CalMate

L'extension CalMate calcule automatiquement la valeur du champ « Paramètre optionnel 2 » (OP2) de l'envoi à partir du montant du paiement à la livraison. Le calcul s'effectue après la création de l'envoi. Il est possible de définir une formule par défaut pour le module complémentaire, ainsi qu’une formule spécifique à chaque client.

Prérequis

• abonnement à l’API Deliveo ;
• un abonnement à l'utilisation des webhooks Deliveo ;
• des droits d'accès pour l'installation, la configuration et l'utilisation de l'extension.

Installation et accès

L'extension peut être installée sur le Portail de gestion, dans le menu « Extensions ». Une fois installée, elle est accessible dans le menu « Extensions / CalMate ». Seuls les utilisateurs disposant des droits d'accès appropriés peuvent installer et utiliser l'extension.

Principe de fonctionnement

Dans la formule, x correspond au montant du paiement à la livraison.

Exemple :

(x * 0.1) + 100

Si le montant du paiement à la livraison est de 1 000, alors :

• x = 1000
• la valeur calculée de OP2 est 200

Opérations mathématiques pouvant être utilisées dans la formule :

• +
• -
• *
• /
• ()

Règles importantes

• Le calcul s'effectue après la création de l'envoi.
• Si le champ OP2 contient déjà une valeur, la valeur supplémentaire la remplace.
• Le résultat du calcul ne peut pas être négatif.
• La longueur du résultat ne doit pas dépasser la longueur maximale du champ OP2.
• En cas de formule erronée, le calcul n'est pas effectué.

Configuration du webhook

Pour que l'extension fonctionne, vous devez créer un webhook.

1. Ouvrez le menu Paramètres / Webhook.
2. Créez un webhook simple.
3. Sélectionnez l'événement « Création d'un envoi » comme événement.
4. Copiez l'URL du webhook affichée sur la page CalMate.
5. Enregistrez le webhook.

L'URL du webhook est unique à chaque installation ; utilisez donc toujours l'adresse affichée sur l'interface de CalMate.

Formule OP2 par défaut

La formule OP2 par défaut s'applique à tous les envois des clients pour lesquels aucune formule spécifique n'a été définie. Pour la configurer :

1. Saisissez la formule dans le champ « Formule OP2 par défaut ».
2. Vérifiez la formule à l'aide du bouton « Tester la formule ».
3. Cliquez sur le bouton « Enregistrer ».

Exemple :

10+(x*2)/10

Formules spécifiques au client

Dans la section « Formules client », vous pouvez définir des calculs différents pour chaque client. Pour cela, deux informations sont nécessaires :

• ID client
• Formule

L'ID client est l'identifiant numérique interne qui apparaît dans la colonne « ID » de la liste « Données de base / Clients » du portail de gestion. Pour ajouter une formule spécifique au client :

1. Recherchez l’ID client dans le menu « Données de base / Clients ».
2. Saisissez l'ID dans le champ « ID client ».
3. Saisissez la formule correspondant au client.
4. Si nécessaire, testez la formule.
5. Cliquez sur le bouton « Ajouter ».

Les formules client existantes peuvent être supprimées à l'aide du bouton « Supprimer » situé à la fin de la ligne.

Ordre d'application des formules

Lors de la création d'un envoi, le système :

1. vérifie si une formule spécifique au client est associée à ce dernier ;
2. si oui, il utilise la formule spécifique au client ;
3. s'il n'y a pas de formule spécifique, il applique la formule par défaut.

Test d'une formule

La formule peut être testée avant la sauvegarde.

1. Dans le champ de test, saisissez la x valeur, c'est-à-dire le montant du paiement à la livraison que vous souhaitez tester.
2. Cliquez sur le bouton « Tester la formule ».
3. Le système exécute la formule.
4. Si le test est réussi, il affiche le résultat calculé.

Le test ne modifie pas l'envoi, il vérifie uniquement le bon fonctionnement de la formule.

Formule erronée

Si la formule saisie n'est pas valide :

• le calcul ne s'exécute pas ;
• le champ de la formule s'affiche brièvement dans un cadre rouge.

Dans ce cas, vérifiez :

• que les parenthèses sont correctement placées ;
• les opérateurs autorisés ;
• si vous n'utilisez que la x variable ;
• s'il n'y a pas de faute de frappe ou d'opérateur manquant.

Exemples

Ajout d'un montant fixe

x+100

Un montant de 100 est ajouté au montant du paiement à la livraison.

Calcul d'une valeur en pourcentage

x*0.1

La valeur de l'OP2 correspond à 10 % du montant du paiement à la livraison.

Pourcentage et montant fixe combinés

(x*0.1)+100

La valeur de l'OP2 correspond à 10 % du montant du paiement à la livraison, plus 100.

Déduction d'un montant fixe

x-100

Le système déduit 100 du montant du paiement à la livraison. Le résultat ne peut pas être négatif.

Erreurs courantes

La valeur de l'OP2 n'est pas mise à jour

Vérifiez :

• si le webhook a bien été créé ;
• si l'événement du webhook est « Création d'un envoi » ;
• si l'URL correcte est indiquée dans le webhook ;
• si un montant de contre-remboursement est associé à l'envoi ;
• si la formule a bien été enregistrée.

Ce n'est pas la formule attendue qui s'exécute

Vérifiez :

• s'il existe une formule spécifique pour ce client ;
• si l'identifiant client saisi est correct ;
• si la formule par défaut souhaitée a bien été enregistrée.

La formule spécifique au client a priorité sur la formule par défaut.

Le résultat est négatif

Le module complémentaire ne peut pas utiliser de valeur OP2 négative. Modifiez la formule de manière à ce que le résultat soit au moins égal à zéro pour tous les montants de paiement à la livraison attendus.

Échec du test de la formule

Vérifiez :

• la syntaxe de la formule ;
• les parenthèses ;
• les opérateurs ;
• l' x utilisation des variables.

L'ancienne valeur de OP2 a disparu

Lors de la création de l'envoi, le module complémentaire remplace la valeur précédente du champ OP2. Cela fait partie du fonctionnement normal.