Een factuur stoppen die nog niet is ingediend
- In de sandbox
In gewone woorden
Werkt alleen zolang de factuur received, validated of queued is. Sinds 0.18.3 geldt: als een verzending is geprobeerd en
het antwoord verloren is gegaan (een time-out of een 5xx), staat de factuur op submitting en geeft een annulering 409
send-in-progress, omdat het verzendkanaal hem kan hebben; de worker zet hem op submitted of dead_letter. Zodra
het verzendkanaal hem heeft, is een annulering een zakelijk document (een creditnota, of een KOR in Polen), geen API-aanroep.
Sinds 0.18.5 geeft het annuleren van een factuur die al is geannuleerd 200 met die factuur, zodat een nieuwe poging na een verloren
antwoord veilig is. Sinds 0.18.6 mag de sleutel van de beheerder een dead_letter-factuur annuleren als er nooit een aanroep naar het verzendkanaal
voor is gedaan: er kan niets op het verzendkanaal staan, dus hetzelfde document kan daarna opnieuw worden verzonden. Als er wel een aanroep
is gedaan, is het antwoord 409 dead-letter-reached-rail, want een verzending waarvan het antwoord verloren ging, kan er zijn: controleer
eerst bij het verzendkanaal. De sleutel van een eindklant krijgt 409 dead-letter; de beheerder beslist.
apiKeyAuthorizationBearer <token>Stuur uw sleutel als bearer-token: Authorization: Bearer <your-api-key>. De health-aanroep is de enige aanroep die geen sleutel vereist.
id*stringDe factuur-ID die de indieningsaanroep teruggeeft.
^inv_[A-Za-z0-9]{16,40}$Idempotency-Key*stringEen unieke sleutel per logisch verzoek (een UUID is prima). Wordt bewaard zolang de gegevens van de eindklant worden bewaard. Met de sleutel van de beheerder mag hij niet beginnen met client: (400), de vorm waaronder sleutels van eindklanten worden bewaard.
8 <= length <= 100Geannuleerd vóór de indiening, een dead letter die het verzendkanaal nooit bereikte (sleutel van de beheerder), of al geannuleerd.
application/json- response
id*stringinvoice_ref*stringinvoice_number?stringroute*RouteHet verzendkanaal van het land. Dezelfde waarden als country_route in statusberichten.
"PEPPOL""PL-KSEF""RO-EFACTURA""FR-PA""DE-XRECHNUNG"environment*string"sandbox""production"state*InvoiceStateDe eigen status van de dienst voor een factuur. Statusberichten melden de levenscyclus zoals de partner hem ziet;
queued en submitting zijn interne stappen tussen validated en submitted. validation_failed betekent dat de officiële regels het document hebben geweigerd; sinds
0.18.4 wordt een controle die niet draaide (KOSIT-RUN, EI-PDF-CHECK) opnieuw geprobeerd en eindigt dan als dead_letter met die
code. Een dead_letter houdt zijn document vast, zodat hetzelfde bestand antwoordt met duplicate_of; sinds 0.18.6 kan de
beheerder er een annuleren waarvoor geen aanroep naar het verzendkanaal is gedaan, en dan kan het bestand opnieuw worden verzonden.
"received""source_error""validated""validation_failed""queued""submitting""submitted""ready""accepted""rejected""delivered""cancelled""dead_letter"legal_id?|KSeF-nummer, ANAF-uploadindex, document-ID van het toegangspunt, factuur-ID van het Franse platform.
buyer_status?string|nulldocument_sha256?|^[a-f0-9]{64}$attempts?array<>Eerdere indieningen van dezelfde invoice_ref (bijvoorbeeld na een afwijzing en een correctie).
errors?array<>documents?array<>created_at*stringdate-timeupdated_at*stringdate-timedeadline_at?stringEen indicatieve termijn voor deze factuur, als het laatste moment van de laatste toegestane dag in UTC (lees het datumdeel als die dag): de uitgiftedatum plus vijf werkdagen voor Roemenië (e-Factura), de volgende werkdag voor Polen (KSeF offline24). Dagen worden van maandag tot en met vrijdag geteld en feestdagen worden niet toegepast, dus de echte termijn kan later zijn, nooit eerder; het is geen juridisch advies. Wordt in elke status van de factuur gegeven; het zegt niet dat de factuur op tijd of te laat was. Alleen aanwezig voor die twee verzendkanalen, en alleen als de factuur een uitgiftedatum heeft: POST /invoices met een invoice.issue_date, of sinds 0.19.2 een UBL-bestand (cbc:IssueDate) of een FA(3)-bestand (Fa/P_1) dat als XML is verzonden of in de map is neergezet. Een PDF heeft er geen, en dat ze ontbreekt betekent niet dat er geen termijn geldt. Sinds 0.19.1.
date-timecurl -X POST "https://example.com/invoices/inv_bd8bc8b276f38643f1c0f24f/cancel" \ -H "Authorization: Bearer <your-api-key>" \ -H "Idempotency-Key: order-2026-0001"{ "invoice_ref": "FRESH-mux3dlqm-0", "environment": "sandbox", "document_sha256": "b341c81da6fe297787829a8c26fd4b25106b5b34e67482d38c1039651bbfed65", "route": "DE-XRECHNUNG", "updated_at": "2026-10-06T19:49:10.992Z", "client": "acme-srl", "created_at": "2026-10-06T19:49:10.816Z", "id": "inv_ae4d9834bf251353532fe5ee", "state": "cancelled", "invoice_number": "FRESH-mux3dlqm-0"}Toegangsgegevens versleuteld bewaren; de waarde wordt nooit teruggegeven POST
Een proces bewaart toegangsgegevens alleen voor zijn eigen omgeving. Met legal_entity koppelt u ze aan het verkoper-ID waarvoor ze gelden (btw-nummer, NIP, SIREN of bedrijfs-ID); toegangsgegevens zonder die koppeling dienen voor de andere facturen van de eindklant. Een beheerderssleutel van een eindklant bewaart alleen voor de eigen eindklant.
De actuele status van een factuur opvragen GET
Volgende