Version de développement
Cette documentation décrit la version « next » (develop), non encore publiée. Pour la version stable, basculez sur « v5 » dans l'en-tête.
Utilisation

Configurer les séries de nommage

Modifier les séries de nommage des transactions depuis l'onglet Nommage des documents des paramètres des ventes, des achats, de la comptabilité et du stock.

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ètresTransactions listées
Paramètres des ventesClient, Devis, Commande client, Facture de vente, Bon de livraison, Facture proforma
Paramètres des achatsFournisseur, 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 stocksArticle, É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

  1. Ouvrez les paramètres du module, par exemple Paramètres des ventes.
  2. Ouvrez l'onglet Nommage des documents.
  3. Sur la ligne de la transaction, cliquez sur le crayon. La fenêtre « Série de nommage » de cette transaction s'ouvre.
  4. 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.
  5. Mettez en première ligne la série à utiliser par défaut.
  6. 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.

  1. Dans Paramètres des ventes > Nommage des documents, cliquez sur le crayon de la ligne « Devis ».
  2. Ajoutez la ligne DV-.YYYY.-.##### et placez-la en premier.
  3. 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éthodeRô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.