Skip to main content
POST
Vytvoriť úhradu dokladu

Autorizace

Authorization
string
header
povinné

Bearer token vytvorený pre konkrétnu firmu v Integrácie → API.

Hlavičky

Idempotency-Key
string

Voliteľný identifikátor requestu pre bezpečné retry. Použite unikátnu hodnotu pre každé create volanie, ktoré chcete vedieť bezpečne zopakovať.

Příklad:

"invoice-create-2026-03-03-001"

Tělo

application/json

Payload pre vytvorenie úhrady dokladu. Podporované sú len dokumenty invoice, proforma a credit-note, pričom cieľový doklad musí byť dostupný pre token.

documentType
enum<string>
povinné

Typ dokladu, ku ktorému úhradu vytvárate.

Dostupné možnosti:
invoice,
proforma,
credit-note
Příklad:

"invoice"

documentId
integer
povinné

ID dokladu, ku ktorému úhradu vytvárate.

Příklad:

301

currencyId
integer

Voliteľné ID meny z referenčnej tabuľky mien. Ak ho nepošlete, použije sa mena zo zdrojového dokladu.

Příklad:

1

currencyRate
number<float>

Kurz meny úhrady voči EUR. Ak ho nepošlete, systém ho dopočíta z finálneho paymentDate kurzom z predchádzajúceho dňa. Ak ho pošlete pre inú menu než EUR, použije sa presne táto override hodnota. Ak je finálna mena úhrady EUR, backend vždy uloží 1.0.

Příklad:

1

paymentDate
string<date>

Dátum úhrady vo formáte Y-m-d. Ak ho nepošlete, použije sa dnešný dátum.

Příklad:

"2026-03-07"

paymentMethodId
integer

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.

Příklad:

1

amount
number<float>

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.

Musí být násobkem 0.01
Příklad:

15.5

Odpověď

Úhrada bola vytvorená.

Jedna úhrada public dokladu.

id
integer

Interné ID úhrady.

Příklad:

801

documentType
enum<string>

Typ dokladu, ku ktorému úhrada patrí.

Dostupné možnosti:
invoice,
proforma,
credit-note
Příklad:

"invoice"

documentId
integer

ID dokladu, ku ktorému úhrada patrí.

Příklad:

301

paymentMethod
object

Použitý spôsob úhrady ako vnorený lookup objekt.

currency
object

Mena úhrady ako vnorený lookup objekt.

paymentDate
string<date>

Dátum úhrady vo formáte Y-m-d.

Příklad:

"2026-03-07"

amount
number<float>

Suma úhrady v mene úhrady.

Příklad:

15.5

currencyRate
number<float>

Kurz meny úhrady voči EUR. Ak je mena úhrady EUR, backend vždy vráti 1.0.

Příklad:

1

receiptInvoice
object | null

Preview daňového dokladu k prijatej platbe, ak existuje.