> ## Documentation Index
> Fetch the complete documentation index at: https://foliant-help.iforiti.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Odesílání webhooků do vašeho vlastního systému

> Integrace Webhooky odešle podepsanou událost JSON na váš vlastní endpoint, když Foliant vygeneruje dokument nebo dokončí export.

Integrace **Webhooky** je určena pro vývojáře. Kdykoli se ve Foliantu něco stane, odešle událost JSON na zvolenou adresu HTTPS. Váš vlastní systém pak může reagovat, například uložit PDF každé faktury nebo převzít hotový export.

Webhooky jsou ve verzi beta. Pokud je v **Nastavení › Integrace** nevidíte, pro váš obchod zatím nejsou k dispozici. O přístup požádejte podporu.

## Události

| Událost | Kdy se odesílá |
| - | - |
| `document.generated` (**Dokument vygenerován**) | Foliant vytvoří dokument k objednávce: stažení, export nebo e-mail s PDF. |
| `export.completed` (**Export dokončen**) | Hromadný export je připraven. |

## Propojení webhooků

1. Ve Foliantu přejděte do **Nastavení › Integrace**.

2. U položky **Webhooky** klikněte na **Propojit**.

3. Vyplňte nastavení:

   | Pole | Co zadat |
   | - | - |
   | **URL endpointu** | Adresa, na kterou Foliant odesílá události. Musí používat HTTPS, například `https://example.com/webhooks/foliant`. |
   | **Podpisový klíč** | Nepovinné. S klíčem je každý požadavek podepsán, takže si můžete ověřit, že pochází od Foliantu. |
   | **Události** | Události, které se mají odesílat. Ve výchozím nastavení jsou vybrány obě. |

4. Klikněte na **Propojit**.

URL, klíč a události můžete později změnit v části **Nastavení** na stránce integrace.

## Co obsahuje každý požadavek

Foliant odešle požadavek `POST` s tělem JSON:

```json theme={null}
{
  "id": "a unique delivery id",
  "event": "document.generated",
  "created_at": "2026-10-11T09:30:00+00:00",
  "shop": "your-store.myshopify.com",
  "data": { }
}
```

### Data `document.generated`

* `template`: `uuid` a `name` šablony.
* `document_type`: `invoice`, `credit_note`, `quote`, nebo prázdné u jiných dokumentů.
* `order`: její `id`, `name` a `type` (objednávky nebo koncepty objednávek).
* `refund_id` a `fulfillment_id`, pokud je dokument k refundaci nebo zásilce.
* `document_number` a `issued_at` u číslovaných dokumentů.
* `source`: jak dokument vznikl, například `download`, `admin_download`, `export` nebo `email`.
* `export`: ID exportu, pokud je dokument součástí exportu.
* `generated_at`.

### Data `export.completed`

* `export`: jeho `uuid`, `order_type`, `template_uuids`, počet `orders`, `orders_skipped` (smazané po výběru) a `documents`, `requested_by` (`merchant` nebo `customer`) a `completed_at`.
* `download_url`: odkaz ke stažení exportu a `download_url_expires_at`, kdy tento odkaz přestane fungovat.
* `download_expires_at`: kdy vyprší platnost samotného exportu.

Události obsahují ID a počty, nikoli e-mailové adresy zákazníků.

### Hlavičky

| Hlavička | Obsahuje |
| - | - |
| `X-Foliant-Event` | Událost, například `document.generated`. |
| `X-Foliant-Delivery` | Jedinečné ID doručení (stejné jako `id` v těle). |
| `X-Foliant-Timestamp` | Čas odeslání v sekundách Unix. |
| `X-Foliant-Signature` | `sha256=` následované podpisem. Pouze pokud jste nastavili podpisový klíč. |

## Ověření podpisu

Podpis je hexadecimální HMAC-SHA256 z časového razítka, tečky a nezpracovaného těla požadavku (`<timestamp>.<body>`), s vaším podpisovým klíčem jako klíčem. Vypočítejte ho na své straně a porovnejte s hodnotou za `sha256=` v `X-Foliant-Signature`. Použijte nezpracované tělo přesně tak, jak bylo přijato.

## Odpovědi a opakované pokusy

* Jakákoli odpověď 2xx se počítá jako doručení.
* Pokud váš endpoint vrátí chybu 5xx, 408 nebo 429, nebo neodpoví do 10 sekund, Foliant to zkusí později znovu, pokaždé s delším odstupem, nejvýše 5 pokusů.
* Ostatní odpovědi 4xx jsou konečné: Foliant je neopakuje.
* Každá událost se doručí jednou na dokument nebo export. Opakované pokusy ji po úspěchu nikdy neodešlou dvakrát.

Každé doručení se zobrazí v části **Aktivita** na stránce integrace, kde můžete neúspěšné doručení **Zkusit znovu**. Viz [Aktivita integrace](https://foliant-help.iforiti.com/cs/integrations/integration-activity.md).

## Související články

* [Propojení a správa integrace](https://foliant-help.iforiti.com/cs/integrations/connect-an-integration.md)
* [Aktivita integrace](https://foliant-help.iforiti.com/cs/integrations/integration-activity.md)
* [Automatizace pomocí Shopify Flow](https://foliant-help.iforiti.com/cs/integrations/shopify-flow.md)
* [Export PDF](https://foliant-help.iforiti.com/cs/exports/export-pdfs.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.