Peppol pre vývojárov: Začíname s elektronickými objednávkami

Peppol je medzinárodná otvorená sieť B2B, ktorá organizáciám umožňuje efektívne vymieňať štruktúrované obchodné dokumenty, ako sú objednávky a faktúry.

Porozumenie technickým špecifikáciám a procesu implementácie Peppol je pre vývojárov kľúčové pre vytváranie robustných systémov, ktoré zvyšujú efektívnosť organizácie. Táto príručka opisuje kľúčové pojmy a technické pokyny pre vývojárov, aby mohli začať používať elektronické objednávky prostredníctvom Peppol.

Peppol (Pan-European Public Procurement Online) je rámec, ktorý štandardizuje elektronickú výmenu dokumentov medzi podnikmi a verejnými organizáciami. Nie je to ERP systém, portál ani platforma pre obstarávanie, ale protokol umožňujúci interoperabilitu medzi rôznymi systémami.

Peppol používa model štyroch rohov, čo znamená, že každá organizácia sa pripája k sieti prostredníctvom svojho vybraného poskytovateľa prístupového bodu Peppol, čím sa eliminuje potreba zosúlaďovať poskytovateľov služieb s obchodnými partnermi.

Kľúčové vlastnosti Peppol sú:

Implementácia elektronických objednávok v Peppol si vyžaduje pochopenie špecifikácií obchodnej interoperability (BIS), syntaxe správ a požiadaviek na výmenu údajov.

Tu je prehľad šiestich základných krokov a technických aspektov, ktoré je potrebné zohľadniť.

Vývojári implementujúci faktúry Peppol musia pochopiť, ako správne vyplniť prvky cbc podľa usmernení Peppol BIS, aby zabezpečili súlad dokumentov a úspešný prenos.

V kontexte Peppol a syntaxe UBL (Universal Business Language) pre faktúry znamená cbc skratka Common Basic (spoločné základné Basic ). Tieto preddefinované dátové prvky v rámci schémy UBL predstavujú základné, opakovane použiteľné stavebné bloky obchodných dokumentov, ako sú faktúry, objednávky a oznámenia o expedícii.

Peppol podporuje tri základné špecifikácie, nazývané aj profily, pre procesy objednávok. Každý BIS je navrhnutý pre konkrétne prípady použitia a obchodní partneri sa musia dohodnúť, ktorý z nich budú používať.

BIS Order Only: Pre jednoduché zadávanie objednávok bez odpovede dodávateľa.
BIS Ordering: Zahŕňa odpovede na objednávky s potvrdením prijatia, zamietnutia alebo čiastočného prijatia.
BIS Despatch Advice: Informuje kupujúceho o podrobnostiach zásielky.

Transakcia Peppol Order (T01) sa riadi štandardu UBL (Universal Business Language) .

Na efektívne implementovanie Peppol potrebujú vývojári dôkladne pochopiť, ako vyplňovať prvky cbc v súlade s usmerneniami Peppol BIS, aby sa zabezpečila súlad s predpismi aj plynulý prenos. Dodržiavanie požadovanej syntaxe pre všetky prvky dokumentu je nevyhnutné, pretože odchýlky od validačných pravidiel Peppol môžu viesť k chybám, ktoré narušia proces objednávania.

Tu je niekoľko príkladov základných prvkov objednávkových dokumentov:

Zobrazenie údajov: Prvky cbc zvyčajne predstavujú jednotlivé polia údajov, vďaka čomu sú jednoduché na používanie a overovanie.
Atribúty: Niektoré prvky cbc obsahujú atribúty, ako napríklad currencyID (pre sumy) alebo unitCode (pre množstvá).
Povinné/voliteľné: Usmernenia Peppol BIS (Business Interoperability Specification) špecifikujú, ktoré prvky cbc sú povinné, voliteľné alebo podmienečne povinné.

Zatiaľ čo cbc predstavuje základné komponenty, cac (Common Aggregate Components) sa používa pre komplexné dátové štruktúry, ktoré zoskupujú súvisiace cbc a iné cac prvky. Napríklad cac:Party zoskupuje všetky informácie o obchodnej entite, ako je jej názov, adresa a identifikátory.

Ďalšie podrobnosti o konkrétnych prvkoch cbc používaných v objednávkach Peppol UBL nájdete v oficiálnej BIS Ordering Peppol BIS Ordering .

Transakcie Peppol sú distribuované prostredníctvom certifikovaných prístupových bodov Peppol, nazývaných aj poskytovatelia služieb Peppol. Ako vývojár musí vaša aplikácia pripojiť sa k API poskytovateľa, aby mohla odosielať a prijímať dokumenty. Prístupové body zvládajú technické zložitosť smerovania správ k obchodným partnerom a od nich.

Získajte viac informácií o prístupe k objednávkam Peppol prostredníctvom rozhrania API pre objednávky.

Validácia zabezpečuje súlad s pravidlami Peppol a požiadavkami BIS. Implementujte robustné validačné kontroly na identifikáciu chýb pred odoslaním. Napríklad skontrolujte povinné polia, ako sú cbc:ID a cbc:DocumentCurrencyCode. Overte formáty údajov, vrátane dátumov, mien a identifikátorov.

Overovanie formátu je integrované a automatizované pre používateľov prístupového bodu Peppol spoločnosti Qvalia.

Pred nasadením riešenia otestujte integráciu v prostredí sandboxu, ktoré poskytuje váš poskytovateľ prístupového bodu. To vám umožní simulovať rôzne scenáre, ako napríklad odosielanie objednávok, prijímanie odpovedí a spravovanie správ o expedícii.

Objednávky Peppol sa opierajú o schémy UBL založené na XML. Nižšie je uvedený stručný prehľad kľúčových prvkov štruktúry objednávky:

Záhlavie obsahuje dôležité metadáta o objednávke.

Kupujúci a predávajúci sú definovaní pomocou segmentov cac:BuyerCustomerParty a cac:SellerSupplierParty.

Každá riadka objednávky špecifikuje položky, množstvá a ceny.

BIS Despatch Advice umožňuje dodávateľom informovať kupujúcich o podrobnostiach zásielky.

Správa môže obsahovať:

Dodržiavajte pokyny Peppol BIS: Vždy dodržiavajte oficiálnu dokumentáciu Peppol BIS, aby ste zaistili súlad s predpismi.
Zohľadňujte miestne odlišnosti: Hoci Peppol je globálny štandard, niektoré sektory alebo regióny môžu vyžadovať špecifické úpravy.
Automatizujte overovanie: Pred odoslaním implementujte automatické kontroly syntaxe a súladu obsahu.
Zabezpečte údaje: Zaistite, aby všetky odosielané údaje boli v súlade s GDPR a ďalšími predpismi o ochrane osobných údajov.

Peppol poskytuje robustný rámec pre elektronické objednávky, ktorý umožňuje podnikom zefektívniť prevádzku a zlepšiť presnosť údajov. Pre vývojárov je pochopenie technických špecifikácií Peppol BIS, schém UBL a integrácie prístupových bodov kľúčové pre vytváranie škálovateľných a efektívnych riešení.