Dépannage

Commandes non reçues dans HubRise

Pour recevoir des commandes dans HubRise, la première étape consiste à connecter WooCommerce à HubRise. Si ce n'est pas fait, suivez les étapes dans Connexion à HubRise.

Si vous avez connecté WooCommerce à HubRise, mais vous ne recevez pas de commandes dans HubRise, vérifiez les éléments suivants.

Vérifier les crochets Web WooCommerce

Lorsque vous connectez WooCommerce Bridge, il crée deux crochets Web sur votre site internet WooCommerce. Ceux-ci sont essentiels pour transmettre les commandes de WooCommerce à HubRise.

Vous devez vérifier la présence de ces crochets Web, mais aussi vous assurer que leur statut est Active. Si leur statut est Inactive, ils ne fonctionneront pas. Vous devrez les réactiver en cliquant sur leur nom.

Pour vérifier que les crochets Web ont été créés :

1. Ouvrez votre back-office WooCommerce.
2. Dans le panneau de navigation de gauche, cliquez sur WooCommerce > Réglages > Avancé.
3. Ensuite, cliquez sur Crochets Web.
4. Trouvez les deux entrées suivantes :
   • HubRise {{id_point_de_vente}}: Order updated
   • HubRise {{id_point_de_vente}}: Order created
5. Vérifiez le statut de chaque entrée. Si l'un d'entre eux est défini sur Inactive, cliquez sur son nom pour changer le statut en Active.

Si ces entrées sont présentes et actives, c'est signe que la connexion avec HubRise a bien été établie. Vous pouvez passer à l'étape suivante.

Si vous ne trouvez pas les deux entrées, vous devez reconnecter le bridge et vérifier à nouveau les crochets Web WooCommerce. Pour plus d'informations sur la connexion du bridge, voir Connexion à HubRise.

Passer une commande fictive dans WooCommerce

Pour vérifier la connexion entre WooCommerce et HubRise, passez une commande fictive dans WooCommerce et vérifiez qu'elle est transmise à HubRise.

1. Ouvrez votre back-office WooCommerce.
2. Dans le menu du haut, cliquez sur Visiter la boutique. Cela ouvre votre site internet WooCommerce.
3. Passez une commande sur votre site WooCommerce.
4. Retournez dans le back-office WooCommerce, et cliquez sur WooCommerce > Commandes dans le panneau de navigation de gauche. Votre nouvelle commande doit être présente.

Lorsque WooCommerce est connecté à HubRise, les commandes passées dans WooCommerce doivent être immédiatement transmises à HubRise.

Pour vérifier que votre commande fictive a bien été transmise à HubRise, suivez ces étapes :

1. Connectez-vous à votre back-office HubRise.
2. Naviguez vers la page DONNÉES > COMMANDES.
3. Trouvez votre commande de test dans cette page.

Si vous voyez la commande, la connexion entre WooCommerce et HubRise fonctionne correctement.

Commandes reçues dans HubRise avec du retard

Par défaut, les commandes sont transmises de WooCommerce à HubRise par un processus appelé cron. Il s'exécute très régulièrement et transmet toutes les commandes qui ne l'ont pas encore été. Cela peut retarder la création des commandes et la mise à jour des statuts.

Vous pouvez choisir de transmettre les commandes immédiatement, sans attendre l'exécution du cron. On parle dans ce cas de crochets Web synchrones. Pour activer les crochets Web synchrones, suivez ces étapes :

1. Accédez aux fichiers de votre site WordPress en utilisant un client FTP ou le gestionnaire de fichiers du panneau de commande de l'hébergeur.
2. Accédez au répertoire wp-content/themes/[votre-thème], où [votre-thème] représente le dossier de votre thème actif.
3. Ouvrez le fichier functions.php et ajoutez l'extrait de code suivant à la fin du fichier :

   add_filter( 'woocommerce_webhook_deliver_async', '__return_false' );

4. Enregistrez le fichier. Les modifications prendront effet immédiatement.

Si vous n'êtes pas sûr de savoir comment modifier le fichier functions.php, contactez le développeur de votre site WooCommerce.

Erreurs 401

Si vous constatez des erreurs 401 dans WooCommerce Bridge, cela signifie que celui-ci est incapable de s'authentifier avec WooCommerce.

Il y a trois causes courantes d'erreurs 401 :

Clé API supprimée

Si la clé API de HubRise a été supprimée dans WooCommerce, cela conduit à des erreurs 401. Pour le vérifier :

1. Ouvrez votre tableau de bord WordPress.
2. Accédez à WooCommerce > Réglages > Avancé > API REST.
3. Vérifiez qu'il existe bien une clé API nommée HubRise - API.

S'il n'y a pas de clé HubRise - API, cela signifie qu'elle a été supprimée. Vous devez alors reconnecter le bridge. Pour plus d'informations sur la connexion du bridge, voir Connexion à HubRise.

Échec de l'authentification de base HTTP

Si votre configuration WooCommerce ne fonctionne pas avec la méthode d'authentification de base HTTP par défaut, cela peut également entraîner des erreurs 401. Vous devez alors passer à la méthode OAuth1.

Suivez ces étapes :

1. Réinitialisez la configuration de WooCommerce Bridge.
2. Reprenez la configuration du bridge depuis le début, et à la première étape développez Options avancées.
3. Sélectionnez l'option Use OAuth1.
4. Poursuivez la configuration telle qu'elle est décrite dans Connexion à HubRise.

Vérifiez si cette modification a permis de résoudre les erreurs 401. Si ce n'est pas le cas, consultez les autres étapes de dépannage.

URL incorrecte lors de la configuration

REMARQUE IMPORTANTE : Ce problème n'est pertinent que si vous utilisez la méthode d'authentification OAuth1.

Lors de la configuration de la méthode OAuth1, si vous avez ajouté un www supplémentaire ou si vous avez oublié d'en inclure un dans l'URL de votre site internet, l'API WooCommerce répond avec le message JSON ci-dessous :

{  "code": "woocommerce_rest_authentication_error",  "message": "Signature non valide - La signature fournie ne correspond pas.",  "data": {    "status": 401  }}

Dans ce cas, le message d'erreur indique que la signature fournie ne correspond pas en raison de la saisie d'une URL incorrecte. Ce problème ne survient qu'avec la configuration de la méthode OAuth1, car l'URL exacte est alors nécessaire pour calculer la signature de la requête, contrairement à Basic Auth qui n'utilise pas l'URL dans l'authentification de chaque requête. Pour résoudre le problème, vous devez vous reconnecter et utiliser l'URL exacte de votre site internet (avec ou sans le www, selon le cas).

Voici comment effectuer la correction :

1. Réinitialiser la configuration de WooCommerce Bridge. Pour savoir comment faire, voir Réinitialiser la configuration.
2. Reprenez la configuration du bridge depuis le début. À la première étape, saisissez l'URL de votre boutique WooCommerce, en veillant à ce qu'elle corresponde exactement à votre site internet (attention à la présence ou non de www).
3. Poursuivez la configuration telle qu'elle est décrite dans Connexion à HubRise.

Voici la traduction en français :

Erreurs 422

Lorsque la synchronisation des commandes WooCommerce avec HubRise échoue, vous pouvez rencontrer une erreur 422 avec le corps de réponse suivant :

{  "message": "Validation failed",  "errors": [    {      "field": "/private_ref",      "message": "is already used ('21824' given)"    }  ],  "error_type": "unprocessable_entity"}

Cette erreur indique que l'ID de commande (private_ref) envoyé est déjà utilisé. Cela se produit généralement après une restauration de base de données dans WooCommerce, qui réinitialise la valeur d'auto-incrémentation de la table wp_posts, provoquant des ID en double pour les nouvelles commandes.

Suivez ces étapes pour résoudre le problème.

Étape 1 : Accéder à votre base de données

Vous devez avoir accès à votre base de données MySQL WooCommerce. Si vous n'avez pas phpMyAdmin ou un autre outil de base de données, vous pouvez utiliser une extension WordPress simple :

• Installez l'extension Run SQL Query.

Étape 2 : Ouvrir l'outil "Run SQL Query"

1. Dans votre panneau d'administration WordPress, allez dans Outils > Run SQL Query.
2. Cet outil vous permet d'exécuter des commandes SQL directement depuis votre tableau de bord WordPress.

L'interface devrait ressembler à ceci :

Étape 3 : Identifier la table wp_posts

Votre table des articles peut avoir un préfixe personnalisé. Recherchez une table se terminant par _posts. Par exemple, dans la capture d'écran ci-dessus, la table s'appelle mod488_posts.

Étape 4 : Trouver l'ID le plus élevé dans la table

Exécutez la requête SQL suivante pour trouver l'ID le plus élevé actuellement utilisé dans la table wp_posts. Remplacez mod488_posts par le nom réel de votre table :

SELECT id FROM mod488_posts ORDER BY id DESC LIMIT 1;

Cela retournera l'ID le plus élevé actuellement utilisé.

Étape 5 : Mettre à jour la valeur d'auto-incrémentation

Ajoutez 1 à l'ID le plus élevé et définissez la valeur AUTO_INCREMENT en conséquence. Par exemple, si l'ID le plus élevé est 22060, définissez la valeur d'auto-incrémentation à 22061.

Exécutez la commande SQL suivante, en remplaçant mod488_posts et 22061 par le nom réel de votre table et la nouvelle valeur d'auto-incrémentation :

ALTER TABLE `mod488_posts` AUTO_INCREMENT = 22061;

Étape 6 : Passer une commande test

Créez une nouvelle commande test dans WooCommerce et vérifiez qu'elle se synchronise correctement avec HubRise.

Si l'erreur 422 n'apparaît plus, le problème est résolu !

Besoin d'aide supplémentaire ?

Si vous rencontrez toujours des problèmes après avoir suivi ces étapes, n'hésitez pas à contacter support@hubrise.com pour obtenir de l'aide.