Olitpa sitten pienyritys, suuryritys tai ohjelmistotoimittaja, Qvalian sovellusrajapinta tarjoaa sinulle yhden standardeihin perustuvan tavan integroitua Peppol-verkkoon, ja se tukee valinnaisesti muita EDI-virtoja, älykästä asiakirjojen käsittelyä ja tietojen rikastamista.

Through the service Invoicing API, you can work with invoice-related Peppol messages such as BIS Billing (invoice), BIS Billing Credit Note (credit note), BIS Self-Billing Invoice, BIS Self-Billing Credit Note and BIS Invoice Response, and, when needed, complement them with Message Level Response for message-level validation results during the MLR transition period. Transport receipts, Message Level Status (MLS) between service providers, and business-level responses are separate mechanisms.

API voi:

Tässä oppaassa opit, miten:

Peppol API tarjoaa yhtenäisen käyttöliittymän sähköisille liikesanomille Peppolin ja EDI:n välityksellä. Se on rakennettu tukemaan seuraavia keskeisiä skenaarioita:

Kaikissa päätepisteissä käytetään yhteistä suunnitteluperiaatetta:

Sinulle tämä tarkoittaa, että voit ajatella liiketoimintaviestejä verkkojen ja protokollien sijaan. Sinä luot kelvollisia UBL-pohjaisia asiakirjoja; Qvalia hoitaa Peppol- ja EDI-kerroksen taustalla.

Qvalian Peppol API:n käyttöönotto vaatii vain muutamia perusasioita:

Qvalia-tili
Organisaatiosi on otettu Qvalia-asiakkaaksi. Saat tilin rekisteröintinumeron, joka yksilöi tilisi yksiselitteisesti kaikissa tapahtumakutsuissa.

API-avain
Tunnistautuminen tapahtuu API-avaimen avulla, ja testi- ja tuotantoympäristöille on omat avaimet. Kaikki kutsut tehdään HTTPS:n kautta nykyaikaisella TLS:llä.

Tilin rekisteröintinumero URL-polussa
Tapahtumakutsut sisältävät accountRegNo -numeron polussa. Esimerkiksi:

Formaattivalinta:
Voit valita JSON- tai XML-muodon tavallisten HTTP-otsakkeiden (Content-Type ja Accept) avulla. JSON on oletusarvo, jos mitään nimenomaista valintaa ei ole tehty.

Kun nämä elementit ovat valmiina, voit aloittaa Peppolin liikenteen testaamisen Qvalian avulla.

Tässä osiossa käydään läpi tyypillinen ensimmäinen integraatio järjestelmäsi ja Qvalian Transaction API:n välillä, joka kattaa sekä Peppol-laskujen lähettämisen että vastaanottamisen.

Aloita integrointi hiekkalaatikkoympäristöä vastaan:

Näin voit rakentaa ja testata ilman, että se vaikuttaa todellisiin asiakkaisiin tai rahavirtoihin.

Tallenna kokoonpanoosi:

Kunkin pyynnön on sisällettävä:

Peppol business document endpoints use the UBL 2.1-based structure defined by the applicable BIS or PINT specification. Other Qvalia APIs and endpoints may use different payload models; confirm the current API documentation for the endpoint you are implementing.

Voit joko:

Otsikot ohjaavat muotoa:

JSON (oletus)

XML

Tämä joustavuus mahdollistaa Peppol API:n integroinnin sekä JSON- että XML-pohjaisiin ympäristöihin.

Kartoita seuraavaksi sisäinen laskutusmallisi UBL-elementteihin. Käytettävissä ovat sekä UBL JSON että UBL XML.

Tavoitteena on varmistaa, että:

Tämän jälkeen sarjallistat tämän joko JSON- tai XML-muodossa, riippuen valitsemastasi formaatista. Saapuvien laskujen osalta käytät samaa UBL-rakennetta lukiessasi, validoidessasi ja kartoittaessasi tietoja Qvaliasta sisäiseen malliisi.

Step 5: Send an outgoing Peppol invoice

Kun lähtevä hyötykuorma on valmis, päätepisteen esimerkki:

Sisältää:

Qvalia validoi laskun, reitittää sen Peppol-verkon tai VAN kautta ja palauttaa vastauksen, jossa on tunnisteet ja tila.

Kun haluat hakea saapuvat laskut Qvaliasta API:n kautta, sinun on tyypillisesti:

Soita esimerkiksi saapuvaan päätepisteeseen:

Vaihtoehtoisesti voit:

Palautettu UBL JSON tai XML yhdistetään sitten sisäiseen tietomalliisi lähettämistä, hyväksyntää tai jatkokäsittelyä varten.

Tapahtuma-API käyttää ennakoitavia HTTP-tilakoodeja, jotka voit liittää loki-, seuranta- ja käyttäjäviesteihin. Tyypillisiä malleja:

The same patterns apply whether you are sending or receiving invoices. OpenPeppol is replacing MLR with MLS in the eDelivery layer: the MLS activation window starts on 1 March 2027, MLS becomes mandatory for service providers on 1 April 2027, and MLR is retired on 1 May 2027.

API-vastausten lisäksi voit aina kirjautua Qvaliaan ja tarkastella toimintaa tapahtumalokissa. Näin saat käyttöliittymäpohjaisen näkymän siitä, mitä integraatiossasi tapahtuu, mukaan lukien esim:

Tapahtumaloki on hyödyllinen:

Yhdessä HTTP-tilakoodit ja tapahtumaloki antavat täydellisen kuvan: järjestelmäsi voi reagoida vastauksiin ohjelmallisesti, kun taas tiimisi voi tarvittaessa tutkia ja seurata tilannetta suoraan Qvaliassa.

Kun laskut on otettu käyttöön, on helppoa laajentaa integraatiota koko Peppol-viestisalkkuun.

Typical extensions include:
Orders. Receive and send structured orders electronically
Order responses and changes. Confirm, modify, or cancel orders
Catalogues. Maintain product and price information in electronic catalogues
Despatch advice. Communicate shipment information
Message-level validation and status. Track MLR during the transition period, MLS between service providers, and the relevant business response for each process

The available endpoints use a consistent account and authentication model, but payload structures and enabled message types depend on the relevant Peppol profile and your Qvalia service configuration. You enable new use cases as your business or your customers’ requirements evolve.

Tässä kohtaa "yksi Peppol API tarpeesta riippumatta" -lupaus tulee konkreettiseksi: sama integraatio palvelee pieniä toimittajia, suuria yrityksiä ja monimutkaisia alustaskenaarioita.

Jos olet ohjelmistotoimittaja - joka käyttää laskutusalustaa, toiminnanohjausjärjestelmää, kirjanpitoratkaisua tai integraatioalustaa - vaatimuksesi ovat hieman erilaiset. Qvalian kumppani-API:n avulla voit luoda monitilaaja-kokoonpanon loppukäyttäjien viestien vaihtoa varten, mukaan lukien Peppol ID -rekisteröintien hallinta.

Peppolin kumppani-API:tä tarvitaan tarvittaessa:

Qvalian kumppanuuslähtöinen malli on suunniteltu nimenomaan tähän tarkoitukseen.

Sovelluksesi luo tai käyttää UBL-hyötykuormia (laskuja, tilauksia jne.) samalla tavalla kuin tavallisella Transaction API:lla. Jos haluat lähettää tai vastaanottaa tapahtumia tietyn asiakkaan puolesta, kutsut Transaction API:ta partner-prefixed URI patternin kautta:

Esimerkiksi:

Qvalia reitittää ja vastaanottaa viestejä ikään kuin ne olisivat suoraan asiakkaan lähettämiä tai vastaanottamia, ja ne ovat täysin jäljitettävissä tilikohtaisesti.

Kuljetuksen ja liitettävyyden lisäksi Qvalia tarjoaa myös Enrichment API -rajapinnan, joka voi rikastuttaa tapahtumia muun muassa rivikohtaisella luokittelulla, tapahtumaa edeltävällä ja sen jälkeisellä käsittelyllä ja muulla tavoin, sekä poimia ja muuntaa PDF-dokumentit rikkaiksi, jäsennellyiksi ja validoiduiksi tiedoiksi pienellä vaivalla.

Rikastusliittymä on suunniteltu asynkroniseksi palveluksi:

Tähän tulokseen voi sisältyä:

Tyypillinen integrointi näyttää seuraavalta:

Lähetä lasku rikastettavaksi
Kutsu päätepistettä, liitä laskutiedosto ja kaikki asiaankuuluvat metatiedot ja
Tallenna palautettu pollingId.

Kysely loppuun
Soita turvallisin väliajoin. Käsittelyn aikana API varmistaa, että työ on edelleen käynnissä. Kun se on valmis, se palauttaa tilan ja linkit rikastustulokseen.

Hae tiettyjä rikastetyyppejä
Soita saadaksesi tietyn rikastustuloksen - esimerkiksi yksityiskohtaiset laskutiedot tai Peppol-validointitulokset. Syötä tämä kirjanpitomoottoriin, analytiikkapinoon tai automaatiologiikkaan.

Kaikissa tapauksissa pääsy tähän teknologiaan on suoraviivaista: sama tili- ja suojausmalli kuin transaktioiden sovellusliittymässä ja pieni joukko hyvin määriteltyjä päätepisteitä.

Qvalian sovellusliittymä on rakennettu antamaan sinulle yksinkertaistettu ja skaalautuva yhteys Peppol-verkkoon yritystyypistäsi riippumatta:

Seuraava askel on suoraviivainen: muodosta yhteys hiekkalaatikkoon, lähetä ensimmäinen testilasku ja aloita suunnittelemaan, miten Peppolista, EDI:stä ja rikastamisesta voi tulla sisäänrakennettu osa toimintojasi tai tuotteitasi - eikä erillinen, monimutkainen projekti.