Preskoči na glavno vsebino

Príkaz na inkaso

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

Avtor: Petr Pech

Príkaz k inkasu je možné vytvárať cez REST API jednoduchým volaním metódou PUT alebo POST nad konkrétnym bankovým účtom.


Spôsob volania

URL

Popis

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

Pre zadaný bankový účet vytvorí príkaz k inkasu 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-30

Pre zadaný bankový účet vytvorí príkaz k inkasu 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

Východisková 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

ℹ️ Dátum sa tu zadáva vo formáte ISO yyyy-mm-dd — pozor, pri bankovej a pokladničnej knihy sa naopak používa formát d.M.yyyy.


Ktoré doklady sa zaradia

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

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

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

  • nejde o zálohový daňový doklad,

  • forma úhrady dokladu je „prevodom",

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

  • mena dokladu je zhodná s menou účtu,

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

  • doklad sa doteraz nevyskytuje na príkaze k inkasu,

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

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

  • 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:

Status

Význam

200

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

201

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

⚠️ Status 200 teda neznamená, že príkaz vznikol — vznik príkazu spoznáte podľa 201 a hlavičky Location. Metóda GET na tejto adrese vracia 405 Method Not Allowed.


Súvisiace

Ste s tem dobili odgovor na svoje vprašanje?