Čas na sandbox
Otváracie hodiny
Overte si funkčnosť vo vašich vlastných systémoch a v testovacej sieti Peppol.
Je čas na štart
Dni až týždne
Spustite v súlade s vašou integráciou a procesom „ release “.
Obmedzenie počtu požiadaviek
Dohodnuté s každým partnerom
Kapacita pridelená jednotlivým partnerom.
Úloha poskytovateľa služieb
Qvalia
Spoločnosť Qvalia prevádzkuje prístupový bod, SMP a riadenie siete.
Technická podpora
Tretí riadok
Spoločnosť Qvalia poskytuje technickú podporu tretej úrovne.
Určené pre
Poskytovatelia ERP systémov · Softvér na fakturáciu a účtovníctvo · Systémy CRM · Prevádzkovatelia služieb typu „ VAN “
B2B trhoviská · Účtovné agentúry · IT poradenské spoločnosti
Váš produkt, naša infraštruktúra
Partneri vytvárajú a zodpovedajú za používateľský zážitok. Spoločnosť Qvalia prevádzkuje Access Point, SMP a súvisiacu infraštruktúru pre zasielanie správ, ku ktorej je prístup prostredníctvom jedného API.
Vy máte pod kontrolou zákaznícku skúsenosť, zmluvu a cenotvorbu. Spoločnosť Qvalia prevádzkuje službu Peppol v pozadí vášho rozhrania.
Čo prevádzkujeme, čo vlastníte
Čo Qvalia prevádzkuje
- Prístupový bod a SMP v rámci úlohy poskytovateľa služieb Peppol spoločnosti Qvalia
- Overovanie správ, konverzia formátu a doručovanie v rámci siete
- Registrácia a vyhľadávanie účastníkov
- Monitorovanie, aktualizácie a súlad so sieťovými požiadavkami
Čo vlastníte
- Rozhranie, ktoré používajú vaši zákazníci v rámci vášho vlastného produktu
- Vzťahy so zákazníkmi, zmluvy a cenotvorba
- Váš vlastný proces zaškolenia a podpory
Pracovný postup partnerského rozhrania API
Partnerské rozhranie API zahŕňa systémovú autentizáciu, nastavenie zákazníka, odosielanie dokumentov a spracovanie prichádzajúcich správ. Spoločnosť Qvalia zabezpečuje prenos, vyhľadávanie, validáciu a správu certifikátov v rámci systému Peppol.
1. Prihláste sa
Partnerské systémy sa overujú pomocou kľúča API alebo si ho vymieňajú za JWT s krátkou platnosťou. Jedno overovacie údaje pokrývajú rozhrania API pre transakcie, partnerov, účty a obohacovanie údajov.
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. Vytvorte zákazníka
Vytvorte účet a zaregistrujte jeho identifikátor účastníka Peppol. Spoločnosť Qvalia spravuje registráciu účastníkov a aktualizácie adresára.
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. Odosielanie a prijímanie správ
Pred odoslaním sa dokumenty overujú podľa platných špecifikácií Peppol. Štruktúrované odpovede z overovania sa odosielajú späť do vášho systému a prichádzajúce správy sú k dispozícii prostredníctvom toho istého účtu.
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. Prihlásiť sa na odber udalostí
Prihláste sa na odber udalostí týkajúcich sa dokumentov prostredníctvom webhookov. Qvalia odosiela správy na váš koncový bod pri príchode dokumentu, pri zmene stavu doručenia a v prípade zlyhania doručenia.
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.| Špecifikácia | Podrobnosti |
| Doprava | Prepravu dát prostredníctvom protokolu Peppol AS4, zasielanie správ prostredníctvom protokolu ebMS a správu certifikátov PKI zabezpečuje spoločnosť Qvalia. |
| Doba odozvy | Doba odozvy rozhrania API závisí od veľkosti dátovej časti a kvality pripojenia. Doručovanie prostredníctvom Peppolu prebieha asynchrónne a závisí od prijímajúceho prístupového bodu. |
| Zmeny s nekompatibilnými dôsledkami | Zmeny s nekompatibilnými dopadmi sa zavádzajú ako nová verzia API s najmenej mesačným predstihom, zvyčajne aj s dlhším |
Modely účtov pre viacerých používateľov
Vyberte si konsolidované nastavenie alebo samostatný účet pre každého zákazníka v závislosti od požiadaviek na registráciu, oddelenie údajov a správu používateľov.
| Konsolidované | Účet na nájomcu | |
| Registrácia v systéme Peppol | Spoločné nastavenie, ktoré spravujete vy | Vlastný účet a Peppol ID pre každého konečného zákazníka |
| Údaje a používatelia | Spravované spoločne na vašej platforme | Samostatné údaje, používatelia a nastavenia pre každého nájomcu |
| Začlenenie | Najrýchlejší spôsob, ako pridať zákazníka | Registráciu účastníkov a aktualizáciu zoznamu zabezpečuje spoločnosť Qvalia |
| Vhodné | Mnoho malých zákazníkov v rámci jednej služby, ktorú prevádzkujete | Zákazníci, ktorí potrebujú vlastnú identitu v systéme Peppol a auditovú stopu |
V oboch modeloch máte kontrolu nad procesom zapojenia nových účastníkov. Model účtu určuje registráciu účastníkov a oddelenie údajov.
Podporované obchodné dokumenty
Táto integrácia podporuje dostupné procesy fakturácie, objednávania a súvisiacich obchodných dokumentov.
| Dokument | Názov Peppol | Podrobnosti |
| Faktúra | Faktúra | Výzva na úhradu s jednotlivými položkami, daňou a platobnými podmienkami |
| Dobropis | Doplnok k faktúre | Oprava alebo zrušenie už odoslanej faktúry |
| Faktúra na základe vlastného vyúčtovania | Faktúra na základe vlastného vyúčtovania | Faktúra, ktorú kupujúci vystaví v mene dodávateľa |
| Kreditná nota na základe vlastnej fakturácie | Samostatná faktúra – dobropis | Odpovedajúci dobropis k faktúre vystavenej na základe vlastného vyúčtovania |
| Objednávka | Objednávka | Objednávka od kupujúceho pre dodávateľa |
| Odpoveď na objednávku | Odpoveď na objednávku | Prijatie, zamietnutie alebo úprava objednávky |
| Objednávková zmluva | Objednávka a zmluva | Rámcová zmluva, na ktorú sa odvolávajú neskoršie objednávky |
| Zmena objednávky | Zmena objednávky | Zmena a doplnenie už odoslaného príkazu |
| Zrušenie objednávky | Zrušenie objednávky | Stornovanie už odoslanej objednávky |
| Oznámenie o odoslaní | Oznámenie o odoslaní | Čo bolo skutočne odoslané a na základe akej objednávky |
| Katalóg | Katalóg | Produkty, popisy a dohodnuté ceny |
| Odpoveď na katalóg | Odpoveď na katalóg | Schválenie alebo zamietnutie katalógu |
| Odpoveď na úrovni správy | Odpoveď na úrovni správy | Technické potvrdenie alebo odmietnutie správy |
| Stav na úrovni správy | Stav na úrovni správy | Stav spracovania správy v sieti |
Punchout, Služby PDF a EDI môžu využívať rovnakú štruktúru účtov. Qvalia zabezpečuje overovanie, smerovanie, doručovanie a riešenie chýb na úrovni siete.
Štruktúrované údaje o transakciách
Dokumenty sú k dispozícii vo forme štruktúrovaných transakčných údajov na účely vykazovania, analýzy a automatizácie účtovníctva.
Položka faktúry, tak ako bola prijatá
ART 4471-B
Printing paper A4 80G 5X500
12 pcs 489,00 SEKV tom istom riadku, utajené
| UNSPSC | 14111507 Kopírovací papier |
| Kategória | Kancelárske potreby |
| Jednotka | 12 × 2 500 listov |
| Jednotková cena | 40.75 SEK |
| Dodávateľ | Porovnané s kmeňovými údajmi |
Položky faktúr je možné štruktúrovať a klasifikovať v reálnom čase, pričom kmeňové údaje sú prepojené s tokom transakcií. To vo vašom produkte podporuje vykazovanie, analýzu výdavkov a automatizáciu účtovníctva. Ako doplnkové funkcie sú k dispozícii OCR, automatizované účtovníctvo a obohatenie klasifikácie.
Povinnosti súvisiace s dodržiavaním štandardu Peppol
Spoločnosť Qvalia zastáva úlohu poskytovateľa služieb Peppol v rámci systému Embedded Peppol. Partner naďalej nesie zodpovednosť za vzťahy so svojimi zákazníkmi a za komerčnú ponuku. Číslo „ Peppol ID “ môže byť pridelené iba aktívnym právnickým osobám.
| Zodpovednosť | Qvalia | Ty |
| Úloha certifikovaného poskytovateľa služieb Peppol | Qvalia | |
| Prístupový bod a prevádzka SMP | Qvalia | |
| Certifikácia Peppol, audity a správa siete | Qvalia | |
| Systémy riadenia podľa noriem ISO/IEC 27001:2022 a ISO 22301:2019 | Qvalia | |
| Overovanie totožnosti zákazníka | Partner | |
| Overenie, či zákazníci nie sú vyškrtnutí z registra, nie sú v platobnej neschopnosti ani neporušujú požiadavky v oblasti boja proti praniu špinavých peňazí | Partner | |
| Zmluva s konečným zákazníkom, cenotvorba a obchodné vzťahy | Partner |
Toto platí pre Embedded Peppol aj pre platformu typu „white-label“. Partneri, ktorí potrebujú zastávať úlohu poskytovateľa služieb Peppol vo vlastnom mene, by sa mali skôr zamerať na službu Hosted Access Point.
Často kladené otázky
Čo v praxi znamená pojem „Embedded Peppol“?
Svojim zákazníkom ponúkate prepojenie s Peppolom a výmenu obchodných správ v súlade s normami, ktoré sú prostredníctvom API integrované do vášho produktu. Spoločnosť Qvalia prevádzkuje infraštruktúru Peppol v pozadí. Vy ste vlastníkom vzťahu so zákazníkmi a ponuky.
Musíme si dodržiavanie požiadaviek Peppol zabezpečovať sami?
Nie. V rámci riešenia Embedded Peppol spoločnosť Qvalia zastáva úlohu poskytovateľa služieb Peppol a prevádzkuje prístupový bod a SMP. Spoločnosť Qvalia zabezpečuje riadenie siete Peppol a technickú zhodu tejto služby. Vy naďalej nesiete zodpovednosť za zmluvy s konečnými zákazníkmi, informácie potrebné na registráciu, cenotvorbu a podporu. Partneri, ktorí potrebujú zastávať úlohu poskytovateľa služieb vo vlastnom mene, by mali zvážiť riešenie Hosted Access Point.
Ako podporujete multi-tenantné nastavenia Peppol?
Qvalia podporuje konsolidované aj multi-tenantové modely. Môžete spravovať viacerých koncových zákazníkov v zdieľanom prostredí alebo pre každého zákazníka vytvoriť samostatný účet a prideliť mu vlastné Peppol ID.
Aké typy správ Peppol môžeme ponúknuť našim používateľom a konečným zákazníkom?
Faktúry, dobropisy, objednávky, potvrdenia objednávok, oznámenia o expedícii, katalógy a súvisiace obchodné správy, ako aj punchout. Qvalia zabezpečuje overovanie, smerovanie, doručovanie a riešenie chýb v rámci celej siete. Formáty PDF a EDI prechádzajú cez tú istú štruktúru účtov.
Ako sa zapájajú a spravujú koncoví zákazníci?
Koncovým zákazníkom sa počas procesu zapojenia prideľujú vlastné identifikátory Peppol a smerovacie pravidlá. Spoločnosť Qvalia v pozadí spravuje registráciu účastníkov, aktualizácie adresára a konfiguráciu siete, zatiaľ čo vy máte pod kontrolou celý proces zapojenia.
Musíme vykonávať dotazovanie na prichádzajúce dokumenty?
Nie. Prihláste sa na odber udalostí webhookov a správ Qvalia na váš koncový bod v prípade doručenia správy alebo dokumentu Peppol, pri zmene stavu doručenia a v prípade zlyhania doručenia. Ako alternatíva sú k dispozícii koncové body s periodickým dotazovaním.
Môžeme ponúknuť viac než len výmenu správ?
Áno. Každá transakcia je k dispozícii vo forme štruktúrovaných údajov s klasifikáciou jednotlivých položiek, čo vám umožňuje integrovať do vášho vlastného produktu funkcie vykazovania, analýzy výdavkov a automatizovaného účtovníctva, a nie len prenášať dokumenty. OCR, automatizované účtovníctvo a obohatenie klasifikácie sú k dispozícii ako doplnkové funkcie.
Existujú nejaké obmedzenia rýchlosti?
Áno. Partnerské účty sú nastavené s limitmi výrazne prevyšujúcimi štandardné limity účtov a limit sa prispôsobuje vášmu predpokladanému objemu transakcií. Ak plánujete rozsiahle zaradenie nových zákazníkov alebo náročný koniec mesiaca, kontaktujte nás.
Ako rýchlo môžeme začať?
Prístup do testovacieho prostredia je zvyčajne k dispozícii v priebehu niekoľkých hodín. Spustenie do prevádzky závisí od integrácie, testovania a vášho procesu schvaľovania ( release ).
Ako prebieha integrácia?
Platforma je integrovaná prostredníctvom rozhraní REST API. Systémové overovanie používa klientske poverenia OAuth 2.0. Jednorazové prihlásenie (SSO) používateľov sa konfiguruje samostatne prostredníctvom podporovaných možností overovania identity. Ak vo vašom produkte nepotrebujete toto rozhranie, platforma typu „white-label“ poskytuje aplikáciu Qvalia pod vašou značkou.
Alternatívne riešenia
Zvoľte si platformu typu „white-label“ pre kompletnú aplikáciu alebo riešenie „Hosted Access Point“, ak má vaša organizácia plniť úlohu poskytovateľa služieb.
Chcete ten produkt, nie jeho zostavenie
Platforma typu „white-label“ je kompletná aplikácia spoločnosti Qvalia, ktorá funguje pod vašou značkou, doménou a cenovou politikou. Ponúka plnohodnotné rozhranie bez nutnosti vývojového projektu.
Musíte byť poskytovateľom vo vlastnom mene
Vďaka službe „Hosted Access Point“ sa stanete certifikovaným poskytovateľom služieb Peppol s vlastnou identitou prístupového bodu a certifikátom PKI, a to v rámci infraštruktúry, ktorú prevádzkuje spoločnosť Qvalia.
Kontaktujte nás
Integrujte elektronickú fakturáciu, elektronické objednávanie a obohacovanie údajov do svojej platformy s Qvalia.
Naše partnerské API, pokročilé nástroje pre správu a riešenia white label vám umožňujú ponúkať vašim koncovým používateľom plynulú správu transakcií.
Spolupracujte s nami, aby ste rozšírili možnosti svojej platformy a podporili digitálnu transformáciu. Kontaktujte nás a zistite viac.
Výmena obchodných dokumentov prostredníctvom Peppol, EDI a ďalších systémov
Aktivujte obohacovanie údajov pomocou umelej inteligencie na úrovni jednotlivých položiek
Rozšírte svoju ponuku produktov a ich použiteľnosť