Stap 5: eerste factuur versturen

Eerste e-factuur versturen via POST salesInvoice/send in de sandbox: ontvanger checken, XML body, idempotency-header.

Stuur een geldig XML-document naar je eigen test-party in acceptatie. Zo oefen je de hele keten zonder derden lastig te vallen.

Voorwaarden
  1. Formaat gekozen — Documentformaten (start: Peppol BIS Billing 3.0)
  2. Voorbeeld of eigen XML — Voorbeeldfacturen
  3. Bestand gevalideerd — Validator
  4. Geldig Bearer-token — OAuth2-token
Ontvanger controleren
POST /api/v1/{partyId}/salesInvoice/queryRecipientParty HTTP/1.1
Host: accp-psb.econnect.eu
Authorization: Bearer ...
Content-Type: application/json

Body: lijst met party-identifiers (bijvoorbeeld je eigen test-party). Zo zie je of de ontvanger op het testnetwerk staat en welke documenttypes worden geaccepteerd. Uitgebreid: Factuur verzenden (API).

Verzenden
POST /api/v1/{partyId}/salesInvoice/send HTTP/1.1
Host: accp-psb.econnect.eu
Authorization: Bearer ...
Content-Type: application/xml
X-EConnect-DocumentId: 550e8400-e29b-41d4-a716-446655440000
  • {partyId} = identifier van de verzendende partij (jouw test-party)
  • Body = ruwe XML
  • X-EConnect-DocumentId = UUID voor idempotency (nooit het factuurnummer)
  • Ontvanger staat in de XML (EndpointID) — foutieve EndpointID → InvoiceSentError
Aanbevolen eerste test
  1. queryRecipientParty op je eigen test-party
  2. Stuur een BIS- of NLCIUS-factuur naar diezelfde party
  3. Bij herhaalde POST met hetzelfde DocumentId verwacht je 409 Conflict (al verwerkt)
Status en retries

Aflevering op Peppol kan asynchroon lopen. Abonneer op webhook-topics (volgende stap) om InvoiceSent, retries en errors te zien. Diepe uitleg: Factuur verzenden.

Volgende stap

Webhooks instellen en verifiëren