Configurer les séries de nommage
Configurer les séries de nommage
Une série de nommage est un masque qui numérote les nouveaux documents, par exemple DV-.YYYY.-.#####. Vous pouvez modifier les séries d'un type de transaction depuis les paramètres de son module.
Pour la syntaxe complète des masques, voir Masques de numérotation. Pour les autres règles de nommage, voir Nommage des documents.
Prérequis
- Le droit d'écriture sur les paramètres du module, par exemple Paramètres des ventes.
Où trouver les séries
Chaque page de paramètres a un onglet Nommage des documents. Il contient un tableau avec trois colonnes : Transaction, Série actuelle et un bouton crayon.
| Paramètres | Transactions listées |
|---|---|
| Paramètres des ventes | Client, Devis, Commande client, Facture de vente, Bon de livraison, Facture proforma |
| Paramètres des achats | Fournisseur, Demande de matériel, Appel d'offre, Commande fournisseur, Facture d'achat, Réception |
| Paramètres de comptabilité | Écriture de journal, Écriture de paiement, Facture d'achat, Commande fournisseur, Réception, Facture de vente |
| Paramètres des stocks | Article, Écriture de stock, Réception, Bon de livraison, Demande de matériel, Liste de sélection, Réconciliation du stock, Ensemble de Série et Lot |
Une transaction sans série affiche « Non configuré ».
Modifier les séries d'une transaction
- Ouvrez les paramètres du module, par exemple Paramètres des ventes.
- Ouvrez l'onglet Nommage des documents.
- Sur la ligne de la transaction, cliquez sur le crayon. La fenêtre « Série de nommage » de cette transaction s'ouvre.
- Dans le tableau Ajouter préfixe de série, modifiez ou ajoutez une ligne dans la colonne Séries. La colonne Aperçu affiche le prochain numéro.
- Mettez en première ligne la série à utiliser par défaut.
- Cliquez sur Mettre à jour.
Le message « Série de nomination mise à jour » confirme l'enregistrement. La première série du tableau devient la valeur par défaut du champ Séries des nouveaux documents. Les autres séries restent proposées dans ce champ.
La section Règles de configuration des séries de la fenêtre rappelle la syntaxe : les caractères spéciaux autorisés sont / et -, et les variables disponibles sont .YYYY., .YY., .MM., .DD., .WW., .{nom_du_champ}., .FY. et .ABBR..
Exemple
Exemple fictif : la série actuelle des devis est SAL-QTN-.YYYY.-. Vous voulez des numéros qui commencent par DV.
- Dans Paramètres des ventes > Nommage des documents, cliquez sur le crayon de la ligne « Devis ».
- Ajoutez la ligne
DV-.YYYY.-.#####et placez-la en premier. - Cliquez sur Mettre à jour.
Le prochain devis s'appelle DV-2026-00001. Les devis existants gardent leur numéro.
Séries des clients et des fournisseurs
Pour un client, la ligne « Client » sert seulement si Règle de nommage du client vaut « Série de nommage ». Le bouton Configurer les séries ouvre alors la même fenêtre. Le champ Options de séries de nommage affiche les séries enregistrées. Le fonctionnement est le même pour les fournisseurs dans Paramètres des achats, avec Nommage du fournisseur selon.
Pour les développeurs
La fenêtre est fournie par la classe frappe.ui.NamingSeriesController. Une page de paramètres l'utilise ainsi :
frappe.ui.form.on("Selling Settings", {
refresh(frm) {
if (!frm.naming_controller) frm.naming_controller = new frappe.ui.NamingSeriesController(frm);
frm.naming_controller.render_table("transaction_naming_html", [
{ label: __("Quotation"), doctype: "Quotation" },
]);
},
});
| Méthode | Rôle |
|---|---|
render_table(fieldname, transactions) | Affiche le tableau des transactions dans un champ HTML. |
show_naming_series_dialog(doctype, on_update) | Ouvre la fenêtre pour un type de document. on_update({ doctype, naming_series_options }) est appelé après l'enregistrement. |
load_master_series(doctype, field) | Copie les séries d'un type de document dans un champ du formulaire. |