Bez webhookov vidíte len synchrónne API odpovede. Stav doručenia, opakovania a príjem bežia asynchrónne. Hooky patria ku každej vážnej integrácii.

1. Zverejnite HTTPS endpoint, ktorý dokáže prijímať JSON (dočasne: tunel ako ngrok je pre accp v poriadku)
2. Zaregistrujte hook s topicom InvoiceSent (odosielanie) a/alebo InvoiceReceived (príjem)
3. Odpovedzte do 100 sekúnd HTTP 2xx
4. Overte podpis HMAC SHA256, než payloadu dôverujete

Podpis je v hlavičke X-EConnect-Signature (sha256= plus hex), vypočítaný pomocou secureKey z URL hooku. Pri odpovedi inej ako 2xx skúša PSB doručenie znova až 5 dní.

Presné registračné API, hlavičky a správanie opakovaní: Nastavenie webhookov.

1. Odošlite faktúru (krok 5)
2. Prijmite hook pre odosielacie udalosť
3. Zalogujte topic, document/correlation id a výsledok overenia
4. Zámerne vynúťte non-2xx, aby ste videli štart opakovaní; potom obnovte 2xx

• Nedávajte hook secret do client-side kódu
• Používajte oddelené secrety/URL pre accp a produkciu
• Odmietnite požiadavky s neplatným podpisom (a zalogujte ich)

Pokračujte s:

• SDK a CLI
• Validate API
• API Reference
• Spracovanie chýb