Skip to main content
POST
Create credit note

Authorizations

Authorization
string
header
required

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

Headers

Idempotency-Key
string

Optional request identifier for safe retries. Use a unique value for each create request you want to retry safely.

Example:

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

Body

application/json

Payload used to create a credit note. This is an explicit create flow without inline client resolution. You must send the complete business payload including invoiceId, all key document fields, and items. The client is derived automatically from the source invoice and the resulting credit note total must stay negative.

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. The resulting document must have a negative total amount.

Required array length: 1 - 100 elements

Payload for a single invoice line item. Three modes are supported: a manual item, priceListItemId + quantity, or priceListItemId with sparse override fields. quantity is always required. If you omit priceListItemId, you must also send name, unitPrice, and vatRate. unitId is optional; when you omit it for a manual item, the backend defaults to unit 1 (piece / Unit::Piece). If you send priceListItemId, the backend can hydrate the name, unit, unit price, and VAT rate from the price list item, and the payload acts only as a sparse override.

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

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