Exportar estados de regalías a CSV

Descargue sus estados de regalías como archivos CSV para analizar ingresos en una hoja de cálculo, prepararse para la temporada de impuestos o mantener registros financieros detallados.

Antes de comenzar

• Debe tener al menos un estado de regalías pagado (los estados aparecen después de procesar su primer pago)
• Una aplicación de hojas de cálculo como Excel, Google Sheets o Numbers para abrir el archivo CSV

---

Descargar un estado

1. Vaya a Regalías desde el menú principal
2. Navegue a la pestaña Estados
3. Encuentre el período de estado que desea descargar
4. Haga clic en el botón de descarga (ícono de flecha) junto al estado

El sistema generará su archivo CSV. Para estados más pequeños, la descarga comienza inmediatamente. Para estados más grandes, verá un indicador de progreso mientras se prepara el archivo.

Consejo

Use el menú Descargar Por Año en la parte superior para exportar todos los estados de un año completo en un solo archivo. Esto es útil para la preparación anual de impuestos.

---

Qué sucede durante la exportación

Descargas instantáneas

Para la mayoría de los estados, el CSV está listo instantáneamente. Aparece un diálogo con un botón Descargar para guardar el archivo.

Procesamiento de estados grandes

Para estados con muchos elementos de línea, el sistema procesa la exportación en segundo plano:

1. Aparece un diálogo “Preparando Exportación”
2. El sistema genera el archivo (esto puede tomar unos momentos)
3. Una vez listo, aparece un botón Descargar
4. Haga clic en Descargar para guardar el archivo

Nota

Solo puede ejecutarse una exportación a la vez. Si ve un mensaje de “Exportación en Progreso”, espere a que termine la exportación actual antes de iniciar otra.

Qué recibe

La descarga es un archivo ZIP que contiene:

• el archivo CSV (o varios archivos CSV, si la exportación fue lo bastante grande como para dividirse)
• COLUMNS.txt, una referencia en texto plano que describe cada columna del archivo

Cada exportación generada se conserva durante 24 horas. Si vuelve a solicitar una exportación con la misma cuenta, el mismo rango de fechas y la misma agrupación dentro de ese plazo, recibirá el archivo ya generado en lugar de uno nuevo.

---

Referencia de columnas CSV

Cada fila en el CSV representa un único elemento de línea de su estado de regalías. Aquí está el significado de cada columna.

Columnas básicas

Columna	Descripción	Ejemplo
pay_period	Período de pago en formato YYYYMM	202601
label	Nombre de su sello	Midnight Records
retailer	Nombre de la plataforma	Spotify
territory	Código de país o región	US, GB, DE
type	Tipo de transacción	Stream, Download, UGC
cat	Número de catálogo	MR-2026-001
upc	Código de barras UPC del lanzamiento	840123456789
release	Título del lanzamiento	Neon Skyline
isrc	Código ISRC de la pista (un identificador único para cada pista)	USRC12400001
track_artist	Nombre del artista	Luna Rivera
track_title	Título de la pista	Golden Hour
track_version	Información de versión o remix (vacío si no hay)	Acoustic Version
track_count	Número de pistas	1
purchase_qty	Número de streams o ventas	4523
dsp_transaction_date	Fecha de transacción de la plataforma	2026-01-15
dsp_statement_id	ID de referencia del estado	SP-2026-0001

Columnas de ingresos

Los ejemplos siguientes muestran una línea de streaming estándar y una línea UGC.

Columna	Descripción	Línea de streaming	Línea UGC
gross_usd	Ingresos brutos en USD de esa línea, antes de las comisiones de LabelGrid	18.09000000	4.63000000

Columnas de comisiones de LabelGrid

Columna	Descripción	Línea de streaming	Línea UGC
platform_fee_rate	Tasa de comisión de plataforma de su plan	0.05000000 (5%)	0.00000000
platform_fee_usd	Monto de la comisión de plataforma (mostrado como valor negativo)	-0.90450000	0.00000000
ugc_fee_rate	Tasa de comisión de UGC / Content ID de su plan	0.00000000	0.20000000 (20%)
ugc_fee_usd	Monto de la comisión de UGC / Content ID (mostrado como valor negativo)	0.00000000	-0.92600000
total_labelgrid_fee	Las dos comisiones sumadas (valor negativo)	-0.90450000	-0.92600000
net_revenue_usd	Sus ganancias finales después de todas las comisiones de LabelGrid	17.18550000	3.70400000

Nota

Las tasas se determinan por estado. Todas las líneas de un mismo estado llevan el mismo platform_fee_rate y el mismo ugc_fee_rate.

---

Especificación técnica

Si está integrando este CSV en software contable o un backend financiero, aquí están los detalles exactos del formato.

Propiedad	Valor
Codificación	UTF-8
Delimitador	Coma (,)
Carácter de comillas	Comillas dobles (")
Carácter de escape	Barra invertida (\)
Fin de línea	LF (\n)
Fila de encabezado	Siempre presente como primera fila
Total de columnas	23 (orden fijo, ver referencia de columnas arriba)
Entrega	Archivo ZIP que contiene el CSV más un archivo de referencia COLUMNS.txt

Tipos de datos y precisión

Grupo de columnas	Tipo	Precisión
pay_period	String	YYYYMM (6 caracteres)
dsp_transaction_date	String	YYYY-MM-DD (10 caracteres)
purchase_qty	Entero	Número entero
gross_usd, *_fee_usd, net_revenue_usd	Decimal	Hasta 8 decimales
platform_fee_rate, ugc_fee_rate	Decimal	Hasta 8 decimales (ej., 0.05000000 = 5%)
Todas las demás columnas	String	Longitud variable

Consejo

Los montos de comisiones son siempre valores negativos (son deducciones). Las columnas de tasas son fracciones decimales, no porcentajes: multiplique por 100 para obtener el porcentaje.

Fórmulas de ingresos

total_labelgrid_fee = platform_fee_usd + ugc_fee_usd
net_revenue_usd     = gross_usd + total_labelgrid_fee

Notas para procesamiento automatizado

• Campos vacíos: track_version y cat pueden estar vacíos (dos comas consecutivas)
• Entrecomillado de texto: Los campos que contienen comas o comillas se encierran entre comillas dobles. Las comillas dobles dentro de los valores de campo se eliminan durante la exportación.
• Exportaciones grandes: Las exportaciones de más de 150 MB se dividen en múltiples archivos CSV (cada uno con su propia fila de encabezado) y se entregan como archivo ZIP
• Ordenamiento: Las filas se ordenan por pay_period descendente, luego por dsp_transaction_date descendente

---

Entender las comisiones en el CSV

Cómo se calculan los ingresos netos

net_revenue_usd = gross_usd + total_labelgrid_fee

Como las comisiones son valores negativos, reducen su monto bruto. Esta es una línea de streaming completa del archivo de muestra, con una comisión de plataforma del 5%:

	Monto
Ingresos brutos (gross_usd)	$18.09000000
Comisión de plataforma (5%)	-$0.90450000
Comisión de UGC / Content ID	$0.00000000
Ingresos netos	$17.18550000

La comisión de plataforma y la comisión UGC son categorías independientes que no se acumulan

Este es el punto que más conviene entender bien si va a llevar su contabilidad a partir de esta exportación.

• Ambas tasas se cobran sobre el mismo importe.
• Ninguna de las dos comisiones se cobra sobre el resultado de la otra. La comisión de UGC no se aplica a lo que queda tras la comisión de plataforma, ni la comisión de plataforma a lo que queda tras la comisión de UGC.
• Los dos importes se suman: total_labelgrid_fee = platform_fee_usd + ugc_fee_usd.

A continuación, un ejemplo resuelto de una línea de un estado que lleva los dos tipos de comisión, con una tasa de plataforma del 5% y una tasa de UGC del 20% sobre ese mismo importe de $100.00000000:

Cálculo	Correcto (se suman)	Incorrecto (en cascada)
Comisión de plataforma	-$5.00000000	-$5.00000000
Comisión de UGC / Content ID	-$20.00000000 (20% de $100.00)	-$19.00000000 (20% de $95.00)
Comisión total de LabelGrid	-$25.00000000	-$24.00000000

La columna de la izquierda es la que cuadra. Una tasa de plataforma del 5% y una tasa de UGC del 20% suman una deducción del 25% sobre ese mismo importe, no el 24% que resultaría de aplicar una tasa sobre lo que queda tras la otra.

Cuándo aparece cada comisión

La comisión de UGC / Content ID se aplica a los ingresos por contenido generado por los usuarios en plataformas como YouTube, TikTok y SoundCloud. En las líneas de plataformas de streaming estándar como Spotify o Apple Music, ugc_fee_rate y ugc_fee_usd muestran 0.00.

Como las tasas se determinan por estado, en la mayoría de las líneas una tasa tiene valor y la otra es cero: un estado suele contener un solo tipo de ingreso. Si un estado sí contiene los dos tipos, ambas tasas aparecen en todas sus líneas y se aplica la regla de suma anterior. No dé por hecho que solo una de las dos columnas de tasa es distinta de cero; lea las que tengan valor y súmelas.

Aviso de inclusión de comisiones

Las comisiones se incluyen en las exportaciones CSV a partir del período de estado de octubre de 2024. Los estados anteriores muestran datos de ingresos sin las columnas de desglose de comisiones.

Comisiones en la API de estados

Si consulta los estados a través de la API pública en lugar de la exportación CSV, los endpoints de estados devuelven el mismo desglose en tres campos adicionales:

Campo	Descripción
platform_fee_usd	Comisión de distribución estándar cobrada en el estado
ugc_fee_usd	Comisión de UGC / Content ID cobrada en el estado
labelgrid_ugc_rate	Tarifa de la comisión de UGC / Content ID vigente cuando se generó el estado

Ambos importes son negativos y suman labelgrid_fee. Las comisiones se calculan sobre el importe total liquidado en el estado, que incluye cualquier saldo trasladado de períodos anteriores, por lo que multiplicar una tarifa únicamente por las ganancias de ese período no siempre coincide con el importe: tome los importes como cifras de referencia.

Cualquiera de los tres campos puede ser null, sobre todo en los estados generados antes de que se registrara el desglose. No van siempre juntos:

• platform_fee_usd y ugc_fee_usd están siempre ambos presentes o ambos en null; nunca aparece uno sin el otro.
• labelgrid_ugc_rate se guarda por separado y es independiente de esa pareja: puede ser null en un estado que sí trae ambos importes, y puede tener valor en un estado en el que ambos importes son null.

Lea cada campo por su cuenta en lugar de deducir uno a partir de otro. Interprete null como «sin desglosar», no como cero, y siga usando labelgrid_fee como total de comisiones en todos los casos.

---

Descargar un CSV de muestra

¿Quiere ver cómo se ve la exportación antes de descargar la suya? Descargue nuestro archivo de muestra:

Descargar CSV de muestra

La muestra contiene datos de ejemplo que muestran elementos de línea típicos en múltiples plataformas y territorios, con la estructura de 23 columnas descrita arriba. Todas sus filas cumplen las fórmulas de este artículo, así que puede usarla como archivo de prueba al desarrollar su integración.

---

Consejos para trabajar con los datos

Abrir en Google Sheets

1. Vaya a Google Sheets
2. Haga clic en Archivo → Importar
3. Suba su archivo CSV
4. Seleccione “Coma” como separador
5. Haga clic en Importar datos

Abrir en Excel

1. Abra Excel
2. Haga clic en Archivo → Abrir y seleccione el archivo CSV
3. Excel detectará automáticamente el formato separado por comas

Ideas de análisis comunes

• Filtrar por retailer para ver ganancias por plataforma
• Tabla dinámica por territory para encontrar sus mercados más fuertes
• Sumar net_revenue_usd para verificar el monto total de su estado
• Ordenar por purchase_qty para encontrar sus pistas más reproducidas
• Agrupar por release para comparar el rendimiento de álbumes

---

Solución de problemas

La exportación está tardando demasiado

Los estados grandes con muchos elementos de línea pueden tardar más en generarse. El sistema consulte durante hasta 5 minutos. Si la exportación se agota:

1. Cierre el diálogo
2. Espere unos minutos
3. Intente descargar nuevamente

Error “Exportación en Progreso”

Solo puede procesarse una exportación a la vez. Espere a que termine cualquier exportación actual, luego intente de nuevo.

El CSV muestra caracteres inesperados

Asegúrese de que su aplicación de hojas de cálculo esté configurada con codificación UTF-8 al importar. Esto garantiza que los nombres de artistas y títulos de pistas con caracteres especiales se muestren correctamente.

Faltan columnas de comisiones

Las columnas de comisiones (platform_fee_rate, platform_fee_usd, etc.) solo están disponibles para períodos de estado desde octubre de 2024 en adelante. Los períodos anteriores muestran datos de ingresos sin el desglose de comisiones.

---

Guías relacionadas

• Entender Reportes de Regalías - Cómo leer sus datos de regalías
• Calendario de Pagos - Cuándo se pagan las regalías
• Información Fiscal - Usar datos de exportación para preparación de impuestos

---

¿Necesita ayuda con su exportación? Contacte a nuestro equipo de soporte.