Paramètres de nommage des documents
Un masque de numérotation définit l'identifiant des nouveaux documents. Par exemple, le masque FA-.YYYY.-.MM.-.#### donne les numéros FA-2026-03-0001, FA-2026-03-0002, etc.
Vous pouvez définir plusieurs masques pour un même type de document, par exemple un masque par établissement.
Pour ouvrir les Paramètres de nommage des documents, cherchez-les dans la barre de recherche (Ctrl+K).
Syntaxe d'un masque
Un masque est découpé en parties par des points (.). Chaque partie est soit un texte fixe, soit une variable.
| Partie | Valeur insérée | Exemple |
|---|---|---|
#### | Compteur, sur autant de chiffres que de # | 0042 |
YYYY / YY | Année sur 4 ou 2 chiffres | 2026 / 26 |
MM / DD | Mois / jour | 03 / 05 |
WW | Numéro de semaine | 10 |
JJJ | Numéro du jour dans l'année | 064 |
FY | Nom de l'exercice fiscal du document | 2025-2026 |
TFY | Nom de l'exercice fiscal, réduit à 2 chiffres par année | 25-26 |
ABBR | Abréviation de la société du document | AN |
{nom_du_champ} | Valeur d'un champ du document | CLI-0042 |
Le point avant le compteur est obligatoire (FA-.####, et non FA-####). Dokos accepte les lettres, les chiffres, les espaces et les caractères -, #, ., /, { et }. Il refuse les autres caractères spéciaux.
Le compteur dépend de tout ce qui le précède. Avec FA-.YYYY.-.####, le compteur repart de 1 chaque année, car le préfixe change (FA-2026-, puis FA-2027-).
Par défaut, les variables de date prennent la date de création du document. Pour utiliser la date de comptabilisation, cochez Utiliser la date de comptabilisation pour nommer les documents dans les Valeurs par défaut globales. FY et TFY utilisent toujours la date de comptabilisation ou la date de transaction du document.
Configurer les masques d'un type de document
- Dans Sélectionner la transaction, choisissez le type de document. Dokos affiche ses masques dans Liste des masques pour cette transaction.
- Modifiez la liste. Mettez un masque par ligne. Le premier masque est le masque par défaut.
- Facultatif : cochez Forcer l'utilisateur à choisir un masque de numérotation. Il n'y a alors plus de masque par défaut : l'utilisateur choisit le masque dans chaque nouveau document.
- Facultatif : saisissez un masque dans Essayer un masque. La Prévisualisation des noms générés montre les trois prochains numéros.
- Cliquez sur Mettre à jour.
Modifier le compteur d'un masque
Vous pouvez changer le numéro de départ ou le numéro courant d'une série.
- Dans la section Mettre à jour le compteur d'un masque de numérotation, choisissez le Préfixe. Dokos affiche la Valeur actuelle.
- Saisissez la nouvelle valeur. Le prochain document prend la valeur suivante.
- Cliquez sur Mettre à jour le compteur.
Par exemple, si la valeur actuelle des commandes client est 16 et que vous saisissez 49, la prochaine commande prend le numéro 50.
Utiliser la valeur d'un champ
Pour insérer la valeur d'un champ, mettez son nom technique entre accolades, dans une partie séparée par des points : DEV-.{party_name}.-.YYYY.-.###.
| Syntaxe | Valeur insérée | Documents |
|---|---|---|
{party_name} | Identifiant du client ou de la piste | Devis |
{customer} | Identifiant du client | Commande client, bon de livraison, facture de vente |
{supplier} | Identifiant du fournisseur | Devis fournisseur, commande fournisseur, facture d'achat |
Exemple fictif Avec le masque
DEV-.{party_name}.-.YYYY.-.###, les devis du client « CLI-0042 » portent les numérosDEV-CLI-0042-2026-001,DEV-CLI-0042-2026-002, etc.
- Le compteur repart de 1 pour chaque combinaison préfixe + tiers + année. Chaque client a donc sa propre séquence.
- Un identifiant de tiers long ou avec des espaces donne des numéros longs. Préférez des identifiants de tiers courts.
- Si le champ n'existe pas dans le document (par exemple
{customer}sur un devis), la partie reste vide.
Documents modifiés
Dans la section Documents modifiés, le champ Masque de numérotation pour les documents modifiés définit le nom d'un document corrigé après annulation :
- Amend Counter (par défaut) : le nom d'origine suivi d'un compteur, par exemple
FA-2026-0001-1; - Default Naming : un nouveau numéro, pris dans le masque du document.
Le tableau Règles spécifiques permet de choisir une règle différente par type de document.
Règles de nommage des documents (cas avancé)
Pour des règles conditionnelles — par exemple un préfixe différent selon le groupe de clients — utilisez les Règles de nommage des documents, accessibles depuis la recherche (Ctrl+K).
Chaque règle combine :
- un masque de numérotation, qui peut contenir des champs entre accolades ;
- des conditions qui définissent quand la règle s'applique ;
- une priorité, pour départager plusieurs règles qui correspondent au même document.
Voir aussi : Nommage des documents dans Dodock
Remplir automatiquement le titre affiché (name + client/fournisseur)
Dans Dokos, deux champs distincts servent à identifier un document :
| Champ | Rôle | Contrôlé par |
|---|---|---|
name | Identifiant technique unique, visible dans l'URL et les listes | Séries de nommage |
title | Libellé affiché dans les listes et en en-tête de formulaire | Par défaut : nom du client ou du fournisseur |
Si vous souhaitez que le titre affiché combine le numéro du document et le nom du tiers — par exemple FAC-2024-001 - Maison Verte SARL au lieu de Maison Verte SARL — les séries de nommage ne suffisent pas : il faut alimenter le champ title via un Script serveur.
Configurer un Script serveur
server_script_enabled = true dans la configuration du site). Le rôle Gestionnaire de script est requis pour créer ou modifier des scripts.Créez un script par type de document concerné. Depuis la recherche (icône de loupe ou Ctrl+K), ouvrez Script Python, puis configurez :
- Type : Événement déclencheur
- Nom de l'événement :
Before Save
Le numéro définitif est attribué avant l'événement Before Save, y compris lors de la première sauvegarde — le script s'applique donc correctement dès la création du document.
Documents de vente (Quotation, Sales Order) :
doc.title = (doc.name or "") + " - " + (doc.customer_name or "")
Documents d'achat Purchase Order :
doc.title = (doc.name or "") + " - " + (doc.supplier_name or "")
Si la numérotation après validation est activée
Si vos documents reçoivent leur numéro définitif à la validation (fonctionnalité Dokos), le titre restera provisoire jusqu'à cette étape. Ajoutez un second script avec l'événement On Submit.
Before Submit ne peut pas être utilisé ici : à ce stade, le rename Dokos n'a pas encore eu lieu et doc.name contient encore le numéro provisoire du brouillon. C'est uniquement dans On Submit que le nom définitif est disponible.# Documents de vente (Sales Invoice)
frappe.db.set_value(doc.doctype, doc.name, "title", doc.name + " - " + (doc.customer_name or ""))
# Documents d'achat (Purchase Invoice)
frappe.db.set_value(doc.doctype, doc.name, "title", doc.name + " - " + (doc.supplier_name or ""))
Rendre le titre visible
Le champ title est masqué par défaut. Deux niveaux de visibilité :
- Dans le formulaire : ouvrez Personnaliser un formulaire sur le type de document, trouvez le champ
titleet décochez Caché. - Dans les vues liste ouvrez Personnaliser un formulaire sur le type de document, et changez la propriété
Champ titreàtitle.
Voir aussi : Scripts Python (Scripts serveur)