Aika siirtyä hiekkalaatikkoon
Aukioloajat
Tarkista toimivuus omien järjestelmiesi ja Peppolin testiverkon avulla.
Aika käynnistää
Päiviä tai viikkoja
Käynnistä integrointisi ja release -prosessisi mukaisesti.
Käyttörajoitus
Sovittu kumppanin kanssa
Kapasiteetti on varattu kumppanikohtaisesti.
Palveluntarjoajan rooli
Qvalia
Qvalia vastaa Access Pointin, SMP:n ja verkon hallinnoinnin toiminnasta.
Tekninen tuki
Kolmas rivi
Qvalia tarjoaa kolmannen tason teknistä tukea.
Suunniteltu
ERP-järjestelmien toimittajat · Laskutus- ja kirjanpito-ohjelmistot · CRM-järjestelmät · VAN -palveluntarjoajat
B2B-markkinapaikat · Kirjanpitotoimistot · IT-konsulttiyritykset
Teidän tuotteenne, meidän infrastruktuurimme
Kumppanit kehittävät ja vastaavat käyttökokemuksesta. Qvalia ylläpitää Access Pointia, SMP:tä ja niiden taustalla toimivaa viestinvälitysinfrastruktuuria, joihin pääsee yhden sovellusrajapinnan (API) kautta.
Sinä hallitset asiakaskokemusta, sopimusta ja hinnoittelua. Qvalia hoitaa Peppol-palvelun käyttöliittymäsi taustalla.
Me hoidamme toimintaa, sinä omistat sen
Mitä Qvalia tarjoaa
- Tukiasema ja SMP Qvalian Peppol-palveluntarjoajan roolissa
- Viestien tarkistaminen, muodon muuntaminen ja toimittaminen verkon kautta
- Osallistujien rekisteröinti ja haku
- Seuranta, päivitykset ja verkon vaatimustenmukaisuus
Mitä sinulla on
- Käyttöliittymä, jota asiakkaasi käyttävät oman tuotteesi sisällä
- Asiakassuhde, sopimus ja hinnoittelu
- Oma perehdytys- ja tukiprosessisi
Kumppani-API:n työnkulku
Partner API kattaa järjestelmän todennuksen, asiakastietojen määrittämisen, asiakirjojen lähettämisen sekä saapuvien viestien käsittelyn. Qvalia huolehtii Peppol-siirroista, palvelujen löytämisestä, validoinnista ja varmenteiden hallinnasta.
1. Kirjaudu sisään
Kumppanijärjestelmät todentavat itsensä API-avaimella tai vaihtavat sen lyhytaikaiseksi JWT-tunnukseksi. Yksi tunnistetieto kattaa Transaction-, Partner-, Account- ja Enrichment-rajapinnat.
curl --location --globoff -X POST \
'https://api.qvalia.com/token' \
--data '{
"client_id": "{partnerRegNo}",
"client_secret": "{apiKey}"
}'
# Valid for one hour. Send it on every call:
# Authorization: Bearer <token>2. Luo asiakas
Luo tili ja rekisteröi sen Peppol-osallistujan tunniste. Qvalia huolehtii osallistujien rekisteröinnistä ja hakemistopäivityksistä
curl --location --globoff -X POST \
'https://api.qvalia.com/partner/{partnerRegNo}/account' \
--header 'Authorization: Bearer <token>' \
--data '{
"accountRegNo": "5567321707",
"name": "Nordkap Logistik AB",
"address": "Wallingatan 33",
"postalCode": "111 24",
"country": "SE"
}'
curl --location --globoff -X PUT \
'https://api.qvalia.com/partner/{partnerRegNo}/account/5567321707/peppol/0007:5567321707' \
--header 'Authorization: Bearer <token>'3. Viestien lähettäminen ja vastaanottaminen
Asiakirjat tarkistetaan sovellettavien Peppol-määritysten mukaisesti ennen lähettämistä. Järjestelmälliset tarkistusvastaukset lähetetään takaisin järjestelmääsi, ja saapuvat viestit ovat saatavilla saman tilin kautta.
curl --location --globoff -X POST \
'https://api.qvalia.com/partner/{partnerRegNo}/transaction/5567321707/invoices/outgoing' \
--header 'Authorization: Bearer <token>' \
--data '{ "Invoice": { } }'
# 200
# { "status": "success", "data": { "message": "invoice 12335675 sent" } }4. Tilaa tapahtumat
Tilaa asiakirjojen tapahtumien seuranta webhookien avulla. Qvalia lähettää ilmoituksen päätepisteeseesi, kun asiakirja saapuu, kun toimitustila muuttuu ja kun toimitus epäonnistuu.
curl --location --globoff -X PUT \
'https://api.qvalia.com/partner/{partnerRegNo}/webhook/configure' \
--header 'Authorization: Bearer <token>' \
--data '{
"url": "https://your-platform.example/qvalia/events",
"events": ["new_document", "document_delivery", "document_error"]
}'
# Delivered as HTTPS POST with a JSON body.
# Respond 2xx within 10 seconds.| Tekniset tiedot | Yksityiskohdat |
| Liikenne | Peppol AS4 -siirron, ebMS-viestinvälityksen ja PKI-varmenteiden hallinnan hoitaa Qvalia. |
| Vasteaika | API:n vasteaika riippuu datan koosta ja yhteydestä. Peppol-lähetys tapahtuu asynkronisesti ja riippuu vastaanottavasta yhteyspisteestä. |
| Merkittäviä muutoksia | Yhteensopivuutta rikkovat muutokset julkaistaan uutena API-versiona vähintään kuukauden varoitusajalla, yleensä pidemmälläkin |
Usean käyttäjän tilimallit
Valitse joko yhtenäinen järjestelmä tai erillinen tili jokaiselle asiakkaalle rekisteröitymisen, tietojen erottelun ja käyttäjähallinnan vaatimusten perusteella.
| Konsolidoitu | Tili vuokralaiskohtaisesti | |
| Peppolin rekisteröinti | Yhteiskäytössä oleva kokoonpano, jota hallinnoit itse | Oma tili ja ” Peppol ID ” (Omat tiedot) kunkin loppuasiakkaan kohdalla |
| Tiedot ja käyttäjät | Hallitaan yhdessä alustallanne | Erilliset tiedot, käyttäjät ja asetukset jokaiselle vuokralaiselle |
| Käyttöönotto | Nopein tapa lisätä asiakas | Qvalia huolehtii osallistujien rekisteröinnistä ja osallistujaluettelon päivityksistä |
| Istuvuus | Monet pienasiakkaat yhden tarjoamasi palvelun piirissä | Asiakkaat, jotka tarvitsevat oman Peppol-tunnuksen ja kirjausketjun |
Molemmissa malleissa voit hallita käyttöönottokokemusta. Tilimalli määrittää osallistujien rekisteröinnin ja tietojen erottelun.
Tuetut liiketoimintadokumentit
Sama integraatio tukee käytettävissä olevia laskutus-, tilaus- ja niihin liittyviä liiketoimintadokumenttien virtoja.
| Asiakirja | Peppol-nimi | Yksityiskohdat |
| Lasku | Lasku | Maksuvaatimus, jossa on erittely, verot ja maksuehdot |
| Luottoilmoitus | Hyvityslasku | Jo lähetetyn laskun korjaus tai peruutus |
| Itse laskutettava lasku | Itse laskutettava lasku | Ostajan toimittajan puolesta laatima lasku |
| Itse laskutettava hyvityslasku | Itse laskutettava hyvityslasku | Itse laskutetun laskun vastaava hyvityslasku |
| Tilaus | Tilaus | Ostajan toimittajalle lähettämä ostotilaus |
| Tilausvastaus | Tilausvastaus | Tilauksen hyväksyminen, hylkääminen tai muuttaminen |
| Tilaussopimus | Tilaussopimus | Puitesopimus, johon myöhemmissä tilauksissa viitataan |
| Tilauksen muutos | Tilauksen muutos | Jo lähetetyn määräyksen muutos |
| Tilauksen peruutus | Tilauksen peruutus | Jo lähetetyn tilauksen peruuttaminen |
| Lähetysohjeet | Lähetysilmoitus | Mitä on tosiasiallisesti toimitettu, ja mihin tilaukseen liittyen |
| Tuoteluettelo | Tuoteluettelo | Tuotteet, kuvaukset ja sovitut hinnat |
| Vastaus luetteloon | CatalogueResponse | Luettelon hyväksyminen tai hylkääminen |
| Vastaus viestitasolla | Viestitason vastaus | Viestin tekninen vahvistus tai hylkääminen |
| Viestitason tila | Viestin tilatiedot | Viestin käsittelytilanne verkossa |
Punchout, PDF- ja EDI-palvelut voivat käyttää samaa tilirakennetta. Qvalia huolehtii tietojen tarkistuksesta, reitityksestä, toimituksesta ja verkkotason virheiden käsittelystä.
Jäsennelty transaktiotieto
Asiakirjat ovat saatavilla jäsenneltyinä transaktiotietoina raportointia, analytiikkaa ja kirjanpidon automatisointia varten.
Laskurivi, sellaisena kuin se on vastaanotettu
ART 4471-B
Printing paper A4 80G 5X500
12 pcs 489,00 SEKSama rivi, luokiteltu
| UNSPSC | 14111507 Kirjoituspaperi |
| Luokka | Toimistotarvikkeet |
| Yksikkö | 12 × 2 500 arkkia |
| Yksikköhinta | 40.75 SEK |
| Toimittaja | Yhdistetty perustietoihin |
Erät voidaan jäsentää ja luokitella reaaliajassa, kun perustiedot on kytketty tapahtumavirtaan. Tämä tukee raportoinnin, kuluanalytiikan ja kirjanpidon automatisointia tuotteessasi. OCR, automatisoitu kirjanpito ja luokittelun täydennys ovat saatavilla lisäosina.
Peppol-vaatimusten noudattamiseen liittyvät velvollisuudet
Qvalia toimii Embedded Peppol -palvelun Peppol-palveluntarjoajana. Kumppani vastaa edelleen asiakassuhteistaan ja kaupallisesta tarjonnastaan. Vain aktiivisille oikeushenkilöille voidaan myöntää Peppol ID-tunnus.
| Vastuu | Qvalia | Sinä |
| Sertifioidun Peppol-palveluntarjoajan rooli | Qvalia | |
| Tukiasema ja SMP-toiminta | Qvalia | |
| Peppol-sertifiointi, auditoinnit ja verkon hallinnointi | Qvalia | |
| ISO/IEC 27001:2022- ja ISO 22301:2019 -hallintajärjestelmät | Qvalia | |
| Asiakkaan tuntemisvelvollisuus | Kumppani | |
| Varmistetaan, että asiakkaat eivät ole poistettu rekisteristä, maksukyvyttömiä tai rikkoneet rahanpesun torjuntaa koskevia vaatimuksia | Kumppani | |
| Loppuasiakassopimus, hinnoittelu ja kaupalliset suhteet | Kumppani |
Tämä koskee sekä Embedded Peppol -palvelua että white-label-alustaa. Kumppanit, joiden on toimittava Peppol-palveluntarjoajana omalla nimellään, tulisi sen sijaan tutustua Hosted Access Point -palveluun.
Usein kysytyt kysymykset
Mitä ”Embedded Peppol” tarkoittaa käytännössä?
Tarjoat omille asiakkaillesi Peppol-yhteyden ja standardien mukaisen liiketoimintaviestien vaihdon, jotka on integroitu tuotteeseesi sovellusrajapinnan (API) kautta. Qvalia ylläpitää Peppol-infrastruktuuria taustalla. Asiakassuhde ja palvelutarjonta ovat sinun vastuullasi.
Pitääkö meidän huolehtia Peppol-vaatimusten noudattamisesta itse?
Ei. Embedded Peppol -ratkaisussa Qvalia toimii Peppol-palveluntarjoajana ja ylläpitää liityntäpistettä sekä SMP:tä. Qvalia huolehtii palvelun Peppol-verkon hallinnosta ja teknisestä vaatimustenmukaisuudesta. Sinä olet edelleen vastuussa loppuasiakassopimuksista, käyttöönottotiedoista, hinnoittelusta ja tuesta. Kumppanien, joiden on toimittava palveluntarjoajana omalla nimellään, tulisi harkita Hosted Access Point -ratkaisua.
Miten tuette monen käyttäjän Peppol-asetuksia?
Qvalia tukee sekä konsolidoituja että monikäyttäjämalleja. Voit hallinnoida useita loppuasiakkaita jaetussa ympäristössä tai tarjota jokaiselle asiakkaalle erillisen tilin ja Peppol-tunnuksen.
Mitä Peppol-viestityyppejä voimme tarjota käyttäjillemme ja loppuasiakkaillemme?
Laskut, hyvityslaskut, tilaukset, tilausvastaukset, lähetysilmoitukset, tuoteluettelot ja niihin liittyvät liiketoimintaviestit sekä punchout. Qvalia huolehtii validoinnista, reitityksestä, toimituksesta ja virheiden käsittelystä koko verkostossa. PDF- ja EDI-tiedostot käsitellään saman tilirakenteen kautta.
Miten loppuasiakkaat otetaan mukaan ja hallitaan?
Loppuasiakkaille annetaan omat Peppol-tunnukset ja reitityssäännöt käyttöönoton yhteydessä. Qvalia hoitaa taustalla osallistujien rekisteröinnin, hakemistopäivitykset ja verkkomääritykset, kun taas sinä hallitset käyttöönottokokemusta.
Pitääkö meidän tarkistaa saapuvat asiakirjat?
Ei. Tilaa webhook-tapahtumat ja Qvalia-ilmoitukset päätepisteeseesi, kun Peppol-viesti tai -asiakirja saapuu, kun sen toimitustila muuttuu ja kun toimitus epäonnistuu. Vaihtoehtona ovat myös polling-päätepisteet.
Voimmeko tarjota muutakin kuin viestien vaihtoa?
Kyllä. Jokainen tapahtuma on saatavilla jäsenneltynä datana, jossa on rivikohtainen luokittelu. Tämän ansiosta voit integroida raportointitoiminnot, kuluanalyysit ja automatisoidun kirjanpidon omaan tuotteeseesi sen sijaan, että siirtäisit pelkästään asiakirjoja. OCR, automatisoitu kirjanpito ja luokittelun täydennys ovat saatavilla lisäominaisuuksina.
Onko käyttörajoituksia?
Kyllä. Kumppanitileille myönnetään huomattavasti tavallisia tilirajoja suuremmat kiintiöt, ja rajaa mukautetaan odotetun volyymin mukaan. Jos suunnittelet laajamittaista asiakashankintaa tai kiireistä kuunloppua, ota meihin yhteyttä.
Kuinka pian voimme aloittaa?
Sandbox-käyttöoikeus myönnetään yleensä muutaman tunnin kuluessa. Tuotantokäyttöönotto riippuu integraatiosta, testauksesta sekä asiakkaan omasta release -prosessista.
Miten integraatio on toteutettu?
Alusta integroidaan REST-rajapintojen kautta. Järjestelmän todennus perustuu OAuth 2.0 -asiakastunnistetietoihin. Käyttäjien kertakirjautuminen (SSO) määritetään erikseen tuettujen tunnistautumisvaihtoehtojen kautta. Jos et tarvitse käyttöliittymää tuotteesi sisällä, white label -alusta tarjoaa Qvalian sovelluksen omalla brändilläsi.
Vaihtoehtoiset ratkaisut
Valitse White-label-alusta, jos haluat kattavan sovelluksen, tai Hosted Access Point, jos organisaatiosi haluaa toimia palveluntarjoajana.
Haluat tuotteen, et sen kokoonpanoa
White-label-alusta on Qvalian kattava sovellus, joka toimii asiakkaan brändin, verkkotunnuksen ja hinnoittelun alla. Se tarjoaa täydellisen käyttöliittymän ilman erillistä kehityshanketta.
Sinun on toimittava palveluntarjoajana omalla nimelläsi
Hosted Access Point -palvelun avulla sinusta tulee sertifioitu Peppol-palveluntarjoaja, jolla on oma Access Point -tunnus ja PKI-varmenne Qvalian ylläpitämässä infrastruktuurissa.
Ota yhteyttä
Integroi verkkolaskutus, sähköinen tilaus ja tietojen rikastaminen järjestelmääsi Qvalian avulla.
Kumppani-API:n, kehittyneiden hallintatyökalujen ja white label -ratkaisujen avulla voit tarjota saumatonta tapahtumien hallintaa loppukäyttäjille.
Tee yhteistyötä kanssamme, jotta voit laajentaa alustasi ominaisuuksia ja edistää digitaalista muutosta. Ota meihin yhteyttä saadaksesi lisätietoja.
Vaihda liiketoiminta-asiakirjoja Peppolin, EDI:n ja muiden välineiden kautta.
Mahdollistaa tekoälypohjaisen tietojen rikastamisen rivikohtaisella tasolla.
Laajenna tuotetarjontaasi ja käytettävyyttäsi