Ce que fait le bouton « Synchroniser le détail du grand livre FBA » dans Odoo

Ce qu'Odoo fait tout seul, sans rien cliquer

La tâche planifiée Amazon SP-API - Synchroniser le rapport détaillé du registre FBA (opt-in) (Amazon SP-API - Sync FBA ledger detail report (opt-in)) s'exécute une fois par jour et est active dès l'installation du module. Elle ne traite que les comptes actifs dont la synchronisation du détail est activée, et pour chacun elle lance la même synchronisation que le bouton.

Il y a des différences avec l'exécution manuelle : le résumé indique comme origine la tâche planifiée au lieu de manuel, il n'est pas publié dans le chatter du compte et, si un compte échoue, la tâche laisse un avertissement dans le journal du serveur et passe au suivant. Le bouton ne fait pas cette sélection de comptes : il travaille sur le compte où vous cliquez.

Le bouton existe dans les branches d'Odoo 17, 18, 19 et 20 et s'affiche toujours dans l'écran Comptes (Accounts), sans aucune condition.

Le cas de Casa Olivar : du menu au résumé

Exemple Cas illustratif : l'entreprise et ses chiffres sont inventés pour expliquer le flux.

Casa Olivar est une boutique fictive qui vend de l'huile et des conserves avec FBA et utilise le connecteur sur Odoo 20. Marta, de l'administration, a le droit Responsable et veut revoir l'historique des événements d'un compte sans attendre la tâche du jour.

1. Elle va dans Amazon › Configuration › Comptes (Amazon › Configuration › Accounts) et ouvre le compte.
2. Dans l'onglet Rapports FBA (opt-in) (FBA Reports (opt-in)), au sein du groupe Audit des demandes de remboursement (trouvez l'argent qu'Amazon vous doit) (Reimbursement Claim Audit (find money Amazon owes you)), se trouve la case Audit des remboursements FBA (FBA reimbursement audit), désactivée par défaut. Marta veut que la synchronisation passe aussi par l'audit des demandes du compte, donc elle l'active.
3. Elle clique sur Synchroniser le détail du grand livre FBA. L'action interroge Amazon, avec une pause entre deux requêtes, jusqu'à ce que le rapport se termine, échoue ou que les tentatives soient épuisées.
4. Quand elle se termine avec un résumé, le compte enregistre la date et le texte de l'exécution et publie ce résumé dans son chatter.
5. Si l'état du rapport indiqué dans le résumé n'est pas DONE, rien n'est importé lors de cette exécution et Marta peut la relancer plus tard. S'il est DONE mais qu'Amazon ne livre pas le document du rapport, le résumé l'indique et rien n'est importé non plus. S'il y a un document, le résumé ajoute combien de lignes contenait le rapport et combien ont été capturées, mises à jour ou ignorées.

Son collègue Íñigo n'a que le droit Lecteur : il ne voit pas les niveaux Configuration et Comptes du menu, donc il n'accède pas à cet écran.

Le lendemain, la tâche planifiée refait la même chose sans que personne ne clique, mais uniquement sur les comptes actifs dont la synchronisation du détail est activée.

Ce qu'il vérifie avant d'appeler Amazon

Le chemin Amazon › Configuration › Comptes a des droits par niveau : Amazon demande Lecteur, et Configuration comme Comptes demandent Responsable. Sans ce droit, vous ne voyez pas ces niveaux.

En cliquant sur le bouton, la première chose est une vérification sur le serveur : si vous n'êtes pas superutilisateur, vous devez avoir le droit Responsable (Manager) du connecteur ou celui des Paramètres. Ensuite, il vérifie que vous pouvez écrire sur ce compte. Le superutilisateur passe sans la vérification des groupes, et la tâche planifiée n'y passe pas non plus car elle appelle directement la synchronisation.

Ce qu'il fait en interne, dans l'ordre

1. Il vérifie les droits, comme vous venez de le voir.
2. Il travaille sur un seul compte.
3. Il demande à Amazon de créer le rapport de détail du registre FBA. Si Amazon ne renvoie pas l'identifiant du rapport, l'action s'arrête.
4. Il interroge l'état du rapport jusqu'à ce qu'il soit DONE, CANCELLED ou FATAL, ou jusqu'à épuisement des tentatives. Le nombre de tentatives et les secondes entre elles viennent du compte ; sans valeur, le code utilise douze tentatives avec dix secondes de pause.
5. Si le rapport ne passe pas à DONE, il enregistre la date et le résumé avec l'état dans lequel il est resté, le publie dans le chatter et termine sans rien importer.
6. S'il est DONE mais qu'Amazon ne fournit pas de document du rapport, il fait de même : résumé enregistré, rien d'importé et pas de décompte de lignes.
7. S'il y a un document, il le télécharge et le transmet à l'import de l'historique des événements du registre du compte.
8. Si Audit des remboursements FBA est activée, la synchronisation passe aussi par l'audit des demandes du compte.
9. Il enregistre la date et le résumé et publie le résumé dans le chatter.

Le résumé reprend le compte, l'origine (manuel si c'est vous qui le lancez), l'identifiant et l'état du rapport et, si l'import a lieu, le décompte des lignes, capturées, mises à jour et ignorées.

Ce qui change dans votre Odoo et ce qui ne change pas

• L'historique des événements du registre du compte s'accumule.
• Le compte enregistre la date et le résumé de la dernière exécution, et le chatter reçoit une note avec le résumé.
• Avec Audit des remboursements FBA activée, la synchronisation passe aussi par l'audit des demandes. Son aide indique qu'en l'activant, la synchronisation accumule aussi des événements de perte, de dommage et de retrouvé, et que l'audit les compare aux remboursements des règlements pour dégager les unités qu'Amazon doit encore, avec une valeur estimée et une date limite de réclamation. C'est une analyse en lecture seule.
• Selon le code lui-même, c'est une synchronisation indépendante qui ne touche pas au stock FBA : elle ne fait qu'accumuler un historique par événement pour l'audit des remboursements.

L'avertissement qui peut arrêter l'action

En cliquant sur Synchroniser le détail du grand livre FBA, cet avertissement peut apparaître : You need Amazon Seller Connector Manager (or Settings) access for this action. Ask a manager to grant Manager access.

Il apparaît quand vous n'êtes pas superutilisateur et que vous n'avez ni le droit Responsable du connecteur ni celui des Paramètres. Il se règle comme le dit le texte lui-même : demandez à un responsable de vous accorder l'accès Responsable.

Ce qu'il faut retenir du cas

• La tâche quotidienne synchronise les comptes actifs dont la synchronisation du détail est activée ; le bouton sert à la lancer à la main sur le compte que vous avez ouvert.
• Le droit est vérifié au clic, en plus de limiter le menu.
• L'état du rapport dans le résumé vous dit s'il y a eu import.
• La case Audit des remboursements FBA décide si la synchronisation passe aussi par l'audit des demandes.

Comment FlexigoTech vous aide

FlexigoTech met en place Odoo 17, 18, 19 et 20 et développe des connecteurs et des intégrations sur mesure. La page du module et sa fiche sur Odoo Apps donnent les détails d'achat. Le module est à paiement unique par version et nécessite l'abonnement à FlexigoTech Cloud, plan Connecteur (49 €/mois ou 490 €/an, HT). 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.

À lire aussi

Vérifié dans le code du connecteur (version 20.0) et dans les sources citées

Sources

• Code du module : flexigobe_amazon_seller_connector 20.0 (8576afa5): views/amazon_spapi_account_views.xml
• Code du module : flexigobe_amazon_seller_connector 20.0 (8576afa5): models/amazon_spapi_account.py
• apps.odoo.com/apps/modules/20.0/flexigobe_amazon_seller_connector
• flexigotech.com/precios.html
• flexigotech.com/en/services.html