Peppol API integrácia: napojenie fakturácie a ERP

Ako sa softvér pripája na Peppol cez API?

Bežná integrácia prepája váš fakturačný alebo ERP systém s rozhraním poskytovateľa doručovania. Program pripraví údaje, odovzdá doklad a prevezme výsledky či prijaté faktúry. Poskytovateľ zabezpečuje svoju úlohu v doručovacej sieti.

Zákaznícke API a prenos medzi Access Pointmi sú odlišné vrstvy. Peppol AS4 opisuje komunikáciu medzi poskytovateľmi. Konkrétne adresy API, spôsob autentifikácie a formát odpovedí pre váš program určujú podklady zvoleného poskytovateľa.

Skôr než sa začne programovať, potvrďte rozsah: len odoslanie, len príjem alebo oba smery. Uveďte aj viac firiem, opravné doklady, prílohy a požadované prepojenie s účtovníctvom.

Ktoré úlohy rozdeliť medzi ERP a poskytovateľa?

Poskytovateľ môže prijať hotové XML alebo ponúkať tvorbu z iných údajov. V oboch prípadoch skontrolujte, že obchodný význam polí zostane zachovaný. Mapovanie vysvetľuje komentovaný XML vzor.

Ako navrhnúť odoslanie a návrat výsledku?

Doklad najskôr uložte a technicky overte. Pri odovzdaní si zaznamenajte vlastnú referenciu a identifikáciu správy poskytovateľa. Odpoveď API má vysvetlený význam: prevzatie požiadavky môže predchádzať konečnému výsledku prenosu.

Pri asynchrónnom spracovaní môže výsledok prísť webhookom alebo ho program zisťuje opakovaným dopytom podľa dokumentácie. Tieto možnosti nepovažujte za povinnú funkciu každého API. Dohodnite, ako sa výsledok vráti k správnemu dokladu a čo pracovník uvidí pri chybe.

Ilustračný tok integrácie:

ERP pripraví a uloží faktúru
→ overí XML a priradí vlastnú referenciu
→ odovzdá doklad poskytovateľovi
→ uloží identifikáciu správy
→ prevezme výsledok prenosu
→ zobrazí stav alebo úlohu na opravu

Schéma nie je definícia konkrétneho API. Mená stavov a dostupné potvrdenia preberajte z dokumentácie služby. Technické doručenie odlišujte od obchodného schválenia odberateľom.

Čo sa stane pri výpadku alebo opakovanej požiadavke?

Ak po odoslaní nastane timeout, výsledok môže byť neznámy: poskytovateľ mohol doklad prevziať. Opakované odoslanie musí mať dohodnutú ochranu pred duplicitou. Overte, či API podporuje idempotentnú požiadavku alebo dohľadanie správy podľa vašej referencie.

Pri webhookoch počítajte s opakovanou udalosťou a podľa dokumentácie overujte jej pôvod. Pri príjme si uložte identifikátor správy aj identitu faktúry; neopierajte kontrolu iba o názov súboru. Technická duplicita prenosu a dva obchodne podobné doklady sú odlišné situácie.

Pripravte aj ručné vyriešenie prípadu, ktorý zostal bez jednoznačného výsledku. Výsledok neoznačujte automaticky ako úspešný len preto, že prestal prichádzať chybový kód.

Ako nastaviť príjem a prístupy viacerých firiem?

Získané XML zachovajte a porovnajte údaje s importom do správnej firmy. Následné schvaľovanie, priradenie účtov a úhrada patria do vášho pracovného postupu. Oficiálna UBL štruktúra pomôže určiť, kam patria obchodné údaje.

Testovacie a produkčné účty držte oddelene. Kľúče ukladajte na serveri a sprístupnite ich len potrebným procesom. Pri viacerých subjektoch overte rozsah každého oprávnenia, aby požiadavka jednej firmy nemohla spracovať doklady druhej.

Určte aj obnovu prístupu a výmenu údajov pri zmene služby. Prevádzkový záznam má pomôcť dohľadať problém bez zbytočného kopírovania celého obsahu faktúr do každého logu.

Čo musí prejsť skúškou pred spustením?

Otestujte bežné odoslanie a príjem, neplatný doklad, neznámeho príjemcu, opravu a opakovaný import. Pridajte timeout po odovzdaní, opakovanú udalosť a dočasnú nedostupnosť služby. Pri každom scenári určte očakávaný výsledok a postup obsluhy.

Zaznamenajte použité vydanie pravidiel a verziu konektora. Pri aktualizácii ich porovnajte s platnými špecifikáciami eDelivery. Kontrolu dokladu vysvetľuje validácia e-faktúry.

Pri slovenskej prevádzke pridajte aj dohodu o oznamovaní údajov. Finančná správa opisuje automatický prenos cez digitálneho poštára; integrácia má používateľovi umožniť dohľadať jeho výsledok. Všeobecný tok opisuje doručovanie faktúr.

Organizáciu práce a skúšky s dodávateľom softvéru dopĺňa návod na napojenie účtovného programu. Prevod existujúcich podkladov rieši postup PDF na eFaktúru.