Indicateurs du tableau de bord¶
Le tableau de bord des Ventes montre deux indicateurs sur une période : le Résumé des ventes et la Répartition du chiffre d'affaires. Cette page donne leur définition exacte — ce que le serveur additionne, et ce qu'il laisse de côté.
Le droit SALES.DASHBOARD.READ ouvre l'écran.
La période¶
Trois listes coiffent l'écran : Année, Mois, Jour. Les années proposées sont celles où l'organisation a eu de l'activité ; l'écran s'ouvre sur l'année et le mois du jour courant, et sur Tous les jours.
| Choix | Période lue |
|---|---|
| Année seule (Tous les mois) | Du 1er janvier au 31 décembre |
| Année et mois (Tous les jours) | Du 1er au dernier jour du mois |
| Année, mois et jour | Ce seul jour |
Un jour qui n'existe pas dans le mois choisi retombe sur Tous les jours. Les noms des mois et des jours suivent votre langue ; les années et le jour courant viennent du serveur.
Les deux indicateurs sont relus à chaque changement de période.
Ce que le serveur publie¶
Le module déclare ses indicateurs, et l'écran ne dessine que ceux-là :
| Code publié | Section affichée |
|---|---|
sales-resume |
Résumé des ventes |
repartition-sales |
Répartition du chiffre d'affaires |
Un indicateur que le serveur ne publie pas ne coûte ni section ni appel.
Le résumé des ventes¶
Cinq cartes, toutes exprimées dans la devise de l'entreprise.
| Carte | Définition |
|---|---|
| Vendu | Le chiffre d'affaires de la période, tel que la vue de chiffre d'affaires du module le compose (voir ci-dessous) |
| Encaissé | La somme des règlements validés de type encaissement dont la date de paiement tombe dans la période, hors modes de paiement de type gratuité |
| Remboursé | La somme des règlements validés de type décaissement dont la date de paiement tombe dans la période |
| Reste à payer | Le total TTC des bons de commande de la période, hors statuts Créé et Annulé, diminué des encaissements validés de la période imputés aux lignes de ces commandes |
| Gratuités | La somme des règlements validés de type encaissement dont le mode de paiement est de type gratuité |
Comment le « Vendu » se compose¶
Le montant retenu pour chaque pièce est son net commercial hors taxes — le montant hors taxes après réduction.
| Pièce | Sens | Condition retenue |
|---|---|---|
| Bon de commande | + | Statut différent de Créé et de Annulé |
| Facture | + | Facture « doit », statut différent de Non défini et de Brouillon, et ne facturant aucune ligne déjà portée par un bon de commande |
| Ticket de caisse | + | Statut Clôturé et aucune facture engendrée |
| Avoir | − | Statut Validé ou Envoyé, et nature autre qu'un escompte |
Pourquoi une facture est parfois exclue
Une facture tirée d'un bon de commande porte le même montant que lui. La compter reviendrait à compter la vente deux fois : la vue ne retient donc que les factures autonomes, celles dont aucune ligne ne remonte à une commande.
L'escompte n'est pas une réduction commerciale
Un escompte est une remise financière pour paiement anticipé. Il ne diminue pas le chiffre d'affaires, contrairement au rabais, à la remise et à la ristourne.
Trois lectures qui ne s'additionnent pas¶
Vendu, Encaissé et Remboursé ne se rapportent pas aux mêmes documents ni aux mêmes dates : le premier compte des ventes à leur date d'édition, les deux autres des règlements à leur date de paiement. Un règlement de janvier sur une vente de décembre entre dans l'un et pas dans l'autre. Vendu − Encaissé n'est donc pas le Reste à payer, qui a sa propre définition.
La répartition du chiffre d'affaires¶
Un anneau, une part par point de vente de l'organisation, et une carte Total.
| Élément | Définition |
|---|---|
| Une part | Le chiffre d'affaires de la période — la même vue que le Vendu — restreint à ce point de vente |
| Total | La somme des parts affichées, calculée par l'écran |
| Aucune vente sur la période | Le serveur n'a renvoyé aucune part |
Le Total de l'anneau peut différer du Vendu
L'anneau ne parcourt que les points de vente que le module connaît. Une pièce rattachée à aucun point de vente entre bien dans le Vendu, mais dans aucune part et donc dans aucun Total. Un écart entre les deux chiffres se lit ainsi, et non comme une erreur de calcul.
Affichage¶
| Situation | Ce qui est affiché |
|---|---|
| Chiffres en cours de lecture | Une zone d'attente, et non des zéros |
| Lecture d'une section refusée | Un message d'erreur propre à la section ; l'autre section reste affichée |
| Calendrier illisible | Un message d'erreur en tête d'écran |
| Aucune part à dessiner | Le message Aucune vente sur la période |
Et ensuite ?¶
- Éditer les états du module — les mêmes chiffres, en détail
- Les statuts des documents — d'où viennent les conditions ci-dessus
- Permissions
Changelog¶
- 1.0 (27 août 2026) : création du document.