API Ahead

Ediciones

API Ahead · Amazon SP-API — del 27 de mayo al 26 de agosto de 2026

Qué ha cambiado en la Amazon Selling Partner API entre el 27 de mayo de 2026 y el 26 de agosto de 2026, y qué significa para tu código.

7 rompen · 6 de riesgo silencioso · 113 aditivos · 12 anuncios · 23 modelos de API tocados

Categoría Nº
🔴 Rompe 7
🟠 Riesgo silencioso 6
🟢 Aditivo 113
📣 Anuncios de Amazon 12

🔴 Rompe (7)

Esto falla de forma ruidosa. Arréglalo antes de que Amazon lo aplique.

Amazon Warehousing And Distribution / awd_2024-05-09

  • Valores retirados de GET /awd/2024-05-09/inboundShipments/{shipmentId}/labels :: pageType: LETTER_6, THERMAL_NONPCP
  • Si envías alguno de estos valores, la petición será rechazada. Si los almacenas, tus registros históricos pueden dejar de validar.

Catalog Items API

  • Retirado en Catalog Items API v0: listCatalogCategories (fecha de retirada: 2026-08-26)
  • Si tu integración lo sigue usando, ya está fallando en producción.

Data Kiosk / analytics_salesAndTraffic_2023_11_15

  • Modelo de API eliminado: Data Kiosk / analytics_salesAndTraffic_2023_11_15
  • Esta API ha desaparecido de los modelos publicados. Si la llamas, confirma el plan de retirada en el changelog oficial de inmediato.

Notifications API

  • Retirado en Notification Type Values: LISTINGS_ITEM_ISSUES_CHANGE (payload version 1.0) (fecha de retirada: 2026-08-26)
  • Si tu integración lo sigue usando, ya está fallando en producción.
  • Retirado en Notification Type Values: ORDER_STATUS_CHANGE (fecha de retirada: 2026-07-29)
  • Si tu integración lo sigue usando, ya está fallando en producción.

Orders / orders_2026-01-01

  • El campo ItemProceedsBreakdown.subtotal pasa a ser obligatorio
  • Las peticiones que no lo incluyan serán rechazadas.
  • El campo ItemProceedsBreakdown.type pasa a ser obligatorio
  • Las peticiones que no lo incluyan serán rechazadas.

🟠 Riesgo silencioso (6)

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.

Listings Items / listingsItems_2021-08-01

  • Amazon documenta por primera vez los valores permitidos de Issue.categories[]: DUPLICATE, INVALID_ATTRIBUTE, INVALID_IMAGE, INVALID_PRICE, LISTING, MISSING_ATTRIBUTE, MISSING_IMAGE, MISSING_PRICE, PRODUCT, QUALIFICATION_REQUIRED
  • El tipo del campo no ha cambiado, así que un diff de OpenAPI estándar no ve nada aquí. Pero Amazon acaba de fijar qué puede contener. Si mapeas este campo contra un conjunto fijo de valores, comprueba que están todos contemplados.

Notifications / OrderChangeNotification

  • Nuevos valores en OrderChangeNotification.Payload.OrderChangeNotification.OrderChangeType: DeliveryTipChange
  • 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.

Notifications / notifications

  • Nuevos valores en OrderChangeTypeEnum: DeliveryTipChange
  • 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.

Orders / orders_2026-01-01

  • Nuevos valores en GET /orders/2026-01-01/orders :: includedData: FULFILLMENT_ORDERS
  • 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.
  • Nuevos valores en GET /orders/2026-01-01/orders/{orderId} :: includedData: FULFILLMENT_ORDERS
  • 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.

Replenishment / replenishment-2022-11-07

  • Nuevos valores en AggregationFrequency: DAY
  • 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 (113)

Superficie nueva. No rompe nada — léelo sólo si tienes curiosidad.

Amazon Warehousing And Distribution / awd_2024-05-09

  • Nuevo esquema: FormatType
  • Nuevo endpoint: GET /awd/2024-05-09/inboundShipments/{shipmentId}/labelPageTypes
  • Nuevo endpoint: GET /awd/2024-05-09/outboundOrders
  • Nuevo endpoint: GET /awd/2024-05-09/outboundOrders/{orderId}
  • Nuevo esquema: InventoryDetailsVisibility
  • Nuevo esquema: OrderAttribute
  • Nuevo esquema: OrderPreference
  • Nuevo esquema: OrderPreferenceValue
  • Nuevo esquema: OutboundExecutionError
  • Nuevo esquema: OutboundListing
  • Nuevo esquema: OutboundOrder
  • Nuevo esquema: OutboundOrderCreationData
  • Nuevo esquema: OutboundOrderReference
  • Nuevo esquema: OutboundShipment
  • Nuevo esquema: OutboundStatus
  • Nuevo endpoint: POST /awd/2024-05-09/outboundOrders
  • Nuevo endpoint: POST /awd/2024-05-09/outboundOrders/{orderId}/confirmation
  • Nuevo endpoint: PUT /awd/2024-05-09/outboundOrders/{orderId}
  • Nuevo esquema: PageType
  • Nuevo esquema: ShipmentLabelPageTypes
  • Nuevo esquema: ShipmentSortableField
  • Nuevo esquema: SkuQuantitiesVisibility
  • Nuevo esquema: SortOrder

Finances / financesInvoices_2026-06-25

  • Nuevo modelo de API publicado: Finances / financesInvoices_2026-06-25

Finances / finances_2024-06-19

  • Nuevo esquema: Balance

…y 88 cambios aditivos más en 21 modelos.

📣 Anuncios de Amazon (12)

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.

⏳ Próximas retiradas (90 días)

Lo que Amazon retira en los próximos 90 días según su calendario oficial. No son cambios de esta semana: es el recordatorio para que la migración no te pille.

Retirada Producto Qué se retira
26 de agosto de 2026 Catalog Items API v0 listCatalogCategories
26 de agosto de 2026 Notification Type Values LISTINGS_ITEM_ISSUES_CHANGE (payload version 1.0)
11 de noviembre de 2026 Report Type Values GET_V2_SETTLEMENT_REPORT_DATA_FLAT_FILE, GET_V2_SETTLEMENT_REPORT_DATA_XML

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 una pull request con el arreglo — eso es lo que estamos construyendo. Responde a este correo y te apuntamos a la lista de pilotos.

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.