Configura tu clave API de App Store Connect para Appstead

Crea la clave API con Sales and Reports, descarga el archivo .p8 una vez y añade las credenciales que Appstead necesita para un workspace en vivo.

Un workspace en vivo en Appstead se conecta directamente con App Store Connect. Le das a Appstead una clave API con el rol Sales and Reports, y la app la usa para leer datos de tu app e informes de ventas. No hay cuenta de Appstead ni servidor de por medio.

Los workspaces en vivo forman parte de Appstead Pro. Si quieres probar la app antes de conectar una cuenta, el workspace demo integrado no necesita ninguna clave.

Qué necesitas

Appstead pide cuatro cosas al añadir un workspace en vivo:

• Una Issuer ID de App Store Connect
• Una Key ID de API
• El archivo de clave privada .p8
• Tu Vendor Number para informes de ventas

Antes de empezar

Necesitas una cuenta Admin en App Store Connect para generar Team Keys. Si inicias sesión con el rol Developer o App Manager, el botón Generate no aparece. Pide al Admin o Account Holder de tu equipo que cree la clave, o que te haga Admin.

La clave debe ser un Team Key, no un Individual Key. Apple no permite que Individual Keys accedan a datos de Sales and Finance, así que la validación de un Individual Key fallará en Appstead.

Crea una clave nueva para Appstead en lugar de reutilizar una de otra herramienta. La clave necesita el rol Sales and Reports. Es el nivel de acceso que Appstead usa para configurar el workspace en vivo.

Apple solo te deja descargar el archivo privado .p8 una vez. Mantenlo privado y a mano hasta importarlo. No lo subas a un repositorio de código ni lo envíes por email o chat.

1. Crear la clave API

1. Inicia sesión en App Store Connect y abre API Keys. Si navegas a mano: en Users and Access, pestaña Integrations, App Store Connect API.
2. Asegúrate de que la pestaña Team Keys esté seleccionada y elige Generate API Key o el botón Add (+).
3. Nombra la clave Appstead u otro nombre que reconozcas.
4. En Access elige Sales and Reports.
5. Elige Generate.

La guía de claves API de Apple describe el flujo y los roles actuales en detalle.

2. Copiar IDs y descargar el archivo .p8

En la página Team Keys reúne estas tres cosas:

• Issuer ID: el ID de toda la cuenta arriba en la página. Es el mismo para cada clave de la cuenta.
• Key ID: el ID en la fila de esta clave nueva.
• Private Key: elige Download API Key en esa fila para guardar el archivo .p8.

Key ID y archivo .p8 deben pertenecer a la misma clave API. El enlace de descarga desaparece cuando lo usas. Si ya no está, crea una clave de reemplazo. Apple no guarda otra copia del archivo privado.

3. Encontrar la Vendor Number

Appstead usa tu Vendor Number para solicitar informes de ventas. Abre Payments and Financial Reports en App Store Connect. El número aparece como Vendor # arriba a la izquierda. Es un número de toda la cuenta, no el Apple ID de una app.

4. Añadir workspace en vivo en Appstead

1. Abre Appstead, ve a Settings y elige Add Workspace. Si aún no tienes workspace, la pantalla vacía ofrece Add Live Workspace, y la Overview demo ofrece Connect App Store. Los tres abren el mismo formulario.
2. Si aún no tienes Appstead Pro, aparece primero la pantalla Pro. El formulario se abre cuando Pro está activo.
3. Pon un nombre al workspace que reconozcas, por ejemplo el nombre de tu estudio.
4. Pega Issuer ID y Key ID.
5. Elige Choose .p8 File y selecciona la clave privada descargada.
6. Introduce la Vendor Number.
7. Elige Validate & Save. Appstead comprueba las credenciales con Apple antes de guardar o importar nada.

Si ya configuraste este workspace en otro dispositivo con la misma cuenta de iCloud, Appstead puede encontrar las credenciales en iCloud Keychain y ofrecer continuar con ellas.

Qué pasa después de conectar

• La primera importación carga los últimos 90 días de informes de ventas diarios para que Overview y Trends se llenen de inmediato. Puedes seguir usando la app mientras importa.
• Las actualizaciones posteriores amplían el historial hasta el año móvil de informes diarios que Apple proporciona.
• Apple publica el informe de ayer normalmente hacia las 7 h hora del Pacífico. Hasta entonces falta el día más reciente, no es cero.
• Los últimos cinco días se vuelven a obtener en cada actualización y se muestran como provisionales porque Apple aún puede corregirlos.

Más de una cuenta de App Store Connect

Cada workspace de Appstead guarda las credenciales de una cuenta. Para una segunda cuenta, por ejemplo un cliente o un equipo antiguo, repite estos pasos con una clave bajo esa cuenta y añádela como workspace propio. Cambias de workspace con un toque.

Si la descarga .p8 falla en iPhone o iPad

La descarga de Apple puede fallar en iPhone o iPad. Descarga el archivo en un Mac, transfiérelo con AirDrop o Archivos e impórtalo en Appstead. Borra copias temporales cuando la importación funcione.

Si Appstead no puede validar la clave

Si Apple rechaza las credenciales, comprueba en orden:

• Issuer ID y Key ID no tienen espacios de más.
• El archivo .p8 elegido pertenece a esa Key ID.
• La clave es un Team Key con rol Sales and Reports y no está revocada.
• La Vendor Number pertenece a la cuenta de App Store Connect que añades.

Si Appstead indica que las credenciales funcionan pero falta un acuerdo, App Store Connect aceptó la clave pero tu Account Holder aún debe aceptar un acuerdo requerido antes de entregar informes de ventas. Acéptalo en la página Agreements de App Store Connect e inténtalo de nuevo.

Quitar workspace o revocar la clave

Para desconectar, abre el workspace en Settings y elige Remove Workspace. Puedes quitarlo solo de este dispositivo, dejándolo en otros, o de todos los dispositivos.

Quitar un workspace no revoca la clave en Apple. Si el archivo .p8 se expuso o ya no lo necesitas, revoca la clave en la página Team Keys de App Store Connect. Una clave revocada deja de funcionar en Appstead al instante. Crea una nueva antes de revocar si quieres mantener el workspace.

Tu clave sigue siendo privada

Appstead guarda la clave privada de este workspace en Keychain. La app no envía tu clave API, datos de ventas ni métricas de negocio a ningún servidor de Appstead.