Connecter une boutique WooCommerce

Pour connecter une boutique WooCommerce, vous avez besoin de trois 'clés' (keys). Une clé d'API, une clé secrète d'API et une clé secrète de webhook.

?> Conseil Assurez-vous que toutes les commandes ouvertes dans votre boutique WooCommerce sont traitées avant de créer la liaison. Ainsi, vous évitez les différences de stock possible.

Créer des API keys

La connexion à l'API permet à Stoqflow de communiquer avec votre boutique WooCommerce. Pensez aux demandes d'ordres et à l'information sur les produits, mise à jour du statut des commandes, etc. Voici le plan d'action pour lier une boutique WooCommerce à Stoqflow.

• Connectez-vous à votre boutique WooCommerce
• Naviguez vers « WooCommerce » => « Paramètres » => « Avancé »
• Cliquez sur « API REST »
• Cliquez sur « Ajouter une clé »

• Entrez dans la zone de description : Stoqflow
• Choisissez dans les droits pour : Lecture / Ecriture
• Vous recevrez les deux premières clés

• Avertissement : Ne fermez pas ce fenêtre, car vous n'allez pas la voir qu'une fois
• Ouvrez Stoqflow dans une nouvelle fenêtre ou onglet
• Naviguez vers « Magasins » et ajoutez un nouveau magasin
• Donnez à l'un nom et choisissez « Online Shop », puis choisissez « WooCommerce »
• Entrez les deux clés générées sous « Configuration API »

• Clé API = clé client, Clé secrète API = Secret Client
  • N'oubliez pas d'entrer également dans la zone de URL complète de votre boutique (y compris http ou https)
• Fermez pas le fenêtre Stoqflow mais revenez à WooCommerce

!> Attention Après avoir configuré l'API et avant de configurer les webhooks, effectuez une synchronisation des produits et des commandes dans cet ordre. Après la mise en place des clés API, vous aurez deux boutons de synchronisation sous vos paramètres d’API dans Stoqflow.

Ajouter les webhooks

Les webhooks permettent à WooCommerce d'informer notre application en temps réel (en temps réel) de toutes modifications opérationnelles. Sans webhooks, Stoqflow recevra les modifications aux moments fixes et pas en temps réel.

Webhook 1 : mise à jour de la commande

• Naviguez dans WooCommerce vers « WooCommerce » => « Paramètres » => « Avancé » => « Webhooks »
• Cliquez sur « Ajouter un webhook »
• Remplissez les champs suivants :
  • Nom : Stoqflow – order updated
  • Statut : Actif
  • Sujet : Mise à jour de la commande (Order updated)
  • URL de livraison : https://app.stoqflow.com/webhooks/woocommerce
  • Secret : (laissé ouvert pour l'instant)
  • API version : Intégration V3 WP REST API
• Cliquez sur « Enregistrer le webhook »
• Le champ « Secret » sera automatiquement rempli après enregistrement
• Copiez cette clé secrète et revenez à Stoqflow
• Entrez dans la zone de configuration des webhooks cette clé partagée sous « Clé secrète »
• N'oubliez pas d'entrer également le nom complet du domaine de votre boutique (y compris http ou https)
• Choisissez les commandes que vous souhaitez importer dans Stoqflow en fonction du filtre de statut ou un filtre avancé (utilisé le plus souvent est statut « processing »)
• Enregistrez cette configuration dans Stoqflow

Webhook 2 : création d'une commande

• Naviguez dans WooCommerce vers « WooCommerce » => « Paramètres » => « Avancé » => « Webhooks »
• Cliquez sur « Ajouter un webhook »
• Remplissez les champs suivants :
  • Nom : Stoqflow – order created
  • Statut : Actif
  • Sujet : Création d'une commande (Order created)
  • URL de livraison : https://app.stoqflow.com/webhooks/woocommerce
  • Secret : copiez la clé secrète créée dans le Webhook 1
• API version : Intégration V3 WP REST API
• Cliquez sur « Enregistrer le webhook »

Webhook 3 : suppression d'une commande

• Naviguez dans WooCommerce vers « WooCommerce » => « Paramètres » => « Avancé » => « Webhooks »
• Cliquez sur « Ajouter un webhook »
• Remplissez les champs suivants :
  • Nom : Stoqflow – order deleted
  • Statut : Actif
  • Sujet : Suppression d'une commande (Order deleted)
  • URL de livraison : https://app.stoqflow.com/webhooks/woocommerce
  • Secret : copiez la clé secrète créée dans le Webhook 1
• API version : Intégration V3 WP REST API
• Cliquez sur « Enregistrer le webhook »

Ajouter des options de livraison

Lorsqu'une commande de vente avec une option de livraison spécifique arrive dans l'application, un transporteur est recherché avec un nom similaire qui offre une méthode de livraison active pour la boutique où l'ordre a été créé. Si tel est le cas, ce transporteur sera utilisé comme préférences transporteur pour cet ordre de vente. Les options de livraison peuvent être ajoutées dans WooCommerce en suivant les étapes ci-dessous :

• Naviguez dans WooCommerce vers « WooCommerce » => « Paramètres » => « Avancé » => « Webhooks »
• Créez un ou plusieurs « zones de livraison »
• Utilisez les noms des transporteurs que vous souhaitez utiliser comme « méthodes de livraison » pour la(s) zone(s) de livraison