Quelles versions WooCommerce sont compatibles avec Atoo-Sync ?

  Objectif

Cette FAQ explique quelles versions de WooCommerce, WordPress et PHP sont compatibles avec Atoo-Sync, ainsi que les particularités de fonctionnement et les plugins/thèmes supportés.

 Versions compatibles

Atoo-Sync fonctionne avec WooCommerce Multisite (multi-boutique) et ne nécessite pas l’API REST de WooCommerce.

 Méthode de communication

Atoo-Sync ne communique pas via l’API WooCommerce.
La synchronisation s’effectue à l’aide de requêtes HTTP (GET ou POST) entre l’application Atoo-Sync et le plugin installé sur le site WooCommerce.

Exemple de requête :

Ce mode de communication assure une compatibilité élevée, indépendamment des thèmes ou extensions WooCommerce installés.

 Compatibilité avec les thèmes

Atoo-Sync est compatible avec la majorité des thèmes WooCommerce.
Cependant, quelques cas particuliers peuvent nécessiter des vérifications :

• Thèmes qui remplacent le système natif de variations/attributs par leur propre plugin de sélecteurs (couleur, taille, etc.).

• Thèmes qui utilisent un plugin de galerie d’images spécifique (non natif de WooCommerce).

• Thèmes “headless” ou hybrides (WooCommerce + React ou VueJS).

Aucune incompatibilité majeure connue, car Atoo-Sync ne dépend pas de l’API REST mais communique directement avec le plugin WooCommerce via HTTP.

 plugins et extensions compatibles

Atoo-Sync a été testé avec succès avec les extensions suivantes :

• Customer Specific Pricing for WooCommerce

• Groups

• Perfect Brands for WooCommerce

• Yoast SEO

• WooCommerce Product Attachment

Ces plugins peuvent être utilisés conjointement avec Atoo-Sync sans altérer la synchronisation des produits, clients ou commandes.

 Recommandations

• Veillez à utiliser une version du plugin Atoo-Sync identique à celle de l’application (ex. : v25.10.1.0).

• Avant la première synchronisation, vérifiez vos paramètres d’URL, d’accès et les droits sur le répertoire du plugin WooCommerce.

• En cas de mise à jour majeure de WooCommerce ou WordPress, testez la synchronisation sur un environnement de préproduction.

Comment associer plusieurs images à un article à déclinaison dans WooCommerce ?

Objectif

Expliquer comment fonctionne l’envoi d’images pour les articles à déclinaison (variations) dans WooCommerce via Atoo-Sync et clarifier la limitation actuelle : une seule image par variation.

 Fonctionnement général

Lors de l’export des articles vers WooCommerce :

• Atoo-Sync crée le produit principal (variable).

• Atoo-Sync crée chaque variation (déclinaison).

• Atoo-Sync peut associer une image par variation.

• Le produit principal peut, lui, recevoir plusieurs images (galerie), mais pas les variations individuellement.

 Limitation WooCommerce / Atoo-Sync

 Limite technique actuelle :

Atoo-Sync ne peut envoyer qu’une seule image par variation WooCommerce.
Même si plusieurs images sont présentes dans le dossier, une seule sera utilisée.

Pourquoi ?

• WooCommerce ne propose nativement qu’un seul champ d’image par variation
  (variation->image_id).

• Atoo-Sync se base sur cette structure native.

• Ajouter plusieurs images nécessiterait :

  • un contournement technique côté module WooCommerce,

  • stocker plusieurs images comme galerie « globale » (pas variation par variation),

  • OU une personnalisation spécifique.

 Règles de nommage des images (pour l’unique image par variation)

Pour que l’image d’une variation soit reconnue, il faut la nommer ainsi :

 

REFERENCE_VARIATION.png REFERENCE_VARIATION.jpg REFERENCE_VARIATION.webp 

 Sans suffixe _01, _02…

Les suffixes (_01, _02, etc.) ne sont plus utiles, puisqu’une seule image est prise en compte.

Exemple :

 Atoo-Sync ne reconnaît pas :

• les images nommées avec la référence maître,

• plusieurs images pour une même variation,

• les images avec suffixe (_01, _02…).

 Où placer les images ?

Dans un dossier unique, par exemple :

Puis dans Atoo-Sync :

Menu Profil → Articles → Images → sélectionner le dossier.

 Processus d’export

1. Paramétrer le dossier d’images.

2. Lancer l’export des articles.

3. Atoo-Sync :

   • détecte la variation via la référence,

   • importe l’image unique liée,

   • met à jour la variation dans WooCommerce.

 Résultat dans WooCommerce

• Le produit principal peut afficher une galerie (si plusieurs images sont envoyées avec la référence maître — option réservée à WooCommerce uniquement).

• Chaque variation n’a qu’une image possible et un seul champ d’image.

 Cas particulier : images supplémentaires

Si vous souhaitez :

• plusieurs images par variation,

• une galerie propre à chaque déclinaison,

• des images différentes selon les attributs (comme certaines boutiques mode),

cela nécessite un développement spécifique du module WooCommerce
(sur devis).

Atoo-Sync ne le gère pas nativement.

 Résumé rapide à placer dans la FAQ

Fonction	Supporté ?
1 image par variation	Oui
Plusieurs images par variation	Non
Galerie du produit principal	Oui
Utilisation de la référence maître pour la galerie	Oui
Suffixes _01, _02…	Inutile
Images par variation avec ref. maître	Non

Comment exporter les prix spécifiques groupes clients dans WooCommerce?

Explications : 

WooCommerce est une extension open source pour WordPress permettant de créer une boutique en ligne.

Si vous souhaitez exporter les prix spécifiques des groupes clients et/ou des clients dans WooCommerce, plusieurs étapes seront nécessaires pour effectuer l'export correctement.

Prérequis :

Pour le bon fonctionnement des exports des prix spécifiques groupes clients, il est nécessaire d'installer des plugins supplémentaires : 

• Customer Specific Pricing for WooCommerce : https://wisdmlabs.com/woocommerce-user-specific-pricing-extension/
• Groups : https://wordpress.org/plugins/groups/

Export des groupes clients : 

Dans un premier temps il faut créer les groupes clients dans WooCommerce.

Rendez-vous Dans Atoo-Sync, puis dans Configurer le profil, et  section Clients.

Dans client et Export des clients vers la boutique, cochez la case Créer les groupes clients dans le site web.

Enfin vous pourrez exporter les groupes clients.

Rendez-vous dans l'onglet Clients sur Atoo-Sync,

Cliquez sur le bouton Exporter les Groupes de Clients.

Exporter les groupes clients permettra aux tarifs spécifiques de se déclencher correctement en fonction du groupe auquel vos clients appartiennent.

Export des tarifs spécifiques groupes clients : 

Une fois les groupes clients créés, vous pouvez paramétrer pour pouvoir exporter les tarifs spécifiques.

Rendez vous dans Configurer le profil sur Atoo-Sync

Cliquez sur Articles, puis Stock et prix.

Cochez la case Envoyer les prix spécifiques des groupes clients.

Enfin, vous allez pouvoir exporter les  prix.

Cliquez sur le bouton Prix dans l'onglet  Profil Atoo-Sync.

Dans WooCommerce au niveau de vos produits, vous devriez voir comme ci dessous, vos prix spécifiques : 

Pour les prix spécifiques "clients" cela fonctionne de la même façon.

Il faut qu'Atoo-Sync connaisse le client, c'est à dire qu'il ait déjà passé commande et été importé via notre connecteur, ou qu'Atoo-Sync exporte les clients de l'ERP vers la boutique.

Les prix spécifiques clients apparaissent également sur Customer Specific Price dans la partie customer base pricing.

Limitation avec le plug-in WisdmLabs Customer Specific Pricing for WooCommerce

Les logiciels Atoo-Sync GesCom sont compatibles avec le plug-in WisdmLabs Customer Specific Pricing for WooCommerce.

Ce plug-in permet de définir des prix ou des remises par clients ou groupes de clients.

Cependant la gestion des prix et des remises de ce plugin n'est pas vraiment compatible avec ce que l'on retrouve dans les logiciels de gestion commerciale.

En effet il n'est pas possible avec ce plug-in de définir un prix et une remise pour une mème client ou groupe de client. Pour contrer cette limitation le plug-in Atoo-Sync GesCom dans WooCommerce converti directement les remises en prix remisés.