Ce mode de fonctionnement du plugin WooCommerce by AntsRoute permet d’envoyer les commandes WooCommerce manuellement ou automatiquement vers AntsRoute. Vos clients n’ont pas la possibilité de choisir une date et un créneau horaire de livraison.
Voici les étapes à suivre pour paramétrer le plugin :
- Étape 1 - Installer l’extension AntsRoute sur WordPress
- Étape 2 - Gérer les capacités des véhicules sur AntsRoute
- Étape 3 - Récupérer une clé API sur AntsRoute
- Étape 4 - Paramétrer le plugin WooCommerce by AntsRoute sur WordPress
- Étape 5 - Remonter le statut des livraisons AntsRoute vers WooCommerce grâce aux webhooks
- Étape 6 - Gérer les champs personnalisés sur AntsRoute
Étape 1 - Installer l’extension AntsRoute sur WordPress
Pour commencer, vous devez installer le plugin « WooCommerce Local Delivery Date Picker & Time Slots by AntsRoute » sur votre site WordPress. Pour cela, vous devez suivre les étapes ci-dessous :
- Récupérez le fichier de l'intégration « WooCommerce Local Delivery Date Picker & Time Slots by AntsRoute » en nous contactant par e-mail ou directement depuis la marketplace de WooCommerce.
- Connectez-vous à votre compte WordPress.
- Rendez-vous dans « Extensions » > « Ajouter ».
- Cliquez sur le bouton « Téléverser une extension ».
- Cliquez sur le bouton « Choisir un fichier » et sélectionnez le fichier à installer.
- Dès que le nom du fichier s’affiche, cliquez sur le bouton « Installer maintenant ».
- Cliquez sur le bouton « Activer l’extension ».
Étape 2 - Gérer les capacités des véhicules sur AntsRoute
Les capacités « Number » et « Weight » doivent être créées sur votre compte AntsRoute. Ces capacités permettent de gérer les quantités (nombre d’articles et poids) que chacun de vos véhicules peut transporter au cours d’une tournée.
1. Créer les capacités « Number » et « Weight »
Pour commencer, vous devez créer ces deux capacités depuis les paramètres en suivant ces quelques étapes :
- Rendez-vous dans le module « Paramètres ».
- Cliquez sur l’onglet « Capacités ».
- Cliquez sur le bouton « Ajouter ».
- Renseignez la première capacité « Number » :
- Number (Nom) ;
- Unité (Unité) ;
- Optionnel (Mode de validation).
- Cliquez sur le bouton « Sauvegarder ».
- Cliquez de nouveau sur le bouton « Ajouter » pour créer la seconde capacité « Weight ».
- Renseignez la seconde capacité « Weight » :
- Weight (Nom) ;
- Kg (Unité) ;
- Optionnel (Mode de validation).
- Cliquez sur le bouton « Sauvegarder ».
💡 Respecter l’utilisation des majuscules et des minuscules pour Number et Weight pour permettre la synchronisation des données entre AntsRoute et WooCommerce.
2. Déterminer les capacités des véhicules
Dès que vous avez créé les capacités, vous devez indiquer les quantités qui peuvent être transportées par chacun de vos véhicules.
- Rendez-vous dans le module « Ressources ».
- Cliquez sur l’onglet « Véhicules ».
- Pour le premier véhicule, cliquez sur « … » et « Modifier ».
- Déterminez la quantité « Number » qui peut être transportée par le véhicule.
- Déterminez la quantité « Weight » qui peut être transportée par le véhicule.
- Cliquez sur le bouton « Sauvegarder ».
- Cliquez sur le bouton « Confirmer ».
- Répétez ces quelques étapes pour chacun des véhicules.
Étape 3 - Récupérer une clé API sur AntsRoute
Depuis votre compte AntsRoute, vous devez récupérer une clé API qui vous sera demandée par la suite lors du paramétrage du plugin WooCommerce by AntsRoute. Pour cela, vous devez suivre ces quelques étapes :
- Cliquez sur le rond bleu en haut à droite.
- Cliquez sur l'onglet « Intégrations ».
- Cliquez sur « Clés d’API ».
- Cliquez sur le bouton « + ».
- Déterminez un « Nom » pour cette clé.
- Sélectionnez l'entrepôt pour lequel générer une clé d’API.
- Cliquez sur le bouton « Créer ».
- Cliquez sur « Copier ».
- Cliquez sur le bouton « Continuer ».
💡 Nous vous demanderons de renseigner cette clé API au cours de la prochaine étape. D’ici là, vous pouvez la conserver dans un fichier texte.
Étape 4 - Paramétrer le plugin WooCommerce by AntsRoute sur WordPress
Afin de paramétrer le plugin WooCommerce by AntsRoute, vous devez vous connecter sur WordPress et suivre ces quelques étapes :
- Rendez-vous dans l’onglet « WooCommerce » > « AntsRoute ».
- Cliquez sur « Paramètres ».
- Choisissez l’option « Ne pas permettre aux clients de choisir la date et le créneau horaire ».
- Choisissez une « Zone et méthode d’expédition » que vous avez défini dans les paramètres de WooCommerce.
- Entrez la « Clé API du site AntsRoute » que vous avez récupéré au cours de l’étape précédente.
- Choisissez le « Déclencheur de l’envoi d’une commande sur AntsRoute ». Par exemple, si vous choisissez l’option « Attente de paiement », dès que la commande passe à l’état « Attente de paiement » sur WooCommerce, la livraison est envoyée sur AntsRoute.
- Choisissez le « Déclencheur de l’annulation d’une commande sur AntsRoute ». Par exemple, si vous choisissez l’option « Remboursée », dès que la commande passe à l’état « remboursée » sur WooCommerce, la livraison est annulée sur AntsRoute.
- Sélectionner le module où « Envoyer la commande ».
- Sélectionnez les « Jours et heures de livraison », c’est-à-dire les jours et heures d’ouverture de votre entreprise.
- Indiquez la « Date limite de livraison », c’est-à-dire le nombre de jours ouvrables entre la date de création de la commande dans WooCommerce et la date de livraison dans AntsRoute. Par exemple, « 0 » correspond à une livraison pour le jour même ; « 1 » correspond à une livraison pour le lendemain ; « 2 » correspond à une livraison à J+2 ; etc.
- Si vous avez choisi une date limite de livraison correspondant à « 0 » ou « 1 », vous pouvez déterminer une « Heure limite de livraison », c’est-à-dire l’heure à partir de laquelle il n’est plus possible de planifier une livraison. Par exemple, si vous choisissez une heure limite de livraison correspondant à 18:00, vous ne pouvez plus planifier une livraison pour le jour-même (ou pour le lendemain) jusqu’à 18h.
- Déterminez la « Durée de livraison » par défaut, c’est-a-dire le temps nécessaire pour que votre chauffeur-livreur sorte la marchandise du véhicule et la remette au client.
- Indiquez si nécessaire les « Jours de congés et jours fériés » au format aaaa-mm-jj. Par exemple, 2022-11-11.
- Cliquez sur le bouton « Sauvegarder ».
💡 Si vos chauffeurs effectuent plusieurs retours au dépôt au cours de leurs tournées afin de recharger leurs véhicules, vous devez activer l’option de « Pick-up & Delivery ». Lors de l’activation de cette option, d’autres champs devront être renseignés : Nom de l’entrepôt ; Adresse de l’entrepôt ; Temps de chargement ; Créneaux horaires de chargement.
Étape 5 - Remonter le statut des livraisons AntsRoute vers WooCommerce grâce aux webhooks
Nous disposons également de Webhooks sur AntsRoute qui permettent d’envoyer le statut des livraisons vers WooCommerce. Voici les quelques étapes à suivre pour paramétrer les webhooks :
- Rendez-vous sur WordPress > WooCommerce > AntsRoute.
- Cliquez sur l’onglet « Webhook ».
- Copiez l’URL.
- Rendez-vous sur votre compte AntsRoute.
- Cliquez sur le rond bleu en haut à droite.
- Cliquez sur l’onglet « Intégrations ».
- Cliquez sur l’onglet « Webhooks ».
- Cliquez sur le bouton « + ».
- Déterminez un « Nom » pour ce webhook.
- Collez « l’Adresse URL » que vous avez récupéré précédemment.
- Choisissez le « Mode d’authentification » « Aucun ».
- Sélectionnez les « Événements à envoyer » :
- Livraison réalisée ;
- Livraison annulée ;
- Livraison supprimée ;
- Livraison verrouillée.
- Sélectionnez votre « Entrepôt ».
- Cliquez sur le bouton « Sauvegarder ».
Dès que c’est fait, vous pouvez vous rendre dans WordPress > WooCommerce > Commandes afin de visualiser le statut de chaque livraison.
Étape 6 - Gérer les champs personnalisés sur AntsRoute
La création de champs personnalisés permet de remonter des informations depuis WooCommerce vers AntsRoute. Par exemple, la description et le prix des articles, la méthode de paiement, etc.
1. Créer une nouvelle catégorie
La création d’une catégorie vous permet de regrouper des champs personnalisés pour faciliter la lecture des informations. Par exemple, une catégorie « Champs personnalisés » ou « Champs WooCommerce ».
💡 La création des champs personnalisés est optionnelle. Si vous créez ces champs personnalisés, assurez-vous d'utiliser exactement le même nom.
- Rendez-vous dans le module « Paramètres ».
- Cliquez sur l’onglet « Champs personnalisés ».
- Cliquez sur l’onglet « Livraison ».
- Cliquez sur le bouton « Ajouter une catégorie ».
- Renseignez un « Nom » pour cette catégorie.
- Cliquez sur le bouton « Sauvegarder ».
💡 Lors de la création des champs personnalisés présentés ci-dessous, vous devrez les classer dans la catégorie que vous venez de créer.
2. Ajouter le champ personnalisé « Price »
- Cliquez sur le bouton « Ajouter un champ ».
- Indiquez le nom « Price ».
- Pour le type de champ, choisissez l’option « Champ texte ».
- Cliquez sur le bouton « Sauvegarder ».
3. Ajouter le champ personnalisé « Description »
- Cliquez sur le bouton « Ajouter un champ ».
- Indiquez le nom « Description ».
- Pour le type de champ, choisissez l’option « Champ texte ».
- Cliquez sur le bouton « Sauvegarder ».
4. Ajouter le champ personnalisé « Payment method »
- Cliquez sur le bouton « Ajouter un champ ».
- Indiquez le nom « Payment method ».
- Pour le type de champ, choisissez l’option « Champ texte ».
- Cliquez sur le bouton « Sauvegarder ».
5. Ajouter le champ personnalisé « Currency »
- Cliquez sur le bouton « Ajouter un champ ».
- Indiquez le nom « Currency ».
- Pour le type de champ, choisissez l’option « Champ texte ».
- Cliquez sur le bouton « Sauvegarder ».
6. Ajouter le champ personnalisé « Paid »
- Cliquez sur le bouton « Ajouter un champ ».
- Indiquez le nom « Paid ».
- Pour le type de champ, choisissez l’option « Champ liste ».
- Ajoutez les options « true » and « false ».
- Cliquez sur le bouton « Sauvegarder ».