Contexte
L’objectif de ProAbono est d’externaliser toute la logique de facturation, pour délester les développeurs de cette complexité.
Les caractéristiques de type consommation permettre de facturer des usages ponctuels agrégés en fin de période. Ex : nombre de SMS consommé sur un mois.
La gestion de la période est programmée dans ProAbono et la valorisation et la remise à zéro de la consommation est pilotée par ProAbono. C’est une opération qui peut se déclencher dans différents cas.
- Automatiquement au renouvellement de l’abonnement
- Automatiquement à la facturation programmée du client
- Par API
- Lors d’une opération de résiliation
- Lors d’une opération de changement d’offre
Manière de procéder
Tous les cas listés plus haut n’ont pas besoin d’être gérés lors de l’installation de ProAbono. En revanche, vous devez utiliser l’une des 4 manières recommandées pour transmettre les consommations :
- En temps réel
- File d’attente
- Quotidiennement
- Mensuellement
1) Transmission en temps-réel
Concept
Votre serveur envoie une requête d’incrément à chaque consommation.
Consulter l’article Mettre à jour les usages ou La documentation technique pour en savoir plus sur la transmission des usages.
Avantages
- Le portail client reflète la consommation en temps-réel, le client peut avoir un suivi précis de sa consommation
Inconvénients
- S’il y a beaucoup de consommations, le nombre de requêtes peut être élevé.
- Le système ne permet pas les appels concurrents (modifications simultanées du même abonnement)
2) Transmission par file d’attente
Concept
Votre serveur enregistre les consommations dans une file d’attente interne et envoie des requêtes d’incrément par lot.
La documentation technique est ici.
Avantages
- Le portail client reflète la consommation en quasi-temps-réel, le client peut avoir un suivi précis de sa consommation.
- Il est possible de pousser, dans la même requête, des consommations consécutives sur le même abonnement.
Inconvénients
- Plus délicat à mettre en place techniquement.
3) Transmission quotidienne
Concept
Votre serveur envoie des requêtes d’incrément quotidien. Idéalement par lot.
La documentation technique est ici.
Avantages
- Peu de requêtes.
- Le processus est plus facile à monitorer et à relancer si des problèmes se sont produits.
Inconvénients
- Le portail client reflète l’état de la consommation de la veille.
- Une facturation au jour J ne prend pas en compte la consommation du jour J, cette consommation sera comptabilisée dans la facturation suivante.
4) Transmission mensuelle
Concept
Votre serveur envoie des requêtes d’incrément de la valeur de la consommation mensuelle. Idéalement par lot.
La documentation technique est ici.
Avantages
- Peu de requêtes.
- Vous avez la maîtrise (et la responsabilité) complète sur la consommation.
Inconvénients
- Le portail client ne reflète pas l’état de la consommation.
Note sur la transmission d’usages par lot
La transmission par lot présente l’avantage de réduire les temps de traitement et le nombre de requêtes envoyées à ProAbono.
Elle gère automatiquement l’ordonnancement si plusieurs usages sont envoyés pour la même caractéristique du même abonnement.
En revanche, l’envoi d’un lot échoue si un seul des abonnements est interrompu. Pour éviter ce problème, il est recommandé de faire une vérification des usages avant d’autoriser un client à consommer (ce qui est une bonne pratique de manière générale).