Notas de lanzamiento de la SP-API
Nuevas funciones, actualizaciones de software y registro de cambios de la API de socios vendedores.
Para ver las versiones anteriores al 19 de enero de 2022, consulta Anuncios en el Repositorio de GitHub de la API del colaborador comercial.
27 de febrero de 2025
Cambios en la documentación
- Se ha añadido un Actualizaciones de metadatos del producto SP-API página, que muestra los cambios en los metadatos de todos los tipos de productos en las plataformas afectadas.
26 de febrero de 2025
Cambios en la API
-
Se han añadido las siguientes operaciones a la API Amazon Warehousing and Distribution (AWD) v2024-05-09:
createInbound
: Crea un borrador de pedido entrante con tracción integral con una lista de paquetes para su envío entrante. La operación crea un envío por pedido.getInbound
: Recupera un pedido entrante con tracción integral.updateInbound
: Actualiza un pedido entrante con AWD que está enDRAFT
estado y aún no se ha confirmado. Utilice esta operación para actualizar elpackagesToInbound
,originAddress
, ypreferences
atributos.cancelInbound
: Cancela un pedido entrante con tracción integral y su envío asociado.confirmInbound
: Confirma un pedido entrante con tracción integral enDRAFT
estado.getInboundShipmentLabels
: Recupera las etiquetas de caja de un identificador de envío que especifiques. Se trata de una operación asincrónica. Si el estado de la etiqueta esGENERATED
, entonces la URL de la etiqueta está disponible.updateInboundShipmentTransportDetails
: Actualiza los detalles de transporte de un envío con tracción integral.checkInboundEligibility
: Determina si los paquetes que especificas son aptos para un pedido entrante con tracción integral.
-
Se ha añadido un tutorial que muestra cómo crear un pedido entrante para su envío a AWD. Para obtener más información, consulta Tutorial: Crea un pedido entrante para enviarlo a AWD.
- Se agregó el
includedData
matriz al JSON_LISTINGS_FEED. Si especificas elincludedData
En la cabecera del feed, el informe incluye una lista de los problemas que se producen tras la aceptación del envío de tu anuncio. - El Guía de flujos de trabajo de administración de listados de edificios ahora incluye instrucciones sobre cómo usar el
includedData
conjunto deJSON_LISTINGS_FEED
para solucionar los problemas que se produzcan tras la aceptación del envío de tu anuncio. Para obtener más información, consulta Crea y actualiza artículos de listados de forma masiva.
- Añadido
deliveryWindow
a lagetPackageTrackingDetails
respuesta. Esta propiedad proporciona a los vendedores un intervalo de tiempo que describe cuándo se espera que se entregue un paquete.
-
Se agregaron dos nuevos Informes de análisis:
- Informe de rendimiento del catálogo de búsqueda: proporciona métricas de interacción de búsqueda, como impresiones, clics, adiciones al carrito y compras para un intervalo de fechas específico.
- Informe de rendimiento de las consultas de búsqueda: proporciona el rendimiento general de las consultas, como las impresiones, los clics, las adiciones al carrito y las compras para un ASIN determinado y un intervalo de fechas específico.
- Se agregó la API de vehículos v2024-11-01, que puedes usar para recuperar información sobre los vehículos, incluidos sus identificadores únicos. Puedes usar esta información y la API de listados para proporcionar la lista de vehículos con los que son compatibles los ASIN que figuran en la lista.
Cambios en la documentación
- Se agregó un tema que enumera las funciones requeridas para cada operación de SP-API, tipo de fuente, tipo de notificación y tipo de informe. Puedes usar esta información como ayuda para seleccionar los roles al registrarte como desarrollador. Para obtener más información, consulte Mapeos de roles.
Avisos de eliminación
Los recursos de SP-API obsoletos ya no están en desarrollo activo. Las llamadas a los recursos de SP-API obsoletos fallarán a partir de su fecha de eliminación. Para obtener una lista completa de las aplicaciones obsoletas de SP-API, consulte Calendario de obsolescencia de SP-API.
La fecha de eliminación de los siguientes valores de tipo de feeds ha cambiado del 31 de marzo de 2025 al 30 de junio de 2025.
POST_FLAT_FILE_BOOKLOADER_DATA
POST_FLAT_FILE_CONVERGENCE_LISTINGS_DATA
POST_FLAT_FILE_INVLOADER_DATA
POST_FLAT_FILE_LISTINGS_DATA
POST_FLAT_FILE_PRICEANDQUANTITYONLY_UPDATE_DATA
POST_INVENTORY_AVAILABILITY_DATA
POST_PRODUCT_DATA
POST_PRODUCT_IMAGE_DATA
POST_PRODUCT_OVERRIDES_DATA
POST_PRODUCT_PRICING_DATA
POST_PRODUCT_RELATIONSHIP_DATA
POST_UIEE_BOOKLOADER_DATA
Para obtener más información, consulte Migración de flujos de trabajo de feeds de productos.
29 de enero de 2025
Cambios en la API
- Se agregó el parámetro de respuesta opcional
replenishmentQuantity
a lalistInventory
operación. Puedes usar este parámetro para revisar la información sobre las cantidades de las unidades que están en tránsito desde Amazon Warehousing and Distribution (AWD) a una instalación de Fulfillment by Amazon (FBA).
- El conjunto de datos de Vendor Analytics ahora incluye métricas como
sellableInTransitInventory
,unsellableInTransitInventory
,mostRecentSubmitted
,netOrderedGMS
, ynetShipmentGMS
. Puedes usar estas métricas para supervisar la disponibilidad del inventario, identificar problemas de gestión logística y comprender tu rendimiento de ventas.
- La respuesta del
listPackingOptions
la operación ahora describe los métodos de embalaje y los pesos de los paquetes aceptables en elsupportedConfigurations
propiedad. Esta propiedad sustituye a lasupportedShippingConfigurations
propiedad.
- Añadido
sampleLocation
a la respuesta delgetCompetitiveSummary
operación y la solicitud delgetFeaturedOfferExpectedPriceBatch
operación. Puedes usar esta métrica para obtener información sobre la ubicación de las ofertas destacadas y para recuperar el precio esperado (FOEP) de una oferta especial específica para una ubicación.
- Se actualizó el Informe de datos de usuario final para incluir el soporte para el mercado de Irlanda (IE).
Cambios en la documentación
- Se agregó un nuevo, interactivo Referencia de API para cada API, donde puedes crear solicitudes de forma dinámica en varios idiomas.
- Notas añadidas: bienvenido y Preguntas frecuentes sobre errores páginas para mejorar la capacidad de descubrimiento de Panel de estado de la API.
- Reestructuró el Guía del servicio de cálculo del IVA para mejorar el flujo y la legibilidad.
- Se actualizó el Guía de casos de uso de la versión 1 de las API de compras minoristas para proveedores para incluir las siguientes operaciones en función de los requisitos empresariales:
getPurchaseOrder
,SubmitShipmentConfirmations
,submitInvoices
, yGetShipmentDetails
. - Se agregó un tema de límite de velocidad para cada API. En estos nuevos temas se enumeran los planes de uso (límites de velocidad y valores de ráfaga) para cada operación. Para ver un ejemplo, consulte Límites de velocidad de la API de Data Kiosk.
- Se agregó un tutorial que muestra cómo usar las API de SP para recuperar y pasar un número de orden de compra a UPS, FedEx o USPS. Para obtener más información, consulte Tutorial: Recuperar y pasar un número de orden de compra a un transportista.
Avisos de eliminación
Los recursos de SP-API obsoletos ya no están en desarrollo activo. Las llamadas a los recursos de SP-API obsoletos fallarán a partir de su fecha de eliminación. Para obtener una lista completa de las aplicaciones obsoletas de SP-API, consulte Calendario de obsolescencia de SP-API.
- La fecha de retirada de Select API de artículos de catálogo v0 las operaciones cambiaron del 11 de diciembre de 2024 al 31 de marzo de 2025. Las operaciones afectadas son:
listCatalogItems
getCatalogItem
18 de diciembre de 2024
Cambios en la API
- Se ha añadido la propiedad de caducidad a
listInventory
ygetInboundShipment
respuestas. Puedes usar esta propiedad para obtener la fecha de caducidad de un artículo perecedero de tu envío. Para obtener más información, consulte Rastrea un envío entrante con los detalles del SKU esperado y recibido. - Se agregó el
prepDetails
propiedad dellistInventory
ygetInboundShipment
respuestas. Puedes usar esta propiedad para obtener los detalles de preparación de un artículo, incluidos el propietario de la preparación, la categoría, las instrucciones y el propietario de la etiqueta.
- El Conjunto de datos de análisis de proveedores ahora incluye métricas como las unidades confirmadas, el COGS enviado, el MSRP y los datos del código postal del cliente.
- Se agregó el
searchListingsItems
operación. Puedes usar esta operación para devolver la información de varios artículos de los listados en función de los filtros, que incluyen los ID de los anuncios, los problemas, el estado y la fecha de creación.
- Añadido
REVENUE_BY_DELIVERIES
,SUBSCRIBER_RETENTION
,REVENUE_PENETRATION_BY_SELLER_FUNDING
, ySHARE_OF_COUPON_SUBSCRIPTIONS
métricas para elgetSellingPartnerMetrics
respuesta de operación. Estas métricas describen las fuentes de ingresos y el rendimiento de las suscripciones. - Se agregó el
SHARE_OF_COUPON_SUBSCRIPTIONS
métrico allistOfferMetrics
respuesta de operación. Esta métrica describe el rendimiento de la adquisición de cupones.
- Se agregó el
storeName
propiedad delgetMarketplaceParticipations
respuesta. Puedes usar elstoreName
propiedad para obtener el nombre de la tienda del vendedor tal como se muestra en el mercado. - Se agregó el
MarketplaceParticipationList
matriz algetAccount
respuesta. LaMarketplaceParticipationList
la matriz reemplaza la matriz deMarketplaceLevelAttributes
. - Se quitó el
sellingPlan
parámetro delMarketplaceParticipationList
matriz y la agregó al nivel raíz delgetAccount
respuesta. Para obtener más información, consulte Guía de casos de uso de la API para vendedores v1. - El
getAccount
la operación requiere el Proveedor de servicios de información de cuentas (AISP) rol. Para obtener más información sobre este rol, consulte Registro de proveedores externos.
- El API de transferencias v2024-06-01 ya está disponible de forma general. Puedes usar esta API para recuperar información sobre los métodos de pago asociados a un vendedor e iniciar los pagos al método de depósito del vendedor registrado. Para usar esta API, debes seleccionar una de las siguientes funciones en la página de registro de la aplicación de tu aplicación:
Esta API está disponible en la región de la UE.
- Se agregó el
createContainerLabel
operación. Puede utilizar esta operación para crear una etiqueta de contenedor (palé).
- El
GetShipmentLabels
el funcionamiento de la versión 1 de la API Vendor Shipments ahora permite a los vendedores recuperar etiquetas de paquetes pequeños.
Expansión de Seller Central Marketplace a Irlanda (IE)
El 10 de diciembre de 2024, Seller Central lanzó el soporte para el Marketplace de Irlanda (IE). Para obtener más información, consulta URL de Seller Central de SP-API, Puntos finales de SP-API, y Identificadores de mercado temas de la documentación de SP-API.
Soporte de proveedores externos para desarrolladores de SP-API del Reino Unido y la UE
Los vendedores del Reino Unido y la UE ahora pueden autorizar a los proveedores externos (TPP) a acceder a la cuenta y a los servicios de pago del titular de la cuenta mediante el AISP y PISP roles.
Para obtener más información, consulte Registro de proveedores externos y Preguntas frecuentes sobre proveedores externos.
Cambios en la documentación
- Guía actualizada sobre cómo manejar valores de enumeración nulos.
Avisos de eliminación
Los recursos de SP-API obsoletos ya no están en desarrollo activo. Las llamadas a los recursos de SP-API obsoletos fallarán a partir de su fecha de eliminación. Para obtener una lista completa de las aplicaciones obsoletas de SP-API, consulte Calendario de obsolescencia de SP-API.
-
La fecha de retirada de Select API de artículos de catálogo v0 las operaciones cambiaron del 11 de diciembre de 2024 al 28 de enero de 2025. Las operaciones afectadas son:
listCatalogItems
getCatalogItem
-
La fecha de retirada del Notificaciones escriba un valor
LISTINGS_ITEM_ISSUES_CHANGE
(versión 1.0 de carga útil) cambió del 11 de diciembre de 2024 al 26 de marzo de 2025.
14 de noviembre de 2024
Cambios en la API
- Actualizó el API EasyShip v2022-03-23 para obtener soporte adicional para el mercado en los Países Bajos (NL) y Polonia (PL).
12 de noviembre de 2024
Cambios en la API
- Añadido
WasPrice
a lagetCompetitiveSummary
operación (en elreferencePrices
lista en la respuesta de la operación).WasPrice
es el precio medio de 90 días que los clientes pagan por el producto en Amazon. Puedes usar este valor para establecer promociones y descuentos en función del precio típico de la página de detalles del producto.
11 de noviembre de 2024
Cambios en la API
- Se actualizó el límite de tarifa para
initiatePayout
operación de 0,5 a 0,017 y se actualizó la velocidad de ráfaga de 30 a 2.
6 de noviembre de 2024
Cambios en la API
- Se agregó el
TransactionNumber
parámetro para elAdjustmentItem
objeto. Puede usar este parámetro para identificar con qué está relacionado el ajuste. Por ejemplo, los clientes de Amazon Shipping pueden usar esto para obtener un número de factura que puedan usar para identificar una factura de Amazon Shipping.
- Se ha añadido lo siguiente al Guía de casos de uso de la API Outbound de Fulfillment v2020-07-01:
items
ahora tiene límites de cantidad (máximo de 100 artículos con un máximo de 250 unidades por pedido).shippingSpeedCategory
ahora tiene acuerdos de nivel de servicio de métodos de envío que varían según el mercado.DeliveryPreferences
ahora tiene la preferencia de entrega predeterminada establecida para dejar el paquete desatendido en la puerta principal para los pedidos que cumplan los requisitos.
- Se actualizó el
getEligibleShippingServices
ycreateShipment
operaciones para incluir nuevas tasas de aceleración aumentadas.
- Se agregó soporte para el mercado japonés (JP) para
getFeaturedOfferExpectedPriceBatch
operación. Ahora puedes consultar el precio esperado de la oferta destacada (FOEP) de todos los sitios web.
Cambios en la documentación
-
Se agregó la siguiente información a Planes de uso y límites de tarifas:
- Detalles sobre el algoritmo de limitación de velocidad
- Factores que influyen en los límites de tarifas
- Cómo encontrar tus límites de tarifas
-
Se han añadido las siguientes páginas de límites de velocidad específicas de la API:
-
Se han añadido nuevas referencias interactivas para las siguientes API:
Avisos de eliminación
Los recursos de SP-API obsoletos ya no están en desarrollo activo. Las llamadas a los recursos de SP-API obsoletos fallarán a partir de su fecha de eliminación. Para obtener más información sobre las fechas de caducidad de SP-API, consulte la Calendario de obsolescencia de SP-API.
-
API de artículos de catálogo v0 (Seleccione las operaciones)
listCatalogItems
getCatalogItem
-
API de cumplimiento entrante v0 (Seleccione operaciones)
confirmPreorder
confirmTransport
createInboundShipment
createInboundShipmentPlan
estimateTransport
getPreorderInfo
getTransportDetails
putTransportDetails
updateInboundShipment
voidTransport
Para obtener más información, consulte Migración de los flujos de trabajo entrantes de cumplimiento.
POST_PRODUCT_DATA
POST_INVENTORY_AVAILABILITY_DATA
POST_PRODUCT_OVERRIDES_DATA
POST_PRODUCT_PRICING_DATA
POST_PRODUCT_IMAGE_DATA
POST_PRODUCT_RELATIONSHIP_DATA
POST_FLAT_FILE_INVLOADER_DATA
POST_FLAT_FILE_BOOKLOADER_DATA
POST_FLAT_FILE_CONVERGENCE_LISTINGS_DATA
POST_FLAT_FILE_LISTINGS_DATA
POST_FLAT_FILE_PRICEANDQUANTITYONLY_UPDATE_DATA
POST_UIEE_BOOKLOADER_DATA
Para obtener más información, consulte Migración de flujos de trabajo de feeds de productos.
LISTING_ITEM_ISSUES_CHANGE
payload versión 1.0
14 de octubre de 2024
Cambios en la API
- Se agregó el
listPrepDetails
ysetPrepDetails
operaciones para obtener y establecer los detalles de preparación.
- Se agregó el
TRANSACTION_UPDATE
notificación que se envía cada vez que se publica una nueva transacción en la cuenta del vendedor.
Cambios en la documentación
- Se agregó el Programe consultas en quioscos de datos guía, en la que se detalla cómo realizar llamadas regulares de forma automática a
createQuery
. - Nuevo Ejemplos de códigos de Fulfillment Inbound.
25 de septiembre de 2024
Cambios en la API
- Añadido
GroupByAttributes
a laanalytics_vendorAnalytics_2024_09_30
esquema. Estos atributos detallan la ubicación a la que se envían los artículos:shipToCountryCode
shipToCity
shipToStateOrProvince
- Se actualizó el
GetInventorySummariesResponse
para incluir un nuevoStores
matriz.Stores
contiene una lista de tiendas inscritas por el vendedor para el artículo de inventario afectado.
- Se actualizó el
FBAInventoryAvailabilityChangeNotification
objetar incluir un nuevoStores
matriz.Stores
contiene una lista de tiendas inscritas por el vendedor para el artículo de inventario afectado.
- Se agregó el opcional
storeName
campo alistFinancialEvents
respuesta. Este campo indica la tienda en la que se realizó la transacción y está contenido en los siguientes objetos:ShipmentEvent
PayWithAmazonEvent
ServiceFeeEvent
RemovalShipmentEvent
- Nuevo API de finanzas v2024-06-19 proporciona información financiera relevante para el negocio del vendedor. Puedes usar esta API para obtener los eventos financieros de un pedido o rango de fechas específico sin tener que esperar hasta que se cierre el período del estado de cuenta.
- Nuevo API de facturas para el mercado de Brasil que puede utilizar para buscar y recuperar facturas en función de criterios específicos y descargar de forma asincrónica las facturas devueltas. Para obtener más información, consulte Guía de casos de uso de la API de facturas.
- Se agregó el
AmazonPrograms
atribuir algetOrderItems
respuesta. Este atributo contiene la lista de programas que están asociados a un elemento, como Suscríbete y ahorra.
Cambios en la documentación
-
Se actualizó el Guía de flujos de trabajo de automatización del ajuste de precios para incluir estrategias de migración de Price Feed y actualizaciones masivas de precios mediante el
JSON_LISTINGS_FEED
. -
Se actualizó el Preguntas frecuentes sobre la API de precios de productos y las notificaciones para incluir:
-
Nuevo Ejemplos de códigos de API de precios de productos, que muestran cómo:
- Recupera y mapea los datos de SKU.
- Obtenga el precio del SKU.
- Calcula el precio de la nueva SKU.
- Envía un nuevo precio de SKU.
-
Nuevo Ejemplo de solución de precios B2C en GitHub, que incluye:
- Revaluación con respecto a
PRICING_HEALTH
notificaciones en Java y Python. - Lógica de revaluación en contra
ANY_OFFER_CHANGED
notificaciones en Java y Python.
- Revaluación con respecto a
-
Nuevo ejemplo de solución de precios B2B en GitHub, que incluye:
- Lógica de revaluación en contra
ANY_OFFER_CHANGED
notificaciones en Java - Función de descuento por nivel de cantidad en Java
- Lógica de revaluación en contra
Avisos de eliminación
Los recursos de SP-API obsoletos ya no están en desarrollo activo. Las llamadas a los recursos de SP-API obsoletos fallarán a partir de su fecha de eliminación. Para obtener más información sobre las fechas de caducidad de SP-API, consulte la Calendario de obsolescencia de SP-API.
-
API de artículos de catálogo v0 (Seleccione las operaciones)
listCatalogItems
getCatalogItem
-
API de cumplimiento entrante v0 (Seleccione operaciones)
confirmPreorder
confirmTransport
createInboundShipment
createInboundShipmentPlan
estimateTransport
getPreorderInfo
getTransportDetails
putTransportDetails
updateInboundShipment
voidTransport
Para obtener más información, consulte Migración de los flujos de trabajo entrantes de cumplimiento.
POST_PRODUCT_DATA
POST_INVENTORY_AVAILABILITY_DATA
POST_PRODUCT_OVERRIDES_DATA
POST_PRODUCT_PRICING_DATA
POST_PRODUCT_IMAGE_DATA
POST_PRODUCT_RELATIONSHIP_DATA
POST_FLAT_FILE_INVLOADER_DATA
POST_FLAT_FILE_BOOKLOADER_DATA
POST_FLAT_FILE_CONVERGENCE_LISTINGS_DATA
POST_FLAT_FILE_LISTINGS_DATA
POST_FLAT_FILE_PRICEANDQUANTITYONLY_UPDATE_DATA
POST_UIEE_BOOKLOADER_DATA
Para obtener más información, consulte Migración de flujos de trabajo de feeds de productos.
LISTING_ITEM_ISSUES_CHANGE
payload versión 1.0
11 de septiembre de 2024
Cambios en la API
- Se agregó soporte para el mercado de Japón (JP). Para obtener más información sobre los mercados que admiten las operaciones de Easy Ship, consulta el Tabla de soporte del mercado de EasyShip API v2022-03-23.
- Se ha añadido un campo opcional,
deliveryInformation
, alGetFulfillmentOrder
respuesta. Puede usar esto para obtener eldeliveryDocumentList
, que puede incluir una foto o una firma para un envío saliente de Logística Multicanal entregado. Puedes usardropOffLocation
para llegar al lugar donde se entregó el paquete de envío.
- El API de artículos de listados v2021-08-01 y
JSON_LISTINGS_FEED
el tipo de feed ahora admite la función de precios de Amazon Business (B2B). - La nueva Guía de gestión avanzada de casos de uso con múltiples ofertas y envíos múltiples demuestra cómo los socios vendedores que están inscritos en el programa Amazon Business (B2B) pueden crear varias ofertas en un listado, lo que crea una diferencia de precios entre los compradores habituales de los sitios web de Amazon (como Amazon.com) y los compradores empresariales de los sitios web de Amazon Business.
- Se agregaron nuevas propiedades opcionales de detalles de verificación a
regulatedInfo
operaciones. Los vendedores pueden usar estos detalles para verificar los pedidos que contienen recetas. - El Guía de pedidos regulados incluye un nuevo tutorial sobre cómo proporcionar detalles adicionales sobre la verificación de un pedido que contiene información regulada.
- Se actualizó el
getFeaturedOfferExpectedPriceBatch
para no necesitar másofferIdentifier
en elFeaturedOfferExpectedPriceResponseBody
. ElofferIdentifier
el parámetro ahora es opcional para deserializar correctamentegetFeaturedOfferExpectedPriceBatch
respuestas de error, comoFeaturedOfferExpectedPriceResponseBody
no proporcionaofferIdentifier
en la respuesta cuando hay errores.
Avisos de eliminación
Los recursos de SP-API obsoletos ya no están en desarrollo activo. Las llamadas a los recursos de SP-API obsoletos fallarán a partir de su fecha de eliminación. Para obtener más información sobre las fechas de caducidad de SP-API, consulte la Calendario de obsolescencia de SP-API.
19 de agosto de 2024
Cambios en la API
- Se agregó el parámetro de respuesta opcional
totalInboundQuantity
a lalistInventory
operación. Puedes usar este parámetro para rastrear el inventario en tránsito hacia Amazon Warehousing and Distribution. - Se agregó un nuevo parámetro de solicitud opcional
skuQuantities
a lagetInboundShipment
operación. Puedes usar este parámetro para conciliar y comparar el inventario esperado y el recibido para cada SKU de un envío.
Ahora puede usar el API de almacenamiento y distribución de Amazon para:
- Realiza un seguimiento del inventario en tránsito hacia Amazon Warehousing and Distribution para mejorar la visualización integral del inventario.
- Reconcilia y compara el inventario esperado y el recibido para cada SKU de un envío.
14 de agosto de 2024
Cambios en la API
- Se agregó un nuevo valor de enumeración de inelegibilidad entrante,
FBA_INB_0342
en elgetItemEligibilityPreview
operación. Este valor proporciona más información sobre por qué una oferta no puede usar códigos de barras de ciertos fabricantes.
- Se agregó el
getAccount
operación para recuperar información sobre las cuentas de vendedores.
-
Se ha añadido un nuevo
unitOfMeasure
variable para soportar productos de peso variable. Esta variable proporciona la unidad de medida de los precios de los artículos vendidos por peso. Si no aparece este campo, el artículo se vende por unidades. Las operaciones que devuelven esta variable incluyen:
Cambios en la documentación
- La nueva Guía de casos de uso de la API de servicios v1 describe cómo acceder a los detalles del puesto de servicio y confirmar o reprogramar las citas mediante el API de servicios v1.
Avisos de eliminación
Los recursos de SP-API obsoletos ya no están en desarrollo activo. Las llamadas a los recursos de SP-API obsoletos fallarán a partir de su fecha de eliminación. Para obtener más información sobre las fechas de caducidad de SP-API, consulte la tabla de depreciaciones.
Las siguientes operaciones en el API de artículos de catálogo v0 estaban en desuso el 30 de septiembre de 2022 y se eliminará el 25 de septiembre de 2024:
listCatalogItems
getCatalogItem
31 de julio de 2022
Cambios en la API
-
Se agregó el
queryStartDate
parámetro para elgetFeatureInventory
operación. Puede usar este parámetro para seleccionar el inventario que se ha actualizado desde una fecha específica. -
El Guía de casos de uso de la API Outbound de Fulfillment v2020-07-01 proporciona los pasos para aprobar el
queryStartDate
parámetro al recuperar una lista de artículos del inventario que cumplen los requisitos para una función de gestión logística específica.
Cambios en la documentación
El blog de la API del socio vendedor se eliminará el 31 de julio de 2024. Para obtener orientación técnica sobre las API de los socios vendedores, consulta la Sitio de documentación de SP-API. Para obtener más información sobre las API de los socios vendedores, consulta Universidad de desarrolladores.
Avisos de eliminación
Los recursos de SP-API obsoletos ya no están en desarrollo activo. Las llamadas a los recursos de SP-API obsoletos fallarán a partir de su fecha de eliminación. Para obtener más información sobre las fechas de caducidad de SP-API, consulte la tabla de depreciaciones.
Las siguientes operaciones en el API de artículos de catálogo v0 estaban en desuso el 30 de septiembre de 2022 y se eliminará el 25 de septiembre de 2024:
listCatalogItems
getCatalogItem
8 de julio de 2024
Cambios en la API
- Se agregó el
Benefits
objetar, que contiene una lista de las ventajas de Amazon incluidas y excluidas de una oferta de servicio de envío. Cada beneficio excluido tiene una lista de códigos de motivo por los que se excluye. Los beneficios representan los servicios prestados por Amazon (por ejemplo,CLAIMS_PROTECTED
(para la Garantía de la A a la Z) cuando los vendedores compren envíos a través de Amazon. Los vendedores obtienen información sobre lo que implica comprar una etiqueta a través de Amazon.
28 de junio de 2024
Cambios en la API
- Se quitó el 27 de junio de 2024 actualizaciones de API saliente de cumplimiento v2020-07-01 y API v0 de Merchant Fulfillment.
27 de junio de 2022
Cambios en la API
- El API de cumplimiento entrante v2024-03-20 ya está disponible para todo el mundo. Puedes usar esta API para seleccionar entre varias opciones de servicios de colocación entrante y crear planes entrantes que admitan hasta 1500 SKU.
- El Guía de casos de uso de la API Fulfillment Inbound v2024-03-20 ofrece tutoriales sobre cómo crear envíos y orientación sobre el flujo de trabajo de los envíos entrantes de gestión logística.
- El Preguntas frecuentes sobre la API Fulfillment Inbound incluye los beneficios del API de cumplimiento entrante v2024-03-20 y orientación sobre la migración desde la versión 0 de la API Fulfillment Inbound.
- Migración de los flujos de trabajo entrantes de cumplimiento lo guiarán durante la migración desde el API de cumplimiento entrante v0 a la nueva API de cumplimiento entrante v2024-03-20.
##### API saliente de cumplimiento v2020-07-01
- Se agregó el queryStartDate
parámetro para el getFeatureInventory
operación. Los vendedores pueden usar este parámetro para seleccionar el inventario que se ha actualizado desde una fecha específica.
- El Guía de casos de uso de la API Outbound de Fulfillment v2020-07-01 proporciona los pasos para aprobar el queryStartDate
parámetro al recuperar una lista de artículos del inventario que cumplen los requisitos para una función de gestión logística específica.
##### API v0 de Merchant Fulfillment
- Se agregó el Benefits
objetar, que contiene una lista de las ventajas de Amazon incluidas y excluidas de una oferta de servicio de envío. Cada beneficio excluido tiene una lista de códigos de motivo por los que se excluye. Los beneficios representan los servicios prestados por Amazon (por ejemplo, CLAIMS_PROTECTED
(para la Garantía de la A a la Z) cuando los vendedores compren envíos a través de Amazon. Los vendedores obtienen información sobre lo que implica comprar una etiqueta a través de Amazon.
- Puedes usar el nuevo API de transferencias v2024-06-01 para iniciar pagos y recuperar los detalles de los instrumentos, las cuentas de los vendedores llamando al
initiatePayout
ygetPaymentMethods
operaciones. Para ver tutoriales sobre cómo usar la API de transferencias v2024-06-01, los vendedores pueden consultar la Guía de casos de uso de la API de transferencias v2024-06-01. Esta API solo está disponible en versión beta privada.
Cambios en la documentación
- El Guía de casos de uso de Finances v0 describe cómo recuperar la información financiera, como el saldo actual, las transacciones y el estado de las transferencias de fondos de sus pedidos mediante el API de finanzas v0.
Avisos de eliminación
Los recursos de SP-API obsoletos ya no están en desarrollo activo. Las llamadas a los recursos de SP-API en desuso dejarán de funcionar a partir de su fecha de eliminación. Para obtener más información sobre las fechas de caducidad de SP-API, consulte tabla de desaprobaciones.
19 de junio de 2024
Cambios en la API
- Los vendedores pueden usar el nuevo API de almacenamiento y distribución de Amazon v2024-05-09 para rastrear el inventario dentro de los centros de distribución de AWD y rastrear los envíos que van a los centros de distribución de AWD.
- El API de Data Kiosk v2023-11-05 ya está disponible para todo el mundo.
- La nueva Solución de muestra de Data Kiosk proporciona todos los recursos que necesita para implementar una aplicación SP-API totalmente funcional que automatice la creación y la recuperación de los documentos de Data Kiosk.
- La nueva Guía de flujo de trabajo de Data Kiosk ofrece información sobre las mejores prácticas, responde a preguntas frecuentes sobre el uso de las API y describe los flujos de trabajo óptimos.
- La nueva Conjunto de datos de análisis de proveedores proporciona datos de proveedores en varios dominios. Puedes agregar datos con cualquier granularidad (ASIN/marca/fabricación/fecha) y acceder a más de 100 métricas sobre ventas, tráfico, inventario, previsiones, rentabilidad y nuevas métricas de ventas geográficas.
- Desarrolladores que crean o administran aplicaciones que se integran con API de inventario de FBA v1 y API saliente de cumplimiento v2020-07-01 puede usar los dos entornos sandbox dinámicos para probar las integraciones de código entre los dominios de la API saliente de Logística de Amazon y Fulfillment. Estos entornos limitados simulan la gestión logística de los pedidos y los movimientos de inventario de forma que imitan las respuestas de producción de Amazon. Para obtener más información, consulta el Guía FBA Inventory Dynamic Sandbox.
- Se agregó el nuevo
deliveryOffers
operación. Los vendedores pueden utilizar esta operación para mostrar las ofertas de envío estándar de Logística Multicanal (MCF) en las páginas previas al pago. Esta operación solo está disponible en el mercado de los Estados Unidos (EE. UU.). - Se agregó el campo opcional
lockerDetails
algetFulfillmentOrder
respuesta. Los vendedores pueden incluir la información necesaria para acceder a las cajas de entrega de los casilleros. Este campo solo está disponible en el mercado japonés (JP). - Se agregó el campo opcional
deliveryPreferences
a lacreateFulfillmentOrder
solicitud. Los vendedores pueden incluir las preferencias de entrega que se aplican a la dirección de destino. Este campo solo está disponible en la plataforma de Japón (JP). - Desarrolladores que crean o administran aplicaciones que se integran con API de inventario de FBA v1 y API saliente de cumplimiento v2020-07-01 puede usar los dos entornos sandbox dinámicos para probar las integraciones de código entre los dominios de la API saliente de Logística de Amazon y Fulfillment. Estos entornos limitados simulan la gestión logística de los pedidos y los movimientos de inventario de forma que imitan las respuestas de producción de Amazon. Para obtener más información, consulta el Guía de entorno aislado dinámico de Fulfillment Outbound.
- El
getFeaturedOfferExpectedPriceBatch
la operación ya está disponible en todos los mercados excepto en Japón (JP). Los vendedores pueden utilizar esta operación para obtener los datos del precio esperado (FOEP) de la oferta destacada para un máximo de 40 SKU.
- Se agregaron las métricas
LOST_REVENUE_DUE_TO_OOS
,SUBSCRIBER_NON_SUBSCRIBER_AVERAGE_REORDERS
, yCOUPONS_REVENUE_PENETRATION
a lagetSellingPartnerMetrics
respuesta de operación. Estas métricas describen las fuentes de ingresos y los ingresos perdidos. - Se agregaron las métricas
LOST_REVENUE_DUE_TO_OOS
yCOUPONS_REVENUE_PENETRATION
a lalistOfferMetrics
respuesta de operación. Estas métricas describen las fuentes de ingresos y los ingresos perdidos.
Avisos de eliminación
Los recursos de SP-API obsoletos ya no están en desarrollo activo. Las llamadas a los recursos de SP-API en desuso dejarán de funcionar a partir de su fecha de eliminación. Para obtener más información sobre las fechas de caducidad de SP-API, consulte Tabla de desaprobaciones.
4 de junio de 2024
Cambios en la API
- Nueva función: Consulta y selecciona uno de los plazos de entrega disponibles para que un envío llegue a una instalación de Amazon
- Nueva función: Imprima etiquetas para artículos individuales
- Seleccione Partnered Carrier como opción para sus envíos de carga inferior a la de un camión (LTL)
- Actualizar el nombre de los planes y envíos entrantes
- Actualizar la cantidad de unidades de un SKU tras la confirmación del envío
- Añada tres nuevas operaciones obligatorias:
confirmDeliveryWindowOptions
,generateDeliveryWindowOptions
, ylistDeliveryWindowOptions
Avisos de eliminación
Los recursos de SP-API obsoletos ya no están en desarrollo activo. Las llamadas a los recursos de SP-API en desuso dejarán de funcionar a partir de su fecha de eliminación. Para obtener más información sobre las fechas de caducidad de SP-API, consulte Tabla de desaprobaciones.
Las siguientes operaciones en API de cumplimiento entrante v0 ya no están en desuso:
22 de mayo de 2024
Cambios en la API
-
Se agregó el
lowestPricedOffers
yreferencePrices
atributos a la API de precios de productos v2022-05-01. Esta mejora ofrece las 20 mejores ofertas y precios de referencia con los precios más bajos. -
En el Guía de casos de uso de la API de precios de productos v2022-05-01, el Tutorial: obtén una lista de ofertas destacadas para un lote de hasta 20 ASIN hace uso de dos nuevos atributos:
lowestPricedOffers
yreferencePrices
. -
Se agregó el Guía de flujos de trabajo de automatización del ajuste de precios a nuestro sitio de documentación de la API para socios vendedores. En esta guía se describe cómo aprovechar la API de precios de productos v2022-05-01 y notificaciones de precios para crear los mejores flujos de trabajo de su clase que automaticen la gestión de precios.
-
Se agregó el Preguntas frecuentes sobre la API de precios de los productos y las notificaciones a nuestro sitio de documentación de la API para socios vendedores. En esta documentación se abordan las preguntas más frecuentes y los detalles de API de precios de productos v2022-05-01.
- Se ha añadido un nuevo
includedData
opción de parámetro de consulta llamadaclassifications
, que reemplaza al obsoleto MWSGetProductCategoriesForSKU
yGetProductCategoriesForASIN
operaciones. Los vendedores y vendedores pueden usarclassifications
para explorar los árboles de clasificación asignados a un ASIN.
- El Atributos de ficheros de pedidos
POST_ORDER_FULFILLMENT_DATA
yPOST_FLAT_FILE_FULFILLMENT_DATA
se actualizan con un campo nuevo:ship-from-supply-source-id
.
Avisos de eliminación
Los recursos de SP-API obsoletos ya no están en desarrollo activo. Las llamadas a los recursos de SP-API en desuso dejarán de funcionar a partir de su fecha de eliminación. Para obtener más información sobre las fechas de caducidad de SP-API, consulte Tabla de desaprobaciones.
24 de abril de 2024
Cambios en la API
-
Se agregó el
CompanyName
atribuir al API de pedidos v0 API. -
Se actualizó el límite de tarifa para
getOrder
,getOrderAddress
, ygetOrderBuyerInfo
operaciones de .0167 a .5 y aumentamos la ráfaga de 20 a 30. -
Actualizó el
IsBuyerRequestedCancel
,IsGift
yNumberOfItems
tipos de objetos desde booleano/entero hasta cadena. -
Actualizó el
getOrders
operación para devolver elAutomatedCarrier
yAutomatedShipMethod
atributos.
- Se actualizó la licencia de la licencia de software de Amazon a la licencia Apache 2.0.
- Se agregó el código HTTP 413 a la lista de posibles respuestas de cada operación.
Reportar cambios en el esquema
Se agregó el lastUpdatedDate
campo a los siguientes informes de proveedores:
GET_VENDOR_SALES_REPORT
GET_VENDOR_NET_PURE_PRODUCT_MARGIN_REPORT
GET_VENDOR_TRAFFIC_REPORT
GET_VENDOR_FORECASTING_REPORT
GET_VENDOR_INVENTORY_REPORT
Expansión de Vendor Central Marketplace a Irlanda (IE)
El 23 de abril de 2024, Vendor Central lanzó el soporte para Ireland (IE) Marketplace. Para obtener más información, consulte el URL de SP-API Vendor Central, Puntos finales de SP-API, y Identificadores de mercado temas de la documentación de SP-API.
Cambios en la documentación
- El Guía de casos de uso de Orders API v0 incluye nuevos detalles sobre la antigüedad del pedido. Los pedidos que tengan más de dos años no se devolverán en la respuesta de la API. Los sitios web de JP, AU y SG son una excepción. En esas plataformas, la versión 0 de la API de pedidos admite pedidos desde 2016 hasta la actualidad.
Avisos de eliminación
Los recursos de SP-API obsoletos dejarán de recibir soporte técnico. Las llamadas a los recursos de SP-API en desuso dejarán de funcionar a partir de la fecha de su eliminación. Para obtener información más detallada sobre las fechas de caducidad de SP-API, consulte Tabla de desaprobaciones.
- API de Logística Inbound v0 (operaciones selectas)
createInboundShipmentPlan
updateInboundShipment
createInboundShipment
getPreorderInfo
confirmPreorder
getTransportDetails
putTransportDetails
voidTransport
estimateTransport
confirmTransport
getShipments
getShipmentItemsByShipmentId
getShipmentItems
POST_PRODUCT_DATA
POST_INVENTORY_AVAILABILITY_DATA
POST_PRODUCT_OVERRIDES_DATA
POST_PRODUCT_PRICING_DATA
POST_PRODUCT_IMAGE_DATA
POST_PRODUCT_RELATIONSHIP_DATA
POST_FLAT_FILE_INVLOADER_DATA
POST_FLAT_FILE_LISTINGS_DATA
POST_FLAT_FILE_BOOKLOADER_DATA
POST_FLAT_FILE_CONVERGENCE_LISTINGS_DATA
POST_FLAT_FILE_LISTINGS_DATA
POST_FLAT_FILE_PRICEANDQUANTITYONLY_UPDATE_DATA
POST_UIEE_BOOKLOADER_DATA
LISTING_ITEM_ISSUES_CHANGE
payload versión 1.0
1 de abril de 2024
Cambios en la API
- Acceso anticipado a la nueva API Fulfillment Inbound v2024-03-20, que admite la creación de envíos entrantes de Logística de Amazon y te permite seleccionar entre varias opciones de servicio de envío entrante, entre otras funciones.
Avisos de eliminación
Los recursos de SP-API que anuncien su obsolescencia dejarán de admitirse después de la fecha de caducidad. Las llamadas a los recursos obsoletos dejarán de funcionar a partir de su fecha de eliminación. Para obtener información más detallada sobre las fechas de caducidad de SP-API, consulte la Tabla de depreciaciones.
- API de Logística Inbound v0 (operaciones selectas)
createInboundShipmentPlan
updateInboundShipment
createInboundShipment
getPreorderInfo
confirmPreorder
getTransportDetails
putTransportDetails
voidTransport
estimateTransport
confirmTransport
getShipments
getShipmentItemsByShipmentId
getShipmentItems
20 de marzo de 2024
Cambios en la API
- Se agregó el
AdditionalAddressNotes
,NdrAction
,NdrRequestData
, ySubmitNdrFeedbackRequest
se opone a landrFeedback parameter
. - Se agregó un tutorial para Uso de la API NDRFeedback para enviar informes de envíos no entregados que cumplan los requisitos.
- Se agregaron los atributos de mercancías peligrosas
LiquidVolume
,IsHazmat
, yDangerousGoodsDetails
al objeto Item.
- Actualizada Métrica de visualización de páginas del ASIN de Marketplace informe para incluir el apoyo al Reino Unido. Para obtener más información sobre este informe, consulte Valores del tipo de informe de cumplimiento normativo. Este cambio se aplica únicamente al mercado del Reino Unido.
- Publicado nuevo Solicita y recupera un informe de facturación masiva para los pedidos de Logística Multicanal (MCF) para la India tutorial sobre el Solicita un tutorial sobre informes página. El informe de facturación masiva permite a los vendedores de MCF descargar la factura del impuesto sobre bienes y servicios asociada a su pedido de MCF en formato lote/zip. Los vendedores pueden pasar un intervalo de fechas para generar la solicitud de descarga y recibir un archivo zip con las facturas de los pedidos de MCF entregados.
- Actualizada
FEED_PROCESSING_FINISHED
yREPORT_PROCESSING_FINISHED
para incluir soporte para los proveedores. Ambas notificaciones incluyen una nuevaaccountId
propiedad, que identifica al socio vendedor en cuyo nombre se envió el feed o el informe. Este cambio se aplica a todos los sitios web.
- Se agregó el
PaymentInformation
atributo, obligatorio para la India, pero opcional para todos los demás sitios web. - Se agregó un tutorial sobre cómo crear un pedido de MCF para la India en el Guía de casos de uso de la API Outbound de Fulfillment v2020-07-01.
Cambios en la documentación
- Se agregaron bibliotecas cliente de Python y Javascript para los SDK en la SP-API. Para obtener más información sobre los SDK de SP-API, consulte Uso de los SDK, Tutorial: Automatice las llamadas a la SP-API con el SDK de JavaScript para Node.js, y Tutorial: Automatice las llamadas a la SP-API con el SDK de Python.
- Se modificó el formato de las páginas de valores de los tipos de informes y se consolidaron los atributos de los tipos de informes para optimizar la visibilidad.
Avisos de eliminación
Los recursos de SP-API obsoletos ya no están en desarrollo activo. Las llamadas a los recursos de SP-API en desuso dejarán de funcionar a partir de su fecha de eliminación. Para obtener información más detallada sobre las fechas de caducidad de SP-API, consulte Tabla de desaprobaciones.
- API de autorización v1 (todas las operaciones)
- API FBA Small and Light v1 (todas las operaciones)
- API de Logística Inbound v0 (operaciones selectas)
getInboundGuidance
POST_PRODUCT_DATA
POST_INVENTORY_AVAILABILITY_DATA
POST_PRODUCT_OVERRIDES_DATA
POST_PRODUCT_PRICING_DATA
POST_PRODUCT_IMAGE_DATA
POST_PRODUCT_RELATIONSHIP_DATA
POST_FLAT_FILE_INVLOADER_DATA
POST_FLAT_FILE_LISTINGS_DATA
POST_FLAT_FILE_BOOKLOADER_DATA
POST_FLAT_FILE_CONVERGENCE_LISTINGS_DATA
POST_FLAT_FILE_LISTINGS_DATA
POST_FLAT_FILE_PRICEANDQUANTITYONLY_UPDATE_DATA
POST_UIEE_BOOKLOADER_DATA
POST_FLAT_FILE_FBA_UPDATE_INBOUND_PLAN
POST_FLAT_FILE_FBA_CREATE_INBOUND_PLAN
RFQ_UPLOAD_FEED
GET_PRODUCT_EXCHANGE_DATA
GET_FBA_UNO_INVENTORY_DATA
MFN_ORDER_STATUS_CHANGE
LISTING_ITEM_ISSUES_CHANGE
payload versión 1.0
21 de febrero de 2024
Cambios en la API
- Se agregó un nuevo valor de tipo de informe Informe de datos del usuario final proporciona datos personales de los clientes, incluida la información de contacto, Glance View y
Orderdata
para los clientes que han decidido compartir estos datos con el vendedor al completar una transacción en las plataformas DE DE, FR, IT, ES, NL, PL, SE y BE (EU-8).
- Promovió la API de administración de aplicaciones v2023-11-30 de la versión beta pública a la versión de producción. Esta API le permite rotar programáticamente sus credenciales de inicio de sesión con Amazon (LWA) (secretos de cliente).
Actualizaciones de la documentación
- Se agregaron seis nuevos tutoriales de código que detallan cómo realizar diversas tareas, como la vista previa de los pedidos, la creación de pedidos y la cancelación de pedidos. Encuéntralos en el Muestras de código sección.
Avisos de eliminación
Los recursos de SP-API que anuncien su obsolescencia dejarán de admitirse después de la fecha de caducidad. Las llamadas a los recursos obsoletos dejarán de funcionar a partir de su fecha de eliminación. Para obtener información más detallada sobre las fechas de caducidad de SP-API, consulte la Tabla de depreciaciones.
POST_FLAT_FILE_FBA_UPDATE_INBOUND_PLAN
POST_FLAT_FILE_FBA_CREATE_INBOUND_PLAN
RFQ_UPLOAD_FEED
GET_PRODUCT_EXCHANGE_DATA
GET_FBA_UNO_INVENTORY_DATA
MFN_ORDER_STATUS_CHANGE
31 de enero de 2024
Cambios en la API
- Se agregó un nuevo modo de validación para
putListingsItem
ypatchListingsItem
operaciones. Usa elmode=VALIDATION_PREVIEW
parámetro de consulta para validar un artículo del listado sin conservar los datos en el catálogo. Esta función te permite previsualizar los errores de publicación en producción sin necesidad de crear anuncios.
- Se agregó el
ShipsInProductPackaging
valor para elPrepInstruction
enumeración.PrepInstructionList
se devuelve en la respuesta a las llamadas aprepInstructions
.
- Añadido
ExtendedFields
yAddressExtendedFields
objetos. Estos objetos solo están disponibles para las direcciones de Brasil y se devuelven en las respuestas a las direcciones de envío de Brasil que contienen campos extendidos.
Avisos de eliminación
Los recursos de SP-API que anuncien su obsolescencia dejarán de admitirse después de la fecha de caducidad. Las llamadas a los recursos obsoletos dejarán de funcionar a partir de su fecha de eliminación. Para obtener información más detallada sobre las fechas de caducidad de SP-API, consulte la Tabla de depreciaciones.
- API de autorización v1 (todas las operaciones)
- API FBA Small and Light v1 (todas las operaciones)
POST_FLAT_FILE_FBA_UPDATE_INBOUND_PLAN
POST_FLAT_FILE_FBA_CREATE_INBOUND_PLAN
RFQ_UPLOAD_FEED
GET_FBA_UNO_INVENTORY_DATA
GET_PRODUCT_EXCHANGE_DATA
13 de diciembre de 2023
Cambios en la API
- La nueva API de administración de aplicaciones le permite rotar programáticamente sus credenciales de inicio de sesión con Amazon (LWA) (secretos de cliente). Disponible en versión beta pública.
- Lanzó el soporte para el envío de artículos peligrosos (DG) en los mercados de EE. UU. y el Reino Unido.
- India (IN) es ahora un mercado compatible
- Se han añadido dos campos nuevos al
Issue
objeto:Enforcements
yCategories
searchDefinitionsProductTypes
tipo de operación actualizado a cadena
- Se agregó un opcional
payloadVersion
parámetro - Nuevo Los problemas con los artículos de los listados cambian la notificación, versión 2023-12-13 tiene tres nuevas medidas de cumplimiento:
LISTING_SUPPRESSED
,ATTRIBUTE_SUPPRESSED
, yCATALOG_ITEM_REMOVED
Actualizaciones de la documentación
Guía de casos de uso de la API V1 de Vendor Direct Fulfillment Orders se actualizó para incluir una sección sobre Transmisión de datos de clientes de Direct Fulfillment. Los proveedores no reciben datos de los clientes, como el nombre, la dirección o el número de teléfono, para ciertos envíos gestionados a través del getOrder
y getOrders
operaciones. En el caso de los proveedores que utilizan únicamente etiquetas de Amazon, algunos campos se sustituirán por el valor ficticio XXXXX
.
El Guía de casos de uso de la versión 1 de las API de adquisición minorista para proveedores se ha actualizado para incluir información sobre el uso de las operaciones Enviar envíos y Obtenga los detalles del envío.
GET_FBA_FULFILLMENT_LONGTERM_STORAGE_FEE_CHARGES_DATA
ahora incluye los nombres de las columnas actualizados. Se ha añadido una nota al informe de cargos por almacenamiento prolongado de Logística de Amazon sobre Valores de tipo de informe de Logística de Amazon (FBA) página, que describe la forma correcta de generar el informe.
El informe de facturas masivas de Fulfillment by Amazon (FBA) (FBA_BULK_INVOICE
) comparte las facturas de un vendedor dentro del intervalo de fechas indicado. Estas facturas incluyen los pedidos de los clientes atendidos por el vendedor.
Avisos de eliminación
Los recursos de SP-API que anuncien su obsolescencia dejarán de admitirse después de la fecha de caducidad. Las llamadas a los recursos obsoletos dejarán de funcionar a partir de su fecha de eliminación. Para obtener información más detallada sobre las fechas de caducidad de SP-API, consulte la Tabla de depreciaciones.
- API de autorización v1 (todas las operaciones)
- API FBA Small and Light v1 (todas las operaciones)
- API de Logística Inbound v0 (operaciones selectas)
getInboundGuidance
- API de cumplimiento para comerciantes v0 (operaciones seleccionadas)
getEligibleShipmentServicesOld
cancelShipmentOld
getAdditionalSellerInputsOld
POST_FLAT_FILE_FBA_UPDATE_INBOUND_PLAN
POST_FLAT_FILE_FBA_CREATE_INBOUND_PLAN
RFQ_UPLOAD_FEED
GET_FBA_UNO_INVENTORY_DATA
GET_PRODUCT_EXCHANGE_DATA
ORDER_STATUS_CHANGE
8 de noviembre de 2023
Cambios en la API
- La nueva API de fuentes de suministro configura y actualiza la información sobre las fuentes de suministros del vendedor, como tiendas y almacenes.
- El Reino Unido es ahora un mercado válido.
getFeaturedOfferExpectedPriceBatch
(FOEP) se ha extendido a Amazon.co.uk.ASIN_NOT_ELIGIBLE
ahora es un valor pararesultStatus
.- La nueva
competitiveSummary
la operación devuelve la respuesta resumida de la competencia, que incluye las opciones de compra destacadas para el ASIN ymarketplaceId
combinación.
- Actualizado para tres parámetros nuevos (
itemName
,locale
, ysearchlocale
) y uno nuevodisplayName
tipo de producto.
- Actualizado
ListFinancialEvent
yListFinancialEventGroups
las operaciones comunican con mayor claridad las respuestas y el alcance esperados. La respuesta paraChangeRefundTransactions
se modificó de un objeto a una matriz.
- Actualizado
weight
el campo ahora es obligatorio. Este cambio generará un error al invocarshipmentconfirmations
para que los proveedores no tengan que esperar a que se produzca un error durante el estado de la transacción.
Actualizaciones de la documentación
- Nuevo Guía de integración del inventario de ubicaciones múltiples (MLI) asesora a los socios vendedores sobre las API y las operaciones que son obligatorias para la integración con la MLI, lo que permite a los vendedores en varias ubicaciones proporcionar a Amazon datos a nivel de ubicación sobre su inventario y sus capacidades reales de gestión logística.
- La guía actualizada de flujos de trabajo de administración de listados de edificios ahora incluye los pasos para recuperar una recomendación mediante
itemName
okeywords
en el Publica un artículo que aún no existe en el catálogo de Amazon flujo de trabajo.
Avisos de eliminación
Los recursos de SP-API que anuncien su obsolescencia dejarán de admitirse después de la fecha de caducidad. Las llamadas a los recursos obsoletos dejarán de funcionar a partir de su fecha de eliminación. Para obtener información más detallada sobre las fechas de caducidad de SP-API, consulte la Tabla de depreciaciones.
- API de autorización v1 (todas las operaciones)
- API FBA Small and Light v1 (todas las operaciones)
- API de Logística Inbound v0 (operaciones selectas)
getInboundGuidance
- API de cumplimiento para comerciantes v0 (operaciones seleccionadas)
getEligibleShipmentServicesOld
cancelShipmentOld
getAdditionalSellerInputsOld
GET_FBA_UNO_INVENTORY_DATA
GET_PRODUCT_EXCHANGE_DATA
ORDER_STATUS_CHANGE
11 de octubre de 2023
Cambios en la API
- Actualizado
ItemProcurement
el elemento de datos pasó de ser un objeto a una matriz.
- Se agregó una lista de elementos asociados a la respuesta del
getOrderItems
operación.
- El atributo
listingPrice
en la respuestagetItemOffers
cambió el nombre para ayudar a los desarrolladores a evitar errores al extender su código para casos de uso de empresa a empresa. Los subcamposLandedprice
yShipping
ya no son obligatorios, sino opcionales.
Avisos de eliminación
Los recursos de SP-API que anuncien su obsolescencia dejarán de admitirse después de la fecha de caducidad. Las llamadas a los recursos obsoletos dejarán de funcionar a partir de su fecha de eliminación. Para obtener información más detallada sobre las fechas de caducidad de SP-API, consulte la Tabla de depreciaciones.
- API de autorización v1 (todas las operaciones)
- API FBA Small and Light v1 (todas las operaciones)
- API de feeds v2020-09-04 (Todas las operaciones)
- API de Logística Inbound v0 (operaciones selectas)
getInboundGuidance
- API de cumplimiento para comerciantes v0 (operaciones seleccionadas)
getEligibleShipmentServicesOld
cancelShipmentOld
getAdditionalSellerInputsOld
- API de informes v2020-09-04 (Todas las operaciones)
GET_FBA_UNO_INVENTORY_DATA
GET_PRODUCT_EXCHANGE_DATA
ORDER_STATUS_CHANGE
20 de septiembre de 2023
Cambios en la API
- La descripción de la operación
BuyerCompanyName
en la API de pedidos v0 se ha actualizado para que esté más claro el nombre de la empresa de la dirección de destino.
Actualizaciones de la documentación
- Actualizado Guía de flujos de trabajo de administración de listados de edificios incluye instrucciones para usar la API de artículos de listados para crear relaciones jerárquicas de paquetes, que pueden vincular las unidades, los paquetes de cajas y los palés de un producto para crear un listado conectado. Para obtener más información, consulta Configuración de jerarquías de paquetes.
Avisos de eliminación
Los recursos de SP-API que anuncien su obsolescencia dejarán de admitirse después de la fecha de caducidad. Las llamadas a los recursos obsoletos dejarán de funcionar a partir de su fecha de eliminación. Para obtener información más detallada sobre las fechas de caducidad de SP-API, consulte la Tabla de depreciaciones.
- API de autorización v1 (todas las operaciones)
- API FBA Small and Light v1 (todas las operaciones)
- API de feeds v2020-09-04 (Todas las operaciones)
- API de Logística Inbound v0 (operaciones selectas)
getInboundGuidance
- API de cumplimiento para comerciantes v0 (operaciones seleccionadas)
getEligibleShipmentServicesOld
cancelShipmentOld
getAdditionalSellerInputsOld
- API de informes v2020-09-04 (Todas las operaciones)
GET_FBA_UNO_INVENTORY_DATA
GET_PRODUCT_EXCHANGE_DATA
16 de agosto de 2023
Cambios en la API
- El
ShipmentServiceLevelCategory
La propiedad de la definición del pedido se ha actualizado para incluir el valorPriority
. Este valor está disponible en la nueva plantilla de envíos disponible en las plataformas de Francia, España, Alemania, Polonia, los Países Bajos, Suecia y Bélgica para admitir los pedidos Prime gestionados por el vendedor. Si tu integración usa las nuevas plantillas de envío para estas regiones, es posible que tengas que actualizar tu integración para aceptar laPriority
valor paraShipmentServiceLevelCategory
.
- El
generic_keyword
El atributo son datos exclusivos del vendedor y la API de artículos del catálogo ya no los devolverá. Los socios vendedores pueden usar la API de artículos de la lista para ver los valores enviados.
Actualizaciones de la documentación
- El sitio de documentación para desarrolladores de SP-API publicó recientemente un nuevo Bienvenido tema. En este tema se proporcionan recursos para migrar a SP-API e integrarse con ella, consejos para buscar en el sitio de documentación y enlaces rápidos a contenido popular de SP-API.
- El sitio de documentación para desarrolladores de SP-API se ha actualizado para incluir temas nuevos y mejorados sobre el registro de desarrolladores, que incluyen cómo Regístrese como desarrollador público, cómo Regístrese como desarrollador privado, cómo Regístrese como proveedor privado, cómo Solicita puestos restringidos (PII), y cómo Comprueba el estado de tu solicitud de registro como desarrollador.
Avisos de eliminación
Hemos ajustado la fecha de eliminación de las siguientes API:
Las llamadas a estas API tendrán una velocidad de aceleración más baja desde 16 de agosto de 2023 por 18 de octubre de 2023. Las llamadas a estas API fallarán 18 de octubre de 2023.
Para obtener información más detallada sobre las fechas de eliminación de la SP-API, consulta la tabla de eliminaciones.
21 de junio de 2023
Cambios en la API
API de reabastecimiento
- La nueva API de reabastecimiento v2022-11-07 devuelve métricas e información de ofertas de un programa de reabastecimiento de un colaborador comercial (Suscríbete y ahorra). Esta API está disponible en los siguientes sitios web: Estados Unidos de América, Canadá, Brasil, México, Reino Unido, Alemania, España, Italia, Francia, Países Bajos, Emiratos Árabes Unidos, India, Japón y Australia.
API de informes
- El nuevo informe
MARKETPLACE_ASIN_PAGE_VIEW_METRICS
proporciona información sobre las métricas de visualizaciones de la página de ASIN (vista panorámica) de los sitios web de DE, FR, IT, ES, NL, PL, SE y BE (EU-8), con datos disponibles hasta los últimos siete días.
Análisis rápido de venta minorista
- El nuevo informe
GET_VENDOR_REAL_TIME_SALES_REPORT
comparte los datos de ventas a nivel de ASIN, agregados cada hora. Las solicitudes pueden abarcar varios períodos de tiempo. - El nuevo informe
GET_VENDOR_REAL_TIME_TRAFFIC_REPORT
comparte datos sobre el tráfico de clientes a las páginas de detalles de los artículos del proveedor, agregados cada hora. Las solicitudes pueden abarcar varios períodos de tiempo. - El nuevo informe
GET_VENDOR_REAL_TIME_INVENTORY_REPORT
comparte datos de inventario a nivel de ASIN, agregados cada hora.
API de artículos de listings
- La API de artículos de listings ahora está disponible en el sitio web de Bélgica (BE).
API de notificaciones
- La nueva notificación
LISTINGS_ITEM_MFN_QUANTITY_CHANGE
se envía cada vez que hay un cambio en la cantidad disponible de un artículo del listing. - La nueva 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 reemplaza aORDER_STATUS_CHANGE
. - Se ha actualizado la notificación
B2B_ANY_OFFER_CHANGED
para incluir los precios de descuento por cantidad (QD) en la secciónOffer
, con nuevos atributos que incluyen varios niveles de cantidad, tipo de descuento y precio. Ahora puedes utilizar esta notificación para crear soluciones de modificación de precios de QD, lo que elimina la necesidad de utilizar las API de precios con esta finalidad.
Análisis rápido de venta minorista
- La nueva notificación
ITEM_SALES_EVENT_CHANGE
se envía cinco minutos después del comienzo de cada hora. Esta notificación comparte los datos de ventas a nivel de ASIN e incluye los datos de la hora anterior, así como los datos retrasados de hasta 24 horas antes. Se incluyen los ASIN cuando tienen pedidos o cancelaciones durante una hora determinada. Cada notificación puede incluir varios ASIN y un colaborador comercial puede recibir varias notificaciones cada hora. - La nueva notificación
ITEM_INVENTORY_EVENT_CHANGE
se envía cinco minutos después del comienzo de cada hora. Esta notificación comparte los datos de inventario a nivel de ASIN e incluye los datos de la hora anterior, así como los datos retrasados de hasta 24 horas antes. Se incluyen los ASIN si el número de unidades disponibles para la compra por parte de los clientes ha cambiado. Cada notificación puede incluir varios ASIN y un colaborador comercial puede recibir varias notificaciones cada hora. - La nueva notificación
DETAIL_PAGE_TRAFFIC_EVENT
se envía cinco minutos después del comienzo de cada hora. Esta notificación comparte los datos de tráfico a nivel de ASIN e incluye los datos de la hora anterior, así como los datos retrasados de hasta 24 horas antes. 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.
Actualizaciones de la documentación
- La nueva guía de migración de procesos de gestión de listings te ayuda a migrar tus procesos de gestión de listings existentes de ficheros de archivos sin formato y basados en XML a ficheros basados en JSON y la API de artículos de listings del colaborador comercial.
- El repositorio de esquemas de informes actualizados incluye
GET_B2B_PRODUCT_OPPORTUNITIES_RECOMMENDED_FOR_YOU
yGET_B2B_PRODUCT_OPPORTUNITIES_NOT_YET_ON_AMAZON
Avisos de eliminación
Los recursos de la SP-API que anuncian su eliminación ya no se admitirán después de su fecha de eliminación. Las llamadas a recursos eliminados devolverán un error a partir de su fecha de eliminación.
Para obtener información más detallada sobre las fechas de eliminación de la SP-API, consulta la tabla de eliminaciones.
17 de mayo de 2023
Cambios en la API
- Se ha actualizado el entorno aislado dinámico para incluir la operación
createShippingLabels
.
- Desaparición del proceso de aprobaciones de pedidos genéricos. Se han eliminado los atributos
ItemApprovalTypes
yItemApprovalStatus
.
Actualizaciones de la documentación
-
En el nuevo Directorio de atributos de informes se enumeran todos los atributos disponibles en los informes de la SP-API.
-
Las nuevas Preguntas frecuentes de adquisición minorista de proveedores incluye preguntas frecuentes sobre la API de adquisición minorista de proveedores de la SP-API.
Avisos de eliminación
- API de ficheros v2020-09-04
- API de informes v2020-09-04
POST_FLAT_FILE_FBA_CREATE_INBOUND_PLAN
POST_FLAT_FILE_FBA_UPDATE_INBOUND_PLAN
19 de abril de 2023
Cambios en la API
- Se ha actualizado la propiedad
city
en el formulario de atributosaddress
de obligatorio a opcional.
- Se ha actualizado el campo
sellerSku
para incluir y analizar comas.
Actualizaciones de la documentación
- Se ha actualizado el metaesquema de definición de tipo de producto de Amazon (v1) para incluir las siguientes palabras clave:
$lifecycle
,replacedBy
,replaces
,enumDeprecated
yenumReplacement.
.
Actualizaciones de la guía de C#
- Se agregaron dos nuevas guías de C#: Genere un SDK de C# con generación y autenticación de tokens LWA y Conéctate a la API del socio de ventas mediante un SDK de C# generado.
Avisos de eliminación
29 de marzo de 2023
Cambios en la API
- Se ha actualizado
nextToken
para que caduque después de 30 segundos.
- Se ha añadido la operación
confirmShipment
.
- Se ha actualizado el atributo
address
para incluir la ciudad. - Se ha actualizado para emplear un entorno aislado dinámico para las pruebas en lugar de un entorno aislado estático. Incluye una nueva operación exclusiva para el entorno aislado.
Actualizaciones de la documentación
- Nueva Guía de casos de uso de la API de pedidos para la operación de confirmación de envío de Pedidos v0. La operación
confirmShipment
confirma el estado del envío de un pedido específico. También se puede usar para editar los datos de envío de los pedidos que se han enviado. Incluye un enlace a la guía (si está disponible). - En la nueva Guía de casos de uso de entorno aislado dinámico de la API de envío saliente v2020-07-01 se explica cómo probar tus aplicaciones sin afectar a los datos de producción ni iniciar eventos reales.
- Biblioteca ampliada de esquemas de informes disponible en el repositorio de GitHub selling-partner-api-models
- Tres nuevos recursos de la API de artículos de listings para resolver preguntas frecuentes:
Avisos de eliminación
22 de febrero de 2023
Cambios en la API
- Se han actualizado las respuestas simuladas del entorno aislado estático para mostrar los nombres de algunos métodos de envío nacionales (EE. UU.) de UPS en la SP-API.
- Se han añadido los siguientes atributos de preferencias de entrega a
getOrderAddress
para admitir los pedidos de los clientes de Amazon Business:PreferredDeliveryTime
BusinessHours
OtherAttributes
AddressInstructions
Estos atributos contienen información sobre cómo y cuándo se entrega un paquete.
- El atributo
customedURL
debuyerCustomizedInfo
, devuelto por las operacionesgetOrder
ygetOrders
, ahora es una URL codificada en Base 64 que utiliza el juego de caracteres UTF-8.
- Se ha actualizado para pasar
six-month-past-in-date
como parámetro de consulta.
Actualizaciones de la documentación
- La nueva Guía de casos de uso de pedidos de Amazon Business incluye operaciones para obtener información sobre los clientes de Amazon Business y sus preferencias de entrega.
- La nueva Guía de casos de uso de la API de ventas proporciona a los vendedores información sobre el rendimiento de las ventas. Para ello, se devuelven las métricas agregadas de los pedidos correspondientes a un período de tiempo determinado, desglosadas por detalles y tipo de comprador.
- La nueva Guía de casos de uso de productos pequeños y ligeros de Logística de Amazon incluye operaciones para ayudar a acceder al programa Productos pequeños y ligeros de Logística de Amazon.
Avisos de eliminación
25 de enero de 2023
Cambios en la API
- La nueva operación
getFeaturedOfferExpectedPriceBatch
recupera las respuestas a un lote de hasta 40 solicitudes de precio esperado de oferta destacada (FOEP).
- El nuevo atributo
buyerCustomizedInfo
contiene información sobre los compradores de los productos que el proveedor ha configurado como personalizables y especifica los tipos de personalización o configuraciones junto con los tipos y gamas de sus productos.
- El nuevo atributo
serialNumber
devuelve una lista de números de serie de los productos electrónicos que se envían a los clientes. Se devuelve solo para pedidos de Logística de Amazon.
- El nuevo tipo de evento financiero
CapacityReservationBillingEventList
te permite recuperar los detalles relacionados con un cargo de facturación por reserva de capacidad.
Actualizaciones de la documentación
- Los nuevos directorios de casos de uso identifican las API, las notificaciones y los informes que necesitarás para los casos de usos generales de Vendedor y Proveedor de la SP-API. Además, en la Tabla de modelos de la SP-API se indica si cada API está disponible para vendedores o proveedores e incluye enlaces a la referencia de cada modelo y a cualquier nota de lanzamiento pertinente.
- En la nueva Guía de casos de uso de la API de pedidos de gestión logística directa del proveedor V2021-23-28 se describe la API de pedidos de gestión logística directa del proveedor, que proporciona acceso programático a los datos de los pedidos de un proveedor de gestión logística directa.
- En la nueva Guía de casos de uso de la API de estado de transacciones de gestión logística directa del proveedor V2021-12-28 se describe la API de estado de transacciones de gestión logística directa del proveedor, que proporciona acceso programático al estado de las transacciones de un proveedor de gestión logística directa.
- Se ha actualizado el tema de planes de uso dinámico para Planes de uso y límites de tasa en la SP-API y ahora incluye la API de precios de productos y la operación
getFeaturedOfferExpectedPriceBatch
.
Avisos de eliminación
- API de ficheros v2020-09-04
- API de informes v2020-09-04
- Informes de inventario de Logística de Amazon
- Notificación
MFN_ORDER_STATUS_CHANGE
6 de diciembre de 2022
Cambios en la API
Se ha actualizado la API de artículos del catálogo v2022-04-01 para incluir varios atributos adicionales en el resumen a fin de equipararla con la sección Artículos del catálogo de Marketplace Web Services:
Además, se han añadido los siguientes atributos a ItemSummaryByMarketplace
:
adultProduct
autographed
memorabilia
releaseDate
tradeInEligible
9 de noviembre de 2022
Cambios en la API
-
El nuevo informe fiscal para vendedores sobre el GST (B2B)
GET_GST_MTR_B2B_CUSTOM
proporciona información detallada sobre las ventas, los reembolsos y las cancelaciones de las facturas de Amazon Business emitidas dentro del intervalo de fechas que especifiques. Solo disponible en el sitio web de la India. -
El nuevo informe fiscal para vendedores sobre el GST (B2C)
GET_GST_MTR_B2C_CUSTOM
proporciona información detallada sobre las ventas, los reembolsos y las cancelaciones de facturas del consumidor emitidas dentro del intervalo de fechas que especifiques. Solo disponible en el sitio web de la India. -
El nuevo informe de transferencia de inventario para vendedores sobre el GST
GET_GST_STR_ADHOC
proporciona información sobre los movimientos de inventario desde centros logísticos de Amazon (retiradas de un centro logístico o transferencias entre centros). El informe contiene detalles en el nivel de transacción necesarios para la contabilidad y la declaración del impuesto sobre el GST. Solo disponible en el sitio web de la India.
Actualizaciones de la documentación
- En la nueva Guía de creación de procesos de gestión de listings se describen los pasos que puedes seguir para crear los mejores procesos de creación y gestión de listings mediante la integración con la API del colaborador comercial.
19 de octubre de 2022
Cambios en la API
Se ha actualizado para la nueva notificación FBA_INVENTORY_AVAILABILITY_CHANGES
que 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.
-
Se ha actualizado
GET_SALES_AND_TRAFFIC_REPORT
y ahora incluye datos de tráfico B2B relacionados con el tráfico procedente de clientes de Amazon Business. A partir del 28 de agosto de 2022, se han cambiado las métricas de conversión B2B para utilizar los nuevos datos de tráfico B2B. Los datos anteriores al 08/28/2022 se establecen en cero para evitar confusiones. -
El nuevo informe de previsiones de Suscríbete y ahorra
GET_FBA_SNS_FORECAST_DATA
proporciona una previsión de ventas de ocho semanas basada en las suscripciones existentes y el historial de ventas. -
El nuevo informe de rendimiento de Suscríbete y ahorra
GET_FBA_SNS_PERFORMANCE_DATA
ofrece un resumen de las últimas cuatro semanas de los artículos enviados, el porcentaje de pedidos fallidos por falta de existencias, el precio medio de venta tras el descuento y el descuento medio para cada SKU.
Actualizaciones de la documentación
- Nuevo Guía de implementación de API Guard para socios vendedores describe las consideraciones arquitectónicas y los pasos de configuración para implementar Amazon Selling Partner Guard en la nube de AWS.
21 de septiembre de 2022
Cambios en la API
- Se ha actualizado para la nueva operación sincrónica createShippingLabels que crea etiquetas de envío para un pedido de compra y devuelve las etiquetas. Ten en cuenta que la operación
createShippingLabels
no cuenta con ningún soporte para entorno aislado en este momento. - Se ha actualizado para ofrecer asistencia de producción y entorno aislado dinámico para todas las operaciones equivalentes de Envío de gestión logística directa del proveedor V1.
- Se ha actualizado para que las siguientes operaciones restringidas sean compatibles con la API de envío de gestión logística directa del proveedor v2021-12-28:
createShippingLabels
getPackingSlip
getCustomerInvoice
getShippingLabel
- El informe del libro de inventario actualizado (
GET_LEDGER_DETAIL_VIEW_DATA
) ahora incluye un nuevo filtroeventType
para filtrar eventos concretos del almacén.
Actualizaciones de la documentación
- La nueva Guía del servicio de cálculo del IVA proporciona a los desarrolladores de los sitios web de la UE información orientativa sobre el servicio de cálculo del IVA de Amazon.
- En la nueva Guía de casos de uso de la API de solicitudes v1 se describe la API del colaborador comercial para solicitudes (API de solicitudes), que te ayuda a crear aplicaciones que permitan a los vendedores enviar solicitudes coherentes y de alta calidad a los compradores.
- En la nueva Guía de casos de uso de la API de mensajería v1 se describe la API de mensajería.
- En la nueva guía Codificación de URL se explica cómo codificar las URL para evitar errores con los SKU.
- Se ha actualizado la Guía de entorno aislado dinámico de gestión logística directa del proveedor para incluir asistencia para las operaciones de Envío de gestión logística directa del proveedor v2021-12-28. Ten en cuenta que, por el momento, la operación createShippingLabels no se puede usar en entornos aislados.
10 de agosto de 2022
Cambios en la API
- Mejoras en la API de pedidos para admitir los envíos de Easy Ship.
- Se ha actualizado para la nueva operación
getRangeSlotCapacity
que proporciona franjas de capacidad en un formato similar al de los registros de disponibilidad. - Se ha actualizado para la nueva operación
getFixedSlotCapacity
que proporciona franjas de capacidad fija.
18 de mayo de 2022
Cambios en la API
- La nueva versión de la API de artículos del catálogo 2022-04-01 mejora la experiencia de la API y aborda los comentarios de los desarrolladores con los siguientes cambios:
- Se han añadido búsquedas basadas en identificadores a la operación
searchCatalogItems
, lo que permite realizar solicitudes en lote con hasta 20 identificadores por solicitud (ASIN, UPC, EAN, etc.) - Se ha añadido un conjunto de datos
dimensions
, que proporciona dimensiones normalizadas del artículo y del paquete. - Se han añadido nombres de visualización para la categoría de producto, la subcategoría de producto y la clasificación de navegación.
- Se han ampliado los atributos de identificación a resúmenes de artículos (clasificación de artículos, cantidad de paquetes, número de pieza, grupo de visualización del sitio web).
- Se han añadido clasificaciones de navegación y grupos de visualización del sitio web a los índices de ventas.
- Se han alineado las operaciones
searchCatalogItems
ygetCatalogItem
para utilizar los mismos conjuntos de datos, que incluyenattributes
. - Se ha reemplazado
variations
conrelationships
para permitir la representación de varios tipos de relaciones, como las jerarquías de paquetes. - Se han añadido detalles del tema de la variante (nombre a los detalles de las relaciones).
- Se han añadido búsquedas basadas en identificadores a la operación
- Se ha añadido un parámetro
processingDirective
que permite transferir información adicional a la suscripción para controlar el procesamiento de las notificaciones. Este parámetro lo utiliza la notificaciónANY_OFFER_CHANGED
. - Se ha actualizado la notificación
ANY_OFFER_CHANGED
para permitir filtrar las notificaciones a solomarketplaceIds
específicos y limitar las notificaciones a una cada intervalo de cinco o diez minutos.
- Se ha actualizado para admitir el programa
getOrderRegulatedInfo
que gestiona los pedidos regulados en el Reino Unido. Los pedidos regulados son un conjunto limitado de pedidos para productos que requieren receta médica (medicamentos para mascotas, lentes de contacto con receta y gafas graduadas). Se han añadido dos operaciones nuevas:updateVerificationStatus
y {{2}}. - Nuevo atributo
IsAccessPointOrder
para ayudar a identificar los pedidos de Red logística del vendedor (gestionados por el vendedor) que se han enviado a centros de puntos de acceso (AP).
- Se ha actualizado para la nueva operación
getMyFeesEstimates
que recupera las estimaciones de las tarifas de los productos para una lista de productos y sitios web.
- Se ha actualizado para las nuevas operaciones
getItemOffersBatch
ygetListingOffersBatch
que recuperan los precios de los productos y ofrecen información en una lista de productos.
- Los nuevos tipos de informe Informe mensual del EPR, Informe trimestral del EPR e Informes anuales del EPR incluyen datos sobre las declaraciones de responsabilidad ampliada del productor (EPR) para los proveedores de servicios de Francia y Alemania, a fin de ayudar a los vendedores a cumplir con la normativa de la UE.
13 de abril de 2022
Cambios en la API
- La nueva API de Easy Ship te ayuda a crear aplicaciones que ayudan a los vendedores a gestionar y enviar los pedidos de Amazon Easy Ship.
- Se ha actualizado la API de inventario de Logística de Amazon para que tenga disponibilidad global. También se ha publicado una nueva guía de casos de uso de inventario de Logística de Amazon.
- La nueva 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 la Buy Box) debido a que su precio no es competitivo. - La nueva propiedad
FulfillmentChannel
de la notificaciónORDER_STATUS_CHANGE
te permite filtrar las notificaciones de cambio de estado del pedido en función de si el pedido lo gestiona Amazon (Logística de Amazon) o el vendedor (Red logística del vendedor).
- La nueva API de pedidos de gestión logística directa del proveedor v2021-12-28 proporciona acceso programático a los datos de los pedidos de un proveedor de gestión logística directa. Esta versión del 28 de diciembre de 2021 añade asistencia para pruebas en entornos aislados dinámicos.
- La nueva API de datos de pruebas del entorno aislado de gestión logística directa del proveedor v2021-10-28 proporciona acceso programático a datos de pruebas del entorno aislado de gestión logística directa del proveedor.
- La nueva referencia de la API de envío de gestión logística directa del proveedor v2021-12-28 proporciona acceso programático a datos de envío de un proveedor de gestión logística directa. Esta versión del 28 de diciembre de 2021 añade asistencia para pruebas en entornos aislados dinámicos.
- La nueva API de transacciones de gestión logística directa del proveedor v2021-12-28 proporciona acceso programático al estado de las transacciones de un proveedor de gestión logística directa. Esta versión del 28 de diciembre de 2021 añade asistencia para pruebas en entornos aislados dinámicos.
Actualizaciones de la documentación
- La nueva Guía de entorno aislado dinámico de gestión logística directa del proveedor incluye las operaciones de entorno aislado dinámico para las API de gestión logística directa del proveedor.
- Nuevo Guía de migración de informes de análisis de proveedores minoristas que explica los cambios en los informes de análisis del comercio minorista de los proveedores y proporciona los pasos para la migración.
23 de marzo de 2022
Cambios en la API
- El nuevo parámetro
buyerRequestedCancel
proporciona información sobre si un comprador solicitó la cancelación del pedido y el motivo de la cancelación.
Nuevos informes de Retail Analytics para vendedores
- El nuevo Informe comercial de ventas y tráfico te ayuda a gestionar mejor tus análisis al proporcionarte métricas clave del rendimiento de ventas, como las ventas de productos pedidos, los ingresos, las unidades solicitadas y el importe de las reclamaciones, así como métricas del tráfico de la página, como las visualizaciones de la página y el porcentaje de Buy Box del catálogo completo de productos del vendedor, agrupados por fecha y ASIN. Este informe requiere el rol Brand Analytics de la API del colaborador comercial, que ahora está disponible para todos los vendedores.
Nuevos informes de rendimiento
- El nuevo Informe de rendimiento de cupones te ayuda a optimizar tus promociones y ajustar tus estrategias publicitarias. El informe incluye detalles de campaña (número total de clips, canjes) y detalles de cupón (fecha de inicio y finalización, clips, canjes e información sobre el presupuesto). Está disponible para los proveedores que tengan el rol Brand Analytics de la API del colaborador comercial.
Nuevos informes de Retail Analytics para proveedores
- El nuevo informe de ventas de proveedores te ayuda a gestionar mejor tu inventario al proporcionarte métricas clave de ventas minoristas, como los ingresos por pedidos o envíos y las unidades. Los datos se presentan a nivel general en el catálogo de artículos de un proveedor y, a nivel de ASIN, en los periodos de presentación de informes
DAY
,WEEK
,MONTH
,QUARTER
yYEAR
. Disponible para los proveedores que tengan el rol Brand Analytics de la API del colaborador comercial. - El nuevo informe de tráfico de proveedores te ayuda a gestionar mejor tu inventario al proporcionarte métricas clave de tráfico de venta minorista, como las visualizaciones de la página de detalles. Los datos se presentan a nivel general en el catálogo de artículos de un proveedor y, a nivel de ASIN, en los periodos de presentación de informes
DAY
,WEEK
,MONTH
,QUARTER
yYEAR
. Disponible para los proveedores que tengan el rol Brand Analytics de la API del colaborador comercial. - El nuevo Informe de previsiones para proveedores te ayuda a gestionar mejor tu inventario al proporcionarte previsiones semanales prospectivas de la media, P70, P80 y P90, de la demanda de los clientes. El sistema de previsión produce previsiones para un ASIN en varios niveles P, también conocidos como niveles de confianza. Si estableces un nivel P de previsión de 0,80 ("P80"), significa que hay un 80 % de probabilidad de que la demanda de los clientes no supere las unidades previstas semanalmente. Los datos se presentan a nivel de ASIN para la fecha de generación de previsiones semanales más reciente. Disponible para los proveedores que tengan el rol Brand Analytics de la API del colaborador comercial.
- El nuevo Informe sobre el estado del inventario del proveedor 2.0 te ayuda a gestionar mejor tu inventario al proporcionarte métricas de inventario y del estado operativo, como las unidades disponibles que se pueden vender y la tasa de confirmación del proveedor. Los datos se presentan a nivel general en el catálogo de artículos de un proveedor y, a nivel de ASIN, en los periodos de informes semanales, mensuales, trimestrales y anuales. Disponible para los proveedores que tengan el rol Brand Analytics de la API del colaborador comercial.
Actualización de la documentación para los Informes de datos de facturas
- Tanto el Informe de datos de facturas con IVA de archivos sin formato como el Informe de datos de facturas con IVA con formato XML están ahora disponibles en la documentación. Son informes para vendedores inscritos en el Servicio de cálculo del IVA de Amazon y que optan por subir sus propias facturas.
Actualizaciones de la documentación
-
La nueva página Centro de migración reúne todos los plazos, las fechas de eliminación planificadas y los recursos relacionados con la migración de Amazon MWS a la API del colaborador comercial en una única página de referencia.
-
El nuevo sitio Blog sobre la API del colaborador comercial incluye artículos de arquitectos de soluciones de Amazon y expertos en API que abarcan diversos temas, como historias de clientes, migraciones, prácticas recomendadas, consejos y trucos, y mucho más.
19 de enero de 2022
Cambios en la API
- Nuevo código de error
PRODUCTASSURANCE_SAFETYDOCUMENTATION
devuelto con productos que no cuentan con la documentación de cumplimiento de seguridad. Este código de error se devuelve para las siguientes operaciones:CreateInboundShipmentPlan
CreateInboundShipment
UpdateInboundShipment
PreviewItemEligibility
Obtenga más información sobre este cambio en Seller Central.
- Nuevo atributo
buyerTaxInformation
para el sitio web de Turquía. Este atributo incluye información fiscal empresarial cuando el comprador es una empresa.
- La nueva notificación Cambio de estado del pedido se envía cada vez que hay un cambio en el estado de disponibilidad del pedido.
- El nuevo Informe de estado de gestión de inventario de Logística de Amazon te ayuda a gestionar mejor tu inventario al ofrecerte una visión consolidada de tus ventas (7, 30, 60 y 90 días), el estado de los envíos (en curso, recibidos y enviados), las tarifas estimadas por almacenamiento prolongado o normal y las unidades antiguas y sobrantes. Este informe incluye estadísticas sobre las ventas, los envíos entrantes, las tarifas estimadas y las acciones recomendadas.
- Nuevo Informe de transferencias de inventario por encargo que proporciona información en el nivel de transacción como el valor de la factura, el número de factura, la tasa impositiva y los números de identificación fiscal de bienes y servicios (GSTIN) para las transacciones de desplazamientos interestatales.
Actualizaciones de la documentación
Guía de migración de Amazon MWS a la API del colaborador comercial
- Documentación actualizada con orientación y recursos adicionales sobre la migración, incluidos los Serie de vídeos sobre la API para socios vendedores (SP-API) en YouTube para obtener asistencia de migración paso a paso y el API de socios vendedores en AWS Quick Start para configurar los recursos de IAM e implementar SP-API en la nube de AWS.
Updated 13 days ago