Úhrady dokladov
Zoznam úhrad dokladu
Vráti zoznam úhrad konkrétneho public dokladu. Zoznam je nefiltrovaný a nepaginuje sa; vždy vracia všetky úhrady daného dokladu v poradí od najnovšej.
GET
Zoznam úhrad dokladu
Autorizace
Bearer token vytvorený pre konkrétnu firmu v Integrácie → API.
Parametry dotazu
Typ dokladu, pre ktorý chcete úhrady načítať. Podporované sú len invoice, proforma a credit-note.
Dostupné možnosti:
invoice, proforma, credit-note ID dokladu patriaceho.
Odpověď
Zoznam úhrad dokladu.
Zoznam úhrad vybraného dokladu.
Předchozí
Vytvoriť úhradu dokladuVytvorí 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 `paymentDate` nepošlete, použije sa dnešný dátum.
- Ak `paymentMethodId` nepošlete, použije sa spôsob úhrady zo zdrojového dokladu.
- Ak `currencyId` nepošlete, použije sa mena zo zdrojového dokladu.
- Ak `amount` nepošlete, použije sa aktuálna zostávajúca suma `toBePaid` zo zdrojového dokladu. Tento shortcut funguje len pri doklade s nenulovým `toBePaid`; inak endpoint vráti `422`.
- Ak `amount` pošlete explicitne, môže mať najviac 2 desatinné miesta.
- Ak `amount` pošlete explicitne, nesmie svojou veľkosťou presiahnuť aktuálne `toBePaid` a musí rešpektovať jeho znamienko, aby nevznikla preplatková úhrada alebo opačný smer platby.
- Ak `currencyRate` nepošlete, systém ho odvodí z finálneho `paymentDate` kurzom z predchádzajúceho dňa.
- Ak pošlete `currencyRate` pre 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áti `currencyRate = 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.
Další
Zoznam úhrad dokladu

