Bestillingsforløb
Bestilling til afsendelse
Bestillinger, svar, ændringer og afbestillinger
Specifikationer
Peppol BIS-specifikationer
Kun bestilling, Bestilling, Avanceret bestilling, Bestillingsaftale
Begivenheder
Signerede webhooks
Modtaget, leveret, forsinket og mislykket
Tilgængelighed
99,8 % pr. måned
Kontraktmæssigt, med servicekreditter
Peppol-bestillingsforløbet i én API
Køber og leverandør opretter hver især forbindelse via deres eget adgangspunkt. Dit system sender og henter meddelelserne via Qvalia’s API, og Qvalia står for validering, modtageropslag og levering på Peppol-netværket.
Modtag en ordre og besvar den
Som leverandør skal du abonnere på webhooken for nye dokumenter, hente ulæste ordrer og svare med et ordresvar. Som køber skal du sende ordrer til det udgående endpoint og følge svarene på det indgående endpoint.
- Sandkasse på api-test.qvalia.com, produktionsmiljø på api.qvalia.com
- JSON som standard, eller UBL XML med Content-Type- og Accept-headere
- En idempotensnøgle ved hvert POST-anrop gør gentagelser sikre
● ● ●
Sandkasse: Hent ulæste ordrer, og svar derefter
# 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.jsonRangordning af meddelelser og slutpunkter
Enhver vej begynder med /transaction/{accountRegNo}. Hver meddelelsestype har udgående og indgående slutpunkter, et slutpunkt til visning af ulæste meddelelser og et status-slutpunkt.
| Besked | Sendt af | Endepunkt | Peppol BIS |
| Bestilling | Køber | /orders | Kun bestilling, Bestilling, Avanceret bestilling |
| Svar på bestilling | Leverandør | /orderresponses | Bestilling, Avanceret bestilling |
| Ændring af ordre | Køber | /order-changes | Avanceret bestilling |
| Annullering af ordre | Køber | /order-cancellations | Avanceret bestilling |
| Bestillingsaftale | Leverandør | /orderagreements | Ordreaftale |
| Katalog | Leverandør | /catalogues | Katalog |
| Svar på kataloget | Køber | /catalogueresponses | Katalog med svar |
| Råd om afsendelse | Leverandør | /despatch-advices | Forsendelsesbekræftelse |
Hvilke meddelelser din konto bruger, afhænger af tjenesten og abonnementet. Anmodnings- og svarskemaerne for de enkelte meddelelser findes i API-reference til Order. Fakturaer for leverede ordrer behandles via API til fakturering. For at kontrollere, inden man sender, at modtageren er tilmeldt en bestemt beskedtype, for eksempel Order eller OrderResponse, brug opslag på modtager.
Vælg dit udgangspunkt
Leverandører
Håndtering af e-ordrer
Modtag og besvar Peppol-ordrer i Qvalia’s webapplikation, og omdan dem til fakturaer, inden du opretter en integration.
Indkøbsplatforme
Integreret Peppol
Send og modtag ordrer for dine egne kunder. Partner-API’en opretter deres konti og Peppol-id’er, og Order-API’en formidler meddelelserne.
E-handel
Punchout
Forbind dit katalog med køberens indkøbssystem, så indkøbskurven returneres som en struktureret ordre.
Ofte stillede spørgsmål om Order API
Hvad er en ordre-API?
Et ordre-API gør det muligt for dit system at sende og modtage indkøbsordrer samt de tilhørende meddelelser i et struktureret format. Qvalia’s ordre-API overfører Peppol- BIS ordering -meddelelser som JSON eller UBL XML og leverer dem via Peppol-netværket.
Hvilke bestillingsmeddelelser understøtter API’et?
Ordrer, ordresvar, ordreændringer, ordreaflysninger, ordreaftaler, kataloger med katalogsvar samt forsendelsesmeddelelser. Hver af disse har udgående og indgående endepunkter.
Hvad er forskellen mellem Peppol- BIS Ordering en og avanceret bestilling?
Bestilling omfatter selve bestillingen og svaret på bestillingen. Avanceret bestilling omfatter desuden ændringer og annulleringer af bestillinger, så køberen kan ændre eller annullere en bestilling, efter at den er afsendt. Læs »Hvad er Peppol BIS Ordering? « og »Hvad er Peppol BIS Advanced Ordering?«
Kan jeg modtage Peppol-ordrer uden en integration?
Ja. Alle Connect-abonnementer omfatter modtagelse af Peppol-ordrer i Qvalia’s webapplikation. Adgang til API og sandkasse er inkluderet fra Connect- Medium -abonnementet.
Hvordan ved jeg, at en ordre er blevet leveret?
Abonner på webhooks for leverings- og fejlhændelser, eller hent statusoplysninger for ordrer via status-endpointet. Enhver leveringshændelse kan hentes igen i 30 dage ved hjælp af dens hændelses-ID.
Kan en ordre blive til en faktura?
Ja. I Connect-webapplikationen er automatiseringen fra ordre til faktura inkluderet fra » Medium «-abonnementet. I din egen integration skal du bruge ordredataene til at oprette fakturaen og sende den via fakturerings-API’en.
Er der en sandkasse?
Ja. Sandkassen på api-test.qvalia.com bruger sin egen API-nøgle, så du kan teste bestillingsforløb uden at påvirke de aktive ordrer.
