Boletín semanal · gratis · para developers de la Amazon SP-API

Entérate de lo que Amazon cambió en la SP-API antes de que rompa tu integración.

Cada lunes, un diff exacto de los modelos OpenAPI que publica Amazon, clasificado en lo que rompe, lo que rompe en silencio, lo que se retira y lo que se añade. Cada cambio sale de una fuente pública de Amazon que puedes comprobar tú mismo: nada sale de una suposición.

No sustituye al changelog de Amazon: lo completa. El changelog te dice lo que Amazon anuncia; nosotros, lo que el contrato cambió de verdad — modelos, esquemas de notificaciones y reports, rate limits y fechas de retirada — incluido lo que no anunciaron.

Y lo que todavía no vemos, dicho claro: los atributos y valores permitidos de cada categoría de producto no están en los modelos públicos, viven en las definiciones de tipo de producto que sirve la API autenticada de Amazon. Te avisamos cada vez que Amazon anuncia una actualización —lo hace todos los meses—; saber qué campo cambió en tus categorías es parte del servicio para clientes.

Doble confirmación · Baja en un clic · Ni spam ni listas compradas · Privacidad

Una edición real, no un mockup · mayo–agosto de 2026

API Ahead · Amazon SP-API · 27 may – 26 ago 2026

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

Catalog Items v0
listCatalogCategories se retira el 26 de agosto de 2026. En el modelo OpenAPI seguía sin marcar.
Data Kiosk
Amazon elimina el esquema analytics_salesAndTraffic_2023_11_15.
awd_2024-05-09
Valores LETTER_6 y THERMAL_NONPCP retirados del parámetro pageType.
orders_2026-01-01
ItemProceedsBreakdown.subtotal y .type pasan a obligatorios.
listingsItems_2021-08-01
10 valores de Issue.categories documentados por primera vez.
OrderChangeNotification
Nuevo valor DeliveryTipChange en changeType.

Cómo funciona

Un diff de ficheros versionados. Determinista y exacto.

01

Amazon publica sus modelos

Los modelos OpenAPI de toda la Selling Partner API viven en un repositorio público de Amazon, cada cambio con su commit y su fecha. Como ese repositorio a veces va por detrás de la realidad, leemos también el calendario oficial de retiradas y el changelog de Amazon.

Cada modelo se aplana en hechos

En vez de comparar dos JSON anidados, cada documento se convierte en afirmaciones planas con claves estables. Comparar dos versiones se reduce a comparar dos diccionarios.

field    Order.OrderStatus              -> string|required=True
enum-doc Issue.categories[]             -> ('DUPLICATE', 'INVALID_IMAGE', ...)
param    GET /orders :: includedData    -> array<string>|required=False|in=query

03

Cada diferencia se clasifica y se redacta

Rompe, riesgo silencioso, deprecación o aditivo. Y después, para cada cambio que importa: qué cambió, qué rompe en la práctica y qué buscar en tu código. Escrito para un developer con prisa.

Las cinco categorías

No todo lo que cambia rompe. Lo que rompe no siempre avisa.

Rompe	Falla de forma ruidosa: endpoint o campo eliminado, parámetro que pasa a obligatorio, valor de enum retirado.
Riesgo silencioso	No falla al desplegar. Falla en producción, semanas después, sobre parte de tus registros.
Deprecación	Retirada anunciada. Hay tiempo, pero hay fecha.
Aditivo	Superficie nueva. No rompe nada.
Anuncios de Amazon	Lo que Amazon publica en su changelog, con su fecha y su enlace.

La naranja es la que nos diferencia: un switch con los valores conocidos no falla al desplegar, falla la primera vez que Amazon envía el valor nuevo.

Para quién

Para quien mantiene código contra la SP-API.

Agencias e integradores que mantienen N integraciones de N clientes. Un cambio de Amazon les multiplica el trabajo por N, y el primer aviso suele ser un cliente enfadado.

ISVs y SaaS del ecosistema cuyo producto es la integración. Si se rompe, no es un bug: es un incidente de producto.

Equipos con un developer in-house que además hace otras diez cosas y no tiene un hueco cada semana para leerse el changelog.

No es para el vendedor que usa una herramienta ya hecha: esa herramienta ya tiene a alguien mirando esto por él. Es para ese alguien.

Lo que viene

El siguiente nivel: tu repositorio, tu fichero, tu línea.

Estamos construyendo el siguiente nivel: conectas tu repositorio en modo lectura y te decimos qué fichero y qué línea toca cada cambio, con una pull request propuesta. Tu código no sale de tu casa y nadie escribe en tu producción.

Buscamos los primeros equipos piloto. Déjanos tu correo y hablamos.

Te suscribe también al boletín semanal · Doble confirmación · Baja en un clic · Privacidad

¿Prefieres escribir directamente? [email protected]

Cada lunes, antes de que empiece tu semana.

Sin coste. Sin API keys. Sin acceso a tu código.