Démarrage

Paramètres de nommage des documents

Configurer les séries de nommage des documents avec des préfixes, l'exercice fiscal, des valeurs de champ et des règles de nommage.

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.

PartieValeur inséréeExemple
####Compteur, sur autant de chiffres que de #0042
YYYY / YYAnnée sur 4 ou 2 chiffres2026 / 26
MM / DDMois / jour03 / 05
WWNuméro de semaine10
JJJNuméro du jour dans l'année064
FYNom de l'exercice fiscal du document2025-2026
TFYNom de l'exercice fiscal, réduit à 2 chiffres par année25-26
ABBRAbréviation de la société du documentAN
{nom_du_champ}Valeur d'un champ du documentCLI-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

  1. Dans Sélectionner la transaction, choisissez le type de document. Dokos affiche ses masques dans Liste des masques pour cette transaction.
  2. Modifiez la liste. Mettez un masque par ligne. Le premier masque est le masque par défaut.
  3. 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.
  4. Facultatif : saisissez un masque dans Essayer un masque. La Prévisualisation des noms générés montre les trois prochains numéros.
  5. 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.

  1. Dans la section Mettre à jour le compteur d'un masque de numérotation, choisissez le Préfixe. Dokos affiche la Valeur actuelle.
  2. Saisissez la nouvelle valeur. Le prochain document prend la valeur suivante.
  3. 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.

Pour les factures, ne faites pas reculer un compteur : deux factures ne peuvent pas porter le même numéro, et la numérotation doit rester continue.

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.-.###.

SyntaxeValeur inséréeDocuments
{party_name}Identifiant du client ou de la pisteDevis
{customer}Identifiant du clientCommande client, bon de livraison, facture de vente
{supplier}Identifiant du fournisseurDevis fournisseur, commande fournisseur, facture d'achat

Exemple fictif Avec le masque DEV-.{party_name}.-.YYYY.-.###, les devis du client « CLI-0042 » portent les numéros DEV-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 :

  1. un masque de numérotation, qui peut contenir des champs entre accolades ;
  2. des conditions qui définissent quand la règle s'applique ;
  3. 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 :

ChampRôleContrôlé par
nameIdentifiant technique unique, visible dans l'URL et les listesSéries de nommage
titleLibellé affiché dans les listes et en en-tête de formulairePar 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

Les Scripts serveur doivent être activés par un administrateur système (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.

L'événement 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 title et 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)