Domov eFaktúry Developer portal ICD & OpenAPI Error catalog VerifyEU
Delivery lifecycle

Webhook contract

Enterprise integrácia nekončí intake endpointom. Musí vedieť, aké eventy prídu späť, v akom poradí, ako sa overujú podpisy a kedy sa má volať retry alebo artifact download.

Transport a business eventy

Rozlišovať medzi transportným doručením, business rejection a manuálnym review. ACK ešte neznamená prijatie z obchodného hľadiska.

Retry a idempotency

Webhook receiver má byť idempotentný, logovať event IDs a vedieť bezpečne spracovať opakované doručenia alebo oneskorené callbacky.

Odporúčané eventy

Event
Význam
Akcia
invoice.accepted
Feed bol prijatý do processing pipeline. Ešte nejde o finálny výsledok.
Track
invoice.validation_failed
Dokument neprešiel validatorom; payload obsahuje rule IDs, severity a remediation hints.
Fix + retry
invoice.delivered
Transportná vrstva potvrdila úspešné doručenie do siete alebo príjemcovi.
Archive timeline
invoice.rejected
Business alebo transport rejection. V payloade má byť dôvod a ďalší odporúčaný krok.
Remediation
invoice.artifacts_ready
Finálne XML a PDF sú pripravené na stiahnutie alebo spätné odovzdanie do archívu klienta.
Fetch artifacts

Payload example

{ "event": "invoice.validation_failed", "event_id": "evt_01H...", "invoice_id": "VZ-2026-00418", "idempotency_key": "verizon-2026-00418", "transmission_id": "trn_01H...", "rule_version": "SK-CIUS-2026.04", "issues": [ { "rule_id": "SK-CIUS-01", "severity": "fatal", "path": "/Invoice/cac:AccountingCustomerParty", "message": "Chýba DIČ odberateľa", "hint": "Doplňte buyer tax identifier" } ] }

Delivery guardrails

Použiť HMAC alebo podobný mechanizmus na overenie zdroja webhooku.

Exponenciálne retry s dead-letter logikou pri 5xx chybách na strane príjemcu.

Logovať event_id, invoice_id a transmission_id do interného monitoringu.

Počítať s tým, že eventy nemusia vždy prísť v intuitívnom poradí; authoritative state držať v timeline modeli.

Live webhook snapshot

Endpointy
Aktívne
Delivery logy
Retry / fail
Snapshot sa opiera o uložený enterprise webhook stav vo workspace appke.

Recent delivery activity

Načítavam webhook aktivitu…
Rules

Error Catalog

Validation fail webhook má odkazovať na rule IDs, severity a remediation hints z jednotného katalogu.

Otvoriť error catalog →
Env

Sandbox vs Production

Oddeliť test callbacky od produkčných receiverov, podpisov a retry monitoringu.

Otvoriť režimy →
Portal

Enterprise Portal Flow

Callback eventy musia skončiť v inboxe, audit traili a artifact vrstve, nie len v logu.

Otvoriť portálový flow →