Vytvoriť dobropis

curl --request POST \ --url https://app.fintoro.sk/api/public/v1/credit-notes \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data ' { "invoiceId": 301, "number": "20260051", "issueDate": "2026-03-03", "dueDate": "2026-03-17", "deliveryDate": "2026-03-03", "bankAccountId": 201, "variableSymbol": 20260051, "transferTaxLiability": false, "paymentMethodId": 1, "currencyId": 1, "currencyRate": 1, "languageId": 1, "items": [ { "quantity": 2, "priceListItemId": 501, "name": "Konzultácia", "description": "Mesačný balík konzultácií", "unitPrice": 100, "unitId": 1, "vatRate": 20, "discountType": "percentage", "discountValue": 10, "discountName": "Vernostná zľava", "warehouseAllocations": [ { "warehouseId": 1, "quantity": 2 } ] } ], "businessCaseId": 701, "numericalSeriesId": 12, "constantSymbol": 308, "specificSymbol": 55, "discountType": "percentage", "discountValue": 10, "note": "Dobropis k pôvodnej faktúre.", "textAboveItems": "Dobropisujeme časť pôvodného plnenia." } '

{ "id": 351, "uuid": "6b1b8c9e-66e6-4fb5-b2db-6d7c7f0f8f19", "type": "credit-note", "number": "20260051", "webDokladUrl": "https://app.fintoro.sk/web-doklad/credit-note/4f3f8a95-5c4a-4c8b-9e6c-8a0c1a5df3a1", "pdfDownloadUrl": "https://app.fintoro.sk/api/public/v1/credit-notes/351/pdf", "company": { "name": "Fintoro s.r.o.", "subjectId": "12345678", "legalForm": "Spoločnosť s ručením obmedzeným", "taxId": "2020123456", "vatId": "SK2020123456", "vatPayerTypeId": 4, "country": "Slovensko", "city": "Bratislava", "street": "Hlavná 1", "zip": "81101", "logo": "https://cdn.fintoro.sk/company/logo.svg", "signature": "https://cdn.fintoro.sk/company/signature.png", "registrationCourt": "Mestský súd Bratislava III", "registrationNumber": "12345/B", "email": "support@fintoro.sk", "phone": "+421900000000", "web": "https://fintoro.sk" }, "clientId": 101, "client": { "name": "Acme s.r.o.", "type": "company", "subjectId": "12345678", "taxId": "2020123456", "vatId": "SK2020123456", "isVatPayer": true, "email": "billing@acme.test", "street": "Hlavná 1", "city": "Bratislava", "zip": "81101", "countryId": 703, "country": { "id": 703, "name": "Slovensko", "code": "SK", "eu": true }, "hasDeliveryAddress": true, "deliveryStreet": "Skladová 9", "deliveryCity": "Košice", "deliveryZip": "04001", "deliveryCountryId": 703, "deliveryCountry": { "id": 703, "name": "Slovensko", "code": "SK", "eu": true } }, "bankAccount": { "id": 201, "bankId": 1, "bank": { "id": 23, "name": "Tatra Banka", "swift": "TATRSKBX" }, "name": "Hlavný účet", "iban": "SK3111000000001234567890", "swift": "TATRSKBX", "isPrimary": true, "autoPaymentMatching": true }, "payments": [ { "id": 801, "documentType": "invoice", "documentId": 301, "paymentMethod": { "id": 1, "name": "Platba prevodom" }, "currency": { "id": 1, "symbol": "EUR", "name": "Euro", "mark": "€" }, "paymentDate": "2026-03-07", "amount": 15.5, "currencyRate": 1, "receiptInvoice": { "id": 301, "uuid": "6b1b8c9e-66e6-4fb5-b2db-6d7c7f0f8f19", "type": "invoice", "number": "20260001", "clientId": 101, "client": { "name": "Acme s.r.o.", "type": "company", "subjectId": "12345678", "taxId": "2020123456", "vatId": "SK2020123456", "isVatPayer": true, "email": "billing@acme.test", "street": "Hlavná 1", "city": "Bratislava", "zip": "81101", "countryId": 703, "country": { "id": 703, "name": "Slovensko", "code": "SK", "eu": true }, "hasDeliveryAddress": true, "deliveryStreet": "Skladová 9", "deliveryCity": "Košice", "deliveryZip": "04001", "deliveryCountryId": 703, "deliveryCountry": { "id": 703, "name": "Slovensko", "code": "SK", "eu": true } }, "issueDate": "2026-03-03", "dueDate": "2026-03-17", "deliveryDate": "2026-03-03", "currency": { "id": 1, "symbol": "EUR", "name": "Euro", "mark": "€" }, "total": 200, "totalWithVat": 240, "toBePaid": 240, "status": "unpaid", "hasVat": true } } ], "invoiceId": 301, "variableSymbol": 20260051, "constantSymbol": 308, "specificSymbol": 55, "issueDate": "2026-03-03", "dueDate": "2026-03-17", "deliveryDate": "2026-03-03", "businessCaseId": 701, "discountType": "percentage", "discountValue": 10, "transferTaxLiability": false, "numericalSeriesId": 12, "paymentMethodId": 1, "currencyId": 1, "currencyRate": 1, "languageId": 1, "note": "Dobropis k pôvodnej faktúre.", "textAboveItems": "Dobropisujeme pôvodné plnenie.", "itemsTotal": -20, "itemsTotalWithVat": -24, "alreadyPaid": 0, "total": -20, "totalWithVat": -24, "toBePaid": -24, "status": "unpaid", "hasVat": true, "items": [ { "id": 1, "uuid": "6b1b8c9e-66e6-4fb5-b2db-6d7c7f0f8f19", "name": "Dobropisovaná konzultácia", "description": "Storno časti mesačného balíka", "unitPrice": -10, "unitId": 1, "quantity": 2, "vatRate": 20, "discountName": "Vernostná zľava", "discountType": "percentage", "discountValue": 10, "priceListItemId": 501, "total": -20, "totalWithVat": -24 } ] }

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 dobropisu. Ide o explicitný create flow bez inline client resolution. Musíte poslať kompletný business payload vrátane invoiceId, všetkých kľúčových dokladových polí a položiek. Klient sa automaticky odvodí zo zdrojovej faktúry a výsledná celková suma dobropisu musí zostať záporná.

invoiceId

integer

povinné

ID pôvodnej faktúry, ku ktorej sa dobropis viaže.

Příklad:

301

number

string

povinné

Explicitné číslo dobropisu. Musí byť unikátne v rámci dobropisov aj faktúr. Tento flow vyžaduje number, preto spolu s ním neposielajte numericalSeriesId.

Required string length: 1 - 20

Příklad:

"20260051"

issueDate

string<date>

povinné

Dátum vystavenia vo formáte Y-m-d.

Příklad:

"2026-03-03"

dueDate

string<date>

povinné

Dátum splatnosti vo formáte Y-m-d. Musí byť väčší alebo rovný issueDate.

Příklad:

"2026-03-17"

deliveryDate

string<date>

povinné

Dátum dodania vo formáte Y-m-d. Musí byť menší alebo rovný issueDate.

Příklad:

"2026-03-03"

bankAccountId

integer

povinné

ID bankového účtu firmy použitého na dobropise.

Příklad:

201

variableSymbol

integer

povinné

Variabilný symbol s dĺžkou 1 až 10 číslic.

Požadovaný rozsah: 0 <= x <= 9999999999

Příklad:

20260051

transferTaxLiability

boolean

povinné

Príznak prenesenej daňovej povinnosti.

Příklad:

false

paymentMethodId

integer

povinné

ID spôsobu úhrady z referenčnej tabuľky spôsobov úhrady.

Příklad:

1

currencyId

integer

povinné

ID meny z referenčnej tabuľky mien.

Příklad:

1

currencyRate

number<float>

povinné

Kurz meny k EUR. Ak je mena dokladu EUR, backend vždy uloží a vráti 1.0.

Požadovaný rozsah: 0.00001 <= x <= 10000000

Příklad:

1

languageId

integer

povinné

ID jazyka z referenčnej tabuľky jazykov.

Příklad:

1

items

object[]

povinné

Položky dobropisu. Výsledný doklad musí mať zápornú celkovú sumu.

Required array length: 1 - 100 elements

Payload jednej položky faktúry. Podporované sú tri režimy: manuálna položka, priceListItemId + quantity, alebo priceListItemId s čiastočnými override poľami. Povinné je vždy quantity. Ak nepošlete priceListItemId, musíte poslať aj name, unitPrice a vatRate. unitId je voliteľné; ak ho pri manuálnej položke nepošlete, backend použije jednotku 1 (ks / Unit::Piece). Ak priceListItemId pošlete, backend si z cenníkovej položky vie dopočítať názov, jednotku, cenu a sadzbu DPH; payload potom slúži len ako sparse override.

Option 1
Option 2

Show child attributes

businessCaseId

integer | null

Voliteľné ID obchodného prípadu. Ak ho pošlete, musí patriť klientovi zdrojovej faktúry.

Příklad:

701

numericalSeriesId

integer | null

ID číselného radu pre dobropisy. V tomto explicitnom public create/update flowe ho neposielajte spolu s povinným poľom number.

Příklad:

12

constantSymbol

integer | null

Konštantný symbol s dĺžkou 1 až 4 číslic.

Požadovaný rozsah: 0 <= x <= 9999

Příklad:

308

specificSymbol

integer | null

Špecifický symbol s dĺžkou 1 až 10 číslic.

Požadovaný rozsah: 0 <= x <= 9999999999

Příklad:

55

discountType

enum<string> | null

Typ zľavy na úrovni celého dokladu.

Dostupné možnosti:

percentage,

fixed

Příklad:

"percentage"

discountValue

number<float> | null

Hodnota zľavy na úrovni celého dokladu.

Příklad:

10

note

string | null

Poznámka na doklade.

Maximum string length: 3000

Příklad:

"Dobropis k pôvodnej faktúre."

textAboveItems

string | null

Text nad položkami.

Maximum string length: 3000

Příklad:

"Dobropisujeme časť pôvodného plnenia."

Odpověď

Dobropis bol vytvorený.

Dobropis.

integer

Příklad:

351

uuid

string

Příklad:

"6b1b8c9e-66e6-4fb5-b2db-6d7c7f0f8f19"

type

string

Příklad:

"credit-note"

number

string

Příklad:

"20260051"

webDokladUrl

string<uri>

Absolútna URL na verejný web doklad tohto dobropisu.

Příklad:

"https://app.fintoro.sk/web-doklad/credit-note/4f3f8a95-5c4a-4c8b-9e6c-8a0c1a5df3a1"

pdfDownloadUrl

string<uri>

Absolútna URL na Fintoro API endpoint, ktorý stiahne PDF tohto dobropisu ako prílohu.

Příklad:

"https://app.fintoro.sk/api/public/v1/credit-notes/351/pdf"

company

object

Snapshot dodávateľa uložený priamo na tomto doklade.

Show child attributes

clientId

integer

Live ID klienta naviazaného na dobropis.

Příklad:

101

client

object

Historický snapshot klienta uložený priamo na tomto doklade.

Show child attributes

bankAccount

object

Bankový účet naviazaný na dobropis ako živá väzba načítaná aj cez soft delete.

Show child attributes

payments

object[]

Úhrady naviazané na tento dobropis v poradí od najnovšej.

Show child attributes

invoiceId

integer | null

ID pôvodnej faktúry, ku ktorej je dobropis naviazaný.

Příklad:

301

variableSymbol

integer | null

Příklad:

20260051

constantSymbol

integer | null

Příklad:

308

specificSymbol

integer | null

Příklad:

55

issueDate

string<date>

Příklad:

"2026-03-03"

dueDate

string<date>

Příklad:

"2026-03-17"

deliveryDate

string<date> | null

Příklad:

"2026-03-03"

businessCaseId

integer | null

Voliteľné ID obchodného prípadu. Ak ho pošlete, musí patriť klientovi zdrojovej faktúry.

Příklad:

701

discountType

string | null

Příklad:

"percentage"

discountValue

number<float> | null

Příklad:

10

transferTaxLiability

boolean

Příklad:

false

numericalSeriesId

integer | null

Příklad:

12

paymentMethodId

integer

ID spôsobu úhrady z referenčnej tabuľky spôsobov úhrady.

Příklad:

1

currencyId

integer

ID meny z referenčnej tabuľky mien.

Příklad:

1

currencyRate

number<float>

Příklad:

1

languageId

integer

ID jazyka z referenčnej tabuľky jazykov.

Příklad:

1

note

string | null

Příklad:

"Dobropis k pôvodnej faktúre."

textAboveItems

string | null

Příklad:

"Dobropisujeme pôvodné plnenie."

itemsTotal

number<float>

Příklad:

-20

itemsTotalWithVat

number<float>

Příklad:

-24

alreadyPaid

number<float>

Příklad:

0

total

number<float>

Příklad:

-20

totalWithVat

number<float>

Příklad:

-24

toBePaid

number<float>

Příklad:

-24

status

enum<string>

Dostupné možnosti:

paid,

unpaid,

partially_paid,

overdue,

will_not_be_paid

Příklad:

"unpaid"

hasVat

boolean

Příklad:

true

items

object[]

Show child attributes

Prehľad

Endpointy

Business pravidlá

Payload kontrakt

Autorizace

Hlavičky

Tělo

Odpověď