Procurement Service Bus (PSB) je centrálna API brána od eConnect, prostredníctvom ktorej odosielate, prijímate a spracovávate e-faktúry, objednávky a ďalšie e-dokumenty. PSB prepája Váš softvér so sieťou Peppol a ďalšími sieťami pre e-fakturáciu cez moderné REST API s OAuth2 zabezpečením.

Či už ste dodávateľ softvéru, ktorý chce integrovať e-fakturáciu, alebo organizácia, ktorá chce automatizovať dokumentové toky: PSB poskytuje infraštruktúru, aby ste to zvládli spoľahlivo a škálovateľne.

PSB je viac než len odosielací kanál. Je to plnohodnotná platforma na spracovanie e-dokumentov s funkcionalitou pokrývajúcou celý purchase-to-pay proces.

E-fakturácia je jadrom. Prostredníctvom API odosielate predajné faktúry príjemcom v sieti Peppol a prijímate nákupné faktúry od dodávateľov. PSB automaticky smeruje dokumenty na správny Access Point a potvrdzuje doručenie aktualizáciami stavu v reálnom čase.

E-ordering ide ďalej ako fakturácia. PSB podporuje odosielanie a prijímanie objednávok, potvrdení objednávok, zmien objednávok a stornovaní. Výchozí sú iba Peppol objednávky (Order Only a Advanced Ordering); správy DICO (vrátane správy o údržbe) sú k dispozícii tam, kde je to relevantné, a objednávky Coupa (cXML) na vyžiadanie. Order-flip (prevod objednávky na fakturu jednou akciou) nie je funkciou PSB; je dostupný výlučne na platforme Collabrr.

Self-billing umožňuje vytvárať a odosielať faktúry v mene dodávateľa. To je relevantné pre organizácie, ktoré samy vystavujú nákupné faktúry na základe prijatého tovaru alebo služieb.

Validácia ponúka samostatný endpoint, prostredníctvom ktorého môžete skontrolovať správnosť XML dokumentov bez ich odoslania. Validate API automaticky rozpozná formát dokumentu, testuje ho voči najnovším artefaktom a poskytuje podrobnú, viacjazyčnú spätnú väzbu pre každé validačné pravidlo.

Transformácia konvertuje dokumenty z jedného formátu e-faktúry na iný. PSB podporuje viac ako 20 formátov vrátane 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 odoslať vo vlastnom formáte bez manuálnej konverzie. Transformácia je užitočná pre partnerov, ktorí očakávajú špecifický formát, alebo na testovanie pred spustením do prevádzky.

Validated Party Data (VPD) je GraphQL API, prostredníctvom ktorého dopytujete a overujete údaje o stranách. Skontrolujte, či číslo KvK, OIN alebo IČ DPH skutočne patrí určitej organizácii, skôr než odošlete faktúru. V In Control je rovnaká funkcionalita známa pod komerčným názvom Purple Pages.

Intelligent Document Recognition (IDR) konvertuje PDF faktúry na štruktúrované XML pomocou OCR a AI. IDR je priamo ovládateľný cez PSB API s nastaviteľnými úrovňami kvality a prioritami.

PSB je postavený na modeli Actor v klastri Microsoft Azure Service Fabric. Znie to technicky, ale výhody sú konkrétne: dokumenty sa spracovávajú paralelne na viacerých serveroch bez toho, aby na seba čakali. Pri poruche servera sa spracovanie automaticky pokračuje na inom uzle bez straty dát.

V praxi to znamená čas spracovania menej ako 100 milisekúnd na dokument pri odoslaní, preukázanú kapacitu 200 000 správ za hodinu a dostupnosť 99,99 % (viac ako osem rokov bez neplánovaného výpadku).

PSB funguje ako Peppol Access Point s viacerými Access Points v štandardnej konfigurácii. Záťaž sa dynamicky rozdeľuje cez spoľahlivé fronty. Každý tenant je logicky izolovaný: je technicky nemožné pristúpiť k dokumentom iného tenanta. PSB beží na Microsoft Azure (regióny Holandsko a Írsko); všetko spracovanie dát prebieha v rámci EÚ/EHP.

S jedinou API integráciou získate prístup k viacerým sieťam. PSB automaticky smeruje dokumenty na správny kanál na základe príjemcu.

PSB je pripravený na požiadavky ViDA (VAT in the Digital Age). Smernica ViDA zavádza povinné digitálne daňové reportovanie (Digital Reporting Requirements, DRR) od 1. júla 2030 pre cezhraničné transakcie v celej EÚ.

PSB automaticky generuje DRR hlásenie z údajov faktúry a odosiela ho príslušnému daňovému úradu. Pre integrátorov to neznamená žiadnu prácu navyše: odošlete faktúru rovnako ako doteraz a PSB sa postará o CTC reportovanie na pozadí podľa modelu Peppol 5-corner.

Stavové správy o CTC reportovaní sú dostupné cez rovnaký webhook mechanizmus ako stavové správy o doručení. PSB poskytuje dôkazové súbory (evidence files) pre každé hlásenie. CTC reportovanie je zahrnuté v cene dokumentu, bez osobitných príplatkov.

PSB pracuje na princípe udalostí. Namiesto pravidelného pollingu, či sú k dispozícii nové dokumenty, môžete nastaviť webhooky, ktoré Vašu aplikáciu priamo upozornia pri relevantných udalostiach: prijatá faktúra, úspešne doručená faktúra, chyba pri odoslaní, Invoice Response od príjemcu.

Hooky podporujú viaceré typy akcií: HTTPS webhooky, e-mailové notifikácie, SFTP push a dokonca dávkové spracovanie, pri ktorom sa dokumenty periodicky ponúkajú ako ZIP archív. Každý typ hooku je zabezpečený podpismi HMAC SHA256.

PSB používa OAuth 2.0 na autentifikáciu s podporou Client Credentials aj Resource Owner Password Credentials flow. Celá komunikácia prebieha cez TLS 1.2 alebo vyššie. Binárne uploady sa automaticky skenujú na vírusy a malvér a XML dokumenty sa validujú voči štandardným sadám pravidiel.

Každý tenant operuje v logicky izolovanom prostredí. PSB spracováva dokumenty pre viac ako 20 000 organizácií.

PSB REST API (v1) je organizované okolo nasledujúcich skupín endpointov:

Kompletná dokumentácia endpointov s formátmi požiadaviek a odpovedí je dostupná ako interaktívna Swagger UI. Príslušný swagger.json si môžete stiahnuť na generovanie klientského kódu.

Ste pripravení začať? Články nižšie Vám pomôžu na ceste, od žiadosti o testovací účet až po prvé API volanie.

• Getting started popisuje, ako požiadať o účet, nastaviť testovacie prostredie a urobiť prvú požiadavku.
• Autentifikácia vysvetľuje kompletný proces autentifikácie OAuth2 vrátane žiadosti o token a jeho obnovenia.
• SDK a vzorový kód poskytuje prehľad dostupných klientských knižníc a interaktívnej API dokumentácie.
• Idempotency ukazuje, ako zabrániť duplicitnému odosielaniu dokumentov.