> For the complete documentation index, see [llms.txt](https://docs.thewalletcrew.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.thewalletcrew.io/configure/fr/advanced-configuration/wallet/importation-et-exportation.md).

# Importation et exportation

## Importez vos cartes dans The Wallet Crew

The Wallet Crew fournit un puissant outil d'importation qui vous permet d'importer ou de mettre à jour des cartes en masse à l'aide de fichiers XLSX. Ce guide vous accompagnera tout au long du processus et expliquera les points importants à prendre en compte.

### Vue d’ensemble

L'outil d'importation prend en charge :

* Création en masse de nouvelles cartes
* Mise à jour des cartes existantes
* Gestion de différents types de cartes
* Gestion des identifiants de carte et des données supplémentaires
* Suivi de la progression et rapport d'erreurs

### Avant de commencer

1. **Format de fichier**: Préparez votre fichier XLSX en tenant compte des éléments suivants :
   * Les noms de colonne doivent être propres et éviter les caractères spéciaux
   * Les données doivent être correctement formatées selon les types attendus
   * Le fichier doit contenir toutes les informations nécessaires sur les cartes
2. **Colonnes requises**:
   * `id` (facultatif) : Si elle est présente, utilisée pour identifier les cartes existantes
   * `passType` (facultatif) : Le type de carte. Si non spécifié, vous devrez sélectionner un type par défaut
   * Les autres colonnes seront traitées comme des données supplémentaires
3. **Validation des données**:
   * Les adresses e-mail doivent être correctement formatées
   * Les numéros de téléphone doivent respecter les formats standard
   * Les dates doivent être dans un format cohérent

### Processus d'importation

#### Étape 1 : Accédez à l'outil d'importation

1. Accédez à la **Cartes** section de votre compte Wallet Crew
2. Cliquez sur le **Importer des cartes** bouton
3. Sélectionnez votre fichier XLSX\
   ![Passes List](/files/ba4ef1f44845c30a8a84c8fad3f214644cc545e1)

#### Étape 2 : Configurez les paramètres d'importation

La fenêtre modale d'importation vous présentera deux paramètres importants :

1. **Colonne discriminante**:
   * Si votre fichier contient une `id` colonne, elle sera automatiquement sélectionnée
   * Sinon, choisissez une colonne qui identifie chaque carte de manière unique
   * Cette colonne sera utilisée pour déterminer si une carte doit être créée ou mise à jour
2. **Type de Carte par défaut**:
   * Sélectionnez le type de carte par défaut pour les cartes qui n'en spécifient pas
   * Ceci est requis si votre fichier n'inclut pas de `passType` colonne

#### Étape 3 : Vérifiez et importez

1. Vérifiez le nombre total de cartes à importer
2. Vérifiez que les paramètres de colonne discriminante et de type de carte sont corrects
3. Cliquez **Importez** pour lancer le processus\
   ![Import Modal](/files/9d6919bb895a9d3ef1ff0883912873db7e60929c)

#### Étape 4 : Surveillez la progression

Pendant l'importation :

* Une barre de progression affiche l'état actuel
* Vous pouvez voir le nombre de cartes créées et mises à jour
* Toute erreur est affichée en temps réel
* Vous pouvez annuler l'importation à tout moment\
  ![Import Progress](/files/8e844e1bae2c2fa5d86623d5e0ccc905a91f4079)

### Remarques importantes

1. **Traitement par lots**:
   * Les cartes sont importées par lots de 16 pour des performances optimales
   * Le processus continue même si certaines cartes échouent à l'importation
2. **Gestion des erreurs**:
   * Les formats de données invalides sont signalés
   * Les champs obligatoires manquants sont mis en évidence
   * Vous pouvez examiner les erreurs et apporter des corrections
3. **Annulation**:
   * Vous pouvez annuler l'importation à tout moment
   * La fenêtre du navigateur doit rester ouverte pendant le processus
4. **Traitement des données**:
   * Les valeurs vides sont converties en `null`
   * Les colonnes spéciales (id, secret, creationDate, etc.) sont exclues des données supplémentaires
   * Les champs de métadonnées sont traités séparément

### Après l'importation

1. La page se rafraîchira automatiquement pour afficher les cartes mises à jour une fois la fenêtre modale fermée
2. Vous pouvez consulter le rapport d'importation indiquant :
   * Le nombre de cartes créées
   * Le nombre de cartes mises à jour
   * Les erreurs éventuelles survenues

### Bonnes pratiques

1. **Préparation des données**:
   * Nettoyez vos données avant l'importation
   * Utilisez un formatage cohérent
   * Validez les adresses e-mail et les numéros de téléphone
2. **Structure du fichier**:
   * Gardez des noms de colonne simples et clairs
   * Utilisez des formats de date standard
   * Incluez tous les champs requis
3. **Imports volumineux**:
   * Pour les gros fichiers, envisagez de les découper en lots plus petits
   * Surveillez la progression et vérifiez les erreurs
   * Laissez la fenêtre du navigateur ouverte pendant l'importation

### Dépannage

Si vous rencontrez des problèmes :

1. Consultez le rapport d'erreurs pour identifier des problèmes précis
2. Vérifiez le format de votre fichier et les données
3. Assurez-vous que tous les champs requis sont présents
4. Essayez d'importer un lot plus petit pour tester


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.thewalletcrew.io/configure/fr/advanced-configuration/wallet/importation-et-exportation.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
