Credit Notes
Create credit note from invoice
Creates a credit note directly from the selected invoice.
When to use this endpoint
This endpoint is a DX shortcut for the common full-credit flow when you already have the invoiceId and do not want to compose the full payload manually. It does not replace the canonical POST /credit-notes; that endpoint remains the explicit create flow with the full business payload.
What the backend takes from the source invoice
- it always derives the client from the selected invoice,
- it copies the invoice items as negative credit-note lines including warehouse allocations,
- it keeps the bank account, currency, language, payment method, reverse-charge flag, and document-level discount,
- it keeps
note,textAboveItems,constantSymbol, andspecificSymbolunless you explicitly override the fields that are allowed here.
Defaults and override fields
issueDatedefaults to today’s date.dueDatedefaults to the effectiveissueDate.deliveryDatedefaults to the effectiveissueDate.- If you omit
number, the backend generates it from the primary credit-note numbering series. If you sendnumericalSeriesIdwithoutnumber, the number is generated from that series. variableSymbolis derived server-side from the final credit-note number.- Only the fields defined in the request schema below can be overridden.
If you send an Idempotency-Key, the same key with the same payload returns the original response without creating the credit note a second time.
POST
Create credit note from invoice
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"
Path Parameters
Invoice ID.
Example:
301
Body
application/json
Optional override payload for the shortcut endpoint POST /invoices/{invoice}/credit-notes. All other credit-note business fields are derived server-side from the source invoice. It does not accept items, client data, or bank account data in the request.
Manual credit-note number. If omitted, the backend uses the number from the primary credit-note numbering series, or from the series selected via numericalSeriesId. If you send number, do not send numericalSeriesId in the same payload.
Required string length:
1 - 20Example:
"20260051"
Credit-note numbering series ID. When sent without number, the backend generates the final credit-note number from this series. If you send numericalSeriesId, do not send manual number in the same payload.
Example:
12
Optional issue date in Y-m-d format. If omitted, today's date is used.
Example:
"2026-03-05"
Optional due date in Y-m-d format. If omitted, the effective issueDate is used. When sent, it must be greater than or equal to the effective issueDate.
Example:
"2026-03-19"
Optional delivery date in Y-m-d format. If omitted, the effective issueDate is used. When sent, it must be less than or equal to the effective issueDate.
Example:
"2026-03-04"
Optional note override. If omitted, the backend uses the note from the source invoice. If you send null, the note is cleared.
Maximum string length:
3000Example:
"Credit note for a partial cancellation of the supply."
Optional override for the text shown above the line items. If omitted, the backend uses textAboveItems from the source invoice. If you send null, the text is cleared.
Maximum string length:
3000Example:
"We are fully crediting the original supply."
Response
Credit note created from the selected invoice.
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
Create credit note from invoice