Saltar al contenido

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.

Actualizado el 9 min de lectura

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).

  1. 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.
  2. Abre Pagos e informes financieros.
  3. Selecciona Informes en la parte superior de la página.
  4. 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:

RolInformes de Sales and TrendsPagos e informes financierosCambiar precios
AdminSíSíSí
FinanceSíSíNo
SalesSíNoNo
App ManagerApple no lo indicaNoSí
Developer, Marketing, Customer SupportNoNoNo

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.

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:

reportTypereportSubTypefrequencyversion
SALESSUMMARYDAILY, WEEKLY, MONTHLY, YEARLY1_0
PRE_ORDERSUMMARYDAILY, WEEKLY, MONTHLY, YEARLY1_0
SUBSCRIPTIONSUMMARYDAILY1_3
SUBSCRIPTION_EVENTSUMMARYDAILY1_3
SUBSCRIBERDETAILEDDAILY1_3
SUBSCRIPTION_OFFER_CODE_REDEMPTIONSUMMARYDAILY1_0
WIN_BACK_ELIGIBILITYSUMMARYDAILY1_0
NEWSSTANDDETAILEDDAILY, WEEKLY1_0
FIRST_ANNUALDETAILED / SUMMARYDAILY / YEARLY1_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ámetroObligatorioValor para un informe de ventas diarioNotas
filter[vendorNumber]Sí85012345 (el tuyo)De Pagos e informes financieros.
filter[reportType]SíSALESConsulta la tabla anterior para otros tipos.
filter[reportSubType]SíSUMMARYDebe coincidir con el tipo de informe.
filter[frequency]SíDAILYDAILY, WEEKLY, MONTHLY o YEARLY.
filter[reportDate]No2026-11-09Apple 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]No1_0La versión que Apple indica para el tipo de informe.
  1. 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.
  2. 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.
  3. 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, con Authorization: Bearer <token> y Accept: application/a-gzip. Codifica los corchetes en la URL si tu cliente HTTP no lo hace.
  4. El cuerpo de la respuesta 200 es gzip (application/a-gzip). Descomprímelo; con curl, guárdalo en un archivo y ejecuta gunzip.
  5. 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.
  6. 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ú.
  7. Repite para cada día que necesites, sin pasarte de ritmo: cada respuesta lleva una cabecera X-Rate-Limit con 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:

ColumnaQué contienePara qué usarla
Apple IdentifierEl Apple ID de la app o de la compra dentro de la appEnlazar con tus productos en la API
SKU / Parent IdentifierTu SKU; en las compras dentro de la app, Parent Identifier es el SKU de la appAgrupar las compras dentro de la app bajo su app
TitleNombre de la app en las descargas, ID de producto en las compras dentro de la appEtiquetas
Product Type IdentifierEl tipo de transacción, como 1F o IAYSeparar descargas, compras, actualizaciones y redescargas
UnitsUnidades agregadas; negativas en los reembolsosContar descargas y compras
Developer ProceedsLo que recibes por unidad, tras impuestos y la comisión de AppleIngresos = Units × Developer Proceeds
Customer Price / Customer CurrencyEl precio por unidad que se cobró al cliente y su divisaComprobar el precio que la gente pagó de verdad
Country CodeCódigo de dos letras del país o la región del App Store de la compraEl desglose por país
Currency of ProceedsLa divisa de la cifra de Developer ProceedsConvertir antes de comparar países
Subscription / PeriodNueva o renovación, y la duración de la suscripciónDistinguir 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

RespuestaQué suele significarQué hacer
400 PARAMETER_ERROR.REQUIREDFalta 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 informeComprueba tus valores con la tabla de valores permitidos de arriba.
401 NOT_AUTHORIZEDEl token está mal formado, ha caducado o se firmó con una clave revocadaCrea un token nuevo; comprueba que el Key ID, el Issuer ID y el .p8 van juntos.
403El rol de la clave no puede leer informes de ventasUsa una clave con el rol Admin, Finance o Sales.
404No 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 conservaTrátalo como “sin datos” y reintenta los días recientes más tarde.
429Se ha alcanzado el límite de frecuencia por hora de esta claveEspera y reanuda; reparte las descargas históricas en el tiempo.
500 UNEXPECTED_ERRORFalló 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 claroReintenta 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.