Documentación

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:

  1. Vaya al menú principal, en la esquina superior izquierda, y haga clic en Importar.
  2. En ‘¿Qué está cargando?’, elija ‘Tipos de Contrato’.
  3. Haga clic en ‘Descargar archivo de plantilla de tipos de contrato’.
  4. 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

ColumnaAliasRequeridoDescripción
namecontract-type, contract-name, contract-type-nameVer notaEl nombre para mostrar del tipo de contrato
codecontract-code, contract-type-codeVer notaIdentificador único (auto-slugificado)
descriptionNoDescripció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

ColumnaAliasRequeridoDescripción
rule-priorityorder, rule-order, rulepriorityNoOrden de evaluación (comenzando desde 0). Se incrementa automáticamente si se omite
allocation-typetype, allocationtype, allocationCómo se calculan las regalías (ver abajo)
allocation-percentagepercentage, percent, rate, royalty-rateCondicionalRequerido para tipos basados en porcentaje (0–100)
allocation-fixed-pricefixed-price, price-per-unit, fixedpriceCondicionalRequerido para tipo de precio fijo por unidad — debe ser mayor que 0

Tipos de asignación

TipoAliasRequiere
net-receiptsnet receipts, netPorcentaje (0–100)
list-pricelist price, list, rrpPorcentaje (0–100)
list-price-minus-discountlist price minus discountPorcentaje (0–100)
fixed-price-per-unitfixed price per unit, fixed price, fixedPrecio fijo (mayor que 0)
no-allocationno allocation, noneNada

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 operadorColumna de valorDescripción
discount-rate-operatordiscount-rate-valueFiltrar por tasa de descuento
sale-country-operatorsale-country-value (alias: country, countries)Filtrar por país (códigos ISO)
units-sold-operatorunits-sold-valueFiltrar por unidades vendidas
total-net-receipts-operatortotal-net-receipts-valueFiltrar por ingresos netos totales

Operadores numéricos (tasa de descuento, unidades vendidas, ingresos netos)

OperadorSímboloAlias 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
Entrebetween
Uno dein, one of
No uno denot 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

nameallocation-typeallocation-percentage
Standard Authornet-receipts25

Contrato con reglas escalonadas

namerule-priorityallocation-typeallocation-percentageunits-sold-operatorunits-sold-value
Tiered Royalty1net-receipts30>=1000
Tiered Royalty2net-receipts25>=500
Tiered Royalty3net-receipts20

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

namerule-priorityallocation-typeallocation-percentagesale-country-operatorsale-country-value
Regional Rates1net-receipts30inGB,US,CA
Regional Rates2net-receipts20

Contrato de precio fijo

nameallocation-typeallocation-fixed-price
Fixed Ratefixed-price-per-unit1.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.

  1. Vaya al menú principal, en la esquina superior izquierda, y haga clic en Importar.
  2. En ‘¿Qué está cargando?’, elija ‘Tipos de Contrato’.
  3. En ‘Elija su archivo’ haga clic en ‘Examinar’ y navegue hasta su archivo CSV.
  4. Haga clic en ‘Siguiente’.
  5. El archivo será cargado y validado (comprobado para detectar problemas). Verá los resultados en una página de vista previa.
  6. 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-max con 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.