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.

3 rompen · 3 de riesgo silencioso · 94 aditivos · 14 modelos de API tocados

Categoría Nº
🔴 Rompe 3
🟠 Riesgo silencioso 3
🟢 Aditivo 94

🔴 Rompe (3)

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.

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 (3)

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.

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.

🟢 Aditivo (94)

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 69 cambios aditivos más en 14 modelos.

Fuente: los modelos OpenAPI que publica Amazon, comparados versión a versión. Sin scraping y sin adivinar: si está aquí, está en el spec.

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 son © Amazon.com, Inc. or its affiliates, publicados bajo licencia Apache 2.0. Este boletín es un análisis independiente de esos modelos públicos: 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.