API Ahead · Amazon SP-API — del 9 al 16 de noviembre de 2026
Qué ha cambiado en la Amazon Selling Partner API entre el 9 y el 16 de noviembre de 2026, y qué significa para tu código.
2 rompen · 1 de riesgo silencioso · 1 aditivos · 1 anuncio · 2 modelos de API tocados
| Categoría | Nº | |
|---|---|---|
| 🔴 | Rompe | 2 |
| 🟠 | Riesgo silencioso | 1 |
| 🟢 | Aditivo | 1 |
| 📣 | Anuncios de Amazon | 1 |
Análisis
Esta semana hay dos cambios críticos que requieren acción inmediata y un anuncio que afectará a tus listados pronto; el resto son mejoras sin impacto inmediato.
Cambios breaking
- El campo
MarketplaceAttributes.marketplaceIdcambió de tipostringaref:MarketplaceId. Si tu código lo trata como cadena, la validación del modelo fallará y las peticiones al endpointexternalFulfillmentInventorydevolverán errores 400. BuscaMarketplaceAttributes.marketplaceIden tu repositorio y actualiza su tipo al nuevo esquema o usa la definiciónMarketplaceId. - Los tipos de informe
GET_V2_SETTLEMENT_REPORT_DATA_FLAT_FILEyGET_V2_SETTLEMENT_REPORT_DATA_XMLfueron retirados deReport Type Valuesel 11 de noviembre de 2026. Cualquier llamada acreateReportogetReportcon esos valores será rechazada con error 400. Busca esas constantes en tu código (GET_V2_SETTLEMENT_REPORT_DATA_FLAT_FILE,GET_V2_SETTLEMENT_REPORT_DATA_XML) y sustitúyelas por los tipos de informe vigentes.
Cambios silenciosos
- Se añadió un nuevo valor al enum
PreviewFeeType. Si tu lógica valida estrictamente los valores del enum, podrías recibir errores cuando Amazon incluya esas nuevas tarifas en los datos de Analytics. Busca usos dePreviewFeeTypey permite valores no enumerados o actualiza la lista de valores aceptados.
Cambios aditivos
- Se introdujo el esquema
MarketplaceId. No rompe nada, pero ya puedes referenciarlo en tus modelos para reemplazar el uso anterior de cadena enMarketplaceAttributes.marketplaceId.
Anuncio
Revisa tus mapeos de atributos de listado y los valores de enumeración antes del 16 de noviembre de 2026, ya que Amazon actualizará su uso y los valores permitidos.
🔴 Rompe (2)
Esto falla de forma ruidosa. Arréglalo antes de que Amazon lo aplique.
External Fulfillment / externalFulfillmentInventory_2024-09-11
- Cambia el tipo del campo
MarketplaceAttributes.marketplaceId:string→ref:MarketplaceId - La deserialización fallará o convertirá el valor en silencio. Actualiza tus modelos y cualquier casting alrededor de este valor.
Reports API
- Retirado en
Report Type Values:GET_V2_SETTLEMENT_REPORT_DATA_FLAT_FILE,GET_V2_SETTLEMENT_REPORT_DATA_XML(fecha de retirada: 2026-11-11) - Si tu integración lo sigue usando, ya está fallando en producción.
🟠 Riesgo silencioso (1)
Esto no falla al desplegar. Falla en producción, más tarde, sobre una parte de tus registros. Esta es la sección que le cuesta a la gente un fin de semana.
Data Kiosk / analytics_economics_2024_03_15
- Nuevos valores en
PreviewFeeType:"Coupon,"Deal,COUPON_UPFRONT_FEE,COUPON_VARIABLE_FEE,DEAL_UPFRONT_FEE,DEAL_VARIABLE_FEE,FBA_DISPOSAL_FEE,FBA_REMOVAL_FEE,FUEL_AND_LOGISTICS_RELATED_SURCHARGE,[Coupon,[Deal,fees](https://sellercentral.amazon.com/help/hub/reference/external/G202111590)."(+1) - Esto no falla al desplegar. Falla en producción la primera vez que Amazon envía de verdad uno de estos valores y tu
switch, diccionario omatchno tiene rama para él. Revisa todos los sitios donde mapeas este campo contra un conjunto fijo de valores.
🟢 Aditivo (1)
Superficie nueva. No rompe nada — léelo sólo si tienes curiosidad.
External Fulfillment / externalFulfillmentInventory_2024-09-11
- Nuevo esquema:
MarketplaceId
📣 Anuncios de Amazon (1)
Lo que Amazon publicó en su changelog. Enlace y fecha; el resumen es nuestro.
- November Updates to Listing Attribute Usage and Enumeration Values · 11 de noviembre de 2026
Atributos de listings. Amazon actualiza cada mes los atributos y los valores permitidos de las categorías de producto. Ese detalle no está en los modelos públicos: vive en las definiciones de tipo de producto que sirve la API autenticada, así que no lo vemos. Aquí tienes el anuncio y su fecha; el campo exacto que cambió en tus categorías es parte del servicio para clientes.
Fuentes: los modelos OpenAPI y los esquemas de notificaciones, reports y feeds que publica Amazon, comparados versión a versión; su calendario oficial de retiradas y su changelog. Cada cambio sale de una de estas fuentes: nada sale de una suposición.
API Ahead es gratis. Te dice qué ha cambiado en la API.
Si lo que quieres es que te digamos qué ha cambiado en tu repositorio — el fichero, la línea y el arreglo propuesto — ese es nuestro servicio de pago: 99 €/mes por repositorio. Responde a este correo y lo ponemos en marcha.
Los modelos OpenAPI y los esquemas son © Amazon.com, Inc. or its affiliates, publicados bajo licencia Apache 2.0. El calendario de retiradas y el changelog pertenecen a la documentación de Amazon: los enlazamos y resumimos, nunca reproducimos su contenido. Este boletín es un análisis independiente de esas fuentes públicas: no está afiliado a Amazon, ni patrocinado ni respaldado por Amazon. Amazon y Selling Partner API son marcas de Amazon.com, Inc. o sus filiales.