Tilausvirta
Lähetysmääräys
Tilaukset, vastaukset, muutokset ja peruutukset
Tekniset tiedot
Peppol BIS -määritykset
Vain tilaus, tilaaminen, ennakkotilaus, tilaussopimus
Tapahtumat
Allekirjoitetut webhookit
Vastaanotettu, toimitettu, viivästynyt ja epäonnistunut
Saatavuus
99,8 % kuukaudessa
Sopimusperusteinen, palvelupisteillä
Peppol-tilausprosessi yhdessä API:ssa
Ostaja ja toimittaja muodostavat yhteyden kukin oman tukiasemansa kautta. Järjestelmäsi lähettää ja hakee viestit Qvalian sovellusrajapinnan (API) kautta, ja Qvalia huolehtii viestien tarkistuksesta, vastaanottajan hausta ja toimituksesta Peppol-verkossa.
Vastaanota tilaus ja vastaa siihen
Toimittajana tilaa uusi asiakirjojen webhook, hae lukemattomat tilaukset ja vastaa tilausvastauksella. Ostajana lähetä tilaukset lähtevään päätepisteeseen ja seuraa vastauksia saapuvassa päätepisteessä.
- Testausympäristö osoitteessa api-test.qvalia.com, tuotantoympäristö osoitteessa api.qvalia.com
- Oletuksena JSON tai UBL XML, kun Content-Type- ja Accept-otsikot on määritetty
- Jokaisessa POST-pyynnössä käytetty idempotenssiavain tekee uudelleenkokeiluista turvallisia
● ● ●
Sandbox: hae lukemattomat tilaukset ja vastaa sitten
# 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.jsonViestien ja päätepisteiden järjestäminen
Jokainen polku alkaa /transaction/{accountRegNo}. Jokaisella viestityypillä on lähtevät ja saapuvat päätepisteet, lukemattomien viestien lukupäätepiste sekä tilapäätepiste.
| Viesti | Lähettäjä: | Päätepiste | Peppol BIS |
| Tilaus | Ostaja | /orders | Vain tilaukset, tilaaminen, edistynyt tilaaminen |
| Tilausvastaus | Toimittaja | /orderresponses | Tilaus, edistynyt tilaus |
| Tilauksen muutos | Ostaja | /order-changes | Edistynyt tilaaminen |
| Tilauksen peruutus | Ostaja | /order-cancellations | Edistynyt tilaaminen |
| Tilaussopimus | Toimittaja | /orderagreements | Tilaussopimus |
| Tuoteluettelo | Toimittaja | /catalogues | Tuoteluettelo |
| Vastaus luetteloon | Ostaja | /catalogueresponses | Luettelo ja vastaus |
| Lähetysohjeet | Toimittaja | /despatch-advices | Lähetysilmoitus |
Se, mitä viestejä tilisi käyttää, riippuu palvelusta ja liittymästä. Kunkin viestin pyyntö- ja vastausmallit löytyvät Tilaus-API:n viiteopas. Toimitettujen tilausten laskut käsitellään Laskutus API. Voit tarkistaa ennen lähettämistä, onko vastaanottaja rekisteröitynyt tietyn viestityypin vastaanottajaksi, esimerkiksi Order tai OrderResponse, käytä vastaanottajan haku.
Valitse lähtöpisteesi
Toimittajat
Sähköisten tilausten hallinta
Vastaanota ja käsittele Peppol-tilauksia Qvalian verkkosovelluksessa ja muokkaa ne laskuiksi ennen integraation rakentamista.
Hankinta-alustat
Sisäänrakennettu Peppol
Lähetä ja vastaanota tilauksia omille asiakkaillesi. Partner API luo heidän tilinsä ja Peppol-tunnuksensa, ja Order API välittää viestit.
Verkkokauppa
Punchout
Yhdistä tuotevalikoimasi ostajan hankintajärjestelmään, jotta ostoskori muuttuu jäsennellyksi tilauksiksi.
Tilaus-API:n usein kysytyt kysymykset
Mikä on tilaus-API?
Tilaus-API:n avulla järjestelmäsi voi lähettää ja vastaanottaa ostotilauksia sekä niihin liittyviä viestejä jäsennellyssä muodossa. Qvalian tilaus-API välittää Peppol- BIS ordering -viestejä JSON- tai UBL XML -muodossa ja toimittaa ne Peppol-verkon kautta.
Mitä järjestysviestejä API tukee?
Tilaukset, tilausvastaukset, tilausmuutokset, tilausten peruutukset, tilaussopimukset, tuoteluettelot ja niihin liittyvät vastaukset sekä lähetysilmoitukset. Jokaisella on lähtevät ja saapuvat päätepisteet.
Mikä ero on Peppolin ” BIS Ordering ” -toiminnolla ja ”Advanced Ordering” -toiminnolla?
Tilaus käsittää tilauksen ja tilausvastauksen. Laajennettu tilaus sisältää tilauksen muutokset ja peruutukset, joten ostaja voi muuttaa tai peruuttaa tilauksen sen lähettämisen jälkeen. Lue artikkelit ”Mikä on Peppol BIS Ordering? ” ja ”Mikä on Peppol BIS Advanced Ordering?”.
Voinko vastaanottaa Peppol-tilauksia ilman integraatiota?
Kyllä. Kaikkiin Connect-paketteihin sisältyy Peppol-tilauksien vastaanotto Qvalian verkkosovelluksessa. API- ja sandbox-käyttöoikeudet sisältyvät Connect- Medium -pakettiin.
Mistä tiedän, että tilaus on toimitettu?
Tilaa toimitus- ja virhetapahtumia koskevat webhookit tai tarkista tilausten tilatiedot tilauspäätepisteestä. Jokainen toimitustapahtuma voidaan hakea uudelleen 30 päivän ajan tapahtuman tunnisteen avulla.
Voiko tilauksesta tulla lasku?
Kyllä. Connect-verkkosovelluksessa tilauksesta laskuun -automaatio sisältyy jo ” Medium ”-pakettiin. Omassa integraatiossasi voit käyttää tilaustietoja laskun luomiseen ja lähettää sen Invoicing API:n kautta.
Onko siellä hiekkalaatikkoa?
Kyllä. Api-test.qvalia.com-sivuston testausympäristö käyttää omaa API-avaintaan, joten voit testata tilausprosesseja vaikuttamatta tuotantoympäristön tilauksiin.
