---
title: "Utilisation"
weight: 30
description: "Utilisation quotidienne du module eTicket : génération du ticket, QR code et affichage déporté."
---

# Utilisation

## Fonctionnement automatique

Une fois le module configuré, la majeure partie du fonctionnement est automatique. Les actions suivantes se déclenchent sans intervention du caissier :

### Pendant la saisie

Lorsqu'une facture est créée ou modifiée dans TakePOS, le module met à jour en temps réel l'affichage sur l'écran client déporté. Chaque ajout, modification ou suppression de ligne de facture déclenche une actualisation.

Si l'option **Afficher le eTicket qu'une fois validé** est activée, l'écran client affiche uniquement le message "Ticket en cours de création..." pendant la saisie.

### Après le paiement

Lorsque la facture est payée, le module exécute automatiquement les actions suivantes :

1. Génération du ticket au format PDF (largeur 70 mm, hauteur variable)
2. Envoi du PDF vers le serveur relais configuré
3. Récupération de l'URI du ticket et du QR code depuis le serveur relais
4. Affichage du QR code sur l'écran client déporté
5. Enregistrement des informations du ticket en base de données

Le QR code reste affiché pendant la durée configurée (par défaut 1 minute), puis l'écran revient au message de bienvenue ou à la page web externe.

## Bouton e-ticket sur la fiche facture

Sur la fiche d'une facture validée ou payée dans Dolibarr, un bouton **e-ticket** apparaît dans la barre d'actions.

![Bouton e-ticket sur la fiche facture dans Dolibarr](screenshots/bouton-eticket-facture.webp)

- Si le ticket a déjà été envoyé au serveur relais, le QR code apparaît directement sur la fiche
- Sinon, cliquez sur le bouton **e-ticket** pour déclencher manuellement la génération et l'envoi du ticket

## Contenu du ticket PDF

Le ticket PDF généré contient les éléments suivants :

### En-tête

- Logo de la société (si aucun en-tête personnalisé n'est configuré)
- Nom de la société
- En-tête personnalisé TakePOS (si configuré)
- Date et référence de la facture
- Nom du client (si l'option est activée et que ce n'est pas le client générique)
- Notes publiques (si l'option est activée)
- Numéro de table (si l'option restaurant est activée)
- Champs étendus sélectionnés

### Corps

- Tableau des lignes de la facture : libellé, quantité, prix unitaire TTC, total TTC
- Total HT
- TVA (globale ou détaillée par taux selon la configuration)
- Total TTC
- Mode de paiement (si l'option est activée)

### Pied de page

- Pied de page personnalisé TakePOS (si configuré)
- Par défaut : nom de la société, email, SIRET et adresse complète

### Ticket CB (bonus)

Si le module TPE/Stancer est installé et qu'un ticket CB a été généré pour cette facture, il est automatiquement ajouté en page supplémentaire du PDF.

## Affichage client déporté

L'écran client déporté est une page web accessible sans authentification. Elle affiche :

- Le nom de la société et le numéro du terminal
- Le contenu du ticket en temps réel pendant la saisie
- Le QR code de téléchargement une fois le paiement effectué
- Le message de bienvenue ou la page web externe entre deux clients

![Écran client déporté affichant un ticket en cours de saisie](screenshots/ecran-client-deporte.webp)

La page se rafraîchit automatiquement toutes les 2 secondes via une requête AJAX.

## Téléchargement par le client

Le client flashe le QR code avec l'appareil photo de son téléphone. Le lien le redirige vers le serveur relais où le ticket PDF est disponible en téléchargement pendant 24 heures.