Credit Notes
Create credit note
Creates a new credit note.
Business rules
- The credit note must be linked to an existing invoice through
invoiceId. - The credit-note client is always taken from the selected source invoice, so do not send
clientId. - This endpoint does not support inline
clientpayloads, client resolution, or automatic client creation. - The resulting total of the credit note must stay negative; if the payload produces a positive document, the endpoint returns
422.
Payload contract
Unlike the public invoice and proforma APIs, this is an explicit create flow without smart defaults. Send the complete business payload for the document including dates, bank account, symbols, currency, and items.
If you use warehouse allocations on items, the backend processes them as inbound warehouse movements linked to the credit note.
If you send an Idempotency-Key, the same key with the same payload returns the original response without creating the credit note again.
POST
Create credit note
Authorizations
Bearer token created for a specific company in Integrations → API.
Headers
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.
ID of the original invoice the credit note references. The invoice must be available in the token scope.
Example:
301
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 - 20Example:
"20260051"
Issue date in Y-m-d format.
Example:
"2026-03-03"
Due date in Y-m-d format. It must be greater than or equal to issueDate.
Example:
"2026-03-17"
Delivery date in Y-m-d format. It must be less than or equal to issueDate.
Example:
"2026-03-03"
Company bank account ID used on the credit note.
Example:
201
Variable symbol with 1 to 10 digits.
Required range:
0 <= x <= 9999999999Example:
20260051
Reverse-charge tax liability flag.
Example:
false
Payment method ID from the payment method reference table.
Example:
1
Currency ID from the currency reference table.
Example:
1
Currency exchange rate against EUR. If the document currency is EUR, the backend always stores and returns 1.0.
Required range:
0.00001 <= x <= 10000000Example:
1
Language ID from the language reference table.
Example:
1
Credit note line items. The resulting document must have a negative total amount.
Required array length:
1 - 100 elementsPayload 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.
- Option 1
- Option 2
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
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
Constant symbol with 1 to 4 digits.
Required range:
0 <= x <= 9999Example:
308
Specific symbol with 1 to 10 digits.
Required range:
0 <= x <= 9999999999Example:
55
Document-level discount type.
Available options:
percentage, fixed Example:
"percentage"
Document-level discount value.
Example:
10
Note shown on the document.
Maximum string length:
3000Example:
"Credit note for the original invoice."
Text shown above the line items.
Maximum string length:
3000Example:
"We are crediting part of the original supply."
Response
Credit note created.
Credit note.
Example:
351
Example:
"6b1b8c9e-66e6-4fb5-b2db-6d7c7f0f8f19"
Example:
"credit-note"
Example:
"20260051"
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"
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"
Supplier snapshot stored directly on this document.
Live ID of the client linked to the credit note.
Example:
101
Historical client snapshot stored directly on this document.
Bank account linked to the credit note as a live relation, loaded even through soft delete.
Payments linked to this credit note ordered from newest to oldest.
ID of the original invoice the credit note references.
Example:
301
Example:
20260051
Example:
308
Example:
55
Example:
"2026-03-03"
Example:
"2026-03-17"
Example:
"2026-03-03"
Optional business case ID. When sent, it must belong to the client derived from the source invoice.
Example:
701
Example:
"percentage"
Example:
10
Example:
false
Example:
12
Payment method ID from the payment method reference table.
Example:
1
Currency ID from the currency reference table.
Example:
1
Example:
1
Language ID from the language reference table.
Example:
1
Example:
"Credit note for the original invoice."
Example:
"We are crediting the original supply."
Example:
-20
Example:
-24
Example:
0
Example:
-20
Example:
-24
Example:
-24
Available options:
paid, unpaid, partially_paid, overdue, will_not_be_paid Example:
"unpaid"
Example:
true
Previous
Show credit noteReturns the credit-note detail. The response contains the supplier snapshot, the historical client snapshot stored on the credit note, the live bank account relation used on the document, `invoiceId` of the original invoice the credit note references, and the `payments` belonging to that credit note. It also includes `webDokladUrl` and `pdfDownloadUrl` for downstream integration flows.
Next
Create credit note