Plafonnement monétaire

Prérequis

• Activez les gestionnaires de déclencheur de plafond monétaire.
• Pour afficher toutes les capitalisations monétaires actives associées au compte d'un participant, ajoutez le composant Générateur d'applications Lightning Utilization Tracker à la page d'enregistrement Compte.

Fonctionnement du plafond monétaire

Le plafond monétaire calcule les montants des dépenses pour trois compartiments de dépenses :

• Dépenses estimées : Le montant d'argent qui devrait être dépensé pour une ou plusieurs activités.
• Dépenses engagées : Le montant approuvé pour une ou plusieurs activités.
• Dépenses réelles : Le montant déjà dépensé pour une ou plusieurs activités.

Pendant un événement en cours, le système prend la plus élevée des dépenses réelles par rapport à la somme des dépenses estimées et engagées comme total en cours. Une fois l'événement fermé, le système prend en compte uniquement les dépenses réelles.

Chaque compte de participant a une limite en dépenses définie dans un enregistrement Limite en objectifs d'activité de prestataire. Lorsqu'un participant est ajouté à un événement, ou qu'une dépense est créée, mise à jour ou supprimée, le système recalcule automatiquement le total du plafond et le compare à cette limite. Seules les dépenses dont le type est marqué Inclus dans le plafond sont prises en compte dans la limite.

Lorsqu'une limite est enfreinte, le système répond de l'une des deux façons suivantes, selon la configuration du plafond :

• Erreur : L'action est bloquée, avec un message d'erreur, empêchant l'ajout du participant ou l'enregistrement de la dépense.
• Avertir : L'action est autorisée, mais un enregistrement Écart du participant à l'événement géré est créé avec un message d'avertissement.

Calcul de la dépense totale

Les dépenses totales sont calculées en fonction du statut de l'événement géré.

Si l'événement géré est terminé, c'est-à-dire que le statut représente un état conclu, le total des dépenses est égal aux dépenses réelles.

Total = Réel

Si l'événement géré n'est pas terminé, c'est-à-dire que le statut représente un état brouillon, les dépenses totales correspondent au maximum des dépenses réelles et estimées plus les dépenses engagées.

Total = MAX(Réel, Estimé + Engagé)

Les données de plafond sont stockées dans le champ d'informations supplémentaires de la mesure d'objectif d'activité du prestataire sous le format JSON et sont cumulées dans les champs Montant des dépenses engagées, Montant des dépenses réelles, Montant des dépenses estimé et Montant total des dépenses.

Le code suivant est un exemple de plafond monétaire.

{"1POXJOO0000002L4AU":{"isFinalValue":true,"isFinal":true,"estimatedMap":
{},"estimated":{},"committedMap":{},"committed": {},"actualMap":
{"1Z6XJ0000000iAjOAI":{"rate": 1.0,"amount":200.0},"1Z6XJ00000001970AA":
{"rate":1.0,"amount": 100.0}},"actual":{"1Z6XJ0000000iAjOAI":
{"rate": 1.0,"amount":200.0},"1Z6XJ00000001970AA":
{"rate": 1.0, "amount":100.077}}}}

Le plafond est calculé uniquement lorsque l'événement géré est à l'état final, c'est-à-dire fermé ou conclu. Le statut final est déterminé en fonction du champ Statut de l'événement conclu dans les paramètres de l'organisation de gestion des événements. Les taux de conversion sont automatiquement mis à jour en fonction de la devise.

Gestionnaires de déclencheur

• ExpenseParticipantMonetaryCapsHandler
  • Lorsque des participants aux dépenses sont créés, le gestionnaire recalcule le total des dépenses. Le gestionnaire empêche la création de participants aux dépenses si le plafond monétaire est défini avec Type d'alerte défini sur Erreur et si le nouveau total dépasse la limite monétaire. Si le Type d'alerte est défini sur Avertir, même si la limite monétaire est dépassée, le gestionnaire autorise la création d'un participant aux dépenses, mais avec un avertissement. Seuls les participants dont le type de dépense est marqué Inclus dans le plafond sont pris en compte.
  • Lorsque le montant d'un participant aux dépenses est mis à jour, le gestionnaire recalcule les totaux de plafond en fonction du nouveau montant. Si le Type d'alerte du plafond monétaire est défini sur Erreur, le gestionnaire bloque les augmentations de montant qui entraînent un dépassement du plafond. Si le Type d'alerte est défini sur Avertir, même si la limite monétaire est dépassée, le gestionnaire autorise l'augmentation du montant. Les diminutions sont toujours autorisées sans restriction — même si le total actuel dépasse déjà le plafond — car elles réduisent l'utilisation. Les modifications apportées à un champ autre que le montant ne déclenchent aucun recalcul.
  • Lorsqu'un participant aux dépenses est supprimé, le gestionnaire recalcule les totaux de plafond pour retirer le montant supprimé. Les suppressions sont toujours autorisées, car le retrait d'un participant réduit toujours le total du plafond.
• MngEventPartMonetaryCapsHandler
  • Lorsqu'un nouveau participant est ajouté à un événement, le gestionnaire vérifie si le plafond de dépenses de ce prestataire est déjà atteint. Si le plafond monétaire est configuré avec Type d'alerte défini sur Erreur, le gestionnaire limite l'ajout. Si le plafond monétaire est configuré avec Type d'alerte défini sur Avertir, le gestionnaire l'autorise, mais avec un avertissement.
  • Lorsque le compte du participant est modifié (compte à compte, compte à expert ou expert à compte), le gestionnaire recalcule les plafonds pour l'ancien et le nouveau participant. Si un compte est échangé avec un utilisateur, le plafond monétaire est réduit uniquement pour le compte. L'échange entre des types autres que le compte (utilisateur, contact) est sans effet.
• MngEventMonetaryCapsHandler
  • Si le statut de l'événement géré est mis à jour, le gestionnaire de déclencheur recalcule la limite en plafond monétaire pour tous les participants. Si le statut n'est pas l'un des statuts qualifiants (brouillon ou fermé), le gestionnaire retire l'entrée de dépense et l'événement n'est plus suivi.
  • Si la date de début de l'événement géré est mise à jour hors de la période du plan d'activité associé, le gestionnaire retire l'entrée de dépense. Si les dates de l'événement sont comprises dans la période du plan d'activité, le gestionnaire recalcule la dépense en fonction de la nouvelle période.
  • Si l'événement géré est supprimé, le gestionnaire retire toutes les contributions associées de la limite en plafonds monétaires.
• ExpenseMonetaryCapsHandler
  • Si la date de dépense est mise à jour, le gestionnaire recalcule les totaux de plafond en fonction de la nouvelle date. Si la nouvelle date dépasse une période configurée, la dépense n'est plus prise en compte dans le plafond.
  • Si l'un des champs de contrôle définis dans le JSON Critères de ProviderActivityMeasureType est mis à jour, mais remplit toujours les critères, le gestionnaire recalcule le plafond. Si l'un des champs de contrôle définis dans le JSON Critères de ProviderActivityMeasureType est mis à jour, mais ne remplit pas les critères, le gestionnaire retire la contribution du total du plafond.
  • Si une dépense marquée Inclus dans le plafond est supprimée, le gestionnaire recalcule la dépense et retire l'entrée de la dépense. Seules les dépenses dont le type est marqué Inclus dans le plafond sont prises en compte.

Tâches par lot

• Calcul des dépenses par rapport aux plafonds monétaires : Lorsque les données sont chargées en masse, les gestionnaires de déclencheur sont cette tâche par lot qui recalcule les dépenses en fonction des toutes dernières données du compte.
• Partage des objectifs d'activité des prestataires en fonction du type de plan d'activité : Partage les objectifs d'activité des prestataires associés à des plans d'activité de type Limite de gestion des événements avec les territoires alignés sur un compte. Pour les objectifs associés à d'autres types de plan d'activité, la tâche partage les objectifs conformément au paramètre de partage du plan d'activité.

Synchronisation mobile hors ligne

Monétique Caps gère les infractions de plafond monétaire hors ligne sur le mobile différemment que sur le Web.

Sur le Web, lorsque le commercial tente d'ajouter un participant qui a dépassé les limites en plafonds monétaires ou qui est en limite, le système bloque l'action.

Sur un appareil mobile, lorsque le commercial tente la même action hors ligne, le système ne bloque pas l'action. Le participant est ajouté à l'autre événement avec succès, mais un enregistrement Écart du participant à l'événement géré associé est créé. Lorsque le mobile est synchronisé avec le Web, les données sont partagées avec le système principal.