Un exemple chiffré montrant comment dates de début, changements de plan et de tarif, prorata, frais d'inscription et équipement deviennent des lignes de facture immuables.
Ce guide présente un cycle de facturation complet avec des chiffres réels. Il explique les dates de début d'adhésion, les changements de plan, les lignes de facture au prorata, les frais d'inscription et l'équipement. Pour la configuration et l'encaissement SEPA (identifiant créancier, mandats IBAN, modes de rapprochement et exports pain.008), consultez Prélèvement SEPA.
En production, la facturation mensuelle automatique s'exécute le 1er de chaque mois à 06:00 UTC. Cet exemple utilise une date d'exécution manuelle pour faciliter le calcul.
Anna s'inscrit elle-même le 14 avril et choisit le plan IBAN Amateur. Le 22 avril, elle passe au plan Unlimited :
| Amateur | Unlimited | |
|---|---|---|
| Cotisation mensuelle | 49,00 EUR | 69,00 EUR |
| Frais d'inscription | 49,00 EUR | 69,00 EUR |
Elle commande aussi un Kimono à 88,00 EUR, livré le 30 avril. Le 12 mai, l'admin du branch clique sur Run Monthly & Yearly Invoice.
La date à laquelle l'athlète reçoit réellement un plan détermine le début de la facturation :
| Parcours de l'athlète | Début d'adhésion utilisé pour la facturation |
|---|---|
| Athlète importé avec un plan déjà attribué dans l'import en attente | La date de migration configurée par le branch |
| Athlète importé sans plan attribué qui s'abonne plus tard | La date réelle de souscription au plan |
| Nouvel adulte ou enfant inscrit en libre-service | La date réelle de souscription au plan |
| Activation retardée par la validation des frais d'inscription | La date initiale de souscription est conservée |
| Trial | La date réelle d'inscription ou d'activation |
Anna a choisi son premier plan le 14 avril : c'est donc sa date de début. Avril compte 30 jours et seuls les jours à partir du 14 peuvent être facturés.
Les sélections de plan sont enregistrées dans un historique daté. Le jour du changement appartient entièrement au nouveau plan ; l'ancien plan se termine la veille. Une facture manuelle contient donc une ligne récurrente pour chaque segment de plan/tarif :
| Ligne récurrente | Jours couverts | Calcul | Montant |
|---|---|---|---|
| Amateur | 14–21 avril (8 jours) | 49,00 × 8 / 30 | 13,07 EUR |
| Unlimited | 22–30 avril (9 jours) | 69,00 × 9 / 30 | 20,70 EUR |
| Total récurrent d'avril | 33,77 EUR |
Les plans mensuels utilisent le nombre de jours calendaires couverts divisé par le nombre de jours du mois. Les plans annuels utilisent les jours couverts divisés par 365, ou 366 pour une année bissextile. Chaque ligne affichée est d'abord arrondie aux centimes, puis les lignes arrondies sont additionnées.
Si plusieurs changements sont enregistrés le même jour, ils restent visibles dans l'historique, mais seule la dernière sélection reçoit la facturation de ce jour. Les règles existantes de pause et de résiliation déterminent toujours les jours facturables.
Pendant une période d’adhésion ininterrompue, les frais d'inscription sont définitivement liés au premier plan payant hors Trial de l'athlète. Anna a d'abord choisi Amateur : ses frais sont donc de 49,00 EUR. Le passage à Unlimited ne les remplace pas par ceux du plan Unlimited.
Amateur, 14–21 avril : 13,07 EUR
Unlimited, 22–30 avril : +20,70 EUR
Frais du premier plan : +49,00 EUR
─────────
Total facture avril : 82,77 EUR
Cette base est également verrouillée lorsqu'un plan payant est attribué dans un import en attente. Un Trial ne verrouille pas de frais de plan payant : le premier plan payant choisi ensuite le fait. Si la validation des frais retarde l'activation, le montant enregistré et la date initiale de souscription sont conservés.
Par exemple, si un ancien membre reprend Unlimited le 30 juillet, juillet comprend 4,45 EUR pour les 30–31 juillet plus 69,00 EUR de frais pour la nouvelle période (73,45 EUR au total). Août coûte ensuite 69,00 EUR.
Modifier le prix d'un plan crée une nouvelle version du tarif au lieu de réécrire l'historique :
Si un changement actuel ou futur tombe dans une période manuelle déjà facturée, CompTeam enregistre un avoir immuable pour l'ancien plan et une facturation de remplacement pour le nouveau plan. Les deux sont reportés sur la prochaine facture manuelle ; tout avoir qui rendrait cette facture négative est reporté à une facture ultérieure.
Adhésion Reduced d'octobre : 55,00 EUR
Avoir Amateur du 15 au 30 sept. : -36,80 EUR
Reduced du 15 au 30 sept. : +29,33 EUR
─────────
Total facture octobre : 47,53 EUR
Cet exemple suppose que septembre avait déjà été facturé à 69,00 EUR avant un passage, le 15 septembre, au plan Reduced à 55,00 EUR. Les adhésions Stripe n'utilisent pas ces ajustements CompTeam, car Stripe reste la source de référence pour leurs proratas.
Le Kimono d'Anna (88,00 EUR) a été livré le 30 avril, mais la facturation s'exécute le 12 mai. L'équipement est rattaché à la facture du mois en cours de l'exécution, quelle que soit sa date de livraison.
Adhésion Unlimited, mai : 69,00 EUR
Kimono (équipement) : +88,00 EUR
─────────
Total facture mai : 157,00 EUR
Une exécution le 12 mai génère deux factures pour Anna — une par mois en attente, avec des lignes immuables et sa propre échéance :
| Facture | Composition | Montant |
|---|---|---|
| Avril | Amateur (8/30 jours) + Unlimited (9/30 jours) + frais du premier plan | 82,77 EUR |
| Mai | Unlimited (mois complet) + Kimono | 157,00 EUR |
| Total | 239,77 EUR |
À retenir :
Après l'export et l'encaissement des factures manuelles par prélèvement SEPA, rapprochez-les comme décrit dans Prélèvement SEPA.