Tâche « Amazon SP-API - Demander un avis » d'Amazon Connector pour Odoo

Ce que fait cette tâche et où elle s'intègre

La tâche planifiée Amazon SP-API - Demander un avis (Amazon SP-API - Request a Review) parcourt les commandes Amazon déjà expédiées et demande à Amazon de solliciter l'avis de l'acheteur, mais seulement lorsqu'Amazon indique que cette commande l'admet. Elle existe dans les branches 17.0, 18.0, 19.0 et 20.0, elle est active à l'installation du module et s'exécute toutes les deux heures. Dans Odoo 17.0, la tâche est en outre configurée avec une répétition sans fin. Tout ce qui suit sur l'ordre de travail décrit le code d'Odoo 20.0.

Les commandes qu'elle examine sont celles que vous voyez dans le menu Amazon › Commandes (Amazon › Orders), qui ouvre les fiches de Commandes Amazon (Amazon Orders). Le niveau Amazon comme le niveau Commandes exigent le droit Lecteur (Viewer) ; si vous ne l'avez pas, vous ne voyez pas ce niveau du menu. Dans la fiche de la commande, le champ Compte (Account) indique à quel compte Amazon elle appartient et Commande Amazon (Amazon Order) affiche l'identifiant de la commande, en lecture seule.

Chronologie d'un passage

Voici ce qui se passe, dans l'ordre, depuis l'installation jusqu'à la fin d'un passage de la tâche.

1. À l'installation du module La tâche est créée et active, prête à s'exécuter toutes les deux heures.

1. Toutes les deux heures Odoo lance la tâche. Chaque passage travaille avec un plafond de 100 commandes au maximum.

1. D'abord, les comptes Elle cherche les comptes Amazon qui ont activé la demande d'avis. Si aucun ne l'a activée, le passage s'arrête là, sans examiner la moindre commande.

1. Ensuite, la fenêtre d'ancienneté Pour chaque compte, elle calcule un minimum et un maximum de jours. Si ces valeurs sont vides, le code utilise 5 et 30 jours. La commande est mesurée par sa date de dernière mise à jour ou, à défaut, par sa date d'achat : elle doit être au moins aussi ancienne que le minimum et ne pas dépasser le maximum (le code ajoute un jour de marge).

1. Choix des candidates Elle prend les commandes déjà expédiées qui n'ont pas encore de date de demande d'avis et qui tombent dans la fenêtre de leur compte. Elle les trie par la date de leur dernière vérification, les jamais vérifiées en premier, et garde les premières, jusqu'au plafond. Celles qu'Amazon a refusées ou qui ont donné une erreur passent en fin de file.

1. Commande par commande : filtres préalables Pour chaque candidate, la tâche revérifie que le compte a l'option activée et que la commande n'a pas déjà de date de demande, et effectue en plus une vérification d'éligibilité propre au module. Si l'une échoue, elle passe à la commande suivante sans rien demander et sans interroger Amazon.

1. Interrogation d'Amazon Si la commande franchit ces filtres, elle demande à Amazon quelles actions de sollicitation elle admet, via l'API Solicitations.

1. Si Amazon ne propose pas l'avis Rien n'est envoyé et la commande est notée comme vérifiée lors de ce passage. Elle restera candidate aux passages suivants tant qu'elle est dans la fenêtre, mais derrière celles qui n'ont jamais été vérifiées.

1. Si Amazon le propose La tâche crée la demande d'avis. Une fois terminée avec succès, la commande reçoit sa date de demande.

1. Si quelque chose échoue sur une commande La tâche laisse un avertissement dans le journal du serveur avec le numéro de la commande et poursuit avec la suivante. Un échec sur une commande n'interrompt pas le passage.

1. À la fin Le passage se termine et, deux heures plus tard, un autre commence. Une commande avec une date de demande n'est plus redemandée : le code l'écarte aussi bien lors du choix des candidates qu'avant d'interroger Amazon.

Que vérifier si elle ne fait rien

Si les heures passent et qu'aucune commande ne reçoit de demande, passez en revue ces points un à un.

• La tâche est toujours active. Elle est active à l'installation et s'exécute toutes les deux heures ; si elle est désactivée, il n'y aura aucun passage.
• Un compte a la demande d'avis activée. La tâche ne travaille qu'avec les comptes Amazon qui ont activé cette option. Sans aucun compte avec l'option activée, le passage se termine sans toucher aux commandes.
• La commande est déjà expédiée. Les commandes qui ne sont pas dans cet état ne sont pas candidates.
• La commande n'a pas encore de date de demande. Si l'avis a déjà été demandé, le module ne le redemande pas.
• L'ancienneté correspond à la fenêtre. Comparez l'ancienneté de la commande avec le minimum et le maximum de jours de son compte (5 et 30 s'ils sont vides). Une commande trop récente ou trop ancienne reste hors de la recherche.
• La commande passe la vérification d'éligibilité du module. Avant d'interroger Amazon, le module effectue une vérification propre par commande ; si la commande ne la passe pas, elle est ignorée sans interroger Amazon.
• Amazon le propose. Si Amazon n'inclut pas l'action d'avis pour cette commande, la tâche la note comme vérifiée et n'envoie rien.
• Il y a un avertissement dans le journal du serveur. Quand l'appel à Amazon échoue, la tâche laisse un avertissement dans le journal du serveur avec le numéro de la commande et poursuit avec la suivante. Cherchez-le par ce numéro.
• Il y a plus de 100 candidates. Le passage ne traite que jusqu'à ce plafond et commence par les commandes jamais vérifiées. Les autres attendent le passage suivant.

Pour localiser une commande précise, ouvrez Amazon › Commandes et vérifiez dans sa fiche que le Compte est celui que vous attendez et que la Commande Amazon correspond à l'identifiant que vous cherchez.

Comment vous verrez le nom de la tâche selon la langue

Le nom de la tâche change avec la langue de votre Odoo. Avec Odoo en espagnol, elle s'appelle Amazon SP-API - Demander un avis ; en allemand, Amazon SP-API - Bewertung anfordern ; en français, Amazon SP-API - Demander un avis ; en italien, Amazon SP-API - Richiedi una recensione ; et en portugais, Amazon SP-API - Pedir uma Avaliação.

Coût et aide

Le module est à paiement unique par version d'Odoo (17, 18, 19 et 20 ; consultez le prix de chacune sur la fiche Odoo Apps ou sur la page du module) et nécessite l'abonnement à FlexigoTech Cloud, plan Connecteur : 49 €/mois ou 490 €/an HT (le plan Pro coûte 98 €/mois ou 980 €/an). 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 que procure l'abonnement s'arrête ; les données restent dans votre Odoo.

Si vous souhaitez que nous examinions comment la demande d'avis est configurée sur vos comptes, ou si vous avez besoin d'une intégration sur mesure avec Amazon, FlexigoTech met en œuvre Odoo 17, 18, 19 et 20 et développe des connecteurs et des intégrations.

À lire aussi

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

Sources

• Code du module : flexigobe_amazon_seller_connector 20.0 (8576afa5): data/ir_cron_data.xml
• Code du module : flexigobe_amazon_seller_connector 17.0 (165f66af): data/ir_cron_data.xml
• Code du module : flexigobe_amazon_seller_connector 20.0 (8576afa5): models/amazon_order.py
• apps.odoo.com/apps/modules/20.0/flexigobe_amazon_seller_connector
• flexigotech.com/precios.html
• flexigotech.com/en/services.html