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:

The Solicitations API implementation flowchart

Etapa 1. Assine o ORDER_CHANGE alerta

For more information, refer to Tutorial: Subscribe to the ORDER_CHANGE Notification.

Etapa 2. Valide o OrderStatus parâmetro

The 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

Você 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:

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.


Esta página ajudou você?