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 :
- une commande disponible pour la sollicitation ;
- le rôle Sollicitation des acheteurs ou le rôle Offre de produit.
Étape 1. Abonnez-vous au ORDER_CHANGE
notification
ORDER_CHANGE
notificationPour plus d'informations, reportez-vous à Tutoriel : Abonnez-vous à la notification ORDER_CHANGE.
Étape 2 Validez le OrderStatus
paramètre
OrderStatus
paramètreLes 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
EarliestDeliveryDate
et LatestDeliveryDate
paramètresVous 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 :
- une commande disponible pour la sollicitation ;
- le rôle Sollicitation des acheteurs ou le rôle Offre de produit.
É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.
Updated 7 months ago