Contracttypen importeren

Contracttypen definiëren de royaltyregels die bepalen hoe inkomsten worden toebedeeld aan rechthebbenden. U kunt contracttypen in bulk maken en bijwerken met behulp van de CSV-uploadfunctie — ideaal bij het instellen van meerdere royaltyovereenkomsten tegelijk.

Contracttypen zijn herbruikbaar — eenmaal aangemaakt, kan één contracttype via contract usage imports aan meerdere rechthebbenden en producten worden gekoppeld, waardoor u dezelfde contractvoorwaarden niet meerdere keren hoeft in te voeren. Daarom moeten contracttypen vóór contract usage worden geïmporteerd.

Als u slechts één of twee contracttypen hoeft te maken, kunt u deze misschien liever via de gebruikersinterface maken.

Nieuw bij contracten? Lees eerst het contracts overzicht om te begrijpen hoe contracten, regels en voorwaarden samenwerken.

Download de CSV-sjabloon #

Een CSV-sjabloon kan worden gedownload van de pagina voor contracttype-imports:

1. Ga naar het hoofdmenu (linksboven) en klik op Import.
2. Kies onder ‘Wat laadt u op?’ de optie ‘Contract Types’.
3. Klik op ‘Download contract types template file’.
4. Het CSV-bestand wordt naar uw apparaat gedownload.

U kunt ook alle bestaande contracttypen exporteren vanaf dezelfde pagina. Dit is handig als u contracttypen in bulk wilt bijwerken — exporteer, wijzig de gegevens in uw spreadsheetprogramma en importeer opnieuw.

Hoe contracttype-imports werken #

Elke rij in de CSV vertegenwoordigt één regel binnen een contracttype. Meerdere rijen met dezelfde naam of code worden als regels onder één contracttype gegroepeerd.

• Regels worden in volgorde op prioriteit geëvalueerd — de eerste overeenkomende regel wordt gebruikt voor toewijzing
• Een regel zonder voorwaarden fungeert als standaardopvangoptie
• Als een contracttype-code al bestaat, worden de bijbehorende regels vervangen door de regels in het bestand

Zie contracts overzicht voor meer informatie over hoe regels en voorwaarden werken tijdens royaltyrun.

Bereid uw contracttypegegevens voor #

Open de CSV-sjabloon (of uw geëxporteerde bestand) in uw spreadsheetprogramma — wij raden Google Sheets aan boven Excel.

Identiteitskolommen #

Elke rij moet minstens één van naam of code hebben. Als alleen een code wordt gegeven (geen naam), moet het contracttype al in het systeem bestaan. Als de code wordt weggelaten, wordt deze automatisch gegenereerd op basis van de naam.

Regelconfiguratie #

Toewijzingstypen #

Zie regelacties in Contracten maken en beheren voor details over wat elk toewijzingstype betekent.

Voorwaardenkolommen (allemaal optioneel) #

Elke voorwaarde heeft een operator en een waarde. Als een operator wordt gegeven, is de bijbehorende waarde vereist.

Numerieke operators (kortingspercentage, verkochte eenheden, netto-ontvangsten) #

Tip: Voor de between-operator gebruikt u het formaat min-max (bijv. 10-50).

Landoperators #

Ondersteunt: equals (=), is-not-equal (!=), is-one-of (in), is-not-one-of (not in)

Landwaarden moeten ISO-landcodes zijn (2–3 letters), gescheiden door komma’s. Deze worden automatisch in hoofdletters omgezet.

Voorzichtig met automatische opmaak in spreadsheets #

Excel en andere spreadsheetprogramma’s kunnen uw gegevens op manieren automatisch opmaken die deze beschadigen. Veelvoorkomende problemen zijn lange getallen die worden omgezet naar wetenschappelijke notatie en datums die worden opnieuw opgemaakt.

Tip: Format alle cellen als tekst voordat u gegevens invoert of plakt. Zie Inleiding tot importeren voor gedetailleerde instructies.

Voorbeelden #

Eenvoudig percentagecontract #

Contract met getrapte regels #

Regelprioriteit 3 heeft geen voorwaarden, dus fungeert als standaardopvangoptie voor verkoop onder 500 eenheden. Zie getrapte royalties voor meer informatie over getrapte royalties.

Landgebaseerd contract #

Vastgesteld tarief contract #

Upload uw contracttypen CSV #

Wanneer u uw gegevens hebt dubbel gecontroleerd, slaat u het bestand op als CSV. In Google Sheets is dit Bestand > Downloaden > CSV.

1. Ga naar het hoofdmenu (linksboven) en klik op Import.
2. Kies onder ‘Wat laadt u op?’ de optie ‘Contract Types’.
3. Klik onder ‘Kies uw bestand’ op ‘Bladeren’ en navigeer naar uw CSV-bestand.
4. Klik op ‘Volgende’.
5. Het bestand wordt geüpload en gevalideerd (gecontroleerd op problemen). U ziet de resultaten op een voorbeeldpagina.
6. Als de resultaten er goed uitzien, klikt u op ‘Doorgaan’ en worden de contracttypen geïmporteerd (of als in de voorbeeldstap problemen worden gemarkeerd, moet u de gegevens corrigeren — lees het foutbericht en controleer de vereisten hierboven).

Dry run-voorbeeld #

Voordat de import wordt toegepast, ziet u een samenvatting met:

• Nieuwe contracttypen die worden aangemaakt (met regeltellingen)
• Bestaande contracttypen die worden bijgewerkt (met oude versus nieuwe regeltellingen)
• Validatiefouten die moeten worden opgelost

U moet de import bevestigen voordat wijzigingen worden opgeslagen.

Validatie #

De import voert validatie uit voordat wijzigingen worden aangebracht:

• Naam of code — minstens één moet per rij worden gegeven
• Toewijzingstype — moet een herkend type zijn
• Percentage — vereist voor percentagegebaseerde typen, moet 0–100 zijn
• Vast bedrag — vereist voor vast bedrag per eenheid, moet groter zijn dan 0
• Operators — moeten geldig zijn, indien gegeven
• Waarden — vereist wanneer een operator is opgegeven
• Landcodes — moeten 2–3 letter ISO-codes zijn
• Regelprioriteiten — moeten uniek zijn binnen elk contracttype
• Between-waarden — moeten het formaat min-max gebruiken met twee getallen

Contracttypen in bulk bijwerken #

U kunt het bovenstaande proces ook gebruiken om bestaande contracttypen in bulk bij te werken.

Wanneer een contracttype-code in de CSV overeenkomt met een bestaande record:

• De naam en beschrijving worden bijgewerkt (indien gegeven)
• Alle bestaande regels worden vervangen door de regels uit de CSV — dit is een volledige vervanging, dus alle regels die niet in de CSV staan, worden verwijderd

Tips #

• Gebruik de download van template CSV om de juiste kolomkoppen te krijgen
• Gebruik de exportfunctie om uw huidige contracttypen als uitgangspunt voor bewerkingen te downloaden
• Kolomnamen zijn flexibel — veel aliassen worden geaccepteerd (zie de tabellen hierboven)
• Operators kunnen als symbolen (>, >=) of woorden (greater than, at least) worden geschreven
• Lege voorwaardenkolommen worden genegeerd — voeg alleen voorwaarden toe die u nodig hebt
• Regelprioriteit is optioneel — regels worden automatisch genummerd indien weggelaten

Wat nu? #

Zodra uw contracttypen zijn ingesteld, kunt u ze aan rechthebbenden en producten koppelen door contract usage te importeren.