Bez webhooků vidíte jen synchronní API odpovědi. Stav doručení, opakování a příjem běží asynchronně. Hooky patří ke každé vážné integraci.

1. Zveřejněte HTTPS endpoint, který dokáže přijímat JSON (dočasně: tunel jako ngrok je pro accp v pořádku)
2. Zaregistrujte hook s topicem InvoiceSent (odesílání) a/nebo InvoiceReceived (příjem)
3. Odpovězte do 100 sekund HTTP 2xx
4. Ověřte podpis HMAC SHA256, než payloadu důvěřujete

Podpis je v hlavičce X-EConnect-Signature (sha256= plus hex), vypočtený pomocí secureKey z URL hooku. Při odpovědi jiné než 2xx zkouší PSB doručení znovu až 5 dní.

Přesné registrační API, hlavičky a chování opakování: Nastavení webhooků.

1. Odešlete fakturu (krok 5)
2. Přijměte hook pro odesílací událost
3. Zalogujte topic, document/correlation id a výsledek ověření
4. Záměrně vynucujte non-2xx, abyste viděli start opakování; potom obnovte 2xx

• Nedávejte hook secret do client-side kódu
• Používejte oddělené secrety/URL pro accp a produkci
• Odmítněte požadavky s neplatným podpisem (a zalogujte je)

Pokračujte s:

• SDK a CLI
• Validate API
• API Reference
• Zpracování chyb