Bestillingsflyt
Ordre om utsendelse
Bestillinger, svar, endringer og kanselleringer
Spesifikasjoner
Peppol BIS-spesifikasjoner
Kun bestilling, bestilling, forhåndsbestilling, bestillingsavtale
Arrangementer
Signerte webhooks
Mottatt, levert, forsinket og mislyktes
Tilgjengelighet
99,8 % per måned
Kontraktsmessig, med tjenestekreditter
Peppol-bestillingsflyten i ett API
Kjøper og leverandør kobler seg sammen gjennom sine egne aksesspunkt Systemet ditt legger ut og henter meldingene via Qvalias API, og Qvalia håndterer validering, mottakersøk og levering på Peppol-nettverket.
Motta en ordre og svar på den
Som leverandør kan du abonnere på den nye dokument-webhooken, hente uleste ordrer og svare med et ordresvar. Som kjøper kan du legge ut ordrer på det utgående endepunktet og følge svarene på det innkommende.
- Sandkasse på api-test.qvalia.com, produksjon på api.qvalia.com
- JSON som standard, eller UBL XML med overskriftene Content-Type og Accept
- En idempotensnøkkel på hver POST gjør nye forsøk trygge
● ● ●
Sandkasse: Hent uleste ordrer, og svar deretter
# 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.jsonOrdne meldinger og endepunkter
Hver vei starter med /transaction/{accountRegNo}Hver meldingstype har utgående og innkommende endepunkter, et lest endepunkt for uleste meldinger og et statusendepunkt.
| Beskjed | Sendt av | Endepunkt | Peppol BIS |
| Bestille | Kjøper | /orders | Kun bestilling, bestilling, forhåndsbestilling |
| Ordresvar | Leverandør | /orderresponses | Bestilling, forhåndsbestilling |
| Ordreendring | Kjøper | /order-changes | Forhåndsbestilling |
| Avbestilling av ordre | Kjøper | /order-cancellations | Forhåndsbestilling |
| Ordreavtale | Leverandør | /orderagreements | Ordreavtale |
| Katalog | Leverandør | /catalogues | Katalog |
| Katalogrespons | Kjøper | /catalogueresponses | Katalog med svar |
| Forsendelsesråd | Leverandør | /despatch-advices | Forsendelsesråd |
Hvilke meldinger kontoen din bruker, avhenger av tjenesten og abonnementet. Forespørsels- og svarskjemaer for hver melding finnes i Referanse for bestillings-APIFakturaer for leverte bestillinger går gjennom API for faktureringFor å sjekke før sending at mottakeren er registrert for en meldingstype, for eksempel Order eller OrderResponse, bruk mottakeroppslag.
Velg ditt utgangspunkt
Leverandører
Håndtering av e-ordre
Motta og svar på Peppol-bestillinger i Qvalias webapplikasjon, og gjør dem om til fakturaer, før du bygger en integrasjon.
Innkjøpsplattformer
Innebygd Peppol
Send og motta bestillinger for dine egne kunder. Partner API oppretter kontoene og Peppol-ID-ene deres, og Order API bærer meldingene.
E-handel
Punchout
Connect katalogen din til kjøperens innkjøpssystem, slik at handlekurven kommer tilbake som en strukturert bestilling.
Vanlige spørsmål om bestillings-API
Hva er et bestillings-API?
Et ordre-API lar systemet ditt sende og motta bestillinger, og meldingene rundt dem, i et strukturert format. Qvalias ordre-API inneholder Peppol BIS ordering meldinger som JSON eller UBL XML og leverer dem over Peppol-nettverket.
Hvilke bestillingsmeldinger støtter API-et?
Bestillinger, ordresvar, ordreendringer, ordrekanselleringer, ordreavtaler, kataloger med katalogsvar og forsendelsesvarsel. Hver har utgående og innkommende endepunkter.
Hva er forskjellen mellom Peppol BIS Ordering og forhåndsbestilling?
Bestilling dekker bestillingen og ordreresponsen. Forhåndsbestilling legger til ordreendringer og kanselleringer, slik at kjøperen kan endre eller kansellere en bestilling etter at den er sendt. Les Hva er Peppol BIS Ordering ? og Hva er Peppol BIS Advanced Ordering ?
Kan jeg motta Peppol-bestillinger uten integrasjon?
Ja. Alle Connect Planene inkluderer mottak av Peppol-ordrer i Qvalias webapplikasjon. API- og sandkassetilgang er inkludert fra Connect Medium plan.
Hvordan vet jeg at en bestilling ble levert?
Abonner på webhooks for leverings- og feilhendelser, eller les statussluttpunktet for bestillinger. Enhver levert hendelse kan hentes igjen i 30 dager med hendelses-ID-en.
Kan en bestilling bli en faktura?
Ja. I Connect webapplikasjon, automatisering fra ordre til faktura er inkludert fra Medium plan. Bruk ordredataene til å opprette fakturaen i din egen integrasjon og send den via fakturerings-API-et .
Finnes det en sandkasse?
Ja. Sandkassen på api-test.qvalia.com bruker sin egen API-nøkkel, slik at du kan teste bestillingsflyter uten å påvirke live-bestillinger.
