Je čas na sandbox
Otevírací doba
Ověřte si funkčnost ve svých vlastních systémech a v testovací síti Peppol.
Je čas na start
Dny až týdny
Spusťte proces v souladu s vaší integrací a procesem „ release “.
Omezení počtu požadavků
Dohodnuto s každým partnerem zvlášť
Kapacita přidělená jednotlivým partnerům.
Role poskytovatele služeb
Qvalia
Společnost Qvalia zajišťuje provoz přístupového bodu, SMP a správu sítě.
Technická podpora
Třetí řádek
Společnost Qvalia poskytuje technickou podporu třetí úrovně.
Určeno pro
Poskytovatelé ERP systémů · Software pro fakturaci a účetnictví · Systémy CRM · Provozovatelé webových stránek typu „ VAN “
B2B tržiště · Účetní kanceláře · IT poradenské společnosti
Váš produkt, naše infrastruktura
Partneři vytvářejí a zodpovídají za uživatelský zážitek. Společnost Qvalia provozuje Access Point, SMP a související infrastrukturu pro zasílání zpráv, ke kterým se přistupuje prostřednictvím jediného API.
Vy máte pod kontrolou zákaznickou zkušenost, smlouvu i cenovou politiku. Společnost Qvalia zajišťuje provoz služby Peppol v pozadí vašeho rozhraní.
Co provozujeme, to vám patří
Co Qvalia provozuje
- Přístupový bod a SMP v rámci role poskytovatele služeb Peppol společnosti Qvalia
- Ověřování zpráv, převod formátu a doručování v rámci sítě
- Registrace a vyhledávání účastníků
- Monitorování, aktualizace a dodržování síťových předpisů
Co vlastníte
- Rozhraní, které vaši zákazníci používají v rámci vašeho vlastního produktu
- Vztahy se zákazníky, smlouvy a cenová politika
- Váš vlastní proces zapracování a podpory
Pracovní postup partnerského API
Partnerské API zahrnuje systémové ověřování, nastavení zákazníků, odesílání dokumentů a zpracování příchozích zpráv. Společnost Qvalia zajišťuje přenos, vyhledávání, ověřování a správu certifikátů v rámci systému Peppol.
1. Přihlásit se
Partnerské systémy se autentizují pomocí klíče API nebo jej vymění za krátkodobý token JWT. Jedna sada přihlašovacích údajů pokrývá rozhraní API pro transakce, partnery, účty a obohacování dat.
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. Vytvořte zákazníka
Vytvořte účet a zaregistrujte jeho identifikátor účastníka Peppol. Společnost Qvalia spravuje registraci účastníků a aktualizace adresáře.
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. Odesílání a přijímání zpráv
Dokumenty jsou před odesláním ověřeny podle platných specifikací Peppol. Strukturované odpovědi z ověření jsou zaslány zpět do vašeho systému a příchozí zprávy jsou k dispozici prostřednictvím stejné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. Přihlásit se k odběru událostí
Přihlaste se k odběru událostí týkajících se dokumentů pomocí webhooků. Qvalia odesílá zprávy na váš koncový bod, když dorazí dokument, když se změní stav doručení a když dojde k selhání doručení.
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.| Specifikace | Podrobnosti |
| Doprava | Přenos dat prostřednictvím protokolu Peppol AS4, zasílání zpráv prostřednictvím protokolu ebMS a správu certifikátů PKI zajišťuje společnost Qvalia. |
| Doba odezvy | Doba odezvy API závisí na velikosti datového obsahu a kvalitě připojení. Doručování prostřednictvím Peppolu probíhá asynchronně a závisí na přijímajícím přístupovém bodu. |
| Zásadní změny | Zásadní změny jsou vydávány jako nová verze API s minimálně měsíčním předběžným oznámením, obvykle s delším předstihem |
Modely účtů pro více nájemců
Vyberte si buď konsolidované nastavení, nebo samostatný účet pro každého zákazníka, a to v závislosti na požadavcích týkajících se registrace, oddělení dat a správy uživatelů.
| Konsolidované | Účet pro každého nájemce | |
| Registrace v systému Peppol | Sdílené nastavení, které spravujete vy | Vlastní účet a Peppol ID pro každého koncového zákazníka |
| Data a uživatelé | Společná správa na vaší platformě | Samostatná data, uživatelé a nastavení pro každého nájemce |
| Zaškolení | Nejrychlejší způsob, jak přidat zákazníka | Registraci účastníků a aktualizace seznamu účastníků zajišťuje společnost Qvalia |
| Vhodné | Mnoho malých zákazníků v rámci jedné služby, kterou provozujete | Zákazníci, kteří potřebují vlastní identitu Peppol a auditní stopu |
V obou modelech máte kontrolu nad procesem zapojení nových uživatelů. Model účtu určuje způsob registrace účastníků a oddělení dat.
Podporované obchodní dokumenty
Tato integrace podporuje dostupné procesy fakturace, objednávání a související toky obchodních dokumentů.
| Dokument | Název Peppol | Podrobnosti |
| Faktura | Faktura | Výzva k úhradě s rozpisem položek, daní a platebních podmínek |
| Dobropis | Doplatkový doklad | Oprava nebo zrušení již odeslané faktury |
| Faktura na základě vlastního vyúčtování | Faktura s vlastním vyúčtováním | Faktura, kterou vystaví kupující jménem dodavatele |
| Kreditní doklad na základě vlastní fakturace | Vlastní fakturační dobropis | Odpovídající dobropis k faktuře vystavené na základě vlastního vyúčtování |
| Objednávka | Objednávka | Objednávka od odběratele dodavateli |
| Odpověď na objednávku | OrderResponse | Přijetí, zamítnutí nebo změna objednávky |
| Objednávková smlouva | Objednávková smlouva | Rámcová smlouva, na kterou se odvolávají pozdější objednávky |
| Změna objednávky | Změna objednávky | Změna již odeslané objednávky |
| Zrušení objednávky | Zrušení objednávky | Zrušení již odeslané objednávky |
| Oznámení o odeslání | Oznámení o odeslání | Co bylo skutečně odesláno a na základě které objednávky |
| Katalog | Katalog | Produkty, popisy a sjednané ceny |
| Odpověď na katalog | Odpověď na katalog | Schválení nebo zamítnutí katalogu |
| Odpověď na úrovni zprávy | Odpověď na úrovni zprávy | Technické potvrzení nebo odmítnutí zprávy |
| Stav na úrovni zprávy | Stav na úrovni zprávy | Stav zpracování zprávy v síti |
Punchout, Služby PDF a EDI mohou využívat stejnou strukturu účtů. Qvalia zajišťuje ověřování, směrování, doručování a řešení chyb na úrovni sítě.
Strukturovaná transakční data
Dokumenty jsou k dispozici ve formě strukturovaných transakčních dat pro účely výkaznictví, analýzy a automatizace účetnictví.
Položka faktury, tak jak byla přijata
ART 4471-B
Printing paper A4 80G 5X500
12 pcs 489,00 SEKStejná linka, utajené
| UNSPSC | 14111507 Kopírovací papír |
| Kategorie | Kancelářské potřeby |
| Jednotka | 12 × 2 500 listů |
| Jednotková cena | 40.75 SEK |
| Dodavatel | Porovnáno s kmenovými údaji |
Jednotlivé položky lze strukturovat a klasifikovat v reálném čase, přičemž kmenová data jsou propojena s tokem transakcí. To ve vašem produktu podporuje vytváření reportů, analýzu výdajů a automatizaci účetnictví. Jako doplňkové funkce jsou k dispozici OCR, automatizované účetnictví a obohacování klasifikace.
Povinnosti související s dodržováním standardu Peppol
Společnost Qvalia zastává roli poskytovatele služeb Peppol v rámci služby Embedded Peppol. Partner nadále nese odpovědnost za vztahy se svými zákazníky a za svou obchodní nabídku. Identifikátor „ Peppol ID “ může být přidělen pouze aktivním právnickým osobám.
| Odpovědnost | Qvalia | Ty |
| Role certifikovaného poskytovatele služeb Peppol | Qvalia | |
| Přístupový bod a provoz v režimu SMP | Qvalia | |
| Certifikace Peppol, audity a správa sítě | Qvalia | |
| Systémy řízení podle norem ISO/IEC 27001:2022 a ISO 22301:2019 | Qvalia | |
| Ověření totožnosti zákazníka | Partner | |
| Ověření, že zákazníci nejsou vyřazeni z registru, nejsou v platební neschopnosti ani neporušují požadavky v oblasti boje proti praní špinavých peněz | Partner | |
| Smlouva s konečným zákazníkem, cenová politika a obchodní vztahy | Partner |
To platí jak pro Embedded Peppol, tak pro platformu typu „white label“. Partneři, kteří potřebují zastávat roli poskytovatele služeb Peppol ve svém vlastním jménu, by se měli místo toho seznámit s řešením Hosted Access Point.
Často kladené otázky
Co v praxi znamená pojem „Embedded Peppol“?
Svým zákazníkům nabízíte připojení k síti Peppol a výměnu obchodních zpráv v souladu s normami, a to prostřednictvím API integrovaného do vašeho produktu. Společnost Qvalia zajišťuje provoz infrastruktury Peppol v pozadí. Vy jste vlastníkem vztahu se zákazníkem i samotné nabídky.
Musíme dodržování standardu Peppol zajišťovat sami?
Ne. V rámci služby Embedded Peppol zastává společnost Qvalia roli poskytovatele služeb Peppol a provozuje přístupový bod i SMP. Společnost Qvalia zajišťuje správu sítě Peppol a technickou shodu této služby s příslušnými normami. Vy nadále nesete odpovědnost za smlouvy s koncovými zákazníky, informace o registraci, cenovou politiku a technickou podporu. Partneři, kteří potřebují zastávat roli poskytovatele služeb svým vlastním jménem, by měli zvážit využití služby Hosted Access Point.
Jak podporujete nastavení Peppol pro více nájemců?
Qvalia podporuje jak konsolidované modely, tak modely s více nájemci. Můžete spravovat více koncových zákazníků ve sdíleném prostředí nebo každému zákazníkovi přidělit samostatný účet a identifikační číslo Peppol.
Jaké typy zpráv Peppol můžeme nabídnout našim uživatelům a koncovým zákazníkům?
Faktury, dobropisy, objednávky, potvrzení objednávek, avíza o odeslání, katalogy a související obchodní zprávy, a navíc punchout. Qvalia zajišťuje ověřování, směrování, doručování a řešení chyb v rámci celé sítě. Formáty PDF a EDI využívají stejnou strukturu účtů.
Jak jsou koncoví zákazníci přijímáni a spravováni?
Koncovým zákazníkům jsou při registraci přiděleny vlastní identifikátory Peppol a směrovací pravidla. Společnost Qvalia v pozadí spravuje registraci účastníků, aktualizace adresářů a konfiguraci sítě, zatímco vy máte pod kontrolou celý proces registrace.
Musíme provádět dotazování ohledně příchozích dokumentů?
Ne. Přihlaste se k odběru událostí webhooků a příspěvků Qvalia na váš koncový bod, když dorazí zpráva nebo dokument Peppol, když se změní stav doručení a když doručení selže. Jako alternativa jsou k dispozici koncové body s periodickým dotazováním.
Můžeme nabídnout víc než jen výměnu zpráv?
Ano. Každá transakce je k dispozici ve formě strukturovaných dat s klasifikací jednotlivých položek, což vám umožňuje integrovat do vašeho vlastního produktu funkce pro vytváření reportů, analýzu výdajů a automatizované účetnictví, namísto pouhého přenosu dokumentů. OCR, automatizované účetnictví a obohacení klasifikace jsou k dispozici jako doplňkové funkce.
Existují nějaká omezení rychlosti?
Ano. Partnerské účty mají limity výrazně vyšší než standardní účty a limit se upravuje podle vašeho předpokládaného objemu transakcí. Pokud plánujete rozsáhlé zapojení nových zákazníků nebo náročný konec měsíce, kontaktujte nás.
Jak rychle můžeme začít?
Přístup do testovacího prostředí je obvykle k dispozici během několika hodin. Spuštění do produkčního prostředí závisí na integraci, testování a vašem procesu schvalování ( release ).
Jak je tato integrace realizována?
Platforma je integrována prostřednictvím rozhraní REST API. Systémové ověřování využívá přihlašovací údaje klienta podle standardu OAuth 2.0. Jednotné přihlášení (SSO) uživatelů se konfiguruje samostatně prostřednictvím podporovaných možností identifikace. Pokud ve svém produktu nepotřebujete uživatelské rozhraní, platforma typu „white label“ vám poskytne aplikaci Qvalia pod vaší značkou.
Alternativní řešení
Zvolte platformu typu „white-label“ pro kompletní aplikaci, nebo možnost „Hosted Access Point“, pokud má vaše organizace zastávat roli poskytovatele služeb.
Chcete ten produkt, ne jeho sestavení
Platforma typu „white label“ představuje kompletní aplikaci společnosti Qvalia, která běží pod vaší značkou, doménou a s vašimi cenami. Nabízí plnohodnotné rozhraní bez nutnosti vývojového projektu.
Musíte být poskytovatelem, a to ve svém vlastním jménu
Díky službě Hosted Access Point se stanete certifikovaným poskytovatelem služeb Peppol s vlastní identitou přístupového bodu a certifikátem PKI, a to v rámci infrastruktury provozované společností Qvalia.
Kontaktujte nás
Integrujte elektronickou fakturaci, elektronické objednávání a obohacování dat do své platformy pomocí Qvalia.
Naše partnerské API, pokročilé nástroje pro správu a řešení white label vám umožňují nabídnout vašim koncovým uživatelům hladkou správu transakcí.
Spolupracujte s námi, abyste rozšířili možnosti své platformy a podpořili digitální transformaci. Kontaktujte nás a dozvíte se více.
Vyměňujte obchodní dokumenty prostřednictvím Peppol, EDI a dalších systémů
Umožněte obohacování dat pomocí umělé inteligence na úrovni jednotlivých položek
Rozšiřte svou nabídku produktů a jejich použitelnost