Preskoči na glavno vsebino

Príkaz na inkaso

Ako vytvoriť príkaz na inkaso cez REST API?

Avtor: Petr Pech

Príkaz na inkaso možno vytvárať cez REST API jednoduchým volaním metódou PUT alebo POST:

/c/{firma}/bankovni-ucet/{id}/prikaz-k-inkasu

Pre zadaný bankový účet vytvorí príkaz na inkaso zo všetkých doteraz neuhradených dokladov.

/c/{firma}/bankovni-ucet/{id}/prikaz-k-inkasu?splatnost=2014-10-14&datVystOd=2014-09-01&datVystDo=2014-09-31

Pre zadaný bankový účet vytvorí príkaz na inkaso so zadanou splatnosťou zo všetkých doteraz neuhradených dokladov v uvedenom období.

Vstupy

Spracovanie požiadavky sa riadi týmito parametrami:

parameter

typ

popis

predvolená hodnota

splatnost

dátum yyyy-mm-dd

dátum splatnosti príkazu

nasledujúci pracovný deň

datVystOd

dátum yyyy-mm-dd

dátum vystavenia najstaršieho hradeného dokladu

neobmedzené

datVystDo

dátum yyyy-mm-dd

dátum vystavenia najmladšieho hradeného dokladu

aktuálny dátum

Do vytváraného príkazu na inkaso sú zahrnuté doklady spĺňajúce tieto podmienky:

  1. doklad je typu vydaná faktúra alebo pohľadávka s kladnou (nenulovou) hodnotou,

  2. doklad je typu prijatá faktúra alebo záväzok so zápornou (nenulovou) hodnotou,

  3. nejde o zálohový daňový doklad,

  4. forma úhrady dokladu je „prevodom",

  5. doklad má vyplnené bankové spojenie (číslo účtu),

  6. mena dokladu je zhodná s menou účtu,

  7. doklad ešte nie je úplne uhradený (môže byť čiastočne),

  8. doklad sa doteraz nevyskytuje na príkaze na inkaso,

  9. na doklade nie je nastavený zákaz preplatenia (prijatá faktúra),

  10. doklad je schválený na platbu, ak sa vyžaduje podpis pred vystavením príkazu na úhradu,

  11. dátum vystavenia dokladu vyhovuje zadaným kritériám (pozri parametre datVystOd a datVystDo).

Výstupy

Úspešné spracovanie požiadavky môže vracať tieto stavy:

200

Neboli nájdené žiadne vhodné doklady na vytvorenie príkazu.

201

Príkaz na inkaso bol vytvorený, URL je uvedené v hlavičke Location.

Ste s tem dobili odgovor na svoje vprašanje?