Send webhooks til ditt eget system

Hendelser

Koble til webhooks

1. Gå til Innstillinger › Integrasjoner i Foliant.
2. Klikk på Koble til under Webhooks.
3. Fyll ut innstillingene:

   Felt	Hva du skal skrive inn
   Endepunkt-URL	Adressen Foliant sender hendelser til. Den må bruke HTTPS, for eksempel https://example.com/webhooks/foliant.
   Signeringshemmelighet	Valgfritt. Med en hemmelighet blir hver forespørsel signert, slik at du kan sjekke at den kom fra Foliant.
   Hendelser	Hendelsene som skal sendes. Begge er valgt som standard.

4. Klikk på Koble til.

Hva hver forespørsel inneholder

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

Data for document.generated

• template: malens uuid og name.
• document_type: invoice, credit_note, quote, eller tom for andre dokumenter.
• order: ordrens id, name og type (ordrer eller ordreutkast).
• refund_id og fulfillment_id, når dokumentet gjelder en refusjon eller en forsendelse.
• document_number og issued_at, for nummererte dokumenter.
• source: hvordan det ble laget, for eksempel download, admin_download, export eller email.
• export: eksportens ID, når det er en del av en eksport.
• generated_at.

Data for export.completed

• export: eksportens uuid, order_type, template_uuids, antall orders, orders_skipped (slettet etter at de ble valgt) og documents, requested_by (merchant eller customer) og completed_at.
• download_url: en lenke for å laste ned eksporten, og download_url_expires_at, når lenken slutter å virke.
• download_expires_at: når selve eksporten utløper.

Overskrifter

Sjekk signaturen

Svar og nye forsøk

• Ethvert 2xx-svar regnes som levert.
• Hvis endepunktet ditt returnerer en 5xx-feil, 408 eller 429, eller ikke svarer innen 10 sekunder, prøver Foliant igjen senere og venter lenger hver gang, opptil 5 forsøk.
• Andre 4xx-svar er endelige: Foliant prøver ikke på nytt.
• Hver hendelse leveres én gang per dokument eller eksport. Nye forsøk sender den aldri to ganger etter en vellykket levering.

Relaterte artikler

• Koble til og administrer en integrasjon
• Integrasjonsaktivitet
• Automatiser med Shopify Flow
• Eksporter PDF-er