Tutoriel : comment mapper un champ produit natif EBP sur un champ non natif WooCommerce ?

Ce tutoriel propose un exemple avancé d'utilisation du SDK E-connecteur pour personnaliser les données du flux produit.

Contexte

Vous utilisez la gestion commerciale EBP, où la fiche article contient un code-barres produit. Cependant, WooCommerce ne disposant pas de champ natif pour cette information, E-connecteur ne la synchronise pas automatiquement. Il n’existe pas d’option dans l’assistant de configuration pour activer cette synchronisation.

Dans ce cas précis, votre agence web a ajouté un module permettant de gérer le code-barres dans WooCommerce. Ce module ajoute un champ ean directement à la racine de l’objet product dans l’API REST WooCommerce.

Ce tutoriel ne couvre pas :

• La gestion des variations produit.

• L’ajout de champs dans WooCommerce avec le module WordPress ACF (voir l’article :

   Est-ce qu'E-connecteur supporte l'extension WordPress ACF ?).

Prérequis

Avant de suivre ce tutoriel, vous devez avoir des connaissances de base sur :

• La structure des tables SQL Server EBP et la réalisation de requêtes SELECT basiques.

• L’interrogation de l’API REST WooCommerce via des outils comme Postman ou Insomnia.

Compatibilité
Cet exemple est applicable à toutes les éditions d’E-connecteur, à l’exception des anciennes versions Standard et Pro. Si vous avez besoin d’assistance, toute personnalisation basée sur le SDK E-connecteur nécessite un contrat au temps passé (CTP), le temps d’accompagnement étant décompté de ce contrat.

Depuis la version E-connecteur 8.0.165, cette personnalisation est également possible pour les produits variables.

Étapes de mise en œuvre

1. Identifier le champ WooCommerce

Avec votre client REST habituel (Postman, Insomnia, etc.) ou en consultant la documentation du module WooCommerce utilisé, identifiez le nom du champ ajouté dans l’API REST WooCommerce.
Dans cet exemple, le champ concerné est ean.

2. Identifier la colonne correspondante dans EBP

Dans la base de données EBP, la table Item contient la colonne SQL correspondant au code-barres. Dans notre cas, il s’agit de BarCode.

3. Modifier la requête SQL dans E-connecteur

Dans l’interface de configuration d’E-connecteur :

• Accédez à l’onglet SDK > Sélection complémentaire : extra_sql_select.

• Ajoutez la requête suivante :
  i.BarCode AS xx_ean
  
  Explications :

  • i. fait référence à la table Item d’EBP.

  • BarCode est le nom de la colonne contenant le code-barres.

  • xx_ indique à E-connecteur qu’il s’agit d’un champ personnalisé.

  • ean correspond au nom du champ dans WooCommerce.

Une fois cette configuration appliquée, E-connecteur transmettra automatiquement le code-barres d’EBP vers WooCommerce en utilisant le champ ean ajouté par le module personnalisé.