Procurement Service Bus (PSB) je centrální API brána od eConnect, prostřednictvím které odesíláte, přijímáte a zpracováváte e-faktury, objednávky a další e-dokumenty. PSB propojuje Váš software se sítí Peppol a dalšími sítěmi pro e-fakturaci přes moderní REST API s OAuth2 zabezpečením.

Ať už jste dodavatel softwaru, který chce integrovat e-fakturaci, nebo organizace, která chce automatizovat dokumentové toky: PSB poskytuje infrastrukturu, abyste to zvládli spolehlivě a škálovatelně.

PSB je více než jen odesílací kanál. Je to plnohodnotná platforma pro zpracování e-dokumentů s funkcionalitou pokrývající celý purchase-to-pay proces.

E-fakturace je jádrem. Prostřednictvím API odesíláte prodejní faktury příjemcům v síti Peppol a přijímáte nákupní faktury od dodavatelů. PSB automaticky směruje dokumenty na správný Access Point a potvrzuje doručení aktualizacemi stavu v reálném čase.

E-ordering jde dál než fakturace. PSB podporuje odesílání a příjímání objednávek, potvrzení objednávek, změn objednávek a stornování. Výchozí jsou pouze Peppol objednávky (Order Only a Advanced Ordering); zprávy DICO (včetně zprávy o údržbě) jsou k dispozici tam, kde se to týká, a objednávky Coupa (cXML) na vyžádání. Order-flip (převod objednávky na fakturu jedním úkonem) není funkcí PSB; je k dispozici výhradně na platformě Collabrr.

Self-billing umožňuje vytvářet a odesílat faktury jménem dodavatele. To je relevantní pro organizace, které samy vystavují nákupní faktury na základě přijatého zboží nebo služeb.

Validace nabízí samostatný endpoint, prostřednictvím kterého můžete zkontrolovat správnost XML dokumentů bez jejich odeslání. Validate API automaticky rozpozná formát dokumentu, testuje ho vůči nejnovějším artefaktům a poskytuje podrobnou, vícejazyčnou zpětnou vazbu pro každé validační pravidlo.

Transformace konvertuje dokumenty z jednoho formátu e-faktury na jiný. PSB podporuje více než 20 formátů včetně UBL 2.1, NLCIUS, Peppol BIS Billing V3, PINT, CII, XRechnung, Factur-X/ZUGFeRD, FatturaPA, ebInterface, Svefaktura, e-FFF, OIOUBL, Finvoice, ISDOC, DICO, SETU a SEEF. API automaticky rozpozná vstupní formát, takže dokument můžete odeslat ve vlastním formátu bez manuální konverze. Transformace je užitečná pro partnery, kteří očekávají specifický formát, nebo pro testování před spuštěním do provozu.

Validated Party Data (VPD) je GraphQL API, prostřednictvím kterého dotazujete a ověřujete údaje o stranách. Zkontrolujte, zda číslo KvK, OIN nebo IČ DPH skutečně patří určité organizaci, dříve než odešlete fakturu. V In Control je stejná funkcionalita známá pod komerčním názvem Purple Pages.

Intelligent Document Recognition (IDR) konvertuje PDF faktury na strukturované XML pomocí OCR a AI. IDR je přímo ovladatelný přes PSB API s nastavitelnými úrovněmi kvality a prioritami.

PSB je postaven na modelu Actor v klastru Microsoft Azure Service Fabric. Zní to technicky, ale výhody jsou konkrétní: dokumenty se zpracovávají paralelně na více serverech, aniž by na sebe čekaly. Při poruše serveru se zpracování automaticky pokračuje na jiném uzlu bez ztráty dat.

V praxi to znamená dobu zpracování méně než 100 milisekund na dokument při odeslání, prokázanou kapacitu 200 000 zpráv za hodinu a dostupnost 99,99 % (více než osm let bez neplánovaného výpadku).

PSB funguje jako Peppol Access Point s více Access Pointy ve standardní konfiguraci. Zátěž se dynamicky rozděluje přes spolehlivé fronty. Každý tenant je logicky izolovaný: je technicky nemožné přistoupit k dokumentům jiného tenanta. PSB běží na Microsoft Azure (regiony Nizozemsko a Irsko); veškeré zpracování dat probíhá v rámci EU/EHP.

S jedinou API integrací získáte přístup k více sítím. PSB automaticky směruje dokumenty na správný kanál na základě příjemce.

PSB je připraven na požadavky ViDA (VAT in the Digital Age). Směrnice ViDA zavádí povinné digitální daňové reportování (Digital Reporting Requirements, DRR) od 1. července 2030 pro přeshraniční transakce v celé EU.

PSB automaticky generuje DRR hlášení z údajů faktury a odesílá ho příslušnému finančnímu úřadu. Pro integrátory to neznamená žádnou práci navíc: odešlete fakturu stejně jako dosud a PSB se postará o CTC reportování na pozadí podle modelu Peppol 5-corner.

Stavové zprávy o CTC reportování jsou dostupné přes stejný webhook mechanismus jako stavové zprávy o doručení. PSB poskytuje důkazové soubory (evidence files) pro každé hlášení. CTC reportování je zahrnuto v ceně dokumentu, bez zvláštních příplatků.

PSB pracuje na principu událostí. Místo pravidelného pollingu, zda jsou k dispozici nové dokumenty, můžete nastavit webhooky, které Vaši aplikaci přímo upozorní při relevantních událostech: přijatá faktura, úspěšně doručená faktura, chyba při odeslání, Invoice Response od příjemce.

Hooky podporují více typů akcí: HTTPS webhooky, e-mailové notifikace, SFTP push a dokonce dávkové zpracování, při kterém se dokumenty periodicky nabízejí jako ZIP archiv. Každý typ hooku je zabezpečen podpisy HMAC SHA256.

PSB používá OAuth 2.0 pro autentizaci s podporou Client Credentials i Resource Owner Password Credentials flow. Veškerá komunikace probíhá přes TLS 1.2 nebo vyšší. Binární uploady se automaticky skenují na viry a malware a XML dokumenty se validují vůči standardním sadám pravidel.

Každý tenant operuje v logicky izolovaném prostředí. PSB zpracovává dokumenty pro více než 20 000 organizací.

PSB REST API (v1) je organizováno kolem následujících skupin endpointů:

Kompletní dokumentace endpointů s formáty požadavků a odpovědí je dostupná jako interaktivní Swagger UI. Příslušný swagger.json si můžete stáhnout pro generování klientského kódu.

Jste připraveni začít? Články níže Vám pomohou na cestě, od žádosti o testovací účet až po první API volání.

• Getting started popisuje, jak požádat o účet, nastavit testovací prostředí a provést první požadavek.
• Autentizace vysvětluje kompletní proces autentizace OAuth2 včetně žádosti o token a jeho obnovení.
• SDK a vzorový kód poskytuje přehled dostupných klientských knihoven a interaktivní API dokumentace.
• Idempotency ukazuje, jak zabránit duplicitnímu odesílání dokumentů.