Guía del usuario: Carga Masiva de catálogo en RYLTY

Guía del usuario: Carga Masiva de catálogo

La Carga Masiva te permite crear muchos lanzamientos y pistas de una sola vez a partir de un archivo CSV con los metadatos y los enlaces a tus archivos de audio y portadas, en lugar de subirlos uno a uno desde tu panel.

Está pensada para migrar catálogos que ya existen: si vienes de otra distribuidora, si gestionas un sello con cientos de referencias, o si tienes un back catalogue que quieres tener disponible en RYLTY sin dedicar semanas a la carga manual.

En RYLTY la Carga Masiva es un servicio gestionado. No es una herramienta de autoservicio dentro de tu panel: tú preparas el archivo y los enlaces siguiendo esta guía, y nuestro equipo se encarga de procesar la carga, revisar el resultado y devolverte el informe. Se solicita por correo a support@rylty.art.

Antes de preparar nada, lee esta guía entera. La mayoría de las cargas que fallan lo hacen por detalles que están explicados aquí.

1. Requisitos para solicitar una carga masiva

Para que el servicio tenga sentido —y para poder priorizarlo correctamente— pedimos que se cumplan estas condiciones:

2. Consideraciones previas

Solo crea contenido nuevo

La Carga Masiva sirve para crear lanzamientos y pistas por primera vez. No actualiza contenido ya existente ni gestiona la distribución a las tiendas: no hace primeras entregas, ni reentregas, ni retiradas.

Una vez cargado el catálogo, los lanzamientos quedan en tu panel listos para que los revises y los envíes a distribución cuando quieras.

La cuenta de destino

Cada lanzamiento se asocia a un correo electrónico de usuario, que determina quién puede ver y editar ese contenido y en qué balance se acumulan las regalías que genere.

Antes de la carga, ese usuario debe existir en la plataforma. Si gestionas varios artistas o sellos con cuentas distintas, indícanoslo al solicitar el servicio y creamos las cuentas necesarias.

Este campo es crítico. Una vez cargado el contenido bajo un usuario concreto, no se puede migrar a otro usuario. Revisa los correos electrónicos del CSV antes de enviárnoslo.

Si no necesitas que ningún artista entre a la plataforma y prefieres repartir las regalías por tu cuenta a partir del ISRC y el UPC, puedes usar un único correo de administrador para todo el catálogo.

Metadatos que no admite la carga masiva

Algunos campos que sí existen en el panel no pueden incluirse en el CSV:

• IDs de artista (a nivel de entidad de artista)

• Transcripción de letras (a nivel de pista)

• Versión limpia de contenido explícito (a nivel de pista)

• Punto de inicio del audio (a nivel de pista)

• Disponibilidad por separado (a nivel de pista)

• Lanzamientos programados (a nivel de lanzamiento)

• Tipo de lanzamiento (a nivel de lanzamiento; se calcula automáticamente)

• Descripción y notas del lanzamiento y de la pista

Todos son opcionales y puedes completarlos desde tu panel una vez terminada la carga.

La plantilla tampoco admite ringtones ni videoclips: solo lanzamientos de audio.

Lanzamientos de una sola pista

Cuando un lanzamiento tiene una única pista (un single), la mayoría de valores deben coincidir exactamente a nivel de lanzamiento y de pista. Si no coinciden, la carga de ese lanzamiento falla. Son estos:

• title y track_title

• remix_or_version

• participants

• primary_genre

• secondary_genre

• p_year

• p_line

3. El archivo CSV

Estructura del archivo CSV

Formato del archivo

• Archivo CSV, con campos separados por comas y opcionalmente entrecomillados, según la norma RFC 4180.

• Codificación UTF-8 (importante para tildes, eñes y caracteres no latinos).

• Los campos opcionales pueden ir vacíos, pero sus columnas deben estar presentes para no romper la estructura. No borres ni reordenes columnas.

Cómo se organiza

El archivo se divide en dos secciones dentro de cada fila:

• Nivel de lanzamiento: de la columna C a la Y (más action en A y upc en B).

• Nivel de pista: de la columna Z a la AK.

Cada línea corresponde a una pista e incluye también los datos del lanzamiento al que pertenece. Es decir: si subes un lanzamiento con 10 pistas, tendrás 10 líneas; la parte de lanzamiento se repite idéntica en las 10, y la parte de pista cambia en cada una.

Solicítanos la plantilla al abrir tu petición y trabaja siempre sobre ella. Cuando la tengas rellena, exporta a CSV UTF-8 y envíanosla.

4. Campos generales (líneas 1-5)

La primera sección del archivo describe la propia carga y nos permite procesarla correctamente. Todos estos campos son obligatorios.

5. Campos de lanzamiento

6. Campos de pista

7. Cómo rellenar los participantes

Todos los artistas y demás participantes van en una única columna llamada participants. Cada participante se escribe con su rol delante, separado por dos puntos, y los participantes se separan entre sí con punto y coma.

Si quieres acreditar a estas personas:

primary:Artista1
primary:Artista2
featuring:Artista3
vocals:Artista1
producer:Colaborador1
composer:Colaborador1
lyricist:Colaborador1

La celda participants debe contener exactamente esto, todo seguido:

primary:Artista1;primary:Artista2;featuring:Artista3;vocals:Artista1;producer:Colaborador1;composer:Colaborador1;lyricist:Colaborador1

Reglas de participantes

Estos roles son obligatorios tanto a nivel de lanzamiento como de pista:

• Artista principal (primary)

• Productor (producer)

• Compositor (composer)

• Letrista (lyricist) — salvo que la pista sea instrumental (idioma zxx)

• Un rol específico de intérprete (voz, guitarra, remezclador, etc.)

Un mismo artista no puede ser a la vez artista principal, artista destacado (featuring), colaborador e intérprete: estos roles son excluyentes entre sí. Es uno de los motivos de error más frecuentes.

Si tienes dudas sobre cómo acreditar a alguien, escríbenos antes de preparar el archivo entero.

8. Cómo incluir los enlaces a tus archivos

Los archivos no se adjuntan: en los campos cover_url (lanzamiento) y audio_url (pista) tienes que enlazar un archivo accesible desde el que nuestro sistema pueda descargarlo automáticamente.

Los enlaces son obligatorios y no perdonan. Si un enlace falla, ese lanzamiento no se carga. Comprueba uno por uno que las URLs apuntan al archivo correcto y que son accesibles desde fuera de tu red.

Si usas enlaces temporales (WeTransfer) o credenciales con caducidad (URLs firmadas de S3), asegúrate de que siguen vivos durante todo el proceso de carga.

Opciones admitidas - URLs públicas

• URLs HTTP

• URLs HTTPS

• URLs FTP

• URLs SFTP

• URLs de Amazon S3 (con URL firmada si el archivo está protegido)

• Servicios de almacenamiento en la nube que ofrezcan enlace público de descarga directa (como Dropbox o WeTransfer)

No recomendamos Google Drive. Tiene límites de cuota, a veces bloquea la descarga tras cierto número de archivos, y puede bloquear la IP de descarga o suspender la cuenta. Para catálogos grandes, lo más fiable es un FTP privado o un bucket de S3.

URLs autenticadas

Admitimos autenticación por usuario y contraseña con estos formatos:

http://{usuario}:{contraseña}@{host}/{archivo}
https://{usuario}:{contraseña}@{host}/{archivo}
ftp://{usuario}:{contraseña}@{host}/{archivo}
sftp://{usuario}:{contraseña}@{host}/{archivo}
https://{bucket}.s3.amazonaws.com/{archivo}?AWSAccessKeyId={accesskey}&Signature={signature}&Expires={timestamp}

En SFTP solo admitimos claves públicas. Si necesitas usar SFTP con clave, escríbenos y coordinamos la carga contigo.

9. Cómo incluir pistas que ya existen en tu catálogo

Puedes incluir en un lanzamiento nuevo una pista que ya se creó antes en la plataforma (por ejemplo, un single que después va en un álbum o en un recopilatorio).

Si la pista ya tiene ISRC

Indica el ISRC en los campos de pista y deja vacíos todos los demás campos de pista. Los campos de lanzamiento se rellenan con normalidad.

Si la pista tiene ISRC pero aún no está creada en la plataforma

Primero hay que crearla. En el primer CSV incluye el ISRC junto con todos los metadatos de pista; en los siguientes archivos incluye solo el ISRC y deja vacío el resto.

Si la pista aún no tiene ISRC

Si la configuraste con auto, tendrás que esperar a que se entregue a las tiendas, porque la asignación del ISRC ocurre después. Si incluyes la misma pista con auto en varios lanzamientos, el sistema creará una pista nueva y le asignará un ISRC distinto en cada uno.

Adjuntar una pista nueva a varios lanzamientos

Puedes incluir una pista nueva en varios lanzamientos dentro del mismo CSV: repite los mismos metadatos de pista en varias líneas y rellena en cada una los campos de lanzamiento correspondientes.

10. Cómo solicitar tu carga masiva

1. Escríbenos a support@rylty.art Con el asunto «Carga masiva» e indicando: número aproximado de lanzamientos y pistas, cuenta o cuentas de destino, y si el catálogo está actualmente en otra distribuidora.

2. Te enviamos la plantilla y el presupuesto Recibirás la plantilla CSV en el formato correcto y un presupuesto cerrado según el volumen. Nada avanza hasta que lo apruebes.

3. Preparas el archivo y los enlaces Rellenas la plantilla siguiendo esta guía y subes tus audios y portadas a un almacenamiento accesible. Este es el paso que más tiempo lleva: dedícale el que haga falta.

4. Revisión previa Nos envías el CSV y hacemos una validación antes de cargar nada: estructura, campos obligatorios, roles, coincidencias en los singles y una muestra de enlaces. Si algo falla, te lo devolvemos señalado para que lo corrijas.

5. Ejecutamos la carga Procesamos el archivo. El sistema descarga los audios y portadas de tus enlaces y crea los lanzamientos y las pistas. El plazo orientativo es de 5 a 10 días hábiles desde que el archivo está validado, según el volumen.

6. Te entregamos el informe Recibirás el resultado: cuántos lanzamientos y pistas se crearon correctamente y, si hubo fallos, un CSV con las referencias fallidas y el detalle del error de cada una.

7. Revisas y envías a distribución Los lanzamientos quedan creados en tu catálogo. Revísalos en tu panel, completa los campos que la carga masiva no admite y envíalos a las tiendas cuando estén listos.

11. Corrección de errores

En una carga masiva, solo se procesan los lanzamientos sin errores. Los que fallan se excluyen y el resto se crea igualmente, así que un fallo puntual no echa a perder toda la carga.

Con el informe recibirás un CSV con las referencias fallidas y el detalle de qué campo hay que corregir en cada una. Basta con corregirlas y devolvérnoslo para procesar una segunda vuelta.

Errores más frecuentes

12. Checklist antes de enviar

• El archivo está guardado como CSV con codificación UTF-8.

• No he borrado, añadido ni reordenado columnas.

• format_version es 4.

• total_releases y total_tracks coinciden con el contenido real del archivo.

• Cada lanzamiento tiene tantas filas como pistas, y track_count coincide.

• Todos los user_email son correctos y corresponden a cuentas ya creadas.

• Cada lanzamiento tiene upc o catalog_number válido, y no he puesto auto en los dos.

• Los lanzamientos de una sola pista tienen los mismos valores a nivel de lanzamiento y de pista.

• Todos los participants incluyen artista principal, productor, compositor, letrista e intérprete, sin roles excluyentes repetidos.

• Las pistas instrumentales usan el idioma zxx y no llevan letrista.

• Los géneros y los idiomas están escritos exactamente como en nuestras listas.

• Las fechas están en formato AAAA-MM-DD y original_release está relleno en el catálogo antiguo.

• He abierto en una ventana de incógnito una muestra de cover_url y audio_url y descargan el archivo directamente.

• Los enlaces temporales no caducan durante el proceso de carga.

¿Necesitas ayuda?

Si tienes dudas al preparar el archivo, escríbenos a support@rylty.art antes de rellenarlo entero: revisar contigo un lanzamiento de ejemplo ahorra mucho trabajo después.