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
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: |
currentAccountStatus |
El estado de la nueva cuenta del vendedor. Obligatorio. Tipo: cadena Valores posibles: |
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
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: |
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: |
Offers |
Las 20 mejores ofertas competitivas para el artículo y la condición que activaron la notificación. Obligatorio. Tipo: matriz de |
BuyBoxPrice
BuyBoxPrice
En la tabla siguiente se muestran los objetos y las propiedades del objeto BuyBoxPrice
:
Nombre | Descripción |
---|---|
LandedPrice |
ListingPrice + Shipping - Points . Obligatorio. Tipo: |
ListingPrice |
El precio del artículo. Obligatorio. Tipo: |
Shipping |
Los gastos de envío. Obligatorio. Tipo: |
Points |
La cantidad de puntos Amazon que se ofrecen con la compra de un artículo. Opcional. Nota: el objeto Tipo: |
Condition |
Indica la condición del artículo. Por ejemplo: New , Used , Collectible , Refurbished o Club . Obligatorio. Tipo: cadena |
LowestPrice
LowestPrice
En la tabla siguiente se muestran los objetos y las propiedades del objeto LowestPrice
:
Nombre | Descripción |
---|---|
LandedPrice |
Obligatorio. Tipo: |
ListingPrice |
El precio del artículo. Obligatorio. Tipo: |
Shipping |
Los gastos de envío. Obligatorio. Tipo: |
Points |
La cantidad de puntos Amazon que se ofrecen con la compra de un artículo. Opcional. Nota: el objeto Tipo: |
Condition |
Indica la condición del artículo. Por ejemplo: Obligatorio. Tipo: cadena |
FulfillmentChannel |
Indica si el artículo lo gestiona Amazon o el vendedor. Obligatorio. Tipo: |
Offer
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: 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: |
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: |
ListingPrice |
El precio del artículo. Obligatorio. Tipo: |
Points |
La cantidad de puntos Amazon que se ofrecen con la compra de un artículo. Opcional. Nota: el objeto Tipo: |
Shipping |
Los gastos de envío. Obligatorio. Tipo: |
ShipsFrom |
El estado y el país desde donde se envía el artículo. Opcional. Tipo: |
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: |
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
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 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
Obligatorio. Tipo: cadena |
OfferCount
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: Obligatorio. Tipo: cadena |
FulfillmentChannel |
Indica si el artículo lo gestiona Amazon o el vendedor. Obligatorio. Tipo: |
OfferCount |
El número total de ofertas para la condición y el canal de gestión logística especificados. Obligatorio. Tipo: entero |
Points
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
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
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
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
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 Opcional. Tipo: cadena |
ShipsFrom
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
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 |
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 |
BuyBoxPrices |
Una lista que contiene el precio de {{0}} del artículo para las condiciones determinadas. Opcional. Tipo: matriz de |
ListPrice |
El precio de lista del artículo según lo sugerido por el fabricante. Opcional. Tipo: |
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: |
SalesRankings |
Una lista que contiene el rango de ventas del producto en las categorías de productos determinadas. Opcional. Tipo: matriz de |
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 |
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 Opcional. Tipo: |
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
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: |
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: |
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 |
SellerId |
El identificador del vendedor de la oferta. Obligatorio. Tipo: cadena |
BuyBoxPrice
BuyBoxPrice
En la tabla siguiente se muestran los objetos y las propiedades del objeto BuyBoxPrice
.
Nombre | Descripción |
---|---|
landedPrice |
Opcional. Tipo: |
listingPrice |
El precio del artículo. Obligatorio. Tipo: |
shipping |
Los gastos de envío. Opcional. Tipo: |
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: Obligatorio. Tipo: cadena |
sellerId |
El identificador del vendedor de la oferta. Opcional. Tipo: cadena |
LowestPrice
LowestPrice
En la tabla siguiente se muestran los objetos y las propiedades del tipo LowestPrice
debajo del objeto Summary
:
Nombre | Descripción |
---|---|
LandedPrice |
Opcional. Tipo: |
ListingPrice |
El precio del artículo. Obligatorio. Tipo: |
Shipping |
Los gastos de envío. Opcional. Tipo: |
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: Obligatorio. Tipo: cadena |
FulfillmentChannel |
Indica si el artículo lo gestiona Amazon o el vendedor. Obligatorio. Tipo: |
Offer
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: 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: |
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: |
ListingPrice |
El precio del artículo. Obligatorio. Tipo: |
Shipping |
Los gastos de envío. Obligatorio. Tipo: |
ShipsFrom |
El país desde el que se envía el artículo. Opcional. Tipo: |
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: |
IsFeaturedMerchant |
Indica si el vendedor del artículo puede ganar el {{0}}. Opcional. Tipo: booleano |
OfferChangeTrigger
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 Obligatorio. Tipo: cadena |
TimeOfOfferChange |
La hora de actualización de la oferta que provocó esta notificación. Obligatorio. Tipo: cadena |
OfferCount
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: Obligatorio. Tipo: cadena |
FulfillmentChannel |
Indica si el artículo lo gestiona Amazon o el vendedor. Obligatorio. Tipo: |
OfferCount |
El número total de ofertas para la condición y el canal de gestión logística especificados. Tipo: entero |
PrimeInformation
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
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
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 Opcional. Tipo: cadena |
ShipsFrom
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
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 |
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 |
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 |
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 |
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
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 |
Sí |
BrandName |
El nombre de la marca del artículo. Tipo: cadena |
Sí |
Asin |
El ASIN del artículo. Tipo: cadena |
Sí |
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. |
Sí |
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
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
DetailPageTrafficEventNotifications
En la tabla siguiente se muestran los objetos y las propiedades del objeto DetailPageTrafficEventNotifications
:
Nombre | Descripción | Obligatorio | Type |
---|---|---|---|
detailPageTrafficEventNotifications | Una lista de métricas de tráfico detalladas por hora por ASIN. | Sí | Matriz de DetailPageTrafficEventNotification |
DetailPageTrafficEventNotification
DetailPageTrafficEventNotification
Nombre | Descripción | Obligatorio | Type |
---|---|---|---|
accountId | El 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. | Sí | Cadena |
marketplaceId | El identificador de sitio web de los datos de tráfico. | Sí | Cadena |
startTime | El inicio del intervalo de fecha y hora de los datos de tráfico en formato ISO 8601 en hora UTC. | Sí | Cadena |
endTime | El final del intervalo de fecha y hora de los datos de tráfico en formato ISO 8601 en hora UTC. | Sí | Cadena |
asin | El número de identificación estándar de Amazon del producto. | Sí | Cadena |
glanceViews | El número de visualizaciones de los clientes de la página de detalles del producto de este ASIN. | Sí | 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
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
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: |
Stores |
A list of seller-enrolled stores that apply to this seller SKU. Tipo: matriz de cadenas |
FulfillmentInventory
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 Tipo: |
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. |
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
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 Tipo: número entero |
Shipped |
El número de unidades del elemento afectado que residen actualmente en un estado del envío 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
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
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
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: 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
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
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. | Sí |
Tipos de tarifas permitidos: Tipo: cadena |
FeeAmount |
El importe de la tarifa correspondiente al tipo de tarifa. | Sí | 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. | Sí |
El Tipo: |
IncludedFees |
Una lista estructurada de FeeDetail que contiene la distribución de un tipo de tarifa específico. |
No | Tipo: matriz de FeeDetail |
FeesEstimate
FeesEstimate
En la tabla siguiente se muestran los objetos y las propiedades del objeto FeesEstimate
:
Nombre | Descripción | Obligatorio | Valor |
---|---|---|---|
TimeOfFeesEstimated | La fecha y hora en la que se calcularon las tarifas. | Sí | Tipo: cadena |
TotalFeesEstimate | El importe total de las tarifas si el precio se reduce hasta el umbral de precio o por debajo de este. | Sí | Tipo: MoneyType |
FeeDetails | Una distribución del TotalFeesEstimate ). | Sí | Tipo: matriz de FeeDetail |
FeePromotionNotification
FeePromotionNotification
Cada objeto FeePromotionNotification
se compone de los siguientes objetos de datos:
Nombre | Descripción | Obligatorio | Valor |
---|---|---|---|
FeePromotionType |
El tipo de promoción. | Sí |
Valores: 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. | Sí | Tipo: cadena |
MerchantId |
La promoción se aplica a este merchantId. | Sí | Tipo: cadena |
Identifiers |
Lista de artículos a los que se aplica esta promoción. | Sí | Tipo: matriz de Identifier |
PromotionActiveTimeRange |
El intervalo de tiempo en el que esta promoción está activa. | Sí | Tipo: PromotionActiveTimeRange |
PromotionInformation |
Un objeto que contiene detalles adicionales sobre la promoción. Se incluye una estimación de la tarifa, si corresponde. | Sí | Tipo: PromotionInformation |
Identifier
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. | Sí |
Por ejemplo: ASIN, SKU, nodo de navegación y marca. Tipo: cadena |
IdentifierValues |
El nombre descriptivo del valor de ID. | Sí |
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 |
IdentifierValue
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. | Sí | 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
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. | Sí |
Tipos de tarifas permitidos: Tipo: cadena |
FeeDiscountType |
El tipo de promoción que recibirás por tus tarifas. | Sí |
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 Tipo: |
FeeDiscountValue |
El porcentaje de descuento de tus tarifas si FeeDiscountType implica una cantidad no monetaria. |
No |
Si el 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
PromotionActiveTimeRange
En la siguiente tabla se muestran las propiedades del objeto PromotionActiveTimeRange
:
Nombre | Descripción | Obligatorio | Valor |
---|---|---|---|
EffectiveFromDate | Fecha (incluyente) en la que la promoción entra en vigor. | Sí | Tipo: cadena |
EffectiveThroughDate | Fecha (excluyente) en la que ha finalizado la promoción. | Sí | 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
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 | Sí |
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 | Sí |
feedType |
El tipo de fichero. Para obtener más información, consulta valores de feedType . |
string | Sí |
processingStatus |
El estado de procesamiento del fichero. | string | Sí |
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
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
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
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 Obligatorio Tipo: cadena |
FulfillmentOrderStatus |
El estado actual del pedido de gestión logística. Valores
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 Tipo: |
FulfillmentReturnItem |
Información sobre un artículo que ha sido devuelto a un centro logístico de Amazon. Opcional. Se devuelve solo cuando 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
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:
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 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
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
ItemInventoryEventChangeNotifications
Nombre | Descripción | Obligatorio | Type |
---|---|---|---|
itemInventoryEventChangeNotifications | Una lista de métricas de inventario detalladas por hora por ASIN. | Sí | Matriz de ItemInventoryEventChangeNotification |
ItemInventoryEventChangeNotification
ItemInventoryEventChangeNotification
Nombre | Descripción | Obligatorio | Type |
---|---|---|---|
accountId | El 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. | Sí | Cadena |
marketplaceId | El identificador de sitio web de los datos del inventario. | Sí | Cadena |
startTime | El inicio del intervalo de fecha y hora de los datos de inventario en formato ISO 8601 en hora UTC. | Sí | Cadena |
endTime | El final del intervalo de fecha y hora de los datos de inventario en formato ISO 8601 en hora UTC. | Sí | Cadena |
asin | El número de identificación estándar de Amazon del producto. | Sí | Cadena |
highlyAvailableInventory | El 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). | Sí | 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
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
ItemSalesEventNotifications
Nombre | Descripción | Obligatorio | Type |
---|---|---|---|
itemSalesEventChangeNotifications | Una lista de métricas de ventas detalladas por hora por ASIN. | Sí | Matriz de ItemSalesEventChangeNotification |
ItemSalesEventChangeNotification
ItemSalesEventChangeNotification
Nombre | Descripción | Obligatorio | Type |
---|---|---|---|
accountId | El 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. | Sí | Cadena |
marketplaceId | El identificador de sitio web de los datos de ventas. | Sí | Cadena |
currencyCode | El código de divisa de cualquier importe monetario en formato ISO 4217. | Sí | Cadena |
startTime | El inicio del intervalo de fecha y hora de los datos de ventas en formato ISO 8601 en hora UTC. | Sí | Cadena |
endTime | El final del intervalo de fecha y hora de los datos de ventas en formato ISO 8601 en hora UTC. | Sí | Cadena |
asin | El número de identificación estándar de Amazon del producto. | Sí | Cadena |
orderedUnits | El 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. | Sí | Número entero |
orderedRevenue | Las ventas del producto solicitado en el periodo de tiempo especificado. Se realizan ajustes en caso de cancelaciones. | Sí | 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
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
.
Objeto | Descripción |
---|---|
MarketplaceId | El sitio web en el que se publica el artículo. |
Asin | El ASIN del artículo. |
PreviousProductType | El tipo de producto anterior. |
CurrentProductType | El 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
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 | Sí |
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 | Sí |
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 |
Sí |
ListingsItemStatus
ListingsItemStatus
En esta tabla se muestran los valores posibles para ListingsItemStatus
:
Nombre | Descripción |
---|---|
BUYABLE | Indica 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. |
DISCOVERABLE | Indica 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. |
DELETED | Cuando 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
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 | Sí |
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 | Sí |
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 |
Sí |
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:
|
Matriz de cadenas | No |
IssueSeverity
IssueSeverity
En esta tabla se muestran los valores posibles para IssueSeverity
:
Nombre | Descripción |
---|---|
ERROR | Cuando 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. |
WARNING | Cuando 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. |
NONE | Cuando 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 | Sí |
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 | Sí |
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 |
Sí |
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
IssueSeverity
En esta tabla se muestran los valores posibles para IssueSeverity
:
Nombre | Descripción |
---|---|
ERROR | Cuando 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. |
WARNING | Cuando 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. |
NONE | Cuando 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
IssueEnforcementActions
En esta tabla se muestran los valores posibles para IssueEnforcementActions
:
Nombre | Descripción |
---|---|
SEARCH_SUPPRESSED | Cuando 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
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 | Sí |
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 | Sí |
Sku |
Un colaborador comercial ha proporcionado el identificador de un artículo de listings en Amazon. | string | Sí |
Quantity |
El número de unidades disponibles en Amazon. | entero | Sí |
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
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 | Sí |
SellerId |
El identificador del colaborador comercial. | string | Sí |
AmazonOrderId |
Un identificador de pedido definido por Amazon en formato 3-7-7. | string | Sí |
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 | Sí |
OrderChangeTrigger |
Detalles sobre la causa del envío de esta notificación ORDER_CHANGE . |
OrderChangeReason |
Sí |
Summary |
Información sobre el pedido y los artículos del pedido afectados por el cambio. | OrderChangeSummary |
Sí |
OrderChangeReason
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 | Sí |
ChangeReason |
El motivo de que se haya enviado esta notificación ORDER_CHANGE . |
string | Sí |
OrderChangeSummary
OrderChangeSummary
Nombre | Descripción | Type | Obligatorio |
---|---|---|---|
MarketplaceID |
El identificador del pedido en el sitio web de Amazon. | string | Sí |
OrderStatus |
El estado actual del pedido. Los valores posibles incluyen UpComing , Pending , Unshipped , PartiallyShipped , PendingAvailability , Canceled , InvoiceUnconfirmed , Shipped y Unfulfillable . |
string | Sí |
PurchaseDate |
La fecha de compra del pedido, en formato de fecha/hora ISO 8601. Será nulo cuando no haya información relacionada. | string | Sí |
DestinationPostalCode |
El código postal de destino. Será nulo cuando no haya información relacionada. | string | Sí |
FulfillmentType |
Tipo de gestión logística del pedido afectado, Red logística del vendedor o Red logística de Amazon. | string | Sí |
OrderType |
El tipo de pedido. | string | Sí |
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 |
Sí |
OrderItem
OrderItem
Nombre | Descripción | Type | Obligatorio |
---|---|---|---|
OrderItemId |
El identificador del artículo del pedido definido por Amazon. | string | Sí |
SellerSKU |
El SKU específico del vendedor de un artículo. | string | Sí |
SupplySourceId |
El identificador único del origen de suministro. Será nulo cuando no haya información relacionada. | string | Sí |
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 | Sí |
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
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: |
merchantOffer |
Ofrece los detalles del colaborador comercial (vendedor) que recibe la notificación. Obligatorio. Tipo: |
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: |
buyBoxPrice
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 Obligatorio. Tipo: |
listingPrice |
El precio del artículo. Obligatorio. Tipo: |
shipping |
Los gastos de envío. Obligatorio. Tipo: |
points |
La cantidad de puntos Amazon que se ofrecen con la compra de un artículo. Opcional. Tipo: |
merchantOffer
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: |
listingPrice |
El precio del artículo. Obligatorio. Tipo: |
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 Tipo: |
offerChangeTrigger
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
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
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
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: |
competitivePriceThreshold |
El umbral de precio competitivo de los competidores externos de Amazon. Opcional. Tipo: |
retailOfferPrice |
El precio máximo de oferta minorista de 14 días. Opcional. Tipo: |
msrpPrice |
El fabricante sugirió el precio de venta al público del ASIN. Opcional. Tipo: |
salesRank
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
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 |
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 |
buyBoxPrices |
Una lista que contiene el precio de {{0}} del artículo para las condiciones determinadas. Opcional. Tipo: matriz de |
salesRankings |
Una lista que contiene las clasificaciones de ventas del ASIN en varias categorías de productos. Opcional. Tipo: matriz de |
referencePrice |
Conjunto de precios de referencia para un ASIN determinado. Obligatorio. Tipo: |
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
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 | Sí |
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 | Sí |
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
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 | Sí |
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 | Sí |
reportType |
El tipo de informe. Para obtener más información, consulta los valores de reportType . |
string | Sí |
processingStatus |
El estado de procesamiento del informe. | string | Sí |
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
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
.
Nombre | Descripción | Type |
---|---|---|
SellingPartnerMetadata | Metadatos que describen al vendedor. | SellingPartnerMetadata |
RelatedIdentifiers | Identifiers related to the transaction, such as order and shipment IDs. | matriz < RelatedIdentifier > |
TransactionType | El tipo de transacción. | string |
PostedDate | La fecha y la hora en que se registró la transacción. | Fecha |
TotalAmount | La cantidad total de dinero de la transacción. | Currency |
SellingPartnerMetadata
SellingPartnerMetadata
Nombre | Descripción | Type |
---|---|---|
SellingPartnerId | Un identificador de vendedor único. | string |
AccountType | El tipo de cuenta de la transacción. | string |
MarketplaceId | El identificador de la plataforma en la que se produjo la transacción. | string |
RelatedIdentifier
RelatedIdentifier
Nombre | Descripción | Type |
---|---|---|
RelatedIdentifierName | Un conjunto enumerado de nombres de identificadores empresariales relacionados. | string |
RelatedIdentifierValue | Valor correspondiente de RelatedIdentifierName | string |
Currency
Currency
Nombre | Descripción | Type |
---|---|---|
CurrencyAmount | El valor monetario. | int |
CurrencyCode | El 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
FulfillmentChannelType
Indica si el artículo lo gestiona Amazon o el vendedor.
Tipo: cadena
Valores FulfillmentChannelType
:
-
Amazon
-
Merchant
moneyType
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
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 |
Updated about 1 month ago