Guía de casos de uso de la API de solicitudes v1

Envía solicitudes coherentes y de alta calidad a los compradores.

Versión de API: v1

¿Qué es la API de solicitudes?

Puedes usar el API de socios vendedores para solicitudes (API de solicitudes) para crear aplicaciones que permitan a los vendedores enviar ofertas consistentes y de alta calidad a los compradores. Los vendedores pueden solicitar tanto una reseña del producto como una valoración del vendedor enviando un único correo electrónico basado en una plantilla.

Tutorial 1: Configurar la API de solicitudes

En esta guía se muestra cómo configurar la API de solicitudes antes de solicitar comentarios.

Requisitos

Para completar este tutorial, necesita:

The Solicitations API implementation flowchart

Paso 1. Suscríbete al ORDER_CHANGE notificación

Para obtener más información, consulte Tutorial: Suscríbase a la notificación ORDER_CHANGE.

Paso 2. Valide el OrderStatus parámetro

Los flujos de trabajo de Amazon Simple Queue Service (SQS) reciben la carga útil del ORDER_CHANGE notificación. Puede usar Amazon SQS para validar la OrderStatus parámetro. Compruebe que el OrderStatus el valor ha cambiado a Shipped. Elimine las redundancias para asegurarse de que ya se ha enviado una solicitud para un pedido específico. Para obtener más información sobre cómo sondear la cola de SQS, consulte Tutorial: configurar las notificaciones (flujo de trabajo de Amazon Simple Queue Service).

Paso 3. Compruebe el EarliestDeliveryDate y LatestDeliveryDate parámetros

Puede solicitar una solicitud dentro de un plazo de cinco días después de la EarliestDeliveryDate hasta 30 días después del LatestDeliveryDate. Llamar a la API de solicitudes fuera de este plazo provocará errores inesperados en la API.

Paso 4. Almacene los identificadores clave

Archive o almacene en caché el amazonOrderId y MarketplaceId parámetros. Estos identificadores son necesarios para solicitar revisiones en el futuro.

Ahora está listo para solicitar comentarios.

Tutorial: Solicitar valoraciones sobre un pedido

En este tutorial se muestra cómo solicitar una reseña del producto y las valoraciones del vendedor sobre un pedido. En primer lugar, comprueba si un pedido está disponible para su solicitud y, a continuación, crea la solicitud.

Requisitos

Para completar este tutorial, necesita:

Paso 1. Comprobar si un pedido está disponible para solicitud

Llama a la operación getSolicitationActionsForOrder, utilizando los siguientes parámetros:

Parámetro de ruta

Parámetro Descripción Obligatorio
amazonOrderId

Un identificador de pedido de Amazon. Especifica el pedido para el que quieres obtener una lista de tipos de solicitud disponibles.

Tipo: cadena

Parámetro de consulta

Parámetro Descripción Obligatorio
marketplaceIds

Un identificador de sitio web. Especifica el sitio web en el que se realizó el pedido. Solo se puede especificar un sitio web.

Tipo: matriz [cadena]

Ejemplo de solicitud

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

Respuestas de ejemplo

Respuesta de ejemplo cuando no hay ninguna acción de solicitud disponible:

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

Respuesta de ejemplo cuando hay acciones de solicitud 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" } ] } }

Paso 2. Crear una solicitud de reseña de producto

Si la acción productReviewAndSellerFeedback aparece en la respuesta, llama a la operación createProductReviewAndSellerFeedbackSolicitation, pasando los siguientes parámetros:

Parámetro de ruta

Parámetro Descripción Obligatorio
amazonOrderId

Un identificador de pedido de Amazon. Especifica el pedido para el que se envía una solicitud.

Tipo: cadena

Parámetro de consulta

Parámetro Descripción Obligatorio
marketplaceIds

Un identificador de sitio web. Especifica el sitio web en el que se realizó el pedido. Solo se puede especificar un sitio web.

Tipo: matriz [cadena]

Ejemplo de solicitud

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

Respuestas de ejemplo

Respuesta de ejemplo de un pedido no apto:

{}

Respuesta de ejemplo de un pedido no apto:

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

Prácticas recomendadas

Cuando solicites reseñas, asegúrate de:

  • Busca reseñas de los pedidos que se han entregado.
  • Solicita comentarios dentro del plazo permitido.

Tenga en cuenta que no puede:

  • Busque críticas positivas de forma selectiva.
  • Solicita modificaciones a las revisiones existentes.
  • Ofrezca recompensas o incentivos por las reseñas.

Para obtener más información sobre cómo gestionar las solicitudes de forma ética, consulta la Política antimanipulación para las opiniones de los clientes.

Convierte los comentarios negativos en oportunidades

Cuando recibes reseñas negativas, tu esfuerzo por resolver el problema del comprador puede cambiar la narrativa. Cuando hayas resuelto el problema del comprador, llama al createNegativeFeedbackRemoval operación desde el API de mensajería. Los vendedores pueden utilizar esta operación para pedir al comprador que retire la valoración desfavorable. Esto ofrece a los vendedores una segunda oportunidad y subraya su compromiso con la satisfacción del cliente.


¿Te ha ayudado esta página?