Ce mode de fonctionnement du plugin WooCommerce by AntsRoute permet à vos clients de choisir une date et un créneau horaire de livraison avant de procéder au paiement avec vérification préalable de la disponibilité et envoi automatique des commandes vers AntsRoute.
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 - Personnaliser l’affichage du plugin WooCommerce by AntsRoute
- Étape 7 - 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
Au cours de cette étape, vous pouvez choisir de vérifier la disponibilité au moment du choix du créneau horaire de livraison par le client ou d'envoyer directement la commande vers AntsRoute sans vérifier les disponibilités.
Méthode n°1 - Vérifier la disponibilité dans AntsRoute
En choisissant cette première option, vous acceptez que vos clients puissent directement rechercher des disponibilités pour la livraison de leur commande dans votre planning. Les disponibilités présentées aux clients seront valables pendant une durée limitée.
Cette durée de validité des disponibilités peut être configurée depuis votre compte AntsRoute > Paramètres > Paramètres > Paramètres d’optimisation.
Dès qu’une disponibilité est validée, c’est-a-dire dès que le client valide la date et le créneau horaire sélectionné, toutes les autres disponibilités qui été affichées sont libérées.
- Rendez-vous dans l’onglet « WooCommerce » > « AntsRoute ».
- Cliquez sur « Paramètres ».
- Choisissez l’option « 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’annulation d’une livraison dans 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.
- Activez « Vérifier la disponibilité dans AntsRoute » en choisissant l’option « Oui ».
- Déterminez jusqu’à quatre « Créneaux horaires de livraison » qui seront présentés à vos clients au moment de la planification.
- Sélectionnez les « Jours de livraison » qui seront présentés à vos clients.
- Indiquez la « Date d’ouverture minimum du calendrier », c’est-à-dire la date à partir de laquelle peut être planifiée la livraison. Par exemple, « 0 » permet de planifier une livraison pour le jour même ; « 1 » permet de planifier une livraison pour le lendemain ; « 2 » permet de planifier une livraison à J+2 ; etc.
- Si vous avez choisi une date d’ouverture minimum du calendrier correspondant à « 0 » ou « 1 », vous pouvez déterminer une « Heure limite de livraison », c’est-à-dire l’heure à partir de laquelle vos clients ne pourront plus planifier de livraison. Par exemple, si vous choisissez une heure limite de livraison correspondant à 18:00, vos clients peuvent planifier une livraison pour le jour-même (ou pour le lendemain) jusqu’à 18h.
- Si vous avez choisi une date d’ouverture minimum du calendrier correspondant à « 0 », vous pouvez déterminer une « Durée minimale avant le créneau de livraison », c’est-à-dire une durée en minutes avant le créneau horaire à partir de laquelle il n'est plus possible de programmer la livraison pour le jour même. Par exemple, si vous définissez 30 minutes et que votre client choisit le créneau horaire de livraison 10h00 - 12h00, le client peut programmer la livraison pour le même jour jusqu'à 9h30.
- Déterminez la « Date maximale pouvant être sélectionnée », c’est-à-dire la date jusqu’à laquelle vos clients peuvent planifier une livraison au moment de la commande. Par exemple, si vous indiquez une date maximale de 10 jours et que votre client effectue sa commande le 10 avril 2022, il peut planifier sa livraison jusqu’au 20 avril 2022.
- Déterminez la « Durée de livraison » par défaut, c’est-a-dire le temps nécessaire en minutes 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 ».
Méthode n°2 - Ne pas vérifier la disponibilité dans AntsRoute
En choisissant cette seconde option, vous ne vérifiez pas les disponibilités au moment de la planification des livraisons par vos clients. En revanche, vous pouvez choisir le module vers lequel sont envoyées les livraisons : « Organiser » ou « Panier des livraisons ».
- Rendez-vous dans l’onglet « WooCommerce » > « AntsRoute ».
- Cliquez sur « Paramètres ».
- Choisissez l’option « 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’annulation d’une livraison 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.
- Désactivez « Vérifier la disponibilité dans AntsRoute » en choisissant l’option « Non ».
- Sélectionner le module où « Envoyer la commande ».
- Déterminez les « Créneaux horaires de livraison » qui seront présentés à vos clients au moment de la planification.
- Sélectionnez les « Jours de livraison » qui seront présentés à vos clients.
- Indiquez la « Date d’ouverture minimum du calendrier », c’est-à-dire la date à partir de laquelle peut être planifiée la livraison. Par exemple, « 0 » permet de planifier une livraison pour le jour même ; « 1 » permet de planifier une livraison pour le lendemain ; « 2 » permet de planifier une livraison à J+2 ; etc.
- Si vous avez choisi une date d’ouverture minimum du calendrier correspondant à « 0 » ou « 1 », vous pouvez déterminer une « Heure limite de livraison », c’est-à-dire l’heure à partir de laquelle vos clients ne pourront plus planifier de livraison. Par exemple, si vous choisissez une heure limite de livraison correspondant à 18:00, vos clients peuvent planifier une livraison pour le jour-même (ou pour le lendemain) jusqu’à 18h.
- Si vous avez choisi une date d’ouverture minimum du calendrier correspondant à « 0 », vous pouvez déterminer une « Durée minimale avant le créneau de livraison », c’est-à-dire une durée en minutes avant le créneau horaire à partir de laquelle il n'est plus possible de programmer la livraison pour le jour même. Par exemple, si vous définissez 30 minutes et que votre client choisit le créneau horaire de livraison 10h00 - 12h00, le client peut programmer la livraison pour le même jour jusqu'à 9h30.
- Déterminez la « Date maximale pouvant être sélectionnée », c’est-à-dire la date jusqu’à laquelle vos clients peuvent planifier une livraison au moment de la commande. Par exemple, si vous indiquez une date maximale de 10 jours et que votre client effectue sa commande le 10 avril 2022, il peut planifier sa livraison jusqu’au 20 avril 2022.
- 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 - Personnaliser l’affichage du plugin WooCommerce by AntsRoute
L’affichage du plugin WooCommerce by AntsRoute peut être personnalisé pour correspondre à votre image. Afin de personnaliser l’affichage du calendrier qui permet à vos clients de sélectionner la date et le créneau horaire de livraison, vous devez vous rendre dans WordPress > WooCommerce > AntsRoute > Personnalisation.
Voici les éléments qui peuvent être personnalisés :
- En-tête du champ ;
- Position du champ - c’est-à-dire l’endroit où doivent figurer les champs de sélection de la date et du créneau horaire ;
- Priorité du champ - c’est-à-dire la priorité du plugin WooCommerce by AntsRoute par rapport aux autres plugins ;
- Libellé du champ de la date - par exemple : « date de livraison préférée » ;
- Description du champ de la date ;
- La semaine commence le - c’est-à-dire le jour de la semaine à afficher en premier dans le calendrier ;
- Format de la date - aa-mm-jj ou aa/mm/jj ;
- Libellé des créneaux horaires - par exemple : « créneau horaire de livraison souhaité » ;
- Description des créneaux horaires ;
- Format des créneaux horaires - g:i a (par exemple : 3:00 - 5:00) ou H:i (par exemple : 15:00 - 17:00).
Étape 7 - 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.
💡 La création des champs personnalisés est optionnel. Si vous crééz ces champs personnalisés, assurez-vous d'utiliser exactement le même nom.
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 ».
- 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 »
💡 Si vous utilisez la "Méthode n°1 - Vérifier la disponibilité dans AntsRoute", le champ personnalisé "Payment method" ne fonctionne pas.
- 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 »
💡 Si vous utilisez la "Méthode n°1 - Vérifier la disponibilité dans AntsRoute", le champ personnalisé "Paid" ne fonctionne pas.
- 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 ».