Trimiteți webhookuri către propriul sistem

Evenimente

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.

Ce conține fiecare cerere

{
  "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.

Antete

Verificați semnătura

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.

Articole conexe

• Conectați și gestionați o integrare
• Activitatea integrării
• Automatizați cu Shopify Flow
• Exportați PDF-uri