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

# Trimiteți webhookuri către propriul sistem

> Integrarea Webhooks trimite un eveniment JSON semnat către propriul endpoint atunci când Foliant generează un document sau finalizează un export.

Integrarea **Webhooks** este destinată dezvoltatorilor. Aceasta trimite un eveniment JSON la o adresă HTTPS aleasă de dumneavoastră ori de câte ori se întâmplă ceva în Foliant, astfel încât propriul sistem să poată reacționa, de exemplu arhivând fiecare factură PDF sau preluând un export finalizat.

Webhooks este în versiune beta. Dacă nu o vedeți în **Setări › Integrări**, nu este încă disponibilă pentru magazinul dvs. Contactați asistența pentru a solicita acces.

## Evenimente

| Eveniment | Trimis când |
| - | - |
| `document.generated` (**Document generat**) | Foliant creează un document pentru o comandă: o descărcare, un export sau un e-mail cu PDF. |
| `export.completed` (**Export finalizat**) | Un export în bloc este gata. |

## Conectați webhookurile

1. În Foliant, accesați **Setări › Integrări**.

2. La **Webhooks**, faceți clic pe **Conectați**.

3. Completați setările:

   | Câmp | Ce introduceți |
   | - | - |
   | **URL endpoint** | Adresa la care Foliant trimite evenimentele. Trebuie să folosească HTTPS, de exemplu `https://example.com/webhooks/foliant`. |
   | **Secret de semnare** | Opțional. Cu un secret, fiecare cerere este semnată, astfel încât să puteți verifica dacă provine de la Foliant. |
   | **Evenimente** | Evenimentele de trimis. Ambele sunt selectate implicit. |

4. Faceți clic pe **Conectați**.

Puteți modifica ulterior URL-ul, secretul și evenimentele din **Setări**, pe pagina integrării.

## Ce conține fiecare cerere

Foliant trimite o cerere `POST` cu un corp JSON:

```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": { }
}
```

### Datele `document.generated`

* `template`: `uuid` și `name` ale șablonului.
* `document_type`: `invoice`, `credit_note`, `quote` sau gol pentru alte documente.
* `order`: `id`, `name` și `type` ale comenzii (comenzi sau comenzi preliminare).
* `refund_id` și `fulfillment_id`, când documentul este pentru o rambursare sau o expediere.
* `document_number` și `issued_at`, pentru documentele numerotate.
* `source`: modul în care a fost creat, de exemplu `download`, `admin_download`, `export` sau `email`.
* `export`: ID-ul exportului, când face parte dintr-un export.
* `generated_at`.

### Datele `export.completed`

* `export`: `uuid`, `order_type`, `template_uuids`, numărul de `orders`, `orders_skipped` (șterse după ce au fost alese) și `documents`, `requested_by` (`merchant` sau `customer`) și `completed_at`.
* `download_url`: un link pentru descărcarea exportului și `download_url_expires_at`, momentul în care acest link nu mai funcționează.
* `download_expires_at`: momentul în care expiră exportul în sine.

Evenimentele conțin ID-uri și numere, nu adrese de e-mail ale clienților.

### Antete

| Antet | Conține |
| - | - |
| `X-Foliant-Event` | Evenimentul, de exemplu `document.generated`. |
| `X-Foliant-Delivery` | ID-ul unic al livrării (același cu `id` din corp). |
| `X-Foliant-Timestamp` | Momentul trimiterii, în secunde Unix. |
| `X-Foliant-Signature` | `sha256=` urmat de semnătură. Doar dacă ați setat un secret de semnare. |

## Verificați semnătura

Semnătura este un HMAC-SHA256 hexazecimal al marcajului de timp, al unui punct și al corpului brut al cererii (`<timestamp>.<body>`), folosind secretul de semnare drept cheie. Calculați-o pe partea dvs. și comparați-o cu valoarea de după `sha256=` din `X-Foliant-Signature`. Folosiți corpul brut exact așa cum a fost primit.

## Răspunsuri și reîncercări

* Orice răspuns 2xx este considerat livrat.
* Dacă endpointul dvs. returnează o eroare 5xx, 408 sau 429 ori nu răspunde în 10 secunde, Foliant încearcă din nou mai târziu, așteptând tot mai mult de fiecare dată, până la 5 încercări.
* Celelalte răspunsuri 4xx sunt definitive: Foliant nu le reîncearcă.
* Fiecare eveniment este livrat o singură dată per document sau export. Reîncercările nu îl trimit niciodată de două ori după un succes.

Fiecare livrare apare în **Activitate** pe pagina integrării, unde puteți folosi **Reîncercați** pentru una eșuată. Consultați [Activitatea integrării](https://foliant-help.iforiti.com/ro/integrations/integration-activity.md).

## Articole conexe

* [Conectați și gestionați o integrare](https://foliant-help.iforiti.com/ro/integrations/connect-an-integration.md)
* [Activitatea integrării](https://foliant-help.iforiti.com/ro/integrations/integration-activity.md)
* [Automatizați cu Shopify Flow](https://foliant-help.iforiti.com/ro/integrations/shopify-flow.md)
* [Exportați PDF-uri](https://foliant-help.iforiti.com/ro/exports/export-pdfs.md)


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