Comment interpréter les codes d'erreur du tunnel de vente ?
Lorsqu'une transaction aboutit à un statut "Erreur", un tableau d'erreurs est affiché en bas de la fiche du parcours. Il liste les erreurs remontées par Resamania avec leur code, leur message et leurs détails techniques. Cet article vous aide à identifier rapidement la cause d'un blocage et à prendre les mesures correctives adaptées.
Pour accéder aux erreurs : rendez-vous dans Transactions, filtrez par statut "Erreur", puis cliquez sur le parcours concerné. Le tableau "Erreurs associées" se trouve en bas de la fiche.
1. Lire le tableau d'erreurs
Pour chaque erreur enregistrée, le tableau affiche :
- Date : date et heure précises de l'erreur
- Message : description lisible de l'erreur
- Code : code d'erreur Resamania, à utiliser pour identifier la cause ci-dessous
- Détails : données techniques associées (statut HTTP, valeurs attendues)
2. Liste des erreurs courantes
| Code d'erreur | Catégorie | Que faire ? |
|---|---|---|
email: api.error.contact.email-already-used |
Contact | L'adresse e-mail est déjà enregistrée dans un autre club du réseau. Si le transfert de fiche est activé, il se déclenche automatiquement. Sinon, invitez le prospect à se rendre dans son club pour modifier son dossier. |
email: Cette valeur n'est pas une adresse email valide. |
Contact | L'adresse e-mail est refusée par Resamania malgré les contrôles du tunnel de vente. Invitez le prospect à vérifier la saisie. |
birthDate: api.error.generic.less-than |
Contact | La date de naissance indique que le prospect est mineur selon la politique configurée dans Resamania. Vérifiez les conditions d'accès à la formule. |
birthDate: api.error.generic.greater-than |
Contact | La date de naissance dépasse l'âge maximum autorisé dans Resamania. |
api.error.signature-request.code-invalid |
Mandat SEPA | Le code SMS n'a pas été correctement saisi par le prospect. Il peut relancer le processus depuis le début. |
iban: api.error.constraint.iban |
Mandat SEPA | L'IBAN est non conforme ou incomplet. Demandez au prospect de vérifier ses coordonnées bancaires. |
iban: api.error.mandate.iban-not-in-sepa-zone |
Mandat SEPA | L'IBAN n'appartient pas à la zone SEPA autorisée dans Resamania. Le prospect doit utiliser un compte domicilié dans la zone SEPA. |
bic: Cette valeur n'est pas un Code Identifiant de Business (BIC) valide. |
Mandat SEPA | Le code BIC associé à l'IBAN est invalide. Vérifiez que le prospect a bien renseigné ses informations bancaires complètes. |
address: "XXXXX" n'est pas un code postal valide pour le pays FR. |
Adresse | Le code postal est refusé par Resamania malgré la validation par le tunnel de vente et Google Maps. Contactez le support MaSalleDeSport si l'erreur est récurrente sur un même code postal. |
api.error.article.service-invalid-start-date |
Produit | Un produit dans Resamania a une date de démarrage de publication invalide. Corrigez la configuration du produit dans Resamania. |
api.error.article.service-invalid-end-date |
Produit | Un produit dans Resamania a une date de fin de publication invalide. Corrigez la date de fin dans Resamania. |
api.error.article.sale-article-no-stock |
Produit | Le produit n'est plus en stock dans ce club dans Resamania. Le prospect en est informé automatiquement. Mettez à jour le stock disponible dans Resamania. |
api.error.corporation.no-match-found |
Configuration club | Erreur liée au paramétrage du club et du mandat associé dans Resamania. Contactez votre équipe support Resamania. |
corporation: api.error.sale.missing-corporation |
Configuration club | L'entité juridique (corporation) n'est pas configurée dans Resamania. Aucune vente ne peut aboutir sans cette configuration. Contactez votre équipe support Resamania. |
api.error.club.sale-terms.not-found |
Configuration club | Les conditions de paiement et le contrat ne sont pas configurés dans Resamania. La signature du contrat est bloquée. Contactez votre équipe support Resamania. |
Network node IRI cannot be resolved. |
Configuration tunnel | Défaut de configuration du tunnel de vente. Contactez votre équipe support MaSalleDeSport avec l'identifiant du parcours. |
api.error.scope.unauthorized-client-token |
Configuration tunnel | Défaut de configuration du tunnel de vente. Contactez votre équipe support MaSalleDeSport avec l'identifiant du parcours. |
Network node must not be of type "franchise" or "mixed". |
Configuration tunnel | Défaut de configuration du tunnel de vente. Contactez votre équipe support MaSalleDeSport avec l'identifiant du parcours. |