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 (icono 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”, espera a que termine la exportación actual antes de iniciar otra.

---

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

Columna	Descripción	Ejemplo
gross_usd	Ingresos brutos en USD (después de deducir las comisiones del proveedor de estados)	18.09000000

Nota

El monto gross_usd es después de que su proveedor de estados (como Merlin o The Orchard) haya tomado su parte. Esta es la cantidad que llega a LabelGrid para su cuenta.

Columnas de comisiones de LabelGrid

Columna	Descripción	Ejemplo
platform_fee_rate	Tasa de comisión de la plataforma LabelGrid según su plan	0.05000000 (5%)
platform_fee_usd	Monto de comisión de la plataforma LabelGrid (mostrado como valor negativo)	-0.90450000
ugc_fee_rate	Tasa de comisión de Contenido Generado por Usuarios para plataformas UGC	0.20000000 (20%)
ugc_fee_usd	Monto de comisión de plataforma UGC (mostrado como valor negativo)	-1.74400000
total_labelgrid_fee	Total de todas las comisiones de LabelGrid (valor negativo)	-2.18000000
net_revenue_usd	Sus ganancias finales después de todas las comisiones	17.18550000

---

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)

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 — multiplica por 100 para obtener el porcentaje.

Fórmulas de ingresos

platform_fee_usd  = -1 × platform_fee_rate × gross_usd
ugc_fee_usd       = -1 × ugc_fee_rate × gross_usd
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. Por ejemplo:

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

Comisiones de plataformas UGC

La comisión UGC aplica solo a plataformas de Contenido Generado por Usuarios como YouTube, TikTok y SoundCloud. Para plataformas de streaming estándar como Spotify o Apple Music, las columnas ugc_fee_rate y ugc_fee_usd mostrarán 0.00.

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.

---

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.

---

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