Guia de casos de uso da API de solicitações v1
Enviar solicitações consistentes e de alta qualidade aos compradores.
Versão da API: v1
O que é a API de solicitações?
You can use the Selling Partner API for Solicitations (Solicitations API) to build applications that let sellers send consistent, high-quality solicitations to buyers. Sellers can request both a product review and seller feedback by sending a single template-based email.
Tutorial 1: Configurar a API de Solicitações
Este guia demonstra como configurar a API Solicitations antes de solicitar feedback.
Pré-requisitos
Para concluir este tutorial, você precisa:
- Um pedido disponível para solicitação.
- The Buyer Solicitation role or the Product Listing role.
Etapa 1. Assine o ORDER_CHANGE
alerta
ORDER_CHANGE
alertaFor more information, refer to Tutorial: Subscribe to the ORDER_CHANGE Notification.
Etapa 2. Valide o OrderStatus
parâmetro
OrderStatus
parâmetroThe Amazon Simple Queue Service (SQS) workflows receives the payload of the ORDER_CHANGE
notification. You can use Amazon SQS to validate the OrderStatus
parameter. Check that the OrderStatus
value has changed to Shipped
. Eliminate redundancies to make sure whether a solicitation has already been dispatched for a specific order. For more information on how to poll the SQS queue, refer to Tutorial: Set up notifications (Amazon Simple Queue Service workflow).
Etapa 3. Verifique o EarliestDeliveryDate
e LatestDeliveryDate
parâmetros
EarliestDeliveryDate
e LatestDeliveryDate
parâmetrosVocê pode solicitar a solicitação dentro de um período de cinco dias após o EarliestDeliveryDate
até 30 dias após o LatestDeliveryDate
. Chamar a API de Solicitações fora desse prazo resultará em erros inesperados de API.
Etapa 4. Armazene identificadores de chave
Arquive ou armazene em cache o amazonOrderId
e MarketplaceId
parâmetros. Esses identificadores são necessários para solicitar avaliações no futuro.
Agora você está pronto para solicitar feedback.
Tutorial: solicitar feedback de um pedido
Este tutorial mostra como solicitar uma avaliação do produto e o feedback do vendedor sobre um pedido. Primeiro, você verifica se um pedido está disponível para solicitação e, em seguida, cria o pedido de solicitação.
Pré-requisitos
Para concluir este tutorial, você precisa:
- Um pedido disponível para solicitação.
- The Buyer Solicitation role or the Product Listing role.
Etapa 1. Verificar se um pedido está disponível para solicitação
Call the getSolicitationActionsForOrder
operation, passing the following parameters:
Parâmetro do caminho
Parâmetro | Descrição | Obrigatório |
---|---|---|
amazonOrderId |
Um identificador de pedido da Amazon. Isso especifica o pedido para o qual você deseja obter uma lista dos tipos de solicitação disponíveis. Tipo: string |
Sim |
Parâmetro de consulta
Parâmetro | Descrição | Obrigatório |
---|---|---|
marketplaceIds |
Um identificador de marketplace. Isso especifica o marketplace no qual o pedido foi feito. Somente um marketplace pode ser especificado. Tipo: array[String] |
Sim |
Exemplo de solicitação
GET https://sellingpartnerapi-na.amazon.com/solicitations/v1/orders/333-7777777-7777777
?marketplaceIds=ATVPDKIKX0DER
Exemplos de resposta
Exemplo de resposta quando nenhuma ação de solicitação está disponível:
{
"_links": {
"actions": [],
"self": {
"href": "/solicitations/v1/orders/111-1111111-1111111?marketplaceIds=ATVPDKIKX0DER"
}
},
"_embedded": {
"actions": []
}
}
Exemplo de resposta quando as ações de solicitação estão disponíveis:
{
"_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"
}
]
}
}
Etapa 2. Criar uma solicitação de avaliação de produto
If the productReviewAndSellerFeedback
action is listed in the response, call the createProductReviewAndSellerFeedbackSolicitation
operation, passing the following parameters:
Parâmetro do caminho
Parâmetro | Descrição | Obrigatório |
---|---|---|
amazonOrderId |
Um identificador de pedido da Amazon. Isso especifica o pedido para o qual uma solicitação é enviada. Tipo: string |
Sim |
Parâmetro de consulta
Parâmetro | Descrição | Obrigatório |
---|---|---|
marketplaceIds |
Um identificador de marketplace. Isso especifica o marketplace no qual o pedido foi feito. Somente um marketplace pode ser especificado. Tipo: array[String] |
Sim |
Exemplo de solicitação
POST https://sellingpartnerapi-na.amazon.com/solicitations/v1/orders/333-7777777-7777777/solicitations/productReviewAndSellerFeedback
?marketplaceIds=ATVPDKIKX0DER
Exemplos de resposta
Exemplo de resposta para um pedido não qualificado:
{}
Exemplo de resposta para um pedido não qualificado:
{
"errors": [
{
"code": "Unauthorized",
"message": "The requested solicitation is not available for this amazonOrderId.",
"details": ""
}
]
}
Práticas recomendadas
Ao solicitar avaliações, certifique-se de:
- Busque avaliações de pedidos que foram entregues.
- Solicite feedback dentro do prazo permitido.
Observe que você não pode:
- Busque seletivamente avaliações positivas.
- Solicite alterações nas avaliações existentes.
- Ofereça recompensas ou incentivos por avaliações.
For more information on how to ethically navigate solicitations, review the Anti-Manipulation Policy for Customer Reviews.
Transforme feedback negativo em oportunidades
When you receive negative reviews, your effort to resolve the buyer's issue can change the narrative. Once you have resolved the buyer's problem, call the createNegativeFeedbackRemoval
operation from the Messaging API. Sellers can use this operation to ask the buyer to remove the unfavorable feedback. This offers sellers a second chance and underscores their commitment to customer satisfaction.
Updated 7 months ago