Skicka webhooks till ditt eget system

Händelser

Anslut webhooks

1. Gå till Inställningar › Integrationer i Foliant.
2. Klicka på Anslut under Webhooks.
3. Fyll i inställningarna:

   Fält	Vad du anger
   Slutpunkts-URL	Adressen som Foliant skickar händelser till. Den måste använda HTTPS, till exempel https://example.com/webhooks/foliant.
   Signeringshemlighet	Valfritt. Med en hemlighet signeras varje begäran så att du kan kontrollera att den kom från Foliant.
   Händelser	Händelserna som ska skickas. Båda är valda som standard.

4. Klicka på Anslut.

Vad varje begäran innehåller

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

Data för document.generated

• template: mallens uuid och name.
• document_type: invoice, credit_note, quote eller tomt för andra dokument.
• order: dess id, name och type (ordrar eller utkastordrar).
• refund_id och fulfillment_id, när dokumentet gäller en återbetalning eller en leverans.
• document_number och issued_at, för numrerade dokument.
• source: hur dokumentet skapades, till exempel download, admin_download, export eller email.
• export: exportens ID, när dokumentet ingår i en export.
• generated_at.

Data för export.completed

• export: dess uuid, order_type, template_uuids, antal orders, orders_skipped (raderade efter att de valdes) och documents, requested_by (merchant eller customer) och completed_at.
• download_url: en länk för att ladda ned exporten, och download_url_expires_at, när länken slutar fungera.
• download_expires_at: när själva exporten går ut.

Headers

Kontrollera signaturen

Svar och nya försök

• Alla 2xx-svar räknas som levererade.
• Om din slutpunkt returnerar ett 5xx-fel, 408 eller 429, eller inte svarar inom 10 sekunder, försöker Foliant igen senare och väntar längre varje gång, upp till 5 försök.
• Andra 4xx-svar är slutgiltiga: Foliant försöker inte igen.
• Varje händelse levereras en gång per dokument eller export. Nya försök skickar den aldrig två gånger efter en lyckad leverans.

Relaterade artiklar

• Ansluta och hantera en integration
• Integrationsaktivitet
• Automatisera med Shopify Flow
• Exportera PDF:er