De actuele status van een factuur opvragen
- In de sandbox
In gewone woorden
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}$De factuur.
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 GET "https://example.com/invoices/inv_bd8bc8b276f38643f1c0f24f" \ -H "Authorization: Bearer <your-api-key>"{ "invoice_ref": "CAPTURE-JSON-1790961440", "environment": "sandbox", "document_sha256": "45f857890231e9bc6e73c1ec1e53bc01e7b030f84068b324bdd9ef42b88322bc", "route": "DE-XRECHNUNG", "updated_at": "2026-10-06T19:49:02.676Z", "documents": [ { "sha256": "45f857890231e9bc6e73c1ec1e53bc01e7b030f84068b324bdd9ef42b88322bc", "kind": "canonical", "href": "/invoices/inv_936a93e38de84e7b0a1d7681/documents/canonical" }, { "sha256": "ad122fe72dc6f04b2de6b6bbc01fcb7e46e33116b12e3bbb02a569cde3f10106", "kind": "manifest", "href": "/invoices/inv_936a93e38de84e7b0a1d7681/documents/manifest" }, { "sha256": "941fd5005aa03586a7bf23f3039c6d15e38220879d46690f9199a494e35fdc11", "kind": "validation-report", "href": "/invoices/inv_936a93e38de84e7b0a1d7681/documents/validation-report" }, { "sha256": "251a52fec3bdd44555a7396a1567d62c5ada3e3b7d002bb757d6b50e347c2e90", "kind": "xrechnung-ubl", "href": "/invoices/inv_936a93e38de84e7b0a1d7681/documents/xrechnung-ubl" } ], "client": "acme-srl", "created_at": "2026-10-06T19:49:01.621Z", "id": "inv_936a93e38de84e7b0a1d7681", "state": "ready", "invoice_number": "DOC-mux3dlqm"}Een factuur stoppen die nog niet is ingediend POST
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.
Een gegenereerd document of het ontvangstbewijs van het verzendkanaal downloaden GET
Soorten: canonical (de JSON zoals ontvangen), erp-export (een ERP-export zoals het ERP hem verzond), het bestand zoals verzonden (ubl, cii, fa3, pdf), het opgebouwde document (xrechnung-ubl voor Duitsland, anders ubl of fa3), validation-report en manifest (de SHA-256 van de bytes die naar het verzendkanaal gaan, en de lagen die ze hebben gecontroleerd). De vier JSON-soorten worden geleverd als application/json. De ETag is de SHA-256.