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

Události

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.

Co obsahuje každý požadavek

{
  "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.

Hlavičky

Ověření podpisu

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.

Související články

• Propojení a správa integrace
• Aktivita integrace
• Automatizace pomocí Shopify Flow
• Export PDF