API de App Store Connect
Número de proveedor de App Store Connect y la API salesReports
Cada solicitud de informes de ventas a la API de App Store Connect necesita un número en el que la mayoría de los desarrolladores nunca se ha fijado: el número de proveedor. Aquí tienes dónde está, qué clave puede usarlo y cómo convertir `GET /v1/salesReports` en ventas por país con las que puedas trabajar de verdad.
Dónde encontrar tu número de proveedor
Tu número de proveedor está en Pagos e informes financieros. Inicia sesión en App Store Connect, abre Pagos e informes financieros, selecciona Informes en la parte superior de la página y el número aparece en la esquina superior izquierda, bajo el nombre de tu entidad legal. La API lo espera como filter[vendorNumber] (ayuda de Apple).
- Inicia sesión en App Store Connect con el rol de titular de la cuenta, Admin o Finance: los roles que Apple indica para Pagos e informes financieros.
- Abre Pagos e informes financieros.
- Selecciona Informes en la parte superior de la página.
- Lee el número de proveedor bajo el nombre de tu entidad legal, arriba a la izquierda, y cópialo.
Dos atajos. Si alguna vez has descargado un informe de ventas desde Tendencias → Informes de ventas y tendencias, el número de proveedor está en el nombre del archivo: los archivos de resumen diario se llaman S_D_<vendor number>_<date>, por ejemplo S_D_80012345_20130919 (nombres de archivo de los informes). Y si solo tienes el rol Sales, pide a alguien con el rol Admin o Finance que lo lea por ti, ya que se muestra en la página financiera.
Más de un número de proveedor
El menú junto al nombre de tu proveedor puede mostrar varios números de proveedor. Apple asigna uno nuevo cuando cambias el nombre de tu entidad legal, y otros distintos para los acuerdos de Apple News+ o Apple Arcade. Los informes se dividen por número de proveedor, así que tras un cambio de nombre legal necesitas el número nuevo para las ventas nuevas y el antiguo para el historial.
Qué roles pueden leer los informes de ventas
Intervienen dos permisos distintos: ver el número de proveedor (Pagos e informes financieros) y leer Sales and Trends. La clave de API que descarga los informes necesita el segundo. Según los permisos de los roles y las páginas de ayuda de Apple:
| Rol | Informes de Sales and Trends | Pagos e informes financieros | Cambiar precios |
|---|---|---|---|
| Admin | Sí | Sí | Sí |
| Finance | Sí | Sí | No |
| Sales | Sí | No | No |
| App Manager | Apple no lo indica | No | Sí |
| Developer, Marketing, Customer Support | No | No | No |
Apple sugiere el rol Sales (su documentación de la API lo llama Sales and Reports) para una clave que entregas a un tercero que solo analiza informes: puede llamar a GET /v1/salesReports, pero no al endpoint de informes financieros (nota de Apple). Si una misma clave debe leer ventas y cambiar precios, el único rol de clave que hace ambas cosas es Admin. La alternativa son dos claves, App Manager para los precios y Sales para los informes, que es más ordenado si tu herramienta lo admite. Cómo crear cada una está en crear una clave de API.
Tipos de informe de Sales and Trends
GET /v1/salesReports sirve todos los informes descargables de Sales and Trends. Cada tipo solo acepta ciertas combinaciones de subtipo, frecuencia y versión; cualquier otra da error. Las combinaciones válidas, según la referencia del endpoint de Apple:
| reportType | reportSubType | frequency | version |
|---|---|---|---|
SALES | SUMMARY | DAILY, WEEKLY, MONTHLY, YEARLY | 1_0 |
PRE_ORDER | SUMMARY | DAILY, WEEKLY, MONTHLY, YEARLY | 1_0 |
SUBSCRIPTION | SUMMARY | DAILY | 1_3 |
SUBSCRIPTION_EVENT | SUMMARY | DAILY | 1_3 |
SUBSCRIBER | DETAILED | DAILY | 1_3 |
SUBSCRIPTION_OFFER_CODE_REDEMPTION | SUMMARY | DAILY | 1_0 |
WIN_BACK_ELIGIBILITY | SUMMARY | DAILY | 1_0 |
NEWSSTAND | DETAILED | DAILY, WEEKLY | 1_0 |
FIRST_ANNUAL | DETAILED / SUMMARY | DAILY / YEARLY | 1_0 |
Para las ventas por país, el que te interesa es SALES / SUMMARY: unidades, precios e ingresos agregados de apps y compras dentro de la app, con una fila por producto, país, precio y tipo de transacción. La frecuencia diaria es la más útil, porque puedes reconstruir cualquier periodo a partir de días, y los días son lo que necesitas para ver el efecto de un cambio de precio.
Descargar un informe de ventas con GET /v1/salesReports
| Parámetro | Obligatorio | Valor para un informe de ventas diario | Notas |
|---|---|---|---|
filter[vendorNumber] | Sí | 85012345 (el tuyo) | De Pagos e informes financieros. |
filter[reportType] | Sí | SALES | Consulta la tabla anterior para otros tipos. |
filter[reportSubType] | Sí | SUMMARY | Debe coincidir con el tipo de informe. |
filter[frequency] | Sí | DAILY | DAILY, WEEKLY, MONTHLY o YEARLY. |
filter[reportDate] | No | 2026-11-09 | Apple documenta AAAA-MM-DD y dice que DAILY no requiere fecha. Envía una de todos modos para saber qué día recibes. |
filter[version] | No | 1_0 | La versión que Apple indica para el tipo de informe. |
- Crea una clave de API de equipo con el rol Admin, Finance o Sales y guarda su Issuer ID, su Key ID y el archivo
.p8. - Firma un JWT con la clave (generar tokens). En la mayoría de las solicitudes, Apple rechaza los tokens que duran más de 20 minutos, así que crea uno nuevo para cada lote.
- Pide el día:
GET https://api.appstoreconnect.apple.com/v1/salesReports?filter[frequency]=DAILY&filter[reportType]=SALES&filter[reportSubType]=SUMMARY&filter[vendorNumber]=85012345&filter[reportDate]=2026-11-09&filter[version]=1_0, conAuthorization: Bearer <token>yAccept: application/a-gzip. Codifica los corchetes en la URL si tu cliente HTTP no lo hace. - El cuerpo de la respuesta 200 es gzip (
application/a-gzip). Descomprímelo; con curl, guárdalo en un archivo y ejecutagunzip. - Ahora tienes texto separado por tabuladores: una fila de encabezado y después una fila por producto, país, precio y tipo de transacción. Analiza las columnas por el nombre del encabezado, no por la posición.
- Guarda el día. Apple conserva los informes diarios solo durante un año, así que lo que quieras comparar año contra año tienes que guardarlo tú.
- Repite para cada día que necesites, sin pasarte de ritmo: cada respuesta lleva una cabecera
X-Rate-Limitcon las solicitudes por hora que te quedan (límites de frecuencia).
Los informes semanales, mensuales y anuales funcionan igual con otra frecuencia. Los ejemplos de nombres de archivo de Apple fechan un informe semanal en domingo y dan a los archivos mensuales y anuales solo el mes o el año, lo que sirve para comprobar qué periodo has recibido. Recuerda que sumar 30 archivos diarios te da un mes que puedes cortar como quieras; un archivo mensual no te da los días.
El formato del archivo y las columnas que importan
La referencia de campos del Summary Sales Report documenta todas las columnas (describe la versión 1_3 del diseño; Apple añade columnas con el tiempo, otra razón para identificarlas por el nombre del encabezado). Las que necesitas para las ventas por país:
| Columna | Qué contiene | Para qué usarla |
|---|---|---|
| Apple Identifier | El Apple ID de la app o de la compra dentro de la app | Enlazar con tus productos en la API |
| SKU / Parent Identifier | Tu SKU; en las compras dentro de la app, Parent Identifier es el SKU de la app | Agrupar las compras dentro de la app bajo su app |
| Title | Nombre de la app en las descargas, ID de producto en las compras dentro de la app | Etiquetas |
| Product Type Identifier | El tipo de transacción, como 1F o IAY | Separar descargas, compras, actualizaciones y redescargas |
| Units | Unidades agregadas; negativas en los reembolsos | Contar descargas y compras |
| Developer Proceeds | Lo que recibes por unidad, tras impuestos y la comisión de Apple | Ingresos = Units × Developer Proceeds |
| Customer Price / Customer Currency | El precio por unidad que se cobró al cliente y su divisa | Comprobar el precio que la gente pagó de verdad |
| Country Code | Código de dos letras del país o la región del App Store de la compra | El desglose por país |
| Currency of Proceeds | La divisa de la cifra de Developer Proceeds | Convertir antes de comparar países |
| Subscription / Period | Nueva o renovación, y la duración de la suscripción | Distinguir suscriptores nuevos de renovaciones |
Los identificadores de tipo de producto clasifican las filas (lista completa): 1, 1F, 1T y F1 son descargas de apps, gratuitas o de pago; 3 y 3F son redescargas; 7, 7F, 7T y F7 son actualizaciones; IA1, IA9, IAY, FI1 y sus variantes -M son compras dentro de la app y suscripciones; IA3 es una compra no consumible restaurada.
- Developer Proceeds es por unidad. Multiplica por Units antes de sumar filas.
- Los reembolsos tienen Units negativas y Developer Proceeds positivos, así que Units × Developer Proceeds los resta correctamente.
- Deja fuera las actualizaciones y las redescargas antes de contar descargas: son gratuitas y suelen superar con mucho a las descargas reales.
- El mismo producto y país pueden aparecer en varias filas (precios, dispositivos o códigos promocionales distintos). Súmalas.
- Los días van de medianoche a medianoche, hora del Pacífico, no UTC.
- Los importes están en divisas locales. Convierte con un único conjunto de tipos antes de ordenar los países; ventas por país explica cómo hacer una comparación justa.
Cuándo están listos los informes y cuánto duran
Según la página de disponibilidad de Apple: los informes diarios están disponibles al día siguiente, los semanales los lunes, los mensuales cinco días después de terminar el mes y los anuales seis días después de terminar el año, por lo general antes de las 8 a. m., hora del Pacífico. Los informes diarios, semanales y mensuales se conservan durante un año; los anuales, diez. Un Summary Sales Report solo existe para un periodo con al menos una unidad de app vendida, así que un día sin ventas simplemente no tiene archivo.
Errores habituales de salesReports
| Respuesta | Qué suele significar | Qué hacer |
|---|---|---|
400 PARAMETER_ERROR.REQUIRED | Falta un filtro obligatorio, p. ej. “The parameter 'filter[vendorNumber]' is required but was not provided” | Envía los cuatro filtros obligatorios. |
| 400 (otros) | Una combinación que Apple no ofrece: un subtipo, una frecuencia o una versión que no corresponde al tipo de informe | Comprueba tus valores con la tabla de valores permitidos de arriba. |
401 NOT_AUTHORIZED | El token está mal formado, ha caducado o se firmó con una clave revocada | Crea un token nuevo; comprueba que el Key ID, el Issuer ID y el .p8 van juntos. |
| 403 | El rol de la clave no puede leer informes de ventas | Usa una clave con el rol Admin, Finance o Sales. |
| 404 | No hay informe para esa fecha: aún no se ha publicado, no se vendió nada ese día o es más antiguo de lo que Apple conserva | Trátalo como “sin datos” y reintenta los días recientes más tarde. |
| 429 | Se ha alcanzado el límite de frecuencia por hora de esta clave | Espera y reanuda; reparte las descargas históricas en el tiempo. |
500 UNEXPECTED_ERROR | Falló el servidor de Apple. Cuando enviamos un número de proveedor que no pertenecía al equipo de la clave, esto fue lo que devolvió en lugar de un mensaje claro | Reintenta una vez; si persiste, revisa primero el número de proveedor. |
Cómo usa RepriceCat tu número de proveedor
RepriceCat cambia los precios con tu clave de App Store Connect; con tu número de proveedor también puede ver qué hacen esos precios. Añádelo en Ajustes → Informes de ventas. Tu clave necesita el rol Admin, Finance o Sales para leer informes, así que Admin si la misma clave también cambia precios. A partir de ahí, RepriceCat descarga los informes diarios SALES / SUMMARY de Apple, cada día una vez, y guarda solo los totales diarios por producto y país. Las actualizaciones y las redescargas se dejan fuera.
- La pantalla Sales: unidades, descargas, compras, ingresos (en USD a los tipos de hoy), peso y tendencia por país, con un mapa del mundo, gráficos diarios y por día de la semana y filtros por app y producto.
- Sugerencias de precios, como países con muchas descargas pero pocas compras, o que compran mucho más a menudo que la media.
- El impacto de cada cambio de precio en Actividad: unidades e ingresos antes y después del cambio, por producto y país.
- Experimentos: cambia el precio en unos pocos países, deja el resto como comparación y conserva o revierte el resultado (cómo hacer una prueba de precios).
Si prefieres no mantener tú mismo el script de descarga y análisis, compara RepriceCat con los scripts de API o empieza con un mes gratis.
Preguntas frecuentes
¿Dónde encuentro mi número de proveedor en App Store Connect?
Abre Pagos e informes financieros, selecciona Informes en la parte superior y lee el número en la esquina superior izquierda, bajo el nombre de tu entidad legal. También aparece en el nombre de archivo de cualquier informe de ventas que hayas descargado, como S_D_80012345_20130919.
¿El número de proveedor es lo mismo que mi Team ID o el Apple ID de la app?
No. El número de proveedor está ligado a tu entidad legal en Pagos e informes financieros. El Team ID y los Apple ID de las apps son identificadores distintos y no sirven como filter[vendorNumber].
¿Qué rol necesita una clave de API para descargar informes de ventas?
Admin, Finance o Sales. App Manager puede cambiar precios, pero no es uno de los roles que Apple indica para Sales and Trends, así que una sola clave que haga ambas cosas necesita Admin.
¿Por qué GET /v1/salesReports devuelve 404?
No hay informe para esa fecha: el día aún no se ha publicado, no se vendió nada ese día o la fecha es más antigua que el año que Apple conserva los informes diarios. Trátalo como sin datos y reintenta los días recientes más tarde.
¿Hasta cuándo puedo descargar informes de ventas del App Store?
Los informes diarios, semanales y mensuales se conservan un año desde que están disponibles, y los anuales diez años. Guarda tú los archivos si necesitas un historial diario más largo.
¿Qué versión debo usar para el informe de ventas diario?
La referencia del endpoint de Apple indica la versión 1_0 para SALES y SUMMARY. Analiza el archivo por nombres de columna y no por posiciones, porque Apple añade columnas entre versiones del diseño.
Pruébalo
Cambia el precio en todos los territorios a partir de un solo precio base
Niveles, ajuste a puntos de precio, una tabla de revisión y una sola confirmación, mediante la API de App Store Connect. Primer mes gratis y después $1 por app al mes.