Orderflöde
Från order till leverans
Ordrar, svar, ändringar och annulleringar
Specifikationer
Peppol BIS-specifikationer
Order Only, Ordering, Advanced Ordering, Order Agreement
Händelser
Signerade webhooks
Mottagen, levererad, försenad och misslyckad
Tillgänglighet
99,8 % per månad
Enligt avtal, med kreditering vid avvikelse
Peppols orderflöde i ett API
Köpare och leverantör ansluter var och en via sin egen accesspunkt. Ert system skickar och hämtar meddelandena via Qvalias API, och Qvalia sköter validering, uppslag av mottagare och leverans i Peppol-nätverket.
Ta emot en order och svara på den
Som leverantör prenumererar ni på webhooken för nya dokument, hämtar olästa ordrar och svarar med ett ordersvar. Som köpare skickar ni ordrar till den utgående endpointen och följer svaren på den inkommande.
- Testmiljö på api-test.qvalia.com, produktion på api.qvalia.com
- JSON som standard, eller UBL XML med headrarna Content-Type och Accept
- En Idempotency-Key på varje POST gör omförsök säkra
● ● ●
Testmiljö: hämta olästa ordrar och svara
# Hämta olästa inkommande ordrar (markeras som lästa)
curl "https://api-test.qvalia.com/transaction/$ACCOUNT_REG_NO/orders/incoming/readorders?limit=10" \
-H "Authorization: $QVALIA_API_KEY" \
-H "Accept: application/json"
# Svara med ett ordersvar
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.jsonOrdermeddelanden och endpoints
Alla sökvägar börjar med /transaction/{accountRegNo}. Varje meddelandetyp har utgående och inkommande endpoints, en läs-endpoint för olästa meddelanden och en statusendpoint.
| Meddelande | Skickas av | Endpoint | Peppol BIS |
| Order | Köpare | /orders | Order Only, Ordering, Advanced Ordering |
| Ordersvar | Leverantör | /orderresponses | Ordering, Advanced Ordering |
| Orderändring | Köpare | /order-changes | Advanced Ordering |
| Orderannullering | Köpare | /order-cancellations | Advanced Ordering |
| Orderavtal | Leverantör | /orderagreements | Order Agreement |
| Katalog | Leverantör | /catalogues | Catalogue |
| Katalogsvar | Köpare | /catalogueresponses | Catalogue with response |
| Leveransavisering | Leverantör | /despatch-advices | Despatch Advice |
Vilka meddelanden ert konto använder beror på tjänst och plan. Scheman för anrop och svar för varje meddelande finns i referensen för Order API. Fakturor för levererade ordrar går via faktura-API:et. Vill ni kontrollera före sändning att mottagaren är registrerad för en meddelandetyp, till exempel Order eller OrderResponse, använder ni mottagarkontrollen.
Välj er startpunkt
Leverantörer
E-orderhantering
Ta emot och besvara Peppol-ordrar i Qvalias webbapplikation och gör om dem till fakturor, innan ni bygger en integration.
Inköpsplattformar
Inbyggd Peppol
Skicka och ta emot ordrar för era egna kunder. Partner-API:et skapar deras konton och Peppol-ID:n, och order-API:et hanterar meddelandena.
E-handel
Punchout
Koppla er katalog till köparens inköpssystem, så att varukorgen kommer tillbaka som en strukturerad order.
Vanliga frågor om order-API:et
Vad är ett order-API?
Med ett order-API kan ert system skicka och ta emot inköpsordrar, och meddelandena runt dem, i ett strukturerat format. Qvalias order-API hanterar Peppol BIS-ordermeddelanden som JSON eller UBL XML och levererar dem via Peppol-nätverket.
Vilka ordermeddelanden stöder API:et?
Ordrar, ordersvar, orderändringar, orderannulleringar, orderavtal, kataloger med katalogsvar samt leveransaviseringar. Alla har utgående och inkommande endpoints.
Vad är skillnaden mellan Peppol BIS Ordering och Advanced Ordering?
Ordering omfattar ordern och ordersvaret. Advanced Ordering lägger till orderändringar och annulleringar, så att köparen kan ändra eller annullera en order efter att den har skickats. Läs Vad är Peppol BIS Ordering? och Vad är Peppol BIS Advanced Ordering?
Kan vi ta emot Peppol-ordrar utan en integration?
Ja. Alla Connect-planer omfattar mottagning av Peppol-ordrar i Qvalias webbapplikation. API och testmiljö ingår från planen Connect Medium.
Hur vet vi att en order har levererats?
Prenumerera på webhooks för leverans- och felhändelser, eller läs statusendpointen för ordrar. Varje levererad händelse kan hämtas igen i 30 dagar med sitt händelse-ID.
Kan en order bli en faktura?
Ja. I webbapplikationen Connect ingår automatisering från order till faktura från planen Medium. I er egen integration använder ni orderdata för att skapa fakturan och skickar den via faktura-API:et.
Finns det en testmiljö?
Ja. Testmiljön på api-test.qvalia.com har en egen API-nyckel, så ni kan testa orderflöden utan att påverka riktiga ordrar.
