Bestelstroom
Verzendopdracht
Bestellingen, reacties, wijzigingen en annuleringen
Technische gegevens
Peppol BIS-specificaties
Alleen bestelling, Bestellen, Geavanceerd bestellen, Bestelovereenkomst
Evenementen
Ondertekende webhooks
Ontvangen, afgeleverd, vertraagd en mislukt
Beschikbaarheid
99,8% per maand
Contractueel, met servicecredits
De Peppol-bestelstroom in één API
De afnemer en de leverancier maken elk verbinding via hun eigen toegangspunt. Uw systeem verstuurt en haalt de berichten op via de API van Qvalia, en Qvalia zorgt voor de validatie, het opzoeken van de ontvanger en de bezorging via het Peppol-netwerk.
Een opdracht ontvangen en deze uitvoeren
Meld je als leverancier aan voor de nieuwe document-webhook, haal ongelezen bestellingen op en stuur een antwoord met een bestelbevestiging. Als koper verstuur je bestellingen naar het uitgaande eindpunt en volg je de reacties op het inkomende eindpunt.
- Sandbox op api-test.qvalia.com, productie op api.qvalia.com
- Standaard JSON, of UBL XML met de Content-Type- en Accept-headers
- Een idempotentiesleutel bij elke POST-verzoek maakt herhalingspogingen veilig
● ● ●
Sandbox: haal ongelezen opdrachten op en reageer vervolgens
# Fetch unread incoming orders (marks them as read)
curl "https://api-test.qvalia.com/transaction/$ACCOUNT_REG_NO/orders/incoming/readorders?limit=10" \
-H "Authorization: $QVALIA_API_KEY" \
-H "Accept: application/json"
# Reply with an order response
curl -X POST \
"https://api-test.qvalia.com/transaction/$ACCOUNT_REG_NO/orderresponses/outgoing" \
-H "Authorization: $QVALIA_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d @order-response.jsonBerichten en eindpunten ordenen
Elk pad begint met /transaction/{accountRegNo}. Elk berichttype heeft uitgaande en inkomende eindpunten, een eindpunt voor ongelezen berichten en een statuseindpunt.
| Bericht | Verzonden door | Eindpunt | Peppol BIS |
| Bestelling | Koper | /orders | Alleen bestellen, Bestellen, Geavanceerd bestellen |
| Reactie op bestelling | Leverancier | /orderresponses | Bestellen, Geavanceerd bestellen |
| Wijziging van de bestelling | Koper | /order-changes | Geavanceerd bestellen |
| Annulering van een bestelling | Koper | /order-cancellations | Geavanceerd bestellen |
| Bestelovereenkomst | Leverancier | /orderagreements | Bestelovereenkomst |
| Catalogus | Leverancier | /catalogues | Catalogus |
| Reactie op de catalogus | Koper | /catalogueresponses | Catalogus met reacties |
| Verzendbericht | Leverancier | /despatch-advices | Verzendbevestiging |
Welke berichten je account gebruikt, hangt af van de dienst en het abonnement. De verzoek- en antwoordschema’s voor elk bericht staan in het API-referentie bestellen. Facturen voor geleverde bestellingen worden verwerkt via de Facturatie-API. Om vóór het verzenden te controleren of de ontvanger is aangemeld voor een bepaald berichttype, bijvoorbeeld Order of OrderResponse, gebruik de ontvanger opzoeken.
Kies je startpunt
Leveranciers
Beheer van online bestellingen
Ontvang en beantwoord Peppol-opdrachten in de webapplicatie van Qvalia en zet ze om in facturen, voordat u een integratie opzet.
Inkoopplatforms
Geïntegreerde Peppol
Verzend en ontvang bestellingen voor uw eigen klanten. De Partner API maakt hun accounts en Peppol-ID’s aan, en de Order API verzorgt de berichten.
E-commerce
Punchout
Koppel uw catalogus aan het inkoopsysteem van de koper, zodat het winkelmandje als een gestructureerde bestelling wordt teruggestuurd.
Veelgestelde vragen over de Order-API
Wat is een order-API?
Met een order-API kan uw systeem inkooporders en de bijbehorende berichten in een gestructureerd formaat verzenden en ontvangen. De Order-API van Qvalia verwerkt Peppol- BIS ordering -berichten in JSON- of UBL XML-formaat en verzendt deze via het Peppol-netwerk.
Welke bestelberichten ondersteunt de API?
Bestellingen, reacties op bestellingen, wijzigingen in bestellingen, annuleringen van bestellingen, bestelovereenkomsten, catalogi met reacties op catalogi en verzendbevestigingen. Elk daarvan heeft uitgaande en inkomende eindpunten.
Wat is het verschil tussen Peppol- BIS Ordering en en geavanceerd bestellen?
Onder ‘Bestellen’ vallen de bestelling en het antwoord op de bestelling. ‘Geavanceerd bestellen’ omvat ook wijzigingen en annuleringen van bestellingen, zodat de koper een bestelling kan aanpassen of annuleren nadat deze is verzonden. Lees ‘Wat is Peppol BIS Ordering? ’ en ‘Wat is Peppol BIS Advanced Ordering?’
Kan ik Peppol-bestellingen ontvangen zonder integratie?
Ja. Bij alle Connect-abonnementen is het ontvangen van Peppol-bestellingen via de webapplicatie van Qvalia inbegrepen. Toegang tot de API en de sandbox is inbegrepen vanaf het Connect- Medium -abonnement.
Hoe weet ik of een bestelling is afgeleverd?
Abonneer je op webhooks voor leverings- en foutmeldingen, of raadpleeg het status-eindpunt voor bestellingen. Elke leveringsmelding kan gedurende 30 dagen opnieuw worden opgevraagd aan de hand van de gebeurtenis-ID.
Kan een bestelling worden omgezet in een factuur?
Ja. In de Connect-webapplicatie is de automatisering van bestelling tot factuur inbegrepen vanaf het ‘ Medium ’-abonnement. Gebruik in je eigen integratie de bestelgegevens om de factuur aan te maken en deze via de Invoicing API te verzenden.
Is er een sandbox?
Ja. De sandbox op api-test.qvalia.com maakt gebruik van een eigen API-sleutel, zodat je bestelprocessen kunt testen zonder dat dit invloed heeft op live bestellingen.
