De Peppol-API in een oogopslag
Van API-sleutel tot eerste verzoek
Ons onboardingteam begeleidt je bij de integratie en het testen.
export ACCOUNT_REG_NO=YOUR_ACCOUNT_REGISTRATION_NUMBER
# Identifies the account in every Transaction API requestGebruik deze waarde in het verzoekpad bij elke aanroep van de Transaction API.
export QVALIA_API_KEY=YOUR_SANDBOX_API_KEY
export QVALIA_BASE_URL=https://api-test.qvalia.comHoud de inloggegevens voor de testomgeving en de productieomgeving gescheiden.
curl -X POST \
${QVALIA_BASE_URL}/transaction/${ACCOUNT_REG_NO}/invoices/outgoing \
-H Authorization:${QVALIA_API_KEY} \
-H Content-Type:application/json \
-d @invoice.jsonHet antwoord bevestigt dat het document is ontvangen. De validatieresultaten en de bezorgstatus worden via webhooks of de documentstatus doorgegeven.
export QVALIA_API_KEY=YOUR_PRODUCTION_API_KEY
export QVALIA_BASE_URL=https://api.qvalia.comVolg de verwerking en levering via webhooks of de documentstatus.
Eén account, zes API's
Facturatie-API
Verzend en ontvang facturen en creditnota’s via Peppol, met validatie vóór verzending.
Bestel-API
Verzend en ontvang inkooporders via Peppol, inclusief orderbevestigingen, wijzigingen en annuleringen voor het volledige bestelproces.
Partner-API
Maak eindklantaccounts en Peppol-ID’s aan en beheer deze vanuit uw eigen platform, met webhooks voor documentgebeurtenissen.
OCR-API
Haal gestructureerde gegevens uit PDF-facturen voor controle en verdere verwerking.
Enrichment-API
Classificeer documenten en afzonderlijke posten, en vul transacties aan met gestructureerde gegevens.
Boekhoud-API
Genereer boekingsvoorstellen op basis van inkomende facturen voor een snellere controle en verwerking.
Nog meer manieren om contact te leggen
Wanneer een API-integratie niet de juiste oplossing is, of wanneer je meer nodig hebt dan alleen het uitwisselen van documenten.
- SFTP
Wissel bestanden in XML- of CSV-formaat uit via SFTP wanneer API-integratie geen optie is. - ERP-koppelingen
Kant-en-klare koppelingen voor gangbare ERP- en boekhoudsystemen. - Peppol MCP-server
Geef AI-agenten en MCP-clients gestructureerde toegang tot transacties, regelitems, leveringsstatus en validatie. - Punchout
Koppel een leverancierscatalogus aan het inkoopsysteem van de inkoper. - B2B-afrekenproces
Voeg een B2B-betaal- en factureringsoptie toe aan een WooCommerce-webwinkel, met verzending via Peppol.
Peppol-referentie voor ontwikkelaars
Op deze pagina wordt ingegaan op de API’s van Qvalia en de Peppol-documenten die hiermee worden verzonden. De onderliggende Peppol-standaard, met specificaties, validatieregels en codelijsten, wordt behandeld in onze Peppol-documentatie en implementatiegids. De volledige endpoint-referentie is te vinden op api.qvalia.io. De normatieve Peppol-specificaties worden door OpenPeppol gepubliceerd op docs.peppol.eu.
Peppol-documenten en hun API’s
| Document | Peppol-specificatie | Qvalia API |
| Factuur | Peppol BIS Billing .0 | Factuur-API's |
| Creditnota | Peppol BIS Billing 3.0, creditnota | API’s voor creditnota’s |
| Bestelling en reactie op de bestelling | BIS Ordering via Peppol BIS Ordering | API’s voor bestellingen, API’s voor bestelbevestigingen |
| Bestelovereenkomst | BIS Order Agreement | API’s voor bestelovereenkomsten |
| Wijziging en annulering van een bestelling | Peppol BIS Advanced Ordering | API’s voor het wijzigen van bestellingen, API’s voor het annuleren van bestellingen |
| Verzendbericht | Peppol BIS Despatch Advice | API’s voor verzendbevestigingen |
| Catalogus | Peppol- BIS Catalogue -bericht met antwoord | Catalogus-API's |
| Verzendstatus | Reactie op berichtniveau en status op berichtniveau | API’s voor reacties op berichtniveau, API’s voor statussen op berichtniveau |
Validatie en fouten
Codelijsten
Adressering en opzoeken
Testen en exploitatie
Sandbox
Test uw integratie met uw eigen systemen zonder dat dit gevolgen heeft voor echte klanten of financiële stromen.
Versiebeheer
Ingrijpende wijzigingen worden als nieuwe API-versie uitgebracht, met een aankondigingstermijn van ten minste één maand.
Systeemstatus
Bekijk de huidige beschikbaarheid van diensten en updates over storingen.
Beveiliging
Lees hoe Qvalia omgaat met informatiebeveiliging, bedrijfscontinuïteit en vertrouwen.
Peppol voor uw bedrijf of voor uw klanten?
Peppol-toegangspunt
U wilt Peppol-documenten verzenden en ontvangen voor uw eigen bedrijf. Maak verbinding met het Peppol Access Point van Qvalia en integreer dit met uw ERP-systeem of via de API.
Oplossingen van partners
Bied Peppol aan uw eigen klanten aan via het model dat het beste bij uw rol past. Integreer Peppol in uw product via de API van Qvalia, of beheer een Hosted Access Point onder uw eigen identiteit als Peppol-serviceprovider.
Vragen die ontwikkelaars stellen
Meer implementatietips vind je in onze kennisbank.
Is er een testomgeving?
Ja. De sandbox op api-test.qvalia.com maakt gebruik van een aparte API-sleutel, zodat je kunt testen zonder dat dit gevolgen heeft voor echte klanten of financiële stromen. Volg de stapsgewijze handleiding voor de Peppol API in de kennisbank.
Welke formaten ondersteunt de API?
Standaard JSON, of XML. Beide maken gebruik van op UBL 2.1 gebaseerde structuren voor de relevante Peppol-document-eindpunten. Stel Content-Type en Accept in op application/json of application/xml. Zie Peppol-berichttypen voor de bedrijfsdocumenten en -processen die door het netwerk worden ondersteund.
Hoe kan ik me aanmelden?
Met een API-sleutel in de Authorization-header, of met een tijdelijk token (JWT) dat je via het /token-eindpunt verkrijgt met behulp van je sleutel. Je krijgt aparte sleutels voor de test- en productieomgeving.
Hoe weet ik of een document is afgeleverd?
Abonneer je op webhooks of vraag de API regelmatig op. Qvalia verstuurt meldingen wanneer een document binnenkomt, wanneer het is afgeleverd en wanneer de aflevering mislukt. Voor responsberichten op Peppol-niveau, zie ‘Status op berichtniveau’ in de kennisbank.
Moet ik het Peppol-transport zelf implementeren?
Nee. Qvalia beheert het Access Point en zorgt voor het opzoeken van de ontvanger, het AS4-transport en de bezorging. Je stuurt een document naar de API. Lees hier hoe SMP- en SML-service discovery het ontvangende eindpunt lokaliseren.
Kan ik dit integreren zonder code te schrijven?
Ja. Gebruik een ERP-connector of wissel XML- of CSV-bestanden uit via SFTP.
Welke Peppol-documenten kan ik uitwisselen?
Facturen, creditnota’s, bestellingen, reacties op bestellingen, bestelovereenkomsten, wijzigingen en annuleringen van bestellingen, verzendberichten, catalogi en reacties op berichtniveau. In de tabel onder ‘Peppol-referentie voor ontwikkelaars’ vindt u de specificaties voor elk van deze documenten. Welke documenttypes in uw configuratie zijn opgenomen, hangt af van de geselecteerde dienst en integratie. Zie ‘Wat zijn de berichttypes in Peppol?’ voor een overzicht.
Hoe vindt de API het eindpunt van de ontvanger?
Qvalia gebruikt de ‘ Peppol ID ’ van de ontvanger om via de Service Metadata Locator (SML) de Service Metadata Publisher (SMP) te vinden. De SMP geeft de documentmogelijkheden, het proces en het transport-eindpunt door die nodig zijn voor de verzending. Lees ‘Peppol SMP en SML: hoe service discovery werkt’.
Wat gebeurt er als een document de Peppol-validatie niet doorstaat?
Een document met een fatale validatiefout moet worden gecorrigeerd voordat het wordt verzonden. De foutcode geeft aan om welke regelset het gaat en welk deel van het document nader moet worden onderzocht. Zie ‘Hoe Peppol-validatie werkt ’ en ‘Peppol-validatiecodes’.
Hoe kan ik de Peppol ID en documentmogelijkheden van een ontvanger controleren?
Gebruik de zoekfunctie ‘Peppol ID ’ van Qvalia om de deelnemer en de in de directory gepubliceerde documentmogelijkheden te vinden. Zie voor informatie over de structuur en schema’s van identificatiecodes het artikel ‘Wat is Peppol ID?’ in de kennisbank.