> 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/pos/cegid/donnees-client-et-fidelite/receipts-vouchers-and-sales-documents.md).

# Reçus, vouchers et documents de vente

Utilisez les documents de vente Cegid Retail Y2, les PDF de reçus, les cartes cadeaux et la valeur stockée dans les parcours des cartes Wallet.

Au-delà de l’enregistrement client et de la fidélité, Cegid Retail Y2 conserve l’historique des transactions et la valeur stockée. Le connecteur expose les deux aux parcours Wallet : les documents de vente et les PDF de reçu générés, ainsi que les bons, cartes cadeaux et certificats rattachés à un client.

<details>

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

* Un client ouvre un reçu récent depuis une Carte Wallet au lieu de conserver la copie papier.
* Le solde d’une carte cadeau apparaît sur une Carte et est vérifié avant que le client n’atteigne la caisse.
* Une commande click-and-collect est exposée sur la Carte afin que le personnel puisse la retrouver en la scannant.

</details>

### Documents de vente

Le connecteur lit les documents de vente individuellement, à l’aide de leur clé Cegid ou d’une référence externe, et peut récupérer une liste des documents récents d’un client. Ceux-ci alimentent l’historique des transactions dans un parcours Wallet.

### PDF de reçus

Lorsqu’un document rendu est requis plutôt que les données sous-jacentes, le connecteur génère un PDF de reçu via Cegid. La génération est asynchrone : le connecteur demande le document, attend que Cegid signale qu’il est prêt, puis le télécharge.

Le modèle utilisé par Cegid est défini par connexion, comme décrit dans [Configurer le connecteur Cegid Retail Y2](/connectors/fr/pos/cegid/installation-et-configuration/connect-with-cegid-retail-y2.md). Si le modèle est laissé vide, le modèle par défaut de Cegid est utilisé.

{% hint style="warning" %}
Les paramètres des reçus et les paramètres de notification métier partagent la même connexion. Lorsqu’un autre système dépend de l’abonnement aux notifications, vérifiez cet abonnement après avoir modifié les paramètres des reçus.
{% endhint %}

### Bons, cartes cadeaux et valeur stockée

Cegid regroupe les bons, les cartes cadeaux, les certificats, les dépôts et les comptes clients. Le connecteur lit ceux qui sont rattachés à un client et les expose dans des collections séparées, afin qu’un modèle puisse cibler directement le type pertinent.

| Collection                    | Contient                                       |
| ----------------------------- | ---------------------------------------------- |
| `y2.bons.giftCards`           | Cartes cadeaux.                                |
| `y2.bons.giftCertificates`    | Certificats cadeaux.                           |
| `y2.bons.loyaltyCertificates` | Certificats émis par le programme de fidélité. |
| `y2.bons.accounts`            | Comptes clients.                               |
| `y2.bons.deposits`            | Dépôts.                                        |

Lorsqu’une Carte représente spécifiquement une carte cadeau, son identifiant est vérifié par rapport au client propre à la carte avant que la Carte ne soit servie, afin qu’une Carte cadeau ne puisse pas être utilisée pour lire le solde d’un autre client.

### Reçus en attente

Une étape du flux peut créer un reçu en attente dans Cegid : un document créé à l’avance et finalisé en caisse. Il est utilisé pour le click-and-collect et des parcours similaires où la transaction est préparée avant l’arrivée du client.

### Actualisation des Cartes après une commande

Une tâche planifiée actualise les Cartes affectées par des commandes récentes, en remontant par défaut d’une heure. Elle fournit une actualisation fiable lorsque les notifications métier ne sont pas activées, à une granularité plus grossière.

### FAQ

<details>

<summary><strong>Pourquoi un reçu ne se génère-t-il pas ?</strong></summary>

L’identifiant du modèle configuré est la première chose à vérifier, puis l’existence du document dans Cegid sous la clé demandée. Les échecs de génération sont signalés par Cegid plutôt que par le connecteur.

</details>

<details>

<summary><strong>Les paramètres des reçus s’appliquent-ils à chaque magasin ?</strong></summary>

Ils s’appliquent par connexion. Lorsqu’une enseigne utilise une connexion par magasin, un modèle défini sur certaines connexions et pas sur d’autres produit un comportement différent selon le magasin.

</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/connectors/fr/pos/cegid/donnees-client-et-fidelite/receipts-vouchers-and-sales-documents.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.
