> ## 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 des clients depuis un CSV

> Téléversez en masse des enregistrements clients dans Qwoty à l'aide d'un fichier CSV

{/* AUDIT NOTE: Import functionality not found in the tested account. The Customer list only shows a "+ New" button and a search bar — no Import button visible. The feature may require additional permissions or may not be enabled on this account. All step labels remain as TODOs. Nav path confirmed: Customer > Customer (not "Customers"). */}

L'importation de clients depuis un fichier CSV vous permet d'ajouter rapidement plusieurs enregistrements clients dans Qwoty sans saisie manuelle. Vous pouvez importer des informations client de base, des données de facturation et des champs personnalisés en une seule opération.

## Prérequis

Avant de commencer, assurez-vous de disposer des éléments suivants :

* Un fichier CSV contenant les données clients
* Des permissions de rôle Administrateur ou Responsable
* Des en-têtes de colonnes correspondant aux noms de champs clients de Qwoty

<Tip>Téléchargez le modèle CSV depuis Qwoty pour vous assurer que votre fichier respecte le format correct et contient les colonnes requises.</Tip>

## Accéder à l'outil d'importation

Naviguez vers **Customer** → **Customer** dans le menu latéral gauche, puis cliquez sur **\[BUTTON LABEL]** {/* TODO: verify import button label — not visible in tested account */} dans le coin supérieur droit.

## Préparer votre fichier CSV

<Steps>
  <Step title="Télécharger le modèle">
    Cliquez sur **\[BUTTON LABEL]** {/* TODO: verify download template button */} pour obtenir un modèle CSV contenant tous les champs disponibles et le format de colonnes correct.
  </Step>

  <Step title="Mettre en forme vos données">
    Ouvrez le modèle et renseignez les informations de vos clients. Les colonnes obligatoires comprennent :

    * **\[FIELD NAME]** {/* TODO: verify required field - likely "Company Name" or "Customer Name" */}
    * **\[FIELD NAME]** {/* TODO: verify required field - likely "Email" */}

    Les colonnes facultatives peuvent inclure l'adresse de facturation, le numéro de téléphone, le numéro de TVA, le segment client et les champs personnalisés.
  </Step>

  <Step title="Enregistrer le fichier">
    Enregistrez votre fichier au format CSV (encodage UTF-8 recommandé) et fermez tout programme l'ayant ouvert.
  </Step>
</Steps>

<Warning>Vérifiez que les adresses e-mail sont uniques. Les e-mails en doublon entraîneront l'omission de ces lignes ou la mise à jour des enregistrements existants selon vos paramètres.</Warning>

## Importer le fichier

<Steps>
  <Step title="Téléverser votre CSV">
    Cliquez sur **\[BUTTON LABEL]** {/* TODO: verify upload button or drag-drop zone label */} et sélectionnez votre fichier CSV préparé. Qwoty valide le format du fichier et affiche un aperçu.
  </Step>

  <Step title="Associer les champs">
    Examinez l'écran d'association des champs. Qwoty associe automatiquement les colonnes CSV aux champs clients en fonction des noms d'en-têtes. Corrigez les associations incorrectes à l'aide des menus déroulants.
  </Step>

  <Step title="Définir les options d'importation">
    Choisissez le comportement d'importation :

    * **\[OPTION NAME]** : {/* TODO: verify option label - likely "Skip duplicates" */} Ignore les lignes dont l'adresse e-mail existe déjà
    * **\[OPTION NAME]** : {/* TODO: verify option label - likely "Update existing" */} Écrase les données clients existantes avec les valeurs du CSV
    * **\[OPTION NAME]** : {/* TODO: verify option label - likely "Create only" */} Ajoute uniquement les nouveaux clients
  </Step>

  <Step title="Lancer l'importation">
    Cliquez sur **\[BUTTON LABEL]** {/* TODO: verify final confirmation button - likely "Import" or "Start Import" */} pour démarrer le traitement. Un indicateur de progression affiche l'état du téléversement.
  </Step>
</Steps>

## Ce qui se passe ensuite

Qwoty traite le fichier CSV et affiche un résumé d'importation indiquant :

* Le nombre de clients créés avec succès
* Le nombre de clients existants mis à jour
* Le nombre de lignes ignorées en raison d'erreurs

Vous pouvez télécharger un rapport d'erreurs si certaines lignes n'ont pas passé la validation. Les clients importés avec succès apparaissent immédiatement dans votre liste de clients et sont disponibles pour la création de devis.

## Résolution des problèmes

<AccordionGroup>
  <Accordion title="L'importation échoue avec une erreur de format">
    Vérifiez que votre CSV utilise des séparateurs virgule, l'encodage UTF-8 et que la ligne d'en-têtes se trouve bien en première ligne. Évitez les caractères spéciaux dans les noms de colonnes qui ne correspondent pas exactement au modèle.
  </Accordion>

  <Accordion title="Certaines lignes sont ignorées">
    Téléchargez le rapport d'erreurs pour identifier les lignes ayant échoué et la raison. Les problèmes courants incluent des champs obligatoires manquants, des formats d'e-mail invalides ou des données dépassant les limites de longueur des champs.
  </Accordion>

  <Accordion title="Des clients en doublon sont créés">
    Cela se produit lorsque les adresses e-mail présentent de légères variations (espaces superflus, casse différente). Nettoyez vos données pour garantir la cohérence des e-mails avant l'importation, ou utilisez le mode mise à jour pour fusionner les enregistrements.
  </Accordion>

  <Accordion title="Les champs personnalisés ne s'importent pas">
    Vérifiez que les noms de colonnes des champs personnalisés correspondent exactement aux noms de champs définis dans **\[MENU PATH]** {/* TODO: verify settings location - likely Settings > Custom Fields */}. Les champs personnalisés doivent être créés avant d'y importer des données.
  </Accordion>
</AccordionGroup>

## Ressources associées

<CardGroup cols={2}>
  <Card title="Créer un client" icon="user-plus" href="/user-guide/customers/how-tos/create-customer">
    Ajouter des enregistrements clients individuels manuellement
  </Card>

  <Card title="Gérer les données clients" icon="pen-to-square" href="/user-guide/customers/reference/customer-record">
    Modifier et mettre à jour les informations clients
  </Card>

  <Card title="Vue d'ensemble des clients" icon="building" href="/user-guide/customers/reference/segments">
    En savoir plus sur la gestion des clients dans Qwoty
  </Card>

  <Card title="Exporter les clients" icon="file-export" href="/user-guide/customers/reference/segments">
    Télécharger les données clients au format CSV
  </Card>
</CardGroup>