API Ahead

Ediciones

API Ahead · Amazon SP-API — del 26 de octubre al 2 de noviembre de 2026

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

12 rompen · 6 de riesgo silencioso · 21 aditivos · 2 anuncios · 10 modelos de API tocados

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

🔴 Rompe (12)

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

External Fulfillment / externalFulfillmentShipments_2024-09-11

  • Valores retirados de Charge.chargeType: GIFT_WRAP, OTHER, PRODUCT, SHIPPING, TOTAL
  • Si envías alguno de estos valores, la petición será rechazada. Si los almacenas, tus registros históricos pueden dejar de validar.
  • Valores retirados de CreateSandboxShipmentRequest.shippingType: Marketplace, Self
  • Si envías alguno de estos valores, la petición será rechazada. Si los almacenas, tus registros históricos pueden dejar de validar.
  • El esquema DateTime cambia de tipo: string → string(date-time)
  • Los modelos generados para este tipo ya no son correctos.
  • El esquema Decimal cambia de tipo: string → number
  • Los modelos generados para este tipo ya no son correctos.
  • Valores retirados de PackageStatus: CREATED, INVOICE_GENERATED, PICKUP_SLOT_RETRIEVED, SHIPLABEL_GENERATED
  • Si envías alguno de estos valores, la petición será rechazada. Si los almacenas, tus registros históricos pueden dejar de validar.
  • Cambia el tipo del campo ShipmentInfo.orderPlacedTimestamp: string → number(int64)
  • La deserialización fallará o convertirá el valor en silencio. Actualiza tus modelos y cualquier casting alrededor de este valor.

Support / support_2025-02-01

  • Campo eliminado: Case.lastOutboundDate
  • Cualquier código que lea este campo obtendrá null o un KeyError. Revisa el parseo y el mapeo posterior.
  • Esquema eliminado: CaseFilters
  • Los modelos generados que referencien este tipo dejarán de compilar o de deserializar.
  • Esquema eliminado: DateFilter
  • Los modelos generados que referencien este tipo dejarán de compilar o de deserializar.
  • Campo eliminado: ListCasesRequest.caseFilters
  • Cualquier código que lea este campo obtendrá null o un KeyError. Revisa el parseo y el mapeo posterior.
  • Campo eliminado: ListCasesRequest.marketplaceId
  • Cualquier código que lea este campo obtendrá null o un KeyError. Revisa el parseo y el mapeo posterior.
  • Campo eliminado: ListCasesRequest.sortField
  • Cualquier código que lea este campo obtendrá null o un KeyError. Revisa el parseo y el mapeo posterior.

🟠 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.

External Fulfillment / externalFulfillmentShipments_2024-09-11

  • Nuevos valores en Charge.chargeType: gift_wrap, other, product, shipping, total
  • 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 CreateSandboxShipmentRequest.shippingType: MARKETPLACE, SELF
  • 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.

Merchant Fulfillment / merchantFulfillmentV0

  • Nuevos valores en DeliveryExperienceOption: DeliveryConfirmationWithIdentityCheck, DeliveryConfirmationWithNameVerification
  • 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 DeliveryExperienceType: DeliveryConfirmationWithIdentityCheck, DeliveryConfirmationWithNameVerification
  • 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 / OrderChangeNotification

  • Nuevos valores en OrderChangeNotification.Payload.OrderChangeNotification.OrderChangeType: PreFulfillmentStatusChange
  • 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: PreFulfillmentStatusChange
  • 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 (21)

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

Action Items / actionItems_2026-06-01

  • Nuevo modelo de API publicado: Action Items / actionItems_2026-06-01

Action Plans / actionPlans_2026-06-01

  • Nuevo modelo de API publicado: Action Plans / actionPlans_2026-06-01

External Fulfillment / externalFulfillmentShipments_2024-09-11

  • El campo ComplianceAttributes.countryOfOriginRequirement pasa a ser opcional
  • Nuevo campo opcional: ComplianceAttributes.hazmatLabelRequirement
  • El campo ComplianceAttributes.itemValueRequirement pasa a ser opcional
  • El campo InvoiceInfo.creationDateTime pasa a ser opcional
  • El campo InvoiceInfo.invoiceId pasa a ser opcional
  • Nuevo campo opcional: Package.trackingDetails
  • El campo RecommendedPackage.lineItems pasa a ser opcional
  • Nuevo campo opcional: ShippingInfo.expectedShippingDateTime
  • Nuevo esquema: TrackingDetails

Listings Items / listingsItems_2021-08-01

  • Nuevo campo opcional: ItemOfferByMarketplace.quantityDiscountPlan
  • Nuevo campo opcional: ItemOfferByMarketplace.replenishmentDiscount
  • Nuevo esquema: QuantityDiscountLevel
  • Nuevo esquema: QuantityDiscountPlan
  • Nuevo esquema: ReplenishmentDiscount

Messaging / messaging_2026-04-20

  • Nuevo modelo de API publicado: Messaging / messaging_2026-04-20

Notifications / OrderChangeNotification

  • Nuevo campo opcional: OrderChangeNotification.Payload.OrderChangeNotification.Summary.PreFulfillmentStatus

Notifications / notifications

  • Nuevo campo opcional: TrackingIdentifier.proNumber

Services / services

  • Nuevo parámetro opcional: GET /service/v1/serviceJobs :: providerServiceJobReferenceIds
  • Nuevo campo opcional: ServiceJobProvider.providerServiceJobReferenceId

📣 Anuncios de Amazon (2)

Lo que Amazon publicó en su changelog. Enlace y fecha; el resumen es nuestro.

⏳ 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
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.