Ako riešiť webhooky pre stavy eFaktúr?
Krátka odpoveď
Webhook pre stav eFaktúry nikdy nespracúvajte slepo. Overte zdroj alebo podpis, uložte payload, skontrolujte idempotenciu, namapujte stav na interný stavový automat a až potom aktualizujte faktúru. Rovnaký webhook môže prísť viackrát, takže spracovanie musí byť bezpečné.
Podpis alebo token
Webhook musí prísť z dôveryhodného zdroja.
Rovnaká udalosť viackrát
Duplicitný webhook nesmie zmeniť výsledok.
Interné stavy
Partnerove názvy stavov preložte do vlastného modelu.
Payload a výsledok
Uložte, čo prišlo a ako systém rozhodol.
Podrobné vysvetlenie
Webhook je asynchrónna správa, že sa s dokladom niečo stalo. Môže priniesť stav queued, delivered, failed, rejected alebo iný stav podľa partnera. Váš systém má vedieť spracovať duplicitu, oneskorené poradie udalostí a rozdiel medzi technickým a obchodným stavom.
Ako to vyplýva zo zákona
Ak statusy používate ako dôkaz odoslania, doručenia alebo prijatia, musíte vedieť preukázať ich pôvod a väzbu na doklad.
Praktické príklady
- Webhook delivered príde dvakrát a druhé spracovanie sa ignoruje ako duplicita.
- Webhook failed vytvorí úlohu pre fakturanta a uloží technický dôvod.
- Oneskorený queued po delivered sa neprepíše ako spätný krok.
Najčastejšie chyby
- „Webhooku vždy verím.“ Najprv overte zdroj.
- „Webhooky prídu presne raz a v poradí.“ V praxi s tým nemožno počítať.
- „Stačí uložiť finálny stav.“ Pre audit je dôležitá aj história udalostí.
Záver
Webhooky pre eFaktúry spracúvajte ako overené, idempotentné a logované udalosti.
Právny základ
- Zákon č. 222/2004 Z. z. o DPH, § 76a
- Technická dokumentácia partnera
- Interný audit trail
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.