Skip to main content
POST
Vytvoriť dobropis z faktúry

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"

Parametry cesty

invoice
integer
povinné

ID faktúry.

Příklad:

301

Tělo

application/json

Voliteľný override payload pre shortcut endpoint POST /invoices/{invoice}/credit-notes. Všetky ostatné business polia dobropisu sa odvodia na serveri zo zdrojovej faktúry. Nepodporuje položky, klienta ani bankový účet v requeste.

number
string

Manuálne číslo dobropisu. Ak ho nepošlete, backend použije číslo z primárneho číselného radu dobropisov, resp. z radu určeného cez numericalSeriesId. Ak pošlete number, nepošlite zároveň numericalSeriesId.

Required string length: 1 - 20
Příklad:

"20260051"

numericalSeriesId
integer | null

ID číselného radu dobropisov. Ak ho pošlete bez number, backend z neho vygeneruje finálne číslo dobropisu. Ak pošlete numericalSeriesId, nepošlite zároveň manuálne number.

Příklad:

12

issueDate
string<date>

Voliteľný dátum vystavenia vo formáte Y-m-d. Ak ho nepošlete, použije sa dnešný dátum.

Příklad:

"2026-03-05"

dueDate
string<date>

Voliteľný dátum splatnosti vo formáte Y-m-d. Ak ho nepošlete, použije sa finálny issueDate. Ak ho pošlete, musí byť väčší alebo rovný finálnemu issueDate.

Příklad:

"2026-03-19"

deliveryDate
string<date>

Voliteľný dátum dodania vo formáte Y-m-d. Ak ho nepošlete, použije sa finálny issueDate. Ak ho pošlete, musí byť menší alebo rovný finálnemu issueDate.

Příklad:

"2026-03-04"

note
string | null

Voliteľný override poznámky. Ak pole nepošlete, použije sa note zo zdrojovej faktúry. Ak pošlete null, poznámka sa vynuluje.

Maximum string length: 3000
Příklad:

"Dobropis k čiastočnému storno plnenia."

textAboveItems
string | null

Voliteľný override textu nad položkami. Ak pole nepošlete, použije sa textAboveItems zo zdrojovej faktúry. Ak pošlete null, text sa vynuluje.

Maximum string length: 3000
Příklad:

"Dobropisujeme pôvodné plnenie v plnom rozsahu."

Odpověď

Dobropis bol vytvorený zo zvolenej faktúry.

Dobropis.

id
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.

clientId
integer

Live ID klienta naviazaného na dobropis.

Příklad:

101

client
object

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

bankAccount
object | null

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

payments
object[]

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

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
Příklad:

1

currencyId
integer
Příklad:

1

currencyRate
number<float>
Příklad:

1

languageId
integer
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[]