> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qwoty.io/llms.txt
> Use this file to discover all available pages before exploring further.
# Mappage des champs
> Fonctionnement du mappage des champs lors de l'importation de données dans Qwoty.
## Fonctionnement du mappage des champs
Lorsque vous importez un fichier CSV, Qwoty analyse vos colonnes et tente de les faire correspondre aux champs existants de l'objet cible.
### Mappage automatique
Qwoty tente de faire correspondre les colonnes en se basant sur :
* Les noms d'en-tête de colonne (correspondances exactes ou similaires aux noms de champs de Qwoty)
* La détection du type de données (UUID, nombres, booléens, dates ISO)
* Les modèles de champs courants
**Conseil rapide :** exportez quelques lignes de l'objet que vous souhaitez importer. Le fichier exporté contiendra les noms de colonnes exacts attendus par Qwoty, ce qui rendra le mappage automatique transparent lors de l'importation.
### Options de mappage manuel
Pour chaque colonne, vous pouvez :
* **Mapper vers un champ** — sélectionnez le champ Qwoty correspondant dans une liste déroulante à l'étape **Mappage**
* **Ignorer cette colonne** — ignorer entièrement la colonne (les données ne seront pas importées)
**Les champs doivent exister avant l'importation.** L'importation crée des enregistrements, pas des champs. Créez des champs personnalisés sous **Paramètres → Données → Modèle de données** avant d'importer. Consultez la page [Modèle de données](/user-guide/data-model/introduction) pour plus de détails.
## Compatibilité des types de champs
Tous les types de champs disponibles dans le modèle de données de Qwoty sont pris en charge pour l'importation. Vous pouvez également importer des valeurs `id` (ou `product_id`, selon l'objet) pour attribuer un UUID spécifique à de nouveaux enregistrements ou mettre à jour des enregistrements existants.
## Exigences de format de données
Certains champs ont une syntaxe particulière. Nous recommandons de télécharger le **fichier exemple** depuis l'écran d'importation avant de préparer votre importation — il indique la syntaxe attendue pour chaque type de champ.
### Champs texte
* Aucun formatage particulier requis
* Les espaces en début et en fin de valeur sont supprimés automatiquement
* Si une valeur contient une virgule, un saut de ligne ou des guillemets, encadrez la cellule de guillemets doubles : `"Premium, Extra Large"`
### Champs numériques
* Chiffres uniquement
* Les décimales utilisent un point : `1234.56`
* Pas de séparateurs de milliers (pas `1,234.56`)
* Les nombres négatifs sont acceptés uniquement là où le champ le permet (la plupart des champs de prix exigent des valeurs positives)
### Champs booléens
Utilisez les valeurs en minuscules `true` ou `false` — s'applique aux champs comme `settings[is_active]`.
### Champs de date
Utilisez la norme ISO 8601 :
* `YYYY-MM-DD` (recommandé) — par exemple, `2026-04-25`
* `YYYY-MM-DDTHH:MM:SSZ` pour les horodatages
### Champs de devise
Utilisez le code ISO 4217 à trois lettres : `EUR`, `USD`, `GBP`, `JPY`. N'utilisez pas le symbole (`€`, `$`) ni le nom complet.
### Champs de taxe (TVA)
Utilisez le format `_` où le taux est exprimé sans virgule décimale (multiplié par 10) :
| Valeur | Signification |
| -------- | --------------------- |
| `FR_200` | France, TVA 20,0 % |
| `FR_055` | France, TVA 5,5 % |
| `DE_190` | Allemagne, TVA 19,0 % |
| `-` | Aucune taxe appliquée |
### Champs d'énumération (sélection)
Utilisez la **valeur exacte** attendue par Qwoty, en respectant la casse. Énumérations courantes :
| Champ | Valeurs acceptées |
| --------------------------- | ---------------------------------------------------------------------------- |
| `settings[recurrence_type]` | `one_off`, `recurring` |
| `settings[product_type]` | `physical`, `service`, `subscription` |
| `type` (prix) | `one-time`, `reccuring` |
| `pricing_model` | `Flat`, `Cost based`, `Percent`, `Graduated Tiered`, `Volume Tiered`, `None` |
| `period_unit` | `day`, `week`, `month`, `year` |
Les énumérations sont **sensibles à la casse**. `flat` est rejeté — utilisez `Flat`. `Recurring` est rejeté — utilisez `recurring`. Utilisez exactement les valeurs indiquées ci-dessus.
### Champs à valeurs multiples
Certains champs acceptent plusieurs valeurs dans une même cellule, séparées par des **virgules**, avec la cellule encadrée de guillemets doubles :
| Colonne | Exemple |
| -------------------- | -------------------------- |
| `catalog_api_names` | `"france,partner_pricing"` |
| `category_api_names` | `"hardware,accessories"` |
### Champs indexés (paliers, options, identifiants)
Qwoty utilise une notation entre crochets avec un index numérique pour les groupes de champs répétés. Deux conventions coexistent selon l'objet :
| Modèle | Base d'index | Exemple |
| ------------------ | ------------ | -------------------------------------------------------------- |
| Options de produit | Base 1 | `options[1][name]`, `options[1][value]`, `options[2][name]`... |
| Paliers de prix | Base 0 | `tiers[starting_unit][0]`, `tiers[starting_unit][1]`... |
Ajoutez `[1]`, `[2]`... ou `[0]`, `[1]`... selon le groupe de champs pour déclarer des lignes supplémentaires.
### Champs ID
La spécification d'un ID lors de l'importation est facultative. Qwoty génère automatiquement un UUID si aucun n'est fourni.
Cas d'utilisation pour le mappage d'une colonne ID :
* **Définir un ID spécifique** — choisissez l'UUID pour les enregistrements nouvellement créés
* **Mettre à jour des enregistrements existants** — faites correspondre les enregistrements existants pour les mettre à jour plutôt que de créer des doublons. Dans ce cas, mappez uniquement la colonne ID — ne la combinez pas avec d'autres champs uniques, afin de simplifier l'importation.
Si vous fournissez un ID, il doit être au format UUID (par exemple, `c776ee49-f608-4a77-8cc8-6fe96ae1e43f`).
### Champs de relation
Pour lier des enregistrements à leur objet parent ou connexe, consultez la page [Importer des relations](/user-guide/data-migration/reference/import-relations).
## Trouver les noms d'API
Pour les références aux Catalogues, Catégories et Grilles de prix, vous devez utiliser le **nom d'API** (et non le libellé d'affichage).
### Comment trouver les noms d'API
1. Ouvrez **Paramètres → Données → Modèle de données**
2. Sélectionnez l'objet (Catalogue, Catégorie, Grille de prix)
3. Consultez le nom d'API affiché dans la colonne **Nom d'API**
Vous pouvez également exporter l'objet en premier — le CSV exporté inclut les noms d'API dans les colonnes appropriées.
## Voir aussi
Formats de fichiers pris en charge et bonnes pratiques pour les CSV.
Quels champs sont uniques et comment Qwoty applique l'unicité.
Comment lier des enregistrements à leurs parents lors de l'importation.
Erreurs de validation et comment les corriger.