API

Aké API potrebujem na eFaktúry?

Krátka odpoveď

Na eFaktúry zvyčajne potrebujete API pre validáciu XML, odoslanie cez doručovacieho partnera, príjem statusov, archív dôkazov a import alebo export do účtovníctva. Ak firma faktúry len občas vystavuje, API nemusí byť potrebné. Pri ERP, e-shope alebo väčšom objeme je však API kľúčové, aby proces nestál na ručnom nahrávaní súborov.

Validácia

Kontrola XML

API má vedieť vrátiť chyby z XSD, EN 16931 a profilu.

Odoslanie

Partner connector

Odosielanie smeruje cez certifikovaného doručovacieho partnera.

Statusy

Webhook alebo polling

ERP potrebuje vedieť, čo sa s dokladom stalo.

Archív

Dôkazný balík

Uložte XML, hash, reporty, statusy a potvrdenia.

Podrobné vysvetlenie

API vrstva má oddeliť účtovný systém od doručovacieho partnera a od kontrolnej logiky. ERP má vedieť odovzdať fakturačné dáta alebo hotové XML, systém má spustiť validáciu, uložiť dôkazy a vrátiť stav. Doručenie samotné má ísť cez certifikovaného partnera, nie cez eFaktúra Centrum ako poštára.

Ako to vyplýva zo zákona

Zákon neurčuje konkrétnu API architektúru. Povinnosťou firmy je mať správny elektronický doklad, schopnosť doručenia v povinnom režime a preukázateľnú stopu od odoslania po prijatie.

Praktické príklady

  • ERP pošle XML na validáciu a dostane späť report s chybami.
  • E-shop po vystavení faktúry zavolá API, ktoré vytvorí kontrolný balík.
  • Doručovací partner pošle webhook so stavom doručená a ERP ho uloží k faktúre.

Najčastejšie chyby

  • „API je len upload XML.“ Dobré API rieši aj validáciu, stav a audit.
  • „Keď mám API partnera, nepotrebujem archív.“ Statusy a dôkazy treba uchovať vo vlastnom procese.
  • „Všetko musí byť real-time.“ Niektoré kroky môžu bežať frontou, hlavne pri väčšom objeme.

Záver

API pre eFaktúry má spájať ERP, validáciu, partnera, statusy a archív do jedného dohľadateľného procesu.

Právny základ

  • Zákon č. 222/2004 Z. z. o DPH, § 76a
  • Zákon č. 222/2004 Z. z. o DPH, § 85o
  • EN 16931 a Peppol BIS Billing 3.0

Súvisiace otázky

Nie je to právne poradenstvo. Zdroje: zákon č. 222/2004 Z. z. o DPH, Finančná správa SR eFaktúra FAQ, OpenPeppol BIS Billing 3.0 a interný validačný model eFaktúra centra. Overené 7. 7. 2026.