Ať už jste malá firma, velký podnik nebo dodavatel softwaru, API společnosti Qvalia vám nabízí jednotný, standardizovaný způsob integrace do sítě Peppol s volitelnou podporou dalších EDI toků, inteligentního zpracování dokumentů a obohacování dat.

Prostřednictvím služby Invoicing API můžete pracovat s fakturačními zprávami Peppol, jako jsou BIS Billing faktura), BIS Billing Note (dobropis), BIS Self-Billing Invoice (faktura s vlastním vyúčtováním), BIS Self-Billing Credit Note (dobropis s vlastním vyúčtováním) a BIS Invoice Response(odpověď na fakturu), a v případě potřeby je doplnit o Message Level Response (odpověď na úrovni zprávy) pro technická potvrzení související s fakturami a dalšími zprávami Peppol.

API může:

V tomto průvodci se naučíte:

Peppol API poskytuje jednotné rozhraní pro elektronické obchodní zprávy přes Peppol a EDI. Je navrženo tak, aby podporovalo základní scénáře, jako například:

Ve všech koncových bodech se používá společný princip návrhu:

Pro vás to znamená, že můžete uvažovat v termínech obchodních zpráv namísto sítí a protokolů. Vytváříte platné dokumenty založené na UBL; Qvalia zpracovává vrstvu Peppol a EDI na pozadí.

Začátek práce s Peppol API od společnosti Qvalia vyžaduje pouze několik základních kroků:

Účet Qvalia
Vaše organizace je zaregistrována jako zákazník Qvalia. Obdržíte registrační číslo účtu, které jednoznačně identifikuje váš účet ve všech transakčních hovorech.

API klíč
Ověřování se provádí pomocí API klíče, přičemž pro testovací a produkční prostředí se používají samostatné klíče. Všechna volání se provádějí přes HTTPS s moderním TLS.

Číslo registrace účtu v cestě URL
Transakční volání obsahují vaše číslo účtu (accountRegNo) v cestě. Například:

Volba formátu: JSON nebo XML
Formát JSON nebo XML můžete vybrat pomocí standardních hlaviček HTTP (Content-Type a Accept). Pokud není výslovně zvolen žádný formát, je výchozím formátem JSON.

Jakmile budou tyto prvky připraveny, můžete začít testovat provoz Peppol s Qvalia.

Tato část popisuje typickou první integraci mezi vaším systémem a transakčním API společnosti Qvalia a zahrnuje jak odesílání, tak přijímání faktur Peppol.

Začněte integrací do prostředí sandboxu:

To vám umožňuje vytvářet a testovat bez ovlivnění skutečných zákazníků nebo finančních toků.

Ve vaší konfiguraci uložte:

Každá žádost by měla obsahovat:

Všechny transakce používají jako základní standard UBL 2.1.

Můžete buď:

Formát řídí hlavičky:

JSON (výchozí)

XML

Tato flexibilita vám umožňuje integrovat rozhraní API Peppol do prostředí JSON-first i XML-first.

Dále namapujte svůj interní model faktury na prvky UBL. K dispozici jsou formáty UBL JSON i UBL XML.

Cílem je zajistit, aby:

Poté to serializujete jako JSON nebo XML, v závislosti na zvoleném formátu. U příchozích faktur použijete stejnou strukturu UBL při čtení, ověřování a mapování dat z Qvalia do vašeho interního modelu.

Krok 5a: Odeslání odchozí faktury Peppol

S připraveným odchozím datovým obsahem, příklad koncového bodu:

Zahrnout:

Qvalia ověří fakturu, odešle ji prostřednictvím sítě Peppol neboVAN a vrátí odpověď s identifikátory a stavem.

Chcete-li načíst příchozí faktury z Qvalia prostřednictvím API, obvykle:

Zavolejte příchozí koncový bod, například:

Volitelně můžete:

Vrácený UBL JSON nebo XML je poté namapován do vašeho interního datového modelu pro zveřejnění, schválení nebo další zpracování.

Transakční API používá předvídatelné stavové kódy HTTP, které můžete přiřadit k protokolům, monitorování a zprávám uživatelů. Typické vzorce:

Stejné postupy platí jak pro odesílání, tak pro přijímání faktur.

Kromě odpovědí API se můžete kdykoli přihlásit do Qvalia a zkontrolovat aktivitu v protokolu transakcí. Získáte tak přehled o tom, co se děje ve vaší integraci, včetně například:

Transakční protokol je užitečný pro:

HTTP stavové kódy a protokol transakcí společně poskytují ucelený obraz: váš systém může programově reagovat na odpovědi, zatímco váš tým může v případě potřeby provádět vyšetřování a sledování přímo v Qvalia.

Jakmile budete mít faktury připravené, je snadné rozšířit integraci na kompletní portfolio zpráv Peppol.

Mezi typická rozšíření patří:
Objednávky. Elektronické přijímání a odesílání strukturovaných objednávek
Odpovědi na objednávky a změny. Potvrzení, změna nebo zrušení objednávek
Katalogy. Správa informací o produktech a cenách v elektronických katalozích
Oznámení o odeslání. Sdělování informací o zásilkách
Odpovědi na úrovni zpráv. Sledování potvrzení na technické a obchodní úrovni

Vzhledem k tomu, že vše využívá stejný design API, model ověřování a datový model UBL 2.1, nepotřebujete pro každý typ dokumentu samostatné projekty nebo brány. Nové případy použití můžete aktivovat podle toho, jak se vyvíjí vaše podnikání nebo požadavky vašich zákazníků.

Právě zde se slib „jedno API Peppol bez ohledu na potřeby“ stává hmatatelným: stejná integrace slouží malým dodavatelům, velkým podnikům i komplexním scénářům platforem.

Pokud jste dodavatelem softwaru – provozujete fakturační platformu, ERP, účetní řešení nebo integrační platformu – vaše požadavky se mírně liší. S Partner API od Qvalia můžete nastavit konfiguraci pro více uživatelů pro výměnu zpráv pro koncové uživatele, včetně správy Peppol ID .

Partner API pro Peppol je nutné, pokud potřebujete:

Model společnosti Qvalia zaměřený na partnerství je navržen speciálně pro tento účel.

Vaše aplikace generuje nebo spotřebovává užitečná data UBL (faktury, objednávky atd.) stejným způsobem jako standardní rozhraní API transakcí. Chcete-li odesílat nebo přijímat transakce jménem konkrétního zákazníka, vyvoláte rozhraní API transakcí prostřednictvím vzoru URI s předponou partnera:

Například:

Qvalia směruje a přijímá zprávy, jako by byly odeslány nebo přijaty přímo zákazníkem, s plnou sledovatelností podle účtu.

Kromě přepravy a konektivity nabízí Qvalia také rozšiřující API, které může obohatit transakce o klasifikaci položek, zpracování před a po transakci a další funkce a které dokáže s minimálním úsilím extrahovat a transformovat dokumenty PDF na bohatá, strukturovaná a ověřená data.

Rozšiřující API je navrženo jako asynchronní služba:

Tento výsledek může zahrnovat:

Typická integrace vypadá takto:

Odeslat fakturu za obohacení
Zavolejte koncový bod, připojte soubor s fakturou a veškerá relevantní metadata a
Uložte vrácené pollingId.

Dotaz na dokončení
Volání v bezpečných intervalech. Během zpracování API potvrzuje, že úloha stále běží. Po dokončení vrátí stav a odkaz na výsledek obohacení.

Načtení konkrétních typů obohacení
Volání pro získání konkrétního výstupu obohacení – například podrobných údajů o fakturách nebo výsledků ověření Peppol. Tyto údaje můžete vložit do svého účetního systému, analytického stacku nebo automatizační logiky.

Ve všech případech je přístup k této technologii velmi jednoduchý: stejný účet a bezpečnostní model jako u Transaction API a malá sada dobře definovaných koncových bodů.

API společnosti Qvalia je navrženo tak, aby vám poskytlo zjednodušený a škálovatelný přístup k síti Peppol, bez ohledu na typ vaší společnosti:

Další krok je jednoduchý: připojte se k testovacímu prostředí, odešlete svou první zkušební fakturu a začněte plánovat, jak se Peppol, EDI a obohacení mohou stát nedílnou součástí vašich operací nebo produktu – namísto samostatného, komplexního projektu.