ObjectifLors 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 regroupementPour 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 explicatifRé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.
PréparationAvant 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 articlesDans le menu Burger :
Menu > Fonctions avancées > Personnalisation des champs | tablesSélectionnez Article > Champs personnalisés
Créer les champs personnalisésDans 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 EBPUne 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-SyncRetournez dans Atoo-Sync :
Configurer le profil > Articles > Déclinaisons / VariationsSélectionnez les champs créés dans EBP :
Nom d’attribut → Nom de la Gamme (ex. : Gamme 1 Nom)
Valeur d’attribut → Valeur de la Gamme (ex. : Gamme 1 Valeur)
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.
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 :
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
Rendez-vous dans Configurer le profil > Options Avancées > Section EBP > Create PDF time out > passez la valeur a 200.
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.
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.
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.
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.
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.
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.
Contrôlez la présence dans le dossier des fichiers de commandes suivants :
Afin de contrôler la bonne création des commandes à importer dans EBP, vérifiez le chemin de création de ces fichiers.
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.
Ouvrez le fichier en double-cliquant dessus pour visualiser.
dans EBP Gestion Commerciale (Gescom), il est possible de créer des factures temporaires. Ces documents ont plusieurs objectifs et intérêts :
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.
? É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
Utile pour des ventes en cours où toutes les informations ne sont pas encore finalisées (quantités exactes, remises, délais de paiement...).
? Flexibilité pour les modifications
Contrairement aux factures définitives, une facture temporaire peut être corrigée sans avoir besoin de passer par une procédure d'avoir.
? Facturation en plusieurs étapes
Utile si vous devez envoyer un devis puis transformer progressivement en facture (cas des acomptes, factures progressives...).
? Préparation comptable
Permet de préparer les documents avant la validation pour éviter des erreurs dans la comptabilité.
Quand vous validez une facture temporaire, elle devient une facture définitive, ce qui entraîne :
Son enregistrement comptable (si la comptabilité est liée).
L’impossibilité de la modifier (seule solution : faire un avoir).
C'est donc une option utile pour les entreprises qui veulent plus de contrôle sur leur facturation avant de finaliser leurs documents.
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.
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.
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 :
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 le document cliquez sur Notes en haut à droite :
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) :
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
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 :
Voici la liste des différents type de calcul des tarifs EBP lus pas Atoo-Sync.
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 :
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.