Over serviceproviders

eInvoicing genereert en valideert PEPPOL-XML, maar verstuurt niets vanzelf over het netwerk. Dat is de taak van een serviceprovider — een PEPPOL Access Point met een contract met de PEPPOL-autoriteit. Uw serviceprovider zet uw XML uiteindelijk in de mailbox van de ontvanger (en omgekeerd voor inkomend).

Waarom nodig

PEPPOL is een vier-hoeken-model: Sender → Sender's Access Point → Receiver's Access Point → Receiver. De twee Access Points zijn serviceproviders; zij doen authenticatie, routing, retries en standaarden-compliance.
U kunt niet zomaar UBL-XML naar een klant POSTen — die accepteert geen losse HTTP. Hij accepteert het van een PEPPOL Access Point.

Ondersteunde integraties

Provider	API-referentie	Sterke punten
B2B Router	b2brouter.com	Multi-account; API send + poll
Recommand	peppol.recommand.eu/api-reference	Webhook voor realtime inbound, transparante prijzen, multi-company, document-verificatie, GitHub

Beide providers regelen de zwaarte van het vier-hoeken-model. U configureert credentials in eInvoicing; de app routeert uitgaande documenten ernaar en haalt inkomende eruit.

Hoe outbound werkt

Verkoopfactuur → EDocument (UBL-XML) → Validate → Transmit via API
   → Service Provider (B2B Router / Recommand)
   → PEPPOL-netwerk → Access Point ontvanger → Ontvanger

Status van EDocument wordt "Transmission Successful" en de provider-document-ID wordt in reference opgeslagen voor tracking.

Hoe inbound werkt

Mechanisme	Wanneer
Webhook	Realtime — provider POSTt UBL-XML naar `/api/method/edocument_integration.api.webhook` zodra een document binnenkomt
Polling	Op een schema — app belt de inbox-endpoint van de provider periodiek, haalt nieuwe documenten op en maakt EDocument-records

Beide paden monden uit in dezelfde EDocument-lifecycle: aanmaken → detect → valideren → matchen → Inkoopfactuur maken.

Andere provider toevoegen

De integratie is pluggable. Voor een derde provider:

Maak <provider>_api.py met een client-class met transmit_invoice(xml) en poll_inbox()
Voeg een route toe in api.py's transmit_edocument() en poll_incoming_invoices()
Voeg de nieuwe waarde toe aan het EDocument Integrator Select-veld op EDocument Integration Settings

Details: zie edocument_integration op GitHub.

Een provider instellen — credentials en DocType-instellingen
Een serviceprovider configureren — webhook-URL en polling
Verzenden & ontvangen — dagelijks gebruik

eInvoicing