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 |
| Pre zadaný bankový účet vytvorí príkaz k inkasu zo všetkých doteraz neuhradených dokladov. |
| 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 |
| dátum | Dátum splatnosti príkazu. | nasledujúci pracovný deň |
| dátum | Dátum vystavenia najstaršieho hradeného dokladu. | neobmedzené |
| dátum | 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
datVystOdadatVystDo).
Výstupy
Úspešné spracovanie požiadavky môže vracať tieto stavy:
Status | Význam |
| Neboli nájdené žiadne vhodné doklady na vytvorenie príkazu. |
| Príkaz k inkasu bol vytvorený, URL je uvedené v hlavičke |
⚠️ 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
Príkaz k úhrade (REST API)
Príkaz k inkasu (aplikácia)
Príkaz k inkasu (nastavenie)
