Introduction
L’intégration entre Odoo et AntsRoute vous permet de transférer vos demandes de livraison afin d’optimiser automatiquement vos tournées.
Grâce à ce connecteur, vous pouvez :
- Envoyer vos livraisons depuis Odoo vers AntsRoute
- Planifier vos tournées plus efficacement
- Suivre l’état des livraisons directement depuis Odoo
👉 Cette intégration est disponible via le catalogue d’applications Odoo.
💡 Bon à savoir : les fonctionnalités pick-up & delivery sont également compatibles avec cette intégration.
Avant de commencer
Avant de commencer la configuration, assurez-vous :
- d’utiliser odoo.sh ;
- de disposer d’une version compatible d’Odoo : 13.0, 14.0, 15.0, 16.0, 17.0, 18.0 ou 19.0 ;
- d’avoir installé les modules Inventaire (Stock), Ventes et Facturation.
Étape 1 : Installer le module AntsRoute
- Ouvrez le module Applications
- Recherchez AntsRoute
- Cliquez sur Installer
👉 Le module est maintenant disponible dans votre environnement Odoo.
Étape 2 : Configurer un entrepôt
Cette étape permet de définir le point de départ de vos livraisons.
- Accédez au module Inventaire
- Cliquez sur Configuration > Entrepôts
- Cliquez sur Créer
- Renseignez :
- Nom de l’entrepôt
- Nom court (5 caractères maximum)
- Adresse (obligatoire)
- Horaires d’ouverture
- Cliquez sur Sauver
💡 Important : l’adresse correspond au lieu de chargement des marchandises.
Étape 3 : Créer une méthode d’expédition AntsRoute
3.1 Paramétrer la méthode
- Allez dans Inventaire > Configuration > Méthodes d’expédition
- Cliquez sur Créer
- Renseignez :
- Nom
- Transporteur
- Cochez Utiliser AntsRoute
- Ajoutez un article de livraison
💡 Vous pouvez définir un prix (forfait) fixe par transport ou basé sur des règles (poids, volume, quantité).
3.2 Ajouter la clé API AntsRoute
Récupérer la clé API :
- Connectez-vous à AntsRoute
- Cliquez sur votre profil (rond bleu en haut à droite)
- Ouvrez Intégrations
- Cliquez sur Clé API
- Cliquez sur « + » (Ajouter)
- Renseignez éventuellement un nom pour identifier cette clé
- Indiquez le site de rattachement
- Cliquez sur le bouton Créer
- Copiez la clé générée
- Cliquez sur le bouton Continuer pour confirmer
Ajouter la clé dans Odoo :
- Retournez dans Odoo
- Ouvrez l’onglet AntsRoute dans la méthode d’expédition
- Collez la clé API dans le champ prévu à cet effet
🔑 À quoi sert la clé API ?
Elle permet de connecter Odoo à AntsRoute de manière sécurisée.
3.3 Choisir le mode de planification
Dans la méthode d’expédition > AntsRoute > Destination de la demande dans AntsRoute, deux options sont disponibles :
- Organiser : la livraison est planifiée à une date précise
- Panier : la livraison est ajoutée avec une date d’échéance et sera planifiée plus tard
💡 Si vous utilisez la fonctionnalité Pick-up & Delivery, sélectionnez l’option « Pickup delivery activée » dans le champ Mode AntsRoute. Pour rappel, cette fonction permet de :
- Charger des marchandises à une adresse A,
- Puis les livrer à une adresse B,
- Ou revenir à l’entrepôt plusieurs fois dans la journée pour recharger leur véhicule.
3.4 Définir les paramètres de livraison
- Renseignez les informations suivantes :
- Durée moyenne de chargement à l’entrepôt
- Durée moyenne de déchargement chez un client
- Jours de livraison
- Début de plage horaire de l’entrepôt (heure à partir de laquelle un chargement peut être réalisé à l’entrepôt)
- Fin de plage horaire de l’entrepôt (heure jusqu’à laquelle un chargement peut être réalisé à l’entrepôt)
- Début de plage horaire de livraison client (heure à partir de laquelle une livraison peut être réalisée chez un client)
- Fin de plage horaire de livraison client (heure jusqu’à laquelle une livraison peut être réalisée chez un client)
- Puis cliquez sur Sauver
Étape 4 : Créer un devis avec livraison
4.1 Ajouter un client (optionnel)
- Allez dans Ventes > Commendes > Devis
- Cliquez sur Créer
- Sélectionnez un client.
Ou créez un nouveau client en suivant ces étapes :- Renseignez un nom dans le champ Client
- Cliquez sur Créer et modifier
- Renseignez :
- Adresse de livraison
- Numéro de téléphone mobile
- Cliquez sur Sauver
4.2 Ajouter des produits
- Cliquez sur Lignes de commande
- Ajoutez les produits à livrer
4.3 Ajouter la livraison
- Cliquez sur Ajouter une expédition
- Sélectionnez la méthode d’expédition AntsRoute créée au cours de l’étape 3
- Cliquez sur Ajouter, puis Confirmer
Étape 5 : Envoyer la livraison vers AntsRoute
5.1 Configurer les capacités dans AntsRoute
Les capacités permettent d’optimiser le chargement des véhicules.
Créez ces 3 capacités :
- Number (nombre d’articles)
- Weight (poids en kg)
- Volume (volume en m³)
Pour les configurer :
- Rendez-vous dans le module Paramètres
- Cliquez sur l’onglet Capacités
- Cliquez sur le bouton « + » (Ajouter)
Ajouter la capacité Number
Renseignez les informations suivantes :
- Nom : Number
- Unité : Unit
- Mode de validation : optionnel
Puis cliquez sur Sauvegarder.
Ajouter la capacité Weight
Répétez l’opération avec les informations suivantes :
- Nom : Weight
- Unité : Kg
- Mode de validation : optionnel
Ajouter la capacité Volume
Répétez une dernière fois avec :
- Nom : Volume
- Unité : m3
- Mode de validation : optionnel
💡 Bon à savoir : ces capacités sont utilisées par AntsRoute pour répartir les livraisons en fonction des contraintes de vos véhicules (poids, volume, nombre de colis).
5.2 Renseigner les capacités des véhicules
- Allez dans Ressources
- Cliquez sur l'onglet Véhicules
- Pour chacun des véhicules, cliquez sur ... > Modifier
- Renseignez les capacités maximales du véhicule pour les éléments suivants :
- Number
- Weight
- Volume
- Sauvegardez
5.3 Créer des champs personnalisés
Pour récupérer certaines informations depuis Odoo dans AntsRoute, vous devez créer des champs personnalisés.
Les champs à ajouter sont :
- Price
- Description
- Reference
👉 Ces champs permettent de faire remonter automatiquement les informations liées aux commandes Odoo.
Avant d’ajouter des champs, vous devez créer une catégorie :
- Rendez-vous dans le module Paramètres
- Cliquez sur l’onglet Champs personnalisés
- Sélectionnez l’onglet Livraison
- Cliquez sur le bouton « Ajouter une catégorie »
- Renseignez un Nom (exemple : Champs Odoo)
- Cliquez sur Sauvegarder
Vous pouvez maintenant créer vos champs.
Ajouter le champ Price
- Cliquez sur Ajouter un champ
- Renseignez :
- Nom : Price
- Catégorie : sélectionnez la catégorie créée précédemment
- Type : Champ texte
- Puis cliquez sur Sauvegarder.
Ajouter le champ Description
Répétez les mêmes étapes avec :
- Nom : Description
- Type : Champ texte
Ajouter le champ Reference
Répétez une dernière fois avec :
- Nom : Reference
- Type : Champ texte
💡 Bon à savoir : une fois ces champs configurés, les informations correspondantes seront automatiquement visibles dans vos livraisons AntsRoute.
5.4 Définir les quantités à livrer
- Ouvrez la livraison dans Odoo
- Cliquez sur Éditer
- Sélectionnez l’onglet Opérations
- Indiquez les quantités d’article à livrer le champ Fait
- Cliquez sur Sauver
5.5 Envoyer la livraison
Cliquez sur Demander l’enlèvement
👉 La livraison est automatiquement envoyée dans AntsRoute.
Informations disponibles dans AntsRoute
Une fois la livraison envoyée depuis Odoo vers AntsRoute, plusieurs informations sont automatiquement transmises et visibles :
- Reference : correspond à la référence Odoo, incluant le numéro de devis et le bon de livraison
- Description : correspond à la référence de l’article dans Odoo (ou au nom de l’article si aucune référence n’est renseignée)
- Price : correspond au prix de la commande
- Weight : indique le poids total des articles à livrer (nombre entier positif)
- Number : indique le nombre d’articles à livrer
👉 Ces informations facilitent le suivi des livraisons et permettent aux équipes terrain de disposer de toutes les données nécessaires.
Étape 6 : Suivre l’état des livraisons
Depuis Odoo :
- Cliquez sur Commandes > Commandes
- Ouvrez une commande
- Cliquez sur Livraison
- Accédez à l’onglet Informations AntsRoute
- Cliquez sur Mise à jour information de livraison
Vous pouvez consulter :
- Date de livraison
- Statut
- Chauffeur assigné
- Signature du client (ajoutée via l’app)
- Photos (ajoutées via l’app)
- Commentaires (ajoutés via l’app)
💡 Les photos de la livraison sont accessibles sur Odoo via les pièces jointes.
Synchronisation des données
Vous pouvez modifier la fréquence de synchronisation :
- Allez dans Configuration > Paramètres généraux
- Cliquez sur Activer le mode développeur
- Cliquez sur Configuration
- Accédez à Technique > Actions planifiées
- Ouvrez AntsRoute – Mise à jour des informations
- Modifiez la fréquence via Editer (en haut à gauche) et « Définir tous les … jours »
- Cliquez sur Sauver
Conclusion
L’intégration entre Odoo et AntsRoute vous permet de gérer vos livraisons de manière fluide, depuis la création du devis jusqu’au suivi final.
Une fois configurée, elle vous aide à :
- Gagner du temps sur la planification
- Réduire les erreurs manuelles
- Améliorer le suivi des livraisons
👉 Si vous rencontrez des difficultés, vérifiez en priorité :
- La clé API
- Les capacités configurées
- Les informations d’adresse
🙋♀️ Besoin d’aide ?
Si vous rencontrez des difficultés pour configurer votre intégration avec Odoo, vous pouvez contacter le support AntsRoute :
- Par email
- Ou via le chat accessible directement depuis votre interface web.