Valores del tipo de notificación

Suscríbete a las notificaciones de los socios vendedores.

Puedes usar los valores de los tipos de notificación para suscribirte a las notificaciones de la API para socios vendedores. Determina qué notificaciones quieres recibir para elegir los valores de los tipos de notificación.

Los siguientes notificationType y payloadVersion los valores indican el tipo de notificación con la versión de carga compatible:

ACCOUNT_STATUS_CHANGED

Los vendedores pueden suscribirse a esta notificación.

La notificación ACCOUNT_STATUS_CHANGED se envía cada vez que cambia el estado de la cuenta de los pares de colaborador comercial/sitio web suscritos a desarrolladores. Se publica una notificación cada vez que el estado de la cuenta del colaborador comercial cambia entre NORMAL, AT_RISK y DEACTIVATED.

Esquema de carga útil: versión 2021-01-01

Flujo de trabajo: Flujo de trabajo de Amazon Simple Queue Service

En la siguiente tabla se muestran las propiedades del objeto accountStatusChangeNotification:

Nombre Descripción
previousAccountStatus El estado de la cuenta del vendedor antes de esta actualización.

Obligatorio.

Tipo: cadena

Valores posibles: NORMAL, AT_RISK y DEACTIVATED

currentAccountStatus El estado de la nueva cuenta del vendedor.

Obligatorio.

Tipo: cadena

Valores posibles: NORMAL, AT_RISK y DEACTIVATED

Esquema de notificación: AccountStatusChangedNotification.json

Ejemplo de notificación:

{ "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 vendedores pueden suscribirse a esta notificación.

Esta notificación admite los siguientes valores de eventFilter: aggregationSettings y marketplaceIds. Para utilizar estos filtros, también debes proporcionar lo siguiente
eventFilterType: "eventFilterType": "ANY_OFFER_CHANGED".

Consulta Directivas de procesamiento para obtener más información.

La notificación ANY_OFFER_CHANGED se envía siempre que se produce un cambio en una de las 20 ofertas más populares, por condición (nuevo o de segunda mano), o si el precio externo (el precio de otros minoristas) cambia para un artículo que vendes, o si hay un cambio en la oferta que gana la BuyBox, o si hay un cambio en el precio de la BuyBox. Las 20 mejores ofertas vienen determinadas por el precio de lanzamiento, que es el precio más el envío menos {{1}}. Si varios vendedores cobran el mismo precio de lanzamiento, los resultados se devolverán en orden aleatorio.

Solo recibirás notificaciones de ANY_OFFER_CHANGED sobre artículos con ofertas activas. No puedes suscribirte a las notificaciones de artículos para los que no tienes ofertas activas.

Esquema de carga útil: versión 1.0

Flujo de trabajo: Flujo de trabajo de Amazon Simple Queue Service

En la tabla siguiente se muestran los objetos y las propiedades del objeto AnyOfferChangedNotification:

Nombre Descripción
SellerId El identificador del vendedor de la oferta.

Obligatorio.

Tipo: cadena

OfferChangeTrigger El evento que provocó el envío de la notificación.

Obligatorio.

Tipo: OfferChangeTrigger

Summary Información sobre el producto para el que se modificó la oferta. La información de este resumen se aplica a todas las condiciones del producto.

Obligatorio.

Tipo: Summary

Offers Las 20 mejores ofertas competitivas para el artículo y la condición que activaron la notificación.

Obligatorio.

Tipo: matriz de Offer

BuyBoxPrice

En la tabla siguiente se muestran los objetos y las propiedades del objeto BuyBoxPrice:

Nombre Descripción
LandedPrice ListingPrice + Shipping - Points.

Obligatorio.

Tipo: MoneyType

ListingPrice El precio del artículo.

Obligatorio.

Tipo: MoneyType

Shipping Los gastos de envío.

Obligatorio.

Tipo: MoneyType

Points La cantidad de puntos Amazon que se ofrecen con la compra de un artículo.

Opcional.

Nota: el objeto Points solo se devuelve en Japón (JP).

Tipo: Points

Condition Indica la condición del artículo. Por ejemplo: New, Used, Collectible, Refurbished o Club.

Obligatorio.

Tipo: cadena

LowestPrice

En la tabla siguiente se muestran los objetos y las propiedades del objeto LowestPrice:

Nombre Descripción
LandedPrice

ListingPrice + Shipping - Points.

Obligatorio.

Tipo: MoneyType

ListingPrice

El precio del artículo.

Obligatorio.

Tipo: MoneyType

Shipping

Los gastos de envío.

Obligatorio.

Tipo: MoneyType

Points

La cantidad de puntos Amazon que se ofrecen con la compra de un artículo.

Opcional.

Nota: el objeto Points solo se devuelve en Japón (JP).

Tipo: Points

Condition

Indica la condición del artículo. Por ejemplo: New, Used, Collectible, Refurbished o Club.

Obligatorio.

Tipo: cadena

FulfillmentChannel

Indica si el artículo lo gestiona Amazon o el vendedor.

Obligatorio.

Tipo: FulfillmentChannelType

Offer

En la tabla siguiente se muestran los objetos y las propiedades del objeto Offer:

Nombre Descripción
SellerId

El identificador del vendedor de la oferta.

Obligatorio.

Tipo: cadena

SubCondition

La subcondición del artículo. Por ejemplo: New, Mint, Very Good, Good, Acceptable, Poor, Club, Ocode, Warranty, Refurbished Warranty, Refurbished, Open Box o Other.

Obligatorio.

Tipo: cadena

SellerFeedbackRating

Información sobre las valoraciones del vendedor, incluido el porcentaje de valoraciones positivas y el recuento total de valoraciones recibidas.

Opcional.

Tipo: SellerFeedbackRating

ShippingTime

El tiempo mínimo y máximo, en horas, en el que es probable que se envíe el artículo después de que se haya realizado el pedido.

Obligatorio.

Tipo: ShippingTime

ListingPrice

El precio del artículo.

Obligatorio.

Tipo: MoneyType

Points

La cantidad de puntos Amazon que se ofrecen con la compra de un artículo.

Opcional.

Nota: el objeto Points solo se devuelve en Japón (JP).

Tipo: Points

Shipping

Los gastos de envío.

Obligatorio.

Tipo: MoneyType

ShipsFrom

El estado y el país desde donde se envía el artículo.

Opcional.

Tipo: ShipsFrom

IsFulfilledByAmazon

Indica si Amazon gestiona la oferta.

Obligatorio.

Tipo: booleano

IsBuyBoxWinner

Indica si la oferta se encuentra actualmente en {{0}}. Puede haber hasta dos ganadores de {{1}} en cualquier momento por ASIN, uno que sea apto para Prime y otro que no lo sea.

Opcional.

Tipo: booleano

ConditionNotes

Información sobre la condición del artículo.

Opcional.

Tipo: cadena

PrimeInformation

Información de Amazon Prime.

Opcional.

Tipo: PrimeInformation

IsExpeditedShippingAvailable

Indica si está disponible el envío urgente.

Opcional.

Tipo: booleano

IsFeaturedMerchant

Indica si el vendedor del artículo puede ganar el {{0}}.

Opcional.

Tipo: booleano

ShipsDomestically

Indica si el artículo se envía en el ámbito nacional.

Opcional.

Tipo: booleano

OfferChangeTrigger

En la siguiente tabla se muestran las propiedades del objeto OfferChangeTrigger:

Nombre Descripción
MarketplaceId

El identificador del sitio web del artículo al que se le ha cambiado la oferta.

Obligatorio.

Tipo: cadena

ASIN

El ASIN del artículo al que se le ha cambiado la oferta.

Obligatorio.

Tipo: cadena

ItemCondition

La condición del artículo afectado por un cambio de oferta. Por ejemplo, si una oferta de artículos de segunda mano cambia, la gama de ofertas del objeto Offers solo corresponderá a artículos de segunda mano. El objeto Summary objeto proporciona un resumen de las demás condiciones que se pueden utilizar para modificar los precios.

Obligatorio.

Tipo: cadena

TimeOfOfferChange

La hora de actualización de la oferta que ha provocado esta notificación, en formato ISO 8601.

Obligatorio.

Tipo: cadena

OfferChangeType

El tipo de oferta que ha cambiado y ha activado esta notificación.

Valores OfferChangeType:

External: el CompetitivePriceThreshold en el objeto Summary ha cambiado debido a una nueva oferta de un vendedor que no es de Amazon.

Internal: el precio de una oferta en el sitio web minorista de Amazon ha cambiado.

Featured Offer - El ganador de la Buy Box o el precio de la Buy Box han cambiado.

Obligatorio.

Tipo: cadena

OfferCount

En la tabla siguiente se muestran los objetos y las propiedades del objeto OfferCount:

Nombre Descripción
Condition

Indica la condición del artículo. Por ejemplo: New, Used, Collectible, Refurbished o Club.

Obligatorio.

Tipo: cadena

FulfillmentChannel

Indica si el artículo lo gestiona Amazon o el vendedor.

Obligatorio.

Tipo: FulfillmentChannelType

OfferCount

El número total de ofertas para la condición y el canal de gestión logística especificados.

Obligatorio.

Tipo: entero

Points

En la siguiente tabla se muestran las propiedades del objeto Points:

Nombre Descripción
PointsNumber

La cantidad de puntos Amazon que se ofrecen con la compra de un artículo.

Obligatorio.

Tipo: entero

PrimeInformation

En la tabla siguiente se muestran los objetos y las propiedades del objeto PrimeInformation:

Nombre Descripción
IsOfferNationalPrime

Indica si la oferta es de Amazon Prime en todo el sitio web en el que aparece.

Obligatorio.

Tipo: booleano

IsOfferPrime

Indica si la oferta es de Amazon Prime.

Obligatorio.

Tipo: booleano

SalesRank

En la siguiente tabla se muestran las propiedades del objeto SalesRank:

Nombre Descripción
ProductCategoryId

El identificador de la categoría de producto del producto.

Obligatorio.

Tipo: cadena

Rank

El rango de ventas del producto en la categoría de producto determinada.

Obligatorio.

Tipo: entero

SellerFeedbackRating

En la tabla siguiente se muestran los objetos y las propiedades del objeto SellerFeedbackRating:

Nombre Descripción
SellerPositiveFeedbackRating

El porcentaje de valoraciones positivas del vendedor en los últimos 365 días.

Opcional.

Tipo: doble

FeedbackCount

El recuento de valoraciones recibidas sobre el vendedor.

Obligatorio.

Tipo: largo

ShippingTime

En la siguiente tabla se muestran las propiedades del objeto ShippingTime:

Nombre Descripción
MinimumHours

El tiempo mínimo, en horas, en el que es probable que se envíe el artículo después de que se haya realizado el pedido.

Opcional.

Tipo: corto

MaximumHours

El tiempo máximo, en horas, en el que es probable que se envíe el artículo después de que se haya realizado el pedido.

Opcional.

Tipo: corto

AvailableDate

La fecha en la que el artículo estará disponible para su envío. Solo se muestra para los artículos que actualmente no están disponibles para su envío.

Opcional.

Tipo: cadena

AvailabilityType

Indica si el artículo está disponible para su envío ahora o en una fecha conocida o desconocida en el futuro. Si se conoce, el atributo availableDate indica la fecha en la que el artículo estará disponible para su envío.

Opcional.

Tipo: cadena

ShipsFrom

En la tabla siguiente se muestran los objetos y las propiedades del objeto ShipsFrom:

Nombre Descripción
State

El estado desde el que se envía el artículo.

Opcional.

Tipo: cadena

Country

El país desde el que se envía el artículo.

Opcional.

Tipo: cadena

IsFulfilledByAmazon

Indica si Amazon gestiona la oferta.

Obligatorio.

Tipo: booleano

Summary

En la tabla siguiente se muestran los objetos y las propiedades del objeto Summary:

Nombre Descripción
NumberOfOffers

Una lista que contiene el número total de ofertas del artículo para las condiciones y los canales de gestión logística determinados.

Obligatorio.

Tipo: matriz de OfferCount

LowestPrices

Una lista que contiene los precios más bajos del artículo para las condiciones y los canales de gestión logística determinados.

Obligatorio.

Tipo: matriz de LowestPrice

BuyBoxPrices

Una lista que contiene el precio de {{0}} del artículo para las condiciones determinadas.

Opcional.

Tipo: matriz de BuyBoxPrice

ListPrice

El precio de lista del artículo según lo sugerido por el fabricante.

Opcional.

Tipo: MoneyType

SuggestedLowerPricePlusShipping

El precio más bajo sugerido del producto, incluido el envío (menos {{0}}). El precio más bajo sugerido se basa en una serie de factores, incluidos los precios de venta históricos y los precios aptos de {{1}} recientes y los comentarios de los clientes sobre tus productos.

Opcional.

Tipo: MoneyType

SalesRankings

Una lista que contiene el rango de ventas del producto en las categorías de productos determinadas.

Opcional.

Tipo: matriz de SalesRank

NumberOfBuyBoxEligibleOffers

Una lista que contiene el número total de ofertas que son aptas para el {{0}} según las condiciones y los canales de gestión logística determinados.

Obligatorio.

Tipo: matriz de OfferCount

CompetitivePriceThreshold

Este precio se basa en los precios competitivos de otros minoristas (excluidos otros vendedores de Amazon). Es posible que tu oferta no cumpla los requisitos para price si tu shipping + {{2}} es mayor que este precio competitivo.

Opcional.

Tipo: MoneyType

Esquema de notificación: AnyOfferChangedNotification.json

Ejemplo de notificación:

{ "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 vendedores pueden suscribirse a esta notificación.

La notificación B2B_ANY_OFFER_CHANGED se envía cada vez que se produce un cambio en cualquiera de las 20 ofertas B2B más importantes de Amazon Business, en forma de cambio de precio (para una sola unidad y siete niveles de descuento por cantidad predefinidos: 2, 3, 5, 10, 20, 30 y 50) de un artículo publicado por el vendedor. Las 20 mejores ofertas B2B vienen determinadas por el precio de lanzamiento por unidad, que es el precio más los gastos de envío. Si varios vendedores cobran el mismo precio de lanzamiento, los resultados se mostrarán en orden aleatorio.

Solo recibirás notificaciones de B2B_ANY_OFFER_CHANGED sobre artículos para los que el vendedor tiene ofertas activas. No puedes suscribirte a las notificaciones de artículos para los que el vendedor no tiene ofertas activas.

Esquema de carga útil: versión 1.0

Flujo de trabajo: Flujo de trabajo de Amazon Simple Queue Service

En la siguiente tabla se muestran los objetos y propiedades del objeto AnyOfferChangedNotification de B2B:

Nombre Descripción
OfferChangeTrigger

El evento que provocó el envío de la notificación.

Obligatorio.

Tipo: OfferChangeTrigger

Summary

Información sobre el producto para el que se modificó la oferta. La información de este resumen se aplica a todas las condiciones del producto.

Obligatorio.

Tipo: Summary

Offers

Las 20 ofertas B2B más competitivas para el artículo y la condición que activaron la notificación.

Obligatorio.

Tipo: matriz de Offer

SellerId

El identificador del vendedor de la oferta.

Obligatorio.

Tipo: cadena

BuyBoxPrice

En la tabla siguiente se muestran los objetos y las propiedades del objeto BuyBoxPrice.

Nombre Descripción
landedPrice

listingPrice + shipping.

Opcional.

Tipo: MoneyType

listingPrice

El precio del artículo.

Obligatorio.

Tipo: MoneyType

shipping

Los gastos de envío.

Opcional.

Tipo: MoneyType

offerType

Indica si la oferta es de tipo B2B o B2C. Cuando el tipo de oferta es B2C con un descuento por cantidad, el vendedor gana la {{0}} porque otros no tienen inventario en esa cantidad, no porque tengan un descuento por cantidad en el ASIN.

Obligatorio.

Tipo: cadena

quantityTier

El nivel de cantidad de la oferta.

Obligatorio.

Tipo: entero

discountType

Indica si el nivel de cantidad es para descuento por cantidad o descuento progresivo.

Opcional.

Tipo: cadena

condition

Indica la condición del artículo. Por ejemplo: New, Used, Collectible, Refurbished o Club.

Obligatorio.

Tipo: cadena

sellerId

El identificador del vendedor de la oferta.

Opcional.

Tipo: cadena

LowestPrice

En la tabla siguiente se muestran los objetos y las propiedades del tipo LowestPrice debajo del objeto Summary:

Nombre Descripción
LandedPrice

ListingPrice + Shipping.

Opcional.

Tipo: MoneyType

ListingPrice

El precio del artículo.

Obligatorio.

Tipo: MoneyType

Shipping

Los gastos de envío.

Opcional.

Tipo: MoneyType

OfferType

Indica si la oferta es B2B o B2C

Obligatorio.

Tipo: cadena

QuantityTier

El nivel de cantidad de la oferta

Obligatorio.

Tipo: entero

DiscountType

Indica si el nivel de cantidad es para descuento por cantidad o descuento progresivo.

Opcional.

Tipo: cadena

Condition

Indica la condición del artículo. Por ejemplo: New, Used, Collectible, Refurbished o Club.

Obligatorio.

Tipo: cadena

FulfillmentChannel

Indica si el artículo lo gestiona Amazon o el vendedor.

Obligatorio.

Tipo: FulfillmentChannelType

Offer

En la tabla siguiente se muestran los objetos y las propiedades del objeto Offer:

Nombre Descripción
SellerId

El identificador del vendedor de la oferta.

Obligatorio.

Tipo: cadena

SubCondition

La subcondición del artículo. Por ejemplo: New, Mint, Very Good, Good, Acceptable, Poor, Club, Ocode, Warranty, Refurbished Warranty, Refurbished, Open Box o Other.

Obligatorio.

Tipo: cadena

SellerFeedbackRating

Información sobre las valoraciones del vendedor, incluido el porcentaje de valoraciones positivas y el recuento total de valoraciones recibidas.

Opcional.

Tipo: SellerFeedbackRating

ShippingTime

El tiempo mínimo y máximo, en horas, en el que es probable que se envíe el artículo después de que se haya realizado el pedido.

Obligatorio.

Tipo: ShippingTime

ListingPrice

El precio del artículo.

Obligatorio.

Tipo: MoneyType

Shipping

Los gastos de envío.

Obligatorio.

Tipo: MoneyType

ShipsFrom

El país desde el que se envía el artículo.

Opcional.

Tipo: ShipsFrom

IsFulfilledByAmazon

Indica si Amazon gestiona la oferta.

Obligatorio.

Tipo: booleano

IsBuyBoxWinner

Indica si la oferta se encuentra actualmente en {{0}}. Puede haber hasta dos ganadores de {{1}} en cualquier momento por ASIN, uno que sea apto para Prime y otro que no lo sea.

Opcional.

Tipo: booleano

ConditionNotes

Información sobre la condición del artículo.

Opcional.

Tipo: cadena

PrimeInformation

Información de Amazon Prime.

Opcional.

Tipo: PrimeInformation

IsFeaturedMerchant

Indica si el vendedor del artículo puede ganar el {{0}}.

Opcional.

Tipo: booleano

OfferChangeTrigger

En la siguiente tabla se muestran las propiedades del objeto OfferChangeTrigger:

Nombre Descripción
MarketplaceId

El identificador del sitio web del artículo al que se le ha cambiado la oferta.

Obligatorio.

Tipo: cadena

ASIN

El ASIN del artículo al que se le ha cambiado la oferta.

Obligatorio.

Tipo: cadena

ItemCondition

La condición del artículo afectado por un cambio de oferta. Por ejemplo, si una oferta de artículos de segunda mano cambia, la gama de ofertas del objeto Offers solo corresponderá a artículos de segunda mano. El objeto Summary objeto proporciona un resumen de las demás condiciones que se pueden utilizar para modificar los precios.

Obligatorio.

Tipo: cadena

TimeOfOfferChange

La hora de actualización de la oferta que provocó esta notificación.

Obligatorio.

Tipo: cadena

OfferCount

En la tabla siguiente se muestran los objetos y las propiedades del tipo OfferCount:

Nombre Descripción
Condition

Indica la condición del artículo. Por ejemplo: New, Used, Collectible, Refurbished o Club.

Obligatorio.

Tipo: cadena

FulfillmentChannel

Indica si el artículo lo gestiona Amazon o el vendedor.

Obligatorio.

Tipo: FulfillmentChannelType

OfferCount

El número total de ofertas para la condición y el canal de gestión logística especificados.

Tipo: entero

PrimeInformation

En la siguiente tabla se muestran las propiedades del objeto PrimeInformation:

Nombre Descripción
IsOfferNationalPrime

Indica si la oferta es de Amazon Prime en todo el sitio web en el que aparece.

Obligatorio.

Tipo: booleano

IsOfferPrime

Indica si la oferta es de Amazon Prime.

Obligatorio.

Tipo: booleano

SellerFeedbackRating

En la siguiente tabla se muestran las propiedades del objeto SellerFeedbackRating:

Nombre Descripción
SellerPositiveFeedbackRating

El porcentaje de valoraciones positivas del vendedor en los últimos 365 días.

Opcional.

Tipo: entero

FeedbackCount

El recuento de valoraciones recibidas sobre el vendedor.

Obligatorio.

Tipo: entero

ShippingTime

En la siguiente tabla se muestran las propiedades del objeto ShippingTime:

Nombre Descripción
MinimumHours

El tiempo mínimo, en horas, en el que es probable que se envíe el artículo después de que se haya realizado el pedido.

Opcional.

Tipo: entero

MaximumHours

El tiempo máximo, en horas, en el que es probable que se envíe el artículo después de que se haya realizado el pedido.

Opcional.

Tipo: entero

AvailableDate

La fecha en la que el artículo estará disponible para su envío. Solo se muestra para los artículos que actualmente no están disponibles para su envío.

Opcional.

Tipo: cadena

AvailabilityType

Indica si el artículo está disponible para su envío ahora o en una fecha conocida o desconocida en el futuro. Si se conoce, la propiedad availableDate indica la fecha en la que el artículo estará disponible para su envío.

Opcional.

Tipo: cadena

ShipsFrom

En la siguiente tabla se muestran las propiedades del objeto ShipsFrom:

Nombre Descripción
Country

El país desde el que se envía el artículo.

Opcional.

Tipo: cadena

Summary

En la tabla siguiente se muestran los objetos y las propiedades del objeto Summary:

Nombre Descripción
NumberOfOffers

Una lista que contiene el número total de ofertas B2B para el artículo según las condiciones y los canales de gestión logística determinados.

Obligatorio.

Tipo: matriz de OfferCount

LowestPrices

Una lista que contiene los precios más bajos del artículo para las condiciones, los canales de gestión logística, los niveles de cantidad y los tipos de descuento determinados.

Los siete niveles de cantidad predefinidos para el tipo de descuento "Descuentos por cantidad" son 2, 3, 5, 10, 20, 30 y 50.

Obligatorio.

Tipo: matriz de LowestPrice

BuyBoxPrices

Una lista que contiene el precio de {{0}} del artículo según las condiciones, los niveles de cantidad y los tipos de descuento determinados.

Se muestran hasta los 50 primeros niveles de cantidad.

Opcional.

Tipo: matriz de BuyBoxPrice

BuyBoxEligibleOffers

Una lista que contiene el número total de ofertas B2B que son aptas para el {{0}} según las condiciones y los canales de gestión logística determinados.

Obligatorio.

Tipo: matriz de OfferCount

Esquema de notificación: B2bAnyOfferChangedNotification.json

Ejemplo de notificación

{ "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 vendedores pueden suscribirse a esta notificación.

Amazon envía una notificación BRANDED_ITEM_CONTENT_CHANGE cada vez que se produzca un cambio en el título, la descripción, la lista de características o las imágenes de cualquier ASIN con el que el colaborador comercial tenga una relación de marca. Un colaborador comercial mantiene una relación de marca con un ASIN, tal como se define en el programa de marcas registradas de Amazon, cuando es propietario verificado de la marca. El colaborador comercial es la entidad que autoriza a una aplicación a utilizar la API de notificaciones en su nombre, con el fin de crear y gestionar suscripciones de notificaciones. Amazon envía notificaciones de BRANDED_ITEM_CONTENT_CHANGE de artículos publicados en cualquier sitio web de Amazon.

Esquema de carga útil: versión 1.0

Flujo de trabajo: Flujo de trabajo de Amazon EventBridge

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

Nombre Descripción Obligatorio
MarketplaceId El sitio web en el que se publica el artículo.

Tipo: cadena

BrandName El nombre de la marca del artículo.

Tipo: cadena

Asin El ASIN del artículo.

Tipo: cadena

AttributesChanged La matriz de atributos del artículo que han cambiado. Los nombres, las descripciones y los requisitos de los atributos están disponibles mediante la API de definiciones de tipos de productos. Para obtener más información, consulte la Guía de casos de uso de la API de definiciones de tipos de productos.

Tipo: matriz de cadenas

Valores posibles:
bullet_point
item_name
product_description
... y todos los atributos de la imagen del producto (main_product_image_locator, other_product_image_locator_1, etc.). Consulte el images grupo de propiedades de este Ejemplo de respuesta JSON en la Guía de casos de uso de la API de definiciones de tipos de productos para ver la lista completa de los atributos de las imágenes.

NOTA: La presencia de uno o más de los valores anteriores que contienen la palabra image (por ejemplo, main_product_image_locator, other_product_image_locator_1, etc.) indica que al menos uno imagen cambiada en la página de detalles del producto. El número de valores que contienen la palabra imagen no necesariamente coinciden con el número de imágenes modificadas en la página de detalles del producto.

Esquema de notificación: BrandedItemContentChangeNotification.json

Ejemplo de notificación:

{ "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 vendedores y proveedores pueden suscribirse a esta notificación.

La notificación DETAIL_PAGE_TRAFFIC_EVENT se envía a los cinco minutos después del comienzo de cada hora. Esta notificación comparte los datos de tráfico del nivel de ASIN e incluye los datos de la hora anterior, así como los datos retrasados de las 24 horas anteriores. Se incluyen los ASIN que tienen vistas panorámicas. Cada notificación puede incluir varios ASIN y un colaborador comercial puede recibir varias notificaciones cada hora.

Esquema de carga útil: versión 1.0

Flujo de trabajo: Flujo de trabajo de Amazon Simple Queue Service

DetailPageTrafficEventNotifications

En la tabla siguiente se muestran los objetos y las propiedades del objeto DetailPageTrafficEventNotifications:

NombreDescripciónObligatorioType
detailPageTrafficEventNotificationsUna lista de métricas de tráfico detalladas por hora por ASIN.Matriz de DetailPageTrafficEventNotification

DetailPageTrafficEventNotification

NombreDescripciónObligatorioType
accountIdEl ID de cliente del vendedor o el ID del grupo de proveedores de la cuenta del colaborador comercial al que se envía esta notificación.Cadena
marketplaceIdEl identificador de sitio web de los datos de tráfico.Cadena
startTimeEl inicio del intervalo de fecha y hora de los datos de tráfico en formato ISO 8601 en hora UTC.Cadena
endTimeEl final del intervalo de fecha y hora de los datos de tráfico en formato ISO 8601 en hora UTC.Cadena
asinEl número de identificación estándar de Amazon del producto.Cadena
glanceViewsEl número de visualizaciones de los clientes de la página de detalles del producto de este ASIN.Número entero

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 vendedores pueden suscribirse a esta notificación.

La notificación FBA_INVENTORY_AVAILABILITY_CHANGES se envía cada vez que hay un cambio en las cantidades del inventario de Logística de Amazon. Esta notificación incluye una instantánea del inventario de Logística de Amazon en todos los sitios web aptos de una región determinada.

Esquema de carga útil: versión 1.0

Flujo de trabajo: Flujo de trabajo de Amazon Simple Queue Service

FBAInventoryAvailabilityChangeNotification

En la tabla siguiente se muestran los objetos y las propiedades del objeto FBAInventoryAvailabilityChangeNotification:

Nombre Descripción
SellerId

El identificador del vendedor.

Tipo: cadena

FNSKU

El SKU de la red logística del artículo de inventario afectado.

Tipo: cadena

ASIN

El número de identificación estándar de Amazon del artículo de inventario afectado.

Tipo: cadena

SKU

El SKU del vendedor del artículo de inventario afectado.

Tipo: cadena

FulfillmentInventoryByMarketplace

Una lista de los detalles del inventario de gestión logística de cada sitio web.

Tipo: matriz de FulfillmentInventoryDetails

FulfillmentInventoryDetails

En la tabla siguiente se describen los objetos y las propiedades de un objeto FulfillmentInventoryDetails:

Nombre Descripción
MarketplaceId

El identificador del sitio web del destino en el que se puede utilizar el inventario afectado para gestionar el pedido.

Tipo: cadena

ItemName

El título de producto del producto de inventario afectado.

Tipo: cadena

FulfillmentInventory

Detalle de la disponibilidad de inventario del artículo afectado.

Tipo: FulfillmentInventory

Stores

A list of seller-enrolled stores that apply to this seller SKU.

Tipo: matriz de cadenas

FulfillmentInventory

En la tabla siguiente se describen los objetos y las propiedades de un objeto FulfillmentInventory:

Nombre Descripción
InboundQuantityBreakdown

Detalles de las unidades entrantes del artículo afectado, que aún están en estado WORKING o en camino para su recepción en los almacenes de Amazon.

Tipo: InboundQuantityBreakdown

Fulfillable

La cantidad de unidades del artículo afectado que se pueden utilizar para gestionar los pedidos en el sitio web determinado.

Tipo: número entero

Unfulfillable

La cantidad de unidades del artículo afectado que no se pueden utilizar para gestionar pedidos debido a la condición actual del artículo.

Tipo: número entero

Researching

Número de unidades del artículo afectado que se están investigando actualmente tras realizar los ajustes.

Tipo: número entero

ReservedQuantityBreakdown

Detalles del inventario que se encuentra temporalmente en proceso interno.

Tipo: ReservedQuantityBreakdown

FutureSupplyBuyable

La cantidad de unidades disponibles para que los clientes las encuentren y compren mientras el inventario está de camino a un centro logístico de Amazon a través de In-Stock Head Start.

Tipo: número entero

PendingCustomerOrderInTransit

La cantidad de unidades que los clientes han comprado mientras el inventario estaba de camino a un centro logístico de Amazon a través de In-Stock Head Start.

Tipo: número entero

InboundQuantityBreakdown

En la tabla siguiente se describen los objetos y las propiedades de un objeto InboundQuantityBreakdown:

Nombre Descripción
Working

El número de unidades del artículo afectado que residen actualmente en un envío con estado WORKING.

Tipo: número entero

Shipped

El número de unidades del elemento afectado que residen actualmente en un estado del envío SHIPPED, IN_TRANSIT, DELIVERED o CHECKED_IN.

Tipo: número entero

Receiving

Número de unidades del artículo afectado que llegaron y se van a recibir próximamente en los almacenes de Amazon.

Tipo: número entero

ReservedQuantityBreakdown

En la tabla siguiente se describen los objetos y las propiedades de un objeto ReservedQuantityBreakdown:

Nombre Descripción
WarehouseProcessing

El número de unidades del artículo afectado que se han apartado temporalmente para su posterior procesamiento.

Tipo: número entero

WarehouseTransfer

El número de unidades del artículo afectado que están en proceso de traspaso a otra ubicación del almacén de Amazon.

Tipo: número entero

PendingCustomerOrder

El número de unidades del artículo afectado que se enviarán próximamente como envío de pedido de un cliente.

Tipo: número entero

Esquema de notificación: FBAInventoryAvailabilityChangeNotification.json

Ejemplo de notificación

{ "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 }, "Stores": [ "Low-Cost Store" ] }, { "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 }, "Stores": [ "Low-Cost Store" ] } ] }, "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 vendedores pueden suscribirse a esta notificación.

La notificación FBA_OUTBOUND_SHIPMENT_STATUS se envía cada vez que Amazon crea o cancela un envío de Logística de Amazon para un vendedor. Esta notificación es solo para envíos in situ de Logística de Amazon. Esta notificación solo está disponible en el sitio web de Brasil.

Esquema de carga útil: versión 1.0

Flujo de trabajo: Flujo de trabajo de Amazon Simple Queue Service

FBAOutboundShipmentStatusNotification

En la tabla siguiente se muestran los objetos y las propiedades del objeto FBAOutboundShipmentStatusNotification:

Nombre Descripción
SellerId

El identificador del vendedor.

Tipo: cadena

AmazonOrderId

El identificador de pedido definido por Amazon.

Tipo: cadena

AmazonShipmentId

El identificador de envío definido por Amazon.

Tipo: cadena

ShipmentStatus

El estado del envío. Valores de ShipmentStatus: Created y Cancelled.

Tipo: cadena

Esquema de notificación: FBAOutboundShipmentStatusNotification.json

Ejemplo de notificación

{ "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 vendedores pueden suscribirse a esta notificación.

Los vendedores que utilizan la API del colaborador comercial pueden beneficiarse de promociones con tarifas limitadas en el tiempo. Para recibir notificaciones de las promociones de tarifas disponibles, los vendedores deben suscribirse a la notificación FEE_PROMOTION. Cuando el vendedor se suscriba inicialmente a la suscripción y isEnabled esté configurado en true, el vendedor recibirá todas las promociones activas en ese momento. Cada promoción se envía como un mensaje único. Las notificaciones de promoción posteriores se envían cuando la promoción se activa.

La notificación FEE_PROMOTION se compone de un conjunto de campos de datos que describen los detalles de esa promoción. Todos los criterios de cumplimiento de requisitos para cada promoción se describirán en esos campos de datos.

Nota: las tarifas estimadas devueltas por esta API no están garantizadas. Las tarifas reales pueden variar. Para obtener más información sobre las tarifas, consulta Programa de venta con tarifas de Amazon y Características y tarifas de Logística de Amazon en Seller Central.

Esquema de carga útil: versión 1.0

Flujo de trabajo: Flujo de trabajo de Amazon Simple Queue Service

FeeDetail

En la tabla siguiente se muestran los objetos y las propiedades de un objeto FeeDetail:

Nombre Descripción Obligatorio Valor
FeeType El tipo de tarifas cobradas.

Tipos de tarifas permitidos: ReferralFee, VariableClosingFee, PerItemFee, FBAFees, FBAPickAndPack, FBAWeightHandling, FBAOrderHandling y FBADeliveryServicesFee.

Tipo: cadena

FeeAmount El importe de la tarifa correspondiente al tipo de tarifa. Tipo: MoneyType
FeePromotion El importe de promoción de la tarifa correspondiente al tipo de tarifa. No Tipo: MoneyType
TaxAmount El impuesto calculado sobre la tarifa que se cobraría al vendedor. No Tipo: MoneyType
FinalFee La tarifa final que se cobraría al vendedor.

El FeeAmount menos el FeePromotion.

Tipo: MoneyType

IncludedFees Una lista estructurada de FeeDetail que contiene la distribución de un tipo de tarifa específico. No Tipo: matriz de FeeDetail

FeesEstimate

En la tabla siguiente se muestran los objetos y las propiedades del objeto FeesEstimate:

NombreDescripciónObligatorioValor
TimeOfFeesEstimatedLa fecha y hora en la que se calcularon las tarifas.Tipo: cadena
TotalFeesEstimateEl importe total de las tarifas si el precio se reduce hasta el umbral de precio o por debajo de este.Tipo: MoneyType
FeeDetailsUna distribución del TotalFeesEstimate).Tipo: matriz de FeeDetail

FeePromotionNotification

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

Nombre Descripción Obligatorio Valor
FeePromotionType El tipo de promoción.

Valores: Pricing, SelectionASIN o SelectionCategory. Es posible que haya más tipos disponibles en el futuro.

Tipo: cadena

FeePromotionTypeDescription Proporciona más detalles sobre la finalidad de una promoción. No

Una descripción de cadena accesible y localizada. Es útil para que los integradores la muestren en una interfaz de usuario.

Tipo: cadena

MarketplaceId La promoción se aplica a este marketplaceId. Tipo: cadena
MerchantId La promoción se aplica a este merchantId. Tipo: cadena
Identifiers Lista de artículos a los que se aplica esta promoción. Tipo: matriz de Identifier
PromotionActiveTimeRange El intervalo de tiempo en el que esta promoción está activa. Tipo: PromotionActiveTimeRange
PromotionInformation Un objeto que contiene detalles adicionales sobre la promoción. Se incluye una estimación de la tarifa, si corresponde. Tipo: PromotionInformation

Identifier

En la tabla siguiente se describen los objetos y las propiedades de un objeto de la matriz de Identifiers:

Nombre Descripción Obligatorio Valor
IdentifierType El tipo de identificador de colaborador comercial (vendedor) al que se aplicará esta promoción.

Por ejemplo: ASIN, SKU, nodo de navegación y marca.

Tipo: cadena

IdentifierValues El nombre descriptivo del valor de ID.

Por ejemplo: los ASIN o SKU reales del colaborador comercial, una lista real de marcas (como Nike) o una lista real de nodos de navegación.

Tipo: matriz de IndentifierValue

IdentifierValue

Descripción de los valores identificativos a los que se aplica esta promoción.

Nombre Descripción Obligatorio Valor
IdentifierValueId El identificador real del nodo de navegación, el ASIN/SKU real o el valor de la marca. Tipo: cadena
IdentifierValueFriendlyName Los valores identificativos del colaborador comercial (vendedor) a los que se aplicará esta promoción. No Solo es relevante o solo se rellena para elementos como los nodos de navegación. Por ejemplo, este sería el nombre descriptivo de un nodo de navegación.

Tipo: cadena

PromotionInformation

En la tabla siguiente se muestran los objetos y las propiedades del objeto PromotionInformation:

Nombre Descripción Obligatorio Valor
FeeType El tipo de tarifa que se descuenta en esta promoción.

Tipos de tarifas permitidos: ReferralFee, VariableClosingFee, PerItemFee, FBAFees, FBAPickAndPack, FBAWeightHandling, FBAOrderHandling y FBADeliveryServicesFee.

Tipo: cadena

FeeDiscountType El tipo de promoción que recibirás por tus tarifas.

Puntos de descuento fijos, con descuento o porcentuales.

Tipo: cadena

PriceThreshold El precio de oferta de umbral que cumpla los requisitos, o inferior, que se debe cumplir para que se aplique la promoción. No Tipo: MoneyType
FeeDiscountMonetaryAmount El importe que recibirás de tus tarifas si FeeDiscountType implica una cantidad monetaria. No

Si el FeeDiscountType implica una cantidad monetaria, este valor se rellenará.

Tipo: MoneyType

FeeDiscountValue El porcentaje de descuento de tus tarifas si FeeDiscountType implica una cantidad no monetaria. No

Si el FeeDiscountType implica una cantidad no monetaria, este valor se rellenará.

Tipo: número

FeesEstimate La estimación de la tarifa de esta promoción, si está disponible. Para la estimación se da por hecho que se cumplen todas las condiciones requeridas para la promoción. No Tipo: FeesEstimate

PromotionActiveTimeRange

En la siguiente tabla se muestran las propiedades del objeto PromotionActiveTimeRange:

NombreDescripciónObligatorioValor
EffectiveFromDateFecha (incluyente) en la que la promoción entra en vigor.Tipo: cadena
EffectiveThroughDateFecha (excluyente) en la que ha finalizado la promoción.Tipo: cadena

Esquema de notificación: FeePromotionNotification.json

Ejemplo de notificación

{ "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 vendedores y proveedores pueden suscribirse a esta notificación.

La notificación FEED_PROCESSING_FINISHED se envía cada vez que un fichero enviado mediante la API del colaborador comercial para ficheros alcanza el estado de procesamiento de ficheros de DONE, CANCELLED o FATAL.

Esquema de carga útil: versión 1.0

Flujo de trabajo: Flujo de trabajo de Amazon Simple Queue Service

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

Nombre Descripción Type Obligatorio
accountId El identificador de cliente del vendedor o el identificador de grupo de proveedores de la cuenta del socio vendedor en cuyo nombre se envió el fichero. string
sellerId El identificador de cliente vendedor de la cuenta del socio vendedor en cuyo nombre se envió el fichero. Este campo será nulo cuando el fichero se envíe en nombre de un identificador de grupo de proveedores. string No
feedId El identificador del fichero. string
feedType El tipo de fichero. Para obtener más información, consulta valores de feedType. string
processingStatus El estado de procesamiento del fichero. string
resultFeedDocumentId El identificador del documento del fichero. Este identificador es único solo si se combina con un identificador de vendedor. string No

Esquema de notificación: FeedProcessingFinishedNotification.json

Ejemplo de notificación para comerciantes

{ "notificationVersion": "2020-09-04", "notificationType": "FEED_PROCESSING_FINISHED", "payloadVersion": "2020-09-04", "eventTime": "2020-07-13T19:42:04.284Z", "payload": { "feedProcessingFinishedNotification": { "sellerId": "A3TH9S8BH6GOGM", "accountId": "amzn1.merchant.o.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:45:04.284Z", "notificationId": "d0e9e693-c3ad-4373-979f-ed4ec98dd746" } }

Ejemplo de notificación para proveedores

{ "notificationVersion": "2020-09-04", "notificationType": "FEED_PROCESSING_FINISHED", "payloadVersion": "2020-09-04", "eventTime": "2020-07-13T19:42:04.284Z", "payload": { "feedProcessingFinishedNotification": { "accountId": "amzn1.vg.6213651", "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:45:04.284Z", "notificationId": "d0e9e693-c3ad-4373-979f-ed4ec98dd746" } }

FULFILLMENT_ORDER_STATUS

Los vendedores pueden suscribirse a esta notificación.

La notificación FULFILLMENT_ORDER_STATUS se envía cada vez que hay un cambio en el estado de un peidido de Logística Multicanal.

Esquema de carga útil: versión 1.0

Flujo de trabajo: Flujo de trabajo de Amazon Simple Queue Service

FulfillmentOrderStatusNotification

En la tabla siguiente se muestran los objetos y las propiedades del objeto FulfillmentOrderStatusNotification:

Nombre Descripción
EventType

Indica si la notificación contiene información sobre el pedido, el envío o la devolución.

Valores EventType:

Order: esta notificación contiene información sobre un pedido de gestión logística.

Shipment: esta notificación contiene información sobre un envío de gestión logística. Para obtener más información, consulta el objeto FulfillmentShipment.

Return: esta notificación contiene información sobre una devolución de gestión logística.

Obligatorio

Tipo: cadena

SellerId

El identificador del vendedor.

Tipo: cadena

StatusUpdatedDateTime

La fecha y la hora de la actualización más reciente del estado. En formato ISO 8601.

Obligatorio

Tipo: cadena

SellerFulfillmentOrderId

El identificador del pedido de gestión logística que has creado y enviado mediante la operación CreateFulfillmentOrder.

Obligatorio

Tipo: cadena

FulfillmentOrderStatus

El estado actual del pedido de gestión logística.

Valores FulfillmentOrderStatus:

  • Received: el pedido de gestión logística se recibió y validó. La validación incluye determinar que la dirección de destino es válida y que los registros de Amazon indican que el vendedor tiene suficiente inventario apto para la venta (sin daños) para gestionar el pedido. El vendedor puede cancelar un pedido de gestión logística cuyo estado sea Recibido.

  • Invalid: el pedido de gestión logística se ha recibido pero no se ha podido validar. Esto puede deberse a que la dirección de destino no sea válida o a que los registros de Amazon indiquen que el vendedor no dispone de existencias suficientes para gestionar el pedido. Cuando esto ocurre, el pedido de gestión logística no es válido y no se enviará ningún artículo del pedido.

  • Planning: el pedido de gestión logística se ha enviado a la red logística de Amazon para iniciar la planificación del envío, pero aún no se ha recogido ninguna unidad del inventario de ningún envío. El vendedor puede cancelar un pedido de gestión logística que esté en estado de planificación.

  • Processing: el proceso de recogida de unidades del inventario ha comenzado en al menos un envío del pedido de gestión logística. El vendedor no puede cancelar un pedido de gestión logística que tenga el estado de En proceso.

  • Cancelled: el vendedor ha cancelado el pedido de gestión logística.

  • Complete: se han gestionado todas las cantidades de artículos del pedido de gestión logística.

  • CompletePartialled: algunas cantidades de artículos del pedido de gestión logística se han gestionado; el resto se ha cancelado o no es apto para el envío.

  • Unfulfillable: no se ha podido gestionar ninguna cantidad de artículos del pedido de gestión logística porque el personal del centro logístico de Amazon no ha podido encontrar existencias para estos artículos o no ha podido encontrar stock en condiciones de venta (que no presentaran daños).

Obligatorio

Tipo: cadena

FulfillmentShipment

Información sobre la entrega y el artículo de un envío en un pedido de gestión logística.

Opcional. Se devuelve solo cuando EventType es Shipment.

Tipo: FulfillmentShipment

FulfillmentReturnItem

Información sobre un artículo que ha sido devuelto a un centro logístico de Amazon.

Opcional. Se devuelve solo cuando EventType es Return.

Tipo: FulfillmentReturnItem

FulfillmentReturnItem

En la tabla siguiente se muestran los objetos y las propiedades del objeto FulfillmentReturnItem:

Nombre Descripción
ReceivedDateTime

La fecha y la hora en que el centro logístico de Amazon recibió el artículo devuelto. En formato de fecha y hora ISO 8601.

Obligatorio

Tipo: cadena

ReturnedQuantity

La cantidad que se ha devuelto.

Obligatorio

Tipo: entero

SellerSKU

El SKU del vendedor del artículo.

Obligatorio

Tipo: cadena

FulfillmentShipment

En la tabla siguiente se muestran los objetos y las propiedades del objeto FulfillmentShipment:

Nombre Descripción
FulfillmentShipmentStatus

El estado actual del envío.

Valores de FulfillmentShipmentStatus:

  • Pending: ha comenzado el proceso de recogida de unidades del inventario.

  • Shipped: todos los paquetes del envío han salido del centro logístico.

  • CancelledByFulfiller: el centro logístico de Amazon no pudo gestionar el envío según lo previsto. Esto puede deberse a que el inventario no estaba en la ubicación prevista del centro logístico. Tras cancelar el pedido de gestión logística, Amazon crea inmediatamente un nuevo envío de gestión logística y vuelve a intentar gestionar el pedido.

  • CancelledBySeller: el envío se ha cancelado mediante la operación CancelFulfillmentOrder.

Obligatorio

Tipo: cadena

AmazonShipmentId

Un identificador de envío asignado por Amazon.

Obligatorio

Tipo: cadena

EstimatedArrivalDateTime

La hora estimada de llegada del envío, en formato de fecha y hora ISO 8601. Ten en cuenta que este valor puede cambiar con el tiempo. Si un envío incluye varios paquetes, el valor de EstimatedArrivalDateTime se aplica a todos los paquetes del envío. Si el envío se ha cancelado, EstimatedArrivalDateTime no se devuelve.

Obligatorio

Tipo: cadena

FulfillmentShipmentPackages

Contiene todos los paquetes del envío de gestión logística.

Opcional

Tipo: matriz de FulfillmentShipmentPackage

FulfillmentShipmentPackage

En la tabla siguiente se muestran los objetos y las propiedades del objeto FulfillmentShipmentPackage:

Nombre Descripción
PackageNumber

Identifica un paquete dentro de un envío.

Obligatorio

Tipo: entero

CarrierCode

Identifica al transportista que entregará el paquete.

Obligatorio

Tipo: cadena

TrackingNumber

El número de seguimiento utilizado para obtener la información de seguimiento y entrega.

Obligatorio

Tipo: cadena

Esquema de notificación: FulfillmentOrderStatusNotification.json

Ejemplo de notificación

{ "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

Los vendedores y proveedores pueden suscribirse a esta notificación.

La notificación ITEM_INVENTORY_EVENT_CHANGE se envía a los cinco minutos del comienzo de cada hora. Esta notificación comparte los datos de inventario del nivel de ASIN e incluye los datos de la hora anterior, así como los datos retrasados de las 24 horas anteriores. Los ASIN se incluyen si el número de unidades disponibles para que compren los clientes
ha cambiado. Cada notificación puede incluir varios ASIN, y un colaborador comercial podría recibir varias notificaciones cada hora.

Esquema de carga útil: versión 1.0

Flujo de trabajo: Flujo de trabajo de Amazon Simple Queue Service

ItemInventoryEventChangeNotifications

NombreDescripciónObligatorioType
itemInventoryEventChangeNotificationsUna lista de métricas de inventario detalladas por hora por ASIN.Matriz de ItemInventoryEventChangeNotification

ItemInventoryEventChangeNotification

NombreDescripciónObligatorioType
accountIdEl ID de cliente del vendedor o el ID del grupo de proveedores de la cuenta del colaborador comercial al que se envía esta notificación.Cadena
marketplaceIdEl identificador de sitio web de los datos del inventario.Cadena
startTimeEl inicio del intervalo de fecha y hora de los datos de inventario en formato ISO 8601 en hora UTC.Cadena
endTimeEl final del intervalo de fecha y hora de los datos de inventario en formato ISO 8601 en hora UTC.Cadena
asinEl número de identificación estándar de Amazon del producto.Cadena
highlyAvailableInventoryEl número de unidades disponibles para la venta en el sitio web, en función de las unidades de los centros logísticos de Amazon que estén en condiciones de venderse, las unidades minúsculas que haya en las cestas de la compra de los clientes o que estén destinadas a otros pedidos (por ejemplo, pedidos de suscripción y ahorro).Número entero

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 vendedores y proveedores pueden suscribirse a esta notificación.

La notificación ITEM_SALES_EVENT_CHANGE se envía a los cinco minutos del comienzo de cada hora. Esta notificación comparte los datos de ventas del nivel de ASIN e incluye los datos de la hora anterior, así como los datos retrasados de las 24 horas anteriores. Los ASIN se incluyen cuando tienen pedidos o cancelaciones durante
una hora determinada. Cada notificación puede incluir varios ASIN y un colaborador comercial podría recibir varias notificaciones cada hora.

Esquema de carga útil: versión 1.0

Flujo de trabajo: Flujo de trabajo de Amazon Simple Queue Service

ItemSalesEventNotifications

NombreDescripciónObligatorioType
itemSalesEventChangeNotificationsUna lista de métricas de ventas detalladas por hora por ASIN.Matriz de ItemSalesEventChangeNotification

ItemSalesEventChangeNotification

NombreDescripciónObligatorioType
accountIdEl ID de cliente del vendedor o el ID del grupo de proveedores de la cuenta del colaborador comercial al que se envía esta notificación.Cadena
marketplaceIdEl identificador de sitio web de los datos de ventas.Cadena
currencyCodeEl código de divisa de cualquier importe monetario en formato ISO 4217.Cadena
startTimeEl inicio del intervalo de fecha y hora de los datos de ventas en formato ISO 8601 en hora UTC.Cadena
endTimeEl final del intervalo de fecha y hora de los datos de ventas en formato ISO 8601 en hora UTC.Cadena
asinEl número de identificación estándar de Amazon del producto.Cadena
orderedUnitsEl número de unidades solicitadas por los clientes de Amazon en el periodo de tiempo especificado. Este número puede ser negativo si hay más cancelaciones que pedidos.Número entero
orderedRevenueLas ventas del producto solicitado en el periodo de tiempo especificado. Se realizan ajustes en caso de cancelaciones.Número

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 vendedores pueden suscribirse a esta notificación.

Amazon envía una notificación ITEM_PRODUCT_TYPE_CHANGE cada vez que se produzca un cambio en el tipo de producto de cualquier producto con el que el colaborador comercial tenga una relación de marca. Un colaborador comercial mantiene una relación de marca con un producto, tal como se define en el programa de marcas registradas de Amazon, cuando es propietario verificado de la marca. El colaborador comercial es la entidad que autoriza a una aplicación a utilizar la API de notificaciones en su nombre, con el fin de crear y gestionar suscripciones de notificaciones. Amazon envía notificaciones de ITEM_PRODUCT_TYPE_CHANGE sobre productos publicados en cualquier sitio web de Amazon.

Esquema de carga útil: versión 1.0

Flujo de trabajo: Flujo de trabajo de Amazon EventBridge

Una notificación ITEM_PRODUCT_TYPE_CHANGE con PayloadVersion=1.0 incluye los siguientes objetos en el objeto Payload.

ObjetoDescripción
MarketplaceIdEl sitio web en el que se publica el artículo.
AsinEl ASIN del artículo.
PreviousProductTypeEl tipo de producto anterior.
CurrentProductTypeEl tipo de producto actual.

Esquema de notificación: ItemProductTypeChangeNotification.json

Ejemplo de notificación

{ "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 vendedores pueden suscribirse a esta notificación.

Amazon envía una notificación LISTINGS_ITEM_STATUS_CHANGE cuando el estado de un artículo de listing cambia para un colaborador comercial. Las notificaciones LISTINGS_ITEM_STATUS_CHANGE se publican cuando se crea o elimina un artículo de listing o cuando cambia su capacidad de compra. La carga útil de la notificación proporciona la información y el estado actuales del artículo de listing. Amazon envía notificaciones LISTINGS_ITEM_STATUS_CHANGE sobre artículos publicados en cualquier sitio web de Amazon.

Para obtener información adicional relacionada con el listing, como problemas con los artículos de listings, llama a la API del colaborador comercial para artículos de listings. Para obtener más información, consulta Guía de casos de uso de la API de artículos de listings.

El colaborador comercial es la entidad que autoriza a una aplicación a llamar a la API de notificaciones en su nombre con el fin de crear y gestionar suscripciones de notificaciones.

Esquema de carga útil: versión 1.0

Flujo de trabajo: Flujo de trabajo de Amazon EventBridge

Una notificación LISTINGS_ITEM_STATUS_CHANGE con PayloadVersion=1.0 incluye los siguientes objetos en el objeto Payload.

Nombre Descripción Type Obligatorio
SellerID Identificador del colaborador comercial, como la cuenta de un colaborador comercial (vendedor), del artículo de listings afectado. string
MarketplaceId Identificador del sitio web de Amazon del artículo de listings afectado. string No
Asin El identificador del número de identificación estándar (ASIN) de Amazon del artículo del catálogo asociado al artículo de listings. string No
Sku Identificador del artículo de listings afectado. string
CreatedDate Marca de tiempo de creación del artículo de listings con el formato de fecha y hora ISO 8601. string No
Status Lista de estados asociados actualmente al artículo de listings afectado. La ausencia de un valor indica que el estado no se aplica actualmente al artículo de listing. Por ejemplo, si BUYABLE no está presente, el artículo de listing no se puede comprar actualmente. Matriz de ListingsItemStatus

ListingsItemStatus

En esta tabla se muestran los valores posibles para ListingsItemStatus:

NombreDescripción
BUYABLEIndica que el artículo de listings está disponible para su compra en el sitio web minorista de Amazon del sitio web de Amazon correspondiente. Cuando se proporciona, el artículo de listings se puede comprar. Si se omite, el artículo de listings no se puede comprar.
DISCOVERABLEIndica que el artículo del catálogo de Amazon (ASIN) asociado se puede encontrar en los resultados de búsqueda del sitio web minorista de Amazon del sitio web de Amazon correspondiente. Cuando se proporciona, se puede encontrar el artículo de listings. Si se omite, el artículo de listings no se puede detectar.
DELETEDCuando se proporciona, el artículo de listings se elimina. Si se omite, el artículo de listings no se elimina.

Esquema de notificación: ListingsItemStatusChangeNotification.json

Ejemplo de notificación

{ "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 vendedores y proveedores pueden suscribirse a esta notificación.

Amazon envía una notificación LISTINGS_ITEM_ISSUES_CHANGE cada vez que se produzca un cambio en los problemas relacionados con un producto del listing del que sea propietario el colaborador comercial. Los problemas indican que el producto del listing tiene problemas que son la causa de la inactividad del listing, de la supresión de búsquedas o de otros problemas de calidad. Por ejemplo, si la imagen del producto del colaborador comercial tiene baja resolución, este problema provocará que se supriman las búsquedas del producto. Amazon envía notificaciones LISTINGS_ITEM_ISSUES_CHANGE sobre productos publicados en cualquier sitio web de Amazon.

Las notificaciones de LISTINGS_ITEM_ISSUES_CHANGE se activan cuando se crea, corrige o actualiza un problema en un listing. La carga útil de notificaciones incluye información básica sobre el listing, la gravedad de los problemas relacionados y las medidas de cumplimiento derivadas de los problemas. Para obtener más información sobre los problemas relacionados con un listing, llama a la API del colaborador comercial para artículos de listings. Para obtener más información, consulta Guía de casos de uso de la API de artículos de listings.

Todos los problemas que pueden producirse con un listing no tienen los problemas definidos correspondientes. Por lo tanto, esta notificación no representa necesariamente todos los problemas de un listing (tampoco la API del colaborador comercial para artículos de listing). Amazon está trabajando para definir más problemas que representen con mayor precisión los problemas de listing que puedan surgir.

El colaborador comercial es la entidad que autoriza a una aplicación a llamar a la API de notificaciones en su nombre con el fin de crear y gestionar suscripciones de notificaciones.

En la actualidad, LISTINGS_ITEM_ISSUES_CHANGE la notificación admite dos versiones de carga útil: “2023-12-13”, y “1.0”. “2023-12-13” es más nuevo que “1.0”. “2023-12-13” tiene más “EnforcementActions” que “1.0”, que proporciona más información sobre el impacto de los problemas de los artículos de los listados. Por ejemplo, “LISTING_SUPPRESSED” la medida coercitiva anula la capacidad de compra del artículo del anuncio actual. Suscríbete o migra a una versión más reciente “2023-12-13”, y “1.0” la versión quedará obsoleta pronto.

Esquema de carga útil: versión 2023-12-13

Flujo de trabajo: Flujo de trabajo de Amazon EventBridge

Una notificación LISTINGS_ITEM_ISSUES_CHANGE con PayloadVersion=2020-09-04 incluye los siguientes objetos en el objeto Payload.

Nombre Descripción Type Obligatorio
SellerId Identificador de colaborador comercial, como una cuenta de colaborador comercial (vendedor) o un código de proveedor, del artículo de listings afectado. string
MarketplaceId Identificador del sitio web de Amazon del artículo de listings afectado. string No
Asin El identificador del número de identificación estándar (ASIN) de Amazon del artículo del catálogo asociado al artículo de listings. string No
Sku Identificador del artículo de listings afectado. string
Severities Lista de gravedad de los problemas relacionados con el artículo de listings afectado. Cuando no haya problemas que afecten al artículo de listings, NONE se proporciona en su lugar. Matriz de IssueSeverity
EnforcementActions Lista de las medidas de cumplimiento adoptadas por Amazon en relación con los problemas relacionados con el artículo del listing afectado. Valores posibles actuales:
  • LISTING_SUPPRESSED - Esta medida elimina la posibilidad de compra del artículo del anuncio actual.

  • ATTRIBUTE_SUPPRESSED - El valor de un atributo del artículo del listado no es válido, por lo que Amazon lo rechaza.

  • CATALOG_ITEM_REMOVED - Este artículo del catálogo está inactivo en Amazon y no se pueden comprar todas las ofertas de este producto en la plataforma correspondiente.

  • SEARCH_SUPPRESSED - Este valor indica que el elemento del catálogo está oculto en los resultados de búsqueda.

Matriz de cadenas No

IssueSeverity

En esta tabla se muestran los valores posibles para IssueSeverity:

NombreDescripción
ERRORCuando se proporciona, al menos un problema con ERROR se ha producido un error de validación que ha impedido que se procese el envío.
WARNINGCuando se proporciona, al menos un problema con WARNING se ha producido una gravedad que debe revisarse, pero no ha impedido que se procese el envío.
NONECuando se proporciona, no hay problemas definidos que afecten al artículo de listings. Sin embargo, es posible que haya otros problemas con el listing.

Esquema de notificación: ListingsItemIssuesChangeNotification_2023-12-13.json

Ejemplo de notificación

{ "NotificationVersion":"1.0", "NotificationType":"LISTINGS_ITEM_ISSUES_CHANGE", "PayloadVersion":"2023-12-13", "EventTime":"2021-02-03T18:59:30.194Z", "Payload":{ "SellerId": "AXXXXXXXXXXXXX", "MarketplaceId": "ATVPDKIKX0DER", "Asin": "BT6RZ7JM4H", "Sku": "NLS-SHOES-03", "Severities": [ "ERROR", "WARNING" ], "EnforcementActions": [ "SEARCH_SUPPRESSED", "LISTING_SUPPRESSED", "ATTRIBUTE_SUPPRESSED", "CATALOG_ITEM_REMOVED" ] }, "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" } }

Esquema de carga útil de LISTINGS_ITEM_ISSUES_CHANGE: versión 1.0

Una notificación LISTINGS_ITEM_ISSUES_CHANGE con PayloadVersion=1.0 incluye los siguientes objetos en el objeto Payload.

Nombre Descripción Type Obligatorio
SellerId Identificador de colaborador comercial, como una cuenta de colaborador comercial (vendedor) o un código de proveedor, del artículo de listings afectado. string
MarketplaceId Identificador del sitio web de Amazon del artículo de listings afectado. string No
Asin El identificador del número de identificación estándar (ASIN) de Amazon del artículo del catálogo asociado al artículo de listings. string No
Sku Identificador del artículo de listings afectado. string
Severities Lista de gravedad de los problemas relacionados con el artículo de listings afectado. Cuando no haya problemas que afecten al artículo de listings, NONE se proporciona en su lugar. Matriz de IssueSeverity
EnforcementActions Lista de medidas de cumplimiento adoptadas por Amazon con relación a los problemas asociados con el artículo de listings afectado. Matriz de IssueEnforcementActions No

IssueSeverity

En esta tabla se muestran los valores posibles para IssueSeverity:

NombreDescripción
ERRORCuando se proporciona, al menos un problema con ERROR se ha producido un error de gravedad que ha impedido que se procese el envío, por ejemplo, un error de validación.
WARNINGCuando se proporciona, al menos un problema con WARNING se ha producido una gravedad que debe revisarse, pero no ha impedido que se procese el envío.
NONECuando se proporciona, no hay problemas definidos que afecten al artículo de listings. Sin embargo, es posible que haya otros problemas con el listing.

IssueEnforcementActions

En esta tabla se muestran los valores posibles para IssueEnforcementActions:

NombreDescripción
SEARCH_SUPPRESSEDCuando se proporciona, el artículo de listing se suprime de los resultados de búsqueda debido al menos a un problema asociado actualmente con el artículo de listing afectado.

Esquema de notificación: ListingsItemIssuesChangeNotification.json

Ejemplo de notificación

{ "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 vendedores pueden suscribirse a esta notificación.

Amazon envía una notificación LISTINGS_ITEM_MFN_QUANTITY_CHANGE a un integrador o vendedor cada vez que cambie la cantidad disponible para el artículo del listing gestionado por el vendedor (Red logística del vendedor). La cantidad disponible es el número de unidades que los clientes pueden pedir en Amazon. Cuando un cliente hace un pedido, Amazon reduce el número de unidades solicitadas con respecto a la cantidad disponible para ese artículo del listing. Cuando la cantidad disponible llegue a cero, los clientes ya no podrán realizar pedidos del artículo. Los colaboradores comerciales suelen actualizar Amazon con el número exacto de unidades disponibles en sus existencias para que los clientes puedan realizar pedidos.

La cantidad disponible de un artículo de listing cambia debido a varios factores, como las actualizaciones de la cantidad de inventario del colaborador comercial, la realización de nuevos pedidos y la cancelación de los pedidos existentes. Con esta notificación, los colaboradores comerciales suscritos ya no tendrán que sondear constantemente la operación getListingsItem de colaborador comercial ni la API de pedidos para obtener la última cantidad disponible.

Las principales características de esta notificación son las siguientes:

  • Los colaboradores comerciales se mantienen actualizados sobre el inventario real disponible en Amazon.
  • Los colaboradores comerciales planifican con antelación en función de los niveles de inventario para satisfacer la demanda de los artículos de listings.
  • Los colaboradores comerciales sincronizan y actualizan los niveles de inventario de los artículos de listings con sus sistemas internos y a través de sus otros canales de venta.
  • Los colaboradores comerciales no necesitan sondear con frecuencia el informe de inventario ni llamar a la operación getListingsItem de colaborador comercial para determinar la cantidad disponible.

Esquema de carga útil: versión 1.0

Flujo de trabajo: Flujo de trabajo de Amazon EventBridge

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

Nombre Descripción Type Obligatorio
SellerId El token de vendedor del colaborador comercial propietario del artículo de listings. string
FulfillmentChannelCode El código del canal de gestión logística que representa el programa, la red o el canal de logística Red logística del vendedor (gestionado por el vendedor) en el que se aplica la cantidad. string
Sku Un colaborador comercial ha proporcionado el identificador de un artículo de listings en Amazon. string
Quantity El número de unidades disponibles en Amazon. entero

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 vendedores 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 los cambios en el estado del pedido y las cancelaciones solicitadas por el comprador.

Esta notificación admite el siguiente valor de eventFilter: orderChangeTypes. Para utilizar este filtro, también debes proporcionar el siguiente eventFilterType: "eventFilterType": "ORDER_CHANGE".

Consulta Directivas de procesamiento para obtener más información.

Esquema de carga útil: versión 1.0

Flujo de trabajo: Flujo de trabajo de Amazon Simple Queue Service

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

Nombre Descripción Type Obligatorio
NotificationLevel El nivel de la notificación actual. string
SellerId El identificador del colaborador comercial. string
AmazonOrderId Un identificador de pedido definido por Amazon en formato 3-7-7. string
OrderChangeType El tipo de cambio de pedido que ha activado el envío de la notificación. Los valores posibles son BuyerRequestedChange y OrderStatusChange. string
OrderChangeTrigger Detalles sobre la causa del envío de esta notificación ORDER_CHANGE. OrderChangeReason
Summary Información sobre el pedido y los artículos del pedido afectados por el cambio. OrderChangeSummary

OrderChangeReason

Nombre Descripción Type Obligatorio
TimeOfOrderChange La hora del cambio que ha provocado esta notificación, en formato de fecha/hora ISO 8601. Será nulo cuando no haya ninguna marca de tiempo relacionada. string
ChangeReason El motivo de que se haya enviado esta notificación ORDER_CHANGE. string

OrderChangeSummary

Nombre Descripción Type Obligatorio
MarketplaceID El identificador del pedido en el sitio web de Amazon. string
OrderStatus El estado actual del pedido. Los valores posibles incluyen UpComing, Pending, Unshipped, PartiallyShipped, PendingAvailability, Canceled, InvoiceUnconfirmed, Shipped y Unfulfillable. string
PurchaseDate La fecha de compra del pedido, en formato de fecha/hora ISO 8601. Será nulo cuando no haya información relacionada. string
DestinationPostalCode El código postal de destino. Será nulo cuando no haya información relacionada. string
FulfillmentType Tipo de gestión logística del pedido afectado, Red logística del vendedor o Red logística de Amazon. string
OrderType El tipo de pedido. string
NumberOfItemsShipped El número de artículos enviados. entero No
NumberOfItemsUnshipped El número de artículos no enviados. entero No
EarliestDeliveryDate El inicio del periodo de tiempo durante el cual te comprometiste a la gestión logística del pedido, en formato de fecha/hora ISO 8601. Se devuelve solo para pedidos gestionados por el vendedor. string No
LatestDeliveryDate El final del periodo de tiempo durante el cual te comprometiste a cumplir con el pedido, en formato de fecha/hora ISO 8601. Se devuelve solo para pedidos gestionados por el vendedor cuyo estado no es PendingAvailability, Pending ni Canceled. string No
EarliestShipDate El inicio del periodo durante el cual te comprometiste a enviar el pedido, en formato de fecha/hora ISO 8601. string No
LatestShipDate El final del periodo durante el cual te comprometiste a enviar el pedido, en formato de fecha/hora ISO 8601. string No
CancelNotifyDate El final del periodo durante el cual debes notificar al vendedor la posible cancelación, en formato de fecha/hora ISO 8601. string No
OrderPrograms Los programas de pedidos en los que participa este pedido. matriz de cadenas No
ShippingPrograms Los programas de envío en los que participa este pedido. matriz de cadenas No
EasyShipShipmentStatus El estado del pedido de Amazon Easy Ship. Esta propiedad se incluye solo para los pedidos de Amazon Easy Ship. string No
ElectronicInvoiceStatus El estado de la factura electrónica. string No
OrderItems Información sobre los artículos del pedido incluidos en este pedido. Para las notificaciones OrderItemLevel, una carga útil incluye un artículo, mientras que para las notificaciones OrderLevel, una carga útil incluye todos los artículos. Matriz de OrderItem

OrderItem

Nombre Descripción Type Obligatorio
OrderItemId El identificador del artículo del pedido definido por Amazon. string
SellerSKU El SKU específico del vendedor de un artículo. string
SupplySourceId El identificador único del origen de suministro. Será nulo cuando no haya información relacionada. string
OrderItemStatus El estado actual del artículo del pedido. Este campo tendrá un valor no nulo cuando los estados de los artículos sean diferentes. string No
Quantity El número de artículos del pedido. entero
QuantityShipped El número de artículos enviados. entero No
IsBuyerRequestedCancel Verdadero cuando el comprador ha solicitado la cancelación. booleano No
ItemEarliestDeliveryDate El inicio del periodo de tiempo durante el cual te has comprometido a la gestión logística del pedido. string No
ItemLatestDeliveryDate El final del periodo de tiempo durante el cual te has comprometido a la gestión logística del pedido. string No

Esquema de notificación: OrderChangeNotification.json

Ejemplo de notificación

{ "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" } }

PRICING_HEALTH

Los vendedores pueden suscribirse a esta notificación.

La notificación PRICING_HEALTH se envía cuando una oferta de un vendedor no reúne los requisitos para ser la oferta destacada (oferta de {{1}}) debido a un precio poco competitivo. Los vendedores pueden tomar medidas para que la oferta destacada vuelva a reunir los requisitos ajustando el precio total de la oferta (precio más gastos de envío menos puntos) con el fin de que coincida o sea inferior al precio de la competencia, o se ajuste a los precios de referencia proporcionados. Estos incluyen el precio de la oferta destacada, el precio de venta medio de 60 días, el precio más alto de 14 días (enviado y vendido por Amazon) y el precio de lista. Para poder optar a la oferta destacada, debes fijar precios competitivos y cumplir con otros criterios de elegibilidad diseñados para ofrecer a los clientes una excelente experiencia de compra, como precios, disponibilidad y rapidez de entrega excelentes. La oferta destacada es la oferta que el cliente elige Añadir a la cesta en la página de detalles del producto.

Esquema de carga útil: versión 1.0

Flujo de trabajo: Flujo de trabajo de Amazon Simple Queue Service

La notificación PRICING_HEALTH con PayloadVersion=1.0 incluye las siguientes propiedades en el objeto de carga útil.

Nombre Descripción
issueType El tipo de problema de la notificación.

Obligatorio.

Tipo: cadena

sellerId El identificador del vendedor de la oferta.

Obligatorio.

Tipo: cadena

offerChangeTrigger El evento que provocó el envío de la notificación.

Obligatorio.

Tipo: offerChangeTrigger

merchantOffer Ofrece los detalles del colaborador comercial (vendedor) que recibe la notificación.

Obligatorio.

Tipo: merchantOffer

summary Información sobre el producto para la que se modificó la oferta. La información de este resumen se aplica a todas las condiciones del producto.

Obligatorio.

Tipo: summary

buyBoxPrice

En la tabla siguiente se muestran los objetos y las propiedades del objeto buyBoxPrice:

Nombre Descripción
condition

Indica la condición del artículo.

Obligatorio.

Tipo: cadena

landedPrice

El listingPrice más gastos de envío.

Obligatorio.

Tipo: moneyType

listingPrice

El precio del artículo.

Obligatorio.

Tipo: moneyType

shipping

Los gastos de envío.

Obligatorio.

Tipo: moneyType

points

La cantidad de puntos Amazon que se ofrecen con la compra de un artículo.

Opcional.

Tipo: points

merchantOffer

En la tabla siguiente se muestran los objetos y las propiedades del objeto merchantOffer:

Nombre Descripción
condition Indica la condición del artículo.

Obligatorio.

Tipo: cadena

fulfillmentType Indica si el artículo lo gestiona Amazon o el vendedor.

Obligatorio.

Tipo: cadena

landedPrice El listingPrice más gastos de envío.

Obligatorio.

Tipo: moneyType

listingPrice El precio del artículo.

Obligatorio.

Tipo: moneyType

shipping Los gastos de envío.

Obligatorio.

Tipo: cadena

points La cantidad de puntos Amazon que se ofrecen con la compra de un artículo.

Opcional.

Nota: el objeto Points solo se devuelve en Japón (JP).

Tipo: points

offerChangeTrigger

En la tabla siguiente se muestran los objetos y las propiedades del objeto offerChangeTrigger:

Nombre Descripción
marketplaceId El identificador del sitio web del artículo al que se le ha cambiado la oferta.

Obligatorio.

Tipo: cadena

asin El ASIN del artículo al que se le ha cambiado la oferta.

Obligatorio.

Tipo: cadena

itemCondition La condición del artículo afectado por un cambio en la oferta.

Obligatorio.

Tipo: cadena

timeOfOfferChange La hora de actualización de la oferta que provocó esta notificación.

Opcional.

Tipo: cadena

offerCount

En la tabla siguiente se muestran los objetos y las propiedades del objeto offerCount:

Nombre Descripción
condition

Indica la condición del artículo.

Obligatorio.

Tipo: cadena

fulfillmentType

Indica si el artículo lo gestiona Amazon o el vendedor.

Obligatorio.

Tipo: cadena

offerCount

El número total de ofertas para la condición y el canal de gestión logística especificados.

Obligatorio.

Tipo: entero

points

En la tabla siguiente se muestran los objetos y las propiedades del objeto points:

Nombre Descripción
pointsNumber

La cantidad de puntos Amazon que se ofrecen con la compra de un artículo.

Obligatorio.

Tipo: entero

referencePrice

En la tabla siguiente se muestran los objetos y las propiedades del objeto referencePrice:

Nombre Descripción
averageSellingPrice

El precio medio de venta del artículo.

Opcional.

Tipo: moneyType

competitivePriceThreshold

El umbral de precio competitivo de los competidores externos de Amazon.

Opcional.

Tipo: moneyType

retailOfferPrice

El precio máximo de oferta minorista de 14 días.

Opcional.

Tipo: moneyType

msrpPrice

El fabricante sugirió el precio de venta al público del ASIN.

Opcional.

Tipo: moneyType

salesRank

En la tabla siguiente se muestran los objetos y las propiedades del objeto salesRank:

Nombre Descripción
productCategoryId

La categoría de producto del índice.

Obligatorio.

Tipo: cadena

rank

El índices de ventas del ASIN.

Obligatorio.

Tipo: entero

summary

En la tabla siguiente se muestran los objetos y las propiedades del objeto summary:

Nombre Descripción
numberOfOffers

Una lista que contiene el número total de ofertas del artículo para las condiciones y los canales de gestión logística determinados.

Obligatorio.

Tipo: matriz de offerCount

buyBoxEligibleOffers

Una lista que contiene el número total de ofertas que son aptas para el {{0}} según las condiciones y los canales de gestión logística determinados.

Obligatorio.

Tipo: matriz de offerCount

buyBoxPrices

Una lista que contiene el precio de {{0}} del artículo para las condiciones determinadas.

Opcional.

Tipo: matriz de buyBoxPrice

salesRankings

Una lista que contiene las clasificaciones de ventas del ASIN en varias categorías de productos.

Opcional.

Tipo: matriz de salesRank

referencePrice

Conjunto de precios de referencia para un ASIN determinado.

Obligatorio.

Tipo: referencePrice

Esquema de notificación: PricingHealthNotification.json

Ejemplo de notificación

{ "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 vendedores y proveedores pueden suscribirse a esta notificación.

La notificación PRODUCT_TYPE_DEFINITIONS_CHANGE se envía cada vez que hay un nuevo tipo de producto o una nueva versión de tipo de producto.

Si la notificación se activa al añadir uno o más tipos de productos nuevos en un sitio web, la carga útil de notificación proporciona los nombres de los nuevos tipos de productos y la versión del tipo de producto aplicable a esos tipos de productos.

Si la notificación solo se activa con una nueva versión del tipo de producto, la carga útil de la notificación proporciona la nueva versión del tipo de producto.

Para obtener más información sobre los tipos de productos, consulta la Guía de casos de uso de la API de definiciones de tipo de producto.

Esquema de carga útil: versión 1.0

Flujo de trabajo: Flujo de trabajo de Amazon EventBridge

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

Nombre Descripción Type Obligatorio
AccountId El identificador del colaborador comercial, como la cuenta del colaborador comercial (vendedor) o el ID del grupo de proveedores. string
MarketplaceId Identificador del sitio web de Amazon del tipo de producto o versión del tipo de producto afectado. string No
ProductTypeVersion Versión de la definición de tipos de productos de Amazon publicada recientemente. string
NewProductTypes Lista de tipos de productos lanzados en un sitio web. Matriz de cadenas No

Esquema de notificación: ProductTypeDefinitionsChangeNotification.json

Ejemplo de notificación

Ejemplo 1: Notificación con nuevos tipos de productos

{ "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 cambio de versión del tipo de producto

{ "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 vendedores y proveedores pueden suscribirse a esta notificación.

La notificación REPORT_PROCESSING_FINISHED se envía cada vez que un informe que hayas solicitado a través de la API del colaborador comercial alcanza el estado de procesamiento de informes de DONE, CANCELLED o FATAL.

Esquema de carga útil: versión 1.0

Flujo de trabajo: Flujo de trabajo de Amazon Simple Queue Service

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

Nombre Descripción Type Obligatorio
accountId El identificador de cliente del vendedor o el identificador del grupo de proveedores de la cuenta del socio vendedor en cuyo nombre se presentó el informe. string
sellerId El identificador de cliente vendedor de la cuenta del socio vendedor en cuyo nombre se envió el fichero. Este campo será nulo cuando el fichero se envíe en nombre de un identificador de grupo de proveedores. string No
reportId El identificador del informe. string
reportType El tipo de informe. Para obtener más información, consulta los valores de reportType. string
processingStatus El estado de procesamiento del informe. string
reportDocumentId El identificador del documento del informe. Este identificador es único solo si se combina con un ID de vendedor. string No

Esquema de notificación: ReportProcessingFinishedNotification.json

Ejemplo de notificación para comerciantes

{ "notificationVersion": "2020-09-04", "notificationType": "REPORT_PROCESSING_FINISHED", "payloadVersion": "2020-09-04", "eventTime": "2020-07-14T03:35:13.214Z", "payload": { "reportProcessingFinishedNotification": { "sellerId": "A3TH9S8BH6GOGM", "accountId": "amzn1.merchant.o.A3TH9S8BH6GOGM", "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:45:04.284Z", "notificationId": "d0e9e693-c3ad-4373-979f-ed4ec98dd746" } }

Ejemplo de notificación para proveedores

{ "notificationVersion": "2020-09-04", "notificationType": "REPORT_PROCESSING_FINISHED", "payloadVersion": "2020-09-04", "eventTime": "2020-07-14T03:35:13.214Z", "payload": { "reportProcessingFinishedNotification": { "accountId": "amzn1.vg.6213651", "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:45:04.284Z", "notificationId": "d0e9e693-c3ad-4373-979f-ed4ec98dd746" } }

TRANSACTION_UPDATE

Los vendedores pueden suscribirse a esta notificación.

El TRANSACTION_UPDATE la notificación se envía cada vez que se publica una nueva transacción en la cuenta del vendedor.

Esquema de carga útil: versión 1.0

Flujo de trabajo: Flujo de trabajo de Amazon Simple Queue Service

La notificación TRANSACTION_UPDATE con payloadVersion=1.0=1.0 incluye las siguientes propiedades en el objeto TransactionUpdateNotification.

NombreDescripciónType
SellingPartnerMetadataMetadatos que describen al vendedor.SellingPartnerMetadata
RelatedIdentifiersIdentifiers related to the transaction, such as order and shipment IDs.matriz < RelatedIdentifier >
TransactionTypeEl tipo de transacción.string
PostedDateLa fecha y la hora en que se registró la transacción.Fecha
TotalAmountLa cantidad total de dinero de la transacción.Currency

SellingPartnerMetadata

NombreDescripciónType
SellingPartnerIdUn identificador de vendedor único.string
AccountTypeEl tipo de cuenta de la transacción.string
MarketplaceIdEl identificador de la plataforma en la que se produjo la transacción.string

RelatedIdentifier

NombreDescripciónType
RelatedIdentifierNameUn conjunto enumerado de nombres de identificadores empresariales relacionados.string
RelatedIdentifierValueValor correspondiente de RelatedIdentifierNamestring

Currency

NombreDescripciónType
CurrencyAmountEl valor monetario.int
CurrencyCodeEl código de moneda de tres dígitos en formato ISO 4217.string

Esquema de notificación: TransactionUpdateNotification.json

Ejemplo de notificación:

{ "NotificationVersion": "1.0", "NotificationType": "TRANSACTION_UPDATE", "PayloadVersion": "1.0", "EventTime": "2023-07-14T03:35:13.214Z", "NotificationMetadata": { "ApplicationId": "amzn1.sellerapps.app.aacccfff-4455-4b7c-4422-664ecacdd336", "SubscriptionId": "subscription-id-d0e9e693-c3ad-4373-979f-ed4ec98dd746", "PublishTime": "2020-07-14T03:35:13.214Z", "NotificationId": "d0e9e693-c3ad-4373-979f-ed4ec98dd746" }, "Payload": { "TransactionUpdateNotification": { "SellingPartnerMetadata": { "SellingPartnerId": "A3TH9S8BH6GOGM", "MarketplaceId": "ATIV93840DER", "AccountType": "PAYABLE" }, "RelatedIdentifiers": [ { "RelatedIdentifierName": "OrderId", "RelatedIdentifierValue": "8129762527551" } ], "TransactionType": "Shipment", "PostedDate": "2020-07-14T03:35:13.214Z", "TotalAmount": { "CurrencyAmount": 10, "CurrencyCode": "USD" } } } }

Tipos comunes

Contiene los tipos comunes que utilizan todas las notificaciones incluidas en los objetos de carga útil de notificaciones.

FulfillmentChannelType

Indica si el artículo lo gestiona Amazon o el vendedor.

Tipo: cadena

Valores FulfillmentChannelType:

  • Amazon

  • Merchant

moneyType

Tipo de divisa e importe.

En la siguiente tabla se muestran las propiedades del objeto MoneyType:

Nombre Descripción
amount

El importe en la divisa.

Tipo: número

currencyCode

Código de divisa de tres dígitos. En formato ISO 4217.

Tipo: cadena

MoneyType

Tipo de divisa e importe.

En la siguiente tabla se muestran las propiedades del objeto MoneyType:

Nombre Descripción
Amount

El importe en la divisa.

Tipo: número

CurrencyCode

Código de divisa de tres dígitos. En formato ISO 4217.

Tipo: cadena


¿Te ha ayudado esta página?