FAQ - EBP
Comment Configurer les imports paramétrables EBP/Atoo-Sync
FAQ – Création et mise à jour des imports paramétrables EBP avec Atoo-Sync
1. Contexte et principe général
Sans le SDK EBP, l’import des commandes eCommerce dans EBP Gestion Commerciale se fait de manière manuelle, via les imports paramétrables proposés nativement par EBP.

Atoo-Sync permet d’automatiser une partie du processus, mais EBP reste maître de l’import des données.
C’est pourquoi des paramétrages dans EBP sont obligatoires et nécessitent une intervention humaine lors de la mise en place initiale.
2. Rôle du SDK EBP
Le SDK EBP est un composant EBP permettant l’échange de données entre EBP et des applications tierces.
- Atoo-Sync peut se connecter au SDK EBP
- Cette connexion permet à Atoo-Sync de :
- Déclencher les imports
- Alimenter EBP avec les fichiers nécessaires
- Mettre à jour certaines informations après import
Configuration du SDK dans Atoo-Sync
Dans Atoo-Sync :
- Configurer le profil
- Onglet Gestion Commerciale
- Renseigner le chemin du SDK EBP
- Le chemin dépend de la version d’EBP installée
- Il peut varier selon l’environnement (poste, serveur, version EBP)

3. Fonctionnement asynchrone des imports EBP
EBP fonctionne de manière asynchrone pour les imports.
Cela signifie que plusieurs imports successifs sont nécessaires pour importer une commande complète.
Le principe est le suivant :
- Import du client (si le client n’existe pas)
- Import de la commande et des adresses associées
- Mise à jour des informations Web (statut transféré, état de la commande, etc.)
Les étapes 1. et 2. correspond à des formats d’import paramétrable distinct dans EBP.
4. Fichiers générés par Atoo-Sync
Selon le paramétrage Atoo-Sync, plusieurs fichiers sont générés dans le dossier d’échange EBP :
- Fichier clients
- Fichier commandes / documents commerciaux
- Exemple :
Orders.txt, Quotes.txt, Delivery.txt ou Invoice.txt
- Le type de fichier est généré en fonction du Type de document paramétré dans Atoo-Sync dans Configurer le profil >Import des commandes> Import des commandes qui ont le statut

Ces fichiers sont générés par atoo-sync à un emplacement définit dans le paramétrage Atoo-Sync puis utilisés par EBP lors des imports paramétrables.

5. Accès aux imports paramétrables dans EBP
Depuis EBP Gestion Commerciale :
- Menu burger
- Imports | Exports
- Imports paramétrables

6. Import des clients
Étape 0 – Lancer l'import des commandes 1 première fois
- Dans Atoo-Sync GesCom, Lancez une première fois l'import de commande afin de récupérer un ou plusieurs clients (non existants dans votre base EBP), Un fichier Customers.txt sera généré et utilisé dans les étapes suivantes.

Étape 1 – Lancer l’assistant d’import
- Outils > Imports paramétrables
- L’assistant d’importation paramétrable de données s’ouvre
- Cliquer sur Suivant (ou lancer une sauvegarde si proposé)
Étape 2 – Destination et source de l’import
- Sélectionner : Clients / Prospects
- Dans Fichier à importer
- Cliquer sur
...
- Sélectionner le fichier
Customers.txt
- Ce fichier se trouve dans le dossier défini dans :
- Profil Atoo-Sync > Gestion Commerciale > Emplacement du dossier de sauvegarde des fichiers Clients et Commandes


Étape 3 – Chargement des paramètres
- Dans la liste déroulante :
- Sélectionner le paramétrage Atoo-Sync Customers
- Cliquer sur Suivant

Si le champ Nom du paramétrage est vide, il est donc nécessaire de le créer, indiquez juste le nom du fichier Customers.txt en le recherchant et en le sélectionnant, laissez le champ nom du paramétrage Vide.
Puis faites Suivant
Étape 4 – Codage et lecture du fichier
- Type : Délimités (champs séparés par des caractères)
- Séparateur :
- Vérifier l’aperçu des données
- Cliquer sur Suivant

Étape 5 – Associations des champs
- EBP affiche l’association entre :
- Champs source (fichier Atoo-Sync)
- Champs destination (EBP)
- Vérifier les correspondances
- Cliquer sur Suivant

Si le champ est vide et que c'est un nouveau format d'import paramétrable, indiquez le nom du format client : Atoo-Sync Customers

Puis suivant pour valider ce nouveau format d'import paramétrable dédié aux clients
Étape 6 – Lancement de l’import
- Toutes les données nécessaires ont été collectées
- Cliquer sur Lancer

Étape 7 – Fin de l’opération
- Message : Opération terminée avec succès (EBP récapitule)
- Un résumé indique :
- Nombre d’enregistrements importés
- Créés / mis à jour / non importés

7. Import des commandes de la boutique
L’import des commandes suit exactement le même principe.
Type de document importé
Selon le paramétrage Atoo-Sync, il est possible d’importer :
- Devis (Quotes)
- Commandes (Orders)
- Bons de livraison (Delivery)
- Factures (Invoice)
Tout dépend du paramétrage dans configurer le profil > Import des commande > type de document en fonction des statuts des commandes
Exemple ci-dessous avec des Commandes (Vente).
Étape (0) préalable : import des commandes avec Atoo-Sync
- Lancez le second import, (après avoir traité le fichier client)
- Récupérez le fichier notez son emplacement.
- Ouvrez, accéder à à votre EBP
Étapes principales
- Relancer :
- Outils > Imports paramétrables
- Sélectionner :

- Choisir le fichier :
- Sélectionner le paramétrage :

Si le paramétrage Atoo-Sync Orders n'existe pas sélectionnez uniquement le fichier orders puis suivant
- Vérifier :
- Codage du fichier
- Séparateurs (point-virgule)
- Aperçu des données
- Contrôler les associations des champs,
- A Cette étape si le format n'existait pas Dans le champ Nom du paramétrage, Tapez Atoo-Sync Orders

- Cliquer sur Lancer
- Si le format d'import paramétrable n'existait pas il sera présent dans la liste, de plus les données du fichier commande (orders.txt) auront été traité, les commandes seront présentes dans la liste des documents EBP.
Fin de l’import
- Message : Opération terminée avec succès
- Le résumé confirme :
- Le nombre de documents créés
- L’absence ou non d’erreurs
8. Import du fichier Adresses.txt (mise à jour des adresses clients)
8.1. Activation côté Atoo-Sync
Le fichier Adresses.txt est généré automatiquement par Atoo-Sync uniquement si la mise à jour des adresses est activée.
Dans Atoo-Sync :
- Profil > Clients > Options
- Activer :
- Mettre à jour les adresses de livraison
- Mettre à jour les adresses de facturation

Lorsque ces options sont cochées :
- Lors de l’import des commandes
- Atoo-Sync génère un fichier :
- Le fichier est placé dans le même dossier que :
8.2. Rôle du fichier Adresses.txt
Le fichier Adresses.txt permet :
- De mettre à jour les adresses clients existantes dans EBP
- De synchroniser :
- Les adresses de facturation
- Les adresses de livraison
- D’assurer la cohérence entre la boutique et EBP
Important :
- Le fichier ne crée pas les clients
- Il s’appuie sur les clients déjà importés via
Customers.txt
L’import des adresses doit donc être effectué après l’import des clients.
8.3. Ordre des imports à respecter
Lorsque la mise à jour des adresses est activée, l’ordre des imports est le suivant :
-
- Import des clients (
Customers.txt)
- Import des adresses clients (
Adresses.txt)
- Import des commandes (
Orders.txt, Quotes.txt, etc.)
8.4. Import du fichier Adresses.txt dans EBP (principe)
L’import du fichier Adresses.txt se fait via les imports paramétrables EBP, sur le même modèle que les imports Clients et Commandes.
Dans EBP Gestion Commerciale :
- Outils > Imports paramétrables
- Type d’import :
- Adresses clients / prospects
- Fichier à importer :
Lors du premier import :
- Créer un nouveau format d’import
- Nom nécessaire :
- Atoo-Sync Customers Addresses
- Ce nom est à renseigner à l'étape association des champs

Lors des imports suivants :
- Réutiliser le paramétrage existant
Les étapes de codage, de séparation des champs et d’association sont identiques aux imports Clients, se font automatiquement.
8.5. Points clés à retenir
Adresses.txt n’est généré que si l’option de mise à jour des adresses est activée
- L’import des adresses est indépendant des clients mais dépend de leur existence
- Le paramétrage d’import est à créer une seule fois
- L’ordre des imports doit toujours être respecté
9. Points importants à retenir
- Les imports paramétrables doivent être créés une première fois manuellement (effectué lors du 1er paramétrage)
- Une fois les formats créés :
- Ils sont réutilisés automatiquement par Atoo-Sync
- Plusieurs imports sont nécessaires pour une commande complète
- Les fichiers ne doivent pas être modifiés manuellement, sous risque de créer des erreurs, et conflits dans EBP.
- Toute modification de structure nécessite :
- Une mise à jour des formats d’import EBP
- Une vérification avec le support Atoo-Sync
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
EBP : Comment créer les champs personnalisés pour les articles à regroupement
Objectif
Lors de la configuration des regroupements d’articles (déclinaisons / variations) dans Atoo-Sync, il est nécessaire de disposer de champs personnalisés dans EBP.
Ces champs permettront à Atoo-Sync de regrouper les produits similaires sous une même référence maître, afin de créer des articles déclinés sur la boutique e-Commerce (PrestaShop, WooCommerce, Shopify…).
Principe du regroupement
Pour chaque gamme de regroupement, il faut créer 2 champs personnalisés :
| Type de champ |
Description |
Exemple |
| Nom de la gamme |
Nom de l’attribut côté CMS (nom de la variation) |
Couleur, Taille |
| Valeur de la gamme |
Valeur de cet attribut |
Rouge, Bleu, M, L |
> Vous pouvez créer jusqu’à 5 gammes de regroupement (Gamme 1 à Gamme 5).
> Tous les articles partageant la même référence maître seront fusionnés en un seul produit décliné sur le site.
Schéma explicatif
-
Référence maître
: représente la boîte principale (le produit parent).
-
Nom de gamme
: les compartiments de la boîte (ex. : Couleur, Taille).
-
Valeur de gamme
: les éléments contenus dans ces compartiments (ex. : Rouge, Bleu, M, L).
Tous les articles associés à la même référence maître seront regroupés en un seul article décliné sur le site web.
Étapes de création dans EBP
Préparation
Avant de commencer, déconnectez tous les utilisateurs de EBP.
Sinon, un message EBP indiquera que des utilisateurs sont connectés et bloquera la création des champs libres.
Accéder aux paramètres des articles
Dans le menu Burger :





Créer les champs personnalisés
Dans l’onglet Champs personnalisés, créez les champs nécessaires :
-
Référence Maître
-
Nom Gamme 1 à 5
-
Valeur Gamme 1 à 5

Recommandations :
-
Le type du champ doit être Texte.
-
Après la saisie de chaque champ, cliquez sur Enregistrer,
et non pas sur OK, pour valider la création.
Exemple d’utilisation dans EBP
Une fois les champs créés, vous pouvez les renseigner dans vos fiches articles :
| Référence |
Référence Maître |
Gamme 1 |
Valeur 1 |
Gamme 2 |
Valeur 2 |
| .HETESTRGP1 |
.HETESTRGPMTR |
Conditionnement |
5 ml |
Qualité |
Bio |
| .HETESTRGP2 |
.HETESTRGPMTR |
Conditionnement |
10 ml |
Qualité |
Bio |

Configuration dans Atoo-Sync
Retournez dans Atoo-Sync :
Sélectionnez les champs créés dans EBP :
Répétez l’opération pour chaque niveau de gamme que vous souhaitez synchroniser.
Conseils utiles
-
Vous n’êtes pas obligé de créer les 5 gammes. Créez uniquement celles nécessaires à vos produits.
-
La référence maître doit être identique pour tous les articles à regrouper.
-
Vérifiez que vos champs sont correctement renseignés avant de lancer la synchronisation.
- Si les attributs existent déjà sur votre boutique avant l’export des articles, veillez à copier/coller les noms exacts de ces attributs dans les champs “Nom de gamme” correspondants dans EBP.
Les noms des gammes dans EBP et des attributs sur le site e-commerce doivent être strictement identiques pour que le regroupement fonctionne correctement.
- Pour garantir la même description pour chaque déclinaison / variation, consultez cette autre documentation : https://docs.atoo-next.net/faq-atoo-sync-gescom-31.html?search=libell%C3%A9#faq-2556
Comment envoyer le nom de la société de EBP vers le site web ?
Objectif
Lors de la synchronisation des clients professionnels entre EBP et le site e-commerce, il est important que le nom de la société soit correctement transmis.
En effet, le site web différencie les noms et prénoms du client du nom de l’entreprise.
Principe
Pour que le nom de la société soit bien envoyé dans le champ "Entreprise" (ou "Société") du CMS, il est nécessaire d’ajuster un paramètre dans la fiche client EBP.
Procédure
-
Ouvrez la fiche client dans EBP.
-
Si le client est une entreprise (et non un particulier), décochez la case « Personne physique ».
-
Renseignez le nom de la société dans le champ Nom.

Résultat
Si la case « Personne physique » est cochée, alors le champ société ne sera pas renseignée, et dans les informations xml envoyées au site e-Commerce, la balise <company> ne contiendra aucune valeur.

En décochant Personne physique :
Remarques utiles
-
Si la case Personne physique reste cochée, le nom sera interprété comme un nom de personne et ne sera pas transmis dans le champ Société côté site.
-
Cette distinction permet de différencier clairement les clients particuliers des professionnels lors de la synchronisation.
J’ai un logiciel EBP est-ce que cela va fonctionner ?
Oui. Depuis 2014, Atoo-Sync GesCom est compatible avec le logiciel EBP Gestion Commerciale OpenLine.
Pour l’import des commandes dans EBP par Atoo-Sync, il est soit :
- manuel : depuis EBP, Outils/ Import Paramétrable
- direct : pour les clients EBP ayant souscrit à un contrat Privilège. Alors Atoo-Sync utilisera le SDK EBP pour créer directement dans EBP les clients et les commandes.
Export Factures PDF EBP : erreur InvoiceDocumentXML is nothing
Explication :
Lors du lancement de l'export des factures PDF, EBP prend quelques secondes ou plus à générer les factures PDF à expédier.
Atoo-Sync possède un temps d'attente (time out) de 20 secondes par défaut. Si ce délais est dépassée une erreur apparait :
02/04/2025 12:57:06 - Envoyer les factures en PDF
02/04/2025 12:57:06 - -> 1/1 - Facture numéro : FA1110157
02/04/2025 12:57:36 - -> Error InvoiceDocumentXML is nothing
Solution :
Rendez-vous dans Configurer le profil > Options Avancées > Section EBP > Create PDF time out > passez la valeur a 200.

Attention : Les Options avancées sont à manipuler avec délicatesse. Si vous ne connaissez pas les effets que possèdent chaque option, nous vous déconseillons de modifier les valeurs.
Import EBP Erreur élément racine manquant.
Explication :
Dans la connexion Atoo-Sync avec EBP, il est possible d'obtenir dans certains cas une erreur : Élément racine manquant.
Cette erreur bloque l'import des commandes vers EBP.

Solution :
Pour trouver l'origine du problème il faut analyser les données clients importées.
En commençant par analyser coté WEB, sur la ou les commandes bloquantes.
Exemple avec une adresse :

Contrôlez les adresses de livraison et de facturation.
Retirez les caractère qui se présentent sous forme de points d'interrogation ou autres paraissant inhabituels.
Origine du problème :
Le client a très certainement effectué un copié collé, copiant au passage des caractères spéciaux non géré par EBP.
Ces caractères spéciaux s'affichent mal dans Prestashop, on les repère souvent avec cet étrange caractère
.
Enfin après correction tentez à nouveau d'importer les commandes, si l'erreur persiste il est possible que d'autres champs ou d'autres commandes ont le même problème.
Mes commandes ne remontent plus après une Mise à jour EBP
Explications :
Vous avez effectué une mise à jour de votre EBP mais Atoo-Sync indique que les commandes sont importées avec succès, alors qu'elles ne remontent pas dans EBP.
Cela est dû au fait qu'à chaque Maj. EBP, un nouveau dossier du SDK (permettant le transfert) est recréé.
Or Atoo-Sync ne se met pas à jour automatiquement sur ce paramètre : il vous faut mettre à jour manuellement le nouveau chemin du SDK.

Solution :
Rendez-vous dans Atoo-Sync et cliquez sur Configurer le profil

Puis allez dans la section gestion commerciale

Au niveau de Application EBP Gestion commerciale, veillez à ce que la case Utiliser le SDK pour importer les clients et les commandes soit bien cochée.
Puis ouvrez le navigateur via le bouton "..." .
Par défaut, il doit pointer sur l'ancien SDK --->utilisez l'icone pour remonter au dossier parent
.
Sélectionnez le dossier de la nouvelle version (ici dans notre exemple 22.2).

Double-cliquez sur ce nouveau dossier, vous y trouverez le nouveau SDK.
Ce dernier se nomme EBP.Invoicing.Application

Validez (sans oublier d'appliquer avant de fermer la fenêtre de configuration) et enfin testez l'import des commandes.


Comprendre les erreurs d'imports des commandes vers EBP
Contexte :
Vous rencontrez un problème pour importer vos commandes vers EBP, Atoo-Sync indique que l'import s'est effectué avec succès. Mais aucune nouvelle commande n'apparaît dans EBP.
A faire et à Vérifier :
Contrôlez la présence dans le dossier des fichiers de commandes suivants :
- quote (pour les documents devis) ou:
- order (pour les documents commandes) ou:
- delivery (pour les documents bons de commandes) ou:
- invoice (pour les documents factures).
Afin de contrôler la bonne création des commandes à importer dans EBP, vérifiez le chemin de création de ces fichiers.

- Copiez le chemin du dossier :

- Et collez dans l'explorateur de fichiers :



- Si les fichiers sont bien présents, vérifiez dans les logs Atoo-sync dans le fichier. Allez dans : C:\ProgramData\Atoo Next\Atoo-Sync GesCom\logs
- Le fichier : EBP import.txt

Le fichier EBP import.txt enregistre les erreurs côté EBP, et indiquera ce qui a pu bloquer la création des documents dans EBP ou simplement notifiera le nombre de documents et de lignes créés ans vote base de données EBP.
Note : Ce fichier est écrasé à chaque import de commande. Il ne conserve pas les erreurs des précédentes commandes.
Ouvrez le fichier en double-cliquant dessus pour visualiser.
Exemple :

- Indique que l'utilisateur est mal renseigné dans le paramétrage Atoo-Sync pour la connexion au SDK.

- Il faut corriger l'utilisateur pour résoudre le problème.
Note : les erreurs peuvent être tout autre, des erreurs de connexion au SDK, des erreurs de validité du lot dans votre licence, ou encore des erreurs sur des informations obligatoires manquantes.
Générer des factures temporaires dans EBP grâce à l'import des commandes Atoo-Sync
Explications :
dans EBP Gestion Commerciale (Gescom), il est possible de créer des factures temporaires. Ces documents ont plusieurs objectifs et intérêts :
1. Qu'est-ce qu'une facture temporaire ?
Une facture temporaire est un document qui ressemble à une facture classique mais qui n'est pas encore comptabilisée. Elle peut être modifiée ou supprimée avant sa validation définitive.
2. Intérêts et avantages des factures temporaires
? Éviter les erreurs
-
Permet de vérifier les montants, articles et conditions avant de finaliser la facture.
-
Possibilité de faire valider par un supérieur ou un client avant édition définitive.
? Gestion des facturations en attente
? Flexibilité pour les modifications
? Facturation en plusieurs étapes
? Préparation comptable
3. Une fois la facture validée
Quand vous validez une facture temporaire, elle devient une facture définitive, ce qui entraîne :
C'est donc une option utile pour les entreprises qui veulent plus de contrôle sur leur facturation avant de finaliser leurs documents.
4. Dans Atoo-Sync : Indiquer de générer des "factures en cours de rédaction"
Si l'option facture temporaire est bien activée coté EBP, il est possible d'indiquer un type de document à générer nommé facture en cours de rédaction. Ce qui générera dans EBP un document de type facture temporaire.
Solution :
Côté EBP :
L'option document en cours de rédaction n'est disponible que si la facturation temporaire a été activée coté EBP :

Rendez-vous dans EBP dans le menu burger, puis dans Paramètre société > Documents de vente >Validation
et sélectionnez Document en cours de validation avec numérotation temporaire jusqu'à validation.
Côté Atoo-Sync GesCom :
Enfin relancez Atoo-Sync si il est déjà ouvert, puis rendez-vous dans Import des commandes.

Si le paramétrage est correcte coté EBP et Atoo-Sync vous devriez obtenir ce type de document .
Exemple dans EBP :

Où trouver les commentaires / remarques clients des commandes ?
Explications :
Un client a la possibilité de déposer des remarques, ou commentaires. Au niveau module / plugin, il est possible de définir ce que l'on récupère.
Sur Prestashop :

Sur WooCommere

Note : Sur WooCommerce, par défaut la valeur est sur Aucun message, passez la valeur sur Le premier message du client. Sans ça aucun message de client ne sera intégré dans les notes de documents.
Sur Prestashop exemple :

Dans EBP :
Sur le document cliquez sur Notes en haut à droite :

Pourquoi mes commandes ne remontent pas lors de la 1ere synchro ?
EBP utilise un service complémentaire qui permet d'automatiser les imports paramétrables, nommé SDK (Software Development Kit). SDK est asynchrone. Il faut donc plusieurs synchronisations au SDK pour que les commandes soient entièrement traitées.
Selon les versions d’Atoo-Sync, 2 ou 3 synchronisations sont nécessaires (dans les dernières versions il en faut 3. cf Schéma) :
- la 1ère importe les clients
- la 2eme importe les commandes
- la 3eme permet de renseigner dans notre base de données que la commande a bien été transférée et que le document XXXX a bien été créé.
Lors de la dernière importation Atoo-Sync sera en capacité de lire le numéro de document créé par EBP. Atoo-Sync a besoin de cette information pour la mise à jour des statuts des commandes, ainsi que l’envoi des factures sur la boutique.
Schéma de synchronisation :

Ces tâches peuvent être automatisées. Nous vous recommandons d’importer vos commandes toutes les 15 minutes.
Pour la mise en place d’une tâche planifiée, vous référer à la page : https://docs.atoo-next.net/faq-atoo-sync-gescom-31.html#faq-581
Envoyer des articles liés en tant que vente croisée
Dans la fiche Article EBP, rendez-vous dans l'onglet "Facturation", dans la section "Article lié" ajoutez le produit lié à cet article. Puis cochez la case "Proposer à la vente :
Exemple :

Dans le paramétrage Atoo-Sync GesCom assurez vous d'avoir coché "Envoyer les articles liés en tant que vente croisée" :

Dans le paramétrage du module Atoo-Sync GesCom de votre boutique assurez d'avoir activé la fonctionnalité "Produits associés" de la section "Modification des articles" :

Synchronisez ensuite ces 2 articles via le logiciel Atoo-Sync GesCom :

Voici le résultat sur PrestaShop :
L'article lié dans EBP est le produit associé dans PrestaShop :

Comment bien Exporter les contacts EBP vers la boutique ?
Explications :
Vous avez besoin d'envoyer les contacts dans votre CMS, pour qu'une fiche client soit créée ?
Plusieurs paramètres coté EBP et Atoo-Sync seront nécessaire pour le bon envoi des contacts.
Procédure :
Coté Atoo-Sync
Il faut faire attention à cette case et ensuite ce qui est configuré dans EBP sur chaque client.

Sur la fiche client dans EBP

Et sur la fiche de chaque contact du client dans EBP. Pour l'ouvrir, cliquer sur le crayon en face du nom.


Cochez la case contact web pour chaque contact qui devront être autorisé à exporter vers le CMS.
Remises EBP lues par Atoo-Sync
Voici la liste des différents type de calcul des tarifs EBP lus pas Atoo-Sync.
- Prix de vente HT
- Prix de vente TTC
- % remise
- Prix de vente HT + % remise
- Prix de vente TTC + % remise
- Montant de remise HT
- Prix de vente HT + montant de remise HT
- Montant de remise TTC
- Coefficient sur Prix Achat
- Coefficient sur Prix Achat + % remise
- Coefficient sur Prix Achat + remise HT
- Coefficient sur Prix de vente HT
- Coefficient sur Prix de vente HT + % remise
- Coefficient sur Prix de vente HT + remise HT
- Coefficient sur Prix de vente TTC
- Coefficient sur Prix de vente TTC + % remise
- Coefficient sur Prix de vente TTC + remise HT
- Coefficient sur Prix de Revient
- Coefficient sur Prix de Revient + % remise
- Coefficient sur Prix de Revient + remise HT
Imports paramétrables sur même BDD EBP avec plusieurs sites
Lors de l'import d'une commande sur EBP Atoo-Sync crée plusieurs fichiers textes.
Vous avez un fichier customers pour les clients, un fichier adresses pour les adresses clients et un fichier pour la commande selon le type de document :
Orders => Commandes
Quotes => Devis
Invoices => Factures
Delivery notes => Bon de livraison
Ces fichiers sont ensuite intégrés sur EBP à l'aide du SDK.
Quelques fois le mappage saute entre les champs ou il faut le faire pour la première fois lors du premier import.
Vous trouverez la procédure pour l'import paramétrable en cliquant sur le lien suivant :
https://docs.atoo-next.net/atoo-sync-gescom-ebp-importer-les-commandes-manuellement-dans-ebp-p467.html
Mais quelque fois vous avez la même base de données EBP pour différents sites et par conséquent vous ne voulez pas le même fichier pour tous vos imports.
Nous avons ajouté une fonctionnalité à Atoo-Sync permettant de sélectionner le nom du fichier à utiliser lors de l'import.
Cette sélection change selon le profil et se trouve dans les options avancées :

Vous pouvez donc créer par exemple un fichier Atoo-Sync Orders site 1 pour le premier site et Atoo-Sync Orders site 2 pour le second site.