> ## 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.

# Send webhooks til ditt eget system

> Webhooks-integrasjonen sender en signert JSON-hendelse til ditt eget endepunkt når Foliant genererer et dokument eller fullfører en eksport.

**Webhooks**-integrasjonen er for utviklere. Den sender en JSON-hendelse til en HTTPS-adresse du velger hver gang noe skjer i Foliant, slik at ditt eget system kan reagere, for eksempel ved å arkivere hver faktura-PDF eller hente en ferdig eksport.

Webhooks er i beta. Hvis du ikke ser den under **Innstillinger › Integrasjoner**, er den ikke tilgjengelig for butikken din ennå. Kontakt kundestøtte for å spørre om tilgang.

## Hendelser

| Hendelse | Sendes når |
| - | - |
| `document.generated` (**Dokument generert**) | Foliant oppretter et dokument for en ordre: en nedlasting, en eksport eller en e-post med PDF. |
| `export.completed` (**Eksport fullført**) | En masseeksport er klar. |

## 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**.

Du kan endre URL-en, hemmeligheten og hendelsene senere under **Innstillinger** på integrasjonens side.

## Hva hver forespørsel inneholder

Foliant sender en `POST`-forespørsel med en JSON-brødtekst:

```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 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.

Hendelser inneholder ID-er og antall, ikke kunders e-postadresser.

### Overskrifter

| Overskrift | Inneholder |
| - | - |
| `X-Foliant-Event` | Hendelsen, for eksempel `document.generated`. |
| `X-Foliant-Delivery` | Leveringens unike ID (den samme som `id` i brødteksten). |
| `X-Foliant-Timestamp` | Når den ble sendt, i Unix-sekunder. |
| `X-Foliant-Signature` | `sha256=` etterfulgt av signaturen. Bare når du har angitt en signeringshemmelighet. |

## Sjekk signaturen

Signaturen er en heksadesimal HMAC-SHA256 av tidsstempelet, et punktum og den rå brødteksten i forespørselen (`<timestamp>.<body>`), med signeringshemmeligheten din som nøkkel. Beregn den på din side, og sammenlign den med verdien etter `sha256=` i `X-Foliant-Signature`. Bruk den rå brødteksten nøyaktig slik du mottok den.

## 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.

Hver levering vises under **Aktivitet** på integrasjonens side, der du kan klikke på **Prøv igjen** for en mislykket levering. Se [Integrasjonsaktivitet](https://foliant-help.iforiti.com/nb/integrations/integration-activity.md).

## Relaterte artikler

* [Koble til og administrer en integrasjon](https://foliant-help.iforiti.com/nb/integrations/connect-an-integration.md)
* [Integrasjonsaktivitet](https://foliant-help.iforiti.com/nb/integrations/integration-activity.md)
* [Automatiser med Shopify Flow](https://foliant-help.iforiti.com/nb/integrations/shopify-flow.md)
* [Eksporter PDF-er](https://foliant-help.iforiti.com/nb/exports/export-pdfs.md)


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