> 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/connectors/fr/ticketing/aparte/ticket-lifecycle.md).

# Cycle de vie du billet

### Pourquoi le cycle de vie est important

Un ticket Wallet n'est pas seulement une copie statique d'un billet. Il doit rester aligné sur le dernier état du billet, surtout lorsqu'une place change, qu'un événement est mis à jour ou qu'une Carte est ajoutée à un appareil.

Le connecteur Aparté couvre ce cycle de vie, de la mise en correspondance des billets au suivi des installations Wallet.

<details>

<summary><strong>Exemples concrets</strong></summary>

* **Commande à plusieurs places**: créer une Carte Wallet par place à partir d'une seule ligne de commande.
* **Mise à jour opérationnelle**: actualiser la Carte après une modification du billet dans Aparté.
* **Suivi de l'adoption**: enregistrer qu'un billet a été ajouté à un Wallet ou retiré d'un Wallet.

</details>

### Comment les billets sont mis en correspondance

Chaque Carte est liée à un billet Aparté via `id.aparte.ticketId`.

Cette valeur utilise le format `<orderItemId>|<seatId>`. Elle permet de distinguer clairement les billets lorsqu'un article de commande contient plusieurs places.

### Créer des Cartes à partir d'un article de commande

Le connecteur peut fonctionner à partir de `aparte.orderItemId`.

Lorsque cette valeur est renseignée, The Wallet Crew récupère les billets associés à cette ligne de commande, fait correspondre les Cartes existantes et crée automatiquement celles qui manquent. C'est utile dans les parcours de réservation et de confirmation, où une commande peut inclure plusieurs participants.

### Comportement d'actualisation et de mise à jour

Aparté reste la source de vérité pour les données de billet. The Wallet Crew lit les données du billet lorsque la Carte doit être actualisée et utilise ces informations pour maintenir la version Wallet alignée.

Si l'API Aparté est temporairement indisponible, la Carte conserve les dernières informations valides jusqu'à ce qu'une actualisation ultérieure réussisse.

### Suivi des installations Wallet

Le connecteur peut notifier Aparté lorsqu'une Carte est installée ou retirée d'Apple Wallet ou de Google Wallet.

Cela rend l'adoption Wallet mesurable au niveau du billet. C'est particulièrement utile pour le reporting, le suivi opérationnel et l'analyse du déploiement.

### Routage avancé

Certains projets ont besoin de modèles Wallet différents selon les types de billets. C'est possible grâce au `extensions.aparte.ticket.mapper` hook et sa `GetPassType` méthode.

Cette partie n'est généralement nécessaire que pour les implémentations avancées. Une configuration standard peut souvent utiliser un seul modèle par défaut.

### FAQ

<details>

<summary><strong>Une ligne de commande peut-elle générer plusieurs Cartes ?</strong></summary>

Oui. Si la ligne de commande contient plusieurs billets ou places, le connecteur peut créer une Carte par billet.

</details>

<details>

<summary><strong>Le connecteur met-il à jour les données de billet Aparté ?</strong></summary>

Aucun contenu de billet n'est réécrit dans Aparté. Le comportement d'écriture en retour se limite aux événements du cycle de vie du Wallet, tels que l'installation ou la désinstallation.

</details>

<details>

<summary><strong>Que se passe-t-il si Aparté est indisponible pendant un moment ?</strong></summary>

Le connecteur réessaie la requête. Jusqu'à la prochaine actualisation réussie, la Carte Wallet continue d'afficher les dernières données valides.

</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 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/connectors/fr/ticketing/aparte/ticket-lifecycle.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.