Importar tipos de contrato
Importe o actualice en lotes tipos de contratos (conjuntos de reglas de regalías) utilizando una plantilla CSV, con soporte para reglas escalonadas, condiciones y múltiples tipos de asignación.
Los tipos de contrato definen las reglas de regalías que determinan cómo se asignan los ingresos a los titulares de derechos. Puede crear y actualizar tipos de contrato en lote usando la función de carga CSV — ideal cuando configura múltiples acuerdos de regalías a la vez.
Los tipos de contrato son reutilizables — una vez creados, un único tipo de contrato se puede vincular a múltiples titulares de derechos y productos a través de importaciones de uso de contrato, lo que le evita tener que introducir los mismos términos de contrato varias veces. Por esta razón, los tipos de contrato deben importarse antes del uso del contrato.
Si solo necesita crear uno o dos tipos de contrato, puede preferir crearlos a través de la interfaz de usuario.
¿Nuevo en contratos? Lea primero la descripción general de contratos para comprender cómo funcionan conjuntamente los contratos, reglas y condiciones.
Descargar la plantilla CSV
Una plantilla CSV está disponible para descargar desde la página de importación de tipos de contrato:
- Vaya al menú principal, en la esquina superior izquierda, y haga clic en Importar.
- En ‘¿Qué está cargando?’, elija ‘Tipos de Contrato’.
- Haga clic en ‘Descargar archivo de plantilla de tipos de contrato’.
- El archivo CSV de plantilla se descargará en su dispositivo.
También puede exportar todos los tipos de contrato existentes desde la misma página. Esto es útil si desea actualizar tipos de contrato en lote — exporte, modifique los datos en su software de hojas de cálculo y luego reimporte.
Cómo funcionan las importaciones de tipos de contrato
Cada fila en el CSV representa una única regla dentro de un tipo de contrato. Varias filas con el mismo nombre o código se agrupan como reglas bajo un tipo de contrato.
- Las reglas se evalúan en orden por prioridad — se usa la primera regla coincidente para la asignación
- Una regla sin condiciones actúa como valor predeterminado general
- Si un código de tipo de contrato ya existe, sus reglas serán reemplazadas por las del archivo
Para más información sobre cómo funcionan las reglas y condiciones durante las ejecuciones de regalías, consulte la descripción general de contratos.
Preparar los datos de tipos de contrato
Abra la plantilla CSV (o su archivo exportado) en su software de hojas de cálculo — recomendamos Google Sheets sobre Excel.
Columnas de identidad
| Columna | Alias | Requerido | Descripción |
|---|---|---|---|
| name | contract-type, contract-name, contract-type-name | Ver nota | El nombre para mostrar del tipo de contrato |
| code | contract-code, contract-type-code | Ver nota | Identificador único (auto-slugificado) |
| description | — | No | Descripción de formato libre |
Cada fila debe tener al menos uno de nombre o código. Si solo se proporciona un código (sin nombre), el tipo de contrato ya debe existir en el sistema. Si se omite el código, se genera automáticamente a partir del nombre.
Configuración de reglas
| Columna | Alias | Requerido | Descripción |
|---|---|---|---|
| rule-priority | order, rule-order, rulepriority | No | Orden de evaluación (comenzando desde 0). Se incrementa automáticamente si se omite |
| allocation-type | type, allocationtype, allocation | Sí | Cómo se calculan las regalías (ver abajo) |
| allocation-percentage | percentage, percent, rate, royalty-rate | Condicional | Requerido para tipos basados en porcentaje (0–100) |
| allocation-fixed-price | fixed-price, price-per-unit, fixedprice | Condicional | Requerido para tipo de precio fijo por unidad — debe ser mayor que 0 |
Tipos de asignación
| Tipo | Alias | Requiere |
|---|---|---|
| net-receipts | net receipts, net | Porcentaje (0–100) |
| list-price | list price, list, rrp | Porcentaje (0–100) |
| list-price-minus-discount | list price minus discount | Porcentaje (0–100) |
| fixed-price-per-unit | fixed price per unit, fixed price, fixed | Precio fijo (mayor que 0) |
| no-allocation | no allocation, none | Nada |
Para obtener detalles sobre lo que significa cada tipo de asignación, consulte acciones de reglas en Crear y Gestionar Contratos.
Columnas de condición (todas opcionales)
Cada condición tiene un operador y un valor. Si se proporciona un operador, se requiere su valor correspondiente.
| Columna de operador | Columna de valor | Descripción |
|---|---|---|
| discount-rate-operator | discount-rate-value | Filtrar por tasa de descuento |
| sale-country-operator | sale-country-value (alias: country, countries) | Filtrar por país (códigos ISO) |
| units-sold-operator | units-sold-value | Filtrar por unidades vendidas |
| total-net-receipts-operator | total-net-receipts-value | Filtrar por ingresos netos totales |
Operadores numéricos (tasa de descuento, unidades vendidas, ingresos netos)
| Operador | Símbolo | Alias de palabras |
|---|---|---|
| Mayor que | > | greater than, more than |
| Mayor que o igual | >= | at least |
| Menor que | < | less than |
| Menor que o igual | <= | at most |
| Igual | = | is, equals, equal to |
| No es igual | != | is not, not equal to |
| Entre | — | between |
| Uno de | — | in, one of |
| No uno de | — | not in, not one of |
Consejo: Para el operador between, use el formato
min-max(p. ej.10-50).
Operadores de país
Soporta: equals (=), is-not-equal (!=), is-one-of (in), is-not-one-of (not in)
Los valores de país deben ser códigos de país ISO (2–3 letras), separados por comas. Se convierten automáticamente a mayúsculas.
Tenga cuidado con el formato automático de hojas de cálculo
Excel y otro software de hojas de cálculo pueden formatear automáticamente sus datos de formas que los corrompan. Los problemas comunes incluyen números largos convertidos a notación científica y fechas reformateadas.
Consejo: Formatee todas las celdas como texto antes de introducir o pegar datos. Para obtener instrucciones detalladas, consulte Introducción a la importación.
Ejemplos
Contrato de porcentaje simple
| name | allocation-type | allocation-percentage |
|---|---|---|
| Standard Author | net-receipts | 25 |
Contrato con reglas escalonadas
| name | rule-priority | allocation-type | allocation-percentage | units-sold-operator | units-sold-value |
|---|---|---|---|---|---|
| Tiered Royalty | 1 | net-receipts | 30 | >= | 1000 |
| Tiered Royalty | 2 | net-receipts | 25 | >= | 500 |
| Tiered Royalty | 3 | net-receipts | 20 |
La prioridad de regla 3 no tiene condiciones, por lo que actúa como valor predeterminado general para ventas de menos de 500 unidades. Para más información sobre regalías escalonadas, consulte regalías escalonadas.
Contrato basado en país
| name | rule-priority | allocation-type | allocation-percentage | sale-country-operator | sale-country-value |
|---|---|---|---|---|---|
| Regional Rates | 1 | net-receipts | 30 | in | GB,US,CA |
| Regional Rates | 2 | net-receipts | 20 |
Contrato de precio fijo
| name | allocation-type | allocation-fixed-price |
|---|---|---|
| Fixed Rate | fixed-price-per-unit | 1.50 |
Cargar su CSV de tipos de contrato
Cuando haya verificado sus datos, guarde el archivo como CSV. En Google Sheets, esto es Archivo > Descargar > CSV.
- Vaya al menú principal, en la esquina superior izquierda, y haga clic en Importar.
- En ‘¿Qué está cargando?’, elija ‘Tipos de Contrato’.
- En ‘Elija su archivo’ haga clic en ‘Examinar’ y navegue hasta su archivo CSV.
- Haga clic en ‘Siguiente’.
- El archivo será cargado y validado (comprobado para detectar problemas). Verá los resultados en una página de vista previa.
- Si los resultados se ven bien, haga clic en ‘Continuar’ y los tipos de contrato serán importados (o, si el paso de vista previa resalta problemas, deberá corregir los datos — lea el mensaje de error y verifique los requisitos anteriores).
Vista previa de ejecución de prueba
Antes de que se aplique la importación, verá un resumen que muestra:
- Nuevos tipos de contrato a crear (con conteos de reglas)
- Tipos de contrato existentes a actualizar (mostrando conteos de reglas antiguos frente a nuevos)
- Cualquier error de validación que necesite corregirse
Debe confirmar la importación antes de que se guarden los cambios.
Validación
La importación ejecuta la validación antes de que se realicen cambios:
- Nombre o código — al menos uno debe proporcionarse por fila
- Tipo de asignación — debe ser un tipo reconocido
- Porcentaje — requerido para tipos basados en porcentaje, debe ser 0–100
- Precio fijo — requerido para fixed-price-per-unit, debe ser mayor que 0
- Operadores — deben ser válidos si se proporcionan
- Valores — requeridos cuando se especifica un operador
- Códigos de país — deben ser códigos ISO de 2–3 letras
- Prioridades de reglas — deben ser únicas dentro de cada tipo de contrato
- Valores entre — deben usar el formato
min-maxcon dos números
Actualizar tipos de contrato en lote
También puede usar el proceso anterior para actualizar tipos de contrato existentes en lote.
Cuando un código de tipo de contrato en el CSV coincide con un registro existente:
- El nombre y la descripción se actualizan (si se proporcionan)
- Todas las reglas existentes se reemplazan con las reglas del CSV — esto es un reemplazo completo, por lo que se eliminarán las reglas no incluidas en el CSV
Consejos
- Use la descarga de plantilla CSV para obtener los encabezados de columna correctos
- Use la función de exportación para descargar sus tipos de contrato actuales como punto de partida para ediciones
- Los nombres de columna son flexibles — se aceptan muchos alias (consulte las tablas anteriores)
- Los operadores se pueden escribir como símbolos (
>,>=) o palabras (greater than,at least) - Las columnas de condición vacías se ignoran �� solo agregue las condiciones que necesite
- La prioridad de regla es opcional — las reglas se numeran automáticamente si se omiten
¿Qué sigue?
Una vez que sus tipos de contrato estén configurados, puede vincularlos a titulares de derechos y productos importando uso de contrato.