Webhooky

Webhook je adresa na vašem serveru, na kterou invo.space pošle POST požadavek, když se něco stane, třeba když se zaplatí faktura. Adresu nastavíte v Nastavení > API a webhooky v poli Webhook URL.

NastaveníKopírovat odkaz

1. Otevřete Nastavení > API a webhooky.
2. V části Webhooky vyplňte Webhook URL, například https://example.com/webhook.
3. Klikněte na Uložit.

Pokud webhooky nepoužíváte, nechte pole prázdné. Účet má jednu adresu pro všechny události.

UdálostiKopírovat odkaz

Formát požadavkuKopírovat odkaz

Tělo je JSON s názvem události a daty:

{
  "event": "invoicePaid",
  "payload": {
    "invoiceUuid": "...",
    "symbol": "20260104",
    "orderUuid": null,
    "orderSymbol": null,
    "customSymbol": null,
    "dateOfPayment": "2026-11-03T00:00:00+01:00"
  }
}

Obsah payload podle události:

• invoicePaid: invoiceUuid, symbol, orderUuid, orderSymbol, customSymbol, dateOfPayment.
• invoiceUpdated: stejné identifikátory jako invoicePaid (bez data zaplacení) a pole items s položkami faktury (id, extId, amount, unit, description, ceny a taxRate). Částky mají tvar { "amount": "...", "currency": "CZK" }.
• orderPaid: uuid, symbol, dateOfPayment.

orderUuid a orderSymbol jsou vyplněné, když faktura vznikla z výzvy k platbě, takže fakturu spárujete s objednávkou ve svém systému.

Ruční odesláníKopírovat odkaz

V detailu zaplacené faktury nebo výzvy k platbě najdete v menu (tři tečky vedle Upravit) volbu Odeslat webhook o zaplacení. Hodí se, když váš server požadavek nezpracoval, nebo pro událost orderPaid. Pokud webhook URL není nastavená, aplikace vás upozorní.

Ruční odeslání je i v API: POST /api/v2/webhooks s tělem {"event": "invoicePaid", "entityId": "<uuid dokladu>"}.

Na co mysletKopírovat odkaz

• Požadavky nepodepisujeme. Ověřte si, že doklad opravdu existuje a je zaplacený, voláním API, než podle webhooku něco uděláte (třeba odešlete zboží).
• Neúspěšné doručení neopakujeme. Když váš server neodpoví, použijte ruční odeslání.
• Webhook posíláme hned při události, proto ho na svém serveru zpracujte rychle.