Docs

De actuele status van een factuur opvragen

  • In de sandbox

In gewone woorden

Toont waar één factuur staat.
GET
/invoices/{id}

Autorisatie

apiKey
headerAuthorizationBearer <token>

Stuur uw sleutel als bearer-token: Authorization: Bearer <your-api-key>. De health-aanroep is de enige aanroep die geen sleutel vereist.

Padparameters

id*string

De factuur-ID die de indieningsaanroep teruggeeft.

Patroon^inv_[A-Za-z0-9]{16,40}$

Body van het antwoord

De factuur.

application/json
  1. response
id*string
invoice_ref*string
invoice_number?string
route*Route

Het verzendkanaal van het land. Dezelfde waarden als country_route in statusberichten.

Waarde in"PEPPOL""PL-KSEF""RO-EFACTURA""FR-PA""DE-XRECHNUNG"
environment*string
Waarde in"sandbox""production"
state*InvoiceState

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

Waarde in"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|null
document_sha256?|
Patroon^[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*string
Formaatdate-time
updated_at*string
Formaatdate-time
deadline_at?string

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

Formaatdate-time
curl -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.