Grouper des sous-postes de facture
Pour aider vos clients à mieux comprendre vos factures (tant sous forme de PDF que via la page de facture hébergée ou par e-mail), vous pouvez catégoriser les postes de facture et les regrouper par catégorie. Vous pouvez également masquer des groupes de postes de facture, ce qui peut être utile si certains postes sont trop détaillés : vous pouvez alors faire en sorte que seul le sous-total de certains groupes soit visible de vos clients.
Ce guide décrit comment organiser les factures ponctuelles et les factures d’abonnement en créant des groupes et des filtres dynamiques dans le Dashboard Stripe.
Regroupez les sous-postes de facture de manière dynamique à l’aide d’expressions CEL.
Postes de facture non groupés
Postes de factures groupés avec des postes récapitulatifs (groupe « Red items » réduit)
Avant de commencer
Pour utiliser cette fonctionnalité, vous devez définir des règles et des modèles à l’aide d’expressions CEL (Common Expression Language). Pour en savoir plus sur CEL, consultez cette présentation. Ce guide fournit quelques exemples applicables aux modèles de factures, mais nous vous recommandons de lire la définition officielle de ce langage sur GitHub. Vous pouvez également commencer par un cas d’usage courant.
Uniquement disponible avec Billing Scale
Le regroupement des postes de facture à l’aide de CEL nécessite un abonnement à Billing Scale.
Restrictions
Cette fonctionnalité présente certaines limites :
- Vous pouvez uniquement appliquer des expressions CEL aux factures créées à partir du Dashboard.
- Chaque expression CEL a une longueur maximale de 1 024 caractères.
- Un modèle dispose d’un maximum de 10 politiques de regroupement des postes de facture.
- Chaque expression CEL a une limite de développement de 1. Par exemple, nous prenons en charge
line_item.invoice_item.expand().description
mais pasline_item.subscription.expand().default_payment_method.expand().type
. - Les expressions CEL ne sont pas compatibles avec tous les champs de l’objet Invoice Item dans l’API publique.
- Les expressions CEL utilisent la version de l’API
2022-11-15
comme ressource sous-jacente. Les versions ultérieures de l’API et les fonctionnalités de prévisualisation ne sont pas automatiquement prises en charge pendant la phase bêta.
Grouper des sous-postes de facture
Vous pouvez regrouper des sous-postes de facture dans le Dashboard. Si vous souhaitez utiliser l’API, vous pouvez demander un accès anticipé à la version bêta dans l’onglet API.
Cas d'usage
Le tableau suivant fournit quelques exemples de politiques de regroupement courantes.
Cas d’usage | Détails et exemple |
---|---|
Grouper par métadonnées de sous-poste de facture | Certaines entreprise utilisent un processus commercial qui relie différents numéros de bon de commande à chaque sous-postes de facture à l’aide d’une métadonnée nommée « PO ». Dans cet exemple, le champ Grouper par crée des groupes pour chaque numéro de bon de commande et répertorie les postes de facture correspondant à ce numéro à partir de leur champ de métadonnées. Grouper par :
Filtrer par :
|
Grouper par métadonnées de tarif | Vous pouvez également choisir de regrouper les sous-postes de facture par métadonnées de tarif afin d’organiser la facture par type de tarif. La facture est divisée en plusieurs parties selon la chaîne Grouper par :
Filtrer par :
|
Grouper par prorata | Si vos factures d’abonnement incluent de nombreux postes de facture correspondant à des calculs au prorata, vous voudrez peut-être simplifier votre facture pour les clients. Cet exemple regroupe les postes dont le montant calculé au prorata est supérieur à 0 USD dans un groupe appelé « Crédits » et les postes négatifs dans un groupe appelé « Débits ». Grouper par :
Filtrer par :
|
Grouper les postes de facture par description | Tous les postes de facture non regroupés figurent par défaut dans la section Autre d’un récapitulatif. Si vous souhaitez répertorier les postes non regroupés par description, vous pouvez développer la section Autre sous un récapitulatif. Pour éviter de remplacer une autre stratégie de regroupement, il doit s’agir du dernier élément de la liste des stratégies. Grouper par :
|