API Ahead · Amazon SP-API — 9–16 November 2026
What changed in the Amazon Selling Partner API between 9 and 16 November 2026, and what it means for your code.
2 breaking · 1 silent risk · 1 additive · 1 announcement · 2 API models touched
| Category | Count | |
|---|---|---|
| 🔴 | Breaking | 2 |
| 🟠 | Silent risk | 1 |
| 🟢 | Additive | 1 |
| 📣 | Amazon announcements | 1 |
Briefing
Esta semana requiere acción inmediata: el tipo del campo MarketplaceAttributes.marketplaceId cambió y dos valores de tipo de informe de liquidación fueron retirados, lo que romperá las integraciones que todavía los usan. Además, hay una actualización de atributos de listado que entrará en vigor a mediados de noviembre y que debe revisarse antes de que impacte en la publicación de productos.
Cambios críticos
MarketplaceAttributes.marketplaceId pasó de string a ref:MarketplaceId.
Cualquier código que envíe o valide este campo como cadena literal fallará la validación del modelo y provocará errores 400.
Busque en su base de código referencias a MarketplaceAttributes.marketplaceId y actualice la serialización para usar el nuevo tipo de referencia (MarketplaceId).
Report Type Values: se eliminaron los valores GET_V2_SETTLEMENT_REPORT_DATA_FLAT_FILE y GET_V2_SETTLEMENT_REPORT_DATA_XML (removal date 2026‑11‑11).
Las solicitudes de generación de reportes que usen esos tipos recibirán respuestas de error y detendrán los procesos de descarga de liquidaciones.
Haga una búsqueda de esos valores en los payloads de createReport o en constantes de tipo de reporte y sustitúyalos por los tipos vigentes.
Riesgo silencioso
Se añadieron nuevos valores al enum PreviewFeeType.
Si su código valida estrictamente los valores del enum, los nuevos ítems pueden ser rechazados como inválidos.
Actualice cualquier lista de valores permitidos o la lógica de validación para incluir los valores recién añadidos (por ejemplo, busque "PreviewFeeType" en los esquemas o en la lógica de validación).
Cambios aditivos
Se introdujo un nuevo esquema MarketplaceId. No rompe nada, pero permite referenciar de forma tipada los identificadores de marketplace en futuras implementaciones.
Aviso de Amazon
A partir del 16 de noviembre de 2026, Amazon actualizará el uso de atributos de listado y los valores de enumeración de numerosos tipos de producto, por lo que debe revisar que sus mapeos de atributos coincidan con los nuevos requisitos antes de esa fecha.
🔴 Breaking (2)
These will fail loudly. Fix before Amazon enforces them.
External Fulfillment / externalFulfillmentInventory_2024-09-11
- Type changed on field
MarketplaceAttributes.marketplaceId:string->ref:MarketplaceId - Deserialization will break or silently coerce. Update your models and any casting around this value.
Reports API
- Removed from
Report Type Values:GET_V2_SETTLEMENT_REPORT_DATA_FLAT_FILE,GET_V2_SETTLEMENT_REPORT_DATA_XML(removal date: 2026-11-11) - If your integration still uses it, it is already failing in production.
🟠 Silent risk (1)
These will NOT fail at deploy time. They fail in production, later, on a subset of records. This is the section that costs people weekends.
Data Kiosk / analytics_economics_2024_03_15
- New enum value(s) in
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) - This will NOT fail at deploy time. It fails in production the first time Amazon actually sends one of these values and your switch/map/match has no branch for it. Check every place you map this field to a fixed set of values.
🟢 Additive (1)
New surface area. Nothing breaks — read only if you're curious.
External Fulfillment / externalFulfillmentInventory_2024-09-11
- New schema:
MarketplaceId
📣 Amazon announcements (1)
What Amazon published in its changelog. Link and date; the summary is ours.
- November Updates to Listing Attribute Usage and Enumeration Values · 11 November 2026
Listing attributes. Amazon updates the attributes and allowed values of product categories every month. That detail is not in the public models: it lives in the product type definitions served by the authenticated API, so we do not see it. Here you get the announcement and its date; the exact field that changed in your categories is part of the client service.
Sources: the OpenAPI models and the notification, report and feed schemas Amazon publishes, compared version to version; its official deprecations schedule and its changelog. Every change comes from one of these sources: nothing here is a guess.
API Ahead is free. It tells you what changed in the API.
If you'd rather be told what changed in your repo — the file, the line, and the proposed fix — that's our paid service: €99/month per repository. Reply and we'll set it up.
The OpenAPI models and schemas are © Amazon.com, Inc. or its affiliates, released under the Apache License 2.0. The deprecations schedule and the changelog belong to Amazon's documentation: we link to them and summarize them, never reproduce their content. This newsletter is an independent analysis of those public sources: it is not affiliated with, sponsored by, or endorsed by Amazon. Amazon and Selling Partner API are trademarks of Amazon.com, Inc. or its affiliates.