Vytvoriť úhradu dokladu
Vytvorí novú úhradu pre public doklad.
Podporované typy dokladov
Endpoint podporuje len invoice, proforma a credit-note.
Business správanie
- Úhrada sa vždy viaže na konkrétny doklad cez kombináciu
documentType+documentId. - Minimálny create payload je len
documentType+documentId; ostatné polia môžete vynechať a server ich dopočíta. - Ak
paymentDatenepošlete, použije sa dnešný dátum. - Ak
paymentMethodIdnepošlete, použije sa spôsob úhrady zo zdrojového dokladu. - Ak
currencyIdnepošlete, použije sa mena zo zdrojového dokladu. - Ak
amountnepošlete, použije sa aktuálna zostávajúca sumatoBePaidzo zdrojového dokladu. Tento shortcut funguje len pri doklade s nenulovýmtoBePaid; inak endpoint vráti422. - Ak
amountpošlete explicitne, môže mať najviac 2 desatinné miesta. - Ak
amountpošlete explicitne, nesmie svojou veľkosťou presiahnuť aktuálnetoBePaida musí rešpektovať jeho znamienko, aby nevznikla preplatková úhrada alebo opačný smer platby. - Ak
currencyRatenepošlete, systém ho odvodí z finálnehopaymentDatekurzom z predchádzajúceho dňa. - Ak pošlete
currencyRatepre inú menu nežEUR, použije sa presne táto override hodnota. - Ak je finálna mena úhrady
EUR, backend vždy uloží a vráticurrencyRate = 1.0, aj keď pošlete inú hodnotu. - Pri vytvorení sa prepočíta stav úhrady dokladu rovnako ako vo web a mobile flowe.
- Ak pošlete úhradu pre proformu a neskôr k nej vytvoríte daňový doklad k prijatej platbe, response úhrady vie obsahovať aj
receiptInvoice.
Ak pošlete Idempotency-Key, rovnaký key s rovnakým payloadom vráti pôvodnú odpoveď bez druhého vytvorenia úhrady.
Autorizace
Hlavičky
Tělo
Payload pre vytvorenie úhrady dokladu. Podporované sú len dokumenty invoice, proforma a credit-note, pričom cieľový doklad musí byť dostupný pre token.
Voliteľné ID meny z referenčnej tabuľky mien. Ak ho nepošlete, použije sa mena zo zdrojového dokladu.
1
Voliteľné ID spôsobu úhrady z referenčnej tabuľky spôsobov úhrady. Ak ho nepošlete, použije sa spôsob úhrady zo zdrojového dokladu.
1
Suma úhrady v mene úhrady. Ak ju nepošlete, použije sa aktuálna zostávajúca suma toBePaid zo zdrojového dokladu. Toto odvodenie funguje len pri doklade s nenulovým toBePaid; inak endpoint vráti 422. Ak ju pošlete explicitne, môže mať najviac 2 desatinné miesta, nesmie svojou veľkosťou presiahnuť aktuálne toBePaid a musí rešpektovať jeho znamienko. Backend akceptuje aj záporné sumy, napríklad pri vysporiadaní dobropisu. Pri ukladaní sa znamienko normalizuje podľa typu dokladu: pri credit-note na zápornú absolútnu hodnotu, pri invoice a proforma na kladnú absolútnu hodnotu.
0.0115.5
Odpověď
Úhrada bola vytvorená.
Jedna úhrada public dokladu.

