Aller au contenu

Éditer les états du module

Un état, c'est une question posée au module et une feuille rendue en retour. Les Ventes en publient quatre, réunis sous un même écran : ce que vous avez vendu, ce qu'on vous doit, ce que vous avez encaissé, et le compte d'un client. Ce guide dit ce que chacun demande et ce que chacun montre.

Prérequis

  • Le droit SALES.REPORTING.READ — un seul droit ouvre les quatre états
  • Des documents sur la période demandée : bons de commande confirmés, factures, avoirs, règlements validés

Étapes

1. Ouvrir l'écran

Dans le menu, États. L'écran se partage en deux : une barre latérale qui nomme les quatre états, et la page de celui que vous lisez. Il s'ouvre sur Statistique des ventes ; la barre latérale marque la section courante, et l'adresse de la page suit celle que vous choisissez.

Sans le droit de lecture des états, la barre latérale reste vide et l'écran ne s'ouvre pas : le module vous dépose sur le premier écran que votre profil autorise.

2. Poser des critères, générer, emporter

Les quatre états se conduisent de la même manière : un formulaire de critères, puis Générer le rapport.

  • Un critère laissé tranquille n'est pas transmis : il vaut alors « tous ». Un menu déroulant vous le dit en toutes lettres — Tous les clients, Tous les produits, Tous les points de vente, Tous les statuts, Tous les modes.
  • Les dates sont obligatoires partout, et le module les réclame avant d'appeler le serveur plutôt qu'après. Un champ obligatoire vide affiche son message sous lui.
  • Générer le rapport ouvre un aperçu PDF. Exporter Excel enregistre le même état en tableur, Fermer referme la fenêtre.

Éditer un état, c'est lire

Aucun droit d'écriture n'entre en jeu, et aucun état ne modifie quoi que ce soit. Un profil en consultation seule édite les quatre états.

3. Statistique des ventes

Les critères : Client, Produit, Point de vente, Début, Fin et Filtre sur les produits — un texte cherché dans le libellé du produit.

Le formulaire de l'état Statistique des ventes : client, produit, point de vente, période et filtre sur les produits

L'état ne compte que les articles des bons de commande confirmés, partiellement livrés ou livrés : un brouillon de commande et une commande annulée n'y figurent pas.

Chaque ligne réunit un produit, un client, un prix de vente et un prix de revient, et donne la Qté, le Prix de revient unitaire et total, le Prix de vente unitaire et total, la Marge unitaire et totale, le Taux MQ — la marge rapportée au prix de vente — et le Taux MC — la marge rapportée au prix de revient. Une ligne Total ferme la feuille.

Le prix de revient vient des lots de stock

Le coût qu'affiche l'état est celui du lot consommé par la ligne de commande. Un article sorti sans lot valorisé compte pour un coût nul, et sa marge vaut alors son prix de vente.

4. Échéances à venir

Les critères : Client, Référence client, Statut de paiement, Statut de délai, Du, Au et Filtre sur les commandes.

L'état pose la même question que l'écran Recouvrement › Échéances, et y répond d'un seul tenant plutôt que page par page. Les colonnes sont la Date d'échéance, la Commande, le Client, la Référence client, le Montant, le Payé, le Reste dû, le Statut de paiement et le Statut de retard.

Les échéances sont groupées par client et, à l'intérieur d'un groupe, de la plus proche à la plus lointaine. Chaque groupe se ferme sur son sous-total, et la feuille sur un Total du reste dû.

Choisissez cet écran quand vous partez d'une question ; partez de l'écran des échéances quand vous partez d'une liste que vous êtes en train de lire.

5. Règlements de la période

Les critères : Client, Point de vente, Mode de règlement, Du, Au et Filtre sur les règlements — un texte cherché dans la référence.

Un règlement n'est compté que s'il est validé : un brouillon que le caissier n'a jamais confirmé et un règlement annulé ne sont lus par personne.

Chaque ligne dit la Date, la Référence, le Client, le Point de vente, le Mode de règlement, les Commandes imputées — réunies sur une seule ligne, séparées par des virgules — et le Montant. Les règlements sont rangés par mode puis par jour, et chaque mode porte son total ; la feuille se ferme sur un Total général.

Un remboursement compte en négatif

Un décaissement est un règlement rendu au client : il est lu avec un montant négatif, et il abaisse le total de son mode au lieu de le gonfler. Un état où les remboursements dépassent les encaissements affiche donc un total négatif, ce qui est la bonne lecture.

6. Grand livre client

Les critères : Client, Du et Au. Le client est ici obligatoire — c'est le seul état qui parle de quelqu'un plutôt que de tout le monde.

L'état aligne, dans l'ordre des jours, les pièces qui ont bougé ce que le client vous doit :

Pièce Sens Ce qui est retenu
Bon de commande Débit Les commandes confirmées, partiellement livrées ou livrées
Avoir Crédit Les avoirs validés ou envoyés
Règlement Crédit Les encaissements validés imputés au client

Les colonnes sont la Date, la Pièce, la Référence, le Débit, le Crédit et le Solde. Le solde est celui que la ligne laisse derrière elle : il se lit ligne après ligne, et non colonne par colonne.

La feuille s'ouvre sur un Solde initial — tout ce qui a bougé avant la période, résumé en un chiffre plutôt qu'imprimé —, porte un Total des mouvements et se ferme sur un Solde final.

Un remboursement n'est pas encore déduit

Le grand livre lit les encaissements ; il ne lit pas encore les décaissements. Le compte d'un client remboursé surestime donc ce qu'il a payé. Utilisez Règlements de la période pour retrouver ses remboursements.

Une limite à connaître

Les quatre états sont rendus en français, quel que soit le profil linguistique de la personne qui les demande : les titres, les en-têtes de colonne et les libellés de totaux sont écrits dans le modèle du rapport, et non traduits. Les dates y sont écrites au format jj/mm/aaaa. Seul l'écran qui pose les critères suit votre langue.

C'est une limite connue, suivie par l'issue #392 du module.

Et ensuite ?

Changelog

  • 1.0 (27 août 2026) : création du document.