> 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/import-and-export.md).

# Importation et exportation

Importez et mettez à jour en masse des Cartes Apple Wallet et Google Wallet à partir de fichiers XLSX, et consultez le rapport d'importation pour détecter les erreurs.

## Importer des cartes vers The Wallet Crew

The Wallet Crew fournit un puissant outil d'importation pour importer ou mettre à jour des cartes en masse à l'aide de fichiers XLSX. Ce guide explique le processus et les considérations importantes.

### Aperçu

L'outil d'importation prend en charge :

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

### Avant de commencer

1. **Format du fichier**: Préparez le fichier XLSX en tenant compte des éléments suivants :
   * Les noms de colonnes 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 la carte
2. **Colonnes requises**:
   * `id` (facultatif) : Si elle est présente, utilisée pour identifier les cartes existantes
   * `passType` (facultatif) : Le type de carte. Si aucun n'est spécifié, un type par défaut doit être sélectionné
   * 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éder à l'outil d'importation

1. Accédez à la **Cartes** section dans The Wallet Crew
2. Cliquez sur le **Importer des cartes** bouton
3. Sélectionnez le fichier XLSX

<figure><img src="https://123508161-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDJrf9G0l7ArnvuwEH0a8%2Fuploads%2FQu0X3A09k1Z7oZjUVHjn%2Fconfigure-readme-passes-list.png?alt=media&#x26;token=16ae4dfb-061a-4405-a3c4-13b6589195ae" alt="Passes list with the Import Passes button"><figcaption><p>L'action Importer des cartes se trouve au-dessus de la liste des cartes.</p></figcaption></figure>

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

La fenêtre modale d'importation affiche deux paramètres importants :

1. **Colonne discriminante**:
   * Si le fichier contient une `id` colonne, elle est automatiquement sélectionnée
   * Sinon, choisissez une colonne qui identifie de manière unique chaque carte
   * 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 le fichier n'inclut pas de `passType` colonne

#### Étape 3 : Vérifier et importer

1. Vérifiez le nombre total de cartes à importer
2. Vérifiez que les paramètres de la colonne discriminante et du type de carte sont corrects
3. Cliquez **Importer** pour commencer le processus

<figure><img src="https://123508161-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDJrf9G0l7ArnvuwEH0a8%2Fuploads%2FOpu3xMYXM9gKKsQdBaQy%2Fconfigure-readme-import-modal.png?alt=media&#x26;token=adcb1cc2-42ef-4e5b-bcfa-9b92e070be2f" alt="Import modal showing the discriminator column and default pass type settings"><figcaption><p>Vérifiez la colonne discriminante et le type de carte par défaut avant de lancer l'importation.</p></figcaption></figure>

#### Étape 4 : Suivre la progression

Pendant l'importation :

* Une barre de progression affiche l'état actuel
* Le nombre de cartes créées et mises à jour est affiché
* Toutes les erreurs sont affichées en temps réel
* L'importation peut être annulée à tout moment

<figure><img src="https://123508161-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDJrf9G0l7ArnvuwEH0a8%2Fuploads%2FfGMpncWLZmbIU068AMwU%2Fconfigure-readme-import-progress.png?alt=media&#x26;token=2439463a-8501-478e-9ed6-1b753776c788" alt="Import progress screen with counts of created and updated passes"><figcaption><p>Surveillez les comptes de cartes créées, mises à jour et d'erreurs pendant l'exécution de l'importation.</p></figcaption></figure>

### Notes 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
   * Les erreurs peuvent être examinées et corrigées
3. **Annulation**:
   * L'importation peut être annulée à 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 s'actualisera automatiquement pour afficher les cartes mises à jour une fois la fenêtre modale fermée
2. Le rapport d'importation affiche :
   * Nombre de cartes créées
   * Nombre de cartes mises à jour
   * Toutes les erreurs survenues

### Bonnes pratiques

1. **Préparation des données**:
   * Nettoyez les 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 colonnes simples et clairs
   * Utilisez des formats de date standard
   * Incluez tous les champs obligatoires
3. **Importations volumineuses**:
   * Pour les gros fichiers, envisagez de les diviser en lots plus petits
   * Surveillez la progression et vérifiez les erreurs
   * Gardez la fenêtre du navigateur ouverte pendant l'importation

### Dépannage

En cas de problèmes :

1. Consultez le rapport d'erreurs pour identifier les problèmes spécifiques
2. Vérifiez le format du fichier et les données
3. Assurez-vous que tous les champs obligatoires 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.thewalletcrew.io/configure/fr/advanced-configuration/wallet/import-and-export.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.