Modèle de courriel des factures

Envoyé chaque fois qu'une nouvelle commande est complétée, ainsi que pour les paiements récurrents d'abonnement — order.isRecurringInvoice permet de distinguer les deux.

Le modèle reçoit :

Variable	Type	Notes
context	string	Email, Pdf ou Html — permet à un même modèle de s'afficher dans plusieurs contextes.
settings	object	Paramètres de la boutique — voir Settings (signature, businessAddress, logoUrl, includeProductImagesInInvoice, orderHistoryUrl).
order	Order	La commande complétée.
refund	Refund	Présent uniquement lorsque le courriel fait suite à un remboursement.

Ce à quoi vous avez accès

Les données sont décrites par des types réutilisables, chacun documenté une seule fois et partagé entre tous les courriels de commande :

Chemin	Type
order	Order
order.items[]	Item
order.billingAddress, order.shippingAddress	Address
order.summary	Summary
order.summary.taxes[], order.taxes[]	Tax
order.discounts[]	Discount
order.customFields[], order.items[].customFields[]	CustomField
order.refunds[], refund	Refund

Exemple minimal

{
  "context": "Email",
  "settings": { "businessAddress": { "...": "see Address" }, "logoUrl": "..." },
  "order": {
    "invoiceNumber": "SNIP-1001",
    "email": "john.doe@example.com",
    "total": 120,
    "items": [ { "id": "tshirt", "name": "Geek T-Shirt", "quantity": 2, "unitPrice": 50, "categories": [], "metadata": null } ],
    "summary": { "subtotal": 100, "total": 120, "taxes": [] }
  }
}

Le détail champ par champ se trouve dans les pages de types liées — regroupé à un seul endroit afin que chaque courriel de commande (Factures, Commande reçue, Expédiée, Suivi, Remboursement, Commentaire) partage une seule source de vérité.