> 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/guides-monitoring/fr/monitor/pass-list.md).

# Liste des Cartes

Trouvez des Cartes dans la console d'administration par identifiant, type, modèle, métadonnées ou Wallet, puis agissez dessus une par une ou en lot, importez-les et exportez-les.

La liste des cartes affiche chaque carte du tenant. C'est le point de départ pour trouver la carte d'un client donné, vérifier un groupe de cartes après un problème, et agir sur plusieurs cartes à la fois : pousser une mise à jour, les exporter ou en importer de nouvelles.

Elle s'ouvre depuis **Wallet → Cartes** dans la console d'administration.

<figure><img src="https://1809963934-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEsokFUBfsbM9mlwavmMB%2Fuploads%2FBIgXFIuNpoovxWSFZ9Ea%2Fpass-list.png?alt=media&amp;token=6c71b665-33e5-41ec-9c60-87680c3cbc60" alt="Pass list with the view menu, search, Columns, Push update and Export, and columns for id, creation date, template, identifiers and Installed in"><figcaption><p>La liste des cartes avec son menu d'affichage, sa zone de recherche, ses filtres et sa barre d'outils.</p></figcaption></figure>

## Trouver une carte

Commencez avec l'identifiant déjà disponible dans le dossier client, puis affinez avec des filtres si nécessaire.

* Le **Affichage** menu, à gauche de la zone de recherche, affiche les cartes d'un type (Carte client, Carte de tampons, Offre, Carte cadeau, Billet d'événement, Générique) ou **Toutes les cartes**. Seuls les types utilisés par un modèle du tenant peuvent être choisis, et le choix est mémorisé dans le navigateur pour chaque tenant.
* Le **zone de recherche** recherche le texte dans plusieurs champs à la fois.
* **Filtres** s'appliquent à n'importe quelle colonne, avec des conditions adaptées à son type : contient, égal à, commence par, dans une liste, comparaisons, avant ou après une date, vide ou non vide.
* Le **Installé dans** le filtre sélectionne les cartes par Wallet : inclut Apple Wallet ou Google Wallet, n'importe quel Wallet, ou aucun Wallet.

Le tri et la pagination sont effectués sur le serveur, donc ils s'appliquent à toutes les cartes, pas seulement à la page chargée.

{% hint style="info" %}
Pour trouver la carte d'un client spécifique, recherchez ou filtrez sur l'identifiant envoyé lors de la création de la carte, par exemple un ID CRM, un numéro de fidélité ou une référence de réservation.
{% endhint %}

## Colonnes

Par défaut, la liste affiche l'identifiant de chaque carte, sa date de création, son modèle, les colonnes d'identifiant et **Installé dans** (les Wallets auxquels la carte a été ajoutée). Le **Colonnes** menu ajoute ou supprime des colonnes. Deux groupes de colonnes dépendent de la configuration du tenant :

* **Identifiants**: les clés qui relient chaque carte aux enregistrements dans d'autres systèmes ;
* **Métadonnées**: les valeurs calculées par chaque modèle (voir [onglet Général](https://docs.thewalletcrew.io/configure/fr/advanced-configuration/wallet/template-configuration/general-tab.md#metadata)).

Les deux peuvent être filtrés et triés comme n'importe quelle autre colonne.

## Agir sur une carte

Chaque ligne propose **Pousser la mise à jour**, **Voir les données**, **Voir le code QR** et **Détails**. **Détails** ouvre la page de la carte, qui décrit ces actions et les autres (notifier, accorder un avantage, appliquer un thème). Voir [Détails de la carte](https://docs.thewalletcrew.io/guides-monitoring/fr/monitor/pass-details.md#actions).

## Agir sur plusieurs cartes

La barre d'outils agit sur toutes les cartes qui correspondent à l'affichage, à la recherche et aux filtres actuels. Vérifiez les filtres avant de l'utiliser.

* **Pousser la mise à jour** Rend et renvoie à nouveau chaque carte correspondante, par exemple après un changement de modèle ou de données. La confirmation indique combien de cartes sont mises à jour et un temps estimé ; ses paramètres avancés définissent le débit et peuvent forcer une mise à jour des métadonnées de toutes les cartes. Cela nécessite l'autorisation de pousser des mises à jour. Les mises à jour groupées en cours sont listées dans **Paramètres → Supervision → Mises à jour Wallet**, où elles peuvent être annulées : les cartes déjà traitées conservent ce que l'opération leur a donné (voir [Opérations par lot](https://docs.thewalletcrew.io/developers-guides/fr/integration-guides/wallet/batch-operations.md#track-and-cancel-batches-in-the-console)).
* **Exporter** télécharge les cartes correspondantes sous forme de fichier Excel : voir [Exporter les données](https://docs.thewalletcrew.io/guides-monitoring/fr/monitor/report.md#export-the-pass-list).

{% hint style="warning" %}
Une poussée groupée atteint chaque carte correspondante. Sans filtre, cela correspond à chaque carte de l'affichage actuel.
{% endhint %}

## Importer des cartes

**Importer** crée ou met à jour des cartes à partir d'un fichier Excel, par exemple pour émettre des cartes aux membres existants. Trois paramètres encadrent l'importation :

* le **Colonne discriminante**: la colonne qui identifie les cartes existantes, généralement un ID externe. Une ligne dont la valeur correspond à une carte existante la met à jour ; les autres lignes créent des cartes ;
* le **Modèle de carte par défaut**: utilisé pour les lignes qui ne nomment pas de modèle ;
* le **Colonnes de données supplémentaires**: colonnes stockées comme données supplémentaires de chaque carte.

L'importation affiche sa progression, avec les cartes créées, mises à jour et en erreur, puis un récapitulatif des erreurs par ligne. Le navigateur doit rester ouvert pendant l'exécution de l'importation.

## FAQ

<details>

<summary><strong>Pourquoi une recherche sur un identifiant renvoie-t-elle plusieurs cartes ?</strong></summary>

Plusieurs cartes peuvent partager un identifiant, par exemple après des inscriptions de test ou des appels API répétés. Filtrez sur **Installé dans** ou comparez la date de dernière mise à jour pour trouver la carte utilisée.

Pour les identifiants affichés sur la page de la carte, voir [Détails de la carte](https://docs.thewalletcrew.io/guides-monitoring/fr/monitor/pass-details.md#overview). Pour le modèle derrière les identifiants et la récupération des données, voir [Données et synchronisation de la carte](https://docs.thewalletcrew.io/developers-guides/fr/pass-architecture/pass-data-and-sync.md).

</details>

<details>

<summary><strong>Pourquoi les colonnes de métadonnées diffèrent-elles d'un tenant à l'autre ?</strong></summary>

Les métadonnées sont définies dans chaque modèle. Un programme peut utiliser un magasin, un autre un événement ou un niveau d'adhésion.

</details>


---

# 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/guides-monitoring/fr/monitor/pass-list.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.
