Importar títulos y productos
Importa o actualiza productos de forma masiva con ISBNs, metadatos y detalles de publicación mediante carga de CSV.
Esta página te guiará a través de los pasos para importar tus títulos, ya sea importando nuevos productos o importando actualizaciones a productos existentes.
Si solo quieres añadir uno o dos títulos nuevos, puede que prefieras hacerlo a través de la interfaz de usuario. Sin embargo, si buscas importar títulos y datos de forma masiva, estás en el lugar correcto.
Ten en cuenta que los productos son ediciones específicas de un título. Por ejemplo, un título podría llamarse “Mi Libro” y puede tener múltiples formatos: tapa blanda, tapa dura, libro electrónico y audiolibro. Cada una de estas ediciones/formatos se conoce en Royalties HQ como un producto, y cada uno tendrá su propio ID de producto (por ejemplo, ISBN).
Los productos se pueden importar de forma masiva usando la función de carga CSV. Hay una plantilla disponible para descargar desde la página Titulares de derechos > Importar.
Descargar la plantilla de importación de títulos
- Ve al menú principal, arriba a la izquierda, y haz clic en Títulos, luego en Productos.
- En la página de listado de Productos, haz clic en el botón Importar.
- Bajo ‘¿Qué estás subiendo?’, elige ‘Productos’.
- Debajo de esto, haz clic en ‘Descargar archivo de plantilla de Productos’.
- El archivo de plantilla CSV se descargará en tu dispositivo.
Formatear los datos de tus títulos
- Abre la plantilla de importación CSV de Productos descargada en el paso anterior (ver arriba) – recomendamos usar Google Sheets.
- Cada fila es un producto (en Royalties HQ, un título es el ‘padre’ y puede tener múltiples formatos – a estos los llamamos productos).
- Cada producto debe tener al menos un ID de producto como ISBN, ASIN u otro ID de producto (y estos deben ser únicos).
- Todos los demás campos son opcionales.
- Cuando tus datos estén listos, guárdalos como CSV. En Google Sheets, esto es Archivo > Descargar > CSV.
Al formatear tus datos, debes seguir estos requisitos:
- Debes formatear los números como texto
- Las fechas deben estar en este formato: YYYY-MM-DD (por ejemplo, “30 de diciembre de 2020” debe introducirse como “2020-12-30”)
- El tipo de cálculo de nivel (tier-type columna) debe ser units-sold o total-net-receipts (Más información sobre niveles y tipo de cálculo de nivel está aquí).
| Nombre de Columna | Descripción | Requerido | Formato/Valores |
|---|---|---|---|
| name | Título completo del libro | Sí | Cadena de texto |
| title-code | Identificador único para el título (registro padre) | Sí | Alfanumérico (por ejemplo, T000047). Debe tener 7 caracteres. Se creará uno automáticamente si se deja en blanco. |
| royalty-period-start-month | Mes de inicio para cálculos de regalías | Sí | Un mes escrito completo o abreviado (por ejemplo, “Jan” o “January”) |
| royalty-period-length | Duración del período de regalías | Sí | monthly, two-monthly, quarterly, six-monthly, annual |
| product-type | Tipo de formato de esta edición | Sí | softcover, hardcover, ebook, audiobook, wire-bound |
| status | Estado de publicación | Sí | active, inactive, withdrawn |
| imprint | Nombre del sello editorial | No | Cadena de texto |
| isbn | ISBN-13 para formatos físicos | Condicional* | ISBN de 13 dígitos sin guiones |
| asin | Número de Identificación Estándar de Amazon | Condicional* | Alfanumérico de 10 caracteres |
| number-pages | Número de páginas para libros físicos | No | Entero (por ejemplo, 300) |
| legacy-units-sold | Unidades históricas vendidas antes de usar Royalties HQ | No | Entero (por ejemplo, 250) |
| legacy-earned-royalties | Regalías históricas ganadas antes de usar Royalties HQ | No | Decimal (por ejemplo, 16.95) |
| date-first-published | Fecha de publicación inicial | No | Formato YYYY-MM-DD |
| date-withdrawn | Fecha en que el formato se retiró de la venta | No | Formato YYYY-MM-DD |
*Al menos un ID de producto (ISBN, ASIN u otro) es requerido para cada producto
Otros datos
Códigos de título
- En Royalties HQ, cada título recibe un identificador único – un código de título. Nota: un título NO es un ISBN.
- Todos los formatos del mismo libro comparten el mismo código de título.
- Un código de título se generará automáticamente cuando crees un nuevo título – ya sea a través de la interfaz de usuario o mediante importación. Puedes especificar un código de título en la importación. Esto es importante para agrupar productos bajo un título. Por ejemplo, si estás importando una nueva edición de un título, debes importarlo con el código de título relevante.
- Si no especificas un código de título en la importación, cualquier producto nuevo se generará bajo nuevos títulos.
Titulares de Derechos
- Deben coincidir con códigos de titular de derechos existentes en Royalties HQ.
- Importa primero los titulares de derechos si aún no existen en Royalties HQ.
- Déjalo en blanco si aún no se ha asignado un titular de derechos.
Datos Heredados
- Opcional.
- Usa campos heredados para registrar ventas históricas antes de que estuvieras usando Royalties HQ.
- Estos importes son esenciales cuando un contrato usa el total de unidades vendidas para determinar la tasa de regalías actual de un titular de derechos para un producto (ISBN).
IDs de Producto Adicionales
- ID de Producto Adicional incluye ACX, Google Play y más – estos son campos opcionales para almacenar identificadores de producto alternativos
- Úsalos para códigos propietarios, SKUs internos o identificadores personalizados que no sean ISBNs o ASINs
- Los IDs de producto deben ser únicos en todos los productos
- Este campo es útil para rastrear títulos en múltiples sistemas
Idioma
- Idioma es un campo opcional para indicar el idioma del producto
- Usa códigos ISO 639-3 de tres letras (por ejemplo, “eng” para inglés, “deu” para alemán, etc.), o etiquetas en inglés simple (“English”, “German”, etc.)
- Déjalo en blanco si no es aplicable o si el idioma no es relevante
- Esto se puede completar automáticamente mediante obtención de metadatos de Google Books para productos nuevos
Soporte de formato de mes y período
royalty-period-start-month admite descriptores de mes flexibles:
- Nombres de mes completos: “January”, “February”, “March”, etc.
- Abreviaturas de tres letras: “Jan”, “Feb”, “Mar”, etc.
- Formato numérico: 1-12 (por ejemplo, 3 para marzo)
Subir tu CSV de productos
Cuando hayas verificado dos veces los datos de tu producto, puedes proceder e importarlos a Royalties HQ. Así es como lo haces:
- Ve al menú principal, arriba a la izquierda, y haz clic en Importar.
- Para el tipo, selecciona ‘Títulos’.
- Bajo ‘Elige tu archivo’ haz clic en ‘Examinar’ y navega hasta tu archivo CSV.
- Haz clic en ‘Siguiente’
- El archivo se cargará y validará (se comprobará si hay problemas). Verás los resultados en una página de vista previa.
- Si los resultados se ven bien, haz clic en ‘Continuar’ y los productos se importarán (o, si el paso de vista previa destaca problemas, necesitarás corregir los datos – lee el mensaje de error y comprueba los requisitos a continuación).
Actualizar productos de forma masiva
También puedes usar el proceso anterior para actualizar productos de forma masiva.
La importación CSV coincidirá con los productos existentes en ISBN o ASIN. Los campos en blanco se ignorarán; estos no sobrescribirán los datos existentes.
Ten en cuenta que cualquier ID de producto nuevo (incluidos ISBNs o ASINs) en tu CSV que no estén en una fila con un ID de producto reconocido resultará en un producto nuevo.