Skip to main content
PUT
Update credit note

Authorizations

Authorization
string
header
required

Bearer token created for a specific company in Integrations → API.

Path Parameters

creditNote
integer
required

Credit note ID.

Example:

351

Body

application/json

Payload used to update a credit note. Update uses the same fields and validation rules as the create flow. You must send the full business payload including invoiceId and items; omitted fields are not copied from the current credit note. The client is always derived from the selected source invoice.

invoiceId
integer
required

ID of the original invoice the credit note references. The invoice must be available in the token scope.

Example:

301

number
string
required

Explicit credit-note number. It must be unique across invoices and credit notes. This flow requires number, so do not send numericalSeriesId together with it.

Required string length: 1 - 20
Example:

"20260051"

issueDate
string<date>
required

Issue date in Y-m-d format.

Example:

"2026-03-03"

dueDate
string<date>
required

Due date in Y-m-d format. It must be greater than or equal to issueDate.

Example:

"2026-03-17"

deliveryDate
string<date>
required

Delivery date in Y-m-d format. It must be less than or equal to issueDate.

Example:

"2026-03-03"

bankAccountId
integer
required

Company bank account ID used on the credit note.

Example:

201

variableSymbol
integer
required

Variable symbol with 1 to 10 digits.

Required range: 0 <= x <= 9999999999
Example:

20260051

transferTaxLiability
boolean
required

Reverse-charge tax liability flag.

Example:

false

paymentMethodId
integer
required

Payment method ID from the payment method reference table.

Example:

1

currencyId
integer
required

Currency ID from the currency reference table.

Example:

1

currencyRate
number<float>
required

Currency exchange rate against EUR. If the document currency is EUR, the backend always stores and returns 1.0.

Required range: 0.00001 <= x <= 10000000
Example:

1

languageId
integer
required

Language ID from the language reference table.

Example:

1

items
object[]
required

Credit note line items. This field stays required on update. If you send the original uuid of an existing line item from the credit note detail response, the backend can preserve warehouse inbound receipt links. In the create flow, item uuid is not part of the request contract and the backend ignores it.

Required array length: 1 - 100 elements

Payload for a single invoice line item during update. The validation rules are the same as in create, but you may additionally send the original uuid of an existing invoice row. You can obtain that UUID from the invoice detail response. The backend uses it during warehouse allocation and outbound receipt synchronization so it can match the edited line with the original stored line. In the create flow, item uuid is not part of the request contract; if you send it, the backend ignores it.

businessCaseId
integer | null

Optional business case ID. When sent, it must be available in the token scope and to the client derived from the source invoice.

Example:

701

numericalSeriesId
integer | null

Numbering series ID for credit notes. In this explicit public create/update flow, do not send it together with the required number field.

Example:

12

constantSymbol
integer | null

Constant symbol with 1 to 4 digits.

Required range: 0 <= x <= 9999
Example:

308

specificSymbol
integer | null

Specific symbol with 1 to 10 digits.

Required range: 0 <= x <= 9999999999
Example:

55

discountType
enum<string> | null

Document-level discount type.

Available options:
percentage,
fixed
Example:

"percentage"

discountValue
number<float> | null

Document-level discount value.

Example:

10

note
string | null

Note shown on the document.

Maximum string length: 3000
Example:

"Credit note for the original invoice."

textAboveItems
string | null

Text shown above the line items.

Maximum string length: 3000
Example:

"We are crediting part of the original supply."

Response

Credit note updated.

Credit note.

id
integer
Example:

351

uuid
string
Example:

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

type
string
Example:

"credit-note"

number
string
Example:

"20260051"

webDokladUrl
string<uri>

Absolute URL of the public web document for this credit note.

Example:

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

pdfDownloadUrl
string<uri>

Absolute URL of the Fintoro API endpoint that downloads this credit note PDF as an attachment.

Example:

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

company
object

Supplier snapshot stored directly on this document.

clientId
integer | null

Live ID of the client linked to the credit note. Returns null when the contact has been deleted; the document's client snapshot is preserved.

Example:

101

client
object

Historical client snapshot stored directly on this document.

bankAccount
object | null

Bank account linked to the credit note as a live relation, loaded even through soft delete.

payments
object[]

Payments linked to this credit note ordered from newest to oldest.

invoiceId
integer | null

ID of the original invoice the credit note references.

Example:

301

variableSymbol
integer | null
Example:

20260051

constantSymbol
integer | null
Example:

308

specificSymbol
integer | null
Example:

55

issueDate
string<date>
Example:

"2026-03-03"

dueDate
string<date>
Example:

"2026-03-17"

deliveryDate
string<date> | null
Example:

"2026-03-03"

businessCaseId
integer | null

Optional business case ID. When sent, it must belong to the client derived from the source invoice.

Example:

701

discountType
string | null
Example:

"percentage"

discountValue
number<float> | null
Example:

10

transferTaxLiability
boolean
Example:

false

numericalSeriesId
integer | null
Example:

12

paymentMethodId
integer

Payment method ID from the payment method reference table.

Example:

1

currencyId
integer

Currency ID from the currency reference table.

Example:

1

currencyRate
number<float>
Example:

1

languageId
integer

Language ID from the language reference table.

Example:

1

note
string | null
Example:

"Credit note for the original invoice."

textAboveItems
string | null
Example:

"We are crediting the original supply."

itemsTotal
number<float>
Example:

-20

itemsTotalWithVat
number<float>
Example:

-24

alreadyPaid
number<float>
Example:

0

total
number<float>
Example:

-20

totalWithVat
number<float>
Example:

-24

toBePaid
number<float>
Example:

-24

status
enum<string>
Available options:
paid,
unpaid,
partially_paid,
overdue,
will_not_be_paid
Example:

"unpaid"

hasVat
boolean
Example:

true

items
object[]