Wysyłaj webhooki do własnego systemu

Zdarzenia

Połącz webhooki

1. W Foliant przejdź do Ustawienia › Integracje.
2. Przy Webhooki kliknij Połącz.
3. Wypełnij ustawienia:

   Pole	Co wpisać
   Adres URL endpointu	Adres, na który Foliant wysyła zdarzenia. Musi używać HTTPS, np. https://example.com/webhooks/foliant.
   Sekret podpisu	Opcjonalnie. Z sekretem każde żądanie jest podpisane, więc możesz sprawdzić, czy pochodzi od Foliant.
   Zdarzenia	Zdarzenia do wysyłania. Domyślnie oba są zaznaczone.

4. Kliknij Połącz.

Co zawiera każde żądanie

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

Dane document.generated

• template: uuid i name szablonu.
• document_type: invoice, credit_note, quote lub puste dla innych dokumentów.
• order: jego id, name i type (zamówienia lub wersje robocze zamówień).
• refund_id i fulfillment_id, gdy dokument dotyczy zwrotu pieniędzy lub przesyłki.
• document_number i issued_at, dla dokumentów numerowanych.
• source: sposób utworzenia, np. download, admin_download, export lub email.
• export: ID eksportu, gdy dokument jest częścią eksportu.
• generated_at.

Dane export.completed

• export: jego uuid, order_type, template_uuids, liczba orders, orders_skipped (usunięte po wybraniu) i documents, requested_by (merchant lub customer) oraz completed_at.
• download_url: link do pobrania eksportu, oraz download_url_expires_at, czyli moment, w którym link przestaje działać.
• download_expires_at: kiedy wygasa sam eksport.

Nagłówki

Sprawdź podpis

Odpowiedzi i ponowienia

• Każda odpowiedź 2xx oznacza dostarczenie.
• Jeśli Twój endpoint zwróci błąd 5xx, 408 lub 429 albo nie odpowie w ciągu 10 sekund, Foliant spróbuje ponownie później, za każdym razem czekając dłużej, maksymalnie 5 razy.
• Inne odpowiedzi 4xx są ostateczne: Foliant ich nie ponawia.
• Każde zdarzenie jest dostarczane raz na dokument lub eksport. Po udanym dostarczeniu ponowienia nigdy nie wysyłają go drugi raz.

Powiązane artykuły

• Połącz integrację i zarządzaj nią
• Aktywność integracji
• Automatyzuj za pomocą Shopify Flow
• Eksportuj pliki PDF