# Modèles de rendu pour les factures Utilisez les modèles de rendu de facture pour personnaliser l’apparence de votre facture pour différents clients Vous pouvez personnaliser le contenu de vos factures pour des groupes de clients spécifiques. Voici quelques exemples : - Afficher un texte spécifique dans le champ de bas de page de votre facture pour les clients d’un pays particulier - Afficher un mémo spécifique pour les clients ayant une source de revenus particulière - Regrouper des postes d’une certaine manière pour les clients dont les transactions sont complexes Ce guide décrit comment utiliser les modèles de rendu de facture pour : - Stocker et réutiliser des valeurs courantes pour les champs de la facture au lieu de les saisir pour chaque facture concernée - Stocker, gérer et mettre à jour les valeurs des champs de la facture qui s’appliquent à un grand nombre de clients - Configurer les règles de regroupement des postes, qui ne peuvent pas être définies en dehors des modèles de rendu de facture - Pour les factures d’abonnement, personnaliser les valeurs de la facture sans toucher directement à la facture elle-même. ## Configurer des modèles de rendu de facture Vous pouvez créer des modèles de rendu de facture uniquement dans le Dashboard. Il n’est pas possible de les créer à l’aide de l’API. 1. Dans vos paramètres de facturation, sélectionnez l’onglet [Factures > Modèles](https://dashboard.stripe.com/settings/billing/invoice-templates). 1. Cliquez sur **+ Créer un modèle**. 1. Saisissez un nom pour votre modèle. 1. Spécifiez les valeurs des champs que vous souhaitez inclure dans le modèle. Les modèles de facture prennent en charge le mémo, le pied de page et les champs personnalisés. 1. Éventuellement, vous pouvez [définir un ou plusieurs groupes de postes à l’aide d’expressions du langage d’expression commun (Common Expression Language, CEL)](https://docs.stripe.com/invoicing/group-line-items.md). 1. Pour obtenir un aperçu de votre modèle, saisissez l’ID d’une facture applicable dans le champ **ID de la facture** du volet de prévisualisation. Notez cependant que toute valeur définie directement sur cette facture remplace la valeur correspondante du modèle. Par exemple, si cette facture a une valeur de pied de page, l’aperçu affiche le pied de page de la facture et non celui du modèle. ## Appliquer des modèles de rendu de facture aux factures #### Dashboard Dans le Dashboard, vous pouvez appliquer un modèle aux factures de la manière suivante : - Dans l’éditeur de factures - Dans l’éditeur d’abonnements, pour appliquer à toutes les factures associées à l’abonnement - Dans les paramètres de facturation d’un client, pour appliquer à toutes les futures factures associées à ce client #### API > #### Utiliser l’API Accounts v2 pour représenter les clients > > L’API Accounts v2 est disponible en version générale pour les utilisateurs Connect, et en version bêta publique pour les autres utilisateurs Stripe. Tous les utilisateurs Stripe peuvent activer Accounts v2 [dans leur Dashboard](https://dashboard.stripe.com/settings/connect/platform-setup). Cependant, lorsqu’ils effectuent des appels à l’API Accounts v2, les utilisateurs de la version bêta doivent [indiquer une version bêta](https://docs.stripe.com/api-v2-overview.md#sdk-and-api-versioning). > > Dans la plupart des cas d’usage, nous vous recommandons de [modéliser vos clients en tant qu’objets Account configurés par le client](https://docs.stripe.com/connect/use-accounts-as-customers.md), plutôt que d’utiliser des objets [Customer](https://docs.stripe.com/api/customers.md). #### Accounts v2 Avec l’API, vous pouvez appliquer un modèle aux factures de différentes manières : - When you create a draft invoice using the [Invoicing API](https://docs.stripe.com/api/invoices/create.md#create_invoice-rendering-template): ```curl curl https://api.stripe.com/v1/invoices \ -u "<>:" \ -d "customer_account={{CUSTOMERACCOUNT_ID}}" \ -d collection_method=send_invoice \ -d days_until_due=30 \ -d "rendering[template]=inrtem_xxx" ``` - When you create or update a customer-configured `Account`, use [configuration.customer.billing.invoice.rendering.template](https://docs.stripe.com/api/v2/core/accounts/object.md#v2_account_object-configuration-customer-billing-invoice-rendering-template) to apply a template to all future invoices associated with that customer, including subscription-generated invoices: ```curl curl -X POST https://api.stripe.com/v2/core/accounts \ -H "Authorization: Bearer <>" \ -H "Stripe-Version: $latestPreviewApiVersion" \ --json '{ "contact_email": "jenny.rosen@example.com", "display_name": "Jenny Rosen", "configuration": { "customer": { "billing": { "invoice": { "rendering": { "template": "inrtem_xxx" } } } } }, "include": [ "configuration.customer" ] }' ``` #### Customers v1 Avec l’API, vous pouvez appliquer un modèle aux factures de différentes manières : - When you create a draft invoice using the [Invoicing API](https://docs.stripe.com/api/invoices/create.md#create_invoice-rendering-template): ```curl curl https://api.stripe.com/v1/invoices \ -u "<>:" \ -d customer=cus_xxx \ -d collection_method=send_invoice \ -d days_until_due=30 \ -d "rendering[template]=inrtem_xxx" ``` - When you create or update a `Customer`, use [invoice_settings.rendering_options.template](https://docs.stripe.com/api/customers/create.md#create_customer-invoice_settings-rendering_options-template) to apply a template to all future invoices associated with that customer, including subscription-generated invoices: ```curl curl https://api.stripe.com/v1/customers \ -u "<>:" \ -d "name=Jenny Rosen" \ -d "invoice_settings[rendering_options][template]=inrtem_xxx" ``` Vous ne pouvez pas utiliser l’API pour appliquer des modèles de facture directement aux abonnements, aux planifications d’abonnement ou aux devis. En revanche, vous pouvez attacher un modèle à un client pour l’appliquer à toutes les futures factures associées à ce client, ou appliquer un modèle à des factures à l’état de projet. ## Remplacer et mettre à jour les modèles Vous pouvez configurer les valeurs des champs correspondant au pied de page de la facture, au mémo et aux champs personnalisés à plusieurs endroits. Lorsque plusieurs valeurs peuvent s’appliquer à un champ de facture, elles sont classées dans l’ordre suivant, de la plus élevée à la plus basse : | Priorité | Paramètres | Méthode | | ------------------------------ | -------------------------------------- | -------------------- | | 1 | Sur la facture | Dashboard ou API | | Sur l’abonnement | Dashboard uniquement | | 2 | Modèle appliqué à la facture | Dashboard ou API | | Modèle appliqué à l’abonnement | Dashboard uniquement | | 3 | Modèle attaché au client | Dashboard ou API | | 4 | Paramètres de la facture sur le client | API uniquement | | 5 | Paramètres de la facture sur le compte | Dashboard uniquement | > Les paramètres de facturation définis s’appliquent toujours, sauf s’ils sont remplacés par un paramètre de priorité supérieure. Par exemple, pour créer une facture ponctuelle pour un client qui remplace le modèle associé à ce client, vous devez soit appliquer un modèle différent à la facture, soit définir directement les valeurs de la facture. Lorsque vous mettez à jour ou remplacez un modèle, les nouvelles valeurs s’appliquent à toutes les factures futures associées à ce modèle. Par exemple, si vous mettez à jour une valeur dans le modèle d’un client, la nouvelle valeur s’applique à toutes les factures futures pour les abonnements existants de ce client, sauf si le modèle d’abonnement la remplace.