Aller au contenu principal

WooCommerce - Étapes d'intégration

  • Mise à jour

Aperçu de l'intégration

Screenshot 2024-09-10 at 14.49.48.png

L'intégration de Hive avec WooCommerce est native, offrant des mises à jour en temps réel via des webhooks. Toute mise à jour dans votre boutique sera reflétée dans la Hive App quelques secondes plus tard.

 

Comment intégrer WooCommerce dans Hive

Pour connecter votre boutique WooCommerce à la Hive App, vous devrez créer une nouvelle clé "REST API" dans votre boutique WooCommerce et partager l'"URL", la "clé client" et le "secret client" avec Hive en créant un ticket de support client sur la Hive App dans votre page "support".

Pour créer une clé "REST API" dans votre boutique WooCommerce, veuillez suivre les étapes ci-dessous :

  1. Dans Woocommerce, accédez à l'onglet WooCommerce, cherchez l'icône Woo et sélectionnez "Paramètres"
  2. Naviguez et cliquez sur l'onglet "Avancé".
  3. Sous la rubrique "Configuration de la page", trouvez l'onglet "REST API".
  4. Cliquez sur "Ajouter une clé"
  5. Ajoutez "Hive Technologies" comme description et donnez les permissions "Read/Write", puis cliquez sur "Générer une clé API".
  6. Veuillez copier et envoyer votre "URL", votre "clé de consommateur" et votre "secret de consommateur" à Hive en créant un ticket sur la Hive App dans la page "support".

gif woo.gif

⚠️ Si vous intégrez une autre boutique WooCommerce après que nous ayons commencé à traiter vos commandes, veuillez en informer Hive via le support client afin de vous aligner sur le moment où l'exécution des commandes doit commencer pour cette boutique supplémentaire.

 

Comment importer votre catalogue dans Hive

Pour que Hive sache quelles SKU traiter à partir d'une boutique, il est nécessaire de les mettre en correspondance avec les SKU de Hive.

Après l'intégration de votre WooCommerce, vos produits seront importés via des webhooks quelques secondes plus tard dans la Hive App. Veuillez commencer à mapper vos produits dans l'application Hive dès que les produits de votre boutique ont été importés afin que Hive sache quels produits physiques expédier à partir des commandes synchronisées depuis cette nouvelle boutique.

Pour plus d'informations sur la façon de faire correspondre les produits de la boutique aux SKU de Hive, veuillez cliquer ici.

 

Comment configurer la synchronisation de l'inventaire

Hive peut synchroniser les quantités d'inventaire avec votre WooCommerce. De cette façon, vous avez un aperçu précis de votre inventaire dans WooCommerce, et vous pouvez éviter les ventes excessives. Les numéros d'inventaire sont synchronisés avec WooCommerce toutes les heures. La synchronisation de l'inventaire ne sera activée qu'une fois que Hive aura commencé à traiter vos commandes. Si vous ne souhaitez pas que cette fonctionnalité soit activée, veuillez contacter le support client.

  • Remarque : la synchronisation des stocks et la synchronisation des commandes ne sont pas liées. Sans la synchronisation de l'inventaire, les commandes arriveront toujours dans Hive. La synchronisation de l'inventaire est dédiée à l'envoi des comptes d'inventaire à WooCommerce.

 

Comment les informations de suivi sont-elles transmises à WooCommerce ?

Les informations de suivi des envois seront transmises à WooCommerce dès que la commande est marquée comme "expédiée" dans Hive. Lorsque Hive exécute une commande dans le centre d'exécution, nous marquons la commande comme "terminée" et envoyons le nom du transporteur, l'URL de suivi et le numéro de suivi de l'expédition à votre WooCommerce.

 

Détails de l'intégration

  1. Données SKU importées de WooCommerce

Les champs SKU suivants sont importés de WooCommerce dans Hive :

  • Poids
  • Coût/coût de production
  • Statut

Le coût de production est un champ important à remplir dans WooCommerce. Avec le code SH et le pays d'origine, il est nécessaire pour passer les autorités douanières en cas d'expédition en dehors de l'UE. Si l'un de ces champs n'est pas renseigné, la commande sera bloquée dans le Fulfillment Center jusqu'à ce que vous mettiez à jour les informations relatives à l'SKU.

  • Note : Les champs SKU "Country of origin" et "HS Code" ne sont pas encore importés de WooCommerce. Si vous envisagez d'expédier en dehors de l'UE, veuillez les remplir directement dans la Hive App.
  • Note : Actuellement, nous n'importons pas le champ "Barcode" (EAN) de WooCommerce. Pour nous aider à mieux identifier vos SKU, veuillez remplir ces champs dans la Hive App.

 

  1. Détails de la synchronisation des commandes et des produits

Les commandes et les mises à jour de produits avec l'intégration WooCommerce se font en temps réel, car la connexion se fait via des webhooks.

Il s'agit des points de terminaison de l'API que nous utilisons actuellement :

GET /wp-json/wc/v3/settings/produits/<id>

  • Pour importer les paramètres d'un produit

GET /wp-json/wc/v3

  • Pour tester que l'URL et la clé API fonctionnent correctement

GET /wp-json/wc/v3/produits

  • Pour importer des produits

GET /wp-json/wc/v3/produits/<product_id>/variations

  • Pour importer des variantes d'un produit

POST /wp-json/wc/v3/produits/<product_id>/variations/batch

  • Pour mettre à jour l'inventaire

GET /wp-json/wc/v3/orders

  • Pour importer des commandes

GET /wp-json/wc/v3/orders/<id> (en anglais)

  • Pour importer une commande spécifique

PUT /wp-json/wc/v3/commandes/<id>

  • Pour mettre à jour l'état de la commande

GET /wp-json/wc/v3/orders/<id>/notes

  • Pour récupérer les notes de commande

POST /wp-json/wc/v3/orders/<id>/notes

  • Pour créer une nouvelle note de commande avec le numéro de suivi/URL

GET /wp-json/wc-shipment-tracking/v3

  • Pour détecter la présence du plugin de suivi des envois payés

GET /wp-json/wc-shipment-tracking/v3/orders/<order_id>/shipment-trackings/

  • Pour obtenir tous les envois

POST /wp-json/wc-shipment-tracking/v3/orders/<order_id>/shipment-trackings/

  • Pour créer un nouvel envoi

GET /wp-json/wc/v3/webhooks

  • Pour vérifier si les URL de nos webhooks sont enregistrées

POST /wp-json/wc/v3/webhooks/batch

  • Pour enregistrer les URL de nos webhooks, s'ils sont manquants

Sur cette page de WooCommerce, vous pouvez trouver plus d'informations sur les points de terminaison API que nous utilisons.

 

  1. Peut-on activer la FIFO ?

Nous recevons des horodatages de WooCommerce, ce qui nous permet de suivre une logique FIFO (First-in-First-out) pour les commandes importées de WooCommerce.

 

Fonctionnalités non prises en charge

L'intégration ne prend actuellement pas en charge les fonctionnalités suivantes :

  • Transfert par lots des informations de suivi de Hive vers WooCommerce
  • Transfert des informations de suivi des numéros de série de Hive à WooCommerce
  • Téléchargement de documents de WooCommerce vers Hive pour les commandes B2B Vous pouvez également ajouter des documents manuellement dans l'application Hive. Toutes les étapes sont expliquées dans cette FAQ.
  • Annonce d'expéditions de réapprovisionnement
  • Marquer des articles "en attente" dans WooCommerce
    • Vous pouvez également utiliser les "actions de commande" dans la Hive App pour marquer les commandes "en attente"

 

Guide de désinstallation

Vous pouvez révoquer notre clé API à partir de votre WooCommerce pour mettre fin à notre collaboration. Pour ce faire, suivez les étapes suivantes :

  1. Dans Woocommerce, accédez à l'onglet WooCommerce, cherchez l'icône Woo et sélectionnez "Paramètres"
  2. Naviguez et cliquez sur l'onglet "Avancé".
  3. Sous la rubrique "Configuration de la page", trouvez l'onglet "REST API".
  4. Trouvez la clé "Hive Technologies
  5. Cliquez sur "Révoquer"

Articles associés