Guide des cas d'utilisation de l'API Sollicitations v1

Envoyer des sollicitations conformes et de haute qualité aux acheteurs.

Version de l'API : v1

Qu'est-ce que l'API Sollicitations ?

Vous pouvez utiliser API des partenaires de vente pour les sollicitations (API de sollicitations) pour créer des applications qui permettent aux vendeurs d'envoyer des sollicitations cohérentes et de haute qualité aux acheteurs. Les vendeurs peuvent demander à la fois une évaluation du produit et des commentaires en envoyant un seul e-mail basé sur un modèle.

Tutoriel 1 : Configuration de l'API Sollicitations

Ce guide explique comment configurer l'API Sollicitations avant de solliciter des commentaires.

Conditions préalables

Pour terminer ce didacticiel, vous devez :

The Solicitations API implementation flowchart

Étape 1. Abonnez-vous au ORDER_CHANGE notification

Pour plus d'informations, reportez-vous à Tutoriel : Abonnez-vous à la notification ORDER_CHANGE.

Étape 2 Validez le OrderStatus paramètre

Les flux de travail Amazon Simple Queue Service (SQS) reçoivent la charge utile du ORDER_CHANGE notification. Vous pouvez utiliser Amazon SQS pour valider OrderStatus paramètre. Vérifiez que le OrderStatus la valeur est passée à Shipped. Éliminez les redondances pour vous assurer qu'une sollicitation a déjà été envoyée pour une commande spécifique. Pour plus d'informations sur la façon d'interroger la file d'attente SQS, reportez-vous à Tutoriel : Configuration des notifications (flux de travail Amazon Simple Queue Service).

Étape 3 Vérifiez le EarliestDeliveryDate et LatestDeliveryDate paramètres

Vous pouvez demander une sollicitation dans un délai de cinq jours après la EarliestDeliveryDate à 30 jours après la LatestDeliveryDate. L'appel de l'API Sollicitations en dehors de cette période entraînera des erreurs d'API inattendues.

Étape 4 Stockez les identifiants de clé

Archivez ou mettez en cache le amazonOrderId et MarketplaceId paramètres. Ces identifiants sont nécessaires pour solliciter des avis à l'avenir.

Vous êtes maintenant prêt à solliciter des commentaires.

Tutoriel : Solliciter des commentaires pour une commande

Ce tutoriel explique comment solliciter un avis sur un produit et les commentaires d'un vendeur pour une commande. Dans un premier temps, vous devez vérifier qu'une commande est disponible pour la sollicitation, puis vous pouvez créer une demande de sollicitation.

Conditions préalables

Pour terminer ce didacticiel, vous devez :

Étape 1 : Vérifier qu'une commande est disponible pour la sollicitation

Appelez l'opération getSolicitationActionsForOrder en transmettant les paramètres suivants :

Paramètre de chemin d'accès

Paramètre Description Obligatoire
amazonOrderId

Ce paramètre correspond à un numéro de commande Amazon et indique la commande pour laquelle vous souhaitez obtenir la liste des types de sollicitation disponibles.

Type : chaîne

Oui

Paramètre de la requête

Paramètre Description Obligatoire
marketplaceIds

L'identifiant de site de vente, qui indique le site de vente sur lequel la commande a été passée. Un seul site de vente peut être spécifié.

Type : array[String]

Oui

Exemple de demande

GET https://sellingpartnerapi-na.amazon.com/solicitations/v1/orders/333-7777777-7777777 ?marketplaceIds=ATVPDKIKX0DER

Exemples de réponses

Exemple de réponse lorsqu'aucune action de sollicitation n'est disponible :

{ "_links": { "actions": [], "self": { "href": "/solicitations/v1/orders/111-1111111-1111111?marketplaceIds=ATVPDKIKX0DER" } }, "_embedded": { "actions": [] } }

Exemple de réponse lorsque des actions de sollicitation sont disponibles :

{ "_links": { "actions": [ { "href": "/solicitations/v1/orders/111-1111111-1111111/solicitations/productReviewAndSellerFeedback?marketplaceIds=ATVPDKIKX0DER", "name": "productReviewAndSellerFeedback" } ], "self": { "href": "/solicitations/v1/orders/111-1111111-1111111?marketplaceIds=ATVPDKIKX0DER" } }, "_embedded": { "actions": [ { "_links": { "schema": { "href": "/solicitations/v1/orders/111-1111111-1111111/solicitations/productReviewAndSellerFeedback/schema", "name": "productReviewAndSellerFeedback" }, "self": { "href": "/solicitations/v1/orders/111-1111111-1111111/solicitations/productReviewAndSellerFeedback?marketplaceIds=ATVPDKIKX0DER", "name": "productReviewAndSellerFeedback" } }, "_embedded": { "schema": { "_links": { "self": { "href": "/solicitations/v1/orders/111-1111111-1111111/solicitations/productReviewAndSellerFeedback/schema", "name": "productReviewAndSellerFeedback" } }, "type": "object", "name": "productReviewAndSellerFeedback", "title": "Request seller feedback and product review", "description": "Request seller feedback and product review", "properties": {}, "required": [], "$schema": "http://json-schema.org/draft-04/schema#", "x-ui-hidden": true } }, "name": "productReviewAndSellerFeedback", "title": "Request seller feedback and product review" } ] } }

Étape 2 : Solliciter l'évaluation d'un produit

Si l'action productReviewAndSellerFeedback est mentionnée dans la réponse, appelez l'opération createProductReviewAndSellerFeedbackSolicitation, en fournissant les paramètres suivants :

Paramètre de chemin d'accès

Paramètre Description Obligatoire
amazonOrderId

Ce paramètre correspond à un numéro de commande Amazon et indique la commande pour laquelle une sollicitation a été envoyée.

Type : chaîne

Oui

Paramètre de la requête

Paramètre Description Obligatoire
marketplaceIds

L'identifiant de site de vente, qui indique le site de vente sur lequel la commande a été passée. Un seul site de vente peut être spécifié.

Type : array[String]

Oui

Exemple de demande

POST https://sellingpartnerapi-na.amazon.com/solicitations/v1/orders/333-7777777-7777777/solicitations/productReviewAndSellerFeedback ?marketplaceIds=ATVPDKIKX0DER

Exemples de réponses

Exemple de réponse pour une commande non éligible :

{}

Exemple de réponse pour une commande non éligible :

{ "errors": [ { "code": "Unauthorized", "message": "The requested solicitation is not available for this amazonOrderId.", "details": "" } ] }

Bonnes pratiques

Lorsque vous sollicitez des avis, assurez-vous de :

  • Demandez des avis sur les commandes qui ont été livrées.
  • Demandez des commentaires dans les délais impartis.

Notez que vous ne pouvez pas :

  • Recherchez de manière sélective des critiques positives.
  • Demandez des modifications aux avis existants.
  • Offrez des récompenses ou des incitations pour les commentaires.

Pour plus d'informations sur la manière de gérer les sollicitations de manière éthique, consultez le Politique anti-manipulation pour les avis clients.

Transformez les commentaires négatifs en opportunités

Lorsque vous recevez des avis négatifs, vos efforts pour résoudre le problème de l'acheteur peuvent changer la donne. Une fois que vous avez résolu le problème de l'acheteur, appelez le createNegativeFeedbackRemoval opération à partir du API de messagerie. Les vendeurs peuvent utiliser cette opération pour demander à l'acheteur de supprimer le commentaire défavorable. Cela offre aux vendeurs une seconde chance et souligne leur engagement en faveur de la satisfaction de leurs clients.


Cette page vous a-t-elle été utile ?