Peppol pro vývojáře: Začínáme s elektronickými objednávkami

Peppol je mezinárodní otevřená síť B2B, která organizacím umožňuje efektivní výměnu strukturovaných obchodních dokumentů, jako jsou objednávky a faktury.

Porozumění technickým specifikacím a procesu implementace Peppol je pro vývojáře zásadní pro vytváření robustních systémů, které zvyšují efektivitu organizace. Tato příručka popisuje klíčové pojmy a technické pokyny pro vývojáře, kteří chtějí začít používat elektronické objednávky pomocí Peppol.

Peppol (Pan-European Public Procurement Online) je rámec, který standardizuje elektronickou výměnu dokumentů mezi podniky a veřejnými organizacemi. Nejedná se o ERP systém, portál ani platformu pro zadávání veřejných zakázek, ale o protokol umožňující interoperabilitu mezi různými systémy.

Peppol používá model čtyř rohů, což znamená, že každá organizace se připojuje k síti prostřednictvím svého vybraného poskytovatele přístupového bodu Peppol, což eliminuje potřebu sladit poskytovatele služeb s obchodními partnery.

Hlavní rysy systému Peppol jsou:

Zavedení elektronických objednávek v systému Peppol vyžaduje porozumění jeho specifikacím obchodní interoperability (BIS), syntaxi zpráv a požadavkům na výměnu dat.

Zde je přehled šesti základních kroků a technických aspektů, které je třeba zohlednit.

Vývojáři implementující faktury Peppol musí rozumět tomu, jak správně vyplňovat prvky cbc podle pokynů Peppol BIS, aby zajistili soulad dokumentů a úspěšný přenos.

V kontextu Peppol a syntaxe UBL (Universal Business Language) pro faktury znamená cbc zkratku Common Basic (společné základní Basic ). Tyto předdefinované datové prvky v rámci schématu UBL představují základní, opakovaně použitelné stavební bloky obchodních dokumentů, jako jsou faktury, objednávky a zprávy o odeslání.

Peppol podporuje tři základní specifikace, nazývané také profily, pro procesy objednávek. Každý BIS je navržen pro konkrétní případy použití a obchodní partneři se musí dohodnout, který z nich budou používat.

BIS Order Only: Pro jednoduché zadávání objednávek bez odpovědi dodavatele.
BIS Ordering: Zahrnuje odpovědi na objednávky s potvrzením přijetí, zamítnutí nebo částečného přijetí.
BIS Despatch Advice: Informuje kupujícího o podrobnostech zásilky.

Transakce Peppol Order (T01) se řídí standardu UBL (Universal Business Language) .

Aby mohli vývojáři efektivně implementovat Peppol, musí důkladně rozumět tomu, jak vyplňovat prvky cbc v souladu s pokyny Peppol BIS, a zajistit tak jak soulad s předpisy, tak hladký přenos. Dodržování požadované syntaxe pro všechny prvky dokumentu je zásadní, protože odchylky od validačních pravidel Peppol mohou vést k chybám, které naruší proces objednávky.

Zde je několik příkladů základních prvků objednávkových dokumentů:

Zobrazení dat: Prvky cbc obvykle představují jednotlivá datová pole, což usnadňuje jejich použití a ověřování.
Atributy: Některé prvky cbc obsahují atributy, jako je currencyID (pro částky) nebo unitCode (pro množství).
Povinné/volitelné: Pokyny Peppol BIS (Business Interoperability Specification) určují, které prvky cbc jsou povinné, volitelné nebo podmíněně povinné.

Zatímco cbc představuje základní komponenty, cac (Common Aggregate Components) se používá pro komplexní datové struktury, které seskupují související prvky cbc a další prvky cac. Například cac:Party seskupuje všechny informace o obchodní entitě, jako je její název, adresa a identifikátory.

Další podrobnosti o konkrétních prvcích cbc používaných v objednávkách Peppol UBL naleznete v oficiální BIS Ordering Peppol BIS Ordering .

Transakce Peppol jsou distribuovány prostřednictvím certifikovaných přístupových bodů Peppol, nazývaných také poskytovatelé služeb Peppol. Jako vývojář musí vaše aplikace pro přenos a příjem dokumentů komunikovat s API poskytovatele. Přístupové body řeší technickou složitost směrování zpráv mezi obchodními partnery.

Další informace o přístupu k objednávkám Peppol prostřednictvím rozhraní API pro objednávky.

Validace zajišťuje soulad s pravidly Peppol a požadavky BIS. Zavést robustní kontrolní mechanismy pro identifikaci chyb před přenosem. Například zkontrolovat povinná pole, jako jsou cbc:ID a cbc:DocumentCurrencyCode. Ověřte formáty dat, včetně dat, měn a identifikátorů.

Ověření formátu je integrováno a automatizováno pro uživatele přístupového bodu Peppol společnosti Qvalia.

Před nasazením řešení otestujte integraci v testovacím prostředí poskytovaném vaším poskytovatelem přístupového bodu. To vám umožní simulovat různé scénáře, jako je odesílání objednávek, přijímání odpovědí a správa zpráv o odeslání zásilky.

Objednávky Peppol se opírají o schémata UBL založená na XML. Níže je uveden stručný přehled klíčových prvků struktury objednávky:

Záhlaví obsahuje důležité metadata o objednávce.

Kupující a prodávající jsou definováni pomocí segmentů cac:BuyerCustomerParty a cac:SellerSupplierParty.

Každá řádka objednávky specifikuje položky, množství a ceny.

BIS Despatch Advice umožňuje dodavatelům informovat odběratele o podrobnostech zásilky.

Zpráva může obsahovat:

Dodržujte pokyny Peppol BIS: Vždy dodržujte oficiální dokumentaci Peppol BIS, abyste zajistili soulad s předpisy.
Zohledněte místní odlišnosti: Ačkoli je Peppol globálním standardem, některé sektory nebo regiony mohou vyžadovat specifické úpravy.
Automatizujte ověřování: Před přenosem implementujte automatické kontroly syntaxe a obsahu.
Zabezpečte data: Zajistěte, aby všechna přenášená data byla v souladu s GDPR a dalšími předpisy na ochranu osobních údajů.

Peppol poskytuje robustní rámec pro elektronické objednávky, který podnikům umožňuje zefektivnit provoz a zlepšit přesnost dat. Pro vývojáře je pochopení technických specifikací Peppol BIS, schémat UBL a integrace přístupových bodů zásadní pro vytváření škálovatelných a efektivních řešení.