Peppol-rajapinta lyhyesti
API-avaimesta ensimmäiseen pyyntöön
Käyttöönottotiimimme tukee sinua integroinnin ja testauksen aikana.
export ACCOUNT_REG_NO=YOUR_ACCOUNT_REGISTRATION_NUMBER
# Identifies the account in every Transaction API requestKäytä tätä arvoa jokaisen Transaction API -kutsun pyyntöpolussa.
export QVALIA_API_KEY=YOUR_SANDBOX_API_KEY
export QVALIA_BASE_URL=https://api-test.qvalia.comPidä testaus- ja tuotantoympäristön tunnukset erillään toisistaan.
curl -X POST \
${QVALIA_BASE_URL}/transaction/${ACCOUNT_REG_NO}/invoices/outgoing \
-H Authorization:${QVALIA_API_KEY} \
-H Content-Type:application/json \
-d @invoice.jsonVastaus vahvistaa, että asiakirja on vastaanotettu. Vahvistustulokset ja toimitustila ilmoitetaan webhookien tai asiakirjan tilan kautta.
export QVALIA_API_KEY=YOUR_PRODUCTION_API_KEY
export QVALIA_BASE_URL=https://api.qvalia.comSeuraa käsittelyä ja toimitusta webhookien tai asiakirjan tilan avulla.
Yksi tili, kuusi sovellusrajapintaa
Laskutus API
Lähetä ja vastaanota laskuja ja hyvityslaskuja Peppolin kautta, ja varmista niiden oikeellisuus ennen toimitusta.
Tilaa API
Lähetä ja vastaanota ostotilauksia Peppolin kautta, mukaan lukien tilausvastaukset, muutokset ja peruutukset koko tilausprosessin ajan.
Kumppanin API
Luo ja hallinnoi loppuasiakastilejä ja Peppol-tunnuksia omalta alustaltasi, jossa on webhookit asiakirjatapahtumia varten.
OCR API
Pura PDF-laskuista jäsenneltyjä tietoja tarkastelua ja jatkokäsittelyä varten.
Enrichment-sovellusliittymä
Luokittele asiakirjat ja rivitiedot sekä täydennä tapahtumia jäsennellyillä tiedoilla.
Kirjanpito API
Luo kirjausehdotuksia saapuvista laskuista, jotta niiden tarkastelu ja kirjaaminen sujuu nopeammin.
Lisää tapoja olla yhteydessä
Kun API-integraatio ei ole sopiva ratkaisu tai kun tarvitset enemmän kuin pelkkää asiakirjojen vaihtoa.
- SFTP
Vaihda tiedostoja XML- tai CSV-muodossa SFTP:n kautta, kun API-integraatio ei ole mahdollinen. - ERP-liitännät
Valmiit liitännät yleisimpiin ERP- ja kirjanpitojärjestelmiin. - Peppol MCP -palvelin
Tarjoa tekoälyagenteille ja MCP-asiakkaille jäsennelty pääsy tapahtumiin, rivitietoihin, toimitustilaan ja vahvistuksiin. - Punchout
Liitä toimittajan tuoteluettelo ostajan hankintajärjestelmään. - B2B-maksuprosessi
Lisää WooCommerce-verkkokauppaan B2B-maksu- ja laskutusvaihtoehto, jossa toimitus tapahtuu Peppolin kautta.
Peppol-opas kehittäjille
Tällä sivulla käsitellään Qvalian sovellusrajapintoja (API) ja niiden välittämiä Peppol-asiakirjoja. Niiden taustalla oleva Peppol-standardi, mukaan lukien erittelyt, validointisäännöt ja koodiluettelot, on kuvattu Peppol-dokumentaatiossamme ja toteutusoppaassamme. Täydellinen päätepisteviite löytyy osoitteesta api.qvalia.io. Normatiiviset Peppol-erittelyt on julkaistu OpenPeppolin toimesta osoitteessa docs.peppol.eu.
Peppol-asiakirjat ja niiden sovellusrajapinnat
| Asiakirja | Peppol-määrittely | Qvalia-sovellusliittymä |
| Lasku | Peppol BIS Billing 3.0 | Laskutus-API:t |
| Luottoilmoitus | Peppol BIS Billing 3.0, hyvityslasku | Luottotodistusten sovellusrajapinnat |
| Tilaus ja tilausvastaus | Peppol BIS Ordering | Tilaus-API:t, tilausvastaus-API:t |
| Tilaussopimus | Peppol BIS Order Agreement | Tilaussopimusten sovellusrajapinnat |
| Tilauksen muutos ja peruutus | Peppol BIS Advanced Ordering | Tilauksen muutos-API:t, tilauksen peruutus-API:t |
| Lähetysohjeet | Peppol BIS Despatch Advice | Lähetysilmoitusten sovellusrajapinnat |
| Tuoteluettelo | Peppol- BIS Catalogue , johon on vastattu | Luettelon sovellusrajapinnat |
| Toimituksen tila | Viestitason vastaus ja viestitason tila | Viestitason vastausrajapinnat, viestitason tilarajapinnat |
Vahvistus ja virheet
Koodiluettelot
Osoitteiden käsittely ja haku
Testaus ja käyttö
Hiekkalaatikko
Testaa integraatiota omien järjestelmiesi kanssa ilman, että se vaikuttaa todellisiin asiakkaisiin tai rahavirtoihin.
Versiointi
Yhteensopivuutta rikkovat muutokset julkaistaan uutena API-versiona, ja niistä ilmoitetaan vähintään kuukautta etukäteen.
Järjestelmän tila
Tarkista palvelujen nykyinen saatavuus ja häiriötiedot.
Turvallisuus
Lue, miten Qvalia huolehtii tietoturvasta, liiketoiminnan jatkuvuudesta ja luottamuksesta.
Peppol yrityksellesi vai asiakkaillesi?
Peppol-yhteyspiste
Haluat lähettää ja vastaanottaa Peppol-asiakirjoja oman yrityksesi tarpeisiin. Yhdistä Qvalian Peppol-yhteyspisteeseen ja integroi se ERP-järjestelmääsi tai API:n kautta.
Kumppanien ratkaisut
Tarjoa Peppol-palvelua omille asiakkaillesi juuri sinun rooliisi sopivalla mallilla. Integroi Peppol tuotteeseesi Qvalian sovellusrajapinnan (API) avulla tai ylläpidä isännöityä yhteyspistettä omalla Peppol-palveluntarjoajan tunnuksellasi.
Kehittäjien esittämät kysymykset
Lisää käyttöönotto-ohjeita löytyy tietop ankistamme.
Onko käytettävissä testausympäristöä?
Kyllä. Api-test.qvalia.com-sivuston testausympäristössä käytetään erillistä API-avainta, joten voit testata järjestelmää vaikuttamatta todellisiin asiakkaisiin tai rahavirtoihin. Noudata tietopankissa olevaa Peppol-API:n vaiheittaista ohjetta.
Mitä tiedostomuotoja API tukee?
Oletusarvoisesti JSON tai XML. Molemmissa käytetään UBL 2.1 -pohjaisia rakenteita asiaankuuluville Peppol-asiakirjojen päätepisteille. Aseta Content-Type- ja Accept-kentät arvoiksi application/json tai application/xml. Katso Peppol-viestityypit saadaksesi tietoa verkoston tukemista liiketoiminta-asiakirjoista ja prosesseista.
Miten kirjaudun sisään?
Käyttämällä API-avainta Authorization-otsikossa tai lyhytaikaista tunnistetta (JWT), jonka saat /token-päätelaitteesta avaimesi avulla. Saat erilliset avaimet testaus- ja tuotantokäyttöön.
Mistä tiedän, onko asiakirja toimitettu?
Tilaa webhookit tai hae tietoja sovellusrajapinnasta. Qvalia lähettää tapahtumailmoituksia, kun asiakirja saapuu, kun se toimitetaan ja kun toimitus epäonnistuu. Peppol-tason vastausviesteistä on lisätietoja tietopankin kohdassa ”Viestitason tila ”.
Pitääkö minun toteuttaa Peppol-siirto itse?
Ei. Qvalia vastaa tukiaseman toiminnasta sekä vastaanottajan hausta, AS4-siirrosta ja toimituksesta. Lähetät asiakirjan sovellusrajapintaan (API). Lue, miten SMP- ja SML-palvelunetsintä paikantaa vastaanottavan päätepisteen.
Voinko integroida järjestelmän kirjoittamatta koodia?
Kyllä. Käytä ERP-liitintä tai siirrä XML- tai CSV-tiedostoja SFTP:n kautta.
Mitä Peppol-asiakirjoja voin vaihtaa?
Laskut, hyvityslaskut, tilaukset, tilausvastaukset, tilaussopimukset, tilausten muutokset ja peruutukset, lähetysilmoitukset, luettelot ja viestitason vastaukset. Kehittäjille tarkoitetun Peppol-viitteen alla olevassa taulukossa on esitetty kunkin asiakirjatyypin taustalla olevat vaatimukset. Se, mitkä asiakirjatyypit järjestelmäsi sisältää, riippuu valitusta palvelusta ja integraatiosta. Katso yleiskatsaus kohdasta ”Mitkä ovat Peppolin viestityypit?”.
Miten sovellusrajapinta löytää vastaanottajan päätepisteen?
Qvalia käyttää vastaanottajan palvelun metatietojen julkaisijan tunnistetta ( Peppol ID ) paikantaakseen palvelun metatietojen julkaisijan (SMP) palvelun metatietojen paikantimen (SML) avulla. SMP palauttaa toimittamiseen tarvittavat asiakirjan ominaisuudet sekä prosessi- ja siirtopäätelaitteen. Lue artikkeli ”Peppol SMP ja SML: miten palvelujen paikannus toimii”.
Mitä tapahtuu, kun asiakirja ei läpäise Peppol-validointia?
Asiakirja, jossa on vakava validointivirhe, on korjattava ennen sen lähettämistä. Virhekoodi ilmaisee sääntökokonaisuuden ja sen asiakirjan osan, jota on tarkasteltava tarkemmin. Katso kohdat ”Peppol-validoinnin toiminta” ja ”Peppol-validointisääntökoodit”.
Miten voin tarkistaa vastaanottajan Peppol ID - ja asiakirjojen käsittelyominaisuudet?
Käytä Qvalian ”Peppol ID ” -hakua löytääksesi hakemistoon julkaistut osallistujat ja asiakirjojen ominaisuudet. Tunnisteiden rakenteesta ja järjestelmistä on lisätietoja tietopankin artikkelissa ”Mikä on Peppol ID? ”.