Transmission des consommations à ProAbono

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 :

1. En temps réel
2. File d’attente
3. Quotidiennement
4. 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

1. Le portail client reflète la consommation en temps-réel, le client peut avoir un suivi précis de sa consommation

Inconvénients

1. S’il y a beaucoup de consommations, le nombre de requêtes peut être élevé.
2. 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.

Note

Notez qu’il est recommandé de limiter chaque requête à 50 usages.

Avantages

1. Le portail client reflète la consommation en quasi-temps-réel, le client peut avoir un suivi précis de sa consommation.
2. Il est possible de pousser, dans la même requête, des consommations consécutives sur le même abonnement.

Inconvénients

1. 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.

Note

Notez qu’il est recommandé de limiter chaque requête à 50 usages.

Avantages

1. Peu de requêtes.
2. Le processus est plus facile à monitorer et à relancer si des problèmes se sont produits.

Inconvénients

1. Le portail client reflète l’état de la consommation de la veille.
2. 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.

Note

Notez qu’il est recommandé de limiter chaque requête à 50 usages.

Avantages

1. Peu de requêtes.
2. Vous avez la maîtrise (et la responsabilité) complète sur la consommation.

Inconvénients

1. Le portail client ne reflète pas l’état de la consommation.

Note

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).