Webhooky
Tento návod vysvetľuje, ako si nastaviť webhooky pre odber udalostí z API eFaktúry.
Krok 1: Zaregistrujte endpoint
Endpoint zaregistrujete v developerskom portáli v sekcii Webhooky, alebo cez POST /v1/partner/webhooks. Musí byť HTTPS, jeden partner môže mať najviac 20 endpointov. Endpoint štandardne dostáva udalosti za všetky vaše organizácie; voliteľným orgId ho obmedzíte na jednu organizáciu.
Krok 2: Uložte si podpisový secret
Pri vytvorení dostanete podpisový secret iba raz — uložte si ho hneď.
Krok 3: Vyberte typy udalostí
Dostupné eventy: peppol.document.sent (doklad prijatý sieťou), peppol.document.delivered (doručený príjemcovi), peppol.document.failed (odoslanie zlyhalo), peppol.document.received (prišiel vám príchodzí doklad) a usage.limit_exceeded (prekročený zahrnutý mesačný objem).
Krok 4: Overte podpis doručenia
Telo je podpísané HMAC-SHA256 v hlavičke X-Webhook-Signature (formát t=<unix>,v1=<hex>), doplnené hlavičkami X-Webhook-Event, X-Webhook-Id (idempotenčný kľúč) a X-Webhook-Timestamp. Podpisujte reťazec <timestamp>.<raw body> — použite surové telo requestu, nie znova serializovaný JSON.
Krok 5: Otestujte a sledujte doručenia
V portáli môžete poslať testovací event, pozrieť históriu doručení (payload + odpoveď) a znovu-odoslať ktorékoľvek minulé doručenie.
Pozor: Endpoint musí odpovedať HTTP 2xx do niekoľkých sekúnd; pri zlyhaní sa doručenie opakuje 5× s exponenciálnym backoffom (5/10/20/40/80 s). Po 15 po sebe zlyhaných doručeniach sa endpoint automaticky deaktivuje.
Tip: Deduplikujte podľa
X-Webhook-Id— replay pošle rovnaké ID. Pri rotácii secretu môže hlavička obsahovať viacv1=segmentov naraz (starý secret platí ešte 24 h), stačí, ak sedí ktorýkoľvek.
Súvisiace návody
Pomohol vám tento návod?