Quand le bouton s'affiche et ce que fait Odoo sans que vous cliquiez
Faut-il cliquer sur le bouton pour que la facture arrive chez Mirakl ?
Pas toujours. Le module étend le bouton standard de validation du bon de livraison et, en validant la livraison, il peut aussi téléverser la facture tout seul, à condition que l'instance ait l'envoi des factures en mode automatique et que le bon de livraison n'ait pas encore de date de téléversement. Le bouton sert à la téléverser à la main. Par ailleurs, la case Créer automatiquement la facture à la validation de la livraison (Auto-create invoice on delivery validation) fait que, à la validation d'une livraison d'une commande Mirakl, la facture client est créée à partir de sa commande de vente. Vous la trouvez dans la fiche des Instances Mirakl (Mirakl Instances), onglet Commandes et retours (Orders and Returns), groupe Passerelle de ventes (Sales Bridge), et elle est désactivée par défaut. Selon son aide, elle respecte la politique de facturation (commande ou livré) et ne bloque jamais la livraison si la facturation échoue.
Quand le bouton apparaît-il et pourquoi peut-il manquer sur un bon de livraison ?
Il se trouve sur la fiche du bon de livraison (transfert d'Inventaire). Il est masqué quand le bon de livraison ne correspond pas à une commande Mirakl ou quand son état n'est pas Terminé. Autrement dit : vous ne le voyez que si le bon de livraison provient d'une commande Mirakl et est à l'état Terminé. La donnée Est une commande Mirakl (Is Mirakl Order) ne figure dans aucune vue, il n'y a donc pas de case à vérifier ; ce que vous pouvez contrôler, c'est l'état du bon de livraison. La condition est la même dans Odoo 17, 18, 19 et 20.

Ce qu'il fait au clic, pas à pas
Que fait exactement le bouton ?
Le code parcourt les bons de livraison concernés et ne retient que ceux qui proviennent d'une commande Mirakl. Pour chacun, il cherche l'instance Mirakl de la commande de vente à laquelle il est lié. Si le bon de livraison n'a pas de commande de vente, il n'y a pas d'instance et le bouton passe son chemin sans rien faire. S'il y en a une, il demande à l'instance de téléverser la facture ; d'après le code du module lui-même, ce qui est téléversé est le PDF de la facture comptabilisée. Si le téléversement réussit, le module enregistre la date et l'heure du téléversement sur le bon de livraison et y laisse une note.

Téléverser la facture vers Mirakl), présent dans Odoo 17, 18, 19 et 20.Qu'est-ce qui change sur le bon de livraison si tout se passe bien ?
Deux choses : la date et l'heure du téléversement sont enregistrées, et la note Mirakl : facture téléversée vers la place de marché. apparaît sur le bon de livraison. Le chemin automatique ne téléverse que si cette date est vide.
Que se passe-t-il si le téléversement échoue ?
Avec le bouton, l'erreur est relancée : vous la voyez à l'écran, l'action s'arrête et ce qui devait changer n'est pas enregistré, c'est-à-dire qu'aucune date de téléversement n'est conservée. Si c'est FlexigoTech Cloud qui ne laisse pas passer l'opération, rien n'est téléversé ni marqué, afin de pouvoir l'envoyer plus tard, et le bouton affiche aussi l'erreur. Dans le chemin automatique, en revanche, l'erreur n'est pas relancée : face à un échec ordinaire, le module laisse sur le bon de livraison une note avec l'erreur et la date n'est pas marquée ; si c'est FlexigoTech Cloud qui ne laisse pas passer l'opération, rien n'est marqué non plus. Le texte précis de l'erreur dépend de ce que répond le téléversement et n'est pas fixé par le bouton.
Puis-je cliquer si la facture a déjà été téléversée ?
Au clic, le bouton ne vérifie pas lui-même s'il existe déjà une date de téléversement, alors que le chemin automatique exige qu'elle soit vide. Avant de la renvoyer à la main, vérifiez dans les notes du bon de livraison si Mirakl : facture téléversée vers la place de marché. y figure déjà.
Versions, abonnement et aide
Le bouton est-il présent dans ma version d'Odoo ?
Oui : le module est publié sur Odoo Apps pour Odoo 17, 18, 19 et 20, et le bouton est sur le bon de livraison dans les quatre branches. Le parcours pas à pas ci-dessus provient du code d'Odoo 20.0. Avec Odoo en français, le bouton s'appelle Téléverser la facture vers Mirakl.

De quoi a-t-il besoin pour fonctionner et combien coûte-t-il ?
Le module s'achète en paiement unique par version d'Odoo (le prix de chaque version figure sur la fiche Odoo Apps et sur la page du module) et nécessite l'abonnement à FlexigoTech Cloud, plan Conector : 49 €/mois ou 490 €/an HT, avec jusqu'à 3 comptes de la plateforme. La connexion passe par FlexigoTech Cloud, qui conserve les identifiants chiffrés, surveille la synchronisation et prévient par e-mail en cas d'échec. Sans abonnement, ou avec le service suspendu, ce qu'apporte l'abonnement s'arrête ; les données restent dans votre Odoo. Avec l'abonnement, le module pour les nouvelles versions d'Odoo est inclus si vous l'avez acheté sur flexigotech.com ; sur l'Odoo App Store, chaque version s'y achète.
Pouvez-vous m'aider à le mettre en place ?
FlexigoTech implante Odoo 17, 18, 19 et 20 et développe des connecteurs et des intégrations sur mesure.
À lire aussi
Vérifié dans le code du connecteur (version 20.0) et dans les sources citées
Sources
- Code du module : flexigobe_mirakl_connector 20.0 (aa05e537): views/stock_picking_views.xml
- Code du module : flexigobe_mirakl_connector 20.0 (aa05e537): models/stock_picking.py
- Code du module : flexigobe_mirakl_connector 20.0 (aa05e537): models/mirakl_instance.py
- apps.odoo.com/apps/modules/20.0/flexigobe_mirakl_connector
- flexigotech.com/precios.html
- flexigotech.com/en/services.html
