La API de la Versión: v1

¿Cuál es la Notifications API v1?

La selling partner API de Notificaciones le permite suscribirse a las notificaciones que son pertinentes para la selling partner 's business. El uso de esta API, puede crear un destino para recibir notificaciones, suscribirse a las notificaciones, eliminar suscripciones de notificación, y más. En lugar de la votación de la información, su aplicación puede recibir la información directamente de Amazon cuando un evento se dispara una notificación a las que estás suscrito.

Puedes suscribirte a notificaciones en nombre de sellers o vendors. Para determinar si puedes suscribirte a un tipo de notificación en nombre únicamente de sellers, únicamente de vendors o de ambos,vaya a notificationType.

🚧

Construir un mecanismo de copia de seguridad

Como mejor práctica, se recomienda que tenga un medio para recuperar la información necesaria en caso de un corte inesperado o retraso en la entrega de la notificación.

Terminología

• Amazon EventBridge: Un serverless evento de autobús que conecta los datos de la aplicación desde sus propias aplicaciones, integradas de Software-como-un-Servicio (SaaS) de las aplicaciones y de los servicios de AWS. Para obtener más información, consulte Amazon EventBridge.
• (Amazon SQS) Amazon Simple Queue Service: Una totalmente gestionado servicio de message queue server para microservices, sistemas distribuidos, y serverless aplicaciones. Para obtener más información, consulte Amazon Simple Queue Service.
• Partner event source: Usado por un AWS partner para enviar eventos a un cliente de cuenta AWS. Para recibir estos eventos, el cliente debe asociar un evento de autobús con la pareja de origen de evento. Para obtener más información, consulte ¿Qué Es Amazon EventBridge?
• Event bus: Recibe los eventos de una fuente y los dirige a la asignación resource de acuerdo a las reglas asociadas con el Event bus. Para obtener más información, consulte EventBus.

Notificación de flujos de trabajo

Hay dos diferentes flujos de trabajo para la recepción de notificaciones. El flujo de trabajo de uso depende del tipo de notificación que desea recibir.

Amazon EventBridge de flujo de trabajo

El siguiente diagrama Offers una visión general de la Amazonía EventBridge pasos de flujo de trabajo para suscribirse a listas de notificaciones.

flujo de trabajo para suscribirse a listas de notificaciones

Utilice este flujo de trabajo para recibir los siguientes tipos de notificación:

• BRANDED_ITEM_CONTENT_CHANGE: Envía cada vez que hay un cambio en el título, descripción, viñetas o imágenes, por cualquier ASIN que la selling partner tiene una marca en relación con.
• ITEM_PRODUCT_TYPE_CHANGE: Envía cada vez que hay un cambio en el tipo de producto nombre de cualquier ASIN que la selling partner tiene una marca en relación con.
• LISTINGS_ITEM_STATUS_CHANGE: Envía cada vez que hay un listado de cambio de estado, incluyendo comprable de transición, listado de crear, o listado de eliminar cualquier SKU que la selling partner tiene.
• LISTINGS_ITEM_ISSUES_CHANGE: Envía cada vez que hay un cambio de cualquier SKU que la selling partner tiene.
• PRODUCT_TYPE_DEFINITIONS_CHANGE: Envía cada vez que hay un nuevo Tipo de Producto o Tipo de Producto Versión.

Consulte el Tutorial: Configurar notificaciones (fluxo de trabalho do Amazon EventBridge).

Amazon Simple Queue Service flujo de trabajo

Utilice este flujo de trabajo para recibir los siguientes tipos de notificación:

• ACCOUNT_STATUS_CHANGED:Enviado cada vez que cambia el estado de la cuenta para los pares de selling partner /marketplace suscritos a los desarrolladores. Una notificación se publica cada vez que la venta de la pareja cuenta de los cambios de estado entre NORMAL, AT_RISK, y DEACTIVATED.
• ANY_OFFER_CHANGED: Envía cada vez que hay un cambio en alguna de las 20 mejores ofertas, por estado (nuevo o usado), o si el externo precio (el precio de otras tiendas) cambios para un elemento de la lista por el seller.
• B2B_ANY_OFFER_CHANGED: Envía cada vez que hay un cambio en cualquiera de los top 20 B2B Offers, en la forma de cualquier cambio de precio (ya sea de una sola unidad o cantidad de la capa de descuento de los precios) para un elemento de la lista por el seller.
• DETAIL_PAGE_TRAFFIC_EVENT: Enviado al comienzo de cada hora. Esta notificación comparte datos de tráfico a nivel de ASIN e incluye datos de la hora anterior, así como cualquier dato retrasado de hasta 24 horas antes. Cada notificación puede incluir varios ASIN y un selling partner puede esperar recibir varias notificaciones cada hora.
• FBA_INVENTORY_AVAILABILITY_CHANGES: Envía cada vez que hay un cambio en el Cumplimiento Por parte de Amazon (FBA) las cantidades de inventario. Esta notificación incluye una instantánea de la FBA de inventario en todos los marketplaces en una región en particular.
• FBA_OUTBOUND_SHIPMENT_STATUS: Envía cada vez que creamos o cancelar un Cumplimiento por parte de Amazon, el envío de un seller.
• FEE_PROMOTION: se Envía cuando una promoción se convierte en activo.
• FEED_PROCESSING_FINISHED: Enviado siempre a cualquier alimento enviadas mediante la selling partner API para Feeds alcanza un alimento estado de tramitación de DONE, CANCELLED o FATAL.
• FULFILLMENT_ORDER_STATUS: Envía cada vez que hay un cambio en el estatus de un Multi-Canal de Cumplimiento de la orden.
• ITEM_INVENTORY_EVENT_CHANGE : Enviado al comienzo de cada hora. Esta notificación comparte datos de inventario a nivel de ASIN e incluye datos de la hora anterior, así como cualquier dato retrasado de hasta 24 horas antes. Cada notificación puede incluir varios ASIN y un socio de ventas puede esperar recibir varias notificaciones cada hora.
• ITEM_SALES_EVENT_CHANGE: Enviado al comienzo de cada hora. Esta notificación comparte datos de ventas a nivel de ASIN e incluye datos de la hora anterior, así como cualquier dato retrasado de hasta 24 horas antes. Cada notificación puede incluir varios ASIN y un socio de ventas puede esperar recibir varias notificaciones cada hora.
• ORDER_CHANGE: Enviado siempre que haya un cambio importante en el pedido. Los cambios importantes incluyen cambios en el estado del pedido y cancelaciones solicitadas por el comprador.
• ORDER_STATUS_CHANGE: Envía cada vez que hay un cambio en el estado de nuevo o existente a fin de disponibilidad.
• PRICING_HEALTH: Envía cada vez que un seller de la oferta no es elegible para ser la Oferta presentada debido a la falta de competitividad de los precios.
• REPORT_PROCESSING_FINISHED: Enviado siempre que cualquier reporte que se ha solicitado el uso de la la selling partner API de Reports alcanza un reporte de tramitación de DONE, CANCELLED o FATAL.

Consulte el Tutorial: Configurar notificaciones (Fluxo de trabalho do Amazon Simple Queue Service).

Tutorial: Configurar notificaciones (fluxo de trabalho do Amazon EventBridge)

Utilizar este tutorial para recibir cualquiera de los siguientes tipos de notificaciones:

• BRANDED_ITEM_CONTENT_CHANGE: Envía cada vez que hay un cambio en el título, descripción, viñetas o imágenes por cualquier ASIN que la selling partner tiene una marca en relación con.
• ITEM_PRODUCT_TYPE_CHANGE: Envía cada vez que hay un cambio en el tipo de producto nombre de cualquier ASIN que la selling partner tiene una marca en relación con.
• LISTINGS_ITEM_STATUS_CHANGE: Envía cada vez que hay un listado de cambio de estado, incluyendo comprable de transición, listado de crear, o listado de eliminar cualquier SKU que la selling partner tiene.
• LISTINGS_ITEM_ISSUES_CHANGE: Envía cada vez que hay un cambio de cualquier SKU que la selling partner tiene.
• LISTINGS_ITEM_MFN_QUANTITY_CHANGE: Enviado cada vez que hay un cambio en la cantidad disponible de un artículo de listados.
• PRODUCT_TYPE_DEFINITIONS_CHANGE: Envía cada vez que hay un nuevo Tipo de Producto o Tipo de Producto Versión.

Si desea recibir cualquier otro tipo de notificación, omita este tutorial e ir al Tutorial: Configurar notificaciones (Fluxo de trabalho do Amazon Simple Queue Service).

Requisitos previos

Para completar este tutorial, necesitará:

• La autorización de la selling partner s (sellers o vendors) para quienes estás realizando las llamadas. Se refieren a la Guía para desarrolladores de Selling Partner API para más información.
• Una cuenta de AWS. Esta cuenta de AWS será responsable por los cargos relacionados con la recepción de las notificaciones. Si aún no eres cliente de AWS, puedes crear una cuenta de AWS de forma gratuita. Para obtener más información, consulte la AWS Free Tier.
• Un recurso de destino para recibir notificación de eventos de Amazon EventBridge autobús. Para obtener más información, consulte ¿Qué Es Amazon EventBridge?
• Una comprensión básica de Amazon EventBridge. Para obtener más información, consulte Amazon EventBridge.

Paso 1. Crear un destino

Llame a la operación createDestination para crear un Amazon EventBridge destino.

Nota: sólo puede crear una EventBridge destino por cuenta de AWS.

1. Llame a la operación createDestination, pasando los siguientes parámetros del body:

Nota: Llamar a la operación createDestination no requiere de autorización de la cualquier selling partner . En este sentido, esta operación es un "grantless de la operación" y tiene un diferente modelo de autorización de la Venta de la mayoría de los otros selling partner API operations. Para obtener más información, consulte Grantless operaciones en la Guía para desarrolladores de Selling Partner API.

Ejemplo de solicitud:

POST https://sellingpartnerapi-na.amazon.com/notifications/v1/destinations
{
  "resourceSpecification":
  {
    "eventBridge":
    {
      "accountId": "123456789",
      "region": "us-east-1"
    }
  },
  "name": "YourDestinationName"
}

Respuesta

Una respuesta correcta incluye lo siguiente:

Respuesta ejemplo:

{
  "payload": {
    "resource": {
      "sqs": null,
      "eventBridge": {
        "name": "sellingpartnerapi.amazon.com/amzn1.sellerapps.app.15a75829-cd4a-4efc-b947-0cc39d874577",
        "accountId": "123456789",
        "region": "us-east-1"
      }
    },
    "destinationId": "64a4a891-60dd-303f-89f9-43caf25cb3ec",
    "name": "YourDestinationName"
  }
}

2. Guardar los valores siguientes:

• resource:eventBridge:name:: este valor se Utiliza en el Paso 2. Configurar Amazon EventBridge para manejar las notificaciones.
• destinationId: Pasar en este valor en el Paso 4. Crear una suscripción.

Paso 2. Configurar Amazon EventBridge para manejar las notificaciones

Asociar un evento en el autobús con su pareja de origen de evento. Para las definiciones, se refieren a la Terminología.

1. Ir a Amazon EventBridge e iniciar sesión en la Consola de AWS mediante la Cuenta de AWS ID especificado cuando llama a la operación createDestination en el Paso 1. Crear un destino.
2. En la consola, asegúrese de que la Región de AWS que especificó cuando llama a la operación createDestination.
3. En el panel de navegación, seleccione Partner event sources.
4. En la Partner event sources área, en Name, seleccione el partner de origen de evento que coincide con el resource:eventBridge:name valor devuelto en el Paso 1. Crear un destino. El Partner event source está en este formato: aws.partner/sellingpartnerapi.amazon.com/{AWS Account Id}/{Application Id}.
5. En la nueva página que aparece, elija Associate with event bus.
6. En el Associate with event bus página, deje las casillas vacías y elegir Associate.

Ha creado un partner event bus y asociados con su pareja de origen de evento. Vaya al Paso 3. Crear una regla que se activa en un evento de notificación.

Paso 3. Crear una regla que se activa en un evento de notificación

Crear una regla de que los relojes específicos para la notificación de eventos y rutas a los recursos de destino de su elección.

1. Ir a Amazon EventBridge. Si no ha iniciado sesión en la Consola de AWS, inicie sesión con la Cuenta de AWS ID especificado cuando llama a la operación createDestination en el Paso 1. Crear un destino.
2. En la Consola, asegúrese de que la Región de AWS que especificó cuando llama a la operación createDestination.
3. En el panel de navegación, seleccione Rules.
4. Elija Create rule.
5. Introduzca un nombre y una descripción opcional para la regla.
6. Para el Event bus, seleccione el autobús que se asocia con la pareja de origen de evento.
7. Elija Next.
8. Para el Event source, seleccione AWS events or EventBridge partner events.
9. Para la Creation method, seleccione Use pattern form.
10. En Event pattern:

• Elegir Event source, seleccione EventBridge partners.
• Para el Partner en la dropdown, seleccione Amazon selling partner APIs.
• Para el Event type en la dropdown, seleccione All Events.

El evento patrón que se muestra debe ser similar a la siguiente, que indica que va a recibir todos los eventos emitidos por sellingpartnerapi.amazon.com:

{
  "source": [
    {
      "prefix": "aws.partner/sellingpartnerapi.amazon.com"
    }
  ]
}

10. (Opcional) Editar el evento patrón para incluir reglas que coinciden sólo los eventos de notificación que desee. El suceso siguiente patrón contiene una regla que coincide sólo conBRANDED_ITEM_CONTENT_CHANGE los eventos de sellingpartnerapi.amazon.com:

{
  "source": [
    {
      "prefix": "aws.partner/sellingpartnerapi.amazon.com"
    }
  ],
  "detail-type": ["BRANDED_ITEM_CONTENT_CHANGE"]
}

Para obtener información acerca de la creación de reglas más complejas, consulte Event Patterns en la AWS documentación.

11. Elija Next.
12. Ahora seleccione el servicio de AWS que va a actuar cuando un evento del tipo seleccionado es detectado. Introduzca la información específica para este tipo de destino, si es necesario.

Nota: Para muchos tipos de destino, EventBridge necesita permisos para enviar eventos a la meta. En estos casos, puede crear una nueva función de IAM o puede utilizar una función de IAM. Realice una de las siguientes:

• Para crear una función de IAM, seleccione Crear un nuevo rol para este recurso.
• Para utilizar una función de IAM que ya ha creado, seleccione Usar la función existente.

Nota: Para verificar que los eventos están llegando a través de su EventBridge, puede utilizar una cola SQS como un objetivo para la regla que ha creado y, a continuación, la encuesta que cola SQS como las notificaciones que llegan.

13. (Opcional) Elija Add another target para agregar otro objetivo de esta regla, si necesita más de uno.
14. Elija Next.
15. (Opcional) Introduzca una o más etiquetas para la regla. Para obtener más información, consulte el Etiquetado de Amazon EventBridge Recursos de AWS documentación.
16. Elija Next.
17. Elija Create rule.

Solución de problemas:

• Si crea una regla con un encrypted Amazon SQS como un objetivo, debe incluir una acción descifrar en su AWS Key Management Service clave de la política para que el evento sea entregado con éxito a la cifra de la cola. Para obtener más información, vea Mis eventos no se entregan a la meta cola de Amazon SQS en la AWS documentación.
• Para obtener más información sobre solución de problemas, consulte Solución de problemas de Amazon EventBridge en la AWS documentación.

Paso 4. Crear una suscripción

Suscribirse a un tipo de notificación, para ser entregado a su destino que creó en el Paso 1. Crear un destino.

Nota: Sólo una suscripción por cada solicitud, tipo de notificación, y de las partes(seller/vendor) se permite por la región.

1. Llame a la operación createSubscription, pasando los siguientes parámetros:

Ruta de los parámetros:

Parámetros del body:

Ejemplo de solicitud:

POST https://sellingpartnerapi-na.amazon.com/ notifications/v1/subscriptions/BRANDED_ITEM_CONTENT_CHANGE
{
  "payloadVersion":"1.0",
  "destinationId":"3acafc7e-121b-1329-8ae8-1571be663aa2"
}

Respuesta

Respuesta ejemplo:

{
  "payload":{
    "subscriptionId":" 7fcacc7e-727b-11e9-8848-1681be663d3e",
    "payloadVersion":" 1.0",
    "destinationId":"3acafc7e-121b-1329-8ae8-1571be663aa2"
  }
}

Ahora estás suscrito para recibir notificaciones BRANDED_ITEM_CONTENT_CHANGE .

Tutorial: Configurar notificaciones (Fluxo de trabalho do Amazon Simple Queue Service)

Utilizar este tutorial para configurar su sistema para recibir cualquiera de los siguientes tipos de notificaciones:

• ACCOUNT_STATUS_CHANGED:Enviado cada vez que cambia el estado de la cuenta para los pares de selling partner /marketplace suscritos a los desarrolladores. Una notificación se publica cada vez que la venta de la pareja cuenta de los cambios de estado entre NORMAL, AT_RISK, y DEACTIVATED.
• ANY_OFFER_CHANGED: Envía cada vez que hay un cambio en alguna de las 20 mejores ofertas, por estado (nuevo o usado), o si el externo precio (el precio de otras tiendas) cambios para un elemento de la lista por el seller.
• B2B_ANY_OFFER_CHANGED: Envía cada vez que hay un cambio en cualquiera de los top 20 B2B Offers, en la forma de cualquier cambio de precio (ya sea de una sola unidad o cantidad de la capa de descuento de los precios) para un elemento de la lista por el seller.
• DETAIL_PAGE_TRAFFIC_EVENT: Enviado al comienzo de cada hora. Esta notificación comparte datos de tráfico a nivel de ASIN e incluye datos de la hora anterior, así como cualquier dato retrasado de hasta 24 horas antes. Cada notificación puede incluir varios ASIN y un selling partner puede esperar recibir varias notificaciones cada hora.
• FBA_INVENTORY_AVAILABILITY_CHANGES: Envía cada vez que hay un cambio en el Cumplimiento Por parte de Amazon (FBA) las cantidades de inventario. Esta notificación incluye una instantánea de la FBA de inventario en todos los marketplaces en una región en particular.
• FBA_OUTBOUND_SHIPMENT_STATUS: Envía cada vez que creamos o cancelar un Cumplimiento por parte de Amazon, el envío de un seller.
• FEE_PROMOTION: se Envía cuando una promoción se convierte en activo.
• FEED_PROCESSING_FINISHED: Enviado siempre a cualquier alimento enviadas mediante la selling partner API para Feeds alcanza un alimento estado de tramitación de DONE, CANCELLED o FATAL.
• FULFILLMENT_ORDER_STATUS: Envía cada vez que hay un cambio en el estatus de un Multi-Canal de Cumplimiento de la orden.
• ITEM_INVENTORY_EVENT_CHANGE : Enviado al comienzo de cada hora. Esta notificación comparte datos de inventario a nivel de ASIN e incluye datos de la hora anterior, así como cualquier dato retrasado de hasta 24 horas antes. Cada notificación puede incluir varios ASIN y un socio de ventas puede esperar recibir varias notificaciones cada hora.
• ITEM_SALES_EVENT_CHANGE: Enviado al comienzo de cada hora. Esta notificación comparte datos de ventas a nivel de ASIN e incluye datos de la hora anterior, así como cualquier dato retrasado de hasta 24 horas antes. Cada notificación puede incluir varios ASIN y un socio de ventas puede esperar recibir varias notificaciones cada hora.
• ORDER_CHANGE: Enviado siempre que haya un cambio importante en el pedido. Los cambios importantes incluyen cambios en el estado del pedido y cancelaciones solicitadas por el comprador.
• ORDER_STATUS_CHANGE: Envía cada vez que hay un cambio en el estado de nuevo o existente a fin de disponibilidad.
• PRICING_HEALTH: Envía cada vez que un seller de la oferta no es elegible para ser la Oferta presentada debido a la falta de competitividad de los precios.
• REPORT_PROCESSING_FINISHED: Enviado siempre que cualquier reporte que se ha solicitado el uso de la la selling partner API de Reports alcanza un reporte de tramitación de DONE, CANCELLED o FATAL.

Importante: Para recibir cualquier otro tipo de notificación, ir al Tutorial: Configurar notificaciones (fluxo de trabalho do Amazon EventBridge).

Requisitos previos

Para completar este tutorial, necesitará:

• La autorización de los selling partner s para quienes estás realizando las llamadas. Ver la Guía para desarrolladores de Selling Partner API para más información.
• Una Cuenta de AWS. Si aún no eres cliente de AWS, puedes crear una cuenta de AWS de forma gratuita. Para obtener más información, consulte la capa Gratuita de AWS.
• Amazon Simple Queue Service (SQS) de la cola. Para obtener información acerca de la configuración de una cola SQS, ver Amazon Simple Queue Service.

Paso 1. Conceder la selling partner API de permiso para escribir en su cola SQS

Para recibir notificaciones debe conceder la selling partner API de permiso para escribir en su cola SQS.

1. Abra la AWS Management Console e inicie sesión con sus credenciales de AWS.
2. Desde la consola, abra Simple Queue Service.
3. Seleccione el Estándar de la cola donde se desea recibir las notificaciones.
4. Elegir la Access Policy ficha.
5. De la Access policy (Permisos) de sección, seleccione Edit. La Edit Test Queue se abre la página.
6. Desplácese hacia abajo a la Access policy, a continuación, seleccione la Policy generator link. La Política de AWS Generador se abre en una nueva pestaña.
7. En el Paso 1 de la política de generador, seleccione SQS Queue Policy.
8. En el Paso 2 de la política de generador:

• Conjunto Effect a Allow.
• Conjunto Principal para 437568002678.
• Conjunto de Actions a SendMessage y GetQueueAttributes.
• Introduzca el SQS ARN valor en Amazon Resource Name (ARN).
• Elija Add Statement y verificar los detalles.

10. En el Paso 3 de la política de generador, seleccione Generate Policy. Un cuadro de diálogo con la nueva política se abre.
11. Copia de la póliza.
12. Vaya de nuevo a la cola de Amazon SQS, abra la Access Policy ficha, a continuación, pegar la política en la Access Policy (Permissions) de la sección.
13. Guardar los cambios.
14. Referencia de la cola Details sección y en la nota de la ARN para esta cola. Pasará este valor usando el arn parámetro al llamar a la operación createDestination en el Paso 2. Crear un destino.

Nota: Si está utilizando en el lado del servidor de cifrado (ESS), entonces debe proporcionar la selling partner API de acceso a su clave con la AWS Key Management Service (KMS). Considere la posibilidad de usar la siguiente política:

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": {
        "AWS": "arn:aws:iam::437568002678:root"
      },
      "Action": [
        "kms:GenerateDataKey",
        "kms:Decrypt"
      ],
      "Resource": "*"
    }
  ]
}

Ver Key management para obtener más información.

Paso 2. Crear un destino

Llame a la operación createDestination para crear un Amazon Simple Queue Service (SQS) de destino.

1. Llame a la operación createDestination, pasando los siguientes parámetros del body:

Nota: Llamar a la operación createDestination no requiere de autorización de la cualquier selling partner . En este sentido, esta operación es un "grantless de la operación" y tiene un diferente modelo de autorización de la Venta de la mayoría de los otros selling partner API operations. Para obtener más información, consulte Grantless operaciones en la Guía para desarrolladores de Selling Partner API.

Ejemplo de solicitud:

POST https://sellingpartnerapi-na.amazon.com/ notifications/v1/destinations
{
  "name": "YourDestinationName",
  "resourceSpecification":
  {
    "sqs":
    {
      "arn": "arn:aws:sqs:us-east-2:444455556666:queue1"
    }
  }
}

Respuesta

Respuesta ejemplo:

{
  "payload": {
    "name": "YourDestinationName",
    "destinationId": "ExampleDestinationId",
    "resource": {
      "sqs": {
        "arn": "arn:aws:sqs:us-east-2:444455556666:queue1"
      }
    }
  }
}

1. Guardar el destinationId valor como entrada para el Paso 3. Crear una suscripción.

Paso 3. Crear una suscripción

Crear una suscripción a un tipo de notificación, para ser entregado a su destino que creó en el paso anterior.

Nota: Sólo una suscripción por cada solicitud, tipo de notificación, y de las partes(seller/vendor) se permite por la región.

1. Llame a la operación createSubscription , pasando los siguientes parámetros:

Ruta de los parámetros:

Parámetros del body:

Ejemplo de solicitud (sin procesamiento de la directiva):

POST https://sellingpartnerapi-na.amazon.com/ notifications/v1/subscriptions/ANY_OFFER_CHANGED
{
  "payloadVersion":"1.0",
  "destinationId":"3acafc7e-121b-1329-8ae8-1571be663aa2"
}

Respuesta

Respuesta ejemplo:

{
  "payload": {
    "subscriptionId": "7fcacc7e-727b-11e9-8848-1681be663d3e",
    "payloadVersion": "1.0",
    "destinationId": "3acafc7e-121b-1329-8ae8-1571be663aa2",
  }
}

Respuesta

Ejemplos que utilizan un processingDirective (Sólo se admite por la ANY_OFFER_CHANGED notificationType)

Ejemplo de solicitud para crear una suscripción que envía notificaciones por sólo el especificado marketplaceId del:

POST https://sellingpartnerapi-na.amazon.com/ notifications/v1/subscriptions/ANY_OFFER_CHANGED
{
  "destinationId": "12d803a2-7e70-4bb2-a797-2b4b43e10051",
  "payloadVersion": "1.0",
  "processingDirective": {
    "eventFilter": {
      "eventFilterType": "ANY_OFFER_CHANGED",
      "marketplaceIds": ["ATVPDKIKX0DER"]
    }
  }
}

Respuesta ejemplo:

{
  "payload": {
    "subscriptionId": "7318ddfb-18e4-4fe0-89f5-a437321d2e79",
    "destinationId": "12d803a2-7e70-4bb2-a797-2b4b43e10051",
    "payloadVersion": "1.0",
    "processingDirective": {
      "eventFilter": {
        "marketplaceIds": [
          "ATVPDKIKX0DER"
        ],
        "eventFilterType": "ANY_OFFER_CHANGED"
      }
    }
  }
}

Ejemplo de solicitud para crear una suscripción que limita la frecuencia de las notificaciones a uno cada cinco minutos:

POST https://sellingpartnerapi-na.amazon.com/ notifications/v1/subscriptions/ANY_OFFER_CHANGED
{
  "destinationId": "12d803a2-7e70-4bb2-a797-2b4b43e10051",
  "payloadVersion": "1.0",
  "processingDirective": {
    "eventFilter": {
      "eventFilterType": "ANY_OFFER_CHANGED",
      "aggregationSettings": {
        "aggregationTimePeriod": "FiveMinutes"
      }
    }
  }
}

Respuesta ejemplo:

{
  "payload": {
    "subscriptionId": "b8877fdf-17a6-4d59-bb1d-9650d9d823e0",
    "destinationId": "12d803a2-7e70-4bb2-a797-2b4b43e10051",
    "payloadVersion": "1.0",
    "processingDirective": {
      "eventFilter": {
        "aggregationSettings": {
          "aggregationTimePeriod": "FiveMinutes"
        },
        "eventFilterType": "ANY_OFFER_CHANGED"
      }
    }
  }
}

El procesamiento de las notificaciones de su queues

Hay varias propiedades importantes de Amazon SQS queues que se debe entender con el fin de procesar las notificaciones correctamente:

• selling partner de la API de no apoyar la entrega de colas FIFO. Debes utilizar las colas estándar de Amazon SQS para recibir notificaciones.
• selling partner de la API estándar de las colas no garantizan que las notificaciones se recibirán en el orden en que fueron enviados. Estándar de las colas de proporcionar el mejor esfuerzo de pedidos, lo que significa que las notificaciones son generalmente entregados en el mismo orden en que son enviados. Sin embargo, en ocasiones, más de una copia de una notificación podría ser entregada fuera de orden. Por lo tanto, debe diseñar su aplicación para aceptar las notificaciones en cualquier orden.
• Amazon SQS estándar de la cola de notificaciones pueden ser entregados más de una vez. Amazon SQS almacena copias de las notificaciones en múltiples servidores de alta disponibilidad y redundancia. En raras ocasiones, uno de los servidores que almacena una copia de una notificación podría no estar disponible cuando se recibe o eliminar una notificación. Si se produce esta situación, la copia de la notificación no se eliminan en que servidor no disponible, y se puede conseguir que la copia de la notificación de nuevo al recibir notificaciones. Por lo tanto, debe diseñar su aplicación para aceptar múltiples copias de cualquier notificación.
• Puedes determinar si una notificación es un duplicado de una notificación que ya has recibido al verificar la propiedad notificationId de la notificación. Puedes encontrar la notificationId propiedad en el NotificationMetaData object de la notificación.

Para obtener más información acerca del procesamiento de las notificaciones de Amazon SQS queues, ver el Guía para desarrolladores de Amazon Simple Queue Service y el Referencia de la API de Amazon Simple Queue Service en el portal de documentación de AWS.

Procesamiento De Directivas

Un procesamiento de la directiva es un parámetro opcional que se puede proporcionar cuando se llama a la operación createSubscription . Se puede utilizar para cambiar el comportamiento de una suscripción para ciertos notificationTypes. Actualmente sólo se admite para el uso con el ANY_OFFER_CHANGED notificationType. Uso con no notificationType resultados en un fallo en la solicitud con una respuesta HTTP 400.

El uso de un processingDirective para pasar información adicional a la suscripción para el control de la tramitación de las notificaciones. Por ejemplo, puede utilizar una eventFilter para personalizar su suscripción para el envío de notificaciones por sólo el especificado marketplaceId, o para seleccionar la agregación período de tiempo en el que para enviar notificaciones (por ejemplo, limitar a una notificación cada cinco minutos para la alta frecuencia de las notificaciones).

Los siguientes eventFilter valores son compatibles:

Para obtener más información, consulte ProcessingDirective en la referencia de la API.

solicitud de ejemplo que implementa un processingDirective con tanto eventFilter:

POST https://sellingpartnerapi-na.amazon.com/notifications/v1/subscriptions/ANY_OFFER_CHANGED
{
  "payloadVersion": "1.0",
  "destinationId": "3acafc7e-121b-1329-8ae8-1571be663aa2",
  "processingDirective": {
    "eventFilter": {
      "marketplaceIds": [
        "ATVPDKIKX0DER",
        "A2EUQ1WTGCTBG2"
      ],
      "aggregationSettings": {
        "aggregationTimePeriod": "FiveMinutes"
      },
      "eventFilterType": "ANY_OFFER_CHANGED"
    }
  }
}

Respuesta:

{
   "payload": {
     "subscriptionId": "7fcacc7e-727b-11e9-8848-1681be663d3e",
     "payloadVersion": "1.0",
     "destinationId": "3acafc7e-121b-1329-8ae8-1571be663aa2",
     "processingDirective": {
       "eventFilter": {
         "marketplaceIds": [
           "ATVPDKIKX0DER",
           "A2EUQ1WTGCTBG2"
         ],
         "aggregationSettings": {
           "aggregationTimePeriod": "FiveMinutes"
         },
         "eventFilterType": "ANY_OFFER_CHANGED"
       }
     }
   }
 }

Estructura de notificación

selling partner de las notificaciones en formato JSON. Cada notificación contiene una Payload object, que contiene los datos procesables de la notificación. Tipo de notificación, en combinación con PayloadVersion, determina la estructura de la Payload object.

Una Venta de la notificación a la Pareja con NotificationVersion=1.0 contener las siguientes propiedades:

Notificación ejemplo:

{
  "NotificationVersion": "1.0",
  "NotificationType": "BRANDED_ITEM_CONTENT_CHANGE",
  "PayloadVersion": "1.0",
  "EventTime": "2019-03-20T18:59:30.194Z",
  "Payload":
  {
    "MarketplaceId": "ATVPDKIKX0DER",
    "BrandName": "Great Brand",
    "Asin": "B1234567",
    "AttributesChanged": [
      "bullet_point",
      "item_name",
      "product_description",
      "main_product_image_locator",
      "other_product_image_locator_1",
      "other_product_image_locator_2",
      "other_product_image_locator_3",
      "other_product_image_locator_4",
      "other_product_image_locator_5",
      "other_product_image_locator_6",
      "other_product_image_locator_7",
      "other_product_image_locator_8",
      "swatch_product_image_locator"
    ]
  },
  "NotificationMetadata":
  {
    "ApplicationId": "amzn1.sellerapps.app.f1234566-aaec-55a6-b123-bcb752069ec5",
    "SubscriptionId": "93b098e1-c42-2f45-93a1-78910a6a8369",
    "PublishTime": "2019-03-20T18:59:48.768Z",
    "NotificationId": "8e009934-da2c-4f9c-9bc7-93f23b7e1f60"
  }
}

notificationType

Puedes suscribirse a las notificaciones, según el canal de venta pareja de información que desea recibir.

El siguiente notificationType valores indican el tipo de notificación:

• ACCOUNT_STATUS_CHANGED.Enviado cada vez que cambia el estado de la cuenta para los pares de selling partner /marketplace suscritos a los desarrolladores. Una notificación se publica cada vez que la venta de la pareja cuenta de los cambios de estado entre NORMAL, AT_RISK, y DEACTIVATED.
• ANY_OFFER_CHANGED. Enviado cada vez que hay un cambio en cualquiera de las 20 mejores ofertas, por estado (nuevo o usado), o si el externo precio (el precio de otras tiendas) cambios para un elemento de la lista por el seller.
• B2B_ANY_OFFER_CHANGED. Enviado cada vez que hay un cambio en cualquiera de los top 20 B2B Offers, en la forma de cualquier cambio de precio (ya sea de una sola unidad o cantidad de la capa de descuento de los precios) para un elemento de la lista por el seller.
• BRANDED_ITEM_CONTENT_CHANGE. Enviado cada vez que hay un cambio en el título, descripción, viñetas o imágenes, por cualquier ASIN que la selling partner tiene una marca en relación con.
• DETAIL_PAGE_TRAFFIC_EVENT: Enviado al comienzo de cada hora. Esta notificación comparte datos de tráfico a nivel de ASIN e incluye datos de la hora anterior, así como cualquier dato retrasado de hasta 24 horas antes. Cada notificación puede incluir varios ASIN y un selling partner puede esperar recibir varias notificaciones cada hora.
• FBA_INVENTORY_AVAILABILITY_CHANGES. Enviado cada vez que hay un cambio en el Cumplimiento Por parte de Amazon (FBA) las cantidades de inventario. Esta notificación incluye una instantánea de la FBA de inventario en todos los marketplaces en una región en particular.
• FBA_OUTBOUND_SHIPMENT_STATUS. Enviado cada vez que creamos o cancelar un Cumplimiento por parte de Amazon, el envío de un seller.
• FEE_PROMOTION. Se envía cuando una promoción se convierte en activo.
• FEED_PROCESSING_FINISHED. Enviado siempre a cualquier alimento enviadas mediante la selling partner API para Feeds alcanza un alimento estado de tramitación de DONE, CANCELLED o FATAL.
• FULFILLMENT_ORDER_STATUS. Enviado cada vez que hay un cambio en el estatus de un Multi-Canal de Cumplimiento de la orden.
• ITEM_INVENTORY_EVENT_CHANGE : Enviado al comienzo de cada hora. Esta notificación comparte datos de inventario a nivel de ASIN e incluye datos de la hora anterior, así como cualquier dato retrasado de hasta 24 horas antes. Cada notificación puede incluir varios ASIN y un socio de ventas puede esperar recibir varias notificaciones cada hora.
• ITEM_SALES_EVENT_CHANGE: Enviado al comienzo de cada hora. Esta notificación comparte datos de ventas a nivel de ASIN e incluye datos de la hora anterior, así como cualquier dato retrasado de hasta 24 horas antes. Cada notificación puede incluir varios ASIN y un socio de ventas puede esperar recibir varias notificaciones cada hora.
• ITEM_PRODUCT_TYPE_CHANGE. Enviado cada vez que hay un cambio en el tipo de producto nombre de cualquier ASIN que la selling partner tiene una marca en relación con.
• LISTINGS_ITEM_STATUS_CHANGE. Enviado siempre que haya un cambio en el estado de un artículo de una lista que posee un selling partner .
• LISTINGS_ITEM_ISSUES_CHANGE.Enviado siempre que haya un cambio en los problemas asociados con un artículo de una lista que el selling partner s posee.
• LISTINGS_ITEM_MFN_QUANTITY_CHANGE: Enviado cada vez que hay un cambio en la cantidad disponible de un artículo de listados.
• ORDER_CHANGE: Enviado siempre que haya un cambio importante en el pedido. Los cambios importantes incluyen cambios en el estado del pedido y cancelaciones solicitadas por el comprador.
• ORDER_STATUS_CHANGE. Enviado cada vez que hay un cambio en el estatus de la orden de la disponibilidad.
• PRICING_HEALTH. Enviado cada vez que un seller de la oferta no es elegible para ser la Oferta presentada (Compra de Cuadro de oferta) a causa de la falta de competitividad de los precios.
• PRODUCT_TYPE_DEFINITIONS_CHANGE. Enviado cada vez que hay un nuevo Tipo de Producto o Tipo de Producto Versión.
• REPORT_PROCESSING_FINISHED. Enviado siempre que cualquier reporte que se ha solicitado el uso de la la selling partner API de Reports alcanza un reporte de tramitación de DONE, CANCELLED o FATAL.

ACCOUNT_STATUS_CHANGED

Los selleres pueden suscribirse a esta notificación.

El ACCOUNT_STATUS_CHANGED notificación esEnviado cada vez que cambia el estado de la cuenta para los pares de selling partner /marketplace suscritos a los desarrolladores. Una notificación se publica cada vez que la venta de la pareja cuenta de los cambios de estado entre NORMAL, AT_RISK, y DEACTIVATED.

ACCOUNT_STATUS_CHANGED Payload schema: Version 2021-01-0

La siguiente tabla muestra las propiedades de la accountStatusChangeNotification:

Esquema de notificación: AccountStatusChangedNotification.json

Notificación ejemplo:

{
   "notificationVersion": "1.0",
   "notificationType": "ACCOUNT_STATUS_CHANGED",
   "payloadVersion": "2021-01-01",
   "eventTime": "2020-12-11T19:42:04.284Z",
   "payload": {
     "accountStatusChangeNotification": {
       "previousAccountStatus" : "NORMAL",
       "currentAccountStatus" : "AT_RISK"
     }
   },
   "notificationMetadata": {
     "applicationId": "amzn1.sellerapps.app.aacccfff-44aa-4b7c-b42b-ed4ec98dd746",
     "subscriptionId": "subscription-id-d0e9e693-c3ad-4373-979f-ed4ec98dd746",
     "publishTime": "2020-12-11T19:45:04.284Z",
     "notificationId": "d0e9e693-c3ad-4373-979f-ed4ec98dd746"
   }
 }

ANY_OFFER_CHANGED

Los selleres pueden suscribirse a esta notificación.

Esta notificación es compatible con los siguientes filtro de eventos de valores: aggregationSettings, marketplaceIds. El uso de estos filtros, también debe proporcionar la siguiente
eventFilterType: "eventFilterType": "ANY_OFFER_CHANGED".

Consulte Processing Directives para obtener más información.

El ANY_OFFER_CHANGED se enviará una notificación cada vez que hay un cambio en alguna de las 20 mejores ofertas, por estado (nuevo o usado), o si el externo precio (el precio de otras tiendas) cambios de un artículo que se vende, o si hay un cambio a la que Offersn gana el BuyBox, o un cambio a la BuyBox precio. El top 20 de las ofertas son determinados por la aristocracia de los precios, que es el precio más Shipping a menos de Amazon Points. Si varios selleres cobran el mismo precio de destino, los resultados se devolverán en orden aleatorio.

Sólo recibirá ANY_OFFER_CHANGED notificaciones para los elementos para los que tienen ofertas activas. Puede suscribirse a las notificaciones para los elementos para los que no tienen ofertas activas.

La tabla siguiente muestra los objects y las propiedades de la AnyOfferChangedNotification:

BuyBoxPrice

La tabla siguiente muestra los objects y las propiedades de la BuyBoxPrice:

LowestPrice

La tabla siguiente muestra los objects y las propiedades de la LowestPrice:

Offer

La tabla siguiente muestra los objetos y las propiedades de la Offer:

OfferChangeTrigger

La siguiente tabla muestra las propiedades de la OfferChangeTrigger:

OfferCount

La tabla siguiente muestra los objetos y las propiedades de la OfferCount:

Points

La siguiente tabla muestra las propiedades de los Points:

PrimeInformation

La tabla siguiente muestra los objetos y las propiedades de la PrimeInformation objeto:

SalesRank

La siguiente tabla muestra las propiedades de la SalesRank:

SellerFeedbackRating

La tabla siguiente muestra los objetos y las propiedades de la SellerFeedbackRating:

ShippingTime

La siguiente tabla muestra las propiedades de la ShippingTime:

ShipsFrom

La tabla siguiente muestra los objetos y las propiedades de la ShipsFrom:

Summary

La tabla siguiente muestra los objetos y las propiedades del Summary:

Esquema de notificación: AnyOfferChangedNotification.json

Notificación ejemplo:

{
  "NotificationVersion": "1.0",
  "NotificationType": "ANY_OFFER_CHANGED",
  "PayloadVersion": "1.0",
  "EventTime": "2020-01-11T00:09:53.109Z",
  "NotificationMetadata":
  {
    "ApplicationId": "amzn1.sellerapps.app.f1234566-aaec-55a6-b123-bcb752069ec5",
    "SubscriptionId": "7d78cc50-95c8-4641-add7-10af4b1fedc9",
    "PublishTime": "2020-01-11T00:02:50.501Z",
    "NotificationId": " 2012e8e5-b365-4cb1-9fd8-be9dfc6d5eaf"
  },
  "Payload":
  {
    "AnyOfferChangedNotification":
    {
      "SellerId": "merchantId",
      "OfferChangeTrigger":
      {
        "MarketplaceId": "marketplaceId",
        "ASIN": "ysp2k4cziG",
        "ItemCondition": "Collectible",
        "TimeOfOfferChange": "2020-01-11T00:02:50.501Z",
        "OfferChangeType": ""
      },
      "Summary":
      {
        "NumberOfOffers": [
          {
            "Condition": "new",
            "FulfillmentChannel": "Merchant",
            "OfferCount": 28
          }
        ],
        "LowestPrices": [
          {
            "Condition": "new",
            "FulfillmentChannel": "Merchant",
            "LandedPrice":
            {
              "Amount": 28.59,
              "CurrencyCode": "USD"
            },
            "ListingPrice":
            {
              "Amount": 28.59,
              "CurrencyCode": "USD"
            },
            "Shipping":
            {
              "Amount": 0,
              "CurrencyCode": "USD"
            }
          }
        ],
        "BuyBoxPrices": [
          {
            "Condition": "new",
            "LandedPrice":
            {
              "Amount": 14,
              "CurrencyCode": "USD"
            },
            "ListingPrice":
            {
              "Amount": 12,
              "CurrencyCode": "USD"
            },
            "Shipping":
            {
              "Amount": 2,
              "CurrencyCode": "USD"
            }
          }
        ],
        "ListPrice":
        {
          "Amount": 14,
          "CurrencyCode": "USD"
        },
        "SalesRankings": [
          {
            "ProductCategoryId": "lawn_and_garden_display_on_website",
            "Rank": 4013
          },
          {
            "ProductCategoryId": "home_garden_display_on_website",
            "Rank": 17316
          }
        ],
        "NumberOfBuyBoxEligibleOffers": [
          {
            "Condition": "new",
            "FulfillmentChannel": "Merchant",
            "OfferCount": 10
          }
        ]
      },
      "Offers": [
        {
          "SellerId": "AQNACJEM8PUJ1",
          "SubCondition": "new",
          "SellerFeedbackRating":
          {
            "FeedbackCount": 78786,
            "SellerPositiveFeedbackRating": 92
          },
          "ShippingTime":
          {
            "MinimumHours": 24,
            "MaximumHours": 48,
            "AvailabilityType": "",
            "AvailableDate": ""
          },
          "ListingPrice":
          {
            "Amount": 28.59,
            "CurrencyCode": "USD"
          },
          "Shipping":
          {
            "Amount": 0,
            "CurrencyCode": "USD"
          },
          "ShipsFrom":
          {
            "Country": "",
            "State": ""
          },
          "IsFulfilledByAmazon": false
        },
        {
          "SellerId": "A28SS3BS1DBQ92",
          "SubCondition": "new",
          "SellerFeedbackRating":
          {
            "FeedbackCount": 6532,
            "SellerPositiveFeedbackRating": 99
          },
          "ShippingTime":
          {
            "MinimumHours": 24,
            "MaximumHours": 48,
            "AvailabilityType": "",
            "AvailableDate": ""
          },
          "ListingPrice":
          {
            "Amount": 28.69,
            "CurrencyCode": "USD"
          },
          "Shipping":
          {
            "Amount": 0,
            "CurrencyCode": "USD"
          },
          "ShipsFrom":
          {
            "Country": "",
            "State": ""
          },
          "IsFulfilledByAmazon": false
        }
      ]
    }
  }
}

B2B_ANY_OFFER_CHANGED

Los Sellers pueden suscribirse a esta notificación.

El B2B_ANY_OFFER_CHANGED se enviará una notificación cada vez que hay un cambio en cualquiera de los top 20 B2B ofrece, en la forma de cualquier cambio de precio (ya sea de una sola unidad o cantidad de la capa de descuento de los precios) para un elemento de la lista por el Seller. El top 20 B2B ofrece son determinados por el de una sola unidad de aterrizó precio, que es el precio más gastos de envío. Si varios Sellers se están cargando el mismo aterrizó precio, los resultados se devuelven en orden aleatorio.

Sólo recibirá B2B_ANY_OFFER_CHANGED notificaciones para los elementos para los que el Seller tiene ofertas activas. Puede suscribirse a las notificaciones para los elementos para los que el Seller no tiene ofertas activas.

La tabla siguiente muestra los objetos y las propiedades de los b2b AnyOfferChangedNotification objeto:

BuyBoxPrice

La tabla siguiente muestra los objetos y las propiedades de la BuyBoxPrice.

LowestPrice

La tabla siguiente muestra los objetos y las propiedades de la LowestPrice tipo en Summary:

Offer

La tabla siguiente muestra los objetos y las propiedades de la Offer object:

OfferChangeTrigger

La siguiente tabla muestra las propiedades de la OfferChangeTrigger:

OfferCount

La tabla siguiente muestra los objetos y las propiedades de la OfferCount tipo:

PrimeInformation

La siguiente tabla muestra las propiedades de la PrimeInformation:

SellerFeedbackRating

La siguiente tabla muestra las propiedades de la SellerFeedbackRating:

ShippingTime

La siguiente tabla muestra las propiedades de la ShippingTime:

ShipsFrom

La siguiente tabla muestra las propiedades de la ShipsFrom objeto:

Summary

La tabla siguiente muestra los objetos y las propiedades del Summary:

Esquema de notificación: B2bAnyOfferChangedNotification.json

Notificación ejemplo:

{
  "notificationVersion": "1.0",
  "notificationType": "B2B_ANY_OFFER_CHANGED",
  "payloadVersion": "1.0",
  "eventTime": "2020-09-23T21:30:13.713Z",
  "notificationMetadata":
  {
    "applicationId": "amzn1.sellerapps.app.1da85d14-a68d-4ff3-9ff0-df6429e00d9a",
    "subscriptionId": "e3a059ca-677a-442a-8d39-05b2848971b6",
    "publishTime": "2020-09-23T21:30:16.903Z",
    "notificationId": "23ae41cd-3537-4676-af46-6ee9abf8802e"
  },
  "payload":
  {
    "b2bAnyOfferChangedNotification":
    {
      "sellerId": "A3EZFOFNDPFB8R",
      "offerChangeTrigger":
      {
        "marketplaceId": "ATVPDKIKX0DER",
        "asin": "B007IBIWZY",
        "itemCondition": "new",
        "timeOfOfferChange": "2020-09-23T21:30:13.409Z"
      },
      "summary":
      {
        "numberOfOffers": [
          {
            "condition": "new",
            "fulfillmentChannel": "Merchant",
            "offerCount": 3
          }
        ],
        "buyBoxEligibleOffers": [
          {
            "condition": "new",
            "fulfillmentChannel": "Merchant",
            "offerCount": 3
          }
        ],
        "lowestPrices": [
          {
            "condition": "new",
            "fulfillmentChannel": "Merchant",
            "offerType": "B2B",
            "quantityTier": 1,
            "listingPrice":
            {
              "amount": 8184.23,
              "currencyCode": "USD"
            },
            "shipping":
            {
              "amount": 4.49,
              "currencyCode": "USD"
            },
            "landedPrice":
            {
              "amount": 8188.72,
              "currencyCode": "USD"
            }
          },
          {
            "condition": "new",
            "fulfillmentChannel": "Merchant",
            "offerType": "B2B",
            "quantityTier": 20,
            "listingPrice":
            {
              "amount": 7500,
              "currencyCode": "USD"
            }
          },
          {
            "condition": "new",
            "fulfillmentChannel": "Merchant",
            "offerType": "B2B",
            "quantityTier": 30,
            "discountType": "QUANTITY_DISCOUNT",
            "listingPrice":
            {
              "amount": 6975,
              "currencyCode": "USD"
            }
          }
        ],
        "buyBoxPrices": [
          {
            "condition": "new",
            "offerType": "B2B",
            "quantityTier": 1,
            "listingPrice":
            {
              "amount": 8184.23,
              "currencyCode": "USD"
            },
            "shipping":
            {
              "amount": 4.49,
              "currencyCode": "USD"
            },
            "landedPrice":
            {
              "amount": 8188.72,
              "currencyCode": "USD"
            }
          },
          {
            "condition": "new",
            "offerType": "B2B",
            "quantityTier": 20,
            "discountType": "QUANTITY_DISCOUNT",
            "listingPrice":
            {
              "amount": 8000,
              "currencyCode": "USD"
            }
          },
          {
            "condition": "new",
            "offerType": "B2B",
            "quantityTier": 30,
            "discountType": "QUANTITY_DISCOUNT",
            "listingPrice":
            {
              "amount": 7800,
              "currencyCode": "USD"
            }
          }
        ]
      },
      "offers": [
        {
          "sellerId": "A2VUIDM8BZ902A",
          "subCondition": "new",
          "sellerFeedbackRating":
          {
            "feedbackCount": 1,
            "sellerPositiveFeedbackRating": 0
          },
          "shippingTime":
          {
            "minimumHours": 24,
            "maximumHours": 48,
            "availabilityType": "available",
            "availableDate": "2020-07-13T19:42:04.284Z"
          },
          "listingPrice":
          {
            "amount": 8184.23,
            "currencyCode": "USD"
          },
          "shipping":
          {
            "amount": 4.49,
            "currencyCode": "USD"
          },
          "shipsFrom":
          {
            "country": "US"
          },
          "isFulfilledByAmazon": false,
          "isBuyBoxWinner": true,
          "conditionNotes": "New in box",
          "primeInformation":
          {
            "isPrime": true,
            "isNationalPrime": true
          },
          "isFeaturedMerchant": true
        }
      ]
    }
  }
}

BRANDED_ITEM_CONTENT_CHANGE

Los Sellers pueden suscribirse a esta notificación.

Amazon envía un BRANDED_ITEM_CONTENT_CHANGE notificación cada vez que hay un cambio en el título, descripción, viñetas o imágenes, por cualquier ASIN que la selling partner tiene una marca en relación con. Venta pareja tiene una marca en relación con un ASIN, tal como se define en el Amazonas Marcas Registradas programa, cuando están verificado el propietario de la marca. La selling partner es la parte que autoriza una aplicación para llamar a los de la API de Notificaciones en su nombre, para el propósito de la creación y la gestión de suscripciones de notificación. Amazon envía BRANDED_ITEM_CONTENT_CHANGE notificaciones para los elementos de la lista en cualquier Amazon marketplace.

BRANDED_ITEM_CONTENT_CHANGE Payload schema: Version 1.0

Un BRANDED_ITEM_CONTENT_CHANGE notificación con PayloadVersion=1.0 incluye las siguientes propiedades en la Payload del objeto.

Esquema de notificación: BrandedItemContentChangeNotification.json

Notificación ejemplo:

{
  "NotificationVersion": "1.0",
  "NotificationType": "BRANDED_ITEM_CONTENT_CHANGE",
  "PayloadVersion": "1.0",
  "EventTime": "2019-03-20T18:59:30.194Z",
  "Payload":
  {
    "MarketplaceId": "ATVPDKIKX0DER",
    "BrandName": "Great Brand",
    "Asin": "B1234567",
    "AttributesChanged": [
      "bullet_point",
      "item_name",
      "product_description",
      "main_product_image_locator",
      "other_product_image_locator_1",
      "other_product_image_locator_2",
      "other_product_image_locator_3",
      "other_product_image_locator_4",
      "other_product_image_locator_5",
      "other_product_image_locator_6",
      "other_product_image_locator_7",
      "other_product_image_locator_8",
      "swatch_product_image_locator"
    ]
  },
  "NotificationMetadata":
  {
    "ApplicationId": "amzn1.sellerapps.app.f1234566-aaec-55a6-b123-bcb752069ec5",
    "SubscriptionId": "93b098e1-c42-2f45-93a1-78910a6a8369",
    "PublishTime": "2019-03-20T18:59:48.768Z",
    "NotificationId": "8e009934-da2c-4f9c-9bc7-93f23b7e1f60"
  }
}

DETAIL_PAGE_TRAFFIC_EVENT

Los Sellers y Sellers pueden suscribirse a esta notificación.

La notificación DETAIL_PAGE_TRAFFIC_EVENT se envía cinco minutos después del comienzo de cada hora. Esta notificación comparte datos de tráfico a nivel de ASIN e incluye datos de la hora anterior a la hora anterior, así como cualquier dato retrasado de hasta 24 horas antes. Se incluyen los ASIN que tienen vistas rápidas. Cada notificación puede incluir varios ASIN y un selling partner puede esperar recibir varias notificaciones cada hora.

DetailPageTrafficEventNotifications

La siguiente tabla muestra los objetos DetailPageTrafficEventNotifications y las propiedades del objeto:

DetailPageTrafficEventNotification

Esquema de notificación: DetailPageTrafficEventNotification

Ejemplo de notificación:

{
  "notificationVersion": "2020-09-04",
  "notificationType": "DETAIL_PAGE_TRAFFIC_EVENT",
  "payloadVersion": "2020-09-04",
  "eventTime": "2023-02-07T16:05:32.378Z",
  "payload": {
    "detailPageTrafficEventNotifications": [
      {
        "accountId": "amzn1.merchant.o.A21CXK3C4ERTY8",
        "marketplaceId": "ATVPDKIKX0DER",
        "startTime": "2023-02-07T15:00:00Z",
        "endTime": "2023-02-07T16:00:00Z",
        "asin": "B00032HE0O",
        "glanceViews": 42
      }, {
        "accountId": "amzn1.merchant.o.A21CXK3C4ERTY8",
        "marketplaceId": "ATVPDKIKX0DER",
        "startTime": "2023-02-07T15:00:00Z",
        "endTime": "2023-02-07T16:00:00Z",
        "asin": "B00094A20U",
        "glanceViews": 69
      }
    ]
  },
  "notificationMetadata": {
    "applicationId": "amzn1.sellerapps.app.aacccfff-4455-4b7c-4422-664ecacdd336",
    "subscriptionId": "d0e9e693-c3ad-4373-979f-ed4ec98dd746",
    "publishTime": "2023-02-07T16:45:32.378Z",
    "notificationId": "d0e9e693-c3ad-4373-979f-ed4ec98dd746"
  }
}

FBA_INVENTORY_AVAILABILITY_CHANGES

Los Sellers pueden suscribirse a esta notificación.

La FBA_INVENTORY_AVAILABILITY_CHANGES notificación se envía cada vez que hay un cambio en el Cumplimiento Por parte de Amazon (FBA) las cantidades de inventario. Esta notificación incluye una instantánea de la FBA de inventario en todos los marketplaces en una región en particular.

FBAInventoryAvailabilityChangeNotification

La tabla siguiente muestra los objetos y las propiedades de los objetos FBAInventoryAvailabilityChangeNotification:

FulfillmentInventoryDetails

La siguiente tabla describe los objetos y las propiedades de un objeto FulfillmentInventoryDetails:

FulfillmentInventory

La siguiente tabla describe los objetos y las propiedades de un objeto FulfillmentInventory:

InboundQuantityBreakdown

La siguiente tabla describe los objetos y las propiedades de un objeto InboundQuantityBreakdown:

ReservedQuantityBreakdown

La siguiente tabla describe los objetos y las propiedades de un objeto ReservedQuantityBreakdown:

Esquema de notificación: FBAInventoryAvailabilityChangeNotification.json

Notificación ejemplo:

{
  "NotificationVersion": "1.0",
  "NotificationType": "FBA_INVENTORY_AVAILABILITY_CHANGES",
  "PayloadVersion": "1.0",
  "EventTime": "2020-07-13T19:42:04.284Z",
  "Payload": {
    "SellerId": "A3TH9S8BH6GOGM",
    "FNSKU": "X001ABCDEF",
    "ASIN": "B00001ABCD",
    "SKU": "SELLERSKU-1",
    "FulfillmentInventoryByMarketplace":[
      {
        "MarketplaceId": "ATVPDKIKX0DER",
        "ItemName": "Product Title",
        "FulfillmentInventory": {
          "InboundQuantityBreakdown":{
            "Working": 0,
            "Shipped": 5,
            "Receiving": 10
          },
          "Fulfillable": 50,
          "Unfulfillable":0,
          "Researching": 0,
          "ReservedQuantityBreakdown": {
            "WarehouseProcessing": 5,
            "WarehouseTransfer": 15,
            "PendingCustomerOrder": 10
          },
          "FutureSupplyBuyable":10,
          "PendingCustomerOrderInTransit":0
        }
      },
      {
        "MarketplaceId": "A2EUQ1WTGCTBG2",
        "ItemName": "Product Title",
        "FulfillmentInventory": {
          "InboundQuantityBreakdown":{
            "Working": 1,
            "Shipped": 2,
            "Receiving": 3
          },
          "Fulfillable": 40,
          "Unfulfillable":0,
          "Researching": 0,
          "ReservedQuantityBreakdown": {
            "WarehouseProcessing": 5,
            "WarehouseTransfer": 15,
            "PendingCustomerOrder": 10
          },
          "FutureSupplyBuyable":0,
          "PendingCustomerOrderInTransit":0
        }
      }
    ]
  },
  "NotificationMetadata": {
    "ApplicationId": "app-id-d0e9e693-c3ad-4373-979f-ed4ec98dd746",
    "SubscriptionId": "subscription-id-d0e9e693-c3ad-4373-979f-ed4ec98dd746",
    "PublishTime": "2020-07-13T19:42:04.284Z",
    "NotificationId": "d0e9e693-c3ad-4373-979f-ed4ec98dd746"
  }
}

FBA_OUTBOUND_SHIPMENT_STATUS

Los Sellers pueden suscribirse a esta notificación.

El FBA_OUTBOUND_SHIPMENT_STATUS se enviará una notificación cada vez que Amazon crea o cancela un Cumplimiento por parte de Amazon, el envío de un Seller. Esta notificación sólo es para FBA in Situ de los envíos. Esta notificación se encuentra disponible sólo en el marketplace de Brasil.

FBAOutboundShipmentStatusNotification

La tabla siguiente muestra los objetos y las propiedades de la FBAOutboundShipmentStatusNotification objeto:

Esquema de notificación: FBAOutboundShipmentStatusNotification.json

Notificación ejemplo:

{
  "NotificationVersion": "1.0",
  "NotificationType": "FBA_OUTBOUND_SHIPMENT_STATUS",
  "PayloadVersion": "1.0",
  "EventTime": "2020-01-11T00:09:53.109Z",
  "Payload":
  {
    "FBAOutboundShipmentStatusNotification":
    {
      "SellerId": "merchantId",
      "AmazonOrderId": "113-2646096-4474645",
      "AmazonShipmentId": "DrLqQwqvb",
      "ShipmentStatus": "Created"
    }
  },
  "NotificationMetadata":
  {
    "ApplicationId": "appId",
    "SubscriptionId": "subId",
    "PublishTime": "2020-01-11T00:02:50.501Z",
    "NotificationId": "requestId"
  }
}

FEE_PROMOTION

Los Sellers pueden suscribirse a esta notificación.

Los Sellers mediante selling partner API se pueden beneficiar de tiempo limitado cuota de promociones. Para recibir la notificación de la disposición de la cuota de promociones, los Sellers deben suscribirse a la FEE_PROMOTION notificación. Cuando el Seller inicialmente signos para la suscripción y isEnabled se establece a true, el Seller recibe todos los actualmente activos promociones. Cada promoción se envía como un mensaje único. Posterior promoción notificaciones se envían cuando la promoción se convierte en activo.

El FEE_PROMOTION notificación se compone de un conjunto de campos de datos que describe los detalles de la promoción. Todos los criterios de calificación para cada promoción se describe en los campos de datos.

Nota: La estimación de las tasas devuelto por esta API no están garantizados. Los honorarios reales pueden variar. Para obtener más información acerca de las comisiones, consulte Selling on Amazon Fee Schedule y FBA features and fees de Seller Central.

FeeDetail

La tabla siguiente muestra los objetos y las propiedades de un FeeDetail:

FeesEstimate

La tabla siguiente muestra los objetos y las propiedades de la FeesEstimate:

FeePromotionNotification

Cada FeePromotionNotification objeto se compone de los siguientes objetos de datos:

Identifier

La siguiente tabla describe los objetos y las propiedades de un objeto a partir de los Identificadores de la Array:

IdentifierValue

Una descripción de los valores de identificador para que esta promoción se aplica.

PromotionInformation

La tabla siguiente muestra los objetos y las propiedades de la PromotionInformation:

PromotionActiveTimeRange

La siguiente tabla muestra las propiedades de la PromotionActiveTimeRange:

Esquema de notificación: FeePromotionNotification.json

Notificación ejemplo:

{
  "NotificationVersion": "1.0",
  "NotificationType": "FEE_PROMOTION",
  "PayloadVersion": "1.0",
  "EventTime": "2020-01-11T00:09:53.109Z",
  "NotificationMetadata":
  {
    "ApplicationId": "amzn1.sellerapps.app.f1234566-aaec-55a6-b123-bcb752069ec5",
    "SubscriptionId": "7d78cc50-95c8-4641-add7-10af4b1fedc9",
    "PublishTime": "2020-01-11T00:02:50.501Z",
    "NotificationId": " 2012e8e5-b365-4cb1-9fd8-be9dfc6d5eaf"
  },
  "Payload":
  {
    "FeePromotionNotification":
    {
      "MerchantId": "merchantId",
      "MarketplaceId": "marketplaceId1",
      "FeePromotionType": "Pricing",
      "FeePromotionTypeDescription": "To help you offer a lower price to customers, we are offering you a temporary referral fee discount for every sale when the total sale price (price + shipping+ gift wrap) is at or below the pricing threshold.",
      "PromotionActiveTimeRange":
      {
        "EffectiveFromDate": "2016-05-04T22:24:39.615Z",
        "EffectiveThroughDate": "2016-04-28T02:45:12.786Z"
      },
      "Identifiers": [
        {
          "IdentifierType": "ASIN",
          "IdentifierValues": [
            {
              "IdentifierValueId": "B0000000",
              "IdentifierValueFriendlyName": "1234"
            }
          ]
        }
      ],
      "PromotionInformations": [
        {
          "FeeType": "ReferralFee",
          "FeeDiscountType": "Percentage points off",
          "FeeDiscountValue": 5,
          "PriceThreshold":
          {
            "Amount": 1,
            "CurrencyCode": "USD"
          },
          "FeesEstimate":
          {
            "TimeOfFeesEstimated": "2016-05-05T22:24:39.635Z",
            "TotalFeesEstimate":
            {
              "Amount": 10,
              "CurrencyCode": "USD"
            },
            "FeeDetails": [
              {
                "FeeType": "feeType",
                "FeeAmount":
                {
                  "Amount": 1,
                  "CurrencyCode": "USD"
                },
                "FeePromotion":
                {
                  "Amount": 0.8,
                  "CurrencyCode": "USD"
                },
                "FinalFee":
                {
                  "Amount": 0.2,
                  "CurrencyCode": "USD"
                }
              }
            ]
          }
        }
      ]
    }
  }
}

FEED_PROCESSING_FINISHED

Los Sellers pueden suscribirse a esta notificación.

El FEED_PROCESSING_FINISHED se enviará una notificación cada vez que cualquier alimento enviadas mediante selling partner API para Feeds alcanza un alimento estado de tramitación de HECHO, CANCELADOS o FATAL.

FEED_PROCESSING_FINISHED Payload schema: Version 1.0

Un FEED_PROCESSING_FINISHED notificación con PayloadVersion=2020-09-04 incluye los siguientes objetos en la feedProcessingFinishedNotification objeto.

Esquema de notificación: FeedProcessingFinishedNotification.json

Notificación ejemplo:

{
  "notificationVersion": "2020-09-04",
  "notificationType": "FEED_PROCESSING_FINISHED",
  "payloadVersion": "2020-09-04",
  "eventTime": "2020-07-13T19:42:04.284Z",
  "payload":
  {
    "feedProcessingFinishedNotification":
    {
      "sellerId": "A3TH9S8BH6GOGM",
      "feedId": "53347018456",
      "feedType": "POST_PRODUCT_DATA",
      "processingStatus": "DONE",
      "resultFeedDocumentId": "amzn1.tortuga.3.edbcd0d8-3434-8222-1234-52ad8ade1208.URUTI57URI9BMZ"
    }
  },
  "notificationMetadata":
  {
    "applicationId": "amzn1.sellerapps.app.aacccfff-44aa-4b7c-b42b-ed4ec98dd746",
    "subscriptionId": "subscription-id-d0e9e693-c3ad-4373-979f-ed4ec98dd746",
    "publishTime": "2020-07-13T19:42:04.284Z",
    "notificationId": "d0e9e693-c3ad-4373-979f-ed4ec98dd746"
  }
}

FULFILLMENT_ORDER_STATUS

Los Sellers pueden suscribirse a esta notificación.

El FULFILLMENT_ORDER_STATUS se enviará una notificación cada vez que hay un cambio en el estatus de un Multi-Canal de Cumplimiento de cumplimiento de la orden.

FulfillmentOrderStatusNotification

La tabla siguiente muestra los objetos y las propiedades de la FulfillmentOrderStatusNotification:

FulfillmentReturnItem

La tabla siguiente muestra los objetos y las propiedades de la FulfillmentReturnItem:

FulfillmentShipment

La tabla siguiente muestra los objetos y las propiedades de la FulfillmentShipment objeto:

FulfillmentShipmentPackage

La tabla siguiente muestra los objetos y las propiedades de la FulfillmentShipmentPackage:

Esquema de notificación: FulfillmentOrderStatusNotification.json

Notificación ejemplo:

{
  "NotificationVersion": "1.0",
  "NotificationType": "FULFILLMENT_ORDER_STATUS",
  "PayloadVersion": "1.0",
  "EventTime": "2020-01-11T00:09:53.109Z",
  "Payload":
  {
    "FulfillmentOrderStatusNotification":
    {
      "SellerId": "merchantId",
      "EventType": "Shipment",
      "StatusUpdatedDateTime": "2020-01-11T00:09:53.109Z",
      "SellerFulfillmentOrderId": "OrderId",
      "FulfillmentOrderStatus": "Complete",
      "FulfillmentShipment":
      {
        "FulfillmentShipmentStatus": "Shipped",
        "AmazonShipmentId": "DZRSmwG2N",
        "EstimatedArrivalDateTime": "2014-12-19T22:59:59Z",
        "FulfillmentShipmentPackages": [
          {
            "PackageNumber": 1,
            "CarrierCode": "HERMESIT",
            "TrackingNumber": "&0113838XXXXXX8300169397"
          }
        ]
      }
    }
  },
  "NotificationMetadata":
  {
    "ApplicationId": "amzn1.sellerapps.app.f1234566-aaec-55a6-b123-bcb752069ec5",
    "SubscriptionId": "7d78cc50-95c8-4641-add7-10af4b1fedc9",
    "PublishTime": "2020-01-11T00:02:50.501Z",
    "NotificationId": " 2012e8e5-b365-4cb1-9fd8-be9dfc6d5eaf"
  }
}

ITEM_INVENTORY_EVENT_CHANGE

La notificación ITEM_INVENTORY_EVENT_CHANGE se envía cinco minutos después del comienzo de cada hora. Esta notificación comparte datos de inventario a nivel de ASIN e incluye datos de la hora anterior, así como cualquier dato retrasado de hasta 24 horas antes. Los ASIN se incluyen si la cantidad de unidades disponibles para la compra
por parte de los clientes ha cambiado. Cada notificación puede incluir varios ASIN y un selling partner puede esperar recibir varias notificaciones cada hora.

ItemInventoryEventChangeNotifications

ItemInventoryEventChangeNotification

Esquema de notificación: ItemInventoryEventChangeNotification

Ejemplo de notificación:

{
 "notificationVersion": "2020-09-04",
 "notificationType": "ITEM_INVENTORY_EVENT_CHANGE",
 "payloadVersion": "2020-09-04",
 "eventTime": "2023-02-07T16:05:32.378Z",
 "payload": {
   "itemInventoryEventChangeNotifications": [
     {
       "accountId": "amzn1.merchant.o.A21CXK3C4ERTY8",
       "marketplaceId": "ATVPDKIKX0DER",
       "startTime": "2023-02-07T15:00:00Z",
       "endTime": "2023-02-07T16:00:00Z",
       "asin": "B00032HE0O",
       "highlyAvailableInventory": 650
     }, {
       "accountId": "amzn1.merchant.o.A21CXK3C4ERTY8",
       "marketplaceId": "ATVPDKIKX0DER",
       "startTime": "2023-02-07T15:00:00Z",
       "endTime": "2023-02-07T16:00:00Z",
       "asin": "B00094A20U",
       "highlyAvailableInventory": 519
     }
   ]
 },
 "notificationMetadata": {
   "applicationId": "amzn1.sellerapps.app.aacccfff-4455-4b7c-4422-664ecacdd336",
   "subscriptionId": "d0e9e693-c3ad-4373-979f-ed4ec98dd746",
   "publishTime": "2023-02-07T16:45:32.378Z",
   "notificationId": "d0e9e693-c3ad-4373-979f-ed4ec98dd746"
 }
}

ITEM_SALES_EVENT_CHANGE

Los Sellers y Sellers pueden suscribirse a esta notificación.

La notificación ITEM_SALES_EVENT_CHANGE se envía cinco minutos después del comienzo de cada hora. Esta notificación comparte datos de ventas a nivel de ASIN e incluye datos de la hora anterior, así como cualquier dato retrasado de hasta 24 horas antes. Los ASIN se incluyen cuando tienen pedidos o cancelaciones durante una hora determinada. Cada notificación puede incluir varios ASIN y un selling partner puede esperar recibir varias notificaciones cada hora.

ItemSalesEventNotifications

ItemSalesEventChangeNotification

Esquema de notificación: ItemSalesEventChangeNotification

Ejemplo de notificación:

{
  "notificationVersion": "2020-09-04",
  "notificationType": "ITEM_SALES_EVENT_CHANGE",
  "payloadVersion": "2020-09-04",
  "eventTime": "2023-02-07T16:05:32.378Z",
  "payload": {
    "itemSalesEventChangeNotifications": [
      {
        "accountId": "amzn1.merchant.o.A21CXK3C4ERTY8",
        "marketplaceId": "ATVPDKIKX0DER",
        "currencyCode": "USD",
        "startTime": "2023-02-07T15:00:00Z",
        "endTime": "2023-02-07T16:00:00Z",
        "asin": "B00032HE0O",
        "orderedUnits": 9,
        "orderedRevenue": 80.91
      }, {
        "accountId": "amzn1.merchant.o.A21CXK3C4ERTY8",
        "marketplaceId": "ATVPDKIKX0DER",
        "currencyCode": "USD",
        "startTime": "2023-02-07T15:00:00Z",
        "endTime": "2023-02-07T16:00:00Z",
        "asin": "B00094A20U",
        "orderedUnits": 5,
        "orderedRevenue": 527.60
      }
    ]
  },
  "notificationMetadata": {
    "applicationId": "amzn1.sellerapps.app.aacccfff-4455-4b7c-4422-664ecacdd336",
    "subscriptionId": "d0e9e693-c3ad-4373-979f-ed4ec98dd746",
    "publishTime": "2023-02-07T16:45:32.378Z",
    "notificationId": "d0e9e693-c3ad-4373-979f-ed4ec98dd746"
  }
}

ITEM_PRODUCT_TYPE_CHANGE

Los Sellers pueden suscribirse a esta notificación.

Amazon envía un ITEM_PRODUCT_TYPE_CHANGE notificación cada vez que hay un cambio en el tipo de producto en cualquier punto de que la selling partner tiene una marca en relación con. Venta pareja tiene una marca en relación con un elemento, tal como se define en el Amazonas Marcas Registradas programa, cuando están verificado el propietario de la marca. La selling partner es la parte que autoriza una aplicación para llamar a los de la API de Notificaciones en su nombre, para el propósito de la creación y la gestión de suscripciones de notificación. Amazon envía ITEM_PRODUCT_TYPE_CHANGE notificaciones para los elementos de la lista en cualquier Amazon marketplace.

ITEM_PRODUCT_TYPE_CHANGE Payload schema: Version 1.0

Un ITEM_PRODUCT_TYPE_CHANGE notificación con PayloadVersion=1.0 incluye los siguientes objetos en la Payload del objeto.

Esquema de notificación: ItemProductTypeChangeNotification.json

Notificación ejemplo:

{
  "NotificationVersion":"1.0",
  "NotificationType":"ITEM_PRODUCT_TYPE_CHANGE",
  "PayloadVersion":"1.0",
  "EventTime":"2019-03-20T18:59:30.194Z",
  "Payload":{ 
    "MarketplaceId": "ATVPDKIKX0DER",
    "Asin": "B1234567",
    "PreviousProductType": "PET_HEALTH_CARE",
    "CurrentProductType": "PET_APPAREL"
  },
  "NotificationMetadata":{
    "ApplicationId":"amzn1.sellerapps.app.f1234566-aaec-55a6-b123-bcb752069ec5",
    "SubscriptionId":"93b098e1-c42-2f45-93a1-78910a6a8369",
    "PublishTime":"2019-03-20T18:59:48.768Z",
    "NotificationId":"0e999936-da2c-4f9c-9fc2-02b67bae5f49"
  }
}

LISTINGS_ITEM_STATUS_CHANGE

Los Sellers pueden suscribirse a esta notificación.

Amazon envía un LISTINGS_ITEM_STATUS_CHANGE notificación cuando el estado de un listados de elemento de cambios para una selling partner . LISTINGS_ITEM_STATUS_CHANGE notificaciones se publican cuando una listados elemento es creado, eliminado, o su buyability cambios. La carga de la notificación proporciona la listas de los elemento de la información y el estado. Amazon envía LISTINGS_ITEM_STATUS_CHANGE notificaciones para los elementos de la lista en cualquier Amazon marketplace.

Para recuperar adicionales asociados detalles acerca de la inclusión, como los listados elemento de problemas, llame a la selling partner API para los Listados de Elementos. Para obtener más información, consulte los Guía de casos de uso de la Listings Items API v2021-08-01.

La selling partner es la parte que autoriza una aplicación para llamar a las Notificaciones de la API en su nombre para el propósito de la creación y la gestión de suscripciones de notificación.

LISTINGS_ITEM_STATUS_CHANGE Payload schema: Version 1.0

Un LISTINGS_ITEM_STATUS_CHANGE notificación con PayloadVersion=1.0 incluye los siguientes objetos en la Payload del objeto.

ListingsItemStatus

Esta tabla muestra los posibles valores para ListingsItemStatus:

Esquema de notificación: ListingsItemStatusChangeNotification.json

Notificación ejemplo:

{
  "NotificationVersion":"1.0",
  "NotificationType":"LISTINGS_ITEM_STATUS_CHANGE",
  "PayloadVersion":"1.0",
  "EventTime":"2021-02-03T18:59:30.194Z",
  "Payload":{ 
    "SellerId": "AXXXXXXXXXXXXX",
    "MarketplaceId": "ATVPDKIKX0DER",
    "Asin": "BT6RZ7JM4H",
    "Sku": "NLS-SHOES-03",
    "CreatedDate": "2021-02-03T18:50:26.196Z",
    "Status": [
      "BUYABLE",
      "DISCOVERABLE"
    ]
  },
  "NotificationMetadata":{
    "ApplicationId":"amzn1.sellerapps.app.f1234566-aaec-55a6-b123-bcb752069ec5",
    "SubscriptionId":"93b098e1-c42-2f45-93a1-78910a6a8369",
    "PublishTime":"2021-02-03T18:59:30.194Z",
    "NotificationId":"0e999936-da2c-4f9c-9fc2-02b67bae5f49"
  }
}

LISTINGS_ITEM_ISSUES_CHANGE

Los Sellers y los Sellers pueden suscribirse a esta notificación.

Amazon envía un LISTINGS_ITEM_ISSUES_CHANGE notificación cada vez que hay un cambio en las cuestiones relacionadas con los listados de los elementos que la selling partner titular. Problemas de señalar que los listados elemento tiene problemas que causa listado de inactivos, la búsqueda de la represión, o de otros problemas de calidad. Por ejemplo, si la venta de la pareja de la imagen del producto tiene baja resolución, este tema hará que la búsqueda de la supresión de este producto. Amazon envía LISTINGS_ITEM_ISSUES_CHANGE notificaciones para los elementos de la lista en cualquier Amazon marketplace.

LISTINGS_ITEM_ISSUES_CHANGE las notificaciones se activan cuando un problema en un listado se crea, fija, o actualizada. La carga de la notificación incluye el listado básico de información, relacionados con la gravedad del problema y las acciones de cumplimiento causado por problemas. Para recuperar más detalles acerca de los problemas asociados con una lista, llame a la selling partner API for Listings Items. Para obtener más información, consulte los Guía de casos de uso de la Listings Items API v2021-08-01.

Todos los problemas que pueden ocurrir con un listado de no corresponden con las definidas problemas. Como resultado, esta notificación no representan necesariamente todos los problemas con un listado (tampoco la selling partner API for Listings Items). Amazon está trabajando para definir más cuestiones más estrechamente representan los listados de los problemas que pueden ocurrir.

La selling partner es la parte que autoriza una aplicación para llamar a las Notificaciones de la API en su nombre para el propósito de la creación y la gestión de suscripciones de notificación.

LISTINGS_ITEM_ISSUES_CHANGE Payload schema: Version 1.0

Un LISTINGS_ITEM_ISSUES_CHANGE notificación con PayloadVersion=1.0 incluye los siguientes objetos en la Payload del objeto.

IssueSeverity

Esta tabla muestra los posibles valores para IssueSeverity:

IssueEnforcementActions

Esta tabla muestra los posibles valores para IssueEnforcementActions:

Esquema de notificación: ListingsItemIssuesChangeNotification.json

Notificación ejemplo:

{
  "NotificationVersion":"1.0",
  "NotificationType":"LISTINGS_ITEM_ISSUES_CHANGE",
  "PayloadVersion":"1.0",
  "EventTime":"2021-02-03T18:59:30.194Z",
  "Payload":{ 
    "SellerId": "AXXXXXXXXXXXXX",
    "MarketplaceId": "ATVPDKIKX0DER",
    "Asin": "BT6RZ7JM4H",
    "Sku": "NLS-SHOES-03",
    "Severities": [
      "ERROR",
      "WARNING"
    ],
    "EnforcementActions": [
      "SEARCH_SUPPRESSED"
    ]
  },
  "NotificationMetadata":{
    "ApplicationId":"amzn1.sellerapps.app.f1234566-aaec-55a6-b123-bcb752069ec5",
    "SubscriptionId":"93b098e1-c42-2f45-93a1-78910a6a8369",
    "PublishTime":"2021-02-03T18:59:30.194Z",
    "NotificationId":"0e999936-da2c-4f9c-9fc2-02b67bae5f49"
  }
}

LISTINGS_ITEM_MFN_QUANTITY_CHANGE

Los Sellers pueden suscribirse a esta notificación.

Amazon envía una notificación LISTINGS_ITEM_MFN_QUANTITY_CHANGE a un integrador o Seller cada vez que cambia la cantidad disponible para el artículo del listado gestionado por el Seller (MFN). La cantidad disponible es la cantidad de unidades disponibles en Amazon para que los clientes realicen pedidos. Cuando un cliente realiza un pedido, Amazon reduce la cantidad de unidades pedidas de la cantidad disponible para ese artículo de la lista. Cuando la cantidad disponible llega a cero, los clientes ya no pueden realizar pedidos del artículo. Los selling partner suelen actualizar a Amazon con la cantidad exacta de unidades disponibles en sus existencias para permitir que los clientes realicen pedidos.

La cantidad disponible para un artículo de listado cambia debido a varios factores, como las actualizaciones de cantidad de inventario del partner de ventas, la realización de nuevos pedidos y la cancelación de pedidos existentes. Con esta notificación, los selling partner suscritos ya no necesitan sondear constantemente la operación de selling partner getListingsItem o la Orders API para recuperar la última cantidad disponible.

Las características clave de esta notificación son:

• Los selling partner se mantienen actualizados sobre el inventario real disponible en Amazon.
• Los selling partner s planifican con anticipación en función de los niveles de inventario para satisfacer la demanda de los artículos de sus listados.
• Los selling partner sincronizan y actualizan los niveles de inventario de los artículos de sus listados con sus sistemas internos y en sus otros canales de ventas.
• Los selling partner no necesitan sondear con frecuencia el reporte de inventario o llamar a la operación de selling partner getListingsItem para determinar la cantidad disponible.

LISTINGS_ITEM_MFN_QUANTITY_CHANGE Payload schema: Version 1.0

Una notificación LISTINGS_ITEM_MFN_QUANTITY_CHANGE con PayloadVersion = 1.0 incluye las siguientes propiedades en el objeto Payload .

Esquema de notificación : ListingsItemMfnQuantityChange.json

Ejemplo de notificación :

{
  "NotificationVersion": "1.0",
  "NotificationType": "LISTINGS_ITEM_MFN_QUANTITY_CHANGE",
  "PayloadVersion": "1.0",
  "EventTime": "2021-02-03T18:59:30.194Z",
  "Payload": {
    "SellerId": "AXXXXXXXXXXXXX",
    "FulfillmentChannelCode": "DEFAULT",
    "Sku": "NLS-SHOES-03",
    "Quantity": 99
  },
  "NotificationMetadata": {
    "ApplicationId": "amzn1.sellerapps.app.f108f511-eeac-46a6-b125-bcb752069ed0",
    "SubscriptionId": "93b098e1-c42-2f45-93a1-78910a6a8369",
    "PublishTime": "2021-02-03T18:59:30.194Z",
    "NotificationId": "8e009934-da2c-4f9c-9bc7-93f23b7e1f60"
  }
}

ORDER_CHANGE

Los Sellers pueden suscribirse a esta notificación.

La notificación ORDER_CHANGE se envía cada vez que hay un cambio importante en el pedido. Los cambios importantes incluyen cambios en el estado del pedido y cancelaciones solicitadas por el comprador.

ORDER_CHANGE Payload schema: Version 1.0

Un ORDER_CHANGE notificación con PayloadVersion=1.0 incluye las siguientes propiedades en el objeto OrderNotification.

OrderChangeReason

OrderChangeSummary

OrderItem

Esquema de notificación: OrderChangeNotification.json

Notificación ejemplo:

{
  "NotificationVersion" : "1.0",
  "NotificationType" : "ORDER_CHANGE",
  "PayloadVersion" : "1.0",
  "EventTime" : "2020-01-11T00:09:53.109Z",
  "Payload" : {
    "OrderChangeNotification": {
      "NotificationLevel": "OrderLevel",
      "SellerId": "A3TH9S8BH6GOGM",
      "AmazonOrderId": "903-8868176-2219830",
      "OrderChangeType": "BuyerRequestedChange",
      "OrderChangeTrigger": {
        "TimeOfOrderChange": "2022-11-29T19:42:04.284Z",
        "ChangeReason": "Buyer Requested Cancel"
      },
      "Summary": {
        "MarketplaceId": "ATVPDKIKX0DER",
        "OrderStatus": "Unshipped",
        "PurchaseDate": "2022-07-13T19:42:04.284Z",
        "DestinationPostalCode": "48110",
        "FulfillmentType": "MFN",
        "OrderType": "StandardOrder",
        "NumberOfItemsShipped": 0,
        "NumberOfItemsUnshipped": 10,
        "EarliestDeliveryDate": "2022-11-07T19:42:04.284Z",
        "LatestDeliveryDate": "2022-12-07T19:42:04.284Z",
        "EarliestShipDate": "2022-11-07T19:42:04.284Z",
        "LatestShipDate": "2022-12-07T19:42:04.284Z",
        "CancelNotifyDate": "2022-12-07T19:42:04.284Z",
        "OrderPrograms": ["Business"],
        "ShippingPrograms": ["EasyShip"],
        "EasyShipShipmentStatus": "Delivered",
        "ElectronicInvoiceStatus": "NotFound",
        "OrderItems": [
          {
            "OrderItemId": "OIID34853450",
            "SellerSKU": "SellerSKUID1",
            "SupplySourceId": "d7679e14-031b-4ab3-a81b-ec4fc7a460b3",
            "OrderItemStatus": "Unshipped",
            "Quantity": 10,
            "QuantityShipped": 0,
            "IsBuyerRequestedCancel": true,
            "ItemEarliestDeliveryDate": "2022-11-07T19:42:04.284Z",
            "ItemLatestDeliveryDate": "2022-12-07T19:42:04.284Z"
          }
        ]
      }
    }
  },
  "NotificationMetadata" : {
    "ApplicationId": "app-id-d0e9e693-c3ad-4373-979f-ed4ec98dd746",
    "SubscriptionId": "subscription-id-d0e9e693-c3ad-4373-979f-ed4ec98dd746",
    "PublishTime": "2020-07-13T19:42:04.284Z",
    "NotificationId": "d0e9e693-c3ad-4373-979f-ed4ec98dd746"
  }
}

ORDER_STATUS_CHANGE

Los Sellers pueden suscribirse a esta notificación.

🚧

ORDER_STATUS_CHANGE está en desuso

La notificación ORDER_STATUS_CHANGE está siendo reemplazada por la notificación ORDER_CHANGE . Para conocer los plazos de desuso y extinción, consulte las notas de la versión de junio de 2023.

El ORDER_STATUS_CHANGE se enviará una notificación cada vez que hay un cambio en el estatus de la orden de la disponibilidad.

ORDER_STATUS_CHANGE Carga esquema: Versión 1.0

El ORDER_STATUS_CHANGE notificación con PayloadVersion=1.0 incluye las siguientes propiedades en el OrderNotification objeto.

Esquema de notificación: OrderStatusChangeNotification.json

Notificación ejemplo:

{
  "NotificationVersion": "1.0",
  "NotificationType": "ORDER_STATUS_CHANGE",
  "PayloadVersion": "1.0",
  "EventTime": "2020-07-13T19:42:04.284Z",
  "Payload":
  {
    "OrderStatusChangeNotification":
    {
      "SellerId": "AXXXXXXXXXXXXX",
      "MarketplaceId": "ATVPDKIKX0DER",
      "AmazonOrderId": "333-7777777-7777777",
      "PurchaseDate": 1595882000633,
      "OrderStatus": "Unshipped",
      "DestinationPostalCode": "48110",
      "SupplySourceId": "55448834-0d79-5155-75c4-8529543a7c31",
      "OrderItemId": "OIID34853450",
      "SellerSKU": "SellerSKUID1",
      "Quantity": 45,
      "FulfillmentChannel": "MFN"
    }
  },
  "NotificationMetadata":
  {
    "ApplicationId": "app-id-d0e9e693-c3ad-4373-979f-ed4ec98dd746",
    "SubscriptionId": "subscription-id-d0e9e693-c3ad-4373-979f-ed4ec98dd746",
    "PublishTime": "2020-07-13T19:42:04.284Z",
    "NotificationId": "d0e9e693-c3ad-4373-979f-ed4ec98dd746"
  }
}

PRICING_HEALTH

Los Sellers pueden suscribirse a esta notificación.

El PRICING_HEALTH se enviará una notificación cada vez que un Seller de la oferta no es elegible para ser la Oferta presentada (Compra de Cuadro de oferta) a causa de la falta de competitividad de los precios. Los Sellers pueden tomar medidas para restaurar la oferta presentada elegibilidad mediante el ajuste de una oferta del precio total (precio más gastos de envío points menos), por lo que coincide o es menor que el precio competitivo, o está en línea con los precios de referencia proporcionado. Estos incluyen la Oferta presentada precio de 60 días a precio promedio de venta, los de más de 14 días precio (enviado y vendido por Amazon), y el precio de lista.
Para que una oferta sea considerada elegible, debe tener precios competitivos y cumplir con los demás criterios de calificación diseñado para dar a los clientes una gran experiencia de compra, incluyendo los grandes precios, la disponibilidad y la velocidad de entrega. El Destacado es la Oferta seleccionada cuando el cliente elige Añadir a la Cesta en la página de detalles del producto.

El PRICINGHEALTH notificación con payloadVersion=_1.0 incluye las siguientes propiedades en la carga de objetos.

buyBoxPrice

La tabla siguiente muestra los objetos y las propiedades de la buyBoxPrice objeto:

merchantOffer

La tabla siguiente muestra los objetos y las propiedades de la merchantOffer objeto:

offerChangeTrigger

La tabla siguiente muestra los objetos y las propiedades de la offerChangeTrigger objeto:

offerCount

La tabla siguiente muestra los objetos y las propiedades de la offerCount objeto:

points

La tabla siguiente muestra los objetos y las propiedades de los points objeto:

referencePrice

La tabla siguiente muestra los objetos y las propiedades de la referencePrice objeto:

salesRank

La tabla siguiente muestra los objetos y las propiedades de la salesRank objeto:

summary

La tabla siguiente muestra los objetos y las propiedades del summary objeto:

Esquema de notificación: PricingHealthNotification.json

Notificación ejemplo:

{
  "notificationVersion": "1.0",
  "notificationType": "PRICING_HEALTH",
  "payloadVersion": "1.0",
  "eventTime": "2020-09-23T21:30:13.713Z",
  "payload":
  {
    "issueType": "BuyBoxDisqualification",
    "sellerId": "A3EZFOFNDPFB8R",
    "offerChangeTrigger":
    {
      "marketplaceId": "ATVPDKIKX0DER",
      "asin": "B007IBIWZY",
      "itemCondition": "new",
      "timeOfOfferChange": "2020-09-23T21:30:13.409Z"
    },
    "merchantOffer":
    {
      "condition": "new",
      "fulfillmentType": "MFN",
      "listingPrice":
      {
        "amount": 8184.23,
        "currencyCode": "USD"
      },
      "shipping":
      {
        "amount": 4.49,
        "currencyCode": "USD"
      },
      "landedPrice":
      {
        "amount": 8188.72,
        "currencyCode": "USD"
      },
      "points":
      {
        "pointsNumber": 34343
      }
    },
    "summary":
    {
      "numberOfOffers": [
        {
          "condition": "new",
          "fulfillmentType": "MFN",
          "offerCount": 3
        }
      ],
      "buyBoxEligibleOffers": [
        {
          "condition": "new",
          "fulfillmentType": "MFN",
          "offerCount": 3
        }
      ],
      "buyBoxPrices": [
        {
          "condition": "new",
          "listingPrice":
          {
            "amount": 8184.23,
            "currencyCode": "USD"
          },
          "shipping":
          {
            "amount": 4.49,
            "currencyCode": "USD"
          },
          "landedPrice":
          {
            "amount": 8188.72,
            "currencyCode": "USD"
          },
          "points":
          {
            "pointsNumber": 34343
          }
        }
      ],
      "salesRankings": [
        {
          "productCategoryId": "lawn_and_garden_display_on_website",
          "rank": 4013
        },
        {
          "productCategoryId": "home_garden_display_on_website",
          "rank": 17316
        }
      ],
      "referencePrice":
      {
        "averageSellingPrice":
        {
          "amount": 7500,
          "currencyCode": "USD"
        },
        "competitivePriceThreshold":
        {
          "amount": 8000,
          "currencyCode": "USD"
        },
        "msrpPrice":
        {
          "amount": 7900,
          "currencyCode": "USD"
        },
        "retailOfferPrice":
        {
          "amount": 8000,
          "currencyCode": "USD"
        }
      }
    }
  },
  "notificationMetadata":
  {
    "applicationId": "amzn1.sellerapps.app.1da85d14-a68d-4ff3-9ff0-df6429e00d9a",
    "subscriptionId": "e3a059ca-677a-442a-8d39-05b2848971b6",
    "publishTime": "2020-09-23T21:30:16.903Z",
    "notificationId": "23ae41cd-3537-4676-af46-6ee9abf8802e"
  }
}

PRODUCT_TYPE_DEFINITIONS_CHANGE

Los Sellers y los Sellers pueden suscribirse a esta notificación.

El PRODUCT_TYPE_DEFINITIONS_CHANGE se enviará una notificación cada vez que hay un nuevo Tipo de Producto o Tipo de Producto Versión.

Si la notificación es provocada por la adición de uno o más nuevos tipos de productos en un marketplace, la carga de la notificación proporciona los nombres de los nuevos tipos de producto y el tipo de producto versión aplicable a los tipos de producto.

Si la notificación se activa sólo por un nuevo tipo de producto de la versión, la carga de la notificación proporciona el nuevo tipo de producto de la versión.

Para obtener más información acerca de los tipos de productos, ver las Guía de casos de uso de la Product Type Definitions API v2020-09-01.

PRODUCT_TYPE_DEFINITIONS_CHANGE Payload schema: Version 1.0

Un PRODUCT_TYPE_DEFINITIONS_CHANGE notificación con PayloadVersion=1.0 incluye las siguientes propiedades en la Payload del objeto.

Esquema de notificación: ProductTypeDefinitionsChangeNotification.json

Notificación ejemplo:

Ejemplo 1: Notificación con nuevos tipos de producto

{
  "NotificationVersion":"1.0",
  "NotificationType":"PRODUCT_TYPE_DEFINITIONS_CHANGE",
  "PayloadVersion":"1.0",
  "EventTime":"2021-02-03T18:59:30.194Z",
  "Payload":{ 
    "AccountId": "AXXXXXXXXXXXXX",
    "MarketplaceId": "ATVPDKIKX0DER",
    "ProductTypeVersion": "Uyp-Z6z_y2HhQD2x8sDBXkRAuxBqBionr",
    "NewProductTypes":[
      "LUGGAGE",
      "SHOES", 
    ]
  },
  "NotificationMetadata":{
    "ApplicationId":"amzn1.sellerapps.app.f1234566-aaec-55a6-b123-bcb752069ec5",
    "SubscriptionId":"93b098e1-c42-2f45-93a1-78910a6a8369",
    "PublishTime":"2021-02-03T18:59:30.194Z",
    "NotificationId":"0e999936-da2c-4f9c-9fc2-02b67bae5f49"
  }
}

Ejemplo 2: Notificación con un tipo de producto, cambio de versión

{
  "NotificationVersion":"1.0",
  "NotificationType":"PRODUCT_TYPE_DEFINITIONS_CHANGE",
  "PayloadVersion":"1.0",
  "EventTime":"2021-02-03T18:59:30.194Z",
  "Payload":{ 
    "AccountId": "AXXXXXXXXXXXXX",
    "ProductTypeVersion": "Uyp-Z6z_y2HhQD2x8sDBXkRAuxBqBionr"    
  },
  "NotificationMetadata":{
    "ApplicationId":"amzn1.sellerapps.app.f1234566-aaec-55a6-b123-bcb752069ec5",
    "SubscriptionId":"93b098e1-c42-2f45-93a1-78910a6a8369",
    "PublishTime":"2021-02-03T18:59:30.194Z",
    "NotificationId":"0e999936-da2c-4f9c-9fc2-02b67bae5f49"
  }
}

REPORT_PROCESSING_FINISHED

Los Sellers pueden suscribirse a esta notificación.

El REPORT_PROCESSING_FINISHED se enviará una notificación cada vez que cualquier reporte que se ha solicitado el uso de la selling partner API de Reports alcanza un reporte de tramitación de HECHO, CANCELADOS o FATAL.

REPORT_PROCESSING_FINISHED Payload schema: Version 1.0

El REPORT_PROCESSING_FINISHED notificación con PayloadVersion=2020-09-04 incluye los siguientes objetos en la reportProcessingFinishedNotification objeto.

Esquema de notificación: ReportProcessingFinishedNotification.json

Notificación ejemplo:

{
  "notificationVersion": "2020-09-04",
  "notificationType": "REPORT_PROCESSING_FINISHED",
  "payloadVersion": "2020-09-04",
  "eventTime": "2020-07-14T03:35:13.214Z",
  "payload":
  {
    "reportProcessingFinishedNotification":
    {
      "sellerId": "AXXXXXXXXXXXXX",
      "reportId": "54517018502",
      "reportType": "GET_FLAT_FILE_ACTIONABLE_ORDER_DATA",
      "processingStatus": "CANCELLED",
      "reportDocumentId": "amzn1.tortuga.3.edbcd0d8-3434-8222-1234-52ad8ade1208.REP4567URI9BMZ"
    }
  },
  "notificationMetadata":
  {
    "applicationId": "amzn1.sellerapps.app.aacccfff-4455-4b7c-4422-664ecacdd336",
    "subscriptionId": "subscription-id-d0e9e693-c3ad-4373-979f-ed4ec98dd746",
    "publishTime": "2020-07-13T19:42:04.284Z",
    "notificationId": "d0e9e693-c3ad-4373-979f-ed4ec98dd746"
  }
}

Common types

Contiene tipos comunes que son utilizados por todas las notificaciones que están contenidos en la carga de la Notificación de los objetos.

FulfillmentChannelType

Indica si el elemento es cumplido por parte de Amazon o por el Seller.

Tipo: string de

FulfillmentChannelType valores:

• Amazon
• Merchant

moneyType

Tipo de moneda y cantidad.

La siguiente tabla muestra las propiedades de la MoneyType objeto:

MoneyType

Tipo de moneda y cantidad.

La siguiente tabla muestra las propiedades de la MoneyType objeto: