> ## 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.

# Importer vos données

> Importez vos produits, prix et clients existants dans Qwoty à l'aide de fichiers CSV.

Si vous disposez déjà d'un catalogue de produits, d'une liste de prix ou d'une base de clients dans un autre outil, les importer dans Qwoty est plus rapide que de tout ressaisir manuellement. L'assistant d'import CSV de Qwoty gère les trois objets principaux dont vous avez besoin pour commencer à créer des devis.

**Durée :** \~30 minutes pour une migration classique (petit catalogue, quelques centaines de clients)

<Note>
  Vous devez disposer du rôle **Admin** avec l'autorisation **Import CSV** activée dans vos permissions Apps. Voir [Gérer les rôles](/user-guide/settings/users/manage-roles).
</Note>

## Quoi importer — et dans quel ordre

Qwoty impose un ordre d'import strict car les objets se référencent mutuellement. Exécutez-les séquentiellement :

<Steps>
  <Step title="Produits maîtres">
    Les produits maîtres sont les **parents** qui regroupent les variantes. Même les produits à variante unique passent d'abord par cet objet. Importez-les via **Paramètres → Données → Importer/Exporter des données → Produits maîtres**.

    Voir le [guide complet](/user-guide/data-migration/how-tos/import-master-products).
  </Step>

  <Step title="Produits (variantes)">
    Une fois les maîtres créés, importez les variantes qui les référencent — tailles, couleurs, configurations, ou simplement la variante unique d'un produit simple.

    Voir le [guide complet](/user-guide/data-migration/how-tos/import-products).
  </Step>

  <Step title="Prix">
    Vos produits étant en place, associez des prix à un ou plusieurs catalogues de prix. Qwoty prend en charge les tarifications fixe, par paliers, récurrente, en pourcentage, basée sur les coûts et provisoire.

    Voir le [guide complet](/user-guide/data-migration/how-tos/import-prices).
  </Step>

  <Step title="Clients (flux séparé)">
    Les clients ne dépendent pas du catalogue et peuvent être importés à tout moment, avant ou après les produits. Utilisez l'import **Clients** depuis la page clients.

    Voir le [guide d'import des clients](/user-guide/customers/how-tos/import-csv).
  </Step>
</Steps>

<Warning>
  **Ne sautez pas l'ordre pour le catalogue.** Importer des prix avant les produits échoue car il n'y a rien auquel rattacher les prix. Importer des variantes avant les maîtres échoue car il n'y a pas de parent. Exécutez toujours dans l'ordre : Produits maîtres → Produits → Prix.
</Warning>

## Avant de commencer

Une liste de vérification de 10 minutes qui prévient 90 % des erreurs d'import :

* [ ] Exportez vos données depuis votre outil existant au format CSV
* [ ] Assurez-vous que votre fichier utilise l'encodage **UTF-8** (évitez l'encodage régional par défaut d'Excel)
* [ ] Utilisez la **virgule `,`** comme séparateur de champ
* [ ] Créez d'abord les **Catalogues**, **Catégories** et **Catalogues de prix** dans Qwoty (via l'interface) — vos CSV les référencent par nom d'API
* [ ] Ajoutez les **champs personnalisés** dont vous avez besoin sous **Paramètres → Données → Modèle de données** avant l'import — l'envoi d'un CSV crée des enregistrements mais ne crée pas de champs

Pour un guide de préparation complet, incluant les formats de champs, les règles de validation et la liste de vérification finale, consultez [Préparer vos fichiers CSV](/user-guide/data-migration/how-tos/prepare-csv-files).

## L'assistant d'import

Chaque import suit le même flux en 4 étapes :

1. **Téléversement** — déposez votre CSV. Téléchargez le modèle si vous n'en avez pas.
2. **Mappage** — associez vos en-têtes aux champs Qwoty. Mappage automatique lorsque les noms correspondent.
3. **Confirmation** — vérifiez le nombre de lignes qui seront importées par rapport aux lignes contenant des erreurs.
4. **Résultat** — consultez ce qui a réussi. Téléchargez les lignes non importées en CSV si certaines ont échoué.

Les erreurs ne bloquent pas les lignes valides. Corrigez les lignes en erreur dans votre fichier source et renvoyez-le.

## Conseils pour une migration réussie

**Testez d'abord avec un petit lot.** Importez 5 à 10 lignes depuis un échantillon avant d'en envoyer des milliers. Corrigez tout problème systématique une fois, puis lancez le lot complet.

**Conservez votre fichier source comme référence.** Sauvegardez-en une copie avant chaque import. En cas de problème, vous pouvez le comparer aux lignes non importées que Qwoty vous retourne.

**Utilisez les noms d'API, pas les noms d'affichage.** Lorsque vous liez des produits à des catalogues ou des prix à des catalogues de prix, le nom d'API est l'identifiant stable — le nom d'affichage peut changer, le nom d'API ne devrait pas.

**Vous migrez depuis un CRM ?** Si vous connectez un CRM ultérieurement (HubSpot, Salesforce, Pipedrive), les enregistrements clients peuvent se synchroniser automatiquement. Vous pouvez choisir d'importer les clients via CSV maintenant et laisser le CRM prendre le relais plus tard via le [mappage CRM](/user-guide/data-model/reference/crm-mapping).

## Et ensuite

Une fois vos données dans Qwoty, vous avez tout ce qu'il vous faut pour envoyer votre premier devis.

<CardGroup cols={2}>
  <Card title="Envoyer votre premier devis" icon="file-invoice-dollar" href="/getting-started/setup/first-quote">
    Utilisez vos produits et clients importés pour créer et publier un devis.
  </Card>

  <Card title="Configurer les intégrations" icon="puzzle-piece" href="/getting-started/setup/integrations">
    Connectez Qwoty à votre CRM, vos outils de facturation et de messagerie.
  </Card>

  <Card title="Guide complet de migration des données" icon="database" href="/user-guide/data-migration/introduction">
    Tous les imports, toutes les options, la gestion des erreurs et la documentation de référence.
  </Card>

  <Card title="Personnaliser votre modèle de données" icon="diagram-project" href="/user-guide/data-model/introduction">
    Ajoutez des champs personnalisés pour capturer des données spécifiques à votre activité.
  </Card>
</CardGroup>