# Actions

Dans cette section, vous trouverez de l'aide sur les actions disponibles lorsque vous configurez la disposition des touches.

Lorsqu'une action permet de configurer un motif, la règle suivante s'applique :
- chaque ligne du ticket de caisse ne peut contenir qu'un seul motif.
- Si l'utilisateur exécute plusieurs actions sur la ligne qui nécessite un motif, alors seul le dernier motif sélectionné est conservé.

## Groupe de contrôles

Cette action permet de créer une hiérarchie de boutons sur la caisse.
Ainsi, en sélectionnant cettte action, l'utilisateur de la caisse accède aux actions que vous avez ajoutées sous cette action.

Utilisez les fonctions d'indentation/désindentation pour intégrer des éléments sous un groupe de contrôles.

**Paramètres**

Cette action ne prend aucun paramètre.

## Zone vide

Cette action ne fait rien et est destinée à vous aider à agencer des contrôles dans la modification graphique des touches pour laisser des espaces entres les boutons.

**Paramètres**

Cette action ne prend aucun paramètre.

## Ajouter article

Ajoute un article au panier.

**Paramètres**

| Nom du paramètre | Description                                                                                                                                                                     |
|------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| N° article       | (Optionnel) Si ce paramètre est renseigné, alors l'article spécifié est ajouté au panier. Si vous laissez ce champ vide, l'utilisateur est redirigé vers la liste des articles. |
| Quantité         | (Optionnel) Si ce paramètre est renseigné, l'article est ajouté au panier pour la quantité spécifiée. Sinon, il est demandé à l'utilisateur de saisir la quantité à ajouter.    |
| Unité            | (Optionnel) Si ce paramètre est renseigné, l'article est ajouté au panier dans l'unité spécifiée. Sinon, l'unité de vente de l'article est utilisée.                            |

## Ajouter commentaire

Cette action permet d'ajouter une ligne de commentaire sur un ticket de caisse.
Le commentaire est visible sur l'application et sur le ticket de caisse ou la facture imprimés au client.

**Paramètres**

| Nom du paramètre | Description                                                                                                                                                                                           |
|------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| Commentaires     | (Optionnel) Si ce paramètre est renseigné, alors son contenu représente le commentaire ajouté dans le ticket. Si vous laissez ce champ vide, il est demandé à l'utilisateur de saisir un commentaire. |

## Ajouter sous-total

Ajoute un sous-total dans le ticket de caisse sous la ligne actuellement sélectionnée.

**Paramètres**

Cette action ne prend aucun paramètre.

## Ajouter règlement

Redirige vers la page de paiement.

Si un des paramètres dans le tableau suivant est fourni :
- ne redirige pas vers la page de paiement.
- permet d'ajouter directement un nouveau paiement.
- si le montant ajouté excède le reste à payer, une notification vous en informera.

Si vous renseignez le paramètre _Code mode règlement_ sans le paramètre _Montant_, le montant sélectionné par défaut dans le pavé numérique sera le reste à payer.

> Cette action ne peut pas être utilisée dans le cadre d'un devis.

**Paramètres**

<!-- TODO : pas implémenté en v27 : la doc est fausse ou c'est un manque côté logiciel -->
| Nom du paramètre           | Description                                                                                                                                                                                                                                               |
| -------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [!NEW] Code mode règlement | (Optionnel) Si ce paramètre est renseigné, alors spécifie le mode de règlement à appliquer. Si vous laissez ce champ vide, l'application ouvre la page récapitulative des règlements.                                                                     |
| [!NEW] Montant             | (Optionnel) Ne fonctionne que si le paramètre _Code mode règlement_ est renseigné. Si ce paramètre est renseigné, alors spécifie le montant du règlement à appliquer. Si vous laissez ce champ vide, il est demandé à l'utilisateur de saisir le montant. |

> [!NOTE]
> Ces deux paramètres existaient déjà du côté du système centralisé mais n'avaient aucun effet du côté de l'application cliente.

## Supprimer la ligne

Supprime la ligne actuellement sélectionnée du ticket de caisse.
Utilisez cette action pour supprimer indifféremment un article, un commentaire ou un sous-total présent dans un ticket de caisse.

**Paramètres**

Cette action ne prend aucun paramètre.

## <span class="cv-new"></span>Monter la ligne

Déplace la ligne actuellement sélectionnée d'une position vers le **haut** dans le ticket de caisse.

**Paramètres**

Cette action ne prend aucun paramètre.

## <span class="cv-new"></span>Descendre la ligne

Déplace la ligne actuellement sélectionnée d'une position vers le **bas** dans le ticket de caisse.

**Paramètres**

Cette action ne prend aucun paramètre.

## Changer signe de la quantité

Change le signe de la quantité pour la ligne sélectionnée.
Cette action n'est disponible que lorsqu'une ligne d'article est sélectionnée.

**Paramètres**

Cette action ne prend aucun paramètre

## Définir quantité ligne

Change la quantité de la ligne sélectionnée.
Cette action n'est disponible que lorsqu'une ligne d'article est sélectionnée.

- Définir une quantité de zéro ou supérieure à 999 n'est pas accepté et n'aura aucun effet.
- Définir une quantité réinitialisera le prix unitaire et la remise appliquée manuellement sur cette ligne.

**Paramètres**

| Nom du paramètre | Description                                                                                                                                                                                     |
|------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| Quantité         | (Optionnel) Si ce paramètre est renseigné, alors il indique la quantité à affecter à la ligne. Si vous laissez ce champ vide, il est demandé à l'utilisateur de saisir la quantité à appliquer. |

## Définir prix unitaire

Change le prix unitaire TTC de la ligne sélectionnée.
Cette action n'est disponible que lorsqu'une ligne d'article est sélectionnée.

Définir un prix unitaire inférieur à zéro ou supérieur à 1000€ n'est pas accepté et n'aura aucun effet.

**Paramètres**

| Nom du paramètre      | Description                                                                                                                                                                                                   |
|-----------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| Prix unitaire         | (Optionnel) Si ce paramètre est renseigné, alors il indique le prix unitaire TTC à affecter à la ligne. Si vous laissez ce champ vide, il est demandé à l'utilisateur de saisir le prix unitaire à appliquer. |
| Motif obligatoire     | (Optionnel) Si vous indiquez _Oui_, il est demandé à l'utilisateur de préciser le motif pour lequel le prix est modifié. Ce paramètre est ignoré si le paramètre _Code motif par défaut_ est renseigné.       |
| Code motif par défaut | (Optionnel) Si ce paramètre est renseigné, le motif qu'il indique est affecté à la ligne. Le motif n'est pas visible sur le ticket du client mais uniquement pour vos contrôles de gestion.                   |

## Définir pourcentage remise ligne

Change le pourcentage de remise de la ligne sélectionnée.
Cette action n'est disponible que lorsqu'une ligne d'article est sélectionnée.

Définir un pourcentage à zéro enlève un potentiel pourcentage précédemment appliqué.

**Paramètres**

| Nom du paramètre      | Description                                                                                                                                                                                                     |
|-----------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| % remise              | (Optionnel) Si ce paramètre est renseigné, alors il indique le pourcentage de remise à affecter à la ligne. Si vous laissez ce champ vide, il est demandé à l'utilisateur de saisir le pourcentage à appliquer. |
| Motif obligatoire     | (Optionnel) Si vous indiquez _Oui_, il est demandé à l'utilisateur de préciser le motif pour lequel le prix est modifié. Ce paramètre est ignoré si le paramètre _Code motif par défaut_ est renseigné.         |
| Code motif par défaut | (Optionnel) Si ce paramètre est renseigné, le motif qu'il indique est affecté à la ligne. Le motif n'est pas visible sur le ticket du client mais uniquement pour vos contrôles de gestion.                     |

## Définir montant remise ligne

Change le montant TTC de remise de la ligne sélectionnée.
Cette action n'est disponible que lorsqu'une ligne d'article est sélectionnée.

**Paramètres**

| Nom du paramètre      | Description                                                                                                                                                                                                 |
|-----------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| Montant remise        | (Optionnel) Si ce paramètre est renseigné, alors il indique le montant TTC de remise à affecter à la ligne. Si vous laissez ce champ vide, il est demandé à l'utilisateur de saisir le montant à appliquer. |
| Motif obligatoire     | (Optionnel) Si vous indiquez _Oui_, il est demandé à l'utilisateur de préciser le motif pour lequel le prix est modifié. Ce paramètre est ignoré si le paramètre _Code motif par défaut_ est renseigné.     |
| Code motif par défaut | (Optionnel) Si ce paramètre est renseigné, le motif qu'il indique est affecté à la ligne. Le motif n'est pas visible sur le ticket du client mais uniquement pour vos contrôles de gestion.                 |

## Définir groupe prix client

Applique un groupe prix client au ticket.
Cette action recalcule les prix de l'ensemble du ticket et réinitialise donc toute remise ou prix unitaire définit manuellement.

**Paramètres**

| Nom du paramètre | Description                                                                                                                                                                                                          |
|------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| Code             | (Optionnel) Si ce paramètre est renseigné, alors il indique le groupe prix client à appliquer au ticket. Si vous laissez ce champ vide, il est demandé à l'utilisateur de choisir le groupe prix client à appliquer. |

## Définir groupe remise client

Applique un groupe remise client au ticket.
Cette action recalcule les prix de l'ensemble du ticket.

**Paramètres**

| Nom du paramètre | Description                                                                                                                                                                                                              |
|------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| Code             | (Optionnel) Si ce paramètre est renseigné, alors il indique le groupe remise client à appliquer au ticket. Si vous laissez ce champ vide, il est demandé à l'utilisateur de choisir le groupe remise client à appliquer. |

## Définir pourcentage remise facture

Change le pourcentage de remise facture du ticket.

**Paramètres**

| Nom du paramètre | Description                                                                                                                                                                                                                      |
|------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| % remise         | (Optionnel) Si ce paramètre est renseigné, alors il indique le pourcentage de remise facture à affecter au ticket. Si vous laissez ce champ vide, il est demandé à l'utilisateur de saisir le pourcentage de remise à appliquer. |

## Définir montant remise facture

Change le montant TTC de remise facture.

**Paramètres**

| Nom du paramètre | Description                                                                                                                                                                                                        |
|------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| Montant remise   | (Optionnel) Si ce paramètre est renseigné, alors il indique le montant TTC de remise facture à affecter au ticket. Si vous laissez ce champ vide, il est demandé à l'utilisateur de saisir le montant à appliquer. |

## Définir groupe compta. marché TVA

Change le groupe compta. marché TVA du ticket.
Cette action recalcule les prix de l'ensemble du ticket.

**Paramètres**

| Nom du paramètre          | Description                                                                                                                                                                                                              |
|---------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| Groupe compta. marché TVA | (Optionnel) Si ce paramètre est renseigné, alors il indique le groupe remise client à appliquer au ticket. Si vous laissez ce champ vide, il est demandé à l'utilisateur de choisir le groupe remise client à appliquer. |

## Définir valeur axe analytique

Permet d'associer un axe analytique à un ticket de caisse.
L'axe analytique s'applique à l'ensemble du ticket de caisse et vient, éventuellement, remplacer la section qui aurait pu provenir du client, de la caisse, etc.

**Paramètres**

| Nom du paramètre    | Description                                                                                                                                                                                                      |
|---------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| Code axe analytique | Spécifie l'axe analytique à définir.                                                                                                                                                                             |
| Section analytique  | (Optionnel) Si ce paramètre est renseigné, alors il indique la section analytique attribuée au ticket. Si vous laissez ce champ vide, il est demandé à l'utilisateur de choisir la section à affecter au ticket. |

## Imprimer ticket/devis

Déclenche l'impression du reçu pour le ticket en cours.

> Cette action est utilisée dans le cadre d'un devis, elle imprime le devis en cours.

**Paramètres**

Cette action ne prend aucun paramètre.

## Convertir en ticket

Transforme le devis en ticket.

> Cette action ne peut pas être utilisée depuis un ticket.

**Paramètres**

Cette action ne prend aucun paramètre.

## Nouveau ticket/devis

Créé un nouveau ticket (ou un nouveau devis) et affiche son interface d'édition.

**Paramètres**

Cette action ne prend aucun paramètre.

## Aller à la liste des contacts

Se rend à la liste des contacts sans quitter le ticket de caisse en cours.

**Paramètres**

Cette action ne prend aucun paramètre.

## Aller à la fiche contact

Se rend à la fiche du contact du ticket de caisse en cours sans quitter le ticket de caisse en cours.

**Paramètres**

Cette action ne prend aucun paramètre.

## Aller à la liste des articles

Se rend à la liste des articles sans quitter le ticket de caisse en cours.

**Paramètres**

| Nom du paramètre | Description                                                                                                                                                                                                                                                                 |
| ---------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Filtre articles  | (Optionnel) Si ce paramètre est renseigné, alors il indique un filtre des articles à afficher lorsque l'action est sélectionnée. Utilisez le bouton _AssistEdit_ pour vous aidez à renseigner ce filtre. Si ce paramètre est omis, la liste complète des articles affichée. |

> [!NOTE]
> Le résultat du filtre article, s'il est renseigné, devrait se limiter à moins de 200 références.
> Si le filtre contient plus de 200 références, seules les 200 premières seront visibles sur la caisse.
> Si vous souhaitez voir davantage de référence, découpez votre filtre pour obtenir moins d'article et créez davantage de boutons _Aller à la liste des articles_ sur votre caisse.

## Aller à l'accueil

Affiche le premier niveau de la disposition des touches.

**Paramètres**

Cette action ne prend aucun paramètre.

## Aller à la liste des tickets

Sort de l'édition du ticket en cours pour afficher la liste des tickets.

**Paramètres**

Cette action ne prend aucun paramètre.

## Afficher un message

Affiche un message sous forme de toast en bas de l'écran, au centre.

**Paramètres**

| Nom du paramètre | Description                                                                   |
| ---------------- | ----------------------------------------------------------------------------- |
| Message          | (Optionnel) Spécifie le message à afficher.                                   |
| Erreur           | (Optionnel) Si vous indiquez Oui, le message généré sera un message d'erreur. |
