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:
- Un pedido disponible para solicitud.
- El rol Solicitud al comprador o el rol Listing de productos.
Paso 1. Suscríbete al ORDER_CHANGE
notificación
ORDER_CHANGE
notificaciónPara obtener más información, consulte Tutorial: Suscríbase a la notificación ORDER_CHANGE.
Paso 2. Valide el OrderStatus
parámetro
OrderStatus
parámetroLos 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
EarliestDeliveryDate
y LatestDeliveryDate
parámetrosPuede 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:
- Un pedido disponible para solicitud.
- El rol Solicitud al comprador o el rol Listing de productos.
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 |
Sí |
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] |
Sí |
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 |
Sí |
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] |
Sí |
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.
Updated 7 months ago