Amazon SP-API

Apariencia

Dudas Pendientes ​

Preguntas e incógnitas identificadas durante la creación de esta documentación que requieren investigación adicional antes de implementar. Organizadas por categoría.

Autenticación y Seguridad ​

  • ¿Cómo rotar las credenciales LWA de forma segura? Se ha identificado un tutorial sobre rotación de LWA credentials. Revisar para implementar rotación periódica en apps de producción.
  • ¿Qué pasa si el refresh_token caduca o se revoca? ¿Amazon lo invalida tras cierto tiempo de inactividad? ¿Cómo se regenera sin interrumpir el servicio?
  • ¿El refresh_token tiene alguna política de expiración? En el tutorial se dice que es de larga duración pero no se especifica si es indefinido.
  • ¿Se puede tener más de un refresh_token activo para la misma app? Útil para entornos de staging y producción.

Rate Limits y Throttling ​

  • ¿Amazon penaliza o banea por exceder el throttle repetidamente, o solo devuelve 429? El tutorial menciona que pueden "banearte" por exceso de peticiones, pero no detalla el proceso.
  • ¿El dynamic usage plan se aplica por aplicación o por cuenta de vendedor? Si tienes una SaaS con múltiples clientes, ¿cada cliente tiene sus propios límites o comparten?
  • ¿Cómo funcionan exactamente los rate limits en apps con múltiples cuentas de vendedor? Importante para planificar la arquitectura de apps multi-tenant.
  • ¿Los rate limits se comparten entre distintos marketplaces de la misma región? ¿Si pido Orders para amazon.es y amazon.de al mismo tiempo, comparten el bucket?

Fees y Costes ​

  • ¿Cómo se contabiliza exactamente el número de GET calls en el billing de Amazon? ¿Cuenta cada petición HTTP individual o hay alguna agrupación?
  • ¿Hay algún panel en Developer Central donde ver el consumo actual de calls? Para monitorizar el gasto antes de que llegue la factura.
  • ¿Las llamadas de autenticación (obtener access token) cuentan para el billing? La URL api.amazon.com/auth/o2/token no es parte de SP-API técnicamente.
  • ¿El fee mensual cambia si tienes múltiples apps registradas? ¿Cada app paga $1.400/año o es por cuenta de desarrollador?

Orders API ​

  • ¿Qué información exactamente queda oculta sin PII vs con PII? El tutorial menciona dirección completa, nombre y teléfono, pero ¿hay más campos?
  • ¿Cómo se accede a los datos de pedidos de custom products? El tutorial menciona que para custom products (productos personalizados) no se puede usar Reports API y hay que usar Orders API.
  • ¿Cuánto historial de pedidos se puede obtener? ¿Hay un límite de antigüedad para GetOrders?

Reports API ​

  • ¿Hay algún tipo de informe que devuelva datos de ventas por ASIN desagregados? Para análisis de rendimiento por producto.
  • ¿Cuánto tiempo están disponibles los documentos de informe antes de que caduquen? La URL firmada expira en minutos, pero ¿cuánto tiempo está disponible el reportDocumentId para obtener una nueva URL?
  • ¿Qué informes están disponibles para Vendor Central vs Seller Central? El tutorial se centra en Seller Central.
  • ¿Los informes de Settlement se pueden solicitar bajo demanda o solo cuando Amazon los genera? El tutorial indica que son automáticos cada 2 semanas, pero no está claro si se pueden forzar.

Listings API ​

  • ¿Cuál es la estructura exacta del body para putListingsItem (creación completa de listing)? La documentación de Amazon es compleja para este caso.
  • ¿Cómo se actualizan las imágenes de un listing a través de la API? No cubierto en los tutoriales.
  • ¿Qué productTypes están disponibles y cómo obtener los atributos requeridos para cada uno? Necesario para crear listings completos.

Feeds API ​

  • ¿Hay un límite máximo de mensajes (productos) en un único feed? ¿Puedo enviar 10.000 precios en un solo XML?
  • ¿Qué estructura tiene el XML para actualizar inventario y confirmación de envíos FBM? Solo está documentada la actualización de precios en los tutoriales.
  • ¿Todos los tipos de feed tienen documentación oficial o hay algunos sin documentar?

Notifications API ​

  • ¿Cuánto tiempo se guardan los mensajes en la cola SQS antes de expirar si no se consumen? El valor predeterminado de SQS es 4 días, pero no está confirmado para notificaciones de SP-API.
  • ¿Se necesita configurar algo diferente para recibir notificaciones de múltiples cuentas de vendedor? ¿Una sola cola SQS puede recibir notificaciones de cuentas distintas?
  • ¿Cómo funciona EventBridge en comparación con SQS para las notificaciones de SP-API? Para los tipos de notificación que solo soportan EventBridge.

Catalog Items API ​

  • ¿Hay límite de ASINs por petición en SearchCatalogItems usando identifiers? El tutorial menciona 20 resultados por búsqueda de keyword, pero no específica para búsqueda por múltiples ASINs.
  • ¿Se pueden buscar productos de un marketplace en otro? ¿Cross-marketplace lookups?
  • ¿Qué versión de la API es la principal activa en 2026? (v0, 2020-12-01, o 2022-04-01).

PII y Acceso Restringido ​

  • ¿Cuánto dura el proceso de aprobación para PII en una app pública? El tutorial menciona 3 fases pero no indica tiempos.
  • ¿Cuántos RDTs se pueden solicitar en paralelo? Si procesas muchos pedidos, ¿hay un límite de tokens simultáneos?
  • ¿El RDT funciona para todos los pedidos o solo los recientes?

MCP y DataDo ​

  • ¿Cuánto cuesta la suscripción de DataDo? No se especifica en los tutoriales.
  • ¿Hay algún tier gratuito o de prueba en DataDo?
  • ¿El MCP oficial de Amazon tiene costes adicionales por encima de los fees de SP-API?
  • ¿Qué diferencias hay entre el MCP de DataDo y el MCP oficial de Amazon en términos de funcionalidades?

Apps y Desarrolladores ​

  • ¿Cuánto tarda Amazon en revisar y aprobar una aplicación pública (Listed)? El tutorial menciona un proceso de revisión pero no indica el tiempo.
  • ¿Qué ocurre con el acceso si no se renueva el fee anual de $1.400? ¿Se corta inmediatamente o hay periodo de gracia?
  • Para una Public Unlisted app, ¿cómo se hace onboarding a un nuevo vendedor? ¿Cómo les envías el link de autorización OAuth?

Técnicas y Buenas Prácticas ​

  • ¿Cuál es la mejor estrategia para gestionar secretos (LWA credentials) en producción? AWS Secrets Manager, HashiCorp Vault, variables de entorno en servidor... cuál es el enfoque más común.
  • ¿Hay alguna librería oficial o no oficial de Python para SP-API que sea estable en 2026? El tutorial menciona python-amazon-sp-api pero advierte que para producción es mejor hacer llamadas directas.
  • ¿Cómo se gestionan los timeouts en operaciones largas como feeds grandes? Si un feed tarda horas, ¿qué pasa con la conexión?

Este documento debe actualizarse conforme se investiguen y resuelvan las dudas. Marcar con tachado las dudas resueltas y añadir la respuesta en el documento correspondiente.

Documentación basada en más de 40 tutoriales sobre Amazon SP-API. Actualizada a junio de 2026.

Uso interno — Español de España