Référence pour le fichier CSV du kit d'outils

Suivez ce guide pour vous aider à définir votre fichier CSV dans la boîte à outils de migration Billing. Dans les exemples suivants, tous les horodatages sont au format Unix EPOCH. Nous fournissons également des identifiants de client et de tarif de test que vous pouvez utiliser dans un environnement de test.

Prérequis CSV

Avant de créer ou de télécharger un fichier CSV, assurez-vous de connaître les points suivants :

Cas d’usage de migration

Vous pouvez appliquer les cas d’usage de migration ci-dessous à votre propre migration, le cas échéant :

• Migrer des abonnements avec différents modèles tarifaires
• Migrer des abonnements avec différentes méthodes d’encaissement des paiements
• Migrer les abonnements à différents stades du cycle d’abonnement
• Migrer des abonnements avec des taxes
• Migrer des abonnements avec des réductions
• Migrer des abonnements entre des comptes Stripe
• Migrer des abonnements à plusieurs phases

Vous pouvez combiner n’importe quel modèle CSV fourni par Stripe (Basique, Articles à prix multiples, Tarifs ad hoc) avec n’importe lequel des exemples ci-dessous selon vos besoins.

Migrer des abonnements avec différents modèles tarifaires

Vous pouvez migrer des abonnements avec une tarification forfaitaire, comme un plan de base à 100 USD par mois ou un plan avancé à 200 USD par mois. Ces abonnements peuvent avoir un ou plusieurs postes.

Exemple 1 (basique) : migrer un abonnement mensuel de base de 100 USD avec une quantité de 2, à partir du 1er janvier 2024. L’abonnement est facturé automatiquement à l’aide du moyen de paiement par défaut.

Exemple 2 (articles à prix multiples) : migrez les abonnements suivants à partir du 1er janvier 2024 pour qu’ils soient facturés automatiquement via le moyen de paiement par défaut :

• Un abonnement mensuel de base de 100 USD avec une quantité de 2
• Un abonnement mensuel avancé de 200 USD avec une quantité de 1

Exemple 3 (basique) : migrer l’abonnement suivant à partir du 1er janvier 2024 pour qu’il soit facturé automatiquement via le moyen de paiement par défaut :

• Un abonnement mensuel de base de 100 USD avec une quantité de 2
• Des frais additionnels de 20 USD pour les factures ad hoc

Vous pouvez également migrer des abonnements avec un tarif ad hoc, dans les cas où vous n’avez pas de montants de tarif fixes.

Exemple 4 (tarifs ad hoc) : migrez l’abonnement suivants à partir du 1er janvier 2024 pour qu’il soit facturés automatiquement via le moyen de paiement par défaut :

• Un abonnement mensuel ad hoc de 153 USD avec une quantité de 1

Migrer des abonnements avec différentes méthodes d’encaissement des paiements

Vous pouvez collecter le paiement des abonnements migrés automatiquement via le moyen de paiement enregistré par défaut ou en envoyant une facture que le client peut payer à la date d’échéance.

Exemple 1 (basique) : migrer un abonnement annuel de 500 USD avec une quantité de 1 à partir du 1er janvier 2024, pour qu’il soit facturé automatiquement via le moyen de paiement par défaut.

Exemple 2 (basique) : migrer un abonnement annuel de 500 USD avec une quantité de 1 à partir du 1er janvier 2024. Cet abonnement est facturé via une facture envoyée au client, avec une date d’échéance de 30 jours.

Migrer des abonnements à différents stades du cycle d’abonnement

Exemple 1 (basique) : migrer un abonnement dont le renouvellement est prévu. Par exemple, migrez un abonnement mensuel de 100 USD dont la date de renouvellement est le 1er janvier 2024. L’abonnement est renouvelé le 1er de chaque mois.

• Définissez start_date sur la date de renouvellement actuelle, afin que l’abonnement soit facturé immédiatement.
• Définissez billing_cycle_anchor sur la date du prochain cycle de renouvellement.
• Définissez proration_behavior sur la valeur none.

Exemple 2 (basique) : migrer un abonnement payant qui se trouve au milieu d’un cycle de facturation. Par exemple, migrez un abonnement mensuel de 100 USD dont la date de début initiale est le 25 décembre. La date de migration est le 1er janvier et l’abonnement est renouvelé le 25 de chaque mois.

• Définissez backdate_start_date sur la date de début initiale de l’abonnement.
• Définissez billing_cycle_anchor sur la prochaine date de renouvellement.
• Définissez start_date sur la date de migration.
• Définissez proration_behavior sur la valeur none pour éviter de facturer à nouveau le client et maintenir l’abonnement dans un état planifié jusqu’au prochain cycle de facturation.

Exemple 3 (basique) : migrer des abonnements en périodes d’essai. Par exemple, migrez un abonnement mensuel de base de 100 USD à partir du 1er janvier 2024. L’abonnement est en période d’essai jusqu’au 31 janvier 2024. Après la fin de la période d’essai, l’abonnement est facturé automatiquement via le moyen de paiement par défaut.

Exemple 4 (basique) : migrer des abonnements en retard. Par exemple, migrez un abonnement mensuel de 100 USD dont la date de début du dernier cycle est le 25 décembre et qui n’a pas été payé. Migrez cet abonnement en milieu de cycle à partir du 1er janvier avec une date de renouvellement le 25 de chaque mois. Cela crée une facture au prorata du 1er janvier au 25 janvier pour laquelle Stripe peut essayer de collecter le paiement.

Pour migrer les abonnements qui sont dans un cycle actif mais qui n’ont pas été payés dans le système précédent, définissez proration_behavior sur create_prorations pour créer immédiatement une facture et collecter le paiement. Cela permet également d’entrer l’abonnement dans le flux de relance de Stripe si le paiement est toujours impayé.

Exemple 5 : migrez les abonnements qui doivent être annulés à la fin du cycle. Après la migration, vous pouvez choisir de facturer ou non ces abonnements, en fonction du moment de la migration (en milieu de cycle ou au moment du renouvellement).

Ils sont annulés à la fin de cette période. Par exemple, migrez un abonnement mensuel basique de 100 USD à partir du 1er janvier 2024. Cet abonnement est automatiquement annulé le 31 janvier 2024.

Migrer des abonnements avec des taxes

Exemple 1 (basique) : migrer des abonnements pour calculer automatiquement la taxe en activant Stripe Tax. Par exemple, migrez un abonnement mensuel de 100 USD à partir du 1er janvier 2024 en activant Stripe Tax pour calculer automatiquement la taxe.

Le kit d’outils de migration valide si vous avez activé Stripe Tax à l’avance et si les clients ont fourni les champs requis pour calculer la taxe automatiquement. Assurez-vous que vos clients fournissent les informations nécessaires avant la migration.

Exemple 2 (basique) : migrer des abonnements et calculer la taxe à l’aide des taux de taxe manuels. Par exemple, pour migrer un abonnement mensuel basique de 100 $ à partir du 1er janvier 2024, avec une taxe de 10 % créée à l’aide des taux de taxe manuels :

• Créez un taux de taxe manuel de 10 % dans le Dashboard(Catalogue de produits > Bons de réduction).
• Utilisez l’ID du taux de taxe dans le modèle de migration au format CSV.

Exemple 3 (basique) : si vous utilisez un prestataire de services fiscaux externe, tel qu’Avalara ou Vertex :

Pour les abonnements migrés pour lesquels la taxe est déjà calculée, laissez les champs automatic_tax et default_tax_rate vides dans le CSV.

Une fois les abonnements migrés et mis en service, ils suivent automatiquement les flux de travail d’intégration fiscale que vous avez configurés pour les nouveaux abonnements dans votre intégration Billing.

Migrer des abonnements avec des réductions

Le kit d’outils de migration ne prend actuellement en charge qu’un seul bon de réduction par abonnement.

Exemple 1 (basique) : vous pouvez migrer des abonnements avec des réductions qui sont appliquées après la migration. Par exemple, pour migrer un abonnement mensuel de 100 $ à partir du 1er janvier 2024, avec une réduction permanente de 10 % :

• Créez un bon de réduction de 10 % dans le Dashboard(Catalogue de produits > Bons de réduction).
• Utilisez le nom du bon de réduction dans le fichier CSV de migration.

Migrer des abonnements entre des comptes Stripe

Les étapes pour migrer les abonnements d’un compte Stripe à un autre sont les mêmes que lors d’une migration à partir d’un système tiers. Utilisez le kit d’outils de migration Billing pour migrer les abonnements. Vous devrez exporter les données d’abonnement pour votre fichier CSV depuis votre ancien compte Stripe.

Exemple 1 (basique) : pour créer un fichier CSV de migration pour une migration Stripe vers Stripe :

1. Exportez les abonnements de l’ancien compte Stripe via le Dashboard.
2. Utilisez l’exemple CSV suivant comme référence pour mapper les champs entre les anciens et nouveaux comptes Stripe.

Migrer des abonnements à plusieurs phases

Le kit d’outils de migration ne permet pas d’ajouter plusieurs phases directement à un abonnement. Nous recommandons l’approche suivante :

1. Utilisez le kit d’outils de migration pour migrer la phase initiale de l’abonnement.
2. Après la migration, ajoutez les phases supplémentaires aux planifications d’abonnements migrés. Pour ce faire, appelez le endpoint de mise à jour ou utilisez le Dashboard Abonnements Stripe.
3. Ajustez la start_date de la migration pour laisser suffisamment de temps entre les changements d’état planifiés et les changements d’état en temps réel. Cela vous permet d’effectuer les mises à jour de phase avant que les abonnements ne soient mis en production.

Spécification CSV complète