Synchroniser les produits avec Woocommerce

Ce guide explique comment synchroniser les fiches produits. Pour la synchronisation du stock, veuillez suivre ce guide.

---

#1/ Pré-requis

Le code-barres dans Hiboutik est la clef unique qui permet d’identifier un produit ou une déclinaison. Pour qu’un produit Hiboutik trouve son équivalent sous Woocommerce et inversement, il faut que le code-barres du produit (ou de sa déclinaison) dans Hiboutik soit strictement identique à l’UGS/SKU du produit (ou de sa variation) sous Woocommerce.

---

#2/ Importer une base produits Woocommerce

Cette section explique comment importer une base produits Woocommerce dans un compte Hiboutik.

Cette procédure permet d’importer les catégories, les produits, leurs déclinaisons, leurs prix, leurs références et leurs images.

Le stock n’est pas importé dans le cadre de cette procédure. La synchronisation du stock s’effectue séparément avec l’application Woocommerce.

#Configuration

Dans Woocommerce, créez un accès API.

Pour cela, allez dans Woocommerce / Réglages / Avancé / API Rest et ajoutez une clé avec la permission Lecture/Écriture.

Dans la section Apps de votre compte Hiboutik, installez l’application Import Woocommerce.

Indiquez l’URL de votre site Internet et reportez les clés ck et cs générées dans Woocommerce.

Enregistrez les paramètres puis cliquez sur le bouton Importer les données.

L’import s’effectue en plusieurs étapes et peut prendre plusieurs minutes en fonction du nombre de produits à traiter.

---

#Catégories

Les catégories Woocommerce sont automatiquement créées dans Hiboutik lorsqu’elles n’existent pas encore.

La hiérarchie des catégories est également conservée.

Par exemple :

Chaussures
    ├── Homme
    └── Femme

sera reproduite avec la même organisation dans Hiboutik.

---

#Produits simples

Les produits simples Woocommerce sont importés dans Hiboutik avec notamment :

• leur libellé ;
• leur prix de vente ;
• leur catégorie ;
• leur UGS/SKU ;
• leurs images.

Lorsqu’une UGS/SKU est renseignée dans Woocommerce, elle est utilisée comme code-barres du produit dans Hiboutik.

---

#Produits à déclinaisons

Les produits variables Woocommerce sont importés dans Hiboutik avec leurs déclinaisons.

Pour chaque produit variable, le connecteur détermine tout d’abord le type de déclinaison à utiliser dans Hiboutik.

Il analyse pour cela les attributs configurés sur le produit Woocommerce.

Attribut Woocommerce global

En priorité, le connecteur recherche le premier attribut du produit disposant d’un identifiant Woocommerce.

Par exemple :

Produit : T-shirt Classic

Attribut :
Taille

Valeurs :
S
M
L
XL

L’attribut Taille est associé au type de déclinaison correspondant dans Hiboutik.

Le résultat sera :

T-shirt Classic
│
└── Type de déclinaison : Taille
    ├── S
    ├── M
    ├── L
    └── XL

Attribut défini directement sur le produit

Si aucun type de déclinaison ne peut être identifié à partir d’un attribut global Woocommerce, le connecteur recherche une correspondance à partir du nom de l’attribut.

Par exemple :

Woocommerce
Attribut : Pointure

        ↓

Hiboutik
Type de déclinaison : Pointure

Cela permet également de traiter des attributs définis directement au niveau d’une fiche produit Woocommerce.

---

#Création des types de déclinaisons

Les attributs Woocommerce nécessaires aux produits variables sont automatiquement créés dans Hiboutik sous forme de types de déclinaisons lorsqu’ils n’existent pas encore.

Leurs différentes valeurs sont également créées.

Par exemple :

Woocommerce

Attribut : Taille
Valeurs : S, M, L, XL

devient :

Hiboutik

Type de déclinaison : Taille
Déclinaisons : S, M, L, XL

---

#Prix des déclinaisons

Lorsqu’une variation Woocommerce possède son propre prix, celui-ci est appliqué à la déclinaison correspondante dans Hiboutik.

Par exemple :

S  → 29,90 €
M  → 29,90 €
L  → 31,90 €
XL → 31,90 €

Les différences de prix entre les variations Woocommerce sont ainsi conservées dans Hiboutik.

---

#UGS/SKU et codes-barres

L’UGS/SKU Woocommerce est utilisée comme code-barres dans Hiboutik.

Pour un produit à déclinaisons, chaque variation peut ainsi disposer de son propre code-barres.

Par exemple :

Variation Woocommerce

Taille : M
UGS/SKU : 3760123456789

        ↓

Hiboutik

Déclinaison : M
Code-barres : 3760123456789

Une option permet également de générer automatiquement un code-barres EAN13 lorsqu’aucune UGS/SKU n’est renseignée dans Woocommerce.

Le code généré est alors enregistré dans Woocommerce et dans Hiboutik afin de conserver une référence commune entre les deux systèmes.

---

#Images

Les images des produits Woocommerce sont automatiquement importées dans Hiboutik.

Jusqu’à 4 images par produit peuvent être récupérées.

Les formats JPEG, PNG, WEBP et GIF sont pris en charge.

Lorsqu’une image est déjà présente dans Hiboutik à la position correspondante, elle n’est pas importée une seconde fois.

---

#Importer uniquement les produits publiés

Une option permet de limiter l’import aux produits actuellement publiés dans Woocommerce.

Lorsque cette option est activée, les produits qui ne sont pas publiés dans Woocommerce ne sont pas pris en compte lors de l’import.

---

#Nouveaux imports

Le connecteur conserve la correspondance entre les produits Woocommerce et Hiboutik.

Lors d’un nouvel import, les produits déjà associés sont reconnus afin d’éviter leur création en double.

Les nouveaux produits peuvent ainsi être ajoutés au catalogue Hiboutik lors des imports suivants.

---

Attention : un import de produits ne peut pas être annulé automatiquement. Nous vous recommandons de vérifier la configuration de votre catalogue Woocommerce avant de lancer un premier import important.

---

#3/ Exporter une base produits vers Woocommerce

Cette section explique comment exporter une base produits Hiboutik vers un site Woocommerce.

#Étape 1

Dans 'Produits/Importer-Exporter/Exporter les données : Produits', vous trouverez différents exports de votre base produits. Sur la ligne Woocommerce, cliquez sur l’icône 'Générer' et téléchargez le fichier. Ce fichier est préformaté pour un import simplifié dans Woocommerce.

#Étape 2

Sur Woocommerce, allez dans la section 'Produits' et cliquez sur le bouton 'Importer' en haut de la page. Importez ensuite le fichier CSV récupéré à l’étape 1 et suivez le processus d’import.

Les données du fichier à faire correspondre avec les champs Woocommerce sont les suivantes :

Intitulé	Remarques
type	Indique si le produit est simple ou à déclinaisons.
sku	Clef de communication pour la synchronisation. Correspond au code-barres du produit.
published	0 si produit archivé, sinon 1.
name	Libellé du produit.
catalog_visibility	1 si statut 'En ligne' activé, sinon 0.
tax_status	Par défaut les produits sont soumis à taxe ('taxable'). Possibilité de mettre 'none' si vous n’êtes pas assujetti à la TVA.
tax_class	'Standard' = taxe ID 1 (Paramètres/Taux de TVA), 'Reduced Rate'= taxe ID 2, 'Zero Rate'= taxe 0%. Si la correspondance n’est pas juste, modifiez le fichier.
regular_price	Prix de vente du produit.
stock	Quantité si le produit est géré en stock.
categories	Reprend les catégories de votre compte. Vous devez avoir créé au préalable votre arborescence dans Woocommerce avec les mêmes dénominations.
attribute 1 name	Nom du type de déclinaison.
attribute 1 value(s)	Différentes déclinaisons possibles ou nom de la déclinaison.
attribute 1 global	Statut de la déclinaison.
parent	SKU du produit tête si la ligne est une déclinaison.
description	Description du produit.
image_id	Lien vers la première image web de la fiche produit.

Le guide pour importer des produits dans Woocommerce est disponible ici : https://docs.woocommerce.com/document/importation-exportation-de-produits-au-format-csv/

Il est possible de filtrer les produits dans le fichier d’export généré sur Hiboutik (ex : pour exporter uniquement les derniers produits ajoutés) :

– allez dans section 'Produits', – cliquez sur le bouton 'Recherche avancée' en haut de la page, – sélectionnez vos filtres et cochez la case 'Enregistrer la recherche', – et lancez la recherche.

Les fichiers générés dans 'Produits/Importer-Exporter/Exporter les données : Produits' n’intégreront que les résultats de votre recherche.