Importera kontraktstyper
Massimportmera eller uppdatera avtalstyper (royaltyregeluppsättningar) med hjälp av en CSV-mall, med stöd för nivåindelade regler, villkor och flera allokeringstyper.
Kontraktstyper definierar royaltyreglerna som avgör hur inkomst fördelis till rättighetsinnehavare. Du kan skapa och uppdatera kontraktstyper i bulk med CSV-uploadfunktionen — perfekt när du konfigurerar flera royaltyavtal på en gång.
Kontraktstyper är återanvändbara — när de väl är skapade kan en enda kontraktstyp länkas till flera rättighetsinnehavare och produkter via kontraktanvändningsimporter, vilket sparar dig från att ange samma kontraktsvillkor flera gånger. Av denna anledning bör kontraktstyper importeras före kontraktanvändning.
Om du bara behöver skapa en eller två kontraktstyper kanske du föredrar att skapa dem via användargränssnittet.
Ny på kontrakt? Läs kontraktsöversikten först för att förstå hur kontrakt, regler och villkor fungerar tillsammans.
Hämta CSV-mallen
En CSV-mall är tillgänglig för nedladdning från sidan för kontraktstypsimport:
- Gå till huvudmenyn, överst till vänster, och klicka på Import.
- Under “Vad laddar du upp?” väljer du “Contract Types”.
- Klicka på “Download contract types template file”.
- CSV-filmallen kommer att laddas ned till din enhet.
Du kan också exportera alla befintliga kontraktstyper från samma sida. Detta är användbart om du vill uppdatera kontraktstyper i bulk — exportera, ändra data i ditt kalkylprogram och importera sedan på nytt.
Så fungerar kontraktstypsimporter
Varje rad i CSV:en representerar en enda regel inom en kontraktstyp. Flera rader med samma namn eller kod grupperas som regler under en kontraktstyp.
- Regler utvärderas i ordning efter prioritet — den första matchande regeln används för fördelning
- En regel med inga villkor fungerar som en standardkatchall
- Om en kontraktstyp-kod redan finns kommer dess regler att ersättas med dem i filen
För mer information om hur regler och villkor fungerar vid royaltykörningar, se kontraktsöversikten.
Förbereda dina kontraktstypdata
Öppna CSV-mallen (eller din exporterade fil) i ditt kalkylprogram — vi rekommenderar Google Sheets framför Excel.
Identitetskolumner
| Kolumn | Alias | Obligatorisk | Beskrivning |
|---|---|---|---|
| name | contract-type, contract-name, contract-type-name | Se anmärkning | Visningsnamnet för kontraktstypen |
| code | contract-code, contract-type-code | Se anmärkning | Unik identifierare (auto-slugifierad) |
| description | — | Nej | Beskrivning i fri form |
Varje rad måste ha minst ett av namn eller kod. Om endast en kod ges (inget namn) måste kontraktstypen redan finnas i systemet. Om kod utelämnas genereras den automatiskt från namnet.
Regelkonfiguration
| Kolumn | Alias | Obligatorisk | Beskrivning |
|---|---|---|---|
| rule-priority | order, rule-order, rulepriority | Nej | Utvärderingsordning (börjar från 0). Auto-inkrementerad om utelämnad |
| allocation-type | type, allocationtype, allocation | Ja | Hur royalties beräknas (se nedan) |
| allocation-percentage | percentage, percent, rate, royalty-rate | Villkorlig | Krävs för procentbaserade typer (0–100) |
| allocation-fixed-price | fixed-price, price-per-unit, fixedprice | Villkorlig | Krävs för fast-pris-per-enhet-typ — måste vara större än 0 |
Tilldelningstyper
| Typ | Alias | Kräver |
|---|---|---|
| net-receipts | net receipts, net | Procent (0–100) |
| list-price | list price, list, rrp | Procent (0–100) |
| list-price-minus-discount | list price minus discount | Procent (0–100) |
| fixed-price-per-unit | fixed price per unit, fixed price, fixed | Fast pris (större än 0) |
| no-allocation | no allocation, none | Inget |
För detaljer om vad varje tilldelningstyp betyder, se regelåtgärder i Skapa och hantera kontrakt.
Villkorskolumner (alla valfria)
Varje villkor har en operator och ett värde. Om en operator anges krävs dess motsvarande värde.
| Operatorkolumn | Värdekolumn | Beskrivning |
|---|---|---|
| discount-rate-operator | discount-rate-value | Filtrera efter rabattsats |
| sale-country-operator | sale-country-value (alias: country, countries) | Filtrera efter land (ISO-koder) |
| units-sold-operator | units-sold-value | Filtrera efter sålda enheter |
| total-net-receipts-operator | total-net-receipts-value | Filtrera efter totala nettointäkter |
Numeriska operatorer (rabattsats, sålda enheter, nettointäkter)
| Operator | Symbol | Ordalias |
|---|---|---|
| Större än | > | greater than, more than |
| Större än eller lika med | >= | at least |
| Mindre än | < | less than |
| Mindre än eller lika med | <= | at most |
| Lika med | = | is, equals, equal to |
| Inte lika med | != | is not, not equal to |
| Mellan | — | between |
| En av | — | in, one of |
| Inte en av | — | not in, not one of |
Tips: För operatorn mellan använder du formatet
min-max(t.ex.10-50).
Landoperatorer
Stöder: equals (=), is-not-equal (!=), is-one-of (in), is-not-one-of (not in)
Landvärden bör vara ISO-landskoder (2–3 bokstäver), separerade med komma. De konverteras automatiskt till versaler.
Var försiktig med automatisk formatering i kalkylprogram
Excel och andra kalkylprogram kan automatiskt formatera dina data på sätt som skador den. Vanliga problem är att långa siffror konverteras till vetenskaplig notation och datum formateras om.
Tips: Formatera alla celler som text innan du anger eller klistrar in data. För detaljerade anvisningar, se Introduktion till import.
Exempel
Enkelt procentkontrakt
| name | allocation-type | allocation-percentage |
|---|---|---|
| Standard Author | net-receipts | 25 |
Kontrakt med nivåindelade regler
| 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 |
Regelprioritet 3 har inga villkor, så den fungerar som standardkatchall för försäljning under 500 enheter. För mer om nivåindelade royalties, se nivåindelade royalties.
Landbaserat kontrakt
| 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 |
Fastpriskontrakt
| name | allocation-type | allocation-fixed-price |
|---|---|---|
| Fixed Rate | fixed-price-per-unit | 1.50 |
Ladda upp din kontraktstyp-CSV
När du har dubbelkontrollerat dina data sparar du filen som en CSV. I Google Sheets är detta Arkiv > Hämta > CSV.
- Gå till huvudmenyn, överst till vänster, och klicka på Import.
- Under “Vad laddar du upp?” väljer du “Contract Types”.
- Under “Välj din fil” klickar du på “Bläddra” och navigerar till din CSV-fil.
- Klicka på “Nästa”.
- Filen kommer att laddas upp och valideras (kontrolleras för problem). Du kommer att se resultaten på en förhandsgranskningssida.
- Om resultaten ser bra ut klickar du på “Fortsätt” och kontraktstyperna kommer att importeras (eller, om förhandsgranskningssteget visar problem, måste du åtgärda data — läs felmeddelandet och kontrollera kraven ovan).
Torrkörningsförhandsvisning
Innan importen tillämpas kommer du att se en sammanfattning som visar:
- Nya kontraktstyper som ska skapas (med regelräkning)
- Befintliga kontraktstyper som ska uppdateras (visar gamla vs nya regelantal)
- Alla valideringsfel som behöver åtgärdas
Du måste bekräfta importen innan några ändringar sparas.
Validering
Importen kör validering innan några ändringar görs:
- Namn eller kod — minst en måste anges per rad
- Tilldelningstyp — måste vara en känd typ
- Procent — krävs för procentbaserade typer, måste vara 0–100
- Fast pris — krävs för fast-pris-per-enhet, måste vara större än 0
- Operatorer — måste vara giltiga om de anges
- Värden — krävs när en operator anges
- Landskoder — måste vara 2–3 bokstäver ISO-koder
- Regelprioriteringar — måste vara unika inom varje kontraktstyp
- Värdena mellan — måste använda
min-max-format med två tal
Uppdatera kontraktstyper i bulk
Du kan också använda ovanstående process för att uppdatera befintliga kontraktstyper i bulk.
När en kontraktstyp-kod i CSV:en matchar en befintlig post:
- Namn och beskrivning uppdateras (om de anges)
- Alla befintliga regler ersätts med reglerna från CSV:en — detta är en fullständig ersättning, så alla regler som inte finns i CSV:en tas bort
Tips
- Använd malls-CSV för att ladda ned för att få rätt kolumnrubriker
- Använd exportfunktionen för att ladda ned dina nuvarande kontraktstyper som utgångspunkt för redigering
- Kolumnnamn är flexibla — många alias accepteras (se tabellerna ovan)
- Operatorer kan skrivas som symboler (
>,>=) eller ord (greater than,at least) - Tomma villkorskolumner ignoreras — lägg bara till villkor du behöver
- Regelprioritet är valfri — regler numreras automatiskt om den utelämnas
Nästa steg?
När dina kontraktstyper är konfigurerade kan du länka dem till rättighetsinnehavare och produkter genom importera kontraktanvändning.