Ediciones

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.marketplaceId cambió de tipo string a ref:MarketplaceId. Si tu código lo trata como cadena, la validación del modelo fallará y las peticiones al endpoint externalFulfillmentInventory devolverán errores 400. Busca MarketplaceAttributes.marketplaceId en tu repositorio y actualiza su tipo al nuevo esquema o usa la definición MarketplaceId.
  • Los tipos de informe GET_V2_SETTLEMENT_REPORT_DATA_FLAT_FILE y GET_V2_SETTLEMENT_REPORT_DATA_XML fueron retirados de Report Type Values el 11 de noviembre de 2026. Cualquier llamada a createReport o getReport con 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 de PreviewFeeType y 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 en MarketplaceAttributes.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 o match no 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.

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.