Upraviť dobropis

curl --request PUT \ --url https://app.fintoro.sk/api/public/v1/credit-notes/{creditNote} \ --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 } ], "uuid": "6b1b8c9e-66e6-4fb5-b2db-6d7c7f0f8f19" } ], "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.

Parametry cesty

creditNote

integer

povinné

ID dobropisu.

Příklad:

351

Tělo

application/json

Payload pre aktualizáciu dobropisu. Update používa rovnaké polia a rovnaké validačné pravidlá ako create flow. Musíte poslať celý business payload vrátane invoiceId a items; omitted polia sa nedoťahujú z aktuálneho dobropisu. Klient sa vždy preberá zo zvolenej zdrojovej faktúry.

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. Toto pole je pri update povinné vždy. Ak pri existujúcej položke pošlete jej pôvodné uuid z detailu dobropisu, backend vie zachovať väzby na skladové príjemky. Pri create flowe item uuid nie je súčasťou request kontraktu a backend ho ignoruje.

Required array length: 1 - 100 elements

Payload jednej položky faktúry pri update. Pravidlá sú rovnaké ako pri create, ale navyše môžete poslať pôvodné uuid existujúceho riadku faktúry. Toto UUID máte k dispozícii v detaile faktúry. Backend ho používa pri synchronizácii skladových alokácií a výdajok, aby vedel spárovať upravovaný riadok s pôvodným riadkom dokladu. Pri create flowe uuid nie je súčasťou item request kontraktu; ak ho pošlete, backend ho ignoruje.

Option 1
Option 2
Option 3
Option 4

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 aktualizovaný.

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

Ako funguje update

Autorizace

Parametry cesty

Tělo

Odpověď