Documentation

Importer les types de contrats

Importation en masse ou mise à jour des types de contrats (ensembles de règles de redevances) à l'aide d'un modèle CSV, avec support des règles échelonnées, des conditions et de plusieurs types d'allocation.

Les types de contrats définissent les règles de droits d’auteur qui déterminent comment les revenus sont alloués aux titulaires de droits. Vous pouvez créer et mettre à jour les types de contrats en masse à l’aide de la fonction de téléchargement CSV — idéale lors de la mise en place de plusieurs accords de droits d’auteur à la fois.

Les types de contrats sont réutilisables — une fois créés, un seul type de contrat peut être lié à plusieurs titulaires de droits et produits via l’importation d’utilisation de contrats, ce qui vous évite de saisir les mêmes conditions contractuelles plusieurs fois. Pour cette raison, les types de contrats doivent être importés avant l’utilisation du contrat.

Si vous ne devez créer qu’un ou deux types de contrats, vous préférerez peut-être les créer via l’interface utilisateur.

Vous découvrez les contrats ? Lisez d’abord l’aperçu des contrats pour comprendre comment les contrats, les règles et les conditions fonctionnent ensemble.

Télécharger le modèle CSV

Un modèle CSV peut être téléchargé à partir de la page d’importation des types de contrats :

  1. Allez au menu principal, en haut à gauche, et cliquez sur Importer.
  2. Sous « Que téléchargez-vous ? », choisissez « Types de contrats ».
  3. Cliquez sur �� Télécharger le fichier modèle de types de contrats ».
  4. Le fichier modèle CSV sera téléchargé sur votre appareil.

Vous pouvez également exporter tous les types de contrats existants à partir de la même page. Ceci est utile si vous souhaitez mettre à jour les types de contrats en masse — exportez, modifiez les données dans votre logiciel de feuille de calcul, puis réimportez.

Comment fonctionnent les importations de types de contrats

Chaque ligne du CSV représente une seule règle au sein d’un type de contrat. Plusieurs lignes portant le même nom ou le même code sont regroupées en tant que règles sous un type de contrat.

  • Les règles sont évaluées dans l’ordre par priorité — la première règle correspondante est utilisée pour l’allocation
  • Une règle sans conditions agit comme valeur par défaut générale
  • Si un code de type de contrat existe déjà, ses règles seront remplacées par celles du fichier

Pour plus d’informations sur le fonctionnement des règles et des conditions lors des exécutions de droits d’auteur, consultez l’aperçu des contrats.

Préparez vos données de types de contrats

Ouvrez le modèle CSV (ou votre fichier exporté) dans votre logiciel de feuille de calcul — nous recommandons Google Sheets plutôt qu’Excel.

Colonnes d’identité

ColonneAliasRequisDescription
namecontract-type, contract-name, contract-type-nameVoir noteLe nom d’affichage du type de contrat
codecontract-code, contract-type-codeVoir noteIdentifiant unique (auto-slugifié)
descriptionNonDescription libre

Chaque ligne doit avoir au moins l’un de name ou code. Si seul un code est donné (pas de nom), le type de contrat doit déjà exister dans le système. Si le code est omis, il est généré automatiquement à partir du nom.

Configuration des règles

ColonneAliasRequisDescription
rule-priorityorder, rule-order, rulepriorityNonOrdre d’évaluation (à partir de 0). Auto-incrémenté s’il est omis
allocation-typetype, allocationtype, allocationOuiComment les droits d’auteur sont calculés (voir ci-dessous)
allocation-percentagepercentage, percent, rate, royalty-rateConditionnelRequis pour les types basés sur un pourcentage (0–100)
allocation-fixed-pricefixed-price, price-per-unit, fixedpriceConditionnelRequis pour le type prix fixe par unité — doit être supérieur à 0

Types d’allocation

TypeAliasNécessite
net-receiptsnet receipts, netPourcentage (0–100)
list-pricelist price, list, rrpPourcentage (0–100)
list-price-minus-discountlist price minus discountPourcentage (0–100)
fixed-price-per-unitfixed price per unit, fixed price, fixedPrix fixe (supérieur à 0)
no-allocationno allocation, noneRien

Pour plus de détails sur la signification de chaque type d’allocation, consultez les actions de règles dans Créer et gérer les contrats.

Colonnes de conditions (toutes optionnelles)

Chaque condition a un opérateur et une valeur. Si un opérateur est fourni, sa valeur correspondante est requise.

Colonne d’opérateurColonne de valeurDescription
discount-rate-operatordiscount-rate-valueFiltrer par taux de remise
sale-country-operatorsale-country-value (alias : country, countries)Filtrer par pays (codes ISO)
units-sold-operatorunits-sold-valueFiltrer par unités vendues
total-net-receipts-operatortotal-net-receipts-valueFiltrer par total des revenus nets

Opérateurs numériques (taux de remise, unités vendues, revenus nets)

OpérateurSymboleAlias en mots
Supérieur à>greater than, more than
Supérieur ou égal à>=at least
Inférieur à<less than
Inférieur ou égal à<=at most
Égal à=is, equals, equal to
Non égal à!=is not, not equal to
Entrebetween
Un parmiin, one of
Aucun parminot in, not one of

Conseil : Pour l’opérateur between, utilisez le format min-max (par ex. 10-50).

Opérateurs de pays

Prend en charge : equals (=), is-not-equal (!=), is-one-of (in), is-not-one-of (not in)

Les valeurs de pays doivent être des codes pays ISO (2–3 lettres), séparés par des virgules. Ils sont automatiquement convertis en majuscules.

Attention à la mise en forme automatique des feuilles de calcul

Excel et d’autres logiciels de feuille de calcul peuvent formater automatiquement vos données d’une manière qui les corrompt. Les problèmes courants incluent les longs nombres convertis en notation scientifique et les dates reformatées.

Conseil : Formatez toutes les cellules en texte avant d’entrer ou de coller des données. Pour des instructions détaillées, consultez Introduction à l’importation.

Exemples

Contrat de pourcentage simple

nameallocation-typeallocation-percentage
Standard Authornet-receipts25

Contrat avec règles échelonnées

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

La priorité de la règle 3 n’a pas de conditions, elle agit donc comme valeur par défaut générale pour les ventes inférieures à 500 unités. Pour plus d’informations sur les droits d’auteur échelonnés, consultez droits d’auteur échelonnés.

Contrat basé sur le pays

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

Contrat à prix fixe

nameallocation-typeallocation-fixed-price
Fixed Ratefixed-price-per-unit1.50

Téléchargez votre CSV de types de contrats

Lorsque vous avez vérifié vos données, enregistrez le fichier en CSV. Dans Google Sheets, c’est Fichier > Télécharger > CSV.

  1. Allez au menu principal, en haut à gauche, et cliquez sur Importer.
  2. Sous « Que téléchargez-vous ? », choisissez « Types de contrats ».
  3. Sous « Choisir votre fichier » cliquez sur « Parcourir » et accédez à votre fichier CSV.
  4. Cliquez sur « Suivant ».
  5. Le fichier sera téléchargé et validé (vérifié pour les problèmes). Vous verrez les résultats sur une page d’aperçu.
  6. Si les résultats semblent bons, cliquez sur « Continuer » et les types de contrats seront importés (ou, si l’étape d’aperçu met en évidence des problèmes, vous devrez corriger les données — lisez le message d’erreur et vérifiez les exigences ci-dessus).

Aperçu d’exécution à blanc

Avant l’application de l’importation, vous verrez un résumé montrant :

  • Nouveaux types de contrats à créer (avec le nombre de règles)
  • Types de contrats existants à mettre à jour (montrant l’ancien vs le nouveau nombre de règles)
  • Toute erreur de validation qui doit être corrigée

Vous devez confirmer l’importation avant que toute modification ne soit enregistrée.

Validation

L’importation exécute la validation avant toute modification :

  • Nom ou code — au moins un doit être fourni par ligne
  • Type d’allocation — doit être un type reconnu
  • Pourcentage — requis pour les types basés sur un pourcentage, doit être 0–100
  • Prix fixe — requis pour prix fixe par unité, doit être supérieur à 0
  • Opérateurs — doivent être valides s’ils sont fournis
  • Valeurs — requises quand un opérateur est spécifié
  • Codes de pays — doivent être des codes ISO à 2–3 lettres
  • Priorités des règles — doivent être uniques au sein de chaque type de contrat
  • Valeurs entre — doivent utiliser le format min-max avec deux nombres

Mettre à jour les types de contrats en masse

Vous pouvez également utiliser le processus ci-dessus pour mettre à jour les types de contrats existants en masse.

Quand un code de type de contrat dans le CSV correspond à un enregistrement existant :

  • Le nom et la description sont mis à jour (s’ils sont fournis)
  • Toutes les règles existantes sont remplacées par les règles du CSV — c’est un remplacement complet, donc toute règle ne figurant pas dans le CSV sera supprimée

Conseils

  • Utilisez le téléchargement modèle CSV pour obtenir les en-têtes de colonnes corrects
  • Utilisez la fonction exporter pour télécharger vos types de contrats actuels comme point de départ pour les modifications
  • Les noms de colonnes sont flexibles — de nombreux alias sont acceptés (voir les tableaux ci-dessus)
  • Les opérateurs peuvent être écrits en symboles (>, >=) ou en mots (greater than, at least)
  • Les colonnes de conditions vides sont ignorées — ajoutez uniquement les conditions dont vous avez besoin
  • La priorité des règles est optionnelle — les règles sont numérotées automatiquement si elle est omise

Prochaines étapes

Une fois vos types de contrats configurés, vous pouvez les lier à des titulaires de droits et des produits en important l’utilisation des contrats.