Apariencia
Qué es Amazon Selling Partner API (SP-API)
Resumen rápido
Amazon SP-API es la API REST oficial de Amazon para acceder programáticamente a los datos de una cuenta de vendedor o proveedor. Permite automatizar prácticamente cualquier operación que se puede hacer manualmente en Seller Central: consultar pedidos, actualizar inventario, generar informes, monitorizar precios, gestionar listings, etc.
Sustituyó al antiguo Amazon MWS (Marketplace Web Service), que era una API basada en XML y SOAP, ya completamente deprecada.
Conceptos importantes
- SP-API: Selling Partner API. La API moderna de Amazon, basada en REST y JSON.
- MWS: Marketplace Web Service. La API antigua, deprecada. Si tienes código MWS, necesitas migrar.
- REST API: Tipo de arquitectura de API que usa HTTP estándar (GET, POST, PUT, DELETE) y devuelve JSON.
- Seller Central: El panel de control de los vendedores en Amazon.
- Vendor Central: El panel de control para proveedores (distintos de vendedores). Tienen sus propias APIs.
- FBA: Fulfillment by Amazon — Amazon gestiona el almacén y el envío.
- FBM: Fulfillment by Merchant — el vendedor gestiona el envío directamente.
- Marketplace: Cada país/región de Amazon donde se puede vender (amazon.es, amazon.de, amazon.com, etc.).
- ASIN: Amazon Standard Identification Number, el identificador único de cada producto en Amazon.
- SKU: Stock Keeping Unit, el identificador interno que el vendedor da a cada producto.
Cómo funciona
La SP-API es una colección de APIs especializadas por categoría. No hay un único endpoint que lo haga todo; hay una API para pedidos, otra para informes, otra para catálogo, etc.
Cada API sigue este patrón general:
- Obtienes un
access tokentemporal usando las credenciales de tu app (LWA). - Haces la petición HTTP al endpoint correspondiente con ese token en la cabecera.
- Amazon devuelve la respuesta en formato JSON.
Los datos disponibles son prácticamente los mismos que ves en Seller Central, pero de forma programática y automatizable.
Categorías principales de la API
| API | Para qué sirve |
|---|---|
| Orders API | Obtener y gestionar pedidos |
| Sales API | Métricas de ventas agregadas |
| Catalog Items API | Información de productos en el catálogo de Amazon |
| Reports API | Generar y descargar informes de Seller Central |
| Notifications API | Suscribirse a eventos (nuevo pedido, cambio de precio, etc.) |
| Feeds API | Subir datos masivos a Amazon (precios, inventario, listings) |
| Listings API | Gestionar listings individuales (precio, cantidad, etc.) |
| Finances API | Información financiera (liquidaciones, tarifas) |
| FBA API | Gestión del inventario en almacenes de Amazon |
| Fulfillment Inbound API | Enviar stock a los almacenes de Amazon (FBA) |
| Authorization API | Gestionar autorizaciones de terceros |
Pasos prácticos
¿Por dónde empezar?
- Decide si necesitas una app privada (solo para tu cuenta) o una app pública (para otros vendedores). Empieza con privada si es para tu propio negocio.
- Crea una cuenta de desarrollador en Amazon Seller Central (Apps y Servicios → Desarrollar apps).
- Crea tu app en Developer Central.
- Obtén las credenciales LWA (client ID y client secret).
- Genera tu primer
refresh tokenautorizando la app. - Haz tu primera petición a la API.
Errores comunes
- Confundir MWS con SP-API: son completamente distintos. El código MWS no sirve para SP-API.
- Pensar que es una sola API: en realidad es un conjunto de APIs especializadas.
- Asumir que todos los datos están disponibles: algunos datos requieren permisos especiales (PII/RDT). Ver 04-acceso-pii-y-rdt.md.
- No diferenciar entre Seller y Vendor: la SP-API tiene endpoints distintos para vendedores (Seller Central) y proveedores (Vendor Central).
Qué debo saber antes de programarlo
- Amazon SP-API tiene rate limits (límites de solicitudes por segundo) distintos para cada API. Hay que tenerlos en cuenta desde el diseño. Ver 12-rate-limits-y-throttling.md.
- Desde octubre 2024, Amazon eliminó la obligatoriedad de usar AWS IAM y AWS Signature v4. Ahora solo necesitas las credenciales LWA para hacer peticiones. Esto simplifica mucho la configuración inicial.
- Desde enero 2026, hay tarifas de uso de SP-API para desarrolladores de terceros (no afecta a apps privadas). Ver 14-fees-y-optimizacion-de-llamadas.md.
- La documentación oficial de Amazon es confusa y está dispersa. Es habitual necesitar buscar en GitHub, foros y vídeos complementarios.
Pendiente de revisar
- Confirmar si Vendor Central tiene todas las mismas APIs que Seller Central o hay diferencias.
- Revisar si hay diferencias entre marketplaces en cuanto a disponibilidad de APIs.