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.

Through the service Invoicing API, you can work with invoice-related Peppol messages such as BIS Billing (invoice), BIS Billing Credit Note (credit note), BIS Self-Billing Invoice, BIS Self-Billing Credit Note and BIS Invoice Response, and, when needed, complement them with Message Level Response for message-level validation results during the MLR transition period. Transport receipts, Message Level Status (MLS) between service providers, and business-level responses are separate mechanisms.

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:

Peppol business document endpoints use the UBL 2.1-based structure defined by the applicable BIS or PINT specification. Other Qvalia APIs and endpoints may use different payload models; confirm the current API documentation for the endpoint you are implementing.

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.

Step 5: Send an outgoing Peppol invoice

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:

The same patterns apply whether you are sending or receiving invoices. OpenPeppol is replacing MLR with MLS in the eDelivery layer: the MLS activation window starts on 1 March 2027, MLS becomes mandatory for service providers on 1 April 2027, and MLR is retired on 1 May 2027.

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.

Typical extensions include:
Orders. Receive and send structured orders electronically
Order responses and changes. Confirm, modify, or cancel orders
Catalogues. Maintain product and price information in electronic catalogues
Despatch advice. Communicate shipment information
Message-level validation and status. Track MLR during the transition period, MLS between service providers, and the relevant business response for each process

The available endpoints use a consistent account and authentication model, but payload structures and enabled message types depend on the relevant Peppol profile and your Qvalia service configuration. You enable new use cases as your business or your customers’ requirements evolve.

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.