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 :
- Allez au menu principal, en haut à gauche, et cliquez sur Importer.
- Sous « Que téléchargez-vous ? », choisissez « Types de contrats ».
- Cliquez sur �� Télécharger le fichier modèle de types de contrats ».
- 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é
| Colonne | Alias | Requis | Description |
|---|---|---|---|
| name | contract-type, contract-name, contract-type-name | Voir note | Le nom d’affichage du type de contrat |
| code | contract-code, contract-type-code | Voir note | Identifiant unique (auto-slugifié) |
| description | — | Non | Description 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
| Colonne | Alias | Requis | Description |
|---|---|---|---|
| rule-priority | order, rule-order, rulepriority | Non | Ordre d’évaluation (à partir de 0). Auto-incrémenté s’il est omis |
| allocation-type | type, allocationtype, allocation | Oui | Comment les droits d’auteur sont calculés (voir ci-dessous) |
| allocation-percentage | percentage, percent, rate, royalty-rate | Conditionnel | Requis pour les types basés sur un pourcentage (0–100) |
| allocation-fixed-price | fixed-price, price-per-unit, fixedprice | Conditionnel | Requis pour le type prix fixe par unité — doit être supérieur à 0 |
Types d’allocation
| Type | Alias | Nécessite |
|---|---|---|
| net-receipts | net receipts, net | Pourcentage (0–100) |
| list-price | list price, list, rrp | Pourcentage (0–100) |
| list-price-minus-discount | list price minus discount | Pourcentage (0–100) |
| fixed-price-per-unit | fixed price per unit, fixed price, fixed | Prix fixe (supérieur à 0) |
| no-allocation | no allocation, none | Rien |
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érateur | Colonne de valeur | Description |
|---|---|---|
| discount-rate-operator | discount-rate-value | Filtrer par taux de remise |
| sale-country-operator | sale-country-value (alias : country, countries) | Filtrer par pays (codes ISO) |
| units-sold-operator | units-sold-value | Filtrer par unités vendues |
| total-net-receipts-operator | total-net-receipts-value | Filtrer par total des revenus nets |
Opérateurs numériques (taux de remise, unités vendues, revenus nets)
| Opérateur | Symbole | Alias 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 |
| Entre | — | between |
| Un parmi | — | in, one of |
| Aucun parmi | — | not 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
| name | allocation-type | allocation-percentage |
|---|---|---|
| Standard Author | net-receipts | 25 |
Contrat avec règles échelonnées
| 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é 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
| 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 |
Contrat à prix fixe
| name | allocation-type | allocation-fixed-price |
|---|---|---|
| Fixed Rate | fixed-price-per-unit | 1.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.
- Allez au menu principal, en haut à gauche, et cliquez sur Importer.
- Sous « Que téléchargez-vous ? », choisissez « Types de contrats ».
- Sous « Choisir votre fichier » cliquez sur « Parcourir » et accédez à votre fichier CSV.
- Cliquez sur « Suivant ».
- 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.
- 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-maxavec 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.