Les champs de l'instance Mirakl dans Odoo : ce que signifie chacun et que saisir

Où se trouvent les champs et pourquoi certains ne s'affichent pas

• Ligne de livraison est masquée tant que l'instance n'a pas de produit de livraison.
• Produit de commission n'apparaît que lorsque Commission dans la commande client est sur Déduire la commission (net que vous recevez).
• Comptabiliser automatiquement la facture créée n'apparaît que si Créer automatiquement la facture à la validation de la livraison est activé.

Prix de la commande : livraison, remise et commission

• Aucune commission (total payé par le client) : le total est produit plus taxe, ce que paie le client. La commission n'est conservée dans la commande Mirakl qu'à titre informatif.
• Déduire la commission (net que vous recevez) : une ligne négative avec la commission est ajoutée en utilisant le Produit de commission, un produit de type service. Le total est produit plus taxe moins commission, le net que vous recevez.
• Prix d'achat de l'opérateur (l'opérateur vous achète) : pour les marketplaces où l'opérateur vous achète la marchandise et facture lui-même l'acheteur (GACD, par exemple). Chaque ligne prend le prix d'achat que Mirakl fournit pour elle et Odoo ajoute les taxes du produit, de sorte que la commande correspond au bon de commande de l'opérateur. La remise marketplace ne s'applique pas à ces lignes. Si Mirakl n'envoie pas de prix d'achat pour une ligne, cette ligne conserve le prix de l'acheteur et la remise, et une note est laissée dans la commande client et dans les journaux de Mirakl.

Le choix dépend du chiffre que vous voulez voir dans la commande : ce que paie le client, ce que vous encaissez net ou le bon de commande de l'opérateur.

Factures et rythme d'importation

• Automatique (Odoo décide) : avec un numéro fiscal, on obtient une F1 complète, et sans numéro fiscal une F2 simplifiée. C'est la valeur par défaut.
• Simplifiée avec numéro de TVA (F2 TicketBAI/VeriFACTU) : elle est émise simplifiée même si l'acheteur a un numéro fiscal. L'aide la considère valable pour le B2C au Pays basque (TicketBAI) ou lorsque votre conseiller fiscal indique que la F2 suffit.
• Complète (F1 TicketBAI/VeriFACTU) : elle est émise complète même si l'acheteur n'a pas de numéro fiscal, par exemple des clients étrangers qui l'exigent.

En cas de doute, consultez votre conseiller fiscal.

• Créer automatiquement la facture à la validation de la livraison : désactivé par défaut. Si vous l'activez, à la validation d'une livraison d'une commande Mirakl, la facture client est créée à partir de sa commande client. Elle respecte la politique de facturation (commandé ou livré) et ne bloque jamais la livraison si la facturation échoue.
• Comptabiliser automatiquement la facture créée : l'aide recommande de le laisser désactivé avec TicketBAI, VeriFACTU ou SII, car la comptabilisation est irréversible et envoie la facture électronique à l'administration fiscale. Les factures non positives restent en brouillon.
• Envoyer la facture à Mirakl : avec Manuel (avec un bouton), rien n'est envoyé tout seul, et l'aide l'indique comme recommandé, par exemple pour l'envoyer après avoir modifié le client ou le numéro fiscal. Avec Automatique (à la validation de la livraison), elle est envoyée à la validation de la livraison, uniquement si la facture est comptabilisée, et il faut que l'opérateur ait activé l'envoi de factures. Le renvoi remplace le document précédent dans Mirakl, sans doublons.

• Synchronisation des commandes activée, dans Politique de synchronisation et aussi dans la liste des instances : active l'importation planifiée des commandes pour cette instance. Par défaut, elle est désactivée.
• Fréquence de synchronisation des commandes (minutes), dans le groupe Windows : c'est le temps minimum entre deux importations de ce marketplace. L'action planifiée Mirakl - Synchroniser les commandes se réveille toutes les 10 minutes et traite l'instance lorsque ces minutes se sont écoulées. Avec 0, elle importe à chaque réveil et avec 60, toutes les heures.
• Filtrer les synchronisations par dernière mise à jour : demande à Mirakl ce qui a changé depuis la dernière synchronisation, et non ce qui a été créé. L'aide dit de le laisser activé, car avec le filtre par date de création, une commande créée le matin et expédiée l'après-midi est laissée de côté et son nouveau statut n'arrive pas dans Odoo. Ne le désactivez que si l'API de votre opérateur ignore ce filtre. L'importation initiale utilise toujours la date de création.

Ce qui se passe avec l'abonnement et comment nous vous aidons

Mirakl Connector est un paiement unique par version d'Odoo et nécessite l'abonnement à FlexigoTech Cloud, plan Connecteur : 49 €/mois ou 490 €/an HT, avec jusqu'à 3 comptes de la plateforme. La connexion passe par ce service, qui stocke les identifiants chiffrés et prévient par e-mail si la synchronisation échoue. Sans abonnement, ce que ce service apporte s'arrête, et les données restent dans votre Odoo. Vous pouvez consulter le module sur la fiche Odoo Apps ou sur la page du module.

Si vous êtes en train de déployer Odoo et souhaitez revoir ces champs avec nous avant d'activer la synchronisation, FlexigoTech déploie 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): models/mirakl_instance.py
• Code du module : flexigobe_mirakl_connector 20.0 (aa05e537): models/mirakl_ai.py
• apps.odoo.com/apps/modules/20.0/flexigobe_mirakl_connector
• flexigotech.com/en/services.html
• flexigotech.com/precios.html