Que faire en cas d’erreur de format d’import paramétrable EBP ?

Exemple problème rencontré

Lors d’un import (clients, commandes, devis, livraisons, factures), Atoo-Sync affiche une erreur provenant d’EBP, par exemple :

MappingLineEntity
Le champ [Champ destination] a une valeur qui n'est pas autorisée

L’import est alors annulé et aucun document n’est créé dans EBP.

Que signifie cette erreur ?

Cette erreur est générée par EBP Gestion Commerciale lors de l’utilisation d’un format d’import paramétrable.

Elle indique que :

• Un champ du format d’import paramétrable
• Contient une valeur non autorisée par EBP
• Ou un mapping devenu invalide (champ supprimé, modifié, mal associé)

 Ce problème n’est pas lié à Atoo-Sync, mais au format d’import paramétrable EBP.

Cause la plus fréquente

Dans la majorité des cas, l’erreur est causée par :

• Un format d’import paramétrable :
  • ancien
  • mal modifié
  • hérité d’un autre test
• Une évolution du fichier (colonne ajoutée ou modifiée)
• Une incompatibilité entre le format et le type de document importé

 La solution recommandée est de recréer le format d’import paramétrable.

Solution recommandée : recréer le format d’import paramétrable

Étape 1 – Supprimer le format existant

Dans EBP Gestion Commerciale :

• Outils
• Imports paramétrables
• Lors du choix du paramétrage :
  • Sélectionner le format concerné
  • Cliquer sur Supprimer

Étape 2 – Récupérer le fichier en échec

Dans le dossier d’échange Atoo-Sync / EBP, récupérer le fichier correspondant à l’import en erreur :

• Clients : Customers.txt
• Adresses : Adresses.txt
• Devis : Quotes.txt
• Commandes : Orders.txt
• Bons de livraison : Delivery.txt
• Factures : Invoices.txt

Étape 3 – Relancer l’import paramétrable EBP

• Outils
• Imports paramétrables
• Sélectionner le type de document correspondant au fichier
• Sélectionner le fichier généré par Atoo-Sync
• Cliquer sur Suivant jusqu’à l’écran de création du paramétrage

Dans notre exemple Orders = commandes ventes

Étape 4 – Nommer correctement le nouveau format d’import

Lors de la création du format, renseigner un nom standardisé, selon le type de document :

• Atoo-Sync Customers (Clients Propects)
• Atoo-Sync Customers Addresses (Adresses client) à mettre dans client / propects
• Atoo-Sync Quotes (Devis)
• Atoo-Sync Orders (commandes)
• Atoo-Sync Delivery Notes (Bons de livraison)
• Atoo-Sync Invoices (Factures)

 Note importante : Il est nécessaire de respecter ces associations et les noms des formats d'imports paramétrable, sans cela la liaison Atoo-Sync - EBP ne sera pas correcte et génèrera des erreurs.

Étape 5 – Finaliser l’import

• Vérifier les associations de champs
• Enregistrer le format (nom du format)
• Lancer l’import

L’import doit désormais s’exécuter sans erreur.

Points importants à retenir

• L’erreur MappingLineEntity – valeur non autorisée est une erreur EBP
• Elle est généralement liée au format d’import paramétrable
• Supprimer et recréer le format résout le problème dans la majorité des cas
• Le fichier généré par Atoo-Sync est un bon point de départ pour recréer le format
• La documentation pour effectuer / mettre à jour le paramétrage des imports paramétrable EBP se trouve à cette adresse : https://docs.atoo-next.net/faq-ebp-126.html#faq-2665