Importazione dei tipi di contratto
Importa o aggiorna in blocco i tipi di contratto (set di regole royalty) utilizzando un modello CSV, con supporto per regole a livelli, condizioni e molteplici tipologie di allocazione.
I tipi di contratto definiscono le regole di royalty che determinano come il reddito viene allocato ai titolari dei diritti. Puoi creare e aggiornare i tipi di contratto in massa utilizzando la funzione di caricamento CSV — ideale quando si configurano più accordi di royalty contemporaneamente.
I tipi di contratto sono riutilizzabili — una volta creati, un singolo tipo di contratto può essere collegato a più titolari di diritti e prodotti tramite importazioni di utilizzo del contratto, risparmiandoti dall’inserire gli stessi termini contrattuali più volte. Per questo motivo, i tipi di contratto devono essere importati prima dell’utilizzo del contratto.
Se devi creare solo uno o due tipi di contratto, potresti preferire crearli tramite l’interfaccia utente.
Nuovo ai contratti? Leggi prima la panoramica dei contratti per comprendere come contratti, regole e condizioni funzionano insieme.
Scarica il modello CSV
Un modello CSV è disponibile per il download dalla pagina di importazione dei tipi di contratto:
- Vai al menu principale, in alto a sinistra, e fai clic su Importa.
- Sotto “Cosa stai caricando?”, scegli “Tipi di contratto”.
- Fai clic su “Scarica il file modello di tipi di contratto”.
- Il file CSV modello verrà scaricato sul tuo dispositivo.
Puoi anche esportare tutti i tipi di contratto esistenti dalla stessa pagina. Questo è utile se desideri aggiornare i tipi di contratto in massa — esporta, modifica i dati nel tuo software di fogli di calcolo, quindi reimporta.
Come funzionano le importazioni dei tipi di contratto
Ogni riga nel CSV rappresenta una singola regola all’interno di un tipo di contratto. Più righe con lo stesso nome o codice sono raggruppate come regole in un tipo di contratto.
- Le regole vengono valutate in ordine per priorità — viene utilizzata la prima regola corrispondente per l’allocazione
- Una regola senza condizioni funge da impostazione predefinita catch-all
- Se un codice di tipo di contratto esiste già, le sue regole verranno sostituite con quelle nel file
Per ulteriori informazioni su come funzionano regole e condizioni durante le esecuzioni di royalty, vedi panoramica dei contratti.
Prepara i dati dei tipi di contratto
Apri il modello CSV (o il file esportato) nel tuo software di fogli di calcolo — consigliamo Google Sheets rispetto a Excel.
Colonne di identità
| Colonna | Alias | Obbligatoria | Descrizione |
|---|---|---|---|
| name | contract-type, contract-name, contract-type-name | Vedi nota | Il nome visualizzato del tipo di contratto |
| code | contract-code, contract-type-code | Vedi nota | Identificatore univoco (auto-slugificato) |
| description | — | No | Descrizione in formato libero |
Ogni riga deve avere almeno uno tra name o code. Se viene fornito solo un code (nessun name), il tipo di contratto deve già esistere nel sistema. Se code viene omesso, viene generato automaticamente dal name.
Configurazione della regola
| Colonna | Alias | Obbligatoria | Descrizione |
|---|---|---|---|
| rule-priority | order, rule-order, rulepriority | No | Ordine di valutazione (a partire da 0). Auto-incrementato se omesso |
| allocation-type | type, allocationtype, allocation | Sì | Come vengono calcolati i royalty (vedi sotto) |
| allocation-percentage | percentage, percent, rate, royalty-rate | Condizionale | Obbligatorio per tipi basati su percentuale (0–100) |
| allocation-fixed-price | fixed-price, price-per-unit, fixedprice | Condizionale | Obbligatorio per il tipo fixed-price-per-unit — deve essere maggiore di 0 |
Tipi di allocazione
| Tipo | Alias | Richiede |
|---|---|---|
| net-receipts | net receipts, net | Percentuale (0–100) |
| list-price | list price, list, rrp | Percentuale (0–100) |
| list-price-minus-discount | list price minus discount | Percentuale (0–100) |
| fixed-price-per-unit | fixed price per unit, fixed price, fixed | Prezzo fisso (maggiore di 0) |
| no-allocation | no allocation, none | Nulla |
Per i dettagli su cosa significa ogni tipo di allocazione, vedi azioni delle regole in Creazione e gestione dei contratti.
Colonne di condizione (tutte facoltative)
Ogni condizione ha un operatore e un valore. Se viene fornito un operatore, il suo valore corrispondente è obbligatorio.
| Colonna operatore | Colonna valore | Descrizione |
|---|---|---|
| discount-rate-operator | discount-rate-value | Filtra per tasso di sconto |
| sale-country-operator | sale-country-value (alias: country, countries) | Filtra per paese (codici ISO) |
| units-sold-operator | units-sold-value | Filtra per unità vendute |
| total-net-receipts-operator | total-net-receipts-value | Filtra per reddito netto totale |
Operatori numerici (tasso di sconto, unità vendute, reddito netto)
| Operatore | Simbolo | Alias in parole |
|---|---|---|
| Maggiore di | > | greater than, more than |
| Maggiore o uguale a | >= | at least |
| Minore di | < | less than |
| Minore o uguale a | <= | at most |
| Uguale a | = | is, equals, equal to |
| Non uguale a | != | is not, not equal to |
| Tra | — | between |
| Uno di | — | in, one of |
| Non uno di | — | not in, not one of |
Suggerimento: Per l’operatore between, usa il formato
min-max(ad esempio10-50).
Operatori per paese
Supporta: equals (=), is-not-equal (!=), is-one-of (in), is-not-one-of (not in)
I valori di paese devono essere codici ISO di paesi (2–3 lettere), separati da virgole. Vengono automaticamente convertiti in maiuscolo.
Attenzione alla formattazione automatica dei fogli di calcolo
Excel e altri software di fogli di calcolo possono formattare automaticamente i tuoi dati in modi che li corrompono. I problemi comuni includono numeri lunghi convertiti in notazione scientifica e date riformattate.
Suggerimento: Formatta tutte le celle come testo prima di inserire o incollare i dati. Per istruzioni dettagliate, vedi Introduzione all’importazione.
Esempi
Contratto percentuale semplice
| name | allocation-type | allocation-percentage |
|---|---|---|
| Standard Author | net-receipts | 25 |
Contratto con regole a livelli
| 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 priorità della regola 3 non ha condizioni, quindi funge da impostazione predefinita catch-all per le vendite sotto 500 unità. Per ulteriori informazioni sui royalty a livelli, vedi royalty a livelli.
Contratto basato su paese
| 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 |
Contratto con prezzo fisso
| name | allocation-type | allocation-fixed-price |
|---|---|---|
| Fixed Rate | fixed-price-per-unit | 1.50 |
Carica il tuo CSV di tipi di contratto
Dopo aver verificato i dati, salva il file come CSV. In Google Sheets, questo è File > Scarica > CSV.
- Vai al menu principale, in alto a sinistra, e fai clic su Importa.
- Sotto “Cosa stai caricando?”, scegli “Tipi di contratto”.
- Sotto “Scegli il tuo file” fai clic su “Sfoglia” e accedi al tuo file CSV.
- Fai clic su “Avanti”.
- Il file verrà caricato e convalidato (verificato per eventuali problemi). Vedrai i risultati in una pagina di anteprima.
- Se i risultati sembrano corretti, fai clic su “Continua” e i tipi di contratto verranno importati (oppure, se il passaggio di anteprima evidenzia problemi, dovrai correggere i dati — leggi il messaggio di errore e controlla i requisiti sopra).
Anteprima dry run
Prima dell’applicazione dell’importazione, vedrai un riepilogo che mostra:
- Nuovi tipi di contratto da creare (con conteggi delle regole)
- Tipi di contratto esistenti da aggiornare (mostrando conteggi delle regole vecchi rispetto ai nuovi)
- Eventuali errori di convalida che devono essere corretti
Devi confermare l’importazione prima che vengano salvate le modifiche.
Convalida
L’importazione esegue la convalida prima che vengano apportate modifiche:
- Nome o codice — almeno uno deve essere fornito per riga
- Tipo di allocazione — deve essere un tipo riconosciuto
- Percentuale — obbligatorio per tipi basati su percentuale, deve essere 0–100
- Prezzo fisso — obbligatorio per fixed-price-per-unit, deve essere maggiore di 0
- Operatori — devono essere validi se forniti
- Valori — obbligatori quando viene specificato un operatore
- Codici paese — devono essere codici ISO di 2–3 lettere
- Priorità delle regole — devono essere univoche all’interno di ogni tipo di contratto
- Valori between — devono utilizzare il formato
min-maxcon due numeri
Aggiorna i tipi di contratto in massa
Puoi anche utilizzare il processo sopra per aggiornare i tipi di contratto esistenti in massa.
Quando un codice di tipo di contratto nel CSV corrisponde a un record esistente:
- Il name e la description vengono aggiornati (se forniti)
- Tutte le regole esistenti vengono sostituite con le regole dal CSV — questa è una sostituzione completa, quindi tutte le regole non nel CSV verranno rimosse
Suggerimenti
- Usa il download del CSV modello per ottenere le intestazioni di colonna corrette
- Usa la funzione export per scaricare i tuoi tipi di contratto attuali come punto di partenza per le modifiche
- I nomi delle colonne sono flessibili — molti alias sono accettati (vedi le tabelle sopra)
- Gli operatori possono essere scritti come simboli (
>,>=) o parole (greater than,at least) - Le colonne di condizione vuote vengono ignorate — aggiungi solo le condizioni di cui hai bisogno
- La priorità della regola è facoltativa — le regole vengono numerate automaticamente se omesse
Successivamente
Una volta configurati i tipi di contratto, puoi collegarli ai titolari dei diritti e ai prodotti tramite importazione dell’utilizzo del contratto.