Implementácia eFaktúry pre ERP a vývojárov

Krátka odpoveď

Pre ERP a vývojárov nie je eFaktúra jeden XML export, ale dva prepojené životné cykly: doručenie faktúry a slovenské daňové oznamovanie SK TDD. Každý potrebuje vlastné verzie pravidiel, stavy, chyby, opakovanie a auditnú stopu.

K 12. septembru 2026 je aktuálnym povinným vydaním Peppol BIS Billing 3.0.21, slovenská transpozícia je vo verzii 1.11 a finálna špecifikácia SK TDD vo verzii 1.0.0. Slovenská referenčná architektúra je vo verzii 1.2.

Vrstvy, ktoré implementácia nesmie zameniť

EN 16931-1:2026 bola vydaná v máji 2026, ale Európska komisia opisuje migráciu, počas ktorej zostáva doterajšia verzia použiteľná. Validátor preto verziujte a uchovávajte informáciu, podľa ktorých pravidiel bol doklad skontrolovaný.

Navrhnite stavový model, nie jedno pole „odoslané“

Minimálne oddeľte vytvorenie, lokálnu validáciu, prijatie CPDS, výsledok doručenia, aplikačné odmietnutie a účtovné spracovanie. Pre prijaté doklady evidujte pôvodné XML, prílohy, identifikátor správy, čas a klienta.

SK TDD má vlastné operácie Submit, Resubmit a Disregard. Jeho úspech alebo chyba sa nesmie odvodiť iba zo stavu faktúry. V používateľskom rozhraní aj API zobrazte, ktorá vrstva zlyhala a či je bezpečné požiadavku zopakovať.

Bezpečné opakovanie a audit

Použite stabilný interný identifikátor a idempotentný integračný postup, aby sieťový timeout nevytvoril druhý obchodný doklad. Uchovajte odtlačok odoslaného obsahu, použitú verziu validácie, čas, používateľa, technický výsledok a väzbu na opravu. Idempotencia je implementačné odporúčanie, nie náhrada zákonného číslovania faktúr.

Rozdeľte oprávnenia na tvorbu, schválenie, odoslanie, opätovné podanie, zneplatnenie a export. Tajomstvá a integračné kľúče oddeľte podľa prostredia a zákazníka. Citlivé údaje ani produkčné faktúry nekopírujte do vývojových logov.

Testovacia matica

V testovacom prostredí a so syntetickými údajmi overte faktúru, dobropis, faktúru k prijatej platbe, prílohu a samofakturáciu, ak ju produkt podporuje. Pridajte záporné sadzby alebo súčty, neplatný identifikátor, chýbajúce povinné pole, duplicitu, timeout a používateľa bez oprávnenia. Pre SK TDD otestujte všetky tri operácie a nesúlad medzi doručením a reportovaním.

Produkčná pripravenosť vyžaduje aj monitoring, eskaláciu, opakovateľný export XML a auditnej stopy, migračný postup medzi poskytovateľmi a presne pomenovanú zmluvnú stranu CPDS. Samotný výber portálu nie je dôkaz aktivácie účastníka v SMP.

Súvisiace čítanie

Pokračujte cez CPDS API, XML validácia.

Tento text vychádza z verejných materiálov Finančnej správy a dokumentácie OpenPeppol. Zmluvné API a stavové kódy overte u konkrétneho CPDS; CPDS.sk nie je technická špecifikácia ani záväzné stanovisko štátu.