Tipos de Apps y Perfiles de Desarrollador en Amazon SP-API

Resumen rápido

Antes de crear tu app, debes decidir qué tipo de desarrollador y qué tipo de app necesitas. La elección define cuántos vendedores puedes conectar, si puedes aparecer en el Amazon App Store, y qué datos restringidos puedes solicitar. Si solo construyes para ti mismo, empieza con una app privada. Si quieres ofrecer tu solución a otros vendedores, necesitas una app pública.

---

Conceptos importantes

• Perfil de desarrollador privado: Para usar la API solo con tus propias cuentas de vendedor. Sin posibilidad de conectar cuentas de terceros.
• Perfil de desarrollador público: Para construir SaaS u otras soluciones que conecten cuentas de otros vendedores. Requiere más información durante el registro.
• App privada: App asociada a un perfil privado. Solo conecta tus propias cuentas. Más fácil de aprobar.
• App pública no listada (unlisted): App asociada a un perfil público, pero no aparece en el Amazon App Store. Límite de 25 autorizaciones de otros vendedores.
• App pública listada (listed): App publicada en el Amazon App Store. Sin límite de autorizaciones de vendedores.
• Self-authorizations: Autorizaciones de tus propias cuentas de vendedor (máximo 10 en cualquier tipo de app).
• Other authorizations: Autorizaciones de cuentas de otros vendedores (solo disponible en apps públicas).
• Amazon App Store / Amazon Seller Central Partner Network: El marketplace donde aparecen las apps públicas listadas.

---

Cómo funciona

Tabla comparativa

Característica	App Privada	App Pública Unlisted	App Pública Listed
Self-authorizations	10	10	10
Other authorizations (vendedores)	0	25	Ilimitadas
Other authorizations (vendors)	0	Ilimitadas	Ilimitadas
Aparece en App Store	No	No	Sí
Dificultad de aprobación	Baja	Media	Alta
Ideal para	Uso propio	MVP / pruebas	SaaS en producción
Posibilidad de PII	Sí (proceso más fácil)	Sí (proceso medio)	Sí (proceso muy difícil)

Proceso de registro

Para perfil privado:

1. Seller Central → Apps y Servicios → Desarrollar apps.
2. Rellenar el formulario de desarrollador.
3. Esperar aprobación de Amazon (normalmente rápido).

Para perfil público:

1. Mismo proceso, pero el formulario tiene más preguntas.
2. Amazon pregunta qué funcionalidades tendrá la app, cómo beneficia a otros vendedores, si tienes política de privacidad en tu web, etc.
3. El proceso es similar en dificultad al privado, pero requiere más información.
4. Recomendación: si sabes que eventualmente vas a necesitar conectar varias cuentas, regístrate directamente como público para no tener que cambiarlo después.

Para pasar de unlisted a listed (publicar en App Store):

1. Abrir un caso en Amazon una vez la app esté lista.
2. Proporcionar: nombre de la app, descripción de características, marketplaces soportados, email de soporte, precios, si es gratuita, etc.
3. Tras aprobación, la app aparece en el App Store con la posibilidad de conectar vendedores ilimitados.

---

Pasos prácticos

Cómo saber qué tipo de app necesitas

Responde estas preguntas:

1. ¿La app es solo para TU cuenta de vendedor? → Privada
2. ¿Quieres conectar las cuentas de entre 2 y 10 vendedores (clientes de una agencia, por ejemplo)? → Privada (usando las 10 self-authorizations) o Pública Unlisted
3. ¿Quieres un MVP con hasta 25 vendedores externos para validar? → Pública Unlisted
4. ¿Quieres vender tu solución SaaS a decenas o cientos de vendedores? → Pública Listed

Cómo funciona la autorización de terceros

Cuando un vendedor externo quiere conectar su cuenta a tu app:

1. Le envías (o muestras en tu app) un enlace de autorización generado por Amazon.
2. El vendedor hace clic, accede a su Seller Central y acepta los permisos.
3. Amazon te devuelve un authorization_code que conviertes en un refresh_token de esa cuenta.
4. Con ese token, ya puedes acceder a los datos de ese vendedor desde tu app.

Este flujo OAuth es el que distingue las apps públicas de las privadas. En apps privadas, autorizas directamente desde tu cuenta sin necesidad de un flujo OAuth para terceros.

---

Errores comunes

• Empezar con perfil privado y luego necesitar público: Aunque es posible cambiarlo, es más cómodo pensar bien desde el principio.
• Suponer que con app privada puedes conectar múltiples cuentas sin límite: El límite es 10 self-authorizations.
• Confundir "unlisted" con "privada": Una app unlisted es pública (puede conectar cuentas de terceros), simplemente no está en el App Store.
• No tener política de privacidad para el perfil público: Amazon la requiere. Necesitas una URL donde los usuarios puedan ver cómo manejas sus datos.

---

Qué debo saber antes de programarlo

• El tipo de app no afecta a qué endpoints puedes usar, sino a cuántas cuentas puedes conectar.
• Si construyes un SaaS, implementa desde el principio el flujo OAuth de autorización para que los vendedores puedan conectar sus cuentas con un clic.
• Para acceder a datos sensibles (direcciones de envío, información fiscal), necesitas además el acceso PII/RDT por separado. Ver 04-acceso-pii-y-rdt.md.
• Amazon puede rechazar tu solicitud de perfil o de listado. En ese caso, te envía un email indicando qué falta. Puedes reenviar la solicitud corregida.
• Para aplicaciones públicas con PII, el proceso de aprobación es notablemente más difícil (puede implicar una entrevista técnica con Amazon y hasta 6 meses de tramitación).

---

Pendiente de revisar

• ¿Cuáles son exactamente las preguntas del formulario para perfil público? ¿Ha cambiado en 2025/2026?
• ¿Hay límite de veces que puedes solicitar el perfil antes de ser bloqueado permanentemente?
• Confirmar si el límite de 10 self-authorizations aplica también a apps públicas listadas.