# Bienvenue sur Dokos

Dokos est une plateforme complète pour la gestion des entreprises 100% libre, éthique et open-source.

::callout{color="amber"}
L'application Dokos est une adaptation locale de l'application ERPNext par [Frappe Technologies](https://github.com/frappe/erpnext){rel=""nofollow""} pensée pour les entreprise française et européennes. [**En savoir plus**](https://www.dokos.io/fr){rel=""nofollow""} ↗️
::

## Les grands concepts de Dokos

::card-group
  :::card
  ---
  icon: i-material-symbols-interactive-space-outline-rounded
  title: Les espaces de travail
  to: https://doc.dokos.io/v5/dokos/generalites/les_espaces_de_travail
  ---
  :::

  :::card
  ---
  icon: i-material-symbols-apk-document-outline-rounded
  title: Les documents
  to: https://doc.dokos.io/v5/dokos/generalites/les_documents
  ---
  :::
::

## Administrer son site

Le guide de toutes les fonctionnalités essentielles pour administrer efficacement votre plateforme.

::card-group
  :::card
  ---
  icon: i-material-symbols-newsstand
  title: Tableau de bord Administratif
  to: https://doc.dokos.io/v5/dokos/generalites/tableau_de_bord_administratif
  ---
  :::

  :::card
  ---
  icon: i-material-symbols-library-add-check-outline
  title: Rôles et autorisations
  to: https://doc.dokos.io/v5/dokos/generalites/roles_et_autorisations
  ---
  :::

  :::card
  ---
  icon: i-material-symbols-tools-power-drill-outline
  title: Outils de diagnostic
  to: https://doc.dokos.io/v5/dokos/generalites/les_outils_diagnostic
  ---
  :::

  :::card
  ---
  icon: i-material-symbols-web-stories-outline
  title: Personnalisation de l'interface
  to: https://doc.dokos.io/v5/dokos/generalites/personnaliser_l_interface
  ---
  :::

  :::card
  ---
  icon: i-material-symbols-reset-wrench
  title: Outils pratiques
  to: https://doc.dokos.io/v5/dokos/generalites/administration_outils_pratiques
  ---
  :::
::

## Principales fonctionnalités de Dokos

::card-group
  :::card
  ---
  icon: i-icon-park-outline-buy
  title: Achats
  to: https://doc.dokos.io/v5/dokos/achats
  ---
  Fournisseurs, cycle d'achat, appels d'offres
  :::

  :::card
  ---
  icon: i-ep-sell
  title: Ventes
  to: https://doc.dokos.io/v5/dokos/ventes
  ---
  Clients, devis, commandes, factures de vente
  :::

  :::card
  ---
  icon: i-uil-balance-scale
  title: Comptabilité
  to: https://doc.dokos.io/v5/dokos/comptabilite
  ---
  Découvrir les outils de gestion de la comptabilité
  :::

  :::card
  ---
  icon: i-carbon-chart-relationship
  title: CRM
  to: https://doc.dokos.io/v5/dokos/crm
  ---
  Découvrir les outils de gestion de la prospection
  :::

  :::card
  ---
  icon: i-material-symbols-location-on-outline-rounded
  title: Lieu
  to: https://doc.dokos.io/v5/dokos/lieu
  ---
  Réservations, abonnements, événements
  :::

  :::card
  ---
  icon: i-mdi-human-capacity-increase
  title: Ressources Humaines
  to: https://doc.dokos.io/v5/dokos/hrms
  ---
  Découvrir les outils de gestion RH
  :::

  :::card
  ---
  icon: i-fluent-manufacturer-24-regular
  title: Production
  to: https://doc.dokos.io/v5/dokos/production
  ---
  Découvrir les outils de gestion de la production
  :::

  :::card
  ---
  icon: i-eos-icons-project-outlined
  title: Gestion de projets
  to: https://doc.dokos.io/v5/dokos/projets
  ---
  Projets, tâches, suivi du temps
  :::

  :::card
  ---
  icon: i-carbon-rule-data-quality
  title: Gestion de la qualité
  to: https://doc.dokos.io/v5/dokos/qualite
  ---
  Découvrir les outils de gestion de la qualité
  :::

  :::card
  ---
  icon: i-vaadin-stock
  title: Gestion de stocks
  to: https://doc.dokos.io/v5/dokos/stocks
  ---
  Découvrir les outils de gestion des stocks
  :::

  :::card
  ---
  icon: i-ri-customer-service-2-line
  title: Support
  to: https://doc.dokos.io/v5/dokos/support
  ---
  Découvrir les outils de gestion de support client
  :::

  :::card
  ---
  icon: i-mdi-connection
  title: Intégrations
  to: https://doc.dokos.io/v5/dokos/integrations
  ---
  Découvrir les solutions intégrées avec Dokos
  :::
::


# Comparaison entre Dokos et ERPNext

### Gestion des abonnements

Les deux programmes offrent la possibilité de gérer des abonnements, cependant, leurs fonctionnements diffèrent entre les deux logiciels.

### Tableau de bord de rapprochement bancaire

Chaque logiciel propose un tableau de bord de rapprochement bancaire, mais les approches et les interfaces sont complètement différentes.

### Module de gestion de Lieu exclusif à Dokos

Le module de gestion de Lieu est une fonctionnalité exclusive à Dokos et n'est pas présent dans ERPNext.

### Gestion des données

Dokos ne permet pas la suppression générale de données ni la création d'un mode démo pour des raisons légales. De plus, la suppression de données de facturation ou de comptabilité (factures, paiements, écritures comptables) n'est pas possible dans Dokos en raison de contraintes légales.

### Plan comptable et Bilan

Dokos permet d'éditer un bilan adapté au format attendu en France. La configuration du plan comptable permet notamment d'affecter les comptes de tiers à l'actif ou au passif en fonction de leur solde, ce que ne permet pas ERPNext.

### Génération de numéros de facture et formats de fichiers

Dokos propose la génération de numéros de facture lors de la validation pour assurer des séquences chronologiques continues et sans rupture. De plus, Dokos prend en charge la génération de fichiers de prélèvement SEPA aux formats pain.008.001.02, pain.008.002.02 ou pain.008.003.02, ainsi que l'import de transactions bancaires au format OFX.

### Amortissement, achats multi-sociétés et factures d'acompte

Dokos propose des fonctionnalités spécifiques telles que l'amortissement linéaire des actifs selon les règles de calcul françaises, la possibilité de faire des achats auprès de plusieurs sociétés depuis le site e-commerce, et la création de factures d'acompte.

### Espaces de travail distincts

Dokos dispose de ses propres espaces de travail distincts de ceux d'ERPNext.

### Traduction française et API de paiement

La traduction française de Dokos est presque toujours complète et à jour. Les API de paiement via Stripe, Braintree et GoCardless ont été réécrites dans Dokos, offrant un flux de paiement en ligne différent de celui d'ERPNext. Cette différence permet notamment de proposer plusieurs modes de paiement lors des paiements via un lien de paiement.

### Configuration simplifiée pour la gestion des congés

Dokos a grandement simplifié le système de configuration pour la gestion des congés.

### Intégrations spécifiques

Dokos propose des modules de gestion de signature électronique via AdobeSign, ainsi que des intégrations spécifiques avec WooCommerce et Hiboutik.

### Planification graphique et vue Planning

Dokos propose un outil de planification graphique de quarts ainsi qu'une vue Planning pour tous les documents dotés de dates.


# Tutoriels en vidéo

Pour vous accompagner dans l'utilisation de Dokos, nous vous proposons différentes vidéos explicatives.

Retrouvez toutes nos vidéos sur notre [chaîne Youtube](https://www.youtube.com/channel/UC2f3m8QANAVfKi2Pzw2fBlw){rel=""nofollow""} .

### 1. Présentation globale du système dokos et prise en main

🎥 **Séquence 1**: [Navigation dans Dokos](https://www.youtube.com/watch?v=UaP3I7d7I9g&list=PLy7MEftWBZm1XCc0OPSAa7U4mAV6G-RVl&index=1){rel=""nofollow""}

🎥 **Séquence 2**: [Les espaces de travail](https://www.youtube.com/watch?v=akJU0NpAwqE&list=PLy7MEftWBZm1XCc0OPSAa7U4mAV6G-RVl&index=2){rel=""nofollow""} (Configuration)

🎥 **Séquence 3**: [Les utilisateurs, rôles et autorisations dans Dokos](https://www.youtube.com/watch?v=umxDQV17vW4&list=PLy7MEftWBZm1XCc0OPSAa7U4mAV6G-RVl&index=3){rel=""nofollow""}

🎥 **Séquence 4**: [Les types de documents et documents](https://www.youtube.com/watch?v=Ih-nnYoyXOk&list=PLy7MEftWBZm1XCc0OPSAa7U4mAV6G-RVl&index=4){rel=""nofollow""}\:br

### 2. Gestion des Ventes / Du devis à la facturation

🎥 **Séquence 1**: [Gestion des contacts, clients, fournisseurs](https://www.youtube.com/watch?v=t61pcz9MvVo&list=PLy7MEftWBZm1rUb0WfbM3Y_LKsfU4-R-c&index=1){rel=""nofollow""}

🎥 **Séquence 2**: [Création des articles et des prix](https://www.youtube.com/watch?v=kGrQPa6gXN8&list=PLy7MEftWBZm1rUb0WfbM3Y_LKsfU4-R-c&index=2){rel=""nofollow""}

🎥 **Séquence 3**: [Les flux de vente et achat](https://www.youtube.com/watch?v=Hi9pKGpQ6pI&list=PLy7MEftWBZm1rUb0WfbM3Y_LKsfU4-R-c&index=3){rel=""nofollow""}

🎥 **Séquence 4**: [Modèles de Taxes et TVA](https://www.youtube.com/watch?v=XKM-xUMD1KM&list=PLy7MEftWBZm1rUb0WfbM3Y_LKsfU4-R-c&index=4){rel=""nofollow""}\:br

### 3. Vente en ligne et encaissements

🎥 **Séquence 1**: [Gestion de la boutique en ligne](https://www.youtube.com/watch?v=TPbNswrFiPo&list=PLy7MEftWBZm0ZeCYRKc9YnIxztZVidKWI&index=1){rel=""nofollow""}

🎥 **Séquence 2**: [Mise en ligne d’un article](https://www.youtube.com/watch?v=54_pBTWhTQo&list=PLy7MEftWBZm0ZeCYRKc9YnIxztZVidKWI&index=2){rel=""nofollow""}

🎥 **Séquence 2**: [Encaissez les paiements [Partie 1]](https://www.youtube.com/watch?v=yWnc7xh0s6E&list=PLy7MEftWBZm0ZeCYRKc9YnIxztZVidKWI&index=3){rel=""nofollow""}

🎥 **Séquence 2**: [Encaissez les paiements [Partie 2]](https://www.youtube.com/watch?v=x0z2nhHCEAM&list=PLy7MEftWBZm0ZeCYRKc9YnIxztZVidKWI&index=4){rel=""nofollow""}\:br

### 4. La gestion des réservations et événements

🎥 **Séquence 1**: [Les articles réservables et calendriers](https://www.youtube.com/watch?v=AkAaewKFzRk&list=PLy7MEftWBZm38vKpUqTLePuj7-b5UI2pR&index=1){rel=""nofollow""}

🎥 **Séquence 2**: [La gestion des réservations](https://www.youtube.com/watch?v=LBQjltFGKu8&list=PLy7MEftWBZm38vKpUqTLePuj7-b5UI2pR&index=2){rel=""nofollow""}

🎥 **Séquence 3**: [Les événements](https://www.youtube.com/watch?v=Lu3g_gdmahM&list=PLy7MEftWBZm38vKpUqTLePuj7-b5UI2pR&index=3){rel=""nofollow""}

🎥 **Séquence 4**: [Créez une notification pour vos événements](https://www.youtube.com/watch?v=6Uo24FELf60&list=PLy7MEftWBZm38vKpUqTLePuj7-b5UI2pR&index=4){rel=""nofollow""}

:br

### 5. La gestion des abonnements et crédits de réservation

🎥 **Séquence 1**: [Présentation des abonnements](https://www.youtube.com/watch?v=mFjKIV2yLtQ&list=PLy7MEftWBZm1MprqZHjl6Ky0PjVxkfVTj&index=1){rel=""nofollow""}

🎥 **Séquence 2**: [Gérez les abonnements](https://www.youtube.com/watch?v=rvZLyABAihg&list=PLy7MEftWBZm1MprqZHjl6Ky0PjVxkfVTj&index=2){rel=""nofollow""}

🎥 **Séquence 3**: [Présentation des crédits de réservation](https://www.youtube.com/watch?v=Q7ir_xLqTQo&list=PLy7MEftWBZm1MprqZHjl6Ky0PjVxkfVTj&index=2){rel=""nofollow""}

🎥 **Séquence 4**: [Gérez les crédits de réservation](https://www.youtube.com/watch?v=aYV2TWRNFzY&list=PLy7MEftWBZm1MprqZHjl6Ky0PjVxkfVTj&index=4){rel=""nofollow""}

:br

### 6. Le site web / Portail utilisateur dans Dokos

🎥 **Séquence 1**: [La structure du site web](https://www.youtube.com/watch?v=4ZxypJwtsU8&list=PLy7MEftWBZm3DkrBBKSIT5-7cYVvJ-A3o&index=1){rel=""nofollow""}

🎥 **Séquence 2**: [Configuration de la boutique](https://www.youtube.com/watch?v=eL_K9Urv3g0&list=PLy7MEftWBZm3DkrBBKSIT5-7cYVvJ-A3o&index=2){rel=""nofollow""}\:br

### 7. Utilisation du CRM

🎥 **Séquence 1**: [Présentation du CRM](https://www.youtube.com/watch?v=7OdZ39OfwfM&list=PLy7MEftWBZm3q0FiRPXWN5IgIMvaJg2zG&index=1){rel=""nofollow""}

🎥 **Séquence 1**: [Publiez sur les réseaux sociaux](https://www.youtube.com/watch?v=hogyWi9YGsQ&list=PLy7MEftWBZm3q0FiRPXWN5IgIMvaJg2zG&index=2){rel=""nofollow""}

🎥 **Séquence 1**: [Créez des Newsletter et Campagnes](https://www.youtube.com/watch?v=cxHuxwSDZp0&list=PLy7MEftWBZm3q0FiRPXWN5IgIMvaJg2zG&index=3){rel=""nofollow""}\:br

### 8. Gestion des achats et de la TVA

🎥 **Séquence 1**: [Enregistrez vos articles d'achat](https://www.youtube.com/watch?v=v5RnyKg6ggM&list=PLy7MEftWBZm2qwe80e36CslH4kYCATxVc&index=1){rel=""nofollow""}

🎥 **Séquence 2**: [Automatisation de la TVA](https://www.youtube.com/watch?v=cipKAPCtWwY&list=PLy7MEftWBZm2qwe80e36CslH4kYCATxVc&index=2){rel=""nofollow""}

🎥 **Séquence 1**: [Gestion de la TVA intracommunautaire](https://www.youtube.com/watch?v=5P6vq989nBc&list=PLy7MEftWBZm2qwe80e36CslH4kYCATxVc&index=3){rel=""nofollow""}\:br

### 9. La gestion de projet

🎥 **Séquence 1**: [Présentation de la gestion de projet](https://www.youtube.com/watch?v=j4dZV5OSKfI&list=PLy7MEftWBZm2kPJXm7CEaxQgNnzwtVxcy&index=1){rel=""nofollow""}

🎥 **Séquence 2**: [Gestion du temps et coût du projet](https://www.youtube.com/watch?v=3LRwxD0hh4A&list=PLy7MEftWBZm2kPJXm7CEaxQgNnzwtVxcy&index=2){rel=""nofollow""}

🎥 **Séquence 3**: [Dimension comptable](https://www.youtube.com/watch?v=jhhLuwWXAFI&list=PLy7MEftWBZm2kPJXm7CEaxQgNnzwtVxcy&index=3){rel=""nofollow""}

:br

### 10. La Comptabilité

🎥 **Séquence 1**: [Présentation de la comptabilité](https://www.youtube.com/watch?v=YAHqMosWUiU&list=PLy7MEftWBZm1BktK55wkTJJ6XYGpChORB&index=1){rel=""nofollow""}

🎥 **Séquence 2**: [Le fonctionnement comptable](https://www.youtube.com/watch?v=fZu6L67LewY&list=PLy7MEftWBZm1BktK55wkTJJ6XYGpChORB&index=2){rel=""nofollow""}

:br

### 11. Démarrer sur Dokos

🎥 **Séquence 1**: [Démarrer sur Dokos](https://www.youtube.com/watch?v=3FjDAdgiJOU&list=PLy7MEftWBZm3VgU6F2TmTxf2elacNiZaJ){rel=""nofollow""}

🎥 **Séquence 1**: [Autres configurations de bases](https://www.youtube.com/watch?v=9JM9Ea4T184&list=PLy7MEftWBZm3VgU6F2TmTxf2elacNiZaJ&index=2){rel=""nofollow""}

:br

### 12. Gestion des stocks

🎥 **Séquence 1**: [Les entrées de stocks dans Dokos](https://www.youtube.com/watch?v=ZBSzfysJHJM&list=PLy7MEftWBZm3DEkIOtulrra3rOe8Z4cb-){rel=""nofollow""}

🎥 **Séquence 2**: [Les sorties de stocks dans Dokos](https://www.youtube.com/watch?v=6Sr-PBi3W2M&list=PLy7MEftWBZm3DEkIOtulrra3rOe8Z4cb-&index=2){rel=""nofollow""}

:br

### 13. Gestion des stocks

🎥 **Séquence 1**: [Présentation de la production](https://www.youtube.com/watch?v=Tp_j3uUfkMU&list=PLy7MEftWBZm2g7-fWeCdW6HRhN6CkgI1p&index=1){rel=""nofollow""}

🎥 **Séquence 2**: [Plan de production](https://www.youtube.com/watch?v=KWzLYx7pS8c&list=PLy7MEftWBZm2g7-fWeCdW6HRhN6CkgI1p&index=2){rel=""nofollow""}


# Les outils pratiques

## **Communication et productivité**

![administration\_outils.png](https://doc.dokos.io/generalites_dokos/administrer_son_site/administration_outils.png)

- **Communications** : Accédez à tous les emails envoyés et reçus au sein de Dokos
- **To-Do** : Gérez vos tâches et celles assignées à vos équipes
- **Notes** : Créez des mémos internes ou des notifications pour les utilisateurs
- **Explorateur de fichiers** : Retrouvez tous vos documents

## **Automatisation**

- **Répétitions automatiques** : Programmez la récurrence de certains documents
- **Règles d'attribution** : Assignez automatiquement des documents selon des conditions prédéfinies
- **Règles de points d'énergie** : Gamifiez l'utilisation du système en récompensant certaines actions

## **💡 Astuces du quotidien**

- **Raccourci Ctrl+K / Cmd+K** : Ouvrez rapidement la barre de recherche rapide (Awesome Bar)
- **Raccourci Ctrl+G / Cmd+G** : Ouvrez la recherche globale pour trouver n'importe quel enregistrement dans Dokos
- **Raccourci Ctrl+J** : Affichez tous les champs disponibles dans un document ou dans une ligne de tableau ouverte en éditeur détaillé
- **Paramètres de notifications** : Personnalisez ce que vous souhaitez recevoir comme alertes

### Raccourcis clavier dans le menu latéral

Le menu latéral (sidebar) affiche désormais les **raccourcis clavier** directement à côté des entrées de menu qui en possèdent un.

Cela vous permet de découvrir et mémoriser facilement les raccourcis disponibles sans avoir à les chercher ailleurs : il vous suffit d'ouvrir le menu latéral pour voir quelles actions sont accessibles au clavier.

**Exemple :** en ouvrant le menu latéral, vous pouvez voir que l'entrée « Nouvelle note » affiche son raccourci à côté de son libellé, vous rappelant qu'il est possible d'y accéder directement depuis le clavier.

Cette amélioration facilite la prise en main des raccourcis pour les nouveaux utilisateurs et accélère la navigation pour les utilisateurs réguliers.

### L'avatar utilisateur et le menu de profil

Dans la barre latérale de Dokos, votre **avatar utilisateur** (la photo ou les initiales affichées en bas du menu) est désormais un **bouton cliquable** qui ouvre un menu déroulant.

Ce menu vous donne accès rapidement à :

- Vos **paramètres de profil** (nom, photo, préférences)
- La **déconnexion** de votre session
- D'autres actions liées à votre compte

Cette évolution remplace l'ancien comportement où l'avatar était un simple élément visuel non interactif. Vous n'avez plus besoin de naviguer dans les menus pour gérer votre profil : un simple clic sur votre avatar suffit.

**Exemple :** connecté en tant que Thomas Dupont, cliquez sur vos initiales « TD » en bas du menu latéral pour accéder directement à vos paramètres ou vous déconnecter.

### Accéder à un champ avec Ctrl+J

Le raccourci **Ctrl+J** (ou **Cmd+J** sur Mac) ouvre une palette de navigation qui liste tous les champs du document en cours et permet de s'y déplacer instantanément.

#### Dans un document standard

Appuyez sur **Ctrl+J** depuis n'importe quel endroit du document : une fenêtre s'ouvre, listant tous les champs disponibles. Cliquez sur un champ ou naviguez au clavier pour y accéder directement, sans faire défiler manuellement la page.

**Exemple :** sur une commande client longue, appuyez sur **Ctrl+J** et tapez « Conditions » pour atteindre immédiatement le champ *Conditions de paiement*, même s'il se trouve en bas du formulaire.

#### Dans l'éditeur détaillé d'une ligne de tableau

Lorsqu'une ligne d'un tableau (par exemple une ligne d'articles dans une commande) est ouverte dans son **éditeur détaillé** (fenêtre modale), le raccourci **Ctrl+J** affiche désormais les champs de **cette ligne**, et non plus ceux du document parent.

Cela est particulièrement utile dans les tableaux qui contiennent de nombreuses colonnes — certaines n'étant visibles que dans l'éditeur détaillé.

**Exemple :** dans une commande fournisseur à Bureau Moderne, ouvrez l'éditeur détaillé d'une ligne d'article en cliquant sur l'icône de développement de la ligne. Appuyez ensuite sur **Ctrl+J** : la palette affiche uniquement les champs de cette ligne (quantité, prix unitaire, remise, compte comptable, etc.). Sélectionnez le champ souhaité pour y accéder directement.

> 💡 Le raccourci fonctionne même si le curseur est déjà positionné dans un champ de la ligne — ce qui est le cas habituel dans l'éditeur détaillé.


# Impression et PDF

Au-delà des formats d'impression classiques, Dokos offre plusieurs fonctionnalités d'édition avancées : l'ajout de pages de couverture en première et dernière page d'un PDF, la génération de courriers formatés avec en-tête, et la personnalisation du style visuel des impressions grâce à un champ CSS dédié. Ces outils permettent de produire des documents professionnels sans sortir de Dokos.

## Impression sur mobile :badge{text="v5" type="tip"}

> **Exemple — Maison Verte SARL**
> L'équipe commerciale de Maison Verte SARL utilise souvent des tablettes pour consulter les devis chez les clients. Avec la nouvelle option d'impression dans le menu du formulaire, ils peuvent générer un PDF du devis directement depuis leur tablette, sans avoir à ouvrir le panneau latéral, ce qui simplifie grandement le processus de validation sur place.

Depuis Dokos v5, l'option **Imprimer** est désormais disponible directement dans le menu du formulaire sur les appareils mobiles et les écrans de petite taille. Cette amélioration permet d'accéder rapidement à la fonction d'impression sans avoir à ouvrir le panneau latéral, ce qui rend le processus plus fluide et intuitif.

### Comportement

- L'option **Imprimer** apparaît dans le menu du formulaire uniquement sur les écrans de taille inférieure au point d'arrêt `lg` (généralement 1024px).
- Sur les écrans plus grands (desktop), l'option reste accessible uniquement via le panneau latéral, comme auparavant.
- Les mêmes conditions de visibilité s'appliquent : l'option n'est visible que si le document est imprimable (paramètres d'impression configurés, permission `can_print` accordée, et format d'impression disponible pour le type de document).

### Comment imprimer depuis un appareil mobile

1. Ouvrez le document que vous souhaitez imprimer (ex. : un devis, une facture, un bon de commande).
2. Appuyez sur le bouton **Menu** (⋮) en haut à droite du formulaire.
3. Sélectionnez **Imprimer** dans la liste des options.
4. Choisissez le format d'impression souhaité et générez le PDF comme sur desktop.

::callout{color="blue" icon="i-heroicons-information-circle"}
Cette fonctionnalité est particulièrement utile pour les équipes terrain qui utilisent des tablettes ou des smartphones pour consulter et valider des documents chez les clients ou en déplacement.
::

## Pages de couverture PDF :badge{text="Dokos" type="warning"}

> **Exemple — Cabinet Veraison**
> Le cabinet Veraison envoie ses propositions commerciales en PDF. Il a configuré une page de couverture avec le logo du cabinet et une page de quatrième de couverture avec les mentions légales. Chaque devis généré depuis Dokos inclut automatiquement ces deux pages, sans manipulation manuelle dans un éditeur PDF externe.

Un format d'impression dans Dokos peut être associé à une page de couverture en début de document et à une page de quatrième de couverture en fin de document. Chaque page de couverture est un fichier PDF préalablement téléchargé dans Dokos et configuré depuis le formulaire **Page de couverture**.

Une fois les pages de couverture rattachées à un format d'impression, elles s'ajoutent automatiquement à chaque génération PDF — que ce soit depuis le bouton Imprimer, lors d'un envoi par email, ou par le biais d'une automatisation.

### Configuration

::dokos
1. Créer une **Page de couverture** depuis le menu Impression et y rattacher le fichier PDF correspondant.
2. Ouvrir le **Format d'impression** concerné.
3. Indiquer la page de couverture de début et/ou de fin dans les champs dédiés.
::

::demo-link{demo="Dokompany" doctype="Print Format"}
Voir les formats d'impression dans la démo
::

## Courriers formatés en PDF :badge{text="Dokos" type="warning"}

> **Exemple — Tribu SCOP**
> L'équipe de Tribu SCOP rédige un courrier d'accompagnement pour un appel d'offres directement dans Dokos, sélectionne l'en-tête de la société et génère un PDF prêt à l'envoi en un clic, sans passer par un traitement de texte.

Dokos permet de générer un courrier en PDF à partir d'un contenu HTML et d'un en-tête de lettre existant. Le résultat est un document PDF mis en page avec les coordonnées et le logo de la société, téléchargeable immédiatement ou joint automatiquement à un document.

Cette fonctionnalité est disponible depuis les contextes qui proposent la génération de courriers — par exemple lors de l'envoi d'une communication formelle associée à un dossier.

::demo-link{demo="Dokompany" doctype="Letter Head"}
Voir l'en-tête de lettre dans la démo
::

## CSS personnalisé sur l'en-tête de lettre

> **Exemple — Maison Verte SARL**
> Maison Verte SARL souhaite que ses factures imprimées affichent le nom du client en vert et utilisent une police spécifique pour les titres. L'équipe administrative saisit directement les règles CSS dans le champ prévu sur l'en-tête de lettre, sans toucher au HTML ni faire appel à un développeur.

L'en-tête de lettre dispose d'un champ **CSS personnalisé** dédié. Les règles de style saisies dans ce champ sont automatiquement appliquées lors de l'impression d'un document (format d'impression) et lors de la génération de rapports associés à cet en-tête.

Ce champ remplace l'ancienne pratique qui consistait à glisser des balises `<style>` à l'intérieur des champs HTML de l'en-tête — une méthode qui posait des problèmes de sécurité et de maintenabilité.

### Ce que vous pouvez faire

- Modifier la typographie (police, taille, couleur) des éléments de vos impressions
- Ajuster les marges, espacements et bordures
- Appliquer un style différent selon l'en-tête de lettre utilisé (ex. : une charte graphique par entité juridique)
- Cibler précisément les zones du document imprimé grâce aux sélecteurs CSS standards

### Comment configurer le CSS

1. Ouvrir la liste **En-tête de lettre** (Letterhead) depuis Paramètres > Impression.
2. Sélectionner l'en-tête de lettre à personnaliser ou en créer un nouveau.
3. Faire défiler jusqu'à la section **CSS personnalisé**.
4. Saisir les règles CSS dans le champ dédié (exemple ci-dessous).
5. **Enregistrer**, puis générer un aperçu d'impression pour vérifier le rendu.

```css
/* Exemple : couleur de l'en-tête de tableau et police globale */
body {
  font-family: 'Arial', sans-serif;
  font-size: 12px;
}
th {
  background-color: #2e7d32;
  color: #ffffff;
}
.print-heading {
  font-size: 18px;
  font-weight: bold;
}
```

> **Bon à savoir** : le CSS saisi ici s'applique à toutes les impressions utilisant cet en-tête de lettre, qu'il s'agisse d'un document (facture, devis, bon de commande…) ou d'un rapport imprimé.

::demo-link{demo="Dokompany" doctype="Letter Head"}
Voir l'en-tête de lettre dans la démo
::

## Moteurs de génération PDF

Dokos utilise un moteur de rendu pour transformer vos documents en PDF. Deux moteurs sont disponibles, avec des comportements différents en matière de mise en page, de CSS supporté et de gestion des sauts de page.

### WKHTMLTOPDF (moteur historique)

WKHTMLTOPDF est le moteur historique, basé sur une version ancienne du moteur WebKit. Il est installé automatiquement avec Dokos et ne nécessite aucune configuration particulière.

**Limitations connues :**

- Support CSS limité : pas de CSS Grid, Flexbox partiel, pas de variables CSS
- Gestion des sauts de page parfois imprécise (coupures en milieu de paragraphe, dernière page blanche)
- Incompatible avec Bootstrap 4 ou 5

### Moteur Chrome :badge{text="v5" type="tip"}

Depuis Dokos v5, un deuxième moteur basé sur Chromium (le moteur de Google Chrome) est disponible. Il offre un rendu fidèle aux standards web actuels et résout la plupart des problèmes de mise en page rencontrés avec WKHTMLTOPDF.

**Avantages :**

- Support CSS complet : Grid, Flexbox moderne, variables CSS, Bootstrap 4 et 5
- Meilleure gestion des sauts de page et des paragraphes
- Rendu identique à ce que vous voyez dans le navigateur

**Prérequis :** Chromium (\~150 Mo) est téléchargé automatiquement à l'activation.

### Comparaison

| Fonctionnalité        | WKHTMLTOPDF | Chrome      |
| --------------------- | ----------- | ----------- |
| Installé par défaut   | Oui         | Non         |
| CSS Grid              | Non         | Oui         |
| Flexbox complet       | Partiel     | Oui         |
| Variables CSS         | Non         | Oui         |
| Bootstrap 4 / 5       | Non         | Oui         |
| Sauts de page fiables | Limité      | Oui         |
| Consommation mémoire  | Faible      | Plus élevée |

### Configurer le moteur de génération PDF

Le moteur peut être défini à deux niveaux :

**Niveau global** (s'applique à tous les formats d'impression) :

> Paramètres > Paramètres d'impression > **Générateur PDF**

**Par format d'impression** (prioritaire sur le réglage global) :

> Ouvrez un format d'impression > champ **Générateur PDF**

Les deux options proposées sont `wkhtmltopdf` et `chrome`.

## Contrôle des sauts de page à l'impression

::callout{color="blue" icon="i-heroicons-information-circle"}
Les problèmes de sauts de page décrits ci-dessous sont liés aux limitations du moteur **WKHTMLTOPDF**. Si vous rencontrez des difficultés persistantes, envisagez de passer au moteur **Chrome** (disponible depuis la v5), qui gère nativement ces cas sans contournement CSS.
::

### Éviter les coupures en milieu de paragraphe ou de section

Par défaut, WKHTMLTOPDF peut couper un paragraphe ou une section au milieu lorsqu'un document s'imprime sur plusieurs pages. Pour forcer un bloc à rester entier sur la même page, ajoutez des règles CSS dans le champ **CSS personnalisé** de votre format d'impression ou de votre en-tête de lettre :

```css
/* Garder les sections entières sur la même page */
.section-break {
  page-break-inside: avoid;
}

/* Garder les paragraphes entiers */
p {
  page-break-inside: avoid;
}
```

### Forcer un saut de page avant une section

Pour insérer un saut de page avant une section spécifique (ex. : avant le tableau des articles), utilisez :

```css
.break-before {
  page-break-before: always;
}
```

Appliquez la classe `break-before` à la section concernée dans votre format d'impression.

### Éviter les veuves et orphelines

Pour éviter qu'une ligne isolée ne se retrouve en haut ou en bas d'une page :

```css
p {
  orphans: 3;
  widows: 3;
}
```

### Exemple complet

```css
/* Styles pour une impression professionnelle */
.section-break {
  page-break-inside: avoid;
}

.break-before {
  page-break-before: always;
}

p, ul, ol {
  page-break-inside: avoid;
  orphans: 3;
  widows: 3;
}

/* Style spécifique pour les tableaux */
table {
  page-break-inside: avoid;
}
```

## Print Designer

Pour les entreprises souhaitant créer des formats d'impression visuels sans écrire de code HTML, l'application **Print Designer** propose un éditeur WYSIWYG avec glisser-déposer. Elle s'appuie sur le moteur Chrome pour le rendu.

::docs-card
[Print Designer](https://doc.dokos.io/v5/dodock/frappe-products/print-designer)
::


# **Explorer les documents dans Dokos**

Un document dans Dokos est une fiche contenant des &#x2A;*champs pré-paramétrés,** **personnalisables** selon les besoins.

Voici comment les afficher et interagir avec eux :

![tableau\_de\_bord\_les\_vues](https://doc.dokos.io/generalites_dokos/LMS_lesvues.png)

## **Les différentes vues disponibles**

Dokos permet d'afficher les documents sous plusieurs formes :

- **Liste** : Vue rapide avec statut et champs personnalisables (limité à 5-6 champs).
- **Rapport** : Affichage en tableau, avec ajout de colonnes et options de tri avancées.
- **Tableau de bord** : Statistiques synthétiques sur les données clés.
- **Kanban** : Organisation sous forme de cartes basées sur un champ sélectionné (ex : statut).
- **Image** : Affichage de photos associées aux documents (ex : clients, événements).
- **Calendrier / Planification** : Vue chronologique des événements et tâches attribuées.

## **Fonctionnalités communes à tous les documents**

- **Ajout de pièces jointes 📎**
- **Attribution à un utilisateur spécifique 👤**
- **Ajout d'étiquettes (tags) pour faciliter la recherche 🏷️**
- **Partage avec d'autres utilisateurs (comme un Drive classique) 🔗**
- **Ajout de commentaires en bas des documents 💬**
- **Envoi d'emails directement depuis un document 📧**

## Raccourci clavier pour créer un nouveau document

Depuis n'importe quelle vue liste, le raccourci **Ctrl+B*&#x2A; (ou **⌘+B** sur Mac) ouvre immédiatement le formulaire de création d'un nouveau document du même type, sans avoir à cliquer sur le bouton « Nouveau ».

> **Exemple — Maison Verte SARL**
> Léa consulte la liste des commandes clients. Elle veut en créer une nouvelle rapidement : elle appuie sur **Ctrl+B** et le formulaire de nouvelle commande s'ouvre sans qu'elle n'ait besoin de déplacer sa souris jusqu'au bouton « Nouveau ».

Ce raccourci est disponible dans toutes les vues liste de Dokos et s'applique au type de document actuellement affiché.

## Indicateur de communications non lues :badge{text="Dokos" type="warning"}

> **Exemple — Dupont Conseil**
> Marie ouvre la liste des commandes fournisseurs et remarque l'icône de commentaire bleue sur la commande CMD-2024-00089. Elle sait immédiatement qu'un email ou un commentaire attend sa lecture sur ce document, sans avoir à l'ouvrir un par un.

Dans la vue liste, Dokos affiche une icône de communication colorée à côté de chaque document qui contient un message non encore consulté. L'icône passe au bleu dès qu'une communication (email reçu, commentaire, note) est liée au document sans avoir été vue. Le premier utilisateur qui ouvre le document remet le compteur à zéro pour tous — l'indicateur disparaît et le document est considéré comme lu.

Ce mécanisme permet à une équipe de repérer en un coup d'œil les documents qui nécessitent une attention sans configurer de règles de notification spécifiques.

::demo-link{demo="Dokompany" doctype="Sales Order"}
Voir un exemple de liste de commandes de vente dans la démo
::

## Attribution avec date d'échéance et priorité :badge{text="Dokos" type="warning"}

> **Exemple — Maison Verte SARL**
> Thomas attribue un bon de commande à sa collègue Amina en indiquant une date d'échéance au 30 avril et une priorité Haute. Amina reçoit immédiatement un email qui mentionne le document concerné, la date limite et le niveau d'urgence — sans avoir à ouvrir Dokos pour comprendre ce qui lui est demandé.

Lors de l'attribution d'un document à un utilisateur, Dokos enrichit automatiquement l'email de notification avec la date d'échéance et le niveau de priorité définis au moment de l'attribution. L'email est envoyé immédiatement. Le destinataire dispose ainsi de toutes les informations nécessaires directement dans sa boîte mail, sans étape supplémentaire.

::demo-link{demo="Dokompany" doctype="Sales Order"}
Voir un bon de commande dans la démo — utilisez le bouton Attribuer pour tester l'attribution
::

## Suivre un document :badge{text="Dokos" type="warning"}

> **Exemple — Agence Créative Leblanc**
> Sophie, directrice commerciale, veut rester informée de l'avancement d'un contrat important sans en être l'assignée. Elle clique sur "Suivre" dans la barre latérale du document. Chaque modification lui est ensuite signalée par email selon la fréquence qu'elle a choisie dans ses préférences.

Chaque document Dokos affiche dans sa barre latérale une section "Suivi" avec un lien **Suivre** / **Ne plus suivre**. Un utilisateur qui suit un document reçoit des notifications par email à chaque modification (sauvegarde, validation, commentaire, attribution). La fréquence — horaire, quotidienne ou hebdomadaire — se configure dans les **Paramètres utilisateur** de chaque personne, indépendamment des autres.

La barre latérale affiche également la liste des autres utilisateurs qui suivent le même document, ce qui rend la veille collective visible.

::demo-link{demo="Dokompany" doctype="Sales Order"}
Ouvrir un bon de commande dans la démo et consulter la barre latérale
::

## Répétition automatique — aperçu des occurrences futures :badge{text="Dokos" type="warning"}

> **Exemple — Maison Verte SARL**
> Maison Verte génère une facture récurrente pour un abonnement mensuel. Dans la configuration de la répétition, l'équipe peut voir immédiatement les dates des prochaines échéances avant de valider la règle, évitant ainsi de lancer par erreur une répétition sur une mauvaise période.

Dokos affiche la liste des occurrences futures directement dans le document de configuration de répétition automatique. Avant même la première exécution, l'utilisateur peut vérifier que les dates générées correspondent bien à ses attentes — fréquence, point de départ, nombre de répétitions. Cette visualisation est propre à Dokos et n'existe pas dans la configuration standard.

::demo-link{demo="Dokompany" doctype="Auto Repeat"}
Voir la liste des répétitions automatiques dans la démo
::

## Variables dynamiques dans le champ Remarques :badge{text="Dokos" type="warning"}

Le champ **Remarques** des transactions Dokos supporte la syntaxe Jinja2. Toute variable du document peut être insérée avec `{{ doc.champ }}` et sera automatiquement remplacée par sa valeur à la sauvegarde.

> **Exemple — Maison Verte SARL**
> La remarque `Commande passée par {{ doc.contact_display }} le {{ doc.transaction_date }}` devient automatiquement `Commande passée par Jean Dupont le 24/04/2026` lors de l'enregistrement du document.

Cette fonctionnalité permet de générer des remarques contextuelles standardisées sans ressaisie manuelle — utile pour les références internes, les mentions légales variables ou les messages personnalisés.

## Colonnes de devise de base sur les transactions multi-devises :badge{text="Dokos" type="warning"}

Lorsqu'une transaction est saisie en devise étrangère, Dokos affiche automatiquement dans la grille d'articles les colonnes correspondant à la **devise de la société** (taux de base, montant de base, montant net de base). Ces colonnes apparaissent uniquement quand la devise du document diffère de celle de la société, et restent masquées sinon.

> **Exemple — Bureau Moderne**
> Une commande fournisseur en USD affiche, pour chaque ligne d'article, à la fois le prix en USD et son équivalent en EUR au taux de change du jour. Le service comptable peut ainsi valider la contre-valeur sans quitter la grille.

Cette visibilité simultanée des deux devises évite les conversions manuelles et réduit les erreurs de saisie sur les transactions internationales.

## Recherche de champs avec autocomplétion

Dans plusieurs contextes de l'interface, Dokos propose désormais un **champ de recherche avec autocomplétion** à la place d'une liste déroulante fixe pour sélectionner un champ de document. Cette amélioration concerne notamment :

- **La vue liste** — lors du choix d'un champ pour l'édition en masse ou la modification groupée.
- **Les tableaux enfants** — lors de l'édition en masse d'une colonne dans une grille.
- **Les rapports** — lors de l'ajout d'une colonne à un rapport de requête.

> **Exemple — Maison Verte SARL**
> Sophie souhaite ajouter la colonne « Mode de paiement » à un rapport sur les commandes clients. Auparavant, elle devait faire défiler une longue liste pour trouver le champ. Elle tape maintenant « paiement » dans le champ de recherche et les résultats se filtrent instantanément.

Cette recherche par autocomplétion est particulièrement utile sur les types de documents comportant de nombreux champs (Commande client, Écriture comptable, etc.), où la liste déroulante classique devenait difficile à parcourir.


# Les espaces de travail

Un Espace de travail représente des éléments d'un module (par exemple, le CRM) et comprend plusieurs sections :

- **Tableaux de bord & Rapports** : Vue synthétique et analytique des données du module.
- **Raccourcis** : Accès rapide aux fonctionnalités fréquemment utilisées.
- **Liste des données référentielles et transactionnelles** : Répertorie tous les éléments gérés dans ce module. ![mon\_tableau\_de\_bord\_les\_graphiques\_les\_raccourcis](https://doc.dokos.io/generalites_dokos/LMS_premierspas_espacedetravail1.png)![mon\_tableau\_de\_bord\_la\_liste\_des\_documents\_referentiels\_transactionnels](https://doc.dokos.io/generalites_dokos/LMS_premierspas_espacedetravail2bis.png)

## Navigation et mémorisation de la barre latérale

Lorsque vous naviguez entre plusieurs espaces de travail, Dokos mémorise automatiquement la dernière barre latérale que vous avez consultée pour chaque entité. Ainsi, lorsque vous revenez sur un espace de travail ou un document que vous avez déjà ouvert, vous retrouvez directement la barre latérale que vous utilisiez précédemment — sans avoir à la rouvrir manuellement.

> **Exemple — Maison Verte SARL**
> Sophie travaille sur la fiche du client Maison Verte SARL et consulte le panneau latéral « Activité ». Elle navigue ensuite vers un autre module, puis revient sur cette fiche : Dokos affiche de nouveau le panneau « Activité » automatiquement, sans qu'elle ait besoin de le rouvrir.

Cette mémorisation fonctionne par entité (chaque type de document conserve son propre contexte) et persiste pendant toute la session de travail.

## Personnalisation des Espaces de Travail

Vous pouvez modifier un espace de travail existant en cliquant sur "*Modifier*" (coin supérieur droit de la page). Si vous ne voyez pas le bouton "*Modifier*", il vous manque le rôle "**Gestionnaire d'espace de travail**"

::callout
⚠️ Attention, ces modifications sont partagées avec tous les utilisateur et seront visibles que tous !
::

*Si vous souhaitez aller plus loin, Dokos permet la création d'espaces de travail entièrement personnalisés ! 🎨*

## Créer un espace de travail personnalisé

1. Cliquez sur "**Créer un Espace de travail**".
2. Remplissez les champs suivants. Le "*Titre*" de votre espace, le *type d'icône* et la *couleur* que vous souhaitez.
3. "**L'espace de travail parent**" : cette fonctionnalité vous permettra de créer des groupes si nécessaire.
4. "**Public**": Accessible à tous les utilisateurs ayant les droits d'accès

*💡 Nous verrons plus tard comment restreindre des espaces de travail à certains rôles !*

![tableau\_de\_bord\_creer\_un\_espace\_de\_travail](https://doc.dokos.io/generalites_dokos/LMS_espacedetravail_3.png)

## Restriction des modules par domaine d'activité :badge{text="Dokos" type="warning"}

> **Exemple — Dupont Conseil**
> Dupont Conseil n'utilise pas la production ni la gestion des stocks. L'administrateur active uniquement les domaines "Services" et "Comptabilité" dans les Paramètres des domaines. Les menus de production et de stocks disparaissent alors pour l'ensemble des utilisateurs du site, simplifiant la navigation sans supprimer les fonctionnalités.

Les domaines permettent aux gestionnaires de système de restreindre les modules et formulaires accessibles à tous les utilisateurs d'un site. La configuration se fait depuis le formulaire **Paramètres des domaines**, accessible depuis le menu Administration. Seuls les modules correspondant aux domaines actifs restent visibles dans la barre latérale et dans la recherche globale.

::dokos
Cette option est réservée aux administrateurs système. Elle s'applique globalement à tous les utilisateurs du site et non par rôle ou par personne.
::

::demo-link{demo="Dokompany" path="/app/domain-settings"}
Voir les Paramètres des domaines dans la démo
::


# Les outils diagnostic

## **L'inspecteur**

Accessible via la barre de recherche, cet outil technique vous permet de vérifier rapidement si un utilisateur dispose des autorisations nécessaires pour une action donnée.

![administration\_inspecteur.png](https://doc.dokos.io/generalites_dokos/administrer_son_site/administration_inspecteur.png)

## **Messages d'erreur**

En cas de problème d'autorisation, lisez attentivement les messages d'erreur qui apparaissent - ils indiquent généralement précisément quels droits manquent.

## **Le Recorder**

Le [Recorder](https://doc.dokos.io/v5/dodock/utilisation/les-outils-diagnostic/recorder) est un outil avancé pour suivre les requêtes, les événements du cycle de vie des documents et les performances des scripts et webhooks. Il est particulièrement utile pour déboguer des comportements complexes ou optimiser les performances de votre instance Dokos.


# Personnalisation de l'interface

Dokos propose dans ses **Paramètres** (via la barre de navigation) de personnaliser l'interface pour l'adapter au mieux à vos besoins.

## Identité visuelle

- Remplacez le logo Dokos par le vôtre.
- Ajoutez un widget d'annonce pour diffuser des messages à toute l'équipe.

## Tableaux de bord et statistiques

![administration\_personnalisation\_de\_l\_interface](https://doc.dokos.io/generalites_dokos/administrer_son_site/administration_personnalisation.png)

Dokos propose de nombreux outils de visualisation :

- Cartes statistiques (près de 100 préexistantes).
- Graphiques de tableau de bord.
- Cartes de résumé (particulièrement utiles pour les moyennes et grandes entreprises).

## Types de documents personnalisés

Dokos vous offre la possibilité de créer vos propres types de documents adaptés à vos besoins spécifiques. Par exemple :

- Un document "annonce" pour publier des offres.
- Un formulaire web pour permettre des réservations.
- Des documents interconnectés pour suivre votre processus métier.

**À noter** : Les personnalisations que vous effectuez (ajout/suppression de champs) ne seront jamais écrasées lors des mises à jour.

## Totaux et montants sur les liens du tableau de bord :badge{text="Dokos" type="warning"}

> **Exemple — Maison Verte SARL**
> Sur la fiche client de Maison Verte SARL, le tableau de bord affiche non seulement le nombre de factures de vente, mais aussi le total facturé (4 800,00 €) et le montant encore dû (1 200,00 €). Le commercial voit en un coup d'œil la situation financière du client sans ouvrir chaque facture.

Le tableau de bord d'une fiche (client, fournisseur, article…) affiche des liens vers les documents liés avec, en option, des totaux monétaires calculés à la volée. Cette configuration est réservée aux administrateurs et développeurs : elle se définit dans le fichier de configuration du tableau de bord du type de formulaire concerné.

::dokos
**Configuration pour les administrateurs et développeurs**

Chaque groupe de liens dans la configuration du tableau de bord peut recevoir une clé `summary_fields` associant un type de formulaire à un calcul de total. Les options disponibles sont :

| Clé            | Rôle                                                                                                       |
| -------------- | ---------------------------------------------------------------------------------------------------------- |
| `field`        | Champ numérique dont la somme est calculée (ex. `net_total`)                                               |
| `label`        | Libellé affiché pour le total (ex. "Total facturé")                                                        |
| `fieldtype`    | Type d'affichage : `Currency`, `Float`, `Int`                                                              |
| `open_field`   | Champ pour le calcul du sous-total "ouvert" (ex. `outstanding_amount`)                                     |
| `open_label`   | Libellé du sous-total ouvert (ex. "En attente")                                                            |
| `open_filters` | Filtres supplémentaires pour le sous-total ouvert (ex. `{"docstatus": 1, "outstanding_amount": [">", 0]}`) |

Exemple tiré de la fiche client :

```python
"summary_fields": {
    "Sales Invoice": {
        "field": "net_total",
        "label": _("Total Billed"),
        "fieldtype": "Currency",
        "open_field": "outstanding_amount",
        "open_label": _("Outstanding"),
        "open_filters": {"docstatus": 1, "outstanding_amount": [">", 0]},
    },
}
```
::

::demo-link{demo="Dokompany" doctype="Customer"}
Voir une fiche client dans la démo — le tableau de bord affiche les totaux facturés et le montant en attente
::

## Icônes sur les types de formulaires :badge{text="Dokos" type="warning"}

> **Exemple — Dupont Conseil**
> L'administrateur de Dupont Conseil crée un type de formulaire personnalisé "Dossier client" et lui attribue l'icône `folder`. Partout où un lien vers ce formulaire apparaît dans l'interface — champs de recherche, listes liées, résultats de recherche globale — une petite icône dossier s'affiche à gauche pour distinguer visuellement ce type de document.

Chaque type de formulaire dans Dokos peut recevoir une icône issue de la bibliothèque d'icônes Frappe. Cette icône s'affiche à gauche des champs de saisie qui pointent vers ce formulaire, aidant les utilisateurs à identifier le type de document associé sans lire le nom complet.

::dokos
La configuration de l'icône se fait directement sur le formulaire du **Type de document**, dans le champ **Icône**. Cette option est destinée aux administrateurs et développeurs qui créent ou modifient des types de formulaires personnalisés. Les types de formulaires fournis par Dokos sont déjà configurés avec leurs icônes par défaut.
::

::demo-link{demo="Dokompany" doctype="Sales Order"}
Ouvrir un bon de commande dans la démo — les champs de lien affichent l'icône du type de document associé
::

## Modification en masse dans les tables enfants

> **Exemple — Maison Verte SARL**
> Un gestionnaire saisit un bon de commande pour Maison Verte SARL avec vingt lignes d'articles. Il réalise que la date de livraison prévue est incorrecte sur dix d'entre elles. Au lieu de corriger chaque ligne une par une, il coche les dix lignes concernées, clique sur **Modifier**, saisit la nouvelle date une seule fois, et toutes les lignes sélectionnées sont mises à jour instantanément.

Lorsqu'un formulaire contient une table enfant (lignes d'articles, plannings, etc.), il est possible de modifier plusieurs lignes simultanément. Cette fonctionnalité évite les saisies répétitives et réduit les risques d'erreur.

### Comment l'utiliser

1. Ouvrez le document concerné (bon de commande, facture, feuille de temps…).
2. Dans la table enfant, cochez les cases à gauche des lignes à modifier.
3. Un bouton **Modifier** (icône crayon) apparaît dans la barre d'outils de la table.
4. Cliquez sur **Modifier** : une fenêtre s'ouvre avec les champs modifiables.
5. Renseignez uniquement les champs à changer — les champs laissés vides ne seront pas affectés.
6. Cliquez sur **Mettre à jour** : toutes les lignes sélectionnées sont mises à jour dans le formulaire.
7. Enregistrez le document pour valider les changements.

> **Bon à savoir** : Sur un document déjà soumis, seuls les champs autorisés à la modification après soumission apparaissent dans la fenêtre de modification en masse.

### Activer ou désactiver cette option

Par défaut, la modification en masse est activée sur toutes les tables enfants. Un administrateur peut la désactiver champ par champ depuis **Personnaliser le formulaire** :

1. Allez dans **Personnaliser le formulaire** (menu Configuration ou barre de recherche).
2. Sélectionnez le type de formulaire concerné (ex. *Bon de commande*).
3. Repérez le champ de type **Table** correspondant à la table enfant.
4. Décochez l'option **Autoriser la modification en masse**.
5. Cliquez sur **Mettre à jour**.

::dokos
**Pour les développeurs** : l'option est également configurable directement dans la définition du DocType via le champ `allow_bulk_edit` sur le champ de type `Table`. Elle peut aussi être positionnée dans le fichier JSON du DocType pour les types de formulaires personnalisés gérés en code.
::

## Largeur des colonnes dans la vue liste

> **Exemple — Bureau Moderne**
> La responsable achats de Bureau Moderne consulte la liste des bons de commande. La colonne "Fournisseur" est trop étroite et tronque les noms. Elle fait glisser le bord de la colonne vers la droite pour l'élargir : la largeur est sauvegardée automatiquement et restera en place à chaque prochaine ouverture de la liste.

Dans toutes les vues liste de Dokos, vous pouvez ajuster la largeur de chaque colonne selon vos préférences. Ces réglages sont personnels et persistent d'une session à l'autre.

### Trois façons d'ajuster les largeurs

::mermaid
flowchart LR
A\[Largeur définie
sur le champ] -->|priorité basse| B\[Paramètres
de la vue liste]
B -->|priorité moyenne| C\[Glisser-déposer
dans l'en-tête]
C -->|priorité haute| D\[Largeur affichée]

::

#### 1. Glisser-déposer directement dans l'en-tête de liste

C'est la méthode la plus rapide pour un ajustement ponctuel :

1. Positionnez le pointeur sur le **séparateur vertical** entre deux en-têtes de colonne — une fine poignée apparaît.
2. Cliquez et faites glisser vers la gauche ou la droite pour modifier la largeur.
3. Relâchez : la nouvelle largeur est enregistrée automatiquement dans les Paramètres de la vue liste.

> **Bon à savoir** :
>
> - Les poignées de redimensionnement sont toujours légèrement visibles au repos. Survolez la ligne d'en-têtes pour les faire apparaître toutes en même temps.
> - **Double-cliquez** sur le bord de l'en-tête pour ajuster automatiquement la largeur au contenu le plus large de la colonne.
> - Survolez directement une poignée pour la mettre en évidence.

#### 2. Paramètres de la vue liste

Pour régler les largeurs de plusieurs colonnes à la fois :

1. Cliquez sur le menu &#x2A;*⋮** (en haut à droite de la liste) puis sur **Paramètres de la vue liste**.
2. Dans le dialogue, la colonne &#x2A;*Largeur (px)** apparaît à côté de chaque champ affiché.
3. Saisissez la valeur souhaitée en pixels (minimum 50 px, maximum 400 px).
4. Cliquez sur **Enregistrer**.

#### 3. Définition sur le champ (administrateurs)

Un administrateur peut définir une largeur par défaut directement sur un champ depuis **Personnaliser le formulaire**. Cette valeur s'applique à tous les utilisateurs qui n'ont pas encore défini leur propre réglage.

### Contraintes

| Paramètre        | Valeur                                   |
| ---------------- | ---------------------------------------- |
| Largeur minimale | 50 px                                    |
| Largeur maximale | 400 px                                   |
| Sauvegarde       | Automatique après chaque glisser-déposer |
| Portée           | Par utilisateur et par vue liste         |

## Filtres avancés sur les champs de lien :badge{text="Dokos" type="warning"}

> **Exemple — Maison Verte SARL**
> Dans le département **Comptabilité** de Maison Verte SARL, l'administrateur souhaite limiter les approbateurs possibles aux seuls **Utilisateurs système** (et non aux **Utilisateurs du site web**). En configurant un filtre avancé sur le champ **Approbateur** dans les tables enfants du formulaire **Département**, seuls les utilisateurs système apparaissent désormais dans la liste de sélection.

Dokos permet aux administrateurs et développeurs de restreindre les valeurs disponibles dans les champs de lien (comme les approbateurs, fournisseurs, ou employés) en appliquant des **filtres avancés**. Cette fonctionnalité est particulièrement utile pour éviter les erreurs de sélection et garantir que seuls les utilisateurs ou documents pertinents soient disponibles.

### Cas d'usage courants

- **Département** : Limiter les approbateurs aux **Utilisateurs système** (exclure les **Utilisateurs du site web**).
- **Bon de commande** : Filtrer les fournisseurs actifs uniquement.
- **Feuille de temps** : Restreindre les projets aux seuls projets en cours.

### Configuration via l'interface

1. Allez dans **Personnaliser le formulaire** (menu **Configuration** ou barre de recherche).
2. Sélectionnez le type de formulaire concerné (ex. *Département*).
3. Repérez le champ de type **Table** contenant le champ de lien à filtrer (ex. *Leave Approvers*).
4. Dans les options du champ de table, recherchez **Filtre de requête** (ou **set\_query** pour les développeurs).
5. Saisissez le filtre sous forme de dictionnaire JSON. Par exemple, pour limiter aux **Utilisateurs système** :

   ```json
   {
     "doctype": "User",
     "filters": {
       "user_type": "System User"
     }
   }
   ```
6. Enregistrez les modifications.

### Configuration via le code (développeurs)

Pour les développeurs, les filtres avancés peuvent être définis directement dans le code JavaScript ou Python du formulaire. Par exemple, pour appliquer un filtre sur un champ de table enfant :

```javascript
// Dans le fichier JavaScript du formulaire (ex. department.js)
frappe.ui.form.on('Department', {
  refresh(frm) {
    // Appliquer un filtre sur le champ 'approver' dans la table 'leave_approvers'
    frm.set_query('approver', 'leave_approvers', function() {
      return {
        filters: {
          user_type: 'System User'
        }
      };
    });
  }
});
```

::dokos
**Bon à savoir** :

- Les filtres avancés peuvent combiner plusieurs conditions (ex. `{"user_type": "System User", "enabled": 1}`).
- Ils s'appliquent **uniquement** aux champs de type **Lien** ou **Sélection dynamique**.
- Pour les tables enfants, le filtre doit être appliqué **individuellement** à chaque champ de lien concerné.
::

::demo-link{demo="Dokompany" doctype="Department"}
Voir un département dans la démo — les champs **Approbateur** dans les tables enfants affichent uniquement les **Utilisateurs système**
::


# La gestion des utilisateurs

## **Types d'utilisateurs et groupes**

Dokos vous permet de gérer finement vos utilisateurs et leurs permissions :

### **Groupes d'utilisateurs**

L'intérêt principal des groupes est de permettre des assignations collectives. Par exemple, si vous avez plusieurs comptables, vous pouvez :

- Attribuer des tâches à l'ensemble du groupe comptabilité
- Mentionner le groupe dans les commentaires avec **@nomdugroupe** pour notifier tous ses membres

### **Types d'utilisateurs**

Cette fonctionnalité permet d'accorder des autorisations spécifiques à certaines catégories d'utilisateurs.

### **Suivi des activités**

Dokos offre deux journaux complémentaires :

- **Journal d'activité** : Retrace l'ensemble des actions réalisées sur votre plateforme
- **Journal d'accès** : Enregistre les connexions et déconnexions des utilisateurs

---

## **Rôles et autorisations**

### **Comprendre les rôles**

Un rôle est un ensemble d'autorisations groupées qui définit ce qu'un utilisateur peut faire dans le système.

![administration\_les\_roles](https://doc.dokos.io/generalites_dokos/administrer_son_site/administration_les_autorisations.png)

### **Configuration par défaut**

Par défaut, un nouvel utilisateur reçoit le rôle de "**client**", lui donnant uniquement accès au portail. Vous pouvez ensuite lui attribuer des rôles supplémentaires.

### **Structure des autorisations**

Pour chaque rôle, vous définissez :

- Les types de documents concernés
- Les actions autorisées (lecture, écriture, impression, annulation, validation)

Par exemple, un utilisateur avec le rôle "acheteur" pourra créer des contacts, gérer des adresses et des commandes fournisseurs, mais aura uniquement un droit de lecture sur les exercices fiscaux.

### **Niveaux d'autorisation**

Chaque champ sur vos formulaires est associé à un niveau d'autorisation (de 0 à 9 par défaut), permettant une gestion plus fine des accès :

**Exemple pratique** : Dans une demande de congés, certains éléments peuvent être réservés au manager (niveau 1). De même, un employé qui saisit ses notes de frais ne verra pas la partie comptable, accessible uniquement aux comptables disposant d'une autorisation de niveau supérieur.

### **Personnalisation des rôles**

Vous avez la flexibilité de :

- Créer vos propres rôles
- Désactiver les rôles standard
- Dupliquer des rôles existants pour les adapter

**Bonne pratique** : Pour des modifications importantes, il est recommandé de désactiver les rôles standard et de créer vos propres rôles personnalisés. Cela évite que vos personnalisations ne soient écrasées lors des mises à jour.

### **Profils de rôle**

![administrateurs\_les\_profils](https://doc.dokos.io/generalites_dokos/administrer_son_site/administration_profil_de_role.png)

Les profils de rôle vous permettent de combiner plusieurs rôles pour créer des ensembles cohérents d'autorisations. Par exemple, dans l'équipe RH, vous pourriez avoir :

- Un profil "Responsable RH" avec des droits étendus
- Un profil "Utilisateur RH" avec des droits plus limités comme pour les stagiaires

Un utilisateur peut se voir attribuer plusieurs profils selon ses responsabilités.

#### **Rôles spéciaux**

- **Responsable système** : Accès complet à l'administration du système
- **Invité** : Utilisé pour les utilisateurs non connectés
- **Drive Admin** : Accès complet à la gestion des espaces de travail et des fichiers partagés (voir section ci-dessous)

### **Gestion des espaces de travail et Drive Admin**

Dokos intègre un système de gestion des fichiers et des espaces de travail qui permet aux utilisateurs de collaborer efficacement. Pour faciliter l'administration de ces espaces, un nouveau rôle **Drive Admin** a été ajouté aux profils de rôle liés à la gestion des espaces de travail.

#### **Qu'est-ce que le rôle Drive Admin ?**

Le rôle **Drive Admin** donne aux utilisateurs les autorisations nécessaires pour :

- Créer, modifier et supprimer des espaces de travail
- Gérer les permissions d'accès aux espaces de travail
- Organiser et structurer les fichiers partagés
- Configurer les paramètres de partage et de collaboration

#### **Profils concernés**

Ce rôle a été automatiquement ajouté aux profils de rôle suivants pour les gestionnaires d'espaces :

- **Gestionnaire d'espace** : Pour les utilisateurs responsables de la gestion quotidienne des espaces de travail
- **Responsable d'équipe** : Pour les managers qui supervisent plusieurs espaces et équipes

#### **Comment vérifier les profils de rôle ?**

Pour consulter ou modifier les profils de rôle incluant le rôle **Drive Admin** :

1. Allez dans **Paramètres > Utilisateurs et permissions > Profils de rôle**
2. Sélectionnez un profil concerné (ex: "Gestionnaire d'espace")
3. Vérifiez que le rôle **Drive Admin** est bien coché dans la liste des rôles associés
4. Sauvegardez si vous effectuez des modifications

#### **Exemple d'utilisation**

**Scénario** : Sophie est responsable de l'espace de travail "Projets 2025" dans votre organisation. Avec le rôle **Drive Admin**, elle peut :

- Créer des sous-espaces pour chaque projet (ex: "Projet Alpha", "Projet Beta")
- Ajouter ou retirer des membres de ces espaces
- Configurer les permissions pour que certains membres puissent uniquement consulter les fichiers, tandis que d'autres peuvent les modifier
- Archiver les espaces terminés pour garder une structure claire

**Avantage** : Cette intégration automatique du rôle **Drive Admin** dans les profils de gestion d'espaces simplifie la configuration initiale et garantit que les utilisateurs disposent immédiatement des droits nécessaires pour administrer leurs espaces de travail.

### **🚫 Restriction par espace de travail**

Les profils de module vous permettent de contrôler quels modules sont visibles pour chaque utilisateur :

**Important** : Les profils de module contrôlent uniquement la visibilité des espaces de travail dans la barre latérale, mais n'affectent pas les autorisations. Un utilisateur peut toujours accéder à des documents via la recherche s'il dispose des autorisations nécessaires.

Cette fonctionnalité puissante vous permet de limiter l'accès des utilisateurs à certaines données.

### **Exemple concret**

Imaginons que votre entreprise gère deux sociétés : Dokos et Mappemonde. Si Raphaëlle est salariée de Dokos, vous pouvez restreindre son accès pour qu'elle ne voie que les documents liés à Dokos.

### **Fonctionnement**

Les restrictions s'appliquent automatiquement à tous les documents contenant le champ spécifié (par exemple "société"). Vous pouvez également :

- Définir une valeur par défaut pour les nouveaux documents créés par l'utilisateur
- Masquer les descendants (utile dans une structure de holding avec filiales)
- Appliquer des restrictions par département, centre de coûts, ou même sur des champs personnalisés

**Attention** : Pour les employés, des restrictions sont créées automatiquement lors de l'association d'un utilisateur à un profil employé. Vérifiez toujours ce paramètre.

---

## **Rapport des autorisations par type de document**

Le rapport **Autorisations utilisateur par type de document** (accessible via *Paramètres > Utilisateurs et droits*) vous offre une vue d'ensemble des droits accordés à chaque utilisateur pour chaque type de document.

### **Types de permissions affichés**

Le rapport présente les types d'autorisations standard (lecture, écriture, création, suppression, validation, annulation, etc.) ainsi que tous les **types de permissions personnalisés** que vous avez définis dans votre installation.

Cela signifie que si votre organisation a créé des permissions métier sur mesure — par exemple "Approbation RH", "Validation comptable" ou tout autre droit spécifique à votre activité — ils apparaissent désormais dans ce rapport au même titre que les permissions standard.

### **Comment exploiter ce rapport**

1. Rendez-vous dans **Paramètres → Utilisateurs et droits → Autorisations utilisateur par type de document**
2. Filtrez par utilisateur, par rôle ou par type de document selon vos besoins
3. Consultez l'ensemble des colonnes : chaque colonne correspond à un type de permission (standard ou personnalisé)
4. Identifiez rapidement qui dispose de quels droits sur quel document

**Exemple** : Pour vérifier que Raphaëlle (de la société Dokos) dispose bien du droit de validation sur les commandes fournisseurs, filtrez le rapport sur son nom d'utilisateur et repérez la colonne correspondante.

### **Intérêt pour les permissions personnalisées**

Si votre administrateur a défini des types de permissions supplémentaires via les **Gestionnaires de rôles** ou par personnalisation du framework, ces permissions s'affichent automatiquement dans le rapport sans configuration supplémentaire. Vous n'avez pas besoin de les ajouter manuellement : le rapport les détecte et les intègre à la grille d'analyse.


# Suivi et validation des documents

Quand une organisation valide une facture, un bon de commande ou tout autre document soumettable, Dokos enregistre automatiquement des informations essentielles : qui a validé, à quelle heure, si le document a été imprimé et si son intégrité est garantie. Ces mécanismes fonctionnent sans configuration particulière dès que les options correspondantes sont activées sur un type de formulaire.

## Traçabilité de la validation :badge{text="Dokos" type="warning"}

> **Exemple — Tribu SCOP**
> Laure, comptable chez Tribu SCOP, valide une facture de vente le 3 mars à 14h22. Dokos enregistre immédiatement son nom et l'horodatage exact. Un mois plus tard, lors d'un contrôle fiscal, l'auditeur peut confirmer sans ambiguïté qui a validé ce document et à quel moment.

Dès qu'un document est validé, Dokos note automatiquement la date et l'heure de validation ainsi que l'identifiant de l'utilisateur responsable. Ces informations sont stockées directement dans le document et ne peuvent pas être modifiées manuellement. Elles sont visibles dans l'historique des modifications et exploitables dans les rapports.

## Numérotation après validation :badge{text="Dokos" type="warning"}

> **Exemple — Association Les Tilleuls**
> Les Tilleuls émettent leurs factures en mode brouillon avec un numéro provisoire (BROUILLON-2024-00042). Une fois la facture validée, elle reçoit automatiquement son numéro définitif FA-2024-00007 — le prochain dans la séquence officielle. Cela évite les trous dans la numérotation liés aux brouillons abandonnés.

Certains formulaires dans Dokos sont configurés pour attribuer leur numéro définitif uniquement au moment de la validation, et non à la création du brouillon. Le numéro provisoire utilisé pendant la phase de préparation est conservé comme référence interne, tandis que le numéro officiel (conforme à la séquence comptable ou réglementaire) est généré lors de la soumission. Cette approche garantit une numérotation sans interruption dans les séries officielles.

Cette option est activée dans la configuration du type de formulaire concerné.

::demo-link{demo="Dokompany" path="/app/doctype/Sales%20Invoice"}
Voir la configuration du type de formulaire Facture de vente dans la démo
::

## Suivi d'impression :badge{text="Dokos" type="warning"}

> **Exemple — Garage Moreau**
> Le gérant du Garage Moreau imprime un bon de livraison le 5 avril à 09h10. Dokos note automatiquement cette date. En cas de litige avec un client qui prétend ne jamais avoir reçu le document, l'équipe peut vérifier qu'une impression a bien eu lieu ce jour-là.

Quand l'option de suivi d'impression est activée sur un type de formulaire, Dokos enregistre la date et l'heure de la première impression. Cette information n'est pas mise à jour lors des impressions suivantes — elle certifie uniquement que le document a bien été imprimé au moins une fois. Elle est disponible dans les vues liste et les rapports pour filtrer les documents déjà imprimés.

## Scellage cryptographique :badge{text="Dokos" type="warning"}

> **Exemple — Cabinet de conseil Veraison**
> Veraison utilise un module soumis à des exigences réglementaires. Chaque document validé est automatiquement scellé : son contenu est haché et enchaîné aux documents précédents. Toute tentative de modification ultérieure serait détectée immédiatement lors d'un audit.

Le scellage cryptographique protège l'intégrité des documents soumis dans les contextes réglementés (logiciels de caisse certifiés, archivage légal, etc.). Quand cette option est activée sur un type de formulaire, Dokos génère une empreinte numérique du document au moment de sa validation. Cette empreinte est enchaînée à celle du document précédent, créant une séquence ininterrompue qui garantit qu'aucun document n'a été altéré ou supprimé.

Les documents scellés sont archivés dans un journal immuable. Toute suppression ou modification après scellage est techniquement bloquée.

::demo-link{demo="Dokompany" doctype="Sales Invoice"}
Voir une facture de vente validée dans la démo — la barre latérale affiche la date de validation et l'utilisateur responsable
::

## Voir aussi

- [Certification caisse](https://doc.dokos.io/v5/dokos/certification-caisse)
- [Rôles et autorisations](https://doc.dokos.io/v5/dokos/generalites/roles_et_autorisations)
- [Impression et PDF](https://doc.dokos.io/v5/dokos/generalites/impression-et-pdf)


# Le tableau de bord Administratif

Bienvenue dans Dokos, votre logiciel de gestion complet ! Le module **Administration** est votre centre de contrôle pour superviser l'ensemble du système.

## **Tableau de bord administratif**

![tableau\_de\_bord\_administratif](https://doc.dokos.io/generalites_dokos/administrer_son_site/module_administration_tableau_de_bord.png)

Sur le tableau de bord, vous pouvez visualiser :

- Le **nombre total d'utilisateurs actifs**
- Les **connexions en échec** des 30 derniers jours
- La **répartition des connexions par type d'utilisateur**

---

## **Journaux et suivi système**

![administration\_les\_journaux](https://doc.dokos.io/generalites_dokos/administrer_son_site/administration_les_journaux.png)

:br

### **Journal des erreurs**

Ce journal recense toutes les erreurs survenues sur le système, quelle que soit leur typologie. Rassurez-vous, la présence d'erreurs n'est pas nécessairement préoccupante ! Il est important d'analyser ces erreurs pour :

- Résoudre des problèmes techniques potentiels
- Identifier des dysfonctionnements sur votre site
- Obtenir des informations sur des processus qui ne se sont pas déroulés comme prévu

Si vous rencontrez des difficultés :

- **Sans contrat de support** : Ouvrez un ticket sur [Gitlab](https://gitlab.com/groups/dokos/-/issues){rel="&#x22;nofollow&#x22;"}
- **Avec contrat de support** : Envoyez un email à <help@dokos.cloud>

**Note importante** : Le [forum](https://community.dokos.io/){rel="&#x22;nofollow&#x22;"} est principalement dédié aux questions d'usage, tandis que [Gitlab](https://gitlab.com/groups/dokos/-/issues){rel="&#x22;nofollow&#x22;"} est réservé aux problèmes techniques ou aux signalements de bugs.

### **Journal des tâches de fond programmées**

Ce journal vous permet de surveiller l'état des tâches automatisées. Portez une attention particulière aux tâches dont le statut est "**Échec**" - cela signifie que des processus programmés pour s'exécuter à intervalles réguliers n'ont pas pu être complétés pour diverses raisons.

### **Demandes d'intégration**

Cette section répertorie tous les événements reçus des sites externes, principalement les notifications envoyées par les passerelles de paiement. Par exemple, lors d'un paiement en ligne, vous recevez en temps réel les informations de la transaction, puis quelques secondes plus tard, un webhook de confirmation du statut du paiement. Si vous avez mis en place des passerelles de paiement, vérifiez régulièrement s'il y a des échecs, qui pourraient indiquer des transactions non finalisées.


# Paramétrage

::card-group
  :::card{title="Société" to="https://doc.dokos.io/v5/dokos/parametrage/societe"}
  La société
  :::

  :::card
  ---
  title: Plan comptable
  to: https://doc.dokos.io/v5/dokos/parametrage/plan-comptable
  ---
  Le plan comptable
  :::

  :::card
  ---
  title: Articles
  to: https://doc.dokos.io/v5/dokos/parametrage/articles
  ---
  Les articles
  :::

  :::card{title="Prix" to="https://doc.dokos.io/v5/dokos/parametrage/prix"}
  Les prix
  :::

  :::card{title="Clients" to="https://doc.dokos.io/v5/dokos/parametrage/clients"}
  Les clients
  :::

  :::card
  ---
  title: Fournisseurs
  to: https://doc.dokos.io/v5/dokos/parametrage/fournisseurs
  ---
  Les fournisseurs
  :::
::


# La société

::tour{doctype="Company"}
Découvrir le document **Société** dans la démo
::

## Informations générales

La société constitue le fondement initial de l'organisation de la gestion et de la comptabilité dans Dokos. Ce document renferme divers paramètres par défaut qui s'appliqueront à l'ensemble de vos transactions.

> Par exemple, vous pouvez sélectionner un en-tête d'impression qui sera utilisé pour toutes les transactions associées à cette société.

## L'abréviation

L'abréviation est utilisée pour différencier certains types de documents en fonction de leur rattachement à une société donnée.

> Pour illustrer, les comptes comptables sont tous créés à travers le type de document **Compte** et peuvent posséder un numéro et un libellé identiques au sein de différentes sociétés. L'abréviation est employée pour générer des identifiants de comptes distincts pour chaque société.

## La devise

La devise de la société constitue la monnaie de référence utilisée par défaut dans le plan comptable et les transactions. Toutefois, vous pouvez également utiliser d'autres devises dans vos opérations.

## Le plan comptable

Le plan comptable forme l'épine dorsale de la comptabilité de votre société. Lors de la création d'une nouvelle société, deux options s'offrent à vous :

- Utiliser un modèle standard inclus dans Dokos.
- Copier le plan comptable d'une société existante.

::callout{color="teal" icon="i-heroicons-light-bulb"}
En France, Dokos propose un plan comptable général simplifié pour faciliter l'initialisation de votre plan de comptes. Vous pouvez partir de cette base pour configurer l'ensemble de vos comptes.
::

Il est important de noter que, pour les filiales, le plan comptable est établi en fonction de la société mère.

*Pour en savoir plus :* [Le plan comptable](https://doc.dokos.io/v5/dokos/parametrage/plan-comptable)

## Multi-sociétés

Dokos autorise la création de plusieurs sociétés. La structure de l'entreprise peut être parallèle, impliquant des sociétés sœurs, des relations mère-enfant, ou une combinaison des deux.

Une société mère représente une entité hiérarchiquement supérieure qui englobe une ou plusieurs sociétés filles. Ces dernières sont des filiales de la société mère. Les comptes des filiales doivent correspondre à ceux de la société mère afin de permettre le regroupement des comptes dans un plan comptable consolidé.

::callout{color="teal" icon="i-heroicons-light-bulb"}
L'arborescence (affichée sous forme d'arbre) des sociétés permet de visualiser la structure globale de vos entreprises ainsi que leurs relations hiérarchiques.
::

En mode *multi-société*, il est possible d'effectuer des transactions d'achats ou de ventes entre les différentes sociétés.

## Objectif de vente mensuel

Vous avez la possibilité de définir un objectif de ventes mensuelles dans la devise de la société, par exemple 10 000 €. Une fois la société créée, un graphique comparant cet objectif avec vos ventes mensuelles sera généré.

## Comptes par défaut

Les comptes comptables configurés dans la fiche de la société contribuent à la détermination comptable lors des transactions. Lors de la création de la société, un ensemble de comptes est pré-configuré. Nous vous recommandons de vérifier cette configuration et de l'adapter selon les besoins de votre société.

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Si vous êtes indécis quant à la configuration d'un compte, il est recommandé de laisser le champ vide. Cela générera une erreur dans les transactions concernées par ce type de compte, vous permettant ainsi de le paramétrer manuellement pour achever la transaction. Cette méthode peut également être employée pour contraindre les utilisateurs à choisir manuellement un compte dans une transaction. Par exemple, si aucun compte de charge n'est configuré dans la fiche d'un article ou de son groupe, il est préférable que Dokos n'attribue pas automatiquement un compte de charge par défaut provenant de la fiche de la société, car cela risquerait de ne pas correspondre.
::

### Stock Livré Mais Non Facturé

Le champ **Stock Livré Mais Non Facturé** permet de configurer le compte comptable intermédiaire utilisé lorsque des marchandises sont livrées à un client avant d'être facturées.

Lorsque ce compte est renseigné, Dokos comptabilise automatiquement le coût des articles dans ce compte d'actif circulant intermédiaire à la validation du bon de livraison. Le coût est ensuite transféré vers le compte de charges (coût des marchandises vendues) uniquement à la validation de la facture de vente correspondante.

Vous pouvez également cocher **Désactiver le SLMNF pour les retours clients** si vous souhaitez que les retours sur ventes contournent ce mécanisme et s'imputent directement en charges.

→ [En savoir plus sur le mécanisme Stock Livré Mais Non Facturé](https://doc.dokos.io/v5/dokos/comptabilite/stock-livre-non-facture)

## En-têtes de lettre par défaut

La fiche de la société permet de définir deux en-têtes de lettre distincts, appliqués automatiquement selon le contexte d'impression :

- **En-tête de lettre par défaut pour les documents** : utilisé lors de l'impression des pièces comptables et commerciales (factures, devis, bons de commande…).
- **En-tête de lettre par défaut pour les rapports** : utilisé lors de la génération et de l'impression des rapports (bilan, grand livre, etc.).

Cette distinction permet d'adapter la mise en page à chaque usage — par exemple, appliquer un en-tête sobre pour les rapports internes et un en-tête à l'identité visuelle complète pour les documents envoyés aux clients.

> **Exemple** : La société *Maison Verte SARL* utilise un en-tête avec logo et coordonnées pour ses factures clients, et un en-tête simplifié sans logo pour ses rapports comptables mensuels.

::callout{color="teal" icon="i-heroicons-light-bulb"}
Les en-têtes de lettre se configurent dans **Paramètres > En-tête de lettre**. Vous pouvez y créer autant de modèles que nécessaire et les affecter ensuite à vos sociétés.
::

## Inventaire périodique / permanent

Par défaut, l'inventaire permanent est désactivé dans Dokos.

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Les écritures comptables générées par la fonctionnalité d'inventaire permanent ne sont pas encore conformes aux règles comptables françaises. Cette documentation sera mise à jour lorsque ce sera le cas.
::

## Informations légales & diverses

Vous avez la possibilité de fournir diverses informations concernant votre société, telles que le numéro de TVA, le site internet et les informations légales. Ces données pourront être utilisées pour l'impression de vos documents à travers différents formats d'impression.

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Lorsque vous associez une adresse à votre société, il est crucial de cocher la case « Est l'adresse de votre société ».
::


# Le plan comptable

Le plan comptable est une arborescence des comptes dont une entreprise a besoin pour gérer sa comptabilité. Dokos met en place un plan comptable simplifié pour chaque société que vous créez, mais vous pouvez le modifier en fonction de vos besoins et exigences légales.

Pour la France, il est basé sur le Plan Comptable Général et doit être adapté pour toute société faisant sa comptabilité dans Dokos.

::callout{color="teal" icon="i-heroicons-light-bulb"}
Si vous ne souhaitez pas tenir votre comptabilité dans Dokos, vous n'avez pas besoin de faire d'adaptation du plan comptable installé par défaut. Assurez-vous simplement que tous les comptes par défaut sont renseignés dans la fiche de la société pour que le logiciel ne génère pas d'erreurs dans les transactions.
::

---

::tour{doctype="Account"}
Voir les **Comptes** dans la démo
::

## Structure du plan comptable

La structure du plan comptable de Dokos suit les règles suivantes:

- Chaque compte doit être rattaché à une *racine*
- Il existe 5 types de racines: Actif / Passif / Capitaux propres / Produits / Charges
- Chaque compte doit être rattaché au Bilan ou au Compte de résultat (Type de rapport)

::callout{color="teal" icon="i-heroicons-light-bulb"}
Dans la comptabilité française, les comptes de classe 4 sont classés à l'actif ou au passif du bilan en fonction de leur solde. Pour prendre en compte cette spécificité, un champ *Négatif dans le bilan* permet de sélectionner si le compte sera présenté avec un solde négatif ou avec un solde positif dans une catégorie miroir du bilan. Ex. Un compte de classe 4 classé au Passif dans une sous-catégorie *Dettes* peut avoir comme catégorie miroir une sous-catégorie de *Créances* à l'Actif.
::

### Numéros de comptes

Chaque compte est composé d'un libellé et d'un numéro. Vos comptes parents (ou groupes) peuvent également être associés à un numéro de compte, mais vous pouvez utiliser ce champ pour trier vos comptes par ordre alphabétique dans l'arbre du plan comptable. Dans ce cas, cochez la case *Ne pas afficher le numéro de compte dans les rapports* pour que ce numéro n'apparaisse pas dans vos états financiers. Il est utile de trier correctement les comptes du plan comptable, car sa structure est reprise lors de la génération du bilan. Vous pouvez ainsi adapter la structure de votre plan comptable pour structurer votre bilan.

## Créer et modifier des comptes

Lors de la création d'une société, un plan comptable est généré en fonction de l'option sélectionnée: soit un plan comptable standard, soit une copie du plan comptable d'une société existante.

### Outil d'import de plan comptable

Si vous n'avez encore enregistré aucune transaction, vous pouvez écraser ce plan comptable par défaut grâce à l'outil d'import de plan comptable. Cet outil vous permet de configurer votre plan comptable dans un tableur et de l'importer dans Dokos. Il est utilisable uniquement avant l'enregistrement de la première transaction comptable. Ensuite, vous devrez modifier votre plan comptable manuellement.

::tour{doctype="Chart of Accounts Importer"}
Voir l'**Outil d'import de plan comptable** dans la démo
::

### Créer un compte comptable

Pour créer un compte comptable, le plus simple est d'aller sur le plan comptable (Vue: Arbre associée au type de document Compte), de naviguer dans le plan comptable et de cliquer sur *Ajouter un enfant* dans le groupe de comptes concerné.

::callout{color="teal" icon="i-heroicons-light-bulb"}
Vous ne pouvez créer des comptes qu'à partir de comptes *Parents* (ou *Groupes*). Seuls les comptes *Enfants* (ou *Non groupes*) peuvent être utilisés dans les transactions.
::

![La navigation dans le plan comptable](https://doc.dokos.io/content/parametrage/plan-comptable/navigation_plan_comptable.gif)

## Type de compte

Le type de compte est facultatif et permet à Dokos de sélectionner/proposer uniquement certains comptes dans les transactions.

Les principaux types de comptes à connaître sont les suivants:

- Pour les comptes de produits (classe 7): **Compte de produits**
- Pour les comptes de charges (classe 6): **Compte de charges**
- Pour les comptes de TVA (445xxx): **Taxe**
- Pour les comptes bancaires (512xxx): **Banque**
- Pour les comptes de caisse (530xxx): **Espèces**
- Pour les comptes clients (411xxx): **Débiteur**
- Pour les comptes fournisseurs (401xxx): **Créditeurs**
- Pour les comptes temporaires (utilisés lors de la reprise d'un bilan par exemple) ou d'attente: **Temporaire**

## Catégories de comptes

Les **catégories de comptes** permettent de regrouper vos comptes selon une logique métier, indépendamment de leur numérotation. Elles sont utilisées notamment dans les modèles de rapports financiers pour organiser la présentation du bilan et du compte de résultat.

### Type racine d'une catégorie

Chaque catégorie de compte peut désormais être associée à un **type racine** (Actif, Passif, Capitaux propres, Produits ou Charges). Ce paramétrage présente deux avantages concrets :

- **Filtrage intelligent lors de la saisie** : lorsque vous renseignez la catégorie d'un compte, seules les catégories compatibles avec le type racine de ce compte sont proposées. Ainsi, si votre compte est de type *Actif*, vous ne verrez que les catégories définies pour les comptes d'actif — évitant les erreurs d'affectation.
- **Cohérence des rapports financiers** : en liant chaque catégorie à un type racine, les modèles de rapports peuvent regrouper et présenter les soldes dans la bonne section du bilan ou du compte de résultat.

**Exemple concret** : La catégorie *Immobilisations corporelles* est associée au type racine *Actif*. Lorsque le comptable de Maison Verte SARL crée un compte `215100 – Installations techniques`, Dokos lui propose uniquement les catégories d'actif, ce qui garantit une classification correcte dans le bilan.

::mermaid
flowchart LR
A\[Compte comptable
215100 – Installations techniques] -->|Type racine : Actif| B\[Filtrage automatique]
B --> C\[Catégories disponibles
type racine = Actif]
C --> D\[Immobilisations corporelles]
C --> E\[Autres immobilisations]

::

### Configurer le type racine d'une catégorie

Pour associer un type racine à une catégorie existante :

1. Allez dans **Comptabilité > Paramètres > Catégorie de compte**.
2. Ouvrez la catégorie souhaitée.
3. Dans le champ **Type racine**, sélectionnez la valeur correspondante : *Actif*, *Passif*, *Capitaux propres*, *Produits* ou *Charges*.
4. Enregistrez.

::callout{color="teal" icon="i-heroicons-light-bulb"}
Lors de la mise à jour de Dokos, un patch automatique est appliqué pour renseigner le type racine des catégories de comptes standard. Vérifiez les catégories personnalisées que vous avez créées afin de leur affecter le bon type racine.
::

## Devises

Par défaut, la devise de chaque nouveau compte est égale à la devise de la société (Ex. EUR). Cependant, si vous faites des transactions en devise étrangère, il faut créer des comptes de tiers pour chaque devise utilisée.

> Ex. Vous achetez des biens en USD auprès de fournisseurs américains, il vous faut un compte de tiers débiteur (411xxx) en USD.

::callout{color="teal" icon="i-heroicons-light-bulb"}
Si vous préférez comptabiliser vos transactions en devise étrangère sur votre compte de tiers en devise de la société, vous pouvez cocher l'option *Autoriser les factures multi-devises en contrepartie d'un seul compte de tiers* dans les **Paramètres de comptabilité**.
::


# Les articles

Il s'agit de la donnée de base centrale, utilisée pour la facturation client/fournisseur ou la production. Les articles sont des produits ou services pouvant avoir de multiples caractéristiques correspondant à leur nature ou à leur fonction: articles stockés ou non, articles d'acompte, article réservables, articles disponibles à la vente ou à l'achat, modèles et variantes, matières premières et produits finis, etc...

---

::tour{doctype="Item"}
Découvrir les **Articles** sur la démo
::

## Nomenclature des articles

Dans de nombreuses organisations, les articles sont codifiés. Cela permet notamment de les identifier de manière unique sans ambiguïté. Dans Dokos, vous pouvez associer chaque article à un code et leur donner un nom plus fonctionnel. *Ex. I00001 / Produit 1*

Vous pouvez également mettre un libellé dans le champ **code de l'article** et dans le **nom de l'article**. Dans ce cas l'article aura un code identique à son libellé.

Par défaut, le nom du document **Article** est créé sur la base du champ **Code de l'article**. Cela veut dire que votre article aura trois caractéristiques:

- Son code sera I00001
- Son nom/libellé sera Produit 1
- Le nom du document Article correspondant / son identifiant, sera I00001

👉 Vous pouvez changer la règle de nommage du document *Article* dans les **Paramètres des stocks**

::callout{color="teal" icon="i-heroicons-light-bulb"}
Dans Dokos, tous les documents sont associés à un identifiant unique, leur **nom**, qui peut être identique à la valeur de l'un des champs du document.

*Ex. Le nom du document Client est souvent égal à la valeur du champ Nom du client*

[Voir la documentation concernant le nommage des documents](https://doc.dokos.io/v5/dodock/fonctionnalites/nommage)
::

## Groupes d'articles

Les groupes d'articles permettent de catégoriser vos articles afin de faciliter l'analyse de vos données transactionnelles.

Ils ont également l'avantage de permettre la simplification du paramétrage des comptes comptable et de la TVA applicables à vos articles.

[Voir la section concernant la détermination comptable](https://doc.dokos.io/#la-d%C3%A9termination-comptable)

#### Propriété de l'article

- **Unité de mesure par défaut (UDM)** : Il s'agit de l'unité de mesure par défaut que vous utiliserez pour votre produit. Il peut s'agir : Kgs, Mètres, etc. Vous pouvez stocker toutes les UDM dont votre produit aura besoin sous Configurer > Données de base > **Unité de mesure**. Ceux-ci peuvent être présélectionnés lors du remplissage du nouvel élément en utilisant le signe% pour afficher une fenêtre contextuelle de la liste UdM. Visitez la page UDM pour plus de détails

#### Options lors de la création d'un élément

- **Désactivé** : Cochez si vous voulez désactivé l'article. Si vous désactivez un élément, il ne peut être sélectionné dans aucune transaction.
- **Stock d'ouverture** : Le stock d'ouverture correspond au stock que vous avez actuellement en entrepôt et qui est disponible.
- **Taux de valorisation** : Le taux de valorisation est un attribut permettant d'ajouter le coût supplémentaire du produit (Frais de livraison, frais de douane). Par exemple, un produit coûtant 10€ à l'unité, aura des frais de livraison de 1,50€ par unité. Il existe deux options pour maintenir la valorisation des actions. FIFO (premier entré - premier sorti) et moyenne mobile. Pour comprendre ce sujet en détail, veuillez visiter Évaluation des articles, FIFO et Moyenne mobile.
- **Est une immobilisation** : Cochez cette case si cet élément est un actif de la société. Consultez le module Actif pour en savoir plus.


  - **Créer automatiquement des actifs lors de l'achat** : si l'article est un actif de la société, cochez cette case si vous souhaitez créer automatiquement des actifs lors de l'achat de cet article via le cycle d'achat . Consultez la page des ressources pour en savoir plus.
  - **Catégorie d'actif** : Sélectionner la catégorie de l'actif.
- **Autoriser un article alternatif** : Parfois, lors de la production d'un produit fini, un matériau spécifique peut ne pas être disponible. Si vous cochez cette case, vous pouvez créer et sélectionner un article alternatif dans la liste Alternative d'article.
- **Inclure l'article dans la fabrication** : il s'agit des articles de matières premières qui seront utilisés pour créer des produits finis. Si l'article est un service supplémentaire comme le «lavage» qui sera utilisé dans la nomenclature, ne cochez pas cette case.

## 3. Caractéristiques

### 3.1 Description

- **Marque** : si vous avez plusieurs marques, enregistrez-les sous Vente > **Marque** et présélectionnez-les lors du remplissage d'un nouvel article.
- **Description** : Description de l'article. Le texte du code d'article sera récupéré par défaut.

### 3.2 Codes-barres

Les codes-barres peuvent être enregistrés dans les articles pour les numériser rapidement et les ajouter dans les transactions. Dans le tableau Codes-barres, vous pouvez ajouter le code - barres d' un article pour la numérisation . Il existe deux types de codes-barres dans Dokos :

- **EAN** : Le numéro d'article européen est un numéro à 13 chiffres. EAN est utilisé internationalement et reconnu par plus de systèmes de point de vente.
- **UPC-A** : Le code de produit universel est un numéro à 12 chiffres. UPC-A est généralement utilisé uniquement aux États-Unis et au Canada.

### 3.3 Inventaire

- **Durée de conservation en jours** : Il s'agit d'un lot de produits . Le nombre de jours après lequel le lot de produits sera inutilisable. Par exemple, les médicaments.
- **Fin de vie** : Pour un seul article / produit, la date après laquelle il sera complètement inutilisable. Autrement dit, l'article sera inutilisable dans les transactions et la fabrication. Par exemple, vous utilisez des cristaux de plastique pour fabriquer des articles pour les 5 prochaines années, après quoi vous souhaitez utiliser des perles en plastique.
- **Garantie** : Pour suivre une période de garantie, il est nécessaire que l'article soit de série. Lors de la livraison de cet Article, la date de livraison et la période d'expiration sont enregistrées dans la fiche Numéro de série. Grâce au numéro de série maître, vous pouvez suivre l'état de la garantie.

Une période de garantie est une période pendant laquelle un produit acheté peut être retourné ou échangé.

- **Unité de Mesure (UDM) de poids** : Unité de mesure de l'article. Il peut s'agir Kilo, etc. L'Unité de mesure de poids que vous utilisez en interne peut être différente de l'UDM d'achat.
- **Poids par unité** : Le poids réel par unité de l'article. Ex: 1 kilo de biscuits ou 10 biscuits par paquet.
- **Type de demande de matériel par défaut** : Lorsque vous créez une nouvelle demande de matériel pour cet article, le champ défini ici sera sélectionné par défaut dans la nouvelle demande de matériel. Ceci est également connu sous le nom de «retrait».
- **Méthode de valorisation** : Sélectionnez la méthode de valorisation que ce soit FIFO ou Moyenne mobile. Lisez les méthodes d'évaluation des articles pour en savoir plus.

### 3.4 Réapprovisionnement automatique

Lorsque le stock d'un article plonge sous une certaine quantité, vous pouvez définir une réapprovisionnement automatique dans la section **Réapprovisionnement automatique**. Cela devrait être activé dans les paramètres de stock . Cela déclenchera une demande de matériel pour l'article. L'utilisateur avec les rôles Responsable des achats et Responsable des stocks sera informé de la création de la demande de matériel.

- **Enregsitrement (groupe)** : Dans quel groupe entrepôts vérifier la quantité de l'article.
- **Demander pour** : Quel entrepôt pour stocker l'article réapprovisionné.
- **Niveau de réapprovisionnement** : Lorsque cette quantité est atteinte, la commande est déclenchée. Le niveau de commande peut être déterminé en fonction du délai et de la consommation quotidienne moyenne. Par exemple, vous pouvez définir le niveau de commande de la carte mère à 10. Lorsqu'il ne reste que 10 cartes mères en stock, le système crée automatiquement une demande de matériel dans votre compte Dokos.
- **Quantité de réapprovisionnement** : Le nombre d'unités à réorganiser pour que la somme du coût de commande et du coût de détention soit à son minimum. La quantité de commande à nouveau est basée sur la «quantité de commande minimum» spécifiée par le fournisseur et de nombreux autres facteurs.

Par exemple, si le niveau de commande est de 100 articles, votre quantité de commande ne sera pas nécessairement de 100 articles mais de 200. La quantité de réapprovisionnement peut être supérieure ou égale au niveau de réapprovisionnement. Cela peut dépendre du délai de livraison, de la remise, du transport et de la consommation quotidienne moyenne.

**Type de demande de matériel** : Le type de demande de matériel avec lequel le stock sera réorganisé. Cela dépend si vous achetez l'article, que vous le fabriquez vous-même ou que vous le transférez entre les entrepôts.

### 3.5 Unité de mesure (UDM)

Vous pouvez ajouter d'autres Unité de mesure pour un élément. Si l'UDM par défaut dans laquelle vous vendez est des nombres mais que vous la recevez en kilos, vous pouvez définir une UDM supplémentaire avec un facteur de conversion approprié. Par exemple, 500 nombre d'unité = 1 kilogramme, sélectionnez donc Kilogramme / litre comme UDM et définissez le facteur de conversion sur 500. Pour en savoir plus sur la vente dans différentes UDM, visitez cette page.

### 3.6 N° de série et lots

#### 3.6.1 Numéro de série

Avec les numéros de série, vous pouvez suivre la garantie et les retours. Dans le cas où un article individuel est rappelé par le fournisseur, le système de numérotation aide à suivre l'article individuel. Le système de numérotation gère également les dates d'expiration.

Veuillez noter que si vous vendez vos articles par milliers, et si les articles sont très petits comme des stylos ou des gommes à effacer, vous n'avez pas besoin de les mettre série.

Dans Dokos, vous devrez mentionner le numéro de série dans certaines écritures comptables. Si votre produit n'est pas un gros article de consommation durable, s'il n'a pas de garantie et n'a aucune chance d'être rappelé, évitez de donner des numéros de série.

#### 3.6.2 Numéro de lots

Un ensemble d'articles peut être fabriqué par lots. Ceci est utile pour déplacer le lot et associer une date d'expiration à un certain lot.

- **A un numéro de lot** : Les options pour le numéro de lot, la date d'expiration et la conservation du stock d'échantillons seront révélées en cochant cette case. Vous ne pouvez pas l'activer s'il existe une transaction préexistante pour cet article. Si cela est désactivé, vous devrez entrer les numéros de série manuellement pour chaque transaction.
- **Série de numéros de lot** : Préfixe qui sera appliqué aux numéros de lot. Si vous définissez 1ABC, le premier lot sera nommé comme 1ABC00001 lors de la première transaction / fabrication.
- **Créer automatiquement un nouveau lot** : si le numéro de lot n'est pas mentionné dans les transactions, ils seront automatiquement créés selon un format tel que AAAA.00001. Si vous souhaitez toujours créer manuellement un numéro de lot pour cet article, laissez ce champ vide. Ce paramètre remplacera **Préfixe de la série de noms** dans les paramètres de stock. Les numéros de lot peuvent être définis pour être générés automatiquement si vous fabriquez les articles ou peuvent être saisis manuellement s'ils proviennent d'un fabricant externe.
- **A une date d'expiration** : Si vous cochez cette case, le numéro de lot sera créé en fonction de la date d'expiration. Les dates d'expiration peuvent être définies dans le **Lot** maître.
- **Conserver l'échantillon** : Pour conserver un nombre minimum d'échantillons de stock de l'article. Pour cela, vous devez définir un entrepôt de conservation d'échantillons dans les paramètres de stock. Pour en savoir plus, cliquez ici.
- **A un numéro de série** : Ceci est similaire à la série de numéros de lot, il sera créé lorsque vous effectuez des transactions / fabrication. Si vous définissez Série de numéros de série sur AA, lors de la première transaction, un numéro de série tel que AA00001 sera créé.

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
**Conseil** : Lors de la saisie d'un code article dans une table Articles, si la table nécessite des détails d'inventaire, vous pouvez saisir immédiatement les numéros de série ou de lot dans une boîte de dialogue contextuelle, selon que l'article saisi est groupé ou sérialisé.
::

### 3.7 Variante

Une variante d'article est une version différente d'un article. Pour en savoir plus sur la gestion des variantes, consultez Variantes d'article.

### 3.8 Valeurs par défaut pour les ventes, les achats et la comptabilité

Dans cette section, vous pouvez définir les valeurs par défaut liées aux transactions à l'échelle de l'entreprise pour cet article.

- **Société** : Nom de la société qui est concerné par cet article.
- **Entrepôt par défaut** : C'est l'entrepôt qui est automatiquement sélectionné dans vos transactions avec cet article.
- **Liste de prix par défaut** : qu'il s'agisse de vente standard ou d'achat standard. De même, vous pouvez également définir les comptes par défaut d'achat et de vente
- **Fournisseur** : Si un fournisseur par défaut est défini, ce fournisseur sera sélectionné pour les nouvelles transactions d'achat.
- **Compte de dépenses par défaut** : C'est le compte dans lequel le coût de l'article sera débité.
- **Compte de revenus par défaut** : C'est le compte dans lequel les revenus de la vente de l'article seront crédités.
- **Centre de coûts par défaut** : il est utilisé pour suivre les dépenses de cet article.

### 3.9 Comparaison des valeurs par défaut des articles

La grille des valeurs par défaut des articles permet désormais une **comparaison côte à côte** des paramètres appliqués à différents groupes d'articles. Cette fonctionnalité est particulièrement utile pour les organisations gérant plusieurs groupes d'articles avec des configurations similaires, comme des franchises ou des filiales.

#### Accéder à la vue de comparaison

1. Allez dans **Stock > Configuration > Groupe d'articles**
2. Sélectionnez un groupe d'articles dans la liste
3. Dans la section **Valeurs par défaut des articles**, cliquez sur le bouton **Comparer** situé en haut à droite de la grille

::mermaid
flowchart TD
A\[Ouvrir un groupe d'articles] --> B\[Aller dans la section Valeurs par défaut]
B --> C\[Cliquer sur le bouton Comparer]
C --> D\[Sélectionner les groupes à comparer]
D --> E\[Valider la sélection]

::

#### Fonctionnalités de la vue de comparaison

- **Sélection multiple** : Vous pouvez sélectionner jusqu'à 4 groupes d'articles à comparer simultanément
- **Alignement des colonnes** : Les paramètres des différents groupes sont alignés côte à côte pour une comparaison visuelle immédiate
- **Mise en évidence des différences** : Les valeurs différentes entre les groupes sont surlignées pour faciliter l'identification des écarts
- **Navigation simplifiée** : Un en-tête fixe permet de toujours identifier à quel groupe appartient chaque colonne

#### Exemple d'utilisation

> **Scénario — Maison Verte SARL**
> La société gère trois franchises : Paris, Lyon et Bordeaux. Chaque franchise a des paramètres légèrement différents pour ses groupes d'articles (entrepôts par défaut, comptes comptables, etc.).
>
> Avec la vue de comparaison, le responsable des stocks peut:
>
> 1. Sélectionner le groupe d'articles "Fournitures de bureau"
> 2. Comparer les valeurs par défaut entre les trois franchises
> 3. Identifier rapidement que l'entrepôt par défaut pour Bordeaux est incorrect
> 4. Corriger directement depuis la vue de comparaison

#### Bonnes pratiques

- Utilisez cette fonctionnalité pour **standardiser les configurations** entre différents groupes d'articles
- Vérifiez régulièrement les écarts entre groupes pour **maintenir la cohérence** des paramètres
- Lors de la création d'un nouveau groupe d'articles, comparez-le avec un groupe existant pour **assurer la conformité** des paramètres

::callout{color="blue" icon="i-heroicons-information-circle"}
La vue de comparaison est disponible pour tous les champs des valeurs par défaut des articles, y compris les paramètres comptables, les entrepôts, les listes de prix et les fournisseurs.
::

### 3.10 Détails d'achat et de réapprovisionnement

- **Unité de mesure d'achat par défaut à l'achat** : UDM par défaut qui sera utilisée dans les transactions d'achat.
- **Quantité minimum de commande** : La quantité minimum requise pour les transactions d'achat telles que les bons de commande. S'il est défini, le système ne vous permettra pas de procéder à la transaction d'achat si la quantité d'article dans la transaction d'achat est inférieure à la quantité définie dans ce champ.
- **Stock de sécurité** : Le Stock de sécurité est utilisé dans le rapport Niveau de commande recommandé par article. Sur la base du stock de sécurité, de la consommation quotidienne moyenne et du délai de livraison, le système suggère le niveau de réapprovisionnement d'un article.

Niveau de commande = Stock de sécurité + (Consommation quotidienne moyenne \* Délai d'exécution)

- **Dernier taux d'achat** : Le taux auquel vous avez acheté cet article pour la dernière fois à l'aide d'une facture d'achat sera affiché ici.
- **Est un article d'achat** : si cette option n'est pas cochée, vous ne pourrez pas utiliser cet article dans les transactions d'achat.
- **Article fourni par le client** : coché si l'article est fourni par un client et reçu via Saisie de stock> Réception d'articles . Si coché, le champ Client est obligatoire en tant que client par défaut pour la demande d'article . Pour en savoir plus, visitez cette page .
- **Jours de délai de livraison** : Les jours de délai de livraison sont le nombre de jours entre la commande de l'article et son arrivée à l'entrepôt.

### 3.11 Détails du fournisseurs

- **Livré par le fournisseur (livraison directe)** : Si l'article est livré directement par le fournisseur au client, cochez cette case. En savoir plus ici.
- **Codes fournisseur** : Suivez le code article défini par les fournisseurs pour cet article. Dans les transactions d'achat, lors de la sélection d'un article, un numéro de pièce fournisseur sera également récupéré pour référence du fournisseur. Vous pouvez en savoir plus ici.

### 3.12 Détails du commerce extérieur

Si vous achetez l'article dans un autre pays, vous pouvez définir les détails ici.

- **Pays d'origine** : Le pays d'où vous achetez l'article.
- **Numéro du tarif douanier** : Vous pouvez créer un numéro de tarif douanier avec une description et l'utiliser comme référence ici pour le partager avec les agences douanières. Plus tard, il peut être utilisé pour ajouter des bons de livraison.

### 3.13 Détails de ventes

- **Unité de mesure de vente par défaut à la vente** : UDM par défaut qui sera récupérée pour les transactions de vente.
- **Créer un abonnement basé sur :** Vous pouvez choisir un modèle d'abonnement pour l'article créé.
- **Remise maximale (%)** : Vous pouvez définir la remise maximale en % à appliquer à un article. Ex: si vous définissez 20%, vous ne pouvez pas vendre cet article avec une remise supérieure à 20%.
- **Est un article de vente** : Si cette option n'est pas cochée, vous ne pourrez pas utiliser cet article dans les transactions de vente.

### 3.14 Produits comptabilisés d'avance et Frais différés

Vous pouvez activer les revenus ou les dépenses différés à partir de l'élément. Une fois que vous cochez la case, vous verrez des options pour définir le compte de dépenses différées et le nombre de mois pendant lesquels les revenus / dépenses sont différés.

Par exemple, pensez à un abonnement annuel à une salle de sport, vous payez l'argent d'avance en une fois, mais le service est offert tout au long de l'année. Pour le propriétaire de la salle de sport, il s'agit d'un revenu différé et pour le client, il s'agit d'une dépense différée.

### 3.15 Détails du client

Le client peut identifier un article avec un code article différent. Ceci est similaire au code fournisseur .

- **Nom du client** : Sélectionnez un client ici.
- **Groupe de clients** : Il sera récupéré en fonction du client que vous avez sélectionné dans le champ précédent.
- **Code de référence** : un client peut identifier cet article avec un numéro différent. Vous pouvez suivre le code article attribué par le client pour cet article. Lorsque vous créez une commande client, le code de référence du client pour cet article s'affiche.

### 3.16 Taxe sur l'article

Ces paramètres ne sont requis que si un article particulier a un taux de taxe différent du taux défini dans le compte de taxe standard.

Vous devez créer un nouveau **modèle de taxe sur les articles** ou en choisir un existant. Par exemple, si vous avez un compte fiscal, TVA 20% et que cet article particulier est exonéré de taxe, vous sélectionnez TVA 20% dans la première colonne et définissez "0" comme taux de taxe dans la deuxième colonne. Visitez la page du modèle de taxe sur les articles pour plus de détails.

### 3.17 Critères d'inspection

**Modèle d'inspection qualité** : si un contrôle qualité est préparé pour cet article, ce modèle de critères sera automatiquement mis à jour dans le tableau Contrôle qualité du contrôle qualité. Des exemples de critères sont: le poids, la longueur, la finition, etc. **Inspection requise avant l'achat** : Si une inspection est obligatoire avant l'achat de l'article, c'est-à-dire avant de générer un reçu d'achat, cochez cette case. **Inspection requise avant la livraison** : Si une inspection est requise au moment de la livraison par votre fournisseur est obligatoire pour cet article, cochez cette case. Autrement dit, avant de générer un bon de livraison.

L'inspection de la qualité peut être effectuée avec Quick View et vous n'avez pas besoin d'aller sur une autre page pour mettre à jour l'inspection des détails dans Dokos.

### 3.18 Fabrication

**BOM Par défaut** : La valeur par défaut nomenclature utilisée pour la fabrication de cet article. **Fournir des matières premières pour l'achat** : Si vous sous-traitez à un fournisseur, vous pouvez choisir de leur fournir les matières premières pour fabriquer l'article en utilisant la nomenclature par défaut. Fabricant: sélectionnez le fabricant qui a fabriqué cet article. **Numéro de pièce du fabricant** : saisissez le numéro de pièce du fabricant que le fabricant a attribué à cet article.

Les détails du fabricant s'affichent une fois que vous avez créé un «Fabricant d'article» à partir du tableau de bord et sélectionné cet enregistrement par défaut. Ici, ajoutez des détails pour:

- Code de l'article
- Entrez le nom du fabricant
- Entrez le numéro de pièce que le fabricant utilise pour identifier cet article
- Sélectionnez Est par défaut pour afficher le fabricant et le numéro de pièce dans l'enregistrement d'article

### 3.19 Site web

Afin de mettre en évidence vos articles et/ou de les vendre sur votre site web, vous pouvez créer un **Article du site web**.

## La détermination comptable

🚧 Rédaction en cours 🚧

## Activer les réservations d'articles

Certains articles peuvent êtres associés à des réservations de créneaux horaires. C'est le cas des salles de réunion, des bureaux, des espaces de coworking ou bien de machines mises à disposition d'utilisateurs.

Pour activer les réservations d'articles pour un article, il suffit de cocher la case **Autoriser les réservations d'article** (Voir section ci-dessus).

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Les articles associés à des réservations de créneaux horaires seront généralement des services. No cochez donc pas la case **Maintenir le stock**.
::

## Activer les réservations sur le site web

Il est également possible de laisser vos utilisateurs effectuer leurs réservations de créneaux directement sur votre site web.

Pour mettre en place cette fonctionnalité, dans la section **Site Web**, cochez la case **Afficher sur le site web**.

Une fois activée, vos utilisateurs de site web auront le choix entre acheter des unités ou sélectionner un créneau::br![item\_website\_options.png](https://doc.dokos.io/content/lieu/item-booking/item_website_options.png)

- Vous pouvez cocher la case **Désactiver l'achat d'unités** pour ne permettre que la réservation de créneaux.

> L'achat d'unités permet à votre utilisateur d'acheter X unités de votre service, sans spécifier les horaires auxquelles auront lieu ce service. Pour un fonctionnement similaire avec gestion de crédits, voir les [crédits de réservation](https://doc.dokos.io/v5/dokos/lieu/credit-reservation).

- **Réservations simultanées autorisées**: Définissez le nombre de réservations simultanées autorisées > Pour que cette option apparaisse, il faut l'activer dans les [Paramètres du lieu](https://doc.dokos.io/v5/dokos/lieu/parametres-lieu)

Si vous souhaitez autoriser la réservation avec différentes unités de mesure (jour, heure,...) ajoutez les dans le tableau des unités de mesure.

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Les facteurs de conversion utilisés par le système de réservation sont ceux définis dans les [Facteurs de conversion](https://doc.dokos.io/v5/dokos/lieu/reservations-articles#les-facteurs-de-conversion). Les facteurs de conversion définis dans la fiche article servent uniquement à la conversion des [prix de l'article](https://doc.dokos.io/v5/dokos/parametrage/prix) pour la facturation.
::

## Filtrage des unités de mesure par article :badge{text="Dokos" type="warning"}

Dans les transactions Dokos, le champ **Unité de mesure** ne propose que les UDM définies sur la fiche de l'article sélectionné. Seules les unités listées dans le tableau **UDM de l'article** (section Unité de mesure) sont affichées dans la liste déroulante.

> **Exemple — Maison Verte SARL**
> L'article "Carton de papier" a deux UDM définies : Unité et Carton. Lors de la saisie d'un devis, seules ces deux options apparaissent dans le champ UDM — évitant toute erreur de saisie d'une unité non applicable à cet article.

Cette restriction prévient les erreurs de facturation ou de stock causées par l'utilisation d'une unité inadaptée à l'article.


# Les prix

### 1. Liste de prix

::tour{doctype="Price List"}
Découvrir les listes de prix sur la démo
::

Une liste de prix est un catalogue qui contient les prix de vente ou d'achat des produits ou services de votre entreprise.

Dokos vous permet de gérer plusieurs prix de vente ou d'achat pour chacun de vos articles et unités de mesure.

Vous pouvez créer autant de listes de prix que nécessaire pour toutes vos catégories de clients/fournisseurs.

### 1.1. Caractéristiques

::callout
Par défaut, Dokos propose deux listes de prix : "Achat Standard" et "Vente Standard", toutes deux en hors taxe. Lorsque vous définissez une liste de prix en TTC, il est nécessaire d'indiquer les prix TTC manuellement, car le système ne calcule pas automatiquement la TVA.
::

**Personnalisation :**

- Vous pouvez créer plusieurs listes de prix en fonction de différents critères. Par exemple, une liste pour les clients de particuliers et une autre pour les collectivités.
- Chaque liste de prix peut être associée à une devise différente, ce qui est utile pour les entreprises opérant à l'international.

**Types de liste de prix :**

- Prix de vente : Utilisé pour définir les prix auxquels les produits seront vendus aux clients.
- Prix d'achat : Utilisé pour définir les prix auxquels les produits seront achetés aux fournisseurs.

**Mises à jour en masse :**

- Lorsqu'un prix n'est plus valable, il est recommandé d'ouvrir le document correspondant et de mettre une date de fin de validité.
  Ensuite, dupliquez ce document et modifiez simplement le prix et les dates de début et de fin de validité applicables au nouveau prix.

Vous pouvez laissez la date de fin de validité vide si vous ne la connaissez pas encore.

- L'outil **import de données** permet de mettre à jour les prix en masse pour faciliter la gestion des modifications tarifaires.

::callout
Pour une gestion efficace et correcte, il est important de définir des périodes de validité pour vos prix. Cela vous permet de mettre à jour vos tarifs régulièrement et de vous adapter aux fluctuations du marché.
::

![Image permettant de visualiser le bouton ... puis import.](https://doc.dokos.io/Import-liste-de-prix.png)

- Mettre à jour les données existantes vous permettra de modifier en masse les dates de validité dans votre tableau Excel ou Google Sheets.
- Insérer de nouvelles données vous permettra de d'importer des prix d'articles en masse.

![Image permettant de visualiser le champ : Type d'import.](https://doc.dokos.io/import-liste-de-prix.png)**Les prix d'article**

- Prix d'achat :

Le prix d'achat d'un article inclut non seulement le coût de l'article lui-même, mais également les frais supplémentaires associés à son acquisition, tels que les frais de transport, les taxes d'importation, etc. Cette approche permet d'avoir une vue complète du coût réel d'un article dès son acquisition permettant de calculer la marge brute plus juste.

![Cette image permet de visualiser les frais supplémentaires dans un article.](https://doc.dokos.io/prix-de-l-article-frais-supplementaires.png)

**Les prix sur le site e-commerce**

Si vous décidez de vendre vos articles avec la TVA incluse sur le site e-commerce, assurez-vous de mettre en place une liste de prix incluant toutes les taxes. Exemple : Sur l'image ci-dessous, nous avons créé une liste : vente particuliers, dont les prix sont en TTC. Ensuite, vous devez vous rendre dans les paramètres e-commerce pour définir la liste de prix qui sera affichée sur le site internet.

![Cette image permet de visualiser la liste de prix TTC.](https://doc.dokos.io/liste-de-prix-particuliers.png)![Image permettant de visualiser les paramètres e-commence pour définir les prix en TTC ou HT](https://doc.dokos.io/prix-parametres-site-web.png)![Image permettant de visualiser les paramètres e-commence pour définir la site des prix pour le panier](https://doc.dokos.io/parametre-prix-site-web.png)

### Règles de prix

::tour{doctype="pricing-rule"}
Découvrir les règle de prix sur la démo
::

> Pour en savoir plus, rendez-vous sur la page [**Règles de prix**](https://doc.dokos.io/v5/dokos/stocks/regles-de-prix) de la documentation.

Les règles de prix sont utilisées pour appliquer des modifications automatiques aux prix des articles en fonction de critères prédéfinis. Elles permettent de gérer des promotions, des remises, ou des majorations.

**Critères :**

Les règles de prix peuvent être définies en fonction de plusieurs critères, tels que :

- Le groupe de clients
- Le type de client
- Le groupe d'articles
- Le type d'article
- La quantité commandée
- La période (dates de début et de fin de la règle)

![Cette image permet de visualiser le formulaire : règle de prix .](https://doc.dokos.io/regle-de-prix.png)![Cette image permet de visualiser des options pour les règles de prix.](https://doc.dokos.io/regledeprixconditionsmixtes.png)

1. **Conditions mixtes**Lorsque cette option est cochée, les conditions définies seront appliquées ensemble pour tous les éléments sélectionnés. Par exemple, si vous avez plusieurs critères de prix ou de remise, ils seront tous pris en compte de manière combinée.\* **Explication** : Pour que votre règle de prix s'applique même en présence de plusieurs lignes de commande, comme lors d'un paiement en ligne, vous devez cocher cette case.
2. **Est cumulatif**Lorsque cette option est cochée, la règle de prix peut être cumulée avec d'autres règles de prix.\* **Explication** : Si cette option est activée, la remise peut être ajoutée à d'autres remises, augmentant ainsi la réduction totale.
3. **Sur la base d'un code promotionnel**Cette option permet de définir que la règle de prix s'applique uniquement si un certain code promotionnel est utilisé.\* **Explication** : Par exemple, si vous avez une règle de prix qui donne 10 % de réduction, cette réduction ne sera appliquée que si le client saisit le code promotionnel spécifique lors de l'achat.

## Détermination des prix

Les listes de prix peuvent être associées aux clients/fournisseurs ou aux groupes de clients/fournisseurs.

Cela permet au logiciel de sélectionner automatiquement la bonne liste de prix à appliquer dans une transaction.

Une liste de prix par défaut peut être paramétrée dans les paramètres des ventes/paramètres des achats. Elle sera sélectionnée dans les transactions si aucune liste de prix n'est configurée au niveau des clients/fournisseurs/groupes de clients/groupes de fournisseurs.

**Récupération de la liste de prix pour un client**:
:mermaid[flowchart LR
id1(Client)-->id2(Groupe de clients)
id2-->id3(Paramètres des ventes)]

**Récupération de la liste de prix pour un fournisseur**:
:mermaid[flowchart LR
id1(Fournisseur)-->id2(Groupe de fournisseurs)
id2-->id3(Paramètres des achats)]

## Prix de l'article

::tour{doctype="item-price"}
Découvrir les prix d'article sur la démo
::

Le prix de l'article est le document servant à enregistrer un prix associé à un article.

Pour rappel, un article peut être un bien ou un service.

Ces prix peuvent n'être applicables qu'en fonction de certains critères, comme par exemple, pour une unité de mesure donnée.

> Nous vendons des chaises à l'unité et en lots de 4 à des particuliers et à des magasins.
>
> Nous aurons donc 4 prix:
>
> - 2 pour la liste de prix **Client particulier**
> - 2 pour la liste de prix **Revendeurs**
>
> Pour chacune de ces listes de prix, nous aurons un prix pour l'unité de mesure **Unité** et un prix pour l'unité de mesure **Lot de 4**

::tour{doctype="Item Price"}
Découvrir les prix des articles sur la démo
::

## Caractéristiques

### Liste de prix

La liste de prix associée à un prix permet de déterminer si ce prix est valable à la vente ou à l'achat.
Si le prix est applicable à la vente, il sera possible de limiter son application à un seul client.
Si le prix est applicable à l'achat, il sera possible de limiter son application à un seul fournisseur.

La liste de prix permet aussi de déterminer la devise applicable pour ce prix.

### Client / Fournisseur

Si le prix est applicable à un seul client (ventes) ou fournisseur (achats), vous pouvez le sélectionner.

Cela permet de limiter le nombre de listes de prix et de gérer uniquement les exceptions dans vos listes de prix.

Si le client/fournisseur a des prix spécifiques pour de nombreux articles, il peut-être plus pertinent d'avoir des listes de prix différentes.

### N° du lot

Vous pouvez définir un numéro de lot pour lequel ce prix est applicable.

### Prix unitaire

Le prix unitaire est le prix applicable à votre article en fonction des conditions que vous avez définies dans ce document.

## Prix préférentiel selon l'unité de mesure du document :badge{text="Dokos" type="warning"}

Lorsque plusieurs prix existent pour un même article dans la même liste de prix, Dokos **privilégie le prix dont l'unité de mesure correspond à celle du document en cours**. Si aucun prix UOM-spécifique n'est trouvé, le système utilise le prix générique.

> **Exemple — Maison Verte SARL**
> L'article "Carton de papier" a deux prix dans la liste "Vente Standard" : 4,50 € à l'unité et 40 € au carton. Lorsqu'une commande utilise l'unité de mesure "Carton", le prix de 40 € est automatiquement sélectionné.

## Consulter les prix depuis la fiche article

Depuis la fiche d'un article enregistré, l'onglet **Tarification** vous permet de visualiser directement tous les prix actifs sans quitter le formulaire. Jusqu'à 10 prix sont affichés ; un bouton **Voir tous les prix*&#x2A; apparaît au-delà. Vous pouvez également créer un nouveau prix via le bouton **+ Ajouter un prix**, prérempli avec le code article.

Pour en savoir plus, consultez la section [Onglet Tarification](https://doc.dokos.io/v5/dokos/stocks/item-info#onglet-tarification) de la documentation des articles.

## Tableau de bord des prix sur les fiches article et tiers :badge{text="Dokos" type="warning"}

Les fiches **Article**, **Client** et **Fournisseur** affichent un **panneau de bord des prix** centralisant tous les tarifs associés à cet élément. Ce tableau de bord permet de consulter, comparer et gérer l'ensemble des prix sans naviguer entre les enregistrements individuels.

- Sur la fiche **Article** : tous les prix définis dans toutes les listes de prix
- Sur la fiche **Client** : tous les prix spécifiques à ce client et les listes de prix qui lui sont attribuées
- Sur la fiche **Fournisseur** : tous les prix d'achat associés à ce fournisseur

::demo-link{demo="Dokompany" doctype="Item Price"}
Voir les prix des articles dans la démo
::

## Voir aussi

- [Articles](https://doc.dokos.io/v5/dokos/parametrage/articles)
- [Articles autorisés par partie](https://doc.dokos.io/v5/dokos/parametrage/articles-par-partie)
- [Règles de prix](https://doc.dokos.io/v5/dokos/stocks/regles-de-prix)

## Prix d'achat sans restriction de société :badge{text="Dokos" type="warning"}

Dans ERPNext, un prix d'achat peut être restreint à une société spécifique via le champ **Société**. Dans Dokos, ce champ est automatiquement vidé pour les prix d'achat : un prix marqué comme "Achat" s'applique à toutes les sociétés de l'instance, sans restriction.

Cette logique simplifie la gestion dans les environnements multi-sociétés : un seul prix d'achat suffit pour couvrir l'ensemble des entités, sans avoir à dupliquer les enregistrements.

> **Exemple — Dokompany**
> Bureau Moderne fournit des roulements à 2,50 € l'unité. Ce prix est saisi une seule fois dans la liste "Achat Standard". Dokompany France et Dokompany Belgique utilisent toutes les deux ce prix sans configuration supplémentaire.


# Les clients

## 1. Création d'un client

Un client, est une personne, une entreprise ou une organisation qui achète des biens ou des services fournis par votre entreprise.

Dokos permet la gestion des clients (c’est-à-dire les personnes morales) et la gestion des contacts (c’est-à-dire les personnes physiques). Il est possible d’avoir un client de type « entreprise » avec plusieurs contacts associés (les responsables des achats, les contacts pour la facturation, etc).

**Un client est une donnée de base ne nécessitant aucun prérequis.** Cependant, il est possible de créer un client à partir d'une piste ou d'une opportunité existant dans Dokos, transformant ces pistes et opportunités en clients officiels, facilitant ainsi la transition de prospects à clients réels.

- Piste: Une piste est une entrée initiale dans le processus de vente, représentant un potentiel client qui a montré un certain intérêt pour vos produits ou services mais qui n'a pas encore engagé de transaction.
- Opportunité : Une opportunité est une étape avancée dans le processus de vente où la piste a exprimé un intérêt plus concret, et il y a des discussions plus détaillées sur une éventuelle transaction.

::tour{doctype="Customer"}
Découvrir comment créer un client sur la démo
::

::callout{icon="i-heroicons-light-bulb"}
Laissez-vous guider par le parcours du document pour créer votre client sans difficulté.
::

### Paramétrage

Afin de faciliter la création de vos clients, il est possible de définir certaines informations par défaut dans les **paramètres de vente**.

1. **Système de nommage**: Chaque client possède un identifiant unique, qui est le nom du document dans lequel sont renseignés les informations du client. Cet identifiant du client peut être basé sur le nom complet du client ou sur un numéro de série.
   :br
   Si vous choisissez de le baser sur le nom complet du client, en cas d'homonymes, Dokos rajoutera automatiquement un "-1" à la fin du nom pour les différencier.
   :br
   Si vous choisissez de le baser sur une série, vous pouvez définir le préfixe de cette série dans le type de document **Paramètres de nommage des documents**.

::callout
L'identifiant du client sert également de numéro de tiers de facturation.\:brSi vous prévoyez d'échanger des fichiers avec votre comptable/expert comptable, il faut probablement utiliser la même nomenclature que dans son logiciel de comptabilité.
::

2. **Groupe de client**: Définissez le groupe de client par défaut. Il s'agit généralement du groupe de client le plus souvent sélectionné.
3. **Région par défaut**: Définissez la région qui sera sélectionnée par défaut dans le client.

### Fonctionnalités

Les informations renseignées dans la fiche client servent ensuite de valeurs par défaut dans les transactions. Par exemple, si vous mettez la langue d'impression "fr" dans la fiche du client, les documents générés pour ce client (devis, factures, ...) seront imprimés par défaut en français. Vous pouvez toujours modifier cette valeur dans le document correspondant au moment de sa création.

#### Devise et liste de prix

- **Devise de facturation**: La devise de votre client peut être différente de la devise de votre société. Ce champ est à remplir si vous souhaitez facturer votre client en USD alors que votre société facture habituellement en EUR.

::callout
Si vous prévoyez de facturer en devise étrangère, pensez également à créer un compte comptable en devise étrangère pour enregistrer correctement les transactions comptables correspondantes.\:brSi vous préférez enregistrer les écritures comptables sur le compte de tiers par défaut (devise société) cochez la case *Autoriser les factures multi-devises en contrepartie d'un seul compte de tiers* dans les paramètres de comptabilité.
::

- **Liste de prix par défaut**: Sélectionnez une liste de prix applicable à ce client s'il ne s'agit pas de la liste de prix par défaut ou de celle associée à son groupe de clients. ➡️ [Voir la documentation concernant les listes de prix](https://doc.dokos.io/v5/dokos/parametrage/prix)

#### Comptabilité

Cette fonctionnalité vous permet notamment de définir un compte comptable spécifique à chaque client, si vous ne souhaitez pas utiliser le système de comptes auxiliaires proposé par défaut dans Dokos.

Comme cette fonctionnalité est compatible avec le mode multi-société, vous pouvez renseigner un compte par société.

#### Limite de crédit et conditions de paiement

- **Modèle de termes de paiement par défaut**: si un modèle de conditions de paiement est défini ici, il sera automatiquement sélectionné dans transactions de vente.

::callout
Vous pouvez également définir des termes de paiement par défaut au niveau des groupes de clients ou au niveau de la société.\:brDans les paramètres de comptabilité, vous pouvez également définir un délai de paiement par défaut pour les factures. Cette option évite d'avoir à créer des termes de paiement.
::

- **Limite de crédit**: Permet de définir une limite de crédit par société.

#### Informations additionnelles

- **Langue d’impression**: Permet d'imprimer les devis/factures/etc. automatiquement dans la langue du client.
- **Est gelé**: Toute nouvelle écriture comptable associée à ce client est interdite. Seuls les utilisateurs ayant le rôle attribué dans le champ *Rôle autorisé à geler des comptes et à modifier des écritures gelées* des paramètres des comptes sont autorisé à valider des écritures associée à ce client.
- **Programme de fidélité**: Permet d'associer un client à un programme de fidélité.
- **Partenaire de vente**: Permet de lier un client à un partenaire commercial avec un pourcentage de commission associé.
  :br
  Les partenaires de vente sont généralement en dehors de la société.
- **Équipe des Ventes**: Permet de lier un client à un vendeur associé à un pourcentage de commission.
  :br
  Les vendeurs sont généralement internes à la société.

## 2. Recherche et sélection d'un client par alias :badge{text="Dokos" type="warning"}

Pour faciliter la recherche et la sélection de vos clients, Dokos propose désormais un champ **Alias** dans la fiche client. Cet alias agit comme un identifiant alternatif unique, permettant de retrouver rapidement un client même si son nom officiel a changé ou s'il est connu sous un nom différent en interne.

### Utilisation de l'alias

1. **Saisie de l'alias** :

   - Dans la fiche client, renseignez un alias dans le champ dédié (ex: "MV" pour "Maison Verte SARL").
   - Ce champ est unique : deux clients ne peuvent pas partager le même alias.
   - Si vous laissez le champ vide, aucun alias ne sera enregistré pour ce client.
2. **Recherche par alias** :

   - Dans tout champ de type **Lien** pointant vers un client (ex: champ "Client" dans une facture), commencez à taper l'alias du client.
   - Dokos affichera automatiquement les clients dont l'alias correspond à votre saisie.
   - Exemple : en tapant "MV", Dokos proposera "Maison Verte SARL" dans la liste de sélection.
3. **Recherche globale** :

   - L'alias est également intégré à la **recherche globale** de Dokos.
   - En tapant l'alias dans la barre de recherche en haut de l'écran, vous accéderez directement à la fiche du client correspondant.

::callout{icon="i-heroicons-light-bulb"}
L'alias est particulièrement utile pour les clients ayant des noms longs ou complexes, ou pour les clients connus sous un nom commercial différent de leur raison sociale.
::

### Bonnes pratiques

- **Choix de l'alias** : Privilégiez des alias courts et mémorables (ex: initiales, acronymes).
- **Unicité** : Assurez-vous que l'alias est unique pour éviter les conflits lors de la recherche.
- **Mise à jour** : Si un client change de nom mais conserve le même alias, vous n'aurez pas besoin de mettre à jour toutes les transactions le concernant.

## 3. Groupes de clients

Le groupe de clients est une agrégation de clients possédant des caractéristiques communes.

Ils vous permettent d'organiser vos clients et de les associer dans le but de faciliter le paramétrage et l'analyse des transactions.\:brVous pouvez créer une hiérarchie de groupes de clients, composée de parent/noeuds et d'enfants/feuilles.

---

::tour{doctype="Customer Group"}
Découvrir les groupes de clients dans la démo
::

### Attribution automatique du groupe "Client AFPA" pour les utilisateurs du portail interne :badge{text="Dokos" type="warning"}

Dokos permet désormais d'affecter automatiquement le groupe **Client AFPA** aux clients créés pour les utilisateurs du portail interne. Cette fonctionnalité est particulièrement utile pour les organisations qui souhaitent distinguer les clients internes des clients externes.

#### Fonctionnement

1. **Activation** : Cette fonctionnalité est activée par défaut pour les instances configurées avec le module AFPA. Aucun paramétrage supplémentaire n'est nécessaire.
2. **Déclenchement** : Lorsqu'un utilisateur du portail interne est associé à un client (via la création ou la mise à jour d'un contact lié à ce client), Dokos vérifie si le groupe **Client AFPA** est déjà attribué.


   - Si ce n'est pas le cas, le groupe est automatiquement ajouté à la fiche client.
3. **Priorité** : Si un groupe de clients est déjà défini manuellement sur la fiche client, ce groupe reste prioritaire. Le groupe **Client AFPA** ne sera pas ajouté automatiquement.

#### Cas d'usage

> **Exemple — Maison Verte SARL**
> Un employé de Maison Verte SARL se connecte au portail interne pour passer une commande. Lors de la création de son compte utilisateur, un client associé est automatiquement créé dans Dokos. Le système attribue alors le groupe **Client AFPA** à ce client, permettant de le distinguer des clients externes pour des analyses ou des tarifications spécifiques.

#### Configuration avancée

Si vous souhaitez personnaliser le nom du groupe de clients attribué automatiquement, vous pouvez modifier la valeur par défaut dans les **paramètres du module AFPA** :

1. Allez dans **Paramètres > Modules > AFPA**.
2. Modifiez le champ **Groupe de clients pour les utilisateurs du portail interne** pour spécifier un autre groupe.

::callout{icon="i-heroicons-exclamation-triangle"}
Cette modification n'affectera que les nouveaux clients créés après la mise à jour du paramètre. Les clients existants ne seront pas mis à jour automatiquement.
::

### Attribuer une limite de crédit, une liste de prix par défaut et un modèle de conditions de paiement par défaut

Vous pouvez attribuer la limite de crédit, la liste de prix et les conditions de paiement et elles seront automatiquement appliquées lorsqu'un client appartenant au groupe de clients est sélectionné dans une transaction de vente.\:brSi vous avez effectué cette configuration au niveau du client, la configuration de la fiche client sera prioritaire.

## Territoires

Un territoire est une zone géographique utilisée pour catégoriser vos transactions.

---

::tour{doctype="Territory"}
Découvrir les territoires dans la démo
::

### Responsable régional

Vous pouvez affecter un responsable régional qui s'occupe des ventes de cette région.

### Objectifs de vente

Ici, vous pouvez définir des objectifs de vente spécifiques basés sur les champs suivants :

- Groupe d'articles
- Exercice fiscal
- Qté cible
- Montant cible
- Distribution cible

## Notes CRM et activités sur la fiche client :badge{text="Dokos" type="warning"}

La fiche client affiche directement deux sections complémentaires pour le suivi commercial :

- **Notes CRM** — notes libres liées au client (appels, réunions, remarques)
- **Activités** — liste des activités ouvertes et historique complet des interactions

Ces sections permettent aux équipes commerciales de consulter l'historique d'un client sans quitter la fiche, en évitant les allers-retours vers le module CRM.

## Tableau de bord des prix et articles autorisés :badge{text="Dokos" type="warning"}

La fiche client donne accès à deux panneaux de gestion tarifaire :

- **Tableau de bord des prix** — liste tous les prix d'articles associés à ce client (liste de prix dédiée ou tarifs individuels)
- **Gestionnaire d'articles par partie** — permet de restreindre les articles disponibles pour ce client dans les devis et commandes

Pour configurer des articles réservés à certains clients uniquement, consultez la page [Articles autorisés par client ou fournisseur](https://doc.dokos.io/v5/dokos/parametrage/articles-par-partie).

## Indicateurs du tableau de bord :badge{text="Dokos" type="warning"}

> **Exemple — Maison Verte SARL**
> En ouvrant la fiche de Maison Verte SARL, le commercial voit immédiatement dans le panneau de liens : 5 factures de vente — Total facturé 12 400,00 € — En attente 1 800,00 €. Il identifie en un coup d'œil qu'un solde reste à encaisser, sans avoir à ouvrir chaque facture.

Sur la fiche client, le panneau de documents liés affiche des indicateurs financiers calculés à la volée pour les deux groupes clés :

**Factures de vente**

- **Total facturé** : somme des montants nets de toutes les factures liées à ce client
- **En attente** : montant total des factures validées dont le solde restant est supérieur à zéro

**Règlements**

- **Total payé** : somme des montants encaissés sur les écritures de paiement liées
- **Non alloué** : montant des paiements reçus qui ne sont pas encore affectés à une facture

Ces indicateurs sont des repères rapides pour avoir une vue d'ensemble de la relation financière avec le client. Pour une analyse détaillée (par période, par article, par vendeur), utilisez les rapports dédiés dans le module **Ventes** ou **Comptabilité**.

::demo-link
---
demo: Dokompany
path: /desk/customer/Francis%20Charpentier#connections_tab
---
Voir les indicateurs sur une fiche client dans la démo
::

## Profil de rôle portail depuis le groupe de clients :badge{text="Dokos" type="warning"}

Lorsqu'un utilisateur est associé à un client (via son portail), Dokos lui attribue automatiquement le **profil de rôle** configuré sur la fiche client ou, à défaut, sur son groupe de clients. Ce profil détermine les accès disponibles sur le portail (consultation des commandes, des factures, suivi des réservations, etc.).

> **Exemple — Maison Verte SARL**
> Tous les clients du groupe "Entreprise" ont accès au portail avec le profil "Client B2B" — qui inclut la consultation des commandes et le téléchargement des factures. Lorsqu'un contact de Maison Verte se connecte au portail, ses accès sont automatiquement configurés selon ce profil, sans intervention manuelle.

La mise à jour des rôles se fait automatiquement en arrière-plan à chaque enregistrement de la fiche client, garantissant que les droits restent cohérents avec la configuration du groupe.


# Les fournisseurs

## Fournisseurs

Un fournisseur est une personne physique ou morale auprès de qui vous achetez des produits ou des services.

::tour{doctype="Supplier"}
Découvrir les fournisseurs sur la démo
::

### Paramétrage

Afin de faciliter la création de vos fournisseurs, il est possible de définir certaines informations par défaut dans les **paramètres d'achat**.

1. **Système de nommage**: Chaque fournisseur possède un identifiant unique, qui est le nom du document dans lequel sont renseignés les informations du fournisseur. Cet identifiant du fournisseur peut être basé sur le nom complet du fournisseur ou sur un numéro de série. :br
   Si vous choisissez de le baser sur le nom complet du fournisseur, en cas d'homonymes, Dokos rajoutera automatiquement un "-1" à la fin du nom pour les différencier. :br
   Si vous choisissez de le baser sur une série, vous pouvez définir le préfixe de cette série dans le type de document **Paramètres de nommage des documents**.

::callout
L'identifiant du fournisseur sert également de numéro de tiers de facturation. :br
Si vous prévoyez d'échanger des fichiers avec votre comptable/expert comptable, il faut probablement utiliser la même nomenclature que dans son logiciel de comptabilité.
::

2. **Groupe de fournisseurs par défaut**: Définissez le groupe de fournisseurs par défaut. Il s'agit généralement du groupe de fournisseurs le plus souvent sélectionné.
3. **Liste de prix d'achat par défaut**: Définissez la liste de prix qui sera sélectionnée par défaut dans lorsque vous créez un nouveau fournisseur.

### Fonctionnalités

Les informations renseignées dans la fiche fournisseur servent ensuite de valeurs par défaut dans les transactions.
Par exemple, si vous mettez "USD" comme devise de facturation dans la fiche du fournisseur, les documents générés pour ce fournisseur (commande, factures, ...) seront automatiquement en USD. Vous pouvez toujours modifier cette valeur dans le document correspondant au moment de sa création.

#### Autoriser la création d'une facture d'achat sans bon de commande ni reçu d'achat

Si l'option **Commande fournisseur requis** ou **Reçu d'achat requis** est configurée sur "Oui" dans les paramètres d'achat , elle peut être remplacée pour un fournisseur particulier en activant l'option **Autoriser la création de la facture d'achat sans commande fournisseur** ou **Autoriser la création de la facture d'achat sans reçu d'achat** dans la fiche fournisseur.

#### Devise et liste de prix

- **Devise de facturation** : la devise de facturation votre fournisseur peut être différente de la devise de votre entreprise. Ce champ est à remplir si vous souhaitez que le logiciel sélectionne automatiquement une devise étrangère lors de la création de vos transactions d'achat.

::callout
Si vous prévoyez de créer des factures d'achat en devise étrangère, pensez également à créer un compte comptable en devise étrangère pour enregistrer correctement les transactions comptables correspondantes. :br
Si vous préférez enregistrer les écritures comptables sur le compte de tiers par défaut (devise société) cochez la case *Autoriser les factures multi-devises en contrepartie d'un seul compte de tiers* dans les paramètres de comptabilité.
::

- **Liste de prix** : Sélectionnez une liste de prix applicable à ce fournisseur s'il ne s'agit pas de la liste de prix par défaut ou de celle associée à sont groupe de fournisseurs. ➡️ [Voir la documentation concernant les listes de prix](https://doc.dokos.io/v5/dokos/parametrage/prix)

#### Paiements et blocages

- **Modèles de termes de paiement par défaut**: si un modèle de conditions de paiement est défini ici, il sera automatiquement sélectionné dans les transactions d'achat.
- **Bloquer le fournisseur** : vous pouvez bloquer les factures et/ou les paiements d'un fournisseur jusqu'à une date précise. Lorsqu'un fournisseur est bloqué, son statut passera à *Bloqué*.

Les types de blocage sont les suivants :

- **Factures**: Dokos n'autorisera pas la création de factures d'achat ou de bons de commande pour le fournisseur
- **Paiements**: Dokos ne permettra pas la création d'écritures de paiement pour le fournisseur
- **Tous**: Dokos appliquera les deux types de blocage ci-dessus.

Si vous ne définissez pas de date de fin de blocage, Dokos bloquera le fournisseur indéfiniment.

#### Compte fournisseur par défaut

Cette fonctionnalité vous permet notamment de définir un compte comptable spécifique à chaque client, si vous ne souhaitez pas utiliser le système de comptes auxiliaires proposé par défaut dans Dokos.

Si vous souhaitez avoir un compte comptable par fournisseur, vous devez d'abord ajouter un compte fournisseur dans le **plan comptable**, puis sélectionner ce compte fournisseur dans la fiche fournisseur.

Comme cette fonctionnalité est compatible avec le mode multi-société, vous pouvez renseigner un compte par société.

::callout
Le compte fournisseur par défaut est défini dans la fiche de la société
::

## Recherche et sélection d'un fournisseur par alias :badge{text="Dokos" type="warning"}

Pour simplifier la recherche et la sélection de vos fournisseurs, Dokos propose désormais un champ **Alias** dans la fiche fournisseur. Cet alias agit comme un identifiant alternatif unique, vous permettant de retrouver rapidement un fournisseur même si son nom officiel a changé ou s'il est connu sous un nom différent en interne.

### Utilisation de l'alias

1. **Saisie de l'alias** :

   - Dans la fiche fournisseur, renseignez un alias dans le champ dédié (ex: "BM" pour "Bureau Moderne").
   - Ce champ est unique : deux fournisseurs ne peuvent pas partager le même alias.
   - Si vous laissez le champ vide, aucun alias ne sera enregistré pour ce fournisseur.
2. **Recherche par alias** :

   - Dans tout champ de type **Lien** pointant vers un fournisseur (ex: champ "Fournisseur" dans une commande d'achat), commencez à taper l'alias du fournisseur.
   - Dokos affichera automatiquement les fournisseurs dont l'alias correspond à votre saisie.
   - Exemple : en tapant "BM", Dokos proposera "Bureau Moderne" dans la liste de sélection.
3. **Recherche globale** :

   - L'alias est également intégré à la **recherche globale** de Dokos.
   - En tapant l'alias dans la barre de recherche en haut de l'écran, vous accéderez directement à la fiche du fournisseur correspondant.

::callout{icon="i-heroicons-light-bulb"}
L'alias est particulièrement utile pour les fournisseurs ayant des noms longs ou complexes, ou pour les fournisseurs connus sous un nom commercial différent de leur raison sociale.
::

### Bonnes pratiques

- **Choix de l'alias** : Privilégiez des alias courts et mémorables (ex: initiales, acronymes).
- **Unicité** : Assurez-vous que l'alias est unique pour éviter les conflits lors de la recherche.
- **Mise à jour** : Si un fournisseur change de nom mais conserve le même alias, vous n'aurez pas besoin de mettre à jour toutes les transactions le concernant.

## Groupes de fournisseurs

Les groupes de fournisseurs permettent de catégoriser les fournisseurs afin de:

- Créer des groupes homogènes auxquels s'appliqueront des règles communes (termes de paiement, comptabilité)
- Utiliser les groupes de fournisseur pour analyser les données d'achat

::tour{doctype="Supplier Group"}
Voir un groupe de fournisseurs sur la démo
::

## Notes CRM et activités sur la fiche fournisseur :badge{text="Dokos" type="warning"}

La fiche fournisseur affiche deux sections pour le suivi relationnel :

- **Notes CRM** — notes libres sur les échanges avec le fournisseur (négociations, relances, conditions commerciales)
- **Activités** — activités ouvertes et historique des interactions

Ces sections permettent aux équipes achats de centraliser le suivi sans quitter la fiche fournisseur.

## Tableau de bord des prix et articles autorisés :badge{text="Dokos" type="warning"}

La fiche fournisseur donne accès à deux panneaux :

- **Tableau de bord des prix** — liste tous les prix d'articles associés à ce fournisseur
- **Gestionnaire d'articles par partie** — restreint les articles disponibles pour ce fournisseur dans les commandes et factures d'achat

Pour configurer des articles réservés à certains fournisseurs, consultez la page [Articles autorisés par client ou fournisseur](https://doc.dokos.io/v5/dokos/parametrage/articles-par-partie).

## Indicateurs du tableau de bord :badge{text="Dokos" type="warning"}

> **Exemple — Bureau Moderne**
> L'équipe achats ouvre la fiche du fournisseur Bureau Moderne et aperçoit directement : 3 factures d'achat — Total facturé 8 200,00 € — En attente 2 100,00 €. Elle sait immédiatement qu'un règlement est à prévoir, sans parcourir chaque facture.

Sur la fiche fournisseur, le panneau de documents liés affiche des indicateurs financiers calculés à la volée pour les deux groupes clés :

**Factures d'achat**

- **Total facturé** : somme des montants nets de toutes les factures liées à ce fournisseur
- **En attente** : montant total des factures validées dont le solde restant est supérieur à zéro

**Règlements**

- **Total payé** : somme des montants réglés sur les écritures de paiement liées
- **Non alloué** : montant des paiements effectués qui ne sont pas encore affectés à une facture

Ces indicateurs sont des repères rapides pour avoir une vue d'ensemble de la relation financière avec le fournisseur. Pour une analyse détaillée (par période, par article, par acheteur), utilisez les rapports dédiés dans le module **Achats** ou **Comptabilité**.


# Démarrage

::card-group
  :::card
  ---
  title: Import de plan comptable
  to: https://doc.dokos.io/v5/dokos/parametrage/demarrage/plan-comptable
  ---
  Import de plan comptable
  :::

  :::card
  ---
  title: Taxes
  to: https://doc.dokos.io/v5/dokos/parametrage/demarrage/taxes
  ---
  Gestion des taxes
  :::

  :::card
  ---
  title: Société
  to: https://doc.dokos.io/v5/dokos/parametrage/demarrage/societe
  ---
  Configuration de la société
  :::

  :::card
  ---
  title: Nommage des documents
  to: https://doc.dokos.io/v5/dokos/parametrage/demarrage/masques-numerotation
  ---
  Options de nommage des documents
  :::

  :::card
  ---
  title: Import de données
  to: https://doc.dokos.io/v5/dokos/parametrage/demarrage/import-de-donnees
  ---
  Import de données
  :::

  :::card
  ---
  title: Export de données
  to: https://doc.dokos.io/v5/dokos/parametrage/demarrage/export-de-donnees
  ---
  Export de données
  :::

  :::card
  ---
  title: Paramètres système
  to: https://doc.dokos.io/v5/dokos/parametrage/demarrage/parametres-systeme
  ---
  Paramètres système
  :::

  :::card
  ---
  title: Valeurs globales
  to: https://doc.dokos.io/v5/dokos/parametrage/demarrage/valeurs-globales
  ---
  Valeurs globales
  :::

  :::card
  ---
  title: Termes et conditions
  to: https://doc.dokos.io/v5/dokos/parametrage/demarrage/termes-et-conditions
  ---
  Termes et conditions
  :::

  :::card
  ---
  title: Utilisateurs et autorisations
  to: https://doc.dokos.io/v5/dokos/parametrage/demarrage/utilisateurs-et-autorisations
  ---
  Utilisateurs et autorisations
  :::

  :::card
  ---
  title: Objectifs de vente
  to: https://doc.dokos.io/v5/dokos/parametrage/demarrage/objectifs-de-vente
  ---
  Objectifs de vente
  :::

  :::card
  ---
  title: Notifications
  to: https://doc.dokos.io/v5/dokos/parametrage/demarrage/notifications
  ---
  Notifications
  :::

  :::card
  ---
  title: Titres d'impression
  to: https://doc.dokos.io/v5/dokos/parametrage/demarrage/titres
  ---
  Titres d'impression
  :::

  :::card
  ---
  title: Modèles d'adresse
  to: https://doc.dokos.io/v5/dokos/parametrage/demarrage/modele-adresse
  ---
  Modèles d'adresse
  :::

  :::card
  ---
  title: Workflows
  to: https://doc.dokos.io/v5/dokos/parametrage/demarrage/workflows
  ---
  Workflows
  :::
::


# Importateur de plans de comptes

Lorsqu'une nouvelle société est créée dans DOKOS, le plan comptable correspondant est créé par défaut avec une structure prédéfinie. Cependant, si vous disposez de votre propre plan comptable, vous pouvez l'importer à l'aide de l'importateur de plan comptable.

Il vous permet de créer votre propre plan comptable selon vos besoins et de l'importer dans le système.

Tout plan comptable existant pour cette société sera écrasé. Assurez-vous que l'entreprise que vous sélectionnez n'a pas de transactions préexistantes, sinon vous recevrez une erreur de validation.

---

Pour y accéder, allez sur :

> Accueil > Import de données et paramètrage
> **Importateur de plans de comptes**

## 1. Comment importer un plan comptable

1. Sélectionnez la **société** pour laquelle vous souhaitez **importer** le **plan comptable**.

![import\_plan\_comptable.png](https://doc.dokos.io/content/setup/chart-of-accounts-import/import_plan_comptable.png)

2. Cliquez sur le bouton **Télécharger le modèle** pour télécharger le modèle.
3. Sélectionnez le **type de fichier** dans lequel vous souhaitez télécharger le modèle.
4. Sélectionnez le **type de modèle** et cliquez sur **Télécharger**.
5. "**Exemple de modèle**" contient des exemples de données pré-remplis afin que vous ayez une idée de la façon de remplir le modèle. Vous pouvez éditer les données dans "Sample Template" lui-même ou télécharger "Blank Template" pour un nouveau modèle.
6. Une fois que vous avez **téléchargé le modèle**, remplissez les détails dans le modèle comme indiqué dans l'exemple de modèle ci-dessous. Veuillez vous assurer de créer des comptes pour les types de compte **Coût des marchandises vendues**, **Amortissement**, **Immobilisations**, **Payable**, **À recevoir**, **Ajustement de stock**. Les types de racine de ces comptes doivent être l'un des actifs, passifs, revenus, dépenses et capitaux propres.
7. Cliquez sur **Joindre** pour télécharger le modèle.
8. Une fois que vous avez téléchargé le modèle, vous pourrez voir l'**aperçu du plan comptable dans la section Aperçu du graphique**.
9. **Si tout semble correct** dans l'aperçu, cliquez sur **Importer** dans le coin supérieur droit et les comptes seront créés.
10. Pour vérifier les comptes créés, vous pouvez accéder au plan comptable et voir les comptes nouvellement créés pour cette société.

## 2. Plans comptables disponibles par pays

Dokos propose des modèles de plans comptables prêts à l'emploi pour de nombreux pays. Lors de la création d'une société, le modèle correspondant au pays sélectionné est utilisé automatiquement. Vous pouvez également importer l'un de ces modèles manuellement via l'importateur.

Parmi les pays disposant d'un plan comptable vérifié, on trouve notamment :

- France
- Philippines
- Nouvelle-Zélande
- Et de nombreux autres pays couverts par la communauté ERPNext/Dokos.

::callout{color="blue" icon="i-mdi-information"}
Le plan comptable pour les **Philippines** est disponible sous forme de modèle vérifié. Il couvre les grandes catégories comptables (Actif, Passif, Capitaux propres, Produits, Charges) avec une numérotation adaptée aux exigences locales philippines.

Le modèle philippin inclut désormais un groupe **Cost of Goods Sold** (compte n° 5001) avec son compte de détail associé (compte n° 5010, type « Cost of Goods Sold »), inséré dans la section Charges avant les *Operating Expenses*. Cette addition garantit que le compte de charges par défaut est sélectionné automatiquement lors de la création d'une société utilisant ce modèle, sans nécessiter de configuration manuelle supplémentaire.
::

::callout{color="blue" icon="i-mdi-information"}
Le plan comptable pour la **Nouvelle-Zélande** est disponible sous forme de modèle vérifié. Il couvre les cinq grandes catégories comptables (Actif, Passif, Capitaux propres, Produits, Charges) avec une numérotation adaptée à la réglementation comptable néo-zélandaise. Ce modèle est automatiquement proposé lors de la création d'une société dont le pays est défini sur **New Zealand**.
::


# Utilisateurs, rôles et autorisations

Dans DOKOS, vous pouvez créer plusieurs utilisateurs et leur attribuer des rôles différents.

La gestion des utilisateurs et des rôles est essentielle pour contrôler l'accès aux données et aux fonctionnalités du système. En définissant clairement les rôles et les autorisations, vous pouvez garantir que chaque utilisateur a accès uniquement aux informations et aux outils dont il a besoin pour accomplir son travail, tout en protégeant les données confidentielles.

Un rôle est un ensemble d'autorisations attribuées à un utilisateur afin qu'il puisse accéder aux documents dont il a besoin. Par exemple, un employé des ventes aura besoin d'accéder aux transactions de vente, mais n'aura pas accès pour approuver les congés.

Certains utilisateurs ne peuvent accéder qu'à la partie publique de DOKOS (Le portail / site web). Ces utilisateurs sont appelés utilisateurs du site Web. Les utilisateurs système auront accès aux modules et pourront accéder aux documents selon les rôles définis.

Chaque utilisateur du système peut se voir attribuer plusieurs rôles et autorisations. Le rôle le plus important est Manager du système. Tout utilisateur ayant ce rôle peut ajouter d'autres utilisateurs et définir des rôles pour tous les utilisateurs.

---

## 1. Utilisateurs et rôles

- [1. Ajouter un utilisateur](https://doc.dokos.io/v5/dodock/fonctionnalites/utilisateurs/utilisateurs)
- [2. Rôle et profil de rôle](https://doc.dokos.io/v5/dodock/fonctionnalites/utilisateurs/roles)

## 2. Autorisations

- [1. Autorisations basées sur les rôles](https://doc.dokos.io/v5/dodock/fonctionnalites/utilisateurs/role-et-autorisations)
- [2. Autorisations des utilisateurs](https://doc.dokos.io/v5/dodock/fonctionnalites/utilisateurs/autorisations-utilisateur)
- [3. Autorisation de rôle pour la page et le rapport](https://doc.dokos.io/v5/dodock/fonctionnalites/utilisateurs/autorisations-pages-rapports)

## 3. Configuration

- [1. Partager un document](https://doc.dokos.io/v5/dodock/fonctionnalites/utilisateurs/partager-un-document)
- [2. Utilisateur limité](https://doc.dokos.io/v5/dodock/fonctionnalites/utilisateurs/utilisateurs-limites)
- [3. Administrateur](https://doc.dokos.io/v5/dodock/fonctionnalites/utilisateurs/administrateur)

## Sécurité

- [1. Authentification à double facteur](https://doc.dokos.io/v5/dodock/fonctionnalites/utilisateurs/2fa)


# Définition de l'objectif de vente de l'entreprise

La définition et la réalisation des objectifs / cibles de vente peuvent aider votre entreprise à atteindre de nouveaux objectifs et à augmenter ses revenus.

1. Les objectifs de vente mensuels peuvent être définis pour une entreprise via la fiche de l'entreprise dans la section Paramètres de vente. Par défaut, le tableau de bord principal de l'entreprise affiche les statistiques de ventes passées par mois.
2. Vous pouvez définir le champ Objectif de vente pour suivre la progression par rapport au graphique:
3. La progression de la cible est également affichée dans les notifications:


# Téléchargement de sauvegardes

Pour obtenir la **dernière sauvegarde de la base de données**, allez sur :

> Accueil > Paramètres > **Télécharger des sauvegardes**

La sauvegarde disponible pour le téléchargement est mise à jour toutes les 8 heures. Cliquez sur le lien pour télécharger la sauvegarde à un moment donné.

![téléchargement\_sauvegarde.png](https://doc.dokos.io/content/setup/download-backup/telechargement_sauvegarde.png)

Par défaut, trois dernières sauvegardes seront disponibles pour le téléchargement. Pour changer cela, cliquez sur **Définir le nombre de sauvegardes**. Cela vous mènera aux **paramètres système** où vous pouvez définir le nombre de sauvegardes disponibles au téléchargement à la fois.

![nombre\_de\_sauvegarde.png](https://doc.dokos.io/content/setup/download-backup/nombre_de_sauvegarde.png)

## 1. Téléchargement de la sauvegarde de fichiers

En cliquant sur Télécharger la sauvegarde des fichiers, vous enverrez un e-mail contenant des liens vers la sauvegarde pour les fichiers privés et publics. L'e-mail doit être configuré pour que cela fonctionne.

![nombre\_de\_sauvegarde.png](https://doc.dokos.io/content/setup/download-backup/nombre_de_sauvegarde.png)

## 2. Automatiser les sauvegardes sur le stockage cloud

Vous pouvez également automatiser vos sauvegardes pour qu'elles soient téléchargées directement sur une plate-forme de stockage cloud. Actuellement, DOKOS prend en charge:


# Notifications

![Cette capture d'écran permet de visualiser la zone permettant d'accéder aux notifications](https://doc.dokos.io/notifications-bureau.png)

## 1. Généralités

La cloche devient rouge avec un point pour signaler à l'utilisateur qu'il a une notification. Une fois la notification consultées,elle reste toujours visible.

## 2. Paramètres des notifications

::tour{demo="Mappemonde" doctype="notification-settings"}
Consultez les paramètres des notifications dans la démo
::

Cette section permet de configurer de manière précise les modalités de réception des notifications, que ce soit par e-mail ou via le système interne. Vous pouvez personnaliser ces notifications en fonction des événements spécifiques, tels que les assignations, mentions ou rappels, pour mieux suivre vos actions et événements importants.

## 3. En savoir plus

Pour configurer vos notifications, rendez-vous dans la [docuementation Dodock](https://doc.dokos.io/v5/dodock/fonctionnalites/notifications).


# Imprimer les titres

Les **En-têtes d'impression** sont les noms / titres que vous pouvez donner à vos **documents d'envoi**.

Ces documents comprennent les factures de vente, les devis des fournisseurs, etc. Vous pouvez créer une liste de noms pour différentes communications commerciales.

Si vous souhaitez renommer un document d'envoi en fonction de son apparence lors de l'impression, vous pouvez le faire via Imprimer les en-têtes. Par exemple, un devis est également appelé **Proposition commerciale**, **estimation** ou **Facture pro forma**.

Pour accéder aux **en-têtes d'impression**, allez sur :

> Accueil > Paramètres > **En-tête d'impression**

![titre\_d'impression.png](https://doc.dokos.io/content/setup/print/titre_dimpression.png)

## 1. Comment créer un en-tête d'impression ?

1. Allez dans la liste des en-têtes d'impression, cliquez sur ➕ Ajouter En-tête.
2. Entrez l'en-tête qui apparaîtra sur le document.
3. **Enregistrer**.

![créer\_nouveau\_titre.png](https://doc.dokos.io/content/setup/print/creer_nouveau_titre.png)

## 1.1 Comment utiliser le modèle d'en-tête d'impression

1. Allez sur un document à imprimer ou envoyer : Par exemple sur Devis Client
2. Sélectionner le document dans la liste
3. Sur le document, allez à la section **Paramètres d'impression**
4. Titre d'impression : Choisir le modèle que vous venez de créer

![choisir\_titre\_d'impression.png](https://doc.dokos.io/content/setup/print/choisir_titre_dimpression.png)


# Modèle d'adresse

Le modèle d'adresse peut stocker différents formats d'adresses en fonction de la région.

Chaque région a sa manière de définir les adresses. Pour gérer plusieurs formats d'adresses pour vos documents (comme les devis, les factures d'achat, etc.), vous pouvez créer des modèles d'adresses par pays .

---

Pour accéder au **modèle d'adresse**, allez sur :

> Accueil > Paramètres > **Modèle d'adresse**

![modèle\_adresse.png](https://doc.dokos.io/content/setup/print/modele_adresse.png)

Un modèle d'adresse par défaut est créé lors de la configuration du système. Vous pouvez le modifier ou créer un nouveau modèle. Ce modèle par défaut s'appliquera à tous les pays n'ayant pas de modèle spécifique.

Prenons l'exemple d'un client de France où **Région** fait partie de l'adresse. Si vous définissez la région dans le modèle d'adresse pour les France, il apparaîtra dans le champ d'adresse et donc dans l'aperçu avant impression. Des champs tels que le code PIN peuvent être modifiés pour être affichés sous forme de code postal et des champs tels que la région peuvent être ajoutés à l'aide de modèles d'adresses.

Le modèle d'adresse vérifie le champ **Pays** dans la base d'adresses pour appliquer différents modèles d'adresses aux transactions.

## 1. Comment créer un modèle d'adresse

1. Allez dans la **liste des modèles d'adresses**, cliquez sur ➕ Ajouter modèle d'adresse.
2. Choisissez un **pays**.
3. Modifiez le **CSS** et **Jinja** si nécessaire.
4. **Enregistrer**.

![créer\_modèle\_adresse.png](https://doc.dokos.io/content/setup/print/creer_modele_adresse.png)

### 1.1 Modèles de Jinja

Le moteur de création de modèles est basé sur HTML et le système de modèles Jinja . Tous les champs (y compris les champs personnalisés) seront disponibles pour la création du modèle.

Voici le modèle Jinja par défaut:

```jinja
{{ address_line1 }}<br>
{% if address_line2 %}{{ address_line2 }}<br>{% endif -%}
{{ city }}<br>
{% if state %}{{ state }}<br>{% endif -%}
{% if pincode %}PIN:  {{ pincode }}<br>{% endif -%}
{{ country }}<br>
{% if phone %}Phone: {{ phone }}<br>{% endif -%}
{% if fax %}Fax: {{ fax }}<br>{% endif -%}
{% if email_id %}Email: {{ email_id }}<br>{% endif -%}
```

## 2. Modèles régionaux pré-configurés

Dokos inclut des modèles d'adresse prêts à l'emploi pour plusieurs pays. Ces modèles sont automatiquement sélectionnés lorsque le champ **Pays** d'une adresse correspond à l'un des pays ci-dessous.

### 2.1 Danemark

Le modèle danois affiche les lignes d'adresse, le code postal suivi de la ville en majuscules, et le pays en majuscules :

```jinja
{{ address_line1 }}<br>
{% if address_line2 %}{{ address_line2 }}<br>{% endif -%}
{{ pincode }} {{ city | upper }}<br>
{{ country | upper }}
```

**Exemple de rendu** pour un fournisseur situé à Copenhague :

```text
Nørregade 12
1165 COPENHAGUE
DANEMARK
```

### 2.2 Bosnie-Herzégovine

Le modèle bosnien suit la même structure : lignes d'adresse, code postal et ville en majuscules, pays en majuscules :

```jinja
{{ address_line1 }}<br>
{% if address_line2 %}{{ address_line2 }}<br>{% endif -%}
{{ pincode }} {{ city | upper }}<br>
{{ country | upper }}
```

**Exemple de rendu** pour un partenaire situé à Sarajevo :

```text
Ulica Ferhadija 3
71000 SARAJEVO
BOSNIE-HERZÉGOVINE
```

::callout{icon="i-mdi-information-outline"}
Ces modèles régionaux sont appliqués automatiquement dès que le pays correspondant est sélectionné dans une adresse. Vous pouvez les personnaliser librement via la liste **Modèle d'adresse**.
::


# Configuration de la société

Une **société** est une personne morale constituée d'une association de personnes pour l'exploitation d'une entreprise commerciale ou industrielle.

Dans DOKOS, la première société est créée lors de la création d'un compte DOKOS. Pour chaque entreprise, vous pouvez définir un domaine comme la fabrication, la vente au détail ou des services en fonction de la nature de votre activité commerciale.

---

Si vous avez plusieurs entreprises, vous pouvez les ajouter à partir de:

> Accueil > Comptabilité > **Société**

## 1. Comment créer une nouvelle société ?

Allez dans la liste des entreprises, cliquez sur **➕ Ajouter une société**.

- Saissez le **nom de la société**.
- Indiquez le **domaine de l'activité** (Service, Distributeur, Production).
- Ajoutez une **abréviation**.
- Choisir une **maison mère** (facultatif).
- **Enregistrer**

L'abréviation de votre entreprise est créée par défaut. Par exemple, FT pour Frappe Technologies. L'abréviation aide à différencier les actifs d'une entreprise d'une autre.

L'abréviation apparaît également dans divers comptes, centres de coûts, modèles de taxes, entrepôt, etc. de votre entreprise.

Vous pouvez également joindre un logo d'entreprise et ajouter une description de l'entreprise.

#### Autres champs lors de la création

**Domaine** : le domaine de travail de l'entreprise. Ex: fabrication, services, etc. Choisissez-en un lors de la création de votre compte.

**Est un groupe** : si coché, cela devient une société mère.

**Société mère** : S'il s'agit d'une société enfant, définissez la société mère dans ce champ, c'est-à-dire sélectionnez une société du groupe à laquelle appartient cette société. Si une société mère est définie, le plan comptable de la nouvelle société que vous créez sera créé en fonction de la société mère sélectionnée.

### 1.1 Structure Multi-entreprises

Supposons que vous dirigiez un groupe d'entreprises, certaines peuvent être des entreprises plus grandes et d'autres peuvent être plus petites et faire partie de la ou des plus grandes entreprises.

Dans DOKOS, vous pouvez configurer plusieurs sociétés. La structure de l'entreprise peut être parallèle, c'est-à-dire des sociétés sœurs, des sociétés mères-enfants ou une combinaison des deux.

Une **société mère** est une organisation plus grande qui se compose d'**une** ou **plusieurs sociétés filles**. Une **société enfant** est une **filiale** d'une **société mère**.

L'arborescence de l'entreprise affiche la structure globale de vos entreprises.

Une fois que vous avez construit une arborescence de sociétés, DOKOS validera si les comptes des sociétés enfants correspondent aux comptes de la société mère. Tous les comptes peuvent être combinés dans un plan comptable consolidé.

### 1.2 Valeurs par défaut

Dans la fiche Société, vous pouvez définir de nombreuses valeurs par défaut pour les maîtres et les comptes. Ces comptes par défaut vous aideront dans la comptabilisation rapide des transactions comptables, où la valeur du compte sera extraite de la fiche de la société si elle est fournie. Dès que la société est créée, un plan comptable et un centre de coûts par défaut sont automatiquement créés.

Les valeurs par défaut suivantes peuvent être définies pour une entreprise :

- **Devise** par défaut
- **En-tête** par défaut pour l'impression
- **Liste de congé**s par défaut
- **Livre comptable** par défaut
- **Termes** et **conditions applicables à la vente**
- **Termes** et **conditions applicables à l'achat**
- **Entrepôt** par défaut pour les retours de ventes
- **Entrepôt de transit** par défaut
- **Pays**
- **Créer un plan comptable** basé sur
- **Numéro de TVA**
- **Date de création**

### 1.4 Paramètre de vente

Indiquez quel est votre objectif de vente mensuelle.

### 1.5 Plan comptable

Pour chaque société, le maître du plan comptable est géré séparément. Cela vous permet de maintenir une comptabilité distincte pour chaque société conformément aux exigences légales. Vous pouvez également importer des comptes en utilisant tableau **les tableaux des comptes importateur**.

DOKOS a un plan comptable localisé facilement disponible pour certains pays. Lors de la création d'une nouvelle société, vous pouvez choisir de configurer le plan comptable pour celle-ci à partir de l'une des options suivantes.

- **Plan comptable standard**
- **Basé sur le plan comptable de l'entreprise existante**

Notez que, si la société mère est sélectionnée lors de la création d'une nouvelle société, le plan comptable sera créé en fonction de la société mère existante.

## 2. Caractéristiques des comptes

### 2.1 Paramètres de comptabilité

Certains des comptes suivants seront définis par défaut lorsque vous créez une nouvelle société, d'autres peuvent être créés. Les comptes sont visibles dans le plan comptable. Ces valeurs peuvent être modifiées ultérieurement si nécessaire.

- Compte de transfert inter-bancaire
- Compte d'arrondis
- Centre de coûts pour les arrondis
- Compte de passage en perte
- Compte de remises autorisées
- Compte de remises reçues
- Compte de gains / pertes de change
- Compte de gains / pertes de change non réalisés
- Compte de bénéfice/perte non réalisée
- Compte d'acompte fournisseur par défaut
- Compte d'avances versées aux employés par défaut
- Begin typing for results.
- Compte de remise sur le paiement par défaut

### 2.2 Paramètres d'Amortissement des Immobilisations

- Compte d'amortissement cumulé
- Compte de dotations aux amortissement
- Série pour les amortissements d'actifs (Ecriture de journal)
- Dépenses incluses dans la valorisation de l'actif
- Compte de Cessions des Immobilisations
- Centre de coûts de l'Amortissement d'Actifs
- Compte d'immobilisation en cours
- Actif reçu mais non facturé

### 2.3 Détail du budget

Choisir le rôle pour la personne qui validera l'approbation d'un budget exceptionnel.

## 3. Informations sur la société

- Date de constitution
- N° de téléphone
- Fax
- Email
- Site web
- Numéro de SIREN
- Description de l'entreprise


# Configurer les taxes

Les impôts sont des contributions obligatoires aux recettes de l'État / du pays.

L'un des principaux facteurs de motivation de l'utilisation obligatoire des outils comptables est le calcul des impôts. DOKOS vous permet de créer des modèles de taxes configurables que vous pouvez appliquer à vos transactions de vente ou d'achat.

---

## 1. Comptes fiscaux

Pour les **comptes fiscaux** que vous souhaitez utiliser dans les modèles de taxes, allez sur :

> Accueil > Comptabilité > **Plan comptable**

Sélectionnez un compte et cliquez sur modifier. Sélectionnez le **Type de compte** comme **Taxe** pour le compte.

## 2. Modèle de taxes de vente et frais

Le **modèle Taxes de vente et frais** récupère les taxes pour vos transactions de vente telles que la **commande client** et la **facture de vente**. Lisez le **modèle des taxes de vente et des frais** pour en savoir plus.

## 3. Modèle de taxes et frais d'achat

Le **modèle des taxes d'achat et des frais** récupère les taxes pour vos transactions d'achat telles que la **commande fournisseur** et la **facture d'achat**. Lisez le **modèle des taxes et frais d'achat** pour en savoir plus.

## 4. Modèle de taxe d'article

La taxe définie dans le **modèle de taxe d'article** s'applique spécifiquement à un **article** ou à un **groupe d'articles**. Il a la préférence sur le **modèle de taxe de vente** / **achat**.

Depuis la V5, le modèle de taxe d'article permet également de marquer une taxe comme **Non applicable** pour un article donné. Cette option exclut complètement la taxe du calcul sur cet article — à ne pas confondre avec un taux à 0 %, qui laisse une ligne de taxe à zéro dans le document. Lisez le **modèle de taxe sur les articles** pour en savoir plus.

## 5. Catégories de taxe

La **catégorie de taxe** aide à appliquer automatiquement les **modèles de taxe de vente** / **achat** dans vos transactions en fonction du **client** / **fournisseur** choisi. Lisez la **catégorie de taxe** pour en savoir plus.


# Paramètres de nommage des documents

Les documents et les transactions peuvent recevoir des préfixes sous la forme de séries de dénomination.

Dokos vous permet de faire des préfixes à vos documents, chaque préfixe formant sa propre série. Par exemple, une série avec le préfixe FA-.YYYY.-.MM.-.DD.-.### aura les numéros FA-2022-03-05-001, FA-2022-03-05-002, FA-2022-03-06-003 etc.

Vous pouvez avoir plusieurs séries pour toutes vos transactions. Par exemple, des ID de facture de vente comme ceux-ci peuvent être générés :

---

Pour accéder au document **Paramètres de nommage des documents**, recherchez depuis la barre de recherche :

`Paramètres de nommage des documents`

## 1. Configuration de la série de noms pour les documents

1. Sélectionnez la transaction pour laquelle vous voulez faire la série. Le système mettra à jour la série actuelle dans la zone de texte.
2. Modifiez la série selon vos besoins avec des préfixes uniques pour chaque série. Le premier préfixe sera le préfixe par défaut. Chaque nouvelle série de nommage de préfixe doit être ajoutée sur une nouvelle ligne. La série de noms nouvellement ajoutée sera disponible dans le document. Plusieurs séries de dénomination

Si vous souhaitez que l'utilisateur sélectionne explicitement une série au lieu de celle par défaut, cochez la case "L'utilisateur doit toujours sélectionner". Il n'y aura pas de série de nommage par défaut si cette case est cochée.

Vous pouvez également mettre à jour le point de départ d'une série en entrant le nom de la série et le point de départ dans la section "Mettre à jour la série".

Cliquez sur le bouton Mettre à jour pour mettre à jour l'ensemble des séries de dénomination pour le document sélectionné.

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Remarque : Pour voir la série de noms nouvellement ajoutée, cliquez sur Paramètres > Recharger.
::

## 2. Année financière dans la série de dénomination

Vous pouvez également afficher l'exercice financier dans la série de dénomination. Par défaut, si vous saisissez "YYYY" dans la série de dénomination, l'année en cours sera sélectionnée. Pour définir des séries de dénomination basées sur l'exercice fiscal. Il est courant d'avoir une série distincte pour chaque exercice financier.

## 3. Mise à jour de la valeur actuelle des séries de dénomination existantes

Vous pouvez modifier le numéro de séquence de départ/actuel d'une série existante.

1. Dans la section Mettre à jour la série, sélectionnez le préfixe dont la séquence doit être modifiée.
2. La valeur actuelle sera récupérée et affichée.
3. Modifiez le numéro de séquence de départ/existant si nécessaire.
4. Cliquez sur Mettre à jour le numéro de série.

Par exemple, si le numéro de série actuel de la commande client est 16 et que vous souhaitez redémarrer ou le définir sur 50, entrez 0 ou 50 selon votre cas. Toute nouvelle commande client créée commencera à partir du nouveau numéro de séquence.

**Astuce** : Vous pouvez avoir une série distincte pour chaque type de client ou pour chacun de vos points de vente.

## 4. Utilisation des valeurs de champ dans les séries de noms

Il est possible d'**inclure la valeur d'un champ du document** dans le masque de numérotation en l'encadrant d'accolades `{nom_du_champ}`.

### Inclure le nom du client ou du fournisseur

| Syntaxe dans le masque | Valeur insérée     | Documents concernés                                      |
| ---------------------- | ------------------ | -------------------------------------------------------- |
| `{customer}`           | Nom du client      | Devis, Commande client, Facture de vente                 |
| `{supplier}`           | Nom du fournisseur | Devis fournisseur, Commande fournisseur, Facture d'achat |

**Exemple :** pour que vos devis portent le nom du client dans leur numéro, configurez :

```text
DEV-{customer}-.YYYY.-.###
```

Ce masque génère des numéros comme `DEV-Maison Verte SARL-2024-001`, `DEV-Maison Verte SARL-2024-002`, etc.

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
**Points d'attention :**

- Le compteur repart de 1 pour chaque nouvelle combinaison préfixe + client/fournisseur + année. Chaque client a donc sa propre séquence.
- Les noms contenant des espaces ou des caractères spéciaux peuvent générer des identifiants longs. Pensez à utiliser un code court si vos noms de tiers sont longs.
::

### Variables d'exercice fiscal

ERPNext et Dokos proposent des variables supplémentaires utiles pour la comptabilité française :

| Variable | Valeur insérée            | Exemple     |
| -------- | ------------------------- | ----------- |
| `{FY}`   | Exercice fiscal complet   | `2024-2025` |
| `{TFY}`  | Exercice fiscal abrégé    | `24-25`     |
| `{ABBR}` | Abréviation de la société | `MV`        |

**Exemple :** `FA-{FY}-.###` génère `FA-2024-2025-001`

### Règles de nommage des documents (cas avancé)

Pour des règles **conditionnelles** — par exemple appliquer un préfixe différent selon le groupe de client, ou utiliser un code abrégé à la place du nom complet — utilisez les **Règles de nommage des documents** accessibles depuis la barre de recherche.

Chaque règle combine :

1. Un **masque de numérotation** (qui peut contenir des variables de champ entre accolades)
2. Des **conditions** définissant quand cette règle s'applique
3. Une **priorité** pour gérer les conflits lorsque plusieurs règles correspondent au même document

> Voir aussi : [Nommage des documents dans Dodock](https://doc.dokos.io/v5/dodock/fonctionnalites/nommage)

---

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

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
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 barre de recherche, 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`) :

```python
doc.title = (doc.name or "") + " - " + (doc.customer_name or "")
```

**Documents d'achat** `Purchase Order` :

```python
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*&#x2A; (fonctionnalité Dokos), le titre restera provisoire jusqu'à cette étape. Ajoutez un second script avec l'événement &#x2A;*`On Submit`**.

::callout{color="blue" icon="i-heroicons-information-circle"}
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.
::

```python
# Documents de vente (Sales Invoice)
frappe.db.set_value(doc.doctype, doc.name, "title", doc.name + " - " + (doc.customer_name or ""))
```

```python
# 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)](https://doc.dokos.io/v5/dodock/fonctionnalites/personnalisations/server_script)


# Outil d'importation de données

L'outil d'importation de données vous permet d'importer des enregistrements à partir d'un fichier CSV / Excel.

L'outil d'importation de données est un moyen facile de télécharger (ou de modifier) des données en masse (en particulier des données de base) dans le système.

---

Pour commencer à importer des données, allez sur :

> Accueil > Paramètres > Données > **Importer des données**

Ou allez dans le document que vous souhaitez importer et cliquez sur Menu > **Importer**:

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Avant d'utiliser l'importation de données, assurez -vous que toutes vos données sont prêtes.
::

## 1. Insertion de nouveaux enregistrements

Supposons que vous souhaitez importer la liste des clients de votre ancien système dans Dokos. La première étape consiste à télécharger un modèle dans lequel nous pouvons saisir nos données.

### 1.1 Téléchargez le modèle

1. Allez dans la liste des clients, cliquez sur Menu > Importer. Cliquez sur **➕ Ajouter Import de données**.
2. Sélectionnez le **type d'importatio**n comme insérer de nouveaux enregistrements.
3. Cliquez sur **Enregistrer** .
4. Maintenant, cliquez sur **Télécharger le modèle**.
5. Lors de l'insertion de nouveaux enregistrements, le modèle doit être vide. Si vous avez quelques clients dans votre système, vous pouvez sélectionner le type d'exportation comme "5 enregistrements" pour voir le format dans lequel vous devez entrer les données dans le modèle.
6. Sélectionnez le **type de fichier** du modèle d'exportation.
7. Sélectionnez les champs que vous souhaitez remplir en tant que détails du client.
8. Cliquez sur **Exporter**.

::callout{color="blue" icon="i-heroicons-information-circle"}
**Champs pré-cochés dans le modèle** : certains champs apparaissent cochés par défaut dans la liste des champs à inclure. Cela signifie qu'un administrateur a configuré ces champs pour être inclus automatiquement dans le modèle d'import. Vous pouvez décocher les champs dont vous n'avez pas besoin avant de télécharger le modèle.
::

::callout{color="blue" icon="i-heroicons-information-circle"}
**Champ ID lors d'une insertion** : lorsque vous téléchargez un modèle vierge pour insérer de nouveaux enregistrements et que l'identifiant est attribué automatiquement par le système (numérotation automatique), la colonne ID n'apparaît pas dans le modèle. Elle n'est présente que si vous choisissez de saisir l'identifiant manuellement.
::

### 1.2 Saisie de données dans le modèle

Votre modèle téléchargé ressemblera à ceci:

Ouvrez le modèle téléchargé dans une application de feuille de calcul (comme Excel, Numbers ou Libre Office) et entrez les données sous les en-têtes de colonne comme suit:

Maintenant, enregistrez votre modèle en tant que fichier Excel ou CSV (valeurs séparées par des virgules).

Vous pouvez laisser la colonne ID vide lors de l'insertion de nouveaux enregistrements.

Lorsque vous importez ce modèle, chaque ligne crée un enregistrement client dans le système.

### 1.3 Importer le modèle

1. Après avoir mis à jour votre fichier modèle, revenez au formulaire d'importation de données et joignez le fichier en cliquant sur le bouton Joindre .
2. Sélectionnez le fichier modèle et cliquez sur **Télécharger** .
3. Une fois le téléchargement réussi, cliquez sur **Démarrer l'importation**.

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
S'il y a des erreurs dans votre modèle, elles seront affichées dans la section **Avertissements**. Les avertissements sont classés par numéro de ligne afin que vous puissiez facilement les retrouver dans le modèle et les résoudre. Vous devez résoudre tous les avertissements avant de pouvoir importer les données.
::

Après avoir résolu les avertissements, cliquez à nouveau sur Démarrer l'importation pour importer les données. Une fois l'importation des données réussie, vous verrez un journal de chaque enregistrement créé dans la section Journal d'importation.

## 2. Mise à jour des enregistrements existants

Supposons que vous souhaitez mettre à jour les données client en masse dans votre système. La première étape consiste à télécharger le modèle avec les données.

### 2.1 Téléchargez le modèle

1. Par exemple, allez dans la liste des clients, cliquez sur Menu > Importer. Cliquez sur **➕ Ajouter Import de données** .
2. Sélectionnez le type d'importation pour mettre à jour les enregistrements existants
3. Cliquez sur **Enregistrer** .
4. Maintenant, cliquez sur **Télécharger le modèle**.
5. Lors de la mise à jour des enregistrements existants, vous devez exporter les enregistrements du système avec le champ ID et les champs que vous souhaitez mettre à jour. Vous pouvez choisir Tous les enregistrements ou Enregistrements filtrés en fonction de votre cas.
6. Sélectionnez les champs que vous souhaitez mettre à jour pour les enregistrements client.
7. Cliquez sur **Exporter** .

### 2.2 Mise à jour des données dans le modèle

Votre modèle téléchargé ressemblera à ceci :

Maintenant, modifiez les valeurs de votre modèle et enregistrez le fichier au format Excel ou CSV.

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Lors de l'exportation des enregistrements pour les mettre à jour, assurez-vous que la colonne ID est exportée et qu'elle n'est pas modifiée. Les valeurs de la colonne ID sont utilisées pour identifier les enregistrements dans le système. Vous pouvez mettre à jour les valeurs dans d'autres colonnes mais pas dans la colonne ID.
::

### 2.3 Importer le modèle

Suivez les étapes de la section **Importation du modèle** ci-dessus.

## 3. Importation d'enregistrements enfants

Les données dans DOKOS sont stockées dans des tableaux comme une feuille de calcul avec des colonnes et des lignes de données. Chaque formulaire peut avoir plusieurs champs comme la commande client. Il a les champs : Client, Entreprise, etc. Il a également des tables comme la table des articles, la table des taxes, etc. Dans l'importation de données, l'ensemble des champs de la commande client est traité comme la table principale et les lignes à l'intérieur de la table enfant (table des éléments) sont traitées comme la table enfant pour l'importation de données.

Chaque formulaire dans DOKOS peut être associé à plusieurs tables enfants. Les tables enfants sont liées aux tables parentes et sont implémentées là où il existe plusieurs valeurs pour une propriété. Par exemple, un article peut avoir plusieurs prix, une facture de vente a plusieurs articles, taxes, etc.

Lorsque vous exportez un document avec des tables enfants, par exemple, chaque ligne enfant apparaîtra sur une ligne distincte mais elle est associée à une seule ligne parente. Les valeurs suivantes dans les colonnes parentes resteront vides. Vous devez vous assurer que cet ordre n'est pas rompu lorsque vous les importez via Data Import.

## 4. Options d'importation

### 4.1 Importer depuis Google Sheets

Vous pouvez également importer des données depuis Google Sheets. Importez votre modèle dans Google Sheets et saisissez les données. Assurez-vous que la feuille de calcul Google est publique. Vous pouvez tester cela en ouvrant l'URL de Google Sheets dans une fenêtre de navigateur privée.

### 4.2 Soumettre après l'importation

Dans DOKOS, les types de documents sont principalement de deux types: les maîtres et les transactions. Les maîtres sont des enregistrements comme Client et Tâche qui ne peuvent être sauvegardés que non soumis. Les transactions telles que les commandes clients, les factures d'achat sont des documents à soumettre et peuvent être soumises.

Lorsque vous sélectionnez un type de document à soumettre pour l'importation, vous pouvez cocher Soumettre après l'importation pour soumettre le document après son importation.

### 4.3 Attention aux envois d'emails !

Supposons que vous ayez créé une notification dans votre système et que chaque fois qu'un prospect est créé, un e-mail est envoyé. Désormais, si vous importez en masse des prospects, de nombreux e-mails seront envoyés, ce qui peut ne pas être souhaité. Vous pouvez désactiver cette option pour éviter d'envoyer des e-mails.

## 5. Notes complémentaires

### 5.1 Limite de téléchargement

Il n'y a pas de limite stricte sur le nombre d'enregistrements pouvant être importés. Mais vous devez essayer de ne télécharger que quelques milliers d'enregistrements à la fois. L'importation d'un grand nombre d'enregistrements (disons 50 000) peut ralentir considérablement le système pour les utilisateurs qui utilisent le système.

### 5.2 Fichiers CSV

Un fichier CSV (Comma Separated Value) est un fichier de données que vous pouvez télécharger dans ERPNext pour mettre à jour diverses données. Tout fichier de feuille de calcul à partir d'applications de feuille de calcul populaires telles que MS Excel ou Open Office Spreadsheet peut être enregistré sous forme de fichier CSV.

Si vous utilisez Microsoft Excel et que vous utilisez des caractères non anglais, assurez-vous d'enregistrer votre fichier encodé au format UTF-8.

Pour les anciennes versions d'Excel, il n'y a pas de moyen clair d'enregistrer au format UTF-8. Enregistrez donc votre fichier au format CSV, puis ouvrez-le dans le Bloc-notes, puis enregistrez-le sous «UTF-8». (Ou mettez à jour votre Excel!)

### 5.3 Types de documents importables

L'importation de données n'est pas disponible pour tous les types de documents. Seuls les types de documents explicitement configurés pour autoriser l'importation proposent l'option **Importer** dans leur menu.

Dans le module **Ressources Humaines**, les types de documents suivants peuvent être importés en masse via l'outil d'importation de données :

- **Recrutement et onboarding** : Lettre d'offre, Modèle de lettre d'offre, Demande de recrutement, Modèle d'offre d'emploi, Modèle de conditions d'offre d'emploi, Recommandation d'employé, Entretien, Retour d'entretien, Type d'entretien
- **Cycle de vie de l'employé** : Intégration d'employé, Modèle d'intégration d'employé, Départ d'employé, Modèle de départ d'employé, Transfert d'employé, Cartographie des compétences, Entretien de sortie, Déclaration finale, Affectation de liste de jours fériés
- **Évaluation et performance** : Évaluation, Cycle d'évaluation, Retour de performance d'employé, Critère de retour d'employé, KRA
- **Gestion des congés** : Ajustement de congé
- **Gestion des plaintes** : Plainte d'employé, Type de plainte
- **Santé et assurance** : Assurance santé d'employé, Type de document d'identification
- **Autres** : Résumé du travail quotidien, Groupe de résumé du travail quotidien, Modèle de planning de poste

Pour importer l'un de ces types de documents, accédez à sa liste correspondante puis cliquez sur **Menu > Importer**.


# Export de données

L'exportation de données vous permet d'exporter des données de DocTypes vers un format CSV ou Excel.

Après avoir exporté des données, vous pouvez utiliser le même fichier pour importer des données à l'aide de l' importation de données.

---

Pour accéder à l'exportation de données, allez sur :

> Accueil > Paramètres > Données > **Exportation de données**

## 1. Comment utiliser l'exportation de données

1. Accédez au **Document Type d'exportation de données**.
2. Sélectionnez le **Document Type** dont vous souhaitez exporter les données.
3. Sélectionnez le **format** de fichier CSV ou Excel.
4. Sélectionnez les champs à exporter. Les champs marqués d'un astérisque (\*) sont obligatoires. Les champs dont l'affichage dépend d'une condition sont signalés par une icône d'avertissement accompagnée d'une info-bulle explicative.
5. Vous pouvez également **ajouter des filtres** pour sélectionner uniquement des données spécifiques, par exemple, Total général>= 1 000 pour les commandes client.
6. Cliquez sur **Exporter** pour **télécharger le fichier**.

![export\_données.png](https://doc.dokos.io/content/setup/data-export/export_donnees.png)

::callout{color="blue" icon="i-heroicons-information-circle"}
**Champs pré-cochés** : certains champs apparaissent cochés par défaut dans la liste. Cela indique qu'un administrateur a configuré ces champs pour être inclus automatiquement dans le modèle d'export, afin de simplifier la sélection pour les utilisateurs.
::

::callout{color="blue" icon="i-heroicons-information-circle"}
**Modèle vierge non disponible à l'export** : lorsque vous exportez des données existantes, l'option "Modèle vierge" n'est pas proposée. Elle est réservée au téléchargement d'un modèle d'import vide (sans données).
::


# Les paramètres système

Le document **Paramètres système** contient les paramètres de configuration du site à l'échelle du système.

Vous pouvez localiser Dokos pour utiliser un fuseau horaire, une date, un nombre ou un format de devise particulier, et également définir l'expiration globale de la session via les paramètres système.

---

Pour ouvrir les paramètres système, allez sur :

> Accueil > Paramètres > **Paramètres système**

## 1. Sections des paramètres système

## 1.1 Général

- **Pays** : Vous pouvez définir le pays par défaut ici, il sera récupéré lors de la création de nouvelles adresses. Si votre entreprise possède plusieurs succursales dans différents pays, choisissez l'emplacement du siège social.
- **Fuseau horaire** : règle automatiquement l'heure en fonction du fuseau horaire.
- **Langue** : définit la langue globale du compte DOKOS. Ensuite, la langue sera modifiée dans tous les menus, transactions, rapports, etc.

## 1.2 Format de date et de nombre

- **Format de la date** : format dans lequel les dates seront affichées. Par exemple, jj.mm.aaaa ou mm / jj / aaaa. Cela dépend du formatage des dates dans votre région.
- **Format de l'heure** : format dans lequel l'heure sera affichée. Vous pouvez choisir d'afficher ( HH\:mm\:ss) ou de masquer les secondes en définissant l'option sur ( HH\:mm).
- **Format des nombres** : Format dans lequel les nombres seront formatés. Par exemple, 1000 ou 1000,00.
- **Nombre de Décimales** : Le nombre de zéros affichés après la virgule décimale pour les quantités, etc. La plage est comprise entre 2 et 9. La valeur par défaut est 3.
- **Précision de la devise** : nombre de zéros affichés après la virgule décimale pour les valeurs de devise. S'il est laissé vide, il sera basé sur le format numérique .

## 1.3 Sauvegardes

Dans DOKOS, vous pouvez sauvegarder la base de données ainsi que vos fichiers. Les sauvegardes de base de données sont créées automatiquement tandis que les sauvegardes de fichiers doivent être téléchargées explicitement.

Ce champ indique le nombre de sauvegardes après lequel les plus anciennes seront supprimées. Par défaut, 3 sauvegardes sont enregistrées sur 24 heures. De nouvelles sauvegardes sont automatiquement créées au bout de quelques heures et la dernière sauvegarde écrasera la plus ancienne. Pour une sauvegarde des fichiers, cliquez sur le bouton **Télécharger** la sauvegarde des fichiers dans le formulaire **Télécharger les sauvegardes**.

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Garder des sauvegardes régulières de votre système est une bonne pratique en cas d'accident et que vous souhaitez revenir en arrière ou simplement pour vos archives.
::

## 1.4 Exécution d'Opérations en Arrière-Plan

- **Conserver les logs pendant seulement 30 jours** : Si la case est cochée alors les utilisateurs pourront rester connectés à DOKOS durant 30 jours, au-délà, l'utilisateur sera déconnecté automatiquement et devra se connecter à nouveau pour accéder à DOKOS.
- **Ne lancer les tâches qu'une fois par jour si inactif depuis (jours)** : Les programmés seront exécutés une fois par jour pour les sites inactifs au bout de X jour(s). La valeur par défaut est 4. C'est-à-dire, si il n'y a eu aucune activité sur le site durant 4 jours, les tâches seront exécutées une seule fois par jour.

## 1.5 Autorisations

À l'aide des autorisations, vous pouvez limiter l'accès des utilisateurs aux types de documents. La limitation peut être basée sur des champs tels que Société, Territoire, Succursale, etc.

Si la case Appliquer les autorisations utilisateur strictes est cochée et que l'autorisation utilisateur est définie pour un DocType pour un utilisateur, tous les documents pour lesquels la valeur du lien est vide ne seront pas affichés à cet utilisateur.

Cela se fait à partir de :

> Accueil > Utilisateurs et autorisations > Autorisations > **Autorisations utilisateur**

**Par exemple** : si vous définissez les autorisations utilisateur pour le territoire et que vous définissez la valeur sur Inde. Si la case à cocher est décochée, toutes les transactions (commandes client, devis) avec l'Inde et vide seront montrées aux utilisateurs.

Si la case à cocher Appliquer les autorisations utilisateur strictes est cochée, les documents dont le territoire est vide ne seront pas affichés aux utilisateurs.

## 1.6 Sécurité

- **Expiration de la session** : nombre d'heures d'inactivité après lesquelles vous serez déconnecté d'une session. Cela contribue à une meilleure sécurité. Par exemple, s'il n'y a aucune activité pendant 6 heures, votre compte sera déconnecté.
- **Expiration de la session Mobile** : expiration de la session lors de la connexion depuis un téléphone mobile.
- **Autoriser une seule session par utilisateur** : si vous souhaitez utiliser un seul ensemble d'informations d'identification pour plusieurs utilisateurs, cochez cette case. Le nombre de sessions simultanées peut être modifié sous User master. Les sessions de téléphonie mobile ne sont pas comptabilisées ici.
- **Autoriser la connexion à l'aide du numéro de mobile** : en cochant la case «Autoriser la connexion à l'aide du numéro de mobile», vous pouvez vous connecter à ERPNext en utilisant un numéro de mobile valide défini dans votre compte utilisateur.
- **Autoriser la connexion à l'aide du nom d'utilisateur** : autorise la connexion de l'utilisateur via son nom d'utilisateur défini dans le maître des utilisateurs .
- **Montrer l'erreur complète et autoriser le signalement des problèmes au développeur** : cela affichera toute l'erreur à l'écran et permettra de signaler les problèmes. Si vous avez des connaissances techniques dans ce domaine, vous pouvez vous faire une meilleure idée de l'erreur en lisant l'intégralité du message.
- **Supprimer les tags EXIF des images téléchargées** : les métadonnées stockées dans des fichiers image au format de fichier EXIF peuvent être exploitées pour obtenir des informations utilisateur sensibles. Cette option permet aux utilisateurs de supprimer ces données des images avant de les télécharger.

## 1.7 Mot de passe

- **Forcer l'utilisateur à réinitialiser le mot de passe** : nombre de jours après lequel une réinitialisation du mot de passe est obligatoire. 0 signifie pas de limite.
- **Activer la stratégie de mot de passe** : active un vérificateur de force de mot de passe afin que les utilisateurs doivent utiliser des mots de passe forts pour leur connexion.
- **Score minimum du mot de passe** : score pour le vérificateur de force du mot de passe\:brUn score de 2 est moyen
  Un score de 3 est fort
  Un score de 4 est très fort

La complexité est basée sur le nombre de caractères, la capitalisation, les caractères spéciaux, etc.

**Limite de génération de lien de réinitialisation de mot de passe** : Ceci permet de limiter le nombre de demandes de réinitialisation de mot de passe par heure, la valeur par défaut est 3. Le paramétrer sur 0 autorisera un nombre illimité de demandes de génération de lien de réinitialisation de mot de passe.

## 1.8 Sécurité contre les attaques de type "force brute"

- **Autoriser les tentatives de connexion consécutives** : connexions consécutives après lesquelles vous serez verrouillé hors du compte pendant une période spécifique. Cela aide si un intrus tente de se connecter à votre compte.
- **Autoriser la connexion après un échec** : secondes après lesquelles une tentative de connexion sera autorisée après des tentatives infructueuses consécutives.

## 1.9 Authentification à Double Facteur

Les paramètres de l'authentification à deux facteurs peuvent être configurés ici.

En cochant **Activer l'authentification à deux facteurs**, les deux options suivantes s'affichent.

- **Contourner l' authentification à deux facteurs pour les utilisateurs qui se connectent à partir d'une adresse IP restreinte** : les utilisateurs qui se connectent à partir d'adresses IP restreintes ne seront pas invités à effectuer une authentification à deux facteurs. Vous pouvez restreindre les adresses IP du maître utilisateur dans le champ Restreindre IP.
- **Contourner la vérification d'adresse IP restreinte Si l' authentification à deux facteurs est activée** : Si cette case est cochée, tous les utilisateurs peuvent se connecter avec l'authentification à deux facteurs, que leur adresse IP soit restreinte ou non.
- **Méthode d'authentification à deux facteurs** : sélectionnez la méthode d'authentification à utiliser - application OTP, SMS ou e-mail.
- **Heure d'expiration de la page d'image QR Code** : Heure d'expiration de l'image QRCode si "OTP App" est sélectionné dans la méthode.
  Nom de l'émetteur OTP du mot de passe à usage unique.

## 1.10 Email

- **Adresse e-mail de pied de page** : le nom, l'adresse et d'autres détails de l'organisation peuvent être ajoutés ici. Cela sera défini par défaut dans tous les e-mails sortants.
- **Désactiver le pied de page standard des e-mails** : si cette case est cochée, le pied de page standard des e-mails sera désactivé pour les e-mails sortants.
- **Masquer le pied de page dans les rapports par e-mail automatique** : si cette case est cochée, les pieds de page seront masqués dans les rapports par e-mail automatique.
- **Envoyer le lien de la vue Web du document dans l'e-mail** : ERPNext dispose d'une vue de portail à partir de laquelle des parties comme les clients et les fournisseurs peuvent s'inscrire et consulter l'historique de leurs commandes. Lorsque vous envoyez une transaction par e-mail à votre interlocuteur, vous pouvez également envoyer un lien Web pour afficher le même document sur le portail de votre compte ERPNext. Cette option activera cette fonctionnalité.

## 1.11 Rapport préparé

- **Activer la suppression automatique des rapports préparés** : Si la case est cochée, alors les rapports préparées seront supprimés automatiquement au bout de X jour(s) (voir point ci-dessous).
- **Période d'expiration des rapports préparés (en nombre de Jours)** : Le système supprimera automatiquement et définitivement les rapports préparés après ce nombre de jours/

## 1.12 Chat

- **Activer le chat** : cette option activera le chat intégré à l'application qui peut être utilisé pour communiquer avec d'autres employés.


# Valeurs par défaut globales

Les valeurs par défaut pour les documents tels que la devise, l'année fiscale, etc., peuvent être définies à partir des valeurs par défaut globales.

Les valeurs définies ici auront un impact sur tous les utilisateurs et les valeurs par défaut des différents champs seront définies pour eux.

---

Pour accéder aux **valeurs par défaut globales**, allez sur :

> Accueil > Paramètres > **Paramètres par défaut globaux**

Ou effectuez une recherche dans la barre de recherche.

## 1. Valeurs par défaut global

Chaque fois qu'un nouveau document est créé, ces valeurs seront définies par défaut.

- Société par défaut
- Exercice en cours
- Pays
- Unité de distance par défaut
- Devise par défaut
- Masquer le symbole monétaire
- Désactiver le Total arrondi
- Désactiver En lettres

L'unité de distance par défaut est utilisée pour calculer la distance totale dans les trajets de livraison.

## 2. Unité de mesure de stock par défaut

Lors de la création d'un nouveau site, l'unité de mesure **Unité** (Unit) est automatiquement initialisée comme unité de mesure de stock par défaut. Cette valeur est configurable et peut être modifiée ultérieurement selon vos besoins depuis les paramètres de l'application.


# Termes et conditions

Les termes et conditions contiennent les termes et conditions d'un service / produit offert par un vendeur à un acheteur.

Chaque devis / commande client doit idéalement contenir un ensemble de termes de votre contrat. Les termes et conditions sont généralement inclus pour définir les conditions de service, les conditions d'utilisation de tout service ou même pour limiter les responsabilités du vendeur en cas de préjudice causé à l'acheteur en raison de l'utilisation des biens ou services fournis. Il est généralement judicieux de créer un ou plusieurs modèles de vos conditions générales afin de disposer d'un ensemble standard de conditions.

Termes et conditions est plus communément appelé Conditions Générales de vente.

---

Pour accéder au modèle de **termes et conditions**, accédez à:

> Accueil > Achats > Paramètres > **Modèle de termes et conditionsOu**
> Accueil > Vente > Paramètres > **Modèle de termes et conditions**

![termes\_et\_conditions.png](https://doc.dokos.io/content/setup/terms-and-conditions/termes_et_conditions.png)

## 1. Comment créer un modèle de conditions générales

1. Accédez à la liste des modèles de conditions générales, cliquez sur **➕ Ajouter Termes et conditions**.
2. Ajoutez les termes et conditions.

![cgv\_société.png](https://doc.dokos.io/content/setup/terms-and-conditions/cgv_societe.png)

### 1.1 Sélectionner dans les transactions

Dans les transactions, vous trouverez une section des termes et conditions dans laquelle vous pourrez rechercher et récupérer le champs des conditions générales requis.

### 1.2 Termes et conditions lors de l'impression

Une fois les conditions générales définies dans une transaction de vente / achat, elles apparaîtront lors de l'impression :

![impression\_transaction.png](https://doc.dokos.io/content/setup/terms-and-conditions/impression_transaction.png)

### 1.3 Que doivent contenir les conditions générales ?

Voici quelques sujets courants que les conditions générales devraient contenir:

- Validité de l'offre.
- Conditions de paiement (à l'avance, à crédit, avance partielle, etc.).
- Qu'est-ce qui est en sus (ou à la charge du client).
- Avertissement de sécurité / d'utilisation.
- Garantie le cas échéant.
- Politique de retour.
- Conditions d'expédition, le cas échéant.
- Moyens de résoudre les litiges, indemnisation, responsabilité, etc.
- Adresse et contact de votre entreprise.
- Les termes et conditions sont les dispositions générales et spéciales, les dispositions, les exigences, les règles, les spécifications et les normes suivies par une entreprise. Ces spécifications font partie intégrante d'un accord ou d'un contrat que l'entreprise conclut avec ses clients, fournisseurs ou partenaires.

Pour plus d'informations sur les Conditions générales de vente, consultez la rubrique officielle [Site du service public](https://www.service-public.fr/professionnels-entreprises/vosdroits/F33527){rel="&#x22;nofollow&#x22;"}ici.

## 2. Copier automatiquement les pièces jointes vers la transaction

Lorsque vous joignez des documents à un modèle de termes et conditions (PDF des CGV, annexes contractuelles, etc.), Dokos peut les **copier automatiquement** sur chaque transaction qui utilise ce modèle — sans que vous ayez à les rattacher manuellement à chaque devis, commande ou facture.

### 2.1 Activer la copie automatique

Dans le modèle de termes et conditions, cochez l'option **Copier les pièces jointes vers la transaction**.

Une fois cette option activée :

- Lors de la **création** d'une transaction (devis, commande client, facture…), toutes les pièces jointes présentes sur le modèle de termes et conditions sélectionné sont automatiquement copiées vers la transaction.
- Lors d'une **modification** de la transaction, si vous changez le modèle de termes et conditions, les pièces jointes du nouveau modèle sont également copiées (les doublons sont ignorés).

### 2.2 Exemple pratique

Maison Verte SARL prépare ses devis avec un modèle de CGV qui inclut toujours une annexe tarifaire et un document de politique de retour.

1. Dans le modèle **CGV Standard 2025**, cochez **Copier les pièces jointes vers la transaction** et attachez les deux documents PDF.
2. Lors de la création d'un devis pour Bureau Moderne, sélectionnez **CGV Standard 2025** dans la section Termes et conditions.
3. À l'enregistrement du devis, les deux PDF sont automatiquement joints au devis — aucune manipulation supplémentaire n'est nécessaire.

### 2.3 Comportement détaillé

| Situation                                              | Résultat                                                                                                                 |
| ------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------ |
| Option **désactivée**                                  | Aucune pièce jointe n'est copiée automatiquement.                                                                        |
| Option **activée**, création d'une transaction         | Les pièces jointes du modèle sont copiées à la création.                                                                 |
| Option **activée**, modification du modèle sélectionné | Les pièces jointes du nouveau modèle sont copiées ; les fichiers déjà présents sur la transaction ne sont pas dupliqués. |

::callout{color="blue" icon="i-mdi-information"}
Seuls les fichiers directement attachés au modèle de termes et conditions sont copiés. Les pièces jointes déjà présentes sur la transaction restent intactes.
::


# Flux de travail

La création d'un flux de travail permet de définir et de personnaliser les étapes nécessaires à l'approbation ou au rejet d'un document. Ce flux de travail remplace le flux par défaut de Dokos.

Pour accéder à **la liste de flux de travail**, allez sur :

> Accueil > Paramètres > **Flux de travail**

::tour{demo="Mappemonde" doctype="workflow"}
Créer un flux de travail dans la démo
::

**Les notes de frais et les demandes de congés** sont les seuls formulaires qui nécessitent obligatoirement un approbateur et qui ont un flux d'approbation par défaut. Le flux de travail personnalisé remplacera ce flux par défaut. Il est possible de créer des flux de travail pour tous les documents présents dans Dokos.

Exemples :

Un devis supérieur à une certaine somme doit être approuvé par le responsable.
Une commande fournisseur avec une quantité dépassant un certain nombre d'articles.

Vous pouvez utiliser l'éditeur de flux de travail pour créer des flux de travail de manière visuelle. Cet outil permet de glisser-déposer des états et de les relier entre eux pour établir des transitions. Vous pouvez également modifier leurs propriétés à partir de la barre latérale.

Lorsque vous enregistrez votre schéma, les champs du formulaire en tableau se remplissent automatiquement.

## 1. Créer un flux de travail

Voici un exemple pour la validation des dépenses avec l'éditeur visuel :

![Cette image permet de visualiser le formulaire : Flux de travail.](https://doc.dokos.io/flux-de-travail.png)![Cette image permet de visualiser le formulaire : Créer un flux de travail](https://doc.dokos.io/flux-de-travail-page.png)![Cette image permet de visualiser le formulaire d'édition visuel.](https://doc.dokos.io/flux-de-travail.png)

### 1.1. État

Vous pouvez créer des états selon vos besoins.

Exemple :

- **Brouillon** : État initial de la dépense.
- **Soumis à la validation** : La dépense est soumise pour approbation.
- **Approuvé** : La dépense est approuvée.
- **Rejeté** : La dépense est rejetée.
- **Annulé** : La dépense est annulée.

### 1.2. Statut du document

- **Brouillon** : Ce statut est à utiliser jusqu'à l'approbation finale.
- **Soumis** : Ce statut fige le document; il n'est plus modifiable.
- **Annulé**

![Cette image permet de visualiser les états de mon document.](https://doc.dokos.io/fluxdetravail4.png)

### 1.3. Autoriser la modification uniquement pour :

Vous devez sélectionner le rôle autorisé à modifier l'état. Il est nécessaire de mener une réflexion sur les différents rôles de votre organisation.

![Cette image permet de visualiser une transition possible.](https://doc.dokos.io/fluxdetravail5bis.png)

### 1.4. Mettre à jour le champ / mettre à jour la valeur :

![Image permettant de visualiser la mise à jour d'un champ dans un document automatiquement.](https://doc.dokos.io/fluxdetravail22.png)Dans certains documents, lorsque aucun flux de travail n'est défini, l'approbateur doit modifier manuellement le statut du document. En mettant en place un flux de travail, vous devez définir le champ à mettre à jour ainsi que la valeur de mise à jour.![Cette image permet de visualiser un formulaire de note de frais avec une menu déroulant permettant de modifier le statut du document.](https://doc.dokos.io/fluxdetravail21.png)

::callout
Il est important de saisir les valeurs de mise à jour avec une majuscule. Pour obtenir le nom exact du champ, rendez-vous dans la personnalisation du formulaire ou appuyez sur la touche Alt en passant la souris sur le champ souhaité.
::

> les champs de la colonne Mettre à jour le champ ne sont pas mis à jour, un nouveau champ personnalisé sera créé avec le nom que vous avez défini dans le champ **Champ d'état du flux de travail**.

### 1.5. Propriété de la transition :

- Les règles de transition déterminent comment les états changent d'un état à un autre.![Cette image permet de visualiser les propriétés des transitions](https://doc.dokos.io/fluxdetravail5bis.png)

Exemple : **De Brouillon à Soumis à la validation** : Action (Bouton) "Soumettre à la validation" par l'employé.

- Vous avez la possibilité de définir des conditions, ce qui peut être utile pour orienter une demande selon son montant.

Exemple : si le montant de la dépense est supérieur à 50 €, l'approbation doit être faite par l'approbateur des notes de frais, alors que si cette dépense est inférieure ou égale à 50 €, l'employé peut lui-même valider sa dépense.

Exemple : Pour une demande de congés : `doc.total_leave_days <= 5` permet d'orienter les demandes de congés égales ou supérieures à 5 jours vers un certain approbateur.

Voici un exemple finalisé de flux de travail, avec la visualisation graphique et sous forme de tableau.

![Cette image permet de visualiser un flux de travail finalisé.](https://doc.dokos.io/fluxdetravail5.png)![Image permet de visualiser le formulaire avec les champs sous forme de tableau.](https://doc.dokos.io/fluxdetravail6.png)

## 2. État du flux de travail

Vous avez la possibilité d'ajouter une couleur pour représenter l'état du flux de travail.

![Cette image permet de visualiser le lien du formulaire : Etat de flux de travail](https://doc.dokos.io/fluxdetravail7bis.png)![Cette image permet de visualiser le formulaire sur l'état du flux de travail.](https://doc.dokos.io/fluxdetravail7.png)

## 3. Option : Ne pas remplacer le statut.

- le statut de ce flux de travail ne remplacera pas le statut du document dans la vue de liste.

![Cette image permet de visualiser l'option pour ne pas remplacer le statut dans la vue liste.](https://doc.dokos.io/fluxdetravail8.png)

Dans l'exemple ci-dessous, nous avons coché l'option. C'est le statut par défaut du document qui est affiché.

![Cette image permet de visualiser le statut du document dans la vue liste.](https://doc.dokos.io/fluxdetravail13.png)

Dans l'exemple ci-dessous, nous n'avons pas coché l'option. C'est donc le statut créé lors de la mise en place du flux de travail qui est visible dans la vue liste de notre dépense.

![Cette image permet de visualisation le statut dans la vue liste.](https://doc.dokos.io/fluxdetravail12.png)

### 3.1. Particularité :

Que l'option soit cochée ou non, le statut à l'intérieur du document reste le statut par défaut.

![Cette image permet de visualiser le statut du document avec la personnalisation de la couleur.](https://doc.dokos.io/fluxdetravail9.png)

### 3.2. Personnalisation : Obtenir les deux statuts dans la vue liste.

Ci-dessous le pas à pas pour obtenir une vue liste avec les deux statuts du document.

![Cette image permet de visualiser la première étape pour permettre d'obtenir les deux statuts dans la vue liste.](https://doc.dokos.io/fluxdetravail15.png)![Image permettant de visualiser la seconde étape pour obtenir les deux statuts.](https://doc.dokos.io/fluxdetravail16.png)![Cette image permet de visualiser la prochaine étape pour obtenir les deux statuts dans la vue liste.](https://doc.dokos.io/fluxdetravail17.png)![Cette image permet de visualiser la personnalisation de la vue liste.](https://doc.dokos.io/fluxdetravail18.png)![Cette image permet de visualiser la vue liste avec les deux statuts.](https://doc.dokos.io/fluxdetravail19.png)

## 4. À savoir

Lorsque vous créez un flux de travail pour les notes de frais ou les demandes de congé, vous devez accéder aux paramètres RH pour supprimer l'obligation de renseigner un approbateur dans les documents.

Avant de retirer cette obligation, le champ approbateur est obligatoire (voir la capture d'écran ci-dessous). Après avoir décoché cette option, le champ apparaît toujours dans les formulaires mais n'est plus obligatoire.

![Cette image permet de visualiser le formulaire : Note de frais.](https://doc.dokos.io/fluxdetravail24bis.png)![Cette image permet de visualiser le formulaire : Paramètres RH.](https://doc.dokos.io/fluxdetravail23.png)

Vous avez la possibilité de masquer ce champ en personnalisant le formulaire.

![Cette image permet de visualiser la personnalisation d'un formulaire. formulaire](https://doc.dokos.io/fluxdetravail24.png)

les champs de la colonne Mettre à jour le champ ne sont pas mis à jour, un nouveau champ personnalisé sera créé avec le nom que vous avez défini dans le champ **Champ d'état du flux de travail**.

## 5. Exemples :

### 5.1. Demande de congés :

![Cette image permet de visualiser un flux de travail pour une demande de congés.](https://doc.dokos.io/fluxdetravail25.png)![Cette image permet de visualiser un flux de travail pour une demande de congés.](https://doc.dokos.io/fluxdetravail29.png)

### 5.2. Devis supérieur à 100€

![Cette image permet de visualiser un flux de travail pour un devis supérieur à 100€](https://doc.dokos.io/fluxdetravail30.png)![Cette image permet de visualiser un flux de travail pour des devis supérieur à 100€](https://doc.dokos.io/fluxdetravail31.png)

## 6. Actions du flux de travail

Actions de flux de travail est un espace centralisé où vous pouvez suivre et gérer toutes les actions en attente dans vos flux de travail.

Les actions du flux de travail enverront des notifications par e-mail uniquement si la case « Envoyer une alerte par e-mail » est cochée dans le flux de travail que vous avez créé.

> Vous pouvez définir un modèle d'e-mail pour les actions du flux de travail sur chaque état. Le modèle peut consister en un message invitant les utilisateurs à passer aux actions de workflow suivantes.

**Fonctions autorisées :**

- frappe.db.get\_value
- frappe.db.get\_list
- frappe.session
- frappe.utils.now\_datetime
- frappe.utils.get\_datetime
- frappe.utils.add à ce jour
- frappe.utils.now

Exemples:

Cela peut être étendu à n'importe quelle propriété du document.

```text
doc.creation > frappe.utils.add_to_date(frappe.utils.now_datetime(), days=-5, as_string=True, as_datetime=True)
```


# Règle d'attribution

Une règle d'attribution vous permet de configurer l'attribution automatique de documents aux utilisateurs.

La règle d'attribution sera utile dans un scénario dans lequel vous avez une équipe de support et des tickets de support entrants. Pour affecter automatiquement les tickets de support parmi les employés qui travaillent sur le support, une règle d'affectation peut être utilisée.

---

Pour accéder à la **règle d'attribution**, allez sur :

> Accueil > Paramètres > **Règle d'attribution**

## 1. Comment créer une règle d'attribution

**Pour configurer une attribution automatique:**

1. Accédez à la **liste des règles d'attribution*&#x2A;, cliquez sur **➕ Ajouter Règle d'attribution**.
2. Sélectionnez le **type de document** que vous souhaitez attribuer automatiquement (par exemple Problème ).
3. Écrivez la **description** qui sera ajoutée à la tâche.
4. Sélectionnez la **condition de l'affectation**. Vous pouvez écrire des expressions Python simples pour l'affectation automatique dans les fichiers Assigner une règle, Fermer Règle et Règle de désassignation. Vous aurez accès à toutes les propriétés du document et pourrez utiliser des opérateurs comme>, <, ==, etc. ainsi que plusieurs conditions comme andet or.

![créer\_règle\_d'attribution.png](https://doc.dokos.io/content/setup/workflows/creer_regle_dattribution.png)

Exemples:

status == "Open"
issue\_type == "Technical" and priority=="High" and status == "Open"
5\. Sélectionnez la règle d'attribution.

**Round Robin** : attribuez chaque document à un utilisateur dans l'ordre.
Équilibrage de charge : attribuez de nouveaux documents à l'utilisateur qui a le moins d'affectations.

Sélectionnez la liste des utilisateurs auxquels cette règle d'attribution s'appliquera :

![ajouter\_utilisateur\_-\_règle\_attribution.png](https://doc.dokos.io/content/setup/workflows/ajouter_utilisateur_-_regle_attribution.png)

Basé sur le champ : introduite dans la v13, cette règle peut être utilisée pour attribuer un document à l'utilisateur défini dans le champ configuré.

Sélectionnez le champ Lien utilisateur qui déterminera à qui cette règle d'attribution s'appliquera.

6. **Enregistrer**.

Vous pouvez utiliser les propriétés du document dans le champ Description qui fera partie de l'affectation. Des règles d'attribution de «priorité» plus élevées seront appliquées en premier.

Exemple:

Le téléchargement du fichier de problème de priorité élevée ne fonctionnant pas vous a été attribué.

Vous pouvez également configurer plusieurs attributions automatiques pour chaque type de document, celle avec la priorité la plus élevée sera appliquée en premier:

Voici un exemple de règle d'attribution.

Définissez le type de document, les descriptions et les conditions.

### 1.1 Règles d'attribution multiple

Vous pouvez également configurer plusieurs attributions automatiques pour chaque type de document, celle avec la priorité la plus élevée sera appliquée en premier :

Voici un exemple de règle d'attribution.

Définissez le type de document, les descriptions et les conditions.

### 1.2 Définition de la date d'échéance pour l'attribution

Vous pouvez définir automatiquement des dates d'échéance pour les affectations en fonction du champ de date du document de référence.

**Exemple** :

Si vous souhaitez définir une date d'échéance sur l'affectation du problème en fonction de la date «Résolution par» du problème, vous pouvez le faire en sélectionnant le champ «Résolution par» dans l' Due Date Based Onoption de la règle d'attribution.

### Noter:

L'option "Date d'échéance en fonction du" ne sera pas disponible si "Type de document" n'est pas encore sélectionné ou si le Type de document sélectionné ne comporte aucun champ "Date" ou "Date / heure".
La date d'échéance dans la mission / la tâche sera mise à jour chaque fois que la valeur du champ «Date d'échéance basée sur» est mise à jour dans le document de référence.


# Articles autorisés par client ou fournisseur

Dokos permet de définir des **restrictions d'articles par tiers** : certains articles ne seront proposés dans la liste déroulante que pour les clients ou fournisseurs explicitement autorisés. Cette fonctionnalité est utile pour les organisations qui gèrent des catalogues différents selon les types de clients, des accords exclusifs avec certains fournisseurs, ou des restrictions contractuelles sur certains produits.

::dokos
Le gestionnaire d'articles par partie est une fonctionnalité propre à Dokos, non disponible dans ERPNext standard.
::

## Configurer les restrictions :badge{text="Dokos" type="warning"}

Les restrictions peuvent être définies à plusieurs niveaux, par ordre de précision croissante :

- **Groupe d'articles** — tous les articles de ce groupe sont restreints
- **Marque** — tous les articles de cette marque sont restreints
- **Client ou Fournisseur** — restriction directement sur la fiche tiers
- **Groupe de clients ou Groupe de fournisseurs** — restriction appliquée à tous les membres du groupe

Sur chacun de ces documents, un panneau **Gestionnaire d'articles par partie** liste les tiers autorisés et permet d'en ajouter ou retirer.

> **Exemple — Maison Verte SARL**
> Les fournitures de bureau de la gamme « Pro » ne sont vendues qu'aux clients professionnels. Le groupe d'articles « Fournitures Pro » est restreint aux clients du groupe « Entreprises ». Lorsqu'un particulier est sélectionné dans un devis, ces articles n'apparaissent pas dans la liste déroulante.

## Restreindre par groupe de clients ou de fournisseurs

Depuis la mise à jour de mai 2026, il est possible de cibler un **groupe de clients** ou un **groupe de fournisseurs** au lieu d'un tiers individuel. Cette option permet de définir une règle une seule fois et de l'appliquer automatiquement à tous les membres du groupe, sans avoir à répéter la configuration pour chaque tiers.

### Comment configurer une restriction par groupe

1. Ouvrez le gestionnaire d'articles par partie depuis la fiche d'un article, d'un groupe d'articles ou d'une marque.
2. Dans le champ **Type de tiers**, sélectionnez **Groupe de clients** ou **Groupe de fournisseurs** (selon le contexte).
3. Dans le champ **Tiers**, choisissez le groupe souhaité parmi ceux qui ne sont pas eux-mêmes des groupes parents (seuls les groupes « feuilles » sont proposés).
4. Enregistrez.

Toute commande ou devis impliquant un client ou un fournisseur appartenant à ce groupe appliquera alors la restriction automatiquement.

> **Exemple — Bureau Moderne**
> Le fournisseur « Bureau Moderne » appartient au groupe « Fournisseurs Bureautique ». Une restriction est définie sur l'article « Cartouche d'encre XL » pour ce groupe. Lorsqu'un bon de commande est créé pour n'importe quel fournisseur du groupe « Fournisseurs Bureautique », cet article apparaît dans la liste déroulante — sans qu'il soit nécessaire de configurer la restriction individuellement pour chaque fournisseur.

## Comment ça fonctionne dans les documents

Dès qu'un client est sélectionné dans un devis ou une commande client, Dokos filtre la liste des articles disponibles pour n'afficher que :

1. Les articles **non restreints** (disponibles pour tous)
2. Les articles **explicitement autorisés** pour ce client, pour son groupe de clients, ou pour un groupe de clients parent

Le même mécanisme s'applique côté achats : seuls les articles autorisés pour le fournisseur sélectionné ou son groupe apparaissent dans les commandes et factures d'achat.

::mermaid
flowchart TD
ART\["Article"] --> R{Restriction\ndéfinie ?}
R -->|Non| TOUS\["Visible pour tous les tiers"]
R -->|Oui| CHECK1{Tiers individuel\nfigure dans la liste ?}
CHECK1 -->|Oui| VIS\["Article visible"]
CHECK1 -->|Non| CHECK2{Groupe du tiers\nfigure dans la liste ?}
CHECK2 -->|Oui| VIS
CHECK2 -->|Non| CACHE\["Article masqué"]

::

::callout{type="warning"}
**Limite connue** : la validation côté serveur n'empêche pas de sauvegarder un document si le tiers est modifié après la saisie des articles. La restriction s'applique uniquement à la sélection des articles dans la liste déroulante.
::

## Panneau de prix par tiers :badge{text="Dokos" type="warning"}

En complément des restrictions, les fiches **Client**, **Fournisseur** et **Article** affichent un **tableau de bord des prix** listant tous les tarifs associés à ce tiers ou article. Ce panneau permet de consulter et gérer les prix sans naviguer vers les enregistrements individuels.

::demo-link{demo="Dokompany" doctype="Customer"}
Voir le gestionnaire d'articles sur une fiche client dans la démo
::

## Voir aussi

- [Les articles](https://doc.dokos.io/v5/dokos/parametrage/articles)
- [Les clients](https://doc.dokos.io/v5/dokos/parametrage/clients)
- [Les fournisseurs](https://doc.dokos.io/v5/dokos/parametrage/fournisseurs)
- [Les prix](https://doc.dokos.io/v5/dokos/parametrage/prix)


# Recherche d'entreprise par SIREN / SIRET

Pour les sociétés configurées en France, Dokos propose une recherche d'entreprise par numéro **SIREN** ou **SIRET** dans les formulaires de création rapide de contact et d'adresse. Le système récupère automatiquement la raison sociale et le numéro fiscal (TVA intracommunautaire), éliminant la ressaisie manuelle et les risques d'erreur.

::dokos
La recherche SIREN/SIRET est une fonctionnalité propre à Dokos pour les sociétés françaises.
::

::warning
Cette fonctionnalité nécessite d'activer l'intégration avec **Pappers** dans les paramètres de Dokos.
::

## Utilisation :badge{text="Dokos" type="warning"}

Lors de la création d'un **Contact** ou d'une **Adresse** via le formulaire de saisie rapide (accessible depuis les fiches Client, Fournisseur ou directement depuis la liste), un champ de recherche par SIREN/SIRET est disponible.

1. Saisissez le numéro SIREN (9 chiffres) ou SIRET (14 chiffres) dans le champ dédié
2. Le système interroge le référentiel des entreprises françaises
3. La raison sociale et le numéro de TVA sont automatiquement renseignés

> **Exemple — Bureau Moderne**
> Lors de l'ajout du nouveau fournisseur "Bureau Moderne", la comptable saisit son numéro SIREN dans le formulaire. La raison sociale officielle et le numéro de TVA intracommunautaire se remplissent instantanément, garantissant une cohérence avec les données officielles.

::demo-link{demo="Dokompany" doctype="Contact"}
Créer un contact dans la démo
::

## Voir aussi

- [Les clients](https://doc.dokos.io/v5/dokos/parametrage/clients)
- [Les fournisseurs](https://doc.dokos.io/v5/dokos/parametrage/fournisseurs)


# Introduction

Le flux d'achats dans Dokos

::mermaid
flowchart LR
DM(Demande de matériel) --> AO(Appel d'offre)
AO --> DF\[Devis Fournisseur]
DF --> CF(Commande fournisseur)
DM --> CF
CF --> RA(Reçu d'achat)
RA --> FA(Facture d'achat)
CF --> FA
FA --> EP(Ecriture de paiement)

::

---

## 1. Cycle d'achat

- [1. Demande de matériel](https://doc.dokos.io/v5/dokos/stocks/demande-materiel)
- [2. Commande fournisseur](https://doc.dokos.io/v5/dokos/achats/commandes-fournisseur)
- [3. Devis fournisseur](https://doc.dokos.io/v5/dokos/achats/devis-fournisseurs)
- [4. Reçu achat](https://doc.dokos.io/v5/dokos/stocks/recus-achats)

## 2. Articles et prix

- [1. Articles et prix](https://doc.dokos.io/v5/dokos/parametrage/articles)
- [2. Schémas promotionnels](https://doc.dokos.io/v5/dokos/stocks/schemas-promotionnels)
- [3. Règles de prix](https://doc.dokos.io/v5/dokos/stocks/regles-de-prix)

## 3. Fournisseurs

- [1. Fournisseur](https://doc.dokos.io/v5/dokos/parametrage/fournisseurs)
- [2. Fiche d'évaluation des fournisseurs](https://doc.dokos.io/v5/dokos/achats/evaluation-fournisseurs)

## 5. Paramètrages

- [1. Paramètres d'achat](https://doc.dokos.io/v5/dokos/achats/parametres-achats)
- [2. Taxes](https://doc.dokos.io/v5/dokos/achats/taxes)


# Paramètres des achats

> Paramètres > **Paramètres des achats**

::tour{doctype="Buying Settings"}
Découvrir les paramètres des achats sur la démo
::

## Fournisseurs

### Règle de nommage

Lorsqu'un fournisseur est créé, le système génère un identifiant (ou Nom) unique pour la fiche de ce fournisseur. :br
Ce nom permet d'identifier le document associé à ce fournisseur, tout en laissant la possibilité d'utiliser le champ *Nom du fournisseur* comme libellé usuel.

Vous pouvez choisir entre plusieurs options pour nommer vos fournisseurs:

1. Utiliser le nom usuel de votre fournisseur pour identifier sa fiche fournisseur

> Nom de la fiche fournisseur: Dupond SAS / Nom du fournisseur: Dupond SAS

2. Utiliser une série

> Nom de la fiche fournisseur: FOUR-0001 / Nom du fournisseur: Dupond SAS

3. Utiliser une règle sur mesure (Nom auto)

> Nom de la fiche fournisseur: 401DUPOND / Nom du fournisseur: Dupond SAS

Pour configurer une série, utiliser les *Paramètres de nommage des documents*
Pour utiliser une règle sur mesure, vous pouvez personnaliser le document **Fournisseur** et sélectionner la règle de nommage qui vous convient.

### Groupe de fournisseurs par défaut

Configurez la valeur par défaut du groupe de fournisseurs qui sera sélectionné lors création d'un nouveau fournisseur.

## Achats

### Liste de prix d'achat par défaut

Configurez la liste de prix à utiliser par défaut lors de la création d'une nouvelle transaction d'achat. :br
La liste de prix par défaut à l'installation du système est **Achat standard**, vous pouvez bien sûr la modifier en fonction des besoins de votre société. ➡️ [Paramétrage des prix](https://doc.dokos.io/v5/dokos/parametrage/prix)

#### Bon de commande obligatoire

Si cette option est configurée, Dokos vous empêchera de créer une **facture d'achat** ou un **reçu d'achat** directement sans créer d'abord une **commande fournisseur**.

Cette configuration peut être écrasée pour un fournisseur en particulier en cochant la case *Autoriser la création de facture d'achat sans commande d'achat* dans la fiche fournisseur.

### Reçu d'achat obligatoire

Si cette option est configurée, Dokos vous empêchera de créer une **facture d'achat** sans créer d'abord un **reçu d'achat**. Dans le cas où le ou les articles de la transaction sont des services, le reçu ne sera pas obligatoire et vous pouvez directement créer une facture.

Cette configuration peut être écrasée pour un fournisseur en particulier en cochant la case *Autoriser la création de facture d'achat sans reçu d'achat* dans la fiche fournisseur

### Maintenir le même prix tout au long du cycle d'achat

Si cette option est activé, Dokos validera si le prix d'un article change dans une facture d'achat ou un reçu d'achat créé à partir d'une commande fournisseur. Il vous aidera à maintenir le même prix tout au long du cycle d'achat.

Vous pouvez configurer le comportement que vous attendez du système si le prix change via le champ **Action si le prix unitaire n'est pas maintenu**:

- **Stop** : le système vous empêchera de changer le prix en affichant une erreur de validation.
- **Avertir** : le système vous permettra de sauvegarder la transaction mais vous avertira par un message que le prix a été modifié.

### Autoriser les articles a être ajoutés plusieurs fois dans une transaction

Lorsque cette case n'est pas cochée, un article ne peut pas être ajouté plusieurs fois dans la même commande fournisseur. :br
Cependant, vous pouvez toujours modifier sa quantité.

### Tolérance de sur-commande

Ce paramètre vous permet de définir un pourcentage de tolérance au-delà duquel Dokos bloquera la réception ou la facturation d'une quantité supérieure à celle initialement commandée.

Par défaut, Dokos interdit de réceptionner ou facturer plus d'articles que la quantité indiquée dans la commande fournisseur. Grâce à ce réglage, vous pouvez autoriser un léger dépassement pour absorber les variations courantes de livraison.

**Exemple** : Maison Verte SARL commande 100 unités à Bureau Moderne. Avec une tolérance de sur-commande de 5 %, il sera possible de réceptionner jusqu'à 105 unités sans que Dokos ne déclenche d'erreur de validation. Au-delà de 105 unités, le système bloquera la transaction.

::callout{color="blue" icon="i-heroicons-light-bulb"}
Ce paramètre s'applique à l'ensemble des commandes fournisseurs. Si vous avez besoin d'une tolérance différente pour un article ou un fournisseur en particulier, rapprochez-vous de votre administrateur.
::


# Devis Fournisseur

Un devis fournisseur est un document rédigé par un fournisseur potentiel spécifiant le coût des articles ou services qu'il pourra vous fournir dans un délai spécifié.

Un **devis fournisseur** peut également **contenir** des **conditions de vente**, des **conditions de paiement** et des **garanties**.

L'**acceptation du devis** par l'acheteur peut être considérée comme un **accord** liant les deux parties.

::mermaid
flowchart LR
id1(Demande de matériel)-->id2(Appel d'offre)
id1-->id3(Commande fournisseur)
id3-->id4(Facture d'achat)
id4-->id5(Écriture de paiement)
id2-->id6(Devis fournisseur)
id6-->id3
id4-->id7(Écriture de paiement - Acompte)
id3-->id8(Reçu d'achat)

::

---

Pour accéder au **Devis fournisseur**, allez sur :

> Accueil > Achat > **Devis fournisseur**

![liste\_-\_devis\_fournisseur.png](https://doc.dokos.io/content/achats/supplier-quote/liste_-_devis_fournisseur.png)

## 1. Prérequis avant utilisation

Avant de créer et d'utiliser un devis fournisseur, il est conseillé de créer d'abord les éléments suivants :

1. **[Créer un fournisseur](https://doc.dokos.io/v5/dokos/parametrage/fournisseurs)**
2. **[Un article](https://doc.dokos.io/v5/dokos/parametrage/articles)**

## 2. Comment créer un devis fournisseur ?

**Il existe 2 méthodes pour faire cette action :**

- Depuis la **"Fiche fournisseur** en allant sur :

> Allez sur La fiche fournisseur > Documents liées > **Devis fournisseur** ➕

- Depuis la fonctionnalité "**Devis fournisseur**" en allant sur :

> Accueil > Achats > Devis fournisseur > **➕Ajouter un Devis Fournisseur**.

![création\_-\_devis\_fournisseur.png](https://doc.dokos.io/content/achats/supplier-quote/creation_-_devis_fournisseur.png)

### 2.1 Informations de base

- Sélectionnez le **fournisseur** qui vous a envoyé le devis.
- Indiquez la **date de transaction** et la **date limite de validité**.

### 2.2 Obtenir les articles de :

Les éléments de la table des éléments peuvent être extraits par d'autres documents qui sont :

- **Demande de matériel**
- **Appel d'offre**

**Demande de matériel** : les articles seront récupérés à partir d'une demande de matériel soumise que vous sélectionnez. Une demande de matériel peut être recherchée avec certains mots correspondants et une plage de dates peut également être sélectionnée pour filtrer les demandes de matériel.

**Appel d'offre** : Renseigné un fournisseur. Ensuite, si vous avez soumis un appel d'offre auprès de ce fournisseur, les articles peuvent être récupérés à partir de celui-ci.

### 2.4 Lien vers les demandes de matériel

Lorsque vous cliquez sur Outils > **Lien vers les demandes de matériel**, cela lie l'appel d'offre aux demandes de matériel disponibles. Les articles doivent être les mêmes dans la demande de devis et la demande de matériel.

Désormais, lorsque l'appel d'offre est enregistré, vous pouvez voir dans le tableau de bord qu'elle est liée à la demande de matériel. S'il y a plusieurs demandes de matériel avec les mêmes articles, le lien sera créé avec la demande de matériel la plus récente.

### 2.5 Plusieurs fournisseurs pour le même produit

Si vous avez plusieurs fournisseurs qui vous fournissent le même article, vous envoyez généralement une demande de devis à différents fournisseurs. Dans de nombreux cas, surtout si vous avez centralisé les achats, vous souhaiterez peut-être enregistrer tous les devis afin de :

- Pouvoir facilement comparer les prix à l'avenir
- Vérifier si tous les fournisseurs ont eu la possibilité de proposer un devis.

::callout{color="teal" icon="i-heroicons-light-bulb"}
Les devis des fournisseurs ne sont pas nécessaires pour la plupart des petites entreprises. Évaluez toujours le coût de la collecte d'informations à la valeur qu'elle fournit réellement.
::

## 3. Caractéristiques

### 3.1 Taxes et frais

Si votre fournisseur vous facture des taxes supplémentaires ou d'autres frais comme des frais d'expédition ou d'assurance, vous pouvez l'ajouter dans cette section. Cela vous aidera à suivre avec précision vos coûts.

De plus, si certains de ces frais ajoutent à la valeur du produit, vous devrez les mentionner dans le tableau des taxes. Vous pouvez également utiliser des modèles pour vos impôts. Pour plus d'informations sur la configuration de vos taxes, consultez le modèle de taxes et frais d'achat .

### 3.3 Adresse et contact

- L'**adresse** et le **contact** seront récupérés si vous les avez enregistrés dans la fiche fournisseur.

### 3.4 Devise et prix

- La **devise*&#x2A; renseigné par défaut est celle qui est indiquée dans les &#x2A;*"Paramètres d'achat"*&#x2A; ou dans les informations de la &#x2A;*"Fiche fournisseur"**.
- Entrez le **code article**, sélectionnez la **quantité**. Le tarif sera récupéré si vous avez défini le tarif d'achat standard pour l'article dans &#x2A;*Prix de l'article .**

### 3.5 Autres informations

Il existe d'autres champs pour compléter la **Fiche devis fournisseur**, qui sont :

- **Remise supplémentaire**
- **Termes et conditions**
- **Paramètres d'impression**
- **Informations addtionnelles**

### A noter :

Les détails que vous remplissez ici, tels que la règle d'expédition, les taxes, la remise, les conditions générales, etc., proviennent de votre fournisseur et peuvent être enregistrés pour un suivi précis.

**A savoir** :

La **catégorie de taxe** sera extraite de la fiche fournisseur si elle est définie
Les **paramètres d'impression** permettent de modifier l'impression de l'offre fournisseur
Les **conditions générales** ici sont celles de votre fournisseur
Le **devis fournisseur** peut être lié aux **demandes de matériel** à l'aide du bouton '**Lien vers les demandes de matériel**'

## 4. Après l'enregistrement

Les éléments suivants peuvent être créés après la soumission d'un devis fournisseur :

- **Un Bon de commande** : Un bon de commande si vous acceptez le devis du fournisseur.
- **Un Devis client** : Un devis à votre client.
- **Une répétition automatique** : Répétition automatique de l'offre fournisseur à des intervalles spécifiés.

## 5. Comparaison des devis fournisseurs

Pour faciliter la prise de décision lors du choix d'un fournisseur, Dokos propose un **rapport de comparaison des devis fournisseurs**. Ce rapport vous permet de visualiser et comparer les différents devis reçus pour un même article ou service.

### 5.1 Accéder au rapport

Pour accéder au rapport de comparaison des devis fournisseurs :

> Accueil > Achat > Rapports > **Comparaison des devis fournisseurs**

### 5.2 Utilisation du filtre de statut

Le rapport inclut désormais un **filtre de statut** qui vous permet de trier les devis en fonction de leur état actuel :

- **Tous** : Affiche tous les devis, quel que soit leur statut (par défaut).
- **Brouillon** : Affiche uniquement les devis qui sont encore en cours d'édition et non soumis.
- **Soumis** : Affiche uniquement les devis qui ont été soumis et sont en attente de validation ou de commande.

Ce filtre est particulièrement utile pour :

- **Suivre l'avancement** des devis en cours de négociation.
- **Identifier rapidement** les devis déjà validés pour passer commande.
- **Éviter les doublons** en distinguant les devis actifs des brouillons.

### 5.3 Exemple d'utilisation

**Scénario** : Vous avez envoyé une demande de devis à trois fournisseurs pour l'achat de 100 chaises de bureau. Deux fournisseurs ont répondu avec des devis soumis, et un troisième vous a envoyé un brouillon pour révision.

1. Allez dans **Accueil > Achat > Rapports > Comparaison des devis fournisseurs**.
2. Sélectionnez &#x2A;*"Soumis"** dans le filtre de statut pour voir uniquement les devis finalisés.
3. Comparez les prix, les délais de livraison et les conditions de paiement des deux fournisseurs.
4. Passez commande auprès du fournisseur choisi.

::callout{color="teal" icon="i-heroicons-light-bulb"}
Utilisez ce filtre pour prioriser vos actions : traitez d'abord les devis soumis pour accélérer le processus d'achat, puis revenez aux brouillons pour les finaliser ou les rejeter.
::

### 5.4 Bonnes pratiques

- **Mettez à jour le statut** des devis dès qu'ils évoluent (de brouillon à soumis, ou soumis à annulé) pour maintenir une vue claire dans le rapport.
- **Utilisez le filtre** avant d'exporter le rapport pour partager uniquement les informations pertinentes avec votre équipe.
- **Combinez ce filtre** avec d'autres critères (comme la date ou le fournisseur) pour affiner encore davantage vos résultats.

::mermaid
flowchart TD
A\[Accéder au rapport] --> B\[Appliquer le filtre de statut]
B --> C{Besoin de voir}
C -->|Tous les devis| D\[Afficher tous les statuts]
C -->|Devis en cours| E\[Filtrer "Brouillon"]
C -->|Devis prêts| F\[Filtrer "Soumis"]
D --> G\[Comparer et analyser]
E --> G
F --> G
G --> H\[Prendre une décision d'achat]
::


# Commande Fournisseur

Une commande fournisseur est un contrat conclu avec votre fournisseur selon lequel vous vous engagez à acheter un ensemble d'articles dans des conditions données.

Il est similaire à une commande client, mais au lieu de l'envoyer à une partie externe, vous le conservez pour les enregistrements internes.

::mermaid
flowchart LR
id1(Demande de matériel)-->id2(Appel d'offre)
id1-->id3(COMMANDE FOURNISSEUR)
id3-->id4(Facture d'achat)
id4-->id5(Écriture de paiement)
id2-->id6(Devis fournisseur)
id6-->id3
id4-->id7(Écriture de paiement - Acompte)
id3-->id8(Reçu d'achat)

::

---

Pour accéder à la **commande fournisseur**, allez sur :

> Accueil > Achats > **Commande fournisseur**

## 1. Prérequis avant utilisation

Avant de créer et d'utiliser un appel d'offre, il est conseillé de créer d'abord les éléments suivants:

1. **[Un fournisseur](https://doc.dokos.io/v5/dokos/parametrage/fournisseurs)**
2. **[Un article](https://doc.dokos.io/v5/dokos/parametrage/articles)**

## 2. Comment créer une commande fournisseur

### 2.1 Informations de base

- Accédez à la liste des **commandes fournisseurs*&#x2A;, cliquez sur **➕Ajouter Commande fournisseur**.
- Sélectionnez le **fournisseur** dans la liste.
- Indiquez la **date de création de la commande** et la **date demandé pour le**.

### 2.2 Adresse et contact

- L'**adresse** et le **contact** seront récupérés si vous les avez enregistrés dans la "**Fiche fournisseur**".

### 2.3 Devise et prix

- La **devise*&#x2A; renseigné par défaut est celle qui est indiquée dans les &#x2A;*"Paramètres d'achat"*&#x2A; ou dans les informations de la &#x2A;*"Fiche fournisseur"**.

### 2.4 Articles de la commande fournisseur

- Entrez le **code article**, sélectionnez la **quantité**. Le tarif sera récupéré si vous avez défini le tarif d'achat standard pour l'article dans &#x2A;*Prix de l'article .**

**Informations articles** à complèter si vous avez un message "champs Obligatoires Requis dans la table Articles, Ligne X > **Description**"

- Il suffit de cliquer sur "**Modifier**" dans ligne produit.

### 2.5 Taxes et frais

Si votre fournisseur vous facture des taxes supplémentaires ou d'autres frais comme des frais d'expédition ou d'assurance, vous pouvez l'ajouter dans cette section. Cela vous aidera à suivre avec précision vos coûts.

De plus, si certains de ces frais ajoutent à la valeur du produit, vous devrez les mentionner dans le tableau des taxes. Vous pouvez également utiliser des modèles pour vos impôts. Pour plus d'informations sur la configuration de vos taxes, consultez le modèle de taxes et frais d'achat.

#### **Règle de livraison**

Une règle d'expédition permet de définir le coût d'expédition d'un article. Le coût augmentera généralement avec la distance d'expédition. Pour en savoir plus, visitez la page des règles d'expédition.

Ceci est très facile à suivre dans Dokos puisque chaque taxe fiscale est également un compte. Idéalement, vous devez créer deux comptes pour chaque type de TVA que vous payez et collectez, «Achat TVA-X» (actif) et «Vente TVA-X» (responsabilité), ou quelque chose à cet effet.

### 2.6 Remise supplémentaire

Outre l'enregistrement de la remise par article, vous pouvez ajouter une remise à l'ensemble du bon de commande dans cette section. Cette remise pourrait être basée sur le total général, c'est-à-dire après impôts / charges ou total net, c'est-à-dire avant taxes / charges. La remise supplémentaire peut être appliquée sous forme de pourcentage ou de montant.

### 2.7 Termes et conditions

Dans les transactions de vente / achat, il peut y avoir certaines conditions générales sur la base desquelles le fournisseur fournit des biens ou des services au client. Vous pouvez appliquer les conditions générales aux transactions aux transactions et elles apparaîtront lors de l'impression du document.

### 2.8 Paramètres d'impression

- **En-tête de lettre**
  Vous pouvez imprimer votre demande de devis / bon de commande sur le papier à en-tête de votre entreprise. En savoir plus ici .

«Regrouper les mêmes éléments» regroupera les mêmes éléments ajoutés plusieurs fois dans le tableau des éléments. Cela peut être vu lorsque votre impression.

- **Imprimer les titres**
  Les titres de vos documents peuvent être modifiés.

### 2.9 Informations additionnelles

Cette section affiche le statut de la commande fournisseur. S'il s'agit d'une commande interentreprises.

### A noter

Les détails que vous remplissez ici, tels que la règle d'expédition, les taxes, la remise, les conditions générales, etc., proviennent de votre fournisseur et peuvent être enregistrés pour un suivi précis.

**A savoir** :

**La catégorie de taxe** sera extraite de la fiche fournisseur si elle est définie
**Les paramètres d'impression** permettent de modifier l'impression de l'offre fournisseur
**Les conditions générales** ici sont celles de votre fournisseur

## 3. Récupération d'articles

Une commande d'achat peut être créée automatiquement à partir de deux méthodes.

### 3.1 Depuis la demande de matériel

Pour accéder, allez sur :

> Obtenir les articles de > **Demande de matériel**

Pour utiliser cette méthode il faut au préalable avoir &#x2A;*[Créer une demande de matériel](https://doc.dokos.io/v5/dokos/stocks/demande-materiel)**

Les articles peuvent être récupérés automatiquement dans la commande d'achat à partir des demandes de matériel ouvertes . Pour que cela fonctionne, les étapes suivantes doivent être effectuées:

- Sélectionnez un fournisseur dans le bon de commande.
- Définissez le fournisseur par défaut dans le formulaire Article sous Valeurs par défaut de l'article .
- Une demande de matériel doit présenter un type «achat».
- Cliquez sur le bouton Obtenir les articles des demandes de matériel ouvertes sous le nom du fournisseur.

Une boîte de dialogue apparaîtra avec les demandes de matériel contenant des articles pour lesquels le fournisseur par défaut est le même que celui sélectionné dans le bon de commande. En sélectionnant les demandes de matériel et en cliquant sur Obtenir les articles , les articles seront extraits des demandes de matériel.

### 3.2 Depuis le devis fournisseur

Pour accéder, allez sur :

> Obtenir les articles de > **Devis fournisseur**

Pour utiliser cette méthode il faut au préalable avoir &#x2A;*[Créer un devis fournisseur](https://doc.dokos.io/v5/dokos/achats/devis-fournisseurs)**

### 4. Après l'enregistrement

Une fois que vous avez «Enregistré» votre commande fournisseur, vous pouvez effectuer des actions telles que :

- Ajouter des articles
- Mettre à jour des articles
- Supprimer des articles

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Vous ne pouvez pas supprimer les éléments qui ont déjà été reçus.
::

- **Statut** : une fois soumis, vous pouvez conserver la commande fournisseur ou la fermer.
- **Créer** : à partir d'une commande fournisseur soumise, vous pouvez créer les éléments suivants:

  - **Reçu d'achat** : Un reçu indiquant que vous avez reçu les articles.
  - **Facture d'achat** : Une facture / facture pour la commande fournisseur.
  - **Saisie de paiement** : Une entrée de paiement indique que le paiement a été effectué par rapport à un bon de commande.
  - **Écriture de journal** : Une entrée de journal est enregistrée dans le grand livre.

## 5. Livraison directe (dropshipping)

Le **dropshipping** (ou livraison directe) est un mode de fonctionnement dans lequel votre fournisseur expédie les articles directement chez votre client, sans que les marchandises ne transitent par votre entrepôt.

Dans Dokos, une commande fournisseur liée à une commande client en livraison directe dispose d'un mécanisme dédié pour suivre les quantités livrées, article par article.

### 5.1 Fonctionnement général

::mermaid
flowchart LR
A(Commande client\nMaison Verte SARL) -->|Livraison directe| B(Commande fournisseur\nBureau Moderne)
B -->|Le fournisseur expédie| C(Client final)
B -->|Mise à jour des quantités livrées| D(Suivi dans Dokos)
D --> E{Livraison complète ?}
E -->|Non| F(Livraison partielle\nenregistrée)
E -->|Oui| G(Commande client\nmarquée livrée)

::

Lorsqu'une commande fournisseur est en mode dropshipping, le bouton **Mettre à jour la quantité livrée** apparaît dans le formulaire. Ce bouton remplace l'ancien mécanisme qui marquait automatiquement la totalité des articles comme livrés en une seule opération.

### 5.2 Enregistrer une livraison (totale ou partielle)

1. Ouvrez la **commande fournisseur** concernée.
2. Cliquez sur le bouton **Mettre à jour la quantité livrée**.
3. Une boîte de dialogue s'affiche avec la liste des articles en dropshipping et leur quantité commandée.
4. Saisissez la **quantité effectivement livrée** par le fournisseur pour chaque article.


   - Vous pouvez saisir une quantité **inférieure** à la quantité totale commandée pour enregistrer une **livraison partielle**.
   - Vous pouvez revenir ultérieurement et mettre à jour à nouveau lorsque le reste est livré.
5. Validez la boîte de dialogue.

Dokos met alors à jour le suivi des livraisons sur la commande client associée en conséquence.

::callout{color="blue" icon="i-heroicons-light-bulb"}
**Exemple** : Maison Verte SARL commande 10 chaises auprès de Bureau Moderne en dropshipping. Bureau Moderne expédie 6 chaises dans un premier temps. Cliquez sur **Mettre à jour la quantité livrée**, saisissez 6 pour cet article, et validez. Lorsque les 4 chaises restantes sont expédiées, répétez l'opération en saisissant 4.
::

### 5.3 Annulation d'une commande fournisseur en dropshipping

Si la commande fournisseur est annulée, les quantités livrées enregistrées pour les articles en dropshipping sont automatiquement **remises à zéro**, ce qui permet de repartir de l'état initial sans incohérence dans le suivi des livraisons.

### 5.4 Impact sur la commande client

Chaque mise à jour des quantités livrées sur la commande fournisseur se répercute sur la **commande client** liée :

- Le taux de livraison de la commande client est recalculé.
- Si toutes les quantités sont livrées, la commande client passe automatiquement au statut **Livré**.
- En cas de livraison partielle, la commande client reste en statut **En cours** jusqu'à la livraison complète.

## 6. Facture fournisseur et plateformes de dématérialisation

Lorsqu'une facture fournisseur est rattachée à une plateforme de dématérialisation (par exemple via le connecteur e-transactions), Dokos affiche un **pill indicateur** directement sur la fiche de la facture fournisseur. Ce badge indique la plateforme qui a reçu la facture.

- **Sur la fiche de la facture** : l'indicateur apparaît près de l'en-tête, dès qu'une plateforme est associée à la facture.
- **Dans la liste des factures fournisseurs** : une colonne dédiée identifie la plateforme réceptrice pour chaque ligne de facture.

Ce mécanisme permet aux équipes achats de repérer en un coup d'œil les factures soumises à dématérialisation et la plateforme qui les prend en charge.


# Carte de pointage des fournisseurs

Une carte de pointage fournisseur est un outil d'évaluation utilisé pour évaluer la performance des fournisseurs.

Les fiches d'évaluation des fournisseurs peuvent être utilisées pour suivre la qualité des articles, la livraison et la réactivité des fournisseurs sur de longues périodes. Ces données sont généralement utilisées pour aider dans les décisions d'achat. Une fiche d'évaluation des fournisseurs est créée manuellement pour chaque fournisseur.

---

Pour accéder à la **fiche d'évaluation des fournisseurs**, allez sur :

> Accueil > Achats > Fiche d'évaluation des fournisseurs > **Carte de pointage fournisseur**

## 1. Prérequis avant utilisation

Avant de créer et d'utiliser une carte de performance fournisseur, il est conseillé de créer d'abord les éléments suivants:

1. **[Créer un fournisseur](https://doc.dokos.io/v5/dokos/parametrage/fournisseurs)**

## 2. Comment créer une carte de pointage fournisseur

- Accédez à la **liste des fiches de résultats des fournisseurs*&#x2A;, cliquez sur **➕Ajouter une fiche d'évaluation fournisseur**.
- Sélectionnez un **fournisseur**.
- Sélectionnez la **période d'évaluation**, qu'elle soit hebdomadaire, mensuelle ou annuelle.
- Configurez la **fonction de notation** (*détails dans la section suivante*).
- Une **carte de pointage fournisseur** est créée pour chaque fournisseur individuellement. Une seule carte de performance fournisseur peut être créée pour chaque fournisseur.

## 3. Caractéristiques

### 3.1 Configuration de la notation

La carte de pointage fournisseur se compose de périodes d'évaluation définies, au cours desquelles la performance d'un fournisseur est évaluée. Cette période peut être hebdomadaire, mensuelle ou annuelle. Le score actuel est calculé à partir du score de chaque période d'évaluation en fonction de la fonction de pondération. La formule par défaut est pondérée linéairement sur les 12 périodes de notation précédentes.

**Classement des fournisseurs**

- Le **classement des fournisseurs** permet de trier rapidement les fournisseurs en fonction de leurs performances. Ceux-ci sont personnalisables pour chaque fournisseur.
- Le **classement du tableau de bord d'un fournisseur** peut également être utilisé pour empêcher les fournisseurs d'être inclus dans la demande de devis ou de recevoir des bons de commande. L'écran suivant peut être vu en agrandissant une ligne dans le tableau «Classement des scores», cliquez sur la flèche orientée vers le bas.

### 3.2 Configuration des critères

Un fournisseur peut être évalué sur plusieurs critères d'évaluation individuels, y compris (mais sans s'y limiter) le temps de réponse aux devis, la qualité des articles livrés et les délais de livraison. Ces critères sont pesés pour déterminer le score final de la période.

Pour créer un nouveau critère, accédez à Achats > Fiche de performance fournisseur > **Critères de fiche de performance fournisseur** :

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
**Remarque** : les pondérations des critères pour une carte de score doivent totaliser 100.
::

### 3.3 Variables de la carte de pointage des fournisseurs

La méthode de calcul de chaque critère est déterminée par le champ Formule des critères, qui peut utiliser un certain nombre de variables préétablies. Cela peut être vu dans la capture d'écran précédente.

La valeur de chacune de ces variables est calculée sur la période de notation pour chaque fournisseur. Des exemples de telles variables comprennent:

- Le nombre total d'articles reçus du fournisseur
- Le nombre total d'articles acceptés du fournisseur
- Le nombre total d'articles rejetés par le fournisseur
- Le nombre total de livraisons du fournisseur
- Le montant total (en euro) reçu d'un fournisseur

Les variables sont prédéfinies, des variables supplémentaires peuvent être ajoutées via des personnalisations côté serveur. Cochez la case Personnalisé si la variable que vous créez est destinée à un champ personnalisé.

La formule des critères doit être personnalisée pour évaluer les fournisseurs de chaque critère de la manière qui correspond le mieux aux exigences de l'entreprise.

### 3.4 Formules d'évaluation

La formule d'évaluation utilise les variables préétablies ou personnalisées pour évaluer un aspect de la performance du fournisseur au cours de la période de notation. Les formules peuvent utiliser les fonctions mathématiques suivantes:

- **ajout** : +
- **soustraction** : -
- **multiplication** : \*
- **division** : /
- **min** : min (x, y)
- **max** : max (x, y)
- **if** / **else**: (x) if (formul) else (y)
- **moins** **de** : <
- **supérieur** **à** : >
- **variables** : '{variable\_name}'

Il est essentiel que la formule puisse être résolue pour toutes les valeurs de variable. C'est le plus souvent un problème si la valeur est résolue à 0. Par exemple :

```text
  {total_accepted_items} / {total_received_items}
```

Cet exemple se résoudrait à 0/0 dans les périodes où il n'y a pas d'articles reçus, et devrait donc avoir une coche pour protéger dans ce cas :

```text
({total_accepted_items} / {total_received_items}) 
if {total_received_items} > 0
else 1.
```

### 3.5 Évaluation du fournisseur

Une évaluation est générée pour chaque période de carte de pointage fournisseur en cliquant sur le bouton «Générer les périodes de carte de pointage manquantes». Le score actuel du fournisseur peut être vu, ainsi qu'un graphique visuel montrant la performance du fournisseur au fil du temps. Toutes les actions contre le fournisseur sont également notées ici, y compris les avertissements lors de la création d'appels d'offres et de bons de commande ou pour empêcher complètement ces fonctionnalités pour ce fournisseur.


# Modèle de taxes et frais d'achat

Les **taxes et frais d'achat** peuvent être appliqués à tout article que vous achetez.

Le modèle des taxes et frais d'achat est similaire au modèle des taxes et frais de vente. Les modèles créés à partir de ce formulaire peuvent être utilisés dans les bons de commande et les factures d'achat pour les enregistrements internes.

Pour les comptes fiscaux que vous souhaitez utiliser dans les modèles de taxes, vous devez définir le champ **Type de compte** sur « Taxe » pour ce compte particulier.

---

Pour accéder au modèle de **taxes et frais d'achat**, allez sur :

> Accueil > Achats > Paramètres > **Modèle de taxes et frais d'achat**

## 1. Comment ajouter des taxes / frais d'achat via un modèle

Avant de créer un nouveau modèle, notez que des modèles sont déjà créés pour de nombreuses taxes couramment utilisées.

- Cliquez sur **➕ Ajouter Modèle de Taxe et frais d'achat**.
- Entrez un **nom de titre** pour la taxe.
- Sous **Type**, définissez ce sur quoi la taxe sera calculée et le taux de taxe. Il existe cinq options :


  1. **Réel** : sur le montant réel de chaque article.
  2. **Sur total net** : sur le total général de tous les éléments.
  3. **Sur le montant de la ligne précédente** : sert à composer les frais. Par exemple, des frais calculés sur le montant auquel une taxe a déjà été appliquée à la ligne précédente.
  4. **Sur le total de la ligne précédente** : comme ci-dessus, mais appliqué sur la facture totale et pas seulement sur le montant d'un article.
- Sélectionnez un compte qui a des taux d'imposition prédéfinis ou créez le vôtre.
- L'option **Par défaut** applique ce modèle automatiquement aux nouvelles transactions d'achat.
- **Enregistrez**.

![créer\_-\_taxes\_et\_frais\_d'achat.png](https://doc.dokos.io/content/achats/purchase-taxes-and-charges-template/creer_-_taxes_et_frais_dachat.png)

## 2. Caractéristiques

### 2.1 Tableau des taxes et frais d'achat

- **Tenir compte des taxes ou frais pour** : *Total* — pour le total de tous les articles. *Évaluation* — pour chaque article. *Évaluation et total* — appliquer les taxes / frais aux deux.
- **Ajouter ou déduire** : si vous souhaitez ajouter ou déduire la taxe de l'article.
- **Numéro de ligne de référence** : si la taxe est basée sur le *Total de la ligne précédente*, vous pouvez sélectionner le numéro de ligne qui sera pris comme base pour ce calcul (la valeur par défaut est la ligne précédente).
- **Cette taxe est-elle incluse dans le tarif de base ?** : si coché, le montant de la taxe sera considéré comme déjà inclus dans le prix d'impression.
- **Responsable du compte** : le grand livre sous lequel cette taxe sera comptabilisée. Si vous sélectionnez TVA ou toute autre taxe prédéfinie, le taux sera automatiquement rempli.
- **Centre de coûts** : si la taxe / charge est un revenu (comme l'expédition) ou une dépense, elle doit être comptabilisée auprès d'un centre de coûts.
- **Description** : description de la taxe (imprimée sur les factures / devis).
- **Taux** : le taux de la taxe, par exemple : 20 = 20 % de taxe.
- **Montant** : le montant fixe de la taxe, par exemple : 100,00 = 100 € de taxe.

---

# Modèle de taxe sur les articles

Le modèle de taxe sur les articles permet d'adapter la taxation article par article.

Si certains de vos articles ont des taux de taxe différents du taux standard attribué dans le tableau Taxes et frais, vous pouvez créer un modèle de taxe d'article et l'affecter à un article ou à un groupe d'articles. Le taux attribué dans le modèle de taxe de l'article sera prioritaire par rapport au taux de taxe standard attribué dans le tableau Taxes et frais.

Par exemple, si une TVA de 20 % est ajoutée dans le tableau des taxes et frais d'achat, elle sera appliquée à tous les articles de votre commande. Si l'article *Fournitures de bureau* de **Bureau Moderne** est soumis à un taux réduit de 5,5 %, créez un modèle de taxe article à 5,5 % et associez-le à cet article — il remplacera automatiquement le taux général sur cet article uniquement.

## Exclure complètement une taxe sur un article

Certains articles peuvent être totalement hors champ d'une taxe spécifique — par exemple un article exonéré alors que votre modèle général applique une TVA à 20 %.

Dokos propose l'option **Non applicable** dans le modèle de taxe sur les articles.

Sur le modèle de taxe d'article, ajoutez une ligne avec le compte de taxe concerné puis cochez **Non applicable** dans la colonne dédiée.

Quand ce modèle est actif sur un article, Dokos ignore complètement cette taxe pour cet article — même si elle est présente dans le modèle de taxes général de la transaction.

::callout{icon="i-heroicons-information-circle"}
**Différence avec un taux à 0 %** : indiquer 0 % laisse la ligne de taxe visible dans le document (montant nul). L'option *Non applicable* supprime totalement la taxe du calcul pour cet article, sans aucune ligne résiduelle dans le document.
::

::mermaid
flowchart TD
A\[Article dans une commande d'achat] --> B{Modèle de taxe\nassocié à l'article ?}
B -- Non --> C\[Taux du modèle général d'achat]
B -- Oui --> D{Option dans le modèle article}
D -- Taux défini --> E\[Taux de l'article prioritaire]
D -- Taux à 0 % --> F\[Taxe affichée à 0 €]
D -- Non applicable --> G\[Taxe exclue du calcul]

::

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Pour que l'exclusion *Non applicable* fonctionne, le compte de taxe dans le modèle article doit être exactement le même que celui présent dans le modèle de taxes général de la transaction.
::


# Introduction

Dokos dispose d'un module de gestion des actifs permettant de gérer l'immobilisation et l'amortissement d'un bien.

---

::demo-link{path="/app/assets"}
Découvrez les actifs dans la démo
::

## Principales fonctionnalités

::card-group
  :::card
  ---
  title: Actifs immobilisés
  to: https://doc.dokos.io/v5/dokos/actifs/actif
  ---
  Créez vos actifs et gérez leurs calendriers d'amortissement
  :::

  :::card
  ---
  title: Mouvements d'actifs
  to: https://doc.dokos.io/v5/dokos/actifs/mouvements-actifs
  ---
  Enregistrez les mouvements de vos actifs immobilisés
  :::
::


# Premiers pas avec les actifs

::mermaid
graph LR;
i0(Catégorie d'actifs)-->i1(Article);
i1-->i2(Facture/Reçu d'achat);
i2-->i3(Actif);

::

Cet exemple est basé sur la configuration de démonstration de Dokos disponible à l'adresse <https://demo.dokos.cloud>{rel="&#x22;nofollow&#x22;"}

# Cas d'usage

Notre société Dokostration a acquis un ordinateur pour pouvoir utiliser le logiciel Dokos . Elle doit comptabiliser l'achat de ce logiciel ainsi que prévoir un tableau d'amortissement afin d'amortir cet achat sur 3 ans.

### 1. Création d'une nouvelle catégorie d'actifs

L'élément permettant de lier l'amortissement de notre actif et sa facturation est l'**Article**. Cet article sera lié à une catégorie d'actif définissant le paramétrage spécifique applicable à notre actif.

Nous allons donc créer une nouvelle catégorie d'actifs appelée **Matériel Informatique**.
Cette catégorie d'actifs ne permettra pas la comptabilisation des immobilisations en cours.

Voici les paramètres que nous attribuons à cette catégorie. Ces paramètres seront repris lors de la création de notre actif.

| Livre comptable | Méthode d'amortissement         | Nombre total d'amortissements | Fréquence d'amortissement | Date de début de l'amortissement |
| --------------- | ------------------------------- | ----------------------------- | ------------------------- | -------------------------------- |
|                 | Linéaire au prorata (360 jours) | 4                             | 12                        |                                  |

:br

| Société      | Compte d'actif immobilisé                    | Compte d'amortissement cumulé                            | Compte de dotations aux amortissement                               | Compte d'immobilisation en cours |
| ------------ | -------------------------------------------- | -------------------------------------------------------- | ------------------------------------------------------------------- | -------------------------------- |
| Dokostration | 218 - Autres immobilisations corporelles - D | 281 - Amortissements des immobilisations corporelles - D | 681 - Dotations aux amortissements, dépréciations et provisions - D |                                  |

### 2. Création d'un nouvel article

Nous allons donc créer un nouvel article *Ordinateur* et cocher la case **Est une immobilisation**.

Nous allons également associer cet article à la catégorie d'actifs **Matériel Informatique**.

### 3. Création de la facture d'achat correspondante

Nous créons ensuite une facture d'achat pour notre ordinateur en sélectionnant l'article **Ordinateur**.

Vous pouvez constater que le compte comptable associé à la ligne d'article **Ordinateur** n'est pas un compte de charges, mais le compte d'actif immobilisé configuré dans notre catégorie d'actif.

Faites bien attention que la TVA soit associée à l'option *Tenir compte des taxes et frais pour* **Total**.

Si la TVA n'est pas récupérable, mettez le montant TTC dans la ligne d'article **Ordinateur**.

Validez la facture.

### 4. Création de l'actif et génération du tableau d'amortissement

Dans le module **Actifs**, nous créons ensuite un nouvel actif, lui donnons un nom et le lions au code d'article **Ordinateur**.

Tout en bas du document, dans la section Autres détails, nous sélectionnons votre facture d'achat.

Il ne reste plus qu'à sélectionner la localisation de cet actif, puis à cocher la case **Calculer la dépréciation** et à mettre la date de mise en service de notre actif.

Après enregistrement, le système a calculé le tableau d'amortissement. Il ne nous reste plus qu'à valider.


# Les actifs immobilisés

Un actif est tout élément de valeur appartenant à une entreprise.

Les meubles, les ordinateurs, les téléphones portables, les imprimantes, les voitures, les équipements de productions sont des exemples d'actifs. En règle générale, un actif est un élément tangible qui se trouve dans les locaux de l'entreprise ou qui est transporté par un employé. Dans certains cas, un actif peut être un élément incorporel.

La durée de vie utile d'un actif s'étend sur plusieurs années et, par conséquent, sa valeur économique est répartie sur les années correspondantes du point de vue comptable. Si vous achetez une imprimante pour 300€ et qu'elle devrait être utile pendant trois ans, du point de vue comptable, 100€ sont enregistrés comme dépense pour trois ans chacun au lieu des 300€ de la première année. La plupart des pays ont des règles pour de tels calculs.

Dans Dokos, le document Actif est le cœur du module de gestion des actifs. Toutes les transactions liées à un actif telles que l'achat, l'amortissement, la maintenance, le mouvement, la mise au rebut, les ventes seront enregistrées dans l'enregistrement de l'actif.

---

Pour accéder à **la liste des actifs**, allez sur :

> Accueil > Actifs > **Actif**

## 1. Prérequis avant utilisation

Avant de créer et d'utiliser Asset, il est conseillé de créer d'abord les éléments suivants :

- **[Article](https://doc.dokos.io/v5/dokos/parametrage/articles)** avec **Est une immobilisation** activé.
- **Catégorie d'actif**

## 2. Comment créer un actif ?

Depuis le document article.

Un élément représentant l'actif doit être créé. La case **Maintenir le stock** doit être décochée et **Est un actif** doit être cochée.

### 2.1 Création automatique d'actifs

Vous pouvez configurer Dokos pour créer automatiquement des actifs lors de l'enregistrement d'un reçu d'achat en activant **Créer automatiquement des actifs lors de l'achat** dans **Article**.

Si vous avez activé la création automatique d'actif pour l'article représentant un actif, vous devrez fournir l'emplacement de l'actif lors de l'enregistrement du reçu d'achat.

### 2.2 Création manuelle d'actifs

Si vous souhaitez créer des actifs manuellement, créez un élément avec **Est un actif** activé et laissez **Création automatique d'actifs à l'achat** décoché. Lors de l'enregristrement d'un reçu d'achat/facture d'achat avec cet article, un message s'affiche indiquant que vous devez créer des actifs manuellement.

Suivez les étapes ci-dessous pour créer des actifs manuellement.

1. Allez dans la liste des actifs, cliquez sur Nouveau.
2. Saisissez un nom pour l'actif.
3. Sélectionnez le code article. Le nom de l'élément et la catégorie d'actif seront récupérés automatiquement.
4. Sélectionnez le propriétaire de l'actif, c'est-à-dire la société, le fournisseur ou le client.
5. Sélectionnez la société/fournisseur/client.
6. Sélectionnez le reçu d'achat/la facture d'achat. La date d'achat et le montant brut de l'achat seront récupérés automatiquement.
7. Sélectionnez un emplacement. Ex : Bureau de Bombay. Cela sera récupéré automatiquement si spécifié dans le tableau des éléments du reçu d'achat
8. Définissez la date de disponibilité. L'amortissement sera calculé à partir de cette date.
9. Enregistrer et envoyer.

Veuillez noter que vous devez créer un enregistrement d'actif pour chaque actif que vous avez acheté . Si vous avez acheté cinq ordinateurs et avez créé un seul reçu d'achat avec une quantité définie sur cinq, vous devrez créer cinq enregistrements d'actifs manuellement.

### 2.3 Importer des actifs existants

Lorsque vous passez d'un système hérité à Dokos, vous devrez ajouter des détails sur tous les actifs que votre entreprise a achetés précédemment, ainsi que les détails de l'amortissement de chaque actif.

Pour un actif existant, vous pouvez créer l'enregistrement d'actif directement en cochant la case **Est un actif existant** et fournir les détails ci-dessous.

- **Montant brut d'achat**
- **Date d'achat**
- **Date de disponibilité**
- **Amortissement cumulé d'ouverture** : Le montant de l'amortissement cumulé qui a déjà été enregistré pour une immobilisation existante.
- **Nombre d'amortissements enregistrés** : Nombre d'écritures d'amortissement déjà enregistrées.

Sur la base de ces détails, le calendrier d'amortissement du montant restant sera créé automatiquement.

### 2.4 Options supplémentaires lors de la création d'un Asset

- **Propriétaire de l'actif** : Le client, la société, le fournisseur
- **Responsable**
- **Dépositaire** : L'employé qui portera le bien.
- **Département** : Le département du Dépositaire.
- **Prochaine date d'amortissement** : Mentionnez la prochaine date d'amortissement, même si c'est la première. Si l'immobilisation est une immobilisation existante et que l'amortissement est déjà terminé, laissez ce champ vide.
- **Calculer l'amortissement** : cochez cette case pour calculer l'amortissement des actifs.
- **Autoriser l'amortissement mensuel** : cochez cette case pour répartir le montant de l'amortissement d'un actif sur 12 mois de l'année. Les écritures d'amortissement seront effectuées chaque mois à la date indiquée comme date de début d'amortissement. Par exemple, si la date de disponibilité est le 22 novembre 2019 et la date de début de l'amortissement est le 31 mars 2020, le premier amortissement sera effectué le 30 novembre 2019, le second le 31 décembre 2019, et ainsi de suite. Le montant sera distribué en fonction des jours restants jusqu'au prochain amortissement.

## 4. Caractéristiques

### 4.1 Amortissement

- **Fréquence d'amortissement (mois)** : nombre de mois entre les amortissements.
- **Nombre total d'amortissements** : nombre total d'amortissements pendant la durée de vie utile de l'actif. En cas d'actifs existants partiellement amortis, mentionner le nombre d'amortissements en cours. Par exemple, si vous définissez la fréquence sur 12 mois et non. des amortissements comme 3, 1 amortissement sera comptabilisé tous les 12 mois pendant 3 ans.
- **Méthode d'amortissement** : Il existe deux options, la ligne droite et le solde dégressif double.
- **Linéaire** : Cette méthode répartit uniformément le coût de l'immobilisation sur sa durée de vie utile.
- **Méthode à double déclin** : Une méthode d'amortissement accéléré, elle entraîne une charge d'amortissement plus élevée au cours des premières années de possession.
- **Valeur écrite** : Dans cette méthode, le pourcentage d'amortissement est fixe mais il est appliqué sur la valeur actuelle de l'actif que nous obtenons après chaque amortissement. Pour en savoir plus sur l'amortissement des actifs, visitez cette page .
- **Date de début d'amortissement** : La date à partir de laquelle la comptabilisation de l'amortissement sera commencée.
- **Valeur attendue après la durée de vie utile** : La durée de vie utile est la période au cours de laquelle l'entreprise s'attend à ce que l'actif soit productif. Après cette période, l'actif est mis au rebut ou vendu. En cas de vente, mentionnez ici la valeur estimée. Cette valeur est également connue sous le nom de valeur de récupération, valeur de rebut ou valeur résiduelle.
- **Taux d'amortissement** : Il sera calculé sur la base du montant inscrit en valeur attendue après la durée d'utilité.

### 4.2 Calendrier d'amortissement

Lors de la comptabilisation des amortissements sur cet actif, la section Calendrier d'amortissement sera visible. Ce tableau comporte des colonnes pour le livre des finances, la date de planification, le montant de l'amortissement, le montant de l'amortissement et l'écriture au journal.

### 4.3 Détails de l'assurance

Si une assurance a été souscrite pour l'actif que vous enregistrez, vous pouvez stocker les détails d'assurance suivants :

- Numéro de police
- Assureur
- Valeur assurée
- Date de début d'assurance
- Date de fin d'assurance
- Assurance tous risques

### 4.4 Écritures comptables

Sur présentation d'un bien, le compte **Immobilisations en cours** sera crédité et le compte d'actif lié à l'actif sera débité. La soumission n'est possible qu'après avoir entré la **Date de disponibilité**. Si la **Date de disponibilité** est une date future, alors l'écriture comptable sera enregistrée automatiquement à cette date via le planificateur.

### 4.5 Entretien

Cocher **Maintenance requise** permet d'enregistrer les entrées de maintenance des actifs pour cet actif.

### 4.6 Après l'enregistrement

Une fois que vous avez créé un actif, vous verrez des options pour transférer, supprimer ou vendre l'actif. Depuis le bouton Faire, vous pouvez ajuster sa valeur et faire une écriture d'amortissement.

# Catégorie d'actif

Une catégorie d'actifs classe les différents actifs d'une entreprise.

La première étape vers la gestion d'actifs consiste à créer une catégorie d'actifs basée sur le type d'actifs. Par exemple, tous vos ordinateurs de bureau et portables peuvent faire partie d'une catégorie d'actifs nommée « Equipements électroniques ».

Dans **Catégorie d'actif**, vous pouvez définir par défaut une méthode d'amortissement, une périodicité et des comptes liés à l'amortissement, qui s'appliqueront à tous les actifs de la catégorie.

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
**Remarque** : Vous pouvez également définir des comptes et des centres de coûts liés à l'amortissement par défaut dans la fiche de la société.
::

---

Pour accéder à **la liste des catégories d'actifs**, allez sur :

> Accueil > Actif > Actifs > **Catégorie d'actif**

![liste\_catégorie\_actif.png](https://doc.dokos.io/content/actifs/asset-category/liste_categorie_actif.png)

## 1. Comment créer une catégorie d'actifs

1. Saisissez un **nom** pour la catégorie d'actif.
2. Cochez **Autoriser la comptabilisation des immobilisations en cours** si vous souhaitez conserver des enregistrements d'actifs sous un compte de bilan temporaire au lieu du compte d'actifs correspondant.
3. **Enregistrer**.

![détails\_catégorie\_actif.png](https://doc.dokos.io/content/actifs/asset-category/details_categorie_actif.png)

### 1.1 Options supplémentaires lors de la création d'une catégorie d'actifs

- **Activer la comptabilisation des immobilisations en cours** : En activant cette option, les écritures comptables des actifs de cette catégorie qui ne sont pas utilisés sont enregistrées dans les comptes des travaux d'investissement en cours. Cela se produit lorsque vous possédez l'actif mais qu'il n'est pas encore utilisé, c'est-à-dire que la **date de disponibilité** est définie à une date ultérieure. Si vous utilisez tous vos actifs immédiatement, désactivez cette fonctionnalité. En le désactivant, la comptabilité CWIP sera ignorée.

## 2. Caractéristiques

### 2.1 Détails du livre comptable

Vous pouvez lier un livre financier si vous déclarez l'amortissement de différentes manières. Vous pouvez saisir les champs suivants :

- **Mode d'amortissement** : Choisissez un mode d'amortissement sur lequel vous enregistrerez l'amortissement des actifs de cette catégorie. Pour en savoir plus, visitez cette page .
- **Fréquence d'amortissement (mois)** : Le nombre de mois au cours desquels l'amortissement sera comptabilisé. L'actif peut être mis au rebut après cette période.
- **Nombre total d'amortissements** : nombre d'amortissements à réserver dans la période sélectionnée.
- **Taux d'amortissement** : Le taux d'amortissement appliqué sur la période sélectionnée. Celui-ci sera calculé en fonction de la méthode d'amortissement choisie.

![livre\_comptable.png](https://doc.dokos.io/content/actifs/asset-category/livre_comptable.png)

### 2.2 Comptes

Les détails de compte suivants peuvent être définis pour enregistrer les valeurs des actifs dans le grand livre :

- **Société**
- **Compte d'immobilisation**
- **Compte d'amortissement cumulé**
- **Compte de dotation aux amortissements**
- **Compte d'immobilisations en cours**

![comptes.png](https://doc.dokos.io/content/actifs/asset-category/comptes.png)

# Lieu

L'emplacement de l'actif indique où se trouve un actif.

Les actifs que votre organisation possède peuvent être situés dans diverses installations telles que des bureaux administratifs, des usines de production, des entrepôts, etc. Dans Dokos, vous pouvez créer un **Emplacement** pour chacune de vos installations et suivre les actifs présents dans ces emplacements.

---

Pour accéder à **la liste Lieu**, allez sur :

> Accueil > Actifs > Actifs > **Lieu**

![liste\_lieu.png](https://doc.dokos.io/content/actifs/location/liste_lieu.png)

## 1. Comment créer un lieu ?

1. Allez sur la liste lieu, cliquez sur **➕ Ajouter Lieu**
2. Ajoutez un nom de lieu
3. Sélectionnez une l**ocalisation parente** si le nouveau lieu est un sous-lieu.
4. Cochez la case si le lieu **Est le contenant**. Il permet de vérifier s'il s'agit d'une unité hydroponique.
5. Cochez la case si le lieu **Est un groupe**.
6. Indiquez les **détails** du lieu comme la latitude et la longitude.
7. **Enregistrez**.

![détails\_lieu.png](https://doc.dokos.io/content/actifs/location/details_lieu.png)

## 2. Caractéristiques

### 2.1 Détails de l'emplacement

Dans les détails de l'emplacement vous pouvez déterminer la latitude et la longitude du lieu;

![emplacement.png](https://doc.dokos.io/content/actifs/location/emplacement.png)

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
**Remarque** : Lorsqu'un actif est déplacé d'un emplacement à un autre, vous devez créer un enregistrement de mouvement d'actif.
::


# Amortissement des actifs

Le système crée automatiquement un calendrier d'amortissement en fonction de la méthode d'amortissement et d'autres entrées connexes telles que « Date de disponibilité à utiliser » dans l'enregistrement de l'actif. Il est également possible de créer plusieurs plans d'amortissement pour différents livres financiers. Vous devez cocher la case « Calculer l'amortissement » lors de la création d'un actif pour calculer son amortissement et ajouter des entrées à la table d'amortissement dans l'enregistrement d'actif.

**Types d'amortissements** en comptabilité et présent dans Dokos :

- **Linéaire** : L'amortissement est calculé en linéaire et se répartit régulièrement sur la fréquence choisie en mois. Par exemple, la valeur actuelle de l'actif est de 1000, la valeur après amortissement est de 500 après 5 ans, la ligne droite définirait 100 comme montant amorti pour chaque année. Cette méthode est utile lorsqu'il n'y a pas de modèle particulier quant à la façon dont l'amortissement a lieu sur une période de temps.
- **Solde dégressif double** : Ceci est également connu sous le nom de solde dégressif de 200%. Dans cette méthode, 20 % sont dépréciés de la valeur existante à chaque fois. Par exemple, si l'actif vaut 1000, il vaudra 800 dans la période suivante, alors 20% de 800 vaudrait 160 donc maintenant l'actif vaut 640, et ainsi de suite jusqu'à ce que la valeur finale soit atteinte. Si vous commencez en milieu d'année, un amortissement de 10 % sera calculé. Cette méthode est utile lorsque l'actif se déprécie rapidement au début et ralentit plus tard.
- **Valeur écrite** : un pourcentage d'amortissement fixe est défini et la valeur de l'actif se déprécie de ce pourcentage sur la durée de vie de l'actif. Ce pourcentage fixe est toujours calculé sur la valeur actuelle actuelle de l'actif. Par exemple, si la valeur est de 1000 et que la « Valeur écrite » est de 10 % sur 5 ans, 10 % seront amortis chaque année pour obtenir la valeur attendue de 600 en fin de vie. Utile pour les véhicules dont la dépréciation est plus élevée les années suivantes.

| Valeur actuelle | Dépréciation | Valeur enregistré |
| :-------------- | :----------- | ----------------- |
| 1000            | 100          | 900               |
| 900             | 90           | 810               |
| 810             | 80           | 730               |
| 730             | 70           | 660               |
| 660             | 60           | 600               |

- **Manuel** : Dans cette méthode, vous pouvez définir la Date d'échéance et le Montant d'amortissement pour chaque période.

## 1. Amortissement programmé

À la date prévue, le système crée une écriture d'amortissement en créant une écriture au journal et la même écriture au journal est affichée dans le tableau d'amortissement pour référence. La prochaine date d'amortissement et la valeur actuelle sont également mises à jour lors de la soumission de l'écriture d'amortissement.

## 2. Écritures comptables sur les amortissements

**Dans l'écriture d'amortissement** :

- **Compte d'amortissement cumulé** est crédité et
- **Compte de charges aux amortissements** est débité.

Les comptes associés peuvent être définis dans la catégorie d'actif ou la société.

## 3. Saisies automatiques d'amortissement

Vous pouvez activer la comptabilisation de l'écriture d'amortissement automatiquement à partir des Paramètres des comptes. Cela créera automatiquement une entrée d'amortissement à la date prévue via le planificateur. Sinon, vous devez créer une écriture au journal manuellement en cliquant sur "Créer > Écriture d'amortissement" dans la ligne Plan d'amortissement correspondante.

## 4. Un exemple

Pour une meilleure compréhension, la valeur nette de l'actif à différentes dates d'amortissement est indiquée dans un graphique linéaire.

## 5. Calcul du prorata pour les sociétés françaises :badge{text="Dokos" type="warning"}

Pour les entreprises dont le pays est **France**, Dokos applique la **règle des trente jours** lors du calcul du prorata d'amortissement en début et en fin d'utilisation d'un actif. Cette règle est conforme aux usages comptables français.

### Règle des trente jours

Plutôt que de compter le nombre exact de jours calendaires, Dokos considère que chaque mois compte **exactement 30 jours** :

- Le 31 d'un mois est traité comme le 30
- Le dernier jour de février est traité comme le 30
- La durée maximale d'une période de calcul est plafonnée à **360 jours**

> **Exemple — Maison Verte SARL**
> Un actif mis en service le 1er mars et amorti sur une fréquence mensuelle : la première période (du 1er mars au 31 mars) est calculée sur 30 jours, et non sur 31. La durée annuelle maximale retenue pour le calcul est de 360 jours.

::mermaid
flowchart LR
A\["Date de mise en service\n(ex. 1er mars)"] --> B\["Calcul du prorata\nrègle des 30 jours"]
B --> C\["Durée de la période\n≤ 360 jours/an"]
C --> D\["Dotation aux amortissements\nde la première période"]

::

Cette règle s'applique automatiquement dès que la société est configurée avec le pays **France** ; aucun paramétrage supplémentaire n'est nécessaire.

## Voir aussi

- [Actif](https://doc.dokos.io/v5/dokos/actifs/actif)
- [Bilan comptable](https://doc.dokos.io/v5/dokos/comptabilite/rapports/bilan)
- [Ajustement de la valeur des actifs](https://doc.dokos.io/v5/dokos/actifs/ajustment-de-la-valeur-des-actifs)


# Ajustement de la valeur de l'actif

Ajustement de la valeur de l'actif
Si la valeur d'un actif change soudainement en raison de dommages, elle peut être enregistrée à l'aide de l'ajustement de la valeur de l'actif.

Dans le cas de la gestion des immobilisations, la valeur d'un actif nécessite parfois un ajustement. Par exemple, si un ordinateur portable est endommagé pour une raison quelconque, sa valeur chutera instantanément. Et dans ce cas, il faut réajuster la valeur de l'actif.

---

Pour accéder à **la liste ajustement de la valeur de l'actif**, allez sur :

> Accueil > Actifs > Entretien > **Ajustement de la valeur des actifs**

![liste.png](https://doc.dokos.io/content/actifs/asset-value-adjustment/liste.png)

## 1. Prérequis avant utilisation

Avant de créer et d'utiliser Ajustement de la valeur des actifs, il est conseillé de créer d'abord les éléments suivants :

- **[Actifs](https://doc.dokos.io/v5/dokos/actifs)**
- Activer **Calculer l'amortissement** dans le formulaire d'actif

## 2. Comment créer un ajustement de valeur d'actif

1. Accédez à la liste Ajustement de la valeur de l'actif, cliquez sur **➕ Ajouter Ajustement de la valeur de l'actif**.
   2.Sélectionnez un **actif** dont la valeur doit être ajustée.
2. Sélectionnez une **date**.
3. Entrez la **valeur actuelle** et **la nouvelle valeur** de l'actif.
4. **Enregistrer**.

![ajustement\_de\_la\_valeur.png](https://doc.dokos.io/content/actifs/asset-value-adjustment/ajustement_de_la_valeur.png)

Lors de l'enregistrement, le système enregistrera un "Gain/Perte sur la réévaluation de l'actif" et ajustera l'évaluation de l'actif. Vous pouvez modifier le centre de coûts et ajouter un livre financier.

Lors de la soumission, une écriture de journal est créée sous le compte « Amortissements cumulés ».


# Achat d'un actif

Dans Dokos vous pouvez acheter un ou plusieurs actifs pour votre activité et les renseigner.

## 1. Prérequis avant utilisation

- **[Catégorie d'actif](https://doc.dokos.io/v5/dokos/actifs/actif#cat%C3%A9gorie-dactif)**

## 1. Comment créer un achat d'un actif ?

1. Allez sur la liste d'article, créer un nouvel article
2. Créez un élément avec **Est une immobilisation** d'actif pour créer l'actif.
3. Vous pouvez également activer « **Créer automatiquement des actifs à l'achat** pour créer automatiquement des actifs. (Optionnel)
4. Ensuite, le cycle d'achat doit être suivi pour l'achat d'un actif.
5. Saisissez l'emplacement de l'actif dans le tableau Articles du reçu d' achat ou de la facture d'achat par lequel vous recevez l'article.
6. Lors de la soumission d'un reçu d'achat, basé sur la case à cocher de création automatique, les enregistrements d'actifs seront créés automatiquement. Vous pouvez ensuite saisir manuellement d'autres détails de l'actif à partir du formulaire d'actif.

Les écritures comptables suivantes seront enregistrées lors de la soumission de l'entrée de réception si la comptabilité des travaux d'investissement en cours est activée dans la catégorie d'actif de l'actif acheté.

On remarque ici qu'au lieu du compte d'actif correspondant, les immobilisations en cours ont été débités. C'est parce que l'actif a seulement été acheté et qu'il n'est toujours pas disponible pour utilisation. Jusqu'à ce que l'actif soit prêt à être utilisé, la valeur de l'actif est maintenue sur ce compte. Le jour où il est disponible, le compte CWIP est crédité et le compte d'actif correspondant est débité.

En cas de 'Comptabilité des travaux d'immobilisations en cours' désactivée dans la catégorie d'actif, l'entrée de reçu sera effectuée sur les comptes d'actif correspondants définis dans la catégorie d'actif.

Dokos utilise également un compte temporaire **Actifs reçus mais non facturés** (un compte de passif) qui est crédité sur présentation de l'entrée du reçu d'achat. Plus tard, sur présentation de la facture d'achat, ce compte est débité/extourné.


# Réparation d'actifs

La réparation d'actifs fait référence à toute activité effectuée pour réparer un actif cassé afin de restaurer toutes ses fonctionnalités.

Vous pouvez également conserver les enregistrements des réparations/défaillances des actifs qui ne sont pas répertoriés dans la gestion des actifs.

---

Pour accéder à **la liste de réparation d'actifs**, allez sur :

> Accueil > Actifs > Maintenance > **Réparation d'actifs**

![liste\_réparation\_actif.png](https://doc.dokos.io/content/actifs/asset-repair/liste_reparation_actif.png)

## 1. Prérequis avant utilisation

Avant de créer et d'utiliser Asset Repair, il est conseillé de créer d'abord les éléments suivants :

- **[Actifs](https://doc.dokos.io/v5/dokos/actifs)**

## 2. Comment créer une réparation d'actif

1. Accédez à la liste Réparation d'actif, cliquez sur **Ajouter réparation d'actif**.
2. Sélectionnez l'**actif**.
3. Sélectionnez la **date d'échec**.
4. Entrez une **description d'erreur** décrivant le problème.
5. Vous pouvez également l'attribuer à quelqu'un pour qu'il prenne d'autres mesures.
6. Ajoutez les actions effectuées si réparées, entrez le coût de réparation.
7. Modifiez l'état de la réparation entre **En attente**, **Terminé** ou « **Annulée**.
8. **Enregistrer**.

![détails\_réparation.png](https://doc.dokos.io/content/actifs/asset-repair/details_reparation.png)

## 3. Caractéristiques

### 3.1 Détails de la réparation

- Date d'échec et date d'achèvement
- Attribuer à
- État de réparation
- Attribuer au nom
- Coût de réparation

![détails\_de\_la\_réparation.png](https://doc.dokos.io/content/actifs/asset-repair/details_de_la_reparation.png)

### 3.2 Description

Indiquez dans la section de description les informations sur les erreurs et les actions qui ont été réalisées.

![description.png](https://doc.dokos.io/content/actifs/asset-repair/description.png)


# Vendre un actif

Pour vendre un actif, ouvrez l'enregistrement de l'actif et cliquez sur le bouton **Vendre un actif** . Cela vous mènera à une facture de vente . Dans la facture de vente, entrez des détails tels que le client et la date d'échéance du paiement.

Sur présentation de la facture de vente, les écritures comptables suivantes auront lieu :

- Le **Compte à recevoir** (Débiteurs) sera débité du montant de la vente.
- **Compte d'actifs fixes** sera crédité du montant d'achat de l'actif.
- **Compte d'amortissement cumulé** sera débité du montant total déprécié jusqu'à présent.
- Le **Compte de gain/perte sur la cession d'actifs** sera crédité/débité en fonction du montant du gain/de la perte. Le compte Gain/Perte peut être défini dans l'enregistrement de l'entreprise.


# Mouvement d'actif

Le mouvement d'actifs fait référence au déplacement d'un actif d'un emplacement à un autre.

Dans Dokos, vous pouvez suivre l'emplacement d'un actif ou à qui il est émis. Pour le suivi, vous devez créer une transaction de mouvement d'actif chaque fois que l'actif est déplacé d'un emplacement à un autre. Vous pouvez également garder une trace de l'émission d'un actif à n'importe quel employé.

---

Pour accéder à **la liste des mouvements d'actifs**, allez sur :

> Accueil > Actifs > Actifs > **Mouvement d'actifs**

![actifs\_mouvement.png](https://doc.dokos.io/content/actifs/asset-movement/actifs_mouvement.png)

## 1. Prérequis avant utilisation

Avant de créer et d'utiliser Asset Movement, il est conseillé de créer d'abord les éléments suivants :

- **[Actif](https://doc.dokos.io/v5/dokos/actifs)**
- Emplacement de l'actif

## 2. Comment créer un mouvement d'actif

1. Accédez à la liste des mouvements d'actifs, cliquez sur **➕ Ajouter Mouvement d'actif**.
2. Sélectionnez l'objet dans **Ticket**, **Reçu** ou **Transférer**.
3. Les champs obligatoires seront modifiés en fonction de l'objectif.
4. Sélectionnez **une date**.
5. Sélectionnez les **actifs** que vous souhaitez déplacer. L'emplacement actuel / le dépositaire sera automatiquement récupéré.
6. Sélectionnez le **type de document** de référence (facultatif).
7. Sélectionnez Nom du document de référence (facultatif).
8. **Enregistrer**.

![liste\_mouvement\_actif.png](https://doc.dokos.io/content/actifs/asset-movement/liste_mouvement_actif.png)

## 3. Caractéristiques

### 3.1 Actifs

Dans le tableau des actifs, vous pouvez indiquer les champs suivants :

- Actif
- Localisation source
- De l'employé
- Localisation cible
- A l'empployé

![actifs\_mouvement.png](https://doc.dokos.io/content/actifs/asset-movement/actifs_mouvement.png)

### 3.2 Référence

Choisissez le type de document de référence et indiquez le nom du document pour renseigner la référence.

![référence.png](https://doc.dokos.io/content/actifs/asset-movement/reference.png)

Pour effectuer un mouvement d'actifs d'un certain nombre d'actifs, il est conseillé d'aller dans la liste des actifs, de sélectionner les actifs à déplacer et de cliquer sur **Faire un mouvement d'actifs** à partir du menu Actions en haut à gauche.

Il existe également un bouton Transférer un actif en haut à droite du formulaire d'actif pour lancer le mouvement d'actif. Il remplit automatiquement les champs disponibles à partir du formulaire d'actif.


# Maintenance des actifs

La maintenance des actifs fait référence à toute activité effectuée sur les actifs pour maintenir leurs performances ou leur état.

Dokos fournit des fonctionnalités permettant de suivre les détails des tâches de maintenance/étalonnage individuelles pour un actif par date, la personne responsable de la maintenance et la date d'échéance de la maintenance future.

**Pour effectuer la maintenance des actifs dans Dokos** :

1. Activez **Maintenance requise » à partir du document Actif**.
2. Créez une **équipe** de maintenance des actifs.
3. Créez la **gestion des actifs**.
4. Un journal de maintenance des actifs est créé.
5. Créer un journal de réparation d'actifs.

---

Pour accéder à la liste Maintenance des actifs, accédez à :

> Accueil > Actifs > Maintenance > **Maintenance des actifs**

![liste\_maintenance.png](https://doc.dokos.io/content/actifs/asset-maintenance/liste_maintenance.png)

## 1. Prérequis avant utilisation

Avant de créer et d'utiliser Asset Maintenance, il est conseillé de créer d'abord les éléments suivants :

- **[Actif](https://doc.dokos.io/v5/dokos/actifs)** avec la case « Maintenance requise » cochée.
- **[Équipe de maintenance des actifs](https://doc.dokos.io/v5/dokos/actifs/maintenance-des-actifs)**

## 2. Comment créer la maintenance des actifs

Pour chaque actif, créez un enregistrement de maintenance des actifs répertoriant toutes les tâches de maintenance associées, le type de maintenance (maintenance préventive ou étalonnage), la périodicité, l'affectation et les dates de début et de fin de maintenance. En fonction de la date de début et de la périodicité, la prochaine date d'échéance est automatiquement calculée et une tâche est créée pour le cessionnaire.

1. Accédez à la liste Maintenance des actifs, **➕ Ajouter Maintenance des actifs**.
2. Sélectionnez l'**actif** et la **catégorie d'actif**.
3. Sélectionnez l'**équipe de maintenance des actifs**.
4. Ajoutez des **tâches de maintenance** dans le tableau.
5. Définissez le statut de maintenance, qu'il soit « Planifié », « En retard » ou « Annulé ».
6. Sélectionnez une périodicité pour laquelle la tâche doit être effectuée. La prochaine date d'échéance sera calculée.
7. **Enregistrer**.

![détails\_maintenance\_des\_actifs.png](https://doc.dokos.io/content/actifs/asset-maintenance/details_maintenance_des_actifs.png)

Après l'enregistrement, vous pouvez attribuer la tâche à un utilisateur.

## 3. Caractéristiques

### 3.1 Tâches d'entretien

- **Tâche de maintenance** : Qu'il s'agisse d'une activité de maintenance **préventive** ou d'un **étalonnage** pour restaurer un fonctionnement précis.
- **Statut d'entretien** : Prévu, En retard ou annulé
- **Périodicité** : Définissez la périodicité de la maintenance.
- **Attribuer à** : Indiquez à qui est attribuer la maintenance
- **Prochaine date d'échéance** : Si l'entretien n'a pas été effectué à la date prévue ou avant, la date réelle de l'entretien peut être enregistrée ici.

![tâches\_maintenance.png](https://doc.dokos.io/content/actifs/asset-maintenance/taches_maintenance.png)

### 3.2 Maintenance des actifs dans ToDo

Lors de l'attribution de la maintenance à un utilisateur, elle apparaîtra dans la liste des tâches de l'utilisateur.

# Équipe de Maintenance des Actifs

L'équipe de maintenance des actifs est responsable de l'exécution des activités de maintenance sur les actifs.

Les activités d'entretien peuvent être le nettoyage, le polissage, l'entretien ou toute autre activité requise pour maintenir l'actif en bon état.

---

Pour accéder à **la liste équipe de maintenance des actifs**, allez sur :

Accueil > Actifs > Maintenance > **Équipe de maintenance des actifs**

![liste\_équipe.png](https://doc.dokos.io/content/actifs/asset-maintenance-team/liste_equipe.png)

## 1. Prérequis avant utilisation

Avant de créer et d'utiliser Asset Maintenance Team, il est conseillé de créer d'abord les éléments suivants :

- **[Employé](https://doc.dokos.io/v5/dokos/hrms/cycle-de-vie/employee)**
- **[Actif](https://doc.dokos.io/v5/dokos/actifs)**

## 2. Comment créer une équipe de maintenance des actifs

1. Accédez à **la liste Équipe de maintenance des actifs*&#x2A;, **➕ Ajouter Équipe de maintenance**.
2. Saisissez un **nom** pour l'équipe.
3. Sélectionnez **un responsable** pour l'équipe.
4. Dans le **tableau** Équipe de l'équipe de maintenance, ajoutez **les membres de l'équipe** et sélectionnez leurs **rôles** de maintenance .
5. **Enregistrer**.

![détails\_équipe.png](https://doc.dokos.io/content/actifs/asset-maintenance-team/details_equipe.png)

## 3. Caractéristiques

### 3.1 Équipe

Dans cette section, indiquez les membres de l'équipe de maintenance. Ajoutez les différents champs qui sont :

- **Membre de l'équipe**
- **Nom complet**
- **Rôle de maintenance**

![liste\_équipe.png](https://doc.dokos.io/content/actifs/asset-maintenance-team/liste_equipe.png)

# Journal de Maintenance des Actifs

Le journal de maintenance des actifs enregistre les tâches effectuées dans une maintenance des actifs.

Pour chaque tâche dans Maintenance des actifs, le journal de maintenance des actifs est créé automatiquement pour suivre les maintenances à venir. Il aura un statut, une date d'achèvement et des actions effectuées. En fonction de la date d'achèvement ici, la prochaine date d'échéance est calculée automatiquement et un nouveau journal de maintenance des actifs est créé.

---

Pour accéder à **la liste journal de maintenance des actifs**, allez sur :

> Accueil > Actifs > Maintenance > **Journal de maintenance des actifs**

![journal\_de\_maintenance\_des\_actifs.png](https://doc.dokos.io/content/actifs/asset-maintenance-log/journal_de_maintenance_des_actifs.png)

## 1. Prérequis avant utilisation

Avant de créer et d'utiliser le journal de maintenance des actifs, il est conseillé de créer d'abord les éléments suivants :

- **[Maintenance des actifs](https://doc.dokos.io/v5/dokos/actifs/maintenance-des-actifs)**

## 2. Comment créer un journal de maintenance des actifs

1. Allez sur la la liste Journal de maintenance des actifs, cliquez sur **➕ Ajouter Journal de maintenance des actifs**.
2. Sélectionnez **Maintenance des actifs**
3. Renseignez les **détails de la maintenance**, la tâche, le type d'entretien, le statut, la date d'achèvement.
4. Indiquez les **Actions réalisées**
5. **Enregistrer**

![détails\_journal.png](https://doc.dokos.io/content/actifs/asset-maintenance-log/details_journal.png)

## 3. Caractéristiques

### 3.1 Détails de la maintenance

Dans cette section, indiquez toutes les informations de la maintenance.

- **Tâche** : Indiquez la nature de la tâche de maintenance.
- **Type d'entretien**
- A un certificat : Cochez la case si la maintenance à un certificat. Vous pouvez joindre le justificatif.
- **Statut d'entretien** : Prévu, Terminé, Annulé, En retard
- **Attribuer à**
- **Date d'achèvement**
- **Description**

![détails\_de\_la\_maintenance.png](https://doc.dokos.io/content/actifs/asset-maintenance-log/details_de_la_maintenance.png)

## 2. Options dans le journal de maintenance des actifs

Un brouillon du journal de maintenance des actifs est créé comme prévu dans le formulaire Maintenance des actifs. Afin de soumettre un journal de maintenance des actifs, le statut de maintenance des actifs doit être **Terminé** ou **Annulé**.

Le statut du journal de maintenance des actifs peut être **Planifié**, **Terminé**, **Annulé** ou **En retard**.

Des notes supplémentaires peuvent être ajoutées dans la section Actions effectuées pour décrire l'activité en détail.


# Demande de Matériel

Une **Demande de Matériel** est une demande interne pour acheter un produit. Elle peut être générée par un employé de l'entreprise ou automatiquement par le système en cas de rupture de stock.

Pour accéder à la **Demande de Matériel**, allez sur :

> Accueil > Stock > **Demande de Matériel**

## 1. Prérequis

Avant de créer une Demande de Matériel, assurez-vous d'avoir créé :

- Un [Article](https://doc.dokos.io/v5/dokos/parametrage/articles)
- Un [Fournisseur](https://doc.dokos.io/v5/dokos/parametrage/fournisseurs) (si le type est "Achat")

## 2. Comment créer une Demande de Matériel

### 2.1 Créer manuellement

1. Allez dans la liste **Demande de Matériel*&#x2A; et cliquez sur **➕Ajouter Demande de Matériel**.
2. Sélectionnez le **Type** :


   - **Achat** : Pour acheter des articles auprès d'un fournisseur.
   - **Transfert** : Pour transférer des articles entre entrepôts.
   - **Fabrication** : Pour produire des articles.
   - **Matériel pour un client** : Pour livrer directement un client (dropshipping).
3. Ajoutez les articles dans le tableau **Articles**.
4. Pour chaque article, spécifiez :


   - La **quantité demandée**.
   - L'**entrepôt** (si applicable).
   - La **date requise** pour la réception des articles.
5. Enregistrez et soumettez la Demande de Matériel.

### 2.2 Créer automatiquement

Une Demande de Matériel peut être générée automatiquement lorsque le niveau de stock d'un article atteint son **point de commande**. Pour activer cette fonctionnalité :

1. Allez dans la fiche **Article**.
2. Dans la section **Point de commande**, définissez :


   - Le **niveau de stock minimum** (point de commande).
   - L'**entrepôt** concerné.
3. Activez l'option **Générer une Demande de Matériel automatiquement**.

::callout{color="blue" icon="i-heroicons-light-bulb"}
**Exemple** : Si le stock de chaises dans l'entrepôt "Magasin Principal" descend en dessous de 10 unités, une Demande de Matériel sera automatiquement créée pour 20 chaises (quantité par défaut définie dans l'article).
::

## 3. Actions possibles sur une Demande de Matériel

### 3.1 Créer une Commande Fournisseur

Depuis une Demande de Matériel de type **Achat**, vous pouvez créer une ou plusieurs **Commandes Fournisseurs** en cliquant sur **Créer > Commande Fournisseur**.

Avec la nouvelle fonctionnalité, vous pouvez désormais :

1. **Sélectionner un fournisseur par article** :

   - Une boîte de dialogue s'affiche avec la liste des articles en attente de commande.
   - Chaque article affiche son **fournisseur par défaut** (issu de l'article, du groupe d'articles ou de la marque), ainsi que la **quantité en attente** et l'&#x2A;*unité de mesure (UOM)**.
2. **Modifier les fournisseurs et les quantités** :

   - Vous pouvez **changer le fournisseur** pour chaque article individuellement.
   - Un champ **Fournisseur** en haut de la boîte de dialogue permet de **remplir tous les articles avec le même fournisseur** en une seule action.
   - Les fournisseurs **désactivés** ou **barrés** (en raison de leur scorecard) ne sont pas disponibles dans la sélection.
   - La **quantité commandée** peut être ajustée, mais elle ne peut pas dépasser la quantité en attente.
3. **Sélectionner les articles à commander** :

   - Par défaut, tous les articles sont cochés. Vous pouvez **décocher** les articles que vous ne souhaitez pas commander pour le moment.
4. **Valider la création des commandes** :

   - Si tous les articles sélectionnés ont le **même fournisseur**, une seule **Commande fournisseur** est créée et ouverte directement.
   - Si les articles sélectionnés ont des **fournisseurs différents**, une **Commande fournisseur distincte** est créée pour chaque fournisseur. Un message s'affiche avec les liens vers chaque commande créée.

::mermaid
flowchart TD
A(Demande de Matériel) --> B\[Créer > Commande Fournisseur]
B --> C{Dialogue de sélection des fournisseurs}
C --> D\[Afficher les articles avec fournisseurs par défaut]
D --> E\[Modifier les fournisseurs/quantités si nécessaire]
E --> F\[Valider la sélection]
F --> G{Tous les articles ont le même fournisseur ?}
G -->|Oui| H\[Créer une seule Commande Fournisseur]
G -->|Non| I\[Créer une Commande Fournisseur par fournisseur]
I --> J\[Afficher les liens vers les commandes créées]

::

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
**Attention** :

- Si la **date requise** pour un article est déjà passée, la date du jour sera utilisée comme **date requise** dans la commande fournisseur, et un message d'avertissement s'affichera.
- Si vous tentez de créer une commande sans sélectionner d'articles, un message d'erreur s'affichera.
- Si une **Commande fournisseur** en brouillon existe déjà pour certains articles, un avertissement s'affichera avant la création de nouvelles commandes.
::

### 3.2 Autres actions

- **Créer un Appel d'offres** : Pour demander des devis à plusieurs fournisseurs.
- **Créer une Demande de Prix** : Pour obtenir des prix auprès de fournisseurs.
- **Créer une Demande de Transfert** : Pour transférer des articles entre entrepôts (si le type est "Transfert").
- **Créer un Ordre de Fabrication** : Pour produire des articles (si le type est "Fabrication").

## 4. Suivi des Demandes de Matériel

Vous pouvez suivre l'état d'avancement d'une Demande de Matériel via :

- Le **tableau de bord** de la Demande de Matériel, qui affiche les documents liés (Commandes Fournisseurs, Réceptions, etc.).
- Le **rapport des Demandes de Matériel**, accessible via **Accueil > Stock > Rapports > Demandes de Matériel**.

::callout{color="blue" icon="i-heroicons-light-bulb"}
**Astuce** : Utilisez le filtre **Statut** pour afficher uniquement les Demandes de Matériel en attente de traitement.
::


# Introduction

Que vous ayez un comptable dans votre équipe interne OU que vous le fassiez vous-même OU que vous ayez choisi de l'externaliser, le processus de comptabilité financière est au centre de tout système de gestion d'entreprise (alias un système ERP).

Dans Dokos, les opérations comptables se composent de 3 opérations principales :

- **Facture de vente**: Les factures que vous facturez à vos clients pour les produits ou services que vous fournissez.
- **Facture d'achat** : factures que vos fournisseurs vous remettent pour leurs produits ou services.
- **Écritures de journal** : pour les écritures comptables, comme les paiements, les crédits et d'autres types.

## 1. Données de base

- [1. Société](https://doc.dokos.io/v5/dokos/parametrage/societe)
- [2. Plan comptable](https://doc.dokos.io/v5/dokos/parametrage/plan-comptable)
- [3. Exercice fiscal](https://doc.dokos.io/v5/dokos/comptabilite/exercice-fiscal)
- [4. Dimension comptable](https://doc.dokos.io/v5/dokos/comptabilite/dimensions-comptables)
- [5. Journal Comptable](https://doc.dokos.io/v5/dokos/comptabilite/journal-comptable)
- [6. Période comptable](https://doc.dokos.io/v5/dokos/comptabilite/periode-comptable)

## 2. Grand livre

- [1. Grand livre](https://doc.dokos.io/v5/dokos/comptabilite/rapports/grand-livre)
- [2. Écriture de journal](https://doc.dokos.io/v5/dokos/comptabilite/ecriture-journal)

## 3. Comptes débiteurs

- [1. Facture de vente](https://doc.dokos.io/v5/dokos/ventes/facture-de-vente)
- [2. Ecriture de paiement](https://doc.dokos.io/v5/dokos/comptabilite/ecriture-paiements)
- [3. Demande de paiement](https://doc.dokos.io/v5/dokos/ventes/demande-de-paiement)

## 4. Comptes créditeurs

- [1. Ecriture de paiement](https://doc.dokos.io/v5/dokos/comptabilite/ecriture-paiements)

## 5. États financiers

- [1. Le Bilan](https://doc.dokos.io/v5/dokos/comptabilite/rapports/bilan)
- [2. Le Compte de résultat](https://doc.dokos.io/v5/dokos/comptabilite/rapports/compte-de-resultat)
- [3. La Balance générale](https://doc.dokos.io/v5/dokos/comptabilite/rapports/balance-generale)

## 6. Outils de migration

- [1. Outil de création d'ouverture de facture](https://doc.dokos.io/v5/dokos/comptabilite/ouverture-facture)

## Paramètres

- [1. Facture d'acompte](https://doc.dokos.io/v5/dokos/ventes/facture-de-vente#facture-dacompte)
- [2. Prélèvement Sepa](https://doc.dokos.io/v5/dokos/comptabilite/prelevement-sepa)
- [3. Passerelles de paiement](https://doc.dokos.io/v5/dokos/comptabilite/passerelles-paiements)
- [4. Rapprochement bancaire](https://doc.dokos.io/v5/dokos/comptabilite/rapprochement-bancaire)
- [5. Synchronisation bancaire](https://doc.dokos.io/v5/dokos/comptabilite/synchronisation-bancaire)

## France

- [1. Import FEC](https://doc.dokos.io/v5/dokos/comptabilite/import-fec)


# Passerelles de paiement

Les passerelles de paiement sont des documents permettant de créer un lien entre les documents de facturation et de paiement de Dokos et des intermédiaires de paiement comme Stripe, Braintree, GoCardless, Paypal, etc...

# Fonctionnement

::callout
Une nouvelle passerelle de paiement est automatiquement créée lorsque vous configurez une nouvelle intégration avec un intermédiaire de paiement dans Dokos. :br**Exemple**:br
Lorsque vous ajoutez un nouveau compte Stripe appelé `ABC`, une passerelle de paiement appelée `Stripe-ABC` est automatiquement créée dans dokos.
::

::callout
Une passerelle de paiement est ensuite liée à un ou plusieurs comptes comptable, un compte pour chaque devise utilisée pour payer. :br**Exemple**:br
Si vous souhaitez traiter des paiements en EUR ou USD, vous devez créer deux comptes de passerelle de paiement liés à votre passerelle de paiement:

- Un compte de passerelle de paiement avec la devise EUR, lié à un compte comptable en EUR
- Un compte de passerelle de paiement avec la devis USD, lié à un compte comptable en USD
::

Chaque fois qu'un paiement est effectué via cette passerelle de paiement, le système comptabilise l'écriture de paiement sur le bon compte de passerelle de paiement.

# Configuration

Il est possible de définir les éléments suivants pour chaque passerelle de paiement:

- Pour la génération automatique des écritures de paiement:

  - Un mode de paiement
  - Un compte de frais: Utilisé pour comptabiliser les frais prélevés par l'intermédiaire de paiement
  - Un compte de taxes: Pour certaines passerelles de paiement comme GoCardless qui ajoute la TVA déductible à leurs frais
  - Un centre de coût
- Pour le portail:

  - Un titre
  - Une icône

# Usage

Vous pouvez utiliser les passerelles de paiement dans deux grands cas:

1. Le règlement des factures que vous créez dans Dokos
   Cela passe par la création d'une demande de paiement suite à la génération d'une facture ou d'un abonnement. Vous pouvez autoriser plusieurs passerelle de paiement par demande de paiement

> **Exemple**
> Vous pouvez permettre à vos clients de payer par carte bancaire ou prélèvement SEPA

2. Le réglement des commandes passées sur le site web
   Dans ce cas, sélectionnez la passerelle de paiement à utiliser dans les [paramètres e-commerce](https://doc.dokos.io/v5/dokos/e-commerce/parametres).
   Pour le moment, une seule passerelle de paiement est utilisable sur le site web.

# Intégrations disponibles

## Gestion des abonnements + paiements uniques

- [Stripe](https://doc.dokos.io/v5/integrations/payments/stripe)
- [GoCardless](https://doc.dokos.io/v5/integrations/payments/gocardless)
- [Stancer](https://doc.dokos.io/v5/integrations/payments/stancer)

## Gestion des paiement uniques seulement

- Braintree
- Paypal
- Razorpay
- Paytm

# Versions de l'interface passerelle

Dokos prend en charge deux générations d'interface pour les passerelles de paiement :

- **v1 (legacy)** : comportement historique, chaque intégration gère sa propre logique d'initialisation.
- **v2 (PaymentController)** : nouvelle architecture centralisée introduite dans `frappe/payments`. Les passerelles v2 sont détectées automatiquement ; la Demande de paiement délègue alors à `PaymentController.initiate()` sans modifier le comportement des passerelles v1.

::callout{icon="i-heroicons-code-bracket"}
Si vous développez une nouvelle intégration de passerelle de paiement, consultez le guide technique [PaymentController v2](https://doc.dokos.io/v5/dodock/integrations/paiements/payment-controller-v2).
::


# Rapprochement bancaire

::callout{color="blue" icon="i-heroicons-arrow-path"}
Un **nouveau module bancaire unifié** est disponible, regroupant import, rapprochement et règles en une seule interface. Consultez la page [Nouveau module bancaire](https://doc.dokos.io/v5/dokos/comptabilite/nouveau-module-bancaire) pour en savoir plus.
::

# Transaction bancaire

Ce formulaire affiche les transactions bancaires dans Lyon.

## 1. Prérequis avant utilisation

Avant d'utiliser la saisie d'opérations bancaires, il est conseillé de créer d'abord les éléments suivants :

- **Banque**
- **Compte bancaire**

## 2. Comment utiliser la transaction bancaire

Habituellement, une transaction bancaire n'est pas destinée à être créée manuellement. Il est automatiquement créé à l'aide de du téléchargement du relevé bancaire depuis le **Rapprochement Bancaire**.

### 2.1 Champs supplémentaires dans Transaction bancaire

- **Date** : Date de l'opération bancaire.
- **Numéro de référence** : Référence de l'opération bancaire.
- **Compte bancaire** : Le compte bancaire à partir duquel les transactions ont été effectuées.

## 3. Caractéristiques / Champs

Ces champs sont mis à jour via le rapprochement bancaire et ne sont pas destinés à être modifiés à partir d'ici.

### 3.1 Devise et débit/crédit

- **Débit** : Le montant débité.
- **Crédit** : Le montant crédité.
- **Devise** : La devise dans laquelle la transaction a été effectuée.
- **Description** : une description de l'instruction.

### 3.2 Référence

Numéro de référence : Un chèque ou autre numéro de référence.

### 3.3 Saisies de paiement

- **Document de paiement** : Le document par rapport auquel la transaction a été effectuée, qu'il s'agisse d'une facture de vente, d'une note de frais, d'une facture d'achat, d'une écriture de paiement ou d'une écriture au journal.
- **Saisie de paiement** : La transaction spécifique.
- **Montant alloué** : Le montant alloué pour cette transaction particulière.
- \*\*Montant alloué \*\*: Le montant total alloué. Montant non alloué : Le montant total non alloué.

# Rapprochement bancaire

Le rapprochement bancaire sert à pointer les opérations enregistrées sur votre relevé bancaire avec les transactions enregistrées dans votre logiciel de gestion.

## 1. Comment importer ses relevés bancaires ?

::callout{color="teal" icon="i-heroicons-light-bulb"}
Le [nouveau module bancaire](https://doc.dokos.io/v5/dokos/comptabilite/nouveau-module-bancaire) propose un importateur intelligent prenant en charge les formats **CSV, XLSX, OFX et PDF** avec détection automatique des colonnes, sans configuration préalable. Il permet également d'importer des relevés PDF et d'ajuster le mapping de colonnes manuellement lorsque nécessaire.
::

### 1.1 Format OFX

1. Téléchargez votre relevé bancaire au format OFX.
2. Allez dans **Transaction Bancaire**, cliquez sur *Menu* et sélectionnez **Télécharger un relevé en OFX**
3. Téléchargez vos transactions

Avec le format OFX, Dokos ne créera pas de doublons, car chaque transaction est identifiée de manière unique.
Vous pouvez donc importer un fichier contenant des données déjà téléchargées.

### 1.2 Format CSV/XLSX

1. Sélectionnez la banque concernée par cet import dans la liste **Banque**
2. Dans la section *Configuration pour l'import de données*, créez un mapping entre les données d'en-tête de votre fichier CSV/XLSX et celles du type de document **Transaction Bancaire** de Dokos.
3. Téléchargez votre relevé bancaire au format CSV ou XLSX. Vérifiez que la ligne d'en-tête soit la première ligne du fichier.
4. Allez dans **Transaction Bancaire**, cliquez sur *Menu* et sélectionnez **Télécharger un relevé en csv/xlsx**
5. Téléchargez vos transactions

Avec le format XLSX/CSV, si le champ `reference_number` n'est pas renseigné, le logiciel ne pourra pas identifier distinctement les transactions et importera les doublons.

### 1.3 Importer manuellement les transactions bancaire

#### Détails de la transaction

1. Allez dans la **liste Transaction bancaire**, puis cliquer sur **Ajouter une Transaction bancaire**
2. Indiquez la date de la transaction qui apparaît sur votre compte bancaire
3. Renseignez le numéro de référence de la transaction
4. Choisissez la société concerné par cette transaction
5. Indiquez le compte bancaire

#### Montant de la transaction

Indiquez le montant de la transaction, soit au débit s'il s'agit d'une sortie, soit au crédit s'il s'agit d'une entrée.

Vous pouvez ajouter une description si besoin.

## 2. Rapprocher les lignes de relevé bancaire

> Ouvrez la page **Rapprochement bancaire**

1. Sélectionnez le compte bancaire concerné
2. **Sélectionnez la période** à l'aide du nouveau menu déroulant pour filtrer les transactions par plage de dates (ex: dernier mois, dernier trimestre, année en cours, ou plage personnalisée)
3. Sélectionnez une ou plusieurs transactions bancaires
4. Sélectionnez le type de transaction à rapprocher
5. Vérifiez que le montant des transactions bancaires correspond au montant des transactions du système
6. Cliquez sur **Rapprocher**

::callout{color="teal" icon="i-heroicons-light-bulb"}
Le nouveau menu déroulant de période permet de gagner du temps en évitant de saisir manuellement les dates de début et de fin. Par exemple, pour rapprocher les transactions du dernier mois, il suffit de sélectionner "Dernier mois" au lieu de chercher les dates exactes.
::

### 2.1 Spécificités

#### Rapprochement 1 <-> n / n <-> n

L'outil de rapprochement permet de rapprocher une ou plusieurs lignes du relevé bancaire avec une transaction dans Dokos (Ecriture de paiement, écriture de journal, ...)
Il permet également de rapprocher une ligne du relevé bancaire avec plusieurs transactions dans Dokos.
Par contre il ne permet pas de rapprocher plusieurs lignes du relevé bancaire avec plusieurs transactions en même temps.

::callout{color="teal" icon="i-heroicons-light-bulb"}
Si les options proposées par l'outil ne permettent pas de gérer certains cas de figures, vous pouvez toujours ouvrir la transaction et ajouter des lignes de rapprochement en allouant les montant rapprochés manuellement.
::

#### Création automatique de paiement

Si vous rapprochez une facture, Dokos va automatiquement créer le paiement correspondant.
Par contre si la devise de la facture n'est pas celle du compte bancaire, il faudra créer le paiement manuellement.

### 2.2 Rapprochement avec un Ordre de Paiement :badge{text="Dokos" type="warning"}

Il est désormais possible de rapprocher une transaction bancaire directement avec un **Ordre de Paiement** (document regroupant plusieurs paiements fournisseurs émis en une seule opération bancaire, par exemple un virement de masse).

#### Pourquoi utiliser cette option ?

Lorsque vous effectuez un virement groupé vers plusieurs fournisseurs via un Ordre de Paiement, votre banque enregistre une seule opération pour le montant total. Le rapprochement avec l'Ordre de Paiement permet de faire le lien direct entre cette ligne du relevé et l'ensemble des paiements qu'il regroupe, sans avoir à rapprocher chaque écriture individuellement.

#### Comment rapprocher un Ordre de Paiement ?

1. Ouvrez la page **Rapprochement bancaire**.
2. Sélectionnez le compte bancaire concerné.
3. **Sélectionnez la période** à l'aide du menu déroulant pour afficher uniquement les transactions pertinentes.
4. Cliquez sur la transaction bancaire correspondant au virement groupé.
5. Dans le panneau de correspondance, sélectionnez le type **Ordre de Paiement**.
6. Choisissez l'Ordre de Paiement dont le montant correspond au débit bancaire.
7. **Le nom du tiers (client ou fournisseur) associé à l'Ordre de Paiement s'affiche désormais dans la liste des documents correspondants**, facilitant l'identification du bon document.
8. Cliquez sur **Rapprocher**.

Dokos met à jour l'Ordre de Paiement et marque la transaction bancaire comme rapprochée.

> **Exemple — Bureau Moderne**
> La comptable émet un Ordre de Paiement regroupant trois virements fournisseurs pour un total de 4 750 €. Le lendemain, le relevé bancaire affiche un débit unique de 4 750 €. Elle sélectionne cette transaction, choisit le type **Ordre de Paiement** dans le panneau et voit immédiatement s'afficher le nom du fournisseur principal (ex: "Bureau Moderne") à côté de chaque Ordre de Paiement correspondant. Elle sélectionne l'ordre adéquat et rapproche la transaction en un clic.

#### Flux de rapprochement avec un Ordre de Paiement

::mermaid
flowchart LR
A\[Ordre de Paiement
groupant N virements fournisseurs] --> B\[Virement émis
vers la banque]
B --> C\[Transaction bancaire
Débit unique sur le relevé]
C --> D\[Rapprochement bancaire]
D --> E{Type sélectionné}
E -- Ordre de Paiement --> F\[Association directe
Ordre de Paiement ↔ Transaction
\+ Affichage du nom du tiers]
E -- Écriture de paiement --> G\[Association classique
Ecriture ↔ Transaction]
F --> H\[Transaction rapprochée]
G --> H

::

### 2.3 Rapprochement automatique

#### Stripe

Si vous utilisez la passerelle de paiement Stripe, Dokos peut rapprocher vos paiements avec les versements effectués par Stripe sur votre compte bancaire.
Il suffit pour cela de renseigner l'identifiant de "Charge" Stripe dans le champ "Chèque/N° de référence" de l'écriture de paiement.

#### Nom du document

Si vous demandez à vos clients de mettre le numéro de facture dans les références de virement, Dokos peut alors faire le rapprochement automatiquement lorsque vous cliquez sur "Rapprochement automatique"

La détection du numéro de facture dans la description ou la référence de la transaction bancaire est **insensible à la casse** : que le donneur d'ordre ait saisi `FAC-2605-0006`, `fac-2605-0006` ou `Fac-2605-0006`, Dokos reconnaît la facture et effectue le rapprochement.

> **Exemple — Maison Verte SARL**
> Un virement reçu contient la description `paiement fac-2605-0006`. Dokos identifie automatiquement la facture `FAC-2605-0006` et propose le rapprochement, même si la casse diffère du préfixe configuré dans la série de nommage.

#### Options locales

La méthode **regional\_reconciliation** permet de configurer des méthodes de rapprochement spécifiques à certaines régions.

##### Suisse

Vous pouvez ajouter un champ **esr\_reference** dans vos factures pour que Dokos les rapproche automatiquement sur la base du numéro ESR.

#### Hook

Le hook **auto\_reconciliation\_methods** permet de créer vos propres méthodes de rapprochement automatique dans une application personnalisée.

## 3. Filtrer par période pour un rapprochement plus efficace

La nouvelle fonctionnalité de sélection de période vous permet de :

- **Gagner du temps** : Plus besoin de saisir manuellement les dates de début et de fin pour chaque session de rapprochement.
- **Cibler vos recherches** : Limitez l'affichage aux transactions d'une période spécifique (ex: dernier mois, trimestre en cours) pour éviter de parcourir des centaines de lignes.
- **Simplifier les rapprochements récurrents** : Pour les rapprochements mensuels, sélectionnez simplement "Dernier mois" au lieu de calculer les dates.

### 3.1 Périodes prédéfinies disponibles

Le menu déroulant propose les options suivantes :

- **Aujourd'hui** : Transactions du jour courant
- **Hier** : Transactions de la veille
- **Cette semaine** : Du lundi au dimanche de la semaine en cours
- **Semaine dernière** : Du lundi au dimanche de la semaine précédente
- **Dernier mois** : Transactions du mois civil précédent (ex: si nous sommes en avril, affiche les transactions de mars)
- **Ce mois-ci** : Transactions du mois en cours
- **Dernier trimestre** : Transactions du trimestre civil précédent
- **Ce trimestre** : Transactions du trimestre en cours
- **Cette année** : Transactions de l'année civile en cours
- **Plage personnalisée** : Permet de définir des dates de début et de fin spécifiques

> **Exemple — Maison Verte SARL**
> La comptable de Maison Verte doit rapprocher les transactions de mars. Au lieu de chercher les dates exactes du 1er au 31 mars, elle sélectionne simplement "Dernier mois" dans le menu déroulant. Dokos affiche automatiquement toutes les transactions non rapprochées de mars, ce qui lui fait gagner plusieurs minutes à chaque rapprochement mensuel.

### 3.2 Comment utiliser le filtre de période ?

1. Ouvrez la page **Rapprochement bancaire**
2. Sélectionnez votre compte bancaire
3. **Cliquez sur le menu déroulant "Période"** situé en haut de la liste des transactions
4. Choisissez la période qui correspond à votre besoin (ex: "Dernier mois" pour un rapprochement mensuel)
5. La liste des transactions se met automatiquement à jour pour afficher uniquement celles de la période sélectionnée
6. Procédez au rapprochement comme d'habitude

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Le filtre de période s'applique uniquement aux transactions **non rapprochées**. Les transactions déjà rapprochées ne seront pas affichées, même si elles appartiennent à la période sélectionnée.
::

## Correspondance par montant non réconcilié :badge{text="Dokos" type="warning"}

Dans ERPNext, l'outil de rapprochement ne propose en correspondance que les écritures de paiement sans date de rapprochement bancaire (champ `clearance_date` vide). Dans Dokos, ce filtre est remplacé par une condition sur le **montant non réconcilié** : seules les écritures dont le champ `unreconciled_amount` est non nul sont proposées.

Cette approche permet de rapprocher un paiement partiellement alloué avec une nouvelle transaction bancaire pour le solde restant, même si ce paiement a déjà une date de rapprochement.

> **Exemple — Dokompany**
> Un virement de 1 000 € est partiellement alloué à une facture de 700 €. Il reste 300 € à réconcilier. Dokos propose cette écriture dans la liste de correspondance pour la prochaine transaction bancaire correspondante — même si la première allocation a déjà été rapprochée.

## Détection de doublons lors de l'import et de la saisie :badge{text="Dokos" type="warning"}

Dokos applique deux contrôles automatiques pour éviter les doublons dans les transactions bancaires.

**À l'import (OFX ou CSV)** — si une transaction avec le même numéro de référence existe déjà pour ce compte bancaire, Dokos l'ignore silencieusement. Il est donc sans risque d'importer plusieurs fois le même fichier de relevé : les lignes déjà présentes ne sont pas dupliquées.

**En saisie manuelle** — si une transaction avec le même numéro de référence existe déjà pour ce compte bancaire, Dokos bloque la création et affiche une erreur. Si des transactions similaires existent (même date, même montant, même devise, même description), un message d'avertissement est affiché sans bloquer.

> **Exemple — Dokompany**
> Le comptable importe le relevé de janvier deux fois par erreur. Dokos ajoute les nouvelles lignes et ignore celles déjà présentes. En saisie manuelle d'un virement avec la référence "VIR-2024-001" déjà existante, Dokos refuse la création.

## 4. Affichage du nom du tiers dans les documents correspondants :badge{text="Nouveau" type="tip"}

Lors du rapprochement bancaire, Dokos affiche désormais le **nom du tiers** (client ou fournisseur) associé aux documents correspondants dans le panneau de correspondance. Cette amélioration facilite grandement l'identification des documents à rapprocher, surtout lorsque plusieurs documents ont des montants similaires.

### 4.1 Avantages

- **Gain de temps** : Plus besoin de vérifier manuellement chaque document pour identifier le bon tiers.
- **Réduction des erreurs** : Le nom du tiers visible directement dans la liste réduit les risques de rapprochement avec un mauvais document.
- **Expérience utilisateur améliorée** : L'interface est plus intuitive et conviviale, surtout pour les nouveaux utilisateurs.

### 4.2 Comment cela fonctionne-t-il ?

1. Lorsque vous sélectionnez une transaction bancaire dans le **Rapprochement bancaire**, Dokos recherche les documents correspondants (factures, paiements, ordres de paiement, etc.).
2. Pour chaque document trouvé, Dokos extrait le nom du tiers associé (client ou fournisseur).
3. Le nom du tiers s'affiche à côté du document dans le panneau de correspondance, sous la forme : :br`[Type de document] - [Nom du document] (Tiers : [Nom du tiers])`

> **Exemple — Maison Verte SARL**
> La comptable de Maison Verte doit rapprocher un virement de 1 500 €. Dans le panneau de correspondance, elle voit s'afficher :

- `Facture de vente - FAC-2025-0012 (Tiers : Maison Verte SARL)`
- `Facture de vente - FAC-2025-0015 (Tiers : Bureau Moderne)`
- `Écriture de paiement - PAI-2025-0045 (Tiers : Maison Verte SARL)`

Grâce à l'affichage du nom du tiers, elle identifie immédiatement que la facture `FAC-2025-0012` correspond au virement reçu et peut procéder au rapprochement en toute confiance.

### 4.3 Cas d'usage spécifiques

#### Rapprochement avec des Ordres de Paiement

Lors du rapprochement d'un **Ordre de Paiement**, le nom du fournisseur principal associé à l'ordre s'affiche dans la liste des documents correspondants. Cela est particulièrement utile pour les virements groupés, où plusieurs ordres peuvent avoir des montants similaires.

> **Exemple — Bureau Moderne**
> La comptable de Bureau Moderne émet deux Ordres de Paiement le même jour :

- Un ordre de 3 200 € pour le fournisseur "Fournitures de Bureau SARL"
- Un ordre de 3 250 € pour le fournisseur "Matériel Informatique Plus"

Le lendemain, elle voit deux débits de 3 200 € et 3 250 € sur son relevé bancaire. Grâce à l'affichage du nom du fournisseur dans le panneau de correspondance, elle identifie rapidement quel ordre correspond à quel débit et rapproche les transactions sans risque d'erreur.

#### Rapprochement de paiements clients

Pour les paiements clients, le nom du client s'affiche à côté de chaque facture ou écriture de paiement correspondante. Cela est particulièrement utile pour les entreprises ayant plusieurs clients avec des noms similaires ou des montants de facture identiques.

> **Exemple — Maison Verte SARL**
> Maison Verte SARL a deux clients avec des noms similaires : "Maison Verte Lyon" et "Maison Verte Paris". Les deux clients ont émis des paiements de 2 500 € le même jour. Grâce à l'affichage du nom complet du client dans le panneau de correspondance, la comptable peut distinguer facilement les deux paiements et les rapprocher avec les bonnes factures.

### 4.4 Flux amélioré avec affichage du nom du tiers

::mermaid
flowchart TD
A\[Transaction bancaire sélectionnée] --> B\[Recherche des documents correspondants]
B --> C\[Extraction du nom du tiers pour chaque document]
C --> D\[Affichage des documents avec nom du tiers dans le panneau]
D --> E\[Utilisateur identifie le bon document grâce au nom du tiers]
E --> F\[Rapprochement effectué]
::


# Synchronisation bancaire

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Cette intégration est uniquement disponible sur Dokos Cloud. :br
Pour les utilisateurs auto-hébergés,vous pouvez souscrire à un abonnement Plaid ou utiliser des imports de fichiers.
::

# Synchronisation Bancaire

Dans la nouvelle version 2.17 de Dokos, la synchronisation bancaire devient possible grâce à l'intégration Bridge powered by Bankin' qui vous permet de vous connecter à votre banque en toute sécurité.

- **Agréé par l'ACPR**
  Bridge est encadré par la Directive Européenne sur les services de paiement n°2 (DSP2) et respecte les règles préconisées par la CNIL.
- **Sécurisé**
  Bridge applique les mêmes standards de sécurité que les plus grandes banques internationales.
- **Privé**
  L’ensemble de vos données sont chiffrées et vos identifiants de connexion ne seront jamais partagées.

La synchronisation bancaire va permettre de récupérer quotidiennement et automatiquement sur le site de votre banque toutes les opérations passées sur votre compte.

Après avoir renseigné votre identifiant et mot de passe, le site se connectera à votre compte pour récupérer toute l’antériorité disponible. L’antériorité varie selon les banques de quelques semaines à quelques mois.

## 1. Comment configurer la synchronisation bancaire ?

1. Allez sur la liste **Banque**, ajoutez une nouvelle banque ou modifiez une banque déjà existante.
2. Cliquez sur le bouton **Connecter votre banque**
3. Vous allez être envoyé sur la page de connexion **/connect.bridgeap** pour sélectionner votre banque.
4. Une fois que vous avez sélectionné votre banque, vous allez devoir saisir vos identifiants de connexion.
5. Après avoir confirmé votre connexion, vous allez devoir mettre à jour les comptes bancaires pour récupérer toutes vos transactions.

- Cliquez sur **Synchronisation** et faites **Mettre à jour les comptes bancaires**.

6. Une fenêtre va s'ouvrir avec :

- Le **compte bancaire** qui sera affecté par les transcations.
- La **date de synchronisation** à indiquer
- Et faire **confirmer**.

Les transactions bancaires vont être importés sur votre compte.

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Si vous avez de nombreuses transactions qui doivent être importés, il faudra patienter quelques minutes. Pensez à rechargez Dokos en cliquant sur votre profil et sur Recharger.
::

## 2. Retrouvez toutes vos transactions bancaires

Une fois que vous avez mis à jour vos comptes, allez sur :

> Accueil > Comptabilité > Relevé bancaire > **Transaction bancaire**

Toutes les transactions sont maintenant importés automatiquement sur la liste des Transactions bancaires.

::callout{color="blue" icon="i-heroicons-information-circle"}
Les opérations bancaires futures (à venir) sont conservées en statut **En attente** dans la liste des transactions bancaires. Ces opérations ne sont pas définitivement enregistrées tant qu'elles n'ont pas été effectivement débitées ou créditées sur votre compte.

Lors des synchronisations suivantes, ces opérations sont automatiquement mises à jour : leur statut passe à **Rapproché** ou **Annulé** dès que Bridge confirme qu'elles ont été réalisées, et les soldes de votre compte sont recalculés en conséquence.
::

::callout{color="yellow" icon="i-heroicons-light-bulb"}
Vous pouvez visualiser ces opérations futures en filtrant la liste des transactions bancaires par le statut **En attente**. Cela vous permet d'anticiper les encaissements et décaissements à venir sans les intégrer définitivement dans votre comptabilité.
::

## 3. Catégories des transacations

Les catégories sont importés automatiquement depuis la base de données de Bridge.

Vous pouvez accéder à toutes ces catégories, en allant sur **Catégorie de transaction bancaire**.

Vous pouvez ajouter, modifier et supprimer des catégories.

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Si vous ajoutez manuellement des nouvelles catégories. Elles ne seront pas affectées automatiquement.
::


# Factures fournisseurs

Les factures fournisseurs représentent les factures reçues de vos partenaires commerciaux pour des achats de biens ou services. Dokos permet de les saisir manuellement, de les importer en masse, mais aussi de les générer automatiquement à partir de factures électroniques reçues.

## Réception de factures électroniques

Dokos peut recevoir des factures électroniques (e-invoices) via l'intégration avec une plateforme agréée. Lorsqu'une facture électronique est reçue et validée, Dokos crée automatiquement une facture fournisseur correspondante avec les informations extraites du fichier.

### Notification de l'équipe comptable

::callout{color="blue" icon="i-heroicons-bell-alert"}
**Nouvelle fonctionnalité** : Lorsqu'une facture fournisseur est créée automatiquement à partir d'une facture électronique reçue, une notification est envoyée à l'équipe comptable pour l'informer qu'une nouvelle facture a été générée et nécessite probablement une vérification.
::

Lorsqu'une nouvelle facture fournisseur est créée depuis une e-invoice, les membres de l'équipe comptable reçoivent une notification automatique. Cette notification permet à l'équipe de :

- **Vérifier les informations** extraites de la facture électronique (montant, fournisseur, date d'échéance)
- **Compléter ou corriger** les données si nécessaire avant la soumission
- **Assurer le rapprochement** avec les bons de commande ou les livraisons correspondants

### Exemple

> Le fournisseur **Bureau Moderne** envoie une facture électronique via la plateforme agréée. Dokos reçoit le fichier, l'analyse et crée une facture fournisseur brouillon. L'équipe comptable est immédiatement notifiée par e-mail et peut se rendre sur la facture pour vérifier que toutes les informations ont été correctement importées avant validation.

Cette notification automatique évite que les factures électroniques reçues ne restent en attente sans traitement et permet un suivi en temps réel des factures à vérifier.

::callout{color="gray" icon="i-heroicons-information-circle"}
La notification est envoyée aux utilisateurs disposant des rôles appropriés dans la gestion des factures fournisseurs. Contactez votre administrateur si vous ne recevez pas ces notifications.
::


# Nouveau module bancaire

Le module bancaire de Dokos regroupe en un seul endroit toutes les fonctions liées à la gestion de vos relevés et au rapprochement : import de fichiers, correspondance automatique, création de paiements et règles de rapprochement. Il est accessible via le menu **Comptabilité → Module bancaire** ou directement à l'adresse `/banking`.

## 1. Prérequis

Avant d'utiliser le module bancaire, assurez-vous d'avoir créé :

- Au moins une **Banque** (menu *Comptabilité → Relevé bancaire → Banque*)
- Au moins un **Compte bancaire** associé à un compte du grand livre

## 2. Vue d'ensemble de l'interface

L'interface est organisée autour de trois zones principales :

::mermaid
flowchart LR
A\[Sélection de la société\net du compte bancaire] --> B\[Liste des transactions\nbancaires importées]
B --> C\[Panneau de correspondance\net de rapprochement]
C --> D\[Règles automatiques]

::

### 2.1 Sélection du compte

En haut de l'écran, choisissez :

- La **société** (ex. : Maison Verte SARL)
- Le **compte bancaire** à traiter
- La **période** concernée

Le solde du compte s'affiche en temps réel à côté du sélecteur.

### 2.2 Liste des transactions bancaires

Toutes les transactions importées apparaissent dans la colonne de gauche. Chaque ligne indique :

- La date et le libellé de l'opération
- Le montant (débit en rouge, crédit en vert)
- Le statut de rapprochement (non rapprochée, partiellement rapprochée, rapprochée)

### 2.3 Panneau de correspondance

En sélectionnant une ou plusieurs transactions, le panneau de droite affiche les écritures Dokos susceptibles de correspondre. Vous pouvez filtrer par type (factures, écritures de paiement, écritures de journal) et ajuster les critères de recherche.

## 3. Importer un relevé bancaire

### 3.1 Formats pris en charge

| Format | Détection automatique       | Gestion des doublons    |
| ------ | --------------------------- | ----------------------- |
| OFX    | Oui                         | Par identifiant unique  |
| CSV    | Oui (heuristique)           | Par numéro de référence |
| XLSX   | Oui (heuristique)           | Par numéro de référence |
| PDF    | Oui (détection de tableaux) | Par numéro de référence |

::callout{color="blue" icon="i-heroicons-information-circle"}
Comme pour les imports précédents, Dokos ne crée pas de doublons si le numéro de référence est présent dans le fichier. Vous pouvez importer plusieurs fois le même relevé sans risque.
::

### 3.2 Import automatique sans mapping

Le nouveau module intègre un importateur intelligent qui détecte automatiquement les colonnes du fichier dans la plupart des cas. Il n'est plus nécessaire de configurer un mapping colonne par colonne pour les formats courants.

1. Dans le module bancaire, cliquez sur **Importer un relevé**.
2. Glissez-déposez votre fichier CSV, XLSX, OFX ou PDF.
3. Dokos analyse les en-têtes et propose une correspondance automatique avec les champs *Date*, *Montant*, *Libellé*, *Référence*.
4. Vérifiez l'aperçu puis cliquez sur **Confirmer l'import**.

> **Exemple — Maison Verte SARL**:br
> Le comptable télécharge le relevé de mai de la Banque Populaire au format CSV. Dokos détecte les colonnes « Date opé. », « Libellé », « Débit euros », « Crédit euros » et propose le mapping en un clic. L'import crée 47 nouvelles transactions en quelques secondes.

### 3.3 Import avec mapping personnalisé (CSV et XLSX)

Si l'importateur automatique ne reconnaît pas les en-têtes, il est possible de définir manuellement la correspondance, et même de remplacer le mapping suggéré par défaut.

1. Sur l'écran d'aperçu, cliquez sur **Ajuster le mapping**.
2. Pour chaque colonne détectée, sélectionnez le champ Dokos correspondant.
3. Si la suggestion automatique ne convient pas, vous pouvez la remplacer colonne par colonne sans toucher aux autres.
4. Enregistrez le mapping sur la fiche **Banque** pour les prochains imports.

> **Exemple — Bureau Moderne**:br
> Le relevé de la Banque Postale utilise « Valeur » pour la date d'opération et « Opération » pour le libellé. Le comptable ajuste ces deux colonnes manuellement et enregistre le mapping sur la fiche Banque. Les imports suivants seront automatiquement correctement mappés.

### 3.4 Import de relevés au format PDF

Dokos peut désormais importer des relevés bancaires au format PDF, à condition que le fichier contienne du texte numérique (les scans ou images ne sont pas pris en charge).

#### Fonctionnement

1. Glissez-déposez votre fichier PDF dans l'écran d'import.
2. Si le PDF est protégé par un mot de passe, saisissez-le lorsque Dokos vous le demande.
3. Dokos analyse le document et **détecte automatiquement les tableaux** contenant les transactions.
4. Un aperçu du PDF s'affiche avec les zones de tableau mises en évidence.
5. Si la détection est imprécise, vous pouvez **déplacer ou redimensionner** les zones de tableau directement sur l'aperçu en les faisant glisser.
6. Une fois les tableaux validés, la logique de mapping de colonnes habituelle s'applique pour chaque tableau détecté.
7. Vérifiez l'aperçu des transactions puis cliquez sur **Confirmer l'import**.

::mermaid
flowchart TD
A\[Dépôt du fichier PDF] --> B{PDF protégé ?}
B -- Oui --> C\[Saisie du mot de passe]
B -- Non --> D\[Détection automatique des tableaux]
C --> D
D --> E\[Aperçu du PDF avec zones détectées]
E --> F{Détection correcte ?}
F -- Non --> G\[Ajustement manuel des zones\nglisser-déposer sur l'aperçu]
F -- Oui --> H\[Mapping des colonnes par tableau]
G --> H
H --> I\[Aperçu des transactions]
I --> J\[Confirmation de l'import]

::

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
L'import PDF fonctionne uniquement avec des fichiers contenant du texte sélectionnable. Les relevés scannés (images) ne sont pas pris en charge. Si votre banque ne fournit que des scans, utilisez le format CSV ou OFX.
::

> **Exemple — Maison Verte SARL**:br
> La comptable reçoit son relevé de juillet au format PDF depuis l'espace client de sa banque. Elle glisse le fichier dans l'écran d'import : Dokos détecte deux tableaux (un pour les débits, un pour les crédits) et affiche l'aperçu. Elle ajuste légèrement la zone du second tableau en la faisant glisser, puis valide. Les 23 transactions sont importées en quelques secondes.

#### PDFs avec plusieurs tableaux

Si le PDF contient plusieurs tableaux (par exemple un tableau par page ou un tableau séparé pour les débits et les crédits), Dokos les traite chacun indépendamment. Pour chaque tableau, vous pouvez ajuster le mapping de colonnes séparément avant de confirmer l'import.

## 4. Rapprocher les transactions

### 4.1 Correspondance manuelle

1. Cliquez sur une transaction bancaire dans la liste.
2. Le panneau de droite affiche les écritures Dokos dont le montant est proche.
3. Cochez une ou plusieurs écritures correspondantes.
4. Cliquez sur **Rapprocher**.

Le rapprochement 1↔n et n↔1 est pris en charge : vous pouvez associer une transaction bancaire à plusieurs écritures, ou plusieurs transactions à une seule écriture.

> **Exemple — Bureau Moderne**:br
> Un virement de 2 400 € correspond à deux factures de 1 200 € chacune. Sélectionnez la transaction, cochez les deux factures dans le panneau et cliquez sur **Rapprocher** : Dokos crée automatiquement les deux écritures de paiement.

### 4.2 Correspondance automatique

Cliquez sur **Rapprochement automatique** pour que Dokos analyse toutes les transactions non rapprochées et propose des correspondances sur la base :

- Du montant exact
- Du numéro de référence ou du numéro de document
- De la date (tolérance configurable)

Les correspondances trouvées sont présentées pour validation avant d'être confirmées.

### 4.3 Créer un paiement depuis une transaction

Si aucune écriture existante ne correspond (par exemple un prélèvement de charges), vous pouvez créer un paiement directement depuis la transaction :

1. Sélectionnez la transaction.
2. Cliquez sur **Enregistrer un paiement**.
3. Renseignez le tiers (client ou fournisseur), le compte de charge ou de produit.
4. Validez : Dokos crée l'écriture de paiement et rapproche immédiatement la transaction.

### 4.4 Créer un virement interne

Pour les mouvements entre comptes de la même société (ex. : virement du compte courant vers le compte d'épargne) :

1. Sélectionnez la transaction.
2. Cliquez sur **Enregistrer un virement**.
3. Choisissez le compte bancaire de destination.
4. Validez.

## 5. Règles de rapprochement automatique

Les règles permettent d'automatiser la correspondance des transactions récurrentes (loyers, abonnements, salaires…).

### 5.1 Créer une règle

1. Dans le module bancaire, ouvrez l'onglet **Règles**.
2. Cliquez sur **Nouvelle règle**.
3. Définissez les critères de déclenchement :


   - Contient / ne contient pas dans le libellé
   - Montant minimum / maximum
   - Sens de l'opération (débit ou crédit)
4. Définissez l'action :


   - Associer à un tiers (client ou fournisseur)
   - Imputer sur un compte comptable spécifique
   - Catégorie de transaction
5. Enregistrez.

> **Exemple — Maison Verte SARL**:br
> Chaque mois, un prélèvement de 350 € avec le libellé « LOYER BUREAUX » apparaît sur le relevé. Une règle est créée : si le libellé contient « LOYER BUREAUX » et que le montant est entre 340 € et 360 €, imputer sur le compte *Loyers et charges locatives* et associer au fournisseur *Bureau Moderne*. Dès lors, cette transaction est rapprochée automatiquement chaque mois.

### 5.2 Modifier ou désactiver une règle

Dans l'onglet **Règles**, cliquez sur une règle pour l'éditer ou utilisez le bouton bascule pour l'activer/désactiver sans la supprimer.

### 5.3 Priorité des règles

Les règles sont évaluées dans l'ordre d'affichage. Faites glisser les lignes pour modifier la priorité : la première règle dont les critères correspondent est appliquée.

## 6. Relevé de rapprochement et solde

### 6.1 Relevé de rapprochement bancaire

L'onglet **Relevé** affiche le solde théorique du compte (d'après Dokos), le solde réel (d'après les transactions importées) et la différence. Une liste détaille les écritures non encore rapprochées.

### 6.2 Entrées incorrectement pointées

Si une écriture a été rapprochée par erreur, sélectionnez la transaction concernée et cliquez sur **Annuler le rapprochement** pour revenir à l'état non rapproché.

## 7. Journal des actions

Chaque action dans le module bancaire (import, rapprochement, création de paiement, application de règle) est enregistrée dans le **Journal des actions**. Ce journal est accessible depuis l'icône en haut à droite de l'interface et permet de tracer qui a fait quoi et quand.

## 8. Relation avec les anciens outils

::callout{color="amber" icon="i-heroicons-arrow-path"}
Les outils *Rapprochement bancaire* (ancienne interface) et *Transaction bancaire* (liste classique) restent accessibles. Un bandeau dans ces anciennes pages invite à utiliser le nouveau module bancaire qui offre une expérience unifiée.
::

Les données sont identiques : les transactions créées ou rapprochées dans le nouveau module apparaissent bien dans la liste *Transaction bancaire* et vice-versa.

::mermaid
flowchart TD
A\[Import du relevé\nCSV / XLSX / OFX / PDF] --> B{Règle correspondante ?}
B -- Oui --> C\[Rapprochement automatique]
B -- Non --> D\[Liste des correspondances proposées]
D --> E{Écriture existante ?}
E -- Oui --> F\[Rapprochement manuel]
E -- Non --> G\[Création d'un paiement ou virement]
C --> H\[Transaction rapprochée]
F --> H
G --> H
::


# Prélèvement Sepa

La fonctionnalité de prélèvement Sepa de dokos permet de générer des fichiers Sepa XML que vous pouvez envoyer à votre banque afin de traiter plusieurs prélèvements en une seule fois.

## Pré-requis

### Paramètres

Avant de générer votre premier fichier XML, vous devez créer des paramètres de prélèvement Sepa pour chacune de vos sociétés.

Allez à `Comptabilité > Paramètres de prélèvement Sepa` et créez un nouveau document.

Enregistrez les éléments suivants:

- Votre identifiant créditeur
- Le nom de votre société tel qu'enregistré auprès de votre banque
- Le type d'instrument à utiliser: CORE (B2C) ou B2B
- Le schéma à utiliser pour générer le fichier XML. Cela peut être pain.008.001.02, pain.008.002.02 ou pain.008.003.02
- Le compte bancaire à utiliser pour enregistrer/filtrer les paiements correspondants dans dokos
- Un préfix pour la référence utilisée pour générer la description du débiteur

### Mandats Sepa

Afin de générer un fichier XML avec des données précises, vous devez créer un mandat Sepa pour chacun de vos clients.
Ce mandat doit avoir le statut `Actif` pour être considéré comme valide et vous devez inclure les éléments suivants:

- La date de création du mandat
- Un compte bancaire avec un IBAN et un numéro SWIFT/BIC valides

## Comment créer un fichier de prélèvement Sepa

1. Allez à `Comptabilité > Prélèvement Sepa` et créez un nouveau document.
2. Ajoutez une date de début et une date de fin pour la période que vous souhaitez exporter.
3. Vérifier la devise et ajoutez le mode de paiement à utiliser pour filtrer les paiements correspondants à cette période.
4. Cliquez sur `Obtenir les écritures de paiement`
5. Supprimez les écritures que vous ne souhaitez pas inclure dans votre fichier XML
6. Sélectionnez le type de prélèvement: `One-off, First, Recurrent` ou `Final`
7. Cochez la case `Prélèvement en lot` si c'est le cas
8. Enregistrez votre document
9. Cliquez sur `Générer un fichier XML`
10. Si votre fichier XML est correct, validez votre document pour figer votre écriture

::callout
Le prélèvement Sepa fonctionne selon des séquences:

- One off: Prélèvement unique
- First: Premier prélèvement d'une série
- Recurrent: Prélèvements consécutifs au premier d'une série
- Final: Dernier prélèvement d'une série
::

## Fonctionnalités

### Générer les paiements Sepa

Etant donné que vos clients sont déjà liés à un mandat Seap, vous pouvez vous attendre à n'avoir à générer que leurs factures tous les mois et à ce que dokos gère la création des écritures de paiement correspondantes automatiquement.

Lorsque vous êtes prêt·e à générer votre fichier Sepa XML, vous pouvez cliquer sur `Génerer les paiements Sepa` dans la barre d'outil pour que tous vos paiements soient générés automatiquement.

Le système récupère toutes les factures ouverts (impayées ou en retard) liées à un client avec un mandat valide (avec le statut `Actif`) pour la période sélectionnée et génère automatiquement un paiement pour chacune de ces factures.

### Inclure les écritures de paiement déjà inclues dans le fichier XML généré

Si vous avez besoin de générer un fichier avec des écritures qui ont déjà été validées et soumises dans un fichier XML précédent, vous pouvez cocher cette option pour qu'elles soient à nouveau récupérées.


# Exercice fiscale

Un exercice fiscal est utilisé pour enregistrer et déclarer les transactions de l'année.

Il est également appelé exercice financier ou exercice budgétaire. Il est utilisé pour le calcul des états financiers dans les entreprises et autres organisations. L'année fiscale peut être identique ou non à une année civile.

À des fins fiscales, les entreprises peuvent choisir d'être des contribuables de l'année civile ou des contribuables de l'année fiscale selon la juridiction. Dans de nombreuses juridictions, les lois réglementaires concernant la comptabilité et la fiscalité exigent de tels rapports une fois tous les douze mois. Cependant, il n'est pas obligatoire que la période soit une année civile (c'est-à-dire du 1er janvier au 31 décembre).

Un exercice fiscal commence généralement au début d'un trimestre, comme le 1er avril, le 1er juillet ou le 1er octobre. Cependant, l'exercice fiscal de la plupart des entreprises coïncide également avec l'année civile, qui commence le 1er janvier. plus simple et plus facile de cette façon. Pour certaines organisations, il y a des avantages à commencer l'exercice à un autre moment.

Par exemple, les entreprises saisonnières peuvent commencer leur exercice financier le 1er juillet ou le 1er octobre. Une entreprise qui a la plupart de ses revenus à l'automne et la plupart de ses dépenses au printemps peut également choisir de commencer son exercice financier le 1er octobre. De cette façon, ils savent quel sera leur revenu pour cette année-là et peuvent ajuster leurs dépenses pour maintenir les marges bénéficiaires souhaitées.

---

Pour accéder à la liste des années fiscales, allez sur :

> Accueil > Comptabilité > Paramétrage > **Exercice comptable**

## 1. Comment configurer l'année fiscale

1. Accédez à la liste des années fiscales.
2. Pour définir l'année fiscale par défaut, cliquez sur le bouton **Définir par défaut**.


# Période comptable

Une période comptable définit une période au cours de laquelle les états financiers sont enregistrés.

Dans Dokos, la période comptable est une période en dehors de laquelle les transactions soumises sélectionnées (telles que les factures de vente/d'achat, la saisie des stocks, la saisie de la paie, la saisie au journal, etc.) ne sont pas autorisées à être créées. En d'autres termes, les transactions sélectionnées ne peuvent être créées que dans la période comptable définie.

**Pourquoi la période comptable est-elle nécessaire ?**

Lorsque des transactions sont soumises, elles affectent les grands livres et les rapports qui traitent les données du grand livre. Cela peut poser des problèmes lorsque des rapports financiers doivent être générés pour audit par les autorités ou pour clôturer les livres comptables de l'exercice.

Ici, la période comptable peut être utilisée pour limiter la période pendant laquelle les transactions peuvent être soumises afin de préserver l'intégrité des rapports correspondants.

## 1. Comment créer une période comptable

### 1.1 À quoi sert l'option « Fermé » pour les transactions sélectionnées ?

L'option "Fermé" dans la table enfant pour les doctypes de transaction est utilisée pour sélectionner lesquels d'entre eux doivent être restreints après la fin de la période comptable.

Notez que si la période comptable se termine et si l'une des transactions sélectionnées dans la table enfant n'a pas la case "Fermé", alors elles ne seront pas restreintes après la fin de la période comptable.

1. Saisissez un **nom** pour la période comptable.
2. Définissez **une période** en définissant des **dates de début et de fin**.
3. **Ajouter** ou **supprimer** des transactions de la table. Notez que toutes les transactions répertoriées dans le tableau avec l'option "Fermé" cochée seront restreintes après la fin de la période comptable.
4. **Enregistrer**.
   Si vous essayez de soumettre une transaction fermée après la fin de sa période comptable, vous verrez une erreur de validation vous empêchant de le faire.

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
**Remarque** : aucun rôle ne peut soumettre les transactions définies dans la période comptable, même le rôle défini dans « Rôle autorisé à définir des comptes gelés et à modifier les entrées gelées » dans les paramètres du compte .
::


# Journaux comptables

::callout{color="teal" icon="i-heroicons-light-bulb"}
👉 v2
::

Les journaux comptables sont des journaux auxiliaires du grand livre.
Dokos permet la création d'autant de journaux que nécessaire à la tenue de votre comptabilité.

Vous pouvez forcer l'utilisation d'un journal comptable dans toutes vos transactions en cochant l'option "Comptabiliser toutes les transactions dans un journal comptable" dans les Paramètres des comptes.

### 1. Comment créer un journal comptable

`Comptabilité > Journal Comptable`

1. Choisissez un nom et un code pour votre journal comptable
2. Si votre journal est un journal de banque ou de caisse, sélectionnez le compte comptable associé
3. Ajoutez autant de lignes de conditions que nécessaire (voir-dessous)

::callout{color="teal" icon="i-heroicons-light-bulb"}
Généralement on recommande d'avoir au moins 4 journaux par défaut:

- Ventes
- Achats
- Trésorerie
- Opérations diverses

Il faut également décomposer le journal de trésorerie en autant de journaux que vous avez de comptes bancaires et de caisses
::

### 2. Les conditions

Chaque journal peut être associé avec une ou plusieurs transactions.

::callout{color="teal" icon="i-heroicons-light-bulb"}
Le journal "VENTES" va être associé au type de document "Facture de Ventes".
A chaque fois qu'une facture sera validée, les écritures comptables correspondantes seront enregistrées dans le journal des ventes.
::

Il est également possible d'ajouter une condition pour une transaction donnée.

::callout{color="teal" icon="i-heroicons-light-bulb"}
Le journal "AVOIRS" va être également associé au type de document "Facture de Ventes", avec la condition `doc.is_return`

Désormais lorsqu'une facture sera validée, elle sera enregistrée dans le journal "VENTES" et s'il s'agit d'un avoir il sera enregistré dans le journal "AVOIRS"
::

Les conditions doivent prendre la forme `doc.{nom du champ à valider}` et doivent retourner une valeur de type Vrai/Faux.

Exemples retournant le même résultat:

```text
doc.is_return
doc.is_return == 1
doc.is_return == True
```

### 3. Exemples

#### Journal d'A-Nouveaux

| Type de document    | Condition              |
| ------------------- | ---------------------- |
| Facture de vente    | doc.is\_opening=="Yes" |
| Facture d'achats    | doc.is\_opening=="Yes" |
| Ecriture de journal | doc.is\_opening=="Yes" |
| Ecriture de stock   | doc.is\_opening=="Yes" |

## 4. Numérotation séquentielle des écritures (AEN) :badge{text="Dokos" type="warning"}

Chaque écriture GL créée par Dokos reçoit automatiquement un **numéro d'écriture comptable séquentiel** (format `AEN-[exercice]-[numéro]`). Toutes les lignes d'une même transaction (facture, paiement, écriture de journal) partagent le même AEN, garantissant la traçabilité des mouvements groupés.

Cette numérotation est ininterrompue par exercice fiscal et ne peut pas être modifiée manuellement, ce qui facilite les contrôles et la production du Fichier des Écritures Comptables (FEC).

## 5. Journal unique obligatoire par transaction :badge{text="Dokos" type="warning"}

Dans les **Paramètres de comptabilité**, l'option **Forcer un journal unique par transaction** vérifie que toutes les écritures GL d'une même transaction appartiennent au même journal comptable. Si des journaux différents sont détectés, une erreur est levée avant la validation.

::dokos
Cette option se configure dans :

> Comptabilité > Paramètres de comptabilité > **Forcer un journal unique par transaction**
::

## 6. Journal comptable dans le Grand Livre :badge{text="Dokos" type="warning"}

Le rapport **Grand Livre** peut être filtré par journal comptable et affiche ce journal en colonne dans les résultats. Cela permet de consulter l'historique des écritures journal par journal, pour un rapprochement ou un contrôle ciblé.

> Comptabilité > Rapports > **Grand Livre** > filtre *Journal comptable*

## Voir aussi

- [Grand Livre](https://doc.dokos.io/v5/dokos/comptabilite/rapports/grand-livre)


# Modes de paiement

Dans les transactions de vente et d'achat, il existe différentes options pour régler le paiement. Nous pouvons le faire en espèces, par virement bancaire, par chèque etc.

Dans Dokos, vous pouvez créer un mode de paiement selon vos besoins. Dans la saisie de paiement, vous pouvez sélectionner le mode de paiement applicable.

Vous pouvez gérer les modes de paiement standards et en créer de nouveaux depuis :

> Comptabilité > Paramétrage > **Mode de paiement**

![mode-de-paiement.png](https://doc.dokos.io/content/comptabilite/mode-de-paiement.png)

Dans chaque fiche mode de paiement, vous pouvez également définir un compte de paiement par défaut. Lors de la sélection du mode de paiement, le compte de paiement respectif sera récupéré automatiquement dans la transaction.


# Compte bancaire

Dans Dokos, des comptes bancaires peuvent être créés pour une entreprise ainsi que pour d'autres parties telles que des clients, des fournisseurs, etc. Cela vous permet d'enregistrer correctement toutes les transactions bancaires pour une précision comptable.

Pour accéder au compte bancaire, allez sur :

> Accueil > Comptabilité > Relevé bancaire > **Compte bancaire**

## 1. Prérequis avant utilisation

Avant de créer et d'utiliser un compte bancaire, il est conseillé de créer d'abord ce qui suit :

## 2. Comment créer un compte bancaire

1. Entrez un nom de compte.
2. Associez le compte du grand livre défini dans "Comptes bancaires" dans le plan comptable .
3. Sélectionnez une banque.
4. Faites enregistrer.

### 2.1 Options supplémentaires lors de la création d'un compte bancaire

- **Est le compte par défaut** : l'activation de cette option l'utilisera comme compte bancaire par défaut pour toutes les transactions du journal.
- **Est un compte d'entreprise** : Activez si ce compte bancaire est un compte d'entreprise.

Un type de compte et un sous-type de compte peuvent être définis pour une classification plus poussée dans les rapports, etc.

## 3. Caractéristiques

### 3.1 Détails de la partie

- **Type de partie** : s'il ne s'agit pas d'un compte d'entreprise, définissez à qui appartient ce compte. Les options disponibles sont : Client, Employé, Membre, Actionnaire, Étudiant et Fournisseur.
- **Partie** : sélectionnez le client/fournisseur spécifique, etc.

### 3.2 Détails du compte

Pour référence, les détails suivants sur un compte bancaire peuvent être stockés dans Dokos :

- IBAN
- Numéro de Compte bancaire
- Numéro SWIFT
- Code de la branche

### 3.3 Adresse et contact

- Adresse : Une banque peut en avoir plusieurs dans une même localité. L'adresse de l'agence bancaire peut être définie ici.
- Contact : Une personne de contact peut être liée ici. Les banques fournissent généralement une personne de contact dédiée pour les comptes d'entreprise, vous pouvez ajouter le contact de cette personne ici.
- Site Web : Vous pouvez ajouter le site Web de la banque ici.

### 3.4 Détails de l'intégration

- **Date de la dernière intégration**: si votre banque prend en charge l'intégration Plaid , la définition d'une date ici se synchronisera sur la date définie. Cela créera des entrées de transactions bancaires.

# Banque

Dans Dokos, la sauvegarde de différentes banques vous permet de télécharger une feuille Excel et de mapper les transactions sur le grand livre. Les transactions sont créées en tant que transactions bancaires. Ceux-ci peuvent ensuite être utilisés à des fins de référence et de rapports. Cela se fait à l'aide du rapprochement bancaire .

Pour accéder à la banque, allez sur :

> Accueil > Comptabilité > Relevé bancaire > **Banque**

![banque.png](https://doc.dokos.io/content/comptabilite/banque.png)

## 1. Comment créer une banque ?

La création d'une banque est simple, allez dans la liste des banques, cliquez sur ajouter et entrez un nom de banque.

## 1.1 Configurer l'importation de données pour une banque

1. Sous « Champ dans la transaction bancaire », sélectionnez le champ à mettre à jour dans le formulaire « Saisie de transaction de relevé bancaire ».
2. Sous « Colonne dans le fichier bancaire », saisissez la colonne dans le fichier Excel exporté depuis la banque.


# Dimensions comptables

La comptabilité dimensionnelle signifie étiqueter chaque transaction avec des dimensions appropriées comme la succursale, l'unité commerciale, etc. Cela vous permet de maintenir chaque segment séparément, limitant ainsi la maintenance globale sur les comptes GL et votre plan comptable reste pur.

Centre de coûts et Projet sont traités comme des dimensions par défaut dans Dokos. Lors de la définition d'un champ dans la dimension comptable, ce champ sera ajouté dans les rapports de transactions, le cas échéant.

Dans Dokos, vous pouvez créer des dimensions comptables configurables et les utiliser dans les transactions et les rapports.

---

Pour accéder à la liste de la dimension comptable, allez sur :

> Accueil > Comptabilité > Paramètres > Dimensions de comptabilité

## 1. Comment créer une dimension comptable dans Dokos

1. Accédez à la liste Dimension comptable et cliquez sur Ajouter.
2. Sélectionnez le document de référence que vous souhaitez utiliser comme dimension personnalisée. Par exemple, si vous sélectionnez Service comme document de référence, la dimension sera basée sur Service.
3. Saisissez le nom de la dimension (Ce nom apparaîtra dans les transactions pour lesquelles des dimensions sont créées).
4. Dans le tableau Valeurs par défaut des dimensions, vous pouvez mentionner les dimensions par défaut spécifiques à l'entreprise, comme indiqué dans la capture d'écran ci-dessous. Cette dimension sera automatiquement récupérée dans la transaction avec cette société spécifique.
5. Cochez la case "Obligatoire" si vous souhaitez que la dimension soit obligatoire dans les transactions.


# Écriture de journal

Une écriture au journal est une écriture faite dans le grand livre général et elle indique les comptes concernés.

Une écriture de journal est une transaction polyvalente où les comptes de débit et de crédit peuvent être sélectionnés.

Tous les types d'écritures comptables autres que les transactions de vente et d'achat sont effectués à l'aide de l'écriture de journal . Une écriture de journal est une transaction comptable standard qui affecte plusieurs comptes et la somme des débits est égale à la somme des crédits. Une écriture de journal a un impact sur le grand livre.

Les écritures de journal peuvent être utilisées pour saisir des dépenses, des écritures d'ouverture, des écritures de contrepartie, des paiements bancaires, des écritures d'accise, etc. Par exemple, la réservation de dépenses courantes, les dépenses directes comme l'essence/le transport, les dépenses diverses, les écritures d'ajustement et l'ajustement du montant de la facture.

---

## 2. Caractéristiques

### 2.1 Écritures comptables

- **Dimensions comptables** : Un projet ou un centre de coûts peut être lié ici pour suivre le calcul des coûts séparément.
- **N° de compte bancaire** : Si vous avez ajouté un compte bancaire , le numéro associé à ce compte bancaire sera récupéré.
- **Type de référence** : Si cette écriture comptable est associée à une autre opération, elle peut être référencée ici. Sélectionnez le type de référence et sélectionnez le document spécifique. Par exemple, si vous créez une écriture de journal pour une facture de vente spécifique. Liez cette écriture au journal à la facture. Le montant « impayé » de cette facture sera affecté.

Voici les documents qui peuvent être sélectionnés dans l'écriture au journal sous Type de référence :

- Facture de vente
- Facture d'achat
- Entrée de journal
- Commande client
- Commande fournisseur
- Demande de remboursement
- Actif
- Prêter
- Saisie de la paie
- Avance des employés
- Réévaluation du taux de change
- Escompte de facture
- **Est-ce une avance ?** : S'il s'agit d'un paiement anticipé par un client, définissez cette option sur « Oui ». Ceci est utile lorsque vous avez lié un formulaire 'Type de référence' à cette écriture de journal. La sélection de « Oui » liera cette écriture au journal à la transaction sélectionnée dans le champ « Nom de la référence ». Pour en savoir plus, visitez la page Saisie des paiements anticipés .

#### Remarque et remarque personnalisée

Le champ **Remarque** affiche par défaut une description générée automatiquement par le système à partir des détails de la transaction (comptes concernés, références, montants). Cette génération automatique facilite le suivi et la traçabilité des écritures dans le grand livre.

Si vous souhaitez rédiger vous-même le texte de la remarque plutôt que de laisser le système le générer, cochez la case **Remarque personnalisée**. Le champ Remarque devient alors modifiable et vous pouvez y saisir librement votre propre texte. À l'enregistrement ou à la soumission, la génération automatique est ignorée et votre texte est conservé tel quel.

::callout{color="blue" icon="i-heroicons-information-circle"}
**Exemple** : Pour une écriture de régularisation de fin d'exercice, la comptable de Maison Verte SARL coche « Remarque personnalisée » et saisit « Charge à payer — loyer décembre 2025 — régularisation comptable » afin de retrouver facilement cette écriture lors de la révision des comptes.
::

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Si la case **Remarque personnalisée** n'est pas cochée, toute modification manuelle du champ Remarque sera écrasée lors de l'enregistrement, car le système régénère automatiquement la remarque à partir des données de la transaction.
::

### 2.2 Contrepasser l'écriture au journal

Dans toute entrée de journal soumise, il y a un bouton dédié pour inverser l'entrée de journal. En cliquant sur le bouton « Inverser l'écriture au journal », le système crée une nouvelle écriture au journal en annulant le montant du débit et du crédit sur les comptes respectifs.

### 2.3 Saisie des différences

La « différence » est la différence qui reste après la somme de tous les débits et crédits.

Conformément au système de comptabilité en partie double, le débit total doit être égal au crédit total.

Cela devrait être zéro si l'entrée de journal doit être « soumise ». Si ce nombre n'est pas zéro, vous pouvez cliquer sur « Saisir la différence » et le système ajoutera automatiquement une nouvelle ligne avec le montant requis pour que le total soit égal à zéro. Sélectionnez le compte à débiter/créditer et continuer.

### 2.4 Référence

Un numéro de référence peut être saisi manuellement et une date de référence peut être définie. En entrant un numéro de référence ici, une « Remarque » s'affichera, par exemple :

Dans la section Référence, les champs suivants peuvent être saisis manuellement si la facture a été enregistrée hors ligne et non dans le système Dokos. Ceci est uniquement à des fins de référence.

### 2.5 Saisies multi-devises

Si les comptes sélectionnés sont dans des devises différentes, cochez la case 'Multi Currency'. Si cette case n'est pas cochée, vous ne pourrez pas sélectionner de devises étrangères dans l'écriture de journal. Cela affichera les différentes devises et récupérera le « taux de change ». Pour en savoir plus, visitez la page Comptabilité multi-devises .

### 2.6 Modèle d'entrée de journal

À partir du champ du modèle : la sélection d'une option dans ce champ chargera les détails à partir d'un modèle d'entrée de journal.

Il récupérera et ajoutera les détails suivants à l'entrée :

- Type d'entrée
- Société
- Séries
- Comptes dans les écritures comptables

### 2.7 Paramètres d'impression

Pay To / Recd From : Le nom saisi ici apparaîtra sur la facture de vente. Ceci est utile pour imprimer des chèques. Accédez à la vue d'impression dans l'entrée de journal et sélectionnez le 'Format d'impression du chèque'.

#### En-tête de lettre

Vous pouvez imprimer votre entrée de journal sur le papier à en-tête de votre entreprise. En savoir plus ici .

#### Imprimer les en-têtes

Les entrées de journal peuvent également être intitulées différemment à des fins d'impression. Vous pouvez le faire en sélectionnant un en- tête d'impression . Pour créer de nouveaux en-têtes d'impression, accédez à :

Accueil > Paramètres > Impression > Imprimer l'en-tête

Lisez les titres d'impression pour en savoir plus.

### 2.8 Plus d'informations

- **Mode de paiement** : si le paiement a été effectué par virement bancaire, traite bancaire, carte de crédit, chèque ou espèces. De nouveaux modes de paiement peuvent également être créés. Si un compte bancaire est défini dans Mode de paiement, il sera récupéré ici lorsque le Mode de paiement est sélectionné.
- **Est en cours d'ouverture** : Si l'entrée de journal est de type « entrée d'ouverture », ce champ sera défini sur « Oui ». Pour en savoir plus, visitez la page Solde d'ouverture .
- **À partir d'un modèle** : Lorsqu'un modèle est sélectionné, le tableau 'Écritures comptables' sera d'abord vidé avant de charger les comptes à partir du modèle. Vous pouvez ajouter plus d'entrées de compte après cela.

## 3. Types d'entrées de journal

Jetons un coup d'œil à certaines des écritures comptables courantes qui peuvent être effectuées via Journal Entry dans Dokos.

### 3.1 Saisie du journal

Il s'agit d'un type d'entrée à usage général qui peut être utilisé à différentes fins. Voyons quelques exemples.

#### Dépenses (non cumulables)

Souvent, il n'est pas nécessaire de comptabiliser une dépense, mais elle peut être directement imputée sur un compte de dépenses lors du paiement. Par exemple, une indemnité de déplacement ou une facture de téléphone. Vous pouvez débiter directement les frais de téléphone (au lieu de votre opérateur téléphonique) et créditer votre banque lors du paiement.

- Débit : Compte de dépenses (comme les frais de téléphone).
- Crédit : Banque ou Compte Espèces.

#### Créditer les salaires

Pour créditer les salaires des employés, le type « Saisie du journal » est utilisé. Dans ce cas,

- Débit : Les éléments de salaire.
- Crédit : Le compte bancaire.

### 3.2 Saisie du journal inter-entreprise

Si une transaction a lieu entre une société mère et une société fille, ou des sociétés sœurs, ou deux sociétés appartenant au même groupe, cette option peut être utilisée pour faire une écriture au journal inter-sociétés.

Pour en savoir plus, visitez la page Inter Company Journal Entry .

### 3.3 Saisie bancaire

Utilisez ce type lorsque vous effectuez ou recevez un paiement à l'aide d'un compte bancaire . Par exemple, payer des frais de divertissement, etc. en utilisant le compte bancaire de la société.

### 3.4 Saisie des espèces

C'est la même chose que « Entrée bancaire », mais le paiement est effectué via un compte de trésorerie.

### 3.5 Saisie par carte de crédit

Il s'agit d'un type d'entrée permettant d'identifier facilement toutes les entrées de carte de crédit.

### 3.6 Note de débit

Il s'agit d'un document envoyé par un client (votre entreprise) à un fournisseur (votre fournisseur) lors du retour de marchandises/articles.

Vous pouvez également créer une note de débit directement à partir d'une facture d'achat.

« Note de débit » est établie pour un fournisseur contre une facture d'achat ou acceptée comme note de crédit du fournisseur lorsqu'une entreprise retourne des marchandises. Lorsqu'une Note de débit est émise, la Société peut soit recevoir un paiement du Fournisseur, soit ajuster le montant sur une autre facture.

- Débit : Compte fournisseur.
- Crédit : Compte de retour d'achat.

### 3.7 Note de crédit

Il s'agit d'un document envoyé par un fournisseur à un client lors du retour de marchandises/articles.

« Note de crédit » est faite pour un client contre une facture de vente lorsque la société doit ajuster un paiement pour les marchandises retournées. Lorsqu'une note de crédit est établie, le vendeur peut soit effectuer un paiement au client, soit ajuster le montant sur une autre facture.

- **Débit** : Compte de retour des ventes.
- **Crédit** : Compte client.

Une note de débit/crédit est généralement émise pour la valeur des marchandises retournées ou moins.

### 3.8 Contre-entrée

Une Contre-Entrée est comptabilisée lorsque la transaction est comptabilisée au sein d'une même Société de types :

- Espèces à Espèces
- Banque à Banque
- Espèces à la banque
- Banque en espèces

Ceci est utilisé pour enregistrer le retrait ou le dépôt d'argent d'un compte bancaire. Lorsque cette entrée est utilisée, l'argent ne quitte pas l'entreprise à moins qu'il ne soit à nouveau utilisé pour payer quelque chose.

## 3.9 Entrée d'accise

Lorsqu'une entreprise achète des marchandises à un fournisseur, l'entreprise paie des droits d'accise sur ces marchandises au fournisseur. Et lorsqu'une entreprise vend ces marchandises à des clients, elle perçoit des droits d'accise. La société déduira les droits d'accise à payer et le solde du dépôt au gouvernement. Compte.

Lorsqu'une entreprise achète des marchandises avec des droits d'accise :

- **Débit** : Compte d'achat, Compte de droits d'accise.
- **Crédit** : Compte fournisseur.

Lorsqu'une entreprise vend des marchandises avec droit d'accise :

- **Débit** : Compte client.
- **Crédit** : compte de vente, compte de droits d'accise.

### 3.10 Radiations ou créances irrécouvrables

Si vous annulez une facture en tant que créance irrécouvrable, vous pouvez créer un bon de journal similaire à un paiement, sauf qu'au lieu de débiter votre banque, vous pouvez débiter un compte de dépenses appelé créances irrécouvrables.

**Débit** : annulation de créances irrécouvrables
**Crédit** : client
Remarque : Il peut exister des réglementations dans votre pays avant de pouvoir radier les créances irrécouvrables.

### 3.11 Entrée d'ouverture

Cette entrée est utile lors du passage d'un autre logiciel à ERPNext à n'importe quel moment de l'année. Vos factures impayées, actions, etc. peuvent être enregistrées dans ERPNext à l'aide de ce type d'entrée. La sélection du type récupère les comptes de bilan.

### 3.12 Amortissement

L'amortissement est lorsque vous radiez une certaine valeur de vos actifs en tant que dépense. Par exemple, si vous avez un ordinateur que vous utiliserez pendant disons 5 ans, vous pouvez répartir ses dépenses sur la période et passer une écriture au journal à la fin de chaque année en réduisant sa valeur d'un certain pourcentage.

- **Débit** : Amortissement (Dépense).
- **Crédit** : Actif (le Compte sous lequel vous aviez comptabilisé l'actif à amortir).
  Pour en savoir plus, visitez la page Amortissement des actifs .

**Remarque** : Il peut exister des réglementations dans votre pays qui définissent le montant auquel vous pouvez déprécier une catégorie d'actifs.

### 3.13 Réévaluation du taux de change

Si votre plan comptable comporte des comptes avec plusieurs devises, une écriture au journal de type « Réévaluation du taux de change » aide à faire face à cette situation. Cette entrée est destinée à être créée à partir d'un formulaire de réévaluation du taux de change. Pour en savoir plus, visitez la page Réévaluation du taux de change .

# Modèle d'écriture de journal

Un modèle d'entrée de journal vous permet de définir et de sélectionner une liste prédéterminée de comptes et d'options lors de la création d'une entrée de journal.

---

Pour accéder au modèle d'entrée de journal, accédez à :

> Accueil > Comptabilité > Grand livre > **Modèle d'écriture au journal**

## 1. Comment créer et utiliser un modèle d'entrée de journal :

1. Accédez à la liste des modèles d'entrées de journal et cliquez sur Nouveau.
2. Ajoutez les détails suivants :

- Titre du modèle : il sera utilisé pour sélectionner le modèle dans l'entrée de journal.
- Société : Par défaut, la société définie dans Global Defaults est sélectionnée. Vous pouvez également sélectionner n'importe quelle autre entreprise.
- Type d'entrée : Vous pouvez sélectionner ici les types d'entrée disponibles dans Écriture au journal . La valeur par défaut est Écriture au journal .

Il y a 3 « types d'entrée » spéciaux dans ceci :

1. Saisie d'ouverture : Ceci obtiendra tous les comptes et les chargera dans le tableau "Ecritures comptables". Pour en savoir plus, visitez la page Solde d'ouverture .
2. Saisie bancaire : Ceci obtiendra et chargera le compte bancaire par défaut s'il est défini.
3. Cash Entry : Ceci obtiendra et chargera le compte de trésorerie par défaut s'il est défini.

- Est en cours d'ouverture : ce paramètre sera automatiquement défini sur « Oui » si « Entrée d'ouverture » ​​est sélectionné comme Type d'entrée.
- Séries : Vous pouvez choisir parmi une liste de séries de noms disponibles pour l'entrée de journal.
- Écritures comptables : Ici, vous pouvez sélectionner une liste de comptes à ajouter à l'écriture.

Enregistrez et accédez à l' entrée de journal et cliquez sur nouveau.

Dans le champ « À partir du modèle », lorsque vous sélectionnez le modèle, il chargera les comptes et les autres options qui y sont définies. Veuillez noter que cela effacera d'abord la table des écritures comptables, mais vous pouvez ajouter d'autres comptes à la table en dehors de ceux extraits du modèle.


# Écriture de paiement

Une écriture de paiement est un document enregistrant un paiement destiné à/ou provenant d'un tiers.

---

Une écriture de paiement peut également être créée directement puis liée à une commande/facture ultérieurement. Avant de créer et d'utiliser Saisie des paiements, il est conseillé de créer d'abord les éléments suivants :

- Client
- Fournisseur
- Compte bancaire

Si vous suivez le cycle de vente/d'achat, vous aurez besoin des éléments suivants :

- Commande client (paiement anticipé)
- Bon de commande (paiement anticipé)
- Facture de vente
- Facture d'achat

## 1. Comment créer une écriture de paiement

Pour accéder à la **liste des écriture de paiement**, allez sur :

> Accueil > Comptabilité > Comptes débiteurs > **Écriture de paiement**

Lors de la soumission d'un document permettant d'effectuer une saisie de paiement, vous trouverez l'option de paiement sous le bouton **Créer**.

### Type de Paiement

1. Indiquez une date de comptabilisation
2. Sélectionnez le type de Paiement : Entrant, Sortant, Interne
3. Choisissez le mode de paiement : Carte bancaire, Chèque, Espèce

### Paiement de/À

4. Type de tiers : Client, Fournisseur, Employé...
5. Sélectionnez le Tiers concerné

### Compte

Le compte payé à et le compte payé à partir de seront récupérés comme défini dans le formulaire de la société.

### Montant

Le montant payé sera extrait de la facture ou devra être saisi manuellement.

### Référence

Vous pouvez indiquez le document qui sera relié à cette écriture de paiement. Si vous être parti d'une facture, cette section sera renseignée automatiquement.

### Perte

- Montant Total Alloué
- Montant Non alloué
- Écrat de montant

## Comment enregistrer des frais associés à un paiement

Le tableau de déductions ou pertes permet d'enregistrer tout type de frais associés à un paiement.

> Une facture d'achat de $40 a été comptabilisée pour un montant de 36€ dans la devise de la société.
> Le paiement, plusieurs jours plus tard, est finalement de 37€.
> Dans l'écriture de paiement, le montant payé sera de 37€, le montant alloué à la facture de 36€ et dans le tableau de déductions on ajoute la ligne suivante:
>
> Compte: 666 - Pertes de change
> Montant: 1€

> Une facture de vente de 1000€ est payée via GoCardless, le montant réellement reçu est donc de 998€.
> Le montant payé dans l'écriture de paiement est donc de 998€
> Le montant alloué à la facture est de 1000€
> Dans le tableau de déduction on ajoute la ligne suivante:
>
> Compte: 6XXXXX - Frais GoCardless
> Montant: 2€

## Panneau de paiement rapide :badge{text="Dokos" type="warning"}

Sur une facture de vente ou d'achat soumise ayant un **encours impayé**, Dokos affiche un bouton **Paiement** qui ouvre un panneau latéral directement sur la fiche. Sans naviguer vers le formulaire d'écriture de paiement, l'utilisateur saisit :

- Le montant à encaisser/décaisser
- La date de comptabilisation
- Le mode de paiement
- La référence (numéro de chèque, virement…)

Le paiement est créé et soumis en un clic. Le mode de paiement renseigné sur la facture est repris automatiquement dans ce panneau.

::dokos
Le panneau de paiement rapide est une fonctionnalité propre à Dokos, non disponible dans ERPNext standard.
::

> **Exemple — Maison Verte SARL**
> Une facture de 1 200 € vient d'être validée. Le comptable clique sur "Paiement", saisit 1 200 €, sélectionne "Virement bancaire" et valide. L'écriture de paiement est créée et la facture passe en statut "Payée" sans quitter la fiche.

## Annulation d'une écriture de paiement rapprochée

Lorsqu'une écriture de paiement a déjà été **rapprochée avec une ou plusieurs transactions bancaires**, Dokos affiche une boîte de dialogue de confirmation avant de procéder à l'annulation.

Cette protection évite de rompre accidentellement le lien comptable entre le paiement et le relevé bancaire déjà pointé.

### Ce qui se passe lors de l'annulation

::mermaid
flowchart TD
A\[Clic sur Annuler] --> B{Le paiement est-il
lié à des transactions
bancaires rapprochées ?}
B -- Non --> C\[Annulation directe
sans confirmation]
B -- Oui --> D\[Boîte de dialogue
d'avertissement]
D --> E{Choix de l'utilisateur}
E -- Confirmer --> F\[Annulation du paiement
et suppression du rapprochement]
E -- Annuler --> G\[Retour au document
sans modification]

::

### Pourquoi ce comportement est important

Si vous annulez un paiement rapproché sans re-pointer la transaction bancaire correspondante, votre rapprochement bancaire affichera un écart entre le solde théorique (Dokos) et le solde réel (relevé bancaire). Il est donc recommandé de :

1. Prendre note des transactions bancaires liées avant de confirmer l'annulation.
2. Ouvrir le [Rapprochement bancaire](https://doc.dokos.io/v5/dokos/comptabilite/rapprochement-bancaire) ou le [Module bancaire](https://doc.dokos.io/v5/dokos/comptabilite/nouveau-module-bancaire) pour vérifier et corriger le statut des transactions concernées.

> **Exemple — Maison Verte SARL**
> Le comptable souhaite annuler un paiement de 850 € déjà rapproché avec un virement reçu sur le compte bancaire. En cliquant sur **Annuler**, Dokos affiche un message indiquant que ce paiement est lié à une transaction bancaire rapprochée et demande confirmation. Le comptable valide la confirmation, puis retourne dans le module bancaire pour dé-pointer la transaction concernée.

## Voir aussi

- [Factures d'acompte](https://doc.dokos.io/v5/dokos/comptabilite/acomptes)
- [Journaux comptables](https://doc.dokos.io/v5/dokos/comptabilite/journal-comptable)
- [Rapprochement bancaire](https://doc.dokos.io/v5/dokos/comptabilite/rapprochement-bancaire)


# Balance Générale

La balance générale est un document comptable qui permet de recenser l'ensemble comptes de l'entreprise au cours de l'exercice. Elle est notamment appréciée pour son apport synthétique et la vue d'ensemble qu'elle permet lors de la clôture des comptes. Elle fait partie des trois formes de balances comptables, avec la balance auxiliaire et la balance comptable âgée.

Dans Dokos, le rapport affiche les colonnes suivantes :

- Ouverture (Dr) : solde débiteur d'ouverture à la date de début
- Ouverture (Cr) : solde créditeur d'ouverture à la date de début
- Débit : montant total débité sur le compte entre la période sélectionnée
- Crédit : montant total crédité sur le compte entre la période sélectionnée
- Fermeture (Dr) : Solde débiteur de clôture comme à ce jour
- Fermeture (Cr) : Solde créditeur de clôture à ce jour

Il existe également d'autres options pour inclure ou exclure les écritures de clôture de période, afficher / masquer les comptes avec un solde nul et afficher les soldes du Compte de résultat (revenus et dépenses) non clôturés de l'exercice précédent. Tous les chiffres du rapport sont affichés dans la devise de base de l'entreprise.

## À quoi sert la balance générale ?

Fréquemment utilisée par les entreprises, la balance générale n'est toutefois pas un document obligatoire dans le cadre de l'audit. Elle est un outil de révision intéressant, permettant de bénéficier d'une vue générale de tous les comptes.

Véritable matière première en vue de la clôture des comptes, elle fait apparaître les soldes créditeurs et débiteurs sur la période de l'exercice. Elle met ainsi en lumière les dépenses et la trésorerie de l'entreprise, et permet de s'assurer de l'exactitude du bilan.

Elle est notamment utile pour suivre régulièrement la conformité des déclarations de TVA, et éviter ainsi un redressement fiscal.

## Que doit-on mettre dans la balance générale ?

Traditionnellement, elle est présentée sous forme de tableau sur une période donnée (année, semestre, trimestre, mois etc.) récapitulant tous les comptes mouvementés de l'entreprise.

Elle mentionne pour chaque compte :

- le libellé
- le total des débits,
- le total des crédits,
- le solde.

Contrairement à la balance auxiliaire, les soldes débiteurs et créditeurs doivent impérativement être équilibrés.

## Imprimer la balance générale

Dokos propose un format d'impression standardisé pour la balance générale, appelé **Trial Balance Standard**. Il permet de générer un document PDF ou papier directement depuis le rapport, sans configuration supplémentaire.

Le document imprimé contient :

- Le titre du rapport et le nom de la société
- La devise et la période sélectionnée
- Le tableau de la balance avec toutes les colonnes visibles (jusqu'à huit colonnes maximum), en gras pour les lignes de totaux
- La mention de la date et de l'heure d'impression en bas de page

Pour imprimer la balance générale :

1. Ouvrez le rapport **Balance Générale** (Comptabilité > États financiers > Balance Générale)
2. Appliquez les filtres souhaités (société, période, devise…)
3. Cliquez sur le bouton **Imprimer** en haut du rapport
4. Sélectionnez le format **Trial Balance Standard** si plusieurs formats sont disponibles
5. Générez le PDF ou lancez l'impression directement

> **Exemple — Maison Verte SARL**
> Avant de transmettre les comptes à l'expert-comptable, le responsable administratif de Maison Verte SARL imprime la balance générale de l'exercice. Le PDF généré liste tous les comptes mouvementés avec leurs soldes débiteurs et créditeurs d'ouverture et de clôture, prêt à être joint au dossier de révision.


# Le Bilan comptable

Le Bilan est un document qui décrit la &#x2A;*santé financière de l'entreprise, à un moment donné, en général la clôture des comptes annuels.**

Il permet de recenser &#x2A;*ce que l'entreprise possède (l'actif)** et ce qu'&#x2A;*elle doit (le passif)**, autrement dit les ressources engagées pour financer son actif (capital social, emprunts, …).

**Le bilan comptable est l'un des tableau le plus courant.**

D'autres tableaux existent tel le bilan prévisionnel en création d'entreprise, le bilan fonctionnel, le bilan financier.

Ces tableaux financiers ce basent tous sur le bilan comptable, néanmoins ils classent les éléments financiers de manière différente afin d'appuyer des situations financières spécifiques.
Il est bien souvent utilisé par des tiers, partenaires (banques, clients, comité de direction, actionnaires, …) pour connaitre la valeur de la société et assurer sa solvabilité.

Ce bilan permet aussi de déterminer le bénéfice imposable, et sert d'outils de pilotage pour mener des analyses internes. Afin de garantir la véracité des chiffres et leur transparence, les entreprises doivent généralement être certifiées par un commissaire aux comptes. Dans le langage courant, « faire un bilan », c'est recenser l'ensemble des éléments d'une situation donnée (positifs et négatifs) et en faire la synthèse. Il s'agit, plus précisément, de faire le point sur ce que l'entreprise possède, ce qu'elle doit, etc…

---

Pour accéder au **Bilan**, allez sur :

> Comptabilité > États financiers > **Bilan**

![bilan.png](https://doc.dokos.io/content/comptabilite/balance-sheet/bilan.png)

![bilan-suite.png](https://doc.dokos.io/content/comptabilite/balance-sheet/bilan-suite.png)

---

## Imprimer le bilan

Dokos propose un format d'impression standardisé pour le bilan, appelé **Balance Sheet Standard**. Il permet de générer un document PDF ou papier présentable directement depuis le rapport, sans configuration supplémentaire.

Le document imprimé contient :

- Le titre du rapport et le nom de la société
- La devise et la période sélectionnée
- Le tableau du bilan avec les niveaux d'indentation des groupes de comptes, en gras pour les totaux
- La mention de la date et de l'heure d'impression en bas de page

Pour imprimer le bilan :

1. Ouvrez le rapport **Bilan** (Comptabilité > États financiers > Bilan)
2. Appliquez les filtres souhaités (société, période, devise…)
3. Cliquez sur le bouton **Imprimer** en haut du rapport
4. Sélectionnez le format **Balance Sheet Standard** si plusieurs formats sont disponibles
5. Générez le PDF ou lancez l'impression directement

> **Exemple — Maison Verte SARL**
> En fin d'exercice, le comptable de Maison Verte SARL ouvre le bilan, sélectionne la période du 01/01/2025 au 31/12/2025, puis clique sur Imprimer. Le PDF généré affiche les actifs et passifs avec les sous-totaux en gras et la structure en niveaux, prêt à être transmis au commissaire aux comptes.

## Bilan au format français (Brut / Amortissements / Net) :badge{text="Dokos" type="warning"}

Pour les entreprises dont le pays est **France**, Dokos affiche automatiquement le bilan selon le format réglementaire du Plan Comptable Général : la dernière période présente trois colonnes distinctes plutôt qu'une seule colonne nette.

| Colonne                            | Contenu                                                       |
| ---------------------------------- | ------------------------------------------------------------- |
| **[Période] − Brut**               | Valeur brute des actifs, hors amortissements et dépréciations |
| **Amortissements − Dépréciations** | Cumul des amortissements et dépréciations enregistrés         |
| **[Période] − Net**                | Valeur nette comptable (Brut − Amortissements)                |

Les périodes précédentes continuent d'afficher uniquement la valeur nette, comme dans un bilan standard.

> **Exemple — Maison Verte SARL**
> Une immobilisation acquise pour 10 000 € avec 3 000 € d'amortissements cumulés apparaît sur la ligne correspondante avec 10 000 € en Brut, 3 000 € en Amortissements, et 7 000 € en Net.

## Comptes à catégorie alternative de bilan :badge{text="Dokos" type="warning"}

En comptabilité française, certains comptes peuvent figurer à l'actif ou au passif selon le sens de leur solde à la date de clôture. Par exemple, un compte courant d'associé peut être une dette (passif) si l'associé a prêté de l'argent à la société, ou une créance (actif) dans la situation inverse.

Dokos gère cette reclassification automatiquement grâce au champ **Catégorie alternative de bilan** sur les fiches de compte. Lorsqu'un compte présente un solde allant à l'encontre de sa catégorie principale, il est automatiquement déplacé vers la catégorie alternative définie, sans intervention manuelle.

::dokos
La catégorie alternative de bilan se configure sur la fiche du compte concerné, dans le plan comptable de la société.
::

## Bilan sur modèle personnalisé :badge{text="Dokos" type="warning"}

Il est possible de remplacer l'affichage standard du bilan par un **modèle de rapport financier** personnalisé. Sélectionnez votre modèle dans le filtre **Modèle de rapport** avant de lancer le rapport pour obtenir une présentation sur mesure de votre situation patrimoniale.

## Export Excel mis en forme

Lorsque vous exportez le Bilan au format Excel (XLSX), le fichier généré applique désormais automatiquement une **mise en forme visuelle** adaptée à la structure du rapport :

- Les lignes de **totaux et sous-totaux** apparaissent en **gras** pour les distinguer immédiatement des lignes de détail.
- Les **niveaux d'indentation** (groupes de comptes, sous-groupes, lignes de détail) sont respectés dans la mise en page.
- La **présentation horizontale** (Actif / Passif côte à côte) conserve sa mise en forme dans le fichier exporté.

Cette amélioration s'applique quelle que soit la présentation choisie — standard ou horizontale — et quel que soit le niveau de détail sélectionné (résumé ou détail par compte).

Pour exporter, cliquez sur le bouton **Télécharger** en haut du rapport, puis choisissez le format **Excel**.

## Voir aussi

- [Compte de résultat](https://doc.dokos.io/v5/dokos/comptabilite/rapports/compte-de-resultat)
- [Amortissement des actifs](https://doc.dokos.io/v5/dokos/actifs/depreciation-actif)


# Compte de résultat

**Le compte de résultat** est un document comptable où l'on retrouve le détail des **produits générés** (Comptes de classe 7) et des **charges consommées** (Comptes de classe 6) d'une entreprise au cours d'un exercice comptable.

Il reflète l'activité de l'entreprise et permet d'obtenir le résultat net (différence entre les produits et les charges). On sait alors si l'entreprise a fait un bénéfice ou un déficit.

Un compte de résultat contient deux éléments fondamentaux :

- **Les produits**
- **Les charges**

Un produit correspond à une recette (ventes), et une charge correspond à une dépense (achats de marchandises ou de services.

La nature des **produits** et des **charges** inclus dans le compte de résultat final peut être divisée en trois catégories : opérationnelle, financière et exceptionnelle.
Par conséquent, le compte de résultat final est déterminé par le total des résultats opérationnels, financiers et exceptionnels.

## Calcul des éléments comptables du compte de résultat

Les calculs des éléments du compte de résultat cités ci-dessus sont les suivants :

- Le **Résultat d'exploitation** = produits d'exploitation - charges d'exploitation
- Le **Résultat financier** = produits financiers - charges financières
- Le **Résultat exceptionnel** = produits exceptionnels - charges exceptionnelles
- Le **Résultat net comptable** = résultat d'exploitation + résultat financier + résultat exceptionnel - impôt sur les bénéfices - participation des salariés

Pour accéder au Compte de résultat, allez sur :

> Comptabilité > États financiers > **Compte de résultat**

![compte-de-resultat.png](https://doc.dokos.io/content/comptabilite/balance-sheet/compte-de-resultat.png)

## Imprimer le compte de résultat

Dokos propose un format d'impression standardisé pour le compte de résultat, appelé **P\&L Statement Standard**. Il permet de générer un document PDF ou papier présentable directement depuis le rapport.

Le document imprimé contient :

- Le titre du rapport et le nom de la société
- La devise et la période sélectionnée
- Le tableau des charges et produits avec les niveaux d'indentation des groupes de comptes, en gras pour les totaux
- La mention de la date et de l'heure d'impression en bas de page

Pour imprimer le compte de résultat :

1. Ouvrez le rapport **Compte de résultat** (Comptabilité > États financiers > Compte de résultat)
2. Appliquez les filtres souhaités (société, période, devise…)
3. Cliquez sur le bouton **Imprimer** en haut du rapport
4. Sélectionnez le format **P\&L Statement Standard** si plusieurs formats sont disponibles
5. Générez le PDF ou lancez l'impression directement

> **Exemple — Maison Verte SARL**
> En fin de trimestre, la direction de Maison Verte SARL souhaite présenter les résultats en réunion. Le comptable ouvre le compte de résultat, sélectionne la période du trimestre écoulé, clique sur Imprimer et obtient un PDF structuré avec les sous-totaux (résultat d'exploitation, résultat financier, résultat net) bien mis en évidence.

## Export Excel mis en forme

Lorsque vous exportez le Compte de résultat au format Excel (XLSX), le fichier généré applique désormais automatiquement une **mise en forme visuelle** fidèle à la structure du rapport :

- Les lignes de **totaux et sous-totaux** (résultat d'exploitation, résultat financier, résultat net…) sont affichées en **gras**.
- Les **niveaux d'indentation** des groupes de charges et de produits sont conservés dans le fichier Excel.
- La **présentation horizontale** (Charges / Produits côte à côte) conserve sa mise en forme lors de l'export.

Cette amélioration s'applique quelle que soit la présentation choisie — standard ou horizontale — et quel que soit le niveau de détail sélectionné.

Pour exporter, cliquez sur le bouton **Télécharger** en haut du rapport, puis choisissez le format **Excel**.


# Flux de trésorerie

Le **tableau des flux de trésorerie** (ou *cash flow statement*) est un état financier qui retrace l'ensemble des encaissements et décaissements de l'entreprise sur une période donnée. Il complète le bilan et le compte de résultat en indiquant comment l'entreprise génère et utilise ses liquidités.

Les flux sont classés en trois catégories :

- **Activités opérationnelles** : flux liés à l'exploitation courante (ventes, achats, charges de personnel…)
- **Activités d'investissement** : flux liés aux acquisitions et cessions d'immobilisations
- **Activités de financement** : flux liés aux emprunts, remboursements, apports en capital

Pour accéder au rapport, allez sur :

> Comptabilité > États financiers > **Flux de trésorerie**

## Imprimer le tableau des flux de trésorerie

Dokos propose un format d'impression standardisé pour le tableau des flux de trésorerie, appelé **Cash Flow Statement Standard**. Il permet de générer un document PDF ou papier directement depuis le rapport.

Le document imprimé contient :

- Le titre du rapport et le nom de la société
- La devise et la période sélectionnée
- Le tableau des flux organisé par catégories, avec les niveaux d'indentation et les totaux en gras
- La mention de la date et de l'heure d'impression en bas de page

Pour imprimer le tableau des flux de trésorerie :

1. Ouvrez le rapport **Flux de trésorerie** (Comptabilité > États financiers > Flux de trésorerie)
2. Appliquez les filtres souhaités (société, période, devise…)
3. Cliquez sur le bouton **Imprimer** en haut du rapport
4. Sélectionnez le format **Cash Flow Statement Standard** si plusieurs formats sont disponibles
5. Générez le PDF ou lancez l'impression directement

> **Exemple — Maison Verte SARL**
> Le directeur financier de Maison Verte SARL prépare un rapport pour le conseil d'administration. Il ouvre le tableau des flux de trésorerie, sélectionne l'exercice en cours, clique sur Imprimer et obtient un PDF structuré présentant clairement les flux opérationnels, d'investissement et de financement avec leurs totaux respectifs.

## Voir aussi

- [Bilan comptable](https://doc.dokos.io/v5/dokos/comptabilite/rapports/bilan)
- [Compte de résultat](https://doc.dokos.io/v5/dokos/comptabilite/rapports/compte-de-resultat)
- [Balance Générale](https://doc.dokos.io/v5/dokos/comptabilite/rapports/balance-generale)


# Grand Livre

Le Grand Livre est un rapport détaillé listant toutes les transactions enregistrées sur chaque compte. Pour chaque transaction, un compte est débité et un autre crédité, offrant une vue exhaustive de l'activité comptable.

Pour accéder au Grand Livre :

> Comptabilité > Rapports > **Grand Livre**

---

Le rapport peut être filtré par Compte, Centre de coût, Tiers, Projet, Période et bien d'autres critères. Les résultats peuvent être regroupés par compte, pièce justificative ou tiers, avec les soldes d'ouverture et de clôture pour chaque groupe. En comptabilité multidevise, les montants peuvent être affichés dans une autre devise que la devise de base.

## Filtre par journal comptable :badge{text="Dokos" type="warning"}

Dokos ajoute un filtre **Journal comptable** au Grand Livre. Ce filtre restreint l'affichage aux écritures appartenant à un journal spécifique (Ventes, Achats, Trésorerie, Opérations diverses…), et inclut la colonne **Journal comptable** dans les résultats.

> **Exemple — Maison Verte SARL**
> Le service comptable veut vérifier uniquement les écritures du journal "Ventes" pour le mois de mars. En sélectionnant ce journal dans le filtre, seules les factures de vente et avoirs apparaissent, sans les écritures de trésorerie ou d'achats.

## Impression du Grand Livre

Le Grand Livre dispose d'un **format d'impression standard** (« General Ledger Standard ») qui permet d'obtenir une version imprimable du rapport, adaptée aux besoins de contrôle et d'archivage comptable.

### Améliorations du modèle d'impression

Le modèle d'impression a été revu pour offrir une présentation plus claire et plus lisible :

- La colonne &#x2A;*« Détails de la pièce »** (anciennement « Particulars ») regroupe les informations sur chaque écriture : numéro de pièce, date, description et remarques.
- Les **soldes** affichent désormais un suffixe **D** (Débit) ou **C** (Crédit) selon le sens du solde, facilitant la lecture directe sans ambiguïté.
- La mise en forme générale (en-tête, titre, corps du tableau) a été standardisée pour une meilleure cohérence visuelle à l'impression.

> **Exemple — Bureau Moderne**
> Lors d'un contrôle de fin de mois, le responsable comptable imprime le Grand Livre du compte « Fournisseurs ». Chaque ligne affiche clairement le numéro de la pièce, le montant débité ou crédité, et le solde courant suivi de la mention « D » ou « C » pour indiquer sa nature.

### Utiliser le format d'impression

1. Exécutez le rapport **Grand Livre** avec les filtres souhaités.
2. Cliquez sur le bouton **Imprimer** en haut du rapport.
3. Sélectionnez le format **General Ledger Standard** si plusieurs formats sont disponibles.
4. Lancez l'impression ou exportez en PDF.

## Voir aussi

- [Journaux comptables](https://doc.dokos.io/v5/dokos/comptabilite/journal-comptable)
- [Balance générale](https://doc.dokos.io/v5/dokos/comptabilite/rapports/balance-generale)
- [Bilan](https://doc.dokos.io/v5/dokos/comptabilite/rapports/bilan)


# Factures d'acompte

Une facture d'acompte est une facture partielle émise avant la livraison ou la prestation, permettant d'encaisser un paiement anticipé. Dokos gère l'intégralité du cycle : création de la facture d'acompte, comptabilisation dans un compte d'avances, puis imputation automatique sur la facture définitive.

::dokos
Les factures d'acompte sont une fonctionnalité propre à Dokos, non disponible dans ERPNext standard.
::

## Créer une facture d'acompte :badge{text="Dokos" type="warning"}

Les factures d'acompte se créent directement depuis une **Commande client** ou une **Commande fournisseur** soumise.

> Commande client > **Créer > Facture d'acompte**

La facture générée est automatiquement marquée comme facture d'acompte. Les lignes de facturation sont regroupées **par taux de TVA** appliqué aux articles de la commande, garantissant une ventilation fiscale correcte quel que soit le nombre d'articles ou de taux de TVA.

> **Exemple — Maison Verte SARL**
> Une commande client de 5 000 € HT contient des articles à 20 % et des articles à 10 % de TVA. La facture d'acompte générée affichera deux lignes : une pour la base soumise à 20 % et une autre pour la base à 10 %, chacune avec le montant d'acompte correspondant.

::mermaid
flowchart LR
BC\["Commande client\nMaison Verte SARL\n5 000 € HT"] --> FA\["Facture d'acompte\ngroupe par taux TVA"]
FA --> PE\["Écriture de paiement\nrécupération de l'acompte"]
BC --> FF\["Facture finale\nsolde restant dû"]
FA --> FF
PE --> FF

::

## Comptabilisation des acomptes :badge{text="Dokos" type="warning"}

À la soumission d'une facture d'acompte, les écritures comptables utilisent le **compte d'avances reçues** (client) ou **avances versées** (fournisseur) configuré sur la fiche société, à la place du compte client ou fournisseur habituel.

### Option : comptabilisation en compte de passif séparé

Dans les **Paramètres de comptabilité**, l'option **Comptabiliser les avances en compte de passif séparé** permet d'enregistrer les paiements reçus sur commande dans un compte de passif dédié, distinct du compte client ordinaire.

Lorsqu'un paiement est créé depuis une commande (sans facture associée), le système bascule automatiquement vers ce compte d'avance. Une notification informe l'utilisateur du changement de compte.

::dokos
Cette option se configure dans :

> Comptabilité > Paramètres de comptabilité > **Comptabiliser les avances en compte de passif séparé**
::

## Réconciliation sur la facture finale :badge{text="Dokos" type="warning"}

Lors de la création de la facture définitive, les acomptes précédemment encaissés apparaissent dans la section **Avances** de la facture. L'utilisateur sélectionne les acomptes à imputer ; le système ajuste les écritures GL pour n'enregistrer que le solde restant dû, évitant tout doublon comptable.

> **Exemple — Maison Verte SARL**
> Acompte de 1 500 € encaissé en janvier. Facture finale de 5 000 € émise en mars. Après imputation de l'acompte, la facture finale affiche un solde dû de 3 500 €, et les écritures comptables reflètent exactement ce solde.

::demo-link{demo="Dokompany" doctype="Sales Invoice"}
Voir les factures de vente dans la démo
::

## Voir aussi

- [Écriture de paiement](https://doc.dokos.io/v5/dokos/comptabilite/ecriture-paiements)
- [Commande client](https://doc.dokos.io/v5/dokos/ventes/commande-client)
- [Journaux comptables](https://doc.dokos.io/v5/dokos/comptabilite/journal-comptable)


# Catégories de taxes

Les catégories de taxes permettent de différencier le traitement comptable et fiscal de vos clients et fournisseurs selon leur statut : entreprise assujettie, particulier, opérateur intracommunautaire, association, etc. Une catégorie de taxes peut influer à la fois sur le **compte comptable tiers** utilisé et sur le **modèle de taxe** appliqué automatiquement dans les transactions.

::dokos
Le lien entre catégorie de taxes et compte tiers dynamique est une fonctionnalité propre à Dokos, non disponible dans ERPNext standard.
::

## Compte comptable tiers selon la catégorie de taxes :badge{text="Dokos" type="warning"}

Dans le plan comptable français, il est courant d'utiliser des comptes clients différents selon la nature du tiers : 411000 pour les clients standard, 411100 pour les clients intracomm, 411200 pour les clients hors UE, etc. Dokos permet de configurer cette correspondance directement sur la catégorie de taxes.

Lors de la saisie d'une transaction, le système détermine automatiquement le bon compte tiers en fonction de la catégorie de taxes renseignée sur le document (héritée du client ou fournisseur), sans que l'utilisateur ait à le sélectionner manuellement.

> **Exemple — Maison Verte SARL**
> Les clients français standard utilisent le compte 411000. Les clients intracommunautaires ont la catégorie de taxes "UE" mappée sur le compte 411100. Lors de la création d'une facture pour un client UE, le compte 411100 est sélectionné automatiquement.

::mermaid
flowchart LR
CLI\["Client\nCatégorie de taxes: UE"] --> TXN\["Facture de vente"]
TXN --> |"Résolution automatique"| CPT\["Compte 411100\nClients intracommunautaires"]
CLI2\["Client\nCatégorie de taxes: Standard"] --> TXN2\["Facture de vente"]
TXN2 --> |"Résolution automatique"| CPT2\["Compte 411000\nClients France"]

::

## Modèle de taxe selon la catégorie de taxes :badge{text="Dokos" type="warning"}

Les règles de taxe dans Dokos peuvent être conditionnées par la catégorie de taxes du document. Lors du calcul des taxes, le système évalue la catégorie de taxes pour sélectionner le template approprié.

> **Exemple — Maison Verte SARL**
> Un client intracommunautaire (catégorie "UE") déclenche automatiquement le modèle "TVA 0 % intracomm" à la place du modèle "TVA 20 %". Aucune intervention manuelle sur le champ taxe n'est nécessaire.

## Détermination de la catégorie de taxes depuis l'adresse

Dans les **Paramètres de comptabilité**, le paramètre **Déterminer la catégorie de taxe d'adresse à partir de** indique si c'est l'adresse de livraison ou l'adresse de facturation qui est utilisée pour déduire la catégorie de taxes applicable sur le document.

## Configurer une catégorie de taxes

> Comptabilité > Configuration > **Catégorie de taxes**

1. Créez une catégorie (ex. "Intracommunautaire", "Hors UE", "Association")
2. Sur chaque compte client ou fournisseur concerné dans votre plan comptable, associez la catégorie de taxes correspondante
3. Affectez la catégorie de taxes sur les fiches **Client** ou **Fournisseur** concernées

::demo-link{demo="Dokompany" doctype="Tax Category"}
Voir les catégories de taxes dans la démo
::

## Voir aussi

- [Plan comptable](https://doc.dokos.io/v5/dokos/parametrage/plan-comptable)
- [Clients](https://doc.dokos.io/v5/dokos/parametrage/clients)
- [Fournisseurs](https://doc.dokos.io/v5/dokos/parametrage/fournisseurs)


# Import FEC

L'import FEC permet de migrer les données comptables d'un logiciel précédent vers Dokos en chargeant un Fichier des Écritures Comptables. Dokos reconstruit automatiquement la structure comptable — comptes, journaux, tiers — puis crée les documents comptables correspondants : factures de vente, factures d'achat ou écritures de journal.

Cette fonctionnalité est particulièrement utile lors d'un changement de logiciel en cours d'exercice, ou pour reprendre l'historique comptable d'une entreprise sans ressaisie manuelle.

---

Pour accéder à l'import FEC, allez sur :

> Accueil > Comptabilité > France > **Import FEC**

## Flux d'import

::mermaid
graph TD
A\[Fichier FEC .txt] --> B\[Import FEC]
B --> C{Paramètres d'import}
C --> D\[Création comptes manquants]
C --> E\[Création journaux comptables]
D & E --> F\[Documents d'import FEC]
F --> G{Type d'écriture}
G -->|Transaction client| H\[Facture de vente]
G -->|Transaction fournisseur| I\[Facture d'achat]
G -->|Banque / Divers| J\[Écriture de journal]
H & I & J --> K\[Rapprochement automatique]

::

## Configuration préalable : paramètres d'import

Avant le premier import, il faut créer un document de **Paramètres d'import FEC** pour la société concernée. Ce document définit comment Dokos doit interpréter et transformer les données du fichier.

Pour accéder aux paramètres, allez sur :

> Accueil > Comptabilité > France > **Paramètres d'import FEC**

### Correspondance des journaux comptables

Si les codes journaux du fichier FEC ne correspondent pas exactement aux codes des journaux Dokos, le tableau de correspondance permet de les mapper manuellement.

> **Exemple**
> Le fichier FEC contient le code journal « VT » mais le journal Dokos s'appelle « VTE ». La correspondance `VT → VTE` évite que Dokos rejette ces écritures.

### Création de factures ou d'écritures de journal

Par défaut, toutes les écritures sont importées comme écritures de journal. Pour une migration plus complète, Dokos peut créer des factures de vente et/ou d'achat lorsque l'écriture implique un tiers client ou fournisseur.

Si cette option est activée, un article générique doit être sélectionné pour les lignes de facturation (les données du FEC ne contiennent pas de références article).

### Soumission automatique

Dokos peut valider automatiquement les documents créés à l'import. Si cette option est désactivée, les documents restent en brouillon pour validation manuelle.

### Groupe client / fournisseur par défaut

Quand l'import crée un nouveau client ou fournisseur, Dokos l'affecte au groupe et au territoire définis ici.

## Préparer l'import

### Étape 1 — Créer les journaux comptables

Avant d'importer les écritures, les journaux comptables du fichier FEC doivent exister dans Dokos. Le bouton **Créer les journaux** analyse le fichier et crée automatiquement les journaux manquants, en déterminant leur type :

- **Banque** si le journal contient des comptes en 512
- **Caisse** si le journal contient des comptes en 53
- **Ventes** si le journal contient des comptes en 7
- **Achats** si le journal contient des comptes en 6
- **Divers** sinon

### Étape 2 — Créer les comptes manquants

Le bouton **Créer les comptes** analyse tous les numéros de compte présents dans le fichier FEC et crée dans le plan comptable les comptes qui n'existent pas encore. Dokos respecte l'arborescence du PCG pour positionner chaque nouveau compte au bon niveau hiérarchique et lui attribue le bon type de compte (Débiteur, Créditeur, Banque, Caisse, etc.).

## Lancer l'import

Une fois la configuration et la préparation terminées :

1. Créer un nouveau document **Import FEC**
2. Joindre le fichier FEC — Dokos extrait automatiquement la société (via le SIREN dans le nom du fichier) et les dates de l'exercice
3. Vérifier ou ajuster la société, les paramètres d'import et la plage de dates
4. Cliquer sur **Importer le FEC**

L'import s'exécute en arrière-plan et affiche sa progression en temps réel (lignes traitées, documents créés). Pour chaque écriture groupée, Dokos crée un **Document d'import FEC** intermédiaire, puis le transforme en document comptable.

## Documents d'import FEC

Les documents d'import FEC sont les éléments intermédiaires créés pendant le traitement. Chaque document correspond à une écriture du FEC (groupe de lignes partageant la même date et le même numéro d'écriture).

Chaque document indique :

- Son **type** (Transaction, Paiement, Divers)
- Son **statut** (En attente, Terminé, Erreur)
- Le **document Dokos créé** (facture ou écriture de journal)
- Le détail des lignes GL avec les comptes, montants et champs de lettrage

En cas d'erreur, le message d'erreur est visible directement sur le document, et le traitement peut être relancé manuellement.

## Rapprochement automatique

Après l'import des écritures, le bouton **Réconcilier automatiquement** utilise le champ de lettrage (`EcritureLet`) du FEC pour rapprocher automatiquement les factures avec leurs règlements. Dokos identifie les factures et paiements portant la même référence de lettrage et les réconcilie dans le module de rapprochement.

## Voir aussi

- [Journal comptable](https://doc.dokos.io/v5/dokos/comptabilite/journal-comptable)
- [Écriture de journal](https://doc.dokos.io/v5/dokos/comptabilite/ecriture-journal)
- [Grand livre](https://doc.dokos.io/v5/dokos/comptabilite/rapports/grand-livre)


# Outil de création d'ouverture de facture

Lors de la migration vers Dokos ou lors de la création d'une nouvelle société, il est souvent nécessaire d'importer les factures clients et fournisseurs en cours pour assurer la continuité de la comptabilité. L'outil de création d'ouverture de facture permet de créer facilement des factures d'ouverture à partir d'une liste de factures existantes.

## 1. Créer des factures d'ouverture

Pour accéder à l'outil de création d'ouverture de facture :

1. Allez dans **Comptabilité > Outils > Outil de création d'ouverture de facture**.
2. Sélectionnez le type de facture que vous souhaitez créer (Facture de vente ou Facture d'achat).
3. Cliquez sur **Nouveau** pour créer un nouvel enregistrement.

### 1.1 Ajouter des factures

Dans la section **Factures**, vous pouvez ajouter les factures en cours que vous souhaitez importer :

1. Cliquez sur **Ajouter une ligne** dans la table **Factures**.
2. Remplissez les champs suivants pour chaque facture :

   - **Client/Fournisseur** : Sélectionnez le client ou le fournisseur concerné.
   - **Date de facture** : Indiquez la date de la facture originale.
   - **Date d'échéance** : Indiquez la date d'échéance de la facture.
   - **Montant** : Saisissez le montant total de la facture.
   - **Montant restant** : Saisissez le montant restant dû sur la facture.
   - **Projet** (nouveau) : Sélectionnez le projet associé à cette facture si applicable. Ce champ permet d'associer directement un projet à chaque ligne de facture, ce qui facilite le suivi comptable par projet.
3. Dans la table **Articles**, ajoutez les articles ou services liés à chaque facture :

   - **Article** : Sélectionnez l'article concerné.
   - **Quantité** : Indiquez la quantité.
   - **Prix unitaire** : Saisissez le prix unitaire.
   - **Montant** : Le montant total est calculé automatiquement.
   - **Projet** (nouveau) : Si un projet a été sélectionné au niveau de la facture, il sera automatiquement repris ici. Vous pouvez également le modifier pour chaque ligne d'article si nécessaire.

::mermaid
flowchart TD
A\[Créer un nouvel enregistrement] --> B\[Sélectionner le type de facture]
B --> C\[Ajouter des lignes dans Factures]
C --> D\[Remplir les détails de la facture]
D --> E\[Ajouter des articles dans Articles]
E --> F\[Sélectionner un projet au niveau facture ou article]
F --> G\[Enregistrer et soumettre]

::

### 1.2 Soumettre les factures d'ouverture

Une fois que vous avez ajouté toutes les factures et leurs articles :

1. Cliquez sur **Enregistrer** pour sauvegarder votre travail.
2. Cliquez sur **Soumettre** pour générer les factures d'ouverture.
3. Dokos créera automatiquement les factures de vente ou d'achat correspondantes avec le statut **Ouvert**.

## 2. Suivi des factures d'ouverture

Après la création des factures d'ouverture, vous pouvez suivre leur statut dans les sections **Factures de vente** ou **Factures d'achat** selon le type de facture créé. Les factures créées via cet outil apparaîtront avec le statut **Ouvert** et pourront être traitées comme n'importe quelle autre facture dans Dokos.

## 3. Bonnes pratiques

- **Vérifiez les montants** : Assurez-vous que les montants saisis correspondent bien aux montants restants dus sur les factures originales.
- **Utilisez le champ Projet** : Pour un meilleur suivi comptable, associez chaque facture ou ligne d'article à un projet si votre organisation utilise cette dimension comptable.
- **Exportez et imprimez** : Avant de soumettre, exportez la liste des factures pour vérification ou impression en utilisant le bouton **Exporter**.

\:::tip Astuce
Si vous avez un grand nombre de factures à importer, vous pouvez utiliser l'outil d'import en masse pour gagner du temps. Consultez la documentation sur l'import de données pour plus d'informations.
\:::


# Paramètres de taux de change

Dokos peut récupérer automatiquement les taux de change à jour depuis un service en ligne, sans que vous ayez à les saisir manuellement. Les **Paramètres de taux de change** permettent de choisir et de configurer ce service.

::callout{icon="i-heroicons-information-circle"}
Ce formulaire est accessible via **Comptabilité > Paramètres de taux de change** (ou en cherchant « Paramètres de taux de change » dans la barre de recherche).
::

## Fournisseurs disponibles

Dokos prend en charge plusieurs fournisseurs de taux de change :

| Fournisseur              | Description                                                                                                       |
| ------------------------ | ----------------------------------------------------------------------------------------------------------------- |
| **frankfurter.dev - v2** | Service recommandé (par défaut sur les nouvelles installations). Données issues de la Banque centrale européenne. |
| frankfurter.app          | Ancienne version de l'API Frankfurter. Toujours fonctionnelle mais remplacée par v2.                              |
| exchangerate.host        | Service alternatif avec couverture de devises plus large.                                                         |
| Personnalisé             | Permet de brancher votre propre fournisseur via une URL et des paramètres librement configurables.                |

::callout{icon="i-heroicons-star"}
**Frankfurter v2** est le fournisseur recommandé pour les nouvelles installations Dokos. Il s'appuie sur les taux officiels de la Banque centrale européenne, est gratuit et ne nécessite pas de clé d'API.
::

## Fonctionnement général

Lorsque vous saisissez une transaction en devise étrangère (par exemple une facture de vente en USD pour Maison Verte SARL alors que votre devise de base est l'EUR), Dokos interroge le fournisseur configuré pour obtenir le taux du jour et le saisit automatiquement dans le document.

::mermaid
sequenceDiagram
participant U as Utilisateur
participant D as Dokos
participant API as frankfurter.dev v2


```text
U->>D: Saisit une facture en USD
D->>API: GET /v2/rate/USD/EUR?date=2025-06-15
API-->>D: {"rate": 0.9215}
D->>U: Taux de change 0.9215 renseigné automatiquement
```
::

## Configurer le fournisseur Frankfurter v2

Sur une nouvelle installation Dokos, Frankfurter v2 est déjà configuré par défaut. Si vous migrez depuis une installation plus ancienne ou souhaitez vérifier la configuration :

1. Allez dans **Comptabilité > Paramètres de taux de change**
2. Dans le champ **Fournisseur de service**, sélectionnez **frankfurter.dev - v2**
3. Cliquez sur **Définir par défaut** — Dokos remplit automatiquement l'URL et les paramètres corrects
4. Cliquez sur **Vérifier** pour tester la connexion
5. **Enregistrez**

Une fois sauvegardé, le formulaire affiche :

- **URL du point d'accès** : `https://api.frankfurter.dev/v2/rate/{from_currency}/{to_currency}`
- **Paramètres de requête** : `date` (valeur : `{transaction_date}`)
- **Clé du résultat** : `rate`

Vous n'avez pas besoin de modifier ces valeurs manuellement — elles sont renseignées automatiquement lors de la sélection du fournisseur.

## Activer ou désactiver la récupération automatique

Le champ **Désactiver** (en haut du formulaire) permet de suspendre la récupération automatique sans perdre votre configuration. Utile si votre connexion internet est limitée ou si vous souhaitez saisir tous les taux manuellement.

Lorsque la récupération automatique est désactivée, Dokos utilise les taux saisis manuellement dans **Comptabilité > Devise > Taux de change**.

## Qui peut modifier ces paramètres ?

Seul le rôle **Gestionnaire système** peut modifier les Paramètres de taux de change. Les utilisateurs avec le rôle Gestionnaire comptable peuvent consulter la configuration mais ne peuvent pas la modifier.

## En cas de problème

Si le taux de change n'est pas récupéré automatiquement :

1. Vérifiez que le paramètre **Désactiver** n'est pas coché
2. Cliquez sur **Vérifier** dans les paramètres — un message de succès ou d'erreur s'affiche
3. Vérifiez que la paire de devises est bien supportée par le fournisseur (frankfurter.dev couvre toutes les devises de la BCE)
4. Consultez le lien <https://frankfurter.dev/currencies/>{rel="&#x22;nofollow&#x22;"} pour voir les devises disponibles

::callout{icon="i-heroicons-arrow-path"}
**Migration depuis frankfurter.app vers v2** : si votre installation existante utilise `frankfurter.app`, il est recommandé de passer à `frankfurter.dev - v2`. La procédure est la même que la configuration initiale décrite ci-dessus. Les taux historiques déjà enregistrés dans Dokos ne sont pas affectés.
::

## Lien avec les autres paramètres de comptabilité

La configuration des taux de change automatiques interagit avec les options suivantes dans **Paramètres de comptabilité** :

- **Autoriser le taux de change périmé** : si désactivé, Dokos vérifie l'ancienneté du taux récupéré et refuse les taux trop anciens
- **Jours périmés** : nombre de jours au-delà desquels un taux est considéré comme périmé


# Stock livré mais non facturé (SLMNF)

Lorsque vous livrez des marchandises à un client avant d'émettre la facture correspondante, il se crée un décalage temporel entre le moment où votre stock diminue et celui où le coût est officiellement comptabilisé en charges. Le mécanisme **Stock Livré Mais Non Facturé** (SLMNF) permet de gérer ce décalage de manière rigoureuse.

::callout{icon="i-heroicons-information-circle"}
Ce mécanisme est le symétrique côté ventes du compte **Stock Reçu Mais Non Facturé** (SRMNF) utilisé côté achats. Si vous êtes familier avec ce dernier, le fonctionnement est identique mais dans le sens inverse.
::

---

## Pourquoi ce mécanisme existe-t-il ?

Sans ce mécanisme, lorsque vous validez un bon de livraison, Dokos impute directement le coût des marchandises en **charges** (compte de coût des marchandises vendues). Mais la charge n'est réellement due que lorsque la facture est émise — pas à la livraison.

Avec le compte SLMNF, Dokos :

1. **À la livraison** : sort le stock et poste le coût dans un compte d'actif intermédiaire (SLMNF) plutôt qu'en charges directes.
2. **À la facturation** : solde le compte SLMNF et comptabilise le coût réel en charges.

Cela garantit que votre résultat ne reflète les charges de marchandises que lorsque la vente est effectivement facturée.

---

## Flux comptable

::mermaid
flowchart LR
A(\["Stock marchandises"]) -- "Bon de livraison validé" --> B(\["Stock Livré Mais Non Facturé"])
B -- "Facture de vente créée" --> C(\["Coût des marchandises vendues"])
style A fill:#e8f5e9
style B fill:#fff3e0
style C fill:#fce4ec

::

### Détail des écritures

**À la validation du bon de livraison :**

| Compte                       | Débit             | Crédit            |
| ---------------------------- | ----------------- | ----------------- |
| Stock Livré Mais Non Facturé | Coût des articles |                   |
| Compte de stock (entrepôt)   |                   | Coût des articles |

**À la validation de la facture de vente (liée au bon de livraison) :**

| Compte                        | Débit             | Crédit            |
| ----------------------------- | ----------------- | ----------------- |
| Coût des marchandises vendues | Coût des articles |                   |
| Stock Livré Mais Non Facturé  |                   | Coût des articles |

> **Exemple — Maison Verte SARL**
> Maison Verte SARL commande 10 tables à 200 € l'unité. Le 15 juin, vous créez un bon de livraison : le stock diminue de 2 000 € et le compte SLMNF est débité de 2 000 €. Le 30 juin, vous émettez la facture : le compte SLMNF est soldé et les 2 000 € s'imputent en coût des marchandises vendues.

---

## Configurer le compte SLMNF sur votre société

### 1. Ouvrir la fiche de votre société

Allez dans **Paramétrage > Société** et ouvrez votre société.

### 2. Configurer le compte par défaut

Dans la section **Comptes par défaut**, recherchez le champ **Stock Livré Mais Non Facturé** et sélectionnez le compte comptable à utiliser.

::callout{color="teal" icon="i-heroicons-light-bulb"}
Si votre plan comptable ne contient pas encore ce compte, créez-le dans **Comptabilité > Plan comptable** avec le type de compte **Actif circulant**. En France, vous pouvez l'associer à la classe 3 ou 4 selon votre organisation interne — consultez votre expert-comptable.
::

### 3. Option : désactiver le SLMNF pour les retours clients

Si vous ne souhaitez pas appliquer ce mécanisme aux **retours sur ventes**, cochez l'option **Désactiver le SLMNF pour les retours clients** dans la même section. Dans ce cas, les retours seront comptabilisés directement en coût des marchandises sans passer par le compte intermédiaire.

---

## Conditions d'activation

Le mécanisme SLMNF s'active automatiquement à la validation d'un bon de livraison **si les deux conditions suivantes sont réunies** :

1. Un compte **Stock Livré Mais Non Facturé** est renseigné dans la fiche société.
2. Le bon de livraison **n'est pas déjà lié à une facture de vente** au moment de sa validation.

Si le bon de livraison est créé directement depuis une facture de vente déjà validée, le coût s'impute directement en charges — le compte intermédiaire n'est pas utilisé.

---

## Facturer après la livraison

Lorsque vous créez une facture de vente depuis un bon de livraison déjà validé :

1. Ouvrez le bon de livraison concerné.
2. Cliquez sur **Créer > Facture de vente**.
3. Vérifiez les lignes récupérées automatiquement.
4. **Validez** la facture.

Dokos détecte automatiquement que le bon de livraison a été comptabilisé via le compte SLMNF et génère l'écriture de contre-passation correspondante. Vous n'avez rien à configurer manuellement.

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Si vous modifiez la valorisation d'un article après coup (recalcul de coût, réévaluation de stock), Dokos **re-comptabilise** automatiquement les écritures du bon de livraison et de la facture associée pour refléter le coût actualisé. Ce mécanisme s'appuie sur la fonctionnalité de **Recomptabilisation des entrées de stock**.
::

---

## Vérifier l'état du compte SLMNF

Pour consulter le solde en attente (livraisons non encore facturées) :

1. Allez dans **Comptabilité > Grand livre**.
2. Filtrez par le compte **Stock Livré Mais Non Facturé**.
3. Les lignes sans contrepartie correspondent aux bons de livraison en attente de facturation.

Un solde non nul sur ce compte en fin de période indique que des livraisons ont eu lieu mais n'ont pas encore été facturées — c'est normal si votre cycle livraison → facturation s'étend sur plusieurs jours.

---

## Questions fréquentes

**Le compte SLMNF est-il obligatoire ?**
Non. Si aucun compte n'est configuré dans la fiche société, Dokos adopte le comportement antérieur : le coût s'impute directement en charges à la livraison.

**Que se passe-t-il si je facture sans bon de livraison ?**
Le mécanisme ne s'applique pas. Le coût est comptabilisé directement en charges au moment de la validation de la facture.

**Puis-je utiliser ce mécanisme avec les retours clients ?**
Oui, par défaut. Vous pouvez le désactiver pour les retours via l'option **Désactiver le SLMNF pour les retours clients** dans la fiche société.

---

## Voir aussi

- [Factures de vente](https://doc.dokos.io/v5/dokos/ventes/facture-de-vente)
- [La société](https://doc.dokos.io/v5/dokos/parametrage/societe)
- [Reçu d'achat et Stock Reçu Mais Non Facturé](https://doc.dokos.io/v5/dokos/stocks/recus-achats)


# Rapport Comptes clients

Le rapport **Comptes clients** (Accounts Receivable) présente le détail de toutes les factures impayées ou partiellement réglées, client par client. Il permet de suivre précisément l'âge de chaque créance et d'identifier les relances à effectuer.

> **Exemple — Maison Verte SARL**
> La comptable de Maison Verte SARL veut savoir quelles factures sont impayées depuis plus de 30 jours. Elle ouvre le rapport Comptes clients, filtre sur la date du jour, et obtient pour chaque client la liste des factures avec leur date, leur référence, leur ancienneté en jours et les montants facturés et restants à régler.

## Accéder au rapport

Menu : **Comptabilité → Rapports → Comptes clients**

Vous pouvez filtrer par :

- **Date d'échéance** — date de référence pour le calcul des retards
- **Client** — restreindre à un ou plusieurs clients
- **Groupe de clients** — filtrer par catégorie
- **Société** — en environnement multi-sociétés
- **Devise de présentation** — choisir la devise d'affichage
- **Base du vieillissement** — date d'échéance ou date de publication

## Comprendre le tableau de détail

Chaque ligne du rapport correspond à une facture ou écriture client :

| Colonne            | Description                                 |
| ------------------ | ------------------------------------------- |
| Date               | Date de la pièce                            |
| Référence          | Numéro de la facture ou de l'écriture       |
| Âge (jours)        | Nombre de jours depuis la date de référence |
| Montant facturé    | Montant total de la pièce                   |
| Montant restant dû | Solde encore à régler                       |

Les montants sont regroupés par tranches de vieillissement (0-30, 31-60, 61-90, +90 jours) pour faciliter la priorisation des relances.

::mermaid
graph TD
A\[Ouverture du rapport] --> B\[Sélection des filtres]
B --> C\[Tableau détaillé par facture]
C --> D\[Regroupement par tranche de vieillissement]
D --> E\[Impression ou export]

::

## Imprimer le rapport

Dokos intègre un **format d'impression standard** pour ce rapport : **Accounts Receivable Standard**. Il génère un document PDF structuré au format A4, adapté à l'archivage et à la transmission aux clients ou aux équipes de recouvrement.

### Contenu du document imprimé

Le document imprimé comprend :

- **En-tête** : nom de la société et titre du rapport
- **Métadonnées** : filtres appliqués (client, base du vieillissement, date du rapport) — affichés uniquement si renseignés
- **Tableau de détail** : colonnes fixes — Date, Référence, Âge (jours), Montant facturé, Montant restant dû
- **Section remarques** : affichée si des remarques sont présentes sur les pièces
- **Tableau récapitulatif de vieillissement** : synthèse des encours par tranche (0-30, 31-60, 61-90, +90 jours)
- **Pied de page** : mention « Imprimé le … » avec la date et l'heure de génération

### Générer le PDF

1. Configurez les filtres souhaités dans le rapport.
2. Cliquez sur le bouton **Imprimer** (icône imprimante) en haut à droite.
3. Sélectionnez le format d'impression **Accounts Receivable Standard**.
4. Cliquez sur **Télécharger le PDF** ou **Imprimer**.

> **Astuce** : Le tableau de vieillissement en bas du document imprimé offre une vue synthétique immédiatement lisible, idéale pour les réunions de trésorerie ou les échanges avec un commissaire aux comptes.

## Voir aussi

- [Rapport Récapitulatif Comptes clients](https://doc.dokos.io/v5/dokos/comptabilite/rapports/rapport-clients-recapitulatif)
- [Rapport Comptes fournisseurs](https://doc.dokos.io/v5/dokos/comptabilite/rapports/rapport-fournisseurs)


# Rapport Récapitulatif Comptes clients

Le rapport **Récapitulatif Comptes clients** (Accounts Receivable Summary) présente une vue consolidée des soldes dus par client, sans le détail facture par facture. Il est idéal pour obtenir une photographie rapide de l'ensemble de vos créances à une date donnée.

> **Exemple — Maison Verte SARL**
> Le responsable financier de Maison Verte SARL veut connaître, au 30 juin, le solde global dû par chacun de ses clients, sans entrer dans le détail de chaque facture. Il ouvre le rapport Récapitulatif Comptes clients et obtient immédiatement une ligne par client avec les tranches de vieillissement consolidées.

## Accéder au rapport

Menu : **Comptabilité → Rapports → Récapitulatif Comptes clients**

Vous pouvez filtrer par :

- **Date d'échéance** — la date de référence pour le calcul des retards
- **Client** — restreindre à un ou plusieurs clients
- **Groupe de clients** — filtrer par catégorie
- **Société** — en environnement multi-sociétés
- **Devise de présentation** — choisir la devise d'affichage
- **Base du vieillissement** — date d'échéance ou date de publication

## Comprendre le tableau récapitulatif

Contrairement au rapport détaillé Comptes clients, ce rapport regroupe toutes les factures d'un même client sur une seule ligne :

| Colonne       | Description                           |
| ------------- | ------------------------------------- |
| Client        | Nom du client                         |
| Montant total | Total des montants dus                |
| 0-30 jours    | Montant en retard de 0 à 30 jours     |
| 31-60 jours   | Montant en retard de 31 à 60 jours    |
| 61-90 jours   | Montant en retard de 61 à 90 jours    |
| +90 jours     | Montant en retard de plus de 90 jours |

La **dernière ligne** du tableau affiche le **Total** consolidé de toutes les colonnes.

::mermaid
graph TD
A\[Ouverture du rapport] --> B\[Sélection des filtres]
B --> C\[Tableau récapitulatif par client]
C --> D\[Ligne Total]
D --> E\[Impression ou export]

::

## Imprimer le rapport

Dokos intègre un **format d'impression standard** pour ce rapport : **Accounts Receivable Summary Standard**. Il génère un document PDF structuré au format A4, adapté à l'archivage et à la transmission.

### Contenu du document imprimé

- **En-tête** : nom de la société et titre du rapport
- **Métadonnées** : filtres appliqués (client, groupe, base du vieillissement, date du rapport) — affichés uniquement si renseignés
- **Tableau récapitulatif** : une ligne par client avec les colonnes de vieillissement
- **Ligne Total** en gras en bas du tableau
- **Pied de page** : mention « Imprimé le … » avec la date et l'heure de génération

### Générer le PDF

1. Configurez les filtres souhaités dans le rapport.
2. Cliquez sur le bouton **Imprimer** (icône imprimante) en haut à droite.
3. Sélectionnez le format d'impression **Accounts Receivable Summary Standard**.
4. Cliquez sur **Télécharger le PDF** ou **Imprimer**.

> **Astuce** : Le document imprimé indique automatiquement la base de vieillissement utilisée (date d'échéance ou date de publication), ce qui facilite la traçabilité lors de l'archivage.

## Voir aussi

- [Rapport Comptes clients](https://doc.dokos.io/v5/dokos/comptabilite/rapports/rapport-clients)
- [Rapport Récapitulatif Comptes fournisseurs](https://doc.dokos.io/v5/dokos/comptabilite/rapports/rapport-fournisseurs-recapitulatif)


# Rapport Comptes fournisseurs

Le rapport **Comptes fournisseurs** (Accounts Payable) vous donne une vue complète de l'ensemble des factures fournisseurs non réglées à une date donnée. Il permet d'identifier rapidement les montants dus, leur ancienneté et les éventuels acomptes à déduire.

> **Exemple — Bureau Moderne**
> Le service comptable de Bureau Moderne souhaite connaître, au 30 juin, toutes les factures fournisseurs impayées et leur ancienneté. Il ouvre le rapport Comptes fournisseurs, sélectionne la date et obtient immédiatement la liste triée par fournisseur avec les tranches de retard (0-30 j, 31-60 j, etc.).

## Accéder au rapport

Since Comptabilité → Rapports → **Comptes fournisseurs**.

Vous pouvez filtrer par :

- **Date d'échéance** — la date de référence pour le calcul des retards
- **Fournisseur** — restreindre à un ou plusieurs fournisseurs
- **Groupe de fournisseurs** — filtrer par catégorie
- **Société** — en environnement multi-sociétés
- **Devise de présentation** — choisir la devise d'affichage
- **Inclure les remarques** — afficher une colonne de commentaires sur chaque ligne
- **Afficher les futurs paiements** — inclure un tableau secondaire des échéances à venir

## Comprendre le tableau de vieillissement

Le rapport présente chaque fournisseur avec :

| Colonne         | Description                                 |
| --------------- | ------------------------------------------- |
| Fournisseur     | Nom du fournisseur                          |
| Réf. facture    | Numéro de la facture fournisseur            |
| Date d'échéance | Date à laquelle le règlement est attendu    |
| 0-30 jours      | Montant en retard de 0 à 30 jours           |
| 31-60 jours     | Montant en retard de 31 à 60 jours          |
| 61-90 jours     | Montant en retard de 61 à 90 jours          |
| +90 jours       | Montant en retard de plus de 90 jours       |
| Remarques       | Notes éventuelles (si l'option est activée) |

La **dernière ligne** du tableau affiche le **Total** consolidé de toutes les colonnes.

### Futurs paiements

Lorsque l'option **Afficher les futurs paiements** est activée, un tableau secondaire apparaît sous le tableau principal. Il liste les factures dont l'échéance est postérieure à la date de référence, permettant d'anticiper les sorties de trésorerie à venir.

::mermaid
graph TD
A\[Ouverture du rapport] --> B\[Sélection des filtres]
B --> C\[Tableau de vieillissement]
C --> D{Futurs paiements activés ?}
D -- Oui --> E\[Tableau secondaire des échéances futures]
D -- Non --> F\[Ligne Total]
E --> F
F --> G\[Impression ou export]

::

## Imprimer le rapport

Dokos intègre un **format d'impression dédié** au rapport Comptes fournisseurs, appelé **Accounts Payable Standard**. Il génère un document PDF structuré et prêt à l'envoi.

### Contenu du document imprimé

- **En-tête** : nom de la société et titre du rapport
- **Sous-titre** : récapitulatif des filtres appliqués (fournisseur, groupe, date) — s'affiche uniquement si des filtres ont été renseignés
- **Tableau de vieillissement** : toutes les lignes du rapport avec les colonnes d'ancienneté et, si activée, la colonne Remarques
- **Ligne Total** en bas du tableau principal
- **Tableau des futurs paiements** (si l'option est activée)

### Générer le PDF

1. Configurez les filtres souhaités dans le rapport.
2. Cliquez sur le bouton **Imprimer** (icône imprimante) en haut à droite.
3. Sélectionnez le format d'impression **Accounts Payable Standard**.
4. Cliquez sur **Télécharger le PDF** ou **Imprimer**.

> **Astuce** : Si vous filtrez par fournisseur ou par groupe, le sous-titre du document imprimé indique automatiquement ces informations pour faciliter l'archivage.

## Voir aussi

- [Rapport Récapitulatif Comptes fournisseurs](https://doc.dokos.io/v5/dokos/comptabilite/rapports/rapport-fournisseurs-recapitulatif)
- [Rapport Comptes clients](https://doc.dokos.io/v5/dokos/comptabilite/rapports/rapport-clients)
- [Formats d'impression](https://doc.dokos.io/v5/dokos/generalites/impression-et-pdf)


# Rapport Récapitulatif Comptes fournisseurs

Le rapport **Récapitulatif Comptes fournisseurs** (Accounts Payable Summary) présente une vue consolidée des soldes dus par fournisseur, sans le détail facture par facture. Il est idéal pour obtenir une photographie rapide de l'ensemble de vos dettes fournisseurs à une date donnée.

> **Exemple — Bureau Moderne**
> Le responsable financier de Bureau Moderne veut connaître, au 30 juin, le solde global dû à chacun de ses fournisseurs, sans entrer dans le détail de chaque facture. Il ouvre le rapport Récapitulatif Comptes fournisseurs et obtient immédiatement une ligne par fournisseur avec les tranches de vieillissement consolidées.

## Accéder au rapport

Since Comptabilité → Rapports → **Récapitulatif Comptes fournisseurs**.

Vous pouvez filtrer par :

- **Date d'échéance** — la date de référence pour le calcul des retards
- **Fournisseur** — restreindre à un ou plusieurs fournisseurs
- **Groupe de fournisseurs** — filtrer par catégorie
- **Société** — en environnement multi-sociétés
- **Devise de présentation** — choisir la devise d'affichage
- **Base du vieillissement** — date d'échéance ou date de publication

## Comprendre le tableau récapitulatif

Contrairement au rapport détaillé Comptes fournisseurs, ce rapport regroupe toutes les factures d'un même fournisseur sur une seule ligne :

| Colonne       | Description                           |
| ------------- | ------------------------------------- |
| Fournisseur   | Nom du fournisseur                    |
| Montant total | Total des montants dus                |
| 0-30 jours    | Montant en retard de 0 à 30 jours     |
| 31-60 jours   | Montant en retard de 31 à 60 jours    |
| 61-90 jours   | Montant en retard de 61 à 90 jours    |
| +90 jours     | Montant en retard de plus de 90 jours |

La **dernière ligne** du tableau affiche le **Total** consolidé de toutes les colonnes.

::mermaid
graph TD
A\[Ouverture du rapport] --> B\[Sélection des filtres]
B --> C\[Tableau récapitulatif par fournisseur]
C --> D\[Ligne Total]
D --> E\[Impression ou export]

::

## Imprimer le rapport

Dokos intègre un **format d'impression standard** pour ce rapport : **Accounts Payable Summary Standard**. Il génère un document PDF structuré au format A4, adapté à l'archivage et à la transmission.

### Contenu du document imprimé

- **En-tête** : nom de la société et titre du rapport
- **Métadonnées** : filtres appliqués (fournisseur, groupe, base du vieillissement, date du rapport) — affichés uniquement si renseignés
- **Tableau récapitulatif** : une ligne par fournisseur avec les colonnes de vieillissement
- **Ligne Total** en gras en bas du tableau
- **Pied de page** : mention « Imprimé le … » avec la date et l'heure de génération

### Générer le PDF

1. Configurez les filtres souhaités dans le rapport.
2. Cliquez sur le bouton **Imprimer** (icône imprimante) en haut à droite.
3. Sélectionnez le format d'impression **Accounts Payable Summary Standard**.
4. Cliquez sur **Télécharger le PDF** ou **Imprimer**.

> **Astuce** : Le document imprimé indique automatiquement la base de vieillissement utilisée (date d'échéance ou date de publication), ce qui facilite la traçabilité lors de l'archivage.

## Voir aussi

- [Rapport Comptes fournisseurs](https://doc.dokos.io/v5/dokos/comptabilite/rapports/rapport-fournisseurs)
- [Rapport Récapitulatif Comptes clients](https://doc.dokos.io/v5/dokos/comptabilite/rapports/rapport-clients-recapitulatif)


# Introduction

Dokos vous aide à suivre les opportunités commerciales des prospects et des clients, à leur envoyer des devis et à réserver des commandes client.

---

Pour accéder au module de **CRM**, allez sur :

> Accueil > **CRM**

## 1. Pipeline de vente

- [1. Piste](https://doc.dokos.io/v5/dokos/crm/piste)
- [2. Opportunité](https://doc.dokos.io/v5/dokos/crm/opportunite)
- [3. Prospect](https://doc.dokos.io/v5/dokos/crm/prospect)
- [4. Client](https://doc.dokos.io/v5/dokos/parametrage/clients)
- [5. Contact](https://doc.dokos.io/v5/dodock/fonctionnalites/contacts-adresses/contacts)
- [6. Contrat](https://doc.dokos.io/v5/dokos/crm/contrat)
- [7. Rendez-vous](https://doc.dokos.io/v5/dokos/crm/rendez-vous)
- [8. Newsletter](https://doc.dokos.io/v5/dokos/crm/newsletter)

## 2. Paramètres

- [1. Synchronisation avec Frappe CRM](https://doc.dokos.io/v5/dokos/crm/synchronisation-frappe-crm)
- [2. Groupe de clients](https://doc.dokos.io/v5/dokos/parametrage/clients#groupes-de-clients)
- [3. Région](https://doc.dokos.io/v5/dokos/parametrage/clients#territoires)
- [4. Vendeur](https://doc.dokos.io/v5/dokos/ventes/commercial)

## 3. Campagne

- [1. Campagne](https://doc.dokos.io/v5/dokos/crm/campagne)
- [2. Campagne Emailing](https://doc.dokos.io/v5/dokos/crm/email-campaign)


# Piste

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Depuis la version 3.0 de Dokos, l'ancien type de document **Prospect** a été renommé en **Piste**.
::

Une piste est un client potentiel qui pourrait être intéressé par vos produits ou services.

Pour amener le client à franchir la porte, vous pouvez effectuer tout ou partie des actions suivantes :

- **Liste de votre produit sur des répertoires.**
- **Maintenir un site Web mis à jour et consultable.**
- **Rencontrer des gens lors d'événements commerciaux.**
- **Publicité de vos produits ou services.**

Lorsque vous faites savoir que vous êtes dans les parages et que vous avez quelque chose de précieux à offrir, les gens viennent vérifier vos produits. Ce sont vos leads.

Ils sont appelés **Piste** dans Dokos car ils peuvent vous conduire à une vente. Les directeurs des ventes travaillent généralement sur les pistes en les appelant, en établissant une relation et en envoyant des informations sur les produits ou services. Il est important de suivre toute cette conversation pour permettre à une autre personne qui pourrait avoir à faire le suivi de ce contact. La nouvelle personne est alors en mesure de connaître l'historique de cette piste particulière.

---

Pour accéder à la liste des Pistes, allez sur :

> CRM > **Piste**

# 1. Créer une Piste

1. Accédez à la liste des Pistes et cliquez sur ➕ Ajouter Piste

   - **Le Piste est une organisation** : Cochez la case si vos Piste est une organisation. Notez que si la case est cochée, le champ **Nom de l'entreprise est obligatoire**.
2. **Remplir les différents champs pour complèter la fiche** :

   - Nom de la personne
   - Nom de l'organisation
   - Adresse email
   - Responsable de la Piste
   - Statut de la Piste : Les statuts suivants sont automatiquements mis à jours. Vous pouvez également ajoutez/supprimez des statuts en personnalisant le document.


     - **Ouvert** : Lors de la création de la Piste
     - **Opportunité** : Dès que vous aurez créé une opportunité
     - **Devis** : Dès que le devis est validé
     - **Converti** : Dès que le client accepte le devis et que vous avez créé une commande
     - **Devis perdu** : Si vous indiquez que le devis est perdu.
   - Salutation : Mme, M., etc.
   - Désignation
   - Genre
   - Source
   - Nom de la campagne
3. **Enregistrer**

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
**Statut** : Si vous supprimez un statut qui est lié à une action cela pourrait créer une erreur. Notamment dans les prochaines mises à jours de la plateforme où certains statuts pourraient être lié à de nouvelles actions.
::

# 2. Caractéristiques

## 2.1 Suivre

En renseignant les informations relatives au prochain contact avec la Piste, un événement est automatiquement ajouté à votre calendrier. Celui-ci vous enverra un email de rappel le matin du rendez-vous.
Vous pouvez également configurer des notifications en fonction de vos besoins spécifiques.

## 2.2 Notes

Dans cette section, vous avez la possibilité d'ajouter toutes les informations nécessaires sur la Piste, des remarques, des suggestions afin de faciliter la gestion de la Piste.

## 2.3 Adresse et contact

### 2.3.1 Adresse de la Piste

Vous pouvez indiquer l'**adresse** de votre Piste :

- Type d'adresse : Facturation, livraison, Magasin, Bureau, Entrepôt, etc.
- Titre de l'adresse : Domicile, Travail, etc.
- Adresse, Ville, État, Pays, Code postal

### 2.3.2 Contact de la Piste

Indiquez les **coordonnées** de la Piste :

- Téléphone
- N°Mobile
- Fax
- Site web

## 2.3 Informations additionnelles

Vous pouvez ajouter des informations complémentaires sur votre Piste dans les notes, mais également dans des champs d'information structurée qui seront facilement requêtables pour analyser vos Pistes: part de marché, site web, industrie, région.
Ces informations seront reprises automatiquement à la création d'une fiche client à partir de cet Piste.

Le champ "Désabonné" est mis à jour automatiquement lorsque la Piste se désabonne des emails que vous lui envoyez. Il sert également à filtrer les Pistes que vous ajoutez à un nouveau groupe email.

## 2.4 Notifications par email

Lorsqu'un email est reçu sur le fil de discussion d'une Piste, Dokos envoie automatiquement une notification à la bonne personne selon la règle suivante :

- Si un **Responsable de la piste** est défini, c'est **lui qui reçoit la notification**, quelle que soit la personne qui a créé la fiche.
- Si aucun responsable n'est renseigné, la notification est envoyée au **créateur de la fiche**.

Cela évite que la personne qui saisit les pistes (par exemple un assistant commercial) soit notifiée de toutes les réponses, alors que c'est le commercial assigné qui doit les traiter.

**Exemple :** Léa crée une piste pour "Maison Verte SARL" et assigne le suivi à Thomas (Responsable de la piste). Lorsque Maison Verte SARL répond à un email envoyé depuis cette piste, c'est Thomas qui reçoit la notification, pas Léa.

# Différence entre prospect, contact et client

Il est fréquent dans l'utilsation d'un ERP de faire un amalgame entre un prospect, un contact et voire un client.

Dans cette section, nous allons expliquer la distinction entre ces trois types de document.

---

## 1. Caractéristiques

- **Un prospect** : Un prospect désigne, de façon concise, un client potentiel pour une entreprise. Le terme définit de façon plus large un individu pour lequel des opérations commerciales et/ou de communication ont été mises en place afin de le séduire et de le compter parmi les nouveaux clients.
- **Un client** : Acheteur effectif de biens ou de services proposés par l'entreprise. Le client peut être une personne physique ou une personne morale. C'est une personne qui a déjà fait une ou des affaires avec l'entreprise.
- **Contact** : C'est une personne qui appartient au Client. Ceci est applicable dans le scénario BtoB (Business to Business), où vous pouvez contacter plusieurs personnes appartenant au même client.
  **Par exemple** : Vous pouvez avoir une entreprise A qui est votre cliente, et cette entreprise à plusieurs contacts avec vous (Chef de l'entreprise, le commercial, le comptable etc.)

Un **prospect** peut être converti en **client** en sélectionnant **Client** dans la liste déroulante Créer . Une fois le client créé, le prospect devient **converti** et toute autre opportunité provenant de la même source peut être créée pour ce client.

# Sources du prospect

Une source de leads est une source à partir de laquelle les leads sont générés.

Il est important de suivre la source à partir de laquelle vous obtenez les prospects. Cela aidera à mesurer l'efficacité des campagnes de marketing et à allouer les budgets en conséquence.

Pour accéder à la **liste des sources de prospects**, allez sur :

> Accueil > Vendre > Paramètres > **Source de prospect**

## 1. Comment créer une source de prospect

1.Allez dans la liste source du prospect, cliquez sur ➕ .
2\. Entrez **Nom de la source**.
3\. Entrez **Détails**.

Les sources de prospects typiques sont les formulaires de contact sur votre site Web, les campagnes marketing, les événements, les références, les publicités sur les réseaux sociaux, etc.


# Prospect

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Nouveau type de document depuis la version 3.0. Le document Prospect permet maintenant un meilleur suivi des personnes morales
::

Un prospect est maintenant une personne morale qui pourrait être intéressé par vos produits ou services.

Ce type de document vous sera très utile pour suivre plus facilement le prospect. Vous allez pouvoir avoir plus d'informations comme la part de marché, le nombre d'employé etc..

---

Pour accéder à la liste des Prospects, allez sur :

> CRM > Pipeline de Ventes > **Prospect**

## 1. Créez un nouveau prospect

Ajoutez un **nouveau prospect**

### 1.1 Onglet Vue d'ensemble

1. Indiquez les **différentes informations**:

- Le nom du client
- Le groupe de client
- Le nombre d'employé
- Le revenu annuel
- La part de marché
- Le type d'industrie
- La région
- Le responsable du prospect
- Le site web, fax
- La société relié à ce prospect

Faites **Enregistrer** cette première partie

### 1.2 Onglet Adresses et contact

Dans cette section vous allez pouvoir retrouver les adresses et coordonnées du prospect.

#### 1.2.1 **Ajoutez une nouvelle adresse**

- Vous serez redirigé automatiquement dans le document `CRM > Adresse`
- Remplissez toutes les informations du document puis faites **enregistrer**.
- Les informations renseignées seront automatiquement reprises dans l'**adresse du Prospect**.

#### 1.2.2 **Ajoutez un nouveau contact**

- Vous serez redirigé automatiquement dans le document `CRM > Contact`
- Remplissez toutes les informations du document puis faites **enregistrer**.
- Les informations renseignées seront automatiquement reprises dans le **contact du Prospect**.

### 1.3 Onglet Pistes

Dans cette section vous allez pouvoir retrouver toutes les pistes qui sont liés à votre prospect.
Les pistes peuvent être les différents interlocuteurs que vous aurez eu pour votre propsection avec ce prospect.

#### 1.3.1 **Ajoutez une nouvelle piste**

- Allez dans le cellule Piste et faites **Créez nouvelle piste**
- Vous serez redirigé automatiquement dans le document `CRM > Piste`
- Remplissez toutes les informations du document puis faites **enregistrer**.
- Les informations renseignées seront automatiquement reprises dans le **tableau des pistes du Prospect**.

### 1.4 Onglet Opportunités

Dans cette section vous allez pouvoir retrouver toutes les opportunités qui sont liés à votre prospect.

#### 1.4.1 **Ajoutez une nouvelle opportunité**

- Allez dans le cellule Piste et faites **Créez nouvelle Opportunité**
- Vous serez redirigé automatiquement dans le document `CRM > Opportunité`
- Remplissez toutes les informations du document puis faites **enregistrer**.
- Les informations renseignées seront automatiquement reprises dans le **tableau des opportunités du Prospect**.

### 1.4 Onglet Activités

Dans cette section vous allez pouvoir retrouver les tâches et événements qui sont liés à ce prospect.

- Ajoutez et visualisez les tâches
- Ajoutez et visualisez les événements
- Envoyez et suivez l'historique d'envoi des emails

### 1.4 Onglet Notes

Dans cette section vous pouvez ajouter et voir les différentes notes qui ont été renseignés pour ce prospect.


# Opportunité

L'opportunité est une piste qualifiée.

Lorsque vous obtenez un indice indiquant que le prospect recherche un produit / service que vous proposez, vous pouvez le convertir en opportunité. Vous pouvez également créer une opportunité contre un client existant. Plusieurs opportunités peuvent être collectées contre un prospect ou un client.

---

Pour accéder à la liste des opportunités, allez sur :

> Accueil > CRM > Pipeline des ventes > **Opportunité**

## 1. Comment créer une opportunité

1. Accédez à la liste Opportunités et cliquez sur ➕ Ajouter opprtunité.
2. Dans **Opportunité de** :


   - Sélectionnez **Prospect** si l'opportunité provient d'un prospect.
   - Sélectionnez **Client** si l'opportunité provient d'un client.
3. Prospect / Client : Sélectionner le tiers concerné.
4. Indiquez le type de source
5. Sélectionnez le type d'opportunité. Cela indique la grande catégorie d'opportunités comme les ventes, le support, la maintenance, etc.
6. Sélection du statut de l'opportunité : Ouvert, Fermé, Répondu, Devis, etc.
7. Converti par : Choisissez l'utilisateur qui a converti cet apportunité
8. Vous pouvez choisir le niveau du stade de vente
9. Date de clôture prévue

## 2. Caractéristiques

### 2.1 Rappels de suivi des opportunités

Il est important de saisir les opportunités et de construire la relation. Vous pouvez définir les champs **Date du prochain contact** et «**Prochain contact par** et un événement de calendrier sera ajouté pour l'utilisateur choisi dans le champ **Prochain contact par** et une notification sera affichée à cette date.

### 2.2 Attribuer automatiquement des opportunités aux responsables des ventes

Vous pouvez définir des règles d'attribution pour attribuer automatiquement les opportunités aux responsables des ventes.

### 2.3 Fermeture automatique des

Si vous ne recevez pas de réponse d'une opportunité pendant un certain nombre de jours, vous souhaiterez peut-être que cette opportunité soit fermée automatiquement.

Vous pouvez définir le nombre de jours dans les **paramètres de vente**.

### 2.4 Créer un devis client

Vous pouvez créer un devis à partir de la liste déroulante **Créer**. Les valeurs de champ pertinentes seront copiées.

### 2.5 Créer un devis fournisseur

Vous devrez peut-être obtenir un devis de votre fournisseur par rapport aux exigences du client et, sur cette base, préparer le devis pour votre client. Avec Dokos, vous pouvez faire un devis fournisseur à partir de l'opportunité elle-même.

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Meilleure pratique : les prospects et les opportunités sont souvent appelés votre **pipeline de ventes**. C'est ce que vous devez suivre si vous voulez être en mesure de prédire le chiffre d'affaires que vous allez générer à l'avenir. C'est toujours une bonne idée de pouvoir suivre ce qui s'en vient afin d'ajuster vos ressources.
::

### 2.6 Saisir les raisons de la perte d'opportunités

Lorsqu'une opportunité est perdue, vous pouvez saisir les raisons de la perte. Cela vous aidera à analyser les tendances sur une longue période et à identifier les informations nécessaires pour des améliorations dans divers domaines de l'organisation.

## Consultation du catalogue articles depuis une opportunité :badge{text="Dokos" type="warning"}

Dokos permet d'accéder aux détails des articles (nom, description, unité de mesure, prix) directement depuis une opportunité, sans quitter le module CRM. Si un client est associé à l'opportunité, le système récupère automatiquement la liste de prix correspondante pour afficher les prix applicables à ce client.

> **Exemple — Maison Verte SARL**
> Le commercial travaillant sur l'opportunité de Maison Verte SARL peut consulter le catalogue et les tarifs applicables à ce client depuis l'opportunité elle-même, puis générer le devis en un clic avec les prix déjà renseignés.

Cette fonctionnalité accélère la création de devis en évitant les allers-retours entre le module CRM et le catalogue articles.


# Campagne

Une campagne est une mise en œuvre à grande échelle d'une stratégie de vente pour promouvoir un produit ou un service.

Cela se fait dans un segment de marché d'une zone géographique particulière pour atteindre des objectifs spécifiés.

---

Pour accéder à **la liste campagne**, allez sur :

> Accueil > CRM > **Campagne**

## 1. Comment créer une campagne

1. Allez dans la liste des campagnes, cliquez sur **➕ Ajouter Campagne**.
2. Saisissez un **nom** pour la campagne.
3. Remplir le tableau **Calendriers de campagne**.
4. Saisissez une **description** pour décrire le sujet de la campagne.
5. **Enregistrer**.

## 2. Caractéristiques

### 2.1 Calendriers de campagne

Si vous souhaitez mener une campagne en utilisant des e-mails pour vos prospects ou contacts, Email Campaign sert à cela.

Vous devrez établir un calendrier pour la campagne. Cliquez sur « Ajouter une ligne » pour ajouter une entrée au calendrier de la campagne.

**Dans Modèle d'e-mail**, sélectionnez un « Modèle d'e-mail » que vous souhaitez envoyer par e-mail au prospect ou au contact. Vous pouvez en créer un comme suit :

**Dans Envoyer après (jours)**, spécifiez le nombre de jours après lequel l'e-mail respectif doit être envoyé. A l'aide de ce champ, le jour d'envoi de l'e-mail est calculé par rapport à la Date de début de la campagne e - mail.

### 2.2 Campagne de balises dans les pistes, les opportunités et les devis

Lorsqu'une campagne marketing génère un prospect ou une opportunité, vous pouvez baliser la campagne lors de la création du prospect ou de l' opportunité . Vous pouvez également taguer la campagne dans Devis .

Cela aide à évaluer l'efficacité d'une campagne de marketing en calculant le retour sur investissement.

### 2.3 Afficher les prospects générés par une campagne

1. Cliquez sur le bouton **Afficher les prospects** dans la campagne.
2. Vous verrez une liste filtrée des prospects générés par rapport à la campagne.
3. Vous pouvez également créer de nouveaux prospects contre la campagne en cliquant sur **Nouveau**

### 2.4 Tableau de bord

Le tableau de bord de la campagne vous montre toutes les campagnes par e-mail et les publications sur les réseaux sociaux liées à la campagne. Vous pouvez également créer une nouvelle campagne par e-mail et une publication sur les réseaux sociaux à partir d'ici.


# Campagne d'emailing

Une campagne par e-mail est un ensemble coordonné d'e-mails envoyés à des prospects ou des contacts selon un calendrier particulier.

Les campagnes par e-mail restent l'un des moyens les plus efficaces d'atteindre vos clients, contacts ou prospects et de les fidéliser. Par exemple, vous pouvez configurer des campagnes par e-mail pour présenter votre produit aux clients, chaque e-mail révélant une caractéristique intéressante de votre produit.

---

Pour créer une campagne e-mail, allez sur :

> Accueil > CRM > Campagne > **Campagne e-mail**

![liste\_campagne\_emailing.png](https://doc.dokos.io/content/crm/email-campaign/liste_campagne_emailing.png)

## 1. Prérequis avant utilisation

Avant de créer et d'utiliser campagne d'emailing, certains éléments doivent d'abord être créés :

- **[Campagne](https://doc.dokos.io/v5/dokos/crm/campagne)**

## 2. Comment créer une campagne e-mail

1. Accédez à la liste Campagne e-mail, cliquez sur **➕ Ajouter Campagne d'emailing**.
2. Sélectionnez la **campagne** pour laquelle vous souhaitez configurer une campagne e-mail.
3. Définissez la **Date de début** pour la campagne par e-mail.
4. Dans **Campagne par e-mail pour**, indiquez si vous souhaitez configurer une campagne par e-mail pour un prospect ou un contact ou pour qu'un groupe de messagerie soit envoyé à plusieurs contacts par e-mail.
5. Dans **Destinataire**, sélectionnez le prospect, le contact ou le groupe d'e-mails pour lequel vous souhaitez lancer la campagne par e-mail.
6. Dans **Expéditeur**, sélectionnez l'utilisateur du système qui doit être l'expéditeur des e-mails.
7. **Enregistrer**

![détails\_campagne\_emailing.png](https://doc.dokos.io/content/crm/email-campaign/details_campagne_emailing.png)

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
**Remarque** : le champ Envoyer après (jours) dans Campaign spécifie le jour auquel l'e-mail doit être envoyé par rapport à la date de début de la campagne e - mail . Notez la « Date de fin » dans la campagne par e-mail ci-dessus. Nous sommes le « 26-07-2019 », soit 4 jours après la « Date de début », le « 22-07-2029 », car le calendrier de la campagne se termine le jour 4.
::

### 2.1 Créer plusieurs campagnes e-mail pour une campagne

Vous pouvez également créer de nouvelles campagnes par e-mail pour différents prospects ou contacts pour la même campagne via le tableau de bord de la campagne.

Accédez à la campagne pour laquelle vous souhaitez créer des campagnes e-mail.
Cliquez sur + devant Campagnes e-mail pour créer une nouvelle campagne e-mail pour la campagne.

## 3. Caractéristiques

### 3.1 Communication liée

Lorsque des e-mails sont envoyés à des Prospects ou à des Contacts, le document Communication associé est lié au document de Campagne d'e-mails, où vous pouvez visualiser tous les e-mails envoyés.

### 3.2 Se désinscrire de la campagne e-mail

Si un prospect ou un contact ne souhaite pas continuer à recevoir des e-mails concernant la campagne, il peut se désinscrire de la campagne e-mail via le lien de désabonnement envoyé avec l'e-mail.

Lorsque le prospect ou le contact se désinscrit, le statut du document de campagne par e-mail passe à « Désabonné ».

### 3.3 Utiliser les champs Lead ou Contact dans le modèle d'e-mail

Le modèle d'e-mail a le contexte du document que vous avez spécifié dans le champ "Campagne par e-mail pour". Si vous souhaitez afficher les champs de votre document Lead ou Contact dans votre modèle d'e-mail, vous devrez les utiliser doc.fieldnamepour la même chose. Par exemple, si « Campagne par e-mail pour » est « Contact », vous pouvez mentionner le « prénom » de votre contact comme doc.first\_name dans le modèle d'e-mail comme indiqué ci-dessous :

### 3.4 Indication d'état

Le Statut indique l'état de la Campagne Email, les différents Statuts sont :

- **Programmée** : lorsque la campagne e-mail n'a pas encore commencé mais est planifiée à une future « date de début ».
- **En cours** : La campagne serait marquée comme « En cours » entre la « Date de début » et la « Date de fin » de la campagne.
- **Terminé** : Après la 'Date de fin' de la campagne, le statut sera changé en 'Terminé'.
- **Désinscrit** : Lorsque le Lead ou le Contact se désinscrit de la Campagne.


# Contrat

## 👉 Définition d'un contrat

Un contrat est un document qui enregistre les termes et conditions convenus entre votre entreprise et un client ou un fournisseur. Il peut inclure des informations sur les produits ou services fournis, les prix, les conditions de paiement, les dates de livraison, et d'autres clauses spécifiques.

Un contrat est un accord juridiquement contraignant entre un fournisseur et un client concernant la vente de produits ou de services. Il est juridiquement exécutoire car il répond aux exigences et à l'approbation de la loi. Un accord implique généralement l'échange de biens, de services, d'argent ou de promesses de l'un de ceux-ci.

- Accord juridiquement contraignant : Cela signifie que l'accord est reconnu par la loi. Si l'une des parties ne respecte pas les termes de l'accord, l'autre partie peut aller en justice pour faire valoir ses droits.
- Juridiquement exécutoire : Signifie que le contrat peut être appliqué par la loi. Les parties peuvent être forcées de respecter le contrat par un tribunal.
- Répond aux exigences et à l'approbation de la loi : Pour être valable, le contrat doit contenir certains éléments et ne doit pas violer les lois en vigueur.

::callout
Il est vivement conseillé de faire appel à un juriste ou à des professionnels comptétants pour établir un contrat, afin de s'assurer que toutes les exigences légales sont respectées et que les termes de l'accord protègent les intérêts de toutes les parties impliquées.
::

---

## 1. Flux Dokos

::mermaid
```text
flowchart LR
  Devis --> cc[Commande client]
  cc --> fv[Facture de vente]
  Devis --> Contrat --> fv

```
::

Pour accéder à la **liste des contrats**, allez sur :

> CRM > Pipeline de vente > **Contrat**

## 2. Créer un contrat

::tour{demo="Mappemonde" doctype="contract"}
Créer un contrat dans la démo
::

::callout
Laissez-vous guider par le tour pour créer un nouveau contrat.
::

### 2.1 Détails du signataire

Cette section apparaîtra lorsque la case **Signé** (dans la première section) est cochée pour indiquer que le client a signé et accepté le contrat.

**Signataire** : entrez le nom de la personne qui a signé le contrat.
**Signé le** : date à laquelle le contrat a été signé.

![période\_contrat.png](https://doc.dokos.io/content/crm/contract/periode_contrat.png)

## 3. Modèle de contrat

Un modèle de contrat est un aperçu standardisé d'un contrat sans les détails impliqués. Vous pouvez créer un nouveau modèle en allant sur:

> CRM > Modèle de contrat

Vous pouvez créer des modèles à l'aide de Jinja. Par exemple:

```text
The parties enter into this contract on {{ start_date }}.
```

Lorsque vous créez un nouveau contrat à l'aide de ce modèle, le {{ start_date }}est remplacé par la date saisie dans le champ du même nom.

![modèles\_contrat.png](https://doc.dokos.io/content/crm/contract/modeles_contrat.png)

## Fusion dynamique des données du contrat :badge{text="Dokos" type="warning"}

Dokos interprète automatiquement les variables Jinja2 du modèle de contrat en les remplaçant par les valeurs réelles du document au moment de l'application du modèle. Tous les champs du contrat sont accessibles (nom du client, dates, montants, signataire, etc.) via la syntaxe `{{ doc.champ }}`.

> **Exemple — Maison Verte SARL**
> Le modèle contient `Ce contrat lie {{ doc.party_name }} à compter du {{ doc.start_date }}.`. Lorsque le modèle est appliqué au contrat de Maison Verte SARL commençant le 1er mai 2026, Dokos génère automatiquement `Ce contrat lie Maison Verte SARL à compter du 01/05/2026.`

Cette fusion se produit côté serveur lors de la sélection du modèle sur le contrat, avant même la sauvegarde. Le texte généré reste modifiable pour les ajustements manuels.


# Newsletter

La newsletter est un e-mail qui est envoyé périodiquement à un groupe spécifique d'abonnés.

Dans le contexte du CRM, il s'agit d'un e-mail d'information et axé sur le produit qui est envoyé aux clients existants et potentiels dans le but de pousser doucement l'abonné à effectuer les actions requises.

La newsletter peut également être utilisée pour partager des informations avec les employés, les investisseurs, etc.

Vous devez créer des groupes de messagerie avant d'envoyer les newsletters.

---

Pour accéder à **la liste des newsletters**, allez sur :

> Accueil > Paramètres > E-mail > **Newsletter**

## 1. Comment créer une newsletter

1. Allez dans la liste Newsletter et cliquez sur **➕ Ajouter Newsletter**.
2. Sélectionnez le groupe d'e-mails dans le tableau **Destinataire**.
3. Entrez **Sujet**.
4. Entrez **Message**.
5. **Publier** la newsletter pour la rendre disponible sur le Web.
6. Cochez **Envoyer le lien de désabonnement** si vous souhaitez inclure un lien de désabonnement dans l'e-mail.
7. **Envoyer le lien d'affichage Web** inclura un lien dans l'e-mail pour ouvrir la newsletter sur le Web. Cette option n'est visible que lorsque la newsletter est publiée.

Vous trouverez ci-dessous la capture d'écran de l'e-mail reçu avec un lien pour vous désinscrire et un lien pour ouvrir l'e-mail sur le Web.

## 2. Caractéristiques

### 2.1 Créer des groupes d'abonnés

Vous pouvez gérer les abonnés en les regroupant dans différents groupes de messagerie .

Vous pouvez sélectionner plusieurs groupes d'e-mails dans les tableaux 'DESTINATAIRES' de la newsletter.

### 2.2 Programmer l'envoi

Vous pouvez choisir d'envoyer votre newsletter à n'importe quelle date/heure future en spécifiant l'heure par pas horaires.

### 2.3 Tester la newsletter avant de l'envoyer aux abonnés

Une fois la newsletter prête, vous pouvez fournir une **adresse e-mail de test** et cliquer sur **Test**.

Vous pouvez consulter la newsletter reçue dans l'e-mail de test, la vérifier puis l'envoyer à tous les abonnés en cliquant sur **Envoyer** .

## Mise à jour automatique des groupes d'emails :badge{text="Dokos" type="warning"}

> **Exemple — Agence Créative Leblanc**
> L'agence envoie chaque mois une newsletter à tous ses clients actifs. Plutôt que de mettre à jour la liste d'abonnés à la main, elle a configuré son groupe d'emails pour se synchroniser automatiquement avec la liste des clients dont le statut est "Actif". Chaque nuit, Dokos met à jour la liste : les nouveaux clients sont ajoutés, les anciens retirés.

Lors de l'import d'abonnés dans un groupe d'emails (via **Actions > Importer des abonnés**), Dokos propose d'activer la mise à jour automatique. Une fois cochée, un traitement planifié (exécuté automatiquement en arrière-plan) resynchronise régulièrement la liste à partir des mêmes filtres et du même type de document utilisés lors de l'import initial.

::dokos
Cette fonctionnalité nécessite l'installation de l'application **Newsletter**. Elle est réservée aux administrateurs qui configurent les groupes d'emails.
::

[SCREENSHOT: dialogue d'import d'abonnés avec l'option "Mise à jour automatique" cochée]


# Rendez-vous et mise en ligne

Un rendez-vous est une réunion préétablie entre un responsable et un employé de votre entreprise.

Le type de document de rendez-vous peut être utilisé pour planifier et gérer l'interaction avec un prospect ou une opportunité.

---

Pour accéder à la **liste des rendez-vous**, allez sur :

> Accueil > CRM > Pipeline des ventes > **Rendez-vous**

## 1. Prérequis avant utilisation

Avant de créer un Rendez-vous, il est conseillé de créer ces différents documents :

- 1. **Paramètres de réservation de rendez-vous**
- 2. **Liste de vacances**
- 3. **Employé**
- 4. **Prospect**
- 5. **E-mail**

## 2. Comment créer un rendez-vous ?

### 2.1 Créeation rapide

1. Allez dans la liste des Rendez-vous, cliquez sur **➕ Ajouter Rendez-vous**.
2. Définir l'heure du rendez-vous dans le champ **Heure programmée**
3. Indiquez le **statut**.
4. Saisir le **nom** de la personne pour le rendez-vous.
5. **Email** du contact.

### 2.2 Création complète

1. Allez dans la liste des Rendez-vous, cliquez sur **➕ Ajouter Rendez-vous**.
2. Faire **modifier en pleine page**
3. Remplir les différents champs pour complèter la **fiche Rendez-vous**

- Heure programmée
- Statut du Rendez-vous
- Nom, Numéro de télphone, ID Skype, Email
- Détails sur le rendez-vous et sur la personne

## 3. Caractéristiques

### 3.1 Documents liés

- **Rendez-vous avec**
- **Tiers**
- **Événement du calendrier**

## 4. Création de rendez-vous via le site Web

Vos clients/prospects peuvent créer un rendez-vous à l'aide de la page Web yoursitename.com/book\_appointment.

Ils doivent d'abord fixer une date, une heure. Formulaire de rendez-vous

Ensuite, ajoutez plus de détails

Il fera correspondre l'e-mail du client avec les prospects dans le système et s'il en trouve un, il est lié au document. Si aucune piste n'est trouvée, le rendez-vous est marqué comme "Non vérifié" et un e-mail est envoyé au client pour confirmer son e-mail

### 4.1. Caractéristiques

- **Affectation automatique**
  Les rendez-vous sont automatiquement attribués aux employés selon la Agentsliste dans Paramètres de prise de rendez -vous . L'agent ayant le moins d'affectations pour la journée du rendez-vous et qui est libre à l'heure prévue est affecté au rendez-vous.
- **E-mail de confirmation**
  S'il n'y a pas de piste correspondante dans votre système, un e-mail sera envoyé à l'adresse e-mail du rendez-vous pour confirmer si l'adresse e-mail est valide. Lors de la confirmation, un nouveau prospect sera également créé dans le système avec le rendez-vous.

# Paramètres de prise de rendez-vous

Vous pouvez trouver tous les paramètres liés à la prise de rendez-vous dans les **paramètres de prise de rendez-vous**.

![parametre-rendez-vous.png](https://doc.dokos.io/content/crm/parametre-rendez-vous.png)

## 1. Activer la prise de rendez-vous

Cette case à cocher activera la prise de rendez-vous et activera également la page **/book\_appointment** pour les utilisateurs du site Web (vos clients).

## 2. Détails de l'agent

Dans cette section, vous pouvez ajouter des détails sur les agents, tels que leurs heures de travail et leurs jours fériés.

### 2.1 Disponibilité des créneaux

Ici, vous pouvez définir le moment auquel vos agents sont disponibles pour assister à un rendez-vous. Celui-ci est défini par jour de la semaine.

Chaque ligne représente un bloc de temps continu, vous pouvez avoir plusieurs entrées pour chaque jour de la semaine.

Par exemple si vos agents travaillent du lundi au vendredi, de 9h à 17h mais avec une pause déjeuner à 13h30 pendant une demi-heure. Vous devrez créer deux entrées pour chaque jour. Une de 9h à 13h30 et une autre de 14h à 17h.

### 2.2 Agents

Il s'agit de la liste des agents qui seront automatiquement affectés aux rendez-vous. Le nombre de rendez-vous pouvant exister dans une plage horaire dépend également du nombre d'employés dans cette liste.

### 2.3 Liste des jours fériés

Vous pouvez lier une liste de jours fériés. Si le jour est un jour férié, la prise de rendez-vous ce jour-là ne sera pas autorisée.

## 3. Détails du rendez-vous

Cette section contient des détails sur le rendez-vous eux-mêmes.

### 3.1 Durée du rendez-vous en minutes

La durée du rendez-vous en minutes. Ceci est utilisé pour calculer les plages horaires de rendez-vous pour le portail Web. Changer cela n'affecte pas les rendez-vous créés avant le changement.

### 3.2 Notification par e-mail

L'activation de cette case à cocher enverra un e-mail aux participants des rendez-vous, c'est-à-dire votre employé et le client le jour du rendez-vous. La modification de cette case à cocher n'affecte pas les rendez-vous créés avant la modification.

### 3.3 Le nombre de jours de rendez-vous peut être réservé à l'avance

Il s'agit du nombre de jours pendant lesquels le rendez-vous peut être réservé à l'avance. Si la liste des jours fériés fournie ci-dessus se termine avant la date calculée à l'aide de ce numéro, la prise de rendez-vous sera arrêtée à la fin de la liste des jours fériés.

## 4. Paramètres de réussite

### 4.1 URL de redirection réussie

Il s'agit de l'URL vers laquelle l'utilisateur sera redirigé lors de la création d'un rendez-vous réussi via le portail Web. Cette redirection ne se produira pas lors de la création de rendez-vous à partir de l'interface utilisateur du bureau. Laissez vide pour la maison. Ceci est relatif à l'URL du site, par exemple "about" redirigera vers "<https://yoursitename.com/about>{rel="&#x22;nofollow&#x22;"}"


# Synchronisation avec Frappe CRM

Dokos permet de synchroniser les données entre votre instance Frappe CRM et Dokos pour centraliser la gestion de vos prospects et clients.

Cette fonctionnalité est particulièrement utile si vous utilisez déjà Frappe CRM pour suivre vos opportunités commerciales et souhaitez éviter la double saisie des informations.

---

## Activer la synchronisation

Pour activer la synchronisation avec Frappe CRM :

1. Allez dans **CRM > Paramètres > Paramètres CRM**.
2. Dans la section **Frappe CRM**, activez l'option **Activer la synchronisation des données Frappe CRM**.

::mermaid
flowchart TD
A\[Accéder aux Paramètres CRM] --> B\[Activer la synchronisation]
B --> C\[Ajouter des utilisateurs autorisés]
C --> D\[Sauvegarder]

::

Une fois activée, Dokos créera automatiquement les champs personnalisés suivants :

- **`crm_deal`** sur le document **Devis** pour lier un devis à une opportunité Frappe CRM.
- **`crm_deal`** sur le document **Client** pour lier un client à une opportunité Frappe CRM.

\::: info
Si vous désactivez la synchronisation, les champs personnalisés seront automatiquement supprimés.
\:::

---

## Gérer les utilisateurs autorisés

Seuls les utilisateurs listés dans la table **Utilisateurs autorisés pour Frappe CRM** peuvent pousser des données depuis Frappe CRM vers Dokos.

Pour ajouter un utilisateur :

1. Dans les **Paramètres CRM**, allez dans la section **Frappe CRM**.
2. Dans la table **Utilisateurs autorisés pour Frappe CRM**, cliquez sur **Ajouter une ligne**.
3. Sélectionnez l'utilisateur dans la liste.
4. Sauvegardez les modifications.

::mermaid
flowchart TD
A\[Ouvrir Paramètres CRM] --> B\[Accéder à la section Frappe CRM]
B --> C\[Ajouter un utilisateur dans la table]
C --> D\[Sélectionner l'utilisateur]
D --> E\[Sauvegarder]

::

\::: warning
Si la synchronisation est activée mais qu'aucun utilisateur n'est autorisé, Dokos bloquera toute tentative de synchronisation.
\:::

---

## Fonctionnement de la synchronisation

### Création d'un prospect depuis Frappe CRM

Lorsqu'un utilisateur autorisé envoie une requête depuis Frappe CRM pour créer un prospect dans Dokos :

1. Dokos vérifie que la synchronisation est activée.
2. Dokos vérifie que l'utilisateur est autorisé.
3. Si les deux conditions sont remplies, Dokos crée un prospect dans Dokos et lie l'opportunité Frappe CRM via le champ `crm_deal`.

### Création d'un client depuis Frappe CRM

Lorsqu'un utilisateur autorisé envoie une requête depuis Frappe CRM pour créer un client dans Dokos :

1. Dokos vérifie que la synchronisation est activée.
2. Dokos vérifie que l'utilisateur est autorisé.
3. Si les deux conditions sont remplies, Dokos crée un client dans Dokos et lie l'opportunité Frappe CRM via le champ `crm_deal`.

::mermaid
flowchart TD
A\[Requête depuis Frappe CRM] --> B\[Vérifier synchronisation activée]
B -- Non --> C\[Erreur 417]
B -- Oui --> D\[Vérifier utilisateur autorisé]
D -- Non --> E\[Erreur 403]
D -- Oui --> F\[Créer prospect/client]

::

---

## Exemple d'utilisation

**Scénario** : Vous utilisez Frappe CRM pour suivre une opportunité avec le client *Maison Verte SARL*. Vous souhaitez créer un devis dans Dokos pour cette opportunité.

1. Depuis Frappe CRM, un utilisateur autorisé envoie une requête pour créer un prospect dans Dokos.
2. Dokos crée le prospect *Maison Verte SARL* et lie l'opportunité Frappe CRM via le champ `crm_deal`.
3. Vous créez un devis dans Dokos pour ce prospect.
4. Le champ `crm_deal` du devis est automatiquement rempli avec l'identifiant de l'opportunité Frappe CRM.

Cette synchronisation permet de suivre facilement le lien entre vos opportunités Frappe CRM et vos documents Dokos (devis, clients).


# Ventes

Le module de Vente vous permet de créer des devis pour vos prospects, des commandes clients et des factures de vente. :br
De plus, avec la mise en place de nombreux rapports et indicateurs, vous allez pouvoir suivre facilement la progression de vos ventes.

**Le flux de ventes :**

::mermaid
flowchart LR
id4-->id9(Bon de livraion)
id2(Commande client)-->id4(Facture de vente)
id4-->id5(Ecriture de paiement)
id2-->id6("Ecriture de paiement (Acompte)")
id1(Piste)-->id7(Opportunité)
id7-->id8\[Devis Client]
id8-->id2

::

Pour accéder au module des Ventes, allez sur :

> Accueil > **Vente**

## 1. Cycle de vente

- [1. Client](https://doc.dokos.io/v5/dokos/parametrage/clients)
- [2. Devis client](https://doc.dokos.io/v5/dokos/ventes/devis)
- [3. Commande client](https://doc.dokos.io/v5/dokos/ventes/commande-client)
- [4. Facture de vente](https://doc.dokos.io/v5/dokos/ventes/facture-de-vente)
- [5. Partenaire commercial](https://doc.dokos.io/v5/dokos/ventes/partenaire-commercial)
- [6. Abonnement](https://doc.dokos.io/v5/dokos/ventes/abonnements)

## 2. Articles et prix

- [1. Articles](https://doc.dokos.io/v5/dokos/parametrage/articles)
- [2. Prix de l'article](https://doc.dokos.io/v5/dokos/parametrage/prix)
- [3. Liste de prix](https://doc.dokos.io/v5/dokos/parametrage/prix)
- [4. Groupe d'article](https://doc.dokos.io/v5/dokos/parametrage/articles#groupes-darticles)
- [5. Schéma promotionnel](https://doc.dokos.io/v5/dokos/stocks/schemas-promotionnels)
- [6. Règles de prix](https://doc.dokos.io/v5/dokos/stocks/regles-de-prix)
- [7. Règle de livraison](https://doc.dokos.io/v5/dokos/stocks/regle-de-livraison)
- [8. Code promotionnel](https://doc.dokos.io/v5/dokos/ventes/code-promotionnel)

## 3. Paramètres

- [1. Paramètres de vente](https://doc.dokos.io/v5/dokos/ventes/parametres-vente)
- [2. Modèle de taxe et frais de vente](https://doc.dokos.io/v5/dokos/ventes/taxes)
- [3. Modèles termes et conditions](https://doc.dokos.io/v5/dokos/parametrage/demarrage/termes-et-conditions)
- [4. Groupe de clients](https://doc.dokos.io/v5/dokos/parametrage/clients#groupes-de-clients)
- [5. Contact](https://doc.dokos.io/v5/dodock/fonctionnalites/contacts-adresses/contacts)
- [6. Adresse](https://doc.dokos.io/v5/dodock/fonctionnalites/contacts-adresses/addresses)
- [7. Région](https://doc.dokos.io/v5/dokos/ventes/facture-de-vente)
- [8. Campagne](https://doc.dokos.io/v5/dokos/crm/campagne)


# Paramètres de vente

Paramètres de vente est l'endroit où vous pouvez définir les propriétés et les validations qui seront appliquées aux maîtres et aux transactions impliquées dans le cycle de vente.

---

Pour accéder aux **Paramètres de vente**, allez sur :

> Accueil > Vente > Paramètres > **Paramètres de vente**

## 1. Informations générales

### 1.1 Dénomination du client par

Lorsqu'un client est enregistré, un identifiant unique est généré pour ce client.

Par défaut, l'ID client est généré en fonction du nom du client. Si vous souhaitez enregistrer le client en utilisant une série de dénomination, dans le champ Série de dénomination du client, définissez la valeur sur **Série de dénomination**. Exemple d'identifiant client enregistré dans la série de dénomination - "CUST00001, CUST00002, CUST00003 ..." et ainsi de suite.

Vous pouvez définir des séries de noms pour les clients à partir de:

> Configuration > Données > **Attribution de noms aux séries**

#### Configurer la série directement depuis les Paramètres de vente

Lorsque **Série de dénomination** est sélectionné comme méthode de dénomination du client, un bouton **Configurer** apparaît à côté du champ. Ce bouton ouvre une boîte de dialogue qui vous permet de :

- **Prévisualiser** la série de numérotation actuellement active pour les clients
- **Modifier** les séries disponibles (en ajouter, en retirer)
- **Changer** la série par défaut
- **Mettre à jour le compteur** de départ de la série

Cette fonctionnalité évite d'avoir à naviguer vers le document **Paramètres de nommage des documents** pour ajuster la numérotation des clients.

**Exemple :** Si votre entreprise utilise la série `CUST-.YYYY.-` et que vous souhaitez ajouter une série spécifique pour un nouveau type de client, ouvrez la boîte de dialogue de configuration directement depuis les Paramètres de vente et ajoutez votre nouvelle série sur une nouvelle ligne.

### 1.2 Dénomination de la campagne par

Tout comme pour le client, vous pouvez également configurer la méthodologie de dénomination pour le maître de campagne. Par défaut, une campagne sera enregistrée avec le nom de la campagne.

### 1.3 Groupe de clients et territoire par défaut

Sélectionnez un groupe de clients par défaut qui sera mis à jour automatiquement lors de la création d'un nouveau client.

Des devis peuvent être créés pour les clients ainsi que pour les prospects. Lors de la conversion d'un devis en commande client, qui est créée pour un prospect, le système tente de convertir ce prospect en client. Lors de la création du client dans le backend, les valeurs du groupe de clients et du territoire sont sélectionnées dans les paramètres de vente. Si aucune valeur par défaut n'est trouvée pour le groupe de clients ou le territoire, vous recevrez un message de validation demandant le groupe de clients ou le territoire. Vous pouvez également convertir manuellement un prospect en client.

### 1.4 Liste de prix par défaut

La liste de prix définie dans ce champ sera mise à jour automatiquement dans le champ **Liste de prix** des transactions de vente telles que l'offre, la commande client, le bon de livraison et la facture de vente.

### 1.5 Fermer l'opportunité après des jours

S'il existe de nombreuses opportunités ayant un statut autre que **Ouvert**, elles seront automatiquement fermées après le nombre de jours mentionnés dans ce domaine.

### 1.6 Jours de validité du devis par défaut

Les devis au client ne sont valables que pour certains jours. Dans le devis, vous pouvez mettre à jour manuellement la date limite de validité. Par défaut, la date limite de validité est définie automatiquement sur 30 jours à compter de la date de publication du devis. Vous pouvez changer le nombre de jours dans ce domaine selon votre analyse de rentabilisation.

### 1.7 Commande client requise

Si vous souhaitez rendre la création de commande client obligatoire avant la création d'une facture client, vous devez définir le champ **Commande client requise** sur **Oui**. Par défaut, ce sera **Non**.

Cette configuration peut être remplacée pour un client particulier en cochant la case **Autoriser la création de facture client sans commande client** dans la fiche client.

### 1.8 Bon de livraison requis

Pour rendre la création du bon de livraison obligatoire avant la création de la facture de vente, vous devez définir ce champ sur **Oui**. Par défaut, ce sera **Non**.

Cette configuration peut être remplacée pour un client particulier en cochant la case **Autoriser la création de factures de vente sans bon de livraison** dans la fiche client.

### 1.9 Fréquence de mise à jour des ventes

La fréquence à laquelle l'avancement du projet et les détails des transactions de l'entreprise seront mis à jour. Par défaut, c'est pour chaque transaction, vous pouvez également le définir sur **Quotidien** ou **Mensuel** si vous avez beaucoup de transactions chaque jour.

### 1.10 Maintenir le même taux tout au long du cycle de vente

Si cette option est activée, Dokos validera si le prix d'un article évolue dans un bon de livraison ou une facture client créée à partir d'une commande client, c'est-à-dire qu'il vous aidera à maintenir le même taux tout au long du cycle de vente.

Vous pouvez configurer l'action que le système doit entreprendre si le même taux n'est pas maintenu dans le champ "Action si le même taux n'est pas maintenu":

- **Stop** : Dokos vous empêchera de changer le prix en lançant une erreur de validation.
- **Avertir** : le système vous permettra de sauvegarder la transaction mais vous avertira par un message si le taux est modifié.

### 1.11 Autoriser l'utilisateur à modifier le tarif tarifaire dans la transaction

Le teableau des articles dans les transactions de vente comporte un champ appelé **Tarif tarifaire**. Ce champ n'est pas modifiable par défaut dans toutes les transactions de vente. Cela permet de garantir que le prix d'un article est extrait de l'enregistrement **Prix de l'article** et que l'utilisateur n'est pas en mesure de le modifier.

Si vous avez besoin que le prix de l'article extrait de la liste de prix d'un article soit modifiable, **vous devez décocher ce champ**.

### 1.12 Autoriser l'ajout d'un article plusieurs fois dans une transaction

Il s'agit d'un contrôle de validation qui empêche qu'un élément soit ajouté plusieurs fois dans la même transaction lorsqu'il n'est pas coché. Dans certains cas, cela peut être un besoin explicite si c'est le cas, cochez cette case.

### 1.13 Autoriser plusieurs commandes client par rapport à la commande d'achat d'un client

Lors de la création d'une commande client, vous pouvez mettre à jour l'ID de commande d'achat et la date de réception du client. Vous ne pouvez créer qu'une seule commande client par rapport au numéro et à la date du bon de commande du client. Cependant, si vous souhaitez autoriser la création de plusieurs bons de commande pour le même numéro de bon de commande du client, cochez la case **Autoriser plusieurs commandes de vente par rapport au bon de commande d'un client**.

### 1.14 Valider le prix de vente de l'article par rapport au taux d'achat ou au taux de valorisation

Lorsque vous effectuez des ventes, il est important de savoir que vous ne faites pas de pertes. L'activation de cette validation validera le prix de vente de l'article avec sa valorisation / prix d'achat. Si le prix de vente d'un article est inférieur à son prix d'achat, vous recevrez une invite lorsque cette case est cochée.

### 1.15 Masquer le numéro d'identification fiscale du client dans les transactions de vente

Conformément à l'exigence légale, la plupart des clients se voient attribuer un numéro d'identification fiscale unique. Ils doivent également avoir cet identifiant fiscal récupéré dans les transactions de vente. Cependant, si vous ne souhaitez pas utiliser cette fonctionnalité, vous pouvez la désactiver en cochant cette propriété.

## 2. Séries de numérotation des transactions de vente

Les Paramètres de vente proposent un onglet dédié à la gestion des séries de numérotation pour l'ensemble des documents de vente. Cet espace centralisé vous évite de naviguer entre plusieurs écrans pour configurer la numérotation de chaque type de document.

### 2.1 Tableau récapitulatif des séries de numérotation

Un tableau affiché directement dans les Paramètres de vente liste tous les types de documents de vente (devis, commande client, bon de livraison, facture de vente, etc.) avec, pour chacun :

- La **série par défaut** actuellement active
- Les **autres séries disponibles** pour ce type de document

**Exemple :** Pour vérifier rapidement quelle série est utilisée pour les commandes clients de Maison Verte SARL, consultez la ligne « Commande client » dans le tableau — la série active apparaît en évidence.

### 2.2 Configurer une série depuis le tableau

En cliquant sur une ligne du tableau, une boîte de dialogue s'ouvre et vous permet de :

1. **Voir** les séries existantes pour ce type de document
2. **Ajouter** une nouvelle série (saisir le préfixe souhaité sur une nouvelle ligne, par exemple `CMD-BM-.YYYY.-` pour Bureau Moderne)
3. **Définir** quelle série est utilisée par défaut
4. **Mettre à jour le compteur** pour reprendre la numérotation à un point de départ précis

::mermaid
flowchart LR
A\[Paramètres de vente] --> B\[Onglet Séries de numérotation]
B --> C\[Tableau des documents de vente]
C --> D{Clic sur un document}
D --> E\[Boîte de dialogue de configuration]
E --> F\[Modifier / Ajouter des séries]
E --> G\[Changer la série par défaut]
E --> H\[Mettre à jour le compteur]
F & G & H --> I\[Enregistrer]

::

::callout{color="blue" icon="i-heroicons-light-bulb"}
**Bon à savoir :** La configuration des séries depuis les Paramètres de vente est strictement équivalente à celle effectuée via le document **Paramètres de nommage des documents**. Les deux interfaces modifient les mêmes données.
::

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Après avoir ajouté une nouvelle série, rechargez la page du document concerné (par exemple, la fiche Commande client) pour que la nouvelle série apparaisse dans la liste de sélection.
::


# Vendeur

Vous êtes ici parce que vous souhaitez associer un commercial à vos ventes pour suivre ses performances ou calculer ses commissions.

---

## Créer un vendeur

Depuis **Ventes > Vendeur**, cliquez sur **Ajouter**.

1. Saisissez le **nom** du vendeur
2. Sélectionnez l'**employé** correspondant
3. Définissez le **taux de commission** si applicable
4. Cochez **Nœud de groupe** si ce vendeur manage d'autres vendeurs
5. **Enregistrez**

::callout{icon="i-heroicons-information-circle"}
Les vendeurs sont organisés en **hiérarchie** dans Dokos. Vous pouvez créer des équipes avec un responsable commercial en tête et des vendeurs en dessous — les rapports de performance se consolident à chaque niveau.
::

---

## Utiliser un vendeur dans les transactions

Une fois créé, le vendeur peut être sélectionné sur les commandes clients, bons de livraison et factures. Cela permet de suivre le chiffre d'affaires et les commissions par commercial.

---

## Suivre les objectifs

Depuis la fiche vendeur, définissez des **objectifs de vente** par groupe d'articles, territoire ou période (mensuel, trimestriel, semestriel, annuel). Les rapports affichent ensuite l'écart entre les objectifs et les performances réelles.

---

## Et ensuite

- [Partenaire commercial](https://doc.dokos.io/v5/dokos/ventes/partenaire-commercial) — gérer vos revendeurs et agents externes
- [Commande client](https://doc.dokos.io/v5/dokos/ventes/commande-client) — associer un vendeur à une commande


# Demande de paiement

Vous êtes ici parce que vous souhaitez envoyer un lien de paiement sécurisé à un client pour qu'il règle une facture, une commande ou un abonnement en ligne, sans avoir à passer par un échange d'emails ou un appel téléphonique.

::mermaid
flowchart LR
id1(Facture/Commande/Abonnement)-->id2(Demander un paiement)
id2-->id3(Email envoyé au client)
id3-->id4(Client clique sur le lien)
id4-->id5(Page de paiement en ligne)
id5-->id6(Paiement validé)
id6-->id7(Statut mis à jour dans Dokos)

::

---

## Avant de commencer

Pour envoyer une demande de paiement, vous avez besoin :

- D'au moins une **passerelle de paiement** configurée (Stripe, GoCardless, virement, etc.).
- D'un document source valide : **Facture de vente**, **Commande client** ou **Abonnement** en statut *Validé* et non soldé.
- D'une adresse email valide pour le client.

::callout{icon="i-heroicons-information-circle"}
Si aucune passerelle de paiement n'est configurée, la demande de paiement ne pourra pas être envoyée. Consultez [Configurer les passerelles de paiement](https://doc.dokos.io/v5/dokos/comptabilite/passerelles-paiements) pour plus d'informations.
::

---

## Créer une demande de paiement

### Depuis une facture, une commande ou un abonnement

1. Ouvrez le document source (facture, commande ou abonnement).
2. Allez dans l'onglet **Collecte des paiements**.
3. Cliquez sur **Demander un paiement**.
4. Un panneau latéral s'ouvre avec les options suivantes :

   - **Montant** : par défaut le solde restant du document, modifiable pour un paiement partiel.
   - **Échéancier** (uniquement pour les commandes) : ajoutez plusieurs lignes pour proposer un paiement en plusieurs fois.
   - **Mode de paiement** : sélectionnez la passerelle de paiement à utiliser (Stripe, GoCardless, etc.).
   - **Destinataire** : email du client (modifiable).
   - **Modèle d'email** : choisissez un modèle prédéfini ou personnalisez le message.
   - **Joindre le PDF** : cochez pour envoyer le document en pièce jointe.
   - **Envoyer immédiatement** : cochez pour envoyer l'email dès la création de la demande.
5. Cliquez sur **Envoyer la demande de paiement** pour finaliser.

::callout{icon="i-heroicons-light-bulb"}
Si vous ne souhaitez pas envoyer immédiatement la demande, décochez **Envoyer immédiatement**. La demande sera créée en brouillon et vous pourrez l'envoyer plus tard depuis la liste des **Demandes de paiement**.
::

### Depuis la liste des demandes de paiement

1. Allez dans **Ventes > Demandes de paiement**.
2. Cliquez sur **Ajouter**.
3. Sélectionnez le **document source** (facture, commande ou abonnement).
4. Remplissez les champs comme décrit ci-dessus.
5. **Enregistrez** et **Validez** pour envoyer.

---

## Suivre une demande de paiement

### Depuis le document source

Dans l'onglet **Collecte des paiements** du document source (facture, commande ou abonnement), vous trouverez :

- Un **pill de statut** pour chaque demande envoyée (Brouillon, Envoyée, Payée, Annulée).
- Des **actions rapides** pour chaque demande :


  - **Copier le lien de paiement** : pour envoyer manuellement le lien au client.
  - **Renvoyer l'email** : pour renvoyer la demande si le client ne l'a pas reçue.
  - **Annuler la demande** : pour annuler une demande envoyée par erreur.
  - **Voir la demande** : pour ouvrir la demande de paiement complète.

### Depuis la liste des demandes de paiement

La liste **Ventes > Demandes de paiement** affiche toutes les demandes avec leurs statuts et montants. Vous pouvez filtrer par statut, client ou document source pour un suivi efficace.

---

## Personnaliser l'email

Vous pouvez personnaliser le message envoyé au client en utilisant des **variables dynamiques** :

- `{{ doc.transaction_date }}` : date du document source.
- `{{ reference.grand_total }}` : montant total du document source.
- `{{ payment_link }}` : lien de paiement sécurisé.
- `{{ doc.company }}` : nom de votre entreprise.
- `{{ doc.customer_name }}` : nom du client.

::callout{icon="i-heroicons-information-circle"}
Pour créer un **modèle d'email personnalisé**, allez dans **Paramètres > Modèles d'email** et ajoutez un nouveau modèle pour le type **Demande de paiement**.
::

---

## Configurer un échéancier (commandes uniquement)

Pour les commandes, vous pouvez proposer un **paiement en plusieurs fois** en configurant un échéancier dans le panneau **Demander un paiement**.

1. Cliquez sur **Ajouter une ligne** dans la section **Échéancier**.
2. Renseignez :


   - **Montant** : montant de l'échéance.
   - **Date d'échéance** : date à laquelle le paiement doit être effectué.
3. Répétez pour chaque échéance.

::callout{icon="i-heroicons-information-circle"}
Chaque ligne de l'échéancier génère une **demande de paiement distincte** avec son propre lien de paiement. Le client recevra autant d'emails que de lignes dans l'échéancier.
::

---

## Canal de paiement téléphonique

Dokos prend en charge un canal de paiement **téléphonique** distinct du canal web. Lorsque le champ **Canal de paiement** est défini sur "Phone", Dokos ne génère pas de lien de paiement et n'envoie pas d'email. À la place, il déclenche directement une demande de paiement auprès de la passerelle configurée en transmettant le numéro de téléphone du client.

Ce canal est conçu pour les passerelles qui permettent d'initier un paiement par téléphone — par exemple pour déclencher une transaction sur un terminal physique depuis Dokos.

> **Exemple — Dokompany**
> Un client appelle pour régler sa facture par carte. L'équipe commerciale crée une demande de paiement avec le canal "Phone" et le numéro de mobile du client. Dokos transmet la demande à la passerelle qui envoie une notification sur le téléphone du client pour valider le paiement — sans qu'un lien web soit généré ou qu'un email soit envoyé.

---

## Lien automatique avec l'abonnement :badge{text="Dokos" type="warning"}

Lorsqu'une demande de paiement est créée pour un document lié à un abonnement (facture de vente, commande client...), Dokos détecte automatiquement l'abonnement associé et le renseigne sur la demande de paiement. Ce lien permet de tracer chaque demande jusqu'à l'abonnement d'origine et de suivre les renouvellements.

> **Exemple — Dokompany**
> Maison Verte SARL a un abonnement mensuel. La facture générée automatiquement par cet abonnement déclenche une demande de paiement. Dokos remplit automatiquement le champ **Abonnement** sur la demande — sans intervention manuelle.

---

## Ce qui peut bloquer

**"Aucune passerelle de paiement"** — vous devez en sélectionner au moins une pour valider le document.

**"Le lien GoCardless n'apparaît pas"** — si le client est déjà lié à un mandat valide, le lien n'est pas proposé. Utilisez **Actions > Obtenir le paiement immédiatement** à la place.

**"Montant invalide"** — le montant demandé ne peut pas dépasser le solde restant du document source.

**"Email non envoyé"** — vérifiez que l'adresse email du client est correcte et que le modèle d'email est bien configuré.

**"Document source non valide"** — le document source doit être en statut *Validé* et non soldé.

---

## Et ensuite

- [Configurer les passerelles de paiement](https://doc.dokos.io/v5/dokos/comptabilite/passerelles-paiements) — pour activer Stripe, GoCardless ou d'autres passerelles.
- [Factures de vente](https://doc.dokos.io/v5/dokos/ventes/facture-de-vente) — pour enregistrer un paiement manuel.
- [Commandes client](https://doc.dokos.io/v5/dokos/ventes/commande-client) — pour proposer un paiement en plusieurs fois.
- [Abonnements](https://doc.dokos.io/v5/dokos/ventes/abonnements) — pour automatiser les demandes de paiement récurrentes.
- [Modèles d'email](https://doc.dokos.io/v5/dodock/administration/emails) — pour personnaliser les messages envoyés aux clients.


# Termes de paiement

Vous êtes ici parce que vous facturez en plusieurs fois, avec un acompte à la commande et un solde à la livraison — ou parce qu'un client paie à 30 jours. Les termes de paiement vous permettent de définir ces règles une fois et de les réutiliser sur tous vos documents.

---

## Avant de commencer

Les termes de paiement s'appliquent sur :

- Factures de vente et d'achat
- Commandes client et fournisseur
- Devis

Vous pouvez en créer autant que nécessaire (30 jours, 50/50, paiement immédiat...) et les associer directement à une fiche client ou fournisseur pour qu'ils s'appliquent automatiquement.

---

## Créer un terme de paiement

Depuis **Comptabilité > Données de base**, ouvrez la liste **Termes de paiement** et cliquez sur **Ajouter**.

1. Donnez-lui un **nom explicite** — c'est ce que vous verrez dans la liste déroulante sur vos documents (ex : *50% à la commande, 50% à la livraison*)
2. Définissez la **part de la facture** en pourcentage (ex : 50 pour 50%)
3. Choisissez la **base de la date d'échéance** :


   - *Jours après la date de facturation* — l'échéance est X jours après la date de la facture
   - *Jours après la fin du mois de facturation* — utile pour les échéances fin de mois
   - *Mois après la fin du mois de facturation* — pour les délais en mois complets
4. Renseignez le **nombre de jours ou mois** de délai
5. **Enregistrez**

Pour un paiement en plusieurs tranches, créez un **modèle de termes de paiement** qui regroupe plusieurs lignes (ex : 30% à la commande + 70% à 30 jours).

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Quand vous définissez plusieurs tranches, la somme des **parts de facture** doit obligatoirement être égale à **100%**. Si ce n'est pas le cas, le calendrier de paiement ne se génère pas.
::

---

## Appliquer un terme de paiement

**Sur un document** — dans la section *Termes et paiement* de votre facture ou commande, sélectionnez le terme souhaité. Le calendrier de paiement se calcule automatiquement.

**Par défaut sur un client** — ouvrez la fiche client, onglet *Conditions de paiement*, et sélectionnez le terme par défaut. Il sera pré-rempli sur toutes les nouvelles factures pour ce client.

---

## Remise pour paiement anticipé

Vous pouvez inciter vos clients à payer plus tôt en leur accordant une remise automatique si le paiement arrive avant une date limite.

Dans le terme de paiement, renseignez :

- **Type de remise** : pourcentage ou montant fixe
- **Valeur de la remise** (ex : 2%)
- **Validité de la remise** : nombre de jours après la facture pendant lesquels la remise s'applique

Lors de l'enregistrement du paiement, Dokos applique la remise automatiquement si la date est dans les délais.

---

## Ce qui peut bloquer

**Le calendrier de paiement ne se génère pas** — vérifiez que le terme de paiement sélectionné a bien une *part de facture* renseignée, et que le total des parts égale 100%.

**Le terme ne s'affiche pas sur la facture** — il doit être sélectionné dans la section *Termes et paiement*, pas dans *Informations supplémentaires*.

**La remise anticipée ne s'applique pas** — vérifiez la date du paiement : si elle dépasse la validité de la remise, Dokos ne l'applique pas automatiquement.

---

## Et ensuite

- [Factures de vente](https://doc.dokos.io/v5/dokos/ventes/facture-de-vente) — appliquer les termes sur une facture
- [Paramètres clients](https://doc.dokos.io/v5/dokos/parametrage/clients) — définir un terme par défaut par client
- [Écriture de paiement](https://doc.dokos.io/v5/dokos/comptabilite/ecriture-paiements) — enregistrer le règlement


# Point de vente (TPV)

Le point de vente de Dokos permet d'encaisser des clients directement depuis l'interface, en générant une facture de vente et en enregistrant le paiement en une seule opération. Il prend en charge plusieurs modes de paiement simultanés, s'intègre avec des terminaux de paiement physiques ou des passerelles en ligne, et permet désormais la vente de produits avec gestion de stock en temps réel.

Pour accéder au point de vente, allez sur :

> Accueil > Ventes > **Point de vente**

## Vente de la Dokoboard via le TPV :badge{text="Dokos" type="warning"}

Dokos permet désormais de vendre la **Dokoboard** (tableau de bord physique) directement depuis le point de vente, avec une gestion de stock garantie. Lorsqu'un opérateur ajoute une Dokoboard à une facture de caisse, le système vérifie automatiquement la disponibilité en stock et réserve les articles pour éviter les surventes.

> **Exemple — Dokompany**
> Maison Verte SARL souhaite acheter une Dokoboard pour son nouveau point de vente. L'opérateur sélectionne le produit "Dokoboard" dans la liste des articles. Dokos vérifie le stock disponible et affiche une confirmation si l'article est disponible. Une fois la transaction validée, le stock est automatiquement déduit et réservé pour cette vente.

Pour activer cette fonctionnalité, assurez-vous que :

- Le produit "Dokoboard" est correctement configuré dans le système avec un **type d'article** défini comme "Produit".
- Le stock est mis à jour dans l'entrepôt associé au point de vente.
- Le mode de paiement est configuré pour accepter les transactions.

::mermaid
flowchart TD
A\[Ajouter Dokoboard à la facture] --> B{Vérification du stock}
B -->|Stock disponible| C\[Réservation du stock]
B -->|Stock insuffisant| D\[Afficher erreur]
C --> E\[Validation de la transaction]
E --> F\[Mise à jour du stock]

::

## Paiement par terminal SumUp :badge{text="Dokos" type="warning"}

Dokos s'intègre avec les terminaux de paiement **SumUp** directement depuis l'interface du point de vente. Lorsqu'un mode de paiement est configuré avec la passerelle SumUp, Dokos crée automatiquement une demande de paiement et génère un lien profond vers l'application SumUp pour déclencher la transaction sur le terminal.

Pour qu'un mode de paiement utilise SumUp, il faut configurer une **Passerelle de paiement** dont les paramètres sont de type `Sumup Settings` dans le compte associé à la société.

> **Exemple — Dokompany**
> Maison Verte SARL règle un achat de 150 € en carte. L'opérateur sélectionne le mode de paiement "Carte SumUp" dans la caisse. Dokos crée une demande de paiement de 150 € et ouvre l'application SumUp sur la tablette avec le montant pré-rempli. L'opérateur pose la carte sur le terminal — le paiement est validé et la facture est clôturée automatiquement.

Le client doit avoir une **adresse email** renseignée sur sa fiche pour que le paiement SumUp puisse être initié.

::demo-link{demo="Dokompany" doctype="POS Invoice"}
Voir les factures de point de vente dans la démo
::

## Paiement par téléphone au point de vente :badge{text="Dokos" type="warning"}

Les modes de paiement de type **Téléphone** permettent d'initier un paiement directement sur le mobile du client depuis la caisse. Dokos crée une demande de paiement et envoie la requête à la passerelle, qui notifie le client sur son téléphone pour valider la transaction.

Le numéro de mobile du client doit être renseigné sur la facture de caisse avant de lancer le paiement.

> **Exemple — Dokompany**
> Un client passe commande au comptoir et préfère payer depuis son mobile. L'opérateur entre le numéro de téléphone, sélectionne le mode de paiement "Mobile" et clique sur **Envoyer**. Le client reçoit une notification et valide le paiement — sans carte, sans terminal.

## Validation de l'adresse email à la caisse :badge{text="Dokos" type="warning"}

Lorsqu'un opérateur saisit une adresse email sur la facture de caisse, Dokos valide automatiquement le format avant d'enregistrer la transaction. Un email mal formé est signalé immédiatement, ce qui évite les erreurs d'envoi de reçu.

## Voir aussi

- [Demande de paiement](https://doc.dokos.io/v5/dokos/ventes/demande-de-paiement)
- [Passerelles de paiement](https://doc.dokos.io/v5/dokos/comptabilite/passerelles-paiements)
- [Certification caisse](https://doc.dokos.io/v5/dokos/certification-caisse)
- [Gestion des stocks](https://doc.dokos.io/v5/dokos/stocks)


# Devis

Vous êtes ici parce que vous devez envoyer une proposition à un client ou un prospect avant de prendre une commande. Un devis dans Dokos peut devenir une commande client en un clic dès que le client accepte.

::mermaid
flowchart LR
id1(Piste)-->id7(Opportunité)
id7-->id8(Devis)
id8-->id2(Commande client)
id2-->id4(Facture de vente)

::

---

## Avant de commencer

Vous pouvez créer un devis pour :

- Un **client existant** — sa fiche, ses prix et ses conditions sont récupérés automatiquement
- Un **prospect** — sans fiche client complète
- Depuis une **opportunité CRM** — cliquez sur **Créer > Devis** depuis l'opportunité

::callout{icon="i-heroicons-information-circle"}
Un devis peut être créé pour un **prospect** sans fiche client complète. En revanche, la conversion en commande client nécessitera une fiche client avec au minimum un nom et une adresse.
::

::card
---
color: yellow
title: Créer un devis dans la démo
to: https://demo.dokos.cloud/app/quotation/new-quotation-ssddfjasjh
---
::

---

## Créer un devis

Depuis **Ventes > Devis**, cliquez sur **Ajouter**.

1. Sélectionnez le **client** ou le **prospect**
2. Vérifiez la **date de validité** — au-delà de cette date, le devis passe en statut Expiré
3. Ajoutez vos **articles** — les prix se remplissent automatiquement depuis la liste de prix du client
4. Appliquez une **remise** si nécessaire — par article ou sur le total
5. Ajoutez un **code promotionnel** si applicable
6. **Enregistrez** puis **Validez**

Une fois validé, le devis ne peut plus être modifié. Pour l'envoyer, utilisez le bouton **Email** ou exportez-le en PDF.

---

## Modifier un devis après envoi

**Le client veut des changements sur le même devis** — annulez le devis, modifiez-le, revalidez et renvoyez.

**Le client veut comparer deux versions** — dupliquez le devis via **Menu > Dupliquer**, modifiez la copie et envoyez les deux.

---

## Convertir en commande client

Dès que le client accepte, ouvrez le devis et cliquez sur **Créer > Commande client**. Tous les articles, prix et conditions sont repris automatiquement.

---

## Marquer un devis comme perdu

Si le client ne donne pas suite, cliquez sur **Considérer comme perdu** et sélectionnez une raison (prix trop élevé, choix d'un concurrent, délais...). Ces données alimentent vos rapports d'analyse commerciale et vous aident à identifier les tendances.

---

## Cas spécifique : devis avec articles réservables

Si vous gérez des réservations (tiers-lieu, location de matériel), vous pouvez créer le devis directement depuis une réservation d'articles — les créneaux sont bloqués dès la création.

Depuis la liste **Réservations d'articles**, sélectionnez les réservations concernées, puis **Actions > Créer un devis**. Un onglet **Réservations associées** apparaît sur le devis pour vérifier les liens.

---

## Statuts

| Statut    | Ce que ça veut dire                     |
| --------- | --------------------------------------- |
| Brouillon | Enregistré, pas encore validé           |
| Ouvert    | Validé, en attente de réponse du client |
| Commandé  | Converti en commande client             |
| Refusé    | Client a décliné                        |
| Expiré    | Date de validité dépassée sans réponse  |
| Perdu     | Marqué manuellement comme perdu         |

---

## Ce qui peut bloquer

**"Article sans prix"** — aucun prix n'est défini dans la liste de prix active pour ce client. Ajoutez-le manuellement ou vérifiez la liste de prix associée au client.

**"Devis expiré"** — si vous voulez quand même créer une commande depuis un devis expiré, activez l'option **Autoriser la création de commandes pour les devis expirés** dans les paramètres de vente.

**Le devis ne se convertit pas en commande** — vérifiez que le devis est bien en statut *Ouvert* (validé). Un brouillon ne peut pas être converti.

---

## Vue d'ensemble des devis (tableau de bord liste) :badge{text="Dokos" type="warning"}

La liste des devis affiche des **cartes de statut** avec les montants totaux par état :

| Carte         | Contenu                               |
| ------------- | ------------------------------------- |
| **Brouillon** | Devis non encore validés              |
| **Ouvert**    | Validés, en attente de réponse client |
| **Commandé**  | Convertis en commande client          |
| **Perdu**     | Marqués comme perdus                  |

Ces cartes donnent une vue instantanée du pipeline commercial sans ouvrir chaque devis.

## Indicateurs de marge :badge{text="Dokos" type="warning"}

Sur chaque devis, des **cartes indicateurs de rentabilité** s'affichent directement sur le formulaire :

- **Marge brute (€)** — écart entre le total HT et le coût de revient total
- **Marge brute (%)** — ratio marge/chiffre d'affaires
- **Markup (%)** — ratio marge/coût

Les indicateurs s'actualisent dès que les lignes ou les prix changent, permettant d'ajuster une offre avant son envoi pour maintenir les objectifs de rentabilité.

## Sélection partielle d'articles à la conversion :badge{text="Dokos" type="warning"}

Lors de la conversion d'un devis en **Commande client** ou en **Facture de vente**, Dokos permet de **sélectionner uniquement certaines lignes** du devis. Seules les lignes cochées sont reprises dans le document cible.

> **Exemple — Maison Verte SARL**
> Un devis de 5 articles est envoyé. Le client accepte 3 articles immédiatement et veut réfléchir pour les 2 autres. À la conversion, le commercial coche uniquement les 3 articles confirmés pour créer la commande, laissant le devis ouvert pour le reste.

## Et ensuite

- [Commande client](https://doc.dokos.io/v5/dokos/ventes/commande-client) — transformer le devis accepté en commande
- [Facture de vente](https://doc.dokos.io/v5/dokos/ventes/facture-de-vente) — facturer depuis la commande
- [Codes promotionnels](https://doc.dokos.io/v5/dokos/ventes/code-promotionnel) — créer et gérer vos remises
- [Modifier la numérotation](https://doc.dokos.io/v5/dokos/parametrage/demarrage/masques-numerotation) — personnaliser le format de vos numéros de devis


# Commande client

Vous êtes ici parce qu'un client a accepté votre devis ou passe une commande directe. La commande client est le document pivot du cycle de vente : c'est depuis elle que vous créez les bons de livraison, les factures et les paiements.

::mermaid
flowchart LR
id8(Devis)-->id2(Commande client)
id2-->id4(Facture de vente)
id2-->id9(Bon de livraison)
id2-->id6(Acompte)

::

---

## Avant de commencer

Dans la plupart des cas, vous arrivez ici depuis un devis accepté — cliquez sur **Créer > Commande client** depuis le devis. Tout est déjà rempli.

Si vous créez une commande directe sans devis, vous avez besoin d'une fiche client et d'au moins un article avec son prix.

---

## Créer une commande client

Depuis **Ventes > Commande client**, cliquez sur **Ajouter**.

1. Sélectionnez le **client**
2. Définissez la **date de livraison** souhaitée
3. Ajoutez vos **articles** et quantités — les prix se remplissent automatiquement
4. Vérifiez les **taxes** et appliquez une remise si nécessaire
5. **Enregistrez** puis **Validez**

::callout{icon="i-heroicons-information-circle"}
La **date de livraison** est la date souhaitée par le client. Elle est informative et ne bloque pas la validation. La date réelle est enregistrée sur le bon de livraison.
::

Une fois validée, la commande ne peut plus être modifiée directement. Vous pouvez cependant mettre à jour les articles via le bouton **Mettre à jour les articles**, tant qu'ils n'ont pas encore été livrés.

---

## Demander un paiement en ligne :badge{text="Dokos" type="warning"}

Vous pouvez envoyer une **demande de paiement** à votre client pour qu'il règle tout ou partie de sa commande en ligne, avant même la livraison ou la facturation.

### Depuis la commande

1. Cliquez sur le bouton **Demander un paiement** dans l'onglet **Collecte des paiements** (nouvel onglet ajouté automatiquement).
2. Un panneau latéral s'ouvre avec les options suivantes :


   - **Montant** : par défaut le total de la commande, modifiable pour un paiement partiel.
   - **Échéancier** : si vous souhaitez proposer un paiement en plusieurs fois, ajoutez plusieurs lignes avec des montants et dates d'échéance.
   - **Mode de paiement** : sélectionnez la passerelle de paiement à utiliser (Stripe, GoCardless, etc.).
   - **Destinataire** : email du client (modifiable).
   - **Modèle d'email** : choisissez un modèle prédéfini ou personnalisez le message.
   - **Joindre le PDF** : cochez pour envoyer la commande en pièce jointe.
   - **Envoyer immédiatement** : cochez pour envoyer l'email dès la création de la demande.
3. Cliquez sur **Envoyer la demande de paiement** pour finaliser.

::callout{icon="i-heroicons-information-circle"}
Si vous configurez un **échéancier**, chaque ligne générera une demande de paiement distincte avec sa propre date d'envoi et son lien de paiement. Le client recevra autant d'emails que de lignes dans l'échéancier.
::

### Suivi de la demande

Dans l'onglet **Collecte des paiements** de la commande, vous trouverez :

- Un **pill de statut** pour chaque demande envoyée (Brouillon, Envoyée, Payée, Annulée).
- Des **actions rapides** pour chaque demande :


  - **Copier le lien de paiement** : pour envoyer manuellement le lien au client.
  - **Renvoyer l'email** : pour renvoyer la demande si le client ne l'a pas reçue.
  - **Annuler la demande** : pour annuler une demande envoyée par erreur.
  - **Voir la demande** : pour ouvrir la demande de paiement complète.

::mermaid
flowchart LR
id1(Commande client)-->id2(Demander un paiement)
id2-->id3(Email envoyé au client)
id3-->id4(Client clique sur le lien)
id4-->id5(Page de paiement en ligne)
id5-->id6(Paiement validé)
id6-->id7(Statut mis à jour sur la commande)

::

### Exemple d'utilisation

> **Maison Verte SARL** passe une commande de 1 200 €. Le commercial propose un paiement en 3 fois : 400 € à la commande, 400 € à la livraison, et 400 € 30 jours après livraison. Il configure un échéancier avec 3 lignes dans le panneau **Demander un paiement**, et envoie les demandes. Le client reçoit 3 emails avec des liens de paiement distincts, et Dokos suit automatiquement les paiements reçus.

---

## Ce que vous pouvez créer depuis une commande validée

Depuis le bouton **Créer** en haut de la commande :

- **Bon de livraison** — préparer et enregistrer l'expédition
- **Facture de vente** — facturer tout ou partie de la commande
- **Acompte** — demander un paiement partiel avant livraison
- **Demande de paiement** — envoyer un lien de paiement au client
- **Projet** — créer un projet lié à cette commande
- **Abonnement** — transformer la commande en commande récurrente

::callout{icon="i-heroicons-information-circle"}
L'**acompte** crée une facture partielle liée à la commande. Quand vous créez la facture finale, Dokos déduit automatiquement ce qui a déjà été payé via *Acomptes et Avances > Récupérer les acomptes reçus*.
::

---

## Suivre l'avancement

Sur chaque commande validée, Dokos affiche en temps réel :

- Le **montant facturé** et le **pourcentage restant à facturer**
- Les **articles livrés** et ceux encore en attente

Le statut se met à jour automatiquement : *À livrer et facturer*, *À facturer*, *À livrer*, *Terminé*.

---

## Statuts

| Statut               | Ce que ça veut dire                  |
| -------------------- | ------------------------------------ |
| Brouillon            | Enregistrée, pas encore validée      |
| En attente           | Validée, en attente de traitement    |
| À livrer et facturer | Ni livrée ni facturée                |
| À facturer           | Livrée mais pas encore facturée      |
| À livrer             | Facturée mais pas encore livrée      |
| Terminé              | Livrée et facturée intégralement     |
| Annulé               | Commande annulée                     |
| Clôturé              | Fermée manuellement avant complétion |

::callout{icon="i-heroicons-information-circle"}
**Clôturé** sert à fermer une commande partiellement traitée que vous ne souhaitez plus poursuivre — sans annuler les bons de livraison ou factures déjà créés. **Annulé** efface complètement la commande et annule toutes les transactions associées.
::

---

## Ce qui peut bloquer

**"Stock insuffisant"** — si la gestion des stocks est activée, Dokos vérifie la disponibilité à la validation. Vérifiez les quantités disponibles dans l'entrepôt source.

**"Impossible de créer la facture"** — la commande doit être en statut *Validé*. Un brouillon ne peut pas être facturé.

**"Article déjà livré"** — vous ne pouvez pas supprimer un article qui a déjà un bon de livraison associé. Annulez d'abord le bon de livraison.

**Prix modifié après validation** — si vous avez besoin de changer un prix, utilisez **Mettre à jour les articles** ou annulez et recréez la commande.

---

## Vue d'ensemble des commandes (tableau de bord liste) :badge{text="Dokos" type="warning"}

La liste des commandes clients affiche des **cartes de statut** en haut de page, avec les montants totaux pour chaque état :

| Carte                    | Contenu                                 |
| ------------------------ | --------------------------------------- |
| **Brouillon**            | Commandes non encore validées           |
| **À livrer et facturer** | Validées, sans livraison ni facturation |
| **À facturer**           | Livrées, pas encore facturées           |
| **À livrer**             | Facturées, pas encore livrées           |
| **Clôturé**              | Fermées manuellement                    |

Ces cartes permettent d'identifier en un coup d'œil les commandes nécessitant une action, sans ouvrir chaque fiche.

---

## Indicateurs de marge sur les lignes :badge{text="Dokos" type="warning"}

Sur chaque commande validée ou en brouillon, Dokos affiche des **cartes indicateurs de rentabilité** calculées à partir des lignes :

- **Marge brute (€)** — différence entre le total HT et le coût total des articles
- **Marge brute (%)** — ratio marge/chiffre d'affaires
- **Markup (%)** — ratio marge/coût de revient

Les indicateurs s'affichent en vert lorsque la commande est profitable, en rouge en cas de perte. La méthode de calcul (marge ou markup) se configure dans les **Paramètres de vente**.

---

## Prix de revient unitaire :badge{text="Dokos" type="warning"}

Chaque ligne de commande peut recevoir un **prix de revient unitaire**, qui sert à :

1. Calculer les indicateurs de marge ci-dessus
2. Alimenter automatiquement le prix d'achat lors de la création d'une **Commande fournisseur** depuis cette commande client

> **Exemple — Maison Verte SARL**
> Une ligne de commande avec un prix de vente de 150 € et un prix de revient de 90 € affiche une marge de 60 € (40 %). Lorsque le service achats crée la commande fournisseur correspondante, le prix d'achat est pré-rempli à 90 €.

---

## Commande récurrente — alerte de création d'abonnement :badge{text="Dokos" type="warning"}

Lorsqu'une commande contient des **articles récurrents** (configurés pour générer un abonnement), Dokos affiche une alerte visuelle :

- **Brouillon** — bandeau orange indiquant qu'un abonnement sera créé automatiquement à la validation
- **Validée** — bandeau vert avec un lien vers l'abonnement créé

---

## Date de livraison automatique sur les nouvelles lignes :badge{text="Dokos" type="warning"}

Si une date de livraison est déjà renseignée sur la commande, les **nouvelles lignes ajoutées** héritent automatiquement de cette date. Cela évite d'avoir à renseigner manuellement la date sur chaque article ajouté après la création initiale.

---

## Et ensuite

- [Facture de vente](https://doc.dokos.io/v5/dokos/ventes/facture-de-vente) — facturer depuis cette commande
- [Factures d'acompte](https://doc.dokos.io/v5/dokos/comptabilite/acomptes) — encaisser un acompte avant livraison
- [Demander un paiement en ligne](https://doc.dokos.io/#demander-un-paiement-en-ligne) — envoyer un lien de paiement sécurisé à votre client
- [Termes de paiement](https://doc.dokos.io/v5/dokos/ventes/termes-de-paiement) — facturer en plusieurs fois
- [Abonnements](https://doc.dokos.io/v5/dokos/ventes/abonnements) — transformer en commande récurrente


# Factures de vente

Vous êtes ici parce que vous avez besoin de facturer un client. Dans la plupart des cas, Dokos a déjà récupéré les informations depuis votre commande ou votre bon de livraison. Il ne vous reste qu'à vérifier et valider.

::mermaid
flowchart LR
id4-->id9(Bon de livraison)
id2(Commande client)-->id4(Facture de vente)
id4-->id5(Écriture de paiement)
id2-->id6("Acompte")
id1(Devis)-->id2

::

---

## Avant de commencer

Vérifiez que vous avez bien :

- Une **fiche client** créée
- Au moins un **article** avec son prix

Si vous facturez depuis une commande ou un bon de livraison, tout sera récupéré automatiquement.

---

## Créer une facture

Depuis **Ventes** ou **Comptabilité > Comptes clients**, ouvrez la liste des factures de vente et cliquez sur **Ajouter**.

Une fenêtre vous propose trois points de départ — choisissez celui qui correspond à votre situation :

### Depuis une commande client

C'est le cas le plus courant. Ouvrez votre commande client et cliquez sur **Créer > Facture**. Les articles, prix et client sont déjà remplis.

### Facture directe (sans commande)

1. Sélectionnez le **client**
2. Ajoutez vos **articles** et quantités — les prix se remplissent automatiquement si une liste de prix est configurée
3. Vérifiez la **date d'échéance**
4. **Enregistrez** puis **Validez**

### Facture d'acompte

Depuis votre commande client, cliquez **Créer > Facture**, puis cochez **Facture d'acompte**. Le montant et le compte comptable sont remplis automatiquement selon le pourcentage configuré — vous n'avez plus besoin de créer un article d'acompte séparé.

Quand vous créez la facture finale, allez dans **Acomptes et Avances** et cliquez **Récupérer les acomptes reçus** — Dokos déduit automatiquement ce qui a déjà été payé.

---

## Demander un paiement en ligne :badge{text="Dokos" type="warning"}

Une fois votre facture validée, vous pouvez envoyer une **demande de paiement** à votre client pour qu'il règle directement en ligne via une passerelle de paiement (Stripe, GoCardless, etc.).

### Depuis la facture

1. Cliquez sur le bouton **Demander un paiement** dans l'onglet **Collecte des paiements** (nouvel onglet ajouté automatiquement).
2. Un panneau latéral s'ouvre avec les options suivantes :


   - **Montant** : par défaut le solde restant, modifiable si vous souhaitez demander un paiement partiel.
   - **Mode de paiement** : sélectionnez la passerelle de paiement à utiliser (Stripe, GoCardless, etc.).
   - **Destinataire** : email du client (modifiable).
   - **Modèle d'email** : choisissez un modèle prédéfini ou personnalisez le message.
   - **Joindre le PDF** : cochez pour envoyer la facture en pièce jointe.
   - **Envoyer immédiatement** : cochez pour envoyer l'email dès la création de la demande.
3. Cliquez sur **Envoyer la demande de paiement** pour finaliser.

::callout{icon="i-heroicons-information-circle"}
Si vous ne souhaitez pas envoyer immédiatement la demande, décochez **Envoyer immédiatement**. La demande sera créée en brouillon et vous pourrez l'envoyer plus tard depuis la liste des **Demandes de paiement**.
::

### Suivi de la demande

Dans l'onglet **Collecte des paiements** de la facture, vous trouverez :

- Un **pill de statut** indiquant l'état de la demande (Brouillon, Envoyée, Payée, Annulée).
- Des **actions rapides** :


  - **Copier le lien de paiement** : pour envoyer manuellement le lien au client.
  - **Renvoyer l'email** : pour renvoyer la demande si le client ne l'a pas reçue.
  - **Annuler la demande** : pour annuler une demande envoyée par erreur.
  - **Voir la demande** : pour ouvrir la demande de paiement complète.

::mermaid
flowchart LR
id1(Facture de vente)-->id2(Demander un paiement)
id2-->id3(Email envoyé au client)
id3-->id4(Client clique sur le lien)
id4-->id5(Page de paiement en ligne)
id5-->id6(Paiement validé)
id6-->id7(Statut mis à jour sur la facture)

::

### Exemple d'utilisation

> **Maison Verte SARL** a une facture de 500 € en attente de paiement. Le service comptable clique sur **Demander un paiement**, sélectionne Stripe comme mode de paiement, et envoie la demande. Le client reçoit un email avec un lien sécurisé pour régler en ligne. Une fois le paiement validé, le statut de la facture passe automatiquement à **Payé** dans Dokos.

---

## Remises et marges

**Remise sur la facture** — appliquez une remise globale en pourcentage ou en montant dans la section *Remise supplémentaire*. Le total net après remise s'affiche directement sur le document, et le pourcentage apparaît à l'impression.

**Calcul de marge** — calculez votre marge brute directement sur la facture en choisissant la base : taux de valorisation, dernier prix d'achat, ou prix fournisseur. Un pourcentage de marge cible recalcule le prix de vente automatiquement.

---

## Facturation électronique (FacturX)

Si l'application **eTransactions** est installée et configurée, Dokos peut générer automatiquement une facture au format **FacturX** (PDF/A-3 avec données XML intégrées) à chaque validation de facture de vente.

Ce format est exigé pour certains clients publics (Chorus Pro) et recommandé dans le cadre de la réforme de la facturation électronique.

→ [En savoir plus sur la génération FacturX](https://doc.dokos.io/v5/dokos/ventes/facturx)

---

## Statuts

| Statut               | Ce que ça veut dire                      |
| -------------------- | ---------------------------------------- |
| Brouillon            | Enregistrée, pas encore validée          |
| Soumis               | Validée, écritures comptables créées     |
| Payé                 | Paiement enregistré et soldé             |
| Impayé               | En attente de paiement, dans les délais  |
| En retard            | Date d'échéance dépassée                 |
| Note de crédit émise | Un avoir a été créé sur cette facture    |
| Annulé               | Facture annulée, impact comptable annulé |

::callout{icon="i-heroicons-information-circle"}
**Soumis** signifie que la facture est validée et que les écritures comptables sont générées — ce n'est pas encore un paiement. Le statut passe à **Payé** seulement après avoir enregistré un règlement.

**Note de crédit** est le terme comptable pour un **avoir** : un document qui annule tout ou partie d'une facture déjà validée.
::

---

## Ce qui peut bloquer

**"Compte débiteur manquant"** — vérifiez que la fiche client a bien un compte comptable associé, ou que les paramètres de comptabilité ont un compte débiteur par défaut.

**"Article sans prix"** — si aucun prix n'est défini dans la liste de prix active, ajoutez-le manuellement sur la ligne ou dans la fiche article.

**"Période comptable clôturée"** — la date de la facture tombe dans une période déjà clôturée. Modifiez la date comptable ou rouvrez la période.

**Acompte non récupéré** — si l'acompte n'apparaît pas automatiquement, vérifiez que la facture d'acompte est bien liée à la même commande client.

---

## Et ensuite

- **Enregistrer un paiement** — depuis la facture validée, cliquez **Créer > Écriture de paiement**
- **Émettre un avoir** — si le client retourne des articles ou si vous devez corriger une facture validée
- [Facture FacturX](https://doc.dokos.io/v5/dokos/ventes/facturx) — générer une facture électronique conforme EN 16931
- [Demander un paiement en ligne](https://doc.dokos.io/#demander-un-paiement-en-ligne) — envoyer un lien de paiement sécurisé à votre client
- [Modifier la numérotation des factures](https://doc.dokos.io/v5/dokos/parametrage) — pour personnaliser le format de vos numéros
- [Configurer les taxes](https://doc.dokos.io/v5/dokos/ventes/taxes) — pour paramétrer votre régime de TVA
- [Termes de paiement](https://doc.dokos.io/v5/dokos/ventes/termes-de-paiement) — pour facturer en plusieurs tranches


# Taxes de vente

Vous êtes ici parce que vous devez configurer la TVA sur vos documents de vente, ou parce que certains articles ont un taux différent du taux standard.

---

## Avant de commencer

Dans Dokos, les taxes sont gérées via des **modèles de taxes**. Vous créez un modèle une fois — il s'applique automatiquement sur tous vos documents.

Si vous êtes en France avec un seul régime de TVA, un seul modèle suffit dans la plupart des cas. Des modèles pour les taxes courantes sont déjà préconfigurés — vérifiez d'abord si le vôtre existe avant d'en créer un nouveau.

---

## Créer un modèle de taxes

Depuis **Ventes > Paramètres > Modèle de taxes de vente et frais**, cliquez sur **Ajouter**.

1. Donnez un **nom explicite** au modèle (ex : &#x2A;TVA 20%*, &#x2A;TVA réduite 10%*)
2. Sélectionnez votre **régime de TVA** — Dokos configure le calcul automatiquement
3. Cochez **Par défaut** si ce modèle doit s'appliquer sur toutes les nouvelles transactions
4. **Enregistrez**

::callout{icon="i-heroicons-light-bulb"}
**Nouveauté V5** — Vous sélectionnez votre régime de TVA et Dokos configure le tableau de taxes automatiquement. L'affichage détaillé ligne par ligne reste accessible via le bouton **Affichage** pour les cas avancés.

---

**Sur V4** — vous devez renseigner manuellement chaque ligne du tableau : type de calcul (*Sur total net*, *Réel*, *Sur quantité article*...), compte comptable et taux.
::

---

## Appliquer un taux différent sur un article

Si un article est soumis à un taux différent du taux standard (ex : taux réduit sur certains produits), créez un **modèle de taxe sur les articles** et associez-le à la fiche article.

Depuis **Comptabilité > Taxes > Modèle de taxe sur les articles** :

1. Créez un nouveau modèle avec le compte de taxe concerné et le taux spécifique
2. Sur la **fiche article**, section **Taxes**, associez ce modèle

::callout{icon="i-heroicons-information-circle"}
Le taux défini sur l'article est **prioritaire** sur le modèle général. Pour un article totalement exonéré, indiquez 0 % comme taux dans le modèle de taxe sur les articles.

Pour que ce système fonctionne, le compte de taxe de votre modèle article doit aussi être présent dans votre modèle de taxes de vente général.
::

---

## Exclure complètement une taxe sur un article

Certains articles peuvent être totalement hors champ d'une taxe spécifique — par exemple un article exonéré de TVA alors que votre modèle général applique une TVA à 20 %.

Pour cela, Dokos propose l'option **Non applicable** dans le modèle de taxe sur les articles.

Depuis **Comptabilité > Taxes > Modèle de taxe sur les articles** :

1. Créez ou ouvrez le modèle de taxe lié à l'article
2. Ajoutez une ligne avec le compte de taxe concerné
3. Dans la colonne **Taux de taxe**, cochez l'option **Non applicable**
4. **Enregistrez** et associez ce modèle à la fiche article

Quand ce modèle est actif sur un article, Dokos ignore complètement cette taxe pour cet article — même si elle est présente dans le modèle de taxes général de la transaction.

::callout{icon="i-heroicons-information-circle"}
**Différence avec un taux à 0 %** : indiquer 0 % laisse la ligne de taxe visible dans le document (montant nul). L'option *Non applicable* supprime totalement la taxe du calcul pour cet article, sans ligne résiduelle.
::

::mermaid
flowchart TD
A\[Article dans une transaction] --> B{Modèle de taxe\nassocié à l'article ?}
B -- Non --> C\[Taux du modèle général]
B -- Oui --> D{Option dans le modèle article}
D -- Taux défini --> E\[Taux de l'article prioritaire]
D -- Taux à 0 % --> F\[Taxe affichée à 0 €]
D -- Non applicable --> G\[Taxe exclue du calcul]

::

---

## Ce qui peut bloquer

**« Aucune taxe sur la facture »** — vérifiez que le modèle de taxes est sélectionné dans la section *Taxes et frais* du document, ou qu'un modèle par défaut est configuré.

**« Le taux d'un article est incorrect »** — l'article a peut-être un modèle de taxe spécifique qui remplace le modèle général. Vérifiez la section *Taxes* de la fiche article.

**« Compte de taxe manquant »** — le compte comptable associé à la taxe doit être de type *Taxe*. Vérifiez dans votre plan comptable.

**« La taxe apparaît malgré le modèle article »** — si le compte de taxe du modèle article ne correspond pas exactement au compte présent dans le modèle général, l'exclusion *Non applicable* ne s'applique pas. Assurez-vous d'utiliser le même compte dans les deux modèles.

---

## Et ensuite

- [Factures de vente](https://doc.dokos.io/v5/dokos/ventes/facture-de-vente) — appliquer les taxes sur une facture
- [Termes de paiement](https://doc.dokos.io/v5/dokos/ventes/termes-de-paiement) — facturer en plusieurs tranches

## Héritage du modèle de taxe depuis le groupe d'articles :badge{text="Dokos" type="warning"}

Lorsqu'un article n'a pas de modèle de taxe défini directement sur sa fiche, Dokos remonte automatiquement la **hiérarchie des groupes d'articles** pour trouver un modèle applicable. Si le groupe immédiat n'en a pas non plus, le système continue vers le groupe parent, et ainsi de suite jusqu'à la racine.

> **Exemple — Maison Verte SARL**
> L'article "Chaise de bureau ergonomique" appartient au groupe "Mobilier", lui-même sous "Fournitures de bureau". Aucun modèle de taxe n'est défini sur l'article. Dokos trouve un modèle sur le groupe "Mobilier" et l'applique automatiquement — sans configuration article par article.

Cette logique évite de devoir assigner un modèle de taxe sur chaque article individuellement. Il suffit de configurer le modèle au bon niveau du groupe pour qu'il s'applique à tous les articles enfants.

## Ligne de taxe en mode déduction :badge{text="Dokos" type="warning"}

Les modèles de taxe sur les articles supportent un champ **Ajouter / Déduire** qui permet de configurer une ligne de taxe en mode **Déduction** plutôt qu'en ajout. Quand ce mode est actif, la taxe réduit le total au lieu de l'augmenter.

> **Exemple — Bureau Moderne**
> Un article vendu sous régime de TVA sur la marge comporte une ligne de taxe en mode Déduction représentant la part de marge non soumise à TVA. Dokos l'applique automatiquement en soustrayant cette valeur du calcul, sans intervention manuelle sur chaque facture.

Ce mode est utile pour les avoirs fiscaux, les remises fiscales ou les régimes de TVA particuliers (marge, auto-liquidation). Dokos propage correctement ce paramètre depuis le modèle de taxe sur les articles vers les lignes de taxes du document.

## Détail de TVA par article pour les sociétés françaises :badge{text="Dokos" type="warning"}

Pour les sociétés françaises, Dokos enrichit automatiquement chaque ligne d'article avec les données de TVA calculées : taux de TVA applicable, montant de TVA de la ligne et montant TTC. Ces données sont calculées en tenant compte uniquement des comptes de type **Taxe** — les frais non fiscaux sont exclus.

> **Exemple — Maison Verte SARL**
> Sur une facture de vente à 20 % de TVA, chaque ligne d'article affiche : montant HT 100 €, TVA 20 €, TTC 120 €. Ces données sont disponibles dans les exports (FEC, impression) sans calcul manuel.

Ce calcul est effectué automatiquement à la validation du document pour toutes les sociétés dont la localisation est configurée sur France. Les formats d'impression et le FEC utilisent ces champs pour garantir la conformité réglementaire française.


# Abonnements

Vous êtes ici parce que vous souhaitez mettre en place une facturation récurrente pour un client : adhésion, abonnement mensuel, location longue durée.

::mermaid
flowchart LR
CC(Commande client)-->AB(Abonnement)
AB-->DP(Demande de paiement)
DP-->P(Paiement)
P-->F(Facture)

::

---

## Avant de commencer

Pour créer un abonnement, vous avez besoin :

- D'un **article configuré comme récurrent** — dans la fiche article, activez l'option de récurrence
- D'une **fiche client** existante

---

## Créer un abonnement

Depuis **Ventes > Abonnements**, cliquez sur **Ajouter** — ou depuis une commande client validée, cliquez sur **Créer > Abonnement**.

1. Sélectionnez le **client**
2. Définissez la **période de récurrence** : mensuelle, trimestrielle, annuelle
3. Choisissez si la facture est générée en **début ou en fin de période**
4. Ajoutez vos **articles** ou sélectionnez un **plan d'abonnement**
5. Configurez le **mode de paiement** si applicable
6. **Enregistrez**

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Le choix entre facturation en début ou fin de période **ne peut plus être modifié** une fois l'abonnement enregistré. Si vous vous trompez, créez un nouvel abonnement.
::

---

## Visualiser le total net d'un abonnement

Depuis cette version, chaque abonnement affiche désormais un **total net** dans l'en-tête de la fiche. Ce total représente la somme des montants des articles de l'abonnement, après application des éventuelles remises, mais avant les taxes.

### Où le trouver ?

1. Ouvrez un abonnement existant depuis **Ventes > Abonnements**.
2. Dans la partie supérieure de la fiche, sous le nom du client et la période de récurrence, vous verrez une nouvelle ligne **Total net**.

::callout{icon="i-heroicons-information-circle"}
Le total net est calculé automatiquement à partir des articles de l'abonnement et mis à jour en temps réel lorsque vous modifiez les quantités ou les remises.
::

### Exemple d'utilisation

> **Maison Verte SARL** souscrit à un abonnement mensuel pour un service de maintenance (150 € HT) et un accès à un espace de coworking (200 € HT). Une remise de 10 % est appliquée sur le service de maintenance. Le **total net** affiché sera de **335 € HT** (150 € × 0,9 + 200 €). Ce montant est visible immédiatement dans l'abonnement, ce qui permet de vérifier rapidement le coût récurrent pour le client avant de générer les factures.

---

## Demander un paiement en ligne :badge{text="Dokos" type="warning"}

Pour les abonnements avec paiement manuel, vous pouvez envoyer une **demande de paiement** à chaque échéance pour que le client règle sa facture en ligne.

### Depuis l'abonnement

1. Dans l'onglet **Collecte des paiements**, cliquez sur **Demander un paiement** pour la facture concernée.
2. Un panneau latéral s'ouvre avec les options suivantes :


   - **Montant** : par défaut le total de la facture, modifiable pour un paiement partiel.
   - **Mode de paiement** : sélectionnez la passerelle de paiement à utiliser (Stripe, GoCardless, etc.).
   - **Destinataire** : email du client (modifiable).
   - **Modèle d'email** : choisissez un modèle prédéfini ou personnalisez le message.
   - **Joindre le PDF** : cochez pour envoyer la facture en pièce jointe.
   - **Envoyer immédiatement** : cochez pour envoyer l'email dès la création de la demande.
3. Cliquez sur **Envoyer la demande de paiement** pour finaliser.

### Suivi des demandes

Dans l'onglet **Collecte des paiements** de l'abonnement, vous trouverez :

- Un **pill de statut** pour chaque demande envoyée (Brouillon, Envoyée, Payée, Annulée).
- Des **actions rapides** pour chaque demande :


  - **Copier le lien de paiement** : pour envoyer manuellement le lien au client.
  - **Renvoyer l'email** : pour renvoyer la demande si le client ne l'a pas reçue.
  - **Annuler la demande** : pour annuler une demande envoyée par erreur.
  - **Voir la demande** : pour ouvrir la demande de paiement complète.

::mermaid
flowchart LR
id1(Abonnement)-->id2(Facture générée)
id2-->id3(Demander un paiement)
id3-->id4(Email envoyé au client)
id4-->id5(Client clique sur le lien)
id5-->id6(Page de paiement en ligne)
id6-->id7(Paiement validé)
id7-->id8(Statut mis à jour sur la facture)

::

### Exemple d'utilisation

> **Maison Verte SARL** a un abonnement mensuel pour un service de maintenance. Chaque mois, Dokos génère automatiquement une facture de 150 €. Le service comptable clique sur **Demander un paiement** depuis l'onglet **Collecte des paiements** de l'abonnement, sélectionne Stripe comme mode de paiement, et envoie la demande. Le client reçoit un email avec un lien sécurisé pour régler en ligne. Une fois le paiement validé, le statut de la facture passe automatiquement à **Payé**.

---

## Modes de paiement

**Paiement automatique (passerelle)** — si le client a enregistré un moyen de paiement (Stripe, GoCardless...), Dokos déclenche le prélèvement automatiquement à chaque échéance.

**Paiement manuel** — si le champ est laissé vide, Dokos envoie un email avec un lien de paiement au client. Vous enregistrez le règlement manuellement et faites le rapprochement bancaire à réception.

::callout{icon="i-heroicons-information-circle"}
Pour les prélèvements SEPA avec GoCardless : une fois le client lié à un mandat valide, déclenchez le paiement directement depuis la demande de paiement via **Actions > Obtenir le paiement immédiatement**, sans envoyer de lien.
::

---

## Crédits de réservation

Pour les tiers-lieux, les abonnements peuvent inclure des **crédits de réservation** — une monnaie interne que les membres utilisent pour réserver des ressources (salles, équipements, postes de coworking).

Les crédits achetés via un abonnement sont débités automatiquement à chaque réservation sur le portail. Vous pouvez définir une date d'expiration pour les crédits non utilisés.

---

## Annuler un abonnement

Depuis l'abonnement, **Actions > Annuler l'abonnement**. Indiquez la date d'annulation et cochez si la dernière facture doit être calculée au prorata des jours restants.

---

## Ce qui peut bloquer

**"L'abonnement ne génère pas de facture"** — vérifiez que l'article est bien configuré comme récurrent et que l'abonnement est en statut *Actif*. Les abonnements sont actualisés toutes les heures — utilisez le bouton **Mettre à jour** pour forcer la vérification.

**"Montant à 0 lors du paiement Stripe"** — c'est le comportement normal pour le premier paiement : la carte est enregistrée, le prélèvement réel est effectué lors du cycle suivant.

**"La passerelle GoCardless n'apparaît pas"** — si le client est lié à un mandat valide, le lien de paiement GoCardless n'est pas proposé. Annulez les mandats existants pour en créer un nouveau.

---

## Et ensuite

- [Visualiser le total net d'un abonnement](https://doc.dokos.io/#visualiser-le-total-net-dun-abonnement) — comprendre comment le total net est calculé et affiché
- [Demander un paiement en ligne](https://doc.dokos.io/#demander-un-paiement-en-ligne) — envoyer un lien de paiement sécurisé pour les abonnements manuels
- [Commande client](https://doc.dokos.io/v5/dokos/ventes/commande-client) — créer un abonnement depuis une commande
- [Facture de vente](https://doc.dokos.io/v5/dokos/ventes/facture-de-vente) — suivre les factures générées par l'abonnement


# Partenaire commercial

Vous êtes ici parce que vous travaillez avec des revendeurs, des agents ou des distributeurs et vous souhaitez suivre leurs commissions sur vos ventes.

---

## Créer un partenaire commercial

Depuis **Ventes > Partenaire commercial**, cliquez sur **Ajouter**.

1. Saisissez le **nom** du partenaire
2. Définissez le **taux de commission** (en %)
3. Sélectionnez le **type** (revendeur, distributeur, agent, détaillant...)
4. **Enregistrez**

Une fois créé, sélectionnez le partenaire sur vos commandes clients ou factures — sa commission est calculée automatiquement sur le total net.

::callout{icon="i-heroicons-information-circle"}
La commission est calculée sur le **total net** (hors taxes), pas sur le montant TTC.
::

---

## Suivre les ventes via un partenaire

Chaque partenaire dispose d'une **URL de parrainage**. Quand un client passe commande via le panier en utilisant cette URL, le partenaire est automatiquement associé à la commande.

::callout{icon="i-heroicons-information-circle"}
L'URL de parrainage fonctionne via un paramètre dans l'adresse (ex : `https://votresite.com?sp=nomdupartenaire`). C'est ce paramètre que le partenaire intègre dans ses campagnes ou son site pour que ses prospects soient automatiquement tracés.
::

Vous pouvez aussi cocher **Afficher sur le site Web** pour que le partenaire soit visible publiquement sur votre site, avec son logo et une description.

---

## Rapports disponibles

Depuis **Ventes > Rapports** :

- **Résumé des commissions** — commissions dues par partenaire sur les commandes
- **Récapitulatif des transactions** — détail par article de commande
- **Variation par rapport aux objectifs** — écart entre cibles et performances réelles, par période

---

## Et ensuite

- [Commande client](https://doc.dokos.io/v5/dokos/ventes/commande-client) — associer un partenaire à une commande
- [Vendeur](https://doc.dokos.io/v5/dokos/ventes/commercial) — gérer vos équipes commerciales internes


# Code promotionnel

Vous êtes ici parce que vous souhaitez offrir une remise à un client via un code à saisir — lors d'une commande en ligne ou directement sur un devis.

---

## Avant de commencer

Un code promotionnel est lié à une **règle de tarification**. Créez d'abord la règle qui définit la remise (pourcentage, montant fixe, article offert), puis créez le code qui l'active.

Pour les codes utilisables sur le panier e-commerce, activez l'option dans **Paramètres du panier**.

---

## Créer un code promotionnel

Depuis **Ventes > Articles et Prix > Code promotionnel**, cliquez sur **Ajouter**.

1. Saisissez un **nom** (ex : *Bienvenue2024*)
2. Choisissez le **type** :


   - **Promotion** — génère un code lisible basé sur le nom (ex : BIENVENUE2024)
   - **Carte-cadeau** — génère un code aléatoire de 11 caractères (ex : AP48K7CT9LP)
3. Associez une **règle de tarification** avec l'indicateur *basé sur le code promotionnel* activé
4. Définissez la **validité** (dates de début et fin) et l'**utilisation maximale**
5. **Enregistrez**

---

## Appliquer un code

**Sur le panier** — le client saisit le code et clique sur *Appliquer le code de coupon* avant de valider sa commande.

**Sur une commande client** — saisissez le code directement dans le champ *Code promotionnel* du document.

---

## Ce qui peut bloquer

**"Le code ne s'applique pas"** — vérifiez que la règle de tarification associée a bien l'indicateur *basé sur le code promotionnel* activé, et que le code est dans sa période de validité.

**"Utilisation maximale atteinte"** — le compteur *Utilisé* a atteint la limite définie. Augmentez la limite ou créez un nouveau code.

---

## Et ensuite

- [Devis](https://doc.dokos.io/v5/dokos/ventes/devis) — appliquer un code sur un devis
- [Commande client](https://doc.dokos.io/v5/dokos/ventes/commande-client) — appliquer un code sur une commande


# Faq

> ##### Comment nommer mes factures en fonction de l'exercice fiscal en cours ?

La numérotation des factures dépend de la règle de nommage du document "Facture de ventes". :br
Par défaut, la règle est la suivante: `ACC-SINV-.YYYY.-`, YYYY représentant l'année de création de la facture, donc l'année en cours. :br
Pour avoir l'exercice fiscal, il faut changer cette règle et mettre plutôt `ACC-SINV-.FY.-`, avec FY pour Fiscal Year. :br&#x2A;Vous pouvez bien évidemment aussi changer également le préfixe.*

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
L'exercice fiscal utilisé pour nommer vos factures sera l'exercice fiscal par défaut, défini dans les **Valeurs par défaut globales**
::


# Factures FacturX

Le format **FacturX** est un standard franco-allemand de facturation électronique : il s'agit d'un fichier PDF/A-3 dans lequel sont intégrées des données XML structurées (norme EN 16931). Ce format est reconnu par les administrations et plateformes de dématérialisation (Chorus Pro, Factur-X, etc.).

Avec l'application **eTransactions**, Dokos peut générer automatiquement une facture FacturX à la validation (soumission) d'une facture de vente, sans aucune manipulation supplémentaire.

---

## Prérequis

- L'application **eTransactions** doit être installée sur votre site Dokos.
- Vous devez disposer des droits d'accès aux **Paramètres eTransactions**.

---

## Activer la génération automatique de FacturX

1. Allez dans **eTransactions > Paramètres eTransactions**.
2. Cochez l'option **Générer une facture FacturX à la soumission**.
3. Enregistrez.

À partir de ce moment, chaque facture de vente validée (soumise) générera automatiquement un fichier PDF/A-3 FacturX joint au document.

::callout{icon="i-heroicons-information-circle"}
La génération se déclenche **uniquement à la soumission** de la facture de vente. Les factures déjà soumises avant l'activation de l'option ne sont pas concernées rétroactivement.
::

---

## Générer manuellement un FacturX

Si vous souhaitez générer un FacturX pour une facture déjà soumise (ou tester la fonctionnalité), vous pouvez le faire depuis la fiche de la facture de vente :

1. Ouvrez la facture de vente soumise.
2. Cliquez sur le bouton **Générer FacturX** dans la barre d'actions.
3. Le fichier PDF/A-3 est généré et joint automatiquement à la facture.

---

## Où trouver le fichier généré

Le fichier FacturX est automatiquement attaché à la facture de vente dans la section **Pièces jointes** (panneau latéral droit). Son nom reprend le numéro de la facture.

Exemple : pour la facture `SINV-2025-00042` de **Maison Verte SARL**, le fichier joint s'appellera `SINV-2025-00042.pdf`.

Vous pouvez le télécharger directement depuis cet espace et l'envoyer à votre client ou à votre plateforme de dématérialisation.

---

## Ce qui est inclus dans le FacturX

Le fichier généré contient :

- Le **PDF visuel** de votre facture de vente, identique à votre impression standard.
- Un fichier **XML structuré** (profil EN 16931) intégré dans le PDF, lisible par les logiciels de comptabilité et les plateformes de dématérialisation.

Les données reprises dans le XML incluent notamment :

- Identifiants et coordonnées du vendeur et de l'acheteur
- Lignes d'articles avec quantités, prix unitaires et montants
- Taux et montants de TVA
- Numéro et date de la facture
- Date d'échéance et conditions de paiement

---

## Questions fréquentes

**La génération FacturX remplace-t-elle l'impression habituelle ?**
Non. Votre facture de vente habituelle reste accessible comme avant. Le FacturX est un fichier supplémentaire joint au document.

**Peut-on désactiver la génération automatique après coup ?**
Oui. Il suffit de décocher l'option dans les Paramètres eTransactions. Les futures soumissions ne généreront plus de FacturX automatiquement, mais vous pourrez toujours en générer manuellement depuis chaque facture.

**Le format FacturX est-il compatible avec Chorus Pro ?**
Le profil EN 16931 généré par Dokos est compatible avec les exigences de Chorus Pro pour les factures à destination des entités publiques. Vérifiez néanmoins les exigences spécifiques de votre client public avant envoi.

---

## Et ensuite

- [Factures de vente](https://doc.dokos.io/v5/dokos/ventes/facture-de-vente) — créer et valider une facture
- [Se connecter à une Plateforme Agréée](https://doc.dokos.io/v5/integrations/etransaction/plateformes-agreees) — configurer l'application de transactions électroniques


# Introduction

Pour accéder à **la liste de Projets**, allez sur :

> Accueil > **Projets**

![Cette image permet de visualiser la page d'accueil du module projet.](https://doc.dokos.io/pageaccueilprojet.png)

## 1. Projets

- [1. Projet](https://doc.dokos.io/v5/dokos/projets/projets)
- [2. Tâche](https://doc.dokos.io/v5/dokos/projets/taches)

## 2. Suivi du temps

- [1. Feuille de temps](https://doc.dokos.io/v5/dokos/projets/feuilles-de-temps)
- [2. Type d'activité](https://doc.dokos.io/v5/dokos/projets/types-activite)


# Projet

Un projet est un travail planifié qui est conçu pour trouver des informations sur quelque chose, pour produire quelque chose de nouveau ou pour améliorer quelque chose.

Dans Dokos, la gestion de projet est axée sur les tâches. Vous pouvez créer un projet et le diviser en plusieurs tâches.

Un projet a une large portée et peut donc être divisé en tâches. Par exemple, de proposer un nouveau smartphone pour l'année prochaine en tant que projet.
Ensuite, des choses comme la conception, le prototypage, les tests, la livraison, etc. deviennent des tâches dans le cadre du projet.

Bien que chaque tâche d'un projet puisse être attribuée à un individu ou à un groupe d'individus, l'attribution peut également être effectuée au niveau du projet.

Ces tâches peuvent être créées à partir d'un projet lui-même ou une tâche peut également être créée séparément.

---

Pour accéder à **la liste de Projet**, allez sur :

> Accueil > Projets > Projets > **Projet**

![liste\_projet.png](https://doc.dokos.io/content/projets/project/liste_projet.png)

## 1. Comment créer un projet ?

1. Allez dans la liste Projet et cliquez sur **➕ Ajouter Projet**.
2. Ajoutez les **détails** suivants :


   - **Nom du projet** : Titre du projet.
   - **Statut** : Le statut par défaut d'un projet sera « Ouvert » qui pourra ensuite être modifié en **Terminé** ou **Annulé**.
   - **Date de fin prévue** : Saisissez la date à laquelle vous envisagez de terminer le projet.
3. **Enregistrer**.

![détails\_projet.png](https://doc.dokos.io/content/projets/project/details_projet.png)

### 1.1 Options supplémentaires lors de la création d'un projet

1. **À partir d'un modèle** : Si vous disposez d'un modèle de projet existant , vous pouvez choisir de créer votre projet à l'aide de ce modèle.
2. **Date de début prévue** : si vous avez un calendrier fixe pour le projet, vous pouvez définir à la fois la date de début prévue et la date de fin prévue dans le formulaire.
3. **Type de projet** : Vous pouvez classer vos projets en différents types , par exemple, internes ou externes.
4. **Priorité** : Vous pouvez sélectionner le niveau de priorité du projet en fonction de son importance. Vous pouvez également ajouter plus de niveaux de priorité.
5. **Département** : si le projet appartient ou appartient à un département de l'organisation, vous pouvez l'ajouter ici.
6. **Est actif** : Un onglet Oui/Non, qui vous permet de modifier le statut actif du projet à n'importe quelle étape ultérieure.
7. **Méthode d'achèvement** : Vous pouvez suivre le % d'achèvement de votre projet en fonction de l'une des trois méthodes, à savoir. Manuel, achèvement de la tâche, progression de la tâche et poids de la tâche .

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
**Remarque** : Si le poids total des tâches n'est pas de 100, le résultat calculé sera divisé par le poids total. Par exemple, si le total des pondérations des tâches est de 70, le pourcentage d'achèvement = (70/0,8) % = 87,5 %.
::

## 2. Caractéristiques

### 2.1. Détails du client, utilisateurs et notes

- **Client** : Si un Projet est réalisé pour un Client particulier, les détails peuvent être renseignés ici.
- **Commande client** : Si un projet est basé sur une commande client d'un client, vous pouvez récupérer les détails ici. Cela vous permettrait d'informer le client de l'avancement du projet conformément au bon de commande émis.

![détails\_client.png](https://doc.dokos.io/content/projets/project/details_client.png)

- **Utilisateurs** : Vous pouvez ajouter n'importe quel utilisateur du site Web pour lui donner accès à ce projet. Par exemple, vous pouvez ajouter votre client en tant qu'utilisateur du site Web, pour lui permettre d'avoir accès à votre projet pour suivre l'avancement et/ou donner des entrées/remarques. De même, un fournisseur ou un employé contractuel/indépendant impliqué dans le projet peut être ajouté en tant qu'utilisateur.

![utilisateurs.png](https://doc.dokos.io/content/projets/project/utilisateurs.png)

En outre, vous pouvez également développer la fenêtre et sélectionner si vous souhaitez envoyer un e-mail de bienvenue à un utilisateur en particulier ou lui donner les droits de visualisation des pièces jointes.

Vous pouvez en savoir plus sur l'autorisation des utilisateurs à afficher les projets ici .

- **Notes** : Vous pouvez ajouter des notes supplémentaires au projet.

![notes.png](https://doc.dokos.io/content/projets/project/notes.png)

### 2.2. Dates de début et de fin

- Date de début réelle : sur la base du début réel du projet, suivi via des feuilles de temps, la date et l'heure de début réelles du projet seront enregistrées automatiquement.
- Date de fin réelle : sur la base de la fin réelle du projet, suivie via la dernière mise à jour de la feuille de temps, la date et l'heure de fin réelles du projet seront enregistrées automatiquement. Pour en savoir plus sur les feuilles de temps, cliquez ici .

### 2.3. Coût et facturation

- **Coût estimé** : Entrez le coût estimé du projet.
- **Montant total des ventes** : Si vous avez déjà lié le projet à une commande client, le montant total de la commande client sera automatiquement renseigné ici.
- **Montant total du coût** : Le système récupérera automatiquement le montant total du coût de toutes les feuilles de temps liées à ce projet.
- **Montant total facturable** : Le système récupérera automatiquement le montant total facturable de toutes les feuilles de temps liées à ce projet.
- **Demande de remboursement totale** : sur la base des dépenses réclamées par un employé pour l'achèvement du projet, la demande de remboursement totale sera calculée automatiquement.
- **Montant total facturé** : le montant total facturé est automatiquement renseigné dans le système à l'aide de la facture de vente créée par rapport à la commande client.
- **Coût d'achat total** : le coût d'achat total d'un projet est le coût extrait des factures d'achat créées par rapport à un bon de commande émis pour la fourniture de matériaux requis pour un projet.
- **Coût total des matériaux consommés** : à l'aide de l'entrée de stock effectuée conformément aux exigences des matériaux dans le projet, le coût total des matériaux consommés est capturé.

![coût\_et\_facturation.png](https://doc.dokos.io/content/projets/project/cout_et_facturation.png)

### 2.4. Marge

- **Marge brute** : La marge brute vous donnerait la marge que vous avez entre votre montant total des coûts et le montant total facturé.
- **Marge brute** = (Montant total des ventes + Montant total facturable) - Montant total du coût + Montant total facturable + Total des notes de frais + Coût total d'achat + Coût total des matériaux consommés)
- **% brut** : le pourcentage du montant total facturé dépensé dans le montant total des coûts constitue le pourcentage brut.

((Montant total des ventes + Montant total facturable) - Montant total du coût + Montant total facturable + Total des notes de frais + Coût total d'achat + Coût total des matériaux consommés) / Montant total des ventes)\* 100

### 2.5. Surveiller les progrès

Lorsque vous activez l'option **Envoyer des emails de suivi d'avancement** en cochant la case, cela vous permet d'ajouter des détails de surveillance au projet. Un rapport sur l'avancement du projet sera envoyé à toutes les parties prenantes du projet.

- **Liste des jours fériés** : Vous pouvez sélectionner la liste des jours fériés pour votre entreprise. Cela vous permettra de collecter les rapports d'avancement uniquement les jours ouvrables.
- **Fréquence** : Vous pouvez définir la fréquence à laquelle vous souhaitez obtenir les rapports. Il peut être réglé sur une fréquence horaire, biquotidienne, quotidienne ou hebdomadaire.

![suivi.png](https://doc.dokos.io/content/projets/project/suivi.png)

# Type de projet

Un type de projet est la classification des projets en différents types pour regrouper des types de projets similaires.

Les projets internes, les projets externes peuvent être des exemples de types de projets et sont déjà créés dans le système. Vous pouvez choisir d'ajouter d'autres types de projets. Cela s'avère pratique lorsque vous examinez les projets et que vous souhaitez filtrer les informations en fonction des types de projets.

---

Pour accéder à **la liste type de projet**, allez sur :

> Accueil > Projets > Projets > **Type de projet**

![liste\_type\_de\_projet.png](https://doc.dokos.io/content/projets/project-type/liste_type_de_projet.png)

## 1. Comment créer un type de projet

1. Accédez à la liste des types de projets et cliquez sur **Ajouter Type de projet**.
2. Ajoutez le **nom** du type de projet et la **description**
3. **Enregistrer**.

![détails\_type\_de\_projet.png](https://doc.dokos.io/content/projets/project-type/details_type_de_projet.png)

# Mise à jour du projet

Une mise à jour du projet est le statut du projet qui peut être envoyé à toutes les parties prenantes du projet.

Chaque fois que vous souhaitez informer les parties prenantes du projet, vous pouvez leur envoyer une mise à jour du projet.

Pour accéder à la mise à jour du projet, allez sur :

> Accueil > Projets > Projets > Mise à jour du projet

## 1. Comment créer une mise à jour de projet

1. Accédez à la liste de mise à jour du projet et cliquez sur Nouveau.
2. Ajoutez le nom du projet pour lequel vous souhaitez envoyer une mise à jour.
3. Ajoutez le nom des utilisateurs auxquels vous souhaitez envoyer la mise à jour du projet dans la table enfant. Ces Utilisateurs peuvent être vos Clients ou toute autre Partie Interne Interne ou Externe.
4. Enregistrer et envoyer.

Une fois que vous avez enregistré la mise à jour du projet, un e-mail est envoyé aux parties prenantes sélectionnées avec les mises à jour du projet.

### 1.1. Détails supplémentaires

Lorsque vous développez le tableau qui contient les noms des Utilisateurs, vous pourrez ajouter les détails suivants :

- Vous pouvez choisir d'envoyer un e-mail de bienvenue à un utilisateur particulier lors de l'envoi de la mise à jour du projet.
- Vous pouvez choisir si vous souhaitez qu'un utilisateur particulier affiche les pièces jointes dans la mise à jour du projet.
- Vous pouvez ajouter la description de l'étape actuelle du projet dans le champ « Statut du projet ».

# Modèle de projet

Un modèle de projet est une séquence prédéfinie de tâches organisées selon un calendrier stipulé.

Ces modèles peuvent être extraits pour des types de projets similaires et les tâches qu'ils contiennent sont automatiquement remplies au moment de la création de chaque nouveau projet.

---

Pour accéder à **la liste modèle de projet**, allez sur :

> Accueil > Projets > Projets > **Modèle de projet**

![modèle\_de\_projet.png](https://doc.dokos.io/content/projets/project-template/modele_de_projet.png)

## 1. Comment créer un nouveau modèle de projet ?

1. Accédez à la liste des modèles de projet et cliquez sur **Ajouter Modèle de projet**.
2. Ajoutez les **détails** suivants :


   - **Nom du modèle de projet** : Titre du modèle de projet
   - **Type de projet** : Les modèles de projet, tout comme les projets, peuvent être classés en différents types de projets, par exemple, interne ou externe.
   - **Tâches** : Chaque modèle de projet aura un ensemble d'une séquence prédéfinie de tâches. Dans ce tableau, vous pouvez sélectionner les tâches que vous souhaitez pour ce modèle.

![détails\_modèle\_de\_projet.png](https://doc.dokos.io/content/projets/project-template/details_modele_de_projet.png)

## Calcul automatique des dates en tenant compte des jours fériés :badge{text="Dokos" type="warning"}

Lorsqu'un projet est créé depuis un modèle, Dokos utilise la **durée** définie sur chaque tâche du modèle pour calculer automatiquement les dates de début et de fin de chaque tâche. Ce calcul tient compte de la liste des jours fériés associée à la société : si une date calculée tombe sur un jour férié, Dokos la décale automatiquement au prochain jour ouvré.

> **Exemple — Maison Verte SARL**
> Un modèle "Installation client" contient 3 tâches de 2 jours chacune. Le projet commence un jeudi. Dokos calcule les dates en avançant d'autant de jours que la durée de chaque tâche, en sautant automatiquement les jours fériés configurés pour la société.

Cette fonctionnalité garantit que les plannings générés depuis un modèle restent réalistes sans recalcul manuel.

## Tableau de bord des activités sur la fiche projet :badge{text="Dokos" type="warning"}

La fiche projet affiche un **tableau de bord des heures par type d'activité**, calculé à partir de toutes les feuilles de temps liées au projet. Chaque type d'activité apparaît avec son total d'heures et une barre de progression relative.

> **Exemple — Maison Verte SARL**
> Le projet "Mise en place ERP" affiche : Développement — 42 h, Paramétrage — 18 h, Formation — 10 h. Le responsable de projet voit d'un coup d'œil comment le temps est réparti, et peut cliquer sur chaque ligne pour accéder directement aux feuilles de temps correspondantes.

Chaque ligne du tableau est cliquable et redirige vers la liste des feuilles de temps filtrée sur ce type d'activité et ce projet, facilitant le contrôle des imputations.


# Tâche

Dans la gestion de projet, une tâche est une unité ou une activité actionnable qui doit être achevée.

---

Pour accéder à **la liste des Tâches**, allez sur :

> Accueil > Projets > Projets > **Tâche**

![liste\_tâche.png](https://doc.dokos.io/content/projets/task/liste_tache.png)

## 1. Comment créer une tâche ?

1. Accédez à la liste des tâches et cliquez sur ➕ Ajouter Tâche.
2. Ajoutez le **sujet** de la tâche.
3. **Enregistrer**.

![détails\_tâche.png](https://doc.dokos.io/content/projets/task/details_tache.png)

### Alternative

Alternativement, une tâche peut également être créée à partir d'un projet de la manière suivante :

1. Accédez au projet pour lequel vous souhaitez créer une nouvelle tâche.
2. Accédez à Tâche dans la section Projet du tableau de bord. L'icône plus '+' ici vous dirigera vers la page de création de tâche.
3. Ajoutez le sujet de la tâche.
4. **Enregistrer**.

### 1.1 Options supplémentaires lors de la création d'un projet

Les détails supplémentaires suivants peuvent être ajoutés lors de la modification d'une nouvelle tâche :

- **Statut** : Vous pouvez ajouter le statut du projet ou le modifier à tout moment, par exemple de « Ouvert » à « En cours », « En retard », « En attente de révision », « Terminé » ou « Annulé »
- **Projet** : dans le cas où une tâche est ajoutée indépendamment, vous pouvez choisir de lier la tâche à un projet particulier. Si la tâche est créée à partir d'un projet, les détails du projet seront automatiquement ajoutés.
- **Priorité** : Vous pouvez choisir de définir la priorité de la tâche, à savoir, Faible, Moyenne, Élevée ou Urgente.
- **Problème** : si la tâche est une action qui découle d'un problème, ce problème peut être marqué ici avec la tâche.
- **Poids** : Si une tâche particulière porte un certain poids sur un projet, ou autrement, le poids peut être spécifié ici. Cette pondération est calculée dans la méthode de pourcentage d'achèvement des tâches par pondération de la tâche.
- **Type** : si votre tâche peut être définie sous un type de tâche particulier, par exemple, formation utilisateur ou démonstration utilisateur, vous pouvez saisir le type de tâche ici. Il peut être utilisé pour filtrer les tâches en fonction des types de tâches.
- **Couleur** : Chaque tâche peut être reconnue par une couleur différente. Cela aide à identifier une tâche lors de la création de diagrammes de Gantt.
- **Est un groupe** : cette case peut être cochée pour indiquer qu'une tâche est une tâche parente et peut être divisée en plusieurs sous-tâches.
- **Est un modèle** : cette case peut être cochée pour indiquer que cette tâche est une tâche modèle et est destinée à être utilisée dans un modèle de projet.
- **Tâche parent** : Si une tâche particulière fait partie d'une tâche de groupe, la tâche parent peut être liée à la tâche à partir de ce champ.

## 2. Caractéristiques

### 2.1. Chronologie et détails

- **Date de début prévue** : Vous pouvez saisir la date à laquelle vous prévoyez de démarrer la tâche.
- **Date de fin prévue** : Vous pouvez saisir la date à laquelle vous pensez que cette tâche sera terminée.
- **Temps prévu** : Vous pouvez entrer le nombre d'heures que vous prévoyez être consacrées à cette tâche.
- **Progression** : Vous pouvez saisir le pourcentage de progression d'une tâche.
- **Début** : Si la tâche est une tâche modèle, ce champ peut être utilisé pour spécifier le jour auquel cette tâche doit commencer après le début du projet.
- **Durée** : Si la tâche est une tâche modèle, ce champ peut être utilisé pour attribuer un nombre de jours précis à cette tâche.
- **Est un jalon** : cette case peut être cochée dans les cas où une tâche particulière est un jalon dans un projet.

![chronologie.png](https://doc.dokos.io/content/projets/task/chronologie.png)

- Description : Vous pouvez ajouter une description de la tâche ici.

![détails.png](https://doc.dokos.io/content/projets/task/details.png)

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
**Remarque** : En fonction des valeurs des champs Début et Durée , la date de début prévue et la date de fin prévue sont calculées pour les tâches de projet créées à l'aide d'un modèle de projet. Ce calcul ignore les jours fériés en fonction de la liste des jours fériés de votre entreprise.
::

### 2.2. Dépendances et temps réel

Tâches dépendantes : les tâches dépendantes indiquent qu'une tâche particulière dépend d'une autre tâche et que la première ne peut pas être terminée avant l'achèvement de la seconde.

Les dépendances de tâches peuvent être visualisées dans les diagrammes de Gantt de la manière suivante.

- **Date de début réelle** : La date et l'heure réelles de démarrage de la tâche sont enregistrées sur la base des feuilles de temps .
- **Date de fin réelle** : la date et l'heure réelles de fin de la tâche sont enregistrées ici via les feuilles de temps.

![dépendance.png](https://doc.dokos.io/content/projets/task/dependance.png)

### 2.3. Chiffrage

- **Montant total des coûts** : le montant total des coûts est capturé ici via les feuilles de temps soumises par l'utilisateur pendant qu'il travaille sur cette tâche.
- **Montant total de la facturation** : le montant total avec lequel le client doit être facturé via cette tâche est enregistré ici à partir des feuilles de temps.
- **Demande de dépenses totale** : le montant total des dépenses réclamées par un employé pour l'achèvement de cette tâche est enregistré et reflété ici.

### 2.4. Plus d'informations

- **Service** : Vous pouvez saisir le service propriétaire de la tâche. Quel que soit le département Maître d'Ouvrage du Projet, chaque tâche peut être réalisée par un département différent.
- **Société** : Vous pouvez modifier la Société pour laquelle cette Tâche est effectuée. Cela peut être utilisé dans les cas où une société exécute la tâche pour sa société sœur ou sa société mère ou une filiale.

![plus\_d'information.png](https://doc.dokos.io/content/projets/task/plus_dinformation.png)


# Feuille de temps

Une feuille de temps est l'enregistrement du nombre d'heures passées par un employé à la fin de chaque tâche.

La feuille de temps peut également être utilisée pour calculer la facture envers un employé, pour calculer ses salaires ou pour suivre la contribution d'un employé à un projet ou à une tâche.

Dans Dokos, une feuille de temps peut avoir un compte d'un employé particulier travaillant sur plusieurs tâches ou projets dans un format tabulaire.

---

Pour accéder à **la liste feuille de temps**, allez sur,

> Accueil > Projets > Suivi du temps > **Feuille de temps**

![liste\_feuille\_de\_temps.png](https://doc.dokos.io/content/projets/timesheet/liste_feuille_de_temps.png)

## 1. Comment créer une feuille de temps

1. Accédez à la liste des feuilles de temps et cliquez sur **➕ Feuille de temps**.
2. Entrez le nom de l'entreprise et le code de l'employé.
3. Ajoutez les détails suivants dans le champ « Feuilles de temps ».

- **Type d'activité** : Ajoutez le type d'activité pour laquelle la feuille de temps a été créée.
- **Horaire de début** : Saisissez la date et l'heure de début du travail.
- **Heures** : Saisissez le nombre d'heures pour lesquelles cette feuille de temps a été créée. Une feuille de temps peut également être utilisée pour suivre les heures de travail sur plusieurs jours.
- **Projet** : Si cette feuille de temps doit être associée à un projet particulier, vous pouvez ajouter le nom du projet ici.
- **Facturable** : Cette case doit être cochée si cette feuille de temps particulière est facturable.

4. Cliquez sur \**Ajouter une ligne*» pour ajouter d'autres feuilles de temps.
5. **Enregistrer**.
6. Après avoir enregistré la feuille de temps, selon les détails saisis dans les différentes feuilles de temps, la date de début, la date de fin et le total des heures de travail seront mis à jour automatiquement. Cliquez sur **Soumettre**.

![détails\_de\_l'employé.png](https://doc.dokos.io/content/projets/timesheet/details_de_lemploye.png)

## 1.1. Alternativement, une feuille de temps peut également être créée à partir d'une tâche de la manière suivante :

1. Accédez à la tâche pour laquelle vous souhaitez créer une nouvelle feuille de temps.
2. Accédez à « Feuille de temps » dans la section Activité du tableau de bord. L'icône plus '+' ici vous redirigerait vers la page de création de feuille de temps.
3. Suivez les étapes pour créer une feuille de temps.

## 1.2 Minuteur dans la feuille de temps

Un minuteur peut être utilisé pour enregistrer le temps réel pris par un employé pour terminer une activité particulière dans une feuille de temps.

### 1.2.1. Étapes pour démarrer une minuterie :

Dans une feuille de temps En cliquant sur Démarrer la minuterie, une boîte de dialogue apparaît et vous devez saisir les informations suivantes :

- **Type d'activité** : L'activité pour laquelle vous enregistrez le temps.
- **Projet** : Le projet pour lequel vous créez la feuille de temps.
- **Tâche** : La tâche pour laquelle vous enregistrez le temps dans la feuille de temps.
- **Heures attendues** : saisissez le nombre d'heures pendant lesquelles vous prévoyez que la tâche se terminera.

![détails\_feuille\_de\_temps.png](https://doc.dokos.io/content/projets/timesheet/details_feuille_de_temps.png)

Une fois que vous avez terminé la tâche, cliquez sur Terminer. Une nouvelle entrée sera créée dans la feuille de temps et l'heure sera enregistrée en tant que feuille de temps dans le tableau des feuilles de temps de la feuille de temps.

Si le temps dépasse les **heures attendues**, une boîte d'alerte apparaît.

### 1.3. Options supplémentaires lors de la création de la feuille de temps

La feuille de temps, lorsqu'elle est développée, vous permet d'y entrer les détails suivants :

- **Heures attendues** : Entrez l'heure provisoire requise pour terminer les tâches sur les feuilles de temps.
- **À l'heure** : Entrez la date et l'heure auxquelles le travail a été terminé.
- **Terminé** : cette case doit être cochée si la tâche a été terminée lors de la soumission de la feuille de temps.
- **Tâche** : si cette feuille de temps doit être associée à une tâche particulière, vous pouvez le faire ici.
- **Heures de facturation** : nombre d'heures pour lesquelles le client doit être facturé pour cette feuille de temps.
- **Taux de facturatio**n : Le taux auquel le client doit être facturé pour ce travail.
- **Taux de coût** : Il s'agit du coût réel du travail effectué. Il est extrait du coût de l'activité (par employé) ou du type d'activité et peut être modifié.
- **Montant de facturation** : le montant de la facturation est calculé automatiquement en fonction du nombre d'heures facturables et du taux de facturation.
- **Montant du coût** : Le montant du coût est calculé automatiquement en fonction du nombre d'heures et du taux de coût.

## 2. Caractéristiques

### 2.1 Détails de facturation

- **Total des heures facturables** : sur la base de la feuille de temps, le total des heures facturables sera récupéré automatiquement ici.
- **Montant total facturable** : sur la base de la feuille de temps, le montant total facturable sera récupéré automatiquement ici.
- **Total des heures facturées** : une fois la feuille de temps soumise, vous aurez la possibilité de créer une facture de vente à partir de la feuille de temps. Le nombre d'heures pour lesquelles le client sera facturé sera récupéré ici, et une fois la facture de vente soumise, le total des heures facturées sera récupéré.
- **Montant total facturé** : De la même manière que la façon dont les heures totales facturées sont récupérées, le montant total facturé sera également récupéré.
- **Montant total des coûts** : sur la base de la feuille de temps, le montant total des coûts, tel que spécifié par l'employé, est marqué ici.
- **% du montant facturé** : une fois la feuille de temps soumise et une facture de vente créée à partir de la feuille de temps, le pourcentage du montant sur le montant total facturable qui a été calculé pour le montant total facturé est calculé et est reflété ici.

![dtails\_de\_la\_facturation.png](https://doc.dokos.io/content/projets/timesheet/dtails_de_la_facturation.png)

### 3. Après avoir enregistré la feuille de temps

Une fois qu'une feuille de temps est enregistrée et soumise, les détails tels que le taux de facturation et le taux d'établissement des coûts sont verrouillés et ne peuvent pas être modifiés. Les DocTypes suivants peuvent être créés après avoir soumis une feuille de temps.

## Filtrage avancé des feuilles de temps :badge{text="Dokos" type="warning"}

Dokos propose une API de filtrage des entrées de temps par critères personnalisés : employé, projet, tâche, type d'activité et plage de dates. Ce filtrage gère correctement les champs datetime vides (entrées sans heure de fin ou de début), ce qui évite d'exclure par erreur des lignes incomplètes lors des requêtes.

Cette capacité de filtrage est utilisée notamment par le tableau de bord des activités sur la fiche projet, et peut être exploitée dans les rapports personnalisés ou les scripts d'analyse des temps.


# Type d'activité

Le type d'activité est une liste de différents types d'activités par rapport auxquelles une feuille de temps peut être établie.

---

Pour accéder à **la liste type d'activité**, allez sur,

> Accueil > Projets > Suivi du temps > **Type d'activité**

![liste\_type\_d'activité.png](https://doc.dokos.io/content/projets/activity-type/liste_type_dactivite.png)

## 1. Comment créer un type d'activité ?

1. Accédez à la liste des types d'activité et cliquez sur **➕ Ajouter Type d'activité**.
2. Ajoutez le **sujet** du type d'activité.
3. **Enregistrer**.

![type\_d'activité.png](https://doc.dokos.io/content/projets/activity-type/type_dactivite.png)

De plus, vous pouvez également ajouter le **coût de revient** par défaut et le **prix de facturation** par défaut pour chaque activité.

En outre, le taux de coût par défaut et le taux de facturation par défaut pour les employés individuels peuvent également être configurés. Cela peut également être configuré à l'aide du coût d'activité .

Par défaut, les types d'activité suivants sont créés dans Dokos.

- **Planification**
- **Recherche**
- **Rédaction de proposition**
- **Exécution**
- **Communication**

# Coût de l'activité

Le coût d'activité enregistre le prix de facturation à l'heure et le coût de revient d'un employé par rapport à un type d'activité particulier.

Le système tire ce taux lors de la création de feuilles de temps. Il est utilisé pour déterminer le coût du projet.

---

Pour accéder à **la liste de coût de l'activité**, allez sur,

> Accueil > Projets > Suivi du temps > **Coût de l'activité**

![liste\_coût\_d'activité.png](https://doc.dokos.io/content/projets/activity-cost/liste_cout_dactivite.png)

## 1. Comment créer un coût d'activité

1. Accédez à la liste des coûts d'activité et cliquez sur **➕ Ajouter coût d'activité**.
2. Ajoutez le **nom de l'employé** pour lequel vous configurez le coût de l'activité.
3. Ajoutez le **coût de revient** et le **prix de facturation** pour l'employé.
4. **Enregistrer**.

![coût\_d'activité.png](https://doc.dokos.io/content/projets/activity-cost/cout_dactivite.png)

Alternativement, un coût d'activité peut également être créé via la liste d'activités.


# Stock / Inventaire

Le module Stock ou Inventaire de Dokos vous aide à :

- Maintenir les détails de vos produits et entrepôts.
- Suivre la réception, le transfert et la livraison des produits.
- Optimiser les niveaux de stock en fournissant des informations en temps réel via des rapports.
- Fournir une évaluation de chaque produit.

Le module Stock est étroitement intégré aux modules d'achat, de fabrication et de comptabilité.

## 1. Fonctionnalités de base

- [1. Articles](https://doc.dokos.io/v5/dokos/parametrage/articles)
- [2. Prix d'article](https://doc.dokos.io/v5/dokos/parametrage/prix)
- [3. Groupe d'article](https://doc.dokos.io/v5/dokos/parametrage/articles#groupes-darticles)
- [4. Entrepôt](https://doc.dokos.io/v5/dokos/stocks/warehouse)
- [5. Bordereau de livraison](https://doc.dokos.io/v5/dokos/stocks/bordereau-colis)

## 2. Installation

- [1. Paramètres des stocks](https://doc.dokos.io/v5/dokos/stocks/stock-settings)
- [2. Prix d'article](https://doc.dokos.io/v5/dokos/parametrage/prix)
- [3. Groupe d'article](https://doc.dokos.io/v5/dokos/parametrage/articles#groupes-darticles)
- [4. Unité de Mesure](https://doc.dokos.io/v5/dokos/stocks/uom)
- [5. Fabricant](https://doc.dokos.io/v5/dokos/stocks/fabricant)

## 3. Opérations de stock

- [1. Demande de matériel](https://doc.dokos.io/v5/dokos/stocks/demande-materiel)
- [2. Reçu d'achat](https://doc.dokos.io/v5/dokos/stocks/recus-achats)
- [3. Numéro de série](https://doc.dokos.io/v5/dokos/stocks/serial-no)
- [4. Fonction de Lot](https://doc.dokos.io/v5/dokos/stocks/batch)
- [5. Retour des ventes](https://doc.dokos.io/v5/dokos/stocks/sales-return)
- [6. Retour des achats](https://doc.dokos.io/v5/dokos/stocks/purchase-return)
- [7. Conservation des échantillons](https://doc.dokos.io/v5/dokos/stocks/retain-sample-stock)
- [8. Inspection de la qualité](https://doc.dokos.io/v5/dokos/stocks/quality-inspection)


# Reçu d'achat

Les reçus d'achat sont émis lorsque vous acceptez des articles de votre fournisseur généralement contre un bon de commande.

Vous pouvez également accepter les reçus d'achat directement sans avoir besoin d'un bon de commande. Pour ce faire, définissez Bon de commande requis sur «Non» dans les paramètres d'achat.

::mermaid
flowchart LR
id1(Demande de matériel)-->id2(Appel d'offre)
id1-->id3(Commande fournisseur)
id3-->id4(Facture d'achat)
id4-->id5(Écriture de paiement)
id2-->id6(Devis fournisseur)
id6-->id3
id4-->id7(Écriture de paiement - Acompte)
id3-->id8(REÇU D'ACHAT)

::

---

Pour accéder à la liste des reçus d'achat, allez sur :

> Accueil > Stock > Opérations sur actions > **Reçu d'achat**

## 1. Prérequis avant utilisation

Avant de créer et d'utiliser un reçu d'achat, il est conseillé de créer d'abord les éléments suivants :

- **[Commande fournisseur](https://doc.dokos.io/v5/dokos/achats/commandes-fournisseur)**

## 2. Comment créer un reçu d'achat

Un reçu d'achat est généralement créé à partir d'un bon de commande . Dans la commande fournisseur, cliquez sur Créer > **Reçu d'achat**.

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Toutes les informations de la **commande fournisseur** seront reprises pour créer le **Reçu d'achat**. Vous pourrez bien évidemment modifier des informations, notamment si des frais se sont ajoutés. Par exemple des frais de douane peuvent venir s'ajouter à la réception de la marchandise.
::

Pour créer un reçu d'achat manuellement (non recommandé), procédez comme suit :

1. Accédez à la **liste des reçus d'achat**, cliquez sur :**heavy\_plus\_sign: Ajouter Reçu d'achat**.
2. Le nom du fournisseur et les articles peuvent être récupérés à partir de la commande fournisseur en cliquant sur **Obtenir les articles de**.
3. Vous pouvez définir l'entrepôt accepté pour tous les articles de ce reçu d'achat. Ceci est récupéré s'il est défini dans le bon de commande.
4. Dans le cas où des articles sont défectueux, définissez l'entrepôt rejeté où ces articles seront stockés.
5. Sélectionnez l'article et saisissez la quantité dans le tableau Articles.
6. Le tarif sera récupéré et le montant sera calculé automatiquement.
7. Vous pouvez développer la ligne d'article pour modifier l'entrepôt accepté pour un article.
8. **Enregistrer et envoyer**.

- Vous pouvez également ajouter un **Bon de livraison fournisseur** au reçu d'achat si votre fournisseur a ajouté des notes.
- À l'aide de la case à cocher **Modifier la date et l'heure de publication**, vous pouvez modifier l'heure et la date de validation du reçu d'achat. Par défaut, la date et l'heure sont définies lorsque vous cliquez sur le bouton Nouveau.
- **Est de retour** : cochez cette case si vous retournez des articles qui n'ont pas été acceptés dans votre entrepôt.

### 2.1 Statuts

Voici les statuts d'un reçu d'achat:

- **Brouillon** : un brouillon est enregistré mais n'a pas encore été enregistré au système.
- **À facturer**: à facturer à l'aide d'une facture d'achat .
- **Terminé** : soumis et reçu tous les éléments.
- **Retour émis** : tous les articles ont été retournés.
- **Annulé** : a annulé le reçu d'achat.
- **Fermé** : Le but de la clôture est de gérer la fermeture à découvert. Par exemple, vous avez commandé 20 qté, mais la fermeture à 15 qté. Les 5 autres ne doivent pas être reçus ni facturés.

## 3. Caractéristiques

### 3.1 Devise et liste de prix

La devise du reçu d'achat est indiquée dans cette section, elle est extraite du bon de commande. Les prix des articles seront extraits de la liste de prix définie. Cochez la case Ignorer la règle de tarification ignorera les règles de tarification définies dans Comptes > **Règle de prix**.

Étant donné que l'article entrant affecte la valeur de votre inventaire, il est important de le convertir dans votre devise de base si vous avez commandé dans une autre devise. Vous devrez mettre à jour le taux de conversion de devise, le cas échéant.

### 3.2 Détails de l'entrepôt

L'ensemble d'entrepôts suivant s'appliquera à tous les articles du tableau Articles du reçu d'achat. Vous pouvez modifier les magasins pour des postes individuels via le tableau.

- **Entrepôt accepté** : il s'agit de l'entrepôt dans lequel vous accepterez et stockerez les articles entrants. Habituellement, il s'agit de l'entrepôt des «magasins».
- **Entrepôt rejeté**: il s'agit de l'entrepôt dans lequel vous conserverez les articles rejetés qui étaient défectueux ou non conformes au label de qualité.

#### Sous-traitant

- **Matières premières consommées** : dans le cas où vous sous-traitez, sélectionnez **Oui** pour consommer les matières premières du fournisseur.

### 3.3 Tableau des articles

**Code - barres** : vous pouvez suivre les articles à l'aide de codes-barres .

**Scanner le code - barres** : vous pouvez ajouter des éléments dans le tableau des éléments en scannant leurs codes-barres si vous possédez un lecteur de codes-barres. Lisez la documentation pour le suivi des articles à l'aide du code-barres pour en savoir plus.

Le code de l'article, le nom, la description, l'image et le fabricant seront récupérés à partir de la fiche article.

**Reçu et accepté** : définissez la quantité reçue, acceptée et rejetée. L’UdM est extraite du masque d’éléments. Vous devrez mettre à jour le «Facteur de conversion UdM» si votre bon de commande pour un article est dans une unité de mesure (UdM) différente de celle que vous stockez (UdM de stock).

**Tarif** : Le tarif est récupéré s'il est défini dans la liste de prix et le montant total est calculé.

**Modèle de taxe d'article** : vous pouvez définir un modèle de taxe d'article pour appliquer un montant de taxe spécifique à cet article particulier. Pour en savoir plus, visitez cette page .

Les détails du poids de l'article par unité et l'UdM de poids sont extraits s'ils sont définis dans la base de données des articles.

Entrepôt et référence : vous pouvez définir les entrepôts acceptés et rejetés et également ajouter un contrôle qualité, voir la section suivante.

**Numéro de série, numéro de lot et nomenclature** : si votre article est sérialisé ou groupé, vous devrez entrer le numéro de série et le lot dans la table Articles. Vous êtes autorisé à saisir plusieurs numéros de série sur une même ligne (chacun sur une ligne distincte) et vous devez saisir le même nombre de numéros de série que la quantité.

Il y a des champs séparés pour entrer ici les numéros de série des articles acceptés et rejetés. Un numéro de lot peut également être défini si vous stockez un lot de médicaments en plastique par exemple.

Cochez la case **Autoriser le taux de valorisation nul** permettra de soumettre le reçu d'achat même si le taux de valorisation de l'article est égal à 0. Il peut s'agir d'un exemple d'article ou en raison d'une entente mutuelle avec votre fournisseur.

Vous pouvez lier une nomenclature ici si l'article est sous-traité. Lier la nomenclature ici affectera le registre des stocks, c'est-à-dire que le stock de matières premières sera déduit de l'entrepôt fournisseur.

**Remarque** : l'article doit être sérialisé ou groupé pour que ces fonctionnalités fonctionnent. Si l'article est sérialisé, une fenêtre contextuelle apparaîtra dans laquelle vous pourrez saisir les numéros de série.

Les dimensions comptables aident à étiqueter chaque transaction avec des dimensions différentes sans qu'il soit nécessaire de créer de nouveaux centres de coûts.

**Saut de page** : Crée un saut de page juste avant cet élément lors de l'impression.

### 3.4 Suivi de l'inspection de la qualité

Si, pour certains articles, il est obligatoire d'enregistrer les contrôles qualité (si vous l'avez défini dans votre fiche Articles), vous devrez mettre à jour le champ "Contrôle qualité". Le système ne vous autorisera à "Soumettre" le reçu d'achat que si vous mettez à jour le «Contrôle qualité».

Après avoir activé les critères d'inspection dans le formulaire Article pour achat et y avoir joint un modèle d'inspection qualité, les inspections qualité peuvent être enregistrées dans les reçus d'achat.

### 3.5 Matières premières consommées

- La table **Articles consommés** contient les matières premières consommées par le fournisseur afin de recevoir l'article fini.
- Le bouton **Obtenir le stock actuel** récupérera le stock actuel des articles consommés dans l'entrepôt du fournisseur.

### 3.6 Taxes et Règle de livraison

Si votre fournisseur vous facture des taxes supplémentaires ou d'autres frais comme des frais d'expédition ou d'assurance, vous pouvez l'ajouter dans cette section. Cela vous aidera à suivre avec précision vos coûts.

De plus, si certains de ces frais ajoutent à la valeur du produit, vous devrez les mentionner dans le tableau des taxes. Vous pouvez également utiliser des modèles pour vos impôts. Pour plus d'informations sur la configuration de vos taxes, consultez le modèle de taxes et frais d'achat.

#### Règle de livraison

Une règle d'expédition permet de définir le coût d'expédition d'un article. Le coût augmentera généralement avec la distance d'expédition. Pour en savoir plus, visitez la page des règles d'expédition.

Ceci est très facile à suivre dans Dokos puisque chaque taxe fiscale est également un compte. Idéalement, vous devez créer deux comptes pour chaque type de TVA que vous payez et collectez, «Achat TVA-X» (actif) et «Vente TVA-X» (responsabilité), ou quelque chose à cet effet.

### 3.7 Remise supplémentaire

Outre l'enregistrement de la remise par article, vous pouvez ajouter une remise à l'ensemble du bon de commande dans cette section. Cette remise pourrait être basée sur le total général, c'est-à-dire après impôts / charges ou total net, c'est-à-dire avant taxes / charges. La remise supplémentaire peut être appliquée sous forme de pourcentage ou de montant.

### 3.8 Termes et conditions

Dans les transactions de vente / achat, il peut y avoir certaines conditions générales sur la base desquelles le fournisseur fournit des biens ou des services au client. Vous pouvez appliquer les conditions générales aux transactions aux transactions et elles apparaîtront lors de l'impression du document.

### 3.9 Informations additionnelles

Le statut du reçu d'achat est affiché ici et en haut. Les différents statuts sont: Brouillon, À facturer, Terminé, Annulé et Clôturé. Cette section affiche également le pourcentage du montant facturé, c'est-à-dire le pourcentage du montant pour lequel les factures de vente sont créées.

### 3.10 Paramètres d'impression

- **En-tête de lettre**
  Vous pouvez imprimer votre demande de devis / bon de commande sur le papier à en-tête de votre entreprise. En savoir plus ici .

«Regrouper les mêmes éléments» regroupera les mêmes éléments ajoutés plusieurs fois dans le tableau des éléments. Cela peut être vu lorsque votre impression.

- **Imprimer les titres**
  Les titres de vos documents peuvent être modifiés.

## 4. Après l'enregistrement

Une écriture comptable est créée pour chaque article en ajoutant l'article dans l'entrepôt par la «quantité acceptée». Si vous avez des rejets, une écriture comptable est effectuée pour chaque rejet. La «quantité en attente» est mise à jour dans le bon de commande.

Après avoir soumis le reçu d'achat, les éléments suivants peuvent être créés:

- **Retour d'achat**
- **Entrée de stock**
- **Facture d'achat**
- **Conservation du stock d'échantillons**

### 4.1 Retour d'un bon de commande

Une fois que vous avez reçu un bon de commande à l'aide d'un reçu d'achat, vous pouvez créer une entrée de retour au cas où l'article doit être retourné au fournisseur . Pour en savoir plus, visitez la page Retour des achats .

### 4.2 Ignorer le reçu d'achat

Si vous ne souhaitez pas créer de reçu d'achat après une commande d'achat et que vous souhaitez directement créer une facture d'achat, activez la fonction correspondante dans les paramètres d'achat.

#### Note complémentaire

Parfois, certaines dépenses qui s'ajoutent au total de vos articles achetés ne sont connues qu'après un certain temps. Un exemple courant est que si vous importez les articles, vous ne connaîtrez les droits de douane, etc. que lorsque votre «agent de compensation» vous enverra une facture. Si vous souhaitez attribuer ce coût à vos articles achetés, vous devrez utiliser le bon de coût au débarquement . Pourquoi le «coût au débarquement»? Parce qu'il représente les frais que vous avez payés lorsqu'il est arrivé en votre possession.


# Faq

> ##### Comment obtenir le solde du stock dans un entrepôt au 31/12

Vous pouvez utiliser le rapport [Solde du stock](https://doc.dokos.io/v5/dokos/stocks/rapports/solde-du-stock)


# Solde du stock

Ce rapport permet d'obtenir les soldes des stocks disponibles en valeur et quantité pour tous vos entrepôts.

## Afficher les soldes en unités de mesure alternatives

Par défaut, le rapport affiche les quantités dans l'**unité de mesure de stock** de chaque article (par exemple : Kg, Nos, Litre…).

Si vos articles disposent d'**unités de mesure alternatives*&#x2A; configurées (par exemple : Boîte = 12 Nos, Litre = 1 000 ml), vous pouvez activer le filtre &#x2A;*« Afficher le solde en UdM alternative »** pour faire apparaître les colonnes de conversion directement dans le rapport.

### Pourquoi utiliser ce filtre ?

Le filtre existant &#x2A;*« Inclure UdM »** permet de convertir l'ensemble du rapport dans une unité unique — mais cette approche est limitée dès que vos articles utilisent des unités alternatives différentes :

- **Stylo encre** → UdM de stock : Nos, UdM alternative : Boîte (1 Boîte = 12 Nos)
- **Encre** → UdM de stock : Kg, UdM alternative : Millilitre (1 Kg = 1 000 ml)

Choisir « Boîte » dans « Inclure UdM » ne convertit pas correctement les lignes d'encre, et inversement. Le filtre &#x2A;*« Afficher le solde en UdM alternative »** résout ce problème : chaque ligne résout ses propres unités alternatives de façon indépendante.

### Comment activer cette option

1. Ouvrez le rapport **Solde du stock** via la barre de recherche ou le module Stock.
2. Dans les filtres, cochez &#x2A;*« Afficher le solde en UdM alternative »**.
3. Lancez le rapport.

Des colonnes supplémentaires apparaissent alors à droite de la colonne **Qté solde** :

| Qté solde  | UdM alt. 1 | Qté solde (UdM alt. 1) |
| ---------- | ---------- | ---------------------- |
| 24 (Nos)   | Boîte      | 2                      |
| 5 000 (Kg) | Millilitre | 5 000 000              |

### Fonctionnement

- Les unités de mesure alternatives sont lues depuis la table de conversion de l'article, dans l'ordre défini (champ `idx`), en excluant l'unité de mesure de stock.
- La quantité convertie est calculée ainsi : `quantité solde ÷ facteur de conversion`.
- Si un article ne possède pas d'unité de mesure alternative, les colonnes correspondantes restent vides.
- Le filtre &#x2A;*« Inclure UdM »** continue de fonctionner indépendamment de cette option.
- Cette fonctionnalité est **optionnelle** : désactivée par défaut, elle ne modifie pas le rapport standard.

::callout{icon="i-mdi-lightbulb"}
Configurez les unités de mesure alternatives directement sur la fiche article, dans la section **Conversions d'unité de mesure**. Consultez la page [Unité de mesure](https://doc.dokos.io/v5/dokos/stocks/uom) pour en savoir plus.
::

## Trier par tous les champs de quantité du Bin

Le rapport **Solde du stock** permet désormais de trier les résultats par **tous les champs de quantité** disponibles dans le Bin (fiche de stock détaillée), et non plus seulement par une sélection limitée. Cette amélioration offre une flexibilité accrue pour analyser vos stocks selon différents critères opérationnels.

### Champs de quantité disponibles pour le tri

Voici la liste complète des champs de quantité du Bin désormais accessibles dans le sélecteur de tri :

| Champ                                     | Description                                                                        |
| ----------------------------------------- | ---------------------------------------------------------------------------------- |
| Quantité réelle                           | Stock physiquement disponible dans l'entrepôt                                      |
| Quantité réservée                         | Quantité réservée pour des commandes clients                                       |
| Quantité commandée                        | Quantité commandée à un fournisseur, non encore réceptionnée                       |
| Quantité demandée                         | Quantité couverte par une demande d'achat, non encore commandée                    |
| Quantité planifiée                        | Quantité en cours de fabrication (ordres de travail lancés)                        |
| Quantité réservée pour plan de production | Quantité réservée pour des ordres de production planifiés                          |
| Stock réservé                             | Quantité mise en réserve pour des besoins spécifiques (ex : projets, échantillons) |
| Quantité en transit                       | Quantité en cours de transfert entre entrepôts                                     |
| Quantité de travail en cours              | Quantité en cours de transformation (ordres de travail en cours)                   |
| Quantité projetée                         | Quantité disponible après prise en compte des flux entrants et sortants            |

### Comment utiliser le tri étendu

1. Ouvrez le rapport **Solde du stock**.
2. Dans la barre d'outils du rapport, cliquez sur le sélecteur de tri (icône de tri ou menu déroulant).
3. Sélectionnez le champ de quantité par lequel vous souhaitez trier les résultats.
4. Choisissez l'ordre de tri (croissant ou décroissant).
5. Lancez ou relancez le rapport pour appliquer le tri.

### Cas d'usage

- **Gestion des ruptures** : Triez par **Quantité réservée** pour identifier les articles dont le stock est entièrement engagé pour des commandes clients et qui risquent de manquer.
- **Planification des achats** : Triez par **Quantité demandée** pour prioriser les demandes d'achat en attente de validation.
- **Optimisation de la production** : Triez par **Quantité planifiée** pour suivre les articles en cours de fabrication et anticiper les goulots d'étranglement.
- **Gestion des réserves** : Triez par **Stock réservé** pour auditer les quantités mises de côté pour des besoins spécifiques et libérer du stock si nécessaire.

### Comportement du rapport

- Le tri s'applique à **toutes les lignes du rapport**, y compris celles dont la quantité du champ sélectionné est nulle.
- Si vous triez par un champ dont la quantité est nulle pour tous les articles, le rapport affichera d'abord les articles sans valeur pour ce champ, suivis des autres.
- Les bins dont la seule quantité non nulle est dans le champ de tri sélectionné **apparaissent désormais dans les résultats**, contrairement à la version précédente où ils pouvaient être exclus.

::callout{type="warning"}
Le tri par un champ spécifique ne modifie pas les calculs de quantité ou de valeur du rapport. Il réorganise simplement l'ordre d'affichage des résultats pour faciliter l'analyse.
::

## Voir aussi

- [Unité de mesure](https://doc.dokos.io/v5/dokos/stocks/uom)


# Remise supplémentaire

Il existe plusieurs façons d'appliquer une remise sur un article dans une transaction de vente. Cela peut être fait dans toutes les transactions de vente et d'achat.

## 1. Remise sur le tarif tarifaire d'un article

Vous pouvez trouver le champ Remise dans la table Article d'une transaction, cliquez sur la flèche vers le bas à droite d'une ligne. Une remise peut être appliquée sous forme de pourcentage ou de montant fixe lié au tarif tarifaire de l'article.

La fonction de remise (%) est disponible dans toutes les transactions de vente et d'achat.

Si vous souhaitez appliquer une remise (en pourcentage) régulièrement pour certaines quantités, vous préférez utiliser une **Règle de prix*&#x2A;. Lisez la documentation sur les **[Règles de prix](https://doc.dokos.io/v5/dokos/parametrage/prix) pour en savoir plus**.

## 2. Remise sur le total net ou le total général

Dans la section **Remise supplémentaire** (d'une "Commande client" ou d'une "Facture vente"), vous pouvez appliquer une remise sous la forme d'un montant fixe ou d'un pourcentage sur la somme totale des ventes.

### 2.1 Remise sur "Total net"

Si une remise est appliquée sur le total net , le tarif net et le montant net de l'article sont calculés selon le montant de la remise. Le champ Tarif net et Montant ne sera visible que si la remise est appliquée à l'aide de cette fonction.

### 2.2 Remise sur "Totalt TTC"

Si une remise est appliquée en fonction du Total TTC, alors avec le tarif net de l'article, le montant net ainsi que les taxes sont également recalculés selon le montant de la remise.


# N°de lot

La fonction de lot de Dokos vous permet de regrouper plusieurs unités d'un article et de leur attribuer une valeur / un numéro / une étiquette unique appelée N° de lot.

Ceci est fait en fonction de l'article. Si l'article est groupé, un numéro de lot doit être mentionné dans chaque transaction de stock. Les numéros de lot peuvent être gérés manuellement ou automatiquement. Cette fonction est utile pour définir la date d'expiration de plusieurs articles ou les déplacer ensemble vers différents entrepôts.

---

Pour accéder à la **liste N°de lot**, allez sur :

> Accueil > Stock > N°de série et lot > **Lot**

## 1. Prérequis

Avant de créer et d'utiliser un lot, il est conseillé de créer d'abord les éléments suivants:

- Article
- Activez **A un N° de Lot** dans le masque d'articles

## 2. Comment créer un nouveau lot

Pour définir l'article en tant qu'élément de lot, le champ "A un numéro de lot" doit être coché dans la base d'articles. Si vous n'avez pas sélectionné "Créer automatiquement un nouveau lot" lors de la création d'un article, vous devrez créer des lots manuellement au fur et à mesure.

Pour créer une nouvelle base de n ° de lot pour un article, accédez à:

1. Allez dans la **liste des lots*&#x2A;, cliquez sur **➕ Ajouter Lot**.
2. Définissez l'**ID de lot**.
3. Sélectionnez l'**élément**.
4. Si une transaction est effectuée avec un article, le lot ne peut pas être défini ou annulé.
5. **Enregistrer**.

![créer\_lot.png](https://doc.dokos.io/content/stocks/batch/creer_lot.png)

Lorsque les lots sont activés pour un article, l'option permettant de conserver le stock d'échantillons devient également disponible.

## 2.1 Création automatique par lots

Si vous souhaitez créer automatiquement un lot au moment de la réception de l'achat, vous devez cocher «Créer automatiquement un nouveau lot» dans la base d'articles :

## 3. Caractéristiques

### 3.1 Fractionnement et déplacement de lots

Lorsque vous ouvrez un lot, vous verrez toutes les quantités qui appartiennent à ce lot sur la page.

- Pour déplacer le lot d'un entrepôt à un autre, vous pouvez cliquer sur le bouton Déplacer .
- Vous pouvez également diviser le lot en un plus petit en cliquant sur le bouton Fractionner . Cela créera un nouveau lot basé sur ce lot et les quantités seront réparties entre les lots.
- Si vous définissez la date d'expiration, le lot affichera **Non expiré** jusqu'à la date d'expiration, après quoi il affichera **Expiré**. Si aucune date n'est définie, le lot affichera **Non défini**.

### 3.2 Transaction d'articles avec des lots

Une base de lots doit être créée avant la création du reçu d'achat. Par conséquent, chaque fois qu'un reçu d'achat ou un bon de travail est effectué pour un article de lot, vous créerez d'abord son numéro de lot, puis vous le sélectionnerez dans la commande d'achat ou la saisie de stock.

Sur chaque transaction de stock (reçu d'achat, bon de livraison, facture) avec un article de lot, vous devez indiquer le numéro de lot de l'article.

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
**Remarque** : Dans les transactions de stock, les ID de lot seront filtrés en fonction du code article, de l'entrepôt, de la date d'expiration du lot (par rapport à la date comptable d'une transaction) et de la quantité réelle dans l'entrepôt. Lors de la recherche d'un ID de lot sans valeur dans le champ Entrepôt, le filtre Quantité réelle ne sera pas appliqué.
::

### 3.3 Autoriser le stock négatif pour un lot spécifique

Par défaut, le comportement du stock négatif au niveau des lots est contrôlé par le paramètre global **Autoriser le stock négatif pour les lots** dans les [Paramètres de stock](https://doc.dokos.io/v5/dokos/stocks/stock-settings). Lorsque ce paramètre est activé, **tous** les lots peuvent passer en stock négatif.

Dokos permet désormais d'affiner ce contrôle lot par lot grâce à la case à cocher **Autoriser le stock négatif pour ce lot** directement sur la fiche du lot.

#### Cas d'usage typique

Cette option est particulièrement utile lorsque des écritures antidatées ont temporairement mis un lot spécifique en négatif dans le passé, alors que ce lot dispose aujourd'hui d'un stock disponible. Plutôt que d'activer le stock négatif pour l'ensemble des lots (ce qui expose inutilement tous les articles), vous pouvez cibler uniquement le lot concerné.

**Exemple chez Maison Verte SARL** : le lot `SEMENCES-2024-001` a fait l'objet d'une écriture de régularisation antidatée en janvier qui l'a temporairement mis en négatif. Pour éviter de bloquer les opérations en cours sans pour autant assouplir les règles sur tous les lots, le responsable de stock coche **Autoriser le stock négatif pour ce lot** uniquement sur ce lot.

#### Priorité des règles

Le système applique la logique de priorité suivante lors de la validation d'une sortie de stock :

::mermaid
flowchart TD
A\[Sortie de stock\navec N° de Lot] --> B{La quantité\ndu lot passe en négatif ?}
B -- Non --> Z\[✅ Mouvement autorisé]
B -- Oui --> C{Case cochée sur\nla fiche du lot ?}
C -- Oui --> Z
C -- Non --> D{Paramètre global activé\ndans Paramètres de stock ?}
D -- Oui --> Z
D -- Non --> E\[❌ Erreur : stock négatif\nnon autorisé pour ce lot]

::

#### Comment activer l'option

1. Ouvrez la fiche du **lot** concerné (Stock > N°de série et lot > Lot).
2. Cochez la case **Autoriser le stock négatif pour ce lot**.
3. **Enregistrez**.

::callout{color="blue" icon="i-heroicons-information-circle"}
Cette case à cocher ne se copie pas lors de la duplication d'un lot. Chaque lot doit être configuré individuellement.
::


# Bordereau de colis

Un bordereau de colis (ou de livraison) est un document qui répertorie les articles d'une expédition.

Il est généralement joint à la marchandise livrée.

À partir d'un seul bon de livraison, plusieurs bordereaux de colis peuvent être créés. Il est utile lorsque l'envoi est emballé dans différentes boîtes. Chaque boîte peut avoir un poids et un nombre d'articles différents. Par exemple, si vous expédiez 20 chaises dans 4 boîtes, chaque boîte peut contenir 5 chaises avec des bordereaux de colis différents pour chaque boîte.

---

Pour accéder à la liste des bordereaux de colis, allez sur:

> Accueil > Stock > Outils > **Bordereau de colis**

## Prérequis avant utilisation

Avant de créer et d'utiliser un bordereau de colis, il est conseillé de créer d'abord les éléments suivants:

- **Bon de livraison**

## Comment créer un Bordereau de colis

En règle générale, vous devez créer un bordereau de colis à partir d'un bon de livraison lorsqu'il est au stade de l'ébauche (brouillon), cependant, si vous souhaitez créer un bordereau de colis manuellement, procédez comme suit.

1. Accédez à la liste **Bordereau de colis**, cliquez sur Nouveau.
2. Sélectionnez le bon de livraison.
3. Entrez le numéro de colis de ce bordereau de colis.
4. Cliquez sur le bouton **Obtenir les articles** pour récupérer les articles et les quantités dans le tableau Articles.
5. **Enregistrer**.

![créer\_bordereau.png](https://doc.dokos.io/content/stocks/packing-slip/creer_bordereau.png)

La plupart de ces détails seront récupérés si vous créez le bordereau de colis à partir du bon de livraison.

### Options supplémentaires lors de la création d'un bordereau de colis

**Nombre de colis à expédier** : Si plusieurs colis du même type doivent être expédiés en même temps, définissez les numéros de colis De et À. Par exemple, colis numéros 1 à 5 dans un bordereau de colis, puis colis numéros 6 à 10 dans le prochain bordereau de colis et ainsi de suite. Ces informations s'afficheront à l'impression du bordereau de colis. Notez que cela ne fonctionnera que si votre envoi contient autant d'articles.

## Caractéristiques

### Tableau des articles

S'il s'agit d'un article par lots, vous devrez sélectionner le numéro de lot.
La quantité, l'unité de mesure, le poids net et l'unité de poids seront extraites du bon de livraison.
Saut de page créé un saut de page juste avant cet élément lors de l'impression.

### Détails du poids du colis

Ces détails seront affichés lors de l'impression du bordereau de colis.

**Poids net** : il est calculé comme la somme des poids de tous les éléments du tableau.
**Poids brut** : Il s'agit du poids total final, y compris le poids des matériaux d'emballage utilisés.
**Unité de mesure (Udm) poids brut** : Une UdM peut être définie ici pour le poids final du produit.

### Papier à en-tête

Vous pouvez imprimer votre bordereau de colis sur le papier à en-tête de votre entreprise.


# Demande de matériel

Une demande de matériel est un simple document identifiant une exigence d'un ensemble d'articles (produits ou services) pour une raison particulière.

Pour accéder à la demande de matériel, allez sur:

> Accueil > Stock > **Demande de matériel**

## Pré-requis nécessaires

Avant de créer et d'utiliser une demande de matériel, il est conseillé de créer d'abord les éléments suivants:

1. **[Un Fournisseur](https://doc.dokos.io/v5/dokos/parametrage/fournisseurs)**
2. **[Un article](https://doc.dokos.io/v5/dokos/parametrage/articles)**

## Comment créer une demande de matériel

**L'objet de la demande**

Une demande de matériel peut avoir les objectifs suivants:

- **Achat** : Si le matériel demandé doit être acheté.
- **Transfert de matériel** : Si le matériel demandé doit être transféré d'un entrepôt à un autre.
- **Problème matériel** : Si le matériel demandé doit être émis à des fins telles que la fabrication.
- **Fabrication** : Si le matériel demandé doit être produit.
- **Fourni par le client** : Si le matériel demandé doit être fourni par le client. Pour en savoir plus à ce sujet, visitez la page **Article** fourni par le **client** .

## Plusieurs demandes de matériel par commande client :badge{text="Dokos" type="warning"}

Dans Dokos, il est possible de créer **plusieurs demandes de matériel** à partir d'une même commande client. Cette souplesse permet de découper les besoins en plusieurs vagues d'approvisionnement sans être bloqué par une validation trop restrictive.

> **Exemple — Maison Verte SARL**
> Une commande client de 50 chaises est passée. L'équipe logistique crée une première demande de matériel pour 20 chaises disponibles rapidement chez un fournisseur, puis une seconde pour les 30 restantes à livraison différée. Les deux demandes sont liées à la même commande client.

Les quantités indiquées dans chaque demande de matériel correspondent à ce que vous souhaitez commander ou transférer pour cette vague — Dokos ne les ajuste pas automatiquement en fonction de ce qui a déjà été traité dans les demandes précédentes.


# Fabricant

Un fabricant a créé ou produit un article.

Un Fabricant peut ne pas être la même personne / société qui vend l'article sous une marque spécifique. Par exemple, Dokos peut être le fabricant de capsules en plastique, mais elles peuvent être vendu sous une marque, disons Capsules Dokos.

Dans Dokos, un fabricant peut être utilisé pour identifier les articles à l'aide d'un numéro de pièce spécifique.

Pour accéder à la liste des **fabricants**, allez sur :

> Accueil > Stock > **Fabricant**

![liste\_fabricant.png](https://doc.dokos.io/content/stocks/manufacturer/liste_fabricant.png)

## 1. Comment créer un fabricant

1. Allez dans la liste des fabricants et cliquez sur **➕ Nouveau**.
2. Entrez un **nom de fabricant** et entrez une **description** si nécessaire.
3. **Enregistrer**.

![créer\_fabricant.png](https://doc.dokos.io/content/stocks/manufacturer/creer_fabricant.png)

Après avoir créé un fabricant, il peut être défini dans le formulaire Article avec un numéro de pièce du fabricant pour identification.

### 1.1 Détails supplémentaires

Les détails suivants peuvent être définis pour un fabricant:

- Site Internet
- Pays
- Logo

## 2. Caractéristiques

### 2.1 Adresse et contacts

Une adresse et un contact peuvent être définis pour ce fabricant.


# Attribut d'article

Les attributs d'article sont des caractéristiques données aux variantes d'article en fonction des variantes d'article créées.

Les attributs d'article peuvent être la couleur, la taille, la longueur, etc. Plusieurs attributs comme plusieurs couleurs peuvent être définis.

---

Pour accéder à la liste des attributs d'article, allez sur :

> Accueil > Stock > Paramètres > **Attribut d'article**

![attribut\_de\_l'article.png](https://doc.dokos.io/content/stocks/item-attribute/attribut_de_larticle.png)

## 1. Comment créer un attribut d'article

1. Accédez à la liste des attributs d'article, cliquez sur Nouveau.
2. Entrez un nom pour l'attribut.
3. Entrez les valeurs d'attribut dans le tableau.
4. Enregistrer.

Les valeurs d'attribut peuvent être numériques ou non numériques.

### 1.1 Attributs non numériques

Pour les attributs non numériques, spécifiez les valeurs d'attribut avec son abréviation dans le tableau Valeurs d'attribut.

![attribut\_article\_création.png](https://doc.dokos.io/content/stocks/item-attribute/attribut_article_creation.png)

### 1.2 Attributs numériques

Si votre attribut est numérique, sélectionnez Valeurs numériques. Spécifiez la plage et la valeur d'incrément. Dans l'exemple suivant, la longueur du tuyau est comprise entre 0,25 et 3,0 et la plage est 0,25, les variantes seront donc 0,25, 0,5, 0,75 ... 3,0.

![attribut\_valeurs\_numériques\_.png](https://doc.dokos.io/content/stocks/item-attribute/attribut_valeurs_numeriques_.png)


# Groupe d'articles

Un groupe d'articles est un moyen de classer les articles en plusieurs catégories distinctes.

Selon le type de produit, vous pouvez classer un article dans son champ respectif. Si le produit est orienté service, attribuez-le sous le groupe d'articles - service. Si le produit est utilisé comme matière première, affectez-le sous la catégorie Matière première. Dans le cas où un article est utilisé uniquement dans le commerce, vous pouvez le classer sous un groupe d'articles appelé Commerce.

---

Pour accéder à la liste des groupes d'articles, allez sur :

> Accueil > Stock > Articles et prix > **Groupe d'articles**

## 1. Comment créer un groupe d'articles

1. Accédez à la liste des groupes d'articles, cliquez sur **➕ Nouveau**.
2. Sélectionnez un nœud de groupe sous lequel vous souhaitez créer le groupe d'articles, la racine par défaut est **Tous les groupes d'articles**.
3. Sélectionnez **Ajouter un enfant** ou cliquez sur le bouton **Nouveau**.
4. Pour faire de cet enfant un nœud de catégorie / groupe, cochez Nœud de groupe.
5. Cliquez sur Créer nouveau.

![nouveau\_groupe\_d'articles.png](https://doc.dokos.io/content/stocks/item-group/nouveau_groupe_darticles.png)

## 2. Caractéristiques

### 2.1 Valeurs par défaut

- **Liste de prix par défaut** : Une liste de prix par défaut qui déterminera les prix des articles pour ce groupe d'articles.
- **Entrepôt par défaut** : Entrepôt par défaut défini dans les transactions pour les articles appartenant à ce groupe.
- **Centre de coûts d'achat / vente par défaut** : Centre de coûts d'achat / vente par défaut auquel les articles de ce groupe seront facturés.
- **Compte de dépenses / revenus par défaut** : les comptes par défaut des articles appartenant à ce groupe.
- **Fournisseur par défaut** : Lors de la définition d'un fournisseur ici, ce fournisseur sera choisi par défaut dans les transactions d'achat pour les articles de ce groupe.

### 2.2 Taxe sur l'article

Un modèle de taxe d'article par défaut sera appliqué à tous les articles appartenant à ce groupe. De même, une catégorie de taxe peut également être sélectionnée, visitez Devis pour en savoir plus sur les catégories de taxe.

### 2.3 Paramètres du site web

- **Afficher sur le site Web** : les articles appartenant à ce groupe seront affichés sur votre site Web sous le groupe d'articles.
- **Poids** : Il s'agit du poids des groupes d'articles eux-mêmes, les groupes d'articles avec des poids plus élevés seront affichés en premier.
- **Diaporama** : un diaporama pour le groupe d'articles, comme dans un article. Visitez la page d' accueil du module Site Web pour en savoir plus.
- **Description** : Cela apparaîtra sur la page Groupe d'articles.
- **Spécifications du site Web** : étiquette et sa description pour un groupe d'articles.

### 2.4 Filtres du site web

Un filtre de site web pourra être ajouté pour filtrer les articles selon des champs spécifiques. Vous pouvez par exemple filtrer les articles selon le groupe d'article, selon le tarif. Pour ajouter un filtre :

- **Ajouter une ligne**
- **Nom du champ** : Sélectionner une valeur que vous voulez avoir en filtre.
- **Attributs** : Ajouter des attributs pour filtrer les articles selon la couleur, la taille par exemple.


# Informations sur les articles

Un article est un produit ou service pouvant être vendu, acheté, immobilisé ou être utilisé dans le processus de production.

# Produits ou services

Bien que non obligatoire, la gestion de stock est souvent ce qui permet de différencier un produit d'un service.
Dans Dokos, la gestion des stocks peut être activée en cochant la case "Maintenir le stock".

# Site web

Afin de mettre en évidence vos articles et/ou de les vendre sur votre site web, vous pouvez cocher la case **Afficher sur le site web**.

Vous avez la possibilité d'ajouter une image ou un diaporama, de définir les spécifications de votre article et de lui ajouter une description courte et une description longue qui apparaîtront sur la page de présentation de l'article.

## La route

La route sera ajoutée à l'URL de votre site pour permettre de naviguer jusqu'à la fiche de l'article.

> **Exemple*&#x2A;
> Si votre site est à l'adresse &#x2A;*<https://demo.dokos.cloud>{rel="&#x22;nofollow&#x22;"}** et que la route de votre article est **boards/dokoboard-tkkif*&#x2A;, alors l'URL pointant vers la fiche de votre article sera &#x2A;*<https://demo.dokos.cloud/boards/dokoboard-tkkif>{rel="&#x22;nofollow&#x22;"}**.

La première partie de votre route est la route du groupe d'articles lié à votre article.

> **Exemple**
> Si la route de notre article est **boards/dokoboard-tkkif*&#x2A;, &#x2A;*<https://demo.dokos.cloud/boards>{rel="&#x22;nofollow&#x22;"}** nous amènera sur la liste de tous les articles associés au groupe d'articles **Boards**.
> Il est possible d'afficher ou de cacher cette liste dans les paramètres du groupe d'articles.

# Réservations d'articles

## Activer les réservations d'articles

Certains articles peuvent êtres associés à des réservations de créneaux horaires. C'est le cas des salles de réunion, des bureaux, des espaces de coworking ou bien de machines mises à disposition d'utilisateurs.

Pour activer les réservations d'articles pour un article, il suffit de cocher la case **Autoriser les réservations d'article** (Voir section ci-dessus).

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Les articles associés à des réservations de créneaux horaires seront généralement des services. No cochez donc pas la case **Maintenir le stock**.
::

## Activer les réservations sur le site web

Il est également possible de laisser vos utilisateurs effectuer leurs réservations de créneaux directement sur votre site web.

Pour mettre en place cette fonctionnalité, dans la section **Site Web**, cochez la case **Afficher sur le site web**.

Une fois activée, vos utilisateurs de site web auront le choix entre acheter des unités ou sélectionner un créneau: :br![item\_website\_options.png](https://doc.dokos.io/content/lieu/item-booking/item_website_options.png)

- Vous pouvez cocher la case **Désactiver l'achat d'unités** pour ne permettre que la réservation de créneaux.

> L'achat d'unités permet à votre utilisateur d'acheter X unités de votre service, sans spécifier les horaires auxquelles auront lieu ce service. Pour un fonctionnement similaire avec gestion de crédits, voir les [crédits de réservation](https://doc.dokos.io/v5/dokos/lieu/credit-reservation).

- **Réservations simultanées autorisées**: Définissez le nombre de réservations simultanées autorisées > Pour que cette option apparaisse, il faut l'activer dans les [Paramètres du lieu](https://doc.dokos.io/v5/dokos/lieu/parametres-lieu)

Si vous souhaitez autoriser la réservation avec différentes unités de mesure (jour, heure,...) ajoutez les dans le tableau des unités de mesure.

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Les facteurs de conversion utilisés par le système de réservation sont ceux définis dans les [Facteurs de conversion](https://doc.dokos.io/v5/dokos/lieu/reservations-articles#les-facteurs-de-conversion).
Les facteurs de conversion définis dans la fiche article servent uniquement à la conversion des [prix de l'article](https://doc.dokos.io/v5/dokos/parametrage/prix) pour la facturation.
::

# Onglet Tarification

Sur une fiche article **déjà enregistrée**, un onglet **Tarification** est disponible directement dans le formulaire. Il vous permet de consulter en un coup d'œil tous les prix actifs associés à cet article, sans avoir à naviguer vers la liste des prix d'article.

## Ce que vous pouvez y faire

- **Visualiser les prix actifs** : le tableau affiche jusqu'à 10 prix dont la date de fin de validité est vide ou dans le futur. Pour chaque prix, vous voyez la liste de prix, le type (vente ou achat), le tiers associé (client ou fournisseur), le tarif, l'unité de mesure et la date de fin de validité.
- **Ouvrir un prix existant** : cliquez sur une ligne du tableau pour ouvrir directement la fiche Prix d'article correspondante.
- **Voir tous les prix** : si l'article possède plus de 10 prix actifs, un bouton **Voir tous les prix** apparaît en bas du tableau. Il vous redirige vers la liste des prix d'article filtrée sur cet article.
- **Ajouter un prix*&#x2A; : le bouton **+ Ajouter un prix** ouvre un nouveau formulaire Prix d'article prérempli avec le code article, ce qui évite toute saisie manuelle répétitive.

> **Exemple — Maison Verte SARL**
> Vous consultez la fiche de l'article "Chaise de bureau ergonomique". Dans l'onglet Tarification, vous voyez immédiatement qu'il existe un prix à 120 € dans la liste "Vente Standard" et un prix à 85 € dans la liste "Revendeurs". Vous constatez que le prix revendeur expire dans deux semaines et vous cliquez sur la ligne pour le prolonger, sans quitter la fiche article.

::callout{color="blue" icon="i-heroicons-information-circle"}
L'onglet Tarification n'est visible que sur les articles enregistrés. Il n'apparaît pas lors de la création d'un nouvel article.
::


# Variantes d'article

Une variante d'article est une version d'un article avec différents attributs tels que des tailles ou des couleurs.

Par exemple : Supposons que le t-shirt soit un article et qu'il soit disponible en différentes tailles et couleurs comme petit, moyen, grand et rouge, bleu, vert. Dans Dokos, le t-shirt sera considéré comme un modèle d'article et chacune des variations sera une variante d'article.

Un t-shirt bleu en taille petite plutôt qu'un simple t-shirt. Les variantes d'article vous permettent de traiter les versions petite , moyenne et grande d'un t-shirt comme des variantes d'un «t-shirt» d'article.

Sans les variantes d'article, vous auriez à traiter les versions petite , moyenne et grande d'un t-shirt comme trois articles distincts.

---

## 1. Utilisation des variantes d'article

Les variantes peuvent être basées sur deux choses :

- Attributs d'article
- Fabricants

**Conseil**: une fois qu'un modèle d'élément est créé, lorsque vous mettez à jour ce modèle, toutes les variantes sont également mises à jour en conséquence.

### 1.1 Création du modèle de variante d'article

1. Pour utiliser des variantes d'article dans Dokos, créez un élément et cochez **A des variantes** sous Variantes.
2. L'élément est alors désigné sous le nom de «modèle». Un tel modèle n'est plus identique à un **article** normal. Par exemple, le modèle ne peut être utilisé directement dans aucune transaction (commande client, bon de livraison, facture d'achat) elle-même.
3. Seules les variantes de l'article ( t-shirt bleu en taille petite) peuvent être utilisées pratiquement. Par conséquent, il serait idéal de décider si un élément **a des variantes** ou non directement lors de sa création
4. En sélectionnant «Possède des variantes», un tableau apparaîtra. Spécifiez les attributs de variante pour l'article dans le tableau. Si l'attribut a des valeurs numériques, vous pouvez spécifier la plage et créer des intervalles basés sur les valeurs d'incrément.

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Remarque: vous ne pouvez pas effectuer de transactions par rapport à un «modèle».
::

### 1.2 Création des variantes d'article en fonction des attributs d'article

Pour créer des «variantes d'article» par rapport à un «modèle», cliquez sur «Créer». À partir de là, choisissez de créer une seule variante ou plusieurs. Simple est simple où vous créez juste un ou plusieurs attributs et un élément sera créé. Lorsque vous choisissez plusieurs variantes, cochez les attributs et plusieurs éléments seront créés. Par exemple, si vous choisissez Couleur: Rouge, Vert et Taille: Petit, Moyen, Grand, 6 variantes seront créées.

Création de plusieurs variantes dans Dokos :

Pour en savoir plus sur la définition des attributs, consultez Attributs d'article.

### 1.3 Variantes d'article basées sur les fabricants

Pour configurer des variantes basées sur des fabricants, dans votre modèle d'article, définissez **Variantes basées sur** comme **Fabricants**. Dans ce cas, pour créer des variantes, cliquez sur **Créer > Créer une variante**. Le système vous demandera de sélectionner un fabricant. Vous pouvez également indiquer en option un numéro de pièce du fabricant.

La dénomination de la variante sera basée sur le nom (ID) de l'élément modèle avec un suffixe numérique. Par exemple, "Screwdriver" aura la variante "Screwdriver-1".

### 2. Mettre à jour les variantes d'article en fonction du modèle

Accédez à: Accueil> Stock> Articles et prix> Paramètres de variante d'article . Les champs affichés ici seront également copiés dans les variantes. Par défaut, tous les champs sont affichés, supprimez toutes les lignes que vous ne souhaitez pas mettre à jour du modèle d'élément vers les variantes.


# Retour d'achat

Un article acheté retourné est appelé retour d'achat.

Avec la fonction de retour d'achat, vous pouvez retourner les produits au fournisseur. Cela peut être dû à un certain nombre de raisons telles que des défauts de produits, une qualité non conforme, l'acheteur n'a pas besoin du stock, etc.

## 1. Prérequis

Avant de créer et d'utiliser un retour d'achat, il est conseillé de créer d'abord les éléments suivants:

- **[1. Article](https://doc.dokos.io/v5/dokos/parametrage/articles)**

Ou alors

- **[Reçu d'achat](https://doc.dokos.io/v5/dokos/stocks/recus-achats)**

## 2. Comment créer un retour d'achat

1. Ouvrez d'abord le reçu d'achat d'origine, avec lequel le fournisseur a livré les articles.
2. Cliquez sur **Créer > Retour**, cela ouvrira un nouveau reçu d'achat avec la case **Est retour** cochée. Les articles, les tarifs et les taxes seront des nombres négatifs.
3. Lors de la soumission du retour d'achat, le système diminuera la quantité d'articles de l'entrepôt mentionné. Pour maintenir une évaluation correcte des stocks, le solde des stocks augmentera également en fonction du taux d'achat initial des articles retournés.
4. Dans le grand livre comptable, le compte Stock en main sera crédité et le compte Stock reçu mais non facturé sera débité.

Si l'inventaire perpétuel est activé, le système enregistre également l'écriture comptable sur le compte d'entrepôt pour synchroniser le solde du compte d'entrepôt avec le solde du stock selon le grand livre des stocks.

## 3. Impact sur le retour des stocks via le reçu d'achat

Lors de la création d'un retour d'achat par rapport à un reçu d'achat:

La quantité retournée dans le reçu d'achat d'origine, ainsi que tout bon de commande qui y est lié, est mise à jour.

Le statut du reçu d'achat d'origine est changé en Retour émis si 100% sont retournés.


# Inspection de la qualité

Dans Dokos, vous pouvez marquer vos produits entrants ou sortants pour un contrôle qualité.

Pour accéder à cette fonctionnalité, allez sur :

> Accueil > Stock > Outils > **Inspection de qualité**

## 1. Prérequis avant utilisation

Avant de créer et d'utiliser un contrôle qualité, il est conseillé de procéder comme suit au préalable:

- Créez un élément.
- Activez les critères de contrôle qualité dans la base de données articles. En activant l'une ou l'autre des cases à cocher, la soumission d'un document de livraison / réception de stock ne sera autorisée qu'après une inspection de qualité effectuée par rapport à celui-ci.
- (Facultatif) Créez un modèle d'inspection de la qualité. Vous pouvez ajouter des paramètres d'inspection et des critères d'acceptation dans le modèle, qui peuvent être facilement récupérés dans n'importe quel contrôle qualité. Après avoir enregistré le modèle, vous pouvez définir ce modèle dans la fiche article (comme indiqué ci-dessus).

## 2. Comment créer un nouveau contrôle de qualité

1. À partir d'un brouillon de reçu d'achat / bon de livraison, allez dans le champ Contrôle qualité de la table Article et cliquez sur **Créer un nouveau contrôle qualité**. Vous pouvez également créer un contrôle qualité pour une Carte de travail afin de contrôler la qualité des articles en cours de fabrication. Dans ce cas, vous pouvez créer un contrôle qualité pour l'article de production dans la carte de travail.
2. Sélectionnez le type de contrôle : Entrant (Achat), Sortant (Ventes) ou En cours (Fabrication).
3. Sélectionnez le type de document de référence, que ce soit le reçu d'achat, la facture d'achat, le bon de livraison, la facture de vente, la saisie de stock ou la carte de travail.
4. Sélectionnez l'article et définissez la taille de l'échantillon qui sera inspecté. Notez que seuls les articles pour lesquels les critères d'inspection sont activés dans la base de données d'articles seront récupérés.
5. Le modèle de contrôle de la qualité défini dans la fiche article sera extrait.
6. Vous pouvez modifier les personnes inspectées et ajouter les personnes par lesquelles elles sont vérifiées.
7. Toute remarque supplémentaire sur l'inspection peut être ajoutée.
8. Enregistrer.

## 2.1 Création rapide depuis les transactions

Lorsqu'un article requiert une inspection de qualité, Dokos affiche un bouton de création directement dans le document de transaction concerné (reçu d'achat, bon de livraison, saisie de stock, carte de travail). Une boîte de dialogue s'ouvre pour saisir les paramètres d'inspection sans quitter le document en cours.

::callout{type="info"}
Cette boîte de dialogue d'inspection qualité a été améliorée dans le cadre des corrections du flux de fabrication (MR #9122) pour une meilleure intégration dans les transactions de production. Les inspections créées depuis une carte de travail bénéficient notamment d'une meilleure gestion du statut et du document de référence.
::

## 3. Caractéristiques

Une seule inspection de la qualité comprend de nombreux contrôles de qualité (paramètres). Chacun de ces contrôles peut être numérique, non numérique ou basé sur une formule.

### 3.1 Vérifications numériques de la qualité

Les contrôles de qualité numériques comprennent tous les contrôles qui nécessitent des lectures basées sur des nombres et des critères d'acceptation.

Par exemple, vérifier si une lecture se situe dans une certaine plage.

Par défaut, les contrôles sont numériques. Il existe deux champs : **Valeur minimale** et **Valeur maximale**, pour définir une plage dans laquelle chaque lecture doit se trouver. Ces champs peuvent être définis une fois dans le modèle de contrôle qualité et être simplement extraits dans le contrôle qualité.

Si l'une des lectures saisies ne se trouve pas dans cette plage, l'état de la ligne sera automatiquement défini sur «Rejeté» lors de l'enregistrement.

### 3.2 Contrôles de qualité non numériques (basés sur la valeur)

Les contrôles de qualité non numériques comprennent les contrôles qui nécessitent des valeurs alphabétiques ou ceux qui ne nécessitent aucun calcul mathématique.

Par exemple, vérifier si la couleur est blanche dans un contrôle de qualité de couleur, valeurs Oui / Non pour certains paramètres, etc.

Pour les contrôles non numériques, cochez la case «Non numérique». Vous remarquerez que le champ **Valeur des critères d'acceptation** et la section **Inspection basée sur la valeur** sont visibles.

Entrez le champ **Valeur de lecture**. La valeur des critères d'acceptation peut être définie une fois dans le modèle de contrôle qualité, puis extraite dans le contrôle qualité.

Si la valeur de lecture ne correspond pas à la valeur des critères d'acceptation, l'état de la ligne sera automatiquement défini sur «Rejeté» lors de l'enregistrement.

### 3.3 Contrôles de qualité basés sur des formules

Les contrôles de qualité basés sur des formules sont utiles pour les scénarios plus complexes où la simple spécification d'une plage ou d'une valeur d'acceptation ne suffit pas.

Par exemple, vérifier si la qualité d'un matériau est A / B / C, vérifier si la moyenne de certaines lectures se situe dans une certaine plage, etc.

Les contrôles de qualité basés sur des formules s'appliquent aux contrôles de qualité numériques et non numériques.

Cochez la case **Critères basés sur une formule** pour effectuer un contrôle de qualité basé sur une formule. Vous remarquerez alors un champ appelé **Formule des critères d'acceptation** dans lequel vous pouvez spécifier une formule qui détermine si une certaine vérification est acceptée ou rejetée. Cette formule peut être définie une fois dans le modèle de contrôle qualité, puis être extraite dans le contrôle qualité.

Cette formule dépend des nombreux champs de lecture du tableau des lectures.

Pour les lectures numériques, `reading_1`, `reading_2` etc. sont acceptés dans la formule.

Pour les lectures non numériques, seule `reading_value` est acceptée dans la formule.

Voici quelques exemples de formules :

```python
# Numérique
(reading_1 + reading_2) < 10       # somme des deux lectures inférieure à 10
(reading_1 + reading_2) <= 10      # somme inférieure ou égale à 10
mean < 15                          # moyenne des lectures numériques non vides inférieure à 15
(reading_1 * 2) < 20               # lecture 1 multipliée par 2 inférieure à 20
(reading_1) / 2 < 20               # lecture 1 divisée par 2 inférieure à 20

# Non numérique
reading_value in ("A", "B", "C")   # la valeur est A, B ou C
reading_value != "Red"             # la valeur n'est pas Rouge
```

Mettez à jour les lectures et enregistrez. Le champ **Statut** dans les lignes de la table Lectures est défini automatiquement en fonction de la formule d'acceptation.

### 3.4 Inspection manuelle

Jusqu'à présent, tous les contrôles de qualité ont une acceptation / rejet automatique lors de l'enregistrement. Dans le monde réel, il peut y avoir des cas où un contrôle est rejeté mais sera pourtant accepté parce qu'il y a une certaine tolérance.

De tels cas obligeront l'utilisateur à déterminer l'état au niveau de la ligne. Pour éviter toute interférence du système lors de ces contrôles, cochez la case **Inspection manuelle**. Vous pouvez maintenant définir le statut manuellement et il ne sera pas touché lors de l'enregistrement.

Par exemple, si la lecture 1 est légèrement en dehors de la plage définie, ce contrôle serait normalement rejeté. Mais si l'écart est jugé tolérable, l'opérateur peut l'accepter manuellement. Le statut de l'intégralité du contrôle qualité peut alors être décidé par l'utilisateur.


# Règle de livraison

En utilisant la règle de livraison, vous pouvez définir le coût de livraison d'un produit au client ou depuis le fournisseur.

Avec les règles de livraison, vous pouvez :

- définir un montant de livraison fixe
- définir un montant de livraison pour différentes plages de poids ou de montants
- définir différentes règles pour différents pays
- proposer des modes de livraison E-Commerce
- proposer des points de retrait E-Commerce

---

Pour accéder à la **règle de livraison**, allez sur :

> Accueil > Vente > Articles et prix > **Règle de livraison**

![règle\_de\_livraison\_.png](https://doc.dokos.io/content/ventes/shipping-rule/regle_de_livraison_.png)

## Comment créer une règle de livraison

1. Accédez à la liste des **règles de livraison**, cliquez sur ➕ Nouveau.
2. Saisissez le libellé de la règle de livraison, par exemple «Expédition prioritaire» ou «Expédition le jour suivant».
3. Poursuivez avec les détails comptables tels que le compte de livraison, le centre de coûts auquel le montant sera facturé et le montant de livraison.
4. Sous Calculer en fonction de, vous pouvez également modifier le calcul sur lequel la règle de livraison sera appliquée comme la quantité totale nette ou le poids total net, par défaut, il est "Fixe".
5. **Enregistrer**.

![créer\_règle\_de\_livraison.png](https://doc.dokos.io/content/ventes/shipping-rule/creer_regle_de_livraison.png)

## Caractéristiques

### Comptabilité

La section comptabilité vous permet de définir la société qui sera affecté par les transactions et de défnir le compte de livraison pour la création de cette règle de livraison.

![comptabilité\_règle\_de\_livraison.png](https://doc.dokos.io/content/ventes/shipping-rule/comptabilite_regle_de_livraison.png)

### Dimensions comptables

Les dimensions comptables vous permettent d'étiqueter les transactions en fonction d'un territoire, d'une succursale, d'un client, etc. spécifiques. Cela permet d'afficher les états comptables séparément en fonction de la ou des dimensions sélectionnées.

### Conditions des règles de livraison

En sélectionnant Total net ou Poids net, un tableau apparaîtra dans lequel vous pouvez définir les valeurs de départ et d'arrivée pour le montant ou le poids. Saisissez le montant de livraison à calculer pour la plage saisie. Ajoutez plus de conditions si nécessaire. Vous ne pouvez sélectionner qu'une des trois méthodes de calcul dans une règle de livraison.

![mode\_de\_calcul\_règle\_de\_livraison.png](https://doc.dokos.io/content/ventes/shipping-rule/mode_de_calcul_regle_de_livraison.png)

### Restreindre aux pays

Vous pouvez limiter la règle de livraison à certains pays, ajoutez les pays dans le tableau. Par défaut, la règle de livraison sera applicable dans le monde entier.

![restreindre\_au\_pays\_règle\_de\_livraison.png](https://doc.dokos.io/content/ventes/shipping-rule/restreindre_au_pays_regle_de_livraison.png)

## Proposer des modes de livraison E-Commerce

Pour proposer des modes de livraison sur le site web, lors du passage d'une commande, rendez-vous dans l'onglet **Site web** de la règle de livraison et cochez la case **Afficher sur le site web**.

Vous pouvez optionnellement définir une **Description** et modifiez le **Libellé** (onglet *Détails*) qui seront présentés aux clients.

## Proposer des points de retrait E-Commerce

Pour toute règle de livraison disponible sur le site web, vous pouvez proposer des points de retrait. Sinon, n'importe quelle adresse de livraison sera acceptée dans la commande.

Dans l'onglet **Site web**, ajouter des lignes dans le tableau **Points de retrait**. Chaque ligne n'est composée que d'une seule case : le Lien vers le document **Adresse**. Il faut donc au préalable créer un document Adresse pour chaque point de retrait, puis le lier à la règle de livraison. Vous pouvez utiliser [l'outil d'import de données](https://doc.dokos.io/v5/dokos/parametrage/demarrage/import-de-donnees) pour créer rapidement ces adresses depuis un fichier Excel par exemple.


# Règles de prix

Une règle de prix définit les règles de remise/tarification qui s'appliquent en fonction de conditions définies.

Une règle de tarification comporte de nombreuses options à l'aide desquelles vous pouvez contrôler la tarification d'un article. Des filtres tels que la quantité, la date, les groupes et d'autres conditions peuvent être définis.

**Voici les quelques cas qui peuvent être traités à l'aide de la règle de tarification** :

- Conformément à une politique de vente promotionnelle, si le client achète plus de 10 unités d'un article, il bénéficie d'une remise de 20 %.
- Pour le client "XYZ", le prix de vente de l'article spécifique doit être mis à jour sous la forme ###.
- Les articles classés dans un groupe d'articles spécifique ont le même prix de vente ou d'achat.
- Les clients appartenant à un groupe de clients spécifique devraient obtenir ### prix de vente, ou % de remise sur les articles.
- Le fournisseur classé dans un groupe de fournisseurs spécifique doit appliquer un taux d'achat de ###.

---

Pour que la remise et le tarif de la liste de prix s'appliquent automatiquement à un article, créez des règles de tarification pour celui-ci.

Pour accéder à la liste des règles de prix, allez sur:

> Accueil > Stock > Articles et prix > **Règle de prix**

## 1. Pré-requis avant utilisation

Avant de créer et d'utiliser une règle de tarification, il est conseillé de créer d'abord les éléments suivants :

- Article
- Groupe d'articles
- Client
- Le fournisseur

## 2. Comment créer une règle de tarification

1. Accédez à la liste des règles de tarification et cliquez sur Nouveau.
2. Définissez un titre pour la règle.
3. Sélectionnez les éléments à appliquer à partir du code d'article, du groupe d'articles, de la marque ou de la transaction.
4. Sélectionnez si vous souhaitez appliquer une remise sur le prix ou une remise sur le produit. Si vous souhaitez offrir des produits gratuits, sélectionnez la remise sur le produit.
5. Pour un article unique, sélectionnez Code article et sélectionnez les articles.
6. Si vous souhaitez que la règle de tarification soit appliquée à tous les articles, sélectionnez "Groupe d'articles" et sélectionnez Tous les groupes d'articles (groupe d'articles parent).
7. Définissez la remise/le prix à appliquer. Pour en savoir plus, rendez- vous dans cette rubrique .
8. Enregistrer.

### 2.1 Options supplémentaires lors de la création d'une règle de tarification

#### Entrepôt

La définition d'un entrepôt ici entraînera l'application de la règle de tarification uniquement si l'article est sélectionné dans l'entrepôt spécifié ici.

#### Appliquer la règle sur

En fonction de l'attribut sélectionné dans le champ "Appliquer sur", vous pouvez définir la règle de tarification en fonction de l'une des options suivantes :

- Article
- Groupe d'articles
- Marque
- Transaction (sur le montant total de la transaction)

Dans ce tableau, vous pouvez sélectionner l'article/le groupe d'articles/la marque spécifique. Par exemple, si vous sélectionnez Appliquer sur 'Groupe d'articles' et sélectionnez 'Matières premières' dans le tableau, cette règle de tarification sera appliquée uniquement aux articles appartenant au groupe 'Matières premières'.

**UDM** : la règle de tarification ne s'appliquera que si l'UoM définie ici correspond à la transaction.

#### Condition

Dans ce champ, vous pouvez ajouter une condition en python pour vérifier les valeurs de champ dans le doctype de transaction, comme indiqué ci-dessous pour Sales Invoice :

customer=='Customer Name' and status!='Overdue'
Veuillez noter que seules les conditions python à une seule ligne fonctionneront, en utilisant les noms de champ du doctype cible.

#### Conditions mixtes

Si vous sélectionnez deux articles ou plus et définissez la quantité minimale et maximale. La règle de tarification ne sera appliquée que si la somme totale des articles correspond aux quantités définies. Par exemple, si vous créez une règle de tarification sur l'article 1 et l'article 2 et définissez la quantité minimale et maximale sur 30, la règle de tarification s'appliquera uniquement si la quantité totale est de 30.

#### Est cumulatif

L'activation de cette option permet d'appliquer la règle de tarification de manière cumulative. Vous devez définir le 'Min Amt' et le 'Max Amt' pour cela.

Considérez un scénario où le Min Amt est de 1 500 et le Max Amt est de 2 000. Désormais, si une transaction est créée pour 1 400, la règle de tarification ne sera pas appliquée. Cependant, lors de la création d'une deuxième facture d'un montant de 600, la règle de tarification sera appliquée. Cela s'est produit puisque le montant total (cumulatif) des factures s'est élevé à 2 000. Notez que la remise ne sera appliquée qu'à la dernière transaction qui dépasse la limite cumulée.

Cela peut être utile pour accorder des remises si un client achète un article plusieurs fois et que vous souhaitez le récompenser avec des remises/prix spéciaux.

## 3. Caractéristiques

### 3.1 Appliquer la règle sur les autres

Cette fonctionnalité vérifie la condition sur le premier élément mais applique la règle sur un autre élément.

Par exemple, définissez Item1 et Item2 dans le tableau "Apply Rule On" et définissez "Apply Rule On Other" sur Item3. Désormais, si la transaction contient Item1, Item2 et Item3, la règle de tarification s'appliquera à Item3 puisque les deux premiers Items étaient présents dans la transaction.

### 3.2 Informations sur la partie

Définissez si la règle de tarification concerne la vente ou l'achat de l'article.

En fonction de votre sélection, vous pouvez définir l'applicabilité à l'un des maîtres suivants.

- Client
- Groupe de clients
- Territoire
- Partenaire commercial
- Campagne
- Le fournisseur
- Groupe de fournisseurs

### 3.3 Quantité et Montant

Spécifiez la quantité minimale, la quantité maximale, la quantité minimale ou la quantité maximale d'un article lorsque cette règle de tarification doit être appliquée.

Notez que si la quantité ou le montant est inférieur ou supérieur aux limites fixées ici, la règle de tarification ne sera pas appliquée du tout. Cependant, il sera appliqué si vous avez activé les options Conditions mixtes ou Cumulatif.

Quantité et montant de la règle de tarification

### 3.4 Validité

Vous pouvez également définir un intervalle de dates pour la validité de la règle de tarification. Ceci est utile pour une promotion des ventes. En laissant les dates vides, la règle de tarification n'aura aucune limite de temps.

Paramètres de période de règle de tarification

### 3.5 Marge

**Type de marge** : Lors de la vente d'un article, vous pouvez le vendre avec une certaine marge. Si vous ne souhaitez pas ajouter des prix de vente aux articles à chaque fois et que vous souhaitez définir automatiquement une marge, vous pouvez le faire avec cette fonctionnalité.

**Taux ou montant de la marge** : la marge définie peut être basée sur un pourcentage ou un montant, par exemple : une marge de 5 % ou une marge fixe de 50 $.

### 3.6 Programme de remise sur les prix

La règle réelle à appliquer est définie dans cette section.

**Tarif** : Ce sera le nouveau tarif pour un article. Par exemple, si vous vendez un article pour 100 et que vous souhaitez le vendre pour 112 pour une partie spécifique, sélectionnez Tarif et définissez le Tarif sur 112.

**Pourcentage de remise** : Un pourcentage de remise spécifique peut être défini. Le pourcentage de remise peut être défini sur une liste de prix spécifique . Si vous laissez le champ "Pour la liste de prix" vide, la règle de tarification s'appliquera à toutes les listes de prix.

**Montant de la remise** : Un montant de remise fixe sera appliqué. Par exemple, si vous vendez un article pour 100 et souhaitez le vendre avec une remise de 7, cette condition peut être définie à l'aide de l'option Montant de la remise.

### 3.7 Paramètres avancés

\*\*
Seuil de suggestion\*\* : il s'agit du seuil en fonction duquel le système vous avertira d'ajuster la quantité d'articles pour la remise. Par exemple, si la quantité minimale est de 10 et que le seuil est de 9, le système vous avertira d'ajouter 1 article supplémentaire pour que la remise soit applicable. Ceci s'applique également au montant fixé.

**Priorité** : considérez un groupe d'éléments, vous souhaitez définir des règles spécifiques sur un élément du groupe. Cela peut être fait en créant une nouvelle règle de tarification et en définissant une priorité plus élevée. Cela peut également s'appliquer au groupe de clients et au groupe de fournisseurs.

**Appliquer plusieurs règles de tarification** : pour comprendre cela, considérons un article au tarif 500. Il existe deux règles de tarification P1 et P2. P1 applique 10 % de réduction et P2 applique 5 %. L'activation de cette option appliquera un total de 15 % sur le tarif de l'article, ce qui donne 425.

**Appliquer la réduction sur le tarif** : la réduction sera aggravée. Considérez le même scénario que ci-dessus. En activant cette option, 10% seront appliqués sur 500 ce qui donnera 450, puis 5% seront appliqués sur 450 ce qui donnera 427,5.

**Valider la règle appliquée** : affiche le message de validation saisi si la remise/le taux que vous avez défini manuellement dans une transaction ne correspond pas à la règle de tarification.

Ceci est utile lorsque le premier distributeur de la hiérarchie décide de la remise/du tarif à appliquer et que vous ne validez que si la règle de tarification est appliquée correctement.

## 4. Types de remise des règles de tarification

### 4.1 Réduction de prix

1. Sous Type de marge, vous pouvez définir si la marge est calculée en pourcentage ou en montant. Ex : 10% de marge sur tarif fournisseur au moment de la vente.
2. Le tarif mentionné dans la règle de tarification aura priorité sur le tarif de la liste de prix de l'article (prix de l'article).
3. Le pourcentage de remise peut être appliqué pour une liste de prix spécifique (vente ou achat). Pour l'appliquer aux deux, laissez le champ "Pour la liste de prix" vide.
4. La remise peut également être définie en termes de montant.

### 4.2 Remise sur les produits

1. "Achetez 2 quantités obtenez 1 quantité gratuite du même article." Pour configurer ce type de règles, définissez le prix ou la remise sur le produit sur "Remise sur le produit", cochez la case Même article et définissez la quantité.
2. "Achetez 2 quantités obtenez 1 quantité gratuite de l'autre article." Pour configurer ce type de règles. Définissez le prix ou la remise sur le produit comme remise sur le produit, décochez la case "Même article" et définissez l'"article gratuit" et la quantité.


# Conservation du stock d'échantillons

Le stock d'échantillon est un lot de tous les articles stockés pour analyse en cas de besoin plus tard.

L'article pour lequel le stock d'échantillons est stocké peut être une matière première, un matériau d'emballage ou un produit fini.

## 1. Prérequis

Avant d'utiliser la rétention d'échantillons, il est conseillé de créer d'abord les éléments suivants:

- **[Article](https://doc.dokos.io/v5/dokos/parametrage/articles)**
- **[N°de Lot](https://doc.dokos.io/v5/dokos/stocks/batch)**
- **[Entrepôt](https://doc.dokos.io/v5/dokos/stocks/warehouse)**

## 2. Comment définir l'entrepôt de conservation des échantillons dans les paramètres de stock

Il est conseillé de créer un nouvel entrepôt séparément pour la conservation des échantillons et de ne pas l'utiliser en production.

### 2.1 Activer la conservation de l'échantillon dans le maître des articles

**Conserver un échantillon** est basé sur **A un numéro de Lot**, donc ce champ doit être activé en premier.
Cochez **Conserver l'échantillon et** définissez le nombre maximal d'échantillons autorisés pour un lot.

### 2.2 Effectuer une entrée de stock

- Chaque fois qu'une entrée de stock est créée dans le but de recevoir un article, pour les articles pour lesquels la conservation de l'échantillon est activée, la quantité d'échantillon peut être définie pendant cette entrée de stock. Vous devez sélectionner le numéro de lot de l'article / des articles. La quantité d'échantillon ne peut pas être supérieure à la quantité d'échantillon maximale définie dans la base d'articles.
- Lors de la soumission de cette entrée de stock, le bouton Effectuer une entrée de stock de rétention sera disponible pour effectuer une autre entrée de stock pour le transfert d'échantillons d'articles du lot mentionné vers l'entrepôt de rétention défini dans les paramètres de stock.
- En cliquant sur ce bouton, vous serez dirigé vers une nouvelle entrée de stock de type **Transfert de matériel**. Cette entrée transfère votre rétention d'échantillons de votre entrepôt cible (magasins) à l'entrepôt de rétention d'échantillons. Il contiendra toutes les informations, vérifiez et cliquez sur Soumettre.


# Retour des ventes

Un article vendu retourné est appelé retour de vente.

Les entreprises retournent souvent des biens déjà vendus. Ils pourraient être retournés par le client en raison de problèmes de qualité, de non-livraison à la date convenue ou pour toute autre raison.

## 1. Prérequis avant utilisation

Avant de créer et d'utiliser un retour sur vente, il est conseillé de créer d'abord les éléments suivants:

- **[Article](https://doc.dokos.io/v5/dokos/parametrage/articles)**
- **[Facture de vente](https://doc.dokos.io/v5/dokos/ventes/facture-de-vente)**

Ou alors

## 2. Comment créer un retour sur vente

1. Ouvrez d'abord le bon de livraison / la facture de vente d'origine, contre laquelle le client a renvoyé les articles.
2. Cliquez ensuite sur **Créer > Retour de vente**, il ouvrira un nouveau bon de livraison avec **Est retour** coché, les articles, le taux et les taxes seront des nombres négatifs.
3. Vous pouvez également créer l'écriture de retour par rapport à la facture de vente d'origine, pour retourner le stock avec la note de crédit, cochez l'option **Mettre à jour le stock** dans la facture de retour de vente.
4. Lors de l'enregistrement du bon de livraison de retour / de la facture de vente, le système augmentera le solde du stock dans l'entrepôt mentionné. Pour maintenir une évaluation correcte des stocks, le solde des stocks augmentera en fonction du taux d'achat initial des articles retournés.
5. En cas de retour de facture de vente, le compte client sera crédité et le compte de revenu et d'impôt associé sera débité comme indiqué dans le grand livre comptable.

Si l'inventaire perpétuel est activé, le système enregistrera également l'écriture comptable sur le compte d'entrepôt pour synchroniser le solde du compte d'entrepôt avec le solde du stock selon le grand livre des stocks.

## 3. Impact sur le retour de stock via le bon de livraison

Lors de la création d'un retour vente par rapport à un bon de livraison:

- La quantité retournée dans le bon de livraison d'origine, ainsi que toute commande client qui y est liée, est mise à jour.
- Le statut du bon de livraison d'origine est changé en Retour émis si 100% retourné.


# Schéma promotionnel

Un programme promotionnel est une remise temporaire sur un ou plusieurs produits.

Les schémas promotionnels aident les entreprises à réussir en réduisant les prix pendant une période limitée pour attirer plus de clients. Ils peuvent être facilement configurés dans Dokos. Un schéma promotionnel est lié à une règle de prix.

Lors de la création d'un schéma promotionnel, le système crée une règle de prix. Un schéma promotionnel peut être associé à plusieurs règles de prix. Dans Dokos, un schéma promotionnel est un moyen plus simple de gérer les prix sur plusieurs articles/groupes en fonction de différentes parties et conditions.

---

Pour accéder à l**a liste des schémas promotionnels**, allez sur :

> Accueil > Vente > Articles et prix > **Schéma promotionnel**

## 1. Prérequis avant utilisation

Avant de créer et d'utiliser un système promotionnel, il est conseillé de créer d'abord les éléments suivants :

- **[Article](https://doc.dokos.io/v5/dokos/parametrage/articles)**
- **[Groupe d'article](https://doc.dokos.io/v5/dokos/parametrage/articles#groupes-darticles)**
- **[Client](https://doc.dokos.io/v5/dokos/parametrage/clients)**
- **[Fournisseur](https://doc.dokos.io/v5/dokos/parametrage/fournisseurs)**

## 2. Comment créer un programme promotionnel

1. Accédez à la liste des programmes promotionnels et cliquez sur ➕ Ajouter Schéma promotionnel.
2. Saisissez un **nom** pour la règle.
3. Sélectionnez sur **quoi appliquer**, comme le code d'article, le groupe d'articles, la marque ou la transaction. La sélection de Transaction appliquera le schéma sur le montant total de la transaction.
4. Sur la base du système **Appliquer sur** », vous aurez la possibilité de sélectionner le code d'article / le groupe d'articles / la marque dans le tableau.
5. Sélectionnez si le **schéma est destiné à la vent**e, à l'**achat** ou aux **deux** et définissez les informations sur la pièce.
6. Dans le tableau **Remise sur le prix du schéma promotionnel**, définissez la remise sur le prix, la remise sur le produit.
7. Les utilisateurs peuvent également appliquer la remise sur l'autre code d'article/groupe d'articles/marque en sélectionnant la valeur du champ Appliquer la règle sur l'autre.
8. **Enregistrer**.

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
**Remarque** : lors de l'enregistrement d'un programme promotionnel, une nouvelle règle de tarification est créée.
::

### 2.1 Champs supplémentaires lors de la création d'un programme promotionnel

**Conditions mixtes**
Si vous sélectionnez deux articles ou plus et définissez la quantité minimale et maximale. Le programme promotionnel ne sera appliqué que si la somme totale des articles correspond aux quantités définies. Par exemple, vous créez un programme promotionnel sur l'article 1 et l'article 2 et définissez la quantité minimale et maximale sur 30, le programme promotionnel ne s'appliquera que si la quantité totale est de 30.

**est cumulatif**
L'activation de cette option permet au programme promotionnel d'être appliqué de manière cumulative. Vous devez définir le « Min Amt » et le « Max Amt » pour cela.

Considérons un scénario dans lequel le Min Amt est de 1 500 et le Max Amt est de 2 000. Désormais, si une transaction est créée pour 1 400, le programme promotionnel ne sera pas appliqué. Cependant, lors de la création d'une deuxième facture d'un montant de 600, le système promotionnel sera appliqué. Cela s'est produit puisque le montant total (cumulé) des factures s'élevait à 2 000. Notez que la remise ne sera appliquée qu'à la dernière transaction qui dépasse la limite cumulée.

Cela peut être utile pour offrir des remises si un client achète plusieurs fois un article et que vous souhaitez le récompenser avec des remises/prix spéciaux.

## 3. Caractéristiques

### 3.1 Remise sur un autre élément

Cette fonction vérifie l'état du premier article mais applique un régime/une remise/un taux sur un autre article.

Par exemple, définissez Item1 et Item2 dans le tableau "Appliquer la règle sur" et définissez "Appliquer la règle sur les autres" sur Item3. Désormais, si la transaction a Item1, Item2 et Item3, la règle de tarification s'appliquera à Item3 puisque les deux premiers Items étaient présents dans la transaction.

### 3.2 Informations additionnelles

Définissez si le programme promotionnel est destiné à la vente ou à l'achat de l'article.

En fonction de votre sélection, vous pouvez définir l'applicabilité à l'un des documents (Client, Groupe de clients, Région, Campagne, Fourniosseur, Groupe de fournisseurs)

### 3.3 Paramètres de la période

Vous pouvez également définir un intervalle de dates pour lequel le programme promotionnel sera valide. Ceci est utile pour une promotion des ventes. En laissant les dates vides, le programme promotionnel n'aura aucune limite de temps.

**Devise** : La définition d'une devise ici entraînera l'application du programme promotionnel uniquement lorsque la devise est la même dans la transaction.

### 3.4 Règles de remise sur le prix

**Description de la règle** : Entrez une description pour ne pas comprendre ce que ce programme promotionnel implique.

**Quantité et montant**
Spécifiez la quantité minimale, la quantité maximale, le montant minimum ou le montant maximum d'un article lorsque ce programme promotionnel devrait être applicable.

Notez que si la quantité ou le montant est inférieur ou dépasse les limites définies ici, le programme promotionnel ne sera pas du tout appliqué. Cependant, il sera appliqué si vous avez activé les options Conditions Mixtes ou Cumulatives.

**Définition de la remise/du taux**

- **Tarif** : Ce sera le nouveau tarif pour un Article. Par exemple, si vous vendez un article pour 100 et que vous souhaitez le vendre pour 112 pour une partie spécifique, sélectionnez Tarif et définissez le Tarif sur 112.
- **Pourcentage de remise** : Un pourcentage de remise spécifique peut être défini. Par exemple, une remise de 10 % sur un article d'une valeur de 500 se traduirait par un prix de 450.
- **Montant de la remise** : Un montant de remise fixe sera appliqué. Par exemple, si vous vendez un article pour 100 et que vous souhaitez le vendre avec une remise de 7, cette condition peut être définie à l'aide de l'option Montant de la remise.

**Filtres pour définir la remise**

- **Entrepôt** : La définition d'un entrepôt ici entraînera l'application du programme promotionnel uniquement si l'article est sélectionné dans l'entrepôt spécifié ici.
- **Priorité** : Considérez un groupe d'éléments, vous souhaitez définir des règles spécifiques sur un élément du groupe. Cela peut être fait en créant un nouveau programme promotionnel et en définissant une priorité plus élevée.
- **Seuil de suggestion** : Il s'agit du seuil en fonction duquel le système vous notifiera d'ajuster la quantité d'articles pour la remise. Par exemple, si la quantité minimale est de 10 et le seuil est de 9, le système vous demandera d'ajouter 1 article supplémentaire pour que la remise soit applicable. Ceci s'applique également au montant fixé.
- **Valider la règle appliquée** : Si le prix saisi n'est pas valide pour l'article, le système ne vous permettra pas d'appliquer un taux/remise différent.

### 3.5 Règles de remise sur les produits

Une remise sur les produits est applicable lorsqu'un ou plusieurs articles sont gratuits sur l'achat d'autres articles. La plupart des champs de ce tableau sont les mêmes que ceux de la section précédente.

- **Les options supplémentaires sont** : \* Même Article : Si vous souhaitez offrir le même Article gratuitement (remise produit) à l'achat d'un Article, cochez cette case. Si vous souhaitez offrir un autre article, décochez et sélectionnez l'article à offrir gratuitement.
- **Appliquer plusieurs règles de tarification** : Pour comprendre cela, considérons un article au tarif 500. Il comporte deux règles de tarification P1 et P2. P1 applique 10% de réduction et P2 applique 5%. L'activation de cette option appliquera un total de 15 % sur le tarif de l'article, ce qui donne 425.
- **UDM (Unité de mesure)** : Le système promotionnel ne s'appliquera que si l'UoM définie ici correspond à la transaction.
- **Tarif** : Un Article peut être offert gratuitement par le Fournisseur mais il peut y avoir des taxes applicables. La saisie d'un Tarif ici signifie que le Client devra payer les taxes applicables.

## 4. Types de schémas promotionnels

### 4.1 Remise sur les prix

Dans ce type de programme promotionnel, l'utilisateur a la possibilité de définir la remise en termes de pourcentage ou de montant en fonction de la quantité minimale, de la quantité maximale, du montant minimal et du montant maximal des produits. Les utilisateurs peuvent également configurer le schéma où ils peuvent définir le taux forfaitaire du produit en fonction de la quantité ou du montant du produit.

### 4.2 Remise sur les produits

Dans ce type de programme promotionnel, l'utilisateur a la possibilité d'offrir un produit gratuit à l'achat du même produit ou d'un produit différent avec des conditions telles que la quantité minimale, la quantité maximale, le montant minimal, le montant maximal.

## 5. Comment configurer un schéma promotionnel (exemples)

Comprenons comment configurer un schéma promotionnel dans Dokos à l'aide de quelques exemples.

### 5.1 Régimes de conditions mixtes

Le client A a acheté 10 quantités de paquet Britannia Cake 5 Rs et 5 quantités de paquet Britannia Cake 10 Rs. Maintenant, le fournisseur souhaite accorder une remise de 10 % au client A. Ce fournisseur souhaite également accorder une remise de 10 % au client B qui a acheté 15 quantités de paquet Britannia Cake 5 Rs.

Ainsi, le Fournisseur souhaite appliquer la remise sur les produits Britannia Cake 5 Rs, Britannia Cake 10 Rs uniquement si ses Clients ont acheté 15 quantités d'un produit quelconque ou la somme des deux produits.

Pour configurer cela dans Dokos, les étapes sont les suivantes :

- Définissez Appliquer le comme code d'article.
- Définissez le code d'article Britannia Cake 5 Rs, Britannia Cake 10 Rs dans le tableau des codes d'article de la règle de tarification.
- Activez le champ « Conditions mixtes ».
- Dans le tableau des remises de prix, définissez la quantité minimale et la quantité maximale sur 15.
- Définissez le type de remise sur Pourcentage de remise et le taux sur 10.

### 5.2 Pour appliquer une remise sur d'autres articles

Le client A a acheté 30 quantités de paquet Britannia Cake 5 Rs et 2 quantités de Britannia Cake 15 Rs. Le Fournisseur souhaite vendre le produit Britannia Cake 15 Rs au forfait 12. Ici, le prix d'origine du produit Britannia Cake 15 Rs est de 15.

Le fournisseur souhaite appliquer la règle uniquement si le client a acheté au moins 30 quantités du produit Britannia Cake 5 Rs ou Britannia Cake 10 Rs.

Pour configurer cela dans Dokos, les étapes sont les suivantes :

- Définissez Appliquer le comme code d'article.
- Définissez le code d'article Britannia Cake 5 Rs, Britannia Cake 10 Rs dans le tableau des codes d'article de la règle de tarification.
- Appliquez la règle sur les autres comme code d'article et définissez le code d'article comme Britannia Cake 15 Rs.
- Dans le tableau des remises de prix, définissez la quantité minimale sur 30.
- Définissez le type de remise sur Taux et le taux sur 12.


# Numéro de série

Comme indiqué dans la page Article, si un article est paramètré en Série alors un enregistrement de numéro de série ( numéro de série) est conservé pour chaque quantité de cet article. Ces informations permettent de suivre l'emplacement du numéro de série, sa garantie et les informations de fin de vie (expiration).

Les numéros de série sont également utiles pour maintenir les immobilisations. Les programmes de maintenance peuvent également être créés par rapport aux numéros de série pour la planification et la planification des activités de maintenance pour ces actifs (s'ils nécessitent une maintenance).

Vous pouvez également savoir à quel fournisseur vous avez acheté le numéro de série et à quel client vous l'avez vendu. Le statut No de série vous indiquera son état actuel de l'inventaire.

Si votre article est en série, vous devrez entrer les numéros de série dans la colonne correspondante avec chaque numéro de série dans une nouvelle ligne. Vous pouvez gérer des unités uniques d'articles sérialisés à l'aide du numéro de série.

---

Pour accéder à la liste des numéros de série, allez sur :

> Accueil > Stock > N° de série et lot > **N° de série**

## 1. Prérequis avant utilisation

Avant de créer et d'utiliser un numéro de série, il est conseillé de créer d'abord les éléments suivants:

- **[Articles](https://doc.dokos.io/v5/dokos/parametrage/articles)**
- Activez "A un numéro de série" dans la base d'articles

## 2. Comment créer un numéro de série

Habituellement, les numéros de série sont créés automatiquement lorsque des transactions sont effectuées sur un article sérialisé. Cela ne fonctionne que lorsque «A un numéro de série» est activé et qu'une série est définie dans le masque d'articles.

Par exemple, une série a été définie pour l'élément suivant comme «PB2L. #####». Ensuite, une entrée de stock a été soumise pour recevoir l'article. Les numéros de série ont été créés en conséquence.

Toutefois, si vous souhaitez créer un numéro de série manuellement, procédez comme suit:

1. Accédez à la liste des numéros de série, cliquez sur **➕ Ajouter N°de série**.
2. Entrez un **numéro de série**.
3. Entrez le **code de l'article** et les détails seront récupérés.
4. Si une transaction est effectuée avec un article, le numéro de série ne peut pas être défini ou annulé.
5. **Enregistrer**.

L'inventaire d'un article ne peut être affecté que si le numéro de série est traité via une transaction de stock (entrée de stock, reçu d'achat, bon de livraison, facture de vente). Lorsqu'un nouveau numéro de série est créé directement, son entrepôt ne peut pas être défini.

### 2.1 Remarques sur le numéro de série

- Le statut est défini en fonction de l'entrée de stock.
  Seuls les numéros de série avec le statut «Disponible» peuvent être fournis.
- Les numéros de série peuvent être créés automatiquement à partir d'une entrée de stock ou d'un reçu d'achat. Si vous mentionnez le numéro de série dans la colonne Numéros de série, il créera automatiquement ces numéros de série.
- Si dans la base de données articles, la série No de série est mentionnée, vous pouvez laisser la colonne No de série vide dans une entrée de stock / un reçu d'achat. Les numéros de série seront automatiquement définis à partir de cette série.

## 3. Caractéristiques

### 3.1 Détails d'Achat / Production

Le document à partir duquel le numéro de série a été créé sera affiché. Si vous l'avez acheté auprès d'un fournisseur, il sera lié ici.

### 3.2 Détails de livraison

Si le numéro de série a été généré à partir d'une commande client, le client sera lié ici.

### 3.3 Détails de la garantie / AMC

Si l'article est sous garantie ou AMC (contrat de maintenance annuel), les dates d'expiration de celles-ci peuvent être définies.

### 3.4 Plus d'informations

Toute information supplémentaire sur cette unité d'article spécifique peut être définie sous **Numéro de série**.


# Projections de stock

Les projections de stock donnent une vision prospective des niveaux d'inventaire : non seulement ce qui est physiquement disponible aujourd'hui, mais aussi ce qui est attendu (commandes fournisseurs en transit, production lancée) et ce qui est déjà engagé (commandes clients, ordres de travail). Cette vue permet d'anticiper les ruptures et d'agir avant que la production ne soit bloquée.

Pour accéder aux projections de stock, allez sur :

> Accueil > Stock > Rapports de stock > **Projections de stocks**

## Quantité projetée

La quantité projetée est la résultante de tous les flux stocks attendus sur un article. Dokos la calcule ainsi :

**Quantité projetée = Quantité réelle + Quantité planifiée + Quantité commandée + Quantité demandée − Quantité réservée − Stock réservé**

- **Quantité réelle** — stock physiquement disponible dans l'entrepôt
- **Quantité planifiée** — quantité en cours de fabrication (ordres de travail lancés)
- **Quantité commandée** — quantité commandée à un fournisseur, non encore réceptionnée
- **Quantité demandée** — quantité couverte par une demande d'achat, non encore commandée
- **Quantité réservée** — quantité réservée pour des commandes clients ou des ordres de travail
- **Stock réservé** — quantité mise en réserve pour des besoins spécifiques (ex : projets, échantillons)

> **Exemple — Dokompany**
> Il reste 8 moteurs en stock (quantité réelle). 5 sont réservés pour un ordre de travail en attente (quantité réservée). Une commande fournisseur de 15 moteurs est en transit (quantité commandée). 2 moteurs sont mis en réserve pour un projet spécial (stock réservé). La quantité projetée est donc : 8 + 15 − 5 − 2 = **16 moteurs disponibles** après réception de la commande.

## Lecture par entrepôt et vue consolidée

Les projections de stock s'affichent par défaut par entrepôt. Chaque entrepôt présente ses propres niveaux indépendamment des autres, même s'ils appartiennent au même groupe hiérarchique.

Pour obtenir une vue consolidée sur plusieurs entrepôts d'un même groupe, filtrez le rapport par **entrepôt parent**. Dokos agrège alors les quantités de tous les sous-entrepôts rattachés à ce groupe.

> **Exemple — Dokompany**
> Dokompany gère ses composants entre l'entrepôt « Stock Pièces » (composants disponibles à la production) et « Qualité Contrôle » (composants en attente d'inspection). En filtrant sur l'entrepôt parent « Stock », le rapport consolide les deux et affiche le stock total — y compris les pièces pas encore libérées.

::callout{type="warning"}
La consolidation par entrepôt parent inclut **tous** les sous-entrepôts, y compris les entrepôts qualité dont les articles ne sont pas encore disponibles pour la production. Si votre organisation sépare le stock disponible du stock en contrôle qualité, filtrez le rapport sur l'entrepôt de stock disponible uniquement pour obtenir une projection réaliste des besoins de production.
::

## Stock en entrepôt qualité et planification de production

Lorsque des articles passent par un entrepôt de contrôle qualité avant d'être utilisés en production, leur stock n'est pas encore disponible au sens opérationnel. Dokos ne les considère pas automatiquement comme disponibles pour les ordres de travail tant qu'ils n'ont pas été transférés vers l'entrepôt de production.

Ce comportement est intentionnel : un article en attente de contrôle qualité peut être refusé et retiré du stock. L'inclure dans les projections de production conduirait à planifier une fabrication sur du stock incertain.

> **Exemple — Dokompany**
> 20 moteurs sont dans « Qualité Contrôle » en attente d'inspection. 15 sont dans « Stock Pièces » après validation. Le plan de production, configuré pour sourcer depuis « Stock Pièces », ne voit que les 15 moteurs disponibles et génère une demande d'achat pour les moteurs manquants — sans tenir compte des 20 unités dont le statut qualité est encore incertain. Une fois l'inspection des 20 moteurs validée et le transfert vers « Stock Pièces » effectué, la projection se met à jour.

La séquence recommandée pour maintenir des projections fiables est la suivante :

::mermaid
flowchart LR
A\[Réception fournisseur] --> B\[Entrepôt Qualité Contrôle]
B -->|Inspection acceptée| C\[Entrepôt Stock disponible]
B -->|Inspection refusée| D\[Entrepôt Non-conformes]
C --> E\[Disponible pour production]
E --> F\[Projections de stock à jour]

::

## Nouvelle colonne : Stock réservé

Le rapport **Projections de stock** inclut désormais une colonne **Stock réservé**, qui affiche la quantité d'un article mise en réserve pour des besoins spécifiques (projets, échantillons, allocations spéciales, etc.). Cette colonne permet de distinguer clairement le stock physiquement disponible du stock déjà alloué à des usages non opérationnels, améliorant ainsi la précision des projections.

### Pourquoi cette colonne est importante

Dans les versions précédentes du rapport, le **Stock réservé** était inclus dans la **Quantité réservée**, ce qui pouvait fausser l'interprétation des niveaux de stock disponibles. En séparant explicitement ces deux concepts, Dokos offre une vision plus claire :

- **Quantité réservée** : stock engagé pour des commandes clients ou des ordres de travail (flux opérationnels).
- **Stock réservé** : stock mis de côté pour des besoins internes ou spécifiques (flux non opérationnels).

Cette distinction est cruciale pour :

- **Éviter les doubles comptages** dans les projections.
- **Identifier les stocks réellement disponibles** pour de nouvelles commandes ou productions.
- **Auditer les réserves** et libérer du stock si nécessaire.

### Comment utiliser cette colonne

1. **Lecture du rapport** : La colonne **Stock réservé** apparaît désormais entre **Quantité réservée** et **Quantité projetée** dans le tableau des résultats.
2. **Filtrage** : Vous pouvez filtrer le rapport pour afficher uniquement les articles ayant un **Stock réservé** non nul, afin d'auditer les réserves existantes.
3. **Tri** : Triez le rapport par **Stock réservé** pour identifier les articles les plus impactés par les réserves.

### Exemple d'utilisation

> **Scénario — Dokompany**
> Dokompany gère un projet spécial nécessitant 10 moteurs dédiés. Ces moteurs sont mis en réserve dans l'entrepôt « Stock Pièces » avec une étiquette « Réservé - Projet Alpha ». Dans le rapport **Projections de stock** :
>
> - **Quantité réelle** : 25 moteurs
> - **Quantité réservée** : 5 moteurs (pour une commande client)
> - **Stock réservé** : 10 moteurs (pour le projet Alpha)
> - **Quantité projetée** : 25 − 5 − 10 = **10 moteurs disponibles** pour de nouvelles commandes ou productions.

Sans la colonne **Stock réservé**, la quantité projetée aurait été calculée à 20 moteurs (25 − 5), masquant le fait que 10 moteurs sont déjà alloués à un usage interne.

### Configuration et gestion des réserves

Pour réserver du stock pour un besoin spécifique :

1. Allez sur : **Stock > Outils > Réservation de stock**.
2. Créez une nouvelle **Réservation de stock**.
3. Sélectionnez l'article, la quantité et l'entrepôt concernés.
4. Ajoutez une référence (ex : numéro de projet, nom du client interne) pour tracer la réserve.
5. Sauvegardez et soumettez la réservation.

La quantité réservée apparaîtra alors dans la colonne **Stock réservé** du rapport **Projections de stock**.

::callout{type="info"}
Les réserves de stock peuvent être libérées à tout moment en annulant ou en supprimant la **Réservation de stock** correspondante. Une fois la réserve libérée, la quantité redevient disponible pour les projections et les opérations.
::

## Panneau Approvisionnement & Couverture dans les ordres de travail

Le panneau **Approvisionnement & Couverture** est désormais intégré directement dans les fiches **Ordre de travail**, offrant une vue en temps réel des besoins en approvisionnement pour chaque composant. Ce panneau utilise les mêmes données que le rapport **Projections de stock** pour afficher :

- Les quantités disponibles, réservées et manquantes.
- Les délais d'approvisionnement estimés.
- Les alertes pour les composants critiques.

Cette intégration permet aux responsables de production d'anticiper les ruptures de stock **avant** de lancer un ordre de travail, et d'agir en conséquence (ex : créer une demande d'achat, ajuster les quantités, ou reporter l'ordre).

Pour plus de détails sur l'utilisation de ce panneau, consultez la section [Panneau Approvisionnement & Couverture](https://doc.dokos.io/v5/dokos/production/ordre-de-travail#panneau-approvisionnement--couverture) dans la documentation des ordres de travail.

## Voir aussi

- [Ordre de travail](https://doc.dokos.io/v5/dokos/production/ordre-de-travail)
- [Inspection qualité](https://doc.dokos.io/v5/dokos/stocks/quality-inspection)
- [Demande de matériel](https://doc.dokos.io/v5/dokos/stocks/demande-materiel)
- [Réservation de stock](https://doc.dokos.io/v5/dokos/stocks/reservation-stock)


# Réservation de stock

La **Réservation de stock** permet de mettre de côté une quantité spécifique d'un article pour des besoins internes ou particuliers, tels que :

- Des projets spéciaux.
- Des échantillons pour des clients ou des salons.
- Des allocations pour des départements internes (ex : marketing, R\&D).
- Des stocks de sécurité pour des événements prévus.

En réservant du stock, vous évitez que ces quantités ne soient utilisées pour des commandes clients ou des ordres de travail, garantissant ainsi leur disponibilité pour l'usage prévu.

## Créer une réservation de stock

Pour réserver du stock :

1. Allez sur :
   > Accueil > Stock > Outils > **Réservation de stock**
2. Cliquez sur **Nouveau**.
3. Remplissez les informations suivantes :

   - **Article** : sélectionnez l'article à réserver.
   - **Quantité** : indiquez la quantité à réserver.
   - **Entrepôt** : choisissez l'entrepôt où le stock est physiquement disponible.
   - **Référence** : ajoutez une référence pour tracer la réservation (ex : numéro de projet, nom du client interne).
   - **Date de début** et **Date de fin** : définissez la période pendant laquelle le stock doit être réservé (facultatif).
   - **Remarques** : ajoutez des détails supplémentaires si nécessaire (ex : « Réservé pour le salon ProGreen 2025 »).
4. Sauvegardez et soumettez la réservation.

::callout{type="info"}
La réservation de stock est **immédiate** : dès que la réservation est soumise, la quantité réservée est déduite de la **quantité projetée** dans les rapports de stock et n'est plus disponible pour d'autres usages.
::

> **Exemple — Maison Verte SARL**
> Maison Verte prépare un salon professionnel et souhaite réserver 50 pots de fleurs « Orchidée Phalaenopsis » pour des démonstrations. Voici comment elle procède :
>
> 1. Elle crée une **Réservation de stock** pour l'article « Orchidée Phalaenopsis ».
> 2. Elle indique une quantité de **50 unités** dans l'entrepôt « Stock Salon ».
> 3. Elle ajoute la référence « Salon ProGreen 2025 » et une remarque : « Réservé pour démonstrations clients ».
> 4. Après soumission, ces 50 unités n'apparaissent plus comme disponibles dans les projections de stock.

## Visualiser les réserves de stock

Pour consulter les réserves de stock existantes :

1. Allez sur :
   > Accueil > Stock > Outils > **Réservation de stock**
2. Utilisez les filtres pour affiner la liste :

   - **Article** : filtrez par un article spécifique.
   - **Entrepôt** : filtrez par un entrepôt.
   - **Statut** : filtrez par statut (Brouillon, Soumis, Annulé).
   - **Référence** : recherchez une référence spécifique (ex : numéro de projet).
3. Cliquez sur une réservation pour voir ses détails ou la modifier.

Le rapport affiche les colonnes suivantes :

- **Article** : nom et référence de l'article réservé.
- **Quantité réservée** : quantité mise en réserve.
- **Entrepôt** : entrepôt où le stock est réservé.
- **Référence** : référence associée à la réservation.
- **Date de début** et **Date de fin** : période de réservation (si définie).
- **Statut** : statut de la réservation (Brouillon, Soumis, Annulé).

## Modifier ou annuler une réservation

### Modifier une réservation

1. Allez sur :
   > Accueil > Stock > Outils > **Réservation de stock**
2. Sélectionnez la réservation à modifier.
3. Cliquez sur **Modifier**.
4. Mettez à jour les champs nécessaires (ex : quantité, référence, dates).
5. Sauvegardez et soumettez à nouveau la réservation.

::callout{type="warning"}
Si vous **augmentez la quantité réservée**, assurez-vous que le stock supplémentaire est disponible dans l'entrepôt. Si ce n'est pas le cas, la modification échouera.
::

### Annuler une réservation

1. Allez sur :
   > Accueil > Stock > Outils > **Réservation de stock**
2. Sélectionnez la réservation à annuler.
3. Cliquez sur **Annuler**.
4. Confirmez l'annulation.

::callout{type="info"}
L'annulation d'une réservation **libère immédiatement** le stock réservé, qui redevient disponible pour d'autres usages (commandes clients, ordres de travail, etc.).
::

> **Exemple — Bureau Moderne**
> Bureau Moderne avait réservé 20 chaises ergonomiques pour un projet interne. Le projet est annulé, et l'entreprise souhaite libérer ce stock pour une commande client urgente. Voici comment elle procède :
>
> 1. Elle ouvre la **Réservation de stock** concernée.
> 2. Elle clique sur **Annuler** et confirme.
> 3. Les 20 chaises redeviennent disponibles dans les projections de stock et peuvent être utilisées pour la commande client.

## Intégration avec les projections de stock

Les réserves de stock sont **automatiquement prises en compte** dans le rapport **Projections de stock** et dans le **Panneau d'approvisionnement et couverture** :

- **Projections de stock** : la colonne **Stock réservé** affiche la quantité réservée pour chaque article, et cette quantité est déduite du calcul de la **quantité projetée**.
- **Panneau d'approvisionnement** : les articles avec un **stock réservé élevé** peuvent apparaître dans la section **Articles avec stock excédentaire** si la quantité réservée dépasse le seuil de couverture.

> **Exemple — Dokompany**
> Dokompany a réservé 10 moteurs pour un projet spécial. Dans le rapport **Projections de stock** :
>
> - **Quantité réelle** : 25 moteurs
> - **Quantité réservée** : 5 moteurs (pour une commande client)
> - **Stock réservé** : 10 moteurs (pour le projet spécial)
> - **Quantité projetée** : 25 − 5 − 10 = **10 moteurs disponibles**

Le **Panneau d'approvisionnement** peut suggérer de libérer une partie du stock réservé si la quantité projetée devient négative.

## Bonnes pratiques pour la réservation de stock

1. **Réservez uniquement ce qui est nécessaire** : évitez de réserver des quantités excessives qui pourraient bloquer des commandes clients ou des productions.
2. **Utilisez des références claires** : ajoutez des références explicites (ex : numéro de projet, nom du client interne) pour faciliter le suivi et l'audit des réserves.
3. **Définissez des dates de fin** : si la réservation est temporaire (ex : pour un salon), définissez une date de fin pour libérer automatiquement le stock à l'issue de la période.
4. **Auditez régulièrement les réserves** : passez en revue les **Réservations de stock** pour identifier et annuler les réserves obsolètes ou non utilisées.
5. **Communiquez avec les équipes** : informez les équipes concernées (ex : ventes, production) des réserves en cours pour éviter les conflits d'utilisation.

## Voir aussi

- [Projections de stock](https://doc.dokos.io/v5/dokos/stocks/stock-level-report)
- [Panneau d'approvisionnement et couverture](https://doc.dokos.io/v5/dokos/stocks/stock-level-report#nouvelle-fonctionnalit%C3%A9--panneau-dapprovisionnement-et-couverture)
- [Planification des besoins en matériel (MRP)](https://doc.dokos.io/v5/dokos/stocks/mrp)
- [Gestion des entrepôts](https://doc.dokos.io/v5/dokos/stocks/warehouse-management)


# Paramètres de stock

Vous pouvez définir les paramètres par défaut pour vos transactions liées aux actions à partir de la page **Paramètres des actions**.

Pour accéder aux paramètres des stocks, allez sur :

> Accueil > Stock > **Paramètres des stocks**

## 1. Nomages des articles selon

Par défaut, le nom de l'article est défini selon le code d'article entré. Si vous voulez que les éléments soient nommés par une série de noms définie, choisissez l'option **Série de noms**.

## 2. Valeurs par défaut

### 2.1 Groupe d'articles par défaut

Ce sera le groupe d'articles par défaut alloué à un article nouvellement créé. Les groupes d'éléments sont utiles pour la classification et la définition des propriétés de l'ensemble du groupe. Pour en savoir plus, visitez la page &#x2A;*[Groupe d'articles](https://doc.dokos.io/v5/dokos/parametrage/articles#groupes-darticles)**.

### 2.2 Unité de mesure par Défaut des Articles

L'unité de mesure par défaut pour le stock est définie sous forme de nombres (kg, mètres, Unité, etc..), elle peut être modifiée à partir d'ici.

### 2.3 Entrepôt par défaut

Définissez l'entrepôt par défaut à partir duquel les transactions de stock sont effectuées. Il sera récupéré dans l'entrepôt par défaut dans la base d'articles.

#### 2.4 Entrepôt de stockage des échantillons

Il s'agit de l'entrepôt où les retentions d'échantillons sont stockées. Pour en savoir plus, visitez cette page.

### 2.5 Méthode de Valorisation par Défaut

FIFO - premier entré, premier sorti ou évaluation moyenne mobile de vos articles. La méthode par défaut est FIFO. Si vous sélectionnez Moyenne mobile, les nouveaux éléments seront évalués sur la moyenne mobile. Vous pouvez modifier cela lors de la création de nouveaux éléments dans le formulaire d'élément. Une fois l'article enregistré, la méthode d'évaluation ne peut pas être modifiée. En savoir plus ici.

### 2.6 Tolérance à la livraison/réception (%)

Il s'agit du pourcentage que vous êtes autorisé à recevoir ou à livrer plus par rapport à la quantité commandée. Par exemple: si vous avez commandé 100 unités, le fournisseur envoie 120 unités et le pourcentage est fixé à 10%, vous êtes alors autorisé à recevoir 110 unités. Par défaut, il est défini sur 0.

### 2.7 Rôle autorisé à livrer / recevoir en excès

Les utilisateurs avec ce rôle sont autorisés à livrer / recevoir des commandes supérieures au pourcentage d'allocation

### 2.8 Action si l'inspection de qualité n'est pas validée

Déclenchement d'une action si l'inspection de qualité n'est pas validée. Soit l'action s'arrête alors il faut mettre sur **Stop** ou soit cela envoi un avertissement alors il faut mettre sur **Avertir**.

### 2.9 Afficher le champ de code barre

Un champ pour saisir les détails du code-barres d'un article. Si décoché, le champ ne sera pas visible dans le formulaire d'élément.

### 2.10 Convertir la description de l'élément pour nettoyer le code HTML

Habituellement, les descriptions sont copiées à partir d'un site Web ou d'un fichier Word / PDF et contiennent de nombreux styles intégrés. Cela gâche la vue d'impression de vos factures ou devis.

Pour résoudre ce problème, vous pouvez cocher "Convertir la description de l'article en HTML propre" dans les paramètres de stock. Cela garantira que lorsque vous enregistrez les éléments, leurs descriptions seront nettoyées.

Si vous souhaitez contrôler votre description, vos vues et autoriser l'intégration de tout HTML, vous pouvez décocher cette propriété.

### 2.11 Désactiver la sélection de numéro de série et de lot

### 2.12 Insertion automatique

#### 2.12.1 Insertion automatique du taux de la Liste de prix si manquante

L'activation de cette option insérera automatiquement un prix d'article dans la liste de prix d'un article lors de l'utilisation de l'article dans sa première transaction. Ce prix est extrait du "Tarif" défini lors de la première transaction avec l'article. La liste de prix varie selon que vous utilisez une transaction d'achat ou de vente.

Notez que le prix de l'article sera automatiquement inséré uniquement dans la première transaction s'il n'est pas déjà présent.

Si cette option n'est pas cochée, le «taux de vente standard» défini dans l'article lors de la création de l'article sera ajouté en tant que prix de l'article.

#### 2.12.2 Autoriser un stock négatif

Cela permettra aux articles en stock d'être affichés avec des valeurs négatives. L'utilisation de cette option dépend de votre cas d'utilisation. Par exemple, les écritures d'opérations sur actions sont saisies le week-end ou en fin de mois. Dans ce cas, le stock négatif doit être activé afin que vous puissiez continuer avec vos écritures de transaction d'achat / vente.

#### 2.12.3 Autoriser le stock négatif pour les lots

Ce paramètre **global** autorise tous les lots à passer en stock négatif. Lorsqu'il est activé, aucun lot ne sera bloqué lors d'une sortie de stock même si la quantité disponible est insuffisante.

::callout{color="blue" icon="i-heroicons-information-circle"}
**Contrôle lot par lot disponible** : Il est possible d'autoriser le stock négatif uniquement pour certains lots spécifiques, sans activer ce paramètre global. Pour cela, cochez **Autoriser le stock négatif pour ce lot** directement sur la fiche du lot concerné. Voir la documentation [N° de Lot](https://doc.dokos.io/v5/dokos/stocks/batch#33-autoriser-le-stock-negatif-pour-un-lot-specifique) pour plus de détails.
::

#### 2.12.4 Définir les numéros de série automatiquement suivant la règle PEPS

Les numéros de série du stock seront définis automatiquement en fonction des articles saisis en fonction du premier entré, premier sorti. Les numéros de série seront définis automatiquement dans les transactions telles que les factures d'achat / vente, les bons de livraison, etc.

#### 2.12.5 Définir la quantité dans les transactions sur la base du numéro de série

La quantité d'articles sera définie en fonction des numéros de série. Par exemple, si l'utilisateur a ajouté des numéros de série tels que A001, A002 et A003, le système définira la quantité sur 3 dans la transaction.

### 3. Demande de matériel Automatique

#### 3.1 Augmenter la demande de matériel

Cette option est utile si vous souhaitez assurer un approvisionnement constant en matières premières / produits et éviter les pénuries. Une demande de matériel sera lancée automatiquement lorsque le stock atteindra le niveau de commande défini dans le formulaire Article.

#### 3.2 Notifier par e-mail lors de la création d'une demande de matériel automatique

Un e-mail sera envoyé pour informer l'Utilisateur avec le rôle «Responsable des achats» lorsqu'une demande de matériel automatique est créée.

### 4. Paramètres de transfert inter-entrepôts

#### 4.1 Activer l'entrepôt client pour le transfert d'articles à partir du bon de livraison et de la facture de vente

Cette option est utile lorsque le transfert de matériel doit être présenté sous forme de bon de livraison. Par exemple, s'il existe des exigences légales où des taxes doivent être appliquées à chaque transfert de matériel. Il est plus facile à gérer dans une transaction comme le bon de livraison que dans la saisie de stock

#### 4.2 Activer l'entrepôt fournisseur pour le transfert d'articles à partir du reçu d'achat et de la facture d'achat

Similaire à l'option ci-dessus, cette option est utile lorsque le transfert de matériel doit être présenté comme un reçu d'achat.

### 5. Contrôle de l'historique des transactions de stock

L'Utilisateur ne sera pas autorisé à effectuer des enregistrements de stock au-delà de cette date.

Stock gelé jusqu'à: date limite jusqu'à laquelle les stocks seront gelés.
Gel des stocks de plus de [jours] : les stocks de plus de x jours seront gelés. Celui-ci est calculé en fonction de la date de création de l'article.
Rôle Autorisé à modifier le stock gelé : le rôle que vous choisissez ici sera autorisé à modifier le stock gelé.

### 6. Identification par lots

Paramètre global pour les lots de stocks à identifier par une série de dénomination . Vous pouvez remplacer cela dans le DocType d'article.


# Unité de mesure (UDM)

::demo-link{demo="Mappemonde" path="/app/uom"}
Utilisez la **barre de recherche** pour accéder à la page : **Unité de mesure**.
::

## Définition

Une unité de mesure est une référence standard utilisée pour **quantifier** et **gérer** différentes caractéristiques ou grandeurs spécifiques des produits, des stocks ou des services.

Elle permet de définir de manière précise comment les quantités sont exprimées et gérées dans le système, facilitant ainsi la gestion des stocks, des ventes et des achats.

## 1. Prérequis

Avant d'établir vos unités de mesure, il est important de prendre en compte plusieurs aspects.

- **Analyse des besoins métier :** Identifiez les besoins spécifiques de votre entreprise et de vos clients. Identifiez les types de produits ou services que vous proposez, ainsi que les différentes manières dont ils sont utilisés ou vendus.
- **Définition des processus :** Analysez votre manière, d'acheter, de vendre, de gérer des stocks, etc. Identifiez les étapes clés où les unités de mesure seront utilisées et les interactions entre ces étapes.
- **Considération des conversions :** Pensez aux différentes manières dont vos produits ou services peuvent être mesurés et vendus. Identifiez les taux de conversion nécessaires entre les différentes unités de mesure pour garantir une gestion cohérente des stocks, des ventes, etc.

## 2. La notion d’unité de mesure

Par défaut, Dokos propose de nombreuses unités de mesure (UdM).
Cependant, d'autres peuvent être ajoutées selon vos besoins.

Dans chaque unité de mesure, il existe une &#x2A;*option "Doit être un nombre entier"**. Si cette case est cochée, vous ne pourrez pas utiliser de nombres décimaux dans cette unité de mesure.

- Cela signifie que vous ne pourrez pas utiliser des quantités comme 1,5 ou 2,25 pour cette unité, mais seulement des nombres entiers comme 1, 2, 3, etc.

Pour plus de clarté, il est préférable **d'indiquer la plus petite unité de mesure** utilisée dans vos opérations.

### 2.1. Unités de mesure multiples pour un même article

Vous pouvez **définir plusieurs unités de mesure pour un même article**, ce qui est utile lorsque l'article est utilisé dans différentes unités. Lors de l'achat, avec une commande fournisseur en utilisant une unité comme la palette et ensuite lors d'une commande client en utilisant une unité comme le carton.

- Par exemple, mètres, palettes, rouleaux, boîtes, etc ou la durée (heures, demi-journées, journées) ou la capacité (nombre de personnes).

### 2.2. Facteur de conversion

Permet de définir des taux de conversion entre les différentes unités de mesure.

- Par exemple, vous pouvez spécifier combien de mètres correspondent à un rouleau ou combien de boîtes correspondent à un carton.

> En ce qui concerne les unités de mesure telles que la demi-journée ou la journée, il est important de configurer vos unités de mesure en minutes, car celles-ci sont invariables, contrairement à la demi-journée qui sera définie selon vos critères, par exemple : 4 heures pour une demi-journée, 6 heures pour une journée, etc.

![Image permettant de visualiser les paramètre du lieu afin de définir des conversion.](https://doc.dokos.io/conversion-minute.png)

### 2.3. Utilisation lors d’achat ou de vente

Lorsque vous effectuez des achats, des ventes, vous pouvez spécifier les quantités dans l'unité de mesure correspondante. Dokos se charge alors de convertir automatiquement les quantités en fonction des taux de conversion définis.

Dans le contexte des réservations de salles, lorsque votre article est disponible sur le portail, Dokos va automatiquement récupérer l'unité de mesure appropriée et configurer les calendriers en conséquence. De plus, il affichera les prix corrects associés à cette unité de mesure pour faciliter la réservation et la tarification des salles.

### 2.4. Les prix

Dans Dokos, le prix est souvent associé à des unités de mesure pour faciliter la gestion des produits et services.

- **Prix par unité de mesure :** Vous pouvez définir un prix pour chaque unité de mesure de vos produits ou services. De cette façon, lorsque vous vendez un produit, le prix sera automatiquement calculé en fonction de la quantité vendue.
- **Tarifs multiples :** Vous pouvez également configurer des tarifs multiples pour un même produit ou service, en fonction de différentes unités de mesure. Par exemple, vous pouvez avoir un prix à la pièce pour un produit, ainsi qu'un prix par sachet pour le même produit. Cela vous permet de proposer des tarifs différents en fonction des besoins de vos clients.
- **Conversion des prix :** Dokos gère automatiquement la conversion des prix entre différentes unités de mesure. Par exemple, si un produit est vendu à la fois à la pièce et par sachet, le système calcule automatiquement le prix en fonction de l'unité de mesure sélectionnée par le client lors de la vente.
- **Gestion des listes de prix/ règle de prix :** Vous pouvez gérer plusieurs listes de prix, ce qui vous permet d'offrir des tarifs spéciaux ou des remises pour certains clients ou pour certaines périodes. Chaque liste de prix peut avoir des prix définis pour différentes unités de mesure.

::callout
Rendez-vous sur la page [**Les prix**](https://doc.dokos.io/v5/dokos/parametrage/prix) de la documentation.
::

## 3. Site Web

Dans le **contexte des abonnements**, pour configurer plusieurs "unités de mesure" (mois, annuel) de l'abonnement sur le site web, accédez à la section "Article du Site web" que vous souhaitez modifier, puis modifiez le champ "Périodes de récurrence autorisées". Assurez-vous que les unités que vous utilisez existent dans votre table "Unité de mesure", et qu'il existe une conversion vers votre unité de base.

Lorsque votre article est disponible sur le site web, Dokos va automatiquement récupérer l'unité de mesure appropriée et configurer les calendriers en conséquence. De plus, il affichera les prix corrects associés à cette unité de mesure pour faciliter l'achat de l'abonnements.

::callout
Rendez-vous sur la page [**personnalisation du site web**](https://doc.dokos.io/v5/dodock/fonctionnalites/site-web/parametres-site-web) de la documentation.
::

## 4. Cas concret

1. Entreprise de fournitures de bureau

Une entreprise de vente de fournitures de bureau qui propose des cartouches d'encre pour imprimantes. Dans Dokos, l'entreprise peut définir les cartouches d'encre comme un article avec plusieurs unités de mesure, telles que unité, boîte et palette.

**Définition d'unités de mesure multiples :**

- Palette : Cette unité de mesure représente une palette entière de boîtes de cartouches d'encre, soit 50 boîtes de cartouches d'encre ou 500 unités.
- Boîte : Cette unité de mesure représente une boîte contenant plusieurs cartouches d'encre, une boîte de 10 cartouches.
- Unité : Cette unité de mesure représente une cartouche d'encre individuelle.

**Facteur de conversion :**

- 1 boîte = 10 unités de cartouches d'encre
- 1 palette = 50 boîtes de cartouches d'encre

**Utilisation lors d’achat ou de vente :**

Lorsque l'entreprise effectue des achats de cartouches d'encre, des ventes à ses clients, elle peut spécifier les quantités dans l'unité de mesure appropriée.

Lors d'une vente à un client, l'entreprise peut vendre une boîte de 10 cartouches d'encre à un prix de 50 €.
Lors d'un achat auprès d'un fournisseur, l'entreprise peut commander une palette entière de boîtes de cartouches d'encre à un prix de 2000 €.

Dokos se charge alors de convertir automatiquement les quantités en fonction des taux de conversion définis, tout en prenant en compte les prix associés à chaque unité de mesure.


# Entrepôt

Un entrepôt est un bâtiment commercial pour le stockage de marchandises. Les entrepôts sont utilisés par les fabricants, les importateurs, les exportateurs, les grossistes, les entreprises de transport, les douanes, etc.

Ce sont généralement de grands bâtiments simples situés dans les zones industrielles des villes, des villes et des villages. Ils ont pour la plupart des quais de chargement pour charger et décharger les marchandises des camions.

La terminologie de **Entrepôt** dans Dokos est cependant un peu plus large et peut peut-être être considérée comme des **emplacements de stockage**. Vous pouvez créer un sous-entrepôt qui pourrait être une étagère à l'intérieur de votre emplacement réel.

Cela peut devenir un arbre assez détaillé comme celui-ci :

## Entrepôt > Pièce > Rangée > Étagère

Pour accéder à la **liste des entrepôts**, allez sur :

> Accueil > Stock > Paramètres > **Entrepôt**

![liste\_entrepôt.png](https://doc.dokos.io/content/stocks/warehouse/liste_entrepot.png)

## 1. Comment créer un entrepôt

### 1.1 Détails de l'entrepôt

1. Allez dans la liste Entrepôt, cliquez sur **➕ Nouveau**.
2. Remplir les différents champs pour compléter la fiche de l'entrepôt :

- Nom : Entrez un **nom** pour l'entrepôt.
- Entrepôt de transit par défaut : Définissez / vérifiez l'entrepôt.
- Est un groupe : vous pouvez créer des sous-entrepôts sous ce groupe Entrepôt.

4. **Enregistrer**.

![détails\_entrepôt.png](https://doc.dokos.io/content/stocks/warehouse/details_entrepot.png)

Les entrepôts sont enregistrés avec les abréviations de leur entreprise respective. Cela facilite l'identification de l'entrepôt à quelle entreprise en un coup d'œil.

### 1.2 Options supplémentaires lors de la création d'un entrepôt

- **Compte** : Définissez ici un compte par défaut pour toutes les transactions avec cet entrepôt. La définition de ce compte affichera les transactions de cet entrepôt dans le grand livre comptable.
- **Type d'entrepôt** : Vous pouvez créer un type d'entrepôt pour classer les entrepôts. Par exemple, les entrepôts de fournisseurs, les entrepôts de stockage, les entrepôts WIP, les chambres, etc. peuvent être étiquetés. Cette classification est utile lors de la génération de rapports ou dans certaines transactions boursières.

## 2. Caractéristiques

### 2.1 Adresse et contact

Vous pouvez ajouter des adresses de facturation, d'expédition et d'autres types d'adresses pour l'entrepôt. Vous pouvez également ajouter un contact, cela peut être le responsable de l'entrepôt par exemple.

En créant une nouvelle adresse, vous serez dirigé sur :

> CRM > Adresse > **Nouvelle adresse**

![adresse\_entrepôt.png](https://doc.dokos.io/content/stocks/warehouse/adresse_entrepot.png)

### 2.2 Info de contact de l'entrepôt

Renseignez les différentes informations de contact pour l'entrepôt.

- N° de téléphone
- N° de mobile
- Adresse et complément d'adresse
- Ville, État et Pin

![info\_de\_contact\_entrepôt.png](https://doc.dokos.io/content/stocks/warehouse/info_de_contact_entrepot.png)

## 3. Après l'enregistrement

Après avoir enregistré un entrepôt, vous verrez les options suivantes:

**Solde des stocks** : Cela ouvrira le rapport Solde des stocks pour afficher la quantité, la valorisation, le solde, etc.
**Grand livre** : Cela ouvrira le grand livre pour afficher les transactions comptables.
**Non-groupe à groupe** : Si l'entrepôt est un entrepôt non-groupe, c'est-à-dire qu'il ne peut pas contenir d'autres entrepôts en dessous, ce bouton en fera un entrepôt de groupe.

## 4. Recalculer les valeurs de l'entrepôt

Dans la fiche **Entrepôt**, vous trouverez désormais un bouton **Recalculer les valeurs** (anciennement **Recalculer les quantités de l'entrepôt**). Ce bouton permet de recalculer non seulement les quantités en stock, mais aussi le **taux de valorisation** et la **valeur du stock** pour chaque article dans cet entrepôt.

### 4.1 Quand utiliser ce bouton ?

Utilisez ce bouton dans les situations suivantes :

- Après une correction manuelle dans le **Grand Livre des Stocks** pour synchroniser les valeurs avec les écritures comptables.
- Si vous suspectez une incohérence entre le **taux de valorisation standard** et la **valeur réelle du stock** dans un entrepôt.
- Après une migration de données ou une importation massive pour garantir la cohérence des valeurs.

### 4.2 Comment fonctionne le recalcul ?

1. Cliquez sur le bouton **Recalculer les valeurs** dans la fiche Entrepôt.
2. Dokos analyse les &#x2A;*dernières écritures du Grand Livre des Stocks (SLE)** pour chaque article dans cet entrepôt.
3. Si aucune écriture n'existe pour un article, le **taux de valorisation** est réinitialisé à **0** et la **valeur du stock** est également mise à **0**.
4. Si des écritures existent, le **taux de valorisation** et la **valeur du stock** sont recalculés en fonction de la dernière écriture disponible.

::mermaid
flowchart TD
A\[Cliquer sur 'Recalculer les valeurs'] --> B\[Analyser les SLE pour chaque article]
B --> C{SLE existe ?}
C -->|Oui| D\[Recalculer taux de valorisation et valeur du stock]
C -->|Non| E\[Mettre à 0 le taux et la valeur]
D --> F\[Mettre à jour la fiche Entrepôt]
E --> F

::

### 4.3 Exemple d'utilisation

**Scénario** : Vous gérez l'entrepôt **Stock Principal** de l'entreprise **Maison Verte SARL**. Après une vérification manuelle, vous remarquez que la valeur du stock pour l'article **Bureau Moderne - Chaise Ergonomique** ne correspond pas aux écritures comptables.

**Étapes à suivre** :

1. Allez dans la fiche **Stock Principal**.
2. Cliquez sur **Recalculer les valeurs**.
3. Dokos recalcule automatiquement le **taux de valorisation** et la **valeur du stock** pour toutes les références dans cet entrepôt, y compris la **Chaise Ergonomique**.
4. Vérifiez dans le rapport **Solde des stocks** que les valeurs sont désormais cohérentes avec le **Grand Livre des Stocks**.

### 4.4 Bonnes pratiques

- **Fréquence** : Utilisez ce bouton uniquement en cas de nécessité (incohérences détectées). Un recalcul systématique n'est pas recommandé.
- **Sauvegarde** : Avant de lancer un recalcul, assurez-vous d'avoir une sauvegarde récente de vos données.
- **Vérification** : Après le recalcul, vérifiez les valeurs dans le rapport **Solde des stocks** pour confirmer la cohérence.

Cette fonctionnalité garantit que vos données de stock restent alignées avec vos écritures comptables, réduisant ainsi les risques d'erreurs dans vos rapports financiers.


# Module Production

Le module Production de Dokos couvre l'ensemble du cycle de fabrication : définir la composition des produits, planifier les quantités à produire, lancer les ordres de travail, suivre l'avancement en atelier et calculer les coûts réels.

Ce module s'adresse aussi bien aux entreprises qui fabriquent sur stock qu'à celles qui produisent à la commande ou à l'ingénieur à la commande.

---

Pour accéder au module, allez sur :

> Accueil > **Production**

## Configuration de base

Avant de lancer une première production, Dokos a besoin de connaître les postes de travail disponibles, les opérations réalisées et la composition des produits.

- [Station de travail](https://doc.dokos.io/v5/dokos/production/station-de-travail) — machines et postes d'assemblage avec leurs coûts horaires
- [Opération](https://doc.dokos.io/v5/dokos/production/operation) — étapes de fabrication réalisées sur les postes de travail
- [Routage](https://doc.dokos.io/v5/dokos/production/routage) — enchaînement d'opérations réutilisable sur plusieurs nomenclatures
- [Nomenclature](https://doc.dokos.io/v5/dokos/production/nomenclature) — liste des composants et sous-ensembles nécessaires à chaque produit fini

## Planification et exécution

Une fois la configuration en place, Dokos permet de planifier la production en fonction des commandes clients ou des prévisions, puis de générer et suivre les ordres de travail.

- [Ordre de travail](https://doc.dokos.io/v5/dokos/production/ordre-de-travail) — pilotage de la fabrication d'un lot
- [Carte de travail](https://doc.dokos.io/v5/dokos/production/carte-travail) — suivi des opérations par poste de travail et enregistrement des temps réels

## Suivi et gestion

- [Arrêt de production](https://doc.dokos.io/v5/dokos/production/arret-de-production) — enregistrement des temps d'arrêt machine
- [Paramètres de production](https://doc.dokos.io/v5/dokos/production/parametres-de-production) — configuration des entrepôts par défaut et des règles de planification

## Voir le cycle complet en action

Le [pilotage complet de la Dokoboard](https://doc.dokos.io/v5/dokos/production/cycle-production-complet) illustre l'ensemble du flux — de la prévision de ventes à la livraison — avec l'exemple de **Dokompany** : réapprovisionnement automatique, calcul des coûts, projections de stock et suivi de la rentabilité.

::demo-link{demo="Dokompany" path="/app/production-plan"}
Explorer le module Production dans la démo
::


# Paramètres de production

Les paramètres de production centralisent la configuration globale du module : entrepôts par défaut pour les travaux en cours et les produits finis, planification de la capacité des postes de travail, et mise à jour automatique des coûts de nomenclature.

---

Pour accéder aux paramètres de production, allez sur :

> Accueil > Production > Paramètres > **Paramètres de production**

## Entrepôts par défaut

Dokos pré-remplit les champs d'entrepôt dans chaque nouvel ordre de travail à partir des valeurs configurées ici.

- **Entrepôt de travaux en cours (WIP)** — l'entrepôt intermédiaire où les composants sont transférés au démarrage de la production. Les matières premières y transitent avant d'être consommées.
- **Entrepôt des produits finis** — l'entrepôt de destination des articles produits à la clôture de l'ordre de travail.

> **Exemple — Dokompany**
> Dokompany configure « Atelier » comme entrepôt WIP et « Stock Dokoboards » comme entrepôt produits finis. Chaque nouvel ordre de travail reprend automatiquement ces valeurs, sans saisie manuelle.

## Planification de la capacité

Dokos peut vérifier la disponibilité des postes de travail lors de la soumission d'un ordre de travail et planifier les opérations en séquence sur les créneaux libres. Ce mécanisme évite la surcharge des postes et produit un planning réaliste.

Quand la planification de capacité est activée, Dokos tente de placer chaque opération dans un créneau disponible sur un horizon défini (30 jours par défaut). Si aucun créneau n'est libre dans cet horizon, Dokos renvoie une erreur et demande d'ajuster la date de début ou l'horizon de planification.

## Consommation de matières multiples

Quand cette option est activée, Dokos autorise plusieurs entrées de stock de consommation pour un même ordre de travail. Cela convient aux productions longues où les matières premières sont consommées progressivement sur plusieurs jours, sans attendre la finalisation pour saisir les consommations réelles.

## Consommer les composants basé sur

Ce paramètre global détermine la méthode utilisée par défaut pour comptabiliser la consommation des matières premières lors de chaque production :

- **Nomenclature (BOM)** — Dokos consomme exactement les quantités définies dans la nomenclature.
- **Entrée de stock** — Dokos consomme les matières en se basant sur ce qui a été réellement transféré vers l'entrepôt de travaux en cours.

::callout{type="info"}
**Priorité par nomenclature** — Ce paramètre global peut être surchargé nomenclature par nomenclature. Quand une valeur est définie dans le champ « Consommer les composants basé sur » d'une nomenclature, Dokos l'utilise à la place du paramètre global pour toutes les productions basées sur cette nomenclature. Consultez la [documentation des nomenclatures](https://doc.dokos.io/v5/dokos/production/nomenclature#consommer-les-composants-bas%C3%A9-sur) pour plus de détails.
::

## Mise à jour automatique des coûts de nomenclature

Dokos peut recalculer automatiquement le coût prévisionnel de chaque nomenclature chaque jour, en appliquant les derniers taux de valorisation ou prix d'achat des composants. Cette option garantit que les coûts de revient prévisionnels restent à jour sans intervention manuelle.

## Surproduction autorisée

En production sur stock ou sur commande, il peut être nécessaire de fabriquer plus que la quantité commandée pour atteindre la rentabilité d'un lot. Dokos permet de définir un pourcentage de surproduction autorisée. Au-delà de ce seuil, la création d'ordres de travail supplémentaires est bloquée.

## Voir aussi

- [Station de travail](https://doc.dokos.io/v5/dokos/production/station-de-travail)
- [Ordre de travail](https://doc.dokos.io/v5/dokos/production/ordre-de-travail)
- [Nomenclature](https://doc.dokos.io/v5/dokos/production/nomenclature)


# Tableau de bord de production

Pour accéder au tableau de bord de fabrication, accédez à:

> Accueil > Personnalisation > Tableau de bord > **Production**

## 1. Cartes numérotées

Le tableau de bord de production affiche quatre cartes de chiffres calculées sur le mois glissant (les 30 derniers jours à partir de la date du jour) :

- **Ordre de travail total mensuel** : nombre total d'ordres de travail aux statuts Ouvert, En cours et Terminé créés au cours du dernier mois.
- **Ordre de travail terminé par mois** : nombre total d'ordres de travail au statut Terminé créés au cours du dernier mois.
- **Carte de travail en cours** : nombre total de cartes de travail qui ne sont pas encore au statut Terminé, tous mois confondus.
- **Inspection de qualité mensuelle** : nombre total d'enregistrements d'inspection de qualité au statut Soumis créés au cours du dernier mois.

::callout{type="info"}
Ces quatre cartes ont été révisées dans le cadre des améliorations du flux de fabrication (MR #9122) pour affiner les filtres de statut et la fenêtre temporelle de référence. Les chiffres affichés reflètent désormais plus précisément l'activité réelle du mois en cours.
::

## 2. Tableau de bord

Vous pouvez voir certains rapports graphiques prédéfinis dans le tableau de bord lorsque vous ouvrez le module Fabrication. Ces rapports sont entièrement personnalisables, vous pouvez choisir ce qu'il faut afficher ou masquer et également configurer les métriques sur lesquelles les rapports sont affichés.

## 3. Quantité produite

Le graphique donnera les informations sur la quantité totale produite (en utilisant l'ordre de travail) au cours de la dernière année sur une base trimestrielle. Les utilisateurs peuvent également afficher les données du graphique sur une base quotidienne, hebdomadaire, mensuelle, annuelle.

## 4. Opération terminée

Le graphique donnera des informations sur le nombre total d'opérations réalisées au cours de la dernière année sur une base trimestrielle. Les utilisateurs peuvent également afficher les données du graphique sur une base quotidienne, hebdomadaire, mensuelle, annuelle.

## 5. Analyse des bons de travail

Ce graphique donnera des informations sur le nombre de bons de travail en fonction des statuts Non commencé, En cours, Arrêté, Terminé. Ce graphique en anneau fournira les informations basées sur les données du bon de travail de l'année dernière. Vous pouvez également modifier la plage de dates en cliquant sur le bouton **Filtrer**.

## 6. Analyse d'inspection de la qualité

Ce tableau donnera des informations sur le nombre d'inspections de la qualité en fonction du statut Accepté et Rejeté. Le type de graphique est un anneau et il fournira les informations basées sur les données d'inspection de la qualité de l'année dernière. Vous pouvez modifier la plage de dates en cliquant sur le bouton **Filtrer**.

## 7. Ordres de travail en attente

Le graphique donnera des informations sur le nombre d'ordres de travail en attente en fonction des jours de vieillissement. Le nombre de jours chronologiques est calculé en fonction de la différence entre la date actuelle et les jours de date de début / de début réel prévus.

::callout{type="info"}
Le graphique **Ordres de travail en attente** a également été révisé dans le cadre des améliorations du flux de fabrication (MR #9122). La méthode de calcul du vieillissement et les filtres associés ont été affinés pour refléter plus fidèlement les ordres réellement en attente.
::

## 8. Analyse des temps d'arrêt du mois dernier

Le graphique donnera des informations sur le nombre total de minutes pendant lesquelles une machine n'a pas fonctionné le mois dernier. Cela aide l'opérateur à savoir quelle machine n'a pas bien fonctionné et nécessite une maintenance.

## 9. Analyse de la quantité des bons de travail

Le tableau donnera des informations sur le nombre total de quantités en attente et terminées en fonction des bons de travail chaque mois de l'année dernière.

## 10. Analyse des cartes de travail

Le graphique donnera des informations sur le nombre total de fiches de travail qui sont dans les états En attente et Terminé chaque mois pour la dernière année.


# Écriture de temps d'arrêt

Le document d'entrée de temps d'arrêt est utilisé pour capturer le temps d'arrêt de la machine en quelques minutes. L'utilisateur doit créer manuellement l'enregistrement des temps d'arrêt en sélectionnant la machine appropriée ainsi que le temps d'arrêt de la machine. En utilisant les données de saisie des temps d'arrêt, l'opérateur sait quelle machine ne fonctionne pas bien et nécessite une maintenance.

---

Pour accéder à la **liste des écritures de temps d'arrêt**, allez sur :

> Accueil > Production > Production > **Écriture de temps d'arrêt**

## 1. Comment créer une écriture de temps d'arrêt

1. Accédez à la liste des écritures de temps d'arrêt, cliquez sur **➕ Ajouter Écriture de temps d'arrêt**.
2. **Remplir les différents champs pour complèter la fiche** :


   - Nom de série
   - Station de travail / machine
   - Opérateur
   - Horaire de début et Horaire de fin

## 2. Caractéristiques

### 2.1 Raison pour le temps d'arrêt

Sélectionner une raison pour indiquer le temps d'arrêt, vous avez le choix entre plusieurs raisons qui sont :

- Temps de préparation de la machine excessif
- Maintenance de la machine non planifiée
- Vérification sur la machine
- Erreurs de l'opérateur sur la machine
- Dysfonctionnement de la machine
- Coupure d'électricité
- Autre

Dans la section remarque, vous pouvez renseigner toutes les informations nécéssaires pour décrire la raison du temps d'arrêt.


# Carte de travail

La carte de travail est l'interface entre l'ordre de travail et l'atelier. Dokos crée automatiquement une carte de travail pour chaque opération dès que l'ordre de travail est soumis. Les opérateurs y enregistrent leur temps de travail, les quantités produites avec leur unité de mesure, et, si nécessaire, les résultats d'inspection qualité. Ces données alimentent directement le calcul du coût réel de production.

---

Pour accéder à la liste des cartes de travail, allez sur :

> Accueil > Production > Production > **Carte de travail**

## Enregistrement du temps de travail

Chaque carte de travail contient un journal de temps où l'opérateur déclare ses heures. Dokos calcule automatiquement la durée à partir des heures de début et de fin. Si plusieurs opérateurs travaillent en parallèle sur la même opération, chacun dispose d'une ligne distincte dans le journal.

> **Exemple — Maison Verte SARL**
> La carte de travail pour l'opération « Montage » d'un lot de 5 étagères murales est assignée au poste Assemblage A. L'opérateur Jean Dupont ouvre la carte le matin et enregistre une plage de 8h00 à 9h00 pour l'assemblage mécanique. Un second opérateur prend le relais pour le câblage électrique de 9h05 à 9h35. Dokos additionne les deux contributions pour calculer le coût total de l'opération.

::demo-link{demo="MaisonVerte" doctype="Job Card"}
Voir les cartes de travail dans la démo
::

## Unité de mesure de stock (UDM) sur les cartes de travail

Depuis la version 16.32.0, chaque carte de travail affiche désormais une &#x2A;*Unité de Mesure de Stock (UDM)** qui est automatiquement définie à partir :

- du produit fini de l'ordre de travail associé, **ou**
- du produit final de l'opération concernée.

Cette UDM est **backfillée** pour toutes les cartes de travail existantes via un patch système.

### Affichage des quantités avec leur UDM

Toutes les quantités affichées dans les messages, les dialogues de complétion et les rapports liés aux cartes de travail sont désormais accompagnées de leur unité de mesure. Cela inclut :

- La quantité totale à produire
- La quantité complétée
- La quantité en attente
- La quantité en perte de process
- Les comparaisons entre opérations (ex: « 5 unités vs 3 unités de l'opération précédente »)
- Les transferts de matières premières

> **Exemple — Maison Verte SARL**
> Pour un ordre de travail produisant des étagères murales (UDM = **unité**), l'opérateur voit désormais dans la boîte de dialogue de complétion :
>
> - Quantité totale : **10 unités**
> - Quantité complétée : **7 unités**
> - Quantité en attente : **3 unités**
> - Perte de process : **0 unité**
>
> Si l'opération suivante concerne des planches de bois (UDM = **m²*&#x2A;), le message de comparaison affichera :
> &#x2A;« Vous avez produit 7 unités d'étagères, ce qui nécessite 14 m² de planches. »*

::mermaid
flowchart TD
A\[Création de la carte de travail] --> B{Définition de l'UDM}
B -->|Produit fini| C\[UDM = UDM du produit fini]
B -->|Produit final de l'opération| D\[UDM = UDM du produit final]
C --> E\[Affichage des quantités avec UDM]
D --> E

::

## Quantité complétée, quantité en attente et pertes de process

Lorsqu'un opérateur clique sur **Terminer** pour compléter une carte de travail, une boîte de dialogue lui demande de répartir la quantité totale entre trois valeurs :

- **Quantité complétée** — la quantité effectivement produite et conforme lors de cette session (avec UDM)
- **Quantité en attente** — la quantité qui sera produite lors d'une prochaine session (production partielle, avec UDM)
- **Quantité en perte de process** — la quantité définitivement perdue (rebuts, chutes inévitables, avec UDM)

Ces trois champs sont interdépendants et leur somme doit toujours égaler la quantité totale à produire sur la carte.

::callout{type="info"}
**Règle importante sur les pertes de process** : Dokos ne calcule les pertes de process que lorsque la quantité en attente est égale à zéro. Tant qu'il reste des unités à produire (quantité en attente > 0), l'écart entre la quantité totale et la quantité complétée est considéré comme une production reportée, et non comme une perte. Cela évite que Dokos interprète à tort une production partielle comme un rebut et bloque la soumission de la carte de travail.
::

> **Exemple — Maison Verte SARL**
> Un ordre de travail porte sur 10 unités d'étagères murales. Jean Dupont complète l'opération « Assemblage » pour 7 unités ce matin, mais 3 unités attendent encore des pièces en réassort.
>
> Dans la boîte de dialogue de complétion :
>
> - Quantité complétée : **7 unités**
> - Quantité en attente : **3 unités**
> - Perte de process : **0 unité**
>
> Dokos soumet la carte de travail et note que 3 unités restent à produire. Aucune perte n'est enregistrée. Le lendemain, lorsque Jean reprend et produit les 3 unités restantes, la quantité en attente passe à 0. Si l'une d'elles est jugée non conforme, Jean peut alors saisir :
>
> - Quantité complétée : **2 unités**
> - Quantité en attente : **0 unité**
> - Perte de process : **1 unité**
>
> Dokos enregistre alors 1 étagère en rebut et met à jour l'ordre de travail en conséquence.

::mermaid
flowchart TD
A\[Opérateur clique Terminer] --> B{Quantité en attente > 0 ?}
B -- Oui --> C\[Perte de process = 0
Production reportée]
B -- Non --> D\[Calcul des pertes de process possible]
C --> E\[Carte de travail soumise
Production partielle enregistrée]
D --> E

::

## Opérations avec sous-opérations

Quand une opération est décomposée en sous-opérations, chaque sous-opération apparaît dans la carte de travail avec son propre chronomètre. Les sous-opérations doivent être complétées dans leur ordre de définition.

> **Exemple — Maison Verte SARL**
> L'opération « Contrôle Final et Emballage » comprend deux sous-opérations séquentielles :
>
> 1. **Test fonctionnel** (10 min, poste Emballage) — vérification de la stabilité et de la finition
> 2. **Emballage** (10 min, poste Emballage) — mise en carton et conditionnement final
>
> L'opérateur ne peut pas valider l'emballage avant que le test fonctionnel ne soit marqué comme terminé.

## Contrôle qualité en cours de fabrication

Dokos permet d'associer un contrôle qualité directement à une carte de travail pour les opérations critiques. Ce contrôle doit être validé avant que la carte de travail ne puisse être soumise.

> **Exemple — Maison Verte SARL**
> Avant d'emballer une étagère murale, l'opérateur crée un contrôle qualité depuis la carte de travail de l'opération « Contrôle Final et Emballage ». Il enregistre le résultat du test de stabilité et de finition. Si le contrôle est refusé, la carte de travail reste bloquée et l'étagère ne peut pas rejoindre le stock de produits finis.

## Impact sur l'ordre de travail

Chaque carte de travail soumise met à jour l'avancement de l'ordre de travail. Dokos recalcule en temps réel le pourcentage de complétion, le coût réel cumulé et l'écart avec le coût prévisionnel. Quand toutes les cartes de travail d'un ordre sont soumises, la production peut être finalisée.

## Plan d'atelier comme interface principale des opérateurs

Le plan d'atelier est l'interface recommandée pour les opérateurs en production. En un seul écran, ils accèdent à toutes leurs cartes de travail en cours, enregistrent leurs temps, valident les quantités produites avec leur UDM, et déclenchent les entrées de stock — sans naviguer entre l'ordre de travail, la carte de travail et les écritures de stock séparément.

::mermaid
flowchart LR
A\[Ordre de travail] -->|génère| B\[Cartes de travail]
B -->|via Plan d'atelier| C\[Saisie du temps]
C -->|via Plan d'atelier| D\[Entrée de stock automatique]
D --> E\[Ordre de travail mis à jour]

::

> **Exemple — Maison Verte SARL**
> L'opérateur Jean Dupont commence sa journée en ouvrant le plan d'atelier sur sa tablette. Il y voit toutes ses opérations assignées. Pour l'opération « Vissage des supports », il démarre le chronomètre, assemble les pièces, puis clique **Terminer**. Dokos enregistre le temps, soumet la carte de travail et crée l'entrée de stock correspondante avec la quantité produite et son UDM — sans que Jean ait à ouvrir l'ordre de travail ou à créer manuellement une écriture.

::callout{type="info"}
Pour les équipes démarrant sur Dokos, former les opérateurs sur le plan d'atelier en premier réduit significativement les erreurs de navigation. Les ordres de travail et les cartes de travail restent accessibles pour les superviseurs et les corrections, mais ne constituent pas l'interface quotidienne recommandée pour les opérateurs de production.
::

::demo-link{demo="MaisonVerte" path="/app/plant-floor"}
Voir le plan d'atelier dans la démo
::

## Soumission automatique depuis le plan d'atelier :badge{text="Dokos" type="warning"}

Lorsque l'opérateur complète une opération depuis l'interface du **plan d'atelier**, Dokos peut soumettre automatiquement la carte de travail sans action supplémentaire. Si l'opération concernée génère un produit semi-fini, l'écriture de stock correspondante est créée et soumise dans la foulée, avec la quantité et l'UDM appropriées.

> **Exemple — Maison Verte SARL**
> L'opérateur Jean Dupont clique sur **Terminer** pour l'opération « Assemblage » depuis le plan d'atelier. Dokos enregistre la quantité produite (5 unités), soumet la carte de travail et crée automatiquement l'entrée de stock pour les produits semi-finis — sans que Jean ait à naviguer vers le formulaire de la carte.

Cette soumission automatique se déclenche uniquement depuis le plan d'atelier (bouton **Terminer**), et seulement pour la dernière sous-opération d'une séquence. Les cartes de travail créées manuellement restent à soumettre explicitement.

## Voir aussi

- [Ordre de travail](https://doc.dokos.io/v5/dokos/production/ordre-de-travail)
- [Station de travail](https://doc.dokos.io/v5/dokos/production/station-de-travail)
- [Opération](https://doc.dokos.io/v5/dokos/production/operation)
- [Cycle de production complet](https://doc.dokos.io/v5/dokos/production/cycle-production-complet)
- [Unités de mesure](https://doc.dokos.io/v5/dokos/stocks/unites-de-mesure)


# Pilotage complet de la Dokoboard dans Dokos

La Dokoboard est le produit fini de Dokompany : un longboard électrique assemblé à partir de sous-ensembles fabriqués en interne et de composants électroniques achetés. Ce cas illustre comment Dokos gère l'ensemble du cycle — de la prévision commerciale à la livraison — en assurant la traçabilité des coûts et la disponibilité des stocks à chaque étape.

---

## Architecture de production

### Nomenclature multi-niveaux

La Dokoboard est décrite par une nomenclature à trois niveaux. Dokos l'éclate automatiquement pour calculer les besoins en composants bruts lors de la planification.

```text
Dokoboard (produit fini — niveau 0)
└── Truck Assembly × 2              (sous-ensemble fabriqué — niveau 1)
    ├── Truck 184mm × 1                  (composant acheté)
    └── Wheel Assembly × 2               (sous-ensemble fabriqué — niveau 2)
        ├── Roulements 8-pack × 1            (composant acheté)
        └── Roues 83mm 78A × 1               (composant acheté)
```

::demo-link{demo="Dokompany" doctype="BOM"}
Voir la nomenclature Dokoboard dans la démo
::

### Structure des entrepôts

Dokompany organise ses stocks en zones fonctionnelles distinctes, ce qui permet à Dokos de savoir où chaque article doit se trouver à chaque étape du cycle.

| Entrepôt              | Rôle                                                      |
| --------------------- | --------------------------------------------------------- |
| **Stock Pièces**      | Composants achetés disponibles pour la production         |
| **Stock Assemblages** | Sous-ensembles fabriqués (Wheel Assembly, Truck Assembly) |
| **Stock Dokoboards**  | Produits finis prêts à expédier                           |
| **Atelier**           | Travaux en cours (matières en cours d'assemblage)         |
| **Qualité Contrôle**  | Composants reçus en attente d'inspection qualité          |
| **Qualité Rebuts**    | Composants refusés après inspection                       |

---

## Flux de production global

::mermaid
flowchart TD
A\[Commande client] --> B\[Plan de production]
F\[Prévisions MPS] --> B
G\[Seuil de réapprovisionnement] --> B
B --> C1\[Ordre de travail — Wheel Assembly]
B --> C2\[Ordre de travail — Truck Assembly]
B --> C3\[Ordre de travail — Dokoboard]
B --> D\[Demandes d'achat pour composants manquants]
D --> E\[Réception fournisseur]
E -->|Composants électroniques| QC\[Inspection qualité]
E -->|Composants standard| SP\[Stock Pièces]
QC -->|Accepté| SP
QC -->|Refusé| QR\[Stock Rebuts]
SP --> C1 & C2
C1 --> SA\[Stock Assemblages]
C2 --> SA
SA --> C3
C3 --> SD\[Stock Dokoboards]
SD --> LIV\[Bon de livraison → Facture]

::

---

## Déclenchement de la production

La production d'une Dokoboard peut être déclenchée depuis trois sources différentes, utilisables séparément ou en combinaison dans un même plan de production :

- **Commandes clients** — Dokos détecte les commandes validées avec des Dokoboards à produire et les ajoute au plan.
- **Plan Industriel et Commercial (MPS)** — Dokompany prévoit une demande mensuelle croissante (50 unités le premier mois, +5 chaque mois sur 12 mois). Le MPS génère un calendrier de production lissé sans attendre les commandes fermes.
- **Réapprovisionnement automatique** — dès que le stock de Dokoboards tombe sous 20 unités, Dokos génère automatiquement une demande de fabrication de 10 unités.

::demo-link{demo="Dokompany" doctype="Production Plan"}
Voir un plan de production dans la démo
::

---

## Approvisionnement et réapprovisionnement automatique

### Règles de réapprovisionnement

Dokompany configure des niveaux de réapprovisionnement sur ses composants critiques. Dokos surveille ces seuils à chaque mouvement de stock et génère automatiquement les demandes correspondantes.

| Article          | Seuil      | Quantité déclenchée | Type        |
| ---------------- | ---------- | ------------------- | ----------- |
| Dokoboard        | 20 unités  | 10 unités           | Fabrication |
| Truck 184mm      | 10 unités  | 20 unités           | Achat       |
| Roues 83mm       | 40 unités  | 80 unités           | Achat       |
| Roulements       | 10 unités  | 20 unités           | Achat       |
| Vis M4×16        | 100 unités | 500 unités          | Achat       |
| Câble électrique | 5 m        | 50 m                | Achat       |

Lorsque le type est **Fabrication**, la demande alimente directement un plan de production. Lorsque le type est **Achat**, elle génère une demande d'achat que l'équipe approvisionnement transforme en commande fournisseur.

::callout{type="info"}
Le réapprovisionnement automatique déclenche des demandes, pas des actions définitives. Chaque demande reste à valider par un responsable — ce point de contrôle permet d'arbitrer entre réapprovisionner, consommer les stocks existants ou ajuster la planification.
::

::demo-link{demo="Dokompany" doctype="Material Request"}
Suivre les demandes d'approvisionnement
::

### Contrôle qualité des composants électroniques

Certains composants (moteur, pièces moteur, Raspberry Pi Zero) sont signalés comme nécessitant une inspection à la réception. Dokos crée automatiquement un contrôle qualité entrant lors de chaque réception. Ces pièces restent dans « Qualité Contrôle » jusqu'à validation de l'inspection — elles ne peuvent pas être transférées vers la production avant.

Les pièces refusées sont redirigées vers « Qualité Rebuts » et exclues du stock disponible pour la production.

---

## Ordres de travail et gestion de l'atelier

Le plan de production crée un ordre de travail distinct pour chaque niveau de sous-ensemble, dans l'ordre de la nomenclature (du plus bas vers le haut). Dokos réserve les composants dans les entrepôts sources, les transfère vers l'Atelier et génère les cartes de travail pour chaque opération.

Les ordres de travail pour la Dokoboard s'enchaînent ainsi :

1. **Wheel Assembly** → poste *Presse Roulements* (Pressage des roulements, 2 min/unité) → résultat en **Stock Assemblages**
2. **Truck Assembly** → poste *Assemblage B* (Vissage des trucks, 2 min/unité) → résultat en **Stock Assemblages**
3. **Dokoboard** → poste *Assemblage A* (Montage, 60 min/unité) → résultat en **Stock Dokoboards**

   - Sous-opération 1 : Assemblage Mécanique (*Assemblage A*)
   - Sous-opération 2 : Câblage et Montage Électronique (*Assemblage C*)
   - Sous-opération 3 : Contrôle Final et Emballage (*Emballage*)

::demo-link{demo="Dokompany" doctype="Work Order"}
Voir un ordre de travail dans la démo
::

---

## Suivi d'atelier et cartes de travail

Les cartes de travail permettent aux opérateurs de déclarer les temps réels et les quantités produites par opération. Dokos utilise ces données pour calculer précisément les coûts opératoires de chaque production.

> **Exemple — Dokompany**
> Lors du montage, les opérateurs déclenchent un chrono sur leur carte de travail (opération « Montage », poste Assemblage A). La sous-opération « Câblage et Montage Électronique » se déroule au poste Assemblage C. Dokos intègre ces temps réels pour valoriser le coût de main-d'œuvre et d'énergie du produit fini, opération par opération.

Le **plan d'atelier** offre en complément une vue en temps réel de l'état de chaque poste : opérations en cours, en attente ou terminées. C'est l'interface recommandée pour les opérateurs — ils y accèdent à toutes leurs cartes de travail depuis un seul écran, sans naviguer entre plusieurs formulaires.

::demo-link{demo="Dokompany" doctype="Job Card"}
Visualiser le suivi des tâches en atelier
::

::demo-link{demo="Dokompany" path="/app/plant-floor"}
Voir le plan d'atelier en temps réel
::

---

## Calcul des coûts de revient

### Coût prévisionnel depuis la nomenclature

Dokos calcule le coût de revient prévisionnel d'une Dokoboard en additionnant le coût des matières à chaque niveau de la nomenclature et les coûts opératoires des postes de travail.

**Coût matière (nomenclature de démonstration) :**

| Composant          | Qté | Coût unitaire | Sous-total  |
| ------------------ | --- | ------------- | ----------- |
| Truck Assembly     | × 2 | €107,00       | €214,00     |
| **Total matières** |     |               | **€214,00** |

Le coût du Truck Assembly est lui-même calculé depuis sa propre nomenclature :

- **Wheel Assembly*&#x2A; : roulements (€20,70) + roues (€12,00) + Presse Roulements (2 min × €0,60/h) ≈ **€33,00**
- **Truck Assembly*&#x2A; : truck 184mm (€40,00) + 2 × Wheel Assembly (€66,00) + Assemblage B (2 min × €20/h) ≈ **€107,00**

**Coût opératoire Dokoboard :*&#x2A; l'opération « Montage » au poste Assemblage A (60 min, taux horaire : main-d'œuvre €20/h + consommables €2/h + électricité €0,50/h + loyer €2/h = **€24,50/h*&#x2A;) représente **€24,50/Dokoboard**.

### Coût réel vs coût prévisionnel

À la clôture de chaque ordre de travail, Dokos calcule le coût réel en croisant les matières effectivement consommées et les temps réellement déclarés dans les cartes de travail. L'écart est visible directement dans l'ordre de travail.

> **Exemple — Dokompany**
> Un lot de 5 Dokoboards est prévu à €24,50 de coût opératoire par unité. Si les opérateurs ont mis en moyenne 75 min par board à cause d'un problème de câblage, le coût réel monte à €30,63/board. Dokos affiche un écart de +€6,13/board — signal direct pour ajuster les temps standards dans le routage.

---

## Projections de stock et planification

### Plan Industriel et Commercial (MPS)

Dokompany pilote sa production sur 12 mois via le Plan Industriel et Commercial. La prévision démarre à 50 Dokoboards par mois et augmente de 5 unités chaque mois. Dokos intègre les délais d'approvisionnement pour déterminer quand lancer chaque commande ou fabrication :

| Article                      | Délai d'approvisionnement |
| ---------------------------- | ------------------------- |
| Dokoboard (fabrication)      | 2 jours                   |
| Truck Assembly (fabrication) | 1 jour                    |
| Wheel Assembly (fabrication) | 1 jour                    |
| Moteur (achat)               | 15 jours                  |
| Pièces moteur (achat)        | 10 jours                  |
| Raspberry Pi Zero (achat)    | 7 jours                   |

### Projections de stock par entrepôt

Le rapport « Projections de stocks » croise les quantités disponibles, planifiées, commandées et réservées pour anticiper les ruptures. Chez Dokompany, il est filtré sur « Stock Pièces » pour visualiser uniquement les composants effectivement disponibles (hors Qualité Contrôle).

::demo-link{demo="Dokompany" path="/app/master-production-schedule"}
Voir le Plan Industriel et Commercial dans la démo
::

---

## Rapports de suivi de la production et des stocks

### Tableau de bord de production

Le tableau de bord de production centralise les indicateurs clés :

- **Ordres de travail du mois** — nombre total d'ordres ouverts, en cours et terminés
- **Cartes de travail en cours** — opérations actives dans l'atelier
- **Inspections qualité du mois** — contrôles validés vs refusés
- **Analyse par statut** — répartition des ordres (Non commencé / En cours / Arrêté / Terminé)
- **Quantité produite** — évolution sur la dernière année, visualisable par période
- **Temps d'arrêt machine** — minutes d'indisponibilité par poste le mois précédent

::demo-link{demo="Dokompany" path="/app/production-dashboard"}
Voir le tableau de bord de production
::

### Rapport d'analyse des ordres de travail

Ce rapport présente l'historique des ordres de travail avec le détail des coûts réels vs prévisionnels. Dokompany l'utilise pour identifier les lots où les coûts ont dérapé et corriger les temps standards dans les routings.

### Rapport de projection de stock

Accessible depuis le module Stocks, ce rapport croise les quantités disponibles, planifiées, commandées et réservées. Utile pour repérer, avant le lancement d'un plan de production, les composants qui manqueront.

---

## Suivi de la rentabilité

### Analyse de rentabilité brute

Le rapport « Rentabilité brute » dans le module Stocks compare, pour chaque Dokoboard livrée, le prix de vente facturé et le coût de valorisation calculé depuis la nomenclature.

- **Prix de vente** : €1 240,00 / Dokoboard
- **Coût de valorisation** (nomenclature de démonstration) : \~€214,00 / Dokoboard
- **Marge brute prévisionnelle** : \~€1 026,00 / Dokoboard (\~83 %)

> **Exemple — Dokompany**
> Sur un mois où 50 Dokoboards ont été livrées, Dokos calcule automatiquement la marge brute totale. Si une hausse du prix du moteur a augmenté le coût d'achat sur la période, l'impact sur la marge apparaît directement dans le rapport — sans recalcul manuel.

::mermaid
flowchart LR
A\[Prix de vente\n€1 240] --> D\[Marge brute]
B\[Coût matières BOM\n€214] --> C\[Coût de revient réel]
E\[Coût opératoire réel\ntemps × taux horaire] --> C
C --> D
D --> F\[Rapport Rentabilité brute\npar article livré]

::

### Rapport de rentabilité par article

Ce rapport liste toutes les lignes de factures de vente liées aux Dokoboards avec le montant HT et le chiffre d'affaires par période. Couplé avec la rentabilité brute, il permet de suivre à la fois le volume de ventes et la qualité de la marge.

### Suivi des coûts par ordre de travail

Pour un pilotage granulaire, chaque ordre de travail affiche l'écart coût réel / coût prévisionnel opération par opération. Dokompany utilise cette vue pour identifier les postes les plus coûteux et ajuster les temps standards dans les routings.

---

## Voir aussi

- [Nomenclature](https://doc.dokos.io/v5/dokos/production/nomenclature)
- [Ordre de travail](https://doc.dokos.io/v5/dokos/production/ordre-de-travail)
- [Carte de travail](https://doc.dokos.io/v5/dokos/production/carte-travail)
- [Projections de stocks](https://doc.dokos.io/v5/dokos/stocks/stock-level-report)


# Nomenclature

La nomenclature (ou liste de matériaux) décrit la composition complète d'un produit fini : chaque composant acheté, chaque sous-ensemble produit en interne, les quantités nécessaires et les opérations associées. Dokos utilise cette nomenclature pour calculer les besoins en matières, planifier les productions et chiffrer le coût de revient.

Dokos prend en charge les nomenclatures multi-niveaux : un produit fini peut contenir des sous-ensembles qui ont eux-mêmes leur propre nomenclature, et ainsi de suite.

---

Pour accéder à la liste des nomenclatures, allez sur :

> Accueil > Production > Liste de matériaux > **Nomenclature**

## Nomenclature multi-niveaux

Une nomenclature multi-niveaux décrit l'arborescence complète d'un produit : les composants achetés au niveau inférieur, les sous-ensembles fabriqués en interne aux niveaux intermédiaires, et le produit fini au sommet. Dokos « éclate » cette arborescence pour identifier toutes les matières premières nécessaires à la production finale.

> **Exemple — Dokompany**
> La Dokoboard est un longboard électrique dont la nomenclature a trois niveaux :
>
> ```text
> Dokoboard (produit fini)
> ├── Truck Assy × 2          ← sous-ensemble fabriqué
> │   ├── Truck 184 × 1
> │   ├── Vis M4 × 4
> │   ├── Écrou M4 × 4
> │   └── Wheel Assembly × 2  ← sous-ensemble imbriqué
> │       ├── Roulements × 1
> │       └── Roues 83mm × 1
> ├── Deck (longboard) × 1    ← matière première achetée
> ├── Moteur × 1              ← contrôle qualité obligatoire
> ├── Raspberry Pi Zero × 1   ← contrôle qualité obligatoire
> ├── Pièces moteur × 1       ← contrôle qualité obligatoire
> ├── Connecteurs XT60 × 5+5
> ├── Manette Wii × 1
> └── Boîte EVA × 2
> ```
>
> Pour produire 10 Dokoboards, Dokos calcule automatiquement qu'il faut 20 Truck Assy, 40 Wheel Assembly, 200 vis M4, 200 écrous M4, et ainsi de suite jusqu'aux composants les plus élémentaires.

::demo-link{demo="Dokompany" doctype="BOM"}
Voir la nomenclature de la Dokoboard dans la démo
::

## Nomenclature avec opérations

Quand une nomenclature inclut un routage, Dokos associe chaque composant à l'opération qui le consomme. Cela permet de générer les cartes de travail par poste lors du lancement de la production, et de calculer les coûts opératoires en plus du coût des matières.

> **Exemple — Dokompany**
> Dans la nomenclature de la Dokoboard, le routage « Routing Dokoboard » est attaché. Les vis M4 et les écrous M4 sont liés à l'opération « Vissage des trucks », les roulements à « Pressage des roulements ». Dokos sait ainsi exactement combien de temps chaque poste de travail sera mobilisé et calcule le coût opératoire réel après production.

## Contrôle qualité sur les composants critiques

Certains composants peuvent nécessiter une inspection qualité avant d'être utilisés en production. Dokos bloque leur consommation tant que l'inspection n'est pas validée.

> **Exemple — Dokompany**
> Le moteur, les pièces moteur et le Raspberry Pi Zero arrivent en entrepôt « Qualité Contrôle ». Un contrôle qualité entrant est créé automatiquement à chaque réception. Ces articles ne peuvent être transférés vers la production qu'une fois l'inspection acceptée.

## Consommer les composants basé sur

Le champ **Consommer les composants basé sur** permet de définir, pour chaque nomenclature, la méthode utilisée pour comptabiliser la consommation des matières premières lors de la production. Cette valeur est prioritaire sur le réglage global défini dans les [Paramètres de production](https://doc.dokos.io/v5/dokos/production/parametres-de-production).

Deux méthodes sont disponibles :

- **Nomenclature (BOM)** — Dokos consomme exactement les quantités définies dans la nomenclature, indépendamment des matières réellement transférées vers l'atelier. Cette approche convient aux productions standardisées où les quantités théoriques sont fiables.
- **Entrée de stock** — Dokos consomme les matières en se basant sur ce qui a été réellement transféré vers l'entrepôt de travaux en cours (WIP). Cette approche est plus précise pour les productions variables où les quantités réelles peuvent différer de la nomenclature.

Si ce champ est laissé vide dans la nomenclature, Dokos applique le paramètre global défini dans les Paramètres de production.

::mermaid
flowchart TD
A\[Ordre de travail lancé] --> B{Nomenclature :
Consommer basé sur ?}
B -- "Valeur définie" --> C\[Utilise la méthode
de la Nomenclature]
B -- "Vide" --> D\[Utilise le paramètre
global de production]
C --> E{Méthode choisie}
D --> E
E -- "Nomenclature" --> F\[Consommation basée
sur les quantités BOM]
E -- "Entrée de stock" --> G\[Consommation basée
sur les transferts réels]

::

> **Exemple — Dokompany**
> Dokompany fabrique deux références :
>
> - La **Dokoboard Standard** a une nomenclature très stable. La méthode « Nomenclature » est configurée directement dans sa BOM : Dokos comptabilise exactement les quantités théoriques à chaque production, sans tenir compte des éventuels surplus transférés en atelier.
> - La **Dokoboard Prototype** est en phase de développement. Ses besoins en composants varient à chaque lot. La méthode « Entrée de stock » est sélectionnée dans sa BOM : Dokos consomme ce qui a réellement été transféré vers l'Atelier, reflétant ainsi les ajustements effectués en cours de fabrication.
> - Pour toutes les autres nomenclatures sans valeur spécifiée, Dokos applique le réglage des Paramètres de production, qui est « Nomenclature » pour toute la société Dokompany.

::callout{type="info"}
Quand l'ordre de travail est chargé, Dokos lit automatiquement la valeur de ce champ depuis la nomenclature et l'applique à toutes les entrées de stock de consommation associées à cet ordre. Aucune action manuelle n'est nécessaire.
::

## Coût de la nomenclature

La section Coût de la nomenclature affiche le coût de revient prévisionnel du produit fini. Dokos additionne :

- le coût de chaque composant selon le mode de valorisation choisi (taux de valorisation, dernier prix d'achat ou liste de prix)
- les coûts opératoires calculés à partir des durées d'opération et des taux horaires des stations de travail

Ce coût peut être mis à jour manuellement ou automatiquement à chaque changement de prix composant.

## Créateur de nomenclature (BOM Creator)

Pour les produits complexes à plusieurs niveaux, Dokos propose un outil de création guidé qui permet de construire l'arborescence complète en une seule session, puis de soumettre toutes les nomenclatures en cascade.

::demo-link{demo="Dokompany" doctype="BOM Creator"}
Voir le créateur de nomenclature dans la démo
::

## Versionnage et modification des nomenclatures

Une nomenclature soumise est figée : Dokos ne permet pas de la modifier directement pour préserver la traçabilité des productions passées. Pour corriger ou faire évoluer une nomenclature, il faut en créer une nouvelle version avec un numéro incrémenté (ex. `BOM-Truck Assy-002`), valider la nouvelle version, puis désactiver l'ancienne.

Dokos marque automatiquement la version active d'une nomenclature avec le statut **Active**. Pour un même article, une seule nomenclature peut être active à la fois — c'est elle qui sera utilisée par défaut dans les nouveaux ordres de travail.

> **Exemple — Dokompany**
> Suite à un changement de fournisseur de roulements, Dokompany crée une version 2 de la nomenclature Wheel Assembly (`BOM-Wheel assembly-002`) avec le nouveau composant. La version 1 est désactivée. L'outil de mise à jour de nomenclature est ensuite utilisé pour remplacer la version 1 par la version 2 dans toutes les nomenclatures qui utilisent le Wheel Assembly.

## Outil de mise à jour de nomenclature

Quand un sous-ensemble change de composition (nouveau composant, changement de fournisseur), l'outil de mise à jour de nomenclature propage automatiquement la nouvelle version dans toutes les nomenclatures parentes. Cela évite de modifier manuellement chaque produit fini qui utilise ce sous-ensemble.

L'outil demande de renseigner l'ancienne et la nouvelle nomenclature du sous-ensemble. Dokos identifie alors toutes les nomenclatures parentes qui référencent l'ancienne version et les met à jour en une seule opération.

Pour accéder à l'outil :

> Accueil > Production > Outils > **Mise à jour de nomenclature**

> **Exemple — Dokompany**
> La nomenclature `BOM-Wheel assembly-001` est remplacée par `BOM-Wheel assembly-002`. L'outil de mise à jour identifie que `BOM-truck assy-001` et `BOM-dokoboard-001` utilisent toutes les deux le Wheel Assembly. Après exécution, les deux nomenclatures parentes pointent vers la version 2 — sans modification manuelle de chaque fiche.

::callout{type="warning"}
L'outil de mise à jour ne s'applique qu'aux nomenclatures dont le statut est **Active**. Les nomenclatures en brouillon ou désactivées ne sont pas concernées. Après une mise à jour, vérifiez dans la vue en arbre que l'arborescence complète est cohérente, notamment pour les produits finis avec plusieurs niveaux de sous-ensembles imbriqués.
::

### Bonnes pratiques pour les nomenclatures multi-niveaux

Dans une structure à 3 niveaux ou plus (produit fini → étapes d'assemblage → sous-ensembles → composants), un changement à un niveau bas peut nécessiter des mises à jour en cascade sur plusieurs niveaux parents. La séquence recommandée est la suivante :

1. Créer la nouvelle version de la nomenclature enfant modifiée et la soumettre
2. Utiliser l'outil de mise à jour pour remplacer l'ancienne version dans les nomenclatures de niveau immédiatement supérieur
3. Si ces nomenclatures intermédiaires ont elles-mêmes des parents, relancer l'outil pour propager jusqu'au niveau du produit fini
4. Vérifier l'arborescence finale avec la vue en arbre de la nomenclature du produit fini

::callout{type="info"}
La vue en arbre de la nomenclature affiche l'arborescence complète avec les versions actives à chaque niveau. C'est l'outil de contrôle recommandé après chaque mise à jour pour s'assurer que l'ensemble de la chaîne de composition est cohérente.
::

## Voir aussi

- [Opération](https://doc.dokos.io/v5/dokos/production/operation)
- [Station de travail](https://doc.dokos.io/v5/dokos/production/station-de-travail)
- [Routage](https://doc.dokos.io/v5/dokos/production/routage)
- [Ordre de travail](https://doc.dokos.io/v5/dokos/production/ordre-de-travail)


# Opération

Une opération représente une étape précise du processus de fabrication : découper, assembler, câbler, contrôler, emballer. Dokos lie chaque opération à une station de travail par défaut et capture les temps réels via les cartes de travail.

Les opérations peuvent être composées de sous-opérations pour décrire des étapes complexes comportant plusieurs phases séquentielles.

---

Pour accéder à la liste des opérations, allez sur :

> Accueil > Production > Liste de matériaux > **Opération**

## Opérations simples et sous-opérations

Une opération simple couvre une tâche unitaire réalisée sur une seule station de travail. Une opération avec sous-opérations décompose un processus plus long en phases distinctes, chacune pouvant être chronométrée et validée séparément.

> **Exemple — Dokompany**
> Dokompany définit des opérations simples pour chaque geste élémentaire :
>
> - **Pressage des roulements** → Presse Roulements (10 min)
> - **Vissage des trucks** → Assemblage B (15 min)
> - **Assemblage Mécanique** → Assemblage A (châssis, planche, trucks, roues)
> - **Câblage et Montage Électronique** → Assemblage C (moteur, électronique de commande)
>
> L'opération **Contrôle Final et Emballage** regroupe deux sous-opérations : « Test fonctionnel » (moteur, manette) puis « Emballage » (mise en carton). L'opération **Montage** orchestre à son tour trois sous-opérations : Assemblage Mécanique, Câblage et Montage Électronique, et Contrôle Final et Emballage.

::demo-link{demo="Dokompany" doctype="Operation"}
Voir les opérations de fabrication dans la démo
::

## Lien avec les nomenclatures et les cartes de travail

Les opérations s'attachent aux composants dans la nomenclature : chaque matière première ou sous-ensemble peut être associé à l'opération qui l'utilise. Dokos crée ensuite une carte de travail par opération lors du lancement d'un ordre de travail, ce qui permet de suivre la durée réelle à chaque poste.

> **Exemple — Dokompany**
> Dans la nomenclature de la Dokoboard, les vis M4 et les écrous M4 sont liés à l'opération « Vissage des trucks ». Les roulements (bearings) sont liés à « Pressage des roulements ». Quand un ordre de travail est soumis, Dokos génère automatiquement les cartes de travail correspondantes pour chaque opération, avec le bon poste de travail.

## Séquencement des opérations

Dokos respecte l'ordre des opérations défini dans le routage. Si un opérateur tente de valider une opération avant que l'opération précédente ne soit terminée, Dokos bloque la progression avec un message d'erreur. Ce séquencement garantit l'intégrité du flux de production.

## Voir aussi

- [Station de travail](https://doc.dokos.io/v5/dokos/production/station-de-travail)
- [Routage](https://doc.dokos.io/v5/dokos/production/routage)
- [Nomenclature](https://doc.dokos.io/v5/dokos/production/nomenclature)
- [Carte de travail](https://doc.dokos.io/v5/dokos/production/carte-travail)


# Ordre de travail

L'ordre de travail est le document central de l'exécution en atelier. Dokos l'utilise pour organiser la fabrication d'un lot précis : réserver les matières premières, assigner les opérations aux postes de travail, suivre l'avancement via les cartes de travail, enregistrer les produits finis en stock à la fin de la production, et désormais visualiser les besoins en approvisionnement en temps réel.

---

Pour accéder à la liste des ordres de travail, allez sur :

> Accueil > Production > Production > **Ordre de travail**

## Flux de production

::mermaid
graph LR
A\[Ordre de travail soumis] --> B\[Demande de matières premières
ou Transfert direct]
B --> C\[Transfert matières vers Atelier]
C --> D\[Cartes de travail / opérations en atelier]
D --> E\[Produits finis mis en stock]
E --> F\[Ordre de travail clôturé]

::

## Réservation des matières premières

À la soumission de l'ordre de travail, Dokos réserve automatiquement les matières premières dans leurs entrepôts sources. Chaque composant peut provenir d'un entrepôt différent selon sa nature.

> **Exemple — Maison Verte SARL**
> Pour produire un lot de 10 étagères en bois, Dokos réserve dans trois entrepôts distincts :
>
> - **Stock Bois** — les planches de chêne
> - **Stock Quincaillerie** — les vis et équerres
> - **Stock Peinture** — la lasure écologique

L'entrepôt de travaux en cours (Atelier) reçoit ensuite les matières transférées lors du démarrage de la production.

::demo-link{demo="Maison Verte SARL" doctype="Work Order"}
Voir un ordre de travail dans la démo
::

## Entrepôt source par type de composant

Dokos détermine l'entrepôt source de chaque composant selon une priorité en cascade : l'entrepôt défini dans le plan de production est utilisé en premier ; à défaut, Dokos prend l'entrepôt par défaut renseigné sur la fiche article.

Dans le tableau des composants de l'ordre de travail, l'entrepôt source de chaque ligne peut être modifié individuellement avant le premier transfert. Cette correction est utile lorsque certains articles ont un entrepôt par défaut inadapté au contexte de la production.

> **Exemple — Maison Verte SARL**
> Les planches de chêne reçues sont d'abord stockées dans « Réception Fournisseur ». Après contrôle qualité, elles sont transférées vers « Stock Bois ». Si l'entrepôt source dans le plan de production n'a pas été défini, l'ordre de travail pointe par défaut vers « Réception Fournisseur ». L'opérateur peut corriger la ligne pour pointer vers « Stock Bois » avant de lancer la demande de matières.

::callout{type="info"}
Pour éviter cette correction répétitive, définissez l'entrepôt source dans le plan de production avant de créer les ordres de travail. Tous les ordres générés héritent automatiquement de cet entrepôt.
::

## Suivi des transferts partiels de matières

Dokos cumule les quantités transférées au fur et à mesure dans le tableau des composants de l'ordre de travail. Pour chaque article, la colonne **Qté transférée** reflète le total de toutes les entrées de stock déjà créées. La différence entre la quantité requise et la quantité transférée indique ce qui reste à envoyer vers l'atelier.

Lors de la création d'un nouveau transfert partiel, Dokos ne soustrait pas automatiquement ce qui a déjà été transféré — il revient à l'opérateur de saisir uniquement la quantité manquante en se référant au tableau des composants.

> **Exemple — Maison Verte SARL**
> Un ordre de travail nécessite 20 vis inox. Une première entrée de stock en transfère 12 vers l'Atelier. Dokos affiche « 12 transférées / 20 requises ». Lors d'un second transfert, l'opérateur saisit 8 pour compléter le lot. Dokos cumule les deux transferts et affiche « 20 transférées / 20 requises » à l'issue de l'opération.

::callout{type="warning"}
Si plusieurs opérateurs créent des transferts simultanément sans consulter le tableau des composants, il y a un risque de double-saisie. Pour les productions longues, il est recommandé de désigner une seule personne responsable des transferts de matières.
::

## Transfert des matières vers l'atelier

Dokos crée une entrée de stock de type **Transfert de matières pour la production** qui déplace les composants de leurs entrepôts sources vers l'entrepôt de travaux en cours. Cette étape marque le début physique de la fabrication.

## Suivi des opérations par carte de travail

Chaque opération définie dans la nomenclature génère une carte de travail distincte, assignée à la station de travail correspondante. Les opérateurs s'en servent pour déclarer les temps réels et la quantité produite. Dokos consolide ces informations pour calculer le coût réel de l'ordre de travail.

> **Exemple — Maison Verte SARL**
> L'ordre de travail pour 10 étagères génère une carte de travail pour l'opération « Assemblage » au poste Atelier Bois. Cette carte contient les sous-opérations : Découpe, Ponçage, Assemblage et Finition. Chaque opérateur enregistre son temps de travail dans les journaux de temps de la carte.

## Contrôle qualité en cours de production

Si la nomenclature ou l'article produit requiert une inspection qualité, Dokos peut créer un contrôle qualité « en cours de fabrication » directement depuis l'ordre de travail ou la carte de travail. La production ne peut pas être finalisée tant que ce contrôle n'est pas validé.

::callout{type="info"}
La boîte de dialogue de création d'inspection qualité depuis un ordre de travail ou une carte de travail a été améliorée (MR #9122). Il est désormais possible de lancer l'inspection qualité de façon plus fluide sans quitter le contexte de l'ordre de travail en cours.
::

## Mise en stock des produits finis

À la fin des opérations, Dokos crée une entrée de stock de type **Fabrication** qui transfère les produits finis vers l'entrepôt cible.

> **Exemple — Maison Verte SARL**
> Les 10 étagères terminées sont transférées vers l'entrepôt « Stock Produits Finis ». Les matières non consommées retournent au « Stock Bois ». Le coût réel de chaque étagère est calculé : coût des matières effectivement utilisées + temps opératoires × taux horaires des postes.

## Coût réel vs coût prévisionnel

L'ordre de travail affiche en permanence l'écart entre le coût prévu (calculé depuis la nomenclature) et le coût réel (calculé depuis les entrées de stock et les cartes de travail). Cet écart aide à identifier les postes où la production est plus coûteuse que prévu.

## Panneau Approvisionnement & Couverture

Le panneau **Approvisionnement & Couverture** est désormais disponible directement dans la fiche **Ordre de travail**. Ce panneau offre une vue consolidée des besoins en approvisionnement pour tous les composants de l'ordre, en temps réel.

### Fonctionnalités clés

- **Quantités disponibles** : Affiche le stock actuel disponible pour chaque composant dans les entrepôts sources.
- **Quantités réservées** : Indique les quantités déjà réservées pour d'autres ordres de travail ou commandes clients.
- **Quantités manquantes** : Calcule la différence entre la quantité requise et la quantité disponible + réservée.
- **Délais d'approvisionnement** : Estime le délai nécessaire pour obtenir les composants manquants, basé sur les données des fournisseurs ou les délais moyens historiques.
- **Alertes visuelles** : Met en évidence les composants critiques (en rupture ou avec des délais d'approvisionnement longs).

### Comment l'utiliser ?

1. Ouvrez un **Ordre de travail** soumis.
2. Faites défiler la fiche jusqu'au panneau **Approvisionnement & Couverture**.
3. Consultez les informations pour chaque composant :


   - **Disponible** : Quantité physiquement en stock.
   - **Réservé** : Quantité déjà allouée à d'autres besoins.
   - **Manquant** : Quantité à approvisionner pour compléter l'ordre.
   - **Délai estimé** : Temps nécessaire pour obtenir les composants manquants.

> **Exemple — Maison Verte SARL**
> Pour un ordre de travail nécessitant 50 planches de chêne, le panneau affiche :
>
> - **Disponible** : 30 planches
> - **Réservé** : 5 planches (pour un autre ordre)
> - **Manquant** : 20 planches
> - **Délai estimé** : 5 jours (délai moyen du fournisseur)
>
> L'équipe peut ainsi anticiper un retard de 5 jours sur cet ordre et ajuster la planification en conséquence.

### Actions possibles depuis le panneau

- **Créer une demande d'achat** : Pour les composants manquants, vous pouvez générer directement une demande d'achat depuis le panneau.
- **Vérifier les alternatives** : Si un composant est en rupture, Dokos propose des articles de substitution (si configurés dans la fiche article).
- **Mettre à jour les délais** : Les délais d'approvisionnement peuvent être ajustés manuellement pour refléter des conditions spécifiques (ex : pénurie temporaire).

::callout{type="info"}
Le panneau **Approvisionnement & Couverture** est également disponible dans les fiches **Plan de production** et **Demande de matériel**, offrant une cohérence dans la gestion des besoins en approvisionnement à travers Dokos.
::

## Rapport Résumé des ordres de travail

Le rapport **Résumé des ordres de travail** permet de suivre l'ensemble des ordres sur une période donnée : quantités planifiées, produites, en attente, avec leur statut et leur durée de cycle.

Pour accéder au rapport :

> Accueil > Production > Rapports > **Résumé des ordres de travail**

::callout{type="info"}
Ce rapport a été amélioré dans le cadre des corrections du flux de fabrication (MR #9122) pour affiner les calculs de quantités et de statuts affichés.
::

## Arrêt d'un ordre de travail

Un ordre de travail peut être arrêté avant d'être complété. Dokos exige que les matières premières déjà transférées vers l'atelier soient retournées au stock avant de permettre l'arrêt, afin de maintenir la cohérence des inventaires.

## Voir aussi

- [Carte de travail](https://doc.dokos.io/v5/dokos/production/carte-travail)
- [Nomenclature](https://doc.dokos.io/v5/dokos/production/nomenclature)
- [Cycle de production complet](https://doc.dokos.io/v5/dokos/production/cycle-production-complet)
- [Approvisionnement & Couverture](https://doc.dokos.io/v5/dokos/stocks/stock-level-report#projections-de-stock)


# Routage

Le routage définit la séquence complète des opérations nécessaires à la fabrication d'un produit, avec pour chacune la station de travail assignée et la durée estimée. Quand ce routage est attaché à une nomenclature, Dokos génère automatiquement les cartes de travail dans le bon ordre à chaque lancement de production.

---

Pour accéder à la liste des routages, allez sur :

> Accueil > Production > Liste de matériaux > **Routage**

## Définir un routage

Un routage liste les opérations dans leur ordre logique. La durée en minutes et la station de travail sont précisées pour chaque étape, ce qui permet à Dokos de calculer le coût opératoire prévisionnel et de planifier la charge des postes.

> **Exemple — Dokompany**
> Dokompany utilise trois routages distincts selon le niveau de production :
>
> - **Routing Dokoboard** — une seule opération « Montage » (60 min, Assemblage A) qui regroupe en sous-opérations l'assemblage mécanique, le câblage électronique et le contrôle final avec emballage
> - **Routing Trucks** — « Vissage des trucks » (15 min, Assemblage B) pour produire les sous-ensembles de trucks
> - **Routing Wheels** — « Pressage des roulements » (10 min, Presse Roulements) pour assembler les roues

::demo-link{demo="Dokompany" doctype="Routing"}
Voir les routages dans la démo
::

## Séquencement et identifiant d'ordre

Dokos attribue un identifiant de séquence à chaque opération dans le routage. Lors de l'exécution en atelier, les cartes de travail doivent être complétées dans cet ordre. Si un opérateur tente de valider une étape sans que les précédentes soient terminées, Dokos refuse la soumission — ce qui garantit la traçabilité et évite les erreurs d'assemblage.

## Réutilisation sur plusieurs nomenclatures

Un même routage peut être appliqué à plusieurs références produit partageant le même processus de fabrication. Modifier le routage propage automatiquement les nouvelles durées et séquences dans toutes les nomenclatures qui l'utilisent.

## Voir aussi

- [Opération](https://doc.dokos.io/v5/dokos/production/operation)
- [Station de travail](https://doc.dokos.io/v5/dokos/production/station-de-travail)
- [Nomenclature](https://doc.dokos.io/v5/dokos/production/nomenclature)
- [Carte de travail](https://doc.dokos.io/v5/dokos/production/carte-travail)


# Sous-traitant

En sous-traitance, vous faites appel à une partie externe pour effectuer des tâches pour votre organisation, notamment la fabrication.

La sous-traitance est un type de contrat de travail qui vise à sous-traiter certains types de travaux à d'autres entreprises. Cela permet de travailler sur plus d'une phase du projet à la fois, ce qui conduit souvent à une exécution plus rapide.

La sous-traitance est pratiquée par diverses industries. Par exemple, les fabricants qui fabriquent un certain nombre de produits à partir de composants complexes sous-traitent certains composants et les emballent dans leurs installations.

Si votre entreprise implique l'externalisation de certains processus à un fournisseur tiers où vous fournissez les matières premières et que le tiers s'occupe du travail / de la production, vous pouvez suivre cela en utilisant la fonction de sous-traitance de Dokos.

## 1. Comment mettre en place la sous-traitance

1. Créez des articles séparés pour le produit non transformé et le produit transformé. Par exemple, si vous fournissez X non peint à votre fournisseur et que le fournisseur vous renvoie X, vous pouvez créer deux éléments: «X-non peint» et «X».
2. Créez un entrepôt pour votre fournisseur afin que vous puissiez suivre les articles fournis. (vous pouvez fournir un mois d'articles en une seule fois).
3. Pour l'article traité, dans la base de données des articles, activez **Est un article sous-traité**.

### 1.1 Créer une nomenclature

Créez une **nomenclature** pour l'article traité, avec les articles non traités comme sous-articles. Prenons un exemple simple, où vous fabriquez un stylo. Le stylo traité sera nommé sous la nomenclature, tandis que la plume, le plastique, l'encre, etc. seront classés comme sous-articles.

Cette nomenclature sera sans opérations si tout le travail de production est effectué par un tiers. Voyons avec un exemple simple de canne en plastique:

### 1.2 Créer un bon de commande

Passez un bon de commande pour l'article traité, celui pour lequel vous avez créé une nomenclature. Lorsque vous **Enregistrer**, dans **Matières premières fournies**, tous vos articles non traités seront mis à jour en fonction de votre nomenclature. Vous pouvez également sélectionner l'entrepôt dans lequel les matières premières seraient réservées pour la sous-traitance sous Réserver l'entrepôt.

1. Les coûts impliqués dans le processus de sous-traitance doivent être enregistrés dans le champ **Taux du tableau Articles** de la commande fournisseur comme suit :
2. Dans l'image précédente, nous fournissons au sous-traitant 2 boîtes de chacun des 3 matériaux pour fabriquer 240 stylos. Le coût d'un stylo est de 27 et le coût total de tous les stylos est donc de 6480
3. Vous devez définir «Fournir des matières premières» sur Oui, car ce bon de commande est destiné à la sous-traitance.
4. A partir d'un bon de commande, sélectionnez les matières premières à transférer au sous-traitant:
5. Une fois la commande d'achat soumise, vous pouvez également afficher la quantité réservée de l'article à partir du tableau de bord de l'article.

### 1.3 Créer une entrée de stock pour transférer des matières premières

Maintenant que les matières premières sont réservées, effectuez une entrée de stock pour livrer les articles de matière première à votre fournisseur.

Dans le bon de commande, cliquez sur Transférer> Article au fournisseur. Définissez les entrepôts source et cible. L'entrée de stock sera de type «Envoyer au sous-traitant» où vous transférez d'un entrepôt à un autre. Cochez «À partir de la nomenclature» et sélectionnez la nomenclature, entrez la quantité et cliquez sur le bouton Obtenir les articles.

### 1.4 Créer un reçu d'achat pour recevoir les articles finis

Recevez les articles de votre fournisseur à l'aide d'un reçu d'achat . Vous devez entrer dans l'entrepôt du fournisseur d'où les matières premières seront prélevées et les produits finis seront reçus dans l'entrepôt accepté. Considérez cela comme une rétro-consommation pour la sous-traitance.

Cliquez sur Créer > **Reçu d'achat à partir de la commande fournisseur**. Définissez les entrepôts acceptés et fournisseurs. Assurez-vous de cocher la «Quantité consommée» dans le tableau «Matières premières» afin que le stock correct soit maintenu chez le fournisseur. Vous devez sélectionner l'entrepôt du fournisseur où vous recevrez les produits finis.

### 1.5 Matière première provenant du fournisseur

Lors de la création d'une nomenclature pour la sous-traitance, il peut y avoir peu de matières premières comme les écrous et les boulons que les fournisseurs devront se procurer eux-mêmes.

Lors de la création d'une entrée de stock pour **Transfert à partir d'une commande fournisseur**, ces articles peuvent être exclus un par un, mais il est impossible de le faire si vous avez plus de 100 articles.

Si certaines matières premières proviennent directement du fournisseur, ces matières premières doivent être incluses dans la nomenclature.

Il aura une valeur nulle dans la nomenclature
Dans le bon de commande, cette matière première n'apparaîtra pas dans les articles fournis car elle n'est pas fournie
De plus, lors de la création d'un "Transfert", ces articles seront exclus de l'Entrée de Stock

Cependant, le fournisseur peut choisir d'inclure les articles fournis par le fournisseur dans sa commande client qui vous a été envoyée.

## 2. Remarques

Assurez-vous que le **taux** de l'article traité est le taux de traitement (à l'exclusion du taux de matière première).

Dokos ajoutera automatiquement le taux de matière première à des fins d'évaluation lorsque vous recevrez l'article fini dans votre stock.

Dokos définira automatiquement par défaut «l'entrepôt de réserve» dans le bon de commande à partir de la nomenclature. S'il ne se trouve pas dans la nomenclature, il le ferait par défaut à partir de l'entrepôt par défaut défini dans l'article. Vous pouvez définir l'entrepôt de réserve par défaut pour tous les articles du bon de commande à partir du champ «Entrepôt de réserve» de la section Matières premières fournies.


# Station de travail

Une station de travail représente un poste d'assemblage, une machine ou un espace physique où s'effectuent des opérations de fabrication. Dokos utilise ces informations pour planifier les ordres de travail et calculer le coût réel de chaque production.

Chaque station de travail peut avoir un type (manuelle ou machine) avec des taux horaires distincts : main-d'œuvre, électricité, loyer, consommables.

---

Pour accéder à la liste des stations de travail, allez sur :

> Accueil > Production > Liste de matériaux > **Station de travail**

## Types de stations de travail

Les types de stations de travail permettent de regrouper des postes similaires et de définir leurs coûts horaires une seule fois. Dokos applique automatiquement ces taux à toutes les stations de ce type.

> **Exemple — Dokompany**
> Dokompany définit deux types : « Opération manuelle » (20 €/h de main-d'œuvre, 0,5 €/h d'électricité, 2 €/h de loyer, 2 €/h de consommables) et « Machine » (2 €/h de main-d'œuvre, 0,5 €/h d'électricité). Les postes d'assemblage humains coûtent donc plus cher en main-d'œuvre, tandis que la presse à roulements consomme surtout de l'énergie.

::demo-link{demo="Dokompany" doctype="Workstation Type"}
Voir les types de stations de travail dans la démo
::

## Créer une station de travail

Chaque station de travail appartient à un atelier (plan d'atelier) et peut être associée à un calendrier d'ouverture et une liste de jours fériés. Dokos utilise ces informations pour vérifier la disponibilité lors de la planification des ordres de travail.

> **Exemple — Dokompany**
> L'atelier de fabrication de Dokompany comprend cinq stations :
>
> - **Assemblage A, B, C** — postes manuels pour le montage mécanique, le câblage et l'assemblage des trucks
> - **Emballage** — poste manuel pour le contrôle final et l'emballage des Dokoboards
> - **Presse Roulements** — machine pour presser les roulements dans les roues, avec une capacité de 4 unités simultanées

Dokos affiche en temps réel le statut de chaque station sur le plan d'atelier : disponible (vert) ou occupée (gris).

::demo-link{demo="Dokompany" doctype="Workstation"}
Voir les stations de travail dans la démo
::

## Coûts d'exploitation

Les coûts associés à une station de travail entrent directement dans le calcul du coût de revient. Dokos multiplie la durée réelle de chaque opération par les taux horaires configurés, puis ajoute ce montant au coût des matières premières consommées.

Les composantes configurables sont :

- **Main-d'œuvre** (salaires des opérateurs)
- **Électricité**
- **Loyer** (amortissement de l'espace)
- **Consommables** (huile, vis, adhésifs, etc.)

> **Exemple — Dokompany**
> Pour produire un Wheel Assembly, la Presse Roulements tourne 10 minutes. Dokos calcule automatiquement : 10 min × (0,5 + 1 + 2 + 2 €/h) = environ 0,92 € de coût opératoire pour cet assemblage.

## Planification de la capacité

La station de travail définit le nombre d'unités pouvant être traitées en parallèle (capacité de production). Lors de la soumission d'un ordre de travail, Dokos vérifie les créneaux disponibles et planifie les opérations en séquence pour éviter les conflits.

## Disponibilité des matières sans transfert explicite

Quand l'option **Ignorer le transfert de matières** est activée sur une carte de travail, Dokos vérifie la disponibilité en tenant compte à la fois des quantités déjà transférées **et** du stock déjà présent dans l'entrepôt de destination. Si le stock disponible couvre le besoin, la matière est considérée comme disponible sans qu'un transfert supplémentaire soit nécessaire.

> **Exemple — Dokompany**
> L'entrepôt de la Presse Roulements contient déjà 50 roulements en stock. La carte de travail requiert 20 roulements. Dokos détecte que le stock suffit et marque la matière comme disponible, même si aucun transfert explicite n'a été effectué depuis l'ordre de travail.

Cette logique évite les transferts redondants lorsque les stocks sont déjà positionnés au bon endroit, ce qui est courant dans les ateliers où les matières sont stockées directement au poste de travail.

## Voir aussi

- [Opération](https://doc.dokos.io/v5/dokos/production/operation)
- [Routage](https://doc.dokos.io/v5/dokos/production/routage)
- [Nomenclature](https://doc.dokos.io/v5/dokos/production/nomenclature)
- [Paramètres de production](https://doc.dokos.io/v5/dokos/production/parametres-de-production)


# Gestion de la qualité

La gestion de la qualité est l'acte de superviser toutes les activités et tâches nécessaires pour maintenir un niveau d'excellence souhaité dans les tâches. Le module Qualité de Dokos vous aide à gérer vos objectifs qualité, processus, revues, non-conformités, actions et réunions. Il est conçu pour vous aider à gérer un **système de gestion de la qualité** complet. Voici un aperçu de ce qui est inclus dans le module qualité

---

Pour accéder au module de **Qualité**, allez sur :

> Accueil > **Qualité**

![module\_qualité.png](https://doc.dokos.io/content/qualite/module_qualite.png)

## 1. Objectifs et procédures

- [1. Objectif de qualité](https://doc.dokos.io/v5/dokos/qualite/objectif-de-qualite)
- [2. Procédure de qualité](https://doc.dokos.io/v5/dokos/qualite/procedure-de-qualite)

## 2. Retours d'expérience

- [1. Retour de qualité](https://doc.dokos.io/v5/dokos/qualite/retour-experience-qualite)

## 3. Réunion

- [1. Réunion de qualité](https://doc.dokos.io/v5/dokos/qualite/reunion-de-qualite)

## 4. Revue et actions

- [1. Non-conformité](https://doc.dokos.io/v5/dokos/qualite/non-conformite)
- [2. Revue de la qualité](https://doc.dokos.io/v5/dokos/qualite/revue-de-qualite)
- [3. Action de qualité](https://doc.dokos.io/v5/dokos/qualite/action-de-qualite)


# Action de qualité

Une action qualité est prise lors d'une revue de qualité pour corriger les résultats insatisfaisants ou les empêcher de se produire.

L'action qualité est une fonctionnalité standard pour permettre la mise en œuvre d'actions correctives et préventives. Cela respectera la conformité aux réglementations de l'industrie, notamment les ISO 9001, 14001 etc..

Les flux de travail Action de qualité fournissent un environnement contrôlé et réduisent le risque de problèmes répétés en garantissant que les solutions et les processus définis sont respectés.

Les actions qualité peuvent être initialisées pour un objectif qualité ou pour un retour client qui peut ne pas répondre aux normes de qualité attendues. En fonction de cela, une action corrective ou préventive peut être lancée.

---

Pour accéder à **la liste Action de qualité**, allez sur :

> Accueil > Qualité > Revue et action > **Action de qualité**

![liste\_action\_de\_qualité.png](https://doc.dokos.io/content/qualite/quality-action/liste_action_de_qualite.png)

## 1. Prérequis avant utilisation

Avant de créer et d'utiliser une action qualité, il est conseillé de créer d'abord ce qui suit :

- **Examen de la qualité** ou **rétroaction sur la qualité**

## 2. Comment créer une action qualité

1. Allez dans la liste Action Qualité, cliquez sur **➕ Ajouter Action de qualité**.
2. Sélectionnez s'il s'agit d'une **action corrective** ou **préventive**. Cela indique si l'action est planifiée à des fins correctives ou préventives.
3. Sélectionnez la **revue de la qualité**
4. Indiquez l'**objectif**
5. Sélectiionnez le **retour de qualité** dans le champ commentaire
6. Sélectionnez la **procédure de qualité**
7. Saisissez une **résolution** proposée pour le problème dans le champ Résolution.
8. **Enregistrer**.

![détails\_action\_de\_qualité.png](https://doc.dokos.io/content/qualite/quality-action/details_action_de_qualite.png)

Le champ Statut indique si l'Action de Qualité est **Ouverte** et **en cours** ou **Fermée**.

## 3. Caractértistiques

### 3.1 Résolution

Dans la section résolution vous allez pouvoir indiquez les différents éléments pour proposer une résolution à un problème.

1. Indiquez le **problème** qui a été rencontré.
2. Indiquez une **résolution**.
3. Sélectionnez le **statut**.
4. Selectionnez le **responsable** et la **date de fin**.

![résolution.png](https://doc.dokos.io/content/qualite/quality-action/resolution.png)


# Non-conformité

Une non-conformité est une observation qui peut être déposée par toute personne dans l'organisation pour constater le non-respect d'une procédure spécifique

Une fois les procédures qualité définies, l'objectif d'une organisation axée sur la qualité est de s'assurer qu'elles sont respectées. Cela garantit une qualité et des paramètres constants selon les attentes du client. Si ces procédures ne sont pas suivies, une observation est enregistrée via une Non Conformité ou appelée NC dans les systèmes qualité.

Dans Dokos, vous pouvez créer une non-conformité en sélectionnant la procédure qualité par rapport à laquelle elle a été observée, maintenir son statut et enregistrer les actions correctives et préventives.

---

Pour accéder à **la liste Non-conformité**, allez sur :

> Accueil > Qualité > Revue et actions > **Non-conformité**

![liste\_non\_conformité.png](https://doc.dokos.io/content/qualite/non-conformance/liste_non_conformite.png)

## 1. Prérequis avant utilisation

1. **[Procédure de qualité](https://doc.dokos.io/v5/dokos/qualite/procedure-de-qualite)**

## 2. Comment créer une non-conformité ?

1. Allez dans la liste non conformité, cliquez sur **➕Ajouter Non-conformité**
2. Indiquez le sujet
3. Sélectionner la **procédure**
4. Enregistrez les **détails**
5. Enregistrer les **actions correctives** / **préventives** le cas échéant
6. État de mise à jour
7. **Enregistrer**

![détail\_non\_conformité.png](https://doc.dokos.io/content/qualite/non-conformance/detail_non_conformite.png)

## 3. Caractértistiques

### 3.1 Détails

Dans la section des détails, indiquez tous les élements nécessaire pour détailler la non-conformité.

![détails.png](https://doc.dokos.io/content/qualite/non-conformance/details.png)

### 3.2 Action corrective

Une action corrective est une action visant à éliminer une faiblesse détectée dans le système ou la cause d'une non-conformité pour éviter qu'elle ne se reproduise. L'action corrective est une action réactive

Comme une non-conformité peut avoir plusieurs causes, il est parfois nécessaire de combiner plusieurs actions afin d'éliminer la source de l'erreur.

![action\_corrective.png](https://doc.dokos.io/content/qualite/non-conformance/action_corrective.png)

### 3.3 Action préventive

Une action préventive est une action visant à éliminer une faiblesse présumée du système ou la cause d'une non-conformité potentielle ou d'une autre situation indésirable potentielle afin d'empêcher son apparition. L'action préventive est une démarche proactive de recherche d'opportunités d'améliorations.

L'objectif initial de l'action préventive est d'éviter l'apparition d'une non-conformité, mais elle comprend généralement aussi l'amélioration de l'efficacité du système. Elle peut être purement technique en améliorant le produit ou le service ou organisationnelle en améliorant le système.

![action\_préventive.png](https://doc.dokos.io/content/qualite/non-conformance/action_preventive.png)


# Objectif de qualité

Il s'agit d'un ensemble de mesures individuelles qui aident à définir vos objectifs de qualité. Il s'agit d'un processus de gestion de la qualité de base pour établir un ensemble d'objectifs de qualité.

Vous pouvez créer un objectif de qualité pour votre entreprise ayant plusieurs objectifs de qualité. Différents objectifs de qualité pour un but peuvent avoir une cible numérique définie ou une cible mesurée en termes d'état d'achèvement (oui ou non). Il est surveillé en fonction de la fréquence définie pour cet objectif.

Si vous définissez la fréquence, un document d' examen de la qualité sera créé automatiquement périodiquement où vous pouvez maintenir les mesures de performance réelles.

---

Pour accéder à **la liste des objectifs de qualité**, allez sur :

> Accueil > Qualité > **Objectif Qualité**

![liste\_objectif\_de\_qualité.png](https://doc.dokos.io/content/qualite/quality-goal/liste_objectif_de_qualite.png)

## 1. Comment créer un objectif de qualité

1. Accédez à la liste des objectifs de qualité, cliquez sur Nouveau.
2. Saisissez un nom pour l'objectif.
3. Sélectionnez une procédure de qualité à suivre pour atteindre l'objectif.
4. Créé par est la personne responsable de la création de l'objectif.
5. Entrez une fréquence de surveillance parmi **quotidienne**, **hebdomadaire**, **mensuelle** ou **trimestrielle**. Sélectionnez **Aucun** si aucune surveillance n'est nécessaire.
6. Renseignez le **tableau des objectifs**.
7. **Enregistrer**.

## 2. Caractéristiques

### 2.1 Objectifs

Dans le **tableau Objectifs**, saisissez :

1. Les objectifs qui comprennent les différents objectifs qui doivent être complétés pour atteindre un objectif de qualité.
2. La cible qui se compose de la valeur cible numérique d'un objectif à atteindre.
3. L'unité de mesure pour mesurer la cible. Ex : Prospects, Heures, etc.

![détails\_objectif\_de\_qualité.png](https://doc.dokos.io/content/qualite/quality-goal/details_objectif_de_qualite.png)

Le champ Révision indique le nombre de fois où le document a été enregistré.


# Procédure de qualité

Une Procédure de Qualité est une Procédure Opérationnelle Standard (SOP) utilisée comme référence pour effectuer des actions quotidiennes.

Une procédure opérationnelle standard (SOP) est un ensemble d'instructions étape par étape compilées par une organisation pour aider les employés à exécuter les opérations quotidienne. Les SOP visent à atteindre l'efficacité, la qualité des résultats et l'uniformité des performances tout en réduisant les problèmes de communication et le non-respect des réglementations de l'industrie.

Une **Procédure de Qualité** peut être de deux types :

- 1. Une Procédure composée d'étapes simples que vous devez suivre pour atteindre l'Objectif
- 2. Une procédure comportant des sous-procédures qui peuvent également avoir ses propres étapes.

---

Pour accéder à **la liste Procédure Qualité**, allez sur :

> Accueil > Qualité > Objectif et Procédure > **Procédure Qualité**

![liste\_procédure.png](https://doc.dokos.io/content/qualite/quality-procedure/liste_procedure.png)

## 1. Comment créer une procédure qualité

1. Allez dans la liste Procédure Qualité, cliquez sur **➕ Ajouter Procédure de qualité**.
2. Saisissez un **nom** pour la procédure qualité.
3. Dans le **tableau Processus**, saisissez Descriptions de processus.
4. **Sous-procédure** : si la procédure qualité en cours de création est une procédure parent qui contient des sous-procédures, lier la sous-procédure ici. En faisant cela, la procédure en cours devient un parent et la case à cocher **Est un groupe** est activée.
5. **Enregistrer**. Une P**rocédure de qualité** peut également être sauvegardée sans entrer les descriptions de Processus si le titre est explicite.

![détails\_procédure\_de\_qualité.png](https://doc.dokos.io/content/qualite/quality-procedure/details_procedure_de_qualite.png)

La '**Procédure Parent**' est liée à la procédure enfant. Par exemple, « Classification des problèmes » doit être effectué avant une résolution et, par conséquent, « Résolution des problèmes » est le parent ici :

## 2. Caractéristiques

### 2.1 Utilisation de la procédure qualité dans l'objectif qualité

Une fois qu'une **Procédure Qualité** est créée, elle peut être utilisée dans un **Objectif Qualité**.

![procédure\_dans\_objectif.png](https://doc.dokos.io/content/qualite/quality-procedure/procedure_dans_objectif.png)

### 2.2 Sous-procédures

Le processus peut être simplement une instruction ou une procédure de qualité différente. Vous pouvez lier une Procédure Qualité en tant que sous-procédure à une autre :

### 2.3 Vue hiérarchique

Vous pouvez également afficher les procédures qualité dans une arborescence pour une organisation et une navigation faciles.

![arbre\_.png](https://doc.dokos.io/content/qualite/quality-procedure/arbre_.png)

## Procédures avec plusieurs procédures parentes :badge{text="Dokos" type="warning"}

Dans Dokos, une procédure qualité peut être rattachée à **plusieurs procédures parentes** simultanément. Cette flexibilité permet de réutiliser une même procédure dans différents contextes sans duplication.

> **Exemple — Bureau Moderne**
> La procédure "Vérification des emballages" s'applique à la fois au processus "Réception fournisseur" et au processus "Expédition client". Dans Dokos, une seule procédure est créée et liée aux deux parents, garantissant que toute mise à jour se propage partout.

En standard dans ERPNext, chaque procédure ne peut appartenir qu'à un seul parent. Dokos supprime cette restriction pour permettre des organisations matricielles où une même étape de contrôle intervient dans plusieurs flux qualité.


# Retours de qualité

Les retours sur la qualité sont les informations qu'un client exprime sur la satisfaction ou l'insatisfaction concernant les produits ou services que vous proposez.

Les retours de qualité a différents champs pour évaluer différents paramètres. Le client/utilisateur peut facilement donner son avis en sélectionnant son modèle pour évaluer différents paramètres et également fournir un retour qualitatif sur ces paramètres.

Vous pouvez également récupérer les paramètres à l'aide d'un modèle de commentaires sur la qualité. Les modèles stockent des informations prédéfinies que vous pouvez sélectionner dans les commentaires sur la qualité.

Si le retour de qualité n'est pas conforme aux attentes, une Action Qualité pourra être initialisée sur la base de la gravité du retour de qualité.

---

Pour accéder à **la liste retour de qualité**, allez sur :

> Accueil > Qualité > Commentaires > **Retour de la qualité**

![liste\_retour\_de\_qualité.png](https://doc.dokos.io/content/qualite/quality-feedback/liste_retour_de_qualite.png)

## 1. Comment créer un retour de qualité

1. Accédez à **la liste des retours sur la qualité*&#x2A;, cliquez sur **➕ Ajouter un retour de qualité**.
2. Sélectionnez si le retour de qualité est par un client ou un utilisateur (utilisateur du compte Dokos).
3. Sélectionnez le **client** ou l'**utilisateur** en particulier.
4. La sélection d'un modèle de retour d'information sur la qualité remplira automatiquement les paramètres du retour d'information sur la qualité.
5. La **date** sera automatiquement réglée sur **la date du jour**.
6. Le tableau **Paramètres** comporte les colonnes suivantes :


   - **Paramètre** : divers paramètres prédéfinis dans le modèle de commentaires sur la qualité que vous créez.
   - **Note** : Note pour un paramètre de 1 à 5.
   - **Rétroaction** : rétroaction basée sur l'évaluation donnée.
7. **Enregistrer**.

![détails\_retour\_de\_qualité.png](https://doc.dokos.io/content/qualite/quality-feedback/details_retour_de_qualite.png)

## Modèle de retours de qualité

Pour créer le retour qualité, vous devez d'abord définir les paramètres en créant le modèle de feedback qualité. Les modèles contiennent généralement le nom du modèle, la portée et les différents paramètres à saisir. Les différents paramètres peuvent être décidés sur la base de différentes occasions et enquêtes.

---

Pour accéder à **la liste modèle de retours sur la qualité**, allez sur :

> Accueil > Qualité > **Modèle de retours sur la qualité**

![liste\_modèle\_retour\_de\_qualité.png](https://doc.dokos.io/content/qualite/quality-feedback-template/liste_modele_retour_de_qualite.png)

## 1. Comment créer un modèle de commentaires sur la qualité

1. Accédez à **la liste des modèles de commentaires sur la qualité*&#x2A;, cliquez sur **➕ Ajouter un modèle de commentaire sur la qualité**.
2. Saisissez un **nom** pour le modèle.
3. Dans le **tableau Paramètres**, répertoriez les différents processus/paramètres sur lesquels vous souhaitez que l'utilisateur évalue et donne son avis.
4. **Enregistrer**.

![détails\_modèle\_de\_retour.png](https://doc.dokos.io/content/qualite/quality-feedback-template/details_modele_de_retour.png)


# Réunion qualité

C'est une assemblée de personnes pour un objectif ou un ordre du jour particulier, en particulier pour une discussion formelle sur les aspects de la qualité.

Des réunions qualité sont organisées pour passer en revue les revues de qualité qui ont été générées. Le procès-verbal (résumé) de ces réunions inclurait la discussion sur les différentes revues de la qualité.

---

Pour accéder à **la liste Réunion de qualité**, allez sur :

> Accueil > Qualité > Réunion > **Réunion de Qualité**

![liste\_réunion\_de\_qualité.png](https://doc.dokos.io/content/qualite/quality-meeting/liste_reunion_de_qualite.png)

## 1. Comment créer une réunion de qualité

1. Allez dans la liste Réunion Qualité, cliquez sur Nouveau.
2. Entrez un agenda. Il s'agit d'une liste des activités de la réunion dans l'ordre dans lequel elles doivent être abordées.
3. Dans le tableau du compte-rendu, saisissez :


   - **Type de document** : Sélectionnez parmi Examen qualité, Action qualité ou Commentaires sur la qualité.
   - **Nom du document** : sélectionnez l'examen de la qualité, l'action et le retour d'information à discuter.

- **Minute** : documentation écrite ou enregistrée associée à l'examen.

5. **Enregistrer**.

![détails\_réunion.png](https://doc.dokos.io/content/qualite/quality-meeting/details_reunion.png)

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
**Remarque** : Le statut de la réunion peut être défini sur Fermé une fois l'ordre du jour terminé.
::


# Revue de la qualité

Une revue de qualité est un enregistrement de la performance par rapport à l'objectif de qualité à intervalles réguliers.

Une revue de la qualité est une inspection avec une structure spécifique, des rôles définis et une procédure conçue pour garantir l'exhaustivité d'un produit et le respect des normes de qualité. La revue de qualité est utilisée pour vérifier si tous les objectifs d'un objectif de qualité ont été atteints.

---

Pour accéder à **la liste d'examen de la qualité**, allez sur :

> Accueil > Qualité > Revue et actions > **Revue de la qualité**

![liste\_revue\_de\_la\_qualité.png](https://doc.dokos.io/content/qualite/quality-review/liste_revue_de_la_qualite.png)

## 1. Prérequis avant utilisation

Avant de créer et d'utiliser une revue qualité, il est conseillé de créer d'abord les éléments suivants :

- Objectif de qualité

## 2. Comment créer une évaluation de la qualité ?

1. Accédez à la liste Revue de qualité, cliquez sur **➕ Ajouter Revue de qualité**.
2. Sélectionnez un **objectif de qualité** qui doit être examiné.
3. Dans la section Révision du tableau Révisions, laissez une évaluation sur un objectif de qualité.
4. **Enregistrer**.

![détails\_notes.png](https://doc.dokos.io/content/qualite/quality-review/details_notes.png)

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
**Remarque** : Si la Procédure Qualité est liée à l'Objectif Qualité, la Procédure Qualité sera récupérée dans la Revue Qualité.
::

Vous pouvez également ajouter des notes supplémentaires dans la section **Notes**.

![notes.png](https://doc.dokos.io/content/qualite/quality-review/notes.png)

## 3. Caractéristiques

### 3.1 Création automatique périodique

Si vous avez défini la fréquence d'examen dans votre objectif de qualité, l'examen de qualité sera automatiquement créé et son statut sera défini sur **Ouvert**. Le responsable qualité peut alors vérifier les revues ouvertes et terminer l'inspection.

## 4. Après l'enregistrement

Après avoir terminé une revue qualité, vous pouvez créer une action qualité contre celle-ci si vous souhaitez enregistrer des actions correctives ou préventives.


# Introduction

Un excellent support client et une excellente maintenance sont au cœur de toute entreprise prospère. Avec Dokos, vous suivez toutes les demandes et problèmes entrants des clients et vous y répondez rapidement. La base de données des requêtes entrantes vous aidera également à identifier les plus grandes opportunités d'amélioration.

Vous pouvez suivre les requêtes entrantes à partir de votre courrier électronique à l'aide des tickets de support. Vous pouvez suivre les problèmes des clients liés à un numéro de série spécifique et y répondre en fonction de leur garantie et d'autres informations. Vous pouvez également établir des calendriers de maintenance pour les numéros de série et conserver un enregistrement de toutes les visites de maintenance effectuées auprès de vos clients.

---

Pour accéder au module **Support**, allez sur :

> Accueil > **Support**

## 1. Tickets

- [1. Ticket](https://doc.dokos.io/v5/dokos/support/ticket)
- [2. Type de ticket](https://doc.dokos.io/v5/dokos/support/ticket#type-de-ticket)
- [3. Priorité de ticket](https://doc.dokos.io/v5/dokos/support/ticket#priorit%C3%A9-de-ticket)

## 2. Entretien

- [1. Échéancier d'entretien](https://doc.dokos.io/v5/dokos/support/calendrier-de-maintenance)
- [2. Visite d'entretien](https://doc.dokos.io/v5/dokos/support/visites-de-maintenance)

## 3. Accord de niveau de service

## 4. Garantie

- [1. Réclamation de Garantie](https://doc.dokos.io/v5/dokos/support/garantie)
- [2. N° de série](https://doc.dokos.io/v5/dokos/stocks/serial-no)

## 5. Paramètres

- [1. Paramètres du support](https://doc.dokos.io/v5/dokos/support/parametres-du-support)


# Paramètres du support

Tous les paramètres généraux des documents liés à l'assistance se trouvent dans Paramètres d'assistance.

---

Pour accéder **aux paramètres du support**, allez sur :

> Accueil > Assistance > Paramètres > **Paramètres du support**

## 1. Accords de niveau de service

### 1.1 Suivi du contrat de niveau de service

Activez cette fonctionnalité pour commencer à utiliser et à suivre le contrat de niveau de service dans les problèmes.

### 1.2 Autoriser la réinitialisation du contrat de niveau de service

Cela permet à un utilisateur de réinitialiser l'accord de niveau de service dans les problèmes. L'utilisateur obtiendra un bouton pour réinitialiser l'accord de niveau de service pour les problèmes en cours dans l'onglet Niveau de service. Cliquer sur le bouton avant l'échec de l' ANS réinitialisera l'ANS. L'utilisateur de l'équipe d'assistance devra indiquer la raison de la réinitialisation de l'ANS.

![ans.png](https://doc.dokos.io/content/support/support-settings/ans.png)

## 2. Ticket

### 2.1 Nombre de jours avant de fermer le ticket

Tout ticket **Répondu** ou **Résolu** sera fermé après le nombre de jours défini dans ce champ. Cependant, si le client répond à un problème fermé, le problème s'ouvrira à nouveau.

## 3. Portail du support

### 3.1 Section d'aide

Rensiegnez dans cette section les informations d'aide pour le portail du support.

### 3.2 Afficher les derniers messages du forum

- URL du forum
- Obtenir la dernière requête
- Liste des clés de réponse
- Clé du titre du message
- Clé de description du message
- Clé du lien du message
- Chaîne de caractères du lien du message

### 3.3 Section de bienvenue

- Titre de bienvenue
- Sous-titre de bienvenue


# Ticket

Un ticket est une requête entrante d'un client, généralement par e-mail ou à partir de la section Contact de votre site Web.

**Astuce** : Une adresse e-mail dédiée à l'assistance est un bon moyen de suivre les requêtes entrantes. Par exemple, vous pouvez envoyer des demandes d'assistance à Dokos à <support@dokos.io> et cela créera automatiquement un problème dans notre système.

---

Pour accéder **à la liste des tickets**, allez sur :

> Accueil > Support > Tickets > **Ticket**

## 1. Prérequis avant utilisation

Avant de créer et d'utiliser des problèmes, il est conseillé de créer d'abord les éléments suivants :

- **[Client](https://doc.dokos.io/v5/dokos/parametrage/clients)**
- **Compte email**

## 2. Comment créer un ticket ?

Les tickets sont automatiquement créés si vous utilisez la fonction Ajouter à dans Compte de messagerie.

Vous pouvez également créer un ticket manuellement, pour ce faire :

1. Accédez à la liste des tickets, cliquez sur **➕ Ajouter Ticket**.
2. Saisissez l'**objet**, soulevé par et une **description** du ticket.

### 2.1 Options supplémentaires lors de la création d'un ticket

- **Sujet** : Indiquez le nom du sujet
- **Statut** : Lorsqu'un nouveau problème est créé, son statut sera « Ouvert », lorsqu'il reçoit une réponse, son statut devient « Répondu ».


  - **Ouvert** : le problème a été créé et n'a pas encore reçu de réponse.
  - **Répondu** : une réponse a été envoyée au problème.
  - **En attente** : le problème est en attente pour une raison quelconque.
  - **Résolu** : lorsque les utilisateurs sont raisonnablement sûrs d'avoir fourni au client une solution à leur problème mais n'ont pas reçu d'accusé de réception de la résolution du client.
  - **Fermé** : le client a obtenu une résolution satisfaisante qu'il a indiquée avec un accusé de réception et le problème a été clôturé.

Si l'expéditeur répond au fil de discussion, le statut redevient « Ouvrir ». L'utilisateur peut "fermer" le ticket manuellement en cliquant sur le bouton Fermer en haut à droite.

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
**Remarque** : Si le SLA a été configuré, le statut d'exécution du SLA sera mis à jour à la fois pour le statut Fermé et Résolu .
::

- **Client** : Si l'email a été envoyé depuis un Client stocké dans votre compte Dokos, alors un lien Client apparaîtra dans ce champ.
- **Priorité** : La priorité peut être définie selon les exigences. Par défaut, il existe trois priorités : faible, moyenne et élevée. Vous pouvez les supprimer ou en ajouter d'autres si nécessaire.
- **Type de problème** : un problème peut être classé à l'aide du type de problème. Des exemples de types de problèmes peuvent être : « Fonctionnel », « Technique », « Matériel », etc.
- **Élevé par (e-mail)** : l'identifiant de l'e-mail à partir duquel le problème a été envoyé sera affiché ici.

## 3. Caractéristiques

### 3.1 Détails

- **Description** : Il s'agit d'un champ de texte dans lequel les détails du problème peuvent être consultés. Celui-ci peut également contenir une image ou un tableau.

### 3.2 Accord de niveau de service

C'est un contrat entre un fournisseur de services et l'utilisateur final qui définit le niveau de service attendu du fournisseur de services.

L'utilisateur peut sélectionner le Service Level Agreement (SLA) dans la liste.

Chaque problème aura un délai de réponse et un délai de résolution pendant lesquels l'équipe d'assistance doit répondre et résoudre le problème.
La priorité peut être modifiée pour escalader le problème. Les priorités doivent être spécifiées dans le Service Level Agreement.
Si nécessaire, l'accord de niveau de service peut être réinitialisé en cliquant sur le bouton Réinitialiser l'accord de niveau de service dans les problèmes indiqués comme suit :

- Support
- Publier
- SLA

### 3.3 Détails de la Réponse

**Mins to First Response** : temps en minutes entre la création du ticket et l'envoi de la première réponse.

**Première réponse le** : lorsqu'un membre de l'équipe d'assistance répond pour la première fois au ticket, la date et l'heure de la première réponse sont mises à jour.

**Temps de réponse moyen** : Le temps moyen mis pour répondre au Client. Ceci est calculé en prenant la moyenne de tous les intervalles de temps entre les communications reçues et envoyées. Ce champ sera mis à jour à chaque réponse envoyée au client.

### 3.4 Détails de la Résolution

- **Date d'ouverture** : Lorsque le ticket est créé ou enregistré, la date est publiée.
- **Heure d'ouverture** : Lorsque le ticket est créé ou enregistré, l'heure exacte sera automatiquement affichée.
- **Date de résolution** : lorsque l'utilisateur a résolu le ticket, la date et l'heure seront mises à jour dans ce champ.
- **Détails de la résolution** : l'utilisateur peut saisir les détails du ticket, une fois celui-ci résolu. Ceci est un champ de texte. En outre, l'utilisateur peut télécharger l'image, entrer ou créer un tableau.
- **Temps de résolution** : Temps total pris pour fermer le ticket (de la création du ticket à la clôture).
- **Temps de résolution de l'utilisateur** : plusieurs fois, un utilisateur doit attendre la réponse d'un client afin de résoudre un ticket. Lors de la mesure de la productivité de l'utilisateur, ce temps d'attente ne doit pas être pris en compte. Par conséquent, le temps de résolution de l'utilisateur est le temps total pris par un utilisateur pour fermer le ticket et peut être calculé comme suit :

Temps de résolution - Temps total pendant lequel l'utilisateur a dû attendre la réponse d'un client

Les mesures du temps de résolution et du temps de résolution de l'utilisateur sont définies sur « Fermer ». Ces métriques se réinitialisent automatiquement lorsque le ticket se rouvre ou se divise.

**Via le portail client**
Si le Client ayant soulevé le ticket est un Utilisateur du Site Internet (pas d'accès aux modules), cette case sera cochée pour l'indiquer.

### 3.5 Référence

L'utilisateur peut filtrer les tickets en fonction de ces champs liés au ticket :

- Conduire
- Contacter
- Compte email
- Projet
- Compagnie

## 4. Après l'enregistrement

### 4.1 Ajouter des commentaires

Une fois le ticket enregistré, les utilisateurs de l'équipe d'assistance peuvent ajouter des commentaires sur le ticker. Ce champ est modifiable. Les commentaires dans les problèmes sont destinés aux discussions internes et ne seront pas visibles par les clients.

### 4.2 Nouveau courriel

Les utilisateurs peuvent composer un e-mail à la personne qui a soulevé le ticket. Tous les e-mails (reçus et envoyés) peuvent être consultés dans un fil de discussion dans le numéro.

### 4.3 Fil de discussion

Le fil de discussion par e-mail dans un ticket conserve tous les e-mails qui sont envoyés dans le système pour ce ticket afin que vous puissiez suivre ce qui s'est passé entre l'expéditeur et la personne qui répond.

Lorsqu'un nouvel e-mail est envoyé depuis votre boîte aux lettres, une réponse automatique est envoyée à l'expéditeur avec votre message et le numéro de ticket de support.
L'expéditeur peut envoyer des informations supplémentaires à cet e-mail.
Tous les e-mails suivants contenant ce numéro de ticket dans l'objet seront ajoutés à ce fil de discussion.
L'expéditeur peut également ajouter des pièces jointes à l'e-mail.

### 4.4 Attribution des tickets aux utilisateurs

Les tickets peuvent être attribués automatiquement parmi les utilisateurs à l'aide de la règle d'attribution .

Vous pouvez attribuer un ticket à un utilisateur spécifique en cliquant sur la fonction « Attribuer » dans la barre latérale gauche. Cela ajoutera une nouvelle tâche à l'utilisateur et enverra également un message indiquant que ce problème est attribué.

### 4.5 Fermer le ticket

Vous pouvez fermer le ticket manuellement en cliquant sur « Fermer » dans la barre d'outils.
Si l'expéditeur ne répond pas dans les 7 jours, le ticket est fermé automatiquement.

## Type de ticket

Le type de ticket est utile pour marquer et classer les tickets.

La classification des tickets aide à affecter les membres de l'équipe concernés à des problèmes spécifiques. Des exemples de types de tickets peuvent être : « Fonctionnel », « Technique », « Matériel », etc. Ainsi, les ingénieurs peuvent être affectés à des problèmes techniques ou matériels et des consultants seraient affectés à des problèmes fonctionnels.

---

Pour accéder à **la liste des types de ticket**, allez sur :

> Accueil > Support > Tickets > **Type de ticket**

## 1. Comment créer un type de ticket ?

1. Pour créer un type de ticket, cliquez sur **➕ Ajouter Type de ticket**.
2. Saisissez un **nom** pour le type.
3. Une **description** peut être ajoutée.
4. **Enregistrer**

## Priorité de ticket

La priorité du ticket indique l'urgence de résoudre un problème.

L'utilisateur peut créer des priorités telles que "Haut", "Moyen", "Faible", "Critique", etc. La priorité de problème sera utilisée lors de la création de l' accord de niveau de service.

---

Pour accéder à **la liste Priorité des problèmes**, allez sur :

> Accueil > Support > Ticket > **Priorité du ticket**

## 1. Comment créer une Priorité de ticket ?

1. Pour créer une priorité de ticket, cliquez sur **➕ Ajouter Priorité de ticket**.
2. Entrez un **nom** pour le type.
3. Une **description** peut être ajoutée.
4. **Enregistrer**


# Échéancier d'entretien

Le calendrier de maintenance affiche toutes les visites de maintenance à venir.

Toutes les machines nécessitent un entretien régulier, en particulier celles qui contiennent beaucoup de pièces mobiles, donc si vous êtes en train de les entretenir ou en avez certaines dans vos propres locaux, c'est un outil utile pour planifier un calendrier d'activités pour son entretien.

---

Pour accéder à **la liste échéancier d'entretien**, allez sur :

> Accueil > Support > Maintenance > **Échéancier d'Entretien**

L'échéancier d'Entretien est généralement créé à partir d'une commande client de type **Maintenance**.

## 1. Prérequis avant utilisation

- **[Client](https://doc.dokos.io/v5/dokos/parametrage/clients)**
- **[Article](https://doc.dokos.io/v5/dokos/parametrage/articles)**

## 2. Comment créer un programme de maintenance

1. Accédez au calendrier de maintenance, cliquez sur **➕ Ajouter Échéancier d'entretien**.
2. Sélectionnez le **Client** et les **Articles** pour lesquels la maintenance doit être effectuée.
3. Définissez les **dates de début** et de **fin**.
4. Sélectionnez une **périodicité** pour définir la fréquence des visites. Les options sont Hebdomadaire, Mensuel, Trimestriel, Semestriel, Annuel et Aléatoire. Le programme de maintenance sera généré en fonction de la périodicité sélectionnée. La sélection de Random générera des dates aléatoires
5. Le **nombre de visites** sera défini selon la périodicité sélectionnée. Ex : Si vous sélectionnez Hebdomadaire et définissez le mois entier entre le début et les dates, 4 visites sont idéales.
6. Sélectionnez le **commercial** effectuant les visites.
7. **Enregistrer**.

## 3. Caractéristiques

### 3.1 Articles

Dans cette section, vous pouvez ajouter les articles qui seront concernés par l'échéancier d'entretien. Les différents champs ci-dessous seront à renseigner :

- **Code de l'article**
- **Nom de l'article**
- **Date de début**
- **Date de fin**
- **Périodicité**

## 4. Après l'enregistrement

Après avoir enregistré, cliquez sur le bouton **Générer un calendrier** pour générer un échéancier de maintenance. Puis valider.

Le bouton **Générer une planification** générera une ligne distincte pour chaque activité de maintenance. Chaque élément d'un programme de maintenance est attribué à un vendeur.

Lorsque le document est soumis, des événements de calendrier sont créés pour l'utilisateur commercial pour chaque maintenance.


# Réclamation de garantie

Une réclamation de garantie est une réclamation d'un client pour obtenir des réparations gratuites pendant la période de garantie de l'article/service que vous fournissez.

Si vous vendez des articles sous garantie ou si vous avez vendu un contrat de service prolongé tel que le contrat de maintenance annuel (AMC), votre client peut vous contacter à propos d'un problème ou d'une panne du produit et vous fournir le numéro de série de cet article.

---

Pour accéder à la liste des réclamations de garantie, allez sur :

> Accueil > Support > Garantie > Réclamation de garantie

## 1. Prérequis avant utilisation

Avant de créer et d'utiliser une réclamation de garantie, il est conseillé de créer d'abord les éléments suivants :

- **Client**
- **Numéro de série**
- **Article**

## 2. Comment créer une réclamation de garantie ?

1. Accédez à la liste des réclamations sous garantie, cliquez sur **➕ Ajouter Réclamation de garantie**.
2. Sélectionnez un **client**.
3. Sélectionnez le **numéro de série de l'article** sur lequel la réclamation de garantie doit être enregistrée. Le système récupérera alors automatiquement les détails du numéro de série et indiquera s'il est sous garantie ou AMC.
4. Saisissez une **description du ticket**. L'utilisateur peut télécharger et imager et créer une table.
5. **Enregistrer**.

### 2.1 Options supplémentaires lors de la création d'une demande de garantie

- **Statut** : Lors de la création d'une réclamation de garantie, le statut sera défini comme "Ouvert". L'utilisateur peut changer le statut en :
- **Travail en cours** : des correctifs/réparations sont en cours sur l'article.
- **Fermé** : les réparations ont été effectuées et la demande de garantie est maintenant fermée.
- **Annulé** : La réclamation de garantie n'était pas valide et la réclamation a été fermée.
- **Date d'émission** : lors de la création de la demande de garantie, la date actuelle sera capturée. Ce champ est modifiable.

## 3 Caractéristiques

### 3.1 Détails de l'article et de la garantie :

Une fois qu'un numéro de série est sélectionné, les détails suivants sur l'article seront récupérés :

- **Code de l'article**
- **Nom de l'article**
- **Description de l'article**

Les détails sur la garantie/AMC seront récupérés en fonction du numéro de série.

État de la garantie / AMC : Les options possibles sont **Sous garantie**, **Hors garantie**, **Sous AMC** ou **Sur AMC**. Le statut peut être modifié en Hors garantie/AMC si l'article a été falsifié ou si la garantie est annulée en fonction de vos conditions de service.

- Date d'expiration de la garantie
- Date d'expiration de l'AMC

### 3.2 Résolution

- **Date de résolution** : lorsque la garantie ou l'AMC est fermé, la date et l'heure actuelles seront récupérées automatiquement dans le champ Date de résolution. Ce champ est également modifiable.
- **Résolu par** : définissez l'identifiant de messagerie de l'utilisateur qui a résolu la réclamation au titre de la garantie. L'ID de courrier électronique est lié à l' utilisateur créé dans le système.
- **Détails résolus** : il s'agit d'un champ de texte. L'utilisateur peut entrer des détails sur la garantie ou la réclamation AMC. Un utilisateur peut également télécharger l'image, saisir ou créer un tableau.

### 3.3 Détails du client

Les informations suivantes concernant le Client seront récupérées :

- Nom du client
- Personne de contact
- Territoire
- Groupe de clients
- Adresses des clients
- Adresse de service : l' utilisateur peut saisir l'adresse de service si elle est différente de l'adresse du client.

### 3.4 Plus d'informations

- **Entreprise** : La garantie ou l'AMC créée à partir de l'entreprise sera sélectionnée automatiquement.
- **Élevé par** : l' utilisateur peut saisir le nom de la personne qui a déclenché la garantie ou l'AMC dans le cas où le client est une organisation.
- **De la société** : l' utilisateur peut saisir le nom de la société à partir de laquelle la garantie ou l'AMC a été créée.

Si une visite client est nécessaire pour résoudre le problème, vous pouvez créer un nouvel enregistrement de visite de maintenance à partir de celui-ci.


# Visite d'entretien

Une Visite de Maintenance est une visite effectuée par un ingénieur dans les locaux d'un Client pour des travaux de maintenance d'un Article.

---

Pour accéder à **la liste des visites d'entretien**, rendez-vous sur :

> Accueil > Support > Entretien > **Visite de maintenance**

![liste\_maintenance.png](https://doc.dokos.io/content/support/maintenance-visit/liste_maintenance.png)

Une visite de maintenance est généralement créée à partir d'une commande client de type **Entretien**.

## 1. Prérequis avant utilisation

- **[Client](https://doc.dokos.io/v5/dokos/parametrage/clients)**
- **[Article](https://doc.dokos.io/v5/dokos/parametrage/articles)**

## 2. Comment créer une visite d'entretien ?

1. Allez dans la liste Visite de maintenance, cliquez sur **➕ Ajouter Visite d'entretien**.
2. La date et l'heure actuelles seront enregistrées, elles peuvent être modifiées.
3. Sélectionnez le **client**.
4. Sélectionnez le **type d'entretien**, qu'il soit planifié, non planifié ou en panne.
5. Définissez l'état d'achèvement, qu'il soit **Partiellement terminé** ou **Complètement terminé**.
6. Sélectionnez le code article et le numéro de série.
7. Saisissez une description de la maintenance, sélectionnez le commercial effectuant la maintenance et saisissez le travail effectué.
8. **Enregistrer**.

![détails\_maintenance.png](https://doc.dokos.io/content/support/maintenance-visit/details_maintenance.png)

## 3. Caractéristiques

### 3.1 Objets

Dans le tableau des objets vous pouvez indiquer les articles qui seront concernés par la visite d'entretien et de renseigner une description.

Remplissez les différents champs :

- **Nom de l'article**
- **Description**
- **Vendeur**

### 3.2 Informations additionnelles

**Retour d'expérience client** : Vous pouvez enregistrer tout commentaire donné par le Client concernant cette Visite de Maintenance.

Les champs suivants seront extraits du formulaire Client :

- **Adresse du client**
- **Personne de contact**
- **Territoire**
- **Groupe de clients**


# Bienvenue

HRMS est une application ajoutant des fonctionnalités de gestion RH à Dokos.\:br Vous pouvez l'installer en suivant les instructions disponibles sur le [répertoire de l'application](https://gitlab.com/dokos/hrms){rel="&#x22;nofollow&#x22;"}\:br Cette application est installée par défaut sur tous les sites du Cloud Dokos et dans les images Docker de Dokos.

::callout{color="amber"}
L'application HRMS est une adaptation de l'application Frappe HR par [Frappe Technologies](https://github.com/frappe/hrms){rel=""nofollow""}
::

Les principales fonctionnalités du module HRMS

::card-group
  :::card
  ---
  icon: i-clarity-employee-solid
  title: Cycle de vie des employés
  to: https://doc.dokos.io/v5/dokos/hrms/cycle-de-vie
  ---
  Créez vos employés et votre structure organisationnelle et suivez le cycle de vie de vos collaborateurs
  :::

  :::card
  ---
  icon: i-fontisto-holiday-village
  title: Congés
  to: https://doc.dokos.io/v5/dokos/hrms/conges
  ---
  Gérez les allocations et demandes de congés de vos employés
  :::

  :::card
  ---
  icon: i-fluent-shifts-activity-24-filled
  title: Gestion des quarts et présences
  to: https://doc.dokos.io/v5/dokos/hrms/quarts-et-presences
  ---
  Gérez les présences et les allocations de quart de vos employés
  :::

  :::card
  ---
  icon: i-ic-outline-payments
  title: Gestion de la paie
  to: https://doc.dokos.io/v5/dokos/hrms/paie
  ---
  Gérez la paie de votre organisation\:br\_Ce module n'est pas encore adapté à la France\_
  :::
::


# Application mobile RH

## 1. Les fonctionnalités incluent

- **Check-In** : Permet à l'utilisateur d'enregistrer son arrivée au travail.
- **Liens rapides** : Accès direct pour soumettre une feuille de temps, demander un congé ou déclarer une nouvelle dépense.
- **Navigation** : Barre d'outils en bas de l'écran pour accéder à l'accueil, congés, dépenses et heures travaillées.

L'application (qui est une PWA -Progressive web app) est accessible depuis un navigateur basé sur chromium (Google Chrome, Brave, Microsft Edge, etc.) en ajoutant /hrms derrière le lien d'accès au bureau (par exemple : <https://monsite.dokos.cloud/hrms>{rel="&#x22;nofollow&#x22;"}).
Les utilisateurs doivent être déclaré en tant qu'employé dans le module ressource humaine pour pouvoir accéder à l'application web.

## 2. Page d'accueil

Accédez facilement à des options telles que la saisie d'une feuille de temps, la demande de congé ou la déclaration d'une dépense.

Vous pouvez consulter un aperçu de l'état actuel de vos demandes de congés, ainsi que celles des employés dont vous êtes responsable de l'approbation.

Enfin, vous avez la possibilité d'accéder aux autres fonctionnalités de l'application.

## 3. Congés et jours fériés

Dans l'onglet "Congés", vous pouvez accéder à l'historique de vos demandes ainsi qu'à celui des employés pour lesquels vous avez des droits de visualisation ou d'approbation.

Vous avez également la possibilité de consulter les jours fériés à venir.

### 3.1. Demander un congés

## 4. Approbateur de congés

### 4.1. Traitement rapide des demandes.

Lorsqu'un employé dont vous êtes l'approbateur soumet une demande de congé, celle-ci apparaît sur l'écran d'accueil de l'application, dans la section de visualisation rapide.

Vous avez la possibilité de la rejeter ou l'approuver rapidement depuis cette section.

![Cette image permet de visualiser la demande de congés dans l'accueil de l'application.](https://doc.dokos.io/demande-de-conges-appli.png)

### 4.2. Traitement en détail

En accédant à l'historique des congés, vous pouvez consulter la demande de congé de l'employé et l'examiner en détail avant de l'approuver ou de la rejeter.

![Cette image permet de visualiser une fiche de demande de congés pour rejeter ou approuver la demande de congé.](https://doc.dokos.io/fenetrepourapprobationdemandedecongesappli.png)

## 5. Dépenses

Vous pouvez créer une dépense directement depuis l'application mobile. Ainsi, vous enregistrez vos dépenses depuis votre téléphone, puis vous pouvez créer des notes de frais ultérieurement depuis l'interface de bureau de Dokos.

## 6. Heures

Depuis l'onglet "Heure", vous pouvez accéder à un QR code flash pour ajouter rapidement vos heures de travail ou procéder à une saisie manuelle, également disponible.

Dans cette saisie manuelle, vous pouvez détailler la durée et le projet associé, le cas échéant, afin de permettre une analyse des coûts du projet.

Il est également possible d'ajouter une équipe de travail ou des employés individuellement.

## 7. Gestion du mot de passe

### 7.1. Mot de passe oublié

Si vous avez oublié votre mot de passe, vous pouvez en demander la réinitialisation directement depuis l'écran de connexion de l'application mobile.

1. Sur l'écran de connexion, appuyez sur le lien &#x2A;*Mot de passe oublié ?**.
2. Saisissez votre adresse e-mail.
3. Appuyez sur **Envoyer** : un lien de réinitialisation vous sera transmis par e-mail.
4. Suivez le lien reçu pour définir un nouveau mot de passe.

::callout{icon="i-mdi-information-outline"}
Vérifiez votre dossier spam si vous ne recevez pas l'e-mail dans les minutes qui suivent.
::

### 7.2. Changer son mot de passe

Une fois connecté, vous pouvez modifier votre mot de passe directement depuis vos paramètres de profil.

1. Depuis l'application, accédez à votre **Profil** (icône en bas à droite).
2. Appuyez sur **Paramètres**, puis sur **Changer le mot de passe**.
3. Saisissez votre nouveau mot de passe, puis confirmez-le dans le champ dédié.
4. Appuyez sur **Enregistrer** pour valider la modification.

::callout{icon="i-mdi-shield-key-outline"}
Choisissez un mot de passe robuste, composé d'au moins 8 caractères, en mélangeant lettres, chiffres et caractères spéciaux.
::


# Paie

Cette application ne présente aucune différence avec Frappe HR. :br
Nous ne conseillons pas son utilisation en France.

---

## 1. Paie

- [1. Composante salariale](https://doc.dokos.io/v5/dokos/hrms/paie/salary-component)
- [2. Grille des salaires](https://doc.dokos.io/v5/dokos/hrms/paie/salary-structure)
- [3. Entrée de la paie](https://doc.dokos.io/v5/dokos/hrms/paie/payroll-entry)
- [4. Attribution de la structure salariale](https://doc.dokos.io/v5/dokos/hrms/paie/salary-structure-assignment)
- [5. Fiche de paie](https://doc.dokos.io/v5/dokos/hrms/paie/salary-slip)

## 2. Taxation

- [1. Période de paie](https://doc.dokos.io/v5/dokos/hrms/paie/payroll-period)
- [2. Tranche d'impôt sur le revenu](https://doc.dokos.io/v5/dokos/hrms/paie/income-tax-slab)
- [3. Autres revenus de l'employé](https://doc.dokos.io/v5/dokos/hrms/paie/employee-other-income)
- [4. Déclaration d'exemption de taxe](https://doc.dokos.io/v5/dokos/hrms/paie/employee-tax-exemption-declaration)
- [5. Soumission d'une preuve d'exemption de taxe](https://doc.dokos.io/v5/dokos/hrms/paie/employee-tax-exemption-proof-submission)

## 3. Indemnités

- [1. Salaire supplémentaire](https://doc.dokos.io/v5/dokos/hrms/paie/additional-salary)
- [2. Prime de fidélisation](https://doc.dokos.io/v5/dokos/hrms/paie/retention-bonus)
- [3. Intéressement des employés](https://doc.dokos.io/v5/dokos/hrms/paie/employee-incentive)
- [4. Demande d'avantages sociaux](https://doc.dokos.io/v5/dokos/hrms/paie/employee-benefit-application)
- [5. Requête d'avantages sociaux](https://doc.dokos.io/v5/dokos/hrms/paie/employee-benefit-claim)

## 4. Paramètres

- [1. Paramètres de Paie](https://doc.dokos.io/v5/dokos/hrms/paie/payroll-settings)


# Salaire supplémentaire

Le salaire supplémentaire est quelque chose qu'un employé reçoit de l'entreprise pour laquelle il travaille, autre que son salaire habituel.

Dokos vous propose une fonctionnalité appelée **Salaire supplémentaire** pour ajouter ou déduire le salaire supplémentaire d'un employé particulier lors du traitement de la paie. Quelques exemples de salaire supplémentaire pourraient être une prime de performance, une allocation de délégation, des arriérés, des incitations ou d'autres ajustements.

---

Pour accéder à **la liste salaire supplémentaire**, allez sur :

> Accueil > Paie > **Salaire supplémentaire**

![liste\_salaire\_supp.png](https://doc.dokos.io/content/payroll/additional-salary/liste_salaire_supp.png)

## 1. Prérequis avant utilisation

Avant de créer un salaire supplémentaire, il est conseillé de créer les éléments suivants :

- **[Employé](https://doc.dokos.io/v5/dokos/hrms/cycle-de-vie/employee)**
- **[Composante salariale](https://doc.dokos.io/v5/dokos/hrms/paie/salary-component)**

## 2. Comment créer un salaire supplémentaire

1. Accédez à la liste des **salaires supplémentaires*&#x2A;, cliquez sur **➕ Ajouter Salaire supplémentaire**.
2. Sélectionnez **Employé**.
3. Sélectionnez **Composante salariale**.
4. Entrez le **montant**.
5. Entrez la **date de paie**. Si la date de paie pour le salaire supplémentaire se situe dans l'intervalle lorsque le salaire est traité, elle sera ajoutée aux gains/retenues.
6. **Enregistrer** et envoyer.
7. Cochez la case **Remplacer le montant de la structure salariale** pour écraser la composante du salaire supplémentaire sur le montant de la structure salariale. De plus, la case à cocher « Déduire la totalité de l'impôt à la date de paie sélectionnée » peut être cochée si la totalité de l'impôt doit être déduite sur la composante du salaire supplémentaire pour cette date de paie particulière.

![détails\_salaire\_supp.png](https://doc.dokos.io/content/payroll/additional-salary/details_salaire_supp.png)

## 3.Caractéristiques

### 3.1 Salaire supplémentaire récurrent

Cette fonctionnalité permet aux utilisateurs de créer un salaire supplémentaire pour un intervalle fixe.

Lorsque **Récurrent** est coché, vous devez remplir **Date de début** et **Date de fin**. Cela ajoutera ou déduira le montant du salaire supplémentaire pour cet employé dans la plage de dates sélectionnée et cela sera reflété dans le bulletin de salaire de l'employé. Le salaire supplémentaire sera répété chaque mois entre l'intervalle renseigné.

![récurrent\_salaire\_supp.png](https://doc.dokos.io/content/payroll/additional-salary/recurrent_salaire_supp.png)


# Avance versée aux employés

Parfois, les employés doivent effectuer un déplacement professionnel (Salon, rendez-vous client etc.) et l'entreprise paie un certain montant pour leurs dépenses à l'avance. C'est à ce moment que l'employé peut créer un formulaire d'avance d'employé où des détails tels que l'objet de la dépense et le montant de la dépense peuvent être enregistrés.

Une fois l'avance de l'employé créée par l'employé, l'approbateur des dépenses peut soumettre l'enregistrement de l'avance après vérification. Une fois que l'avance de l'employé est soumise, le comptable libère le paiement et effectue l'entrée de paiement.

---

Pour accéder à la **liste avance des employés**, allez sur :

**Ressources humaines > Notes de frais > Avance d'employé**

## 1. Prérequis avant utilisation

- **[Employé](https://doc.dokos.io/v5/dokos/hrms/cycle-de-vie/employee)**
- **[Département](https://doc.dokos.io/v5/dokos/hrms/parametrage/departement)**
- **Plan comptable**
- **Compte d'avance** (configuré dans le plan comptable)

## 2. Comment créer une avance d'employé

1. Allez sur la liste **Avance des employés*&#x2A;, cliquez sur **➕ Ajouter Avance versée aux employés**.
2. Sélectionnez l'**Employé** à qui vous devez donner l'avance.
3. Saisissez l'**objet** et le **montant de l'avance**.
4. Sélectionnez le **compte d'avance** et le **mode de paiement**.
5. **Enregistrer**.

![liste\_avance\_aux\_employés.png](https://doc.dokos.io/content/rh/employee-advance/liste_avance_aux_employes.png)

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
**Remarque** : L'employé peut uniquement sauvegarder l'avance de l'employé, mais ne peut pas la soumettre. Il ne peut être soumis que par l'approbateur des dépenses.
::

## 3. Caractéristiques

### 3.1 Enregistrement d'avance de l'employé

L'enregistrement d'avance d'employé peut être créé par n'importe quel employé, mais il ne peut pas soumettre l'enregistrement.

Après avoir enregistré l'avance de l'employé, l'employé doit affecter le document à l'approbateur. Lors de l'affectation, l'utilisateur approbateur recevra également une notification par e-mail. Pour automatiser la notification par e-mail, vous pouvez également configurer l'[alerte par e-mail](https://doc.dokos.io/v5/dodock/fonctionnalites/notifications).

Après vérification, l'approbateur des dépenses peut soumettre (accepter) le formulaire d'avance de l'employé ou rejeter la demande.

### 3.2 Effectuer la saisie du paiement

**Avance d'employé via l'entrée de paiement**

Après la validation de l'enregistrement d'avance de l'employé, l'utilisateur du compte pourra créer une entrée de paiement à l'aide du bouton **Créer**.

L'entrée de paiement ressemblera à ce qui suit :

![écriture\_de\_paiement.png](https://doc.dokos.io/content/rh/employee-advance/ecriture_de_paiement.png)

**Paiement anticipé des employés par écriture au journal**

Alternativement, une écriture de journal peut également être créée contre l'avance de l'employé.

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
**Remarque** : Assurez-vous que le type de partie est sélectionné comme employé et que le type de référence est sélectionné comme avance d'employé.
::

**L'avance des employés est payée**

Lors de la soumission de l'entrée de paiement/entrée de journal, le montant payé et le statut seront mis à jour dans l'enregistrement d'avance de l'employé.

### 3.3 Ajuster les avances sur note de frais

Plus tard, lorsque l'employé réclame la dépense, un enregistrement d'avance peut être récupéré dans la note de frais et lié à l'enregistrement de la réclamation.

### 3.4 Montant du retour

Lorsqu'une avance est versée à un Salarié, il existe trois situations :

- Le montant peut être inutilisé
- Tout peut être utilisé
- Certaines parties peuvent être utilisées

Créez l'Avance d'employé, créez une écriture de paiement pour indiquer que le montant est payé.

- Si le montant n'est pas utilisé, cliquez sur le bouton **Retour** pour retourner le montant de l'avance payé
- Si toute l'avance est utilisée, cela se reflétera dans le champ **Montant réclamé**
- Si seulement un certain montant est réclamé et que le reste est retourné, le montant retourné sera affiché dans le champ **Montant retourné**.

## 4. Suivi du statut d'une avance

Chaque avance versée à un employé passe par plusieurs statuts qui reflètent son avancement dans le cycle de vie. Ces statuts sont mis à jour automatiquement par Dokos au fil des actions comptables.

::mermaid
flowchart LR
A(\[Brouillon]) --> B(\[En attente d'approbation])
B --> C(\[Payée])
C --> D(\[Partiellement payée])
C --> E(\[Réclamée])
D --> E
D --> C
E --> F(\[Remboursée])
style A fill:#e0e0e0
style B fill:#fff3cd
style C fill:#d4edda
style D fill:#fde8c8
style E fill:#cce5ff
style F fill:#d4edda

::

| Statut                       | Signification                                                                                                            |
| ---------------------------- | ------------------------------------------------------------------------------------------------------------------------ |
| **Brouillon**                | L'avance a été créée mais n'est pas encore soumise à l'approbateur.                                                      |
| **En attente d'approbation** | L'avance est soumise et attend la validation de l'approbateur des dépenses.                                              |
| **Payée**                    | Le montant de l'avance a été entièrement décaissé à l'employé (via une écriture de paiement ou une écriture de journal). |
| **Partiellement payée**      | Une partie du montant a été versée à l'employé, mais un solde reste encore à décaisser ou à récupérer.                   |
| **Réclamée**                 | L'employé a soumis une note de frais couvrant tout ou partie de l'avance.                                                |
| **Remboursée**               | Le montant non utilisé a été restitué à l'entreprise.                                                                    |

### Passage automatique à « Partiellement payée »

Lorsqu'une écriture de paiement ou une écriture de journal ne couvre qu'une partie du montant de l'avance initialement approuvée, Dokos bascule automatiquement le statut en **Partiellement payée**. Le champ **Montant en attente** indique la somme restant à régulariser.

**Exemple** : l'employé Jean Dupont demande une avance de 500 €. Le comptable effectue un premier paiement de 300 €. L'avance passe en « Partiellement payée » avec un montant en attente de 200 €. Lorsque le second versement de 200 € est enregistré, le statut repasse à « Payée ».

### Remboursement via retenue sur salaire

Dokos offre une option permettant de récupérer le montant non utilisé d'une avance directement sur la fiche de paie de l'employé, sans nécessiter d'écriture de remboursement manuelle.

Pour activer ce mode de remboursement :

1. Ouvrez l'avance de l'employé concernée.
2. Cochez l'option **Rembourser le montant non réclamé sur le salaire**.
3. Lors du calcul de la prochaine fiche de paie, Dokos déduira automatiquement le solde non utilisé.

::callout{color="blue" icon="i-heroicons-light-bulb"}
**Bon à savoir** : Lorsque le remboursement est effectué via la fiche de paie, Dokos fait passer automatiquement le statut de l'avance à **Payée** (et non « Partiellement payée »), reflétant ainsi que la régularisation est complète.
::

## 5. Rapport : Résumé des avances des employés

Le rapport **Résumé des avances des employés** vous permet d'analyser les avances versées aux employés avec des filtres avancés et des options de regroupement pour une meilleure visibilité.

### 5.1 Accéder au rapport

Pour accéder au rapport :

**Ressources humaines > Notes de frais > Rapport : Résumé des avances des employés**

### 5.2 Filtres disponibles

Le rapport propose plusieurs filtres pour affiner votre analyse :

| Filtre              | Description                                              | Exemple                       |
| ------------------- | -------------------------------------------------------- | ----------------------------- |
| **Employé**         | Filtrez par un ou plusieurs employés.                    | Jean Dupont, Marie Martin     |
| **Département**     | Filtrez par un ou plusieurs départements.                | Ventes, Marketing             |
| **Branche**         | Filtrez par une ou plusieurs branches de l'entreprise.   | Paris, Lyon                   |
| **Compte d'avance** | Filtrez par un ou plusieurs comptes d'avance configurés. | 512000 - Avances aux employés |
| **Date de début**   | Date de début pour la période d'analyse.                 | 01/01/2026                    |
| **Date de fin**     | Date de fin pour la période d'analyse.                   | 31/12/2026                    |
| **Statut**          | Filtrez par statut de l'avance.                          | Payée, Réclamée, Remboursée   |

### 5.3 Colonnes du rapport

Le rapport affiche les informations suivantes :

| Colonne                   | Description                                                                               |
| ------------------------- | ----------------------------------------------------------------------------------------- |
| **Employé**               | Nom et identifiant de l'employé.                                                          |
| **Titre**                 | Objet de l'avance.                                                                        |
| **Montant de l'avance**   | Montant total de l'avance versée.                                                         |
| **Montant réclamé**       | Montant déjà réclamé via des notes de frais.                                              |
| **Montant retourné**      | Montant retourné à l'entreprise.                                                          |
| **Montant en attente**    | Montant restant à régulariser (Montant de l'avance - Montant réclamé - Montant retourné). |
| **Montant impayé**        | Montant non encore versé à l'employé.                                                     |
| **Montant en souffrance** | Montant en retard de remboursement.                                                       |
| **Compte d'avance**       | Compte comptable utilisé pour l'avance.                                                   |
| **Date de création**      | Date de création de l'avance.                                                             |
| **Statut**                | Statut actuel de l'avance.                                                                |

### 5.4 Options de regroupement

Vous pouvez regrouper les données du rapport par :

- **Employé** : Affiche les avances par employé avec des sous-totaux par employé.
- **Département** : Affiche les avances par département avec des sous-totaux par département.
- **Branche** : Affiche les avances par branche avec des sous-totaux par branche.

**Exemple de regroupement par Employé** :

```text
Jean Dupont (EMP-001)
  - Avance pour salon professionnel : 500,00 € (Montant réclamé : 300,00 €, Montant retourné : 50,00 €)
  - Sous-total : 500,00 €

Marie Martin (EMP-002)
  - Avance pour formation : 300,00 € (Montant réclamé : 300,00 €)
  - Sous-total : 300,00 €

Total général : 800,00 €
```

### 5.5 Visualisation des données

Le rapport propose deux modes d'affichage :

- **Vue plate** : Affiche toutes les lignes sans regroupement.
- **Vue groupée** : Affiche les données regroupées selon l'option sélectionnée, avec des sous-totaux et un total général.

### 5.6 Export du rapport

Vous pouvez exporter le rapport au format **Excel** ou **CSV** pour une analyse plus approfondie ou pour le partager avec d'autres utilisateurs.

### 5.7 Cas d'usage

**Suivi des avances par département** :

1. Sélectionnez le filtre **Département** et choisissez les départements souhaités.
2. Regroupez par **Département** pour voir les sous-totaux par service.
3. Exportez le rapport pour une analyse plus détaillée.

**Analyse des avances en souffrance** :

1. Filtrez par **Statut** et sélectionnez **Partiellement payée** ou **Réclamée**.
2. Triez les résultats par **Montant en souffrance** pour identifier les avances à régulariser en priorité.

**Vérification des comptes d'avance** :

1. Filtrez par **Compte d'avance** pour isoler les avances liées à un compte spécifique.
2. Vérifiez les montants en attente et les statuts pour assurer un suivi comptable précis.

## 6. Bonnes pratiques

- **Vérifiez régulièrement** le rapport **Résumé des avances des employés** pour suivre les avances en cours et éviter les oublis.
- **Utilisez les filtres** pour cibler des analyses spécifiques (par employé, département, ou statut).
- **Exportez les données** pour les intégrer dans vos rapports financiers ou pour les partager avec votre équipe comptable.
- **Formez vos employés** à l'utilisation des avances pour garantir une bonne gestion des dépenses professionnelles.

---

::callout{color="blue" icon="i-heroicons-light-bulb"}
**Astuce** : Pour une gestion encore plus efficace, configurez des [alertes par e-mail](https://doc.dokos.io/v5/dodock/fonctionnalites/notifications) pour être notifié des avances en attente d'approbation ou des montants en souffrance.
::


# Demande d'avantages sociaux

Les employés ont droit à des prestations flexibles qu'ils peuvent recevoir soit au prorata (dans le cadre de leur salaire), soit sous forme de montant forfaitaire lorsqu'ils demandent l'allocation. Afin de choisir parmi divers avantages flexibles qu'un employé recevra au prorata, l'employé doit créer une nouvelle demande d'avantages sociaux.

Les employés ont droit à des prestations flexibles qu'ils peuvent recevoir soit au prorata (dans le cadre de leur salaire), soit sous forme de montant forfaitaire lorsqu'ils demandent l'allocation. Afin de choisir parmi divers avantages flexibles qu'un employé recevra au prorata, l'employé doit créer une nouvelle demande d'avantages sociaux.

---

Pour accéder à la **liste Demande d'avantages sociaux**, allez sur :

> Accueil > Paie > **Demande d'avantages sociaux**

![liste\_demande\_avantages\_sociaux.png](https://doc.dokos.io/content/payroll/employee-benefit-application/liste_demande_avantages_sociaux.png)

## 1. Comment créer une demande d'avantages sociaux

1. Accéder à la liste de Demande d'avantages sociaux, cliquez sur **➕ Ajouter Demande d'avantages sociaux**.
2. Sélectionnez un **employé**.
3. Indiquez la **date** de la demande.
4. Choisir la **périoide paie** et définir la société
5. Remplir la **table des prestations demandées**
6. **Enregistrer**.

![détails\_avantages\_sociaux.png](https://doc.dokos.io/content/payroll/employee-benefit-application/details_avantages_sociaux.png)

## 2. Caractéristiques

### 2.1 Prestations demandées

Dans cette section, vous pouvez indiquez les avantages de l'employé en renseignant le tableau avec les différents champs.

- Composante de revenu
- Montant maximal des prestatuons
- Montant

![prestations\_demandées.png](https://doc.dokos.io/content/payroll/employee-benefit-application/prestations_demandees.png)

Ici, l'employé peut afficher les avantages maximum selon l'affectation de la composante salariale, puis choisir parmi les éléments de rémunération qui font partie de la structure salariale attribuée à l'employé. Ils peuvent également inscrire le montant qu'ils souhaitent recevoir dans le cadre de leur fiche de paie.

C'est sur la base de la demande d'avantages sociaux que le montant maximal de l'avantage sera réparti entre les éléments de rémunération flexibles lors de la génération du bordereau de salaire. Si un employé ne soumet pas la demande d'avantages sociaux avant le traitement de la paie, le montant maximal des avantages éligibles pour l'employé sera distribué proportionnellement à chacun des éléments flexibles présents dans la structure salariale de l'employé.

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
**Remarque** : Les employés ne peuvent soumettre qu'une seule demande d'avantages sociaux pour une période de paie.
::

La demande d'avantages sociaux doit couvrir le montant total que l'employé doit recevoir selon le montant maximal des avantages au prorata. Cependant, si la structure salariale de l'employé se compose d'éléments salariaux qui doivent être payés sur la demande d'avantages sociaux (composante salariale avec demande de rémunération contre avantages ), ils sont autorisés à soumettre une demande d'avantages sociaux à l'exclusion du montant alloué pour ces éléments.

Notez également que les éléments qui doivent être reçus sur la base des demandes d'avantages sociaux peuvent également faire partie de la demande, mais ne seront versés que sous forme de somme forfaitaire, dans le cadre de leur salaire lorsque l'employé soumet une demande pour cela.

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
**Remarque** : Le calcul de l'impôt normal n'inclut pas les avantages flexibles, car dans la plupart des cas, ils sont exonérés d'impôt. Pour imposer ces composants à tout moment avant la dernière paie, utilisez Déduire l'impôt pour les avantages sociaux non réclamés dans Saisie de la paie / Bulletin de salaire lors du traitement du salaire.
::


# Requête d'avantages sociaux

La requête d'avantages sociaux permet aux employés de :

- 1. Demander des avantages flexibles qui doivent être perçus sous forme forfaitaire (si la composante salariale est payée contre une demande d'avantages )
- 2. Demander une exonération fiscale pour les avantages flexibles reçus au prorata, dans le cadre du salaire lors de la déduction d'impôt Pour les avantages sociaux non réclamés est coché dans Saisie de la paie / Bulletin de salaire

---

Vous accéder à **la liste requête d'avantages sociaux**, allez sur :

Accueil > Paie > **Demande d'avantages sociaux**

![liste\_requête\_avantages\_sociaux.png](https://doc.dokos.io/content/payroll/employee-benefit-claim/liste_requete_avantages_sociaux.png)

## 1. Comment créer une requête d'avantages sociaux

![détails\_requête.png](https://doc.dokos.io/content/payroll/employee-benefit-claim/details_requete.png)

## 2. Caractéristiques

### 2.1 Type de prestation et montant

Dans cette section, vous pouvez indiquer pour quel type de prestation est faite la demande. Et également, de définir le montant réclamé.

![type\_de\_prestation\_et\_montant.png](https://doc.dokos.io/content/payroll/employee-benefit-claim/type_de_prestation_et_montant.png)

### 2.2 Preuves de dépenses

Dans cette section, vous pouvez indiquer les preuves de dépenses. Joignez une pièce jointe pour soumettre la preuve.

![preuves\_de\_dépenses.png](https://doc.dokos.io/content/payroll/employee-benefit-claim/preuves_de_depenses.png)

Ici, l'employé peut voir le montant admissible selon son affectation de structure salariale et réclamer le montant qu'il souhaite recevoir dans le cadre de son prochain salaire. Tout montant restant que l'employé n'a pas réclamé, au cours d'une période de paie, sera versé dans le cadre du dernier salaire de paie.

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
**Remarque** : Le calcul de l'impôt normal n'inclut pas les avantages flexibles, car dans la plupart des cas, ils sont exonérés d'impôt. Pour imposer ces composants à tout moment avant la dernière paie, utilisez Déduire l'impôt pour les avantages sociaux non réclamés dans Saisie de la paie / Bulletin de salaire lors du traitement du salaire.
::


# Rapport de ventilation du CTC employé

Le rapport **Ventilation du CTC employé** offre une vue détaillée de la structure de rémunération d'un employé : gains, déductions, **cotisations patronales** et charges fiscales. Pour chaque composante, il indique le montant par cycle de paie, le montant annualisé et la part dans le CTC total.

Ce rapport est particulièrement utile pour les RH et la direction lors de la négociation de packages salariaux, de la préparation des lettres d'offre ou du contrôle de la masse salariale.

---

Pour accéder au rapport, allez sur :

> Accueil > Paie > Rapports > **Ventilation du CTC employé**

Ou directement depuis une **Attribution de structure salariale** via le bouton **Ventilation du CTC**.

## 1. Prérequis avant utilisation

Avant d'utiliser ce rapport, assurez-vous d'avoir :

- Un &#x2A;*[Employé](https://doc.dokos.io/v5/dokos/hrms/cycle-de-vie/employee)** actif
- Une &#x2A;*[Grille des salaires](https://doc.dokos.io/v5/dokos/hrms/paie/salary-structure)** configurée avec ses composantes (gains, déductions et **cotisations employeur**)
- Une &#x2A;*[Attribution de structure salariale](https://doc.dokos.io/v5/dokos/hrms/paie/salary-structure-assignment)** avec le champ **CTC** renseigné

## 2. Champ CTC dans l'attribution de structure salariale

Un nouveau champ &#x2A;*CTC (Coût Total Employeur)** a été ajouté au formulaire d'attribution de structure salariale. Ce champ permet de saisir le montant annuel total que l'entreprise s'engage à verser pour cet employé.

::callout{color="blue" icon="i-heroicons-information-circle"}
**Pourquoi ce champ est-il sur l'attribution et non sur la fiche employé ?**
Le CTC peut varier selon la période et la structure salariale applicable. En le rattachant à l'attribution, vous pouvez gérer des évolutions de package sans modifier la fiche de l'employé.
::

**Comment renseigner le CTC :**

1. Ouvrez une **Attribution de structure salariale**.
2. Renseignez le champ **CTC** avec le montant annuel brut total (ex. : `720 000` pour un package à 60 000 €/mois).
3. Enregistrez le document.

## 3. Filtres du rapport

| Filtre                             | Obligatoire | Description                              |
| ---------------------------------- | ----------- | ---------------------------------------- |
| Entreprise                         | Oui         | Filtre les employés par entité juridique |
| Employé                            | Oui         | Sélectionne l'employé à analyser         |
| Attribution de structure salariale | Oui         | Choisit la période / package à analyser  |

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Les trois filtres sont obligatoires. Le champ **Attribution de structure salariale** se met à jour automatiquement selon l'employé sélectionné.
::

### Pré-sélection automatique de l'employé connecté

Lorsque vous ouvrez le rapport, le filtre **Employé** est automatiquement pré-rempli avec votre propre fiche employé si votre compte utilisateur y est rattaché. De même, le filtre **Attribution de structure salariale** se positionne par défaut sur la dernière attribution connue pour cet employé.

Cette automatisation vous évite de rechercher votre fiche à chaque ouverture du rapport, en particulier lorsqu'un collaborateur consulte sa propre ventilation de rémunération.

::callout{color="blue" icon="i-heroicons-information-circle"}
Si votre compte utilisateur n'est pas associé à une fiche employé, ou si vous avez des droits d'accès élargis, vous pouvez sélectionner manuellement l'employé souhaité.
::

## 4. Lecture du rapport

### 4.1 Carte de profil employé

En haut du rapport s'affiche une carte récapitulative avec :

- Le nom et la photo de l'employé
- Son poste et son département
- La date d'entrée

### 4.2 Indicateurs de synthèse

Quatre métriques sont affichées en évidence :

| Indicateur        | Description                                |
| ----------------- | ------------------------------------------ |
| **CTC annuel**    | Montant total saisi dans l'attribution     |
| **CTC par cycle** | CTC annuel divisé par la fréquence de paie |
| **Salaire brut**  | Total des gains avant déductions           |
| **Salaire net**   | Salaire brut moins toutes les déductions   |

### 4.3 Tableau de ventilation

Le tableau présente les composantes salariales regroupées en sections :

- **Gains** — Salaire de base, indemnités, primes, etc.
- **Total Gains** (ligne récapitulative en gras)
- **Cotisations employeur** — Charges patronales retraite, prévoyance, mutuelle, etc. (composantes de type *Cotisation employeur*)
- **Total Cotisations employeur** (ligne récapitulative en gras)
- **Déductions** — Cotisations salariales, etc.
- **Déductions fiscales** — Impôts et taxes sur salaire
- **Total Déductions** (ligne récapitulative en gras)
- **CTC Total** (ligne finale en gras)

Pour chaque composante :

| Colonne             | Description                                |
| ------------------- | ------------------------------------------ |
| **Composante**      | Nom de la composante salariale             |
| **Type**            | Fixe ou Formule                            |
| **Montant (cycle)** | Montant pour la période de paie            |
| **Montant annuel**  | Montant × nombre de cycles dans l'année    |
| **% du CTC**        | Part de cette composante dans le CTC total |

::callout{color="blue" icon="i-heroicons-information-circle"}
**Nouveauté : Section Cotisations employeur**
Les composantes de type **Cotisation employeur** (ex. : part patronale de la mutuelle, cotisations retraite complémentaire) sont désormais affichées dans une section dédiée. Elles sont incluses dans le calcul du CTC total mais n'affectent pas le salaire net de l'employé.

Cette section permet aux employeurs de visualiser clairement le coût réel des charges patronales associées à chaque employé, facilitant ainsi la budgétisation et la négociation des packages salariaux.
::

### 4.4 Fréquences de paie supportées

Le rapport calcule automatiquement l'annualisation selon la fréquence définie dans la grille des salaires :

| Fréquence      | Cycles par an |
| -------------- | ------------- |
| Mensuelle      | 12            |
| Bimensuelle    | 24            |
| Hebdomadaire   | 52            |
| Bihebdomadaire | 26            |
| Trimestrielle  | 4             |
| Annuelle       | 1             |

## 5. Accès rapide depuis l'attribution de structure salariale

Un bouton **Ventilation du CTC** est disponible directement sur le formulaire d'attribution de structure salariale. Il ouvre le rapport pré-filtré sur l'employé et l'attribution concernés, sans avoir à saisir manuellement les filtres.

## 6. Qui peut consulter ce rapport ?

Le rapport est accessible selon deux profils :

| Profil                               | Ce qu'il peut consulter                                                         |
| ------------------------------------ | ------------------------------------------------------------------------------- |
| **Collaborateur (employé standard)** | Sa propre ventilation de rémunération                                           |
| **Manager / RH**                     | Sa propre ventilation ainsi que celles des employés dont il a la responsabilité |

::callout{color="blue" icon="i-heroicons-information-circle"}
**Accès des managers**
Un manager peut consulter la ventilation CTC des employés qu'il gère, de la même façon qu'il peut déjà accéder aux bulletins de salaire de son équipe. Cet accès repose sur les permissions utilisateur définies dans Dokos.
::

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
**Données sensibles**
La ventilation CTC contient des informations salariales confidentielles. Vérifiez les droits d'accès de vos utilisateurs avant de déployer cette fonctionnalité à l'ensemble du personnel.
::

## 7. Exemple d'utilisation

> **Situation** : La RRH de *Maison Verte SARL* souhaite présenter à Sophie Martin, responsable marketing, la composition de son package annuel de 55 000 €. La structure salariale inclut une cotisation patronale mutuelle de 80 €/mois et une cotisation retraite employeur calculée par formule.

1. Ouvrir l'attribution de structure salariale de Sophie Martin.
2. Renseigner **CTC = 55 000** dans le champ correspondant et enregistrer.
3. Cliquer sur **Ventilation du CTC**.
4. Le rapport affiche :


   - Salaire de base 3 200 €/mois (69,8 % du CTC)
   - Prime de transport 150 €/mois (3,3 %)
   - **Section Cotisations employeur** :


     - Mutuelle employeur 80 €/mois (1,7 %)
     - Retraite employeur (formule) 250 €/mois (5,5 %)
   - Cotisations salariales 300 €/mois (6,5 %)
5. La RRH peut exporter ou imprimer ce rapport pour l'inclure dans la lettre d'offre.

> **Cas collaborateur** : Sophie Martin elle-même ouvre le rapport depuis son espace personnel. Le filtre Employé est déjà rempli avec sa fiche et la dernière attribution salariale est pré-sélectionnée. Elle consulte directement sa ventilation sans aucune saisie préalable.

> **Cas manager** : Thomas Dupont, directeur commercial chez *Maison Verte SARL*, souhaite vérifier la composition du package de l'un de ses commerciaux avant un entretien annuel. Il ouvre le rapport, sélectionne la fiche de son collaborateur et consulte la ventilation détaillée, y compris la nouvelle section **Cotisations employeur**.

## 8. Flux de création d'un package salarial

::mermaid
flowchart TD
A\[Créer la Grille des salaires
avec composantes
(gains, déductions, cotisations employeur)] --> B\[Attribuer la grille
à l'employé]
B --> C\[Renseigner le CTC
dans l'attribution]
C --> D\[Cliquer sur
Ventilation du CTC]
D --> E\[Rapport affiché :
profil + indicateurs + tableau
(dont section Cotisations employeur)]
E --> F\[Exporter / Imprimer
pour lettre d'offre]

::

## 9. Configuration des composantes de cotisation employeur

Pour que les cotisations employeur apparaissent dans le rapport, vous devez les configurer correctement dans la grille des salaires :

1. **Créer une composante salariale** de type *Cotisation employeur* :

   - Allez dans **Accueil > Paie > Configuration > Composante salariale**
   - Créez une nouvelle composante avec le type *Cotisation employeur*
   - Définissez si elle est fixe ou calculée par formule
2. **Ajouter la composante à la grille des salaires** :

   - Ouvrez la grille des salaires concernée
   - Dans l'onglet *Composantes*, ajoutez la cotisation employeur
   - Configurez son montant ou sa formule

::callout{color="blue" icon="i-heroicons-information-circle"}
**Exemple de formule pour une cotisation employeur**
Pour une cotisation retraite employeur égale à 5% du salaire de base :

```text
base * 0.05
```

Où `base` est le nom de la composante de salaire de base.
::

3. **Vérifier l'affichage dans le rapport** :


   - Après avoir attribué la grille à un employé et renseigné le CTC, ouvrez le rapport **Ventilation du CTC employé**
   - La cotisation employeur apparaîtra dans la section dédiée avec son montant et son pourcentage du CTC

## 10. Export et impression

Le rapport peut être exporté aux formats PDF, Excel ou CSV via le menu **Exporter** en haut à droite. L'export conserve toutes les sections, y compris les **Cotisations employeur**.

Pour une impression optimisée :

1. Utilisez le bouton **Imprimer** du navigateur
2. Sélectionnez l'option *Mise en page* pour ajuster les marges si nécessaire
3. Choisissez *Échelle* à 80-90% pour que le tableau tienne sur une page A4 en mode paysage

::callout{color="green" icon="i-heroicons-light-bulb"}
**Astuce**
Pour les packages complexes avec de nombreuses composantes, exportez en Excel pour permettre aux managers de filtrer et analyser les données plus facilement.
::


# Intérenssement des employés

Les intéressements aux employés sont un moyen de récompenser et de motiver les performances des employés en dehors du salaire habituel.

Lorsqu'une organisation souhaite encourager la productivité de ses employés, l'une des options disponibles consiste à récompenser l'employé avec une prime d'intéressement. Dokos vous permet de créer des intéressements aux employés au fur et à mesure des besoins pour une entrée de paie particulière.

---

Pour accéder à **la liste intéressement des employés**, allez sur :

> Accueil > Paie > **Intéressement des employés**

![liste\_intéressement\_des\_employés.png](https://doc.dokos.io/content/payroll/employee-incentive/liste_interessement_des_employes.png)

## 1. Prérequis avant utilisation

Avant de créer une incitation pour les employés, il est conseillé de créer les éléments suivants :

- **[Employé](https://doc.dokos.io/v5/dokos/hrms/cycle-de-vie/employee)**
- **[Composante salariale](https://doc.dokos.io/v5/dokos/hrms/paie/salary-component)**

## 2. Comment créer un incitatif pour les employés

1. Accédez à la liste des incitations aux employés, cliquez sur **➕ Ajouter Intéressement des employés**.
2. Sélectionnez l'**employé**.
3. Saisissez le **montant** de l'incitatif.
4. Sélectionnez la **date** de paie.
5. Sélectionnez la **composante salariale** sous laquelle vous souhaitez offrir l'incitatif.
6. **Enregistrer** et envoyer.
7. Lors de la soumission, le document **Salaire supplémentaire** de la **Composante salariale** spécifiée est créé. Celui-ci sera récupéré lors de l'exécution de la saisie de la paie.

![détails\_intéressement.png](https://doc.dokos.io/content/payroll/employee-incentive/details_interessement.png)


# Autres revenus de l'employé

Autres revenus de l'employé est un document permettant de déclarer les autres revenus d'un employé provenant de différentes sources.

Les autres revenus d'un employé sont également importants pour calculer l'impôt sur le revenu d'un employé. Dans Dokos, un salarié peut déclarer ses autres revenus à l'aide de ce document.

---

Pour accéder à **la liste autres revenus des employés**, allez sur :

> Accueil > Ressources humaines > Impôts et avantages sociaux des employés > **Autres revenus des employés**

![liste\_autres\_revenus\_de\_l'employé.png](https://doc.dokos.io/content/payroll/employee-other-income/liste_autres_revenus_de_lemploye.png)

## 1. Comment créer un autre revenu d'employé

1. Allez dans la liste Employé Autres revenus, cliquez sur ➕ Ajouter Autres revenus de l'employé .
2. Sélectionnez l'**employé** et la **société**.
3. Sélectionnez la **période de paie**.
4. Entrez le **montant** et sa **source**.
5. **Enregistrer** et envoyer.

![détails\_autres\_revenus.png](https://doc.dokos.io/content/payroll/employee-other-income/details_autres_revenus.png)


# Déclaration d'exemption de taxe

L'exonération fiscale est l'exemption monétaire des revenus, des biens ou des transactions d'impôts qui seraient autrement prélevés sur un employé.

Au début d'une période de paie, les employés peuvent déclarer le montant de l'exonération qu'ils réclameront de leur salaire imposable. Dokos vous permet de spécifier la catégorie/sous-catégorie d'exonération fiscale, le montant de l'exonération fiscale et d'autres informations connexes dans le formulaire Déclaration d'exonération fiscale des employés.

---

Pour accéder à **la liste déclaration d'exonération fiscale des salariés**, allez sur :

> Accueil > Ressources humaines > Impôts et avantages sociaux des employés > **Déclaration d'exonération fiscale des employés**

![liste\_déclaration\_d'exemption\_de\_taxe.png](https://doc.dokos.io/content/payroll/employee-tax-exemption-declaration/liste_declaration_dexemption_de_taxe.png)

## 1. Prérequis avant utilisation

Avant de créer une déclaration d'exonération fiscale des employés, il est conseillé de créer les éléments suivants :

- **[Employé](https://doc.dokos.io/v5/dokos/hrms/cycle-de-vie/employee)**
- **Catégorie d'exonération fiscale des employés**
- **Sous-catégorie d'exonération fiscale des employés**

## 2. Comment créer une déclaration d'exonération fiscale des employés

1. Allez dans la liste Déclaration d'exonération fiscale des employés, cliquez sur **➕ Ajouter Déclaration d'exonération fiscale des employés**.
2. Sélectionnez la **sous-catégorie d'exemption** et la **catégorie d'exemption**.
3. Saisissez le **montant maximal** de l'exonération et le **montant déclaré**.
4. **Enregistrer** et envoyer.

![détails\_déclarations.png](https://doc.dokos.io/content/payroll/employee-tax-exemption-declaration/details_declarations.png)

Le montant total de l'exonération sera exonéré des gains annuels imposables de l'employé lors du calcul des retenues d'impôt sur la paie.

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
**Remarque** : Les employés ne peuvent soumettre qu'une seule déclaration d'exonération fiscale pour une période de paie.
::

## 3. Caractéristiques

### 3.1 Catégorie d'exonération fiscale des employés

Les exonérations du salaire imposable sont généralement limitées aux dépenses relatives à des catégories particulières décidées par le gouvernement ou les organismes de réglementation. Dokos vous permet de configurer différentes catégories qui peuvent être exemptées.

Vous pouvez configurer la catégorie d'exonération fiscale des employés en allant sur Impôts et avantages sociaux des employés > Catégorie d'exonération fiscale des employés

![catégorie\_exemption.png](https://doc.dokos.io/content/payroll/employee-tax-exemption-declaration/categorie_exemption.png)

### 3.2 Sous-catégorie d'exonération fiscale des employés

Dans chaque catégorie, il pourrait y avoir de nombreux chefs pour lesquels les exemptions sont autorisées.

Vous pouvez configurer la catégorie d'exonération fiscale des employés en allant à, Taxe et avantages sociaux des employés > Sous-catégorie d'exonération fiscale des employés

![sous\_catégorie\_exemption.png](https://doc.dokos.io/content/payroll/employee-tax-exemption-declaration/sous_categorie_exemption.png)


# Soumission d'une preuve d'exemption de taxe

Les employés sont tenus de fournir des justificatifs de toutes les dépenses pour lesquelles ils réclament une exonération fiscale. Cela peut être fait via le document de soumission de preuve d'exonération fiscale des employés

Cela se fait généralement à la fin d'une période de paie, mais les employés peuvent soumettre n'importe quel nombre de preuves contrairement à la déclaration d'exonération fiscale des employés.

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
**Remarque** : Créez une déclaration d'exonération fiscale pour les employés avant de créer une soumission de preuve d'exonération fiscale pour les employés
::

---

Pour accéder à **la liste soumission de preuve d'exonération fiscale des employés**, allez sur :

> Accueil > Paie > **Soumission de preuve d'exonération fiscale des employés**

![liste\_soumission\_preuve\_d'exemption\_de\_taxe.png](https://doc.dokos.io/content/payroll/employee-tax-exemption-proof-submission/liste_soumission_preuve_dexemption_de_taxe.png)

## 1. Comment créer une soumission de preuve d'exonération fiscale pour les employés

Les détails sont déjà récupérés si vous cliquez sur **Soumettre une preuve » à partir de la déclaration d'exonération fiscale des employés . Toutefois, si vous souhaitez créer manuellement une « soumission de preuve d'exemption d'impôt sur les employés**, procédez comme suit.

1. Accédez à la liste Soumission de la preuve d'exonération fiscale des employés, cliquez sur **➕ Ajouter Soumission de la preuve d'exonération fiscale des employés**.
2. Entrez les **détails** au besoin.

![détails\_soumission.png](https://doc.dokos.io/content/payroll/employee-tax-exemption-proof-submission/details_soumission.png)

3. Entrez le **Type de preuve** (documents, reçus, etc.).
4. Joignez les épreuves en cliquant sur le bouton Joindre en bas.
5. Entrez le montant du paiement du loyer de la maison, la date de location et la date de location.
6. Enregistrer et envoyer.

![preuve\_d'exonération.png](https://doc.dokos.io/content/payroll/employee-tax-exemption-proof-submission/preuve_dexoneration.png)

Le montant total d'exonération sera exonéré des gains annuels imposables de l'employé lors du calcul des retenues d'impôt sur la dernière paie.

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
**Remarque** : Même si les employés soumettent des preuves d'exemption à tout moment pendant la période de paie, Dokos ne les considérera que lors de la dernière paie de la période de paie pour ajuster les taxes finales en fonction de la preuve soumise. Si vous devez ajuster toute taxe supplémentaire collectée ou envisager de soumettre une preuve des employés à tout moment avant la dernière paie, lors du traitement de l'entrée de la paie (ou dans le bulletin de salaire de l'employé), cochez l' option Déduire la taxe pour la preuve d'exonération fiscale non soumise .
::


# Tranche d'impôt sur le revenu

La tranche d'impôt sur le revenu est un document permettant de définir les taux d'imposition sur le revenu en fonction de différentes dalles de revenu imposable.

Dans de nombreux pays, l'impôt sur le revenu est prélevé sur les contribuables individuels sur la base d'un système de dalle où différents taux d'imposition ont été prescrits pour différentes dalles et ces taux d'imposition continuent d'augmenter avec une augmentation de la dalle de revenu. Dans ERPNext, vous pouvez définir plusieurs tranches d'impôt sur le revenu et les lier à la structure salariale de chaque employé via l'affectation de la structure salariale.

---

Pour accéder à **la liste tranche d'impôt sur le revenu**, allez sur :

> Accueil > Paie > **Tranche d'impôt sur le revenu**

![liste\_tranche\_d'impôt.png](https://doc.dokos.io/content/payroll/income-tax-slab/liste_tranche_dimpot.png)

## 1. Comment créer une tranche d'impôt sur le revenu

1. Entrez un nom pour **la tranche d'impôt** sur le revenu, l'**entreprise** et la **date** à partir de laquelle il entrera en vigueur.
2. Cochez la case **Autoriser l'exonération fiscale** le cas échéant.
3. Enregistrer et envoyer.

![détails\_tranche\_d'impôt.png](https://doc.dokos.io/content/payroll/income-tax-slab/details_tranche_dimpot.png)

## 2. Caractéristiques

### 2.1 Tranches de salaire imposables

Dans la table de tranches de salaires imposables, vous pouvez définir le taux pour différentes tranches de revenu. Pour définir la tranche, les champs **Du montant** et **Au montant** doivent être saisis. Pour la première tranche, **Du montant** est facultatif et pour la dernière tranche, \*\*Au montant" est facultatif. Le montant est inclus tout en évaluant l'impôt sur la base du revenu imposable.

La tranche fiscale peut être applicable selon des conditions particulières. Les conditions peuvent être écrites en utilisant tous les noms de champ des documents Employé, Structure salariale, Affectation de la structure salariale et Fiche de salaire.

![tranches\_de\_salaire\_imposables.png](https://doc.dokos.io/content/dokos/hrms/paie/income-tax-slab/tranches_de_salaire_imposables.png)

Exemples:

```text
// Apply tax if employee born between 31-12-1937 and 01-01-1958 (Employees aged 60 to 80)
date_of_birth > date(1937, 12, 31) and date_of_birth < date(1958, 01, 01)

// Apply tax by employee gender
gender == "Male"

// Apply tax by Salary Component
base > 10000

// Annual Taxable income is greater than 5 lakhs
annual_taxable_earning > 500000
```

### 2.2 Autres impôts et charges sur l'impôt sur le revenu

Si d'autres taxes sont applicables sur l'impôt sur le revenu calculé, vous pouvez les saisir à l'aide de ce tableau. Vous pouvez également définir le montant imposable min et max pour lequel cette taxe sera applicable. Par exemple, la taxe sur la santé et l'éducation est appliquée en plus à l'impôt sur le revenu pour tout le monde en France.

![taxes\_et\_frais\_sur\_l'impôt\_sur\_le\_revenu.png](https://doc.dokos.io/content/payroll/income-tax-slab/taxes_et_frais_sur_limpot_sur_le_revenu.png)

### 2.3 Autres propriétés

Autoriser les exonérations fiscales : des exonérations fiscales peuvent être autorisées pour une tranche d'impôt sur le revenu spécifique. Si cette option est activée, lors du calcul des taxes sur la base de cette tranche d'impôt, la déclaration d'exonération fiscale des employés et la soumission de preuves sont prises en compte pour le calcul du revenu imposable.
Montant d'exonération fiscale standard : si l'exonération est autorisée, le montant d'exonération fiscale standard défini par le gouvernement peut être ajouté ici. Cette exonération ne nécessite généralement aucun justificatif et s'applique à tous les salariés liés à cette dalle d'impôt sur le revenu.


# Entrée de la paie

La masse salariale est la somme totale de toutes les rémunérations qu'une entreprise doit verser à ses employés pendant une période donnée ou à une date donnée.

Dans Dokos, l'entrée de la paie permet le traitement en masse de la paie des employés. En d'autres termes, traiter les bulletins de salaire de tous les employés en une seule fois. Le traitement en bloc peut être à l'échelle de l'entreprise ou basé sur les catégories suivantes : succursale, service ou désignation.

---

Pour accéder à **la liste entrée de la paie**, allez sur :

> Accueil > Paie > **Entrée de la paie**

![liste\_.png](https://doc.dokos.io/content/payroll/payroll-entry/liste_.png)

## 1. Comment créer une entrée de paie

1. Accédez à la liste Saisie de la paie, cliquez sur **➕ Ajouter Entrée de la paie**.
2. Sélectionnez la **fréquence de paie**.
3. Sélectionnez **Branche**, **Désignation** et **Département** pour filtrer les employés (facultatif).
4. Sélectionnez Projet (facultatif) si vous souhaitez exécuter la paie pour un projet.
5. Cochez les cases **Valider la présence** et **Fiche de salaire basée sur la feuille de temps** si vous souhaitez déduire le salaire en fonction de la présence et si vous souhaitez également prendre en compte les feuilles de temps des employés respectivement.
6. Sélectionnez le compte de paiement pour effectuer l'opération bancaire.
7. Enregistrer.

![détails\_employés.png](https://doc.dokos.io/content/payroll/payroll-entry/details_employes.png)

Une fois les informations enregistrées, cliquez sur le bouton Obtenir des employés pour obtenir une liste des employés pour lesquels les fiches de salaire seront créées en fonction des critères sélectionnés.

Une fois la liste des Employés récupérée, cliquez sur le bouton Créer des fiches de salaire pour générer des fiches de salaire.

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
**Remarque** : Si les fiches de salaire sont déjà créées, le système ne créera plus de fiches de salaire. Vous pouvez également simplement enregistrer le formulaire en tant que brouillon et créer les fiches de salaire plus tard.
::

## 2. Caractéristiques

### 2.1 Employés

Dans cette section, sélectionnez la branche, le département et la désignation pour pouvoir filtrer les employés.

![employés.png](https://doc.dokos.io/content/payroll/payroll-entry/employes.png)

### 2.2 Sélectionner la période Paie

Indiquez ici la période de paie en mettant la date de début et la date de fin. Vous pouvez également, déduire la taxte pour les avantages soxiaux des employés non réclamés et déduire la taxe pour toute preuve d'exemption de taxe non soumise.

![période\_de\_paie.png](https://doc.dokos.io/content/payroll/payroll-entry/periode_de_paie.png)

### 2.3 Dimensiosn comptables

Après avoir vérifié les bordereaux de salaire, vous pouvez les soumettre tous ensemble en cliquant sur le bouton Soumettre le bordereau de salaire.

Cela enregistrera également le compte Écriture de paiement de la paie par défaut par rapport aux chefs de dépenses respectifs (tels que configurés dans les composants de salaire) pour enregistrer l'accumulation de salaire pour les employés.

- **Centre de coûts** : Vous pouvez sélectionner Centre de coûts dans l'entrée de paie sur laquelle les dépenses seront imputées.

Si vous souhaitez comptabiliser des dépenses sur plusieurs centres de coûts en fonction de l'employé/du département, vous pouvez le faire en définissant le centre de coûts de la paie dans la fiche Employé/département. Le centre de coûts affecté dans le maître Employé/Département aura la priorité sur le centre de coûts sélectionné dans la saisie de la paie.

![dimensions\_comptables.png](https://doc.dokos.io/content/payroll/payroll-entry/dimensions_comptables.png)

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
**Remarque** : La soumission manuelle des bulletins de salaire un par un ne créera pas l'écriture de journal pour enregistrer l'accumulation de salaire.
::

### 2.4 Écriture de paiement

La dernière étape consiste à réserver le paiement du salaire.

Les salaires dans les entreprises sont généralement traités avec une extrême confidentialité. Dans la plupart des cas, les entreprises effectuent un paiement unique à la banque combinant tous les salaires et la banque distribue les salaires sur le compte de salaire de chaque employé.

De cette façon, il n'y a qu'une seule écriture de paiement dans les livres de comptes de l'entreprise et toute personne ayant accès aux comptes de l'entreprise n'aura pas accès aux salaires individuels.

L'écriture de paiement de salaire est une écriture de journal qui débite le total de la composante salariale de type Revenus et crédite le total de la composante salaire de type Retenues de tous les Employés au compte par défaut défini au niveau de la composante Salaire pour chaque composante.

Pour générer votre bon de paiement de salaire à partir de la **Saisie de la paie**, cliquez sur le bouton **Faire une saisie bancaire**.

L'entrée de la paie vous dirigera vers l'entrée de journal avec des filtres pertinents pour afficher les brouillons de pièces de journal créés. Vous devrez définir le numéro de référence et la date des transactions et soumettre l'écriture au journal.

![écriture\_de\_paiement.png](https://doc.dokos.io/content/payroll/payroll-entry/ecriture_de_paiement.png)

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
**Remarque** : Pour les éléments de salaire qui sont des avantages flexibles et pour lesquels la case Créer une écriture de paiement distincte contre demande d'avantages est cochée, ERPNext enregistrera des écritures de journal provisoires distinctes.
::


# Gestion de la paie

Le traitement de la paie est une fonction importante de chaque RH d'entreprise. Dokos simplifie considérablement ce processus en offrant un éventail de fonctionnalités que vous pouvez utiliser, de la gestion de la structure salariale au traitement en bloc de la paie des employés. Lisez la documentation suivante pour comprendre comment configurer et utiliser les ressources humaines de Dokos pour optimiser votre traitement de la paie.

- Période de paie
- Composante salariale
- Structure salariale
- Affectation de la structure salariale
- Saisie de la paie
- Salaire supplémentaire
- Bonus de rétention
- Incitatif des employés


# Période de paie

Une période de paie est une période pour laquelle les employés sont payés pour leur travail au sein de l'entreprise.

La période de paie vous aide à définir les structures salariales et à calculer l'impôt pour une période spécifique en fonction de la tranche d'impôt sur le revenu applicable.

Pour accéder à la **liste de période de paie**, allez à :

> Accueil > Ressources humaines > Paie > **Période de paie**

## 1. Comment créer une période de paie

1. Allez dans la liste Période de paie, cliquez sur **➕ Ajouter période de paie**.
2. Entrez le **nom**.
3. Sélectionnez la date de début et la date de fin de la période de paie.
4. Enregistrer.


# Paramètres Paie

Les paramètres de Paie permettent des paramètres globaux pour les documents de la paie.

---

Pour accéder à **la liste des paramètres Paie**, allez sur :

> Accueil > Paie > Paramètres > **Paramètres Paie**

## 1. Paramètres de paie

![paramètres\_de\_paie.png](https://doc.dokos.io/content/rh/hr-settings/parametres_de_paie.png)

### 1.1 Calculer les jours de travail payés sur la base de

Les jours ouvrables dans le bulletin de salaire peuvent être calculés sur la base des congés ou de présence. Vous pouvez sélectionner l'option en fonction de ce que vous souhaitez calculer.

### 1.2 Heures de travail max par rapport à la feuille de temps

Pour les fiches de salaire basées sur la feuille de temps, vous pouvez définir le nombre maximum d'heures autorisées par rapport à une seule feuille de temps. Définissez cette valeur sur zéro pour désactiver cette validation.

### 1.3 Inclure les vacances dans le nombre total de jours ouvrés

Si coché, le nombre total de jours ouvrables inclura les jours fériés, ce qui réduira la valeur du salaire par jour.

### 1.4 Désactiver le total arrondi

Vous pouvez l'activer pour désactiver l'arrondi du montant total dans les bulletins de salaire.

### 1.5 Fraction du salaire quotidien pour une demi-journée

Sur la base de cette fraction, le salaire pour la demi-journée sera calculé. Par exemple, si la valeur est définie sur 0,5, la moitié du salaire sera attribuée pour une demi-journée de présence.

### 1.6 Envoyer la fiche de paie à l'employé par Mail

Un e-mail avec le bulletin de salaire est envoyé à l'adresse e-mail préférée de l'employé respectif lors de la soumission du bulletin de salaire.

### 1.7 Crypter les fiches de salaire dans les e-mails

Le bulletin de salaire PDF envoyé à l'employé est crypté à l'aide de la politique de mot de passe mentionnée.

### 1.8 Politique de mot de passe

Ce champ devient visible et obligatoire en cochant l'option ci-dessus pour crypter le bulletin de salaire dans l'email.

Voici un exemple de la façon de définir une politique de mot de passe pour le bulletin de salaire PDF.

Exemple:

```text
SAL-{first_name}-{date_of_birth.yea)
```

Cela générera un mot de passe comme SAL-Jane-1972

### 1.9 Afficher le solde de congés dans la fiche de paie

Si coché, alors la fiche de paie indiquera le solde des congés de l'employé.


# Prime de fidélisation

La prime de fidélisation est un paiement ou une récompense en dehors du salaire régulier d'un employé qui est offert comme une incitation à garder un employé clé au travail.

Dokos vous permet de configurer la prime de rétention pour un employé pour une période particulière.

---

Pour accéder à la liste de prime de fidélisation, allez sur :

> Accueil > Paie > **Prime de fidélisation**

![liste\_prime\_de\_rétention.png](https://doc.dokos.io/content/payroll/retention-bonus/liste_prime_de_retention.png)

## 1. Prérequis avant utilisation

Avant de créer une prime de fidélisation, il est conseillé de créer les éléments suivants :

- **[Employé](https://doc.dokos.io/v5/dokos/hrms/cycle-de-vie/employee)**
- **[Composante salariale](https://doc.dokos.io/v5/dokos/hrms/paie/salary-component)**

## 2. Comment créer une prime de fidélisation

1. Accédez à la liste Prime de fidélisation, cliquez sur **➕ Ajouter Prime de rétention**.
2. Sélectionnez l'**employé** et la **date de paiement** de la prime.
3. Saisissez le **montant** de la prime.
4. Sélectionnez la **composante salariale** sous laquelle vous souhaitez donner la prime.
5. **Enregistrer** et envoyer.
6. Lors de la soumission, le document **Salaire supplémentaire** de la « **Composante salariale** spécifiée est créé. Celui-ci sera récupéré lors de l'exécution de la saisie de la paie.

![détails\_prime.png](https://doc.dokos.io/content/payroll/retention-bonus/details_prime.png)


# Composante salariale

Les salaires sont payés par les organisations à leurs employés en échange des services qu'ils rendent. Les différentes composantes qui composent la structure salariale sont appelées composantes salariales.

Le salaire versé aux employés comprend plusieurs éléments différents, tels que le salaire de base, les indemnités, les arriérés, etc. Dokos vous permet de définir ces éléments de salaire et également de spécifier ses différents attributs.

---

Pour accéder à **la liste composante salariale**, allez sur :

> Accueil > Ressources humaines > Paie > **Composante Salaire**

![liste\_composant\_salariale.png](https://doc.dokos.io/content/payroll/liste_composant_salariale.png)

## 1. Comment créer une composante salariale

1. Accédez à la liste des éléments de salaire, cliquez sur **➕ Ajouter Composante salariale**.
2. Entrez son **nom** et son **abréviation**.
3. Indiquez le **type** : Revenus, Déduction ou **Cotisation employeur**
4. Saisissez la **description** de l'élément de salaire (facultatif).
5. Saisissez le nom de l'entreprise et le compte par défaut de la composante salariale dans le tableau Comptes.
6. **Enregistrer**.

![détails\_composante\_salariale.png](https://doc.dokos.io/content/payroll/details_composante_salariale.png)

## 2. Caractéristiques

### 2.1 Type de composante

Le champ **Type** détermine la nature de la composante et la façon dont elle est traitée dans la fiche de paie et dans le calcul du CTC :

| Type                     | Description                                                                                                                                                                                                |
| ------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Revenus**              | Éléments versés à l'employé (salaire de base, indemnités, primes…)                                                                                                                                         |
| **Déduction**            | Montants prélevés sur le salaire de l'employé (cotisations salariales, impôts…)                                                                                                                            |
| **Cotisation employeur** | Charges patronales non versées à l'employé mais incluses dans le coût total employeur (CTC). Ces composantes apparaissent dans une section dédiée de la fiche de paie et du rapport de ventilation du CTC. |

::callout{color="blue" icon="i-heroicons-information-circle"}
**Cotisation employeur**:br
Les composantes de type *Cotisation employeur* représentent les charges supportées par l'entreprise en plus du salaire net (ex. : cotisations patronales retraite, prévoyance, mutuelle employeur). Elles sont incluses dans le calcul du CTC mais ne figurent pas dans les gains ni les déductions de l'employé.
::

### 2.2 Champs supplémentaires

Certains des attributs supplémentaires de la composante salariale qui peuvent être activés à l'aide des cases à cocher sont les suivants :

- **Est payable** : Sélectionnez cette option si la composante salariale est payable.
- **Dépend des jours de paiement** : si cette case est cochée, la composante salariale sera calculée en fonction du nombre de jours ouvrables.
- **La taxe est-elle applicable** : cette case à cocher s'applique aux composants de gain. Cocher cette case permet d'appliquer la taxe sur cette composante salariale.
- **Déduire la totalité de l'impôt à la date de paie sélectionnée** : si cette case est cochée et que la composante est utilisée dans le salaire supplémentaire, le montant d'impôt applicable sur le montant supplémentaire sera déduit le mois de paie spécifique. Si elle n'est pas cochée, la taxe sera répartie sur les mois restants de la période de paie. Par exemple, si un bonus est accordé au cours d'un mois particulier à l'aide d'un salaire supplémentaire, vous pouvez alors déduire le montant total de l'impôt le même mois uniquement.
- **Arrondir à l'entier le plus proche** : Cocher cette case vous permet d'arrondir le montant de cette composante salariale à l'entier le plus proche.
- **Composante statistique** : Si cette option est sélectionnée, la valeur spécifiée ou calculée dans cette composante ne contribuera pas aux gains ou aux déductions. Cependant, sa valeur peut être référencée par d'autres composants qui peuvent être ajoutés ou déduits. Si vous définissez une composante salariale en tant que composante statistique, vous n'avez pas besoin de définir le compte par défaut pour la même chose. De plus, vous ne pourrez pas définir ce composant comme un avantage flexible.
- **Ne pas inclure dans le total** : cochez cette case pour garantir que la composante salariale n'est pas incluse dans le salaire total. Il est utilisé pour définir la composante qui fait partie de la CTC mais qui n'est pas payable (par exemple l'utilisation des voitures de société).
- **Variable basée sur le salaire imposable** : La composante est calculée automatiquement sur le revenu imposable en fonction de la tranche d'impôt sur le revenu applicable (par exemple, TDS ou impôt sur le revenu).
- **Exonéré d'impôt sur le revenu** : Si coché, le montant total sera déduit du revenu imposable avant le calcul de l'impôt sur le revenu sans aucune déclaration ni présentation de justificatif . Par exemple, la taxe professionnelle en Inde est déduite du revenu imposable avant le calcul de l'impôt sur le revenu.
- **Désactivé** : cette case à cocher peut être cochée pour désactiver cette composante salariale. Une composante salariale désactivée ne peut pas être utilisée dans la structure salariale.

![détails\_composante\_salariale.png](https://doc.dokos.io/content/payroll/details_composante_salariale.png)

### 2.3 Avantages flexibles

Cette section s'affiche si la composante salariale est une composante salariale. Les régimes d'avantages sociaux flexibles permettent aux employés de bénéficier des avantages qu'ils souhaitent ou dont ils ont besoin d'un ensemble de programmes offerts par un employeur. Ils peuvent inclure l'assurance maladie, les régimes de retraite, les frais de téléphone, etc. Pour définir un élément de salaire comme un avantage flexible, cochez la case **Est-ce un avantage flexible**.

Saisissez le montant annuel maximum de cet avantage flexible dans le champ &#x2A;*Montant maximum de l'avantage (annuel)**. Certains des attributs supplémentaires des avantages flexibles qui peuvent être activés à l'aide des cases à cocher sont les suivants :

- **Payer contre demande d'avantages** : cochez cette case si vous souhaitez payer cet avantage via la demande d'avantages sociaux .
- **Impact fiscal uniquement** (ne peut pas réclamer mais une partie du revenu imposable) : si elle est définie, l'avantage flexible fera partie du revenu imposable.
  Créer une écriture de paiement distincte pour la demande de prestations : Si cette case est cochée, elle vous permettra de créer une écriture de paiement distincte pour la demande de prestations.

![avantages\_sociaux\_variables.png](https://doc.dokos.io/content/payroll/avantages_sociaux_variables.png)

### 2.4 Comptes

Dans cette section, ajoutez le comptes comptable si nécessaire pour ce composant salarial.

Indiquez la société concernée et le compte comptable.

![compte\_composante.png](https://doc.dokos.io/content/payroll/compte_composante.png)

### 2.5 Condition et formule

Dans cette section, la condition et la formule requises pour le calcul de la composante salariale peuvent être spécifiées. Pour spécifier la formule, cochez la case **Montant basé sur la formule**.

Dans le cas où la Composante Salaire est basée sur un montant prédéfini, Dokos vous permet de saisir directement le montant dans le champ Montant (désactivez la case à cocher « Montant basé sur la formule »).

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
**Remarque** : Cette configuration ci-dessus est facultative. Vous pouvez également définir le montant et la formule/condition pour une composante salariale directement dans la structure salariale. S'ils sont spécifiés dans le document de la composante salariale lui-même, les informations seront directement récupérées dans la structure salariale lorsque la composante est sélectionnée.
::

![condition\_et\_formule.png](https://doc.dokos.io/content/payroll/condition_et_formule.png)

## 3. Exemple : configurer une cotisation patronale retraite

> **Situation** : Chez *Maison Verte SARL*, la direction souhaite modéliser la cotisation patronale retraite complémentaire (8 % du salaire brut) dans le CTC de chaque employé, sans que ce montant n'apparaisse dans la rémunération nette versée.

1. Créez une nouvelle composante salariale **Cotisation patronale retraite**.
2. Choisissez le type **Cotisation employeur**.
3. Cochez **Montant basé sur la formule** et saisissez : `gross_pay * 0.08`
4. Associez le compte comptable de charges patronales dans la section *Comptes*.
5. Enregistrez.
6. Ajoutez cette composante dans la grille des salaires dans le tableau dédié aux cotisations employeur.

Cette composante sera visible dans la section **Cotisations employeur** de la fiche de paie et dans le rapport **Ventilation du CTC**.


# Fiche de paie

Un bulletin de salaire est un document délivré à un employé. Il contient une description détaillée des éléments et des montants du salaire de l'employé.

---

Pour accéder à **la liste de fiche de paie**, allez sur :

> Accueil > Paie > **Fiche de paie**

![liste\_fiche\_de\_paie0.png](https://doc.dokos.io/content/payroll/salary-slip/liste_fiche_de_paie0.png)

## 1. Prérequis avant utilisation

Avant de créer un bulletin de salaire, il est conseillé de créer d'abord les éléments suivants :

- **[Employé](https://doc.dokos.io/v5/dokos/hrms/cycle-de-vie/employee)**
- **[Composante salariale](https://doc.dokos.io/v5/dokos/hrms/paie/salary-component)**
- **[Attribution de la structure salariale](https://doc.dokos.io/v5/dokos/hrms/paie/salary-structure-assignment)**

## 2. Comment créer une fiche de paie

1. Allez sur Fiche de paie, cliquez sur **➕ Ajouter Fiche de paie**.
2. Sélectionnez **Employé**. Lors de la sélection de l'employé, tous les détails de l'employé seront extraits de la structure salariale qui lui est attribuée. Cela inclut des détails tels que la fréquence de paie, les revenus, les retenues, etc.
3. Sélectionnez **Date de début** et **Date de fin**.
4. **Enregistrer**.

![détails\_fiche\_de\_paie.png](https://doc.dokos.io/content/payroll/salary-slip/details_fiche_de_paie.png)

## 3. Caractéristiques

### 3.1. Fiche de paie basée sur les présences/congés

Les utilisateurs RH peuvent créer un bulletin de salaire basé sur la présence ou les congés. Les jours de travail seront calculés sur la base du congé / présence, selon le domaine Calculer la paie de travail Jours sur la base de paramètres RH . Si la paie est basée sur l'assiduité, le congé sans solde sera considéré comme absent et la demi-journée sera considérée comme une demi-journée d'absence.

### 3.2. Fiche de paie basée sur la feuille de temps

Pour créer un bordereau de salaire basé sur une feuille de temps, vous devez créer une structure de salaire pour les feuilles de temps.

Dokos fournit également une option pour créer un bulletin de salaire basé sur les heures de travail basées sur la feuille de temps . Vous pouvez créer une fiche de salaire après avoir soumis la feuille de temps en cliquant directement sur le bouton Créer une fiche de salaire en haut à droite.

Le montant du paiement est calculé en fonction du taux horaire défini dans la structure salariale et est reflété dans le tableau des gains.

### 3.3 Cumul annuel et Cumul mensuel

Pour chaque fiche de salaire, &#x2A;*Année glissante (Devise société)**
et &#x2A;*Mois glissant (Devise société)** sont calculés.

**Cumul annuel** : Salaire total enregistré pour cet employé particulier depuis le début de l'année (période de paie ou exercice financier) jusqu'à la date de fin du bulletin de salaire en cours. :br**Cumul mensuel** : Salaire total enregistré pour un employé particulier depuis le début du mois (pour lequel l'écriture de paie est créée) jusqu'à la date de fin du bulletin de salaire en cours.

L'année à ce jour est également calculée pour chaque élément des tables de gains et de déductions. Le format d'impression **Bulletin de salaire avec cumul annuel** est disponible avec les calculs cumulatifs annuels et cumulatifs mensuels.

![cumul\_fiche\_de\_paie.png](https://doc.dokos.io/content/payroll/salary-slip/cumul_fiche_de_paie.png)

### 3.4 Envoi de la fiche de paie à l'employé

Lors de la soumission d'une fiche de paie, Dokos peut envoyer automatiquement un e-mail à l'employé contenant son bulletin de salaire.

**Envoi différé selon la date de comptabilisation**

Si la **date de comptabilisation** de la fiche de paie est dans le futur, l'e-mail n'est pas envoyé immédiatement. Il est placé en file d'attente et ne sera transmis à l'employé qu'à partir de cette date.

Cela s'applique aussi bien :

- à la soumission manuelle d'une fiche de paie individuelle,
- qu'à la soumission en masse via une &#x2A;*[Entrée de la paie](https://doc.dokos.io/v5/dokos/hrms/paie/payroll-entry)**.

::callout{color="blue" icon="i-heroicons-information-circle"}
**Exemple** : Si vous soumettez le 21 avril la fiche de paie d'une employée avec une date de comptabilisation au 30 avril, elle ne recevra son bulletin par e-mail qu'à partir du 30 avril.
::

Ce comportement garantit que les employés ne reçoivent pas leur bulletin de salaire avant la date officielle de paie, même lorsque le traitement de la paie est effectué en avance.


# Grille des salaires

La structure salariale est le détail du salaire offert à un employé, en termes de répartition des différentes composantes constituant la rémunération.

Toute modification de la structure salariale, c'est-à-dire parmi les composants, peut avoir un impact majeur sur ce que fait l'employé, comme le type d'exonération fiscale réclamée.

Dokos vous permet de définir les gains et les déductions d'une structure salariale, la fréquence de paie et le mode de paiement, entre autres fonctionnalités.

---

Pour accéder à **la liste de grilles des salaires**, allez sur :

> Accueil > Paie > **Grilles des salaires**

![liste.png](https://doc.dokos.io/content/payroll/salary-structure/liste.png)

## 1. Prérequis avant utilisation

Avant de créer une structure salariale, il est conseillé de créer les éléments suivants :

- **[Composante salariale](https://doc.dokos.io/v5/dokos/hrms/paie/salary-component)**

## 2. Comment créer une structure salariale

1. Accédez à la liste Structure salariale, cliquez sur **➕ Ajouter Grille des salaires**.
2. Saisissez le **nom de la structure salariale**.
3. Sélectionnez le **nom de l'entreprise** et la **fréquence de paie**.
4. **Enregistrer** et envoyer.

![détails\_grille\_salaires.png](https://doc.dokos.io/content/payroll/salary-structure/details_grille_salaires.png)

## 3. Caractéristiques

### 3.1 Structure salariale pour le salaire basé sur les feuilles de temps

![fiche\_de\_temps.png](https://doc.dokos.io/content/payroll/salary-structure/fiche_de_temps.png)

Dans Dokos, vous pouvez également définir la structure salariale pour le bordereau de salaire basée sur la feuille de temps, ce qui permet à l'entreprise de payer l'employé selon les heures de travail.

Étapes pour créer une structure salariale basée sur les feuilles de temps :

1. Cochez la case Bulletin de salaire basé sur la feuille de temps .
2. Sélectionnez la composante salariale.
3. Entrez le taux horaire. Sur la base du taux entré, le montant des heures de travail pour la composante salariale sélectionnée sera calculé en conséquence.

#### Montant d'encaissement des congés par jour

S'il existe des congés encaissables pour un employé, vous pouvez définir le montant d'encaissement des congés par jour dans ce champ pour cette structure salariale particulière. Sur la base de la « composante de revenu » définie dans le type de congé encaissé et du montant par jour, la valeur de la composante de salaire sera calculée en conséquence dans le bordereau de salaire.

#### Prestations maximales (montant)

Dans ce champ, le montant maximum des avantages pour la structure salariale peut être spécifié. Si ce champ est rempli, assurez-vous que la structure salariale a une composante salariale avec la case « Est-ce que les avantages sont flexibles » coché, contre laquelle ce montant sera payé.

Une fois que toutes les informations sont enregistrées et soumises, vous pouvez attribuer la structure salariale à un employé via le bouton Attribuer une structure salariale ou en créant une nouvelle affectation de structure salariale via le tableau de bord.

Vous pouvez également affecter la structure salariale créée à plusieurs employés en fonction du grade de l' employé , du service , de la désignation , etc. via le bouton « Attribuer aux employés ». De plus, le bulletin de salaire peut également être créé directement via le tableau de bord.

### 3.2 Bénéfices et déductions

Les gains spécifient les éléments de salaire gagnés par un employé. Ces composants comprennent généralement les indemnités de base, les indemnités, les primes et les incitations qui sont ajoutées au salaire total de l'employé. D'autre part, les déductions spécifient les éléments de salaire qui sont déduits du salaire total de l'employé. Ceux-ci incluent généralement les taxes.

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
**Remarque** : Seuls les éléments de salaire définis comme « gains » seront affichés dans le tableau des gains et les éléments définis comme « retenues » seront affichés dans le tableau des déductions.
::

Pour créer des Revenus et des Déductions, sélectionnez la Composante Salaire dans la colonne Composant. Saisissez la formule/condition si elle n'a pas été spécifiée précédemment lors de la création de la composante salariale. De plus, vous pouvez également saisir un montant prédéfini dans la colonne Montant.

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
**Remarque** : Assurez-vous de cliquer sur la flèche vers le bas et d'activer la case à cocher « Montant basé sur la formule » au cas où la composante salariale est calculée à l'aide d'une formule.
::

![bénéfices\_déductions.png](https://doc.dokos.io/content/payroll/salary-structure/benefices_deductions.png)

### 3.3 Cotisations employeur

Un tableau dédié **Cotisations employeur** permet d'ajouter les composantes salariales de type *Cotisation employeur* (ex. : charges patronales retraite, prévoyance, mutuelle patronale).

Ces composantes sont filtrées automatiquement : seules les composantes dont le type est **Cotisation employeur** peuvent être sélectionnées dans ce tableau. Elles ne figurent pas dans le tableau des gains ni dans le tableau des déductions.

::callout{color="blue" icon="i-heroicons-information-circle"}
Les cotisations employeur sont incluses dans le calcul du **CTC (Coût Total Employeur)** mais ne sont pas versées directement à l'employé. Elles apparaissent dans une section dédiée de la fiche de paie et dans le rapport **[Ventilation du CTC employé](https://doc.dokos.io/v5/dokos/hrms/paie/employee-ctc-breakup)**.
::

### 3.4 Compte

Dans cette section, le mode de paiement et le compte de paiement utilisé pour payer le salaire peuvent être spécifiés.

![compte.png](https://doc.dokos.io/content/payroll/salary-structure/compte.png)


# Attribution de la structure salariale

Le formulaire d'attribution de la structure salariale vous permet d'affecter une structure salariale particulière à l'employé.

Dans Dokos, vous pouvez créer plusieurs attributions de structure salariale pour le même employé pour différentes périodes.

---

Pour accéder à **la liste attribution de la structure salariale**, allez sur :

> Accueil > Paie > **Attribution de la structure salariale**

![liste\_attribution.png](https://doc.dokos.io/content/payroll/salary-structure-assignment/liste_attribution.png)

## 1. Prérequis avant utilisation

Avant de créer une affectation de structure salariale, il est conseillé de disposer des documents suivants :

- **[Employé](https://doc.dokos.io/v5/dokos/hrms/cycle-de-vie/employee)**
- **[Composante salariale](https://doc.dokos.io/v5/dokos/hrms/paie/salary-component)**
- **[Grilles des salaires](https://doc.dokos.io/v5/dokos/hrms/paie/salary-structure)**

## 2. Comment créer une affectation de structure salariale :

1. Accédez à la liste des affectations de structure salariale et cliquez sur **➕ Ajouter Attribution de la structure salariale**.
2. Sélectionnez l'**employé** et la **grille des salaires**.
3. Sélectionnez la **date de début** à partir de laquelle cette structure salariale particulière sera applicable.
4. Entrez le **montant de base** et le **montant variable** selon les besoins. Le montant de base fait référence au salaire de base de l'employé, qui est fixe et versé, indépendamment de l'atteinte des objectifs par les employés. La rémunération variable, d'autre part, est la partie de la rémunération des ventes déterminée par la performance des employés. Lorsque les employés atteignent leurs objectifs (également appelés quotas), une rémunération variable est fournie sous forme de bonus, de rémunération incitative ou de commission.
5. (Optionnel) Renseignez le champ **CTC** avec le coût total employeur annuel si vous souhaitez utiliser le rapport de ventilation du CTC.

![détails\_attribution\_structure.png](https://doc.dokos.io/content/payroll/salary-structure-assignment/details_attribution_structure.png)

### 2.1 Autres façons de créer une affectation de structure salariale

Vous pouvez également affecter une grille des salaires aux employés directement via le document Structure salariale. Pour affecter la structure salariale à un seul employé, cliquez sur le bouton « Attribuer une structure salariale » dans le document Structure salariale.

Si vous souhaitez affecter en bloc la structure salariale à plusieurs employés, vous pouvez le faire via le bouton **Attribuer aux employés**.

Vous pouvez éventuellement filtrer les employés en fonction du grade de l'employé, du service, de la désignation et de l'employé lui-même.

Une fois cela fait, cliquez sur le bouton « Attribuer » pour attribuer la structure salariale en conséquence.

## 3. Champ CTC (Coût Total Employeur)

Le champ **CTC*&#x2A; permet de saisir le montant annuel total que l'entreprise s'engage à verser pour l'employé (package global). Ce montant est utilisé par le rapport &#x2A;*[Ventilation du CTC employé](https://doc.dokos.io/v5/dokos/hrms/paie/employee-ctc-breakup)** pour calculer la part de chaque composante salariale dans le coût total.

::callout{color="blue" icon="i-heroicons-information-circle"}
Le CTC est renseigné au niveau de l'attribution (et non de la fiche employé) afin de pouvoir suivre les évolutions de package au fil du temps, une attribution par période.
::

## 4. Rapport de ventilation du CTC

Un bouton **Ventilation du CTC** est disponible directement sur le formulaire d'attribution de structure salariale. Il ouvre le rapport pré-filtré sur l'employé et l'attribution concernés.

Ce rapport affiche :

- Une carte de profil de l'employé
- Les indicateurs clés (CTC annuel, CTC par cycle, salaire brut, salaire net)
- Le détail de chaque composante salariale avec son montant, son montant annualisé et sa part dans le CTC

→ Consultez la page &#x2A;*[Ventilation du CTC employé](https://doc.dokos.io/v5/dokos/hrms/paie/employee-ctc-breakup)** pour plus de détails.


# API

::swagger{app="hrms"}
::


# v2.0.0

::callout{color="red" icon="i-heroicons-fire"}
Si vous êtes Responsable Système de votre site Dokos, veuillez prendre connaissance des informations de migration ci-dessous avant la mise à jour de votre site.

Veuillez aussi consulter les informations concernant [Dokos](https://doc.dokos.io/v5/dokos/versions/v4.x.x/v4_0_0) et [Dodock](https://doc.dokos.io/v5/dodock/versions/v4.x.x/v4_0_0).
::

::callout
La version 2.0.0 de HRMS est basée sur la version 15 de Frappe HRMS.
Une grande partie des changements cités ci-dessous ont été développés par l'équipe de Frappe Technologies et les contributeurs aux logiciels de l'éco-système Frappe/ERPNext
Le détail des changements publiés dans Dokos est disponible sur [GitLab](https://gitlab.com/dokos/hrms/-/releases){rel=""nofollow""}
::

## Fonctionnalités et améliorations

- Ajout du champ de titre dans les modèles d'intégration des employés et de séparation des employés par niraj2477 [*hrms#950*](https://github.com/frappe/hrms/pull/950){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!139](https://gitlab.com/dokos/hrms/-/merge_requests/139){rel="&#x22;nofollow&#x22;"}**
- Action en masse par e-mail sur les bulletins de salaire dans la vue d'ensemble des bulletins de salaire par ruchamahabal [*hrms#1063*](https://github.com/frappe/hrms/pull/1063){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!134](https://gitlab.com/dokos/hrms/-/merge_requests/134){rel="&#x22;nofollow&#x22;"}**
- (Note de frais) Ajout de boutons pour naviguer vers les types de dépenses et revenir &#x2A;*[!131](https://gitlab.com/dokos/hrms/-/merge_requests/131){rel="&#x22;nofollow&#x22;"}**
- Progressive Web App - Congés, Demandes, Avances et Bulletins de salaire par ruchamahabal [*hrms#1041*](https://github.com/frappe/hrms/pull/1041){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!125](https://gitlab.com/dokos/hrms/-/merge_requests/125){rel="&#x22;nofollow&#x22;"}**
- (util): Ajout d'une provision pour obtenir les jours fériés sauf les jours de repos hebdomadaires de la liste des jours fériés par ruchamahabal [*hrms#1011*](https://github.com/frappe/hrms/pull/1011){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!119](https://gitlab.com/dokos/hrms/-/merge_requests/119){rel="&#x22;nofollow&#x22;"}**
- Ajout du expéditeur dans les paramètres de paie et les paramètres RH par niraj2477 [*hrms#988*](https://github.com/frappe/hrms/pull/988){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!117](https://gitlab.com/dokos/hrms/-/merge_requests/117){rel="&#x22;nofollow&#x22;"}**
- (Paie): Ajout d'un filtre de grade d'employé dans l'entrée de paie par niraj2477 [*hrms#960*](https://github.com/frappe/hrms/pull/960){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!116](https://gitlab.com/dokos/hrms/-/merge_requests/116){rel="&#x22;nofollow&#x22;"}**
- Ajout des options Sélectionner/Désélectionner tout dans la boîte de dialogue de marquage de la présence par creative-paramu [*hrms#1005*](https://github.com/frappe/hrms/pull/1005){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!113](https://gitlab.com/dokos/hrms/-/merge_requests/113){rel="&#x22;nofollow&#x22;"}**
- Améliorations de l'indemnisation des congés par ruchamahabal [*hrms#817*](https://github.com/frappe/hrms/pull/817){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!105](https://gitlab.com/dokos/hrms/-/merge_requests/105){rel="&#x22;nofollow&#x22;"}**
- (Employé): Mise à jour du statut du candidat et de l'offre d'emploi lors de l'insertion par krantheman [*hrms#957*](https://github.com/frappe/hrms/pull/957){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!101](https://gitlab.com/dokos/hrms/-/merge_requests/101){rel="&#x22;nofollow&#x22;"}**
- (Intégration des employés): Ajout d'un bouton Marquer comme terminé pour les intégrations en attente/en cours par krantheman [*hrms#961*](https://github.com/frappe/hrms/pull/961){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!100](https://gitlab.com/dokos/hrms/-/merge_requests/100){rel="&#x22;nofollow&#x22;"}**
- Option pour clore les objectifs par niraj2477 [*hrms#886*](https://github.com/frappe/hrms/pull/886){rel="&#x22;nofollow&#x22;"}
- (Paramètres de paie): Prise en compte de la présence marquée les jours fériés par ruchamahabal [*hrms#915*](https://github.com/frappe/hrms/pull/915){rel="&#x22;nofollow&#x22;"}
- Autoriser l'importation (via l'outil d'importation de données) pour les types de documents Candidat et Offre d'emploi par zeel-codder [*hrms#882*](https://github.com/frappe/hrms/pull/882){rel="&#x22;nofollow&#x22;"}
- hide\_payroll
- expense\_claim\_improvement
- (Paramètres de paie): Considération de la présence marquée les jours fériés pour le composant de l'impôt sur le revenu par ruchamahabal [*hrms#820*](https://github.com/frappe/hrms/pull/820){rel="&#x22;nofollow&#x22;"}
- Ajout du rapport d'assiduité par shift par krantheman [*hrms#775*](https://github.com/frappe/hrms/pull/775){rel="&#x22;nofollow&#x22;"}
- Ajout du champ 'Shift' &#x2A;*[*hrms#762*](https://github.com/frappe/hrms/pull/762){rel="&#x22;nofollow&#x22;"}**
- Notification aux utilisateurs concernant la séparation de l'application de prêt pour l'intégration de la paie par ruchamahabal [*hrms#697*](https://github.com/frappe/hrms/pull/697){rel="&#x22;nofollow&#x22;"}
- Maître d'élément de service de véhicule pour les options de service [*hrms#753*](https://github.com/frappe/hrms/pull/753){rel="&#x22;nofollow&#x22;"}
- deepeshgarg007/eslint [*hrms#726*](https://github.com/frappe/hrms/pull/726){rel="&#x22;nofollow&#x22;"}
- ruchamahabal/conflicting-shifts [*hrms#709*](https://github.com/frappe/hrms/pull/709){rel="&#x22;nofollow&#x22;"}

- **[Autoriser l'accès en lecture à la fonction "Checkin" pour les employés aux utilisateurs en libre-service](https://gitlab.com/dokos/hrms/-/merge_requests/24){rel="&#x22;nofollow&#x22;"}**
- Intégration d'un graphique pour la représentation visuelle des structures hiérarchiques

## Refonte du code et des fonctionnalités existantes

- **[Validation des présences pour la paie par ruchamahabal](https://gitlab.com/dokos/hrms/-/merge_requests/28){rel="&#x22;nofollow&#x22;"}*&#x2A; &#x2A;[hrms#705](https://github.com/frappe/hrms/pull/705){rel="&#x22;nofollow&#x22;"}*
- **[Intégration de la vue Calendrier pour les Demandes de Congés dans hook.py](https://gitlab.com/dokos/hrms/-/merge_requests/16){rel="&#x22;nofollow&#x22;"}**
- **[Amélioration de la paie basée sur les feuilles de temps en ignorant la fréquence de paie par saurabh6790](https://gitlab.com/dokos/hrms/-/merge_requests/12){rel="&#x22;nofollow&#x22;"}*&#x2A; &#x2A;[hrms#612](https://github.com/frappe/hrms/pull/612){rel="&#x22;nofollow&#x22;"}*
- Modifications de la séparation de l'application de prêt
- Définition de fetch\_from pour l'entreprise dans le type de document "Présence" et suppression des appels inutiles à la base de données
- Simplification de la récupération exacte des horaires

## Amélioration de la performance

- Rapport plus rapide des soldes de congés des employés par ruchamahabal [*hrms#1077*](https://github.com/frappe/hrms/pull/1077){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!137](https://gitlab.com/dokos/hrms/-/merge_requests/137){rel="&#x22;nofollow&#x22;"}**
- Traitement automatique par lot et validation de la présence par ruchamahabal [*hrms#1022*](https://github.com/frappe/hrms/pull/1022){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!118](https://gitlab.com/dokos/hrms/-/merge_requests/118){rel="&#x22;nofollow&#x22;"}**
- Mise en file d'attente de l'annulation de l'entrée de paie par ruchamahabal [*hrms#964*](https://github.com/frappe/hrms/pull/964){rel="&#x22;nofollow&#x22;"}
- Paie plus rapide : Partie 2 (bulletin de salaire) par saurabh6790 [*hrms#470*](https://github.com/frappe/hrms/pull/470){rel="&#x22;nofollow&#x22;"}

- **[Optimisation : Indexation du type de poste et de l'employé dans l'attribution des postes](https://gitlab.com/dokos/hrms/-/merge_requests/28){rel="&#x22;nofollow&#x22;"}**
- **[Amélioration : Marquage des absences dans l'auto-présence](https://gitlab.com/dokos/hrms/-/merge_requests/12){rel="&#x22;nofollow&#x22;"}**

## Maintenance et organisation

- **[Optimisation : Élimination des imports Jinja](https://gitlab.com/dokos/hrms/-/merge_requests/29){rel="&#x22;nofollow&#x22;"}**
- **[Amélioration : Ajout d'informations manquantes dans les commentaires des paramètres](https://gitlab.com/dokos/hrms/-/merge_requests/32){rel="&#x22;nofollow&#x22;"}**
- **[Simplification : Suppression de setup.py et requirements.txt](https://gitlab.com/dokos/hrms/-/merge_requests/17){rel="&#x22;nofollow&#x22;"}**
- Transfert des dépendances vers Dodock


# v2.1.0

::callout
La version 2.1.0 de HRMS est basée sur la version 15 de Frappe HRMS.
Une grande partie des changements cités ci-dessous ont été développés par l'équipe de Frappe Technologies et les contributeurs aux logiciels de l'éco-système Frappe/ERPNext
Le détail des changements publiés dans Dokos est disponible sur [GitLab](https://gitlab.com/dokos/hrms/-/releases){rel=""nofollow""}
::

## Fonctionnalités et améliorations

- **Add new doctype for Job offer Term Template *by niraj2477*** [*hrms#1089*](https://github.com/frappe/hrms/pull/1089){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!191](https://gitlab.com/dokos/hrms/-/merge_requests/191){rel="&#x22;nofollow&#x22;"}**
- **(Interview): Add setting for sender in interview & interview feedback reminder emails *by niraj2477*** [*hrms#1033*](https://github.com/frappe/hrms/pull/1033){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!188](https://gitlab.com/dokos/hrms/-/merge_requests/188){rel="&#x22;nofollow&#x22;"}**
- **Add Amount Based on Formula to list view & fix UX *by krantheman*** [*hrms#1113*](https://github.com/frappe/hrms/pull/1113){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!164](https://gitlab.com/dokos/hrms/-/merge_requests/164){rel="&#x22;nofollow&#x22;"}**
- **Job Portal Enhancements *by krantheman*** [*hrms#835*](https://github.com/frappe/hrms/pull/835){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!162](https://gitlab.com/dokos/hrms/-/merge_requests/162){rel="&#x22;nofollow&#x22;"}**
- **Option to enable/disable multiple Shift Assignments for same dates *by krantheman*** [*hrms#1100*](https://github.com/frappe/hrms/pull/1100){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!159](https://gitlab.com/dokos/hrms/-/merge_requests/159){rel="&#x22;nofollow&#x22;"}**
- **Expense doctype*&#x2A; &#x2A;*[!144](https://gitlab.com/dokos/hrms/-/merge_requests/144){rel="&#x22;nofollow&#x22;"}**
- **(PWA): Workflow support + other enhancements *by ruchamahabal*** [*hrms#1105*](https://github.com/frappe/hrms/pull/1105){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!155](https://gitlab.com/dokos/hrms/-/merge_requests/155){rel="&#x22;nofollow&#x22;"}**

## Corrections de bugs

- **Comp leave request fails on leave period boundary dates *by ruchamahabal*** [*hrms#1255*](https://github.com/frappe/hrms/pull/1255){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!201](https://gitlab.com/dokos/hrms/-/merge_requests/201){rel="&#x22;nofollow&#x22;"}**
- **Update job applicant status on interview submit *by zeel-codder*** [*hrms#892*](https://github.com/frappe/hrms/pull/892){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!186](https://gitlab.com/dokos/hrms/-/merge_requests/186){rel="&#x22;nofollow&#x22;"}**
- **Url encoding in job application routes *by ruchamahabal**&#x2A; &#x2A;*[!199](https://gitlab.com/dokos/hrms/-/merge_requests/199){rel="&#x22;nofollow&#x22;"}**
- **NoneType' Iteration Error in Salary Slip Loan Processing *by KhaledBinAmir*** [*hrms#1247*](https://github.com/frappe/hrms/pull/1247){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!197](https://gitlab.com/dokos/hrms/-/merge_requests/197){rel="&#x22;nofollow&#x22;"}**
- **Url encoding in job application routes *by ruchamahabal*** [*hrms#1251*](https://github.com/frappe/hrms/pull/1251){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!196](https://gitlab.com/dokos/hrms/-/merge_requests/196){rel="&#x22;nofollow&#x22;"}**
- **Expense claim taxes calculation*&#x2A; &#x2A;*[!193](https://gitlab.com/dokos/hrms/-/merge_requests/193){rel="&#x22;nofollow&#x22;"}**
- Temporary fix for HRA exemption tests
- Tests for France leaves in 2024
- **Expense doctype issues*&#x2A; &#x2A;*[!192](https://gitlab.com/dokos/hrms/-/merge_requests/192){rel="&#x22;nofollow&#x22;"}**
- **#1226 local variable "days\_to\_add" referenced before assignment (backport #1227) &#x2A;by mergify [bot]*** [*hrms#1231*](https://github.com/frappe/hrms/pull/1231){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!189](https://gitlab.com/dokos/hrms/-/merge_requests/189){rel="&#x22;nofollow&#x22;"}**
- **(Org Chart): Check if company is set before loading children *by ruchamahabal*** [*hrms#1220*](https://github.com/frappe/hrms/pull/1220){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!185](https://gitlab.com/dokos/hrms/-/merge_requests/185){rel="&#x22;nofollow&#x22;"}**
- **Avoid assigning undefined*&#x2A; &#x2A;*[!184](https://gitlab.com/dokos/hrms/-/merge_requests/184){rel="&#x22;nofollow&#x22;"}**
- **Duplicate Overwritten Salary error for other employee *by HoFaks*** [*hrms#1217*](https://github.com/frappe/hrms/pull/1217){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!183](https://gitlab.com/dokos/hrms/-/merge_requests/183){rel="&#x22;nofollow&#x22;"}**
- **(Payroll): Accrual entry creation fails if any employee has no earnings *by ruchamahabal*** [*hrms#1214*](https://github.com/frappe/hrms/pull/1214){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!182](https://gitlab.com/dokos/hrms/-/merge_requests/182){rel="&#x22;nofollow&#x22;"}**
- **Retention Bonus doc cancellation. *by SajadAlimoradi*** [*hrms#1189*](https://github.com/frappe/hrms/pull/1189){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!181](https://gitlab.com/dokos/hrms/-/merge_requests/181){rel="&#x22;nofollow&#x22;"}**
- **Rewrite attendance query in qb & add test for half-day attendance overwritten by leave application *by ruchamahabal*** [*hrms#1205*](https://github.com/frappe/hrms/pull/1205){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!180](https://gitlab.com/dokos/hrms/-/merge_requests/180){rel="&#x22;nofollow&#x22;"}**
- **(france): Don't overwrite Leave Type if modified between migrations*&#x2A; &#x2A;*[!179](https://gitlab.com/dokos/hrms/-/merge_requests/179){rel="&#x22;nofollow&#x22;"}**
- **(migrate): Update custom fields after migration*&#x2A; &#x2A;*[!178](https://gitlab.com/dokos/hrms/-/merge_requests/178){rel="&#x22;nofollow&#x22;"}**
- **Half Day Leave Application Link To Half Day Attendance *by creative-paramu*** [*hrms#1147*](https://github.com/frappe/hrms/pull/1147){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!177](https://gitlab.com/dokos/hrms/-/merge_requests/177){rel="&#x22;nofollow&#x22;"}**
- **Journals as invoice throwing validation error" *by ruthra-kumar*** [*hrms#1192*](https://github.com/frappe/hrms/pull/1192){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!175](https://gitlab.com/dokos/hrms/-/merge_requests/175){rel="&#x22;nofollow&#x22;"}**
- **French translations*&#x2A; &#x2A;*[!174](https://gitlab.com/dokos/hrms/-/merge_requests/174){rel="&#x22;nofollow&#x22;"}**
- **Payroll entry fixes*&#x2A; &#x2A;*[!173](https://gitlab.com/dokos/hrms/-/merge_requests/173){rel="&#x22;nofollow&#x22;"}**
- **Rerun France setup*&#x2A; &#x2A;*[!172](https://gitlab.com/dokos/hrms/-/merge_requests/172){rel="&#x22;nofollow&#x22;"}**
- **Remove failing patch*&#x2A; &#x2A;*[!170](https://gitlab.com/dokos/hrms/-/merge_requests/170){rel="&#x22;nofollow&#x22;"}**
- **Journals as invoice throwing validation error *by ruthra-kumar*** [*hrms#1185*](https://github.com/frappe/hrms/pull/1185){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!169](https://gitlab.com/dokos/hrms/-/merge_requests/169){rel="&#x22;nofollow&#x22;"}**
- **Consider previous Leave Applications while enforcing Maximum Consecutive Leaves Allowed *by krantheman*** [*hrms#1097*](https://github.com/frappe/hrms/pull/1097){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!168](https://gitlab.com/dokos/hrms/-/merge_requests/168){rel="&#x22;nofollow&#x22;"}**
- **(PWA): Validate mandatory fields in form view on client-side *by ruchamahabal*** [*hrms#1178*](https://github.com/frappe/hrms/pull/1178){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!167](https://gitlab.com/dokos/hrms/-/merge_requests/167){rel="&#x22;nofollow&#x22;"}**
- **Interview reminder settings not respected *by ruchamahabal*** [*hrms#1175*](https://github.com/frappe/hrms/pull/1175){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!166](https://gitlab.com/dokos/hrms/-/merge_requests/166){rel="&#x22;nofollow&#x22;"}**
- **(Leave Application): Resolved leave type missing for accurate payroll processing *by Gubbu77*** [*hrms#1148*](https://github.com/frappe/hrms/pull/1148){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!165](https://gitlab.com/dokos/hrms/-/merge_requests/165){rel="&#x22;nofollow&#x22;"}**
- **Disable Same Date Multiple Shift Assignments by default *by krantheman*** [*hrms#1157*](https://github.com/frappe/hrms/pull/1157){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!160](https://gitlab.com/dokos/hrms/-/merge_requests/160){rel="&#x22;nofollow&#x22;"}**
- **Creation of duplicate Additional Salary with Overwrite Salary Structure Amount enabled *by krantheman*** [*hrms#1108*](https://github.com/frappe/hrms/pull/1108){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!158](https://gitlab.com/dokos/hrms/-/merge_requests/158){rel="&#x22;nofollow&#x22;"}**
- **Check the leave type name instead of leave\_type\_name*&#x2A; &#x2A;*[!157](https://gitlab.com/dokos/hrms/-/merge_requests/157){rel="&#x22;nofollow&#x22;"}**
- **PWA fixes *by ruchamahabal*** [*hrms#1138*](https://github.com/frappe/hrms/pull/1138){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!156](https://gitlab.com/dokos/hrms/-/merge_requests/156){rel="&#x22;nofollow&#x22;"}**
- **Translation in msg*&#x2A; &#x2A;*[!153](https://gitlab.com/dokos/hrms/-/merge_requests/153){rel="&#x22;nofollow&#x22;"}**
- **Package.json*&#x2A; &#x2A;*[!152](https://gitlab.com/dokos/hrms/-/merge_requests/152){rel="&#x22;nofollow&#x22;"}**

## Maintenance et organisation

- **Cleanup interviews *by krantheman*** [*hrms#924*](https://github.com/frappe/hrms/pull/924){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!195](https://gitlab.com/dokos/hrms/-/merge_requests/195){rel="&#x22;nofollow&#x22;"}**
- **(PWA): Realtime updates, caching & invalidation *by ruchamahabal*** [*hrms#1191*](https://github.com/frappe/hrms/pull/1191){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!176](https://gitlab.com/dokos/hrms/-/merge_requests/176){rel="&#x22;nofollow&#x22;"}**

## Tests et intégration continue

- **Fix installation in setup & flaky tests *by ruchamahabal**&#x2A; &#x2A;*[!203](https://gitlab.com/dokos/hrms/-/merge_requests/203){rel="&#x22;nofollow&#x22;"}**
- **Fix installation in setup & flaky tests *by ruchamahabal*** [*hrms#1254*](https://github.com/frappe/hrms/pull/1254){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!200](https://gitlab.com/dokos/hrms/-/merge_requests/200){rel="&#x22;nofollow&#x22;"}**
- **Fix flaky tests + related refactors *by ruchamahabal*** [*hrms#1233*](https://github.com/frappe/hrms/pull/1233){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!190](https://gitlab.com/dokos/hrms/-/merge_requests/190){rel="&#x22;nofollow&#x22;"}**
- **(Additional Salary): Overwrite Salary Structure Amount *by krantheman*** [*hrms#1160*](https://github.com/frappe/hrms/pull/1160){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!163](https://gitlab.com/dokos/hrms/-/merge_requests/163){rel="&#x22;nofollow&#x22;"}**

---

**Contributeurs**

- **krantheman** (142)
- **Rucha Mahabal** (94)
- **Charles-Henri Decultot** (29)
- **Akash Tom** (5)
- **Corentin Forler** (2)
- **Khaled Bin Amir** (2)
- **Niraj Gautam** (2)
- **ruthra kumar** (2)
- **HoFaks** (1)
- **Indrajith.vs** (1)

et 3 autres contributeurs…

- Parameshwari Palanisamy
- Sajad Alimoradi
- zeel prajapati

---

**Différentiel complet:** [v2.0.0...v2.1.0](https://gitlab.com/dokos/hrms/-/compare/v2.0.0...v2.1.0){rel="&#x22;nofollow&#x22;"}:br&#x2A;*Tag:** [v2.1.0](https://gitlab.com/dokos/hrms/-/tags/v2.1.0){rel="&#x22;nofollow&#x22;"}


# Paramètres RH

Les paramètres RH permettent de configurer des paramètres globaux pour les documents liés au module HRMS.

---

Pour accéder à **la liste des paramètres RH**, allez sur :

> Accueil > Ressources humaines > Paramètres > **Paramètres RH**

Différents paramètres sont disponibles dans les paramètres HR.

## 1. Paramètres des employés

### 1.1. L'âge de la retraite

Vous pouvez saisir l'âge de départ à la retraite (en années) de vos salariés.

### 1.2 Dossiers des employés à créer par

La dénomination des documents des employés est basée sur la valeur sélectionnée dans ce champ.

- **Série de nommage** : Les documents d'employé créés seront nommés en utilisant la série de nommage sélectionnée dans le champ 'Série'.
- **Numéro d'employé** : Le champ Numéro d'employé devient visible en sélectionnant ce champ, et la dénomination du document d'employé se fait en fonction de ce champ.
- **Nom complet** : Le document de l'employé est nommé en utilisant le nom complet de l'employé.

### 1.3 Arrêter les rappels d'anniversaire

Un e-mail est envoyé à tous les employés de l'entreprise lorsqu'un employé a un anniversaire. Pour empêcher l'envoi de cet e-mail, vous pouvez cocher cette option.

### 1.4 Approbateur des dépenses obligatoire dans la demande de remboursement

Dans le document de demande de remboursement, le champ « Approbateur de dépenses » est défini sur obligatoire lorsque vous cochez cette option.

Les paramètres de paie feront partie des paramètres de RH jusqu'à la version 1.4.0 Dans la version 2.0.0, les paramètres de paie feront partie du nouveau module, Paie.

## 2. Paramètres de paie

### 2.1 Calculer les jours de travail payés sur la base de

Les jours ouvrables dans le bulletin de salaire peuvent être calculés sur la base des congés ou de présence. Vous pouvez sélectionner l'option en fonction de ce que vous souhaitez calculer.

### 2.2 Heures de travail max par rapport à la feuille de temps

Pour les fiches de salaire basées sur la feuille de temps, vous pouvez définir le nombre maximum d'heures autorisées par rapport à une seule feuille de temps. Définissez cette valeur sur zéro pour désactiver cette validation.

### 2.3 Inclure les vacances dans le nombre total de jours ouvrés

Si coché, le nombre total de jours ouvrables inclura les jours fériés, ce qui réduira la valeur du salaire par jour.

### 2.4 Désactiver le total arrondi

Vous pouvez l'activer pour désactiver l'arrondi du montant total dans les bulletins de salaire.

### 2.5 Fraction du salaire quotidien pour une demi-journée

Sur la base de cette fraction, le salaire pour la demi-journée sera calculé. Par exemple, si la valeur est définie sur 0,5, la moitié du salaire sera attribuée pour une demi-journée de présence.

### 2.6 Envoyer la fiche de paie à l'employé par Mail

Un e-mail avec le bulletin de salaire est envoyé à l'adresse e-mail préférée de l'employé respectif lors de la soumission du bulletin de salaire.

### 2.7 Crypter les fiches de salaire dans les e-mails

Le bulletin de salaire PDF envoyé à l'employé est crypté à l'aide de la politique de mot de passe mentionnée.

### 2.8 Politique de mot de passe

Ce champ devient visible et obligatoire en cochant l'option ci-dessus pour crypter le bulletin de salaire dans l'email.

Voici un exemple de la façon de définir une politique de mot de passe pour le bulletin de salaire PDF.

Exemple:

```text
SAL-{first_name}-{date_of_birth.yea)
```

Cela générera un mot de passe comme SAL-Jane-1972

### 2.9 Afficher le solde de congés dans la fiche de paie

Si coché, alors la fiche de paie indiquera le solde des congés de l'employé.

## 3. Paramètres des congés

![paramètres\_des\_congés.png](https://doc.dokos.io/content/rh/hr-settings/parametres_des_conges.png)

### 3.1 Modèle de notification d'approbation de congé

Lors de la création ou de la mise à jour d'une demande de congé avec un approbateur de congé, un e-mail est envoyé à cet approbateur de congé pour l'informer de la nouvelle demande de congé. Le modèle d'e-mail utilisé à cet effet peut être sélectionné ici.

### 3.2 Modèle de notification de statut de congé

Lors de la soumission/annulation d'une demande de congé, l'employé reçoit un e-mail avec le statut mis à jour de sa demande de congé. Le modèle d'e-mail utilisé à cet effet peut être sélectionné ici.

### 3.3 Approbateur de congé obligatoire dans la demande de congé

Dans le document de demande de congé, le champ « Approbateur de congé » est défini sur obligatoire lorsque vous cochez cette option.

### 3.4 Afficher les congés de tous les membres du département dans le calendrier

Les congés approuvés de tous les employés du même service sont affichés dans la vue du calendrier en cochant cette option.

### 3.5 Encaissement automatique des congés

Si cette case est cochée, le système génère un projet d'enregistrement d'encaissement des congés à l'expiration de l'allocation de congés pour tous les types de congés encaissables.

### 3.6 Restreindre la demande de congé antidatée

Si coché, le système ne permettra pas de faire une demande de congé antidatée.

### 3.7 Attribution automatique des congés en fonction de la politique de congé

Si coché, les congés seront accordés aux employés automatiquement en fonction de la date d'entrée en vigueur conformément à la présente affectation de la politique de congé.

### 4. Paramètres de recrutement

#### 4.1 Vérifier les postes vacants lors de la création d'une offre d'emploi

Lors de la création d'une offre d'emploi pour un poste particulier, les postes vacants présents dans le plan de dotation pour ce poste sont vérifiés pour avertir l'utilisateur de la surembauche pour un poste particulier.


# Département

Un département est un domaine fonctionnel spécialisé ou une division au sein d'une organisation. :br
Vous pouvez définir la liste de blocage des congés ainsi que les approbateurs de congés et de notes de frais par département.

---

::tour{doctype="Department"}
Voir des exemples de départements sur la démo
::

Le département est une donnée en arborescence (arbre), ce qui signifie que vous pouvez créer des départements et des sous-départements.

::callout
La case à cocher **Est un groupe** doit être cochée si le département est un département parent.
::

## Prérequis

Avant de créer un Département, il est conseillé de créer les documents suivants :

- **Société** (Obligatoire pour pouvoir associer chaque département à une société)
- **Liste de blocage des congés**

## Caractéristiques

### Approbateurs

Vous pouvez associer des approbateurs de demande de quart, congés et notes de frais directement au niveau de chaque département. :br
Dans ce cas, inutile d'ajouter un approbateur dans la fiche *Employé*, les approbateurs correspondant au département auquel il est associé seront notifiés.

Par contre vous pouvez toujours gérer les exceptions au niveau des fiches *Employé*
ex. Un employé dépendant d'un département a un approbateur dans un autre département. :br
Dans ce cas, vous pouvez lui attribuer un approbateur dans sa fiche *Employé*.


# Branche

Une branche est un élément organisationnel pouvant notamment être associé aux données RH.

Ex. Une société a deux branches (ou succursales) à Paris et Berlin.
Les employés seront donc associés à l'une des deux branches.

::tour{doctype="Branch"}
Voir des exemples de branches sur la démo
::


# Désignation

Les désignations sont les titres d'emploi officiels attribués aux employés.

En ce qui concerne la gestion de l'entreprise, il existe diverses parties prenantes telles que les administrateurs, les dirigeants, les gestionnaires et les actionnaires qui guident une entreprise vers la réalisation de ses objectifs commerciaux.

Dokos vous permet de créer différentes désignations et de mentionner également les compétences requises pour celles-ci.

---

Pour accéder à la **liste de Désignation**, allez sur :

> Accueil > Ressources humaines > Employé > **Désignation**

![liste\_désignation.png](https://doc.dokos.io/content/rh/designation/liste_designation.png)

## 1. Comment créer une désignation

1. Allez dans la **liste Désignation**, cliquez sur ➕Ajouter Désignation.
2. Entrez le **nom** de la désignation.
3. Entrez la **description** et les compétences requises (facultatif).
4. **Enregistrer**.

![créer\_désignation.png](https://doc.dokos.io/content/rh/designation/creer_designation.png)

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
**Remarque** : Les compétences requises pour un employé d'une désignation particulière qui sont spécifiées dans la section « Compétences requises » du doctype Désignation peuvent être directement récupérées dans la carte des compétences de l' employé pour évaluer les performances d'un employé en fonction de ses compétences.
::

## 2. Compétences requises

Vous pouvez ajouter des compétences requises pour chaque désignation. Cela permet d'ajouter des compétences selon le métier et de pouvoir connaître les compétences de chaque type de profil. Par exemple, savoir les compétences pour un développeur logiciel ou d'un comptable.

Les recruteurs pourront consulter ces informations pour savoir quelles compténeces sont nécessaires au poste. Ces compétences peuvent varier d'un secteur à un autre.

![compétences.png](https://doc.dokos.io/content/rh/designation/competences.png)


# Évaluations

## 👉 Avantages du modèle d'évaluation

**Structuration :** Assure un processus cohérent et structuré pour évaluer les performances.

**Transparence :** Permet une évaluation transparente et équitable des employés.

**Amélioration continue :** Favorise le développement continu des compétences des employés.

**Décision éclairée :** Aide à prendre des décisions RH basées sur des données concrètes.

## 1. Conditions préalables

Avant de commencer les évaluations, il est essentiel de définir [**les indicateurs de performance**](https://doc.dokos.io/#cr%C3%A9er-des-indicateurs-de-performance) et [**les critères d'évaluation des employés**](https://doc.dokos.io/#12-d%C3%A9finir-des-crit%C3%A8res-d%C3%A9valuation-des-employ%C3%A9s) sur lesquels les employés seront évalués. Cela peut inclure des compétences techniques, des compétences interpersonnelles, des objectifs spécifiques, etc. Pour chaque indicateur et critère, vous pouvez définir des pondérations pour indiquer l'importance relative lors de la création du [**modèle d'évaluation**](https://doc.dokos.io/#cr%C3%A9er-un-mod%C3%A8le-d-%C3%A9valuation).

### 1.1. Définir les indicateurs de performance

::tour{demo="Mappemonde" doctype="kra"}
Créer des indicateurs de performance
::

**Définition :**

Les critères de performance sont les domaines dans lesquels un employé doit exceller pour atteindre les objectifs de son rôle. Ils représentent les attentes de l'entreprise en termes de résultats concrets et mesurables.

**Utilisation :**

Ils sont définis pour chaque poste ou rôle dans l'entreprise et servent de base pour évaluer les performances des employés.
Ils clarifient les attentes et aident les employés à se concentrer sur les résultats les plus importants pour l'organisation.

**Exemples :**

Pour un vendeur : Nombre de ventes réalisées, chiffre d'affaires généré.

Pour un chef de projet : Respect des délais, satisfaction des clients.

### 1.2. Définir des critères d'évaluation des employés

::tour{demo="Mappemonde" doctype="employee-feedback-criteria"}
Créer des critères d'évaluation des employés
::

**Définition :**

Les critères d'évaluation des employés sont définis pour évaluer la performance, les compétences et le comportement des employés. Ils peuvent inclure des aspects tels que la productivité, la qualité du travail, la communication, la collaboration, l'innovation, et le respect des délais.

**Exemples :**

Qualité du travail : Évaluer la précision et la qualité des résultats produits.

Communication : Évaluer la clarté, la concision et l'efficacité des communications verbales et écrites.

Collaboration : Évaluer la capacité à travailler en équipe et à contribuer positivement à des projets collaboratifs.

Innovation : Évaluer la capacité à proposer des idées nouvelles et à améliorer les processus existants.

### 1.3. Créer un modèle d'évaluation

::tour{demo="Mappemonde" doctype="appraisal-template"}
Créer un modèle d'évaluation
::

**Définition :**

Les modèles d'évaluation permettent de définir des critères et des poids spécifiques pour évaluer les performances des employés. Chaque modèle peut être adapté à différents postes, départements ou branches.

Chaque critère peut être pondéré en fonction de son importance relative. Par exemple, la productivité peut avoir un poids de 30%, tandis que la qualité du travail peut avoir un poids de 20%.

### 1.4. Cycle d'évaluation

::tour{demo="Mappemonde" doctype="appraisal-cycle"}
Créer des cycles d'évaluation
::

**Définition :**

Un cycle d'évaluation est une période de temps définie pendant laquelle la performance globale d'un employé est évaluée.

**Planification de l'évaluation :**

Identifiez les **périodes spécifiques** pendant lesquelles les évaluations seront effectuées (par exemple, trimestrielle, semestrielle, annuelle). Ensuite, **déterminez quels employés** seront évalués au cours de chaque période.

**Sélectionnez la méthode d'évaluation des indicateurs de performance :**

Par défaut, Dokos calcule le score final comme la moyenne des scores suivants :

- Score d'objectif : Basé sur la réalisation des indicateurs de performance/objectifs, soit de manière automatisée soit manuellement.
- Score des critères d'évaluation des employés : Évaluations fournies par les managers, collègues.
- Score d'auto-évaluation : Évaluations réalisées par l'employé lui-même

Pour calculer le score final à l'aide de votre propre formule, activez l'option **calculer le score final basé sur formule dans les paramètres**.

Par exemple, vous pouvez donner plus de poids à certains scores en fonction de vos besoins.

> Une formule personnalisée pourrait ressembler à : (0.5 x Score d'objectif) + (0.3 x Score de critères d'évaluation des employés) + (0.2 x Score d'Auto-Évaluation).

### 1.5. Définition des objectifs :

::tour{demo="Mappemonde" doctype="goal"}
Créer des objectifs
::

Une fois la temporalité et les employés définis dans le cycle d'évaluation, vous devez valider le formulaire pour ensuite fixer des objectifs SMART.

Vous avez également la possibilité de vous rendre directement dans le formulaire objectif.

- Définissez des objectifs : **S**pécifiques, **M**esurables, **A**tteignables, **R**éalistes et **T**emporellement définis pour chaque employé.

::callout{icon="i-heroicons-light-bulb"}
Pour évaluer les progrès réalisés sur les objectifs, vous devez lancer l'évaluation.
::

## 2. Évaluation

### 2.1. Évaluation de la performance des employés

Les responsables et les collègues peuvent fournir des commentaires structurés sur la performance de l'employé.

### 2.2. Évaluation

Avant de créer une évaluation, vous devez au préalables créer :

- Modèle d'évaluation
- Cycle d'évaluation

**Les évaluations peuvent être créées en masse à partir du cycle d'évaluation.**

> Définissez des filtres optionnels pour récupérer la liste des employés dans la liste des évalués .

### Tableau KRA vs Goals

**Indicateurs de performance et pondération :**

Chaque indicateur de performance est associé à une pondération (%), qui reflète son importance relative par rapport aux autres indicateur.

**Réalisation des objectifs (%) :**

Ce pourcentage représente la mesure dans laquelle l'employé a atteint les objectifs liés à un indicateur spécifique. Ce calcul est automatique et basé sur la progression des objectifs.

**Score d'objectif (pondéré) :**

Le score d'objectif pondéré est calculé en tenant compte de la pondération attribuée à chaque indicateur et du pourcentage d'achèvement des objectifs.


# Quarts et présences

🚧 Rédaction en cours 🚧


# Gestion des présences

La présence est un enregistrement indiquant si un employé a été présent un jour particulier ou non.

Dans Dokos, vous pouvez marquer et enregistrer quotidiennement la présence d'un employé à l'aide du doctype Présence.

---

Pour accéder à **la liste des présences**, allez sur :

Accueil > Ressources humaines > **Présence**

![liste\_présence.png](https://doc.dokos.io/content/rh/attendance/liste_presence.png)

## 1. Prérequis avant utilisation

Avant de créer un enregistrement de présence, il est conseillé de créer d'abord les éléments suivants :

- **[Employé](https://doc.dokos.io/v5/dokos/hrms/cycle-de-vie/employee)**
- **Type d'équipe**

## 2. Comment créer une présence

1. Allez dans la liste de présence, cliquez sur ➕ Ajouter Présence.
2. Sélectionnez l'employé.
3. Sélectionnez la date de présence.
4. Le champ **Quart** est rempli automatiquement selon l'affectation de quart de l'employé à la date sélectionnée (voir section 3.1).
5. Sélectionnez le statut (Présent, Absent, En congé, Demi-journée).
6. Enregistrer et envoyer.

![nouvelle\_présence.png](https://doc.dokos.io/content/rh/attendance/nouvelle_presence.png)

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
> **Remarque** : La participation ne peut pas être marquée pour des dates futures.
::

Vous pouvez obtenir un rapport mensuel de vos données de présence en accédant au rapport Détails de la présence mensuelle .

Vous pouvez facilement définir la présence des employés à l'aide de l' outil de présence des employés .

Vous pouvez également télécharger en masse la participation à l'aide de la fonction Télécharger la participation.

## 3. Caractéristiques

### 3.1 Remplissage automatique du quart

Lorsque vous sélectionnez un employé ou modifiez la date de présence, le champ **Quart** est rempli automatiquement si l'employé dispose d'une affectation de quart active à cette date.

**Règle de priorité :**

1. Dokos recherche d'abord la dernière **Affectation de quart** soumise et applicable à la date choisie.
2. Si aucune affectation n'est trouvée, il utilise le **quart par défaut** défini dans la fiche de l'employé.
3. Si ni l'un ni l'autre n'existe, le champ reste vide et vous pouvez le renseigner manuellement.

::callout{color="blue" icon="i-heroicons-information-circle"}
**Bon à savoir** : Le remplissage automatique ne s'applique que si le champ Quart est encore vide. Si vous avez déjà saisi une valeur, elle n'est pas écrasée.
::

**Exemple :**

> La responsable RH de Maison Verte SARL crée une présence pour l'employé Thomas Durand pour le 5 mai. Comme Thomas est affecté au quart « Matin » depuis le 1er mai, le champ Quart se remplit automatiquement avec « Matin » dès que la date est saisie.

### 3.2 Détails

- Sélectionnez type de Quarts
- Arrivée tardive
- Départ anticipé

### 3.3 Marquer la présence non marquée

Si la présence de certains employés n'est pas marquée, vous pouvez les marquer comme présents, absents ou en demi-journée.

**Comment marquer la présence**

1. Accédez à la liste de présence.
2. Cliquez sur le bouton Marquer la présence .
3. Une boîte de dialogue apparaîtra.
4. Sélectionnez l'employé et le mois.
5. Sélectionnez le statut, qu'il soit Présent, Absent ou Demi-journée.
6. Sélectionnez les dates auxquelles vous souhaitez marquer la présence d'un employé sélectionné.
7. Cliquez sur le bouton Marquer la présence et cliquez sur Oui .


# Demande de validation de présence

À l'aide de la demande de présence, les employés peuvent soumettre leur demande de présence pour les jours où leur présence n'a pas été marquée pour diverses raisons telles que le service sur site ou le travail à domicile.

---

Pour accéder à **la liste de demande de présence**, allez sur :

Accueil > Ressources humaines > Présence > **Demande de valiation de présence**

![liste\_demande\_de\_validation.png](https://doc.dokos.io/content/rh/attendance-request/liste_demande_de_validation.png)

## 1. Prérequis avant utilisation

Avant de créer une demande de présence, il est conseillé de créer d'abord les éléments suivants :

- **[Employé](https://doc.dokos.io/v5/dokos/hrms/cycle-de-vie/employee)**

## 2. Comment créer une demande de présence

1. Allez dans la liste des demandes de présence, cliquez sur ➕ Ajouter Demande de validation de présence.
2. Sélectionnez l'employé qui souhaite soumettre la demande de présence.
3. Sélectionnez Date de début et Date de fin de la demande de participation.
4. Le champ **Quart** est rempli automatiquement selon l'affectation de quart de l'employé à la date de début (voir section 3.1).

### Raison

5. Sélectionnez Raison et saisissez Explication (facultatif).
6. Enregistrer et envoyer.

![créer\_demande\_de\_validation.png](https://doc.dokos.io/content/rh/attendance-request/creer_demande_de_validation.png)

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
**Remarque 1** : Vous pouvez cocher la case **Demi-journée** et saisir la date au cas où la participation est pour une demi-journée.
::

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
> **Remarque 2**: Sur présentation de la même chose, les documents de présence seront créés pour les jours que vous avez mentionnés comme indiqué.
::

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
> **Remarque 3** : Vous pouvez soumettre une demande de présence uniquement pour une présence non indiquée.
::

Comme indiqué ci-dessous, les enregistrements de présence respectifs sont liés à la demande de présence soumise.

Si vous annulez la Demande de Présence, les documents de Présence liés créés seront également annulés.

## 3. Caractéristiques

### 3.1 Remplissage automatique du quart

Lorsque vous sélectionnez un employé ou modifiez la date de début de la demande, le champ **Quart** est rempli automatiquement si l'employé dispose d'une affectation de quart active à cette date.

**Règle de priorité :**

1. Dokos recherche d'abord la dernière **Affectation de quart** soumise et applicable à la date de début.
2. Si aucune affectation n'est trouvée, il utilise le **quart par défaut** défini dans la fiche de l'employé.
3. Si ni l'un ni l'autre n'existe, le champ reste vide et vous pouvez le renseigner manuellement.

::callout{color="blue" icon="i-heroicons-information-circle"}
**Bon à savoir** : Le remplissage automatique ne s'applique que si le champ Quart est encore vide. Si vous avez déjà saisi une valeur, elle n'est pas écrasée.
::

**Exemple :**

> Sophie Martin de Maison Verte SARL soumet une demande de validation de présence pour du travail à domicile effectué le 12 mai. Elle sélectionne son nom et la date du 12 mai. Comme elle est affectée au quart « Après-midi » depuis le 1er mai, le champ Quart se complète automatiquement avec « Après-midi ».


# Outil de gestion des présences des employés

L'outil de présence des employés vous permet de marquer la présence de plusieurs employés pour une date particulière.

---

Pour accéder à l'**outil de présence des employés**, allez sur :

Accueil > Ressources humaines > Présence > **Outil de présence des employés**

![liste\_outil\_de\_présence.png](https://doc.dokos.io/content/rh/employee-attendance-tool/liste_outil_de_presence.png)

Cet outil vous permet d'ajouter rapidement des enregistrements de présence pour plusieurs employés en fonction de leur département et de leur succursale pour un jour donné.

## 1. Prérequis avant utilisation

Avant de créer une présence des employés, il est conseillé de créer d'abord les éléments suivants :

- **[Employé](https://doc.dokos.io/v5/dokos/hrms/cycle-de-vie/employee)**
- **[Département](https://doc.dokos.io/v5/dokos/hrms/parametrage/departement)**
- **[Outil de gestion des présences des employés](https://doc.dokos.io/v5/dokos/hrms/quarts-et-presences/employee-attendance-tool)**

## 2. Comment marquer la présence à l'aide de l'outil de présence des employés

1. Entrez la date.
2. Sélectionnez le département et la branche (facultatif).

![détails\_outil\_de\_présence.png](https://doc.dokos.io/content/rh/employee-attendance-tool/details_outil_de_presence.png)

### 3. Caractéristiques

### 3.1 Présence non indiquée

Si vous n'avez pas fait d'enregistrement de présence alors vous aurez la section **Présence non indiquée** d'active.

- Sélectionner les employés et indiquez un statut entre Présent, Travaillant de la maison, Demi-journée ou Absent.

![présence\_non\_indiquée.png](https://doc.dokos.io/content/rh/employee-attendance-tool/presence_non_indiquee.png)

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
> **Remarque** : La participation ne peut pas être marquée pour des dates futures.
::

### 3.2 Présence validée

Une fois que les présences ont été indiquées alors vous les verrer s'afficher en dessous.

- **Une case cochée signifie** : Employé Présent ou Travaillant de la maison
- **Une case non-cochée** : Employé Absent
- **Une case coché avec un "-" à l'intérieur** : Employé en Demi-journée

![présence\_validée.png](https://doc.dokos.io/content/rh/employee-attendance-tool/presence_validee.png)

Une fois la présence marquée à l'aide de l'outil de présence de l'employé, la présence de l'employé est enregistrée dans l'enregistrement de présence :

> Acuueil > Ressources Humaines > Présence > **Présence**.

Depuis les présences vous pouvez annuler et supprimer une présence. Il faut d'abord sélectionner l'employé concerné puis annuler la présence pour ensuite supprimer la présence.

![gestion\_présence.png](https://doc.dokos.io/content/rh/employee-attendance-tool/gestion_presence.png)


# Enregistrement des employés

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Contenu bientôt disponible
::


# Outil de présence des employés

L'outil de présence des employés vous permet de marquer la présence de plusieurs employés pour une date particulière.

Pour accéder à l'outil de présence des employés, allez à :

Accueil > Ressources humaines > Présence > **Outil de présence des employés**

Cet outil vous permet d'ajouter rapidement des enregistrements de présence pour plusieurs employés en fonction de leur département et de leur succursale pour un jour donné.

## 1. Prérequis avant utilisation

Avant de créer une présence des employés, il est conseillé de créer d'abord les éléments suivants :

- **[Employé](https://doc.dokos.io/v5/dokos/hrms/cycle-de-vie/employee)**
- **[Département](https://doc.dokos.io/v5/dokos/hrms/parametrage/departement)**
- **[Branche](https://doc.dokos.io/v5/dokos/hrms/parametrage/branche)**

## 2. Comment marquer la présence à l'aide de l'outil de présence des employés

1. Entrez la date.
2. Sélectionnez le département et la succursale (facultatif).
3. Sélectionnez les employés.
4. Marquez Présent, Absent ou Demi-journée selon les besoins.

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
**Remarque** : La participation ne peut pas être marquée pour des dates futures.
::

Une fois la présence marquée à l'aide de l'outil de présence de l'employé, la présence de l'employé est enregistrée dans l' enregistrement de présence comme indiqué :


# Affectation de quart

La section Gestion des quarts de travail des ressources humaines aide votre organisation à gérer les quarts de travail de vos employés.

Pour utiliser un type de quart dans Dokos,

- Configurer un type d'équipe.
- Entrez la demande de décalage.
- Afficher et gérer les affectations de quarts.

---

Pour accéder à **la liste de Affectation de quart**, allez sur :

> Accueil > Ressources humaines > Gestion des quarts > **Affectation de quart**

![liste\_affectation\_de\_quart.png](https://doc.dokos.io/content/rh/shift-assignment/liste_affectation_de_quart.png)

## 1. Prérequis avant utilisation

- **[Employé](https://doc.dokos.io/v5/dokos/hrms/cycle-de-vie/employee)**
- **[Type de quart](https://doc.dokos.io/v5/dokos/hrms/quarts-et-presences/shift-type)**

## 2. Comment créer une affectation de quart

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
**Remarque** : Une fois la sélection de quart approuvée et soumise, elle crée automatiquement les affectations de quart pour un employé.
::

1. Accédez à la liste des demandes de décalage, cliquez sur **➕ Ajouter Affectation de quart**.
2. Sélectionnez Type de quart.
3. Définissez la durée de l'équipe à l'aide de la **date de début** et de **date de fin**.
4. Enregistrer.

![détails\_affectation.png](https://doc.dokos.io/content/rh/shift-assignment/details_affectation.png)

## 3. Configuration de l'approbateur de demande de quart

Un approbateur de demande d'équipe est un utilisateur qui peut approuver une demande d'équipe d'un employé. Dans Dokos, l'approbation de sélection de quart peut être paramétré à deux niveaux :

### 3.1 Niveau du département

Les approbateurs de demande de quart pour chaque département peuvent être configurés dans le maître du département . L'approbateur de demandes de quarts multiples peut être défini dans un service.

Lorsqu'un employé appartenant à un service particulier demande un type d'équipe, l'approbateur de demande d'équipe défini dans la fiche de service de cet employé sera considéré comme ses approbateurs de type d'équipe.

### 3.2 Niveau de l'employé

L' approbateur des demandes de quart peut également être défini par employé dans le fichier des employés.

Si l'approbateur des demandes de changement est défini à la fois au niveau de l'employé et au niveau du service, l'approbateur des demandes de changement au niveau de l'employé sera considéré comme l'approbateur des congés par défaut dans ce cas.

## 4. Planification depuis le Roster

Le **Roster** est la vue mensuelle de planification des quarts. Elle permet aux responsables de visualiser et d'affecter des quarts pour l'ensemble de leurs employés sur un mois donné, directement depuis un tableau interactif.

### 4.1 Affectation de quarts sur les jours fériés et les jours de congé

Il est désormais possible d'affecter un quart à un employé même sur un **jour férié** ou un **jour de congé**. Cette amélioration permet de couvrir des situations exceptionnelles — par exemple, un rappel au travail lors d'un jour férié ou une permanence prévue pendant une période de congé.

**Comment procéder :**

1. Ouvrez le Roster via : **Accueil > Ressources humaines > Gestion des quarts > Roster**.
2. Naviguez jusqu'au mois souhaité.
3. Repérez la cellule correspondant à l'employé et au jour concerné (même si ce jour est affiché comme férié ou congé).
4. Cliquez sur la cellule pour affecter ou faire glisser un quart vers cette case.
5. Le quart s'ajoute et s'affiche dans la cellule, aux côtés de l'indication de jour férié ou de congé.

::callout{color="blue" icon="i-heroicons-information-circle"}
**Bon à savoir** : Les indicateurs de jour férié et de congé restent visibles dans la cellule. Le quart ajouté s'affiche en complément, sans effacer ces informations. Cela vous permet de distinguer d'un coup d'œil les quarts planifiés sur des jours ordinaires de ceux planifiés sur des jours particuliers.
::

**Exemple :**

> La responsable RH de Maison Verte SARL doit planifier une permanence le 1er mai (jour férié) pour l'employé Thomas Durand. Elle ouvre le Roster du mois de mai, localise la colonne du 1er mai sur la ligne de Thomas Durand, puis clique sur la cellule pour lui affecter le quart « Permanence fériée ». Le quart apparaît directement dans la cellule, à côté du badge de jour férié.

### 4.2 Affichage des événements dans le Roster

Chaque cellule du Roster peut désormais afficher simultanément plusieurs types d'informations pour un même jour :

| Type d'événement    | Affiché dans la cellule      |
| ------------------- | ---------------------------- |
| Jour férié          | Oui — indicateur visuel      |
| Jour de congé       | Oui — indicateur visuel      |
| Quart(s) affecté(s) | Oui — un ou plusieurs quarts |

Si plusieurs quarts sont affectés sur un même jour, ils sont tous listés dans la cellule, triés par heure de début.

## 5. Permissions et contrôle d'accès dans le Roster

Le Roster applique des règles de permission strictes pour garantir que seuls les utilisateurs autorisés peuvent créer, modifier ou supprimer des affectations de quart.

### 5.1 Règles appliquées

| Action                                                        | Permission requise                                         |
| ------------------------------------------------------------- | ---------------------------------------------------------- |
| Consulter les quarts, congés, fériés d'un employé             | Droit de lecture sur la fiche Employé                      |
| Créer une affectation de planning (shift schedule assignment) | Droit de création sur le type de document correspondant    |
| Supprimer une affectation de planning                         | Droit de suppression sur le type de document correspondant |
| Échanger (swap) ou fractionner (break) un quart               | Droit d'écriture sur l'affectation de quart concernée      |
| Insérer un nouveau quart                                      | Droit de création sur le type Affectation de quart         |

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
**Important** : Si un utilisateur ne dispose pas des droits suffisants pour réaliser une action dans le Roster, celle-ci sera refusée et un message d'erreur s'affichera. Contactez votre administrateur Dokos pour ajuster les rôles et permissions si nécessaire.
::

**Exemple :**

> Un chef d'équipe de Maison Verte SARL souhaite échanger le quart du matin et du soir entre deux employés depuis le Roster. Si son profil utilisateur ne dispose que du droit de lecture sur les affectations de quart, l'opération d'échange sera bloquée. Il doit obtenir le droit d'écriture sur ce type de document auprès de l'administrateur.

### 5.2 Validation des filtres dans le Roster

Les filtres de recherche disponibles dans le Roster (par employé ou par type de quart) sont désormais validés côté serveur. Seuls les critères de filtrage reconnus sont acceptés, ce qui renforce la fiabilité et la sécurité des données affichées.

::callout{color="blue" icon="i-heroicons-information-circle"}
**Bon à savoir** : Cette validation est transparente pour l'utilisateur. En cas de filtre non valide, le Roster affichera un message d'erreur explicite plutôt que des résultats incorrects ou vides sans explication.
::


# Sélection de quart

La section Gestion des quarts de travail des ressources humaines aide votre organisation à gérer les quarts de travail de vos employés.

Pour utiliser un type de quart dans Dokos,

- Configurer un type d'équipe.
- Entrez la demande de décalage.
- Afficher et gérer les affectations de quarts.

---

## 1. Prérequis avant utilisation

Pour créer une demande d'équipe, celles-ci doivent d'abord être créées :

- **[Employé](https://doc.dokos.io/v5/dokos/hrms/cycle-de-vie/employee)**
- **[Type de quart](https://doc.dokos.io/v5/dokos/hrms/quarts-et-presences/shift-type)**

La sélection de quart est utilisée par un employé pour demander un type d'équipe particulier.

Pour accéder à **la liste de demande de quart**, allez sur :

> Accueil > Ressources humaines > Gestion des quarts > **Sélection de quart**

![liste\_sélection\_de\_quart.png](https://doc.dokos.io/content/rh/shift-request/liste_selection_de_quart.png)

## 2. Comment créer une Sélection de quart

1. Accédez à la liste de Sélection de quart, cliquez sur **➕ Ajouter Sélection de quart**.
2. Sélectionnez **Employé** et **Type de quart**.
3. Définissez la durée de l'équipe à l'aide de la date de début et de date de fin.
4. Sélectionnez l'**approbateur**. Si l'approbateur sélectionné n'a pas accès au document de demande d'équipe, il est partagé avec l'approbateur avec l'autorisation **soumettre**.
5. Enregistrer.

![détails\_sélection\_de\_quart.png](https://doc.dokos.io/content/rh/shift-request/details_selection_de_quart.png)


# Type de quart

La section Gestion des quarts de travail des ressources humaines aide votre organisation à gérer les quarts de travail de vos employés.

Pour utiliser un type de quart dans Dokos,

- Configurer un type d'équipe.
- Entrez la demande de décalage.
- Afficher et gérer les affectations de quarts.

---

Pour accéder à **la liste de Type de quart**, allez sur :

> Accueil > Ressources Humaines > Gestion des quarts > **Type de quart**

![liste\_type\_de\_quart.png](https://doc.dokos.io/content/rh/shift-type/liste_type_de_quart.png)

## 1. Type de quart

Le document Type d'équipe vous permet de définir les différents types d'équipes dans votre organisation et de configurer la présence automatique pour l'équipe. La présence automatique marque la présence en fonction de « l'enregistrement des employés » pour les employés affectés au quart de travail.

1. Accédez à la liste des types de décalage, cliquez sur **➕ Ajouter type de quart**.
2. Entrez le nom, l'**heure de début** et l'**heure de fin**
3. Sélectionnez **la liste de congés**
4. Enregistrer

![créer\_type\_de\_quart.png](https://doc.dokos.io/content/rh/shift-type/creer_type_de_quart.png)

## 2. Caractéristiques

En plus de définir les différents quarts de travail dans votre organisation, le document Type de quart comporte également le paramètre de présence automatique. La présence automatique marque la présence des employés affectés à ce quart de travail en fonction des enregistrements du document « Contrôle des employés ». La présence automatique pour tous les enregistrements de type d'équipe est tentée d'être marquée toutes les heures. Vous pouvez également déclencher manuellement la présence automatique pour un seul type d'équipe en appuyant sur le bouton « Marquer la présence » dans le document de type d'équipe.

### 2.1 Heure de début

L'heure de la journée à laquelle commence ce quart de travail. L'heure doit être saisie au format 24H.

### 2.2 Heure de fin

L'heure de la journée à laquelle ce quart se termine. L'heure doit être saisie au format 24H.

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
**Remarque** : Pour les cas où l'**Heure de fin** est inférieure à l **Heure de début**, le quart de travail est supposé être un quart de nuit qui commence à une date calendaire et se termine à la date calendaire suivante.
::

### 2.3 Liste des congés

Les jours de congés applicables pour ce quart de travail peuvent être sélectionnés ici. Si elle est laissée vide, la liste des congés par défaut de l'employé ou du document de l'entreprise est prise en compte.

### 2.4 Activer l'enregistrment auotmatique des présences

Vous pouvez utiliser cette option pour activer le marquage de la présence des employés affectés à ce quart de travail en fonction de **Enregistrement des employés**.

### 2.5 Paramètres de présence automatique

Vous pouvez utiliser les paramètres suivants pour configurer la présence automatique selon vos besoins.

#### Déterminer l'enregistrement et le départ

L'enregistrement des employés peut ne pas toujours avoir un type de journal IN/OUT. Pour de tels scénarios, vous pouvez utiliser cette option pour obtenir des résultats appropriés du système de présence automatique.

1. Entrées alternées comme IN et OUT pendant le même quart de travail :


   - La première entrée est considérée comme IN, suivie de l'entrée suivante comme OUT et l'entrée suivante comme IN et ainsi de suite.
2. Strictement basé sur le type de journal dans l'enregistrement des employés :


   - L'enregistrement est déterminé comme IN ou OUT strictement basé sur le **Type de journal** dans l'enregistrement d'enregistrement de l'employé.

#### Calcul des heures de travail basé sur

Les heures de travail peuvent être calculées soit en incluant les pauses entre les quarts de travail, soit en excluant les pauses.

Cela peut être configuré à l'aide des options suivantes :

1. Premier enregistrement et dernier départ :


   - La sélection de cette option calcule les heures de travail en considérant le premier ENT et le dernier enregistrement de l'employé au cours du quart de travail.
   - Dans le cas où l'ENTRÉE/SORTIE est déterminée en alternant les entrées, le premier enregistrement de l'employé est considéré comme IN et le dernier enregistrement de l'employé est considéré comme OUT aux fins du calcul des heures de travail.
2. Chaque enregistrement et départ valides :


   - La sélection de cette option exclut le temps pendant lequel l'employé est extrait.
   - c'est-à-dire que seul le temps pendant lequel l'employé est enregistré est calculé comme heures de travail.

#### Commencez l'enregistrement avant l'heure de début du quart de travail

Souvent, les employés s'enregistraient quelques minutes avant l'heure de début du quart de travail. Pour considérer ces enregistrements comme faisant partie du quart de travail lors du calcul de la fréquentation, vous pouvez configurer cette valeur en conséquence.

#### Autoriser le départ après l'heure de fin de quart

Souvent, les employés partaient après l'heure de fin du quart de travail. Pour considérer ces sorties comme faisant partie du quart de travail lors du calcul de la fréquentation, vous pouvez paramétrer cette valeur en conséquence.

#### Seuil d'heures de travail pour une demi-journée

Si le nombre réel d'heures de travail est inférieur à la valeur indiquée dans ce champ, la présence de l'employé est marquée comme « demi-journée ». Si vous ne souhaitez jamais marquer la demi-journée en fonction des heures de travail, vous devez définir cette valeur sur zéro.

#### Seuil d'heures de travail pour les absences

Si le nombre réel d'heures de travail est inférieur à la valeur indiquée dans ce champ, la présence de l'employé est marquée comme « Absent ». Si vous ne souhaitez jamais marquer Absent en fonction des heures de travail, vous devez définir cette valeur sur zéro.

#### Participation au processus après

La date à partir de laquelle la « Présence automatique » doit commencer à marquer la présence. Vous devez définir une date après laquelle vous disposez des enregistrements d'enregistrement des employés pour ce quart de travail.

#### Dernière synchronisation de l'enregistrement

Il s'agit de l'heure jusqu'à laquelle la présence est marquée en fonction des enregistrements d'enregistrement des employés. Vous devez définir une date et une heure jusqu'à laquelle l'enregistrement des employés a été synchronisé. Sinon, un employé pourrait être marqué comme absent en raison de l'absence de registres d'enregistrement.


# Plan de dotation

Le plan de dotation vous aide à planifier les besoins en main-d'œuvre de votre entreprise.

Dokos vous permet de le faire au niveau de l'entreprise en vous aidant à planifier et budgétiser efficacement les nouvelles embauches pour une période. Les offres d'emploi ne peuvent être créées qu'en fonction du nombre de postes vacants et du budget conformément au plan de dotation actif.

---

Pour accéder à **la liste de Plan de dotation**, allez sur :

> Accueil > Ressources humaines > Recrutement > Plan de dotation

![liste\_plan\_dotation.png](https://doc.dokos.io/content/rh/staffing-plan/liste_plan_dotation.png)

## 1. Prérequis avant utilisation

Avant de créer un plan de dotation, il est nécessaire de créer les éléments suivants :

- Département
- La désignation

## 2. Comment créer un plan de dotation

1. Accédez à la liste du plan de dotation, cliquez sur **➕ Ajouter Plan de dotation**.
2. Entrez le **nom**, la **date de début** et de **fin** et sélectionnez le **département** pour lequel vous souhaitez créer le plan de dotation.
3. Saisissez les détails du plan de dotation tels que la désignation, les postes vacants, le coût estimé par poste, le coût total estimé et le nombre de postes.
4. Enregistrer et envoyer.

![detail\_plan\_de\_dotation.png](https://doc.dokos.io/content/rh/staffing-plan/detail_plan_de_dotation.png)

## 3. Caractéristiques

### 3.1 Détails du plan de dotation

- **Désignation** : Les désignations pour lesquelles le plan de dotation est créé.
- **Nombre de postes** : nombre de postes pour lesquels vous prévoyez de recruter entre les dates de début et de fin du plan de dotation.
- **Postes vacants** : nombre de postes vacants en fonction du nombre de postes que vous souhaitez recruter et du nombre actuel d'employés.
- **Coût estimé par poste** : vous pouvez spécifier le coût pour l'entreprise par poste afin que les responsables du recrutement puissent s'en tenir au budget.
- **Budget total estimé** : une fois que vous avez saisi le plan de recrutement pour toutes les désignations, le plan de dotation établira le budget total estimé conformément au plan.

![détails\_du\_plan\_de\_dotation.png](https://doc.dokos.io/content/rh/staffing-plan/details_du_plan_de_dotation.png)


# Outil de chargement de présence

Cet outil vous aide à télécharger la participation en masse à partir d'un fichier csv.

---

Pour accéder à **l'outil de chargement de présences**, allez sur :

Accueil > Ressources humaines > Présence > **Outil de chargement de présences**

## 1. Prérequis avant utilisation

Avant de télécharger un enregistrement de présence en masse, il est conseillé de créer d'abord ce qui suit :

- **[Employé](https://doc.dokos.io/v5/dokos/hrms/cycle-de-vie/employee)**

## 2. Comment télécharger la présence en masse

1. Entrez la **date de début des présences** et la **date de fin de présences**.
2. Cliquez sur le bouton **Obtenir un modèle**. Il téléchargera un fichier csv avec les détails de l'employé, comme indiqué.
3. Saisissez le Statut (Présent / Absent) de l'Employé pour les dates sélectionnées.
4. Enregistrez le fichier.
5. Téléchargez le fichier enregistré.

![capture\_d’écran\_2021-06-09\_à\_16.11.34.png](https://doc.dokos.io/content/rh/upload-attendance/capture_decran_2021-06-09_a_16.11.34.png)

Une fois la participation en masse téléchargée, les enregistrements de participation respectifs seront créés.


# Cycle de vie des employés

🚧 Rédaction en cours 🚧


# Chauffeur

Pour accéder à **la liste de Chauffeur**, allez sur :

> Accueil > Ressources humaines > Gestion de flotte > **Chauffeur**

![liste\_chauffeur\_.png](https://doc.dokos.io/content/rh/driver/liste_chauffeur_.png)

## 1. Comment créer un chauffeur ?

1. Accéder à la liste des chauffeurs, cliquez sur **➕ Ajouter chauffeur**
2. Indiquez les informations telles que le **Nom**, l'**employé**, **le numéro de télphone portable**, l'**adresse** et le **statut du document**.
3. Si vous faites appel à un transporteur externe, sélectionnez le transporteur.
4. Enregistrer

![détails\_chauffeur.png](https://doc.dokos.io/content/rh/driver/details_chauffeur.png)

## 2. Caractéristiques

### 2.1 Détails de la licence

Vous pouvez saisir les différents élements de la licence du chauffeur.

- Numéro de licence
- Date d'émission
- Date d'expiration

![détails\_licence\_chauffeur.png](https://doc.dokos.io/content/rh/driver/details_licence_chauffeur.png)

### 2.2 Catégorie de permis de conduire

Saisissez toutes les informations relatives dans la table de catégorie du permis de conduire comme la classe du permis, une description, la date d'émission, la date d'expiration.

![catégorie\_permis\_chauffeur.png](https://doc.dokos.io/content/rh/driver/categorie_permis_chauffeur.png)


# Employé

Une personne qui travaille à temps partiel ou à temps plein dans le cadre d'un contrat de travail et qui a des droits et devoirs reconnus de votre entreprise est votre employé.

Dans Dokos, vous pouvez gérer la fiche Employé. Il capture les détails démographiques, personnels et professionnels, les détails d'adhésion et de départ, etc. de l'employé.

---

Pour accéder à la fiche des employés, allez sur :

> Accueil > Ressources humaines > **Employé**

![liste\_employé.png](https://doc.dokos.io/content/rh/liste_employe.png)

## 1. Prérequis avant utilisation

Avant de créer un employé, il est conseillé de créer les éléments suivants :

- **Type d'emploi**
- **Demandeur d'emploi**
- **Département des employés**
- **Grade d'employé**
- **Direction des employés**
- **Désignation des employés**
- **Politique de congé**
- **Liste de vacances**
- **Quitter l'encaissement**
- **Type de décalage**
- **Assurance maladie des employés**

## 2. Comment créer un employé

1. Allez dans la liste des employés, cliquez sur **➕ Ajouter Employé**.
2. Remplir les différents champs pour complèter la fiche :


   - Prénom
   - Nom
   - Salutation
   - Nom complet
   - Type d'emploi : Vous pouvez définir un type d'emploi tel que stagiaire, contrat, temps plein, temps partiel, probation, etc. pour un employé.
   - Société
   - Statut
   - Genre
   - Date de naissance
   - Date d'embauche
3. Enregistrer

![fiche\_technique\_employé.png](https://doc.dokos.io/content/rh/fiche_technique_employe.png)

Comme indiqué ci-dessous, tous les champs obligatoires sont mis en surbrillance.

## 3. Caractéristiques

Outre les détails obligatoires susmentionnés, certains détails supplémentaires qui peuvent être saisis dans la fiche des employés sont les suivants.

### 3.1 Contact en cas d'urgence

La fiche contact en cas d'urgence vous permet de saisir les informations de la personne qui sera contacté en cas d'urgence.

![urgence\_employé.png](https://doc.dokos.io/content/rh/urgence_employe.png)

### 3.2 Créer un utilisateur Dokos

L'ID utilisateur peut être lié à l'employé. Dans le cas où l'ID utilisateur n'est pas créé, vous pouvez cliquer sur «Créer un nouvel utilisateur» dans la liste déroulante pour en créer un.

En cliquant sur la case à cocher **Créer une autorisation utilisateur**, l'accès de l'employé à d'autres enregistrements peut être restreint. Cochez Ajouter des utilisateurs pour savoir comment créer des utilisateurs et ajouter des autorisations.

![utilisateur\_dokos.png](https://doc.dokos.io/content/rh/utilisateur_dokos.png)

### 3.3 Détails d'embauche

Les détails d'adhésion de l'employé tels que la date de l'offre, la date de confirmation, la date de fin du contrat, préavis (jours) et la date de départ à la retraite peuvent être saisis.

![détails\_d'embauche\_employé.png](https://doc.dokos.io/content/rh/de%CC%81tails_d'embauche_employe%CC%81.png)

### 3.4 Département et échelon

Dans une entreprise, les employés sont généralement regroupés en fonction du service , du grade , de la désignation et de la succursale .

Dans la section Département et grade, ces détails de l'employé peuvent être enregistrés. Dans le champ «Se rapporte à», la personne à qui l'employé doit rendre compte de ses tâches peut être saisie.

![département\_et\_échelon\_employé.png](https://doc.dokos.io/content/rh/departement_et_echelon_employe.png)

### 3.5 Approbateurs

L'employé peut faire différentes demandes qui peuvent être une note de frais, des congés, une demande de quart. Un approbateur est à indiquer si l'employé doit avoir l'approbation de son supérieur ou de la personne chargée des congés par exemple.

![approbateur\_employé.png](https://doc.dokos.io/content/rh/approbateur_employe.png)

### 3.6 Détails des présences et congés

Dans Détails des congés, vous pouvez enregistrer les détails de la politique de congé et de la liste des jours fériés . La politique de congé spécifie le type et le nombre de congés auxquels un employé a droit, et la liste des jours fériés est une liste qui contient les dates des jours fériés et des congés hebdomadaires.

![détails\_présences\_et\_congés\_employé.png](https://doc.dokos.io/content/rh/details_presences_et_conges_employe.png)

### 3.7 Détails du salaire

Ici, le mode de paiement du salaire, c'est-à-dire par Banque, Chèque ou Espèces peut être sélectionné.

![détails\_salaire\_employé.png](https://doc.dokos.io/content/rh/details_salaire_employe.png)

### 3.8 Assurance santé

Le fournisseur d'assurance de santé de l'employé est à renseigner dans cette section.

![assurance\_santé\_employé.png](https://doc.dokos.io/content/rh/assurance_sante_employe.png)

### 3.9 Coordonnées

Les informations de contact de l'employé telles que le numéro de portable, l'adresse actuelle et permanente, l'identifiant de courrier électronique personnel et d'entreprise peuvent être saisies ici. Dans le champ ID d'e-mail préféré, l'e-mail de l'entreprise, l'e-mail personnel ou l'ID utilisateur de l'employé peuvent être sélectionnés en fonction des préférences de l'utilisateur.

![coordonnées\_employé.png](https://doc.dokos.io/content/rh/coordonnees_employe.png)

### 3.10 Biographie

La biographie ou lettre de motivation de l'employé peut être renseigné dans cette section.

![biographie\_employé.png](https://doc.dokos.io/content/rh/biographie_employe.png)

### 3.8 Données personnelles

Les détails personnels de l'employé tels que les informations sur les antécédents familiaux comme le nom et la profession du parent, du conjoint et des enfants, les détails du passeport, y compris la date et le lieu de délivrance, les détails de santé tels que la taille, le poids, les allergies, les problèmes médicaux, etc. peuvent être enregistrés.

![données\_personelles\_employé.png](https://doc.dokos.io/content/rh/donnees_personelles_employe.png)

### 3.9 Qualification pour l'éducation

Ici, les détails pédagogiques tels que l'école / université, la qualification, le niveau et l'année de passage de l'employé peuvent être enregistrés comme indiqué ci-dessous :

![qualification\_pour\_éducation.png](https://doc.dokos.io/content/rh/qualification_pour_education.png)

En outre, des détails tels que la classe / pourcentage et les sujets peuvent également être enregistrés en cliquant sur la flèche vers le bas dans le tableau Education.

### 3.10 Expérience de travail antérieure

Tout comme la qualification scolaire, l'expérience de travail antérieure d'un employé peut également être saisie dans le tableau Historique de travail externe, comme indiqué ci-dessous:

En outre, des détails tels que le contact de l'entreprise précédente et l'expérience totale en années peuvent également être enregistrés dans le tableau Historique des travaux externes.

![expérience\_de\_travail.png](https://doc.dokos.io/content/rh/experience_de_travail.png)

### Ancienneté dans l'entreprise

L'ancienneté dans la société permet de suivre l'évolution de l'employé. Ajoutez les lignes nécessaires selon les changements. Cela peut-être une promotion d'un département à un autre, la modification de la désignation métier. Indiquez également la date de début et la date de fin.

![ancienneté\_dans\_la\_travail.png](https://doc.dokos.io/content/rh/anciennete_dans_la_travail.png)

### 3.11 Quitter

Les détails de sortie de l'employé (le cas échéant) tels que la démission, l'entrevue de sortie et les détails de l' engagement de congé peuvent être enregistrés. Lorsque le statut de l'employé est défini sur «Gauche», il est obligatoire de renseigner la date de départ.

![quitter\_employé.png](https://doc.dokos.io/content/rh/quitter_employe.png)

**Remarque** : une fois que le statut de l'employé est défini sur «Gauche», cette fiche d'employé particulière ne sera plus accessible dans les autres transactions.


# Échelon de l'employé

Un grade d'employé est un regroupement d'employés ayant des postes ou des valeurs similaires afin d'attribuer des taux de rémunération et des structures salariales.

Dokos vous permet de configurer les grades des employés, vous aidant à catégoriser facilement les employés en fonction de leur ancienneté ou de tout autre critère.

La note des employés vous aide également à récupérer les enregistrements des employés en masse en fonction de leurs notes lors du traitement de la paie, de l'attribution des congés, etc.

---

Pour accéder à la **liste des échelons d'employé**, allez sur :

> Accueil > Ressources humaines > Employé > **Échelon d'employé**

![liste\_échelon.png](https://doc.dokos.io/content/rh/employee-grade/liste_echelon.png)

## 1. Prérequis avant utilisation

Avant de créer un grade d'employé, il est conseillé de créer les documents suivants :

- **Politique de congé**
- **Structure salariale**

## 2. Comment créer un grade d'employé

1. Accédez à la liste des grades des employés, cliquez sur Nouveau.
2. Entrez le nom du grade de l'employé.
3. Saisissez la politique de congé par défaut et la structure salariale par défaut pour ce grade.
4. Enregistrer.

![créer\_échelon.png](https://doc.dokos.io/content/rh/employee-grade/creer_echelon.png)

Vous pouvez également accéder à l'**employé**, à la **période de congé**, au **modèle d'intégration des employés** et au **modèle de séparation des employés**.


# Groupe d'employés

Le groupe d'employés regroupe des employés en fonction de certains attributs tels que la désignation, le grade, la branche, etc.

Pour accéder au **groupe d'employés**, accédez à :

Accueil > Ressources humaines > Employé > **Groupe d'employés**

![liste\_groupe\_employé.png](https://doc.dokos.io/content/rh/employee-group/liste_groupe_employe.png)

## 1. Prérequis avant utilisation

Avant de créer un groupe d'employés, il est conseillé de créer les documents suivants :

- **[Employé](https://doc.dokos.io/v5/dokos/hrms/cycle-de-vie/employee)**

## 2. Comment créer un groupe d'employés

1. Accédez à la **liste des groupes d'employés**, cliquez sur ➕ Ajouter Groupe employé.
2. Entrez le **nom**.
3. Sélectionnez et ajoutez l'**ID d'employé au groupe**. Le nom de l'employé sera automatiquement récupéré.
4. **Enregistrer**.

![créer\_groupe\_employé.png](https://doc.dokos.io/content/rh/employee-group/creer_groupe_employe.png)

## 3. Caractéristiques

### 3.1 Contrat de niveau de service

Un groupe d'employés peut être ajouté au doctype **Accord de niveau de service**, où le niveau de service peut être spécifié pour un groupe d'employés particulier.


# Assurance maladie des employés

L'assurance maladie des employés est un avantage offert par l'entreprise à ses employés. Lorsqu'une entreprise fournit une assistance en matière d'assurance-maladie, elle paie des primes totales ou partielles pour la police d'assurance-maladie.

Dokos vous permet d'enregistrer les détails de l'assurance maladie des employés et de les lier au maître de cet employé particulier.

---

Pour accéder à à **la liste des Assurances Maladies**, allez sur :

> Accueil > Ressources humaines > Employé > **Assurance maladie des employés**

![liste\_assurance\_maladie.png](https://doc.dokos.io/content/rh/health-insurance/liste_assurance_maladie.png)

## 1. Comment créer une assurance maladie pour les employés

1. Allez dans la liste Assurance-maladie des employés, cliquez sur ➕ Ajouter Assurance maladie des employés.
2. Entrez le **nom** de l'assurance maladie.
3. **Enregistrer**.

![créer\_assurance\_maladie.png](https://doc.dokos.io/content/rh/health-insurance/creer_assurance_maladie.png)


# Promotion des employés

La promotion ou l'avancement de carrière est un processus par lequel un employé d'une entreprise se voit attribuer une part plus élevée de tâches, une échelle salariale plus élevée ou les deux.

Dans Dokos, vous pouvez gérer la promotion des employés et ses différentes activités associées à l'aide de ce document.

Pour accéder à la liste de **promotion des employés**, allez sur :

> Ressources humaines > Cycle de vie des employés > **Promotion des employés**

![Cette image permet de visualiser la fonctionnalité " promotion des employés"](https://doc.dokos.io/promotion-des-employes.png)

## 1. Prérequis avant utilisation

Avant de créer une promotion d'employé, il est conseillé de créer les documents suivants :

- **Employé**
- **Département**

## 2. Comment créer une promotion d'employé

![Image permettant de visualiser une nouvelle promotion.](https://doc.dokos.io/nouvelle-promotion.png)

Dans le tableau **Détails de la promotion des employés**, sélectionnez la propriété et définissez une nouvelle valeur.

![Cette image permet de visualiser la nouvelle propriété à définir.](https://doc.dokos.io/detail-de-la-promotion.png)

Une fois les modifications faites, vous pouvez visualiser les avancements de l'employés dans sa fiche.

![Image permettant de visualiser le profil de l'employé avec les différents postes occupés.](https://doc.dokos.io/anciennete-dans-la-societe.png)


# Départ des employés

Le départ d'un employé est une situation où l'accord de service d'un employé avec son organisation prend fin et l'employé quitte l'organisation.

La séparation des employés est créée pour un employé qui a démissionné ou qui a quitté l'organisation.

**Cas d'utilisation** : supposons que les activités suivantes doivent être effectuées dès qu'un employé quiite l'organisation.

- Récupérer l'ordinateur portable
- Effacer les cotisations
- Supprimer le compte de messagerie de l'employé
- Récupérer la carte d'identité

---

Dans Dokos, ces activités standard peuvent être suivies dans le modèle de séparation des employés.

Pour accéder à la **liste de départ des employés**, allez à :

> Ressources humaines > Cycle de vie des employés > **Départ des employés**

![départ\_des\_employés.png](https://doc.dokos.io/content/rh/employee-seperation/depart_des_employes.png)

## 1. Prérequis avant utilisation

Avant de créer une séparation d'employé, il est conseillé de créer les documents suivants :

- **[Employé](https://doc.dokos.io/v5/dokos/hrms/cycle-de-vie/employee)**
- **[Département](https://doc.dokos.io/v5/dokos/hrms/parametrage/departement)**
- **[Désignation](https://doc.dokos.io/v5/dokos/hrms/parametrage/poste)**
- **[Échelon de l'employé](https://doc.dokos.io/v5/dokos/hrms/cycle-de-vie/employee-grade)**

## 2. Comment créer une séparation d'employés

1. Accédez à la liste de Départ des employés, cliquez sur **➕ Ajouter Départ des employés**.
2. Sélectionnez l'employé. Une fois l'employé sélectionné, les informations correspondantes sur l'employé, telles que le service, la désignation et le grade de l'employé, seront automatiquement récupérées.

![nouveau\_départ\_des\_employés.png](https://doc.dokos.io/content/rh/employee-seperation/nouveau_depart_des_employes.png)

3. Sélectionnez le modèle de départ des employés . En fonction du modèle sélectionné, des informations telles que le service, la désignation et le grade de l'employé seront automatiquement récupérées (si déjà mentionnées dans le modèle de séparation).
4. Saisissez la date de la lettre de démission.
5. De plus, vous pouvez également saisir le résumé de l'entretien de sortie.
6. Enregistrer et envoyer.

![modèle\_départ.png](https://doc.dokos.io/content/rh/employee-seperation/modele_depart.png)

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
**Remarque 1** : Si un modèle de départ d'employés n'est pas créé, vous pouvez directement remplir les informations de séparation dans le doctype de séparation d'employés lui-même.
::

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
**Remarque 2** : Le **Statut** de la cessation d'emploi de l'employé deviendra Terminé une fois que toutes les activités associées seront terminées.
::

## 3. Caractéristiques

### 3.1 Modèle de séparation des employés

Le modèle de départ des employés est un modèle qui contient une liste prédéfinie d'activités pour la séparation des employés. Un modèle de séparation d'employés peut être créé pour un service, une désignation et un grade d'employé particuliers.

**Pour créer un nouveau modèle de départ des employés** :

Pour accéder au nouveau modèle de départ des employés, allez sur :

> Liste Ressources humaines > Cycle de vie des employés > Modèle de départ des employés > **Ajouter Nouveau modèle**.

1. Entrez le département, la désignation et le grade de l'employé (facultatif).
2. Mentionnez les activités pour la séparation. Pour chaque Activité, vous pouvez également mentionner l'Utilisateur ou le Rôle, ou l'un d'entre eux, auquel cette Activité sera attribuée.

### 3.2 Tâches et affectations

Lors de la soumission de la séparation des employés, un projet sera créé. Dans le projet, des tâches seront également créées pour chaque activité.

Vous pouvez afficher les projets et tâches créés via Affichage > Projet/Tâches.

De plus, chaque activité peut se voir attribuer des poids en fonction de son importance.

En fonction de la progression des tâches, la progression peut être mise à jour dans le processus de séparation des employés.

### 3.3 Statut d'employé

Vous pouvez afficher directement l'employé séparé via le doctype Vue de départ des employés > **Employé** ; une fois le formulaire soumis.


# Carte des compétences des employés

La carte des compétences des employés est un enregistrement qui aide votre organisation à suivre les compétences et les formations de vos employés. Il peut être utilisé pour évaluer chaque compétence de l'employé et suivre sa croissance après chaque formation interne. Ces données peuvent être utilisées au moment des évaluations.

---

Pour accéder à la **liste des cartes des compétences des employés**, allez sur :

> Accueil > Ressources humaines > Cycle de vie des employés > **Carte des compétences des employés**

![liste\_carte\_compétences.png](https://doc.dokos.io/content/rh/employee-skill-map/liste_carte_competences.png)

Assurez-vous d'avoir défini les compétences requises pour les désignations à partir du doctype de compétence.

## 1. Comment créer une carte des compétences des employés

1. Accédez à la liste Carte des compétences des employés, cliquez sur **➕ Ajouter Carte de compétences des employés**.
2. Sélectionnez l'employé.
3. Sur la base de la désignation de l'employé, le système tirera les compétences.
4. **Enregistrer**

![détails\_carte\_compétence.png](https://doc.dokos.io/content/rh/employee-skill-map/details_carte_competence.png)

## 2. Caractéristiques

### 2.1 Compétences

Définissez le niveau de compétence sur 5 et la date d'évaluation.
Si l'employé manque de compétences, vous pouvez planifier des formations pour l'employé.

![compétences\_carte.png](https://doc.dokos.io/content/rh/employee-skill-map/competences_carte.png)

### 2.2 Formation

Dans le tableau Formations, sélectionnez l'événement de formation et la date de formation.

![formations\_carte\_compétences.png](https://doc.dokos.io/content/rh/employee-skill-map/formations_carte_competences.png)


# Transfert des employés

Le transfert d'employés est une forme de mobilité interne, dans laquelle l'employé est transféré d'un emploi à un autre, généralement dans un emplacement, un service ou une unité différent.

Dans Dokos, vous pouvez enregistrer les transferts d'employés vers différentes entreprises ou services en utilisant le document de transfert d'employés.

---

Pour accéder à la **liste transfert d'employés**, allez sur :

Ressources humaines > Cycle de vie des employés > **Transfert d'employés**

![liste\_transfert\_des\_emplyés.png](https://doc.dokos.io/content/rh/employee-transfer/liste_transfert_des_emplyes.png)

## 1. Prérequis avant utilisation

- **[Employé](https://doc.dokos.io/v5/dokos/hrms/cycle-de-vie/employee)**
- **[Département](https://doc.dokos.io/v5/dokos/hrms/parametrage/departement)**

## 2. Comment créer un transfert d'employé

1. Sélectionnez l'employé.
2. Sélectionnez la date de transfert.
3. Sélectionnez la nouvelle entreprise au cas où l'employé serait transféré dans une autre entreprise (facultatif).

![nouveau\_liste\_transfert.png](https://doc.dokos.io/content/rh/employee-transfer/nouveau_liste_transfert.png)

4. Dans le tableau Détails du transfert d'employés, sélectionnez la propriété et définissez la valeur actuelle et nouvelle.
5. De plus, la case à cocher **Créer un nouvel employé** peut être cochée pour créer un nouvel ID d'employé pour l'employé transféré.

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
**Remarque** : Si l'option Créer un nouvel ID d'employé est cochée, un nouvel employé sera créé avec des modifications de propriété dans le tableau Détails du transfert et l'ancien employé sera marqué comme étant relevé. Les allocations de congé pour le nouvel employé doivent être créées manuellement à partir de la période de congé.
::

![détails\_transfert.png](https://doc.dokos.io/content/rh/employee-transfer/details_transfert.png)

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
**Remarque** : Le document de transfert peut être soumis à la date de transfert ou après. Une fois soumis, tous les changements ajoutés au tableau Détails du transfert seront appliqués à l'employé.
::


# Type d'emploi

Vous pouvez employer des personnes dans un certain nombre de catégories, chacune ayant son propre salaire et droit à des congés. C'est ce qu'on appelle un type d'emploi.

Dokos vous permet de sélectionner un type d'emploi dans une liste prédéfinie ou même de créer un nouveau type d'emploi en fonction de vos besoins.

---

Pour accéder à la liste des **types d'emploi**, allez sur :

Accueil > Ressources humaines > Employé > **Type d'emploi**

![type\_emploi\_.png](https://doc.dokos.io/content/rh/employment-type/type_emploi_.png)

## 1. Comment créer un type d'emploi

1. Accédez à la liste Type d'emploi, cliquez sur **➕Ajouter Type d'emploi**.
2. Entrez le **nom** du type d'emploi.
3. **Enregistrer**.

![créer\_type\_emploi.png](https://doc.dokos.io/content/rh/employment-type/creer_type_emploi.png)

Le type d'emploi peut être lié à la fiche employé.


# Événement de la formation

L'événement de formation vous permet de planifier des séminaires, des ateliers, des conférences, etc. dans le cadre d'un programme de formation.

Vous pouvez également inviter vos employés à assister à l'événement en utilisant cette fonctionnalité.

---

Pour accéder à **la liste événement de formation**, allez sur :

Accueil > Ressources humaines > Formation > **Événement de formation**

![nouveau\_événement.png](https://doc.dokos.io/content/rh/training-event/nouveau_evenement.png)

## 1. Prérequis avant utilisation

Avant de créer un événement de formation, il est conseillé de créer les documents suivants :

- **[Programme de formation](https://doc.dokos.io/v5/dokos/hrms/cycle-de-vie/training-program)**
- **[Employé](https://doc.dokos.io/v5/dokos/hrms/cycle-de-vie/employee)**

## 2. Comment créer un événement de formation

1. Accédez à la liste des événements de formation, cliquez sur ➕ Ajouter Événement de la formation.
2. Saisissez le **nom de l'événement**.
3. Sélectionnez le **type d'événement** (séminaire, conférence, examen etc.).
4. Sélectionnez le **niveau de l'événemen**t (débutant, intermédiaire, expert).
5. Entrez le **nom du formateur**, l'**e-mail** et le **numéro de contact**.
6. Sélectionnez le **cours de l'événement** . Saisissez l'**heure de début**, l'**heure de fin** et le **lieu** de l'événement de formation.
7. De plus, vous pouvez également écrire une brève description de l'événement dans la zone Description.
8. Enregistrer et envoyer.

![liste\_nouveau\_événement\_de\_formation.png](https://doc.dokos.io/content/rh/training-event/liste_nouveau_evenement_de_formation.png)

## 3. Caractéristiques

### 3.1 Introduction

Si vous souahitez renseigner des informations supplémentaires sur l'événement de la formation, vous pouvez le faire depuis cette section.

![introduction\_événement.png](https://doc.dokos.io/content/rh/training-event/introduction_evenement.png)

### 3.2 Participants

Vous pouvez inviter vos employés à assister à l'événement de formation. Vous pouvez le faire en sélectionnant les employés à inviter dans la **table Employés**.

Par défaut, le statut de l'employé sera **Ouvert**.

Ajoutez les participants qui devront participer à cet événement.
De plus, vous pouvez rendre l'événement obligatoire ou non dans le champ **Présence** pour l'employé qui sera inscrit comme participant.

![participants\_événements.png](https://doc.dokos.io/content/rh/training-event/participants_evenements.png)

### 3.3 Notification

Lorsque vous soumettez l'événement de formation, une notification sera envoyée à l'employé l'informant que la formation a été programmée. Ceci est envoyé via l'alerte e-mail **Formation programmée**. Vous pouvez modifier cette alerte e-mail pour personnaliser le message.


# Programme de formation

Le programme de formation définit des programmes conçus pour former des employés ou d'autres personnes à des compétences spécifiques.

Dans Dokos, vous pouvez créer un programme de formation et planifier des événements de formation sous celui-ci.

---

Pour accéder à la liste de programme de formation, allez sur :

> Accueil > Ressources humaines > Formation > **Programme de formation**

![liste\_programme\_de\_formation.png](https://doc.dokos.io/content/rh/training-program/liste_programme_de_formation.png)

## 1. Comment créer un programme de formation

1. Accédez à la liste des programmes de formation, cliquez sur **➕ Ajouter Programme de formation**.
2. Saisissez le **nom du programme de formation**.
3. Entrez le **nom du formateur**, l'**e-mail du formateur** et le **numéro de contact**.
4. Sélectionnez le fournisseur (facultatif) au cas où un fournisseur/expert externe aurait été appelé pour mener la formation.

![détails\_programme\_formation.png](https://doc.dokos.io/content/rh/training-program/details_programme_formation.png)

De plus, vous pouvez également rédiger une brève description du programme de formation dans la case Description (facultatif).

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
**Remarque** : Par défaut, le statut du programme de formation est « Planifié ». Cependant, vous pouvez modifier le statut en « Terminé » ou « Annulé » selon les besoins.
::

Une fois le programme d'entraînement enregistré, vous pouvez créer des événements d'entraînement sous celui-ci.


# Résultat de la formation

Une fois l'événement de formation terminé, les résultats de la formation des employés peuvent être stockés en fonction de l'évaluation effectuée par le formateur.

Dokos vous permet de créer des résultats de formation et de les partager avec les employés.

---

Pour accéder à **la liste de résultat de la formation**, allez sur :

> Accueil > Ressources humaines > Formation > **Résultat de la formation**

![résultat\_de\_la\_formation.png](https://doc.dokos.io/content/rh/training-result/resultat_de_la_formation.png)

## 1. Prérequis avant utilisation

Avant de créer un résultat d'entraînement, il est conseillé de créer les documents suivants :

- **[Programme de formation](https://doc.dokos.io/v5/dokos/hrms/cycle-de-vie/training-program)**
- **[Événement de formation](https://doc.dokos.io/v5/dokos/hrms/cycle-de-vie/training-event)**
- **[Employé](https://doc.dokos.io/v5/dokos/hrms/cycle-de-vie/employee)**

## 2. Comment créer un résultat d'entraînement

1. Accédez à la liste des résultats de formation, cliquez sur **➕ Ajouter Résultat de formation**.
2. Sélectionnez **Événement de formation**.
3. Entrez les **heures**, l'**échelon** et les commentaires en regard du nom de l'employé.
4. Enregistrer et envoyer

![détails\_résultat\_de\_la\_formation.png](https://doc.dokos.io/content/rh/training-result/details_resultat_de_la_formation.png)

Lorsque le résultat de la formation est soumis, tous les employés recevront un e-mail les informant qu'ils doivent partager leurs commentaires via Training Feedback . Ceci est également géré via une alerte par e-mail, vous pouvez donc également personnaliser cette alerte.

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
**Remarque** : Vous pouvez également accéder aux résultats de la formation directement à partir du tableau de bord des événements de formation.
::


# Demande de déplacement

Les employés peuvent demander des fonds pour un voyage officiel en utilisant la demande de voyage. Pour créer une nouvelle demande de déplacement, rendez-vous sur

> Ressources humaines > Frais de déplacement et de remboursement > Demande de déplacement > **Demande de déplacement**

Demande de déplacement

Vous pouvez également mentionner l'itinéraire de voyage ainsi que les coûts impliqués pour le voyage. Les employés peuvent également vérifier Travel Advance Requireds'ils souhaitent recevoir un paiement initial de l'entreprise.

## 1. Comment créer une demande de déplacement

## 2. Caractéristiques

### 2.1 Détails des employés

### 2.2 Description

### 2.3 Itinéraire du déplacement

### 2.4 Détails des coûts

### 2.5 Dimensions comptables

### 2.6 Détails de l'événements


# Véhicule

Le document Véhicule vous permet de définir les différents types de Véhicules dans votre Organisation. Il agit en tant que maître de véhicule pour la gestion de flotte.

---

Pour accéder à la fiche véhicule, allez sur :

> Accueil > Ressources humaines > Gestion de flotte > **Véhicule**

![liste\_véhicule.png](https://doc.dokos.io/content/rh/vehicle/liste_vehicule.png)

## 1. Comment ajouter un Véhicule ?

1. Allez dans la liste des véhicules, cliquez sur **➕ Ajouter Véhicule**.
2. Entrez des informations telles que la **plaque d'immatriculation**, la **marque** (marque) et le **modèle**.
3. Entrez la valeur du compteur kilométrique (Dernier).
4. Entrez d'autres détails supplémentaires tels que le type de carburant et l'unité de mesure du carburant.
5. **Enregistrer**.

![détails\_véhicules.png](https://doc.dokos.io/content/rh/vehicle/details_vehicules.png)

## 2. Caractéristiques

Outre les fonctionnalités obligatoires susmentionnées, certaines fonctionnalités supplémentaires pouvant être capturées dans le fichier maître du véhicule sont les suivantes :

### 2.1 Détails sur le véhicule

Des détails supplémentaires sur le véhicule sont à complèter sur la fiche :

- Numéro de châssis
- Date d'acquisition
- Valeur du véhicule (montant)
- Emplacement
- Employé gérant le véhicule

![détails.png](https://doc.dokos.io/content/rh/vehicle/details.png)

### 2.2 Détails de l'assurance

Les détails de l'assurance peuvent être indiqués dans la fiche du véhicule.

- Compagnie d'assurance
- Politique N°
- Date de début
- Date de fin

![détails\_assurance.png](https://doc.dokos.io/content/rh/vehicle/details_assurance.png)

### 2.2 Détails supplémentaires

De plus, les attributs du véhicule tels que la couleur, les roues, la porte, le dernier contrôle du carbone, le type de carburant et l'UOM peuvent être enregistrés dans le maître du véhicule.

![détails\_supplémentaires.png](https://doc.dokos.io/content/rh/vehicle/details_supplementaires.png)


# Journal du véhicule

Le journal du véhicule est utilisé pour entrer les lectures du compteur kilométrique, les dépenses de carburant et les détails des dépenses de service.

---

Pour accéder à **la liste de journal du véhicule**, allez sur :

> Accueil > Ressources humaines > Gestion de flotte > **Journal de véhicule**

![liste\_journal.png](https://doc.dokos.io/content/rh/vehicle-log/liste_journal.png)

## 1. Prérequis avant utilisation

Avant de créer un journal de véhicule, il est nécessaire de créer les documents suivants :

- **[Véhicule](https://doc.dokos.io/v5/dokos/hrms/cycle-de-vie/vehicle)**

## 2. Comment créer un journal de véhicule ?

1. Accédez à la liste des journaux de véhicule, cliquez sur Nouveau.
2. Sélectionnez Plaque d'immatriculation et Employé.
3. Entrez les informations de lecture du compteur kilométrique telles que la date et le compteur kilométrique (lecture).
4. Entrez les détails du ravitaillement [facultatif] tels que la quantité de carburant, le prix du carburant, le fournisseur et la référence de la facture.
5. De plus, les détails du service du véhicule peuvent également être ajoutés comme indiqué (facultatif).
6. Enregistrer. Une fois les informations enregistrées, les valeurs du modèle et de la marque seront automatiquement récupérées.

![détails\_journal.png](https://doc.dokos.io/content/rh/vehicle-log/details_journal.png)

## 3. Caractéristiques

La gestion de flotte dans Dokos vous permet de créer automatiquement une note de frais contre vos dépenses de véhicule.

### 3.1 Relevé du Compteur Kilométrique

Le relevé du compteur kilométrique permeet d'indiquer à une date la valeur actuelle de l'odomètre.

![relevé\_du\_compteur.png](https://doc.dokos.io/content/rh/vehicle-log/releve_du_compteur.png)

### 3.2 Détails du ravitaillement

Dans les détails de ravitaillement, plusieurs champs sont à renseigner.

- Quantité de carburant
- Prix du carburant
- Fournisseur
- Facture de référence

![détails\_du\_ravitaillement.png](https://doc.dokos.io/content/rh/vehicle-log/details_du_ravitaillement.png)

### 3.3 Détails du service

Dans les détails du service vous allez pouvoir indiquez tous les autres frais liés à l'utilisation du véhicule. Toutes les réparations qui vont intervenir sur le véhicule seront à indiquer dans la table détails du service.

- **Poste de service** : Vidange, Plaquette de freins, Roues etc.
- **Type** : Inspection, Changement, Service
- **Fréquence** : Kilométrage, Mensuel, Trimestriel, Semestriel, Annuel
- **Charges** : Montant des coûts.

![détails\_du\_service.png](https://doc.dokos.io/content/rh/vehicle-log/details_du_service.png)

### 3.4 Faire une demande de remboursement des dépenses du véhicule

Cliquez sur le bouton **Créer** puis sur le bouton **Note de frais**. Ce bouton n'apparaît que dans le cas des journaux de véhicule est validé.

![demande\_note\_de\_frais.png](https://doc.dokos.io/content/\(unsorted\)/demande_note_de_frais.png)

Lorsque vous cliquez sur **Note de frais**,

1. La date, l'employé et le total des dépenses sont récupérés dans la note de frais créée.
2. La somme des dépenses de carburant et des dépenses de service est calculée et ajoutée au montant de la note de frais.
3. L'employé peut soumettre la note de frais pour un traitement ultérieur.

![créer\_note\_de\_frais.png](https://doc.dokos.io/content/\(unsorted\)/creer_note_de_frais.png)


# Entretiens

## 1. **Définition entretien**

Un entretien, dans le contexte du recrutement, est une rencontre formelle entre un candidat et un ou plusieurs représentants de l'entreprise, visant à évaluer les compétences, les qualifications, l'expérience et la personnalité du candidat. Cet échange permet de déterminer si le candidat est adapté au poste proposé et à la culture de l'entreprise. L'entretien peut se dérouler sous différentes formes, telles que des entretiens en face à face, par téléphone, ou par visioconférence.

## 2. **Type d'entretien**

::tour{demo="Mappemonde" doctype="interview-type"}
Créer un type d'entretien dans la démo
::

Ce formulaire est utilisé pour définir et gérer les différents types d'entretiens qui peuvent être planifiés dans le cadre du processus de recrutement. Cela permet de standardiser les types d'entretiens et de faciliter leur sélection lors de la planification d'un entretien pour un candidat.

![Cette image permet de visualiser le formulaire : Type d'entretien](https://doc.dokos.io/RH5.png)

1. **Nom du type d'entretien :** Saisissez un nom descriptif pour le type d'entretien, par exemple "Entretien téléphonique", "Entretien en présentiel", "Entretien vidéo", etc.
2. **Description :** Ajoutez une description détaillée du type d'entretien, précisant dans quelles situations il est utilisé, ses objectifs, et toute autre information pertinente.

## 3. **Cycle d'entretien**

::tour{demo="Mappemonde" doctype="interview-round"}
Créer un cycle d'entretien dans la démo
::

**Avantages du cycle d'entretien :**

1. **Structure et cohérence** : Assure une évaluation équitable et standardisée de tous les candidats.
2. **Efficacité** : Optimise le temps et les ressources en planifiant et en exécutant les entretiens de manière organisée.
3. **Expérience candidat** : Améliore l'expérience globale du candidat en offrant un processus clair et respectueux.
4. **Qualité de l'embauche** : Augmente les chances de sélectionner le candidat le plus qualifié et le plus adapté au poste et à l'entreprise.

![Cette image permet de visualiser le formulaire : Cycle d'entretien](https://doc.dokos.io/RH6.png)

**Nom du cycle :** Entrez un nom descriptif pour ce cycle d'entretien. Ce nom aidera à identifier facilement ce cycle parmi d'autres.

**Type d'entretien :** Sélectionnez le type d'entretien à partir des options disponibles (par exemple, Entretien téléphonique, Entretien en face à face, Entretien vidéo).

**Intervieweurs :** Listez les noms des intervieweurs qui participeront à ce cycle d'entretien. Cela peut inclure des recruteurs, des managers, ou d'autres membres de l'équipe.

**Compétence :** Entrez le nom ou la description de la compétence attendue pour ce poste. Cela peut inclure des compétences techniques, comportementales, ou spécifiques au poste.

**Description :** Ajoutez une description détaillée de la compétence. Cela peut inclure des exemples de comment cette compétence pourrait se manifester dans le travail quotidien.

**Évaluation moyenne attendue :** Indiquez l'évaluation moyenne attendue pour ce cycle d'entretien. Cette évaluation peut aider à définir un seuil de performance que les candidats doivent atteindre ou dépasser.

## 4. **Entretien**

::tour{demo="Mappemonde" doctype="interview"}
Créer un entretien dans la démo
::

En utilisant ce formulaire, les recruteurs peuvent s'assurer que chaque entretien est bien documenté, évalué de manière cohérente et suivi efficacement. Cela contribue à améliorer la qualité des décisions d'embauche et à optimiser l'expérience des candidats.

![Cette image permet de visualiser le formulaire : Entretien](https://doc.dokos.io/RH7.png)

**Cycle d'entretien :** Sélectionnez le cycle d'entretien auquel appartient cet entretien. (Cycles prédéfinis).

**Statut :** Indiquez le statut actuel de l'entretien.

**Candidat :** Sélectionnez le candidat qui sera évalué.

**Planifié :** Indiquez la date à laquelle l'entretien est planifié.

**Récapitulatif d'entretien :** Fournissez un compte-rendu de l'entretien.

**Valider l'entretien**

## 5. **Commentaires**

::tour{demo="Mappemonde" doctype="interview-feedback"}
Créer des commentaires sur un entretien dans la démo
::

Les commentaires d'entretien sont les observations et les remarques faites sur un candidat après un entretien d'embauche.

Vous pouvez soumettre directement vos commentaires depuis le formulaire de l'entretien ou vous rendre dans l'onglet "Commentaires" pour ajouter des évaluations ou des remarques à l'entretien de votre choix.

![Cette image permet de visualiser le formulaire : Commentaire](https://doc.dokos.io/RH8.png)

\> **Remarque : seuls les intervieweurs associés à la** série d’entretiens sélectionnée peuvent soumettre des commentaires.


# Candidatures et recommandations

## 1. Candidature

Une candidature est l'ensemble des documents et informations soumis par un individu en réponse à une offre d'emploi ou à une opportunité professionnelle.

La candidature est le moyen par lequel un candidat exprime son intérêt pour un poste et met en avant ses compétences, son expérience et ses qualifications. Elle permet à l'employeur de déterminer si le candidat est un bon profil pour le poste et l'entreprise.

::tour{demo="Mappemonde" doctype="job-applicant"}
Créer une candidature dans la démo
::

### 1.1. Prérequis avant utilisation

Avant de créer un demandeur d'emploi, il est conseillé de créer les éléments suivants :

- Plan de dotation
- Département
- Offre d'emploi

![Cette image permet de visualiser le formulaire : Candidature.](https://doc.dokos.io/RH4.png)

#### 1.1.1. Détails

- **Nom du candidat**: Entrez le nom complet du candidat.
- **Adresse email**: Saisissez l'adresse email du candidat.
- **Numéro de téléphone**: Saisissez le numéro de téléphone du candidat.
- **Offre d'emploi**: Sélectionnez l'offre d'emploi pour laquelle le candidat postule.
- **Poste**: Spécifiez le poste pour lequel le candidat postule.
- **Statut**: Indiquez le statut de la candidature (ex: Ouvert).

- **Source**: Indiquez la source de la candidature (ex: Recommandations, site web, etc.).
- **Évaluation du postulant**: Attribuez une note au candidat en fonction de son profil et de ses qualifications.

- **Lettre de motivation**: Indiquez la lettre de motivation du candidat.
- **Pièce jointe du CV**: Utilisez cette section pour joindre le CV du candidat.
- **Lien vers le CV**: Si le CV est en ligne, vous pouvez fournir un lien direct vers celui-ci.

- **Tranche inférieure**: Indiquez le salaire minimum attendu par le candidat.
- **Tranche supérieure**: Indiquez le salaire maximum attendu par le candidat.

### 1.2. Liaison avec un compte de messagerie

Vous pouvez lier une demande d'emploi à un compte de messagerie. Supposons que vous liez une demande d'emploi avec un e-mail <job@example.com>, le système créera un nouveau demandeur d'emploi pour chaque e-mail reçu sur la boîte aux lettres.

Pour lier le compte de messagerie avec le demandeur d'emploi, accédez à :

> Paramètres > Compte de messagerie > **Nouveau compte de messagerie**

Entrez l'adresse e-mail et le mot de passe, puis sélectionnez « **Activer l'entrée** »

Dans **Ajouter à**, sélectionnez **Demandeur d'emploi**

### 1.3. Dépôt de candidature en ligne

Lorsque vous publiez une offre d'emploi, Dokos génère automatiquement un formulaire de candidature accessible depuis votre portail web. Les candidats externes peuvent ainsi postuler directement en ligne, sans avoir besoin d'un compte dans votre système.

Le formulaire en ligne comprend désormais un champ **Pièce jointe du CV**, qui permet au candidat de joindre son CV directement lors de la soumission de sa candidature. Ce fichier est ensuite accessible dans la fiche candidature correspondante, au même titre qu'une pièce jointe ajoutée manuellement depuis le back-office.

**Sécurisation des soumissions avec reCAPTCHA**

Pour protéger votre formulaire de candidature contre les soumissions automatisées et les spams, Dokos intègre désormais une vérification **reCAPTCHA**. Cette fonctionnalité est activable via les paramètres des Ressources Humaines.

> **Configuration requise** :
>
> 1. Accédez à **Ressources Humaines > Paramètres RH**.
> 2. Activez l'option **Activer reCAPTCHA pour les candidatures en ligne**.
> 3. Saisissez votre **Clé du site reCAPTCHA** et **Clé secrète reCAPTCHA** (obtenues depuis la console d'administration Google reCAPTCHA).
> 4. Enregistrez les modifications.

> **Exemple** : Maison Verte SARL active reCAPTCHA pour son formulaire de candidature au poste de « Responsable logistique ». Les candidats doivent désormais cocher une case « Je ne suis pas un robot » avant de soumettre leur candidature, réduisant ainsi les soumissions frauduleuses.

### 1.4. Vue Kanban du pipeline de recrutement

Dokos propose désormais une **vue Kanban** pour visualiser et gérer le pipeline de recrutement des candidats. Cette vue permet de suivre l'avancement des candidatures de manière intuitive et collaborative.

#### 1.4.1. Accéder à la vue Kanban

1. Allez dans **Ressources Humaines > Recrutement > Candidatures**.
2. Cliquez sur l'icône **Vue Kanban** dans la barre d'outils de la liste.

![Vue Kanban du pipeline de recrutement](https://doc.dokos.io/RH-kanban-view.png)

#### 1.4.2. Colonnes du Kanban

La vue Kanban est organisée en colonnes correspondant aux statuts des candidatures. Par défaut, les colonnes suivantes sont disponibles :

- **Ouvert** : Candidatures reçues, en attente de première évaluation.
- **En cours d'évaluation** : Candidatures en cours d'examen par les recruteurs.
- **Entretien planifié** : Candidatures pour lesquelles un entretien a été programmé.
- **Offre envoyée** : Candidatures ayant reçu une offre d'emploi.
- **Embauché** : Candidatures ayant abouti à une embauche.
- **Rejeté** : Candidatures non retenues.

> **Astuce** : Vous pouvez personnaliser les colonnes du Kanban en modifiant les statuts disponibles pour le doctype **Candidature** via **Paramètres > Personnalisation des données > Statuts**.

#### 1.4.3. Gérer les candidatures dans le Kanban

- **Déplacer une candidature** : Faites glisser une carte de candidature d'une colonne à l'autre pour mettre à jour son statut.
- **Modifier une candidature** : Cliquez sur une carte pour ouvrir la fiche détaillée de la candidature et apporter des modifications.
- **Ajouter une note** : Cliquez sur l'icône de commentaire dans une carte pour ajouter une note ou un rappel concernant la candidature.
- **Filtrer les candidatures** : Utilisez les filtres en haut de la vue Kanban pour afficher uniquement les candidatures correspondant à des critères spécifiques (ex: offre d'emploi, département, source).

> **Exemple** : La responsable RH de Maison Verte SARL utilise la vue Kanban pour suivre les candidatures au poste de « Responsable logistique ». Elle déplace la candidature de Jean Dupont de la colonne **En cours d'évaluation** à **Entretien planifié** après avoir programmé un entretien avec lui. Elle ajoute une note dans la carte pour rappeler de vérifier ses références avant l'entretien.

#### 1.4.4. Avantages de la vue Kanban

- **Visualisation claire** : Obtenez une vue d'ensemble immédiate de l'état de votre pipeline de recrutement.
- **Collaboration facilitée** : Partagez la vue Kanban avec votre équipe pour une coordination optimale.
- **Suivi en temps réel** : Les mises à jour de statut sont instantanément reflétées dans le Kanban.
- **Personnalisation** : Adaptez les colonnes du Kanban à votre processus de recrutement spécifique.

### 1.5. Créer un employé depuis une candidature

Lorsqu'un candidat est retenu et que vous souhaitez l'embaucher, vous pouvez créer directement une fiche **Employé** à partir de la candidature. Dokos pré-remplit automatiquement la nouvelle fiche avec les informations déjà saisies dans la candidature, ce qui évite la double saisie et réduit les erreurs.

#### 1.5.1. Données copiées automatiquement

Les informations suivantes sont automatiquement reportées depuis la candidature vers la nouvelle fiche employé :

- **Nom** du candidat
- **Adresse email**
- **Numéro de téléphone**
- **Poste** (désignation visée)
- **Devise du salaire** attendu
- **Lien vers la candidature** d'origine, pour conserver la traçabilité

#### 1.5.2. Données issues de l'offre d'emploi

Si la candidature est rattachée à une **offre d'emploi**, Dokos récupère également les informations suivantes depuis cette offre :

- **Société** (entité juridique employeuse)
- **Département** de rattachement
- **Type d'emploi** (ex: temps plein, temps partiel, stage)

#### 1.5.3. Procédure

1. Ouvrez la fiche **Candidature** du candidat retenu.
2. Dans le tableau de bord ou la section **Connexions** de la candidature, cliquez sur **Créer > Employé**.
3. Dokos ouvre une nouvelle fiche **Employé** pré-remplie avec les informations du candidat et de l'offre d'emploi.
4. Vérifiez les informations importées et complétez les champs restants (ex: date de naissance, adresse, numéro de sécurité sociale).
5. Enregistrez la fiche employé.

> **Exemple** : Maison Verte SARL a sélectionné Jean Dupont pour le poste de « Responsable logistique ». Depuis sa candidature, la responsable RH clique sur **Créer > Employé** : la nouvelle fiche s'ouvre avec le nom « Jean Dupont », son adresse email, son numéro de téléphone, la désignation « Responsable logistique » et la devise du salaire attendu déjà renseignés. Comme la candidature était liée à l'offre d'emploi « Responsable logistique – Lyon », la société, le département et le type d'emploi (temps plein) sont également pré-remplis. Il ne reste plus qu'à saisir la date de prise de fonction et l'adresse postale.

## 2. Recommandations

::tour{demo="Mappemonde" doctype="employee-referral"}
Créer une recommandation dans la démo
::

Cette fonctionnalité permet d'optimiser le processus de recrutement en intégrant des recommandations pour les candidats, souvent basées sur des références internes ou des suggestions des employés actuels.

![Image permettant de visualiser le formulaire : Recommandations.](https://doc.dokos.io/RH12.png)

### 2.1. Remplir le formulaire

1. **Informations de base sur le candidat :**

   - **Prénom :** Saisissez le prénom du candidat.
   - **Nom :** Saisissez le nom de famille du candidat.
   - **Date :** Indiquez la date de la recommandation.
   - **Pour le poste :** Indiquez le poste pour lequel le candidat est recommandé.
2. **Détails de contact du candidat :**

   - **Email :** Fournissez l'adresse email du candidat.
   - **Employeur actuel :** Indiquez l'employeur actuel du candidat.
   - **N° du contact :** Fournissez le numéro de contact du candidat.
   - **Intitulé du poste actuel :** Indiquez le poste actuel du candidat.
   - **Lien vers le CV :** Ajoutez un lien vers le CV du candidat ou joignez le fichier.
3. **Détails du référent :**

   - **Référent :** Sélectionnez l'identifiant de l'employé référent.
   - **Est applicable pour un bonus de recommandation :** Cochez cette case si un bonus est applicable pour cette recommandation.
4. **Informations additionnelles :**

   - **Pour quelles raisons est-ce que ce candidat est qualifié pour ce poste ?** - Décrivez en détail les raisons pour lesquelles le candidat est qualifié pour le poste. Par exemple, son expérience professionnelle, ses compétences spécifiques, etc.
   - **Références de travail :**

     - Fournissez les références de travail pertinentes pour le candidat, y compris les noms, les postes, les sociétés, et les coordonnées de contact.

### 2.2. Création d'une candidature

Lorsque vous soumettez un document de recommandation d'employé, le statut initial sera « En attente ». Après avoir soumis le document, le bouton « Créer un candidat à un poste » apparaîtra.


# Promesse d'embauche et proposition de poste

## 1. **Promesse d'embauche**

### 1.1. **Modèle de promesse d'embauche**

::tour{demo="Mappemonde" doctype="appointment-letter-template"}
Créer un modèle de promesse d'embauche dans la démo
::

1.1.1. Définition d'un modèle de promesse d'embauche

Une promesse d'embauche est un document formel par lequel un employeur s'engage à embaucher un candidat à un poste spécifique à une date future, sous certaines conditions. Ce document est essentiel pour formaliser l'accord entre l'employeur et le futur employé avant la signature du contrat de travail définitif.

Un modèle de promesse d'embauche standardise ce processus en fournissant une structure préétablie qui inclut tous les éléments nécessaires pour que la promesse soit claire, compréhensible et juridiquement valide.

![Cette image permet de visualiser le formulaire : Modèle de promesse d'embauche.](https://doc.dokos.io/RH9.png)

1.1.2. Formulaire

**Nom du modèle :** Saisissez un nom descriptif pour ce modèle de promesse d'embauche. Ce nom doit permettre d'identifier facilement le modèle parmi d'autres.

**Introduction :** Fournissez une introduction qui explique l'objet de la promesse d'embauche. Cette section doit introduire brièvement le poste, les parties impliquées (employeur et futur employé), et l'intention d'embauche.

**Termes :** Listez et décrivez les termes de la promesse d'embauche.

**Conclusions :** Fournissez une conclusion à la promesse d'embauche. Cela peut inclure des informations sur les prochaines étapes, la manière dont le candidat doit accepter l'offre, et des remerciements.

Une fois le modèle de promesse d'embauche défini et sauvegardé dans Dokos, vous pouvez l'utiliser pour générer des promesses d'embauche spécifiques pour différents candidats.

### 1.2. **Promesse d'embauche**

::tour{demo="Mappemonde" doctype="appointment-letter"}
Créer une promesse d'embauche dans la démo
::

![Cette image permet de visualiser le formulaire : Promesse d'embauche.](https://doc.dokos.io/RH10.png)

**Candidat :** Sélectionnez le candidat à qui la promesse d'embauche est destinée.

**Modèle de promesse d'embauche :** Sélectionnez le modèle de promesse d'embauche applicable. Les champs seront automatiquement remplis.

## 2. **Proposition de poste**

::tour{demo="Mappemonde" doctype="job-offer"}
Créer une proposition de pos dans la démo
::

Une proposition de poste est un document formel envoyé à un candidat pour lui offrir un poste spécifique dans l'entreprise. Elle détaille les conditions d'emploi, y compris le titre du poste, la date de début, le salaire, et d'autres termes importants.

![Cette image permet de visualiser le formulaire : Proposition de poste.](https://doc.dokos.io/RH11.png)

**Candidature :** Sélectionnez le candidat à qui la proposition de poste est destinée.

**Statut :** Indiquez le statut actuel de la proposition.

**Date de l'offre :** Indiquez la date à laquelle l'offre est émise.

**Modèle de clause d'offre d'emploi :** Sélectionnez un modèle prédéfini de clause d'offre d'emploi.

**Sélectionnez les conditions générales :** Indiquez si des conditions générales spécifiques doivent être appliquées à cette proposition. Vous pouvez définir des modèles de conditions générales.

> Fournissez des détails supplémentaires sur les termes et conditions de l'offre. Utilisez cet espace pour inclure toute information pertinente qui n'a pas été couverte dans les sections précédentes.

**Détails d'impression :** Vous pouvez créer un format d'impression prédéfini pour imprimer votre offre d'emploi.

Une fois la proposition de poste acceptée, vous pouvez mettre à jour le statut. Un bouton vous permettra alors de créer un employé.


# Offre d'emploi

## Optimisation des Recrutements

Dokos permet de planifier les recrutements pour votre entreprise de manière efficace. Le nombre de postes ouverts que vous pouvez créer pour un titre de poste spécifique est restreint par les postes vacants définis dans le plan de dotation.

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
**Remarque** : Assurez-vous que l'option "Vérifier les postes vacants lors de la création d'une offre d'emploi" est activée dans la section des paramètres d'embauche des paramètres RH pour garantir que cette vérification soit effectuée.
::

![Cette image permet de visualiser le message indiquant que les postes liés à la dotation en cours sont tous créés.](https://doc.dokos.io/RH6.png)

## Offre d'emploi

### Prérequis avant utilisation

Avant de créer une offre d'emploi, il est conseillé de créer les éléments suivants :

- Plan de dotation
- Département

::tour{demo="Mappemonde" doctype="job-opening?status=Open"}
Créer une offre d'emploi articledans la démo
::

![Cette image permet de visualiser le formulaire : Offre d'emploi.](https://doc.dokos.io/RH3.png)

1. Informations générales

- **Titre du poste**: Entrez le titre du poste pour lequel vous souhaitez recruter.
- **Statut**: Sélectionnez le statut de l'offre d'emploi. Par défaut, il est "Ouvert".
- **Publié le**: Indiquez la date à laquelle l'offre d'emploi est publiée. Par défaut, la date et l'heure actuelles sont renseignées.
- **Ferme le**: Indiquez la date à laquelle l'offre d'emploi sera automatiquement fermée si elle n'est plus active.

2. Détails de la société

- **Type de poste**: Indiquez si le poste est à temps plein, temps partiel, ou autre.
- **Département**: Entrez le département de l'entreprise qui recrute.

3. Références

- **Publier sur le site web**: Cochez cette option si vous souhaitez publier l'offre d'emploi sur le site web de l'entreprise.

4. Description

- Cette section est utilisée pour fournir une description détaillée de l'offre d'emploi, y compris les responsabilités, les compétences requises et les qualifications.

5. Détails du salaire

- **Devise**: Sélectionnez la devise dans laquelle le salaire sera payé (ex: EUR).
- **Tranche inférieure**: Indiquez le salaire minimum pour le poste.
- **Tranche supérieure**: Indiquez le salaire maximum pour le poste.
- **Salaire payé par**: Spécifiez la périodicité du paiement (ex: Mois).
- **Publier les tranches salariales**: Cochez cette option si vous souhaitez afficher les tranches salariales sur l'offre d'emploi.

## Améliorations de l'interface utilisateur

### Affichage du titre de l'offre d'emploi

À partir de cette version, le **titre de l'offre d'emploi** est affiché à la place de l'ID dans toutes les listes et formulaires liés aux candidatures. Cela améliore la lisibilité et facilite l'identification des offres pour les utilisateurs.

**Exemple** :
Si vous consultez la liste des candidats pour une offre intitulée "Responsable Marketing", vous verrez désormais "Responsable Marketing" au lieu d'un identifiant technique comme "JOB-2026-001".

### Prévention des candidatures dupliquées

Pour éviter les doublons de candidatures, Dokos vérifie désormais si un candidat a déjà postulé pour une offre d'emploi spécifique. Si une candidature existe déjà pour ce candidat et cette offre, un message d'avertissement s'affiche et bloque la création d'une nouvelle candidature.

**Scénario d'utilisation** :

- Un candidat nommé "Jean Dupont" postule pour l'offre "Responsable Marketing".
- S'il tente de postuler une seconde fois pour la même offre, Dokos affiche un message :

  > "Une candidature existe déjà pour ce candidat et cette offre d'emploi. Veuillez vérifier la liste des candidats."

::callout{color="blue" icon="i-heroicons-information-circle"}
**Astuce** : Cette fonctionnalité est particulièrement utile pour les entreprises recevant un grand nombre de candidatures et souhaitant éviter les doublons dans leur processus de recrutement.
::

Une fois l'offre d'emploi enregistrée, vous pouvez directement créer un nouveau demandeur d'emploi à partir du tableau de bord.

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
**Remarque** : Vous pouvez définir le statut de l'ouverture de tâche comme Ouvert/Fermé. Une fois qu'une offre d'emploi est fermée, vous ne pouvez pas créer de postulant pour celle-ci.
::


# Gestion des plans de dotation et des demandes de création de poste

## 1. Plan de dotation

Un plan de dotation dans Dokos est un outil de gestion des ressources humaines qui permet de planifier, suivre et gérer les besoins en personnel. Il aide à identifier les postes à pourvoir et à anticiper les besoins futurs en personnel.

### 1.1. Prérequis

- Avoir défini des départements
- Avoir défini des postes

#### 1.1.1. Le plan de dotation permet de :

- **Anticiper les besoins en personnel** : En identifiant à l'avance les postes qui devront être pourvus, le plan de dotation aide à éviter le manque d'employés.
- **Gérer les budgets de recrutement** : En fixant des coûts estimés pour chaque poste et en établissant un budget total, le plan de dotation aide à contrôler les dépenses liées aux recrutements.

#### 1.1.2. Analyse des besoins en personnel :

Évaluation des besoins actuels et futurs en personnel en fonction des objectifs de l'entreprise, des projets en cours, et des prévisions de croissance.

### 1.2. Plan de dotation

::tour{demo="Mappemonde" doctype="staffing-plan"}
Créer un plan de dotation dans la démo
::

![Cette image permet de visualiser le formulaire plan de dotation.](https://doc.dokos.io/RH1.png)

- **Nom** : Définir un nom clair et compréhensible.
- **Département** : Facultatif, ce champ permet d'affiner votre plan de dotation en fonction des départements de votre entreprise.
- **Obtenir les demandes d'ouverture de postes** : Permet de récupérer les demandes d'ouverture d'emploi soumises et validées.
- **Postes vacants** : Nombre de postes que vous souhaitez recruter.
- **Coût estimé par poste** : Spécifiez le coût pour l'entreprise par poste.

> Estimation des coûts, y compris les salaires, les avantages sociaux, les coûts de recrutement et les dépenses de formation.

- **Budget total estimé** : Une fois que vous avez saisi le plan de recrutement, le plan de dotation établira le budget total estimé conformément au plan.

## 2. Demande d'ouverture de poste

::tour{demo="Mappemonde" doctype="job-requisitionm"}
Créer une demande d'ouverture de poste dans la démo
::

Une demande d'emploi est un **document interne utilisé pour initier le processus d'embauche d'un nouvel employé**. Ce document permet de structurer et de formaliser la demande de création d'un nouveau poste, assurant ainsi que toutes les étapes nécessaires sont suivies et que toutes les informations requises sont collectées.

Ces demandes sont ensuite transformées en offres d'emploi ou intégrées dans le budget lors de la création du **plan de dotation**. La demande passe généralement par un processus de validation et d'approbation par les responsables concernés avant de lancer le recrutement, garantissant que le besoin est justifié et budgétisé.

![Cette image de visualiser le formulaire de création d'une demande d'un nouveau poste.](https://doc.dokos.io/RH2.png)

1. **Détails du Poste** :

- **Masque de numérotation** : Une référence unique pour identifier la demande
- **Nombre de postes** : Indiquer le nombre de postes à pourvoir.
- **Poste** : Titre du poste.
- **Département** : Département où le poste sera intégré.
- **Statut** : État de la demande (en attente, approuvée, rejetée, etc.).

> Vous avez la possibilité de créer un [**flux de travail**](https://doc.dokos.io/v5/dokos/parametrage/demarrage/workflows) pour définir le flux d'approbation de cette demande.

2. **Rémunération attendue** :\* Indique la compensation prévue pour le poste. Généralement, cette valeur est en brut.
3. **Demandé par** : Nom de la personne qui initie la demande d'ouverture de poste.
4. **Échéances** :

- **Date de comptabilisation** : La date à laquelle le poste doit être créé ou la date de début du recrutement.
- **Attendu pour** : Date à laquelle le poste doit être pourvu.

5. **Description du poste** :

- **Description du poste**: Détail de la fiche de poste.
- **Motif de la demande**: Justification de la demande d'ouverture de poste.

![Cette image permet de visualiser le formulaire de demande de création de poste, avec la bannière recommandation.](https://doc.dokos.io/RH3BIS.png)

Lorsque la demande est enregistrée (statut en attente ou approuvé), une bannière apparaîtra si une recommandation est ouverte, permettant de ne pas ouvrir d'offre d'emploi si cette personne convient pour le poste demandé.

Une fois la demande approuvée, vous pouvez directement créer une offre d'emploi ou associer cette demande à une offre d'emploi déjà créée.

### 2.1. Détection des doublons

Lorsque vous créez une nouvelle demande d'ouverture de poste, Dokos vérifie automatiquement si une demande similaire existe déjà. Une demande est considérée comme un doublon si elle correspond au **même poste**, au **même département** et au **même demandeur**, avec un statut en attente ou approuvé.

Si un doublon est détecté au moment de l'enregistrement, une boîte de dialogue de confirmation s'affiche :

- **Annuler** : revenir au formulaire sans enregistrer, pour vérifier ou modifier la demande.
- **Confirmer** : enregistrer la demande malgré le doublon, si le besoin est justifié (par exemple, deux recrutements distincts pour le même poste dans le même département).

> Cette vérification s'applique uniquement aux nouvelles demandes. Les demandes déjà enregistrées ne sont pas affectées.

**Exemple** : Si la gestionnaire RH de Maison Verte SARL tente de créer une demande pour le poste « Développeur Python » dans le département « Informatique », alors qu'une demande identique est déjà en attente d'approbation, une alerte s'affiche avant l'enregistrement. Elle peut alors confirmer qu'il s'agit bien d'un besoin supplémentaire, ou annuler pour consulter la demande existante.


# Notes de frais

Une **note de frais** est un document utilisé pour enregistrer et suivre les dépenses engagées par les employés au nom de l'entreprise. Ces dépenses peuvent inclure les frais de déplacement, les repas, les fournitures de bureau, le carburant, etc. La note de frais permet aux employés de soumettre les dépenses qu'ils ont payées de leur propre poche pour être remboursées par l'entreprise.

> Ressources humaines > Notes de frais > **Demandes**

Prérequis :

1. [Employé](https://doc.dokos.io/v5/dokos/hrms/cycle-de-vie/employee)
2. [Département](https://doc.dokos.io/v5/dokos/hrms/parametrage/departement)
3. [Modèle de taxes et frais d'achat](https://doc.dokos.io/v5/dokos/achats/taxes)

Avant de créer des notes de frais ou des dépenses, vous devez définir vos modèles de types de notes de frais ainsi que les modèles de taxes associés.

### 1. Type de note de frais

::tour{demo="Mappemonde" doctype="expense-claim-type"}
Créer un type de note de frais dans la démo
::

Les types de notes de frais permettent de catégoriser et de gérer les différentes dépenses engagées par les employés. Cela aide à standardiser les processus de soumission, d'approbation, et de remboursement des frais.

Les administrateurs ou responsables de la comptabilité peuvent définir différents types de notes de frais pour catégoriser les dépenses.

**1.1. Ajouter un nouveau type de note de frais :**

- Remplir les champs requis :

1. **Nom du type de note de frais :**
   Par exemple, "Carburant", "Hébergement", "Repas", "Fournitures de Bureau", etc.
2. **Compte de dépense associé :** Sélectionner le compte de dépense approprié dans le plan comptable de votre entreprise.
3. **Taux de TVA applicable :** Spécifier le modèle de taxes, si nécessaire.

![Cette image permet de visualiser le formulaire : type de note de frais.](https://doc.dokos.io/type-de-note-de-frais.png)

#### 1.2. Modèle de taxes

::tour{demo="Mappemonde" doctype="purchase-taxes-and-charges-template"}
Créer un modèle de taxe dans la démo
::

Créer un modèle de taxes sur un montant TTC car les employés vont saisir leurs montants en net TTC.

![Image permettant de visualiser la liste des modèles de taxes par défaut.](https://doc.dokos.io/modele-de-taxes-et-frais-d-achat.png)

Vous pouvez dupliquer les modèles par défaut, en modifiant le nom et la règle pour définir la taxe sur le montant TTC ou alors vous pouvez créer des modèles selon vos besoins.

![Image permettant de visualiser l'onglet permettant de dupliquer un formulaire.](https://doc.dokos.io/dupliquer-un-modele-de-taxe.png)![Image permettant de visualiser la zone indiquant : Cette taxe est-elle incluse dans le total net.](https://doc.dokos.io/modele-de-taxe-sur-ttc.png)

### 2. Créer une dépense

::tour{demo="Mappemonde" doctype="expense"}
Créer une dépense dans la démo
::

![Image permettant de visualiser le formulaire d'une nouvelle dépense.](https://doc.dokos.io/nouvelle-depense.png)![Image permettant de visualiser les dépenses d'un employés lors d'une formation.](https://doc.dokos.io/plusieurs-depenses.png)

2.1. Créer une dépense :

Renseignez les éléments suivants :

1. Date de la note de frais
2. Indiquez le détail des charges en sélectionnant le type de dépense approprié. Si votre dépense inclut plusieurs taux de TVA, veuillez créer une ligne distincte pour chaque taux de TVA différent.
3. Vous pouvez saisir de centre de coûts et le projet associé à la dépense, si nécessaire.

##### 2.2. TVA différente sur la même dépense :

Lorsqu'un ticket de caisse contient deux taux de TVA différents, par exemple dans le cas d'un repas au restaurant avec une boisson alcoolisée ou lorsqu'une note correspond à une dépense de carburant, il faut procéder de la manière suivante :

La gestion de la TVA sur les tickets peut être effectuée en enregistrant deux lignes distinctes dans la dépense ou note de frais. Cela permet de séparer les éléments soumis à des TVA distincte.

> Exemple pour le carburant :
>
> La gestion de la TVA pour les tickets de carburant peut se faire en utilisant deux lignes distinctes. Pour une dépense ou note de frais, ajoutez une ligne représentant 80% du montant pour le type de frais « Carburant avec TVA (20%) » et une autre ligne représentant 20% du montant pour le type de frais « Carburant sans TVA ».
>
> 1. **Carburant avec TVA déductible (80%) :** Montant 120\*0.8 = 96 EUR (80% de 120 EUR)
> 2. **Carburant sans TVA déductible (20%) :** Montant 120\*0.20 = 24 EUR (20% de 120 EUR)
>
> ![Cette image permet de visualiser la dépense de carburant avec deux lignes de TVA.](https://doc.dokos.io/depense-carburant.png)

2.3. Créer une note de frais à partir des dépenses :

![Image permettant de visualiser la création d'une note de frais à partir des dépenses.](https://doc.dokos.io/creer-une-note-de-frais-a-partir-des-depenses.png)

Le tableau des charges est saisi automatiquement en reprenant les informations des dépenses.

![Image permettant de visualiser une note de frais, en attente.](https://doc.dokos.io/note-de-frais.png)

En vous rendant sur le détail de chaque ligne, vous pourrez retrouver la dépense associée.

![Image permettant de visualiser la partie détail de la dépense.](https://doc.dokos.io/note-de-frais-detail-depense.png)

### 3. Note de frais

::tour{demo="Mappemonde" doctype="expense-claim"}
Créer une note de frais dans la démo
::

![Cette image permet de visualiser une note de frais.](https://doc.dokos.io/note-de-frais-direct.png)

#### 3.1. Créer une note de frais

1. Renseignez l'employé à l'origine de la dépense.
2. Ajoutez l'approbateur de la note de frais. (Elément à renseigner dans le département des postes)
3. Saisissez la date de la dépense, le type de demande de remboursement et le montant de la note de frais.
4. Calcul automatique ou ajouter les taxes manuellement. Si le montant des frais engagés est en net TTC et que vous choisissiez d'ajouter manuellement les taxes, cochez la case : **Taxe incluse dans le montant de la dépense** ![Image permettant de visualiser le calcul manuel de le TVA.](https://doc.dokos.io/note-de-frais-direct-calcul-manuel.png)
5. Insérer un justificatif : Vous pouvez joindre vos justificatifs de paiement en pièce jointe à gauche du formulaire.![Image permettant de visualiser la partie pièces jointes.](https://doc.dokos.io/ticket-de-caisse-bureau-note-de-frais.png)

#### 3.2. Comptabilité

Dans Détails comptables, sélectionnez le compte créditeurs par défaut de la société.

![Image permettant de visualiser la partie comptabilité de la note de frais.](https://doc.dokos.io/note-de-frais-compta.png)

1. **Date de comptabilisation** et **Date de rapprochement** : Ces dates sont essentielles pour suivre la période fiscale à laquelle la dépense est liée et pour les opérations de rapprochement bancaire.
2. **Mode de paiement** : Important pour la gestion de trésorerie et la traçabilité des paiements.
3. **Montant non rapproché** : Affiche le montant de la note de frais qui n'a pas encore été rapproché. Un montant de 0,00 € indique que tous les montants ont été rapprochés. Cela aide à identifier les écarts potentiels ou les montants non encore justifiés.
4. **Comptes créditeurs** : Indispensable pour la génération d'écritures comptables précises.
5. **Projet et Centre de coûts** : Facilitent l'analyse financière par projet ou par unité de coût, assurant une meilleure répartition et gestion des dépenses.

#### 3.3. Plus d'informations

Visualisez le statut de la note de frais. Le statut peut être Brouillon, Approuvé ou Rejeté.

![Image permettant de visualiser la zone plus d'informations du formulaire note de frais.](https://doc.dokos.io/note-de-frais-plus-d-info.png)

#### 3.4. Tableau de bord

![Image permettant de visualiser la zone tableau de bord dans les notes de frais.](https://doc.dokos.io/note-de-frais-tableau-de-bord.png)

Pour les notes de frais de grande valeur, il est possible de créer un acompte avant de traiter la note de frais complètement.
Ajouter une ligne avec les informations de l'acompte et de l'avance.

## 4. Flux de travail

::tour{demo="Mappemonde" doctype="workflow"}
Créer un flux de travail dans la démo
::

La création d'un flux de travail permet de définir et de personnaliser les étapes nécessaires à l'approbation ou au rejet d'un document. Ce flux de travail remplace le flux par défaut de Dokos.

Les notes de frais et les demandes de congés sont les seuls formulaires qui nécessitent obligatoirement un approbateur et qui ont un flux d'approbation par défaut. Le flux de travail personnalisé remplacera ce flux par défaut. Il est possible de créer des flux de travail pour tous les documents présents dans Dokos.

> Pour plus de détails, consultez la page [**flux de travail**](https://doc.dokos.io/v5/dokos/parametrage/demarrage/workflows) de la documentation.

Voici un exemple pour la validation des dépenses avec l'éditeur visuel :

Vous pouvez utiliser l'éditeur de flux de travail pour créer des flux de travail de manière visuelle. Cet outil permet de glisser-déposer des états et de les relier entre eux pour établir des transitions. Vous pouvez également modifier leurs propriétés à partir de la barre latérale.

Lorsque vous enregistrez votre schéma, les champs du formulaire en tableau se remplissent automatiquement.

![Cette image permet de visualiser le formulaire : Flux de travail.](https://doc.dokos.io/flux-de-travail.png)![Cette image permet de visualiser le formulaire : Créer un flux de travail](https://doc.dokos.io/flux-de-travail.png)![Cette image permet de visualiser le formulaire d'édition visuel.](https://doc.dokos.io/flux-de-travail.png)

1. État :

Vous pouvez créer des états selon vos besoins.

Exemple :

- **Brouillon** : État initial de la dépense.
- **Soumis à la validation** : La dépense est soumise pour approbation.
- **Approuvé** : La dépense est approuvée.
- **Rejeté** : La dépense est rejetée.
- **Annulé** : La dépense est annulée.

2. Statut du document :

- Brouillon : Ce statut est à utiliser jusqu'à l'approbation finale.
- Soumis : Ce statut fige le document; il n'est plus modifiable.
- Annulé

![Cette image permet de visualiser les états de mon document.](https://doc.dokos.io/fluxdetravail4.png)

3. Autoriser la modification uniquement pour :

Vous devez sélectionner le rôle autorisé à modifier l'état. Il est nécessaire de mener une réflexion sur les différents rôles de votre organisation.

4. Mettre à jour le champ / mettre à jour la valeur :![Image permettant de visualiser la mise à jour d'un champ dans un document automatiquement.](https://doc.dokos.io/fluxdetravail22.png)Dans certains documents, lorsque aucun flux de travail n'est défini, l'approbateur doit modifier manuellement le statut du document. En mettant en place un flux de travail, vous devez définir le champ à mettre à jour ainsi que la valeur de mise à jour.![Cette image permet de visualiser un formulaire de note de frais avec une menu déroulant permettant de modifier le statut du document.](https://doc.dokos.io/fluxdetravail21.png)

![Cette image permet de visualiser une transition possible.](https://doc.dokos.io/fluxdetravail5bis.png)

5. Propriété de la transition : Les règles de transition déterminent comment les états changent d'un état à un autre. \* Exemple : **De Brouillon à Soumis à la validation** : Action (Bouton) "Soumettre à la validation" par l'employé.

- Vous avez la possibilité de définir des conditions, ce qui peut être utile pour orienter une demande selon son montant. Par exemple : si le montant de la dépense est supérieur à 50 €, l'approbation doit être faite par l'approbateur des notes de frais, alors que si cette dépense est inférieure ou égale à 50 €, l'employé peut lui-même valider sa dépense.

Voici un exemple finalisé de flux de travail, avec la visualisation graphique et sous forme de tableau.

![Cette image permet de visualiser un flux de travail finalisé.](https://doc.dokos.io/fluxdetravail5.png)![Image permet de visualiser le formulaire avec les champs sous forme de tableau.](https://doc.dokos.io/fluxdetravail6.png)

> Nous vous recommandons de consulter la documentation sur les [**flux de travail**](https://doc.dokos.io/v5/dokos/parametrage/demarrage/workflows) afin d'obtenir une compréhension globale.

### 3.2 Réservation de la dépense

Lors de la soumission d'une note de frais, le système comptabilise une dépense sur le compte de dépenses et le compte de l'employé

L'utilisateur peut afficher les notes de frais impayées à l'aide du rapport « Notes de dépenses non réclamées »

### 3.3 Paiement de la note de frais

Pour effectuer le paiement contre la note de frais, l'utilisateur doit cliquer sur Créer > Paiement.

#### Demande de remboursement

#### Saisie de paiement

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
**Remarque** : Ce montant ne doit pas être associé au Salaire car le montant sera alors imposable pour l'Employé.
::

Alternativement, une entrée de paiement peut être effectuée pour un employé et toutes les notes de frais en suspens seront extraites.

Comptabilité > Saisie de paiement > Nouvelle saisie de paiement

Définissez le type de paiement sur « Payer », le type de partie sur l'employé, la partie à l'employé payé et le compte à partir duquel le paiement est effectué. Toutes les demandes de remboursement en suspens seront extraites et les montants des paiements pourront être attribués à chaque dépense.

### 3.4 Lien avec la tâche et le projet

Pour lier une note de frais à une tâche ou un projet, spécifiez la tâche ou le projet lors de la création d'une note de frais.

Cela mettra à jour le coût du projet avec les montants des notes de frais


# Congés

## 1. Avantages du module congés

1. **Personnalisation des congés :**

Vous pouvez configurer chaque détail de la gestion des congés, que ce soit les types de congés, les périodes ou les contats spécifiques à différents groupes d'employés. Cela permet d'adapter la gestion des congés aux besoins exacts de l'entreprise.

2. **Gestion des jours fériés :**

Le module congés de Dokos permet de créer et gérer des listes de jours fériés annuels, avec la possibilité d'inclure des jours fériés locaux ou hebdomadaires. Cela simplifie la gestion des jours chômés et assure un calcul précis des congés.

3. **Attribution automatique des congés :**

Dokos automatise l'allocation des congés en fonction des contrats de travail, réduisant ainsi les tâches administratives et les risques d'erreurs. Les congés sont attribués automatiquement selon les règles définies et ajustés au fil de la période.

4. **Gestion des périodes de blocage :**

Avec Dokos, vous pouvez bloquer certaines périodes pour les congés, empêchant ainsi les employés de prendre des congés lors des moments critiques pour l'entreprise, tout en gardant une flexibilité pour les urgences grâce à un système d'approbation.

5. **Compatible avec notre application mobile :**

Le module de gestion des congés est entièrement compatible avec notre application mobile Dokos RH, permettant aux employés de soumettre facilement leurs demandes de congé et aux approbateurs de les traiter directement depuis leur smartphone.

## 2. fonctionnement

Le système de gestion des congés de Dokos fonctionne de la façon suivante:

1. Vous créez une liste de jours de fériés
2. Vous créez vos types de congés
3. Vous indiquez dans le contrat de travail de l'Employé, quels sont les types de congés auxquels il a droit
4. L'Employé peut effectuer des demandes de congés qui seront validées par un approbateur de notes de congés

::mermaid
```text
journey
    title Gestion des congés
    section Configuration
      Liste de jours fériés: 5: RH
      Types de congés: 5: RH
      Contrat de travail: 5: RH
    section Allocation de congés
        Allocation de congés: 5: RH
      Feuilles de présence: 5: Employé
      Calcul des congés: 5: Dokos
    section Demandes de congés
     Demandes de congés: 5: Employé
     Validation de congés: 5: RH
```
::

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
```text
Actuellement les seules règles de calcul applicables sont les congés payés sur jours ouvrés et les congés payés sur jours ouvrables.\:br
N'hésitez pas à ouvrir un ticket sur [Gitlab](https://gitlab.com/dokos/dokos/-/issues) pour que nous puissions ajouter d'autres règles de calcul spécifiques.
```
::


# Paramètres des congés

## 1. Liste de jours fériés

::tour{demo="Mappemonde" doctype="holiday-list"}
Créer une liste de jours fériés dans la démo
::

Cette fonctionnalité de gestion des jours fériés, permettant de gérer les jours chômés et fériés dans l'entreprise.

![Cette image permet de visualiser le formulaire pour définir les jours chômés.](https://doc.dokos.io/feries.png)

### 1.1. Remplir le formulaire

1. Nom de la liste de jours fériés : Permet de nommer la liste spécifique des jours fériés que vous configurez. (Exemple : 2024, 2025 etc)
2. Date de début : Indique la date à partir de laquelle la liste des jours fériés est active.
3. Date de fin : Indique la date de fin de la liste.
4. Remplace la liste de jours fériés : Permet de remplacer automatiquement une liste existante configurée au niveau de la société, des départements ou des employés par une nouvelle.

::callout
Cela vous permet de configurer une liste pour chaque année tout en assurant une transition fluide d'une liste à l'autre.
::

5. Ajouter des jours fériés hebdomadaires : Permet de définir des jours récurrents comme fériés chaque semaine (par exemple, tous les dimanches pour une entreprise travaillant en jours ouvrables ou tous les samedis et dimanches pour une entreprise travaillant en jours ouvrés).
6. Ajouter des jours fériés locaux : Permet d'ajouter des jours fériés spécifiques à un pays ou une région.

![Cette image permet de visualiser les subventions disponibles pour la France.](https://doc.dokos.io/subdivision.png)

**BL** : Saint-Barthélemy

**GES** : Grand Est (France métropolitaine)

**GP** : Guadeloupe

**GY** : Guyane française

**MF** : Saint-Martin

**MQ** : Martinique

**NC** : Nouvelle-Calédonie

**PF** : Polynésie française

**RE** : Réunion

**WF** : Wallis-et-Futuna

**YT** : Mayotte

7. Couleur : Permet de choisir une couleur pour identifier visuellement les jours féries.

## 2. Réglementation en France

1. Droit aux congés : Tout salarié ayant travaillé chez le même employeur pendant au moins un mois a droit à deux jours et demi de congés ouvrables par mois travaillé, soit un total de 30 jours ouvrables (équivalent à cinq semaines) pour une année complète de travail.
2. Calcul des congés : L'employeur peut choisir de calculer les congés en jours ouvrés (les jours où l'entreprise est ouverte) au lieu de jours ouvrables, à condition que cela ne réduise pas les droits du salarié par rapport au calcul en jours ouvrables.
3. Référence pour l'acquisition des congés : Les congés payés sont acquis en fonction du temps de travail effectif réalisé par le salarié durant une période de référence, qui va par défaut du 1er juin de l'année précédente au 31 mai de l'année en cours. Cependant, cette période peut être modifiée par des dispositions conventionnelles.
4. Congé principal : Le congé principal, c’est-à-dire le plus long congé annuel, ne peut être inférieur à 12 jours ouvrables consécutifs (ou 10 jours ouvrés). Ce congé doit généralement être pris entre le 1er mai et le 31 octobre, sauf indication contraire dans la convention collective. Il peut aussi être fractionné.
5. Congés supplémentaires : Dans certains cas, des jours de congés supplémentaires peuvent être accordés. Ces cas peuvent être prévus par des conventions collectives, des accords collectifs, des accords de branche, des accords d'entreprise ou d'établissement, ou par le contrat de travail.

## 3. Types de congés

::tour{demo="Mappemonde" doctype="leave-type"}
Créer un type de congés dans la démo
::

Le type de congé fait référence aux types de congés alloués à un employé qu'il peut utiliser lors de la demande de congé. Vous pouvez créer autant de types de congés que vous le souhaitez en fonction des besoins de votre entreprise.

![Cette image permet de visualiser le module type de congés.](https://doc.dokos.io/type-de-conge.png)

Une liste par défaut est disponible, vous pouvez modifier les types de congé ou en créer de nouveau.

3.1. Remplir le formulaire

![Cette image permet de visualiser le formulaire type de congés.](https://doc.dokos.io/calcul-des-conges.png)

3.1.1. Détails

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Lorsque le nombre '0' est indiqué, cela signifie qu'aucune valeur n'est définie.
::

- Nom du type de congé : Ce champ permet de nommer le congé, par exemple "Congé payé" ou "Congé sans solde".
- Allocation de congés maximum autorisée : Ce paramètre définit le nombre maximal de jours de congé qu'un employé peut accumuler pour ce type de congé. (30 jours pour les entreprise travaillant en jours ouvrables ou 25 jour pour les entreprise travaillant en jour ouvrés
- Applicable après (jours ouvrés) : Spécifie le nombre de jours ouvrés après lesquels un employé peut prétendre à ce congé. Par exemple, un congé pourrait être disponible après six mois de service.
- Nombre maximum de congés consécutifs autorisés : Limite le nombre de jours de congé consécutifs qu'un employé peut prendre pour ce type de congé.
- Est un congé sans solde : Ce type de congé ne sera pas rémunéré. (Exemple : l'arrêt maladie, car la sécurité sociale prend le relais)
- Est un congé facultatif : Ce congé est offert par l'entreprise mais n'est pas obligatoire pour l'employé.
  &#x2A;Les congés facultatifs sont des jours fériés que les employés peuvent choisir de prendre parmi une liste de jours fériés proposée par l'entreprise. Contrairement aux jours fériés obligatoires, ces jours ne sont pas automatiquement chômés pour tous les employés. L'entreprise peut offrir une certaine flexibilité en permettant aux employés de sélectionner les jours qu'ils souhaitent prendre en congé parmi cette liste. Toutefois, l'entreprise peut limiter le nombre de ces jours facultatifs en définissant un nombre maximal de jours de congé autorisés pour ce type de congé.*
- Autoriser un solde négatif : Permet à l'employé de prendre plus de jours que ceux acquis, avec un solde négatif temporaire.
- Autoriser les sur-allocations : Autorise la distribution de jours supplémentaires même si cela dépasse la limite fixée.
- Inclure les jours fériés dans les congés en tant que congés : Les jours fériés seront comptabilisés dans les jours de congé.
- Est compensatoire : Le congé est en compensation d'heures supplémentaires ou d'autres formes de travail additionnel.
- Calculer en jours ouvrables : Si coché la demande de congé associée sera calculée en jours ouvrés

3.1.2. Calcul des congés

![Cette image permet de visualiser la partie calcul des congés.](https://doc.dokos.io/calcul-des-conges.png)

- Est un congé acquis : Cette case indique si le congé est acquis progressivement par l'employé, en fonction du temps de travail.
- Fréquence d'acquisition des congés : Permet de définir comment et quand les congés sont acquis, par exemple "Congés payés sur jours ouvrés".
- Allouer le : Spécifie à quel moment du mois les congés sont alloués, comme le "Dernier jour" du mois.

## 4. Attribution des congés

Pour simplifier l'attribution des congés, Dokos vous permet de les attribuer directement dans le contrat de travail.

Avec cette méthode, les congés sont automatiquement alloués chaque jour selon les règles définies pour chaque type de congé.

::callout
---
icon: i-heroicons-light-bulb
target: _blank
to: https://doc.dokos.io/dokos/hrms/conges/allocation-conges
---
Pour configurer ce mode d'attribution, rendez-vous sur la page "Allocation de congé" de notre documentation.
::

Au préalable, vous aurez défini les types de congés ainsi que le calcul des congés payés afin de déterminer une fréquence d'attribution et une période.

### 4.1. Paramètres RH

::tour{demo="Mappemonde" doctype="hr-settings"}
Voir les paramètres RH dans la démo
::

Pour que l'allocation des congés se base sur la configuration des contrats de travail, cochez l'option « Allouer les congés depuis les contrats » dans les paramètres RH. Sinon, vous pouvez utiliser le système de Politique de congés.

![Cette image permet de visualiser les paramètres RH.](https://doc.dokos.io/parametres-rh.png)

L'allocation des congés acquis s'effectue au début de la période, avec un nombre initial de congés alloués fixé à 0. Au fil de la période, cette allocation est ajustée et le total des congés attribués est augmenté en fonction du nombre de jours calculés par le système selon les règles définies pour chaque type de congé.

Pour les congés payés, il est nécessaire de créer des feuilles de présence pour chaque employé afin que le système puisse calculer correctement le nombre de jours de congé à allouer.

Vous pouvez également cocher l'option « Calculer les présences » dans les paramètres RH pour que le système effectue ce calcul automatiquement si les présences ne sont pas saisies manuellement.

## 5. Liste de blocage des congés

::tour{demo="Mappemonde" doctype="leave-block-list"}
Créer une liste de blocage dans la démo
::

La liste de blocage des congés est une liste de dates dans une année, auxquelles les employés ne peuvent pas demander de congé.

![Cette image permet de visualiser le formulaire des listes de blocages.](https://doc.dokos.io/Blocage1.png)

Vous pouvez définir des utilisateurs pour approuver les demandes de congé pour les jours bloqués dans le tableau **Liste de blocage de congé autorisée**. permettant aux employés de saisir une demande sur la période bloquée en cas d'urgence.

---

::callout{color="Red" icon="i-heroicons-exclamation-triangle"}
Les éléments suivants ne sont pas utiles si vous utilisez l'option **Allouer les congés depuis les contrats**
::

## 6. Période de congé

::tour{demo="Mappemonde" doctype="leave-period"}
Créer une période de congé dans la démo
::

Une période de congés permet de définir les dates de début et de fin pour le calcul des congés d'un type de congés donné.

![Cette image permet de visualiser le formulaire : Période de congés.](https://doc.dokos.io/periode-de-conges.png)

## 7. Politique de congés

::tour{demo="Mappemonde" doctype="leave-policy"}
Créer une politiqu de congé dans la démo
::

Une politique de congés défini les règles applicables à une catégorie d'employés.

![Cette image permet de visualiser le formulaire : Politique de congés](https://doc.dokos.io/politiquedeconges.png)

La politique de congés peut être affectée à chaque employé directement ou à un échelon.

Si vous l'affectez à un échelon, n'oubliez d'affecter cet échelon à tous les employés concernés.

::mermaid
```text
graph LR;
PC(Politique de Congés) --> APC(Attribution de Politique de Congés) --> AC(Attribution de Congés);
APC:::current-doc;
```
::


# Congés accumulés à encaisser

L'encaissement des congés fait référence à une somme d'argent reçue en échange de congés non utilisés par un employé. Vous pouvez soumettre un encaissement de congé pour les types de congé qui sont encaissables.

Pour accéder à la **liste encaissement des congés**, allez sur :

> Accueil > Ressources humaines > Congés > **Encaissement des congés**

![liste\_congés\_accumulés\_.png](https://doc.dokos.io/content/rh/leave-encashment/liste_conges_accumules_.png)

## 1. Prérequis avant utilisation

Avant de créer l'encaissement des congés, il est conseillé de créer les documents suivants :

- Employé
- Type de congé
- Politique de congé
- Période de congé
- Structure salariale
- Affectation de la structure salariale

## 2. Comment créer un encaissement de congés

1. Allez dans la **liste congés accumulés à encaisser*&#x2A;, cliquez sur **➕ Ajouter Congés accumulés à encaisser**.
2. Sélectionnez Période de congé.
3. Sélectionnez l'employé. Une fois l'employé sélectionné, le service de l'employé est automatiquement récupéré.
4. Sélectionnez le type de congé pour lequel le congé est encaissé. Assurez-vous que le type de congé est encaissable (la case « Autoriser l'encaissement » dans le type de congé est cochée).
5. Sélectionnez Date d'encaissement. En fonction de la date sélectionnée, le montant sera encaissé dans cette écriture de paie particulière.
6. Enregistrer et envoyer.

![détails\_congés\_accumulés.png](https://doc.dokos.io/content/rh/leave-encashment/details_conges_accumules.png)

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
**Remarque** : Lorsque vous sélectionnez l'employé et le type de congé, le solde des congés et les jours encaissables (qui est le solde total des congés moins le seuil de jours défini dans le type de congé) s'afficheront avec le montant de l'encaissement basé sur l'encaissement des congés par jour tel que configuré dans Structure salariale attribuée.
::

Lors de la soumission d'un encaissement de congé pour un employé, Dokos crée automatiquement un salaire supplémentaire qui sera ajouté au bulletin de salaire de l'employé lors du traitement de la paie.

![paie\_congés.png](https://doc.dokos.io/content/rh/leave-encashment/paie_conges.png)


# Allocation de congé

## 1. Attribution des congés

### 1.1. Contrat de travail

Pour simplifier l'attribution des congés, Dokos vous permet de les attribuer directement dans le contrat de travail.

Avec cette méthode, les congés sont automatiquement alloués chaque jour selon les règles définies pour chaque type de congé.

Au préalable, vous aurez défini les types de congés ainsi que le calcul des congés payés afin de déterminer une fréquence d'attribution et une période.

1. Rendez-vous dans le type de contrat de travail pour créer un type de contrat de travail.

![Cette image permet de visualiser le type de contrat de travail.](https://doc.dokos.io/type-de-contrat.png)

2. Définissez les types de congés à attribuer au contrat de travail.

![Cette image permet de visualiser les types de congés attribués dans le contrat de travail.](https://doc.dokos.io/conges-type-de-contrat.png)

3. Dans la fiche employé, rendez-vous sur le contrat de travail.

![Cette image permet de visualiser la zone du type de contrat dans la fiche employé.](https://doc.dokos.io/contrat-de-travail.png)

4. Créez un nouveau contrat de travail. Une fois le type de contrat renseigné, les congés sont automatiquement ajoutés dans l'onglet congés.

![Cette image permet de visualiser un nouveau contrat pour l'employé.](https://doc.dokos.io/new-contrat.png)![Cette image permet de visualiser les congés attribué à l'employé.](https://doc.dokos.io/conges-attribue-a-l-employe.png)

Pour que le calcul soit effectué immédiatement, cliquez sur « Mettre à jour les congés ». Sinon, l'allocation sera effectuée à la date spécifiée pour chaque type de congé.

Pour que l'allocation des congés se base sur la configuration des contrats de travail, cochez l'option « Allouer les congés depuis les contrats » dans les paramètres RH. Sinon, vous pouvez utiliser le système de Politique de congés.

![Cette image permet de visualiser les paramètres RH.](https://doc.dokos.io/parametres-rh.png)

L'allocation des congés acquis s'effectue au début de la période, avec un nombre initial de congés alloués fixé à 0. Au fil de la période, cette allocation est ajustée et le total des congés attribués est augmenté en fonction du nombre de jours calculés par le système selon les règles définies pour chaque type de congé.

Pour les congés payés, il est nécessaire de créer des feuilles de présence pour chaque employé afin que le système puisse calculer correctement le nombre de jours de congé à allouer.

Vous pouvez également cocher l'option « Calculer les présences » dans les paramètres RH pour que le système effectue ce calcul automatiquement si les présences ne sont pas saisies manuellement.

## 2. Calcul des congés acquis pour la France

Pour les entreprises françaises, Dokos applique un calcul des congés acquis conforme au Code du travail français. Ce calcul est activé automatiquement lorsque la société est configurée avec la France comme pays.

### 2.1. Principe de la période de référence

En France, les congés payés sont acquis sur une **période de référence** qui s'étend par défaut du **1er juin de l'année précédente au 31 mai de l'année en cours**. Cette période peut être modifiée par convention collective.

Le système Dokos prend en compte cette période pour :

- calculer le nombre de jours acquis par mois travaillé ;
- s'assurer que les droits ne dépassent pas le plafond légal (30 jours ouvrables ou 25 jours ouvrés pour une année complète) ;
- gérer correctement les cas d'entrée et de sortie en cours de période.

### 2.2. Modes de calcul disponibles

| Mode            | Description                                         | Plafond annuel |
| --------------- | --------------------------------------------------- | -------------- |
| Jours ouvrables | Tous les jours sauf dimanche et jours fériés        | 30 jours       |
| Jours ouvrés    | Jours travaillés dans l'entreprise (lundi–vendredi) | 25 jours       |

Le mode est défini au niveau du type de congé. L'employeur peut opter pour le calcul en jours ouvrés à condition que cela ne réduise pas les droits du salarié par rapport au calcul légal en jours ouvrables.

### 2.3. Acquisition mensuelle

Chaque mois de travail effectif ouvre droit à **2,5 jours ouvrables** (ou l'équivalent en jours ouvrés selon le mode choisi). L'allocation dans Dokos est mise à jour automatiquement en fin de mois selon les présences enregistrées.

**Exemple :**

> Sophie, salariée de Maison Verte SARL depuis le 1er septembre, a travaillé tous les mois jusqu'au 31 mai. Dokos calcule automatiquement son droit à 9 mois × 2,5 = 22,5 jours ouvrables, soit 22 jours ouvrables (arrondi à l'entier inférieur selon les règles légales applicables).

### 2.4. Prise en compte des présences

Pour que le calcul des congés acquis soit correct en France, les **feuilles de présence** doivent être renseignées pour chaque employé. Sans présences enregistrées, le système ne peut pas déterminer le nombre de mois de travail effectif.

Si les présences ne sont pas saisies manuellement, activez l'option **Calculer les présences** dans les paramètres RH pour que le système les génère automatiquement.

::callout{color="blue" icon="i-heroicons-information-circle"}
Le calcul régional France est appliqué automatiquement lors de l'allocation des congés acquis. Aucune configuration supplémentaire n'est requise au-delà du paramétrage du pays sur la fiche société.
::


# Demande de congé

Dokos permet à vos employés de demander des congés via les demandes de congé et de les faire approuver par les approbateurs de congé.

> Accueil > Ressources humaines > Congés > **Demande de congé**

::tour{demo="Mappemonde" doctype="leave-application"}
Créer une demande de congé dans la démo
::

## 1. **Prérequis**

- Avant de créer une demande, un contrat de travail incluant l'attribution des congés doit être défini si ce mode est sélectionné.
- Un approbateur doit être défini, soit au niveau du département, soit pour chaque employé.

## 2. Comment créer une demande de congés

![Cette image permet de visualiser le formulaire de demande de congés.](https://doc.dokos.io/demande-conges.png)

Un tableau des congés alloués et disponibles sera affiché selon les congés pris. Ensuite, l'employé peut définir les dates et soumettre sa demande.

1. Sélectionnez le nom de l'employé
2. le type de congé.
3. Définissez la durée du congé en indiquant la date de début et la date de fin. En fonction des dates sélectionnées, les champs "Nombre total de jours de congé demandés" et "Solde de congé avant la demande" s'afficheront.
4. Si le congé appliqué est d'une demi-journée, cochez la case **demi-journée**.
5. Sélectionnez la date de comptabilisation de la demande de congé. Vous pouvez la modifier si elle est différente du jour de la saisie de la demande.
6. Cochez la case « Suivre par e-mail » pour envoyer une notification de la demande de congé à l'approbateur des congés.
7. Une fois que l'employé enregistre la demande de congé, le statut de la demande de congé passe à "Ouvert" et un e-mail est envoyé à l'approbateur des congés pour approbation.

::callout
Le modèle de notification d'approbation de congé peut être configuré dans les paramètres RH sous la section Paramètres de congés.
::

8. À réception de l'e-mail de notification, l'approbateur des congés peut soit approuver, rejeter, ou annuler la demande. Une fois sa décision prise, il procède à la soumission de la demande de congé. Suite à cette soumission, le statut du document est automatiquement mis à jour en fonction de l'action effectuée, et une notification par e-mail est envoyée à l'employé concerné.

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
**Remarque** : La demande de congé ne peut pas être soumise si le salaire est déjà traité pour la période de congé.
::

## 3. Flux de la demande de congés.

Le flux du processus de demande de congé est résumé ci-dessous :

- L'employé demande un congé via Demande de congé.
- L'approbateur reçoit une notification par e-mail. Pour cela, la case à **Suivre par e-mail** doit être cochée.
- L'approbateur examine la demande de congé.
- L'approbateur approuve/rejette/annule la demande de congé
- L'employé reçoit la notification sur l'état de sa demande de congé

::mermaid
graph TD
A\[Employé demande un congé via Demande de congés] --> B\[Approbateur reçoit une notification par e-mail]
B --> C\[Approbateur examine la demande]
C --> D\[Approbateur approuve, rejette ou annule la demande]
D --> E\[Employé reçoit une notification pour lui annoncer la décision]

::

## 4. Flux de travail

::tour{demo="Mappemonde" doctype="workflow"}
Créer un flux de travail dans la démo
::

La création d'un flux de travail permet de définir et de personnaliser les étapes nécessaires à l'approbation ou au rejet d'un document. Ce flux de travail remplace le flux par défaut de Dokos.

Pour plus d'informations, rendez-vous sur la page [**Flux de travail**](https://doc.dokos.io/v5/dokos/parametrage/demarrage/workflows).

![Cette image permet de visualiser le formulaire flux de travail pour demande de congés.](https://doc.dokos.io/fluxdetravail25.png)

## 5. Caractéristiques

### 5.1 Configuration de l'approbateur de congé

Un approbateur de congé est un utilisateur chargé d'approuver les demandes de congé d'un employé. Il peut être configuré à deux niveaux : département et employé. Au niveau du département, plusieurs approbateurs peuvent être définis, avec un approbateur par défaut. Si un approbateur est aussi défini au niveau de l'employé, celui-ci prend la priorité. Si l'approbateur sélectionné n'a pas accès à la demande, elle peut lui être partagée avec l'autorisation "soumettre". Il est également possible de paramétrer les employés pour qu'ils gèrent leurs propres demandes.

### 5.2 Saisie rapide depuis la vue calendrier

La vue calendrier du module Congés offre une méthode de saisie rapide pour créer une demande de congé sans quitter le calendrier.

**Comment l'utiliser :**

1. Ouvrez la liste des demandes de congé et basculez en **vue calendrier** (icône calendrier en haut à droite).
2. Sélectionnez une plage de dates directement sur le calendrier en cliquant-glissant sur les jours souhaités.
3. Un dialogue de saisie rapide s'ouvre automatiquement avec les dates de début et de fin pré-remplies.

**Champs disponibles dans le dialogue :**

| Champ                       | Description                                                       |
| --------------------------- | ----------------------------------------------------------------- |
| Employé                     | Identifiant de l'employé concerné                                 |
| Type de congé               | Filtré automatiquement selon l'employé et les dates sélectionnées |
| Date de début / Date de fin | Pré-remplies depuis la sélection calendrier                       |
| Nombre de jours             | Calculé automatiquement (lecture seule)                           |
| Raison                      | Motif de la demande                                               |
| Approbateur de congé        | Synchronisé automatiquement ; obligatoire avant l'enregistrement  |

**Résumé des métriques affiché dans le dialogue :**

Dès que l'employé, le type de congé et les dates sont renseignés, le dialogue affiche un résumé en trois indicateurs :

- **Jours alloués** — quota total attribué pour ce type de congé
- **Jours utilisés** — jours déjà consommés sur la période
- **Jours restants** — solde disponible après la demande en cours

Ces indicateurs se mettent à jour dynamiquement à chaque modification des champs.

**Comportement et validations :**

- La liste des types de congé est filtrée côté serveur selon l'employé et la date effective ; les types non applicables n'apparaissent pas.
- L'approbateur de congé est synchronisé automatiquement selon les règles habituelles (département puis employé). L'enregistrement est bloqué tant qu'aucun approbateur n'est défini.
- Le dialogue est disponible uniquement en **vue mensuelle** ; les vues semaine et jour ne permettent pas la saisie rapide.
- Le bouton **Ouvrir le formulaire complet** permet d'accéder au formulaire détaillé de la demande tout en conservant les données saisies dans le dialogue.

**Exemple :**

> Camille, employée chez Maison Verte SARL, souhaite poser trois jours de congés payés la semaine prochaine. Elle ouvre le calendrier des congés, sélectionne les trois jours concernés, choisit le type « Congés payés » dans le dialogue qui s'ouvre, vérifie qu'il lui reste 12 jours disponibles dans le résumé, puis clique sur **Enregistrer**. La demande est créée et l'approbateur reçoit automatiquement une notification.

::mermaid
sequenceDiagram
participant E as Employé
participant C as Calendrier
participant D as Dialogue rapide
participant S as Serveur
E->>C: Sélectionne une plage de dates
C->>D: Ouvre le dialogue (dates pré-remplies)
E->>D: Choisit le type de congé
D->>S: Filtre les types disponibles (employé + date)
S-->>D: Liste des types applicables
D->>S: Récupère les métriques (alloués / utilisés / restants)
S-->>D: Résumé affiché
D->>S: Synchronise l'approbateur
S-->>D: Approbateur défini
E->>D: Clique sur Enregistrer
D->>S: Crée la demande de congé
S-->>E: Notification envoyée à l'approbateur

::

### 5.3 Spécificités pour la France

Pour les entreprises soumises au droit du travail français, Dokos applique des règles de calcul adaptées lors de la création d'une demande de congé.

**Calcul des jours en droit français :**

Lorsque le type de congé est configuré pour utiliser le calcul français (congés payés légaux), le nombre de jours décomptés tient compte :

- du mode de calcul choisi : **jours ouvrables** (tous les jours sauf dimanche et jours fériés) ou **jours ouvrés** (jours travaillés dans l'entreprise, généralement du lundi au vendredi) ;
- des jours fériés tombant dans la période de congé, selon les règles légales en vigueur.

Ce calcul est effectué automatiquement par le système dès que les dates de début et de fin sont renseignées dans le formulaire ou dans le dialogue de saisie rapide.

**Exemple :**

> Thomas, salarié de Bureau Moderne, pose une semaine de congés payés du lundi 28 avril au vendredi 2 mai. Le 1er mai étant férié, le système décompte 4 jours ouvrés au lieu de 5, conformément à la législation française.

::callout{color="blue" icon="i-heroicons-information-circle"}
La logique de calcul régionale pour la France est activée automatiquement lorsque la société est configurée avec la France comme pays. Aucune action supplémentaire n'est requise de la part de l'utilisateur.
::

## 6. Application mobile

L'application mobile permet aux employés de soumettre leurs demandes de congé et aux approbateurs de les gérer facilement.

Pour plus d'informations, consultez la page dédiée à[**l'application mobile RH**](https://doc.dokos.io/v5/dokos/hrms/application-mobile-rh)


# Demande de congé compensatoire

Dokos permet aux employés de demander des congés compensatoires via le document Demande de congé compensatoire. Il est nécessaire que les dates mentionnées dans la demande de congé compensatoire soient dans la liste des jours fériés par défaut et également que l'employé ait sa présence marquée Présent.

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
**Remarque** : Seuls les types de congé marqués comme **Est compensatoire** peuvent être sélectionnés dans la demande de congé compensatoire.
::

::tour{demo="Mappemonde" doctype="compensatory-leave-request"}
Créer un congé compensatoire dans la démo
::

Accueil > Ressources humaines > Congés > **Demande de congé compensatoire**

![Cette image permet de visualiser le formulaire des congés compensatoires.](https://doc.dokos.io/compensatoire.png)

## 1. Prérequis avant utilisation

Avant de créer une demande de congé compensatoire, il est nécessaire de créer les documents suivants :

- [Employé](https://doc.dokos.io/v5/dokos/hrms/cycle-de-vie/employee)

## 2. Caractéristiques

### 2.1 Travail en vacances

- Sélectionnez la **date de début de travail** et la **date de fin de travail**. Il s'agit de la date du ou des jours où l'employé a travaillé, pendant un jour férié.
- Cochez la case **Demi-journée** s'il s'agit d'un demi-jour de congé
- Entrez la **raison** de la demande de congé compensatoire.

![travail\_en\_vacances.png](https://doc.dokos.io/content/rh/compensatory-leave-request/travail_en_vacances.png)

Lors de la soumission de la demande de congé compensatoire, Dokos met à jour l'enregistrement d'allocation de congé pour le type de congé compensatoire, permettant à l'employé de demander des congés de ce type ultérieurement en fonction du nombre de congés restants.


# Période de congés

Une période de congés permet de définir les dates de début et de fin pour le calcul des congés d'un type de congés donné.

::callout{color="teal" icon="i-heroicons-light-bulb"}
La création d'une période de congés n'est pas utile si vous utilisez l'option **Allouer les congés depuis les contrats**
::

---

Pour accéder à la liste de période de congé, allez sur :

> Accueil > Ressources humaines > Congés > **Période de congé**

![liste\_période\_de\_congé.png](https://doc.dokos.io/content/rh/leave-period/liste_periode_de_conge.png)

## 1. Prérequis avant utilisation

Avant de créer une Période de Congé, il est conseillé de créer les éléments suivants :

- **Compagnie**
- **Liste des jours fériés**

## 2. Comment créer une période de congé

1. Allez dans la liste Période de congé, cliquez sur Nouveau.
2. Saisissez la date de début et la date de fin de la période de congé.
3. Sélectionnez le nom de l'entreprise pour laquelle la période de congé s'applique.
4. Enregistrer.

![créer\_péridoe\_de\_congé.png](https://doc.dokos.io/content/rh/leave-period/creer_peridoe_de_conge.png)

La période de congé vous permet également de sélectionner une liste de jours fériés pour les congés facultatifs (facultatif) qui sera prise en compte pour l'attribution des congés facultatifs pour la période.

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
**Remarque** : La « Liste des jours fériés pour les congés facultatifs » n'est pas la même que la « Liste des jours fériés » habituelle. Cette liste contiendra uniquement une liste de jours fériés facultatifs. La « Liste des jours fériés pour les congés facultatifs » peut être créée à partir du document Liste des jours fériés . Vous pouvez créer deux listes de jours fériés pour une période de congé ; l'un contenant les congés habituels et l'autre les congés facultatifs.
::

De plus, vous pouvez cocher la case « Est actif » si vous souhaitez activer cette période de congé particulière.

## 3. Accorder un congé en utilisant la période de congé

Dans la version 12, les congés pouvaient être accordés via la période de congé via le bouton « Accorder des congés ». Dans la version 13, les congés seront accordés à l'aide de Leave Policy Assignment .

Une fois les informations enregistrées, la Période de congé sera également utilisée comme un outil pour vous aider à accorder des congés à une catégorie d'employés.

Le bouton Accorder générera des allocations de congé en fonction de la politique de congé applicable à chaque employé. Vous pouvez attribuer des congés en fonction du grade de l'employé , du service ou de la désignation, comme indiqué ci-dessous.


# Gérer des ressources réservables

::callout{color="amber"}
Dans la version 4 de Dokos cohabitent encore deux modules complémentaires:

- Le module Lieu: module historique contenant la gestion des réservations d'articles, la gestion de crédits, les inscriptions aux événements et les postes d'événements
- Le module Bookings (Réservations): module complémentaire qui peut être installé sur un site Dokos. Celui-ci amène la gestion des contrats, un nouveau portail client, la notion de ressources réservables, etc...

A partir de la version 5 de Dokos, le module **Lieu** sera retiré de Dokos et toutes ses fonctionnalités intégrées au module Bookings. :br
Ce nouveau module est publié sous licence AGPLv3 et devra simplement être installé sur votre site Dokos pour garantir une continuité de service lors du passage à la v5.
::

## Contexte

Développé depuis 2018 en partenariat avec les tiers-lieux sous l'impulsion de [La Compagnie des Tiers Lieux](https://compagnie.tiers-lieux.org/){rel="&#x22;nofollow&#x22;"}, le module **Lieu** a évolué de la simple réservation de salles à un système de gestion complet adapté aux structures louant des ressources.

Certains termes, comme la notion de **Réservation d'articles** sont hérités de la modélisation historique, visant à simplifier la facturation. :br
Avec l'évolution du logiciel, la notion de **Ressource réservable** devient de plus en plus centrale et la sémantique des différentes fonctionnalités est amenée à évoluer progressivement jusqu'à la sortie de la version 5 de Dokos. Cette version marquera la fin du processus d'unification des deux modules et devrait faciliter la maintenance et l'évolution du logiciel. :br
Dans cette documentation nous ferons parfois encore référence de manière interchangeable à un **article** ou une **ressource réservable**.

## Principales fonctionnalités

::card-group
  :::card
  ---
  title: Abonnements
  to: https://doc.dokos.io/v5/dokos/ventes/abonnements
  ---
  Créez des abonnements et collectez les paiements automatiquement
  :::

  :::card
  ---
  title: Réservations
  to: https://doc.dokos.io/v5/dokos/lieu/reservations-articles
  ---
  Permettez à vos visiteurs de réserver des salles ou des machines
  :::

  :::card{title="Événements" to="https://doc.dokos.io/v5/dokos/lieu/evenements"}
  Gérez vos événements, avec des inscriptions en ligne et une billeterie
  :::

  :::card
  ---
  title: Site web
  to: https://doc.dokos.io/v5/dokos/e-commerce/portal-settings
  ---
  Créez un site web pour présenter votre lieu et permettre les réservations et inscriptions en ligne
  :::

  :::card{title="Portail client" to="https://doc.dokos.io/v5/dokos/lieu/portails"}
  Permettez à vos visiteurs de s'inscrire en ligne via un formulaire et de gérer leurs abonnements
  :::

  :::card
  ---
  title: Multi-lieux
  to: https://doc.dokos.io/v5/dokos/lieu/multi-societe
  ---
  Gérez plusieurs lieux dans un seul Doks, et présentez les sur votre site web
  :::
::

## Installation

A partir de la version 4 de Dokos, il faut installer le module [**Bookings**](https://gitlab.com/dokos/bookings/){rel="&#x22;nofollow&#x22;"} sur votre site Dokos pour avoir accès à toutes les fonctionnalités décrites ici.

::tabs
  :::tabs-item{label="Vous êtes client Dokos Cloud ?"}
  Rendez-vous dans votre [espace client](https://cloud.dokos.io){rel=""nofollow""} et choisissez **Bookings** dans la section **Installer des applications** de votre site.
  :::

  :::tabs-item{label="Vous êtes auto-hébergé·es ?"}
  Suivez nos [tutoriels d'installation](https://doc.dokos.io/v5/dodock/installation) pour installer les applications nécessaires pour faire fonctionner Bookings:

  - **Dodock (Frappe)**: le framework applicatif
  - **Payments**: le module de paiement, obligatoire pour installer Dokos
  - **Dokos (ERPNext)**: l'application de gestion
  - **Webshop**: le module permettant de faire fonctionner le panier de Bookings

  Une fois ces applications installées, installez Bookings comme n'importe quelle autre application:

  ```bash
  bench get-app bookings --branch v4
  bench --site {mon_site} install-app bookings
  ```

  Vous pouvez également installer des applications complémentaires selon vos besoins:

  - **Frappe Builder:** pour créer un site web sans code, comme sur la démo
  - **Frappe Insights**: pour générer des rapports et des tableaux de bord
  - **HRMS**: pour gérer vos ressources humaines
  :::
::


# Pré-requis

Le module de réservation de ressources de Dokos dispose de fonctionnalités qui peuvent être activées/désactivées ou qui dépendent d'options sélectionnées dans deux documents de paramétrage:

- Les **Paramètres du lieu**
- Les **Paramètres de réservation de ressources**

Ces deux documents sont accessibles dans l'espace de travail Evènements & Ressources

---

::tabs
  :::tabs-item{label="Paramètres du lieu"}
    ::::tour{demo="Mappemonde" doctype="Venue Settings"}
    Voir les paramètres du lieu dans la démo
    ::::

  ### Réservation d'articles

  ![Cette image permet de visualiser les paramètres du lieu.](https://doc.dokos.io/parametres-du-lieu.png)

  **Supprimer les brouillons après x minutes :**

  - **Cette option s'applique aux réservations effectuées sur le site web.** Lorsqu'un utilisateur crée un panier en ligne, sa réservation bloque le créneau sélectionné pendant X minutes. Avec cette option, vous pouvez définir le nombre de minutes après lesquelles la réservation est annulée si l'utilisateur ne valide pas son panier. Cela permet d'éviter de bloquer des créneaux inutilement lorsque l'utilisateur abandonne son panier. Vous pouvez définir la valeur à 0 pour désactiver cette fonctionnalité.

  **Confirmer la réservation après le paiement :**

  - Si cette case est cochée, la réservation est confirmée uniquement après le paiement. Sinon, la réservation est considérée comme confirmée dès que la commande est passée.

  **Autoriser les réservations d'article simultanées :**

  - **Cette option s'applique aux réservations effectuées sur le site web.** Elle permet d'autoriser les réservations simultanées d'un même article pour un même créneau horaire. En activant cette option, vous pouvez spécifier, pour chaque article dans sa fiche, le nombre de réservations simultanées autorisées.

  **Interdire les réservations multiples pour le même article sur le bureau :**

  - **Cette option s'applique aux réservations effectuées depuis le bureau**. Elle permet d'afficher un message d'erreur si vous tentez de créer une réservation pour un créneau où le nombre maximum de réservations simultanées est déjà atteint.

  > Par exemple, si vous essayez de réserver la salle Marco Polo de 9h à 10h alors qu'il y a déjà une réservation sur ce créneau, Dokos vous laissera normalement enregistrer cette réservation car vous êtes le gestionnaire du lieu. Cependant, en activant cette option, Dokos affichera une erreur et empêchera la création de cette seconde réservation.

  **Synchroniser automatiquement avec Google Agenda :**

  - La synchronisation des réservations d'articles avec Google Agenda est facultative. En cochant cette case, le système synchronisera automatiquement toutes les réservations d'articles avec Google Agenda. Notez que cette fonctionnalité ne fonctionne que si vous avez connecté votre système à Google Agenda et créé un agenda spécifique pour chaque article réservable.

  **Autoriser l'annulation des réservations d'article via le portail :**

  - **Cette option s'applique aux réservations effectuées sur le site web.** En l'activant, vous permettez à vos utilisateurs d'annuler leurs réservations directement depuis leur portail. Une fois cette option activée, vous pourrez spécifier une période minimale pendant laquelle les annulations ne seront pas autorisées.

  **Rôle autorisé à réserver sans passer par le panier :**

  - Les utilisateurs avec ce rôle spécifique peuvent faire des réservations d'articles sans valider un panier et créer une commande.

  ### Mode multi-lieux

  - Par défaut, Dokos associe tous les paniers créés sur le site web à la société par défaut définie dans les paramètres de E-commerce.

  En activant le mode multi-lieux, vous permettez la création de paniers associés à différentes sociétés en fonction des articles sélectionnés.

  > [Voir la documentation du mode multi-lieux](https://doc.dokos.io/v5/dokos/lieu/multi-societe)

  **Sociétés autorisées :**

  - Ajoutez dans ce tableau toutes les sociétés autorisées à facturer sur le site E-Commerce et le portail utilisateur. Pour chaque société, vous pouvez sélectionner une liste de prix, un groupe de clients par défaut, et une série de devis à utiliser par défaut.

  ## Unités de mesure

  ![Cette image permet de visualiser les unités de mesure dans les paramètres du lieu.](https://doc.dokos.io/parametre-lieu-UDM.png)

  Les unités de mesure dans Dokos sont des configurations essentielles qui permettent de définir comment le temps et les unités physiques sont mesurés et calculés pour les réservations et la gestion des ressources.

  > Il est essentiel de définir le nombre d'heures correspondant à une demi-journée si vous envisagez d'utiliser cette unité de mesure.

    ::::callout
    ---
    icon: i-heroicons-light-bulb
    target: _blank
    to: https://doc.dokos.io/dokos/stocks/uom
    ---
    Pour plus d'information rendez-vous sur la page [**Unité de mesure**](https://doc.dokos.io/v5/dokos/stocks/uom) de notre documentation.
    ::::
  :::

  :::tabs-item{label="Paramètres de réservation de ressources"}
  ## Contrats

  Sélectionnez un modèle de notification de contrats personnalisé qui sera utilisé pour demander au client de signer son contrat en ligne.

  Voici le message standard envoyé à vos clients: :br**Sujet**: `Votre contrat est prêt à être signé`:br**Corps du mail**:

  ```html
  <p>
  Bonjour {{ first_name }} {{ last_name }},
  </p>
  {% set site_link = '<a href="' + site_url + '">' + site_url + '</a>' %}
  <p>Votre contrat est prêt à être signé à l'adresse {{ site_link }}.</p>

  {% if user_is_new %}
  <p>Un nouveau compte a été créé pour vous automatiquement.</p>
  <p>Votre id de connexion est : <b>{{ user }}</b>
  <p>Cliquez sur le lien ci-dessous pour compléter votre inscription et définir un nouveau mot de passe.</p>
  {% endif %}

  <p style="margin: 15px 0px;">
      <a href="{{ link }}" rel="nofollow" class="btn btn-primary">
          {% if user_is_new %}
          Terminer l'inscription
          {% else %}
          Signer votre contrat
          {% endif %}
      </a>
  </p>

  {% if created_by != "Administrator" %}
  <br>
  <p style="margin-top: 15px">
      Merci,<br>
      {{ created_by }}
  </p>
  {% endif %}
  <br>
  <p>
      Vous pouvez aussi copier-coller le lien suivant dans votre navigateur :
      <br>
      <a href="{{ link }}">{{ link }}</a>
  </p>
  ```

  ## Portail client

  **Utiliser le nouveau portail client**: En cochant cette case, vous mettez en place les redirections suivantes sur votre site:

  - */me* -> */bookings-ui/account*
  - */order* -> */bookings-ui/orders*
  - *Page d'article du site web* -> */bookings-ui/resource/{chemin vers la ressource associée}*
  - *Fomulaire de signature du contrat* -> */bookings-ui/contract/{lien du contrat à signer}*
  - *Page d'évenement* -> */bookings-ui/event/{identifiant de l'événement}*

  **Trombinoscope**: Activez/désactivez le trombinocope sur le portail client. :br
  Vous pouvez sélectionnez les informations de la fiche utilisateur qui s'afficheront sur chaque vignette.

    ::::callout{color="teal" icon="i-heroicons-light-bulb"}
    Le trombinoscope affichera les utilisateurs de votre site ayant le rôle sélectionné dans la section Trombinoscope. :br
    Par exemple, si vous sélectionnez le rôle **Client**, tous les utilisateurs ayant le rôle **Client** apparaîtront dans le trombinoscope. :br
    Par contre les utilisateurs désactivés n'apparaîtront pas.
    ::::

  **Support**: Activez / Désactivez la section Support du portail clients.

  **Liens**: Ajoutez des liens vers des pages non-standards du portail clients. :br
  Vous pouvez utiliser n'importe quelle icône disponible sur [Feather icons](https://feathericons.com/){rel=""nofollow""}. :br*Exemple:*

  | Icône   | Etiquette      | URL                                                  | Ouvrir dans un nouvel onglet |
  | ------- | -------------- | ---------------------------------------------------- | ---------------------------- |
  | feather | Chat           | /raven                                               | 0                            |
  | layout  | Notre site web | <https://mappemonde.org>{rel=""nofollow""} | 1                            |

  **Activer la gestion des permissions par organisation**: En cochant cette option, vous permettez à vos clients d'inviter d'autres utilisateurs de leur organisation et de leurs donner des droits applicables au portail web. :br
  Par défaut le premier utilisateur d'une organisation à les droit d'administration de son organisation.

  ## Guides de création

  **Activer les guides de création** : En cochant cette option, vous activez la fonctionnalité de guides pas-à-pas sur votre portail Bookings. Une fois activée, vos équipes peuvent créer des tutoriels structurés (stages et étapes) et les publier à destination de vos membres.

    ::::callout{icon="i-heroicons-light-bulb"}
    Pour en savoir plus sur la création et la publication de guides, consultez la page [**Guides de création**](https://doc.dokos.io/v5/dokos/lieu/guides-de-creation).
    ::::
  :::
::


# Cas d'usage

## Mappemonde

Cet exemple est basé sur le cas d'usage présenté sur le site <https://tierslieux.dokos.io>{rel="&#x22;nofollow&#x22;"}

### Présentation du lieu

Mappemonde est un tiers lieu proposant les services suivants:

- La location de 10 espaces de coworking
- La location d'une salle de séminaire
- La location d'une salle de réunion
- La location d'une imprimante 3D

Nous souhaitons permettre les réservations de créneaux horaires pour notre salle de coworking ainsi que pour nos deux salles et notre imprimante 3D via le bureau de Dokos et via le site web.

Mappemonde sera ouvert de 8h à 18h30 tous les jours et proposera des locations à l'heure, à la demi-journée ou à la journée. Les locations à l'heure et à la journée termineront à 18h, par contre les locations à la demi-journées ne démarreront qu'à 13h30 et se termineront à 18h30.

Nous souhaitons synchroniser toutes ces réservations avec Google Agenda.

Nous souhaitons permettre à nos utilisateurs de régler leurs réservations en ligne par carte bancaire sur le site web.

::tabs
  :::tabs-item
  ---
  icon: i-mdi-checkbox-multiple-marked-outline
  label: Configuration
  ---
  #### 1. Créer nos unités de mesure

  Nous n'avons pas besoin de configuration particulière pour réserver des créneaux sur le bureau de Dokos, car il s'agit de mettre une heure de début et une heure de fin. :br
  Par contre, nous allons vouloir facturer nos réservation avec des tarifs différents en fonction de la durée de chaque créneau et nous allons vouloir proposer des créneaux fixes sur le portail client.

  Il nous faudra donc 3 unités de mesure: **Heure**, **Demi-journée**, **Jour**:br
  Chaque unité de mesure sera ensuite associée à une durée et - au moins - un tarif.

  #### 2. Définir la durée de chacune de nos unités de mesure

  Il n'y a généralement pas de débats sur la durée d'une minute ou d'une heure, par contre certaines unités de mesures peuvent avoir des durées différentes en fonction des lieux. :br
  Par exemple, une demi-journée peut être équivalente à 4 heures à Mappemonde, mais 5 heures dans un tiers-lieu voisin.

  Dans Dokos, vous pouvez définir les durées de vos unités de mesure dans les **Paramètres du lieu** > **Unités de mesure**.

  Indiquez quelle est l'unité de mesure valant 1 minute, cela servira de base au système pour calculer les autres durées. :br
  Dans le cas de Mappemonde, nous allons renseigner 3 unités de mesure dans la table de conversion:

  | Unité de mesure | Durée |
  | --------------- | ----- |
  | Heure           | 1h    |
  | Demi-journée    | 4h    |
  | Journée         | 10h   |

  On aurait pu également ajouter des unités de mesure plus exotiques, comme par exemple:

  | Unité de mesure | Durée |
  | --------------- | ----- |
  | Soirée          | 4h    |

  Dans le cas où vous faites des locations de plus longues durées, la table de conversion dédiée permet, par exemple, de paramétrer des unités de mesure spécifiques:

  | Unité de mesure source | Quantité | Unité de mesure cible |
  | ---------------------- | -------- | --------------------- |
  | 3 Mois                 | 3        | Mois                  |

  #### 3. Créer nos calendriers de réservation

  Nous n'avons pas besoin de définir de calendriers pour effectuer une réservation depuis le bureau de Dokos. :br
  Par contre, pour permettre les réservations en ligne, il faut créer un ou plusieurs calendriers qu'on affectera ensuite dans nos ressources réservables.

  Pour Mappemonde, nous avons besoin de deux calendriers: un calendrier permettant les réservations de 8h à 18h, à l'heure ou à la journée. :br
  Pour les réservations à la demi-journée, nous souhaitons laisser une pause de 30 minutes le midi donc nous aurons un calendrier de réservation permettant les réservations de demi-journée de 8h à 13h, puis de 13h30 à 18h30.

    ::::callout
    Il est important de s'assurer que les calendriers que vous créez son cohérents avec les durées des unités de mesure définies plus haut. :br
    Par exemple, de 8h à 18h, il y a 10 heures, et notre unité de mesure Journée dure bien 10h. :br
    De même, chaque demi-journée dure 4h, or il y a bien 4h entre 8h et 13h et entre 13h30 et 18h30.
    ::::
  :::
::

```text
#### Calendrier par défaut - A l'heure et à la journée
- **Unité de mesure**: Aucune - Ce calendrier sera valable pour toutes les unités de mesure, ce sera notre calendrier par défaut
- **Article**: Aucun - Ce calendrier sera valable pour tous les articles

|Jour|Heure de début|Heure de fin|
|----|--------------|------------|
|Lundi|08:00|18:00|
|Mardi|08:00|18:00|
|Mercredi|08:00|18:00|
|Jeudi|08:00|18:00|
|Vendredi|08:00|18:00|

#### Calendrier à la demi-journée
- **Unité de mesure**: Demi-journée - Ce calendrier ne sera valable que pour les demi-journées
- **Article**: Aucun - Ce calendrier sera valable pour tous les articles

|Jour|Heure de début|Heure de fin|
|----|--------------|------------|
|Lundi|08:00|13:00|
|Lundi|13:30|18:30|
|Mardi|08:00|13:00|
|Mardi|13:30|18:30|
|Mercredi|08:00|13:00|
|Mercredi|13:30|18:30|
|Jeudi|08:00|13:00|
|Jeudi|13:30|18:30|
|Vendredi|08:00|13:00|
|Vendredi|13:30|18:30|

#### 4. Configurer les calendriers Google Agenda

Il faut configurer l'intégration aux services [Google](/v5/dokos/integrations/google) et [créer un agenda](/v5/dokos/integrations/google-calendar) pour chacun de nos services.

Nous aurons donc 3 agendas Google:
- Salle de coworking
- Salle de séminaire
- Salle de réunion

#### 5. Créer une ressource pour chaque service
* Nous aurons donc une ressource réservable **Salle de coworking**, une ressource réservable **Grande salle de réunion - 1er étage** et une ressource réservable **Salle de séminaire - 2ème étage**
* Pour chacune de ces ressources, un article équivalent va être généré: il permettra de facturer notre service.  
⚠️ Pour le moment assurez-vous d'avoir un article différent par ressource réservable. C'est le cas quand l'article est créé automatiquement à la création de la ressource.  

::callout
[En savoir plus sur les articles](/v5/dokos/parametrage/articles)
::

* Pour la salle de coworking, nous allons autoriser 10 **réservations simultanées**
* Pour chaque ressource, nous allons définir un prix unitaire par unité de mesure, associés avec un calendrier.
Ex.
|Prix Unitaire|Unité de mesure|Calendrier|
|----|--------------|--------------|
|137 €|Demi-journée|Général - Demi-journée|
|238 €|Jour|Général - Heure et Journée|

::callout
Pour ceux qui souhaitent avoir des prix différents en fonction des types de clients, vous pouvez ajouter des prix supplémentaires directement dans la section [Prix de l'article](/v5/dokos/parametrage/prix)
::

* Pour nos 3 services, nous allons ajouter remplir les onglets **Facturation** et **Site Web** pour définir ce qui s'affichera sur les devis/factures et sur le portail web.
* Nous allons également cocher **Publier sur le site web**


Dans les fiches articles associées à nos ressources, nous pouvons:
- Lier chaque service avec son Agenda Google dans la section **Calendrier**.
- Associer une couleur à chaque service pour les retrouver plus facilement dans notre calendrier de réservation.

#### 6. Réserver un créneau horaire

Pour réserver un créneau horaire, rendez-vous dans **Réservation de ressources > Calendrier de réservation** ou utilisez le raccourci **Ctrl+G** puis tapez **Calendrier de réservation**.

Sélectionnez la ressource que vous souhaitez réserver dans le filtre en haut à gauche.

<mermaid>
flowchart TD
    A[Ouvrir Calendrier de réservation] --> B[Sélectionner la ressource]
    B --> C[Cliquer sur un créneau disponible]
    C --> D[Remplir les détails de la réservation]
    D --> E[Enregistrer]
</mermaid>

Une fois la ressource sélectionnée, cliquez sur un créneau disponible dans le calendrier pour ouvrir le formulaire de réservation.

Dans le formulaire de réservation, vous pouvez:
- **Définir la durée** : Sélectionnez l'unité de mesure (Heure, Demi-journée, Jour) et ajustez la quantité si nécessaire.
- **Activer le toggle "Créneau entier"** : Si cette option est activée, la réservation occupera automatiquement tout le créneau disponible dans le calendrier, sans laisser d'espaces inutilisés. Par exemple, si vous réservez une demi-journée avec cette option activée, le système bloquera toute la plage horaire correspondante (ex. 8h-12h ou 13h30-17h30) sans permettre d'autres réservations dans cet intervalle.
- **Ajouter des participants** : Si nécessaire, ajoutez des participants à la réservation.
- **Saisir une référence** : Ajoutez une référence pour faciliter le suivi.

::callout
L'option **Créneau entier** est particulièrement utile pour les réservations de salles ou d'espaces où vous souhaitez bloquer toute la plage horaire, évitant ainsi les réservations partielles qui pourraient fragmenter votre calendrier.
::

#### 7. Activer la passerelle de paiement

Nous souhaitons permettre le paiement par carte bancaire, nous allons donc nous créer un compte chez [Stripe](/v5/integrations/payments/stripe) et configurer la [passerelle de paiement](/v5/dokos/comptabilite/passerelles-paiements) correspondante.

Ensuite, dans les paramètres du panier, nous allons sélectionner le compte en Euros de Stripe comme compte passerelle de paiement pour permettre le paiement sur le site web lors des réservations de créneaux.

::demo-link{demo="Mappemonde" path="/app/stripe-settings"}
Voir la configuration de la démo
::


#### 8. Activer le portail

Pour permettre aux utilisateurs de voir leurs réservations sur le portail, vous pouvez activer les redirections automatiques vers le portail client de Bookings dans les **Paramètres de réservation de ressources** > **Portail client**.  
Vous y trouverez des éléments de paramétrage liés aux différentes rubriques du portail.  

#### 9. Créer une page d'accueil pour notre site web

Vous pouvez utiliser l'application [Frappe Builder](https://frappe.io/builder) pour créer une page d'accueil présentant vos services.  
Un lien vers /bookings-ui vous permettra de rediriger vos utilisateurs vers le portail client.  

::demo-link{demo="Mappemonde" path="/builder"}
Voir la page d'accueil de la démo
::
::
```

\::


# Réservations de ressources

## 1. Concepts

### 1.1 Ressources réservables

**Présentation**
Le module "Ressources réservables" permet de publier et gérer l'ensemble des équipements et espaces disponibles à la réservation sur votre plateforme. Cette fonctionnalité est essentielle pour communiquer efficacement les disponibilités à vos utilisateurs.

**Types de ressources gérables**
Vous pouvez configurer divers types de ressources, tels que :

- Salles de réunion (Marco Polo, Vasco de Gama)
- Équipements techniques (imprimantes 3D)
- Espaces partagés (zones de coworking)

**Fonctionnalités clés**

*Personnalisation du contenu*
Enrichissez la présentation de chaque ressource avec des descriptions complètes et des images illustratives pour une meilleure expérience utilisateur.

*Gestion tarifaire*
Définissez avec précision les tarifs applicables ainsi que les unités de mesure appropriées (heure, jour, etc.) pour chaque ressource.

*Planification temporelle*
Configurez un calendrier détaillé pour chaque ressource, spécifiant les périodes de disponibilité et d'indisponibilité.

*Contrôle des réservations*
Établissez des règles d'accès en spécifiant les badges ou autorisations nécessaires pour effectuer une réservation.

::demo-link{demo="Mappemonde" path="/app/booking-resource"}
Voir les ressources réservables de la démo
::

## 1.2 Réservation d'articles

**Présentation**
Le module "Réservations d'articles" constitue l'interface principale permettant à vos utilisateurs de réserver des articles et ressources directement depuis la plateforme. Cette fonctionnalité centralise toutes les opérations liées à la gestion des demandes de réservation.

**Fonctionnalités clés**

*Suivi des réservations*
Visualisez l'ensemble des réservations via une interface de calendrier intuitive permettant une gestion optimale des plannings et des disponibilités.

*Gestion de la facturation*
Générez et suivez automatiquement les factures associées à chaque réservation pour une gestion financière simplifiée.

*Gestion des statuts*
Pilotez efficacement le cycle de vie des réservations grâce aux différents statuts disponibles (confirmé, annulé, non confirmé) pour une visibilité optimale sur l'état de chaque demande.

::demo-link{demo="Mappemonde" path="/app/item-booking"}
Voir les réservations d'articles de la démo
::

## 2. Calendriers de réservation

::tour{demo="Mappemonde" doctype="item-booking-calendar"}
Créer un calendrier dans la démo
::

La configuration des calendriers de réservation permet de gérer la disponibilité des ressources sur le portail web. Cela permet de définir des créneaux horaires spécifiques pour la réservation d'articles ou de services, tout en tenant compte des exceptions et de vos besoins spécifiques.

![Cette image permet de visualiser le paramétrage du calendrier.](https://doc.dokos.io/calendrier.png)

#### 2.1. Fonctionnement du calendrier de réservation

Si vous ne renseignez aucun calendrier dans votre ressource voici comment Dokos sélectionne le calendrier à appliquer pour une réservation.

Voici l'ordre de recherche utilisé par Dokos :

- Calendrier correspondant à l'article et à l'unité de mesure demandés : Si un calendrier est spécifiquement lié à l'article et à l'unité de mesure, celui-ci sera utilisé.
- Calendrier correspondant à l'article demandé, sans unité de mesure : Si aucun calendrier spécifique à l'unité de mesure n'est trouvé, Dokos recherche un calendrier lié uniquement à l'article.
- Calendrier correspondant à l'unité de mesure demandée, sans article : Si aucun calendrier spécifique à l'article n'est trouvé, Dokos recherche un calendrier lié uniquement à l'unité de mesure.
- Calendrier lié à aucun article et aucune unité de mesure : Si aucun des critères ci-dessus ne correspond, Dokos utilisera un calendrier général, sans lien spécifique avec un article ou une unité de mesure.

> Il est donc recommandé de configurer un calendrier par défaut pour assurer la gestion des réservations dans tous les cas.

#### 2.2. Comment configurer efficacement un calendrier de réservation ?

- **Définir des créneaux adaptés** : Assurez-vous que les créneaux horaires définis répondent aux besoins de vos utilisateurs. Par exemple, si vos clients préfèrent réserver des matinées ou des après-midis entières, des demi-journées sont une bonne option. Si des créneaux plus courts sont préférables, vous pouvez envisager d'ajuster l'unité de mesure à l'heure plutôt qu'à la demi-journée.
- **Optimisation des ressources** : En tenant compte du coût d'opportunité, vous pouvez configurer vos calendriers de manière à maximiser l'utilisation des espaces tout en minimisant les périodes de non-utilisation. Cela vous permet d'optimiser vos revenus et d'améliorer la satisfaction des clients en offrant des créneaux horaires plus adaptés à leurs besoins.
- **Utiliser des exceptions judicieusement** : Adapter le calendrier aux réalités spécifiques comme les jours fériés, les événements exceptionnels, ou les travaux de maintenance. Assurez-vous de les configurer à l'avance pour éviter les conflits de réservation.

#### 2.3. Configuration des calendriers de réservation

Vous pouvez configurer plusieurs calendriers de réservation en fonction de vos besoins. Chaque calendrier peut être associé à un article spécifique, à une unité de mesure spécifique, ou rester général pour s'appliquer à tous les cas.

![Cette image permet de visualiser les deux calendriers de la démo.](https://doc.dokos.io/deux-calendriers.png)

1. Créer un nouveau calendrier

- Titre du calendrier : Donnez un nom descriptif à votre calendrier. Ce nom doit refléter l'unité de mesure auquel il est associé.
- Unité de mesure : Sélectionnez l'unité de mesure applicable à ce calendrier (par exemple, Demi-journée, Heure, Journée). Si vous souhaitez que le calendrier soit applicable à toutes les unités de mesure, laissez ce champ vide.
- Article : Sélectionnez l'article (comme une salle de réunion ou un bureau) auquel ce calendrier s'applique. Si vous souhaitez que le calendrier soit applicable à tous les articles, laissez ce champ vide.

2. Configurer le calendrier de réservation

Sous la section "Calendrier de réservation", vous pouvez configurer les créneaux horaires disponibles pour chaque jour de la semaine :

Configuration type :

Dans la fenêtre de configuration du calendrier, vous pouvez choisir les jours de la semaine pour lesquels les créneaux horaires seront applicables.
Ils seront ensuite ajoutés automatiquement dans le tableau.

Configuration personnalisez :

- Ajouter des créneaux horaires :
  Cliquez sur "Ajouter une ligne" pour créer un nouveau créneau horaire.
- Jour : Sélectionnez le jour de la semaine pour lequel ce créneau sera valide.
- Heure de début : Spécifiez l'heure à laquelle le créneau commence.
- Heure de fin : Spécifiez l'heure à laquelle le créneau se termine.

> Whole (Entier) : Cochez cette case si vous souhaitez permettre l'ouverture d'un créneau qui ne respecte pas la durée définie dans les paramètres du lieu.

- Exemple : Supposons que, dans les paramètres du lieu, une demi-journée soit définie comme un créneau de 4 heures (par exemple, de 08:00 à 12:00 ou de 13:00 à 17:00). Cependant, vous souhaitez ouvrir le dimanche de 09:00 à 12:00, soit un créneau de 3 heures, ce qui ne correspond pas exactement à la définition standard de la demi-journée. Vous pouvez cocher la case : Whole pour permettre la réservation.

Exemple de calendrier : Différents calendriers par unité de mesure

- Cas d'utilisation : Vous louez vos espaces à l'heure, à la demi-journée et à la journée.
- Calendrier par défaut (à l'heure et à la journée)


  - Unité de mesure : Aucune (valable pour toutes les unités de mesure).
  - Article : Aucun (valable pour tous les articles).
  - Configuration des créneaux : Lundi à Vendredi : 08:00 - 18:00.
- Calendrier à la demi-journée


  - Unité de mesure : Demi-journée.
  - Article : Aucun (valable pour tous les articles).
  - Configuration des créneaux : lundi à Vendredi : Matin : 08:00 - 13:00. Après-midi : 13:30 - 18:30.

#### 2.4. Exceptions

- Exceptions : Cette section vous permet de définir des exceptions au calendrier régulier. Par exemple, si la ressource n'est pas disponible un jour férié ou si elle est réservée pour un événement spécial. Les exceptions peuvent inclure des dates spécifiques où les horaires sont différents ou où les réservations sont totalement interdites.

## 3. Disponibilité de réservation et préavis

La **Disponibilité de réservation** (*Booking Availability*) est le document qui lie une ressource réservable à une unité de mesure et à une liste de prix. C'est dans ce document que vous définissez les règles de préavis applicables à chaque combinaison.

### 3.1 Préavis minimum de réservation

Le **préavis minimum** empêche les réservations de dernière minute. Lorsqu'il est défini, Dokos masque automatiquement sur le portail tous les créneaux dont le début est inférieur à cette durée à compter du moment présent.

> **Exemple — Salle Marco Polo, Maison Verte SARL**
> Vous avez configuré un préavis minimum de 2 heures pour la salle Marco Polo. Il est actuellement 10h00 : Dokos n'affichera plus de créneau disponible avant 12h00. Sophie, membre chez Maison Verte SARL, ne peut donc pas réserver la salle pour 11h00 depuis le portail.

Cette contrainte est également vérifiée côté serveur : une réservation créée manuellement (ou via l'API) sera rejetée si le créneau choisi ne respecte pas le délai minimum.

### 3.2 Préavis maximum de réservation

Le **préavis maximum** limite les réservations trop lointaines dans le futur. Les créneaux dont le début dépasse cette fenêtre n'apparaissent pas sur le portail.

> **Exemple — Bureau privatif, Bureau Moderne**
> Votre tiers-lieu autorise les réservations jusqu'à 30 jours à l'avance pour les bureaux privatifs. Un client de Bureau Moderne qui souhaiterait réserver pour dans deux mois ne trouvera aucun créneau disponible au-delà de 30 jours.

Comme pour le préavis minimum, la règle est appliquée à la fois sur le portail (les créneaux hors fenêtre ne sont pas affichés) et côté serveur (une réservation hors fenêtre est refusée à l'enregistrement).

### 3.3 Laisser les champs vides

Si vous ne renseignez ni le préavis minimum ni le préavis maximum, aucune contrainte temporelle n'est appliquée : les réservations sont possibles jusqu'au dernier moment et sans limite dans le futur.

### 3.4 Granularité par ressource, durée et tarif

Puisqu'une Disponibilité de réservation est propre à une combinaison (ressource, unité de mesure, liste de prix), vous pouvez définir des règles de préavis différentes selon le type d'utilisation.

> **Exemple pratique**
>
> - Salle Marco Polo à l'**heure** : préavis minimum 1 heure, pas de préavis maximum
> - Salle Marco Polo à la **journée** : préavis minimum 24 heures, préavis maximum 60 jours
> - Bureau privatif au **mois** (tarif abonné) : préavis minimum 48 heures, préavis maximum 90 jours

::mermaid
flowchart LR
A\[Client sur le portail] --> B{Créneau dans la fenêtre\nmin/max ?}
B -- Oui --> C\[Créneau affiché]
B -- Non --> D\[Créneau masqué]
C --> E{Validation\nserveur}
E -- OK --> F\[Réservation confirmée]
E -- Hors fenêtre --> G\[Réservation refusée]

::

## 4. Ressources réservables

::tour{demo="Mappemonde" doctype="booking-resource"}
Créer une ressource réservable dans la démo
::

::callout{icon="i-heroicons-light-bulb"}
Deux options s'offrent à vous : la première consiste à créer directement votre ressource réservable via cette fonctionnalité, comme indiqué ci-dessous. La seconde option est de créer un article que vous définirez comme réservable, sans le publier sur le site. Ensuite, vous pourrez créer une nouvelle ressource pour associer cet article à un calendrier et le publier. Notez que si vous publiez l'article directement depuis la création d'article, l'option de configuration du calendrier ne sera pas proposée. En revanche, si vous optez pour la création via la fonctionnalité "Ressources réservables", l'article correspondant sera automatiquement créé.
::

![Cette image permet de visualiser une ressource réservable.](https://doc.dokos.io/ressource-reservable.png)

#### 4.1. Création d'une nouvelle ressource réservable

- **Libellé** : Entrez un nom descriptif pour la ressource (par exemple, "Salle de Réunion A" ou "Bureau 101").
- **Désactivé** : Cochez cette case si la ressource ne doit plus être disponible à la réservation temporairement.
- **Publié sur le site web** : Cochez cette case pour rendre la ressource visible et réservable via le site web public.
- **Réservations simultanées autorisées** : Indiquez le nombre maximum de réservations pouvant être faites simultanément pour cette ressource.
- **Calendrier par défaut** : Sélectionnez un calendrier prédéfini qui sera utilisé pour cette ressource, définissant ainsi les créneaux horaires disponibles pour la réservation.
- **Ne montrer le calendrier qu'aux utilisateurs connectés** : Cochez cette case pour restreindre l'affichage du calendrier aux utilisateurs authentifiés uniquement. Cette option améliore la confidentialité en masquant les disponibilités aux visiteurs non connectés.
- **Prix** : Ajoutez une ou plusieurs lignes pour définir le prix unitaire de la ressource selon l'unité de mesure (heure, demi-journée, journée, etc.). Vous pouvez également associer un calendrier spécifique pour chaque prix.
- **Badges** : Sélectionnez les types de badges requis pour réserver cette ressource. Les badges peuvent être utilisés pour restreindre l'accès à certaines ressources selon les qualifications.

> Rendez-vous sur la page [**Badges**](https://doc.dokos.io/v5/dokos/lieu/badges)

#### 4.2. Configuration de la facturation

- **Groupe d'article** : Sélectionnez le groupe d'articles auquel cette ressource appartient. Ce paramètre est obligatoire pour organiser les articles et les associer correctement aux factures.
- **Description** : Entrez une description détaillée de la ressource, qui apparaîtra sur les factures, devis, et commandes. Vous pouvez formater le texte, ajouter des images, des liens, ou d'autres éléments visuels.
- **Lien vers l'article** : Si vous avez un article spécifique lié à cette ressource, sélectionnez-le ici. Sinon, laissez ce champ vide pour permettre une création automatique.

#### 4.3. Paramètres de site internet

- **Image** : Joignez une image qui sera affichée sur la page de réservation du site internet. Cela permet de rendre la présentation de la ressource plus attrayante pour les utilisateurs.
- **Description** : Ajoutez une description spécifique à afficher sur le site web. Cela peut différer de la description utilisée pour la facturation, permettant ainsi de personnaliser le contenu en fonction du public cible.
- **Diaporama** : Configurez un diaporama pour présenter plusieurs images de la ressource. Cette option est particulièrement utile pour donner aux utilisateurs une vue d'ensemble de l'espace ou de l'équipement proposé.

**Services** :

- **Sélection des services** : Cochez les services supplémentaires inclus avec cette ressource, tels que l'accès PMR, un bureau individuel, un espace pour téléphoner, ou le WiFi. Vous pouvez également créer de nouveaux services si nécessaire.

**Lien vers l'article du site web** :

- **Article du site Web** : Sélectionnez l'article qui sera lié à cette ressource sur le site internet. Laissez ce champ vide pour une création automatique.

## 5. Réservation d'article

::tour{demo="Mappemonde" doctype="item-booking"}
Créer une réservation d'article dans la démo
::

![Cette image permet de visualiser une réservation d'article.](https://doc.dokos.io/reservation-d-article.png)

#### 5.1. Remplir les détails de la réservation :

- Article : Sélectionnez l'article ou la ressource que vous souhaitez réserver (par exemple, "Salle de réunion", "Machine CNC").
- Utilisateur : Associez la réservation à l'utilisateur spécifique qui effectuera la réservation.
- Couleur : Choisissez une couleur pour identifier visuellement cette réservation dans le calendrier. Cela peut aider à distinguer facilement différentes réservations.
- Statut : Définissez le statut de la réservation (par exemple, "Non confirmé", "Confirmé", "Annulé").
- Commence le / Termine le : Spécifiez les dates et heures de début et de fin de la réservation. Vous pouvez également cocher "Toute la journée" si la réservation s'étend sur toute la journée.
- Répéter cet événement : Cochez cette case si la réservation doit se répéter régulièrement.
- Synchroniser avec Google Agenda : Si cette option est activée, la réservation sera synchronisée avec l'agenda Google.
- Ajouter des notes :
  La section notes permet d'ajouter des informations supplémentaires ou des instructions spécifiques concernant la réservation. Ces notes sont utiles pour fournir des détails.

#### 5.2. Configuration de la facturation :

- Type de tiers : Sélectionnez le type de client ou piste potentielle. Cela permet de catégoriser la réservation.
- Tiers : Associez la réservation à un client spécifique, qui sera facturé pour l'utilisation de l'article. Ce champ permet de lier la réservation à une fiche client existante dans le système.

## 6. Site web et portail

- [Rendez-vous sur la page "Passerelles de paiement" pour ajouter une ou plusieurs passerelles de paiement si vous souhaitez activer les paiements en ligne.](https://doc.dokos.io/v5/dokos/comptabilite/passerelles-paiements)

::tour{demo="Mappemonde" doctype="webshop-settings"}
Voir les paramètres e-commerce.
::

### 7.1. Réservation sur le site web

Vos utilisateurs du site web peuvent effectuer des réservations en ligne sur le portail dédié, accessible à l'adresse {Adresse de votre site}/bookings-ui

Les réservations en brouillon (non validées) sont automatiquement supprimées après un certain nombre de minutes (défini dans les paramètres des lieux) en cas d'abandon de panier.

### 7.2. Restriction d'accès au planning des réservations

Pour améliorer la confidentialité et la sécurité de vos données de réservation, vous pouvez configurer Dokos pour ne montrer le planning des réservations qu'aux utilisateurs connectés. Cette fonctionnalité est particulièrement utile pour les organisations qui souhaitent limiter l'accès aux informations de disponibilité aux membres authentifiés uniquement.

**Configuration** :

1. Allez dans la fiche de votre **ressource réservable** (par exemple, "Salle Marco Polo").
2. Cochez la case &#x2A;*"Ne montrer le calendrier qu'aux utilisateurs connectés"**.
3. Enregistrez les modifications.

**Impact sur le portail** :

- Les visiteurs non connectés ne verront plus le calendrier des disponibilités pour cette ressource.
- Un message invitant à se connecter sera affiché à la place du planning.
- Les utilisateurs connectés continueront à voir et à réserver les créneaux disponibles comme d'habitude.

> **Exemple — Maison Verte SARL**
> Vous gérez un espace de coworking et souhaitez limiter la visibilité des disponibilités de vos salles de réunion aux membres actifs. En activant cette option, seuls les utilisateurs connectés avec un compte valide pourront consulter les créneaux disponibles pour la salle Marco Polo, tandis que les visiteurs anonymes ne verront qu'une invitation à se connecter.

::mermaid
flowchart TD
A\[Visiteur sur le portail] --> B{Utilisateur connecté ?}
B -- Oui --> C\[Afficher le planning des réservations]
B -- Non --> D\[Afficher un message d'invitation à se connecter]

::

## 8. Réservations depuis un événement

::tour{demo="Mappemonde" doctype="event"}
Créer un événement dans la démo
::

Si vous organisez des événements nécessitant la gestion de ressources réservables, il est possible de lier vos réservations d'articles à vos événements.

Par exemple, pour organiser une exposition temporaire nécessitant la réservation de votre grande salle, de la cuisine et de deux salles de réunion pour toute la durée de l'événement :

- Créez votre événement et réservez les espaces nécessaires en utilisant le bouton "Réserver un article" depuis la fiche de l'événement.

![Cette image permet de visualiser comment ajouter une ressource réservable dans un événement.](https://doc.dokos.io/evenements.png)

Vous pouvez ensuite ajuster les horaires et les conditions de chaque réservation de manière individuelle pour chaque article réservé.

## 9. Intégration Google Agenda

Vous avez la possibilité de synchroniser vos réservations d'articles avec Google Agenda. Pour configurer la connexion et créer des agendas, consultez [notre page : Google Agenda](https://doc.dokos.io/v5/dokos/integrations/google-calendar).

#### 9.1. Configuration

Vous pouvez le lier chaque article avec un agenda ayant comme document de référence **Réservation d'articles** dans la section **Google Agenda**
Si un article n'est pas lié avec un agenda, il faudra sélectionner celui-ci manuellement dans chaque réservation.

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Chaque article doit être lié avec un agenda différent.
::

#### 9.2. Synchronisation

Pour synchroniser vos réservations, cochez la case **Synchroniser avec Google Agenda**.
Vérifiez qu'un agenda est bien sélectionné dans le champs **Google Agenda**.

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
*Dokos* ne gère pas encore les exceptions liées aux récurrences d'événement.
Si vous souhaitez supprimer un événement récurrent dans Google Agenda, sélectionnez bien l'option **Tous les événements**.
Si vous supprimez seulement une occurence de cet événement, cela n'apparaîtra pas dans *Dokos*.
::

Pour automatiser la synchronisation des réservations en ligne, cochez la case **Synchroniser automatiquement avec Google Calendar** dans les **paramètres des lieux**.

Si vous souhaitez que les réservations d'articles soient toujours synchronisées, personnalisez le formulaire de réservation d'articles et mettez 1 comme valeur par défaut pour le champs **Synchroniser avec Google Agenda**.

## 10. Contrat de réservation de ressources

Pour configurer vos contrats de réservation, rendez-vous sur la page [contrats](https://doc.dokos.io/v5/dokos/lieu/contrats-bookings)

## 11. Paramètres de réservation de ressources

Lors de la création d'un contrat de réservation, vous avez la possibilité d'envoyer une demande de signature par email au client.

![Cette image permet de visualiser la zone permettant d'envoyer le contrat au client.](https://doc.dokos.io/envoyer-le-contrat-au-client.png)

Ci-dessous, vous trouverez le modèle d'email par défaut qui est envoyé au client pour la signature de son contrat :

![Cette image permet de visualiser le mail type envoyé au client pour la signature de son contrat.](https://doc.dokos.io/mail-type.png)

Si le contenu de cet email par défaut ne correspond pas à vos attentes, il est possible de le personnaliser dans les paramètres de réservation de ressources.

![Cette image permet de visualiser les paramètres de réservation de ressources.](https://doc.dokos.io/parametre-ressources.png)


# Contrats

## 1. Prérequis

Avant de pouvoir établir un contrat de réservation, il est nécessaire de créer un article au préalable :

> ***Accueil > Ventes > Données de vente > Article***

::tour{demo="Mappemonde" doctype="item"}
Créer un article dans la démo
::

- Il est important de **configurer les articles comme récurrents** afin qu'ils déclenchent automatiquement la création d'un abonnement lors de la validation de la commande.

Ensuite, vous devez publier cet article sur le site web.

![Cette image permet de visualiser comment publier un article sur le site web.](https://doc.dokos.io/publier-un-article-sur-le-site-web.png)

Accédez à l'article publié sur le site web pour finaliser les paramètres de celui-ci.

![Cette image permet de visualiser l'article du site web.](https://doc.dokos.io/article-du-site-web.png)

Si vous avez activé la récurrence dans l'article, la case **Générer un abonnement** sera automatiquement cochée et non modifiable.

Indiquez la période de récurrence pour cet article.

## 2. Type de contrat

::tour{demo="Mappemonde" doctype="booking-contract-type"}
Créer un type de contrat dans la démo
::

![Cette image permet de visualiser formulaire du type de contrat.](https://doc.dokos.io/type-de-contrat.png)

### 2.1. **Informations générales du contrat**

- **Désactivé** : Cochez cette case si vous souhaitez désactiver ce type de contrat temporairement ou définitivement.
- **Type de contrat** : Indiquez ici le nom du type de contrat que vous créez.
- **Sélectionner un modèle de contrat** : Si vous avez des modèles de contrat prédéfinis, vous pouvez les sélectionner ici.**Modèle de contrat** : Vous pouvez rédiger ou copier-coller le contenu du contrat ici.
- **Spécifier les options de durée** Si vous gérez des contrats à durée déterminée, vous pouvez spécifier les paramètres suivants :
- **Contrat à durée déterminée** : Cochez cette option si le contrat a une durée fixe. **Durée minimum** : Spécifiez la durée minimale en mois.**Préavis** : Indiquez ici la période de préavis nécessaire avant de mettre fin au contrat.

![Cette image permet de visualiser l'onglet ressource dans le type de contat.](https://doc.dokos.io/type-de-contrat-ressources.png)

### 2.2. **Définir les ressources associées au contrat**

Dans l'onglet **Ressources**, vous avez la possibilité de définir quelles ressources seront accessibles avec ce type de contrat. Il peut s'agir d'espaces de travail, de salles de réunion, ou d'équipements spécifiques.

::callout
Cette fonctionnalité permet de fournir un accès illimité aux ressources que vous choisissez de rendre disponibles.
::

![Cette image permet de visualiser l'onglet facturation dans les ressources réservables.](https://doc.dokos.io/onglet-facturation.png)

### 2.3. Configurer les articles de facturation

Dans cette section, vous allez spécifier les différents articles qui seront facturés.

- **Article de facturation récurrente** : Sélectionnez l'article qui sera facturé de manière récurrente pour le quel vous faites ce contrat.
- **Article de facturation à la signature** : Ce champ permet de spécifier un article qui sera facturé uniquement au moment de la signature du contrat, tel que des frais d'activation ou des frais administratifs.
- **Récurrence de facturation** : Indiquez la fréquence à laquelle la facturation récurrente sera appliquée (mensuelle, trimestrielle, annuelle).
- **Montant du dépôt de garantie** : Spécifiez ici le montant du dépôt de garantie à verser à la signature du contrat, si applicable. Ce dépôt peut servir à couvrir les frais en cas de dommages aux ressources ou de non-respect des conditions du contrat.

![Cette image permet de visualiser l'onglet format d'impression.](https://doc.dokos.io/format-d-impression-contrat-de-reservation.png)

### 2.4. Paramètres d'impression

Rendez-vous sur la page : format d'impression pour configurer vos formats.

![Cette image permet de visualiser l'onglet Avenants.](https://doc.dokos.io/avenant-contrat.png)

### 2.5. Avenants

**Exemples de cas d'utilisation des avenants**

- **Modification des conditions de réservation** : Si un client souhaite ajouter ou modifier des ressources, l'avenant peut inclure ces changements, tout en conservant le contrat initial.
- **Changement des tarifs** : En cas de modification des prix après la signature du contrat, un avenant peut être ajouté pour stipuler la nouvelle tarification.
- **Extension de la durée de réservation** : Vous pouvez utiliser un avenant pour prolonger une période de réservation initiale sans devoir rédiger un nouveau contrat.

## 3. Flux

1. Génération et signature du contrat
2. Création d'une commande récurrente
3. Génération d'un abonnement
4. Génération des factures

## 4. Dépôt de garantie

::tour{demo="Mappemonde" doctype="booking-deposit"}
Créer un dépôt de garantie dans la démo
::

Le dépôt de garantie est une somme versée par le client à la signature du contrat, destinée à couvrir d'éventuels dommages aux ressources ou un non-respect des conditions. Il est suivi dans Dokos par un document **Dépôt de garantie** distinct, depuis sa création jusqu'à sa restitution.

Le montant provient du champ **Montant du dépôt de garantie** défini sur le type de contrat (voir §2.3) et se reporte automatiquement sur le contrat.

### 4.1. Prérequis

Un **Compte de dépôt de garantie*&#x2A; doit être configuré sur la société (&#x2A;**Accueil > Paramètres > Société***). C'est sur ce compte de bilan que le montant est immobilisé tant qu'il n'est pas restitué au client.

### 4.2. Cycle de vie

À la signature du contrat, Dokos crée automatiquement un document **Dépôt de garantie** et l'ajoute comme ligne de frais à la première facture. Le versement s'effectue donc lors du règlement de cette facture, ce qui fait passer le dépôt au statut **Payé**. Le remboursement, à la fin de la relation contractuelle, génère l'écriture de journal de restitution.

::mermaid
flowchart TD
A\[Signature du contrat] --> B\[Dépôt de garantie créé : statut Demandé]
B --> C\[Montant ajouté à la première facture]
C --> D\[Règlement de la facture : statut Payé]
D --> E\[Action Remboursement : choix du mode de paiement]
E --> F\[Écriture de journal de type Écriture bancaire : compte de dépôt débité, banque créditée]
F --> G\[Restitution au client : statut Remboursé]

::

Le champ **Statut** du dépôt reflète cette progression :

| Statut    | Signification                                                                                |
| --------- | -------------------------------------------------------------------------------------------- |
| Brouillon | Le dépôt vient d'être créé, avant validation.                                                |
| Demandé   | Le dépôt est validé et attend le règlement du client.                                        |
| Payé      | La facture liée a été réglée ; le montant est immobilisé sur le compte de dépôt de garantie. |
| Remboursé | Le dépôt a été restitué au client par une écriture bancaire.                                 |
| Annulé    | Le dépôt a été annulé et n'est plus dû.                                                      |

### 4.3. Remboursement

Lorsque le dépôt est au statut **Payé**, le bouton **Actions > Remboursement** devient disponible. Dokos demande le **mode de paiement** à utiliser, puis génère automatiquement une **Écriture de journal** de type « Écriture bancaire » qui :

- **débite** le Compte de dépôt de garantie,
- **crédite** le compte bancaire associé au mode de paiement, pour le montant du dépôt.

Le dépôt passe alors au statut **Remboursé** et l'écriture générée est reliée dans le champ **Écriture de remboursement**.

![Cette image permet de visualiser le formulaire de dépôt de garantie.](https://doc.dokos.io/formulaire-depot-de-garantie-rembourse.png)

::callout{type="warning"}
**Comptes obligatoires** — Le remboursement nécessite qu'un **Compte de dépôt de garantie** soit configuré sur la société *et* qu'un compte bancaire par défaut soit défini sur le mode de paiement choisi. À défaut, Dokos affiche une erreur explicite et n'effectue pas l'écriture.
::

::callout
L'annulation du contrat ne rembourse pas et n'annule pas automatiquement le dépôt de garantie : celui-ci reste à traiter séparément.
::

## 5. Contrat

::tour{demo="Mappemonde" doctype="booking-contract"}
Créer un contrat dans la démo
::

**Si vous souhaitez créer un abonnement lié à un contrat, il est nécessaire de générer le contrat, qui à son tour générera l'abonnement.**

![Cette image permet de visualiser le formulaire pour générer un contrat](https://doc.dokos.io/contrat.png)![Cette image permet de visualiser comment envoyer ou valider le contrat](https://doc.dokos.io/signer-contrat.png)

Une fois le formulaire configuré, vous pouvez l'envoyer par mail au client pour signature ou bien le valider, ce qui vaudra comme signature.

### 5.1. Mail reçu par le client

Voici l'e-mail reçu par le client pour demander sa signature, une fois le contrat établi depuis le bureau.

![Cette image permet de visualiser l'e-mail reçu par le client.](https://doc.dokos.io/mail-type.png)

### 5.2. Services inclus

La section **Services inclus** liste les ressources réservables attachées au contrat — par exemple un bureau ou une salle de réunion — dont l'accès est accordé au client pour toute la durée du contrat. Ces services décrivent ce qui est *compris* dans le contrat et n'apparaissent pas directement comme lignes supplémentaires sur la facture.

### 5.3. Articles facturables supplémentaires

En plus du tarif récurrent principal, vous pouvez ajouter dans la section **Tarification** une liste d'articles facturables supplémentaires : parking privatif, espace de stockage, équipement loué, etc.

Chaque ligne du tableau contient :

- **Article** : l'article à facturer (doit être configuré comme article récurrent avec la même période de récurrence que le contrat).
- **Quantité** : le nombre d'unités à facturer à chaque échéance.
- **Prix unitaire** : rempli automatiquement depuis la liste de prix du client dès la sélection de l'article ; modifiable manuellement si besoin.
- **Montant** : calculé automatiquement (quantité × prix unitaire).

::callout{type="warning"}
**Article récurrent obligatoire** — Seuls les articles configurés comme récurrents *et* paramétrés avec la même fréquence de facturation que le contrat peuvent être ajoutés dans cette liste. Si un article ne respecte pas ces conditions, Dokos affiche une erreur explicite au moment de l'enregistrement afin d'éviter qu'une ligne disparaisse silencieusement de l'abonnement.
::

Une fois au moins un article supplémentaire renseigné, le champ **Montant total récurrent** apparaît sous le tableau et affiche la somme du tarif récurrent principal et des montants de tous les articles supplémentaires. Cela vous donne une vision immédiate du montant qui sera facturé à chaque échéance.

**Exemple** — Maison Verte SARL dispose d'un contrat de domiciliation à 150 € / mois. Elle ajoute :

| Article            | Quantité | Prix unitaire | Montant |
| ------------------ | -------- | ------------- | ------- |
| Parking privatif   | 1        | 50,00 €       | 50,00 € |
| Casier de stockage | 2        | 15,00 €       | 30,00 € |

Le **Montant total récurrent** affiché sera &#x2A;*230,00 €** (150 + 50 + 30). Chaque mois, la commande client et l'abonnement généreront trois lignes de facturation distinctes correspondant aux trois articles.

::mermaid
flowchart LR
A\[Contrat signé] --> B\[Commande client]
B --> C\[Abonnement]
C --> D\[Facture mensuelle]
D --> D1\[Ligne : Domiciliation — 150 €]
D --> D2\[Ligne : Parking — 50 €]
D --> D3\[Ligne : Stockage — 30 €]

::

## 6. Abonnement

Dans la section "Termes et conditions", vous pouvez vérifier que votre abonnement est bien associé à un contrat.

![Cette image permet de visualiser le contrat lié à l'abonnement.](https://doc.dokos.io/abonnement.png)

Les articles facturables supplémentaires définis sur le contrat sont automatiquement repris comme plans distincts dans l'abonnement généré. Chaque plan suit la même récurrence de facturation que le contrat principal.

Pour plus d'informations sur les abonnements, rendez-vous sur la page [**Abonnements**](https://doc.dokos.io/v5/dokos/ventes/abonnements) de notre documentation.


# Contrats

## 1. Prérequis

Avant de pouvoir établir un contrat de réservation, il est nécessaire de créer un article au préalable :

> ***Accueil > Ventes > Données de vente > Article***

::tour{demo="Mappemonde" doctype="item"}
Créer un article dans la démo
::

- Il est important de **configurer les articles comme récurrents** afin qu'ils déclenchent automatiquement la création d'un abonnement lors de la validation de la commande.

Ensuite, vous devez publier cet article sur le site web.

![Cette image permet de visualiser comment publier un article sur le site web.](https://doc.dokos.io/publier-un-article-sur-le-site-web.png)

Accédez à l'article publié sur le site web pour finaliser les paramètres de celui-ci.

![Cette image permet de visualiser l'article du site web.](https://doc.dokos.io/article-du-site-web.png)

Si vous avez activé la récurrence dans l'article, la case **Générer un abonnement** sera automatiquement cochée et non modifiable.

Indiquez la période de récurrence pour cet article.

## 2. Type de contrat

::tour{demo="Mappemonde" doctype="booking-contract-type"}
Créer un type de contrat dans la démo
::

![Cette image permet de visualiser formulaire du type de contrat.](https://doc.dokos.io/type-de-contrat.png)

### 2.1. **Informations générales du contrat**

- **Désactivé** : Cochez cette case si vous souhaitez désactiver ce type de contrat temporairement ou définitivement.
- **Type de contrat** : Indiquez ici le nom du type de contrat que vous créez.
- **Sélectionner un modèle de contrat** : Si vous avez des modèles de contrat prédéfinis, vous pouvez les sélectionner ici.**Modèle de contrat** : Vous pouvez rédiger ou copier-coller le contenu du contrat ici.
- **Spécifier les options de durée** Si vous gérez des contrats à durée déterminée, vous pouvez spécifier les paramètres suivants :
- **Contrat à durée déterminée** : Cochez cette option si le contrat a une durée fixe. **Durée minimum** : Spécifiez la durée minimale en mois.**Préavis** : Indiquez ici la période de préavis nécessaire avant de mettre fin au contrat.

![Cette image permet de visualiser l'onglet ressource dans le type de contat.](https://doc.dokos.io/type-de-contrat-ressources.png)

### 2.2. **Définir les ressources associées au contrat**

Dans l'onglet **Ressources**, vous avez la possibilité de définir quelles ressources seront accessibles avec ce type de contrat. Il peut s'agir d'espaces de travail, de salles de réunion, ou d'équipements spécifiques.

::callout
Cette fonctionnalité permet de fournir un accès illimité aux ressources que vous choisissez de rendre disponibles.
::

![Cette image permet de visualiser l'onglet facturation dans les ressources réservables.](https://doc.dokos.io/onglet-facturation.png)

### 2.3. Configurer les articles de facturation

Dans cette section, vous allez spécifier les différents articles qui seront facturés.

- **Article de facturation récurrente** : Sélectionnez l'article qui sera facturé de manière récurrente pour le quel vous faites ce contrat.
- **Article de facturation à la signature** : Ce champ permet de spécifier un article qui sera facturé uniquement au moment de la signature du contrat, tel que des frais d'activation ou des frais administratifs.
- **Récurrence de facturation** : Indiquez la fréquence à laquelle la facturation récurrente sera appliquée (mensuelle, trimestrielle, annuelle).
- **Montant du dépôt de garantie** : Spécifiez ici le montant du dépôt de garantie à verser à la signature du contrat, si applicable. Ce dépôt peut servir à couvrir les frais en cas de dommages aux ressources ou de non-respect des conditions du contrat.

![Cette image permet de visualiser l'onglet format d'impression.](https://doc.dokos.io/format-d-impression-contrat-de-reservation.png)

### 2.4. Paramètres d'impression

Rendez-vous sur la page : format d'impression pour configurer vos formats.

![Cette image permet de visualiser l'onglet Avenants.](https://doc.dokos.io/avenant-contrat.png)

### 2.5. Avenants

**Exemples de cas d’utilisation des avenants**

- **Modification des conditions de réservation** : Si un client souhaite ajouter ou modifier des ressources, l’avenant peut inclure ces changements, tout en conservant le contrat initial.
- **Changement des tarifs** : En cas de modification des prix après la signature du contrat, un avenant peut être ajouté pour stipuler la nouvelle tarification.
- **Extension de la durée de réservation** : Vous pouvez utiliser un avenant pour prolonger une période de réservation initiale sans devoir rédiger un nouveau contrat.

## 3. Flux

1. Génération et signature du contrat
2. Création d’une commande récurrente
3. Génération d’un abonnement
4. Génération des factures

## 4. Dépôt de garantie

::tour{demo="Mappemonde" doctype="booking-deposit"}
Créer un dépôt de garantie dans la démo
::

Le versement s'effectue lors du règlement de la première facture.

![Cette image permet de visualiser le formulaire de dépôt de garantie.](https://doc.dokos.io/formulaire-depot-de-garantie-rembourse.png)

Le bouton "Actions" permet d'enregistrer le paiement et de procéder ensuite au remboursement.

## 5. Contrat

::tour{demo="Mappemonde" doctype="booking-contract"}
Créer un contrat dans la démo
::

**Si vous souhaitez créer un abonnement lié à un contrat, il est nécessaire de générer le contrat, qui à son tour générera l'abonnement.**

![Cette image permet de visualiser le formulaire pour générer un contrat](https://doc.dokos.io/contrat.png)![Cette image permet de visualiser comment envoyer ou valider le contrat](https://doc.dokos.io/signer-contrat.png)

Une fois le formulaire configuré, vous pouvez l'envoyer par mail au client pour signature ou bien le valider, ce qui vaudra comme signature.

### 5.1. Mail reçu par le client

Voici l'e-mail reçu par le client pour demander sa signature, une fois le contrat établi depuis le bureau.

![Cette image permet de visualiser l'e-mail reçu par le client.](https://doc.dokos.io/mail-type.png)

## 6. Abonnement

Dans la section "Termes et conditions", vous pouvez vérifier que votre abonnement est bien associé à un contrat.

![Cette image permet de visualiser le contrat lié à l'abonnement.](https://doc.dokos.io/abonnement.png)

Pour plus d'informations sur les abonnements, rendez-vous sur la page [**Abonnements**](https://doc.dokos.io/v5/dokos/ventes/abonnements) de notre documentation.


# Crédits de réservation

## Crédits de réservation

Les crédits de réservation sont des unités de valeur prépayées que les utilisateurs peuvent utiliser pour effectuer des réservations au sein de l'entreprise. Ils sont particulièrement utiles pour les tiers-lieux, comme les espaces de coworking, où les membres peuvent acheter des crédits et les utiliser pour réserver des espaces ou des services.

Cette fonctionnalité a été pensée pour permettre les achats d'heures de location de salles et/ou d'espace de coworking et le décompte de ces heures a posteriori.

**Avantages des crédits de réservation**

- Flexibilité : Permet aux utilisateurs de réserver des services selon leurs besoins sans devoir payer à chaque fois.
- Simplicité : Facilite la gestion des réservations et des paiements, tant pour les utilisateurs que pour les gestionnaires du lieu.
- Fidélisation : Encourage les utilisateurs à revenir et à utiliser les crédits déjà achetés, créant ainsi une relation continue avec le tiers-lieu.

## Principes de fonctionnement

**Achat et attribution de crédits :**

- Achat de crédits : Les utilisateurs peuvent acheter des crédits de réservation via le site e-commerce.
- Attribution de crédits : Les administrateurs peuvent attribuer des crédits aux utilisateurs en fonction de leur abonnement, de leur adhésion ou d'autres critères définis.

**Utilisation des crédits :**

- Les utilisateurs peuvent utiliser leurs crédits pour réserver des services, des espaces (comme des salles de réunion), des équipements, ou tout autre type de ressource réservable.
- Lors de la réservation, le système déduit automatiquement les crédits nécessaires du compte de l'utilisateur.
- Utilisation des crédits via le site e-commerce : Lorsqu'un utilisateur souhaite réserver un service (par exemple, une salle de réunion ou un espace de travail), il peut utiliser les crédits disponibles sur son compte. Une fenêtre s'ouvre lors de l'ajout d'un service au panier, proposant d'utiliser les crédits pour le paiement.

**Gestion des crédits :**

- Suivi des crédits : Dokos permet de suivre le solde de crédits des utilisateurs.
- Expiration des crédits : Il est recommandé de définir une date d’expiration pour les crédits afin de gérer les réservations de manière efficace et encourager leur utilisation dans un délai raisonnable.

> Exemple pratique :

Supposons qu'un utilisateur ait acheté 4 tickets de coworking pour une demi-journée chacun. S'il souhaite réserver une journée complète, deux tickets seront automatiquement déduits de son compte.

## Prérequis

- [Créer un article](https://doc.dokos.io/v5/dokos/parametrage/articles)

## Les types de crédit de réservation

::tour{demo="Mappemonde" doctype="Booking Credit Type"}
Créer un type de crédit de réservation dans la démo
::

::callout{icon="i-heroicons-light-bulb"}
Laissez-vous guider par le parcours du document.
::

![Cette image permet de visualiser le formulaire : Type de crédits de réservation.](https://doc.dokos.io/type-de-credits-de-reservation.png)

Crédits achetés seuls :

- Description: Les utilisateurs peuvent acheter un certain nombre de crédits à l'avance qu'ils pourront utiliser pour réserver des services ou des produits ultérieurement.
- Exemple: Un utilisateur achète 10 crédits à l'avance pour réserver des salles de réunion ou des équipements.
- (2) Article associé : Un article de type ticket.

Crédits basés sur l'abonnement :

- Description: Les crédits sont accordés de manière périodique (mensuelle, annuelle, etc.) en fonction de l'abonnement de l'utilisateur. (Récurrence)
- Exemple: Un utilisateur ayant un abonnement mensuel reçoit 20 crédits chaque mois pour réserver des espaces de travail ou des activités.
- (2) Article associé : Un article de type abonnement.

Les types de crédits de réservation permettent de définir les règles de conversion et d'utilisation des crédits associés à des articles et des unités de mesure spécifiques. Cela facilite la transformation des lignes de facturation en crédits de réservation utilisables pour des services ou des produits futurs.

**Règles de conversion**

Les règles de conversion permettent de transformer un article facturé en crédits de réservation et vice-versa. Par exemple, un article vendu en heures de coworking peut être converti en crédits de réservation équivalents en fonction des règles définies.

**Couples article/Unité de mesure**

- Transformation en crédits de réservation

(4) Indique le nombre de crédits alloués pour chaque achat de l'article.

Le couple article/Unité de mesure permet au système de convertir automatiquement les lignes de facturation en crédits de réservation. Par exemple, la vente de 10 heures de coworking peut être transformée en 10 crédits de réservation d'une heure chacun.

- Conversion de réservation en crédits déductibles

![Cette image permet de visualiser la zone de conversion des crédits de réservation.](https://doc.dokos.io/type-de-credits-de-reservation-conversions.png)

En miroir, le système utilise un tableau de conversion pour convertir une réservation en crédits déductibles.
Par exemple, si une réservation d'une journée entière de coworking est effectuée, elle peut être convertie en un nombre spécifique de crédits basés sur les règles définies (par exemple, 8 crédits pour une journée complète).

**Utilisation**

- Crédits achetables séparément : Les utilisateurs peuvent acheter des crédits directement sans passer par une réservation spécifique, ce qui leur permet de les utiliser ultérieurement selon leurs besoins.
- Automatique : Lorsqu'un utilisateur fait une réservation, le système déduit automatiquement les crédits nécessaires de son solde en fonction des règles définies.

#### Exemple 1

Mappemonde vend des **Ticket coworking** utilisables dans son **Espace de coworking**

| Vente                                                                          | Conversion                                                           |
| ------------------------------------------------------------------------------ | -------------------------------------------------------------------- |
| Article:\_Ticket coworking demi-journée\_é de mesure: \_Demi-journée\_édits: 1 | Article:\_Espace de coworking\_é de mesure: \_Demi-journée\_édits: 1 |
| Article:\_Ticket coworking journée\_é de mesure: \_Jour\_édits: 1              | Article:\_Espace de coworking\_é de mesure: \_Jour\_édits: 1         |

#### Exemple 2

Mappemonde vend des lots de **10 Tickets coworking** utilisables dans son **Espace de coworking**

| Vente                                                                        | Conversion                                                           |
| ---------------------------------------------------------------------------- | -------------------------------------------------------------------- |
| Article:\_10 Tickets coworking demi-journée\_é de mesure: \_Unité\_édits: 10 | Article:\_Espace de coworking\_é de mesure: \_Journée\_édits: 2      |
|                                                                              | Article:\_Espace de coworking\_é de mesure: \_Demi-journée\_édits: 1 |

## Crédits de réservation / Addition de crédits de réservation

::tour{demo="Mappemonde" doctype="Booking Credit"}
Voir les additions de crédit de réservation dans la démo
::

Les crédits de réservation peuvent être ajoutés de trois manières différentes:

1. Manuellement
2. Automatiquement à chaque validation de facture de vente
3. Automatiquement via un abonnement

### Ajout manuel de crédits de réservation

![Cette image permet de visualiser un ajout d'un crédit de réservation.](https://doc.dokos.io/addition-de-credit-de-reservation.png)

Vous pouvez ajouter des crédits de réservation manuellement en renseignant les informations suivantes:

- Date: Date de début de validité des crédits
- Date d'expiration: Si vous ne renseignez rien, la date sera calculée en fonction de la durée prévue dans le type de crédit de réservation sélectionné
  Si vide, les crédits n'auront pas de date d'expiration
- Client: Le client auquel ces crédits seront alloués
- Utilisateur: Si renseigné, les crédits ne seront utilisables que par cet utilisateur
- Type de crédits de réservation: Le type de crédit alloué
- Quantité achetée: La quantité achetée et allouée au client

### Ajout automatique à la validation de la facture de vente

Lors de la validation d'une facture, le logiciel vérifie si le couple Article/Unité de mesure présent dans chaque ligne de facturation donne droit à une allocation de crédits de réservation. Si une correspondance est trouvée, le nombre de crédits alloués correspondra à la quantité définie dans la ligne de facturation multipliée par le nombre de crédits indiqué dans le type de crédits de réservation correspondant.

### Ajout automatique via un abonnement

Dans les abonnements, dans la section **crédit de réservation**, il est possible de définir des règles d'allocation de crédits. Vous pouvez ajouter des lignes pour chaque type de crédits de réservations que vous souhaitez allouer. Indiquez une quantité ainsi qu'une règle de récurrence. Dokos allouera les crédits selon cette règle.

![Cette image permet de visualiser le formulaire abonnement avec la section crédit de réservation.](https://doc.dokos.io/abonnement-credit.png)

##### Exemples

1. Chaque abonné mensuel peut bénéficier de 4 heures de réservation de salle de réunion gratuite par semaine pendant toute la durée de son abonnement.

| Type de crédits de réservation    | Quantité | Récurrence     | Expiration |
| --------------------------------- | -------- | -------------- | ---------- |
| Ticket salle de réunion à l'heure | 4        | Chaque Semaine | 7          |

👉 Chaque semaine 4 unités de Ticket salle de réunion à l'heure sont alloués au client. Ces tickets expirent 7 jours plus tard, donc à la fin de la semaine.

2. Chaque abonné mensuel peut bénéficier de 10 heures de réservation de salle de réunion gratuite à utiliser pendant son mois d'abonnement.

| Type de crédits de réservation    | Quantité | Récurrence                                  | Expiration |
| --------------------------------- | -------- | ------------------------------------------- | ---------- |
| Ticket salle de réunion à l'heure | 10       | Chaque Mois/A chaque période de facturation | 30         |

👉 Chaque mois (ou à chaque début de nouvelle période de facturation) 10 unités de Ticket salle de réunion à l'heure sont alloués au client. Ces tickets expirent 30 jours plus tard.

## Utilisations de crédit de réservation / Déduction de crédits

::tour{demo="Mappemonde" doctype="Booking Credit Usage"}
Voir les déductions de crédit de réservation dans la démo
::

La déduction de crédits peut se faire:

- Manuellement
- Via une réservation d'articles

##### Déduction manuelle

Pour déduire des crédits de réservation manuellement sélectionnez:

- L'utilisateur qui a utilisé des crédits (Optionnel)
- Le client auquel déduire les crédits
- Le type de crédits de réservation à déduire
- La quantité à déduire

##### Déduction automatique via une réservation d'articles

Lors de la création d'une réservation d'articles via le portail utilisateur (ou site E Commerce), la case **Déduire des crédits de réservation** est cochée lorsque les utilisateurs décident d'utiliser leurs crédits de réservation. Cela déclenche la création automatique d'une déduction de crédits de réservation pour le couple Article/Unité de mesure sélectionnés.

### Solde de crédits de réservation

::tour{demo="Mappemonde" doctype="Booking%20Credits%20Balance"}
Rapport du solde des crédits de réservation
::

1. **Suivi des crédits** :

- Permet de suivre combien de crédits de réservation chaque utilisateur a, combien ont été utilisés et combien restent.

2. **Gestion des utilisations** :

- Les administrateurs peuvent voir les utilisations des crédits de réservation pour mieux comprendre les tendances de réservation et optimiser la gestion des ressources.

3. **Accès basé sur les rôles** :

- Le système permet de définir des rôles spécifiques pour accéder et gérer les rapports de solde de crédits de réservation. Cela assure que seuls les utilisateurs autorisés peuvent consulter ou modifier ces informations.
  4

## Type d'expiration des crédits de réservation

Par défaut, les crédits sont utilisables jusqu'à leur date d'expiration incluse. Cela veut dire qu'il est possible de réserver une salle après l'expiration des crédits, pourvu que l'achat soit effectué pendant la période de validité des crédits. Pour empêcher que les crédits soient utilisés pour des réservations en dehors de leur période de validité, il est possible d'activer la case **Les crédits doivent être valides à la date de début de la réservation** dans les **Paramètres du lieu**.


# Événements

::tour{demo="Mappemonde" doctype="Event"}
Découvrir les événements dans la démo
::

## 1. Créer l'événement

![Image permettant de visualiser le formulaire pour la création d'un nouvel événement.](https://doc.dokos.io/evenement-nouveau-formulaire.png)

### 1. Détails

- Ajoutez le **Sujet**
- Définissez une **Catégorie d'événement** : L'événement peut être une réunion, un événement, un appel, l'envoi d'un email, autre.
- Sélectionnez un **Type d'événement** : Il peut être public ou privé. Si l'événement est public, l'onglet "Site web" apparait.
- Indiquez **Commence le** : Indiquez la date de début
- Indiquez **Termine le** : Indiquez la date de fin
- Pour voir le **Statut** : Visualiser le statut de votre événement
- **Toute la journée** : Cochez la case si votre événement dure toute la journée.
- **Répéter cet événement** : Cochez la case pour répéter cet événement. Une fenêtre s'ouvrira et vous allez pouvoir indiquer la fréquence, répété jusqu'au, intervalle de fréquence.
- **Synchroniser avec Google Agenda** : Cochez la case pour synchroniser l'événement sur Google Agenda.

### 2. Site web

![Cette image permet de visualiser l'onglet site web.](https://doc.dokos.io/evenement-site-web.png)

- **Publié** : Cochez cette case pour rendre l'événement visible sur le site web. Cela rendra l'événement accessible au public ou aux utilisateurs désignés en fonction des paramètres de visibilité.
- **Visible pour** :


  - **Tous** : L'événement sera visible par tous les visiteurs du site web, qu'ils soient connectés ou non.
  - **Rôle** : Limitez la visibilité de l'événement aux utilisateurs connectés avec un rôle spécifique. Par exemple, seuls les administrateurs ou un groupe particulier d'utilisateurs pourront voir l'événement.
- **Autoriser les inscriptions** : Activez cette option pour permettre aux participants de s'inscrire en ligne pour l'événement.
- **Autoriser inscriptions multiples** : Permet aux utilisateurs de s'inscrire pour plusieurs places à partir d'un seul compte utilisateur/adresse email.
- **Autoriser les annulations** : Cochez cette case pour permettre aux participants d'annuler leur inscription.
- **Fermer les inscriptions avant l'événement** : Cochez cette case pour activer la fermeture automatique des inscriptions avant le début de l'événement. Vous pouvez définir le délai dans les **Paramètres de Réservation**.
- **Formulaire d'inscription** : Sélectionnez le formulaire web que les participants utiliseront pour s'inscrire à l'événement. Ce formulaire peut être personnalisé pour collecter des informations spécifiques nécessaires à l'événement.

> **Le formulaire web permet d'activer la collecte d'un paiement à la validation du formulaire par l'utilisateur.**

### 3. Participants et références

![Cette image permet de visualiser l'onglet : participants et références.](https://doc.dokos.io/evenement-participants.png)

#### **Participants**

Dans cette section, vous avez la possibilité d'indiquer les participants qui seront présents pour l'événement. La liste de participants peut inclure des personnes s'étant inscrites via le portail en ligne ou des personnes que vous ajoutez manuellement, comme des intervenants. Si les participants s'inscrivent en ligne, un document *Inscription à l'événement* sera automatiquement généré et accessible depuis la liste de *Liens* de l'événement.

#### **Référence de l'événement**

**Fonctionnalité**

- **Type de document de référence** : Cette colonne vous permet de sélectionner le type de document dans Dokos que vous souhaitez associer à l'événement. Par exemple, cela pourrait être une tâche, un projet, une commande de vente, etc.
- **Nom de la référence** : Une fois le type de document de référence choisi, cette colonne vous permet de spécifier le nom ou l'identifiant précis du document à lier. Cela établit un lien direct entre l'événement et ce document spécifique.

**Utilisation**

- **Suivi des liens** : En associant des documents à un événement, vous pouvez facilement accéder aux informations pertinentes sans avoir à naviguer manuellement dans différents modules.
- **Contexte et coordination** : Cela permet de fournir un contexte supplémentaire à l'événement. Par exemple, si une réunion est organisée pour discuter d'un projet particulier, lier ce projet à l'événement aide à centraliser les informations et à améliorer la coordination.
- **Gestion intégrée** : La gestion des événements devient plus intégrée avec les autres processus de l'entreprise, permettant une meilleure traçabilité et une gestion plus cohérente.

Exemple :

**Réunion de Projet** :

- **Type de document de référence** : Projet
- **Nom de la référence** : Projet 258-A

Cela signifie que la réunion est directement liée au projet "Projet 258-A", facilitant l'accès rapide aux détails du projet pendant la réunion.

::callout{color="teal" icon="i-heroicons-light-bulb"}
Dokos propose un certain nombre de champs *par défaut* dans la fiche Événement. Vous êtes libre de cacher ceux que vous ne souhaitez pas utiliser (ex. Synchronisation Google Agenda) et d'ajouter de nouveaux champs (ex. Besoin d'équipe technique/sécurité/ménage...)
::

## 2. Inscription à un événement

Lorsque vous créez un événement public, vous pouvez permettre les inscriptions en ligne. Chaque inscription générera un document *Inscription à un événement* contenant les coordonnées de la personne qui s'est inscrite ainsi que le statut de son inscription (Confirmée / Annulée).
Vous pouvez créer une inscription manuellement depuis le bureau de Dokos si vous ne souhaitez pas permettre les inscriptions en ligne.

::tour{demo="Mappemonde" doctype="Event Registration"}
Voir des inscriptions aux événements dans la démo
::

### Permettre les inscriptions en ligne

Si le type d'événement de votre événement est **Public**, une section **Site web** apparaît en haut. Commencez par **Publier** votre événement pour le rendre visible sur le site web.
Vous avez la possibilité de définir différentes options de visibilité:

- *Tous*: Votre événement est visible à tous, utilisateurs connectés comme utilisateurs invités. Tout le monde peut y accéder depuis Internet.
- *Rôle*: Votre événement est visible uniquement aux utilisateurs connectés ayant le rôle que vous avez choisi. Cette option est pratique pour publier des événements réservés à vos utilisateurs/clients.

### Personnaliser le formulaire d'inscription

Sans personnalisations, le formulaire d'inscription demande les informations suivantes:

- Nom
- Prénom
- Adresse email
- Numéro de mobile

Dans un certain nombre de cas, vous voudrez collecter des informations additionnelles ou même un paiement une fois le formulaire rempli. Il faut alors utiliser un formulaire web.

#### Utilisation d'un formulaire web

Un formulaire web est une version publique d'un formulaire (Type de document) de Dokos. Il reprend les champs de son document référence, mais peut être personnalisé pour n'afficher que quelques champs publiquement.

Il faut donc que nous utilisions un formulaire associé au type de document **Inscription à un événement** pour qu'une fois rempli en ligne, une **Inscription à un événement** soit automatiquement créée.

::demo-link{demo="Mappemonde" path="/app/web-form/event-registration-form"}
Un formulaire *event-registration-form* existe déjà dans Dokos. Vous pouvez l'utiliser en l'état ou le dupliquer pour le personnaliser.
::

![Cette image permet de visualiser le formulaire web pour la réservation en ligne.](https://doc.dokos.io/evenement-formulaire-site-web.png)

Dans ce formulaire web, vous pouvez ajouter des champs provenant de votre document de référence (via le bouton *Obtenir des champs*) et éventuellement autoriser les paiements.

::callout
Avant d'ajouter de nouveaux champs dans un formulaire web, il faut commencer par les ajouter dans le document de référence via l'outil *Personnaliser le formulaire*
::

Une fois votre formulaire configuré, publiez-le pour l'activer.

### Configurer la fermeture automatique des inscriptions

Pour éviter les inscriptions de dernière minute, vous pouvez configurer une fermeture automatique des inscriptions avant le début de l'événement. Cette fonctionnalité est particulièrement utile pour les événements nécessitant une logistique spécifique (ex. : ateliers, formations, conférences).

#### Étapes de configuration

1. **Accéder aux Paramètres de Réservation** : Allez dans **Administration > Modules > Réservations > Paramètres de Réservation**.
2. **Configurer le délai de fermeture** : Dans l'onglet **Événements**, définissez le champ &#x2A;*Fermer les inscriptions (heures avant l'événement)**. Par défaut, ce délai est fixé à **24 heures**. :br![Paramètres de Réservation - Fermeture des inscriptions](https://doc.dokos.io/parametres-reservation-fermeture-inscriptions.png)
3. **Activer la fermeture automatique** : Dans la fiche de votre événement, cochez la case **Fermer les inscriptions avant l'événement** pour activer cette fonctionnalité.

> **Remarque** : Si le délai configuré dans les paramètres est dépassé, les inscriptions seront automatiquement fermées, même si la case n'est pas cochée dans la fiche de l'événement.

### Collecter un paiement lors de la réservation

Le formulaire web permet d'activer la collecte d'un paiement à la validation du formulaire par l'utilisateur.

Dans l'onglet *Paiements*, choisissez d'activer les paiements puis sélectionnez les options correspondantes à votre usage:

- Vous pouvez récupérer le montant depuis un champ *Montant de l'inscription* présent dans la fiche de l'événement.
  Cela vous permet d'utiliser le même formulaire web pour tous vos événements, même si le montant associé à chaque événement est différent.
- Le type de paiement sera probablement *Paiement immédiat* dans la majorité des cas : les inscrits paieront uniquement leur inscription et leurs coordonnées de paiement n'ont pas besoin d'être enregistrées par la plateforme de paiement pour un paiement ultérieur.
  Il se peut cependant que certains événements ouvrent des droits supplémentaires qui nécessitent des paiements ultérieurs.
  Dans ce cas, l'option *Paiement initial suivi de paiements automatiques* peut être adaptée.

![Cette image permet de visualiser la zone pour permettre de configurer les paiements.](https://doc.dokos.io/evenement-formulaire-inscription.png)![Cette image permet de visualiser le formulaire site web pour définir les paiement sur le site.](https://doc.dokos.io/evenement-formulaire-site-web.png)

## Flux d'inscription

Voici un exemple de flux d'inscription à un événement, avec paiement.

::demo-link{demo="Mappemonde" path="/app/web-form/event-registration-form"}
Cet exemple utilise le formulaire web *event-registration-form*
::

![Flux d'inscription](https://doc.dokos.io/content/lieu/event/event_registration.gif)

## Liaison automatique aux fiches contact :badge{text="Dokos" type="warning"}

> **Exemple — Association Les Tilleuls**
> Les Tilleuls organisent un atelier de jardinage. Trois contacts existants s'inscrivent via le portail. Dokos crée automatiquement une communication sur chacune de leurs fiches contact, retraçant leur participation à l'événement. Un mois plus tard, en consultant la fiche d'un participant, l'équipe retrouve l'atelier directement dans son historique de communications — et sur la fiche de l'entreprise associée à ce contact.

Quand un participant à un événement correspond à un contact existant dans Dokos — que ce soit via une inscription en ligne ou une saisie manuelle —, Dokos crée automatiquement une communication liée à cet événement sur la fiche du contact. Cette communication est visible dans la chronologie du contact, aux côtés des emails, appels et autres interactions. Elle fonctionne pour toutes les catégories d'événements (réunion, appel, événement, etc.).

Si le contact est associé à un client ou une autre fiche, la communication apparaît également dans la chronologie de cette fiche. La relation est ainsi tracée à tous les niveaux sans saisie supplémentaire.

L'inscription à l'événement reste également accessible via un lien en haut de la fiche contact, dans la section des documents liés.

Les participants peuvent être ajoutés manuellement dans l'onglet **Participants et références** ou importés automatiquement depuis les inscriptions reçues en ligne.

::demo-link{demo="Tierslieux" path="/desk/event/EV00010"}
Voir un événement avec des participants dans la démo
::

## Fermeture automatique des inscriptions

Pour améliorer la gestion des événements, Dokos propose une fonctionnalité de fermeture automatique des inscriptions avant le début de l'événement. Cette option est particulièrement utile pour les événements nécessitant une logistique spécifique ou une préparation en amont.

### Fonctionnement

- **Délai configurable** : Vous pouvez définir un délai (en heures) avant le début de l'événement pendant lequel les inscriptions seront automatiquement fermées. Par défaut, ce délai est fixé à **24 heures**.
- **Activation automatique** : Une fois le délai atteint, les inscriptions sont fermées sans intervention manuelle.
- **Notification aux utilisateurs** : Les visiteurs du site web verront un message indiquant que les inscriptions sont fermées.

### Exemple d'utilisation

> **Exemple — Formation en présentiel**
> L'association **Les Tilleuls** organise une formation sur la permaculture le 15 juin 2025. Pour garantir une bonne organisation, ils configurent un délai de fermeture des inscriptions à **48 heures** avant le début de la formation. Ainsi, les participants ne peuvent plus s'inscrire après le 13 juin à 9h00, ce qui laisse suffisamment de temps à l'équipe pour préparer les supports et les espaces.

### Flux de fermeture automatique

::mermaid
sequenceDiagram
participant Utilisateur
participant SiteWeb
participant Dokos


```text
Utilisateur->>SiteWeb: Tente de s'inscrire à un événement
SiteWeb->>Dokos: Vérifie si les inscriptions sont ouvertes
Dokos->>Dokos: Compare la date actuelle avec (date de début - délai)
alt Délai dépassé
    Dokos-->>SiteWeb: Inscriptions fermées
    SiteWeb-->>Utilisateur: Affiche un message "Les inscriptions sont fermées"
else Délai non dépassé
    Dokos-->>SiteWeb: Inscriptions ouvertes
    SiteWeb-->>Utilisateur: Affiche le formulaire d'inscription
end
```
::

## Attribution automatique de badges à la présence :badge{text="Dokos" type="warning"}

Un événement peut être configuré pour attribuer automatiquement un badge aux participants marqués présents. C'est particulièrement utile pour les **formations en présentiel** qui conditionnent l'accès à une ressource réservable (imprimante 3D, laser, etc.).

### Configurer l'attribution de badge

Dans la fiche de l'événement, renseignez le champ **Type de badge attribué** avec le type de badge que les participants présents recevront. Ce champ peut également être pré-rempli automatiquement si vous créez l'événement depuis la fiche du type de badge (bouton **Créer un événement attribuant ce badge**).

### Marquer la présence d'un participant

Depuis la fiche **Inscription à l'événement**, utilisez l'action **Marquer la présence**. Une boîte de dialogue de confirmation s'affiche, indiquant le badge qui sera attribué. Confirmez pour valider la présence et déclencher l'attribution du badge.

> Le champ « Présent » sur l'inscription est en lecture seule et ne peut être modifié que via cette action — jamais manuellement.

### Marquer la présence en lot

Depuis la fiche de l'**Événement**, l'action **Marquer la présence** ouvre un dialogue de sélection multiple. Sélectionnez tous les participants présents et confirmez : les badges sont attribués à tous en une seule opération.

> **Garde-fou** : Il n'est pas possible de marquer la présence pour un événement qui n'a pas encore commencé. Cette vérification est effectuée automatiquement par le système.

### Flux complet

::mermaid
sequenceDiagram
participant Formateur
participant Dokos
participant Membre


```text
Formateur->>Dokos: Ouvre la fiche de l'événement de formation
Formateur->>Dokos: Action "Marquer la présence" (individuelle ou en lot)
Dokos->>Dokos: Vérifie que l'événement a commencé
Dokos->>Dokos: Crée le badge pour chaque participant confirmé
Dokos-->>Membre: Badge attribué automatiquement
Membre->>Dokos: Consulte "Mes badges" sur /account
Membre->>Dokos: Peut désormais réserver la ressource protégée
```
::

Pour en savoir plus sur la configuration des types de badges et la liaison avec les ressources réservables, consultez la [documentation des badges](https://doc.dokos.io/v5/dokos/lieu/badges).


# Poste d'événement

## 1. Poste d'événement

![Cette image permet de visualiser le formulaire poste d'événement.](https://doc.dokos.io/poste-d-evenement.png)

### 1.1. Remplir les champs

- Événement :

Ce champ permet de sélectionner l'événement auquel ce poste est lié.

- Titre du poste :

Il s'agit du nom ou titre de ce poste spécifique. Cela pourrait être une description courte ou un nom unique qui identifie ce poste dans le cadre de l'événement. Par exemple, "Responsables de l'accueil" ou "Conférenciers".

- Postes disponibles :

Ce champ indique le nombre de postes disponibles pour cet événement. Si par exemple, il y a plusieurs personnes qui peuvent occuper ce même poste à la même heure (comme plusieurs hôtes pour l'accueil), vous pouvez indiquer ce nombre ici.

- Description :

Ce champ permet de saisir des détails supplémentaires concernant ce poste d'événement. Vous pouvez y inclure les responsabilités spécifiques, les tâches à accomplir, ou toute autre information pertinente.

## 2. Inscription à un poste d'événement

![Cette image permet de visualiser le formulaire d'inscription à un événement.](https://doc.dokos.io/inscription-poste-evenement.png)

### 2.1. Inscription depuis le bureau

- Sélectionnez le poste d'événement :

Choisissez le rôle ou la tâche spécifique que vous souhaitez assigner.

- Sélectionnez l'utilisateur :

Choisissez la personne qui sera responsable de ce poste.

### 2.2. Inscription depuis le portail

### 2.3. Voir les inscriptions sur le bureau


# Badges

👉 Les badges requis dans Dokos pour les ressources réservables permettent de s'assurer que seules les personnes qualifiées ou autorisées peuvent accéder à certaines ressources.

Avantages des badges requis

Sécurité et conformité :

- Sécurité : Les badges requis peuvent garantir que seules les personnes formées ou autorisées ont accès à certaines machines ou équipements, réduisant ainsi les risques d'accidents.

Efficacité et productivité :

- Utilisation optimisée : En limitant l'accès aux utilisateurs qualifiés, on s'assure que les ressources sont utilisées efficacement et correctement.

Motivation et engagement :

- Reconnaissance : Ils servent également de reconnaissance des compétences et des accomplissements des utilisateurs.

## 1. Type de badge de réservation de ressources

::tour{demo="Mappemonde" doctype="booking-badge-type"}
Créer un badges dans la démo
::

Les types de badges permettent d'associer une image et un libellé qu'on pourra ensuite attribuer sous forme de badge à un utilisateur.

Quelques exemples de types de badges:

- Adhérent
- Niveau 1 / Niveau 2 / Niveau X

> Une fois que vous avez attribué un nom à votre type de badge, pensez à lui associer une image en cliquant sur le carré d'image à gauche.
> Cette image permettra de créer le *badge* visible sur vos ressources.

![Cette image permet de visualiser plusieurs exemples de badges requis.](https://doc.dokos.io/type-de-badges-de-reservation.png)

### Durée de validité par défaut

Chaque type de badge peut être configuré avec une **durée de validité par défaut** (en jours). Lorsqu'un badge est attribué — quelle que soit la voie d'attribution (manuelle, cours LMS ou présence à un événement) — la date d'expiration est automatiquement calculée à partir de cette durée si aucune date explicite n'est fournie.

> **Exemple — FabLab Les Outils Libres**
> Le badge « Fraiseuse CNC Niveau 1 » a une durée de validité de 365 jours. Lorsqu'un membre obtient ce badge après une formation, sa date d'expiration est automatiquement fixée à un an à partir du jour de l'attribution.

### Voies d'attribution automatique

Un type de badge peut être obtenu automatiquement de deux façons, sans aucune saisie manuelle :

| Voie                        | Déclencheur                  | Prérequis                      |
| --------------------------- | ---------------------------- | ------------------------------ |
| **Cours LMS**               | Émission d'un certificat LMS | Application LMS installée      |
| **Présence à un événement** | Participant marqué présent   | Événement lié au type de badge |

Ces deux voies peuvent être combinées : un même badge peut s'obtenir aussi bien en suivant un cours en ligne qu'en assistant à une session en présentiel.

**Renouvellement automatique** : si un utilisateur possède déjà un badge du même type mais qu'il est expiré ou annulé, un nouveau badge actif est créé lors de la prochaine attribution. L'ancien badge est conservé dans l'historique.

#### Attribution via un cours LMS

Dans la section **LMS** du type de badge (visible uniquement si l'application LMS est installée), sélectionnez le cours LMS correspondant. Dès qu'un participant obtient son certificat à l'issue du cours, le badge lui est automatiquement attribué.

#### Attribution via la présence à un événement

Dans la section **Événements** du type de badge, vous pouvez voir la liste des événements liés et utiliser le bouton **Créer un événement attribuant ce badge** pour ouvrir directement un nouvel événement avec le lien vers ce type de badge pré-rempli.

Il est également possible de lier un événement existant en renseignant le champ **Type de badge attribué** directement dans la fiche de l'événement.

## 2. Badge de réservation de ressources

::tour{demo="Mappemonde" doctype="booking-badge"}
Attribuer un badges à un utilisateur dans la démo
::

Vous pouvez affecter des badges à vos utilisateurs en créant des **Badges de réservation de ressources**.

Ces badges peuvent être associés avec une date d'expiration.

![Cette image permet de visualiser l'attribution des badges.](https://doc.dokos.io/badges-de-reservation.png)

## 3. Association avec une ressource réservable

Une fois que vous avez défini vos types de badge, vous pouvez sélectionner les badges requis pour réserver une ressource dans chaque **Ressource réservable**.

Cela signifie que pour réserver cette ressource, votre utilisateur devra être associé avec ce badge.

Si un utilisateur souhaite réserver une ressource sur le site web sans avoir les badges requis, ou si ses badges ont expirés, un message lui indiquera quels sont les badges qu'il/elle doit acquérir afin de pouvoir effectuer une réservation.

![Cette image permet de visualiser la zone permettant de sélectionner les badges dans une ressource.](https://doc.dokos.io/badges-requis-dans-ressource.png)

## 4. Expérience utilisateur sur le portail

### Indicateurs visuels sur les ressources

Lorsqu'une ressource nécessite un ou plusieurs badges, les utilisateurs du portail voient :

- Un &#x2A;*indicateur « N badge(s) requis »** directement sur la carte de la ressource dans la liste des ressources disponibles.
- Un &#x2A;*bandeau orange « Cette ressource est protégée »** en haut de la page de la ressource — les descriptions, tarifs et horaires restent visibles pour que l'utilisateur sache ce qu'il vise.
- Des **pastilles inline** pour chaque badge requis :


  - 🟢 &#x2A;*Verte « Acquis »** : l'utilisateur possède déjà ce badge valide.
  - 🟠 &#x2A;*Orange « Requis »** : l'utilisateur ne possède pas encore ce badge.

### Comment obtenir un badge ?

En cliquant sur une pastille **Requis**, l'utilisateur accède à une fenêtre **Comment l'obtenir** qui liste :

- Le cours LMS associé au badge (si configuré).
- Les prochaines sessions d'événements de formation ouverts aux inscriptions.

Cela permet à l'utilisateur de s'inscrire directement à la formation qui lui permettra d'obtenir le badge et d'accéder à la ressource.

> **Astuce** : Pour que la fenêtre « Comment l'obtenir » affiche des sessions disponibles, pensez à créer des événements de formation **futurs** liés au type de badge. Les événements passés ne s'affichent pas dans cette liste.

### Section « Mes badges » dans le compte utilisateur

Une section **Mes badges** est disponible sur la page `/account` du portail. Elle liste :

- Les badges **actifs** avec leur date d'expiration.
- Les badges **expirés**.
- Un **avertissement** pour les badges dont l'expiration approche dans les 30 jours.

> Cette section est masquée automatiquement si aucun type de badge actif n'est configuré sur le site.

## 5. Marquer la présence à un événement

Lorsqu'un événement est configuré pour attribuer un badge, les gestionnaires peuvent marquer la présence des participants de deux façons :

### Présence individuelle

Depuis la fiche **Inscription à l'événement**, utilisez l'action **Marquer la présence**. Une boîte de dialogue de confirmation s'affiche, indiquant explicitement le badge qui sera attribué au participant. Confirmez pour valider la présence et déclencher l'attribution automatique du badge.

> Le champ « Présent » sur l'inscription est en lecture seule et ne peut être modifié que via cette action dédiée — jamais manuellement.

### Présence en lot

Depuis la fiche de l'**Événement**, utilisez l'action **Marquer la présence** pour ouvrir un dialogue de sélection multiple (roster). Sélectionnez tous les participants présents et confirmez. Les badges sont attribués à tous les participants sélectionnés en une seule opération.

> **Garde-fou** : L'action de marquage de présence n'est disponible que si l'événement a déjà commencé. Il n'est pas possible de marquer la présence pour un événement futur.

## 6. Exemple concret : MappeMonde FabLab

La démo MappeMonde illustre les trois voies d'attribution sur quatre badges et deux ressources protégées.

### Badges configurés dans la démo

| Badge                        | Voie d'attribution                                         |
| ---------------------------- | ---------------------------------------------------------- |
| *Bienvenue à MappeMonde*     | Présence à un événement uniquement                         |
| *Formation Imprimante 3D*    | Événement **ET** cours LMS (deux voies pour le même badge) |
| *Habilitation Fraiseuse CNC* | Présence à un événement uniquement                         |
| *Bonnes pratiques au fablab* | Cours LMS uniquement                                       |

### Ressources protégées

- **Imprimante 3D** — 1 badge requis (*Formation Imprimante 3D*). Ce badge peut être obtenu indifféremment via le cours LMS ou en assistant à une session de formation en présentiel.
- **Fraiseuse CNC** — 2 badges requis (*Habilitation Fraiseuse CNC* + *Bonnes pratiques au fablab*). Le second badge étant délivré uniquement via LMS, un membre doit obligatoirement suivre le cours en ligne pour accéder à cette machine.

::mermaid
flowchart TD
A\[Membre du portail] --> B{Possède les badges requis ?}
B -- Oui --> C\[Réservation possible]
B -- Non --> D\[Bandeau de protection affiché]
D --> E\[Fenêtre « Comment l'obtenir »]
E --> F\[Cours LMS disponible]
E --> G\[Prochaines sessions de formation]
F --> H\[Certificat obtenu → Badge attribué automatiquement]
G --> I\[Présence marquée → Badge attribué automatiquement]
H --> C
I --> C

::

::tour{demo="Mappemonde" doctype="booking-badge-type"}
Voir les types de badges dans la démo MappeMonde
::

## 7. Cas pratique

Un lieu dispose d'une imprimante 3D accessible uniquement aux utilisateurs ayant suivi une formation spécifique (Maîtrise niveau 1) et possédant une habilitation de sécurité.

### Étape 1 — Création des types de badges

Créer un type de badge « Maîtrise niveau 1 » avec une durée de validité de 365 jours.

Créer un type de badge « Habilitation de sécurité ».

### Étape 2 — Configuration de la ressource

Pour la ressource « Imprimante 3D », sélectionner les badges « Maîtrise niveau 1 » et « Habilitation de sécurité ».

### Étape 3 — Configuration des voies d'attribution

**Option A — Via un cours LMS :**
Dans le type de badge « Maîtrise niveau 1 », associez le cours LMS correspondant. Dès qu'un utilisateur obtient son certificat, le badge lui est attribué automatiquement.

**Option B — Via un événement de formation :**
Depuis le type de badge, cliquez sur **Créer un événement attribuant ce badge** pour planifier une session de formation en présentiel. À l'issue de la formation, marquez les participants présents depuis la fiche de l'événement ou depuis chaque inscription — les badges sont attribués automatiquement.

**Ces deux voies peuvent coexister** : un utilisateur peut obtenir le badge indifféremment en ligne ou en présentiel.

> **Conseil** : Créez toujours quelques sessions de formation **futures** en plus des sessions passées. Sans sessions futures, la fenêtre « Comment l'obtenir » ne proposera aucune inscription aux membres qui découvrent la ressource.

### Étape 4 — Expérience des membres

👉 Les membres qui accèdent à la fiche de l'imprimante 3D sur le portail voient le bandeau de protection et les badges requis. En cliquant sur « Comment l'obtenir », ils découvrent le cours LMS disponible et les prochaines sessions de formation.

👉 Une fois le badge obtenu, la pastille passe au vert et ils peuvent réserver un créneau sur l'imprimante 3D.

👉 Trente jours avant l'expiration de leur badge, un avertissement apparaît dans la section « Mes badges » de leur compte pour qu'ils anticipent le renouvellement.


# Abonnements et réservations limitées

Dans les précédentes versions de Dokos, les abonnements et les articles à réservation limitée étaient indépendants.
Le nombre de **réservations simultanées autorisées** n'était pas impacté par les abonnements.
Il était donc possible d'avoir plus d'abonnements actifs pour un article donné que ce nombre maximum de réservations simultanées.
Dans la version 3.20, ce comportement a été modifié.

À l'aide des abonnements à réservation automatique, vous n'avez plus besoin de manuellement modifier la valeur du nombre de **réservations simultanées autorisées** pour chaque article réservable dès qu'il y a un nouvel abonnement.

Dans cette section, vous allez apprendre à configurer vos abonnements (nouveaux et existants) pour qu'ils soient pris en compte dans le nombre de places disponibles d'un article réservable.

## Pré-requis de configuration

Tout d'abord, veillez bien à avoir activé les réservations simultanées dans les **Paramètres du lieu** :

- la case "Autoriser les réservations simultanées" est cochée

Un article réservable est un **Article** dont :

- la case "Autoriser la réservation d'articles" est cochée
- la valeur "Réservations simultanées autorisées" est bien définie

## Configurer vos modèles et plans d'abonnement

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Attention, modifier un **Modèle d'abonnement** n'impacte pas les **Abonnements** déjà créés.
::

Petit rappel : un **Abonnement** est un document créé à partir d'un **Modèle d'abonnement**.
Le modèle fait référence à un **Plan d'abonnement**, qui contient une table avec une liste d'articles : chaque ligne est un **Détail de plan d'abonnement**.
Quand un Abonnement est créé, les lignes du Plan sont copiées dans l'Abonnement lui-même.

::fig
  :::mermaid{style="align-self: stretch;"}
  ```text
  flowchart LR
  B(Modèle d'abonnement) -->|lié à| A(Plan d'abonnement)
  B -->|crée| C(Abonnement)
  A --> E("Détail de plan d'abonnement")
  E -->|"copié(s) dans"| C
  ```
  :::

#caption
Vue simplifiée de la relation entre les modèles, les plans et les abonnements.
::

Pour chaque ligne de plan d'abonnement, vous pouvez définir, entre autres :

- un article, c'est-à-dire l'article qui sera **facturé**
- une quantité et une unité de mesure
- un **article reservé**, celui dont le nombre de places restantes sera impacté par l'abonnement

Par défaut, le champ **Article reservé** est vide. Si ce champ est rempli, alors sur toute la période où un abonnement est **actif**, le nombre de places restantes de l'article reservé sera décrémenté de la quantité indiqué dans la ligne de détail du plan d'abonnement.

Tout fonctionne comme si une **Réservation d'article** était créée pour chaque instant où l'abonnement est actif, mais automatiquement.

::callout{color="teal" icon="i-heroicons-light-bulb"}
D'ailleurs, dans la vue Calendrier des Réservations d'article, **les Abonnements de réservation sont aussi affichés**.
::


# Gestion de lieux multiples

::callout{color="teal" icon="i-heroicons-light-bulb"}
Vous avez deux Tiers Lieux reposant sur **deux sociétés différentes** et vous
souhaitez proposer des réservations sur le même site web avec Dokos ? Alors le
mode Multi-Lieu est fait pour vous.
::

Avec le mode multi-société, pour que les visiteurs de votre site web puissent
accéder à la liste des produits (articles, réservations, coworking, etc.)
spécifique à chacun de vos lieux, il faut qu'un lieu ou qu'une société soit
sélectionnée.

Pour ce faire, vous pouvez par exemple proposer deux boutons sur votre page
d'accueil qui mèneront à deux listes de produits différentes, mais toutes deux
hébergées sur la même page du même site web, votre vitrine.

Par exemple, la page contenant la liste de tous les produits aura la même
apparence et les mêmes fonctionnalités pour chaque Lieu, et sera située à la
même URL sur le site web, mais les produits disponibles ne seront pas les mêmes
selon le lieu sélectionné.

Vous pouvez même placer des liens sur un site externe, comme un site
WooCommerce, pour rediriger les visiteurs vers votre site Dokos pour faire
leurs réservations de salles, achats, etc.

## Configuration

### Mettre en place ses sociétés

Avant toute chose, le mode multi-lieu (ou multi-société) nécessite de
configurer plusieurs Sociétés dans Dokos. De plus, il vous faudra aussi
correctement configurer les comptes pour toutes les sociétés que vous
souhaitez utiliser avec le mode multi-société.
Une attention particulière est nécessaire si vous utilisez plusieurs **devises**
et que des passerelles de paiement sont définies.

> [Voir la documentation liée à la création des Sociétés et de leurs comptes](https://doc.dokos.io/v5/dokos/parametrage/societe)

### Configurer les Paramètres de Lieu

> ::tour{demo="Mappemonde" doctype="Venue Settings"}
> Visite guidée des Paramètres de Lieu
> ::

1. Rendez-vous dans les Paramètres de Lieu, dans la section **Mode multi-lieu**
2. Activez le mode à l'aide de la case à cocher
3. Dans le tableau des **Sociétés autorisées**, ajouter une ligne pour chaque Société que vous souhaitez rendre disponible sur le site web.

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
À la suite de cette opération, tous les articles de site web seront **masqués**,
et les groupes d'article n'apparaîtront plus dans la barre de navigation.
::

#### Configurer un Article de site web

Ensuite, il faut configurer chaque article de site web pour définir pour quelle(s) société(s) il doit être affiché :

1. Rendez-vous dans la liste des **Articles du site web**
2. Sélectionner celui que vous souhaitez modifier
3. Cochez la case **Publié** si elle ne l'est pas déjà
4. Ajoutez les sociétés pour lesquelles l'article de site web doit être affiché
5. Enregistrez le document

#### Configurer un Groupe d'Article

De la même manière, si vous souhaitez afficher certains groupes d'article sur votre site web :

1. Rendez-vous dans le Groupe d'Article que vous souhaitez afficher
2. Cochez la case **Afficher sur le site web** si elle ne l'est pas déjà
3. Rendez-vous dans la section **Mode multi-lieu** qui apparaît en-dessous
4. Ajoutez les sociétés pour lesquelles le groupe d'article doit être affiché
5. Enregistrez le document

Vous pouvez vérifiez le fonctionnement du groupe d'article en cliquant sur le lien **Voir sur le site** dans la barre latérale, juste au-dessus de l'image du groupe d'article.
&#x2A;*Si le groupe d'article est vide sur le site web, c'est que vous n'avez pas déjà sélectionné de société.**
Consultez la section suivante pour découvrir comment sélectionner une société en tant que visiteur du site web.

Si, malgré cette dernière étape, le groupe d'article apparaît toujours vide,
alors les articles associés ne sont pas configurés comme décrit dans la section [Configurer un Article de site web](https://doc.dokos.io/#configurer-un-article-de-site-web).

## Sélectionner une société en tant que visiteur

Rendez-vous sur votre vitrine web, puis rendez-vous tout en bas de la page. Vous devriez y trouver une boîte de sélection intitulée **Sélectionner une société**.
Cliquez-la puis choisissez une société pour consulter les articles et groupes d'articles qui lui sont propres.

## Fonctionnement du panier en mode multi-société

Dans Dokos, un panier est une variante particulière d'un Devis.
En mode multi-société, chaque client va pouvoir constituer son panier sur la vitrine Dokos comme d'habitude,
mais son panier va être lié à la société sélectionnée.

En résumé, les paniers sont distincts pour chaque société.

## Redirection depuis un site externe (WooCommerce)

::callout{color="teal" icon="i-heroicons-light-bulb"}
Vous souhaitez rediriger les visiteurs de votre site WooCommerce vers votre instance Dokos
pour qu'ils et elles puissent réserver un créneau de coworking ou acheter un produit ?
C'est possible et facile avec le mode Multi-Lieu.
::

Concrètement, il suffit de rajouter un petit fragment de texte à la fin du lien vers lequel
vous souhaitez diriger vos visiteurs. Par exemple, au lieu de créer un lien vers
`https://MonTiersLieu.dokos.cloud/tous-les-produits` vous devrez indiquer
`https://MonTiersLieu.dokos.cloud/tous-les-produits?selected_company=LieuParis`

## Pour aller plus loin

Il est possible de définir le Lieu actuel de plusieurs manières :

- avec le paramètre `selected_company` dans l'URL, comme vu précédemment
- en définissant le cookie `company` du côté client
- pour les utilisateurs, en utilisant un ménu déroulant situé dans le pied de page


# Intégration avec Neop

Dokos permet une intégration avec la plateforme de gestion d'accès [Neop](https://www.neop.eu/){rel="&#x22;nofollow&#x22;"}.

::tabs
  :::tabs-item{icon="i-mdi-ev-plug-chademo" label="Fonctionnement"}
    ::::mermaid
    ```text
    graph TD
        A[Utilisateur] -->|Réserve une ressource| B[Système de réservation]
        B -->|Déclenche une réservation| C[Neop]
        C -->|Renvoie un code à 4 chiffres| D[Système de réservation]
        D -->|Stocke le code| E[Espace client]
        A -->|Consulte sa réservation| E
        E -->|Affiche le code à 4 chiffres| A
    ```
    ::::

  - **Utilisateur → Portail de réservation** : L'utilisateur commence le processus en réservant une ressource via le portail de réservation.
  - **Système de réservation → Neop** : Une fois la demande de réservation validée, le système de réservation déclenche une action dans le service Neop.
  - **Neop → Système de réservation** : Neop traite la demande et génère un code d'accès à 4 chiffres qu'il renvoie au système de réservation.
  - **Système de réservation → Espace client** : Le système de réservation stocke ce code à 4 chiffres dans l'espace client de l'utilisateur.
  - **Utilisateur → Portail client** : L'utilisateur consulte ensuite sa réservation en accédant à son espace client.
  - **Portail client → Utilisateur** : L'espace client affiche le code à 4 chiffres à l'utilisateur, qui pourra l'utiliser pour accéder à la ressource réservée.

    ::::callout
    Une réservation sera considérée comme **validée** quand la commande est passée. Son statut est alors **Confirmé** ou **Non confirmé** selon les règles que vous avez choisies. :br
    Pour annuler la réservation, donnez lui le statut **Annulé**.
    ::::

  Ce flux permet donc à l'utilisateur d'obtenir un code d'accès unique pour la ressource qu'il a réservée, code qui est généré par Neop et accessible via son espace client personnel.

  Il est également possible d'envoyer un mail de notification à l'utilisateur pour lui communiquer son code.

  De même, toute réservation effectuée par un·e gestionnaire permet de générer un code à 4 chiffres.
  :::
::

::tabs-item{icon="i-mdi-checkbox-multiple-marked-outline" label="Configuration"}
### Activation de l'API

1. Demandez vos clés API à l'équipe Neop
2. Dans l'espace de travail *Evénements & Ressources*, ouvrez les **Paramètres d'intégration Neop**
3. Saisissez votre ID utilisateur (PSEUDO) et le mot de passe (PASSWORD) communiqués par Neop.
4. Activez l'API

### Paramétrage des ressources

1. Ouvrez les fiches des ressources réservables pour lesquelles vous souhaitez activer la génération de code à 4 chiffres
2. Dans l'onglet **Intégration Neop** vous permet de lier votre ressource avec un identifiant d'espace Neop
::

\::


# Portail utilisateur

Dokos permet de configurer un site internet sur lequel vous pouvez vendre des produits, des services, laisser vos utilisateurs réserver des créneaux ou s'inscrie à un événement.

La vente de produits/services ou la réservation de créneaux passe par le site e-commerce intégré à Dokos qui est public.\:br
Il est également possible de mettre en place un portail utilisateur, avec des pages publiques ou privées, pour ajouter des fonctionnalités additionnelles sur votre site.

---

::card-group
  :::card
  ---
  title: Formulaire d'inscription au lieu
  to: https://doc.dokos.io/v5/dokos/lieu/portails/formulaire-inscription-lieu
  ---
  Proposez un formulaire d'inscription personnalisé à votre lieu.
  :::

  :::card
  ---
  title: Trombinoscope
  to: https://doc.dokos.io/v5/dokos/lieu/portails/trombinoscope
  ---
  Donnez accès à un trombinoscope des membres de votre lieu
  :::
::


# Formulaire Inscription Lieu

Lorsque qu'un nouveau membre s'inscrit à votre espace, il est généralement nécessaire de créer les documents suivants :

- Une fiche de contact
- Un compte client pour la facturation
- Une adresse de facturation
- Un utilisateur dans Dokos pour l'accès au portail
- Un abonnement

::mermaid
```text
graph TD;
A[Formulaire d'inscription] -->|Peut être associé à un abonnement ou non| B{Abonnement ou non ?}
B -->|Oui| C[Page de paiement]
C --> D[Coordonnées de paiement]
B -->|Non| F[Validation du formulaire]
D --> F[Validation du formulaire]
F -->|Création d'un utilisateur, d'un contact et d'un client| G[Création d'un utilisateur, d'un contact et d'un client]
F -->|Création d'un abonnement ou d'une commande| H[Création d'un abonnement]
H --> I[Déclenchement du paiement]
I --> J[Création d'une écriture de paiement et d'une facture associée]
```
::

Afin de simplifier la création de ces différents documents et de récolter des informations additionnelles pouvant servir à la gestion du lieu, Dokos propose un formulaire d'inscription personnalisable.

::demo-link{demo="Mappemonde" doctype="Venue Registration Form"}
Lieu > Formulaire d'inscription au lieu
::

![alt](https://doc.dokos.io/content/lieu/venue-registration-form/form.png)

::callout
Le formulaire d'inscription est rendu disponible sur le site web à l'aide d'un **Formulaire web**.
::

### Configuration

### Personnaliser le formulaire d'inscription

Le formulaire d'inscription *standard* récolte le minimum d'information nécessaire à la création des documents listés ci-dessus.

Si vous souhaitez récolter plus d'informations, vous pouvez personnaliser le type de document **Formulaire d'inscription au lieu** pour ajouter des champs supplémentaires.

### Définir les abonnements disponibles

Pour que les utilisateurs puissent choisir un abonnement lors de l'inscription, il faut créer des **Modèles d'abonnement**, et les rendre disponibles sur le site web en cochant la case **Disponible sur le portail** dans la section Portail de chaque modèle d'abonnement. Pour en savoir plus sur les modèles d'abonnement, consultez la page de [documentation sur les abonnements](https://doc.dokos.io/v5/dokos/ventes/abonnements).

Un exemple de modèle d'abonnement publié est disponible dans la démo de Dokos.

::demo-link
---
demo: Mappemonde
doctype: Subscription Template
path: Abonnement mensuel au coworking
---
Lieu > Modèle d'abonnement > Abonnement mensuel au coworking
::

### Créer un formulaire web

Le formulaire d'inscription n'est, par défaut, pas accessible sur le site web de Dokos.
Vous pouvez le rendre disponible à tous les visiteurs en créant un formulaire web.
Il existe aussi un **Formulaire Web** standard pour cette inscription, appelé tout simplement "Formulaire d'inscription au lieu".

::demo-link{demo="Mappemonde" doctype="Web Form" path="venue-registration-form"}
Voir le formulaire d'inscription standard dans la démo
::

Vous pouvez bien sûr personnaliser ce formulaire standard en le dupliquant.
Vous pouvez aussi créer un formulaire web similaire en suivant ces étapes :

1. Créez un nouveau document Formulaire Web et donnez lui un nom.
2. Donnez lui un nom et une route.
   :callout[Si la route est **inscription**, la page correspondante sera, par exemple, accessible à l'adresse <https://monsite.dokos.cloud/inscription>{rel="&#x22;nofollow&#x22;"}]{color="teal" icon="i-heroicons-light-bulb"}
3. Sélectionnez le type de document de référence **Formulaire d'inscription au lieu**, il s'agit du document qui sera créé lors de l'envoi du formulaire par les visiteurs.
4. Puis utilisez le bouton "Obtenir des champs" pour récupérer tous les champs du formulaire d'inscription.
5. Vous pouvez décider de ne pas exposer certains champs sur le site web en les retirant de la liste. Attention à mettre une valeur par défaut si vous enlevez un champ obligatoire.
6. Enregistrez le document puis cliquez sur le bouton "Publier" pour le rendre disponible sur le site web.

### Remplacer le lien *S'inscrire* sur la page /login

Il est possible de définir un **Formulaire d'inscription personnalisé** dans les **Paramètres du site web**.


# Trombinoscope

Dokos vous permet de créer un trombinoscope sur votre site web, accessible publiquement ou disponible uniquement derrière le portail utilisateur.

::demo-link{demo="Mappemonde" path="/trombinoscope"}
Voir le trombinoscope d'exemple dans la démo
::

### Créer un trombinoscope

Pour créer un trombinoscope il faut commencer par créer une nouvelle page web.

1. Donnez lui un nom et une route facilement identifiable.
   :callout[Si la route est **trombi**, la page correspondante sera, par exemple, accessible à l'adresse <https://monsite.dokos.cloud/trombi>{rel="&#x22;nofollow&#x22;"}]{color="teal" icon="i-heroicons-light-bulb"}
2. Sélectionnez le type de contenu **Constructeur de page**
3. Dans le tableau de *Blocs de construction de page* ajoutez une nouvelle ligne et sélectionnez le bloc **Trombinoscope**
4. Cliquez sur le bouton *Modifier les valeurs* et sélectionnez le rôle permettant de filtrer les utilisateurs affichés dans le trombinoscope
   :callout[Le trombinoscope affichera les utilisateurs de votre site ayant le rôle sélectionné au dessus.
   Par exemple, si vous sélectionnez le rôle **Client**, tous les utilisateurs ayant le rôle **Client** apparaîtront dans le trombinoscope.
   Par contre les utilisateurs désactivés n'apparaîtront pas.]{color="teal" icon="i-heroicons-light-bulb"}

Vous pouvez également choisir les informations qui seront affichées sur le trombinoscope.
Ces informations sont disponibles dans la fiche *Utilisateur* et peuvent être modifiées par chaque utilisateur depuis son portail.
5\. Vous pouvez ajouter d'autres blocs au dessus ou en dessous pour créer une page selon vos goûts

::demo-link{demo="Mappemonde" doctype="Web Page" path="trombinoscope"}
Voir l'exemple de document **Page Web** trombinoscope dans la démo
::

### Restreindre le trombinoscope au portail utilisateurs

Si vous ne souhaitez pas que le trombinoscope soit public, vous pouvez choisir de restreindre son accès à certains utilisateurs connectés au portail.

Pour cela il faut configurer les éléments suivants:

*Dans la page web*

1. Cocher la case **Afficher la barre latérale** si vous souhaitez que la page soit intégrée aux autres pages du portail.
2. Ajouter le code suivant dans la section *Contexte* afin de bloquer l'accès à la page par des utilisateurs non connectés:

```text
if frappe.session.user == "Guest":
    frappe.throw(_("Login to access this page."), frappe.PermissionError)

```

*Dans les paramètres du portail*

1. Ajouter une ligne dans votre menu personnalisé.

Exemple:

| Titre         | Activé | Route          | Type de document de référence | Rôle   |
| ------------- | ------ | -------------- | ----------------------------- | ------ |
| Trombinoscope | 1      | /trombinoscope |                               | Client |

Vous pouvez bien sûr modifier le titre et le rôle associé à cette page.

> Vous pouvez retrouver une page d'exemple sur la [démo de Dokos](https://tierslieux.dokos.io){rel="&#x22;nofollow&#x22;"}


# Formulaire d'adhésion à une association

Dokos n'étant pas un logiciel initialement dédié aux associations, la gestion des adhésions n'est pas une fonctionnalité de base du logiciel.

Cependant, de nombreuses associations utilisent Dokos et cherchent à intégrer la gestion des adhésions.

Pour les adhésions à prix fixe, le [Formulaire d'inscription au lieu](https://doc.dokos.io/v5/dokos/lieu/portails/formulaire-inscription-lieu) permet la génération automatique d'un abonnement.

Pour les adhésions à prix variable, aucun formulaire standard n'est intégré à Dokos pour l'instant, mais nous proposons le *paquet* suivant, que vous pouvez intégrer à votre site pour mettre en place le flux d'adhésion suivant:

::mermaid
```text
graph TD;
A[Formulaire d'adhésion à prix libre] --> B[Validation du formulaire]
B --> C[Page de paiement]
C -->D[Création d'un utilisateur, d'un contact et d'un client]
D -->E[Création d'une facture et d'une écriture de paiement]

```
::

## Composition du *paquet*

::callout
Un *paquet* est un fichier zip contenant un ensemble de documents qui peuvent être importés dans Dokos pour mettre à disposition une fonctionnalité.

Découvrez-en plus plus sur les paquets [ici](https://doc.dokos.io/v5/dodock/fonctionnalites/personnalisations/paquets).
::

Le paquet **Association** comprend les fichier suivants:

### Types de document

- Adhesion: Formulaire d'adhésion que vous pouvez compléter avec les données que vous souhaitez récolter en plus des données basiques proposées.
  Les scripts de création de client, contact, adresse et utilisateur utilisent un système de *mapping* entre les données, ce qui veut dire que si vos champs ont un nom identique à celui d'un formulaire cible (client, contact, etc...), cette donnée sera reprise dans ce document cible.
  *Ex. j'ajoute un champ salutation dans mon formulaire d'adhésion, sa valeur sera reprise dans la fiche contact lors de sa création, car le champ salutation existe dans les contacts*

### Formulaires web

- Adhesion: Formulaire web qui sera rempli en ligne par vos utilisateurs.
  Vous devez ajouter la passerelle de paiement à utiliser avant de le publier, sinon le paiement tombera en erreur. Le flux a été testé avec succès avec le checkout HelloAsso.
  Si vous rajoutez des champs dans le type de document **Adhesion**, pensez à les rajouter dans le formulaire web s'ils doivent être remplis par vos adhérents.

### Scripts serveur

- **Validation de la cotisation**: Script contenant la validation du montant minimum de cotisation. 1€ par défaut.
- **Retour de paiement**: Script mettant à jour le numéro de référence de paiement et le statut de l'adhésion au retour du paiement.
- **Facturation de l'adhésion**: Script orchestrant la création des différentes données de base (client, contact, adresse, utilisateur) et de la facture/paiement.
- **Création du client**: Script de création de la fiche client.
- **Création du contact**: Script de création de la fiche contact.
- **Création de l'utilisateur**: Script de création de la fiche utilisateur.
- **Création de l'adresse**: Script de création de l'adresse.
- **Création de la facture**: Script de création de la facture et du paiement. :br Vous devez indiquer l'article à facturer dans ce script pour que la facture puisse être créée.

## Téléchargement

- [Télécharger la version 1.0.2](https://doc.dokos.io/packages/Association-1.0.2.tar5fc0e7.gz){download="Association-1.0.2.tar5fc0e7.gz"}
- [Télécharger la version 1.0.1](https://doc.dokos.io/packages/Association-1.0.1.tare476d0.gz){download="Association-1.0.1.tare476d0.gz"}


# Guides de création

Les **Guides de création** permettent à votre équipe de rédiger des tutoriels structurés directement depuis Dokos, puis de les mettre à disposition de vos membres via le portail Bookings. Chaque guide peut décrire, étape par étape, comment utiliser une ressource : machine à bois, imprimante 3D, salle de créativité, etc.

::callout{icon="i-heroicons-light-bulb"}
Cette fonctionnalité doit être activée dans les **Paramètres de réservation de ressources** avant utilisation.
::

---

## Activer les guides de création

Avant de pouvoir créer ou consulter des guides, un administrateur doit activer la fonctionnalité :

1. Rendez-vous dans **Paramètres de réservation de ressources** (espace de travail *Évènements & Ressources*).
2. Cochez l'option **Activer les guides de création**.
3. Sauvegardez.

Une fois activée, la section *Guides* devient visible dans le portail et dans le bureau Dokos.

---

## Créer un guide

### Depuis le bureau Dokos

1. Accédez à **Évènements & Ressources > Guides de création**.
2. Cliquez sur **Nouveau**.
3. Renseignez les informations principales :

| Champ                   | Description                                             |
| ----------------------- | ------------------------------------------------------- |
| **Titre**               | Nom du guide affiché sur le portail                     |
| **Slug**                | Identifiant URL, généré automatiquement depuis le titre |
| **Image de couverture** | Visuel affiché dans la liste des guides                 |
| **Résumé**              | Courte description affichée dans les aperçus            |
| **Difficulté**          | Niveau requis (Débutant, Intermédiaire, Avancé)         |
| **Statut**              | Brouillon / Publié / Archivé                            |

4. Associez les **ressources** concernées par ce guide (ex. : Fraiseuse CNC, Imprimante laser).
5. Listez les **fournitures nécessaires** avec, si besoin, des fichiers joints (gabarits, plans…).
6. Ajoutez des **co-éditeurs** pour permettre à d'autres membres de l'équipe de modifier le guide.

### Publier ou dépublier

Depuis le formulaire du guide, utilisez les boutons **Publier** ou **Dépublier** pour contrôler la visibilité sur le portail. Un guide en statut *Brouillon* ou *Archivé* n'est pas visible par les membres.

---

## Structurer le contenu d'un guide

Chaque guide est organisé en **stages** (grandes parties) contenant des **étapes** détaillées.

::mermaid
flowchart TD
G\[Guide] --> S1\[Stage 1 : Préparation]
G --> S2\[Stage 2 : Utilisation de la machine]
G --> S3\[Stage 3 : Nettoyage]
S1 --> E1\[Étape 1 : Vérifier les EPI]
S1 --> E2\[Étape 2 : Préparer le matériau]
S2 --> E3\[Étape 3 : Régler la vitesse]
S2 --> E4\[Étape 4 : Lancer l'usinage]
S3 --> E5\[Étape 5 : Aspirer les copeaux]

::

Pour chaque étape, vous pouvez ajouter :

- Du **texte enrichi** (instructions, conseils de sécurité)
- Des **images** illustrant l'opération
- Des **ressources** associées (lien vers la fiche machine, vidéo…)

---

## Consulter les guides sur le portail

Vos membres accèdent aux guides depuis le portail Bookings. Plusieurs modes de consultation sont disponibles.

### Liste des guides

La page liste affiche tous les guides publiés avec :

- Un **filtre par difficulté** (Débutant, Intermédiaire, Avancé)
- Un **filtre par ressource** associée
- Un **filtre Favoris** pour retrouver rapidement les guides mis en favoris

### Page d'une ressource

Sur la fiche d'une ressource dans le portail, une section liste tous les guides associés à cette ressource. Un membre qui réserve la fraiseuse CNC voit directement les tutoriels qui la concernent.

### Lecture d'un guide

Le guide s'affiche en lecture pas-à-pas avec :

- Une **barre de progression** indiquant l'avancement dans les stages
- La possibilité de **marquer chaque étape comme complétée**
- Un **panneau de ressources** accessible latéralement
- Un **widget de fournitures** récapitulant le matériel nécessaire
- Un bouton **Ajouter aux favoris** pour retrouver le guide facilement

### Mode diaporama

Le mode **présentation** affiche le guide en plein écran, une étape par diapositive. Idéal pour projeter les instructions à côté d'une machine pendant un atelier.

---

## Télécharger un guide en PDF

Depuis la page du guide sur le portail, un bouton **Télécharger en PDF** permet d'exporter le guide.

- Le PDF reprend fidèlement la mise en page du guide.
- Les blocs (texte, images, étapes) ne sont pas coupés entre deux pages.
- **Si des fichiers sont joints aux fournitures**, le téléchargement produit une &#x2A;*archive `.zip`** contenant le PDF et tous les fichiers associés.

::callout{icon="i-heroicons-light-bulb"}
**Exemple d'usage** : L'atelier *FabLab Maison Verte* publie un guide « Découpe laser — première utilisation » associé à la ressource *Laser CO₂ 60W*. Le guide liste les fournitures (lunettes de protection, fichier SVG à découper) avec un gabarit PDF joint. Un membre télécharge le guide et reçoit une archive `.zip` contenant le tutoriel mis en page et le gabarit.
::

---

## Flux complet

::mermaid
sequenceDiagram
participant Admin
participant Dokos
participant Portail
participant Membre


```text
Admin->>Dokos: Active "Guides de création" dans les paramètres
Admin->>Dokos: Crée un guide (titre, stages, étapes, fournitures)
Admin->>Dokos: Clique sur "Publier"
Dokos-->>Portail: Guide visible sur le portail
Membre->>Portail: Consulte la fiche ressource
Portail-->>Membre: Affiche les guides associés
Membre->>Portail: Ouvre un guide, marque les étapes
Membre->>Portail: Télécharge le PDF (ou .zip si fichiers joints)
```
::

---

## Questions fréquentes

**Peut-on avoir plusieurs auteurs sur un guide ?**
Oui. Ajoutez des co-éditeurs dans la section dédiée du formulaire. Ils pourront modifier le guide depuis le bureau Dokos.

**Un guide archivé est-il encore accessible ?**
Non. Seuls les guides au statut *Publié* sont visibles sur le portail. Les guides *Archivés* restent accessibles aux administrateurs dans le bureau.

**Peut-on associer un guide à plusieurs ressources ?**
Oui. La section *Ressources* du guide permet d'en lier autant que nécessaire. Le guide apparaîtra sur la fiche de chacune de ces ressources.


# Introduction

## 1. Configuration

- [1. Paramètres du site web](https://doc.dokos.io/v5/dodock/fonctionnalites/site-web/parametres-site-web)
- [2. Paramètres e-commerce](https://doc.dokos.io/v5/dokos/e-commerce/parametres)
- [3. Thème du site web](https://doc.dokos.io/v5/dodock/fonctionnalites/site-web/theme-site-web)
- [4. Paramétrage de la page A propos](https://doc.dokos.io/v5/dodock/fonctionnalites/site-web/pages-standard)
- [5. Paramètres du formulaire de contact](https://doc.dokos.io/v5/dodock/fonctionnalites/site-web/pages-standard)

## 2. Blog

- [1. Article de Blog](https://doc.dokos.io/v5/dodock/fonctionnalites/site-web/blog)
- [2. Blogueur](https://doc.dokos.io/v5/dodock/fonctionnalites/site-web/blog)

## 3. Site internet

- [1. Page Web](https://doc.dokos.io/v5/dodock/fonctionnalites/site-web/page-web)
- [2. Formulaire web](https://doc.dokos.io/v5/dodock/fonctionnalites/site-web/formulaire-web)

## 4. Portail

- [1. Portail](https://doc.dokos.io/v5/dodock/fonctionnalites/site-web/portail)
- [2. Trombinoscope](https://doc.dokos.io/v5/dokos/lieu/portails)

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Les liens **Page d'accueil** et **Section de page d'accueil** ne sont plus visibles depuis le module site web car ces modules ont été retirés et ont été remplacés par **Page Web**. Il faut donc dès à présent passer par Site Web > **Page Web** pour créer une page d'accueil. La page d'accueil est à configuré depuis les paramètres du site en indiquant le lien de la Page d'accueil. (Documentation plus détaillée à venir)
::


# Site e-commerce

## Fonctionnalités principales du site e-commerce

### 1. Présentation des articles et ressources réservables sur le site

- **Gestion des articles** : Vous pouvez ajouter, modifier et supprimer des articles. Chaque article peut avoir des images, des descriptions, des spécifications techniques, et des informations de tarification. L’ajout sur le site se fait directement dans la configuration de l’article avec le bouton **Action** \*\* Publier l’article\*\*.
- **Catégorisation** : Les articles peuvent être organisés en différentes catégories pour une navigation facile. En configurant des **groupes d’article**.
- **Variantes de produits** : Vous pouvez créer des variantes de produits en fonction de différents attributs comme la taille, la couleur, etc.
- **Vente d'abonnements** : Les tiers lieux peuvent vendre des abonnements.
- **Réservation d'Espaces** : Les utilisateurs peuvent réserver des salles de réunion, des bureaux privés ou des espaces événementiels directement en ligne.
- **Utilisation de crédit** : Les utilisateurs ont la possibilité d’utiliser leurs crédits pour réserver des salles.
- **Calendrier** : Le calendrier proposé pour les réservations en ligne met automatiquement à jour le calendrier du bureau Dokos.

### 2. Commandes et Paiements

- **Traitement des commandes** : Les commandes passées sur le site e-commerce sont automatiquement enregistrées dans Dokos, où elles peuvent être traitées et suivies.
- **Passerelles de paiement** : Dokos s'intègre avec plusieurs passerelles de paiement pour permettre des transactions sécurisées. Vous pouvez configurer des options de paiement comme PayPal, Stripe, HelloAsso, GoCardless, Stancer.
- **Définir des modes de paiement** : Dokos vous permet de configurer plusieurs méthodes de paiement, y compris le virement avec ou sans passerelle, le prélèvement automatique et le paiement par carte de crédit.
- **Facturation automatique** : Génération de factures automatiques pour les abonnements, avec la possibilité de payer en ligne.
- **Historique des commandes** : Les clients peuvent consulter l'historique de leurs commandes passées.

### 3. Personnalisation du Site :

- **Thèmes du site web** : Dokos propose des options de personnalisation de l'apparence de votre site e-commerce via des thèmes et des modèles de mise en page.
- **Paramétrage** : Vous pouvez créer et gérer des pages (comme les pages "À propos", "Formulaire de contact ", etc.) directement depuis l'interface Dokos.

Paramètres du formulaire de contact : En l’absence d’adresse, les demandes de formulaire sont enregistrées dans votre système sous le type de document "Communication".

## Paramètres de caisse

En activant la caisse, vous permettez à vos clients de régler leurs commandes passées sur le site web directement en ligne.

L'**URL de réussite de paiement** est la page vers laquelle l'utilisateur sera re-dirigé après avoir effectué son paiement.

## TVA

Pour permettre le calcul de la TVA dans le panier, créez une ou plusieurs **règles de taxation** et cochez l'option **Utiliser pour le Panier**.

## Modes de livraison

Pour configurer les modes de livraison, créez une ou plusieurs **règles de livraison** et cochez l'option **Afficher sur le site web**. Plus d'informations dans la [documentation des règles de livraison](https://doc.dokos.io/v5/dokos/stocks/regle-de-livraison).

::card
---
icon: i-ph-package-duotone
title: Modes de livraison
to: https://doc.dokos.io/v5/dokos/stocks/regle-de-livraison
---
Utiliser les règles de livraison pour proposer vos produits à la livraison à domicile ou en point de retrait.
::

## Blocs de panier personnalisés

Utilisez les blocs de panier personnalisés vous souhaitez ajouter des informations sur la page Panier de votre site E-Commerce : lien vers vos CGV, rappels utiles, case à cocher, etc.

Rendez-vous dans l'onglet **Panier**, section **Personnalisations**, puis ajoutez des **Blocs web** dans la table correspondante. Cette table fonctionne comme pour le constructeur de page web.

À l'aide du bouton "Modifier" présent pour chaque ligne, vous pouvez choisir sur quelle page le bloc s'affiche (*1. Panier* et/ou *2. Finalisation de la commande*), et configurer la position de chaque bloc dans la page.

## Formulaire d'adresse personnalisé

Vous pouvez personnaliser le formulaire d'adresse utilisé pour recueillir les informations de livraison/facturation des clients sur le site web. Rendez-vous dans l'onglet **Panier**, section **Personnalisations**.

Initialement, la table est vide. Lorsque vous cliquerez sur ajouter une ligne, les champs obligatoires seront ajoutés à la table. Vous pouvez ensuite ajouter des champs supplémentaires, ou modifier les intitulés, valeurs par défaut, etc. Vous pouvez modifier la valeur par défaut d'un champ, comme le pays par exemple. Vous pouvez rendre obligatoires certain champs, comme le numéro de téléphone par exemple. Enfin, vous pouvez ajouter des champs de mise en forme comme *Saut de section* ou *Saut de colonne*.

Prenez garde à ne pas rendre facultatif ou masquer un champ obligatoire (`address_type`, `address_line1`, `city`, `country`), ce qui rendrait impossible la création d'une adresse depuis la page Panier.


# Portail

Ce portail permet aux clients de se connecter et de trouver des informations qui les concernent. Les clients peuvent retracer l'historique de communication de leurs mails. Ils peuvent également vérifier l'état de la commande en se connectant au site Web.

---

Pour accéder aux paramètres du portail, allez sur :

> Accueil > Site web > Portail > **Paramètres du portail**

## 1. Comment configurer le portail ?

- Accédez aux paramètres du portails.
- Indiquez le rôle qui sera attribué par défaut au moment de l'inscription
- Renseignez la Page d'accueil par défaut du portail

### 1. Menu Standard de la Barre Latérale

- **Masquer le Menu Standard** : Si la case est cochée, alors le menu sera masqué du portail.
- Menu portail : Vous pouvez ajouter les documents qui seront visibles sur votre portail.


  - **Titre** : Titre qui s'affichera sur la naviguation
  - **Activé** : Si la case est cochée, alors cette section sera affichée sur le portail
  - **Route** : Définissez le chemin de la page.
  - **Type de document** : Choisissez le document qui sera affiché sur la page
  - **Rôle** : Indiquez le rôle qui sera autorisé à voir les informations.

## Les fonctionnalités du portail

### 1. S'inscrire

Votre client et vos fournisseurs peuvent s'inscrire à votre compte ERPNext en suivant l'option Inscription sur la page de connexion.

- **Étape 1 : s'inscrire**
  Sur la page de connexion, vous trouverez une option pour vous inscrire.
- **Étape 2 : Entrez le nom et l'ID du client**
  Après le processus d'inscription, un e-mail sera envoyé à l'adresse e-mail du client avec les détails du mot de passe.

### 2. Connexion au portail

Pour se connecter à son compte client, le client doit utiliser son adresse e-mail et le mot de passe transmis par Dokos ; générés par le processus d'inscription.

### 3. Commandes client, factures et statut d'expédition

Le portail Web de Dokos permet à vos clients d'accéder rapidement à leurs commandes, factures et expéditions. Les clients peuvent vérifier l'état de leurs commandes, factures et expéditions en se connectant sur le Web.

Une fois qu'une commande est passée, que ce soit à l'aide du panier ou à partir de la plateforme, votre client peut visualiser la commande et garder un œil sur l'état de la facturation et de l'expédition. Lorsque la facture et le paiement de ces commandes sont soumis, le client peut voir le statut mis à jour sur le portail, en un coup d'œil.

### 4. Réservations d'articles

Vous pouvez activer le portail "Bookings" pour donner un accès à vos clients à la liste des créneaux qu'ils ont réservés.\:br
Les différentes réservations apparaîtront avec les statuts "Confirmé", "Annulé" ou "Passé".

Si vous donnez l'autorisation d'écrire dans une réservation d'articles à vos clients, ceux-ci pourront également voir un bouton `Annuler` leur permettant d'annuler leur réservation.
Cette autorisation peut être donnée en cochant la case `Ecrire` pour le rôle `Client` (par défaut) dans le gestionnaire des rôles et autorisation.

### 5. Gestion des abonnements

Dans la partie du portail, vous pouvez activer la gestion des abonnements pour vos utilisateurs. Ils peuvent voir plusieurs abonnements sur leur portail client et ajouter/retirer des élements de chaque abonnement.


# Réservation de ressources sur le site e-commerce

::callout{color="red" icon="i-heroicons-x-circle"}
**Fonctionnalité dépréciée en v5.** La réservation de ressources via le site e-commerce sera supprimée dans une prochaine version de Dokos. Il est déconseillé de l'activer pour de nouveaux projets.
::

Le module e-commerce de Dokos permet à vos clients de réserver des ressources — salles, équipements, espaces de coworking — directement depuis votre site web, sans intervention manuelle de votre équipe. Les réservations en ligne sont automatiquement synchronisées avec le planning interne de Dokos, les factures et les crédits des clients.

## Réserver un créneau depuis le site web :badge{text="Dokos" type="warning"}

Dokos crée automatiquement une réservation d'article dès qu'un client sélectionne un créneau sur le site web. La réservation apparaît dans le panier avec le statut **En panier**, ce qui bloque le créneau pour les autres visiteurs pendant la durée de la session d'achat.

> **Exemple — Maison Verte SARL**
> Sophie, responsable chez Maison Verte SARL, consulte le site de votre tiers-lieu et sélectionne la salle "Marco Polo" pour le mardi de 9h à 12h. La salle est immédiatement marquée comme indisponible sur le calendrier public, et la réservation apparaît dans le panier de Sophie en attendant la validation du paiement.

Une fois le paiement effectué, la réservation passe au statut **Confirmé** et apparaît dans le calendrier interne de Dokos. Si Sophie abandonne son panier sans payer, le créneau est libéré automatiquement après le délai configuré dans les Paramètres de lieu.

::demo-link{demo="Mappemonde" path="/bookings-ui"}
Voir le portail de réservation en ligne
::

## Réservation sur une période longue :badge{text="Dokos" type="warning"}

Dokos prend en charge les réservations exprimées en jours, semaines, mois ou années entières. Le client sélectionne une date de début et une durée, et Dokos calcule automatiquement la période complète correspondante, en respectant le début de semaine ou de mois selon l'unité choisie.

> **Exemple — Bureau Moderne**
> L'entreprise Bureau Moderne souhaite louer un bureau privatif pour le mois d'avril. Sur le site web, elle sélectionne "Bureau 101", choisit l'unité "Mois" et indique avril comme période. Dokos crée une réservation du 1er au 30 avril et calcule la quantité à facturer en fonction de la durée.

Cette fonctionnalité est particulièrement utile pour les espaces de coworking qui proposent des formules à la semaine ou au mois en plus des réservations à l'heure ou à la journée. Les tarifs et unités de mesure disponibles sont configurés dans les Paramètres de lieu.

## Paiement par crédits de réservation :badge{text="Dokos" type="warning"}

Les clients disposant d'un solde de crédits de réservation peuvent choisir d'utiliser leurs crédits pour régler leur réservation directement sur le site web. Dokos affiche cette option lors de la sélection du créneau et déduit automatiquement le montant correspondant du solde du client.

> **Exemple — Maison Verte SARL**
> Sophie a acheté un pack de 10 heures en début de mois. Lors de sa prochaine réservation de la salle "Marco Polo", Dokos lui propose de payer avec ses crédits. Elle confirme, et son solde passe de 10h à 7h sans aucune transaction financière supplémentaire.

Les crédits de réservation doivent être configurés et attribués au client via les [crédits de réservation](https://doc.dokos.io/v5/dokos/lieu/credit-reservation) avant d'être utilisables en ligne.

## Confirmation directe sans passage par le panier :badge{text="Dokos" type="warning"}

Certains articles de site web peuvent être configurés pour permettre une confirmation immédiate de la réservation, sans que le client n'ait à passer par le panier ni à effectuer un paiement en ligne. La réservation passe directement au statut **Confirmé** dès la sélection du créneau.

Cette option est adaptée aux ressources en accès libre pour les membres actifs, ou aux espaces dont la gestion des paiements se fait hors ligne. Elle se configure dans les paramètres de l'article de site web.

## Accès conditionné par badges :badge{text="Dokos" type="warning"}

Dokos vérifie automatiquement les badges de l'utilisateur connecté avant d'autoriser une réservation sur le site web. Si la ressource requiert un ou plusieurs badges (par exemple, une habilitation machine ou un niveau d'adhésion), et que le client ne les possède pas ou qu'ils ont expiré, Dokos affiche un message indiquant les badges manquants et bloque la réservation.

> **Exemple — Maison Verte SARL**
> Le tiers-lieu a configuré l'imprimante 3D pour n'être accessible qu'aux membres ayant le badge "Maîtrise niveau 1". Quand Sophie tente de réserver l'imprimante sans ce badge, Dokos lui indique qu'elle doit d'abord obtenir le badge en passant par la formation dédiée.

La gestion des types de badges et leur attribution aux utilisateurs se configure depuis la section [Badges](https://doc.dokos.io/v5/dokos/lieu/badges).

## Gestion multi-client :badge{text="Dokos" type="warning"}

::dokos
Dokos permet à un utilisateur connecté d'agir pour le compte de plusieurs clients différents sur le site web. Cette fonctionnalité est utile pour les agents d'accueil ou les gestionnaires qui réservent des ressources au nom de leurs clients depuis une interface commune.

Le client actif peut être défini de trois façons :

- via le paramètre `webshop_customer` dans l'URL ou le formulaire de la page
- via l'en-tête HTTP `X-Webshop-Customer` pour les intégrations API
- via un cookie `webshop_customer` déposé lors de la sélection précédente

Dokos vérifie que l'utilisateur connecté est bien déclaré comme utilisateur du portail du client sélectionné avant d'accepter la sélection.
::

## Voir aussi

- [Crédits de réservation](https://doc.dokos.io/v5/dokos/lieu/credit-reservation)
- [Badges de réservation](https://doc.dokos.io/v5/dokos/lieu/badges)
- [Ressources réservables et calendriers](https://doc.dokos.io/v5/dokos/lieu/reservations-articles)
- [Gestion multi-lieu](https://doc.dokos.io/v5/dokos/lieu/multi-societe)
- [Paramètres e-commerce](https://doc.dokos.io/v5/dokos/e-commerce/parametres)


# Gestion de chantiers

::callout
Afin d'avoir ces fonctionnalités sur votre site Dokos, veuillez installer l'application [Chantier](https://gitlab.com/dokos/construction):br
Si vous êtes client Dokos Cloud, vous pouvez faire une demande d'installation à l'adresse [](){mailto="help@dokos.cloud"}<help@dokos.cloud>
::

## Principales fonctionnalités

::card-group
  :::card
  ---
  title: Vue Chantiers
  to: https://doc.dokos.io/v5/dokos/chantiers/vue-chantiers
  ---
  Activez une table dédiée pour la gestion de vos articles dans vos devis, commandes, factures
  :::

  :::card
  ---
  title: Factures de situation
  to: https://doc.dokos.io/v5/dokos/chantiers/factures-situation
  ---
  Créez des factures de situation
  :::

  :::card{title="Outils" to="https://doc.dokos.io/v5/dokos/chantiers/outils"}
  Autres outils apportés par l'application Chantier
  :::
::


# Vue Chantiers dédiée pour les tables d'articles

::tabs
  :::div{icon="i-mdi-ev-plug-chademo" label="Fonctionnement"}
  ### Utilisation dans les documents de vente et d'achat (devis, commandes, factures)

  La vue *Chantiers* vous permet d'ajouter des titres, sous-titres et commentaires dans vos documents de vente ou d'achat. :br
  Elle permet également l'affichage de plus de champs que la vue classique, pour visualiser rapidement, par exemple:

  - La marge
  - Choisir les lignes à afficher ou à ne pas afficher à l'impression
    ![vue chantiers](https://doc.dokos.io/content/chantiers/vue-chantier.png)

  ### Impression

  A l'impression, des composants spécifiques permettent l'affichage des sections et les calculs de sous-totaux.
  ![vue chantiers](https://doc.dokos.io/content/chantiers/impression-chantier.png)
  :::

  :::div{icon="i-mdi-checkbox-multiple-marked-outline" label="Paramétrage"}
  Par défaut, cette vue n'est pas activée à l'installation de l'application de gestion de chantiers. :br
  Pour l'activer, allez dans les **Paramètres de l'application Chantiers** et cochez la case **Utiliser la vue Table dédiée**.

  Choisissez dans quels types de transactions vous souhaitez l'utiliser et paramétrez les colonnes que vous souhaitez afficher dans cette table.
  :::
::


# Factures de situation

Dans certains secteurs d’activité tels que le BTP (bâtiment et travaux publics) ou celui des prestations de services à long terme, il est d’usage de recourir à des factures spécifiques : les factures à l’avancement, aussi connues sous le nom de factures de situation.

::tabs
  :::div{icon="i-mdi-ev-plug-chademo" label="Fonctionnement"}
  ### Créer une facture de situation

  Depuis une commande validée, vous pouvez sélectionner l'option **Créer > Facture de situation**. :br
  Dokos vous proposera automatiquement un pourcentage d'avancement correspondant au maximum entre le pourcentage d'avancement du projet associé à la commande (le cas échéant) et le pourcentage déjà facturé. :br
  Vous êtes libre d'ajuster ce pourcentage.

  ## Ajuster le pourcentage d'avancement

  Vous disposez de deux options pour ajuster le pourcentage d'avancement:

  1. Pourcentage global appliqué à toutes les lignes de facturation. :br
     C'est l'option par défaut, activée en cochant la case correspondante.
  2. Pourcentage par ligne de facturation: Dans ce cas le pourcentage global sera calculé sur la base des lignes de facturation.

  ## Conditions pour les factures de situation

  La gestion de stock ne peut pas être faite au niveau de la facture pour les factures de situation. :br
  Vous devez utilisez les bons de livraison pour sortir les bons niveaux de stock.

  Les factures de situation ne peuvent être associées qu'à une seule commande client.

  ## Impression

  Les factures de situation doivent comporter quelques informations complémentaires vis à vis d'une facture classique. :br
  Dokos donne accès aux éléments suivants, qui peuvent être ajoutés dans vos formats d'impression:

  - Un titre d'impression comportant le numéro de situation. Ex. `Facture de situation n°3`
  - Une table récapitulative de l'état de facturation.
    **Affichage dans la commande**![Récapitulatif de facturation](https://doc.dokos.io/content/chantiers/recapitulatif-facturation.png)

  **Affichage dans le format d'impression de facture**![Situation de facturation](https://doc.dokos.io/content/chantiers/recap-impression-avancement.png)
  :::

  :::div{icon="i-mdi-checkbox-multiple-marked-outline" label="Paramétrage"}
  ## Afficher le pourcentage d'avancement dans la table des articles

  Par défaut le champ n'est pas ajouté dans la vue **Chantier** table des articles. :br
  Dans les **Paramètres de l'application Chantiers**, ajoutez une colonne à l'endroit qui vous semble le plus adapté (généralement avant la quantité) et ajoutez la colonne `progress_percentage`.

  ## Utiliser le titre d'impression dans vos factures

  Dokos va automatiquement ajuster le titre d'impression de votre facture avec le numéro de facture situation. :br
  Pour que l'impression se fasse correctement vous pouvez:

  - Ajouter le champ **Titre d'impression** n'importe où dans votre format d'impression de facture
  - Rendre votre en-tête de facture dynamique en y ajoutant, par exemple: `{{ doc.select_print_heading or "Facture de vente" }}`
  :::
::


# Outils

## Projets et Tâches

Tous les documents joints aux tâches de votre projet sont visibles depuis un onglet dédié dans les tâches et dans les projets.

![Vue de documents](https://doc.dokos.io/content/chantiers/vue-documents.png)

## Rapports

### Récapitulatif de marque sur devis par projet

Ce rapport permet de comparer le pourcentage de marque sur devis avec la marge réelle, par projet.

### Comparatif de marge par devis

Ce rapport permet de comparer la marge théorique calculée lors de l'établissement du devis avec la marge réelle lors de la facturation.


# Application Entreprise

L'application Entreprise ajoute des fonctionnalités avancées à votre système pour répondre à des besoins complexes de gestion d'entreprise.

::card-group
  :::card
  ---
  title: Workflows d'entreprise
  to: https://doc.dokos.io/v5/dokos/entreprise/workflows-entreprise
  ---
  Un système de workflow avancé basé sur des périmètres pour une gestion fine des approbations.
  :::

  :::card
  ---
  title: Portail Fournisseur
  to: https://doc.dokos.io/v5/dokos/entreprise/portail-fournisseur
  ---
  Un portail dédié pour la communication et l'échange de documents avec vos fournisseurs.
  :::

  :::card
  ---
  title: Rapport d'analyse budgétaire
  to: https://doc.dokos.io/v5/dokos/entreprise/analyse-budgetaire
  ---
  Un outil de reporting pour suivre et analyser l'exécution de vos budgets.
  :::

  :::card
  ---
  title: Portail Approbateur
  to: https://doc.dokos.io/v5/dokos/entreprise/portail-approbateur
  ---
  Une interface centralisée pour la gestion des approbations.
  :::
::


# Rapport d'Analyse Budgétaire

Le rapport d'analyse budgétaire de l'entreprise est un outil puissant pour suivre l'exécution de vos budgets en temps réel.

Il vous permet de comparer les montants budgétés avec les montants réels dépensés ou engagés, et de visualiser rapidement les écarts.

Le rapport offre plusieurs niveaux de regroupement et de filtrage, vous permettant d'analyser vos budgets par centre de coûts, par projet, par compte comptable, ou toute autre dimension analytique pertinente pour votre organisation.

Cette vision détaillée et consolidée de vos budgets vous aide à prendre des décisions éclairées et à mieux maîtriser vos dépenses.

Vous pouvez choisir entre le calcul du réalisé sur les montants comptabilisées ou les montants réceptionnés dans les **Paramètres d'entreprise**


# Portail Approbateur

Le portail approbateur est une interface centralisée qui simplifie et accélère le processus d'approbation des documents.

Il offre aux approbateurs une vue d'ensemble de toutes les demandes en attente de leur validation. Depuis ce portail, ils peuvent :

- Consulter les documents en attente d'approbation.
- Approuver ou rejeter les demandes en un clic.
- Accéder à l'historique de leurs approbations.

Le portail approbateur est conçu pour être simple et intuitif, permettant aux utilisateurs de traiter rapidement leurs tâches d'approbation sans avoir à naviguer dans l'ensemble du système.

Vos utilisateurs peuvent y accéder via l'URL: `{votre_site_dokos}/approval-portal`


# Portail Fournisseur

Le portail fournisseur est un espace dédié à vos fournisseurs pour faciliter la communication et l'échange d'informations et de documents.

## Demandes d'information fournisseur

Vous pouvez envoyer une demande d'**Information fournisseur** (`Supplier Information`) à vos fournisseurs pour collecter ou mettre à jour des informations les concernant.

Depuis le portail, le fournisseur peut consulter les demandes, y répondre et joindre des documents si nécessaire.

Cela permet de centraliser et de tracer les échanges d'informations avec vos fournisseurs, et de garantir que vos données sont toujours à jour.

## Flux d'invitation

Le nouveau flux d'invitation fournisseur est centralisé dans le type de document **Information fournisseur**. :br
Il intègre les étapes de demande d'informations, de création d'utilisateur et d'envoi d'e-mail de bienvenue, ainsi que la gestion des informations et documents du fournisseur.

::mermaid
```text
graph TD
    A[Début: Création d'une nouvelle Enterprise Supplier Information] --> B{Email du fournisseur existe ?}
    B -- Oui --> C[Ajouter le rôle Supplier à l'utilisateur existant]
    B -- Non --> D[Créer un nouvel utilisateur avec le rôle Supplier]
    C --> E[Lier l'utilisateur au fournisseur]
    D --> E
    E --> F{Envoyer l'e-mail de bienvenue ?}
    F -- Oui --> G[Envoyer l'e-mail de bienvenue avec lien de réinitialisation de mot de passe]
    F -- Non --> H[Continuer sans envoi d'e-mail]
    G --> I[Générer les documents requis]
    H --> I
    I --> J[Le fournisseur soumet les informations et documents]
    J --> K{Validation des informations et documents}
    K -- Rejeté --> J
    K -- Approuvé --> L[Mettre à jour les informations du fournisseur existant ou créer un nouveau fournisseur]
    L --> M[Fin: Onboarding terminé]
```
::

## Dépôt de documents

Les fournisseurs peuvent également utiliser le portail pour déposer des documents. Le type de document attendu est défini dans le document **Document fournisseur** (`Supplier Document`).

Vous pouvez par exemple demander à vos fournisseurs de déposer leurs attestations fiscales et sociales, leurs conditions générales de vente, ou tout autre document pertinent.

Chaque type de document peut avoir une date d'expiration, ce qui vous permet de suivre facilement la validité des documents de vos fournisseurs et de leur demander de les renouveler à l'approche de l'échéance.

La configuration des types de documents à demander peut être effectuée en passant par le document **Modèle de document fournisseur** (`Supplier Document Template`)


# Workflows d'Entreprise

Le système de workflows d'entreprise est une version améliorée du système de workflow standard. Il a été conçu pour répondre à des besoins de validation complexes et granulaires au sein de l'organisation.

## Périmètre de workflow d'entreprise

La principale nouveauté de ce système est l'introduction du **Périmètre de workflow** (`Workflow Scope`).

Cet objet vous permet de définir des conditions spécifiques qui déclencheront un workflow particulier. Par exemple, vous pouvez définir un workflow qui ne s'applique qu'à une certaine société, un centre de coûts, un projet, ou toute autre dimension analytique disponible sur vos documents.

Cette approche permet de réduire considérablement le nombre de workflows à maintenir et d'avoir une gestion beaucoup plus fine des circuits de validation.

### Fonctionnement

1. La configuration des workflows ne s'effectue plus dans le type de document **Flux de travail** (`Workflow`) mais dans le type de document **Workflow Entreprise** (`Enterprise Workflow`).

Chaque document de configuration de workflow est limité à une société. Cela permet de simplifier la configuration de différents circuits de workflow pour chaque entité d'un groupe.

L'essentiel des options est similaire au système de workflow classique et certaines options additionnelles ont été ajoutées:

**Options liées aux statuts**

- Possibilité de définir s'il s'agit d'un statut d'approbation (`Approval State`)
  Cela permet au système de créer une hiérarchie d'états de workflow et de trouver le prochain valideur même s'il n'est pas défini dans la transition suivante.

::callout
Une entreprise met en place une validation à 3 niveaux pour tous ses centres de coûts: Approbation au niveau 1, 2 et 3
A chaque niveau les approbateurs peuvent approuver ou rejeter, les statuts correspondants sont des statuts d'approbation.
Par contre, une fois que le document est définitivement approuvé, ils peuvent l'annuler, ce n'est pas un statut d'approbation.

Sur un centre de coût, s'il n'y a pas de valideur au niveau 2, le système peut alors décider de laisser l'approbateur niveau 3 approuver au niveau 2 et 3.
::

- Possibilité d'envoyer automatiquement une notification au créateur du document et aux personnes assignées pour leur indiquer que le document est passé à cet état.

::callout
Notifier le/la créateur/rice du document qu'il a été définitivement Approuvé.
::

**Options liées aux transitions**

- Il est possible de rendre la saisie d'un commentaire obligatoire lors d'une action de workflow.
  Exemple: lorsqu'un valideur rejette un document, il doit mettre un commentaire expliquant sa décision.

**Validation automatique**

Lorsque qu'un valideur/une validatrice doit valider à plusieurs niveaux, le système effectue cette validation automatiquement.

::callout
Un approbateur avec une délégation d'engagement de dépense de 10000 € doit valider les dépenses sur son centre de coût.
En tant que responsable du centre de coûts, il effectue une validation, puis le document est envoyé au contrôle de gestion qui valide, avant que celui-ci ne revienne chez lui pour une validation finale.
Dans ce cas, la validation finale est effectuée automatiquement car il a déjà validé dans la chaîne.
::

## Modification de l'interface utilisateur

- Suivi des validations et valideurs suivants

Dans les documents à valider, dans le menu **Actions**, une option **Voir le workflow** permet de voir l'état actuel du workflow ainsi que les noms et actions possibles pour les prochains valideurs.

- Configuration des autorisations et des périmètres de workflow

Un onglet dédié est disponible dans les fiches utilisateur et dans les centres de coûts.

## Délégation de workflow

Une autre fonctionnalité clé est la possibilité de déléguer des approbations. Si un approbateur est absent, il peut désigner un autre utilisateur pour le remplacer temporairement.

La gestion des délégations se fait via le document **Délégation de workflow** (`Workflow Delegation`).

Un utilisateur peut créer une délégation pour une période donnée et pour un périmètre de workflow spécifique. Ainsi, toutes les demandes d'approbation qui lui sont normalement adressées seront redirigées vers le délégataire pendant la période définie.


# Intégrations Dokos

Dokos propose, en plus d'intégrations sous la forme d'[applications installables](https://doc.dokos.io/v5/integrations), des intégrations avec des services tiers, qu'il s'agisse de services de sauvegarde de données, paiements, envoi de messages, etc. ou même encore n'importe quel service accessible via une API REST ou [Zapier](https://doc.dokos.io/v5/integrations/zapier).

## Sauvegarde

::card-group
  :::card
  ---
  icon: clarity:backup-line
  title: Dropbox
  to: https://doc.dokos.io/v5/dokos/integrations/dropbox
  ---
  Plateforme de stockage qui permet de sauvegarder, synchroniser et partager facilement des fichiers.
  :::

  :::card
  ---
  icon: cib:amazon-aws
  title: Amazon S3
  to: https://doc.dokos.io/v5/dokos/integrations/amazon-s3
  ---
  Amazon S3 est le service de stockage principal d’Amazon Web Services. Il permet de stocker une quantité « virtuellement » illimitée de données avec une très haute disponibilité.
  :::

  :::card
  ---
  icon: mdi:google-drive
  title: Google Drive
  to: https://doc.dokos.io/v5/dokos/integrations/google-drive
  ---
  Google Drive est un service de stockage et de synchronisation de fichiers développé par Google.
  :::
::

## Services Google

::card-group
  :::card
  ---
  icon: tabler:brand-google-filled
  title: Paramètres Google
  to: https://doc.dokos.io/v5/dokos/integrations/google
  ---
  Paramètres Google
  :::

  :::card
  ---
  icon: arcticons:google-contacts
  title: Contacts Google
  to: https://doc.dokos.io/v5/dokos/integrations/google-contacts
  ---
  Dokos fournit une intégration avec Google Contacts afin que tous les utilisateurs puissent synchroniser leurs Google Contacts avec Dokos
  :::

  :::card
  ---
  icon: tabler:brand-google-filled
  title: Google Agenda
  to: https://doc.dokos.io/v5/dokos/integrations/google-calendar
  ---
  Dokos fournit une intégration avec Google Contacts afin que tous les utilisateurs puissent synchroniser leurs Google Contacts avec Dokos
  :::

  :::card
  ---
  icon: mdi:google-drive
  title: Google Drive
  to: https://doc.dokos.io/v5/dokos/integrations/google-drive
  ---
  Google Drive est un service de stockage et de synchronisation de fichiers développé par Google.
  :::
::

## Authentification

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
🚧 En cours de rédaction 🚧
::

## Places de marché

::card-group
  :::card
  ---
  icon: logos:woocommerce-icon
  title: Woocommerce
  to: https://doc.dokos.io/v5/integrations/woocommerce
  ---
  L'application Dokos WooCommerce propose un connecteur pour faciliter l'intégration des commandes créées depuis WooCommerce dans Dokos.
  :::

  :::card
  ---
  icon: cib:amazon-aws
  title: Amazon MWS
  to: https://doc.dokos.io/v5/dokos/integrations/amazon-mws
  ---
  Le connecteur Amazon extrait les produits et les commandes client de la market place Amazon. La synchronisation des produits et des commandes clients est séquentielle. Vous devez synchroniser les produits avant de synchroniser les commandes client.
  :::

  :::card
  ---
  icon: lineicons:shopify
  title: Shopify
  to: https://doc.dokos.io/v5/dokos/integrations/shopify
  ---
  Le connecteur Shopify extrait les commandes de Shopify et crée une commande client.
  :::
::

## Paiements

::card-group
  :::card
  ---
  icon: logos:stripe
  title: Stripe
  to: https://doc.dokos.io/v5/integrations/payments/stripe
  ---
  L'intégration avec Stripe permet de proposer des paiements par carte bancaire sur votre site Dokos.
  :::

  :::card
  ---
  icon: streamline:money-cash-dollar-coin-accounting-billing-payment-cash-coin-currency-money-finance
  title: GoCardless
  to: https://doc.dokos.io/v5/integrations/payments/gocardless
  ---
  L'intégration avec GoCardless permet de proposer des paiements par carte bancaire sur votre site Dokos.
  :::

  :::card
  ---
  icon: ic:outline-paypal
  title: PayPal
  to: https://doc.dokos.io/v5/integrations/payments/paypal
  ---
  L'intégration avec Paypal permet de proposer des paiements sur votre site Dokos.
  :::
::

## Messagerie / Chat

::card-group
  :::card
  ---
  icon: logos:discord-icon
  title: Discord
  to: https://doc.dokos.io/v5/dokos/integrations/discord
  ---
  Envoyez vos notifications directement sur Discord.
  :::

  :::card
  ---
  icon: tabler:brand-google-filled
  title: Google Chat
  to: https://doc.dokos.io/v5/dokos/integrations/google-chat
  ---
  Google Chat est un logiciel de communication développé par Google conçu pour les groupes et qui offre des services de messages privés, de conversation de groupes.
  :::

  :::card
  ---
  icon: material-symbols:android-messages
  title: Mattermost
  to: https://doc.dokos.io/v5/dokos/integrations/mattermost
  ---
  Mattermost est conçu comme un chat interne pour les organisations et les entreprises.
  :::

  :::card
  ---
  icon: logos:rocket-chat-icon
  title: Rocket Chat
  to: https://doc.dokos.io/v5/dokos/integrations/rocket-chat
  ---
  Envoyez vos notifications et utilisez la messagerie Rocket.Chat grâce à cette intégration.
  :::

  :::card
  ---
  icon: logos:slack-icon
  title: Slack
  to: https://doc.dokos.io/v5/dokos/integrations/slack
  ---
  Slack est une plateforme de communication collaborative.
  :::
::

## Connecteurs avancés

::card-group
  :::card
  ---
  icon: simple-icons:zapier
  title: Zapier
  to: https://doc.dokos.io/v5/integrations/zapier
  ---
  Zapier est une plateforme permettant à des personnes sans connaissances techniques de connecter différentes applications entre elles.
  :::

  :::card
  ---
  icon: logos:webhooks
  title: Webhooks
  to: https://doc.dokos.io/v5/dodock/fonctionnalites/webhooks
  ---
  Les Webhooks sont des "rappels HTTP définis par l'utilisateur". Pour un DocType sélectionné, vous pouvez créer un webhook qui se déclenche sur des événements de document spécifiques sous certaines conditions, si nécessaire.
  :::

  :::card
  ---
  icon: logos:webhooks
  title: Webhooks entrants
  to: https://doc.dokos.io/v5/dokos/integrations/incoming-webhook-url
  ---
  Les webhooks permettent de déclencher une action suite à un événement. Ils sont généralement utilisés pour faire communiquer des systèmes. C’est la façon la plus simple de recevoir une alerte lorsque quelque chose se produit dans un autre système.
  :::
::


# URL de webhook entrant

Les webhooks permettent de déclencher une action suite à un événement. Ils sont généralement utilisés pour faire communiquer des systèmes. C’est la façon la plus simple de recevoir une alerte lorsque quelque chose se produit dans un autre système.

Les webhooks entrants vont permettre au système de Dokos d'envoyer à un autre système des informations. Par exemple, vous allez envoyer sur un outil collaboratif qu'un ticket client a été reçu.

## 1. Configuration du Webhook entrant depuis Dokos

Il faut maintenant créer le Webhook entrant permettant de dire au logiciel de lier Dokos avec Rocket Chat.

1. Accédez au document **URL Webhook entrant** en allant sur :

> Accueil > Intégration > Paramètres > URL de webhook entrant

![liste\_webhook.png](https://doc.dokos.io/content/integrations/google-chat/liste_webhook.png)

2. Cliquez sur Ajouter **URL Webhook entrant**
3. Indiquez le **nom** du Webhook entrant
4. Sélectionnez l'outil de collaboration concerné
5. Dans la section URL du webhook, il suffit d'insérer l'URL que vous avez copié dans l'outil de collaboration sélectionné
6. Faites **Enregistrer**

![slack\_intégration.png](https://doc.dokos.io/content/integrations/slack/slack_integration.png)


# Intégration Agicap

[Agicap](https://agicap.com){rel="&#x22;nofollow&#x22;"} est un logiciel de gestion et de prévisions de trésorerie.

Une application dédiée permet de synchronisez vos factures d'achat et de ventes avec Agicap pour améliorer vos prévisionnels et projections.

## Installation

1. Installez [Dokos CLI & Dodock](https://doc.dokos.io/dodock/installation){rel="&#x22;nofollow&#x22;"}.
2. Une fois l'installation terminée, ajoutez l'application Agicap à votre bench en lançant
   ```text
   $ bench get-app agicap --branch develop https://gitlab.com/dokos/agicap.git
   ```

3. Installez l'application Agicap sur votre site en lançant

   ```text
   $ bench --site <sitename> install-app agicap
   ```

## Périmètre de l'intégration

Cette application permet de synchroniser vos factures de vente et vos factures d'achat avec Agicap. :br
Vous pouvez connecter plusieurs sociétés et créer plusieurs comptes pour chacune des devises que vous utilisez.

Actuellement le système synchronise les factures de vente et les factures d'achat une fois par heure. :br
Les nouvelles factures créées des transactions en attente dans Agicap. :br
En cas de modifications sur vos factures, les transactions attendues sont mises à jour sur Agicap. :br
En cas d'annulation d'une facture, la transaction correspondante est supprimée sur Agicap.

::callout{color="teal" icon="i-heroicons-light-bulb"}
La synchronisation est effectuée automatiquement une fois par heure
::


# Amazon MWS

Le connecteur Amazon extrait les produits et les commandes client de la market place Amazon. La synchronisation des produits et des commandes clients est séquentielle. Vous devez synchroniser les produits avant de synchroniser les commandes client.

## 1. Comment configurer le connecteur Amazon MWS ?

### 1.1 Configuration des informations d'identification dans Dokos

Vous pouvez demander les informations d'identification du développeur à Amazon MWS une fois que vous êtes un vendeur enregistré sur leur site Web.

### 1.2 Configurer les informations d'identification MWS

Saisissez l'ID du vendeur, l'ID de la clé d'accès AWS, le jeton d'authentification MWS, la clé secrète, l'ID de la place de marché, la région et le domaine.

![paramètres\_amazon.png](https://doc.dokos.io/content/settings/amazon/parame%CC%80tres_amazon.png)

### 1.3 Configurer les détails de la commande

Configurez la société, l'entrepôt, le groupe d'articles, la liste de prix, le groupe de clients, le territoire, le type de client et le groupe de comptes. Le groupe de comptes est utilisé pour détenir les commissions, les taxes, etc. facturées par Amazon.

![détails\_société\_amazon.png](https://doc.dokos.io/content/settings/amazon/details_societe_amazon.png)

### 1.4 Configurer les configurations de synchronisation

À l'aide de la date d'après, vous pouvez synchroniser les produits et les commandes créés après une date particulière. Si vous importez beaucoup de données historiques, il est suggéré de commencer dans l'ordre chronologique inverse de la date d'après et d'importer les données par petits morceaux.

Après avoir configuré toutes les configurations, cliquez sur Activer Amazon et enregistrez les paramètres. Vous êtes maintenant prêt à utiliser l'intégration.

![synchronis.png](https://doc.dokos.io/content/settings/amazon/synchronis.png)

### 1.5 Synchroniser les produits

Cliquez sur ce bouton pour synchroniser les produits. Une fois cela réussi, vous devriez voir vos produits Amazon en tant qu'articles dans ERPNext.

### 1.6 Synchroniser les commandes

Cliquez sur ce bouton pour synchroniser les commandes client. Une fois cela réussi, vous devriez voir vos commandes Amazon en tant que commandes client dans Dokos. Vous pouvez également configurer le planificateur pour synchroniser automatiquement les commandes.

**Noter**

Le connecteur ne gérera pas l'annulation de la commande. Si vous avez annulé une commande sur Amazon, vous devez annuler manuellement la commande client respective et les autres documents dans Dokos.


# Amazon S3

Amazon S3 est le service de stockage principal d’Amazon Web Services. Il permet de stocker une quantité « virtuellement » illimitée de données avec une très haute disponibilité.

La grande particularité d’Amazon S3 réside dans le stockage en mode objet : contrairement au stockage en mode block ou file storage, un objet dans Amazon S3 est composé de data et de metadata, et répond à une API REST

## 1. Télécharger des sauvegardes sur Amazon S3

**Conditions préalables**

- Compte email

Pour recevoir des e-mails pour les sauvegardes échouées et réussies, veuillez d'abord créer un compte de messagerie.

### 1.1 Créer un compartiment S3 et configurer l'accès

1. Créez un nouveau compartiment s3.

Dans les paramètres du bucket, activez **Bloquer tous les accès publics** pour garder vos données privées. N'hésitez pas à activer le chiffrement, la gestion des versions ou le verrouillage d'objet selon vos besoins (veuillez vous référer à la documentation d' Amazon ).

2. Ouvrez la gestion des identités et des accès (IAM).

   - Créez une nouvelle politique pour le Service "S3", autorisant les Actions "ListBucket" et "PutObject".
   - Créez un nouvel utilisateur pour l'accès par programmation.

![s3\_backup\_add\_user.png](https://doc.dokos.io/content/integrations/s3-backup-settings/s3_backup_add_user.png)

- Attachez la stratégie que vous avez créée au nouvel utilisateur.


  - Copiez la clé d'accès et le secret de l'utilisateur.

Pour supprimer automatiquement les anciennes sauvegardes ou les déplacer vers une classe de stockage moins chère, jetez un œil à la gestion du cycle de vie.

## 2. Configurer la sauvergarde S3 sur Dokos

Pour accéder aux **paramètres de sauvergade S3**, allez sur :

> Accueil > Intégration > Sauvegarde > **Paramètres de sauvegarde S3**

1. Allez dans les **paramètres de sauvegarde S3**.
2. Cochez la case **Activer la sauvegarde automatique**.
3. **Collez l'ID de Clé d'Accès** et la **Clé secrète d'accès**.
4. Définissez une adresse e-mail pour recevoir une notification lorsqu'une sauvegarde échoue. Si vous souhaitez également recevoir un e-mail pour des sauvegardes réussies, activez "Envoyer un e-mail pour une sauvegarde réussie".
5. Spécifiez le nom du bucket que vous avez créé à l'étape 1.
6. Choisissez la fréquence à laquelle vous souhaitez effectuer et télécharger des sauvegardes. Cela peut aller du mensuel au quotidien. Si vous souhaitez uniquement effectuer des sauvegardes manuelles, définissez la fréquence sur "Aucun".


# Discord

Si vous souhaitez que vos notifications soient envoyées à un canal Discord dédié, il faut d'abord créer un "webhook" sur Discord.

## Créer un webhook Discord

> Vous pouvez suivre [le guide officiel](https://support.discord.com/hc/en-us/articles/228383668-Intro-to-Webhooks){rel="&#x22;nofollow&#x22;"} pour plus d'informations.

Tout d'abord, rendez-vous dans l'application de bureau ou l'application web Discord sur ordinateur.
Ensuite, dans les paramètres du serveur Discord sur lequel vous souhaitez recevoir des notifications,
cliquez sur "Intégrations" puis sur le bouton "Créer un webhook".
Définissez un nom, une image de profil, et un canal sur lequel le webhook enverra les notifications.
Ensuite, cliquez sur "Copier l'URL du webhook".

## Configurer le webhook entrant dans Dokos

Dans Dokos, rendez-vous dans la liste des "URL de webhook entrant" et créez un nouveau document.

> Administration > Paramètres > Emails & Notifications > URL de webhook entrant

Sélectionnez le Service "Discord" et collez l'URL du webhook que vous avez copié précédemment, puis enregistrez.

## Utiliser le webhook dans une notification

Dans Dokos, rendez-vous dans la liste des "Notifications" et créez un nouveau document.

> Administration > Paramètres > Emails & Notifications > Notification

![Le champ "Canal" contient la valeur "Outil de collaboration externe", et le champ "URL de webhook entrant de l'outil de collaboration" contient la valeur "Discord"](https://doc.dokos.io/content/integrations/discord/notification-discord-1.png)

::callout{color="teal" icon="i-heroicons-light-bulb"}
Astuce : Un lien vers le document sur Dokos est automatiquement ajouté à la fin du message.
::

Une fois cela fait, vous pouvez configurer les autres champs de la notification comme vous le souhaitez, par exemple :

![Le champ "Type de document" contient la valeur "Commande client", le champ "Envoyer une alerte lors de l'événement" contient la valeur "Nouveau", et le champ "Condition" contient la valeur doc.order\_type == "Shopping Cart"](https://doc.dokos.io/content/integrations/discord/notification-exemple-1.png)

![Le champ "Sujet" contient la valeur "Nouvelle Commande", et le champ "Message" contient la valeur "Nouvelle commande "](https://doc.dokos.io/content/integrations/discord/notification-exemple-2.png)


# Paramètres Dropbox

Nous recommandons toujours aux clients de maintenir une sauvegarde de leurs données dans Dokos. La sauvegarde de la base de données est téléchargée sous la forme d'un fichier SQL. Si nécessaire, ce fichier SQL de sauvegarde peut également être restauré dans un autre compte Dokos.

Vous pouvez automatiser le téléchargement de la sauvegarde de la base de données de votre compte Dokos dans votre compte Dropbox.

---

Pour configurer une sauvegarde Dropbox, allez sur :

> Accueil > Intégrations > Paramètres Dropbox

## Comment paramétrer Dropobox ?

### 1. Configuration de base

1. Allez dans les **Paramètres Dropbox**.
2. Cochez la case **Activé**
3. **Envoyé des notifications à** : Indiquez une adresse email qui sera notifiée.
4. **Envoyer un courrier électronique pour une sauvegarde réussie** : Si la case est cochée alors un email sera envoyé lors d'une sauvergarde réussie. Remarque: un e-mail est envoyé par défaut si la sauvegarde échoue.
5. **Fréquence de sauvegarde** : Indiquez la fréquence de sauvergarde, soit quotidien ou soit hebdomadaire.
6. **Nombre limite de sauvegardes de base de données** : Si la case est cochée, alors vous pourrez indiquer un Nombre limite de sauvegardes de la base de données.
7. **Sauvegarde de fichier**: Cochez la case pour que la sauvegarde de fichier soit active.

### 2. Autorisation de l'accès à l'application

1. Indiquez la Clé d'Accès de l'App.
2. Indiquez Clé Secrète de l'App.
3. Puis faites, autoriser l'accès à l'application.

En cliquant sur ce bouton, la page de connexion Dropbox s'ouvrira dans le nouvel onglet. Cela peut vous obliger à autoriser les fenêtres contextuelles pour votre compte Dokos.

- Connectez-vous à votre compte Dropbox en saisissant vos identifiants de connexion.

Une fois la connexion réussie, vous trouverez un message de confirmation comme suit. Cliquez sur "**Autoriser**" pour permettre à votre compte ERPNext d'accéder à votre compte Dropbox.

Avec cela, un dossier appelé "**Dokos**" sera créé dans votre compte Dropbox et la sauvegarde de la base de données commencera à se télécharger automatiquement.


# Google

## Paramètres Google

*Dokos* peut être connecté avec plusieurs outils de la suite d'applications Google : Google Agenda, Google Drive, Google Contacts et Google Maps

---

Pour accéder au **paramétrage de Google**, allez sur :

> Accueil > Intégrations > **Paramètres Google**

Afin de connecter les outils Google avec *Dokos*, vous devez activer et paramétrer une intégration Oauth avec la plateforme Google Cloud.
Cela permet d'obtenir un jeton d'accès (autorisation d'accéder au service) de la part de Google pour le service que vous souhaitez utiliser.

::callout{color="blue" icon="i-mdi-information-outline"}
Pour connecter un compte **Gmail via OAuth** (par exemple pour l'envoi/réception d'e-mails), utilisez plutôt une **Application Connectée**. Consultez la page [Connexion Google via OAuth (Application Connectée)](https://doc.dokos.io/v5/dodock/integrations/connected-app-google-oauth).
::

## 1. Paramétrage pour Agenda, Drive and Contacts

1. Allez sur <https://console.cloud.google.com/>{rel="&#x22;nofollow&#x22;"}
2. Utilisez un projet existant ou créez un nouveau projet
3. Dans **API and Services** sélectionnez **Credentials**
4. Cliquez sur **Create credentials** et sélectionnez **OAuth Client ID**![oauth\_client\_creation.png](https://doc.dokos.io/content/integrations/google/oauth_client_creation.png)
5. Sélectionnez **Web Application**
6. Dans **Authorized Javascript origins** ajoutez l'URL de votre site: `https://{votresite}&#x60; (Ex. &#x2A;*<https://dokos.io>{rel="&#x22;nofollow&#x22;"}**)
7. Dans **Authorized redirect URIs** ajoutez les URLs suivantes en fonction de vos besoins d'intégration:

   - Google Agenda: `https://{votresite}?cmd=frappe.integrations.doctype.google_calendar.google_calendar.google_callback`
   - Google Contacts: `https://{votresite}?cmd=frappe.integrations.doctype.google_contacts.google_contacts.google_callback`
   - Google Drive: `https://{votresite}?cmd=frappe.integrations.doctype.google_drive.google_drive.google_callback`
8. Enregistrez et copiez/collez le **Client ID** et **Client Secret** générés dans les champs correspondants du document **Google Settings** de *Dokos*
9. Allez dans **OAuth consent screen** et ajoutez votre domaine aux **Authorized domains**![oauth\_consent\_setup.png](https://doc.dokos.io/content/integrations/google/oauth_consent_setup.png)
10. . Allez dans **Library** et activez les APIs nécessaires: **Contacts API**, **Google Calendar API** et/ou **Google Drive API**

## 2. Paramétrage pour Maps

L'accès à Google Maps ne nécessite pas de connexion OAuth, seulement une clé API spécifique.

1. Allez sur <https://console.cloud.google.com/>{rel="&#x22;nofollow&#x22;"}
2. Utilisez un projet existant ou créez un nouveau projet
3. Dans **API and Services** sélectionnez **Credentials**
4. Cliquez sur **Create credentials** et sélectionnez **API key**
5. Allez dans **Bibliothèque** et activez la librairie **Geocoding API**
6. Copiez et collez cette clé dans le champs **API key** du document **Google Settings** de *Dokos*


# Google Agenda

Dokos fournit une intégration avec Google Agenda afin que tous les utilisateurs puissent synchroniser leurs événements Google Agenda avec Dokos.

---

Pour accéder à la liste de **Google Agenda**, allez sur :

> Accueil > Intégrations > Services Google > **Google Agenda**

![liste\_google\_agenda.png](https://doc.dokos.io/content/integrations/google-agenda/liste_google_agenda.png)

## 1. Comment configurer l'intégration de Google Agenda

Afin de permettre une synchronisation avec Google Calendar, vous devez autoriser Dokos à obtenir les données d'événements de l'agenda de Google.

### 1.1 L'intégration de Google Agenda est configurée avec les étapes suivantes :

1. Créez des i**nformations d'identification OAuth 2.0** via les paramètres Google.

![paramètres\_google.png](https://doc.dokos.io/content/integrations/contacts-google/parametres_google.png)

2. Dans la liste **Google Agenda**, cliquez sur **Nouveau**. Saisissez le nom du calendrier et l'utilisateur pour lequel vous souhaitez synchroniser, puis enregistrez-le.
3. Selon les données que vous souhaitez synchroniser, vous pouvez sélectionner les éléments suivants.


   - **Importer depuis Google Agenda** - Synchronise tous les événements de Google Calendar vers Dokos.
   - **Envoyer vers Google Agenda** - Synchronise tous les événements de Dokos à Google Agenda.
4. Une fois autorisé, vous pouvez synchroniser manuellement l'événement Google Agenda ou laisser Dokos synchroniser les contacts Google quotidiennement.

![nouveau\_google\_agenda.png](https://doc.dokos.io/content/integrations/google-agenda/nouveau_google_agenda.png)

## 2. Comment utiliser l'intégration de Google Agenda

1. Créer un **événement** dans Dokos
2. Une fois l'intégration de Google Agenda réussie, tous les événements créés dans Dokos seront synchronisés si la case **Envoyer à Google Agenda** est cochée.


   - Créer un événement dans Dokos
   - Supprimer un événement dans Dokos

## 3. Synchronisation d'événements à partir de Google Agenda

Une fois l'intégration de Google Calendar réussie, tous les événements de Google Agenda seront synchronisés si la case **Importer depuis Google Agenda** est cochée.
Synchronisation des événements de Google Calendar vers ERPNext


# Google Chat

**Google Chat** est une plateforme de communication crée par Google. Ce logiciel a été conçu pour les équipes qui fournit des messages directs et des salles de chat d'équipe, similaires aux concurrents Slack et Microsoft Teams, ainsi qu'une fonction de messagerie de groupe qui permet le partage de contenu sur Google Drive.

## 1. Accès à Google Chat et configuration

Pour ce faire, il faut avoir un compte Google Workspace.

1. Rendez-vous à l'adresse suivante : &#x2A;*[](https://mail.google.com/chat)<https://mail.google.com/chat>{rel="&#x22;nofollow&#x22;"}**
2. Cliquez en bas à gauche, dans **Salles*&#x2A;. Cliquez sur &#x2A;*+** et ajoutez un **Espace de travail**

![ajouter\_salle.png](https://doc.dokos.io/content/integrations/google-chat/ajouter_salle.png)

3. Indiquez le nom de votre **Espace de travail**

![détails.png](https://doc.dokos.io/content/integrations/google-chat/details.png)

4. Puis cliquez en haut, sur la section **Nom de l'espace de travail**
5. Faites **Gérer les Webhooks**

![webhook\_création.png](https://doc.dokos.io/content/integrations/google-chat/webhook_creation.png)

6. Sur la fenêtre qui s'ouvre, vous avez l'URL de votre Webhook entrant, copiez-le. Il sera à insérer sur la plateforme Dokos.

![url.png](https://doc.dokos.io/content/integrations/google-chat/url.png)

## 2. Configuration du Webhook depuis Dokos

Il faut maintenant créer le Webhook permettant de dire au logiciel de lier Dokos avec Google Chat.

1. Accédez au document **URL Webhook entrant** en allant sur :

> Accueil > Intégration > Paramètres > URL de webhook entrant

![liste\_webhook.png](https://doc.dokos.io/content/integrations/google-chat/liste_webhook.png)

2. Cliquez sur Ajouter **URL Webhook entrant**
3. Indiquez le **nom** du Webhook entrant
4. Sélectionnez le service **Google Chat**
5. Dans la section URL du webhook, il suffit d'insérer l'URL que vous avez copié dans Google Chat (Étape 6 - Accès à Google Chat et configuration)
6. Faites **Enregistrer**

![google\_chat.png](https://doc.dokos.io/content/integrations/google-chat/google_chat.png)

## 3. Configuration des notifications

Il faut créer une notification permettant de dire au logiciel à quelle action une information sera envoyée sur Google Chat.

1. Accéder au document **Notification** en allant sur :

> Accueil > Paramètres > Email / Notifications > **Notification**

![liste\_notification.png](https://doc.dokos.io/content/integrations/google-chat/liste_notification.png)

2. Cliquez sur **Ajouter une notification**
3. Ajoutez les informations suivantes :


   - Indiquez un **nom** de notification
   - **Activé** : Si cochée, alors la notificatio sera active
   - Sélectionnez un **canal** : Choisissez **Outil de collaboration externe**
   - URL de Webhook entrant de l'outil de collaboration : Sélectionnez le Webhhook entrant que vous avez créé à l'**étape 2.2**.

![détails\_notification.png](https://doc.dokos.io/content/integrations/google-chat/details_notification.png)

## 4 Détails de notification

### 4.1 Filtres

Depuis cette section, gérez vos paramètres de **Filtres** :

1. **Sujet** : Ajoutez un nom de sujet pour votre notification. Vous pouvez ajouter un sujet dynamique en utilisant les tags Jinja.
2. **Type de document** : Sélectionnez le type de document pour lequel une notification sera effectué.
3. **Envoyer une alerte lors de l'événement** : Choisissez pour quelle action la notification sera exécutée (Nouveau, Enregistrer, Valider, annuler...)
4. **Envoyer une notifiaction système** : Si activé, la notification apparaîtra dans les notifications en haut à droite de la barre de navigation
5. **Conditions** : Vous pouvez définir des conditions pour l'envoi de la notification.

   - Exemples de conditions :

   :brdoc.status=="Open"
   doc.due\_date==nowdate()
   doc.total > 40000

![filtres\_notification.png](https://doc.dokos.io/content/integrations/google-chat/filtres_notification.png)

### 4.2 Modifier une propriété après la notification

Depuis cette section, gérez vos paramètres de **modification de propriété après la notification** :

Vous pouvez choisir de modifier une propriété après la notification puis il faut définir une valeur qui sera concerné par cette modification.

![modifier\_une\_propriété.png](https://doc.dokos.io/content/integrations/google-chat/modifier_une_propriete.png)

### 4.3 Message

Depuis cette section, gérez vos messages qui seront envoyés sur **Google Chat** :

Vous pouvez saisir votre message qui sera envoyé sur Google Chat. Utilsez les champs des documents pour les personnaliser.

Voici un exemple de message :

`*Nouveau ticket*`

`Nouvelle demande n° {{ doc.name }}.`

`*Détails*`

`• Client : {{ doc.customer }}``• Sujet : {{ doc.subject }}``• Message : {{ doc.description }}`

![message\_notification.png](https://doc.dokos.io/content/integrations/google-chat/message_notification.png)

#### 5. Tester la notification

1. Vous pouvez simplement tester votre notification en cliquant sur le bouton en haut à droite **Tester cette notification**.

![tester\_notification.png](https://doc.dokos.io/content/integrations/google-chat/tester_notification.png)

2. Vérifiez maintenant sur Google Chat que vous avez bien reçu la notification.

![vérification\_test.png](https://doc.dokos.io/content/integrations/google-chat/verification_test.png)


# Google Contacts

Dokos fournit une intégration avec Google Contacts afin que tous les utilisateurs puissent synchroniser leurs Google Contacts avec Dokos.

---

Pour accéder à la liste des contacts Google, allez sur :

> Accueil > Intégrations > Services Google > **Contacts Google**

![liste\_contact\_google.png](https://doc.dokos.io/content/integrations/contacts-google/liste_contact_google.png)

## 1. Comment configurer l'intégration des contacts Google ?

Afin de permettre une synchronisation avec Google Contacts, vous devez autoriser Dokos à récupérer les données de Contacts de Google. L'intégration de Google Contacts est configurée avec les étapes suivantes :

1. **Créez des informations d'identification** OAuth 2.0 via les paramètres Google.

![paramètres\_google.png](https://doc.dokos.io/content/integrations/contacts-google/parametres_google.png)

2. Dans la liste des contacts Google, cliquez sur **Nouveau**
3. Saisissez l'**e-mail du compte Google** que vous souhaitez synchroniser, puis enregistrez-le.
4. Cliquez maintenant sur **Autoriser l'accès aux contacts** pour autoriser Dokos à obtenir les données des contacts de Google.

![nouveau\_contact\_google.png](https://doc.dokos.io/content/integrations/contacts-google/nouveau_contact_google.png)

## 2. Comment utiliser l'intégration des contacts Google

1. Créer un **Contact** dans Dokos
2. Une fois l'intégration de Google Contacts réussie, tous les contacts créés dans Dokos seront synchronisés si **Envoyer à Google Contact Contact** est cochée.

## 3. Synchroniser les contacts à partir de Google Contacts

Une fois l'intégration de Google Contacts réussie, tous les contacts de Google Contacts seront synchronisés si la case **Récupérer depuis Google contact** est cochée.


# Google Drive

Google Drive est un service de stockage et de synchronisation de fichiers développé par Google. Il permet aux utilisateurs de stocker, synchroniser et partager des fichiers. Google Drive est un élément clé de Google Workspace, l'offre d'abonnement mensuel de Google pour les entreprises.

Vous pouvez utiliser le sélecteur de fichiers de Frappe Framework pour sélectionner n'importe quel fichier dans Google Drive et le joindre au DocType actuel. Par exemple, vous pouvez joindre la facture PDF stockée dans Google Drive à un enregistrement de facture de vente dans votre application Frappe.

## Installer

1. Allez sur <https://console.cloud.google.com/>{rel="&#x22;nofollow&#x22;"}
2. Utilisez un projet existant ou créez un nouveau projet
3. Dans **API and Services** sélectionnez **Credentials**
4. Cliquez sur **Create credentials** et sélectionnez **OAuth Client ID**![oauth\_client\_creation.png](https://doc.dokos.io/content/integrations/google/oauth_client_creation.png)
5. Sélectionnez **Web Application**
6. Dans **Authorized Javascript origins** ajoutez l'URL de votre site: `https://{votresite}&#x60; (Ex. &#x2A;*<https://dokos.io>{rel="&#x22;nofollow&#x22;"}**)
7. Dans **Authorized redirect URIs** ajoutez les URLs suivantes en fonction de vos besoins d'intégration:


   - Google Drive: `https://{votresite}?cmd=frappe.integrations.doctype.google_drive.google_drive.google_callback`
8. Enregistrez et copiez/collez le **Client ID** et **Client Secret** générés dans les champs correspondants du document **Google Settings** de *Dokos*
9. Allez dans **OAuth consent screen** et ajoutez votre domaine aux **Authorized domains**![oauth\_consent\_setup.png](https://doc.dokos.io/content/integrations/google/oauth_consent_setup.png)
10. Allez dans **Library** et activez les APIs nécessaires: **Contacts API**, **Google Calendar API** et/ou **Google Drive API**

### Instance de Dokos

Maintenant que l'API Google Picker est activée et que nous avons les informations d'identification nécessaires, nous pouvons continuer et configurer les paramètres Google dans votre instance Frappe.

1. Ouvrez les paramètres Google .
2. Cochez la case "Activer".
3. Dans la section Google Drive Picker , cochez la case "Google Drive Picker Enabled".
4. Saisissez votre identifiant d'application, votre identifiant client et votre clé API.
5. Enregistrez les paramètres Google et rechargez la fenêtre de votre navigateur.

### Paramètres Google

Maintenant, lorsque vous cliquez sur "Joindre un fichier" dans la barre latérale, vous devriez voir l'icône Google Drive.

Boîte de dialogue Joindre un fichier

Si vous cliquez dessus la première fois, vous devez autoriser l'application Frappe à accéder à vos fichiers Google Drive.

Connexion Google

Ensuite, le sélecteur Google Drive s'ouvre où vous pouvez choisir un fichier.

Sélecteur de Google Drive

Cliquez sur le bouton bleu en bas à gauche pour joindre un lien vers ce fichier au DocType actuel.


# Mattermost

## 1. Accès à Mattermost et configuration

1. Accédez à l'application de Mattermost en allant sur : &#x2A;*[](https://mattermost.com/)<https://mattermost.com/>{rel="&#x22;nofollow&#x22;"}**.
   Créez vous un compte sur la plateforme ou connectez-vous si vous en avez déjà un.
2. Allez sur les canaux de chat

![liste\_canaux.png](https://doc.dokos.io/content/integrations/mattermost/liste_canaux.png)

3. Ajoutez un **nouveau canal*&#x2A;, en cliquant en haut sur le &#x2A;*+** et faites **Créer un nouveau canal**

![ajouter\_un\_espace.png](https://doc.dokos.io/content/integrations/mattermost/ajouter_un_espace.png)

4. Indiquez le **nom du canal**

![gestion\_des\_tickets.png](https://doc.dokos.io/content/integration/mattermost/gestion_des_tickets.png)

5. Allez sur gestion des intégrations en cliquant sur le **menu en haut à gauche** et sélectionnez **Intégrations**

![retour\_aux\_intégrations.png](https://doc.dokos.io/content/integrations/mattermost/retour_aux_integrations.png)

6. Cliquez sur **Webhooks entrant**

![webhook\_entrant.png](https://doc.dokos.io/content/integration/mattermost/webhook_entrant.png)

7. Ajoutez un **nouveau Webhook entrant**

![ajouter\_url.png](https://doc.dokos.io/content/integrations/mattermost/ajouter_url.png)

8. Donnez un **nom** à votre nouveau Webhook entrant et **sélectionnez le canal** qui recevra le webhook.

![validation\_url.png](https://doc.dokos.io/content/integrations/mattermost/validation_url.png)

9. Copiez le lien créé, revenez sur la plateforme Dokos et utilisez-le pour créer une nouvelle URL Mattermost Webhook.

![copier\_url.png](https://doc.dokos.io/content/integrations/mattermost/copier_url.png)

## 2. Configuration du Webhook entrant depuis Dokos

Il faut maintenant créer le Webhook entrant permettant de dire au logiciel de lier Dokos avec Mattermost.

1. Accédez au document **URL Webhook entrant** en allant sur :

> Accueil > Intégration > Paramètres > URL de webhook entrant

![liste\_webhook.png](https://doc.dokos.io/content/integrations/google-chat/liste_webhook.png)

2. Cliquez sur Ajouter **URL Webhook entrant**
3. Indiquez le **nom** du Webhook entrant
4. Sélectionnez le service **Mattermost**
5. Dans la section URL du webhook, il suffit d'insérer l'URL que vous avez copié dans Mattermost (Étape 9 - Accès à Slack et configuration)
6. Faites **Enregistrer**

![création\_url\_entrant.png](https://doc.dokos.io/content/integrations/mattermost/creation_url_entrant.png)

## 3. Configuration des notifications

Il faut créer une notification permettant de dire au logiciel à quelle action une information sera envoyée sur Mattermost.

1. Accéder au document **Notification** en allant sur :

> Accueil > Paramètres > Email / Notifications > **Notification**

![liste\_notification.png](https://doc.dokos.io/content/integrations/google-chat/liste_notification.png)

2. Cliquez sur **Ajouter une notification**
3. Ajoutez les informations suivantes :


   - Indiquez un **nom** de notification
   - **Activé** : Si cochée, alors la notificatio sera active
   - Sélectionnez un **canal** : Choisissez **Outil de collaboration externe**
   - URL de Webhook entrant de l'outil de collaboration : Sélectionnez le Webhhook entrant que vous avez créé à l'**étape 2.2**.

![détails\_notification.png](https://doc.dokos.io/content/integrations/google-chat/details_notification.png)

## 4 Détails de notification

### 4.1 Filtres

Depuis cette section, gérez vos paramètres de **Filtres** :

1. **Sujet** : Ajoutez un nom de sujet pour votre notification. Vous pouvez ajouter un sujet dynamique en utilisant les tags Jinja.
2. **Type de document** : Sélectionnez le type de document pour lequel une notification sera effectué.
3. **Envoyer une alerte lors de l'événement** : Choisissez pour quelle action la notification sera exécutée (Nouveau, Enregistrer, Valider, annuler...)
4. **Envoyer une notifiaction système** : Si activé, la notification apparaîtra dans les notifications en haut à droite de la barre de navigation
5. **Conditions** : Vous pouvez définir des conditions pour l'envoi de la notification.

   - Exemples de conditions :

   :brdoc.status=="Open"
   doc.due\_date==nowdate()
   doc.total > 40000

*Par exemple dans ce cas, dès que le statut du document est égal à **ouvert**, que la date du document est égale à **ajourd'hui** et que le Montant du document est **supérieur à 4000** alors il faut réaliser l'action.*

![filtres\_notification.png](https://doc.dokos.io/content/integrations/google-chat/filtres_notification.png)

### 4.2 Modifier une propriété après la notification

Depuis cette section, gérez vos paramètres de **modification de propriété après la notification** :

Vous pouvez choisir de modifier une propriété après la notification puis il faut définir une valeur qui sera concerné par cette modification.

![modifier\_une\_propriété.png](https://doc.dokos.io/content/integrations/google-chat/modifier_une_propriete.png)

### 4.3 Message

Depuis cette section, gérez vos messages qui seront envoyés sur **Mattermost** :

Vous pouvez saisir votre message qui sera envoyé sur Mattermost. Utilsez les champs des documents pour les personnaliser.

Voici un exemple de message :

`*Nouveau ticket*`

`Nouvelle demande n° {{ doc.name }}.`

`*Détails*`

`• Client : {{ doc.customer }}``• Sujet : {{ doc.subject }}``• Message : {{ doc.description }}`

![message\_notification.png](https://doc.dokos.io/content/integrations/google-chat/message_notification.png)

#### 5. Tester la notification

1. Vous pouvez simplement tester votre notification en cliquant sur le bouton en haut à droite **Tester cette notification**.

![tester\_notification.png](https://doc.dokos.io/content/integrations/google-chat/tester_notification.png)

2. Vérifiez maintenant sur Mattermost que vous avez bien reçu la notification.

![vérification\_mattermost.png](https://doc.dokos.io/content/integrations/mattermost/verification_mattermost.png)


# Rocket Chat

Si vous souhaitez que vos notifications soient envoyées à un canal Rocket Chat dédié, vous pouvez également choisir l'option **Rocket Chat** dans les options du canal et sélectionner l'URL du Webhook Rocket Chat appropriée.

## 1. Accès et connexion à Rocket Chat

1. Allez sur &#x2A;*[](https://rocket.chat/get-started)<https://rocket.chat/get-started>{rel="&#x22;nofollow&#x22;"}**
2. Accédez à votre **panneau d'administratio**n
3. Allez dans **Intégrations**
4. Créez une **nouvelle intégration** et sélectionnez nouveau Webhook entrant.
5. Sélectionnez le **canal** dans lequel vous voulez recevoir les alertes ; il est possible de le modifier dans les messages.
6. Définissez le scritp activé sur Vrai
7. Collez votre script dans le champ Script
8. Sauvegardez l'intégration
9. Copiez le lien créé, revenez sur la plateforme Dokos et utilisez-le pour créer une nouvelle URL Rocket Chat Webhook.

## 2. Configuration du Webhook entrant depuis Dokos

Il faut maintenant créer le Webhook entrant permettant de dire au logiciel de lier Dokos avec Rocket Chat.

1. Accédez au document **URL Webhook entrant** en allant sur :

> Accueil > Intégration > Paramètres > URL de webhook entrant

![liste\_webhook.png](https://doc.dokos.io/content/integrations/google-chat/liste_webhook.png)

2. Cliquez sur Ajouter **URL Webhook entrant**
3. Indiquez le **nom** du Webhook entrant
4. Sélectionnez le service **Rocket Chat**
5. Dans la section URL du webhook, il suffit d'insérer l'URL que vous avez copié dans Rocket Chat (Étape 9 - Accès à Rocket Chat et configuration)
6. Faites **Enregistrer**

![slack\_intégration.png](https://doc.dokos.io/content/integrations/slack/slack_integration.png)

## 3. Configuration des notifications

Il faut créer une notification permettant de dire au logiciel à quelle action une information sera envoyée sur Rocket Chat.

1. Accéder au document **Notification** en allant sur :

> Accueil > Paramètres > Email / Notifications > **Notification**

![liste\_notification.png](https://doc.dokos.io/content/integrations/google-chat/liste_notification.png)

2. Cliquez sur **Ajouter une notification**
3. Ajoutez les informations suivantes :


   - Indiquez un **nom** de notification
   - **Activé** : Si cochée, alors la notificatio sera active
   - Sélectionnez un **canal** : Choisissez **Outil de collaboration externe**
   - URL de Webhook entrant de l'outil de collaboration : Sélectionnez le Webhhook entrant que vous avez créé à l'**étape 2.2**.

![détails\_notification.png](https://doc.dokos.io/content/integrations/google-chat/details_notification.png)

## 4 Détails de notification

### 4.1 Filtres

Depuis cette section, gérez vos paramètres de **Filtres** :

1. **Sujet** : Ajoutez un nom de sujet pour votre notification. Vous pouvez ajouter un sujet dynamique en utilisant les tags Jinja.
2. **Type de document** : Sélectionnez le type de document pour lequel une notification sera effectué.
3. **Envoyer une alerte lors de l'événement** : Choisissez pour quelle action la notification sera exécutée (Nouveau, Enregistrer, Valider, annuler...)
4. **Envoyer une notifiaction système** : Si activé, la notification apparaîtra dans les notifications en haut à droite de la barre de navigation
5. **Conditions** : Vous pouvez définir des conditions pour l'envoi de la notification.

   - Exemples de conditions :

   :brdoc.status=="Open"
   doc.due\_date==nowdate()
   doc.total > 40000

*Par exemple dans ce cas, dès que le statut du document est égal à **ouvert**, que la date du document est égale à **ajourd'hui** et que le Montant du document est **supérieur à 4000** alors il faut réaliser l'action.*

![filtres\_notification.png](https://doc.dokos.io/content/integrations/google-chat/filtres_notification.png)

### 4.2 Modifier une propriété après la notification

Depuis cette section, gérez vos paramètres de **modification de propriété après la notification** :

Vous pouvez choisir de modifier une propriété après la notification puis il faut définir une valeur qui sera concerné par cette modification.

![modifier\_une\_propriété.png](https://doc.dokos.io/content/integrations/google-chat/modifier_une_propriete.png)

### 4.3 Message

Depuis cette section, gérez vos messages qui seront envoyés sur **Rocket Chat** :

Vous pouvez saisir votre message qui sera envoyé sur Rocket Chat. Utilsez les champs des documents pour les personnaliser.

Voici un exemple de message :

`*Nouveau ticket*`

`Nouvelle demande n° {{ doc.name }}.`

`*Détails*`

`• Client : {{ doc.customer }}``• Sujet : {{ doc.subject }}``• Message : {{ doc.description }}`

![message\_notification.png](https://doc.dokos.io/content/integrations/google-chat/message_notification.png)

#### 5. Tester la notification

1. Vous pouvez simplement tester votre notification en cliquant sur le bouton en haut à droite **Tester cette notification**.

![tester\_notification.png](https://doc.dokos.io/content/integrations/google-chat/tester_notification.png)

2. Vérifiez maintenant sur Rocket Chat que vous avez bien reçu la notification.


# Shopify

Le connecteur Shopify extrait les commandes de Shopify et crée une commande client par rapport à elles dans ERPNext.

Lors de la création de la commande client si le client ou l'article est manquant dans Dokos, le système créera un nouveau client/article en extrayant les détails respectifs de Shopify.

## 1. Comment configurer le connecteur ?

Shopify Connector est retiré de Dokos et disponible via une application Frappe sur Frappe Cloud Marketplace

### 1.1 Note aux utilisateurs de l'ancien connecteur Shopify

Si vous n'avez pas configuré Shopify Connector sur votre site ERPNext, vous pouvez passer à l'étape suivante.

Si vous utilisez l'ancienne intégration Shopify fournie dans ERPNext, vous devrez désactiver le connecteur avant de continuer. Après avoir installé l'application, elle migrera les données existantes, par exemple l'identifiant unique du produit pour les éléments, afin de séparer le type de document. Une fois que vous avez terminé de configurer la nouvelle intégration, vous pouvez confirmer l'état de la migration en accédant au doctype « Journal d'intégration du commerce électronique ».

### 1.2 Créer une application privée dans Shopify

Cliquez sur Applications dans la barre de menu Section de menu

Cliquez sur Gérer les applications privées pour créer une application privée Gérer les applications privées

Remplissez les détails et créez l'application. Chaque application a sa propre clé API, mot de passe et secret partagé Détails de l'application

Autorisez les autorisations suivantes à l'application.

- Brouillons de commandes - Lire et écrire
- Commandes - Lire et écrire
- Emplacement - Lire
- Clients - Lire
- Ordres d'exécution affectés - Lecture et écriture
- Produits - Lire et écrire
- Listes de produits - Lire et écrire
- Inventaire - Lire et écrire

## 2. Configuration de Shopify sur ERPNext

Une fois que vous avez créé une application privée sur Shopify, configurez les informations d'identification de l'application et d'autres détails dans les paramètres Shopify dans Dokos.

Pour accéder aux paramètres Shopify, accédez à : Barre de recherche géniale > Paramètres Shopify

1. Remplissez l'URL du site Shopify, le mot de passe et le secret partagé à partir de l'application privée de Shopify. Configurer les informations d'identification de l'application privée
2. Configurer les configurations client, entreprise et inventaire.
3. Configurer les configurations de synchronisation. Le système extrait les commandes de Shopify et crée la commande client dans ERPNext. Vous pouvez configurer le système ERPNext pour capturer le paiement et les exécutions par rapport aux commandes. Configuration de synchronisation Shopify pour les commandes
4. Configurer Tax Mapper. Préparez un mappeur de taxes et de frais d'expédition pour chaque taxe et frais d'expédition que vous appliquez dans Shopify. Vous pouvez trouver le nom de vos taxes sur votre page d'administration Shopify. Cartographie fiscale Shopify Trouver les noms de taxe Shopify

Après avoir configuré toutes les configurations, activez la synchronisation Shopify et enregistrez les paramètres. Cela enregistrera les API sur Shopify et le système lancera la synchronisation des commandes entre Shopify et Dokos.

## 3. Synchroniser les anciennes commandes de Shopify

Une fois que vous avez terminé la configuration de Shopify et que vous avez activé Shopify Syncing, vous disposez également d'une disposition pour synchroniser vos anciennes commandes de Shopify dans ERPNext. Cette synchronisation se fera en arrière-plan et peut prendre quelques heures selon le nombre de commandes que vous avez.

1. Activer "Synchroniser les anciennes commandes Shopify"
2. Saisissez les dates de début et de fin entre lesquelles les commandes doivent être synchronisées shopify synchroniser les anciennes commandes

## 4. Synchronisation d'inventaire

Vous pouvez mettre à jour votre inventaire avec Shopify pour les articles synchronisés depuis Shopify. La synchronisation de l'inventaire est effectuée toutes les heures avec une tâche planifiée. Les niveaux d'inventaire des articles qui ont changé depuis la dernière synchronisation sont transférés vers Shopify. Les niveaux d'inventaire des entrepôts ERPNext sont mappés 1 à 1 avec les emplacements Shopify.

1. Pour activer la synchronisation des stocks, cliquez sur la case à cocher, cela vous montrera un tableau pour mapper l'entrepôt ERPNext avec Shopify Location.
2. Sélectionnez la fréquence de synchronisation. 30 à 60 minutes est la fréquence recommandée.
3. Cliquez sur le bouton "Récupérer les emplacements Shopify" pour remplir les emplacements Shopify dans le tableau.
4. Reliez chaque emplacement à l'entrepôt ERPNext.
5. Enregistrez les paramètres.

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
**Remarque** : ce connecteur suppose qu'ERPNext est la principale source d'informations sur les niveaux de stock, toute modification apportée aux niveaux de stock de Shopify sera écrasée par ERPNext si les niveaux de stock de Dokos changent.
::

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
**Remarque** : Shopify ne prend pas en charge la quantité fractionnaire. Si une quantité fractionnaire est trouvée dans Dokos, le niveau de stock sur Shopify sera défini en l'arrondissant au nombre entier le plus proche.
::

## 5. Synchronisation de l'article

Vous pouvez activer la synchronisation des nouveaux éléments ERPNext vers Shopify en cochant « Télécharger les nouveaux éléments ERPNext vers Shopify ».

Vous pouvez également mettre à jour l'article Shopify lors de la mise à jour de l'article Dokos.

Le but de fournir cette fonctionnalité est de synchroniser les articles avec Shopify. Il n'est pas possible de mapper tous les champs 1 à 1. Lors de la création d'un article sur Shopify à l'aide de cette méthode, il est lié à Dokos, ce qui élimine la possibilité de duplication. Vous pouvez modifier les articles sur Shopify ultérieurement pour ajouter plus de détails.

Remarque : Cette fonctionnalité n'est pas prise en charge dans l'importation de données ou pour les éléments de variante/modèle.

## 6. Annulation de commandes

Ce connecteur gère divers scénarios d'annulation de la manière suivante :

1. Si la commande sur Shopify est annulée et qu'elle n'est pas associée à une facture ou à un bon de livraison, la commande client ERPNext est annulée.
2. Si le document Commande client de Dokos a un document lié, le statut de la commande sur Shopify est ajouté au document respectif. L'annulation et la préparation des documents appropriés doivent être effectuées par l'utilisateur sur la base de ces informations.


# Slack

Si vous souhaitez que vos notifications soient envoyées à un canal Slack dédié, vous pouvez également choisir l'option "**Slack**" dans les options du canal et sélectionner l'URL du Webhook Slack appropriée.

## Accès à Slack et configuration

Pour générer des URL de webhook, vous devez créer une nouvelle application Slack :

1. Accédez à &#x2A;*[](https://api.slack.com/)<https://api.slack.com/>{rel="&#x22;nofollow&#x22;"}**
2. Cliquez sur **Créer une application Slack**

![slack\_api.png](https://doc.dokos.io/content/integrations/slack/slack_api.png)

3. Sélectionnez la rubrique **De zéro** pour créer votre application

![de\_zéro.png](https://doc.dokos.io/content/integrations/slack/de_zero.png)

4. Donnez un nom à votre application et choisissez le bon espace de travail.

![nom\_application.png](https://doc.dokos.io/content/integrations/slack/nom_application.png)

5. Une fois votre application créée, accédez à la section « **Webhooks entrants**

![webhook\_entrant.png](https://doc.dokos.io/content/integrations/slack/webhook_entrant.png)

6. Une fois dans la section des webhooks entrant, cliquez sur **Activer les Webhooks entrants**

![activer\_webhook.png](https://doc.dokos.io/content/integrations/slack/activer_webhook.png)

7. Allez à la section en bas de page **URL de webhook pour votre espace de travail**, puis cliquez sur **Ajouter un nouveau webhook à l'espace de travail**.
8. Indiquez l'endroit où la notification doit être publié. Il s'agit d'un canal que vous aurez crée dans votre compte Slack.

![choix\_du\_canal.png](https://doc.dokos.io/content/integrations/slack/choix_du_canal.png)

9. Copiez le lien créé, revenez sur la plateforme Dokos et utilisez-le pour créer une nouvelle URL Slack Webhook.

![copier\_url\_webhook.png](https://doc.dokos.io/content/integrations/slack/copier_url_webhook.png)

## Configuration du Webhook entrant depuis Dokos

Il faut maintenant créer le Webhook entrant permettant de dire au logiciel de lier Dokos avec Slack.

1. Accédez au document **URL Webhook entrant** en allant sur :

> Accueil > Intégration > Paramètres > URL de webhook entrant

![liste\_webhook.png](https://doc.dokos.io/content/integrations/google-chat/liste_webhook.png)

2. Cliquez sur Ajouter **URL Webhook entrant**
3. Indiquez le **nom** du Webhook entrant
4. Sélectionnez le service **Slack**
5. Dans la section URL du webhook, il suffit d'insérer l'URL que vous avez copié dans Slack (Étape 9 - Accès à Slack et configuration)
6. Faites **Enregistrer**

![slack\_intégration.png](https://doc.dokos.io/content/integrations/slack/slack_integration.png)

## Configuration des notifications

Il faut créer une notification permettant de dire au logiciel à quelle action une information sera envoyée sur Slack.

1. Accéder au document **Notification** en allant sur :

> Accueil > Paramètres > Email / Notifications > **Notification**

![liste\_notification.png](https://doc.dokos.io/content/integrations/google-chat/liste_notification.png)

2. Cliquez sur **Ajouter une notification**
3. Ajoutez les informations suivantes :


   - Indiquez un **nom** de notification
   - **Activé** : Si cochée, alors la notificatio sera active
   - Sélectionnez un **canal** : Choisissez **Outil de collaboration externe**
   - URL de Webhook entrant de l'outil de collaboration : Sélectionnez le Webhhook entrant que vous avez créé à l'**étape 2.2**.

![détails\_notification.png](https://doc.dokos.io/content/integrations/google-chat/details_notification.png)

## Détails de notification

### Filtres

Depuis cette section, gérez vos paramètres de **Filtres** :

1. **Sujet** : Ajoutez un nom de sujet pour votre notification. Vous pouvez ajouter un sujet dynamique en utilisant les tags Jinja.
2. **Type de document** : Sélectionnez le type de document pour lequel une notification sera effectué.
3. **Envoyer une alerte lors de l'événement** : Choisissez pour quelle action la notification sera exécutée (Nouveau, Enregistrer, Valider, annuler...)
4. **Envoyer une notifiaction système** : Si activé, la notification apparaîtra dans les notifications en haut à droite de la barre de navigation
5. **Conditions** : Vous pouvez définir des conditions pour l'envoi de la notification.

   - Exemples de conditions :

   :brdoc.status=="Open"
   doc.due\_date==nowdate()
   doc.total > 40000

*Par exemple dans ce cas, dès que le statut du document est égal à **ouvert**, que la date du document est égale à **ajourd'hui** et que le Montant du document est **supérieur à 4000** alors il faut réaliser l'action.*

![filtres\_notification.png](https://doc.dokos.io/content/integrations/google-chat/filtres_notification.png)

### Modifier une propriété après la notification

Depuis cette section, gérez vos paramètres de **modification de propriété après la notification** :

Vous pouvez choisir de modifier une propriété après la notification puis il faut définir une valeur qui sera concerné par cette modification.

![modifier\_une\_propriété.png](https://doc.dokos.io/content/integrations/google-chat/modifier_une_propriete.png)

### Message

Depuis cette section, gérez vos messages qui seront envoyés sur **Slack** :

Vous pouvez saisir votre message qui sera envoyé sur Slack. Utilsez les champs des documents pour les personnaliser.

Voici un exemple de message :

`*Nouveau ticket*`

`Nouvelle demande n° {{ doc.name }}.`

`*Détails*`

`• Client : {{ doc.customer }}``• Sujet : {{ doc.subject }}``• Message : {{ doc.description }}`

![message\_notification.png](https://doc.dokos.io/content/integrations/google-chat/message_notification.png)

### Tester la notification

1. Vous pouvez simplement tester votre notification en cliquant sur le bouton en haut à droite **Tester cette notification**.

![tester\_notification.png](https://doc.dokos.io/content/integrations/google-chat/tester_notification.png)

2. Vérifiez maintenant sur Slack que vous avez bien reçu la notification.

![slack.png](https://doc.dokos.io/content/integrations/slack/slack.png)


# Zapier

Zapier est une plateforme permettant à des personnes sans connaissances techniques de connecter différentes applications entre elles.

> Cette application est en version beta sur invitation en cliquant sur ce [lien](https://zapier.com/developer/public-invite/33806/e3b8aad5383366dcaf236904c056c227/){rel="&#x22;nofollow&#x22;"}.
> Pour les utilisateurs d'ERPNext, cette application est également compatible avec la version 12.x.x.
> {.is-warning}

## Installer l'application Zapier

### Récupérer l'URI de redirection

> Allez sur zapier.com et connectez-vous ou créez-vous un compte

1. Dans la section `My Apps` cliquez dans `Connect a new account` et cherchez `dokos`:br![zapier\_new\_connection.png](https://doc.dokos.io/content/integrations/zapier/zapier_new_connection.png)
2. Dans la fenêtre qui s'ouvre, copiez l'adresse de redirection (Redirect URI) affichée au dessus des champs Client ID et Client Secret.
   Il s'agit de la même adresse, donc vous pouvez n'en copier qu'une seule. :br![zapier\_auth.png](https://doc.dokos.io/content/integrations/zapier/zapier_auth.png)
3. Gardez cette fenête ouverte pour terminer la connexion après l'étape 1.2.

### Enregistrer une nouvelle connection sur dokos

> Ouvrez dokos et allez dans le module `Intégrations`

1. Créez un nouveau document `Client OAuth`, donnez un nom à l'application cliente (Ex. Zapier) et collez l'URI de redirection copiée plus haut dans les champs `URIs de redirection` et `URI de redirection par défaut`.

![dokos\_oauth.png](https://doc.dokos.io/content/integrations/zapier/dokos_oauth.png)

1. Enregistrez et dokos va générer automatiquement les deux informations manquantes pour terminer notre connexion à Zapier: L'ID client et le secret client. :br
   Copiez ces deux clés.

![dokos\_client\_keys.png](https://doc.dokos.io/content/integrations/zapier/dokos_client_keys.png)

### Configurer les connexions sociales

> Pour permettre les intégrations de type OAuth2, il faut avoir au moins une clé de connexion sociale Dodock.

1. Allez dans `Intégrations > Clé de connexion sociale`
2. Créez une nouvelle clé de connexion de sociale
3. Dans le champ **Fournisseur de connexion sociale** sélectionnez `Dodock`
4. Dans le champ **URL de base** entrez l'URL de base de votre site sans les éventuels sous-domaines.
   Ex: Si votre URL est `https://demo.dokos.io`, entrez `https://dokos.io`

![frappe\_social\_login.png](https://doc.dokos.io/content/integrations/zapier/frappe_social_login.png)

1. Enregistrez

### Terminer l'authentification de Zapier

> Retournez sur Zapier et ouvrez à nouveau la fenêtre de la section 1.1.

- **Base URL**: Entrez l'URL de base de votre site dokos. Ex. `https://demo.dokos.io`
- **Client ID**: Collez la clé générée à l'étape 1.2. correspondante
- **Client Secret**: Collez la clé générée à l'étape 1.2. correspondante

1. Cliquez sur `Yes, Continue`
2. Vous allez être redirigé sur votre site dokos pour valider l'authentification. Cliquez sur `Autoriser`

🎉 Votre application Zapier est désormais connectée à votre site dokos. :br
Vous pouvez créer votre premier Zap.

### Créer un Zap

L'application Zapier **dokos** permet de créer deux types d'interactions:

- La génération d'un Zap en fonction d'un événement affectant un document
- La recherche ou la création d'un document

### Génération d'un Zap

Pour générer un nouveau Zap, séléctionnez l'application **dokos** dans l'éditeur de Zap.

1. Dans le champ **Choose Trigger Event** sélectionnez **Document events**.
2. Sélectionnez le compte à utiliser. Il s'agit probablement du compte créé à l'étape 1.
3. Dans la section **Customize Document**, sélectionnez:


   - Le **DocType** (Type de document) utilisé pour déclencher un Zap
   - L'événement (**Trigger Event**) qui déclenchera ce Zap.
     Cet évément peut être l'un des suivants:


     - **After insert**: Après la création d'un document
     - **On change**: Après la modification du document (peut être déclenché en même temps que `On update` ou `On submit`)
     - **On update**: Après l'enregistrement du document
     - **On submit**: Après la validation du document
     - **On update after submit**: Après enregistrement d'un document déjà soumis. Possible seulement si certains champs sont éditables après validation.
     - **On cancel**: Après l'annulation du document
     - **On trash**: Après suppression du document
   - Les champs à envoyer à Zapier (**Webhook Data**)
     Cliquez sur le bouton + pour ajouter un champ supplémentaire

> L'intégration avec Zapier crée des nouveaux Webhooks dans dokos. :br
> Vous pouvez les retrouver en allant dans `Intégrations > Webhooks`.
> {.is-info}

Vous pouvez ensuite enregistrer et créer votre action avec une autre application Zapier ou avec l'application dokos si vous le souhaitez.

### Déclenchement d'une action sur dokos

Il existe deux types d'actions disponibles sur dokos: **Créer un document** (Create Document) ou **Rechercher un document** (Find Document)

#### Création de document

Un fois que vous avez sélectionné le type de document à créer, choisissez des valeurs pour les champs obligatoires et testez votre Zap.
Un nouveau document devrait être créé sur votre site dokos.

#### Recherche de document

Si vous sélectionnez la recherche de documents, vous pouvez définir 3 paramètres:
1\. Le nombre de document maximum à récupérer
2\. Le nom des champs à récupérer
3\. Un filtre pour trouver votre/vos documents
Si vous cherchez un document en particulier, pensez à filtrer par identifiant (Nom dans dokos).

En cochant la case `Create dokos Document if it doesn't exist yet?` vous autorisez Zapier à créer un nouveau document s'il ne trouve pas de document correspondant à vos filtres.

Une fois votre document trouvé ou créé, vous pouvez passer à l'étape suivante et le réutiliser dans un autre Zap.

### Formats des données

#### Dates

Lorsque vous envoyez un champ de type **Date** ou **Date/Heure**(Datetime), vous devez utiliser les formats suivants:

- **Date**: `YYYY-MM-DD`
  Ex: 2019-11-30
- **Date/Heure**: `YYYY-MM-DD HH:mm:ss`
  Ex: 2019-11-30 08:30:00

Vous pouvez utiliser les outils [Zapier Formatter](https://zapier.com/help/create/format/modify-date-formats-in-zaps){rel="&#x22;nofollow&#x22;"} pour cela si besoin.
Pour le format **Date/Heure**, vous pouvez sélectionner l'option "Use a Custom Value":

![zapier\_datetime.png](https://doc.dokos.io/content/integrations/zapier/zapier_datetime.png)

#### Listes

L'application n'autorise pas encore l'envoi de listes dans les objects composant les documents.
Veuillez envoyer un mail à <help@dokos.io> si cette limitation vous pose des problèmes d'intégrations.


# Ajouter / Masquer un champ dans un formulaire

Dans Dokos, tous les documents présents peuvent être modifiés. Tous les documents présents dans Dokos sont considérés comme un Type de document Standard. Ils sont pré-configurés et ne pourront pas être modifié depuis Type de document.

Il faudra alors faire Personnaliser le forumlaire pour ajouter, masquer des champs. Certains champs qui sont obligatoire ne pourront pas être supprimés mais ils pourront être cachés.

---

Pour accéder à la personnalisation des formulaires, allez sur :

> Accueil > Personnalisations > Personnalisation de formulaire > Personnaliser un formulaire

## 1. Comment accéder à la personnalisation du formulaire depuis le document ?

Vous pouvez également accéder à la personnalisation du formulaire en allant sur le document que vous voulez modifier.

**Dans ce Cas d'usage nous allons choisir de modifier le formulaire du client**

1. Allez sur la liste Client
2. En haut à droite : Cliquez sur les 3 points ...
3. Cliquez sur **Personnaliser**

Vous allez être rédirigé sur le **document Personnaliser un formulaire**.

Le nom du type de document sera automatiquement mis sur **Customer** (Client)

### Rappel : Les différents champs disponibles pour structurer le formulaire

- **Libelle** : Nom du champ créé.
  Le Type permet de définir le type de ces données, il existe plusieurs choix possible. Les plus utilisés sont :
- **Type Donnée** : Vous pouvez renseigner du texte personnalisé.
- **Type Lien** : Vous pouvez choisir les données d'un autre document et il vous permet de rediriger et lier le document à un autre.
- **Type Date** : le champ est mis sous le format d'une date.
- **Type Saut de colonne** : Il permet de créer un saut de ligne entre les champs.
- **Type Saut de section** : Vous permet de segmenter votre document en plusieurs parties. Par exemple, Détails généraux, Table des articles, Termes et conditions etc..
- **Type Sélectionner** : Vous pouve donner des choix en Options
  …
- **Obligation** : Si la case est coché, ce champ sera obligatoire pour pouvoir le valider.
- **Options** : Quand le Type de donnée est Sélectionner ou Lien, vous devez saisir les choix ou le nom de type de document pour rediriger la page...

## 2. Masquer des champs

1. Pour masquer des champs, il suffit d'aller sur la section Champs puis sur le champs que vous souhaitez masquer et cliquez à droite sur **Modifier**.
2. Dans le fomulaire client, nous souhaitons cacher la **section Comptabilité**.

![masquer-section-comptabilite.png](https://doc.dokos.io/content/use-cases/masquer-section-comptabilite.png)

3. Il faut repérer le Libellé **Accounting** (les noms des champs sont en anglais) = Comptabilité.

::callout
Les noms des sections sont en **Gras**
::

Ici, on voit que le type de champ est une section **Saut de section**.

4. Cliquez sur **Modifier** tout à droite du champ.
5. Descendez jusqu'à la case **Masqué**, puis cochez la case pour que la section soit Masqué sur le formulaire.

![cachez-un-champ.png](https://doc.dokos.io/content/use-cases/cachez-un-champ.png)

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Si vous cachez le champ avec le type **Saut de section**, alors toute les champs présents à l'intérieur de cette section seront masqués.
::

6. Quittez le Pop Up / Fenêtre surgissante et faites **Enregistrer**

**La section a bien été retirée sur le fomulaire client.**

## 3. Ajouter des champs

**Dans ce Cas d'usage nous allons choisir de modifier le formulaire du Devis**

Nous allons ajouter un champ **Information** sur le devis. Ce champ permettra d'ajouter des informations personnalisées sur l'article qui sera envoyé dans le devis.

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Ce champ **Information** fait partie de la table article. Cette table d'article est modifié depuis le formulaire Personnalisé : **Item quotation** (Article du devis)
::

![ajouter-champ-informations.png](https://doc.dokos.io/content/use-cases/ajouter-champ-informations.png)

1. Allez sur : > Accueil > Personnalisation > **Personnaliser Formulaire**
2. Sélectionnez le formulaire **Article du Devis** (Item quotation).
3. Pour ajouter des champs, il suffit d'aller sur la section Champs puis allez tout en bas de la liste des champs et cliquez sur **Ajouter une ligne**.
4. Remplir la ligne avec les informations suivantes :


   - **Libellé** : Nom du champ "Information"
   - **Type** : Éditeur de texte
   - **Obligatoire** : Laissez la case décochée
5. Faites **Modifier** tout à droite.

Voici différents otpions que vous pouvez appliquer :

- **Obligatoire** : Ce champ sera obligatoire pour valide le formulaire
- **Unique**
- **Ajouter une colonne pour ce champ dans la vue en liste**
- **Ajouter un filtre standard pour ce champ**
- **Ajouter à la recherche globale**
- **Prévisualisation**
- **Mettre en évidence**
- **Ajouter dans les entrées rapides**
- **Traduisible**

Dans notre cas, nous allons cochez les champs :

- **Ajouter une colonne pour ce champ dans la vue en liste**
- **Traduisible**

5. Dans le Pop-up, cliquez sur Déplacer en haut à droite et indiquez la position 5.
6. Puis faites **Enregistrer** le formulaire

Maintenant, si vous retournez sur le formulaire du Devis, vous allez avoir ce nouveau champ qui sera dans la table d'article.

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Si vous voulez que ce champ soit repris sur la commande et la facture, il faut faire la même manipulation mais pour les Formulaires **Article de la commande** et **Article de la facture**.
Il faut garder le même nom de libellé pour que ce champ reprenne bien l'information une fois que vous avez validé le devis et que vous le passez en commande.
::


# Suivi envoi d'email

Dans cas d'usage, nous allons voir comment afficher un champ qui va indiquer si un email a été envoyé à votre contact.

#### Explication du Cas :

L'objectif est de savoir si le document a bien été envoyé à votre contact quand vous allez sur un document comme une commande client ou une facture de vente.

Lors de la création d'une commande client :

1. Si vous cochez la case **Envoyé un email automatiquement**
2. Alors dès que cette case est cochée
3. Et que le document Commande client est **Validé**
4. Un email est envoyé automatiquement.
5. Puis, une fois que l'email est envoyé, le champ **Statut Email** est modifié avec la valeur **Envoyé**

![flux\_email.png](https://doc.dokos.io/content/use-cases/flux_email.png)

### Étape 1

Pour débuter il faut ajouter des nouveaux champs à votre document. Nous allons ajouter une nouvelle section pour la séparer des autres sections et ajouter deux champs qui seront :

- **Email envoyé automatiquement** : Avec une case à cocher.
- **Statut Email envoyé** : En choisissant manuellement envoyé ou non envoyé. Et pour automatiser cela, nous allons configurer une automation pour mettre la valeur Envoyé.

### Étape 2

Par la suite, pour automatiser l'action de l'envoi de l'email et du changement de la valeur pour le champ **Statut Email envoyé**, nous allons créer une notification.

![section-email.png](https://doc.dokos.io/content/use-cases/section-email.png)

## 1. Ajouter des champs personnalisés

Nous allons ajouter deux champs qui seront utilisés :

- Un champ de saut de section
- Email envoyé automatiquement : Oui ou non
- Email Statut : Pas envoyé ou Envoyé

### 1.1 Ajouter un premier champ : Email envoyé automatiquement

Tout d'abord, il faut ajouter sur le type de document Commande client / Facture de vente le champ **Envoyé un email automatiquement**.

*Nous allons voir ce cas pour le type de document : Commande client*

1. Allez sur le document **Commande client**
2. Cliquez sur les 3 petits points en haut.
3. Faites **Personnaliser**

![commande-client.png](https://doc.dokos.io/content/use-cases/commande-client.png)

*Vous allez arriver sur le document Personnalisation du formulaire pour le document Commande de vente*

4. Allez dans la section Champs, puis en bas faites **Ajouter une ligne**

![ajouter-nouvelle-ligne.png](https://doc.dokos.io/content/use-cases/ajouter-nouvelle-ligne.png)

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Avant cela, ajoutez un champ **Saut de section**, cela vous permettra d'avoir une section indépendante - Déplacez ce champ à la ligne 17.
::

5. Renseignez la ligne des champs comme suit :

   - Indiquez dans **Libellé** : Envoyé un email automatiquement
   - Indiquez dans **Type** : Vérifier
   - Dans **Nom** : Il sera mis automatiquement à l'enregistrement
6. Faites **Modifier**, tout à droit de la ligne du nouveau champ.
7. Déplacez ce champ où vous souhaitez le faire apparaître dans le document par exemple à la ligne 18.

![deplace.png](https://doc.dokos.io/content/use-cases/deplace.png)

### 1.2 Ajouter un second champ : Statut Email

Tout d'abord, il faut ajouter un nouveau champ qui permettra de savoir si l'email a bien été envoyé avec les options (Pas envoyé, Envoyé).

1. Allez dans la section Champs, puis en bas faites **Ajouter une ligne**
2. Renseignez la ligne des champs comme suit :


   - Indiquez dans **Libellé** : Email Statut
   - Indiquez dans **Type** : Sélectionner
   - Dans **Nom** : Il sera mis automatiquement à l'enregistrement

- Indiquez dans **Option** : Pas envoyé, Envoyé en sautant des lignes pour chaque option.

3. Faites **Modifier**, tout à droit de la ligne du nouveau champ.
4. Dans la section **Autorisation**, coché la case **Autoriser les modifications après validation**

![modification.png](https://doc.dokos.io/content/use-cases/modification.png)

5. Déplacez ce champ où vous souhaitez le faire apparaître dans le document par exemple à la ligne 19.

**Voici les champs que vous obtenez à la fin.**![section.png](https://doc.dokos.io/content/use-cases/section.png)

## 2. Créer une notification et modification d'un champ automatiquement

Il faut créer une nouvelle notification qui sera exécutée dès que le champ "**Envoyé un email automatiquement**" est coché sur votre **commande/facture**

Pour ce faire, il faut :

1. Allez dans le document **Notification**
2. Ajoutez une notification
3. Indiquez un nom d'usage
4. Sélectionnez le canal Email

![detail.png](https://doc.dokos.io/content/use-cases/detail.png):br:br

### 2.1 Section Filtre

- **Sujet** : Il s'agit du nom de l'objet qui sera envoyé au client
- **Type de document**: Sélectionnez Commande client
- **Envoyer une alerte lors de l'événement** : Valider

:br

### 2.2 Section Condition

- **Condition** : Indiquez `doc.{nom_du_champ}`*Le nom du champ correspond au champ **Email envoyé automatiquement** dans le document Commande client. Cela signifie que si ce champ est coché, alors la notification sera exécutée dès que la cas est coché et à la validation du document*.

![condition.png](https://doc.dokos.io/content/use-cases/condition.png):br

### 2.3 Section Modifier une propriété après la notification

- **Modifier une propriété après la notification** : Sélectionnez le champ **Staut Email**
- **Valeur à définir** : Indiquez **Envoyé**

![modifie\_propriete.png](https://doc.dokos.io/content/use-cases/modifie_propriete.png):br

### 2.4 Section Destinataires

- Ajoutez une nouvelle ligne
- Destinataire par champ de document : Sélectionnez **contact\_email**

![destinataire.png](https://doc.dokos.io/content/use-cases/destinataire.png):br

### 2.5 Section Message

- Indiquez le contenu de l'email qui sera envoyé au client.
  :br

### 2.6 Impressions

- Joindre une impression de document : Cochez cette case pour que votre document soit envoyé en pièce jointe dans l'email.

**Faites Enregistrer**


# Exonération de TVA

Le statut d'auto-entrepreneur en France entraîne directement une franchise de TVA : vous ne facturez pas la TVA à vos clients et vous ne récupérez pas la TVA lors de vos achats.

Il n'y a donc ni TVA collectée, ni TVA déductible et ni déclaration de TVA en auto-entreprise.

Lorsque vous facturez, vous devez inscrire sur la facture la mention : &#x2A;*« TVA non applicable, article 293B du CGI »**.

---

Dans ce cas d'usage, nous allons voir comment vous pouvez assimiler un client, un fournisseur ou groupes à une exonération de TVA soit une TVA de 0%.

## 1. Configuration des modèles de TVA

1. Allez dans **Modèle de taxes et frais d'achat ou vente**, cliquez sur Nouveau.
2. Entrez un nom de titre pour la taxe (Exonération de TVA ou TVA 0%)
3. Dans **catégorie de Taxe**, ajoutez ou sélectionnez une catégorie de Taxe.


   - Créez une catégorie de taxe en la nommant : **Exonération de TVA**
4. Vous n'avez pas besoin de renseigner la table taxe et frais.
5. Faites **Enregistrer**.

## 2. Attribution du modèle de TVA (Méthode 1)

### 2.1 Création d'une règle de taxation

Une fois que vous avez enregistré votre modèle, dans documents liés puis faites ajoutez une règle de taxation.

1. Indiquez le type de Taxe : Si cela concerne les ventes ou les achats.
2. Sélectionnez le modèle de TVA (ici on sélectionne notre modèle de TVA à 0%).

### 2.2 Sélectionnez les documents qui seront concernés par cette règle

Vous pouvez maintenant choisir les documents qui seront concernés par cette exonération de TVA. Vous pouvez mettre un client en particulier, un groupe de client, un fournisseur etc...

Puis faites **enregistrer**.

## 3. Attribution du modèle de TVA (Méthode 2)

Une fois que vous avez enregistré votre modèle. En allant sur un document client par exemple, vous pouvez lui appliquer ce modèle de TVA.

Dans la section **Nom et Type**, allez dans sur le champs **Catégorie de taxe** puis sélectionnez la &#x2A;*catégorie TVA à 0%**.

Puis faites enregistrer.

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Il est important de bien lier votre **catégorie de TVA** à **votre modèle de taxes et frais**.
::

Maintenant, si vous créez un devis, une commande etc.. aucune TVA ne sera appliqué. Le montant de la TVA sera de 0€.

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Si vous êtes un auto-entrepreneur ou une société qui n'est pas assujeti à la TVA, pensez bien à faire figurer la mention **TVA non applicable, article 293B du CGI** sur vos documents.
::


# Rapports SQL

Les rapports SQL vous permettent de créer des rapports qui seront définis par les requêtes SQL. On peut ajouter diverses données qui seront stockées dans le logiciel DOKOS pour obtenir ces rapports.

## Cas d'usage <*Mappemonde*>

Vous avez un besoin de traiter les différentes réservations chaque jour. Et vous n'avez pas toutes les informations sur les événements.

Il vous faut une liste qui puisse clairement vous indiquer ou à vos clients le jour, le type événement, le lieu, les participants, le thème, etc.

## Solution pour la création du rapport

### 1.1 Créer événement

> Accueil > Lieu > Evénement > **+ Ajouter Événement**

**Remplissez les champs suivant** :

- **Le sujet**
- **Commence le**
- **Termine le**
- **Les participants**
- **les personnes assignées**
- **La description**

![booming\_1.png](https://doc.dokos.io/content/cas_usage_booming_tiers_lieu/booming_1.png)

### 2.1 Créer un rapport

1. Saisir **Rapport** dans la barre de recherche.
2. Cliquez sur **Nouveau.elle Rapport**

![creer\_rapport\_2.png](https://doc.dokos.io/content/cas_usage_booming_tiers_lieu/script_report/creer_rapport_2.png)

**Une fois sur la page de création du rapport**

3. Saisissez un **Nom**
4. Sélectionnez le **DocType** que vous voulez rattaché au rapport
   Pour ce cas, choisissez **EVENT** (Événement).
5. Dans **Type de Rapport**, mettez **Rapport de requête**
6. **Enregistrez**

Le rapport est maintenant créé.

![creer\_rapport.png](https://doc.dokos.io/content/cas_usage_booming_tiers_lieu/script_report/creer_rapport.png)

Cela permet de créer un rapport qui peut gérer des codes SQL. (SQL est une requête de base de données et un langage de programmation, principalement utilisé pour accéder aux données et aux requêtes.)

L'avantage de l'utilisation de ce langage est que les utilisateurs peuvent fortement personnaliser le format, le contenu de la table et peuvent connecter plusieurs tables de données.

![booming\_2.png](https://doc.dokos.io/content/cas_usage_booming_tiers_lieu/booming_2.png)

### 2.2 Requête SQL

#### 2.2.1 Présentation des données des documents sur DOKOS

**Comment récupérer les donnnées du document ?**

1. **Première façon**

- Cliquez sur les trois points en haut à droite.
- Faites **Personnaliser** pour aller sur la page du formulaire.

![booming\_3.png](https://doc.dokos.io/content/cas_usage_booming_tiers_lieu/booming_3.png)

- Dans **type de formulaire** : Mettez **Event** (Événement)

En dessous, vous pouvez voir tous les noms de champs sur l'événement.

![booming\_4.png](https://doc.dokos.io/content/cas_usage_booming_tiers_lieu/booming_4.png)

2. **Deuxième façon**

- Allez dans **Type de document**, vous trouverez toutes les données de chaque document.

Pour accéder à la **liste Type de document**, allez sur :

> Accueil > Développement > Modèles > **Type de document**

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
**Attention les noms des documents sont en anglais**
::

Pour aller sur le formulaire Événement, il faut taper **Event** dans la barre de filtre > Nom.

![booming\_5.png](https://doc.dokos.io/content/cas_usage_booming_tiers_lieu/booming_5.png)

Rédigez les codes pour définir le contenu de votre rapport.

#### 2.2.2 Les codes SQL et ajout des colonnes

Voici le format SQL :

`SELECT` 'les colonnes que vous voulez choisir'
`FROM` \`tableau\`

Si l'événement contien les différents champs :

- Sujet
- Commence le
- Termine le
- Les personnes attribuées
- La description

Il faut écrire sous "**Requête**" :

```text
SELECT name, subject, starts_on, ends_on, _assign, description
FROM tabEvent
```

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
(Attention! Nom des champs 'name' et 'assign' est défini par défaut et ils ne s'affichent pas)
::

Pour ajouter les colonnes il faut :

- Ajoutez une ligne
- Indiquez le **nom de champ**
- Indiquez un **libéllé**
- Sélectionnez un **Type de champ**
- Enregistrer

::callout{color="blue" icon="i-heroicons-light-bulb"}
**Astuce — Recherche de champ par autocomplétion**

Lors de l'ajout d'une colonne dans un rapport, le champ de sélection du nom de champ propose désormais une **autocomplétion** : tapez les premières lettres du nom recherché pour filtrer instantanément la liste. C'est particulièrement utile sur les types de documents comportant de nombreux champs.
::

Il est à noter que le nombre de Colonnes doit être égal au nombre de données sélectionnées après `SELECT`.

- Cliquez sur **Afficher le rapport** en haut à droite pour afficher les résultats de la requête.

![booming\_6.png](https://doc.dokos.io/content/cas_usage_booming_tiers_lieu/booming_6.png)

Pour voir le résultat de la requête en format PDF :

- Cliquez sur les trois points en haut à droite et cliquez sur PDF pour générer un PDF.

![booming\_7.png](https://doc.dokos.io/content/cas_usage_booming_tiers_lieu/booming_7.png)![booming\_8.png](https://doc.dokos.io/content/cas_usage_booming_tiers_lieu/booming_8.png)

### 2.3 Réserver un article et connectez les tableaux différents

Pour afficher les informations de l'article dans la liste.

- Réservez une salle dans **Réservation un article** dans l'Événement.
- Ajoutez des codes SQL pour connecter le tableau **Réservation d'article** et le tableau **Event**.

**1. Première étape**

- Cliquez le bouton **Réserver un article** dans **Evénement**.
- Choisissez les salles (la salle peut être ajoutée à l'avance dans **Article**).
- Cliquez sur la salle en bleu dans **Evénement**.
- Indiquez **Commence le**, le **Termine le** et le **statuts**
- **Enregistrez**

![booming\_9.png](https://doc.dokos.io/content/cas_usage_booming_tiers_lieu/booming_9.png)![booming\_10.png](https://doc.dokos.io/content/cas_usage_booming_tiers_lieu/booming_10.png)![booming\_11.png](https://doc.dokos.io/content/cas_usage_booming_tiers_lieu/booming_11.png)

**2. Deuxième étape : changer les codes pour connecter les 2 tableau**

- Utiliser LEFT JOIN dans la requête SQL.
  Fonction qui permet de connecter le tab1 et tab2.

S'il y a deux colonnes identiques dans les deux tableaux, il faut utiliser `LEFT JOIN` ... `ON`... pour connecter ces deux tableaux.

Voici le code qu'il faut utiliser :

```text
SELECT t1.n, t1.b, t1.c, t2.d, t2.e
FROM tab1 AS t1
LEFT JOIN tab2 AS t2
ON t1.n = t2.f
```

`as` : fonction pour nommer le tableau dans ces codes pour simplifier

Ici, car la colonne "e" dans tab1 et la colonne "n" dans tab2 ont les mêmes données. Nous utilisons donc `LEFT JOIN`...`ON`... pour joindre les deux tables. De cette façon, les t2.d et t2.e que nous lisons sont toutes des données qui correspondent à t1.n.

On pourrait utiliser **t1.n** pour indiquer la colonne **n** qui est à l'origine du tableau **t1**. De cette façon, on peut facilement distinguer différentes colonnes **n**.

([Ici](https://www.geeksforgeeks.org/sql-join-set-1-inner-left-right-and-full-joins/){rel="&#x22;nofollow&#x22;"}, vous pouvez connaître plus d'informations de différents `JOIN`)

Dans notre cas actuel, on peut observer les données de **Evénement** et **Réservation d'article**. Le **nom** de **Evénement** c'est 'EV00001', le "**event**" de **Réservation d'article** c'est aussi 'EV00001'. Donc on peut l'utiliser en SQL.

Attention ! Si le nom de tableau est composé de plusieurs mots, il faut utiliser backtick pour le composer en ensemble.

Exemple, le tableau de Item Booking est `tabItem Booking`.

```text
SELECT e.name, e.subject, e.starts_on, e.ends_on, e._assign, e.description, ib.item, ib.status
FROM tabEvent as e
LEFT JOIN `tabItem Booking` as ib
ON e.name = ib.event
```

Comme code ici, on pourrait obtenir le "item" et le "status" de «Réservation d'article» quand son "event" est 'EV00001'
Laisse regarder le résultat.

![Requête](https://doc.dokos.io/content/cas_usage_booming_tiers_lieu/booming_12.png)![Résultat affiché](https://doc.dokos.io/content/cas_usage_booming_tiers_lieu/booming_13.png)

*BINGO ! Il est aussi possible de connecter plus de tableaux qui nous permet de lire plus d'informations ! :br De cette façon, je peux avoir une liste très complète, c'est vraiment super !*

### 2.4 Ajout du filtre

![Plusieurs événement](https://doc.dokos.io/content/cas_usage_booming_tiers_lieu/booming_14.png)![Plusieurs résultat](https://doc.dokos.io/content/cas_usage_booming_tiers_lieu/booming_15.png)

Sur la page Rapport, il y a toujours un filtre.

Vous pouvez placer les conditions que vous souhaitez filtrer. Vous pouvez sélectionner la date, le statut ou d'autres données que vous souhaitez filtrer. La méthode de filtrage peut être réalisée en sélectionnant des options, ou en sélectionnant des dates, etc.

Après avoir placé un filtre ici, vous pouvez utiliser la fonction `WHERE`...`AND`...`AND`... dans la Requête suivante pour utiliser le filtre que vous avez ajouté.

ex.
Vous pouvez ajouter

```text
WHERE nom du champ 1 = %("Nom du champ 2" de filtre)s     
```

à la fin de la requête

Dans la situation actuelle, nous pouvons d'abord mettre en place un filtre sur **starts\_on** et **ends\_on**. Choisissez leur type de données comme **Date**, puis ajoutez-le à la fin de la requête.

```text
WHERE e.starts_on >= %(starts_on)s AND e.ends_on <=%(ends_on)s
```

De cette façon, nous pouvons sélectionner **l'heure de début** et **l'heure de fin** dans les résultats affichés !

![requête de filtre](https://doc.dokos.io/content/cas_usage_booming_tiers_lieu/booming_16.png)![Résultat affiché](https://doc.dokos.io/content/cas_usage_booming_tiers_lieu/booming_17.png)

Concernant le status de salle, vous pouvez également ajouter un **status** dans **filtre**.**Type de champ** on sélectionne 'Selection'. Mais ce qui est un peu différent, c'est qu'il implique différentes options. Ici, vous devez cliquer sur le **Modifier** à droite du filtre, puis l'ajouter dans l'option
'Confirmed'
'Not confirmed'

Ensuite, comme précédemment, nous ajoutons du code à la fin

```text
WHERE e.starts_on >= %(starts_on)s AND e.ends_on <=%(ends_on)s
AND ib.status = %(status)s
```

On voit ensemble les résultats d'affiches.

![Résultat affiché](https://doc.dokos.io/content/cas_usage_booming_tiers_lieu/booming_18.png)![Résultat affiché](https://doc.dokos.io/content/cas_usage_booming_tiers_lieu/booming_19.png)![Résultat affiché](https://doc.dokos.io/content/cas_usage_booming_tiers_lieu/booming_20.png)

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Attention! Quand vous ajoutez des filtres, le contenu de la page est modifié donc il faut recharger la page en cliquant sur le bouton dans le coin supérieur droit.
::

### 3. Améliorer le format

Vous pouvez rédiger le rapport que vous souhaitez pour améliorer le format.

Voici le code rédigé :

```text
SELECT e.name, e.subject, e.event_category, REPLACE(CONCAT(CONCAT(e.starts_on,'<br>to<br>'), e.ends_on),'.000000',' '), e.description,

REPLACE((SELECT GROUP_CONCAT(tabUser.full_name)
FROM tabUser
WHERE locate(tabUser.name, e._assign) > 0), ",", "<br>"),

REPLACE((SELECT GROUP_CONCAT(ib.item, " : ", ib.status)
FROM `tabItem Booking` as ib
WHERE ib.event = e.name),',','<br>')

FROM tabEvent as e
WHERE e.starts_on >= %(starts_on)s AND e.ends_on <= %(ends_on)s
```

![requête plus beau](https://doc.dokos.io/content/cas_usage_booming_tiers_lieu/booming_21.png)![Résultat affiché](https://doc.dokos.io/content/cas_usage_booming_tiers_lieu/booming_22.png)![PDF affiché](https://doc.dokos.io/content/cas_usage_booming_tiers_lieu/booming_23.png)

Après la fusion de '**start time**' et '**end time**' dans une nouvelle colonne '**Timetable**'.

- Connectez '**item**' et '**status*&#x2A;' en &#x2A;*':'**
- Remplacez les Emails en leur '**prénom**''**Nom**'.

Utilisez les fonctions suivantes pour les réaliser :

Sous requête :
Quand on sélectionne un élément qui n'existe pas dans le tableau principal. On peut utiliser sous-requête (SELECT \*\*\* FROM \*\*)

`REPLACE`( , , )
Il peut réaliser le remplacement des informations dans le resultat
Le lien [REPLACE](https://sql.sh/fonctions/REPLACE){rel="&#x22;nofollow&#x22;"}

`CONCAT`( , )
Il peut réaliser la connexion de 2 éléments que vous avez choisi, qui peut être une colonne ou un symbole.
Le lien [CONCAT](https://sql.sh/fonctions/concat){rel="&#x22;nofollow&#x22;"}

`GROUP_CONCAT`( , )
Il permet de regrouper les valeurs non nulles d'un groupe en une chaîne de caractère. Cela est utile pour regrouper des résultats en une seule ligne que d'avoir autant de ligne qu'il y a de résultat dans ce groupe. Quand notre resultat qui est affiché dans plusieurs lignes, cette fonction nous permet d'afficher en une ligne et séparé par une virgule
Le lien [GROUP\_CONCAT](https://sql.sh/fonctions/group_concat){rel="&#x22;nofollow&#x22;"}

`Locate`()
Il permet de chercher la position d'une chaîne de caractère dans un enregistrement. La fonction retourne zéro si la chaîne de caractère n'a pas été trouvée.
Le lien [Locate](https://sql.sh/fonctions/locate){rel="&#x22;nofollow&#x22;"}

\<br> signifie le saut de la ligne dans le résultat.


# Cas d'usage : Revue de presse

Une revue de presse est un genre journalistique et entrepreneurial qui consiste en une compilation d'articles de presse généraliste ou spécialisée, à une échelle géographique et temporelle choisie. Cette synthèse peut relever juridiquement du panorama de presse si elle ne répond pas à certains critères, dont la gratuité.

Pour la création d'un espace lié à la création d'une Revue de presse il faut :

- 1. Créer un endroit dans le Dokos qui permet de stocker les informations.
- 2. Pouvoir générer des rapports, qui contiennent des informations sur les revues de presse et le chemin de visualisation des fichiers associés.

### Solution

Comment créer un espace dédié à la création de Revues de presse ?

- Il faut créer un nouveau type de document qui correspondra au dossier des revues de presse.

Dans Dokos, vous pouvez retrouver tous les types de document dans :

> Accueil > Développement > Modèles > **Type de document**

## 1. Créer un nouveau modèle de **Type de document**

1. Allez sur la liste de tous les types de document
2. Cliquez sur **+ Ajouter Type de document**
   Ou vous pouvez saisir **Type de document** dans la barre de recherche.

![doctype\_1.png](https://doc.dokos.io/content/cas_usage_booming_tiers_lieu/revue_de_presse/doctype_1.png)

3. Accédez au formulaire qui permet de définir les **informations du nouveau document**.
4. Nommer le document dans le champ **Nom**
5. Sélectionnez le **module** qui sera associé au document.

![doctype\_2.png](https://doc.dokos.io/content/cas_usage_booming_tiers_lieu/revue_de_presse/doctype_2.png)

Dans le partie **contenu**, vous pouvez définir tous les champs du document. Il s'agit des champs que les utilisateurs devront remplir pour valider une Revue de presse.

Dans ce cas là, vous pouvez ajouter les champs suivants :

- Utilisateur
- Date de publication
- Sujet de la revue de presse
- Description de la revue de presse

Etc..

### **Les informations de la table**

1. **Libelle** : Nom du champ créé.
2. Le **Type** permet de définir le type de ces données, il existe plusieurs choix possible. &#x2A;Les plus utilisés sont :*

   - Type **Donnée** : Vous pouvez renseigner du texte personnalisé.
   - Type **Lien** : Vous pouvez choisir les données d'un autre document et il vous permet de rediriger et lier le document à un autre.
   - Type **Date** : le champ est mis sous le format d'une date.
   - Type **Saut de colonne** : Il permet de créer un saut de ligne entre les champs.
   - Type **Saut de section** : Vous permet de segmenter votre document en plusieurs parties. Par exemple, Détails généraux, Table des articles, Termes et conditions etc..
   - Type **Sélectionner** : Vous pouve donner des choix en **Options**
     …
3. **Obligation**: Si la case est coché, ce champ sera obligatoire pour pouvoir le valider.
4. **Options** : Quand le **Type** de donnée est **Sélectionner** ou **Lien**, vous devez saisir les choix ou le nom de type de document pour rediriger la page...

![doctype\_3.png](https://doc.dokos.io/content/cas_usage_booming_tiers_lieu/revue_de_presse/doctype_3.png)

5. Le champ suivant est le **Nom* automatique*\* qui sera généré à la création d'un document.
   Vous pouvez définir la façon de nommer les différents documents en ce type. Par défaut c’est aléatoire. Ici on utilise la façon [série], on remplit "REVUE.#####" dans ce champ.
   ![doctype\_4.png](https://doc.dokos.io/content/cas_usage_booming_tiers_lieu/revue_de_presse/doctype_4.png)
6. **Enregistrer** le nouveau document.
7. Créez votre premier document pour votre revue de presse en allant sur :

> Accueil > Lieu > **Revue de presse**
> ou en recherchant Revue de presse dans la barre de recherche.

![doc\_revue\_de\_presse5.png](https://doc.dokos.io/content/cas_usage_booming_tiers_lieu/revue_de_presse/doc_revue_de_presse5.png)

## 2. Créer un Rapport : Revue de Presse

Vous pouvez retrouver deux cas d’usage a propos de la création des Rapports.

1. **[Rapport de requête](https://doc.dokos.io/fr/customizations/use-cases/query-report){rel="&#x22;nofollow&#x22;"}**
2. **[Rapport de script](https://doc.dokos.io/fr/customizations/use-cases/script-report){rel="&#x22;nofollow&#x22;"}**.

Dans ce cas là, il faut créer un &#x2A;*[Rapport de requête](https://doc.dokos.io/fr/customizations/use-cases/query-report){rel="&#x22;nofollow&#x22;"}**

Le flux de Rapport:

> Onglet à gauche > Développements > Vues > **Rapport**

Ou

> Directement saisir ‘**Rapport**’ dans notre barre de recherche.

1. Cliquez sur **+ Ajouter Rapport** en haut à droite.
   ![rapport\_revue1.png](https://doc.dokos.io/content/cas_usage_booming_tiers_lieu/revue_de_presse/rapport_revue1.png)
2. Le **Nom du Rapport** : 'Revue de Presse'
3. Le **Type de rapport** : Sélectionnez ‘Rapport de Requête'
4. Le &#x2A;*Doctype de Réf.** : Sélectionnez ‘Revue de Presse 1’(C’est le Doctype que vous avez vient créé).
5. Cliquez sur **Enregistrer**.

![rapport\_revue21.png](https://doc.dokos.io/content/cas_usage_booming_tiers_lieu/revue_de_presse/rapport_revue21.png)![rapport\_revue2.png](https://doc.dokos.io/content/cas_usage_booming_tiers_lieu/revue_de_presse/rapport_revue2.png)

6. Ajoutez des colonnes de rapport dans **Colonnes** et écrire des codes dans **Requête/Script**.

![rapport\_revue3.png](https://doc.dokos.io/content/cas_usage_booming_tiers_lieu/revue_de_presse/rapport_revue3.png)

### 2.1 Ecrire les codes

1. Ajoutez des données dans les **Colonnes**.
2. Remplissez le nom des données dans **Nom du champ**
3. Nommez les colonnes dans le champs **Libellé**
4. Sélectionnez le **Type de champ** selon les types de données.

Écrivez le code suivant :

```text
SELECT contact, client, date, sujet, description
FROM `tabRevue de Presse`
```

![codes1.png](https://doc.dokos.io/content/cas_usage_booming_tiers_lieu/revue_de_presse/codes1.png)

Pour afficher le résultat de rapport, cliquez sur le bouton **Afficher le rapport** en haut à droite après avoir enregistré :
![codes2.png](https://doc.dokos.io/content/cas_usage_booming_tiers_lieu/revue_de_presse/codes2.png)![codes3.png](https://doc.dokos.io/content/cas_usage_booming_tiers_lieu/revue_de_presse/codes3.png)

Pour imprimer en PDF, cliquez sur les trois point en haut à droite et cliquez sur PDF
![codes4.png](https://doc.dokos.io/content/cas_usage_booming_tiers_lieu/revue_de_presse/codes4.png)![codes5.png](https://doc.dokos.io/content/cas_usage_booming_tiers_lieu/revue_de_presse/codes5.png)

### 2.2 Ajouter le lien de fichier associé dans le rapport

Comme toutes les données liées à l'ajout de fichier dans l’onglet de gauche de Rapport n'appartiennent pas à ce Rapport. Cela veut dire que les données de **Pièces jointes** ne sont pas dans les données du document **Revue de Presse**. Ces données sont toutes stockées dans le **Fichier** Dokos.

1. Allez dans le fichier associé

Le flux de **Fichier**:

> Onglet à gauche > Outil > **Fichier**

Ou

> Directement saisir ‘**Fichier**’ dans notre barre de recherche.

![fichier1.png](https://doc.dokos.io/content/cas_usage_booming_tiers_lieu/fichier1.png)

![fichier2.png](https://doc.dokos.io/content/cas_usage_booming_tiers_lieu/fichier2.png)

2. Cliquez sur le fichier "YUKI SCRIPT RAPPORTc94640" que nous avons ajouté dans le **Pièces jointes**. Nous pouvons observer les données de ce fichier comme **Nom du Fichier**, **URL du fichier**, **Joint au DocType**, **Joint Au Nom**...

![fichier3.png](https://doc.dokos.io/content/cas_usage_booming_tiers_lieu/fichier3.png)

![fichier4.png](https://doc.dokos.io/content/cas_usage_booming_tiers_lieu/fichier4.png)

3. Pour connaître les noms de ces champs, cliquez sur les trois points en haut à droite et cliquez sur **Personnalisation**.
   **Entrez le type de formulaire**, le **Nom** de ces champs et ses **Type** de données.

![fichier5.png](https://doc.dokos.io/content/cas_usage_booming_tiers_lieu/fichier5.png)

![fichier6.png](https://doc.dokos.io/content/cas_usage_booming_tiers_lieu/fichier6.png)

4. Retournez dans le rapport **Revue de Presse**
5. Ajoutez une colonne ‘file\_url’ dans **Colonnes**. Puis, on corrige le code en :

```text
SELECT r.contact, r.client, r.date, r.sujet, r.description, 
(SELECT GROUP_CONCAT(file_url)
FROM tabFile as f
WHERE f.attached_to_name = r.name AND f.attached_to_doctype = "Revue de Presse")
FROM `tabRevue de Presse` AS r
```

![fichier7.png](https://doc.dokos.io/content/cas_usage_booming_tiers_lieu/fichier7.png)

Voici le résultat que vous allez avoir :

![fichier8.png](https://doc.dokos.io/content/cas_usage_booming_tiers_lieu/fichier8.png)

![fichier9.png](https://doc.dokos.io/content/cas_usage_booming_tiers_lieu/fichier9.png)

### 2.3 Format de rapport plus beau

Si vous voulez un URL complet, il faut ajouter “[https://tierslieux.dokos.io”](https://tierslieux.dokos.io%E2%80%9D){rel="&#x22;nofollow&#x22;"} avant le fichier URL. On écrit les codes:

```text
SELECT r.contact, r.client, r.date, r.sujet, r.description, 
(SELECT GROUP_CONCAT("https://tierslieux.dokos.io",file_url)
FROM tabFile as f
WHERE f.attached_to_name = r.name AND f.attached_to_doctype = "Revue de Presse")
FROM `tabRevue de Presse` AS r
```

Voici le résultat donné :

![format1.png](https://doc.dokos.io/content/cas_usage_booming_tiers_lieu/revue_de_presse/format1.png)

![format2.png](https://doc.dokos.io/content/cas_usage_booming_tiers_lieu/revue_de_presse/format2.png)

![format3.png](https://doc.dokos.io/content/cas_usage_booming_tiers_lieu/revue_de_presse/format3.png)

Vous pouvez tester le rapport avec plusieurs revues de presse et ajouter plus de fichiers associés dans chaque document.

![format4.png](https://doc.dokos.io/content/cas_usage_booming_tiers_lieu/revue_de_presse/format4.png)

![format5.png](https://doc.dokos.io/content/cas_usage_booming_tiers_lieu/revue_de_presse/format5.png)

![format6.png](https://doc.dokos.io/content/cas_usage_booming_tiers_lieu/revue_de_presse/format6.png)

![format7.png](https://doc.dokos.io/content/cas_usage_booming_tiers_lieu/revue_de_presse/format7.png)

Exécutez à nouveau le code :

```text
SELECT r.contact, r.client, r.date, r.sujet, r.description, 
(SELECT GROUP_CONCAT("https://tierslieux.dokos.io",file_url)
FROM tabFile as f
WHERE f.attached_to_name = r.name AND f.attached_to_doctype = "Revue de Presse")
FROM `tabRevue de Presse` AS r
```

![format8.png](https://doc.dokos.io/content/cas_usage_booming_tiers_lieu/revue_de_presse/format8.png)

![format9.png](https://doc.dokos.io/content/cas_usage_booming_tiers_lieu/revue_de_presse/format9.png)

![format10.png](https://doc.dokos.io/content/cas_usage_booming_tiers_lieu/revue_de_presse/format10.png)

A partir de ces résultats, vous pouvez observer que lorsque le nombre de ‘Revue de Presse’ augmente, il n'y a pas de problème avec les résultats.

Mais lorsque plusieurs fichiers sont ajoutés, en raison de la fonction `GROUP_CONCAT()`, il y a des virgules entre les différents liens.

Donc, on pourrait corriger les codes pour le faire plus simple :

```text
SELECT r.contact, r.client, r.date, r.sujet, r.description, 
REPLACE((SELECT GROUP_CONCAT("https://tierslieux.dokos.io",file_url)
FROM tabFile as f
WHERE f.attached_to_name = r.name AND f.attached_to_doctype = "Revue de Presse"),",","<br>")
FROM `tabRevue de Presse` AS r
```

![format11.png](https://doc.dokos.io/content/cas_usage_booming_tiers_lieu/revue_de_presse/format11.png)

![format12.png](https://doc.dokos.io/content/cas_usage_booming_tiers_lieu/revue_de_presse/format12.png)

![format13.png](https://doc.dokos.io/content/cas_usage_booming_tiers_lieu/revue_de_presse/format13.png)


# Le Rapport de Script

Tout ce qui ne peut pas être réalisé à l'aide de Report Builder ou de Query Report peut être réalisé à l'aide de Script Reports. Comme son nom l'indique, ces rapports sont créés à l'aide de scripts Python. Étant donné que ces rapports vous donnent un accès illimité via des scripts Python, ils ne peuvent pas être créés par les administrateurs. Ces rapports sont destinés à être rédigés pendant le développement et à faire partie de votre application.

## Cas d'usage <*MappeMonde*>

MappeMonde (Tiers Lieu) avait besoin d'une liste claire et formelle qui contiendra toutes les informations relatives à l'événement, y compris le nom de la réunion, le thème, l'horaire, les participants, et le contenu impliqué.

## Solution pour la création du rapport

### 1.1 Créer événement

> Accueil > Lieu > Evénement > **+ Ajouter Événement**

**Remplissez les champs suivant** :

- **Le sujet**
- **Commence le**
- **Termine le**
- **Les participants**
- **les personnes assignées**
- **La description**

![booming\_1.png](https://doc.dokos.io/content/cas_usage_booming_tiers_lieu/booming_1.png)

### 2.1 Comment créer un rapport de script ?

1. Saisir **Rapport** dans la barre de recherche.
2. Cliquez sur **Nouveau.elle Rapport**

![creer\_rapport\_2.png](https://doc.dokos.io/content/cas_usage_booming_tiers_lieu/script_report/creer_rapport_2.png)

**Une fois sur la page de création du rapport**

3. Saisissez un **Nom**
4. Sélectionnez le **DocType** que vous voulez rattaché au rapport
   Pour ce cas, choisissez **EVENT** (Événement).
5. Dans **Type de Rapport**, mettez **Rapport de script**
6. **Enregistrez**

Le rapport est maintenant créé.

![creer\_rapport.png](https://doc.dokos.io/content/cas_usage_booming_tiers_lieu/script_report/creer_rapport.png)

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
**Le langage Python** est le langage de programmation Open source le plus employé par les développeurs. Ce langage s’est propulsé en tête de la gestion d’infrastructure, d’analyse de données ou dans le domaine du développement de logiciels. C'est aussi l'un des langages informatiques les plus utilisés au monde.
::

L'avantage de l'utilisation de ce langage est que les utilisateurs peuvent définir beaucoup de variables.

(Si vous voulez en connaître plus sur le langage Python, cliquez [ici](https://www.python.org/){rel="&#x22;nofollow&#x22;"})

### 2.2 Requête Script

#### 2.2.1 Présentation des données des documents sur DOKOS

**Comment récupérer les donnnées du document ?**

1. **Première façon**

- Cliquez sur les trois points en haut à droite.
- Faites **Personnaliser** pour aller sur la page du formulaire.

![booming\_3.png](https://doc.dokos.io/content/cas_usage_booming_tiers_lieu/booming_3.png)

- Dans **type de formulaire** : Mettez **Event** (Événement)

En dessous, vous pouvez voir tous les noms de champs sur l'événement.

![booming\_4.png](https://doc.dokos.io/content/cas_usage_booming_tiers_lieu/booming_4.png)

2. **Deuxième façon**

Allez dans **Type de document**, vous trouverez toutes les données de chaque document.

Pour accéder à la **liste Type de document**, allez sur :

> Accueil > Développement > Modèles > **Type de document**

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
**Attention les noms des documents sont en anglais**
::

Pour aller sur le formulaire Événement :

- Tapez **Event** dans la barre de filtre > Nom.

![booming\_5.png](https://doc.dokos.io/content/cas_usage_booming_tiers_lieu/booming_5.png)

#### 2.2.2 Les codes script et ajout des colonnes

Retournez sur le rapport de l'événement que vous venez de créer en allant sur :

> Accueil > Développement > Vues > **Rapport**

Sur la liste des rapports, retrouvez le rapport que vous avez créé.

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Pour les rapports de script, la librairie Frappe API est utilisé pour créer et gérer les données.
::

A propos de l'usage de ce libraire, allez sur le lien suivant pour ens avoir plus [ici](https://doc.dokos.io/fr/developers){rel="&#x22;nofollow&#x22;"}.

**Le format de notre requête script est :**

```text
result = [résultat]
```

ou avec l'ancien style

```text
data = [colonnes], [résultat]
```

`result` : cela indique les résultats affichés.

**Application dans notre cas :**

- Utilisez la fonction `frappe.db.get_all()` pour lire les données dans notre doctype.

Son format est :

```text
frappe.db.get_all(doctype, filters, or_filters, fields, order_by, group_by, start, page_length)
```

Attention ici, si vous n’avez pas besoin de filtrer, par order\_by, par group\_by, start, par page\_length.
Vous pouvez vous passer de ces éléments, il ne reste que la ligne de code : `frappe.db.get_all(doctype, fields)`.

Pour `frappe.db.get_all()` vous pouvez également utiliser l'alias `frappe.get_all()`.

#### Comment ajouter une colonnne ?

- Faites **Ajouter une ligne**
- Indiquez le **Nom du champ**, le **libellé**
- Indiquez **Type de champ**

Si vous choisissez le type de champ : **Lien**. Vous pouvez indiquer le **chemin du Lien** dans Modifier la ligne > **Option**

![result\_1.png](https://doc.dokos.io/content/cas_usage_booming_tiers_lieu/script_report/result_1.png)

Dans le résultat affiché et sur le PDF, vous pouvez cliquer sur le lien pour accéder à la page de ‘le type de formulaire’.

![filtre11.png](https://doc.dokos.io/content/cas_usage_booming_tiers_lieu/script_report/filtre11.png)![lien1.png](https://doc.dokos.io/content/cas_usage_booming_tiers_lieu/script_report/lien1.png)

Pour lire les données de l'événement, selon `frappe.db.getall()`, il faut écrire :

```text
result = frappe.get_all('Event',  fields = ['name','subject','starts_on','ends_on','description'])
```

Ou il faut utiliser la deuxième façon pour afficher le résultat:

```text
columns = [
        {
        "fieldname": "name",
        "fieldtype": "Data",
        "label": "Event"
    },
    {    
        "fieldname": "subject",
        "fieldtype": "Data",
        "label": "Subject"
    },
        {   
        "fieldname": "starts_on",
        "fieldtype": "Date",
        "label": "Starts On"
    },
        {    
        "fieldname": "ends_on",
        "fieldtype": "Date",
        "label": "Ends On"
    },
    {    
        "fieldname": "description",
        "fieldtype": "Data",
        "label": "Description"
        }
]


fields = ["name","subject","starts_on","ends_on","description"]
    
    
data = columns, frappe.get_all("Event",fields = fields)
```

![data=.png](https://doc.dokos.io/content/cas_usage_booming_tiers_lieu/script_report/data=.png)

Cliquez sur le bouton blanc **Afficher le rapport** en haut à droite.

![affiche\_result\_1.png](https://doc.dokos.io/content/cas_usage_booming_tiers_lieu/script_report/affiche_result_1.png)

Dokos vous permet de l’imprimer ou l'afficher en PDF: Cliquez sur les trois points en haut à droite et PDF pour générer un PDF à imprimer

![pdf1.png](https://doc.dokos.io/content/cas_usage_booming_tiers_lieu/script_report/pdf1.png)

### 2.3 Comment ajoutez des filtres ?

![Plusieurs événement](https://doc.dokos.io/content/cas_usage_booming_tiers_lieu/booming_14.png)

Tous les événements sont affichés dans le résultat.

Dans ce cas, vous avez besoin d’ajouter des filtres dans le champ 'filtre' pour filtrer selon vos besoins.

Vous pouvez par exemple ajouter une ligne, ‘le nom du champ' est 'starts\_on', le libellé est ‘Starts On’, ‘le type de champ’ est ‘date’.

Et une ligne ‘le nom du champ' est 'ends\_on', le libellé est Ends On’, ‘le type de champ’ est ‘date’.

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
**A noter** : :br
Les filtres que vous ajoutez peuvent être utilisés dans les codes suivants comme :
-filters.starts\_on
-filters.ends\_on
::

![filtre.png](https://doc.dokos.io/content/cas_usage_booming_tiers_lieu/script_report/filtre.png)

Le code est donc le suivant :

```text
result = frappe.get_all('Event', fields = ['name','subject','starts_on','ends_on','description'], filters = {"starts_on": ("between", [filters.starts_on,filters.ends_on])})
```

Dans le code ici, 'starts\_on' c’est l'élément que nous voulons comparer avec les dates. On choisira ('filters.starts\_on' et 'filters.ends\_on')

'Between' signifie 'starts\_on' est entre 'filters.starts\_on' et 'filters.ends\_on'. Normalement, ici on pourrait utiliser les symboles pour comparer comme “>” ou “<” ou “=”...

Le logiciel nous permet d'ajouter divers filtres comme celui des dates mais d'autres sont également possibles.

Voici le résultat après l'ajout des filtres.

![filtre\_code.png](https://doc.dokos.io/content/cas_usage_booming_tiers_lieu/script_report/filtre_code.png)

Les événements entre 30/06/2021 et 03/07/2021

![filtre\_date1.png](https://doc.dokos.io/content/cas_usage_booming_tiers_lieu/script_report/filtre_date1.png)

Les événements entre 30/06/2021 et 31/07/2021

![filtre\_date2.png](https://doc.dokos.io/content/cas_usage_booming_tiers_lieu/script_report/filtre_date2.png)

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Quand on ajoute des filtres, le contenu de cette page est modifié donc il faut recharger la page sur le bouton dans le coin supérieur droit.
::

### 2.4 Comment connecter plus de Doctype ?

#### 2.4.1 Réservation d’article

Pour connecter les données de **Réserver un article**

Il faut réserver un article pour notre événement.

1. Cliquez sur le bouton '**Réserver un article**' dans «**Evénement**» 2. Selectionnez les articles que vous voulez.
2. Après la soumission, il faut retourner sur la page d'évenement.
3. Cliquez sur l'article dans les **Documents liés**
4. Sélectionnez **Commence le**, **Termine le** et le **statuts**
5. Faites **Enregistrer**

![reser1.png](https://doc.dokos.io/content/cas_usage_booming_tiers_lieu/script_report/reser1.png)

![reser2.png](https://doc.dokos.io/content/cas_usage_booming_tiers_lieu/script_report/reser2.png)

![reser3.png](https://doc.dokos.io/content/cas_usage_booming_tiers_lieu/script_report/reser3.png)

#### 2.4.2 Requête pour importer les données de Réservation d’article dans le résultat affiché.

**Les différentes étapes en utilisant le langage Python :**

Dans tableau qui comporte les colonnes ‘name’,’subject’, ‘starts\_on’, ‘ends\_on’ et ‘description’.

Vous pouvez importer les autres données dans ce tableau.

- Créez les nouvelles colonnes vides qui permettent que les nouvelles données puissent le remplir.
- Utilisez `for`

Pour en savoir plus, cliquez sur [ici](https://www.w3schools.com/python/python_for_loops.asp){rel="&#x22;nofollow&#x22;"}.

Application du code :

```text
events = frappe.get_all('Event', fields = ['name','subject','starts_on','ends_on','description'], filters = {"starts_on": ("between", [filters.starts_on,filters.ends_on])})

for event in events:
     event["item"] = ""
     event["status"] = ""
     for booking in frappe.get_all('Item Booking', fields = ['item','status'], filters = {'event': event.name}):
          event["item"] = event["item"] + booking.item + "<br>"
          event["status"] = event["status"] + booking.status + "<br>"

result = events
```

La premiere ligne :

```text
events = frappe.get_all('Event', fields = ['name','subject','starts_on','ends_on','description'], filters = {"starts_on": ("between", [filters.starts_on,filters.ends_on])})
```

- Utilisez `frappe.get_all()`. Fonction pour lire les champs ('name','subject','starts\_on','ends\_on','description') à l’origine du type de document ‘Event’.
- Mettre le filtre pour lire les données quand le champ ‘**starts\_o**n’ d'événement qui est entre le '**starts\_on**' et '**ends\_on**' dans le champs de filtre.

Pour la première ligne de ce code :

```text
for event in events: 
```

Nous utilisons une boucle for pour lire séparément chaque événement dans 'Events', et nous nommons chaque événement.

```text
event["item"] = ""
event["status"] = ""
```

- Créez deux colonne ‘item’ et ‘status’ dans chaque ‘event’ que l’on a lu en for boucle. Mais le contenu de ces colonnes est vide car ils sont égal à "".
- Mettez les données suivantes :

```text
for booking in frappe.get_all('Item Booking', fields = ['item','status'], filters = {'event': event.name}):
```

Il faut retirer les données dont on a besoin.

- Utilisez`frappe.get_all`(). fonction pour lire les données de ‘**item**’ et '**status**' dans le type de document ‘Item Booking’. Quand la colonne ‘**event**’ de ‘**Item Booking**’ est égale à event.name.

La boucle `for` nous aide à lire chaque ‘item’ et chaque ‘status’ dans le ‘booking’

Enfin, on doit mettre ces données que l’on a retirées dans la colonne ‘item’ et ‘status’ de ‘event’.

```text
event["item"] = event["item"] + booking.item + "<br>"
event["status"] = event["status"] + booking.status + "<br>"
```

Vous pouvez utiliser ‘=’ pour définir une variable à nouveau.

- Définissez le nouveau event\["item"] égal à event\["item"] précédent(vide) + item à l’origine de booking + “\<br>” (le symbole pour sauter la ligne).
- Utilisez \<br> pour séparer ces certains )

Pour event\["status"], c’est le même principe.

Voici les résultats :

![connect\_1.png](https://doc.dokos.io/content/cas_usage_booming_tiers_lieu/script_report/connect_1.png)

![connect\_2.png](https://doc.dokos.io/content/cas_usage_booming_tiers_lieu/script_report/connect_2.png)

En PDF
![connect\_3.png](https://doc.dokos.io/content/cas_usage_booming_tiers_lieu/script_report/connect_3.png)

### 2.5 L'amélioration de format

Deux nouvelles colonnes viennent d'être ajoutées qui sont "**Item**" et "**Statuts**"

Vous pouvez connecter ces deux colonnes.

```text
events = frappe.get_all('Event', fields = ['name','subject','starts_on','ends_on','description'], filters = {"starts_on": ("between", [filters.starts_on,filters.ends_on])})

for event in events:
     event["item"] = ""
     for booking in frappe.get_all('Item Booking', fields = ['item', 'status'], filters = {
          'event': event.name
}):
          event["item"] = event["item"] + booking.item + ": " + booking.status + "<br>"

result = events
```

- Définir le contenu de event\["item"].
- Mettre les données booking.item et booking.status dans ces deux colonnes et les séparons par deux points.

![format1.png](https://doc.dokos.io/content/cas_usage_booming_tiers_lieu/script_report/format1.png)

![format2.png](https://doc.dokos.io/content/cas_usage_booming_tiers_lieu/script_report/format2.png)

Il suffit d'utiliser et de combiner habilement différentes fonctions en Python.


# TVA sur les ventes et achats internationaux

Lorsqu'une TVA apparaît par erreur sur une facture destinée à un client européen ou à l'export, c'est presque toujours parce que le bon modèle de taxes n'a pas été appliqué. Dokos permet de résoudre ce problème définitivement grâce aux **catégories de taxes**, qui déclenchent automatiquement le bon modèle selon le statut fiscal du tiers.

Ce cas d'usage couvre trois situations :

1. **Ventes intracommunautaires (UE)** — livraison de biens ou prestations à une entreprise assujettie dans un autre pays de l'UE
2. **Exports hors UE** — livraison à un client situé en dehors de l'Union européenne
3. **Achats auprès de fournisseurs européens** — autoliquidation de la TVA

---

## 1. Ventes intracommunautaires (clients UE B2B)

### Principe

Les livraisons de biens à des entreprises assujetties dans un autre État membre de l'UE sont **exonérées de TVA française**. Vous facturez hors taxe et indiquez le numéro de TVA intracommunautaire du client sur la facture.

> **Mention légale obligatoire*&#x2A; : &#x2A;"Exonération de TVA — Autoliquidation par l'acquéreur, article 262 ter I du CGI"*

### Configuration

**Étape 1 — Créer la catégorie de taxes**

> Comptabilité > Configuration > **Catégorie de taxes**

Créez une catégorie nommée par exemple `Intracommunautaire`. Si vous souhaitez aussi que le compte client utilisé soit différent (ex. 411100), associez ce compte dans la section dédiée.

**Étape 2 — Créer le modèle de taxes de vente à 0 %**

> Ventes > Paramètres > **Modèle de taxes de vente et frais**

1. Créez un nouveau modèle nommé `TVA 0% Intracommunautaire`
2. Sélectionnez la catégorie de taxes `Intracommunautaire`
3. Laissez le tableau des taxes **vide** — aucune ligne n'est nécessaire pour 0 %
4. Enregistrez

**Étape 3 — Affecter la catégorie de taxes au client**

Sur la fiche **Client**, dans la section *Nom et Type*, sélectionnez la catégorie de taxes `Intracommunautaire`.

Dès lors, toute facture, commande ou devis créé pour ce client appliquera automatiquement le modèle `TVA 0% Intracommunautaire`.

::callout{icon="i-heroicons-light-bulb"}
Pensez à renseigner le **numéro de TVA intracommunautaire** du client dans la fiche (champ *Numéro de TVA*). Ce numéro doit apparaître sur la facture imprimée.
::

---

## 2. Exports hors UE

### Principe

Les exportations vers des pays situés en dehors de l'Union européenne sont **exonérées de TVA** en vertu de l'article 262 I du CGI.

> **Mention légale obligatoire*&#x2A; : &#x2A;"Exonération de TVA à l'exportation — Article 262 I du CGI"*

### Configuration

La démarche est identique à la configuration intracommunautaire, avec une catégorie distincte :

**Étape 1 — Créer la catégorie**

> Comptabilité > Configuration > **Catégorie de taxes**

Créez une catégorie `Export` (ou `Hors UE`). Associez-y le compte client export si vous utilisez un compte séparé (ex. 411200).

**Étape 2 — Créer le modèle de taxes**

> Ventes > Paramètres > **Modèle de taxes de vente et frais**

Créez `TVA 0% Export` avec la catégorie `Export` et un tableau de taxes vide.

**Étape 3 — Affecter la catégorie au client**

Sur la fiche Client, sélectionnez la catégorie `Export`.

---

## 3. Fonctionnement automatique

Une fois les catégories et modèles configurés, Dokos applique automatiquement le bon modèle à chaque transaction :

::mermaid
flowchart LR
CLI1\["Client\nCatégorie: Intracommunautaire"] --> TXN1\["Facture de vente"]
TXN1 --> MOD1\["TVA 0% Intracommunautaire\n(tableau vide)"]
CLI2\["Client\nCatégorie: Export"] --> TXN2\["Facture de vente"]
TXN2 --> MOD2\["TVA 0% Export\n(tableau vide)"]
CLI3\["Client\nSans catégorie"] --> TXN3\["Facture de vente"]
TXN3 --> MOD3\["TVA 20%\n(modèle par défaut)"]

::

### Détermination automatique depuis l'adresse

Dans les **Paramètres de comptabilité**, le champ **Déterminer la catégorie de taxe d'adresse à partir de** permet à Dokos d'inférer la catégorie de taxes directement depuis l'adresse de facturation ou de livraison — sans qu'il soit nécessaire de configurer manuellement chaque client. Combiné aux **Règles de taxation**, cela permet une application entièrement automatique.

---

## 4. Achats auprès de fournisseurs européens (autoliquidation)

### Principe

Lorsque vous achetez des biens ou des services auprès d'un fournisseur établi dans un autre État membre de l'UE, vous devez **autoliquider la TVA** : vous déclarez vous-même la TVA collectée et la TVA déductible, sans que le fournisseur vous la facture.

Sur le plan comptable, cela se traduit par deux lignes dans le tableau des taxes de la facture d'achat :

| Ligne                       | Sens    | Compte  | Effet                    |
| --------------------------- | ------- | ------- | ------------------------ |
| TVA autoliquidée collectée  | Ajouter | 44571xx | Augmente la dette de TVA |
| TVA autoliquidée déductible | Déduire | 44562xx | Compense la dette de TVA |

Le montant net de TVA payé est nul, mais les écritures sont correctement générées pour la déclaration de TVA.

### Configuration

**Étape 1 — Créer la catégorie de taxes**

> Comptabilité > Configuration > **Catégorie de taxes**

Créez une catégorie `Intracommunautaire` (réutilisez celle des ventes si elle existe déjà, ou créez-en une spécifique aux achats).

**Étape 2 — Créer le modèle de taxes d'achat avec autoliquidation**

> Achats > Paramètres > **Modèle de taxes et frais d'achat**

1. Créez `TVA Autoliquidation Intracommunautaire`
2. Sélectionnez la catégorie `Intracommunautaire`
3. Ajoutez **deux lignes** dans le tableau :


   - Ligne 1 : Type `Sur total net`, Taux 20 %, **Ajouter**, compte TVA collectée autoliquidée
   - Ligne 2 : Type `Sur total net`, Taux 20 %, **Déduire**, compte TVA déductible autoliquidée
4. Enregistrez

**Étape 3 — Affecter la catégorie au fournisseur**

Sur la fiche **Fournisseur**, sélectionnez la catégorie `Intracommunautaire`. Le modèle s'appliquera automatiquement sur les factures d'achat.

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
La configuration des comptes d'autoliquidation (44571, 44562 et leurs subdivisions) dépend de votre plan comptable et de votre cabinet comptable. Vérifiez les comptes à utiliser avec votre expert-comptable avant de paramétrer ce modèle.
::

---

## Voir aussi

- [Catégories de taxes](https://doc.dokos.io/v5/dokos/comptabilite/categories-de-taxes)
- [Exonération de TVA (auto-entrepreneur)](https://doc.dokos.io/v5/dokos/cas-usage/exemption-vat)
- [Taxes de vente](https://doc.dokos.io/v5/dokos/ventes/taxes)
- [Modèle de taxes et frais d'achat](https://doc.dokos.io/v5/dokos/achats/taxes)


# Premiers pas avec Tribu

Ce guide vous accompagne dans la configuration initiale de votre module de gestion des adhésions.

## 1. Configuration initiale

Pour commencer, accédez aux paramètres de Tribu :
Rendez-vous dans **Tribu** → **Adhésion** → **Paramètres de Tribu**.

### Définir les articles de base

Dans l'onglet **Adhésions**, configurez les articles utilisés pour la facturation :

- **Article d'adhésion** : Sélectionnez l'article (ex: "Adhésion à l'association") utilisé pour facturer les cotisations. Cet article doit être de type *Service*.
- **Article pour les dons** (optionnel) : Si vous acceptez les dons lors de l'inscription, définissez l'article correspondant.

### Paramètres par défaut

- **Groupe client** : Choisissez le groupe qui sera attribué par défaut aux nouveaux membres (ex: "Particulier").
- **Mode de paiement** : Dans l'onglet **Paiements**, sélectionnez le mode de paiement par défaut pour les adhésions en ligne (HelloAsso, GoCardless, ou Stripe/Stencer).

---

## 2. Créer vos types d'adhésion

Les types d'adhésion définissent vos formules (annuelle, mensuelle, tarif réduit, etc.).

1. Allez dans **Adhésion** → **Types d'adhésion Tribu**.
2. Créez un nouveau document.
3. Renseignez le nom (ex: "Adhésion 2025-2026"), la durée et les tarifs.
4. Dans l'onglet **Comptabilité**, vérifiez la société et la liste de prix associées.

> **Conseil** : Créez un type d'adhésion par année pour faciliter le suivi et les statistiques.

---

## 3. Gestion des membres et adhésions

### Créer un membre manuellement

1. Allez dans **Adhésion** → **Adhérent**.
2. Cliquez sur &#x2A;*Créer Adhérent +**.
3. Renseignez au minimum le prénom, le nom et l'email.

### Enregistrer une adhésion

- **Manuellement** : Depuis la fiche d'un membre, cliquez sur **Nouvelle adhésion**, ou allez directement dans **Adhésion** → **Adhésion Tribu**.
- **Via le portail** : L'adhérent remplit le formulaire en ligne, effectue son paiement, et l'adhésion est créée automatiquement.

---

## 4. Suivi quotidien

- **Liste des membres** : Visualisez et filtrez vos adhérents dans **Adhésion** → **Adhérent**.
- **Adhésions actives** : Suivez les engagements en cours dans **Adhésion** → **Adhésion** → *Filtres: Statut = Membre*.
- **Tableau de bord** : La page d'accueil du module vous offre une vue d'ensemble du nombre de membres et d'adhésions actives.


# Tribu: Gestion des adhésions

Tribu est votre module de gestion des membres et adhésions au sein de Dokos. :br
Cette application vous permet de gérer facilement vos adhérents, de créer des formulaires d'adhésion en ligne et d'automatiser vos encaissements grâce aux intégrations de paiement.

## Vue d'ensemble

L'application Tribu s'articule autour de trois piliers principaux :

- **Le adhérent** : Le coeur du système, représentant l'individu ou l'organisation.
- **L'adhésion** : Le lien contractuel entre l'adhérent et votre structure pour une période donnée.
- **Les paramètres de Tribu** : Le moteur qui définit comment les adhésions sont facturées et payées.

---

## Flux de vie d'un adhérent

Le statut d'un adhérent évolue automatiquement en fonction de ses engagements.

::mermaid
graph LR
A\[Prospect / Visiteur] -->|Inscription Portail| B(Adhérent Inactif)
B -->|Paiement Cotisation| C{Membre Actif}
C -->|Fin de période| D\[Membre Expiré]
D -->|Renouvellement| C
D -->|Inactivité prolongée| B

::

### Contexte d'usage : Inscription d'un nouveau membre

Lorsqu'un utilisateur s'inscrit via le portail (ex: `/members/cotisation-annuelle`), le système effectue plusieurs actions en arrière-plan :

1. **Création du profil** : Un document *Adhérent* est créé ou mis à jour.
2. **Synchronisation Dokos** : Un *Client* et un *Contact* sont automatiquement générés pour assurer le suivi comptable et relationnel.
3. **Facturation** : Une *Commande Client* est créée, incluant l'article d'adhésion et d'éventuels dons.
4. **Activation** : Dès que le paiement est confirmé (via Stripe, GoCardless ou HelloAsso), l'adhésion passe au statut **Active**.

---

## Configuration des types d'adhésion

Les *Types d'Adhésion* vous permettent de moduler vos offres selon votre public.

### Exemples de configurations courantes :

- **Adhésion Étudiant** : Tarif réduit (Prix fixe), nécessite souvent un champ supplémentaire pour le numéro de carte étudiant.
- **Adhésion Bienfaiteur** : Prix libre avec un montant minimum défini (ex: 50€), permettant à l'adhérent de choisir son niveau de soutien.
- **Adhésion Découverte** : Gratuite, valable pour une durée illimitée ou une période courte.

### Champs supplémentaires (Champs supplémentaires du formulaire d'inscription)

Vous pouvez personnaliser vos formulaires pour collecter des données spécifiques à votre activité sans modifier le code de l'application.
&#x2A;Exemple : Pour une association de randonnée, vous pouvez ajouter un champ "Niveau de marche" ou "Allergies alimentaires".*

Pour ajouter des informations à collecter :

1. Ajoutez des champs dans le document "Adhésion" (via la personnalisation de formulaire).
2. Dans la configuration de Tribu, cochez **Afficher sur le formulaire d'inscription** pour chaque champ que vous souhaitez rendre visible sur le formulaire en ligne.

### Publication et intégration

Le formulaire d'inscription est automatiquement publié sur votre site Dokos. Cependant, vous pouvez également l'intégrer sur n'importe quel site web externe en copiant le code d'intégration fourni dans la configuration du formulaire.

::demo-link{path="/app/membership"}
Découvrir la démo Mappemonde
::

---

## Gestion financière et comptable

Le module Tribu automatise le lien entre vos adhésions et votre comptabilité Dokos.

### Flux de facturation

1. **Génération de la commande** : Lors de la validation d'une adhésion (manuelle ou portail).
2. **Paiement en ligne** : Utilisation d'une *Demande de Paiement* (Payment Request) envoyée automatiquement à l'adhérent.
3. **Réconciliation** : Une fois payée, la commande est facturée et le statut de l'adhésion est mis à jour.

> **Note importante** : Veillez à ce que vos articles d'adhésion (définis dans les *Paramètres Tribu*) soient correctement configurés avec leurs comptes de produits respectifs pour que vos rapports financiers soient exacts.

---

## Maintenance et Automatisation

Le système travaille pour vous chaque nuit :

- **Activation** : Les adhésions dont la date de début est arrivée passent au statut **Active**.
- **Expiration** : Les adhésions arrivant au terme de leur validité passent au statut **Expirée**.
- **Statut Adhérent** : Un adhérent perd son titre de "Membre" dès qu'il n'a plus aucune adhésion active en cours.

---

## Conseils pour une gestion efficace

- **Anticipation** : Préparez vos types d'adhésion pour l'année suivante quelques semaines avant la fin de l'exercice actuel.
- **Communication** : Utilisez les adresses emails collectées sur les fiches membres pour vos newsletters et convocations aux assemblées générales.
- **Simplicité** : Ne demandez que les informations essentielles dans vos formulaires portail pour maximiser le taux de conversion.


---

## title: Certification caisse

# Certification caisse

Documentation relative à la certification des systèmes d'encaissement Dokos.

- [Export des archives fiscales](https://doc.dokos.io/v5/dokos/certification-caisse/export-archives)


# Export des archives fiscales

## Obligation légale

La loi impose la **conservation des archives des données d'encaissement pendant 6 ans**, à compter de la date de la dernière opération de l'exercice fiscal.

L'assujetti est responsable de cette conservation, que les données soient hébergées dans le système d'encaissement ou en dehors.

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Même si le système ne permet pas de purger les données, l'export annuel des archives reste **obligatoire**. C'est une exigence réglementaire indépendante du fonctionnement du logiciel.
::

## Accéder à l'outil d'export

L'outil d'export des archives est accessible depuis la barre de recherche :

> Barre de recherche > **Société** > **Votre société** > **Conformité fiscale** > **Exporter une archive fiscale**

## Exporter une archive

1. **Sélectionner le journal** : choisir le journal SAS Ledger correspondant à la société concernée (un journal par société).
2. **Définir la période** : renseigner la date de début et la date de fin.


   - Pour un export annuel standard : du **1er janvier** au **31 décembre** de l'année concernée.
   - La période maximale d'un export est de **1 an** (366 jours).
3. **Cliquer sur « Télécharger »** : un fichier ZIP est téléchargé.

::callout{color="teal" icon="i-heroicons-light-bulb"}
Exportez **tous les journaux** disponibles pour chaque période. Si plusieurs sociétés sont configurées, chaque société dispose de son propre journal.
::

![sas-ledger-export-rempli.png](https://doc.dokos.io/content/certification_caisse/sas-ledger-export-rempli.png)

## Vérifier l'intégrité d'un journal

Le bouton &#x2A;*« Vérifier »** permet de vérifier la chaîne cryptographique du journal sélectionné. Cette vérification parcourt l'ensemble des enregistrements et confirme que les données n'ont pas été altérées.

- Si le journal est valide, un message « Le journal est VALIDE » s'affiche en vert.
- Si une corruption est détectée, un message d'erreur s'affiche.

## Cas d'usage

### Cas 1 : Fermeture du site Dokos

Si l'assujetti met fin à son utilisation de Dokos, il **doit** avoir préalablement exporté les archives couvrant les 6 dernières années d'activité.

Les 6 ans courent à partir de la **date de la dernière opération de l'exercice fiscal**, pas nécessairement au 31 décembre. Chaque export couvrant 1 an maximum, cela représente **6 fichiers ZIP** par journal.

Exemple : dernière opération le **15 mars 2025**, fermeture du site le 01/06/2025.

| Export | Période à couvrir        |
| ------ | ------------------------ |
| 1      | 16/03/2019 au 15/03/2020 |
| 2      | 16/03/2020 au 15/03/2021 |
| 3      | 16/03/2021 au 15/03/2022 |
| 4      | 16/03/2022 au 15/03/2023 |
| 5      | 16/03/2023 au 15/03/2024 |
| 6      | 16/03/2024 au 15/03/2025 |

::callout{color="blue" icon="i-heroicons-information-circle"}
En pratique, il est plus simple d'exporter par **année calendaire** (1er janvier – 31 décembre) et de s'assurer que la période de la dernière opération est bien couverte. L'outil accepte n'importe quelle plage de dates dans la limite d'un an.
::

Ces fichiers doivent être conservés de manière à garantir leur intégrité et leur disponibilité en cas de contrôle fiscal.

### Cas 2 : Usage courant (recommandé)

**Tous les ans**, en fin d'exercice, l'assujetti peut exporter l'archive de l'année écoulée et la conserver en lieu sûr.

Procédure annuelle recommandée :

1. En janvier, exporter l'archive de l'année précédente (du 1er janvier au 31 décembre).
2. Exporter tous les journaux disponibles.
3. Stocker les fichiers ZIP dans un emplacement sécurisé (disque externe, coffre-fort numérique, etc.).
4. Conserver chaque archive pendant au moins **6 ans**.

## Vérification d'une archive

Un outil de vérification en ligne est disponible pour contrôler l'intégrité des archives exportées :

> **<https://dokos.gitlab.io/certification_caisse/>{rel="&#x22;nofollow&#x22;"}**

Cet outil permet de vérifier que les données de l'archive n'ont pas été modifiées depuis leur export.


# Modèle de taxes et frais d'achat

Un **modèle de taxes et frais d'achat** vous permet de définir des règles standard pour appliquer des taxes, des frais ou des réductions sur vos documents d'achat (commande fournisseur, réception d'achat, facture d'achat). Ces modèles simplifient la saisie et garantissent une application cohérente des taxes et frais.

## 1. Créer un modèle de taxes et frais d'achat

1. Allez dans **Achat > Configuration > Modèle de taxes et frais d'achat**.
2. Cliquez sur **Nouveau**.
3. Donnez un **nom** au modèle (ex: "TVA 20% + Frais de port").
4. Sélectionnez le **type de compte** (Taxes ou Frais).
5. Ajoutez les lignes de taxes ou frais dans le tableau.
6. Enregistrez.

## 2. Configurer une ligne de taxe ou frais

Pour chaque ligne du modèle, vous pouvez définir :

- **Type** : Taxe ou Frais
- **Compte** : Le compte comptable associé (ex: "TVA déductible", "Frais de port")
- **Taux** : Le taux de taxe (pourcentage) ou le montant fixe (pour les frais)
- **Catégorie** : Détermine comment la taxe ou le frais est appliqué :


  - **Total et évaluation** : Appliqué au total du document et inclus dans la valorisation des stocks (pour les articles de stock)
  - **Total** : Appliqué uniquement au total du document (n'affecte pas la valorisation des stocks)
  - **Évaluation** : Appliqué uniquement à la valorisation des stocks (n'affecte pas le total du document)
- **Considérer la taxe ou le frais pour** : Identique à la catégorie, mais avec une formulation plus claire
- **Mode de répartition** : Pour les taxes/frais de type **Montant réel**, vous pouvez choisir comment le montant est réparti entre les articles du document.

## 3. Nouvelle option : Répartir le montant total uniquement sur les articles de stock

\::: info
Cette option est disponible uniquement pour les taxes ou frais de type **Montant réel** et dont la catégorie est **Évaluation** ou **Total et évaluation**.
\:::

Lorsque vous utilisez un **montant réel** (par exemple, des frais de port fixes) et que vous souhaitez que ce montant soit entièrement intégré à la valorisation des stocks, activez l'option **Répartir le montant total uniquement sur les articles de stock**.

### 3.1 Comportement par défaut (option activée)

- Le montant réel est réparti **uniquement entre les articles de stock** (articles avec un type d'article "Stock" ou "Actif").
- Les articles de type "Service" sont exclus de la répartition.
- **Exemple** :


  - **Articles** :


    - Article A (Stock) : 100 €
    - Article B (Stock) : 100 €
    - Article C (Service) : 100 €
  - **Frais de port (Montant réel)** : 30 €
  - **Répartition** : 15 € sur l'Article A, 15 € sur l'Article B (le montant total de 30 € est entièrement capitalisé dans les stocks).

### 3.2 Comportement avec l'option désactivée (ancien comportement)

- Le montant réel est réparti **entre tous les articles** (y compris les services).
- La part des articles de service est **exclue de la valorisation des stocks**.
- **Exemple** (même document que ci-dessus) :


  - **Répartition** : 10 € sur l'Article A, 10 € sur l'Article B, 10 € sur l'Article C.
  - **Valorisation** : Seuls 20 € sont capitalisés (10 € sur A + 10 € sur B), les 10 € de l'Article C sont perdus pour la valorisation.

### 3.3 Cas d'usage

- **Frais de port** : Généralement, vous souhaitez que les frais de port soient entièrement intégrés à la valorisation des stocks. **Laissez l'option activée**.
- **Taxes spécifiques** : Si une taxe doit être répartie sur tous les articles (y compris les services), **désactivez l'option**.

## 4. Appliquer un modèle à un document d'achat

1. Créez ou modifiez un document d'achat (commande fournisseur, réception d'achat, facture d'achat).
2. Dans la section **Taxes et frais**, sélectionnez votre modèle dans le champ **Modèle de taxes et frais**.
3. Les lignes de taxes et frais sont automatiquement ajoutées au document.
4. Vous pouvez ajuster les montants ou les taux si nécessaire.

## 5. Exemple pratique

### 5.1 Scénario

- **Fournisseur** : Bureau Moderne
- **Articles** :


  - 2 chaises (Stock) à 50 € chacune
  - 1 service d'installation (Service) à 100 €
- **Frais de port** : 20 € (Montant réel, catégorie **Total et évaluation**)
- **TVA** : 20% (Taux, catégorie **Total**)

### 5.2 Configuration du modèle

| Type  | Compte         | Taux/ Montant | Catégorie           | Répartir uniquement sur les articles de stock |
| ----- | -------------- | ------------- | ------------------- | --------------------------------------------- |
| Frais | Frais de port  | 20 €          | Total et évaluation | ✅                                             |
| Taxe  | TVA déductible | 20%           | Total               | ❌                                             |

### 5.3 Résultat

- **Frais de port** : 20 € répartis uniquement sur les chaises (10 € par chaise).
- **TVA** : 20% calculés sur le total (200 €) = 40 €.
- **Total du document** : 260 € (200 € + 20 € + 40 €).
- **Valorisation des stocks** : 120 € (100 € pour les chaises + 20 € de frais de port).

::mermaid
flowchart TD
A\[Document d'achat] --> B\[Articles]
B --> C\[2 chaises: 100 €]
B --> D\[1 service: 100 €]
A --> E\[Frais de port: 20 €]
E -->|Réparti uniquement sur les articles de stock| C
C -->|10 € par chaise| F\[Valorisation: 120 €]
A --> G\[TVA: 40 €]
G --> H\[Total: 260 €]

::

## 6. Bonnes pratiques

- **Utilisez des modèles** pour standardiser l'application des taxes et frais.
- **Vérifiez la catégorie** : Assurez-vous que les taxes/frais sont appliqués au bon niveau (total, évaluation ou les deux).
- **Pour les frais de port** : Activez toujours **Répartir le montant total uniquement sur les articles de stock** pour une valorisation correcte des stocks.
- **Testez vos modèles** : Créez un document d'achat de test pour vérifier que les montants sont correctement calculés et répartis.


# Analyses des ventes et des achats

Dokos vous permet d'analyser vos données de ventes et d'achats grâce à des rapports détaillés et des graphiques personnalisables. Vous pouvez désormais filtrer ces analyses par entité (client, fournisseur, groupe de clients ou groupe de fournisseurs) pour affiner vos résultats.

## Rapport d'analyse des ventes

Le rapport **Analyse des ventes** vous permet de visualiser vos données de ventes sous forme de tableau ou de graphique, avec la possibilité de filtrer par client ou groupe de clients.

### Filtres disponibles

- **Période** : Sélectionnez la période à analyser (mois, trimestre, année, etc.).
- **Type d'arbre** : Choisissez entre **Client** ou **Groupe de clients** pour structurer vos données.
- **Entité** : Sélectionnez un ou plusieurs clients ou groupes de clients pour limiter l'analyse à ces entités spécifiques.
- **Courbes** : Choisissez les données à afficher dans le graphique (montant total, quantité, marge, etc.).

### Exemple d'utilisation

Vous souhaitez analyser les ventes réalisées avec le client **Maison Verte SARL** pour le dernier trimestre.

1. Allez dans **Ventes > Rapports > Analyse des ventes**.
2. Sélectionnez la période **Trimestre dernier**.
3. Dans **Type d'arbre**, choisissez **Client**.
4. Dans **Entité**, sélectionnez **Maison Verte SARL**.
5. Cliquez sur **Actualiser** pour afficher les résultats.

Le rapport affichera uniquement les données de ventes pour ce client, et le graphique mettra en évidence les tendances spécifiques à cette entité.

::mermaid
flowchart TD
A\[Sélectionner la période] --> B\[Choisir le type d'arbre]
B --> C\[Filtrer par entité]
C --> D\[Actualiser le rapport]
D --> E\[Analyser les résultats]

::

## Rapport d'analyse des achats

Le rapport **Analyse des achats** fonctionne de manière similaire, mais pour vos données d'achats. Vous pouvez filtrer par fournisseur ou groupe de fournisseurs.

### Filtres disponibles

- **Période** : Sélectionnez la période à analyser.
- **Type d'arbre** : Choisissez entre **Fournisseur** ou **Groupe de fournisseurs**.
- **Entité** : Sélectionnez un ou plusieurs fournisseurs ou groupes de fournisseurs pour limiter l'analyse.
- **Courbes** : Choisissez les données à afficher dans le graphique (montant total, quantité, etc.).

### Exemple d'utilisation

Vous souhaitez analyser les achats réalisés auprès du fournisseur **Bureau Moderne** pour l'année en cours.

1. Allez dans **Achats > Rapports > Analyse des achats**.
2. Sélectionnez la période **Année en cours**.
3. Dans **Type d'arbre**, choisissez **Fournisseur**.
4. Dans **Entité**, sélectionnez **Bureau Moderne**.
5. Cliquez sur **Actualiser** pour afficher les résultats.

Le rapport affichera uniquement les données d'achats pour ce fournisseur, et le graphique mettra en évidence les tendances spécifiques à cette entité.

::mermaid
flowchart TD
A\[Sélectionner la période] --> B\[Choisir le type d'arbre]
B --> C\[Filtrer par entité]
C --> D\[Actualiser le rapport]
D --> E\[Analyser les résultats]

::

## Bonnes pratiques

- Utilisez le filtre **Entité** pour comparer les performances de clients ou fournisseurs spécifiques.
- Combinez les filtres **Période** et **Entité** pour analyser les tendances sur des durées précises.
- Exportez les données au format Excel ou CSV pour des analyses plus approfondies.

::tip
Pour des analyses plus avancées, vous pouvez également utiliser les **Tableaux de bord** pour créer des vues personnalisées avec plusieurs rapports et graphiques.
::


# Réception d'une e-facture depuis une plateforme agréée

## Principe

Depuis le 1er janvier 2026, les entreprises françaises soumises à TVA doivent recevoir leurs factures fournisseurs au format électronique via une plateforme agréée (PA) ou le Portail Public de Facturation (PPF). Dokos centralise la réception de ces e-factures et crée automatiquement les **Factures fournisseurs** correspondantes.

Chaque e-facture reçue contient le flux structuré (XML) transmis par le fournisseur. Dokos extrait les données fiscales et comptables pour générer la facture, mais certaines informations — comme la mise en page, les mentions contractuelles ou les conditions de paiement détaillées — ne sont pas toujours présentes dans le flux.

Pour conserver une traçabilité fidèle à la facture d'origine, Dokos rattache systématiquement le **PDF lisible** de la facture à la fiche *Facture fournisseur* créée.

::mermaid
flowchart LR
A\[Fournisseur émet\nune e-facture] --> B\[Plateforme agréée\ntransmet le flux XML\n+ PDF lisible]
B --> C\[Dokos reçoit\nl'e-facture]
C --> D\[Création de la\nFacture fournisseur]
D --> E{PDF lisible\nprésent dans\nle flux ?}
E -- Oui --> F\[Rattachement du PDF\nà la facture fournisseur]
E -- Non --> G\[Réessai automatique\nau prochain flux]
G --> F
F --> H\[Facture consultable\navec document d'origine]

::

## Rattachement du PDF lisible

### Pourquoi un PDF lisible ?

Le flux électronique structuré (XML) contient les données exploitables par votre logiciel, mais n'est pas conçu pour être lu par un humain. Le PDF lisible correspond à la présentation visuelle de la facture telle qu'elle a été émise par le fournisseur. Il permet :

- de vérifier visuellement la conformité de la facture,
- de retrouver des informations non structurées (conditions générales, logo, annotations manuscrites),
- de conserver une preuve comptable et fiscale lisible,
- de faciliter la validation par les équipes achats.

### Comportement de Dokos

À la réception d'une e-facture depuis une plateforme agréée, Dokos tente de récupérer le PDF lisible transmis dans le flux. Plusieurs cas peuvent se présenter :

| Situation                                           | Action de Dokos                                                                                             |
| --------------------------------------------------- | ----------------------------------------------------------------------------------------------------------- |
| Le PDF lisible est présent dans le flux             | Dokos le rattache immédiatement à la **Facture fournisseur** créée.                                         |
| Le PDF n'est pas encore disponible (flux incomplet) | Dokos réessaie automatiquement le rattachement lors des prochains flux reçus.                               |
| Le PDF ne peut pas être récupéré                    | Dokos ne bloque pas la création de la facture ; le flux structuré reste suffisant pour la saisie comptable. |

Les réessais sont effectués en arrière-plan, sans intervention de votre part. Le rattachement du PDF s'effectue dès que la plateforme agréée le transmet.

### Consultation du PDF rattaché

Une fois la facture fournisseur créée, le PDF lisible apparaît dans la section **Pièces jointes** de la fiche.

1. Ouvrez la **Facture fournisseur** concernée.
2. Descendez jusqu'à la section **Pièces jointes** (en bas de page).
3. Cliquez sur le fichier PDF pour le visualiser dans Dokos ou le télécharger.

> 💡 **Astuce** — Le PDF rattaché conserve le nom du fichier tel que transmis par la plateforme agréée. Vous pouvez le renommer directement depuis la liste des pièces jointes si besoin.

## Exemple concret

Le fournisseur **Bureau Moderne** transmet une facture d'achat de fournitures de bureau via une plateforme agréée. Dokos reçoit le flux électronique et crée automatiquement une **Facture fournisseur** au nom de *Bureau Moderne*.

Le PDF lisible de la facture — qui contient le logo de l'entreprise, le détail des articles et les conditions générales de vente — n'est pas disponible immédiatement dans le flux. Dokos réessaie le rattachement lors des prochaines e-factures reçues. Quelques minutes plus tard, le PDF est transmis par la plateforme et rattaché à la facture.

Vous pouvez alors consulter la facture dans Dokos, vérifier le détail visuel via le PDF, puis valider la facture pour comptabilisation.

## Points de vigilance

- **Pas de blocage** : l'absence temporaire du PDF lisible n'empêche ni la création ni la soumission de la facture fournisseur.
- **Rétention** : le PDF rattaché est conservé dans Dokos comme toute pièce jointe. Assurez-vous que votre politique d'archivage est conforme aux obligations légales de conservation des factures (10 ans en France).
- **Doublons** : si un PDF est déjà rattaché à la facture, Dokos ne l'ajoute pas une seconde fois. Vérifiez les pièces jointes avant de réimporter manuellement un document.

## Voir aussi

n

- [Configuration des plateformes agréées](https://doc.dokos.io/../plateforme-agreee)
- [Factures fournisseurs](https://doc.dokos.io/factures-fournisseurs)
- [Rapprochement bancaire et paiement des fournisseurs](https://doc.dokos.io/../paiements/paiement-fournisseurs)


# v5.0.0

::callout{color="red" icon="i-heroicons-fire"}
Si vous êtes Responsable Système de votre site Dokos, veuillez prendre connaissance des informations de migration avant la mise à jour de votre site.

Veuillez aussi consulter les informations concernant [Dodock](https://doc.dokos.io/v5/dodock/versions/v5.x.x/v5_0_0) et le [guide de migration pour les développeurs](https://doc.dokos.io/v5/dodock/versions/v5.x.x/migration-developpeurs) si vous maintenez des personnalisations.
::

::callout
La version 5.0.0 de Dokos est basée sur la version 16 d'ERPNext.
Une grande partie des changements cités ci-dessous ont été développés par l'équipe de Frappe Technologies et les contributeurs aux logiciels de l'éco-système Frappe/ERPNext.
Le détail des changements publiés dans Dokos est disponible sur [GitLab](https://gitlab.com/dokos/dokos/-/releases/v5.0.0){rel=""nofollow""}
::

> Le détail des nouveautés est disponible sur la page [Dodock v5.0.0](https://doc.dokos.io/v5/dodock/versions/v5.x.x/v5_0_0).


# v4.0.0

::callout{color="red" icon="i-heroicons-fire"}
Si vous êtes Responsable Système de votre site Dokos, veuillez prendre connaissance des informations de migration ci-dessous avant la mise à jour de votre site.

Veuillez aussi consulter les informations concernant [Dodock](https://doc.dokos.io/v5/dodock/versions/v4.x.x/v4_0_0) et [HRMS](https://doc.dokos.io/v5/dokos/hrms/versions/v2.x.x/v2_0_0).
::

::callout
La version 4.0.0 de Dokos est basée sur la version 15 d'ERPNext.
Une grande partie des changements cités ci-dessous ont été développés par l'équipe de Frappe Technologies et les contributeurs de l'éco-système Frappe/ERPNext.
Le détail des changements publiés dans Dokos est disponible sur [GitLab](https://gitlab.com/dokos/dokos/-/releases){rel=""nofollow""}
::

## Migration vers la v4

> [Guide de migration pour les utilisateurs auto-hébergés](https://doc.dokos.io/v5/dodock/administration/migration-v4)

> [Migration de Dokos : v3 > v4 (ERPNext v14 > v15)](https://github.com/frappe/erpnext/wiki/Migration-Guide-to-ERPNext-version-15){rel="&#x22;nofollow&#x22;"}

### Nouveau fonctionnement du système d'Abonnement

La gestion des abonnements a été simplifiée dans Dokos 4. Les modèles de Plan d'abonnement ont été remplacés par les Articles récurrents et les Périodes de récurrence.

**Une migration automatique vers le nouveau système est appliquée lors de la mise à jour vers Dokos 4. Pensez à vérifier vos Abonnements en cours, les Articles qui sont devenus récurrents et leurs prix dans la Liste de prix.**

**Si vous proposez des abonnements à vos clients sur votre site web, vérifiez que les « Articles du Site Web » liés sont bien configurés.**

Supposons que j'avais un Plan d'abonnement intitulé « Abonnement Coworking mensuel » qui facturait un Article « Abonnement mensuel au coworking » tous les mois.
Désormais, je vais pouvoir cocher la case « Est un article récurrent » sur mon Article « Abonnement mensuel au coworking » et lui adjoindre une Période de récurrence de « 1 mois ». Dès que mon Client fera une Commande pour cet Article, un Abonnement sera créé et une commande (et optionnellement une facture) sera générée tous les mois. Cette commande pourra être payée automatiquement par prélèvement, ou depuis le portail. Je pourrais même n'avoir qu'un seul article « Abonnement Coworking » et proposer différentes Périodes de récurrence avec différents prix.

![Article > Abonnement mensuel au coworking. Onglet Abonnements. Case à cocher Est un article récurrent. Périodes de récurrence pour cet article : 1 Mois.](https://doc.dokos.io/content/lieu/subcription-plan/article-recurrent.png)

### Nouveau fonctionnement des paiements sur le portail

Le système de paiement sur le portail a été amélioré dans Dokos 4. Désormais vous pouvez proposer des Modes de paiement sur votre site web, avec des Passerelles de paiement associées. Les Passerelles de paiement sont les services tiers qui permettent de gérer les paiements en ligne (Stripe, GoCardless, etc.), tandis que les Modes de paiement sont présentés à vos clients sur le portail (Carte bancaire, Espèces, etc.).

**Pensez à vérifier les Modes de paiement activés dans les Paramètres E-Commerce**, dans l'onglet Panier, champ « Modes de paiements autorisés ». Si le champ est vide (ce qui peut survenir lors de la migration), alors tous les Modes de paiement sont disponibles, ce qui rend accessible à n'importe qui vos Modes de paiement de test.

![Paiement 20,40 €. Veuillez sélectionner le mode de paiement : Carte de crédit, Virement.](https://doc.dokos.io/content/\(unsorted\)/payments-portal.png)

### Changement du webhook GoCardless

Les fonctionnalités liées aux paiements ayant été déplacées dans une nouvelle application ([Payments](https://gitlab.com/dokos/payments){rel="&#x22;nofollow&#x22;"}), le webhook GoCardless a été déplacé également. Pour l'instant, vous n'avez rien à faire, mais il est fortement recommandé de mettre à jour l'URL de Webhook sur le site GoCardless pour pointer vers la bonne URL sur votre site Dokos.

Malheureusement, GoCardless ne permet pas de faire ce changement automatiquement. Vous devez donc vous rendre sur le site GoCardless, dans la section Développeurs, et modifier l'URL du webhook pour qu'elle pointe vers l'URL suivante : `https://<votre-site-dokos>/api/method/payments.payment_gateways.doctype.gocardless_settings.webhooks`.

Pour information, voici l'ancienne URL du webhook : \`https\:// :votre-site-dokos[/api/method/erpnext.erpnext\_integrations.doctype.gocardless\_settings.webhooks\`
]

## Fonctionnalités et améliorations

- Ajout de dimensions comptables à la soumission de fournisseur par deepeshgarg007 [frappe#38142](https://github.com/frappe/frappe/pull/38142){rel="&#x22;nofollow&#x22;"} [!839](https://gitlab.com/dokos/dokos/-/merge_requests/839){rel="&#x22;nofollow&#x22;"}
- Création d'ordres de paiement à partir des demandes de paiement [!837](https://gitlab.com/dokos/dokos/-/merge_requests/837){rel="&#x22;nofollow&#x22;"}
- Ajout du champ "Note de livraison fournisseur" dans SCR par s-aga-r [frappe#38127](https://github.com/frappe/frappe/pull/38127){rel="&#x22;nofollow&#x22;"} [!836](https://gitlab.com/dokos/dokos/-/merge_requests/836){rel="&#x22;nofollow&#x22;"}
- Définition du mode de paiement par défaut pour les clients, fournisseurs et employés [!832](https://gitlab.com/dokos/dokos/-/merge_requests/832){rel="&#x22;nofollow&#x22;"}
- Suppression de la méthode inutilisée "create\_contact" par barredterra [frappe#38063](https://github.com/frappe/frappe/pull/38063){rel="&#x22;nofollow&#x22;"} [!803](https://gitlab.com/dokos/dokos/-/merge_requests/803){rel="&#x22;nofollow&#x22;"}
- Ajout d'un bouton pour créer rapidement une commande de vente et une soumission par blaggacao (client) [frappe#37320](https://github.com/frappe/frappe/pull/37320){rel="&#x22;nofollow&#x22;"} [!806](https://gitlab.com/dokos/dokos/-/merge_requests/806){rel="&#x22;nofollow&#x22;"}
- Mise en place d'une vue de gestion de projet et d'affectations de tâches [!792](https://gitlab.com/dokos/dokos/-/merge_requests/792){rel="&#x22;nofollow&#x22;"}
- Ajout de l'option "in\_party\_currency" pour les rapports AR/AP par casesolved-co-uk [frappe#37746](https://github.com/frappe/frappe/pull/37746){rel="&#x22;nofollow&#x22;"} [!783](https://gitlab.com/dokos/dokos/-/merge_requests/783){rel="&#x22;nofollow&#x22;"}
- Autorisation de la sélection de plusieurs groupes de clients dans le rapport AR par vishdha [frappe#37716](https://github.com/frappe/frappe/pull/37716){rel="&#x22;nofollow&#x22;"} [!782](https://gitlab.com/dokos/dokos/-/merge_requests/782){rel="&#x22;nofollow&#x22;"}
- Mise à jour du fichier de traduction CSV par wojosc [frappe#37981](https://github.com/frappe/frappe/pull/37981){rel="&#x22;nofollow&#x22;"} [!771](https://gitlab.com/dokos/dokos/-/merge_requests/771){rel="&#x22;nofollow&#x22;"}
- Réservation des articles de plan de production en tant que sous-assemblages par rohitwaghchaure [frappe#37884](https://github.com/frappe/frappe/pull/37884){rel="&#x22;nofollow&#x22;"} [!760](https://gitlab.com/dokos/dokos/-/merge_requests/760){rel="&#x22;nofollow&#x22;"}
- Ajout d'exceptions à un calendrier de réservation d'articles pour gérer les jours fériés ou générer des créneaux supplémentaires (Réservation d'article) [!711](https://gitlab.com/dokos/dokos/-/merge_requests/711){rel="&#x22;nofollow&#x22;"}
- Ajout de filtres à partir de la route dans le rapport du solde des stocks par barredterra [frappe#37836](https://github.com/frappe/frappe/pull/37836){rel="&#x22;nofollow&#x22;"} [!735](https://gitlab.com/dokos/dokos/-/merge_requests/735){rel="&#x22;nofollow&#x22;"}
- Résumé de la facturation des feuilles de temps [frappe#37451](https://github.com/frappe/frappe/pull/37451){rel="&#x22;nofollow&#x22;"} [!732](https://gitlab.com/dokos/dokos/-/merge_requests/732){rel="&#x22;nofollow&#x22;"}
- Validation de la date de fin de période d'abonnement lors de la modification [!702](https://gitlab.com/dokos/dokos/-/merge_requests/702){rel="&#x22;nofollow&#x22;"}
- Séparation de la boutique en ligne [!634](https://gitlab.com/dokos/dokos/-/merge_requests/634){rel="&#x22;nofollow&#x22;"}
- Prévision de trésorerie [!215](https://gitlab.com/dokos/dokos/-/merge_requests/215){rel="&#x22;nofollow&#x22;"}
- Autorisation du retour de composants pour les SCO qui n'ont pas de SCR créé par s-aga-r [frappe#37686](https://github.com/frappe/frappe/pull/37686){rel="&#x22;nofollow&#x22;"} [!690](https://gitlab.com/dokos/dokos/-/merge_requests/690){rel="&#x22;nofollow&#x22;"}
- Ajout d'un lien vers la vue liste des bons de livraison à partir de la tournée de livraison par blaggacao (Livraison) [frappe#37604](https://github.com/frappe/frappe/pull/37604){rel="&#x22;nofollow&#x22;"} [!691](https://gitlab.com/dokos/dokos/-/merge_requests/691){rel="&#x22;nofollow&#x22;"}
- Fusion de la demande d'extraction #37595 de vorasmit/purchase-gl [!678](https://gitlab.com/dokos/dokos/-/merge_requests/678){rel="&#x22;nofollow&#x22;"}
- Réserve automatique des stocks pour la commande client lors de l'achat par s-aga-r [frappe#37603](https://github.com/frappe/frappe/pull/37603){rel="&#x22;nofollow&#x22;"} [!681](https://gitlab.com/dokos/dokos/-/merge_requests/681){rel="&#x22;nofollow&#x22;"}
- Ajout d'une méthode pour la quantité facturée dans le module fournisseur (Supplier Scorecard) par Vishnu7025 [frappe#37580](https://github.com/frappe/frappe/pull/37580){rel="&#x22;nofollow&#x22;"} [!668](https://gitlab.com/dokos/dokos/-/merge_requests/668){rel="&#x22;nofollow&#x22;"}
- Ajout des informations bancaires à la transaction bancaire [!625](https://gitlab.com/dokos/dokos/-/merge_requests/625){rel="&#x22;nofollow&#x22;"}
- Validation du stock négatif pour la dimension d'inventaire (retour en arrière #37373) par mergify [bot] [frappe#37383](https://github.com/frappe/frappe/pull/37383){rel="&#x22;nofollow&#x22;"} [!624](https://gitlab.com/dokos/dokos/-/merge_requests/624){rel="&#x22;nofollow&#x22;"}
- Arrondissement du montant de la taxe par ligne d'article par rtdany10 [frappe#36780](https://github.com/frappe/frappe/pull/36780){rel="&#x22;nofollow&#x22;"} [!617](https://gitlab.com/dokos/dokos/-/merge_requests/617){rel="&#x22;nofollow&#x22;"}
- Actif WIP composite (copie #37352) par mergify [bot] [frappe#37353](https://github.com/frappe/frappe/pull/37353){rel="&#x22;nofollow&#x22;"} [!573](https://gitlab.com/dokos/dokos/-/merge_requests/573){rel="&#x22;nofollow&#x22;"}
- Pourcentage de valeur résiduelle d'actif par anandbaburajan [frappe#37302](https://github.com/frappe/frappe/pull/37302){rel="&#x22;nofollow&#x22;"} [!567](https://gitlab.com/dokos/dokos/-/merge_requests/567){rel="&#x22;nofollow&#x22;"}
- Facture d'achat modifiable par GursheenK [frappe#37194](https://github.com/frappe/frappe/pull/37194){rel="&#x22;nofollow&#x22;"} [!546](https://gitlab.com/dokos/dokos/-/merge_requests/546){rel="&#x22;nofollow&#x22;"}
- Ajout de la TVA du Botswana par kalungia [frappe#37212](https://github.com/frappe/frappe/pull/37212){rel="&#x22;nofollow&#x22;"} [!542](https://gitlab.com/dokos/dokos/-/merge_requests/542){rel="&#x22;nofollow&#x22;"}
- Regroupement des colonnes "Client" et "Fournisseur" avec l'adresse et le contact principaux par FHenry [frappe#37190](https://github.com/frappe/frappe/pull/37190){rel="&#x22;nofollow&#x22;"} [!538](https://gitlab.com/dokos/dokos/-/merge_requests/538){rel="&#x22;nofollow&#x22;"}
- Basculement des valeurs nettes dans le rapport du bilan d'essai par deepeshgarg007 [frappe#37211](https://github.com/frappe/frappe/pull/37211){rel="&#x22;nofollow&#x22;"} [!534](https://gitlab.com/dokos/dokos/-/merge_requests/534){rel="&#x22;nofollow&#x22;"}
- Rapport "Stock Ledger Variance" par s-aga-r [frappe#37165](https://github.com/frappe/frappe/pull/37165){rel="&#x22;nofollow&#x22;"} [!527](https://gitlab.com/dokos/dokos/-/merge_requests/527){rel="&#x22;nofollow&#x22;"}
- Autorisation de la modification de la quantité de stock dans les transactions d'achat et de vente par rohitwaghchaure [frappe#36600](https://github.com/frappe/frappe/pull/36600){rel="&#x22;nofollow&#x22;"} [!525](https://gitlab.com/dokos/dokos/-/merge_requests/525){rel="&#x22;nofollow&#x22;"}
- Améliorations des espaces de travail [!521](https://gitlab.com/dokos/dokos/-/merge_requests/521){rel="&#x22;nofollow&#x22;"}
- Ajout d'un filtre de groupe d'articles dans le registre d'achat par article par Nandhinidevi123 [frappe#36937](https://github.com/frappe/frappe/pull/36937){rel="&#x22;nofollow&#x22;"} [!516](https://gitlab.com/dokos/dokos/-/merge_requests/516){rel="&#x22;nofollow&#x22;"}
- Validation de la date en double dans la liste des jours fériés par niyazrazak [frappe#37022](https://github.com/frappe/frappe/pull/37022){rel="&#x22;nofollow&#x22;"} [!515](https://gitlab.com/dokos/dokos/-/merge_requests/515){rel="&#x22;nofollow&#x22;"}
- Provision pour créer RIV à partir du rapport "Stock Ledger Invariant Check" par s-aga-r [frappe#37115](https://github.com/frappe/frappe/pull/37115){rel="&#x22;nofollow&#x22;"} [!512](https://gitlab.com/dokos/dokos/-/merge_requests/512){rel="&#x22;nofollow&#x22;"}
- Déconciliation des paiements par ruthra-kumar [frappe#36879](https://github.com/frappe/frappe/pull/36879){rel="&#x22;nofollow&#x22;"} [!493](https://gitlab.com/dokos/dokos/-/merge_requests/493){rel="&#x22;nofollow&#x22;"}
- Création du groupe d'articles "basé sur" pour spécifier un pourcentage différent par HarryPaulo [frappe#37032](https://github.com/frappe/frappe/pull/37032){rel="&#x22;nofollow&#x22;"} [!486](https://gitlab.com/dokos/dokos/-/merge_requests/486){rel="&#x22;nofollow&#x22;"}
- Provision pour définir le responsable à partir du plan de production (retour en arrière #37039) par mergify [bot] [frappe#37040](https://github.com/frappe/frappe/pull/37040){rel="&#x22;nofollow&#x22;"} [!473](https://gitlab.com/dokos/dokos/-/merge_requests/473){rel="&#x22;nofollow&#x22;"}
- Ajout d'une périodicité de maintenance d'actif semestrielle par bosue [frappe#37006](https://github.com/frappe/frappe/pull/37006){rel="&#x22;nofollow&#x22;"} [!468](https://gitlab.com/dokos/dokos/-/merge_requests/468){rel="&#x22;nofollow&#x22;"}
- Améliorations des espaces de travail [!441](https://gitlab.com/dokos/dokos/-/merge_requests/441){rel="&#x22;nofollow&#x22;"}
- Intégration Pappers [!442](https://gitlab.com/dokos/dokos/-/merge_requests/442){rel="&#x22;nofollow&#x22;"}
- Réservation série et lot par s-aga-r [frappe#35946](https://github.com/frappe/frappe/pull/35946){rel="&#x22;nofollow&#x22;"} [!442](https://gitlab.com/dokos/dokos/-/merge_requests/442){rel="&#x22;nofollow&#x22;"}
- Carte des articles de service et des produits finis par s-aga-r [frappe#36647](https://github.com/frappe/frappe/pull/36647){rel="&#x22;nofollow&#x22;"} [!450](https://gitlab.com/dokos/dokos/-/merge_requests/450){rel="&#x22;nofollow&#x22;"}
- Onboarding du module de projet et visite du formulaire [!405](https://gitlab.com/dokos/dokos/-/merge_requests/405){rel="&#x22;nofollow&#x22;"}
- Le graphique en barres du résumé du projet affiche désormais le total correct des tâches [!435](https://gitlab.com/dokos/dokos/-/merge_requests/435){rel="&#x22;nofollow&#x22;"}
- Ajout d'icônes au mode de paiement à l'installation [!427](https://gitlab.com/dokos/dokos/-/merge_requests/427){rel="&#x22;nofollow&#x22;"}
- Hook pour fournir des modes de paiement autorisés à l'application de paiement [!426](https://gitlab.com/dokos/dokos/-/merge_requests/426){rel="&#x22;nofollow&#x22;"}
- Provision pour ajouter des articles de rebut dans le reçu de sous-traitance par s-aga-r [frappe#36811](https://github.com/frappe/frappe/pull/36811){rel="&#x22;nofollow&#x22;"} [!419](https://gitlab.com/dokos/dokos/-/merge_requests/419){rel="&#x22;nofollow&#x22;"}
- Outil d'importation de FEC [!119](https://gitlab.com/dokos/dokos/-/merge_requests/119){rel="&#x22;nofollow&#x22;"}
- Affichage de l'UOM dans la liste des articles sur le site Web (commerce électronique) [!401](https://gitlab.com/dokos/dokos/-/merge_requests/401){rel="&#x22;nofollow&#x22;"}
- Autoriser le traitement des retours pour une facture de vente associée à une commande de vente déjà fermée. *par gouravsaini021* [frappe#36676](https://github.com/frappe/frappe/pull/36676){rel="&#x22;nofollow&#x22;"} [!414](https://gitlab.com/dokos/dokos/-/merge_requests/414){rel="&#x22;nofollow&#x22;"}
- Créer des nomenclatures multi-niveaux. *par rohitwaghchaure* [frappe#36494](https://github.com/frappe/frappe/pull/36494){rel="&#x22;nofollow&#x22;"} [!396](https://gitlab.com/dokos/dokos/-/merge_requests/396){rel="&#x22;nofollow&#x22;"}
- Introduire l'inspection de la qualité pour les réceptions en sous-traitance. *par s-aga-r* [frappe#36786](https://github.com/frappe/frappe/pull/36786){rel="&#x22;nofollow&#x22;"} [!394](https://gitlab.com/dokos/dokos/-/merge_requests/394){rel="&#x22;nofollow&#x22;"}
- Ajouter les champs "Projet" et "Centre de coût" aux connexions. *par barredterra* [frappe#36794](https://github.com/frappe/frappe/pull/36794){rel="&#x22;nofollow&#x22;"} [!392](https://gitlab.com/dokos/dokos/-/merge_requests/392){rel="&#x22;nofollow&#x22;"}
- Afficher les créneaux de réservation sélectionnés. [!391](https://gitlab.com/dokos/dokos/-/merge_requests/391){rel="&#x22;nofollow&#x22;"}
- Améliorer le sélecteur de réservation d'articles. [!381](https://gitlab.com/dokos/dokos/-/merge_requests/381){rel="&#x22;nofollow&#x22;"}
- Mettre à jour les articles pour les commandes d'achat en sous-traitance. *par s-aga-r* [frappe#36752](https://github.com/frappe/frappe/pull/36752){rel="&#x22;nofollow&#x22;"} [!386](https://gitlab.com/dokos/dokos/-/merge_requests/386){rel="&#x22;nofollow&#x22;"}
- Ajouter l'option d'envoi d'impression de document pour les demandes de devis. *par barredterra* [frappe#36363](https://github.com/frappe/frappe/pull/36363){rel="&#x22;nofollow&#x22;"} [!377](https://gitlab.com/dokos/dokos/-/merge_requests/377){rel="&#x22;nofollow&#x22;"}
- Migrer la page de rapprochement bancaire vers Vue3 + Tabulator. [!370](https://gitlab.com/dokos/dokos/-/merge_requests/370){rel="&#x22;nofollow&#x22;"}
- Ajouter des colonnes de devise de transaction dans le rapport GL. [frappe#36684](https://github.com/frappe/frappe/pull/36684){rel="&#x22;nofollow&#x22;"} [!362](https://gitlab.com/dokos/dokos/-/merge_requests/362){rel="&#x22;nofollow&#x22;"}
- Apporter des améliorations aux abonnements. [!307](https://gitlab.com/dokos/dokos/-/merge_requests/307){rel="&#x22;nofollow&#x22;"}
- RitvikSardana/develop-ritvik-POS-runtime-effect [frappe#36492](https://github.com/frappe/frappe/pull/36492){rel="&#x22;nofollow&#x22;"} [!358](https://gitlab.com/dokos/dokos/-/merge_requests/358){rel="&#x22;nofollow&#x22;"}
- deepeshgarg007/ignore\_prepared\_report [frappe#36677](https://github.com/frappe/frappe/pull/36677){rel="&#x22;nofollow&#x22;"} [!354](https://gitlab.com/dokos/dokos/-/merge_requests/354){rel="&#x22;nofollow&#x22;"}
- ruthra-kumar/toggle\_for\_negative\_rates [frappe#36642](https://github.com/frappe/frappe/pull/36642){rel="&#x22;nofollow&#x22;"} [!349](https://gitlab.com/dokos/dokos/-/merge_requests/349){rel="&#x22;nofollow&#x22;"}
- ruthra-kumar/readd\_permissions\_in\_journal [frappe#36663](https://github.com/frappe/frappe/pull/36663){rel="&#x22;nofollow&#x22;"} [!353](https://gitlab.com/dokos/dokos/-/merge_requests/353){rel="&#x22;nofollow&#x22;"}

- [Inclusion des totaux de facture dans le rapport de retenue d'impôt](https://gitlab.com/dokos/dokos/-/merge_requests/343){rel="&#x22;nofollow&#x22;"}
- [Option pour activer l'inclusion des feuilles de temps en brouillon](https://gitlab.com/dokos/dokos/-/merge_requests/340){rel="&#x22;nofollow&#x22;"}
- [Utilitaire pour reposter les registres comptables sans annulation](https://gitlab.com/dokos/dokos/-/merge_requests/312){rel="&#x22;nofollow&#x22;"}
- [Personnalisation possible de la transmission des pièces jointes](https://gitlab.com/dokos/dokos/-/merge_requests/305){rel="&#x22;nofollow&#x22;"}
- [Création d'un rapport de comparaison des registres](https://gitlab.com/dokos/dokos/-/merge_requests/302){rel="&#x22;nofollow&#x22;"}
- [Personnalisation complète des messages électroniques](https://gitlab.com/dokos/dokos/-/merge_requests/303){rel="&#x22;nofollow&#x22;"}
- [Ajout du rapport de Ratio Financier](https://gitlab.com/dokos/dokos/-/merge_requests/288){rel="&#x22;nofollow&#x22;"}
- [Surveillance de l'activité des actifs](https://gitlab.com/dokos/dokos/-/merge_requests/273){rel="&#x22;nofollow&#x22;"}
- [Réautorisation de la personnalisation de l'abréviation de l'entreprise lors de la configuration](https://gitlab.com/dokos/dokos/-/merge_requests/282){rel="&#x22;nofollow&#x22;"}
- [Nouvelle fonctionnalité dans le panier : Affichage de l'unité de mesure et correction d'affichage](https://gitlab.com/dokos/dokos/-/merge_requests/246){rel="&#x22;nofollow&#x22;"}
- [Ajout d'un bouton pour désactiver une adresse depuis le portail utilisateur](https://gitlab.com/dokos/dokos/-/merge_requests/243){rel="&#x22;nofollow&#x22;"}
- [Amélioration de la gestion de l'étiquette "Skip CI" dans les demandes de fusion](https://gitlab.com/dokos/dokos/-/merge_requests/244){rel="&#x22;nofollow&#x22;"}
- [Filtrage des analyses de rentabilité par dimensions comptables](https://gitlab.com/dokos/dokos/-/merge_requests/217){rel="&#x22;nofollow&#x22;"}
- [Automatisation des relances basées sur les paiements](https://gitlab.com/dokos/dokos/-/merge_requests/195){rel="&#x22;nofollow&#x22;"}
- [Ajout des Leads au rapport Adresse et contact](https://gitlab.com/dokos/dokos/-/merge_requests/199){rel="&#x22;nofollow&#x22;"}
- [Inclusion des jours fériés locaux](https://gitlab.com/dokos/dokos/-/merge_requests/170){rel="&#x22;nofollow&#x22;"}
- [Automatisation des réévaluations des taux de change](https://gitlab.com/dokos/dokos/-/merge_requests/147){rel="&#x22;nofollow&#x22;"}
- [Filtre projet dans l'importation de rapports d'états financiers](https://gitlab.com/dokos/dokos/-/merge_requests/163){rel="&#x22;nofollow&#x22;"}
- [Correction : Ambiguïté de la colonne 'qty' dans la liste des champs (work\_order.py)](https://gitlab.com/dokos/dokos/-/merge_requests/134){rel="&#x22;nofollow&#x22;"}
- [Enregistrement des paiements anticipés en tant que passif](https://gitlab.com/dokos/dokos/-/merge_requests/132){rel="&#x22;nofollow&#x22;"}
- Standardisation des colonnes supplémentaires pour les rapports de ventes/achats
- Utilisation de l'outil forktool pour créer automatiquement des demandes de fusion
- Ajout d'une méthode pour la quantité commandée dans le scorecard des fournisseurs
- Gestion du retour partiel des composants par rapport à SCO
- Rapport de solde par bon d'échange pour les entrées GL dépareillées en débit/crédit
- Prise en charge des dimensions obligatoires par compte sans restrictions sur les valeurs
- Envoi possible de rapports de comptes clients via le processus SOA
- Autorisation d'utiliser la facture de vente comme source de données
- Aperçu du grand livre
- Ajout d'un plan comptable vérifié avec deux variantes pour la Colombie
- Nouvelle option pour configurer les facteurs de conversion d'unités de mesure avec une minute dans les paramètres de lieu
- Introduction de nouveaux graphiques dans l'espace de travail Finances
- Possibilité de créer des devis pour des prospects
- Ajout de graphiques au tableau de bord Finances
- Normalisation des numéros de série et des groupes de lots de série
- Affichage du journal comptable sélectionné dans les documents tels que les factures de vente et d'achat, les paiements et les écritures comptables
- [Nouvelle fonctionnalité dans le panier : Formulaire/dialogue d'adresse personnalisé](https://gitlab.com/dokos/dokos/-/merge_requests/118){rel="&#x22;nofollow&#x22;"}
- [Nouvelle fonctionnalité : Blocs de panier d'achat](https://gitlab.com/dokos/dokos/-/merge_requests/117){rel="&#x22;nofollow&#x22;"}
- Ajout du plan comptable portugais SNC
- Introduction d'un nouvel espace de travail Finances avec des sous-espaces dédiés
- Ajout d'un graphique pour le solde des relevés bancaires
- Utilisation de cartes numériques pour la gestion des parts
- [Ajout de points de retrait / Lieux de récupération](https://gitlab.com/dokos/dokos/-/merge_requests/114){rel="&#x22;nofollow&#x22;"}
- Intégration du calendrier des tâches dans bootinfo.calendars
- Possibilité de réserver du stock par rapport aux commandes de vente
- Option pour ignorer les éléments de sous-assemblage disponibles dans le plan de production
- Redirection automatique vers la passerelle de paiement si configurée dans les paramètres du commerce électronique
- Mise en place de dimensions obligatoires et dépendantes dans la dimension de l'inventaire
- Capacité à répéter les opérations à partir du rapport de comparaison des valeurs de stock et de compte
- Possibilité de copier des projets de la feuille de temps vers les factures
- [Nouvelle fonctionnalité : Formule personnalisée pour les règles d'expédition](https://gitlab.com/dokos/dokos/-/merge_requests/95){rel="&#x22;nofollow&#x22;"}
- [Corrections pour l'expiration des crédits de réservation](https://gitlab.com/dokos/dokos/-/merge_requests/112){rel="&#x22;nofollow&#x22;"}
- [Résolution du problème " [Nouvelle fonctionnalité] Les créneaux horaires des événements peuvent dépasser ceux des événements parent"](https://gitlab.com/dokos/dokos/-/merge_requests/109){rel="&#x22;nofollow&#x22;"}
- Configuration pour notifier les erreurs de re-postage à un rôle spécifique
- Réservation de la quantité de matières premières du plan de production dans BIN
- Réconciliation automatique des paiements en arrière-plan
- [Correction du format "Montant sur la ligne précédente" en cas de référence non précédente](https://gitlab.com/dokos/dokos/-/merge_requests/99){rel="&#x22;nofollow&#x22;"}
- [Ajout de nouveaux graphiques et espaces de travail pour le module d'achat](https://gitlab.com/dokos/dokos/-/merge_requests/88){rel="&#x22;nofollow&#x22;"}
- Notification d'avertissement pour les écritures de journal liées à plusieurs journaux
- Mise à jour de l'image Docker la plus récente
- Allocation automatisée des paiements anticipés exclusivement pour les commandes
- Suppression de la méthode obsolète get\_customer\_list
- [Amélioration des processus d'inscription aux événements](https://gitlab.com/dokos/dokos/-/merge_requests/94){rel="&#x22;nofollow&#x22;"}
- Calcul du solde de clôture pour les opérations de clôture et les rapports périodiques
- [Ajout d'un outil de configuration du calendrier pour la réservation d'articles](https://gitlab.com/dokos/dokos/-/merge_requests/92){rel="&#x22;nofollow&#x22;"}
- [Extension de la liste déroulante de la périodicité pour inclure 3 ans](https://gitlab.com/dokos/dokos/-/merge_requests/92){rel="&#x22;nofollow&#x22;"}
- Calcul du solde de clôture pour les opérations de clôture et les rapports périodiques
- Prise en compte des ajustements et des taxes pour les lignes supplémentaires
- [Exécution de CI pour des branches spécifiques Dodock avec [dodock-branch=fix-set-monday-as-first-day-of-the-week]](https://gitlab.com/dokos/dokos/-/merge_requests/71){rel="&#x22;nofollow&#x22;"}
- Prise en charge d'articles alternatifs dans les devis
- [Amélioration de la gestion des ressources](https://gitlab.com/dokos/dokos/-/merge_requests/65){rel="&#x22;nofollow&#x22;"}
- Prise en charge d'articles alternatifs dans les devis
- [Construction automatisée des images Docker](https://gitlab.com/dokos/dokos/-/merge_requests/64){rel="&#x22;nofollow&#x22;"}
- Ajustement automatique du taux de valorisation du bon de réception en fonction du taux de la facture d'achat
- [Amélioration de la recherche de réservations](https://gitlab.com/dokos/dokos/-/merge_requests/61){rel="&#x22;nofollow&#x22;"}
- [Nouvelle fonctionnalité : Étiquette multi-entreprise](https://gitlab.com/dokos/dokos/-/merge_requests/62){rel="&#x22;nofollow&#x22;"}
- [Nouvelle fonctionnalité : Paramétrage par défaut "Est un article en stock" à "Faux"](https://gitlab.com/dokos/dokos/-/merge_requests/56){rel="&#x22;nofollow&#x22;"}
- Ajout d'une barre latérale à la page de réservation
- Ajout d'un bouton pour créer un champ de profil de rôle personnalisé à partir des paramètres du lieu
- [Amélioration de la recherche de réservation et des articles](https://gitlab.com/dokos/dokos/-/merge_requests/60){rel="&#x22;nofollow&#x22;"}
- Retrait du code régional KSA
- Option pour définir un profil de rôle par défaut pour tous les utilisateurs liés au client/fournisseur
- Autorisation d'ignorer le panier dans le portail pour certains rôles
- Attribution automatique de profils de rôle aux utilisateurs associés à un groupe de clients ou de fournisseurs spécifique
- Ajout de détails de plan d'abonnement à la section du lieu
- Prise en charge de plusieurs codes-barres par article en validant avec le module de numéro de code-barres
- Ajout d'un nouveau champ de type de transaction dans la transaction bancaire, ainsi que des corrections pour la mise à jour Plaid
- Conversion possible des repostages basés sur les transactions en entrées d'articles d'entrepôt
- [Amélioration de la recherche de réservation et des articles](https://gitlab.com/dokos/dokos/-/merge_requests/55){rel="&#x22;nofollow&#x22;"}
- Option pour mettre fin à un abonnement à la fin de la période
- Possibilité de créer des entrées de transfert en transit à partir de la demande de matières
- Améliorations pour la Préparation de la Déclaration Fiscale en France
- Traduction des éléments préconfigurés pendant l'exécution, pas seulement à l'installation
- Paramètre pour autoriser la création de commandes de vente à partir de devis expirés
- Ajout de filtres dans le Rapport d'Intérêts de Prêt
- [Améliorations pour les lieux](https://gitlab.com/dokos/dokos/-/merge_requests/50){rel="&#x22;nofollow&#x22;"}
- [Améliorations pour les demandes de paiement](https://gitlab.com/dokos/dokos/-/merge_requests/49){rel="&#x22;nofollow&#x22;"}
- [Améliorations pour les inscriptions aux événements](https://gitlab.com/dokos/dokos/-/merge_requests/43){rel="&#x22;nofollow&#x22;"}
- [Amélioration de la recherche de liens](https://gitlab.com/dokos/dokos/-/merge_requests/46){rel="&#x22;nofollow&#x22;"}
- [Améliorations multi-entreprise pour les lieux](https://gitlab.com/dokos/dokos/-/merge_requests/30){rel="&#x22;nofollow&#x22;"}
- Option pour afficher/masquer le solde du compte dans le Plan Comptable
- Page de réservation de ressources ajoutée
- [Comptabilisation des abonnements comme des réservations](https://gitlab.com/dokos/dokos/-/merge_requests/42){rel="&#x22;nofollow&#x22;"}
- Ajout d'un filtre d'entrepôt pour le rapport de marge brute
- Ajout de l'incoterm "named place" à la Demande de Prix
- Intégration de dimensions obligatoires et dépendantes dans la dimension d'inventaire
- Support pour des prix multiples par article
- Création d'une nouvelle page "book-resources" pour la réservation d'articles
- Possibilité d'obtenir des articles à partir de l'Entrée de Stock en Transit
- Ajout du coût opérationnel basé sur la quantité de nomenclature sans créer de fiche de travail
- [Mineur] Intégration du type de date basé sur le filtre dans le rapport Résumé des Ordres de Travail
- Désactivation de l'API d'échange de devises
- Séparation du planning de dépréciation des actifs en un nouveau document
- Ajout d'un nouveau type de Poste de Travail pour la Nomenclature

## Refonte du code et des fonctionnalités existantes

- **[Champ "Généré par le système" et remarques améliorées dans les Entrées de Journal](https://gitlab.com/dokos/dokos/-/merge_requests/320){rel="&#x22;nofollow&#x22;"}*&#x2A; &#x2A;[erpnext#36573](https://github.com/frappe/erpnext/pull/36573){rel="&#x22;nofollow&#x22;"}*
- **[Montant de gain/perte d'échange pour la réservation via le journal](https://gitlab.com/dokos/dokos/-/merge_requests/284){rel="&#x22;nofollow&#x22;"}*&#x2A; &#x2A;[erpnext#35644](https://github.com/frappe/erpnext/pull/35644){rel="&#x22;nofollow&#x22;"}*
- **[Utilisation de base\_tax\_withholding\_net\_total pour la validation du seuil](https://gitlab.com/dokos/dokos/-/merge_requests/309){rel="&#x22;nofollow&#x22;"}**
- **[Introduction et utilisation de mixins dans les tests unitaires](https://gitlab.com/dokos/dokos/-/merge_requests/253){rel="&#x22;nofollow&#x22;"}**
- **[Refonte(ci) : Ajout d'ESLint et mise à jour des configurations de linting par deepeshgarg007](https://gitlab.com/dokos/dokos/-/merge_requests/213){rel="&#x22;nofollow&#x22;"}*&#x2A; &#x2A;[erpnext#36147](https://github.com/frappe/erpnext/pull/36147){rel="&#x22;nofollow&#x22;"}*
- **[Appliquer la validation basée sur les termes uniquement sur les types de documents vente/achat](https://gitlab.com/dokos/dokos/-/merge_requests/206){rel="&#x22;nofollow&#x22;"}*&#x2A; &#x2A;[erpnext#36261](https://github.com/frappe/erpnext/pull/36261){rel="&#x22;nofollow&#x22;"}*
- **[Rafraîchir la table une fois que la boucle est terminée](https://gitlab.com/dokos/dokos/-/merge_requests/204){rel="&#x22;nofollow&#x22;"}**
- **[La Demande de Congé ne devrait pas être dans hook.py](https://gitlab.com/dokos/dokos/-/merge_requests/182){rel="&#x22;nofollow&#x22;"}**
- **[Supprimer Exotel par surajshetty3416](https://gitlab.com/dokos/dokos/-/merge_requests/176){rel="&#x22;nofollow&#x22;"}*&#x2A; &#x2A;[erpnext#36131](https://github.com/frappe/erpnext/pull/36131){rel="&#x22;nofollow&#x22;"}*
- **[Rapport "État des Dates d'Expiration des Lots"](https://gitlab.com/dokos/dokos/-/merge_requests/164){rel="&#x22;nofollow&#x22;"}**
- **[Supprimer frappe.dynamic\_link](https://gitlab.com/dokos/dokos/-/merge_requests/156){rel="&#x22;nofollow&#x22;"}**
- Chaînes traduisibles
- Suppression du module de gestion des prêts
- Ajout d'une table séparée pour suivre la planification dans la fiche de travail
- Simplifier la logique d'échange sur la réconciliation des notes de crédit/débit
- Augmenter la précision du taux de change actuel dans la Réévaluation des Taux de Change
- Supprimer les graphiques hiérarchiques
- Utiliser db.set\_single\_value
- Obtenir le contact ou l'adresse par défaut
- Utiliser delete\_contact\_and\_address
- Supprimer le mapper de rapport de flux de trésorerie personnalisé
- Simplifier la logique de regroupement dans les factures
- Supprimer l'entrée rapide personnalisée d'article
- Bon de Livraison
- Rapport de solde des stocks
- Utiliser job\_id au lieu de job\_name
- Ne pas enregistrer le gain/perte d'échange pour les commandes de vente/achat
- Bouton pour activer/désactiver la préférence du centre de coût du document parent pour le montant d'ajustement d'arrondi
- Ne pas enregistrer le gain/perte d'échange pour les commandes de vente/achat
- Utiliser QB pour FEC
- Refactoriser set\_missing\_values et set\_missing\_ref\_details dans l'Entrée de Paiement
- Basculer la fusion des entrées de grand livre similaires dans les Entrées de Journal
- Réécrire les requêtes de `batch.py` en `QB`
- Filtres et colonnes supplémentaires dans le rapport Ledger des Paiements
- **[Refonte de la réservation de crédit](https://gitlab.com/dokos/dokos/-/merge_requests/77){rel="&#x22;nofollow&#x22;"}**
- Supprimer la jointure interne pour améliorer les performances SQL
- Réécrire les requêtes de `get_item_details.py` en `QB`
- Déplacer les liens vers les premiers onglets dans la fiche employé
- Filtrer uniquement les termes de paiement immédiatement à venir pour chaque Commande de Vente
- Installer les éléments préconfigurés
- Changements de requêtes dus aux prochains changements de DatabaseQuery
- Jour de facturation de l'abonnement
- Réécrire les requêtes de `pick_list.py` en `QB`
- Qté prélevée dans la fiche d'article de la commande de vente
- Utiliser DocStatus
- Colonne "Partenaire Commercial" dans les Rapports de Compte Clients et Fournisseurs
- Revue de la fonctionnalité de perte de processus et ajout de pauses d'onglets
- Convertir les requêtes de heatmap en QB

## Amélioration de la performance

- Ajout d'un index pour le retour sur facture d'achat par ankush [*frappe#37881*](https://github.com/frappe/frappe/pull/37881){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!747](https://gitlab.com/dokos/dokos/-/merge_requests/747){rel="&#x22;nofollow&#x22;"}**
- Ajout d'un index pour le champ de facture fournisseur par deepeshgarg007 [*frappe#37861*](https://github.com/frappe/frappe/pull/37861){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!743](https://gitlab.com/dokos/dokos/-/merge_requests/743){rel="&#x22;nofollow&#x22;"}**
- Report de la requête en base de données lors de l'enregistrement d'une réservation d'article &#x2A;*[!629](https://gitlab.com/dokos/dokos/-/merge_requests/629){rel="&#x22;nofollow&#x22;"}**
- Indexation de `dn_detail` dans `Delivery Note Item` par s-aga-r [*frappe#37528*](https://github.com/frappe/frappe/pull/37528){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!622](https://gitlab.com/dokos/dokos/-/merge_requests/622){rel="&#x22;nofollow&#x22;"}**
- Amélioration de la réactivité de l'outil de rapprochement des paiements par ruthra-kumar [*frappe#36650*](https://github.com/frappe/frappe/pull/36650){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!385](https://gitlab.com/dokos/dokos/-/merge_requests/385){rel="&#x22;nofollow&#x22;"}**
- Activation de l'indexation pour le numéro de voucher dans SABB [*frappe#36688*](https://github.com/frappe/frappe/pull/36688){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!361](https://gitlab.com/dokos/dokos/-/merge_requests/361){rel="&#x22;nofollow&#x22;"}**
- ruthra-kumar/perf\_latest\_details\_only\_pulled\_for\_linked\_vouchers [*frappe#36649*](https://github.com/frappe/frappe/pull/36649){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!356](https://gitlab.com/dokos/dokos/-/merge_requests/356){rel="&#x22;nofollow&#x22;"}**

- **[Enregistrement des entrées de dépréciation des actifs [develop]](https://gitlab.com/dokos/dokos/-/merge_requests/317){rel="&#x22;nofollow&#x22;"}**
- **[Requête plus rapide pour le montant de retour](https://gitlab.com/dokos/dokos/-/merge_requests/314){rel="&#x22;nofollow&#x22;"}**
- **[Report différé des importations de listes de congés [frappe]](https://gitlab.com/dokos/dokos/-/merge_requests/299){rel="&#x22;nofollow&#x22;"}**
- **[Éviter l'analyse complète de la table dans la vérification du compte SLE](https://gitlab.com/dokos/dokos/-/merge_requests/268){rel="&#x22;nofollow&#x22;"}**
- **[Déplacer le rappel de l'état du projet à chaque heure](https://gitlab.com/dokos/dokos/-/merge_requests/248){rel="&#x22;nofollow&#x22;"}**
- **[Utiliser `LEFT JOIN` au lieu de `NOT EXISTS` par s-aga-r](https://gitlab.com/dokos/dokos/-/merge_requests/250){rel="&#x22;nofollow&#x22;"}*&#x2A; &#x2A;[erpnext#36221](https://github.com/frappe/erpnext/pull/36221){rel="&#x22;nofollow&#x22;"}*
- **[Ne pas utiliser ifnull là où ce n'est pas nécessaire](https://gitlab.com/dokos/dokos/-/merge_requests/231){rel="&#x22;nofollow&#x22;"}**
- **[Envoyer les types de documents SLA au démarrage par ankush](https://gitlab.com/dokos/dokos/-/merge_requests/179){rel="&#x22;nofollow&#x22;"}*&#x2A; &#x2A;[erpnext#36150](https://github.com/frappe/erpnext/pull/36150){rel="&#x22;nofollow&#x22;"}*
- **[Index dans `Article` et `Attribut de Variante d'Article` par s-aga-r](https://gitlab.com/dokos/dokos/-/merge_requests/178){rel="&#x22;nofollow&#x22;"}*&#x2A; &#x2A;[erpnext#36133](https://github.com/frappe/erpnext/pull/36133){rel="&#x22;nofollow&#x22;"}*
- Éviter les vérifications d'autorisations depuis les tâches en arrière-plan
- Amélioration des rapports d'enregistrement par article
- Amélioration du patch de création de calendrier de dépréciation des actifs
- Indexer `purpose` dans `Entrée de Stock`
- Requêtes en double lors de la vérification de prevdoc
- Requêtes en double pour l'UOM
- Indexer le champ de liste de prélèvement dans l'entrée de stock et le bon de livraison
- Ignorer les listes de prélèvement annulées lors de la récupération des articles prélevés
- Indexer l'article de la commande de vente dans l'élément de la liste de prélèvement
- Cacher et simplifier les requêtes pour la liste de congés
- Écritures de journal
- Indexer le champ against\_sales\_invoice sur les éléments de DN
- Entrée de Stock
- Le rapport sur la marge brute récupérera les SLE à la demande et sera mis en cache
- Afficher la boîte de dialogue de mise à jour des articles
- Amélioration des performances de rapprochement pour les JE avec des centaines de comptes

## Maintenance et organisation

- **Modification du libellé du type de document "Unreconcile Payments" en "Unreconcile Payment" par ruthra-kumar** [frappe#38258](https://github.com/frappe/frappe/pull/38258){rel="&#x22;nofollow&#x22;"} [!862](https://gitlab.com/dokos/dokos/-/merge_requests/862){rel="&#x22;nofollow&#x22;"}
- **Conversion de la réconciliation des paiements en type de document virtuel par ruthra-kumar** [frappe#38148](https://github.com/frappe/frappe/pull/38148){rel="&#x22;nofollow&#x22;"} [!865](https://gitlab.com/dokos/dokos/-/merge_requests/865){rel="&#x22;nofollow&#x22;"}
- **Optimisation de la requête du montant en attente par ruthra-kumar** [frappe#38257](https://github.com/frappe/frappe/pull/38257){rel="&#x22;nofollow&#x22;"} [!864](https://gitlab.com/dokos/dokos/-/merge_requests/864){rel="&#x22;nofollow&#x22;"}
- **Troncature des "remarques" dans les rapports de grand livre et des comptes clients/fournisseurs par ruthra-kumar** [frappe#38159](https://github.com/frappe/frappe/pull/38159){rel="&#x22;nofollow&#x22;"} [!847](https://gitlab.com/dokos/dokos/-/merge_requests/847){rel="&#x22;nofollow&#x22;"}
- **Extension du drapeau de mise à jour du montant facturé à la facture de point de vente par ruthra-kumar** [frappe#38210](https://github.com/frappe/frappe/pull/38210){rel="&#x22;nofollow&#x22;"} [!850](https://gitlab.com/dokos/dokos/-/merge_requests/850){rel="&#x22;nofollow&#x22;"}
- **Mise à jour du travail planifié pour la transaction en vrac par ruthra-kumar** [frappe#38212](https://github.com/frappe/frappe/pull/38212){rel="&#x22;nofollow&#x22;"} [!851](https://gitlab.com/dokos/dokos/-/merge_requests/851){rel="&#x22;nofollow&#x22;"}
- **Optimisation des actions en vrac par ruthra-kumar** [frappe#38038](https://github.com/frappe/frappe/pull/38038){rel="&#x22;nofollow&#x22;"} [!825](https://gitlab.com/dokos/dokos/-/merge_requests/825){rel="&#x22;nofollow&#x22;"}
- **Utilisation du paramètre 'boolean' lors de la récupération de l'exercice fiscal par ruthra-kumar** [frappe#38082](https://github.com/frappe/frappe/pull/38082){rel="&#x22;nofollow&#x22;"} [!824](https://gitlab.com/dokos/dokos/-/merge_requests/824){rel="&#x22;nofollow&#x22;"}
- **Analyse du nom complet par barredterra** [frappe#38060](https://github.com/frappe/frappe/pull/38060){rel="&#x22;nofollow&#x22;"} [!802](https://gitlab.com/dokos/dokos/-/merge_requests/802){rel="&#x22;nofollow&#x22;"}
- **Ajout d'une case à cocher pour le journal de réévaluation dans les rapports de synthèse des comptes clients/fournisseurs par ruthra-kumar** [frappe#38064](https://github.com/frappe/frappe/pull/38064){rel="&#x22;nofollow&#x22;"} [!804](https://gitlab.com/dokos/dokos/-/merge_requests/804){rel="&#x22;nofollow&#x22;"}
- **Ignorance du compte désactivé lors de la sélection des comptes de revenus par ruthra-kumar** [frappe#37860](https://github.com/frappe/frappe/pull/37860){rel="&#x22;nofollow&#x22;"} [!778](https://gitlab.com/dokos/dokos/-/merge_requests/778){rel="&#x22;nofollow&#x22;"}
- **Optimisation de la transaction en vrac pour la vitesse par ruthra-kumar** [frappe#37971](https://github.com/frappe/frappe/pull/37971){rel="&#x22;nofollow&#x22;"} [!770](https://gitlab.com/dokos/dokos/-/merge_requests/770){rel="&#x22;nofollow&#x22;"}
- **Extension du repostage à "Expense Claim" et le rend configurable par ruthra-kumar** [frappe#37954](https://github.com/frappe/frappe/pull/37954){rel="&#x22;nofollow&#x22;"} [!767](https://gitlab.com/dokos/dokos/-/merge_requests/767){rel="&#x22;nofollow&#x22;"}
- **Drapeau pour basculer la mise à jour du montant facturé dans DN pour la note de crédit par ruthra-kumar** [frappe#37879](https://github.com/frappe/frappe/pull/37879){rel="&#x22;nofollow&#x22;"} [!759](https://gitlab.com/dokos/dokos/-/merge_requests/759){rel="&#x22;nofollow&#x22;"}
- **Évitement de l'erreur de validation basée sur la précision lors de la réconciliation par ruthra-kumar** [frappe#37886](https://github.com/frappe/frappe/pull/37886){rel="&#x22;nofollow&#x22;"} [!755](https://gitlab.com/dokos/dokos/-/merge_requests/755){rel="&#x22;nofollow&#x22;"}
- **Drapeau "Group only by voucher" dans le rapport AR/AP par ruthra-kumar** [frappe#37869](https://github.com/frappe/frappe/pull/37869){rel="&#x22;nofollow&#x22;"} [!746](https://gitlab.com/dokos/dokos/-/merge_requests/746){rel="&#x22;nofollow&#x22;"}
- **Meilleur rapport de comparaison de grand livre par ruthra-kumar** [frappe#37852](https://github.com/frappe/frappe/pull/37852){rel="&#x22;nofollow&#x22;"} [!745](https://gitlab.com/dokos/dokos/-/merge_requests/745){rel="&#x22;nofollow&#x22;"}
- **Transmission des limites aux requêtes JE et PE dans l'outil de réconciliation par ruthra-kumar** [frappe#37838](https://github.com/frappe/frappe/pull/37838){rel="&#x22;nofollow&#x22;"} [!737](https://gitlab.com/dokos/dokos/-/merge_requests/737){rel="&#x22;nofollow&#x22;"}
- **Mise à jour des libellés des champs et suppression des champs inutilisés de BIN par s-aga-r** [frappe#37827](https://github.com/frappe/frappe/pull/37827){rel="&#x22;nofollow&#x22;"} [!733](https://gitlab.com/dokos/dokos/-/merge_requests/733){rel="&#x22;nofollow&#x22;"}
- **Récupération des remarques uniquement si nécessaire dans le rapport AR/AP par ruthra-kumar** [frappe#37793](https://github.com/frappe/frappe/pull/37793){rel="&#x22;nofollow&#x22;"} [!722](https://gitlab.com/dokos/dokos/-/merge_requests/722){rel="&#x22;nofollow&#x22;"}
- **Ignorance des GLE annulées lors de la recherche de la devise des entrées existantes par ruthra-kumar** [frappe#37720](https://github.com/frappe/frappe/pull/37720){rel="&#x22;nofollow&#x22;"} [!706](https://gitlab.com/dokos/dokos/-/merge_requests/706){rel="&#x22;nofollow&#x22;"}
- **Suppression des filtres désactivés superflus par bosue** [frappe#37732](https://github.com/frappe/frappe/pull/37732){rel="&#x22;nofollow&#x22;"} [!704](https://gitlab.com/dokos/dokos/-/merge_requests/704){rel="&#x22;nofollow&#x22;"}
- **Modification du champ "Over Order Allowance" en "Blanket Order Allowance" par s-aga-r** [frappe#37669](https://github.com/frappe/frappe/pull/37669){rel="&#x22;nofollow&#x22;"} [!689](https://gitlab.com/dokos/dokos/-/merge_requests/689){rel="&#x22;nofollow&#x22;"}
- **Suppression des frais inclus dans les comptes de valorisation par deepeshgarg007** [frappe#37632](https://github.com/frappe/frappe/pull/37632){rel="&#x22;nofollow&#x22;"} [!676](https://gitlab.com/dokos/dokos/-/merge_requests/676){rel="&#x22;nofollow&#x22;"}
- **Configuration de la date de comptabilisation pour les gains ou pertes de change par ruthra-kumar** [frappe#37630](https://github.com/frappe/frappe/pull/37630){rel="&#x22;nofollow&#x22;"} [!677](https://gitlab.com/dokos/dokos/-/merge_requests/677){rel="&#x22;nofollow&#x22;"}
- **Utilisation des méthodes compress() et decompress() de la bibliothèque gzip directement par akhilnarang** [frappe#37611](https://github.com/frappe/frappe/pull/37611){rel="&#x22;nofollow&#x22;"} [!663](https://gitlab.com/dokos/dokos/-/merge_requests/663){rel="&#x22;nofollow&#x22;"}
- **Déplacement des passerelles de paiement vers l'application des paiements par s-aga-r** [frappe#37182](https://github.com/frappe/frappe/pull/37182){rel="&#x22;nofollow&#x22;"} [!612](https://gitlab.com/dokos/dokos/-/merge_requests/612){rel="&#x22;nofollow&#x22;"}
- **Utilisation du compte dans la clé lors du regroupement du bon de commande dans le rapport AR/AP par ruthra-kumar** [frappe#37549](https://github.com/frappe/frappe/pull/37549){rel="&#x22;nofollow&#x22;"} [!635](https://gitlab.com/dokos/dokos/-/merge_requests/635){rel="&#x22;nofollow&#x22;"}
- **Ajout d'une case à cocher pour basculer l'héritage du taux de change de PO à PI par ruthra-kumar** [frappe#37330](https://github.com/frappe/frappe/pull/37330){rel="&#x22;nofollow&#x22;"} [!626](https://gitlab.com/dokos/dokos/-/merge_requests/626){rel="&#x22;nofollow&#x22;"}
- **Calcul à l'envers du montant total pour la TDS par ruthra-kumar** [frappe#37478](https://github.com/frappe/frappe/pull/37478){rel="&#x22;nofollow&#x22;"} [!614](https://gitlab.com/dokos/dokos/-/merge_requests/614){rel="&#x22;nofollow&#x22;"}
- **(Correctif) : Ignorance des liens lors du correctif de solde de clôture par ruthra-kumar** [frappe#37484](https://github.com/frappe/frappe/pull/37484){rel="&#x22;nofollow&#x22;"} [!606](https://gitlab.com/dokos/dokos/-/merge_requests/606){rel="&#x22;nofollow&#x22;"}
- **Pour les champs non-repost, ne pas valider par ruthra-kumar** [frappe#37436](https://github.com/frappe/frappe/pull/37436){rel="&#x22;nofollow&#x22;"} [!603](https://gitlab.com/dokos/dokos/-/merge_requests/603){rel="&#x22;nofollow&#x22;"}
- **Ajout d'une validation pour les avances dans SI/PI par ruthra-kumar** [frappe#37459](https://github.com/frappe/frappe/pull/37459){rel="&#x22;nofollow&#x22;"} [!602](https://gitlab.com/dokos/dokos/-/merge_requests/602){rel="&#x22;nofollow&#x22;"}
- **Importation de 'financial\_statements.js' dans le bundle erpnext par ruthra-kumar** [frappe#37393](https://github.com/frappe/frappe/pull/37393){rel="&#x22;nofollow&#x22;"} [!597](https://gitlab.com/dokos/dokos/-/merge_requests/597){rel="&#x22;nofollow&#x22;"}
- **Migration des traductions vers HRMS** [frappe#37376](https://github.com/frappe/frappe/pull/37376){rel="&#x22;nofollow&#x22;"} [!586](https://gitlab.com/dokos/dokos/-/merge_requests/586){rel="&#x22;nofollow&#x22;"}
- **Ajout du champ "access\_key" pour faciliter l'utilisation du fournisseur exchangerate.host par ruthra-kumar** [frappe#37359](https://github.com/frappe/frappe/pull/37359){rel="&#x22;nofollow&#x22;"} [!577](https://gitlab.com/dokos/dokos/-/merge_requests/577){rel="&#x22;nofollow&#x22;"}
- **Blocage de l'entrée de paiement comme référence dans les journaux depuis l'interface utilisateur par ruthra-kumar** [frappe#37294](https://github.com/frappe/frappe/pull/37294){rel="&#x22;nofollow&#x22;"} [!576](https://gitlab.com/dokos/dokos/-/merge_requests/576){rel="&#x22;nofollow&#x22;"}
- **Dans l'élément de devis, la section discount\_and\_margin devrait avoir le même collapsible\_depends\_on que les autres DocType similaires (Sales Order Item, Sales Invoice Item, ...) par FHenry** [frappe#37252](https://github.com/frappe/frappe/pull/37252){rel="&#x22;nofollow&#x22;"} [!549](https://gitlab.com/dokos/dokos/-/merge_requests/549){rel="&#x22;nofollow&#x22;"}
- **Bouton dans l'entrée de paiement pour filtrer les journaux associés par ruthra-kumar** [frappe#37200](https://github.com/frappe/frappe/pull/37200){rel="&#x22;nofollow&#x22;"} [!531](https://gitlab.com/dokos/dokos/-/merge_requests/531){rel="&#x22;nofollow&#x22;"}
- **Ignorer les PLE lors de l'annulation du PCV par ruthra-kumar** [frappe#37202](https://github.com/frappe/frappe/pull/37202){rel="&#x22;nofollow&#x22;"} [!532](https://gitlab.com/dokos/dokos/-/merge_requests/532){rel="&#x22;nofollow&#x22;"}
- **(Mineur) : Entrée de réservation de stock par s-aga-r** [frappe#37185](https://github.com/frappe/frappe/pull/37185){rel="&#x22;nofollow&#x22;"} [!529](https://gitlab.com/dokos/dokos/-/merge_requests/529){rel="&#x22;nofollow&#x22;"}
- **Filtres plus génériques dans le rapport des comptes clients par ruthra-kumar** [frappe#37131](https://github.com/frappe/frappe/pull/37131){rel="&#x22;nofollow&#x22;"} [!509](https://gitlab.com/dokos/dokos/-/merge_requests/509){rel="&#x22;nofollow&#x22;"}
- Amélioration des filtres de date dans la boîte de dialogue 'Obtenir les factures impayées' par ruthra-kumar [*frappe#37127*](https://github.com/frappe/frappe/pull/37127){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!507](https://gitlab.com/dokos/dokos/-/merge_requests/507){rel="&#x22;nofollow&#x22;"}**
- Déplacement du bouton 'déconcilier' dans un menu déroulant par ruthra-kumar [*frappe#37105*](https://github.com/frappe/frappe/pull/37105){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!498](https://gitlab.com/dokos/dokos/-/merge_requests/498){rel="&#x22;nofollow&#x22;"}**
- Amélioration de l'expérience utilisateur dans le formulaire de réservation d'article &#x2A;*[!495](https://gitlab.com/dokos/dokos/-/merge_requests/495){rel="&#x22;nofollow&#x22;"}**
- Suppression du module de publications sur les réseaux sociaux par ankush [*frappe#37087*](https://github.com/frappe/frappe/pull/37087){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!492](https://gitlab.com/dokos/dokos/-/merge_requests/492){rel="&#x22;nofollow&#x22;"}**
- Suppression de l'intégration 'woocommerce' par s-aga-r [*frappe#37015*](https://github.com/frappe/frappe/pull/37015){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!489](https://gitlab.com/dokos/dokos/-/merge_requests/489){rel="&#x22;nofollow&#x22;"}**
- Élimination de l'intégration Twitter par ankush [*frappe#37086*](https://github.com/frappe/frappe/pull/37086){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!490](https://gitlab.com/dokos/dokos/-/merge_requests/490){rel="&#x22;nofollow&#x22;"}**
- Alignement des écritures de gain/perte sur la même date de comptabilisation que le paiement par ruthra-kumar [*frappe#36950*](https://github.com/frappe/frappe/pull/36950){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!455](https://gitlab.com/dokos/dokos/-/merge_requests/455){rel="&#x22;nofollow&#x22;"}**
- **Suppression de `Recalculate Rate` de l'élément SCR par s-aga-r** [*frappe#36929*](https://github.com/frappe/frappe/pull/36929){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!451](https://gitlab.com/dokos/dokos/-/merge_requests/451){rel="&#x22;nofollow&#x22;"}**
- **Ajustement de toutes les autorisations à `Desk User` par ankush** [*frappe#36856*](https://github.com/frappe/frappe/pull/36856){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!429](https://gitlab.com/dokos/dokos/-/merge_requests/429){rel="&#x22;nofollow&#x22;"}**
- **Espace de travail Stock*&#x2A; &#x2A;*[!425](https://gitlab.com/dokos/dokos/-/merge_requests/425){rel="&#x22;nofollow&#x22;"}**
- **Les notes de crédit/débit doivent être autonomes, même lorsqu'elles sont créées à partir d'une autre facture par ruthra-kumar** [*frappe#35330*](https://github.com/frappe/frappe/pull/35330){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!390](https://gitlab.com/dokos/dokos/-/merge_requests/390){rel="&#x22;nofollow&#x22;"}**
- Refonte du calendrier web
- **Suppression des traductions de l'application HRMS** [*frappe#36343*](https://github.com/frappe/frappe/pull/36343){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!233](https://gitlab.com/dokos/dokos/-/merge_requests/233){rel="&#x22;nofollow&#x22;"}**
- Refonte de la réconciliation bancaire

- **[Ajouter une validation pour le compte de dépenses de dépréciation dans la catégorie d'actif](https://gitlab.com/dokos/dokos/-/merge_requests/352){rel="&#x22;nofollow&#x22;"}**
- **[\[corvée\] Traductions en français](https://gitlab.com/dokos/dokos/-/merge_requests/348){rel="&#x22;nofollow&#x22;"}**
- **[Définir des dates de filtre par défaut en cas d'absence](https://gitlab.com/dokos/dokos/-/merge_requests/325){rel="&#x22;nofollow&#x22;"}**
- **[Mettre à jour les autorisations pour la réconciliation des paiements de processus](https://gitlab.com/dokos/dokos/-/merge_requests/324){rel="&#x22;nofollow&#x22;"}**
- **[Ne pas fusionner les écritures comptables de capitalisation d'actifs](https://gitlab.com/dokos/dokos/-/merge_requests/298){rel="&#x22;nofollow&#x22;"}**
- **[Faute de frappe dans l'intégration](https://gitlab.com/dokos/dokos/-/merge_requests/291){rel="&#x22;nofollow&#x22;"}**
- **[Meilleure validation du centre de coût pour les actifs](https://gitlab.com/dokos/dokos/-/merge_requests/281){rel="&#x22;nofollow&#x22;"}**
- **[Utiliser le tableau de données pour la vue du tableau de planification de dépréciation des actifs](https://gitlab.com/dokos/dokos/-/merge_requests/275){rel="&#x22;nofollow&#x22;"}**
- **[Ajout de totaux dans les rapports d'actifs](https://gitlab.com/dokos/dokos/-/merge_requests/228){rel="&#x22;nofollow&#x22;"}**
- **[Supprimer les noms redondants](https://gitlab.com/dokos/dokos/-/merge_requests/224){rel="&#x22;nofollow&#x22;"}**
- **[Utiliser des guillemets cohérents](https://gitlab.com/dokos/dokos/-/merge_requests/184){rel="&#x22;nofollow&#x22;"}**
- **[Ajouter une validation pour le type de compte du type de tiers et du compte](https://gitlab.com/dokos/dokos/-/merge_requests/183){rel="&#x22;nofollow&#x22;"}**
- Avertissement de dépréciation pour l'application de prêt
- Meilleur message d'erreur lors de l'annulation de JE pour la sortie d'actifs
- Supprimer la liste blanche pour les méthodes non accessibles depuis l'interface utilisateur
- Profils de rôle par défaut
- Ajouter des traductions manquantes
- Supprimer la liste blanche pour la méthode non accessible depuis l'interface utilisateur
- Accroche pré-commit pour les fichiers JSON
- Supprimer la vidéo de navigation obsolète
- Convertir throw en msgprint dans le crochet de travail de rapprochement des paiements
- Ajouter une fonction de traduction à la remarque de l'écriture de journal de dépréciation
- Déplacer la source et la campagne dans la section informations supplémentaires
- Traduction dédiée pour l'espace de travail d'achat
- Renommer l'espace de travail d'achat
- Supprimer l'annulation pour définir la taxe sur les articles en fonction du code HSN
- Corriger la traduction
- Corriger la couleur du texte
- **[Utiliser la requête frappe qb get](https://gitlab.com/dokos/dokos/-/merge_requests/86){rel="&#x22;nofollow&#x22;"}**
- **[Crochet pour la licence FullCalendar](https://gitlab.com/dokos/dokos/-/merge_requests/87){rel="&#x22;nofollow&#x22;"}**
- Amélioration du message d'échec de la saisie de dépréciation d'actif
- Remplir automatiquement le nom de l'actif et la date de mise à disposition
- Journal des modifications + traductions
- Supprimer la méthode inutilisée
- Rendre la table `Production Plan Item Reference` cachée dans le plan de production
- Journal des modifications + traductions
- **[Restaurer les doctypes régionaux de France](https://gitlab.com/dokos/dokos/-/merge_requests/83){rel="&#x22;nofollow&#x22;"}**
- Supprimer la validation redondante
- **[Annuler "fix: Rendre le nom et la description de l'article transposables"](https://gitlab.com/dokos/dokos/-/merge_requests/82){rel="&#x22;nofollow&#x22;"}**
- **[Supprimer le chargement de traduction dans get\_context](https://gitlab.com/dokos/dokos/-/merge_requests/78){rel="&#x22;nofollow&#x22;"}**
- Traductions allemandes
- Message `Allow Zero Valuation Rate` dans SE
- Supprimer le test en échec
- Corriger les traductions TR cassées
- Message `Alternative Item Code`
- Corriger les traductions TR cassées
- Message `Alternative Item Code`
- Rendre le livre de finance en lecture seule
- Rendre le livre de finance en lecture seule
- **[corvée-mettre-à-jour-icônes](https://gitlab.com/dokos/dokos/-/merge_requests/58){rel="&#x22;nofollow&#x22;"}**
- Supprimer la dépendance à stdnum
- Autoriser l'importation en vrac d'articles spécifiques à un tiers
- Copier `item\_code` vers `Batch` lors de la création d'un nouveau lot à partir de SCR
- Mettre à jour les traductions turques
- Rapport `Solde et valeur des articles par entrepôt`
- en cours : Améliorations du formulaire d'inscription du lieu
- Redimensionner les colonnes numériques et de date
- Nettoyage de l'assistant de configuration ERPNext
- Ajouter le statut `Annulé` dans l'indicateur SCO `get\_indicator`
- en cours : refactoriser l'abonnement
- Ajouter des visites guidées pour le prix et la liste de prix de l'article
- Traduction française
- Ignorer b028
- Faute de frappe dans le rapprochement des paiements
- Lien `Commande de vente` dans la `Liste de prélèvement`
- Activer l'attribut `No Copy` pour la `route` dans le groupe d'articles
- **[Corriger la traduction erronée de la garantie](https://gitlab.com/dokos/dokos/-/merge_requests/26){rel="&#x22;nofollow&#x22;"}**
- Supprimer les journaux d'activité obsolètes

## Gestion des dépendances

- **[Mise à jour de tweepy 3.10.0 -> 4.14.0 par blaggacao](https://gitlab.com/dokos/dokos/-/merge_requests/219){rel="&#x22;nofollow&#x22;"}*&#x2A; &#x2A;[erpnext#36246](https://github.com/frappe/erpnext/pull/36246){rel="&#x22;nofollow&#x22;"}*
- Mise à jour des dépendances et suppression de setup.py


# v4.1.0

::callout
La version 4.1.0 de Dokos est basée sur la version 15 d'ERPNext.
Une grande partie des changements cités ci-dessous ont été développés par l'équipe de Frappe Technologies et les contributeurs de l'éco-système Frappe/ERPNext.
Le détail des changements publiés dans Dokos est disponible sur [GitLab](https://gitlab.com/dokos/dokos/-/releases){rel=""nofollow""}
::

::callout
🚧 Traduction à venir 🚧
::

## Fonctionnalités et améliorations

- **Option in CRM settings to set the default value in opportunity creation dialog*&#x2A; &#x2A;*[!1016](https://gitlab.com/dokos/dokos/-/merge_requests/1016){rel="&#x22;nofollow&#x22;"}**
- **Income/Expense/Party accounts per tax rate*&#x2A; &#x2A;*[!1005](https://gitlab.com/dokos/dokos/-/merge_requests/1005){rel="&#x22;nofollow&#x22;"}**
- **Set lead name from email *by barredterra*** [*frappe#38505*](https://github.com/frappe/frappe/pull/38505){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1006](https://gitlab.com/dokos/dokos/-/merge_requests/1006){rel="&#x22;nofollow&#x22;"}**
- **feat\:Cost calculator in quotations*&#x2A; &#x2A;*[!997](https://gitlab.com/dokos/dokos/-/merge_requests/997){rel="&#x22;nofollow&#x22;"}**
- **(RFQ): Special properties in print preview *by barredterra*** [*frappe#38725*](https://github.com/frappe/frappe/pull/38725){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1000](https://gitlab.com/dokos/dokos/-/merge_requests/1000){rel="&#x22;nofollow&#x22;"}**
- **Party auto match in bank transactions*&#x2A; &#x2A;*[!981](https://gitlab.com/dokos/dokos/-/merge_requests/981){rel="&#x22;nofollow&#x22;"}**
- **(BankReconciliation): Improve filters and UI*&#x2A; &#x2A;*[!982](https://gitlab.com/dokos/dokos/-/merge_requests/982){rel="&#x22;nofollow&#x22;"}**
- Party auto match in bank transactions"
- Party auto match in bank transactions
- **Default calendar and resource for projects*&#x2A; &#x2A;*[!977](https://gitlab.com/dokos/dokos/-/merge_requests/977){rel="&#x22;nofollow&#x22;"}**
- **Supplier down payments*&#x2A; &#x2A;*[!925](https://gitlab.com/dokos/dokos/-/merge_requests/925){rel="&#x22;nofollow&#x22;"}**
- **New "Event Card" web template*&#x2A; &#x2A;*[!816](https://gitlab.com/dokos/dokos/-/merge_requests/816){rel="&#x22;nofollow&#x22;"}**
- **Add employee number to client user bootinfo *by casesolved-co-uk*** [*frappe#38477*](https://github.com/frappe/frappe/pull/38477){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!964](https://gitlab.com/dokos/dokos/-/merge_requests/964){rel="&#x22;nofollow&#x22;"}**
- **`Company` filter in `Stock Ledger Variance` report *by s-aga-r*** [*frappe#38553*](https://github.com/frappe/frappe/pull/38553){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!956](https://gitlab.com/dokos/dokos/-/merge_requests/956){rel="&#x22;nofollow&#x22;"}**
- **Supplier section in quotations*&#x2A; &#x2A;*[!788](https://gitlab.com/dokos/dokos/-/merge_requests/788){rel="&#x22;nofollow&#x22;"}**
- **add supplier group filter in purchase register *by Nandhinidevi123*** [*frappe#38421*](https://github.com/frappe/frappe/pull/38421){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!930](https://gitlab.com/dokos/dokos/-/merge_requests/930){rel="&#x22;nofollow&#x22;"}**
- **Fec import improvement*&#x2A; &#x2A;*[!927](https://gitlab.com/dokos/dokos/-/merge_requests/927){rel="&#x22;nofollow&#x22;"}**

## Corrections de bugs

- **Simplify logic*&#x2A; &#x2A;*[!1036](https://gitlab.com/dokos/dokos/-/merge_requests/1036){rel="&#x22;nofollow&#x22;"}**
- **Precision for status determination*&#x2A; &#x2A;*[!1035](https://gitlab.com/dokos/dokos/-/merge_requests/1035){rel="&#x22;nofollow&#x22;"}**
- **Groups for current accounts in German CoAs *by barredterra*** [*frappe#38803*](https://github.com/frappe/frappe/pull/38803){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1034](https://gitlab.com/dokos/dokos/-/merge_requests/1034){rel="&#x22;nofollow&#x22;"}**
- **Incorrect requested quantity for the subcontracting order *by rohitwaghchaure*** [*frappe#38455*](https://github.com/frappe/frappe/pull/38455){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!921](https://gitlab.com/dokos/dokos/-/merge_requests/921){rel="&#x22;nofollow&#x22;"}**
- **(demo): Demo setup for Canadian COA *by deepeshgarg007*** [*frappe#38807*](https://github.com/frappe/frappe/pull/38807){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1032](https://gitlab.com/dokos/dokos/-/merge_requests/1032){rel="&#x22;nofollow&#x22;"}**
- **Bank transactions labels*&#x2A; &#x2A;*[!1033](https://gitlab.com/dokos/dokos/-/merge_requests/1033){rel="&#x22;nofollow&#x22;"}**
- **Serial and batch bundle return not working *by rohitwaghchaure*** [*frappe#38754*](https://github.com/frappe/frappe/pull/38754){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1031](https://gitlab.com/dokos/dokos/-/merge_requests/1031){rel="&#x22;nofollow&#x22;"}**
- **French translations*&#x2A; &#x2A;*[!1030](https://gitlab.com/dokos/dokos/-/merge_requests/1030){rel="&#x22;nofollow&#x22;"}**
- **Don't require gross profit calculation rule to avoid having it in quick entry form*&#x2A; &#x2A;*[!1029](https://gitlab.com/dokos/dokos/-/merge_requests/1029){rel="&#x22;nofollow&#x22;"}**
- **Delete e-commerce workspace*&#x2A; &#x2A;*[!1027](https://gitlab.com/dokos/dokos/-/merge_requests/1027){rel="&#x22;nofollow&#x22;"}**
- **Keep borders in portal lists*&#x2A; &#x2A;*[!1026](https://gitlab.com/dokos/dokos/-/merge_requests/1026){rel="&#x22;nofollow&#x22;"}**
- **Handle permission error on portal*&#x2A; &#x2A;*[!1025](https://gitlab.com/dokos/dokos/-/merge_requests/1025){rel="&#x22;nofollow&#x22;"}**
- **Reset SLA on issue doesn't work *by ankush*** [*frappe#38789*](https://github.com/frappe/frappe/pull/38789){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1023](https://gitlab.com/dokos/dokos/-/merge_requests/1023){rel="&#x22;nofollow&#x22;"}**
- **Init internal child table values *by deepeshgarg007*** [*frappe#38691*](https://github.com/frappe/frappe/pull/38691){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1021](https://gitlab.com/dokos/dokos/-/merge_requests/1021){rel="&#x22;nofollow&#x22;"}**
- **(Purchase Register): Show bill\_date and bill\_no *by ljain112*** [*frappe#38742*](https://github.com/frappe/frappe/pull/38742){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1022](https://gitlab.com/dokos/dokos/-/merge_requests/1022){rel="&#x22;nofollow&#x22;"}**
- **Move back button to Webshop*&#x2A; &#x2A;*[!1019](https://gitlab.com/dokos/dokos/-/merge_requests/1019){rel="&#x22;nofollow&#x22;"}**
- **More specific message for recurring sales orders*&#x2A; &#x2A;*[!1018](https://gitlab.com/dokos/dokos/-/merge_requests/1018){rel="&#x22;nofollow&#x22;"}**
- **Never copy a payment key in payment requests*&#x2A; &#x2A;*[!1017](https://gitlab.com/dokos/dokos/-/merge_requests/1017){rel="&#x22;nofollow&#x22;"}**
- **Calculation issues when cost is null*&#x2A; &#x2A;*[!1015](https://gitlab.com/dokos/dokos/-/merge_requests/1015){rel="&#x22;nofollow&#x22;"}**
- **Improve error handling and fiscal year change for adjustment entries*&#x2A; &#x2A;*[!1014](https://gitlab.com/dokos/dokos/-/merge_requests/1014){rel="&#x22;nofollow&#x22;"}**
- **Wrong currency in Stock Balance report *by s-aga-r*** [*frappe#38778*](https://github.com/frappe/frappe/pull/38778){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1013](https://gitlab.com/dokos/dokos/-/merge_requests/1013){rel="&#x22;nofollow&#x22;"}**
- **Asset patch failure due to missing shift\_based column *by anandbaburajan*** [*frappe#38776*](https://github.com/frappe/frappe/pull/38776){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1012](https://gitlab.com/dokos/dokos/-/merge_requests/1012){rel="&#x22;nofollow&#x22;"}**
- **Validation error on reconciling PE to Journals as Invoice *by ruthra-kumar*** [*frappe#38766*](https://github.com/frappe/frappe/pull/38766){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1011](https://gitlab.com/dokos/dokos/-/merge_requests/1011){rel="&#x22;nofollow&#x22;"}**
- **Skip JVs against bank accounts in tax report *by GursheenK*** [*frappe#38767*](https://github.com/frappe/frappe/pull/38767){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1010](https://gitlab.com/dokos/dokos/-/merge_requests/1010){rel="&#x22;nofollow&#x22;"}**
- **Set date format from system settings *by barredterra*** [*frappe#38533*](https://github.com/frappe/frappe/pull/38533){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1007](https://gitlab.com/dokos/dokos/-/merge_requests/1007){rel="&#x22;nofollow&#x22;"}**
- **(ux): Don't override Item Name and Description in MR *by s-aga-r*** [*frappe#38720*](https://github.com/frappe/frappe/pull/38720){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1009](https://gitlab.com/dokos/dokos/-/merge_requests/1009){rel="&#x22;nofollow&#x22;"}**
- **Homepage not working *by rohitwaghchaure*** [*frappe#38755*](https://github.com/frappe/frappe/pull/38755){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1008](https://gitlab.com/dokos/dokos/-/merge_requests/1008){rel="&#x22;nofollow&#x22;"}**
- **Timezone aware SLA banner *by ankush*** [*frappe#38745*](https://github.com/frappe/frappe/pull/38745){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1004](https://gitlab.com/dokos/dokos/-/merge_requests/1004){rel="&#x22;nofollow&#x22;"}**
- **Fetch exc rate of multi currency journals on reconciliation *by ruthra-kumar*** [*frappe#38717*](https://github.com/frappe/frappe/pull/38717){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1003](https://gitlab.com/dokos/dokos/-/merge_requests/1003){rel="&#x22;nofollow&#x22;"}**
- **Remove changelog for v4*&#x2A; &#x2A;*[!1002](https://gitlab.com/dokos/dokos/-/merge_requests/1002){rel="&#x22;nofollow&#x22;"}**
- **Card reconciliation*&#x2A; &#x2A;*[!999](https://gitlab.com/dokos/dokos/-/merge_requests/999){rel="&#x22;nofollow&#x22;"}**
- **(ux): Don't update qty blindly"*&#x2A; &#x2A;*[!998](https://gitlab.com/dokos/dokos/-/merge_requests/998){rel="&#x22;nofollow&#x22;"}**
- **Barcode scanning for the stock entry *by rohitwaghchaure*** [*frappe#38716*](https://github.com/frappe/frappe/pull/38716){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!996](https://gitlab.com/dokos/dokos/-/merge_requests/996){rel="&#x22;nofollow&#x22;"}**
- **Supplier removed on selection of item *by rohitwaghchaure*** [*frappe#38712*](https://github.com/frappe/frappe/pull/38712){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!995](https://gitlab.com/dokos/dokos/-/merge_requests/995){rel="&#x22;nofollow&#x22;"}**
- **1st row depr. sch. value of asset put to less than 180 days acc. to I.T. S. 32 *by anandbaburajan*** [*frappe#38696*](https://github.com/frappe/frappe/pull/38696){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!994](https://gitlab.com/dokos/dokos/-/merge_requests/994){rel="&#x22;nofollow&#x22;"}**
- **Show stock qty in popup *by rohitwaghchaure*** [*frappe#38698*](https://github.com/frappe/frappe/pull/38698){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!993](https://gitlab.com/dokos/dokos/-/merge_requests/993){rel="&#x22;nofollow&#x22;"}**
- **Negative batch issue *by rohitwaghchaure*** [*frappe#38688*](https://github.com/frappe/frappe/pull/38688){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!992](https://gitlab.com/dokos/dokos/-/merge_requests/992){rel="&#x22;nofollow&#x22;"}**
- **Typeerror on new sites *by ruthra-kumar*** [*frappe#38692*](https://github.com/frappe/frappe/pull/38692){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!991](https://gitlab.com/dokos/dokos/-/merge_requests/991){rel="&#x22;nofollow&#x22;"}**
- **(venue): Move venue-registration-form to Webshop*&#x2A; &#x2A;*[!988](https://gitlab.com/dokos/dokos/-/merge_requests/988){rel="&#x22;nofollow&#x22;"}**
- **Serial no filter in the Serial No Ledger report *by rohitwaghchaure*** [*frappe#38669*](https://github.com/frappe/frappe/pull/38669){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!987](https://gitlab.com/dokos/dokos/-/merge_requests/987){rel="&#x22;nofollow&#x22;"}**
- **Close PO on SCO close *by s-aga-r*** [*frappe#38667*](https://github.com/frappe/frappe/pull/38667){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!986](https://gitlab.com/dokos/dokos/-/merge_requests/986){rel="&#x22;nofollow&#x22;"}**
- **Attribute error *by barredterra*** [*frappe#38644*](https://github.com/frappe/frappe/pull/38644){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!985](https://gitlab.com/dokos/dokos/-/merge_requests/985){rel="&#x22;nofollow&#x22;"}**
- **Typo in unittest *by barredterra*** [*frappe#38673*](https://github.com/frappe/frappe/pull/38673){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!984](https://gitlab.com/dokos/dokos/-/merge_requests/984){rel="&#x22;nofollow&#x22;"}**
- **Get data for leaderboard *by barredterra*** [*frappe#38672*](https://github.com/frappe/frappe/pull/38672){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!983](https://gitlab.com/dokos/dokos/-/merge_requests/983){rel="&#x22;nofollow&#x22;"}**
- **Auto delete draft serial and batch bundle *by rohitwaghchaure*** [*frappe#38637*](https://github.com/frappe/frappe/pull/38637){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!978](https://gitlab.com/dokos/dokos/-/merge_requests/978){rel="&#x22;nofollow&#x22;"}**
- **Not able to make serial and batch using csv import *by rohitwaghchaure*** [*frappe#38659*](https://github.com/frappe/frappe/pull/38659){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!979](https://gitlab.com/dokos/dokos/-/merge_requests/979){rel="&#x22;nofollow&#x22;"}**
- **Shipping Address Link Showing in Buying *by creative-paramu*** [*frappe#38634*](https://github.com/frappe/frappe/pull/38634){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!976](https://gitlab.com/dokos/dokos/-/merge_requests/976){rel="&#x22;nofollow&#x22;"}**
- **Hide is\_down\_payment\_item if not set*&#x2A; &#x2A;*[!975](https://gitlab.com/dokos/dokos/-/merge_requests/975){rel="&#x22;nofollow&#x22;"}**
- **Subscription related corrections*&#x2A; &#x2A;*[!973](https://gitlab.com/dokos/dokos/-/merge_requests/973){rel="&#x22;nofollow&#x22;"}**
- **Automatically set mode of payment from customer/supplier*&#x2A; &#x2A;*[!972](https://gitlab.com/dokos/dokos/-/merge_requests/972){rel="&#x22;nofollow&#x22;"}**
- **Set sort\_order to DESC if sort\_field is modified*&#x2A; &#x2A;*[!974](https://gitlab.com/dokos/dokos/-/merge_requests/974){rel="&#x22;nofollow&#x22;"}**
- **(ux): Don't update qty blindly *by s-aga-r*** [*frappe#38608*](https://github.com/frappe/frappe/pull/38608){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!971](https://gitlab.com/dokos/dokos/-/merge_requests/971){rel="&#x22;nofollow&#x22;"}**
- **Ignore non-existing regional customizations *by ankush*** [*frappe#38621*](https://github.com/frappe/frappe/pull/38621){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!968](https://gitlab.com/dokos/dokos/-/merge_requests/968){rel="&#x22;nofollow&#x22;"}**
- **Format only if searched text contain link value text *by shariquerik*** [*frappe#38623*](https://github.com/frappe/frappe/pull/38623){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!969](https://gitlab.com/dokos/dokos/-/merge_requests/969){rel="&#x22;nofollow&#x22;"}**
- **Serial and batch bundle permission *by rohitwaghchaure*** [*frappe#38618*](https://github.com/frappe/frappe/pull/38618){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!967](https://gitlab.com/dokos/dokos/-/merge_requests/967){rel="&#x22;nofollow&#x22;"}**
- **Minor code cleanup *by rohitwaghchaure*** [*frappe#38615*](https://github.com/frappe/frappe/pull/38615){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!966](https://gitlab.com/dokos/dokos/-/merge_requests/966){rel="&#x22;nofollow&#x22;"}**
- **Remove unused cache=True*&#x2A; &#x2A;*[!963](https://gitlab.com/dokos/dokos/-/merge_requests/963){rel="&#x22;nofollow&#x22;"}**
- **Don't update previous doc on rate change *by s-aga-r*** [*frappe#38493*](https://github.com/frappe/frappe/pull/38493){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!944](https://gitlab.com/dokos/dokos/-/merge_requests/944){rel="&#x22;nofollow&#x22;"}**
- **Only highest eligible coupon applied *by sandratridz*** [*frappe#38416*](https://github.com/frappe/frappe/pull/38416){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!961](https://gitlab.com/dokos/dokos/-/merge_requests/961){rel="&#x22;nofollow&#x22;"}**
- **(transaction): Fix fallback for set\_gross\_profit*&#x2A; &#x2A;*[!962](https://gitlab.com/dokos/dokos/-/merge_requests/962){rel="&#x22;nofollow&#x22;"}**
- **Consider the `Valuation Method` while picking incorrect SLE *by s-aga-r*** [*frappe#38592*](https://github.com/frappe/frappe/pull/38592){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!960](https://gitlab.com/dokos/dokos/-/merge_requests/960){rel="&#x22;nofollow&#x22;"}**
- **Sql error while filtering on finance book in GL *by ruthra-kumar*** [*frappe#38580*](https://github.com/frappe/frappe/pull/38580){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!959](https://gitlab.com/dokos/dokos/-/merge_requests/959){rel="&#x22;nofollow&#x22;"}**
- **Incorrect material request quantity in Production Plan *by rohitwaghchaure*** [*frappe#38566*](https://github.com/frappe/frappe/pull/38566){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!958](https://gitlab.com/dokos/dokos/-/merge_requests/958){rel="&#x22;nofollow&#x22;"}**
- **(minor): Financial statements period end date *by GursheenK*** [*frappe#38556*](https://github.com/frappe/frappe/pull/38556){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!954](https://gitlab.com/dokos/dokos/-/merge_requests/954){rel="&#x22;nofollow&#x22;"}**
- **Remove translation from OCR app*&#x2A; &#x2A;*[!955](https://gitlab.com/dokos/dokos/-/merge_requests/955){rel="&#x22;nofollow&#x22;"}**
- **Get dynamic link with parenttype contact *by shariquerik*** [*frappe#38562*](https://github.com/frappe/frappe/pull/38562){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!953](https://gitlab.com/dokos/dokos/-/merge_requests/953){rel="&#x22;nofollow&#x22;"}**
- **Scan for serial or batch in bundle *by rohitwaghchaure*** [*frappe#38534*](https://github.com/frappe/frappe/pull/38534){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!952](https://gitlab.com/dokos/dokos/-/merge_requests/952){rel="&#x22;nofollow&#x22;"}**
- **Incorrect customer outstanding amount *by niyazrazak*** [*frappe#38475*](https://github.com/frappe/frappe/pull/38475){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!951](https://gitlab.com/dokos/dokos/-/merge_requests/951){rel="&#x22;nofollow&#x22;"}**
- **Payment gateway from mode of payment in payment requests*&#x2A; &#x2A;*[!950](https://gitlab.com/dokos/dokos/-/merge_requests/950){rel="&#x22;nofollow&#x22;"}**
- **Don't show non-stock items in Stock Analytics report *by s-aga-r*** [*frappe#38543*](https://github.com/frappe/frappe/pull/38543){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!949](https://gitlab.com/dokos/dokos/-/merge_requests/949){rel="&#x22;nofollow&#x22;"}**
- **Exclude `invoice_doctypes` from party advance *by rtdany10*** [*frappe#38220*](https://github.com/frappe/frappe/pull/38220){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!948](https://gitlab.com/dokos/dokos/-/merge_requests/948){rel="&#x22;nofollow&#x22;"}**
- **Group By in Item-wise Purchase Register *by Nihantra-Patel*** [*frappe#38503*](https://github.com/frappe/frappe/pull/38503){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!946](https://gitlab.com/dokos/dokos/-/merge_requests/946){rel="&#x22;nofollow&#x22;"}**
- **Multiple minor fixes in report and Exchange Rate Revaluation *by ruthra-kumar*** [*frappe#38525*](https://github.com/frappe/frappe/pull/38525){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!945](https://gitlab.com/dokos/dokos/-/merge_requests/945){rel="&#x22;nofollow&#x22;"}**
- **Better overlap logic for job card *by rohitwaghchaure*** [*frappe#38432*](https://github.com/frappe/frappe/pull/38432){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!943](https://gitlab.com/dokos/dokos/-/merge_requests/943){rel="&#x22;nofollow&#x22;"}**
- **Use predefined onload property `load_after_mapping` *by sagarvora*** [*frappe#38209*](https://github.com/frappe/frappe/pull/38209){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!942](https://gitlab.com/dokos/dokos/-/merge_requests/942){rel="&#x22;nofollow&#x22;"}**
- **SO ordered qty on PO item removal *by GursheenK*** [*frappe#38378*](https://github.com/frappe/frappe/pull/38378){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!941](https://gitlab.com/dokos/dokos/-/merge_requests/941){rel="&#x22;nofollow&#x22;"}**
- **German translations for Lost Quotations *by barredterra*** [*frappe#38435*](https://github.com/frappe/frappe/pull/38435){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!940](https://gitlab.com/dokos/dokos/-/merge_requests/940){rel="&#x22;nofollow&#x22;"}**
- **Don't consider cancelled entries *by dj12djdjs*** [*frappe#38401*](https://github.com/frappe/frappe/pull/38401){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!938](https://gitlab.com/dokos/dokos/-/merge_requests/938){rel="&#x22;nofollow&#x22;"}**
- **Move SMS Log module from ERPNext to Frappe *by strongjaw15*** [*frappe#38506*](https://github.com/frappe/frappe/pull/38506){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!937](https://gitlab.com/dokos/dokos/-/merge_requests/937){rel="&#x22;nofollow&#x22;"}**
- **Validation error has not throw for the batch *by rohitwaghchaure*** [*frappe#38494*](https://github.com/frappe/frappe/pull/38494){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!936](https://gitlab.com/dokos/dokos/-/merge_requests/936){rel="&#x22;nofollow&#x22;"}**
- **Changed sort\_order to DESC for customer *by SherinKR*** [*frappe#38498*](https://github.com/frappe/frappe/pull/38498){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!935](https://gitlab.com/dokos/dokos/-/merge_requests/935){rel="&#x22;nofollow&#x22;"}**
- **`AttributeError` while saving Purchase Invoice *by s-aga-r*** [*frappe#38482*](https://github.com/frappe/frappe/pull/38482){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!934](https://gitlab.com/dokos/dokos/-/merge_requests/934){rel="&#x22;nofollow&#x22;"}**
- **(pe): Show split alert only on splitting *by rtdany10*** [*frappe#38440*](https://github.com/frappe/frappe/pull/38440){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!932](https://gitlab.com/dokos/dokos/-/merge_requests/932){rel="&#x22;nofollow&#x22;"}**
- **Show item name as title instead of item group in BOM *by SvbZ3r0*** [*frappe#38478*](https://github.com/frappe/frappe/pull/38478){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!929](https://gitlab.com/dokos/dokos/-/merge_requests/929){rel="&#x22;nofollow&#x22;"}**

## Maintenance et organisation

- **(test): Repost utility deletion flag test *by ruthra-kumar*** [*frappe#38679*](https://github.com/frappe/frappe/pull/38679){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!989](https://gitlab.com/dokos/dokos/-/merge_requests/989){rel="&#x22;nofollow&#x22;"}**
- **Add `get_list` for virtual child doctypes *by ruthra-kumar*** [*frappe#38685*](https://github.com/frappe/frappe/pull/38685){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!990](https://gitlab.com/dokos/dokos/-/merge_requests/990){rel="&#x22;nofollow&#x22;"}**
- **Simpler log settings setup *by ankush*** [*frappe#38449*](https://github.com/frappe/frappe/pull/38449){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!916](https://gitlab.com/dokos/dokos/-/merge_requests/916){rel="&#x22;nofollow&#x22;"}**
- **Simplify conditional logic *by barredterra*** [*frappe#38591*](https://github.com/frappe/frappe/pull/38591){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!965](https://gitlab.com/dokos/dokos/-/merge_requests/965){rel="&#x22;nofollow&#x22;"}**
- **Ignore unreconcile doc on PI cancel/delete *by ruthra-kumar*** [*frappe#38570*](https://github.com/frappe/frappe/pull/38570){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!957](https://gitlab.com/dokos/dokos/-/merge_requests/957){rel="&#x22;nofollow&#x22;"}**

---

**Contributeurs**

- **Charles-Henri Decultot** (79)
- **rohitwaghchaure** (15)
- **ruthra kumar** (13)
- **s-aga-r** (12)
- **barredterra** (11)
- **Corentin Forler** (10)
- **Ankush Menat** (5)
- **Deepesh Garg** (3)
- **Raffael Meyer** (3)
- **Anand Baburajan** (2)

et 22 autres contributeurs...

- Dany Robert
- Devin Slauenwhite
- Gursheen Anand
- Shariq Ansari
- Antoine
- Corin Wenger
- Gughan Ravikumar
- Gursheen Kaur Anand
- NIYAZ RAZAK
- NandhiniDevi
- Nihantra C. Patel
- Richard Case
- Rohit Waghchaure
- Sagar Vora
- Sherin KR
- creative-paramu
- ljain112
- sandratridz

---

**Différentiel complet:** [v4.0.0...v4.1.0](https://gitlab.com/dokos/dokos/-/compare/v4.0.0...v4.1.0){rel="&#x22;nofollow&#x22;"}:br&#x2A;*Tag:** [v4.1.0](https://gitlab.com/dokos/dokos/-/tags/v4.1.0){rel="&#x22;nofollow&#x22;"}


# v4.2.0

::callout
La version 4.2.0 de Dokos est basée sur la version 15 d'ERPNext.
Une grande partie des changements cités ci-dessous ont été développés par l'équipe de Frappe Technologies et les contributeurs de l'éco-système Frappe/ERPNext.
Le détail des changements publiés dans Dokos est disponible sur [GitLab](https://gitlab.com/dokos/dokos/-/releases){rel=""nofollow""}
::

::callout
🚧 Traduction à venir 🚧
::

## Fonctionnalités et améliorations

- **Provision to close SCO *by s-aga-r**&#x2A; &#x2A;*[!1170](https://gitlab.com/dokos/dokos/-/merge_requests/1170){rel="&#x22;nofollow&#x22;"}**
- **Option to calculate mark-up in quotations*&#x2A; &#x2A;*[!1138](https://gitlab.com/dokos/dokos/-/merge_requests/1138){rel="&#x22;nofollow&#x22;"}**
- **Revert "Merge branch 'ft-pr-37232' into 'develop' (dokos/dokos!1028)"*&#x2A; &#x2A;*[!1119](https://gitlab.com/dokos/dokos/-/merge_requests/1119){rel="&#x22;nofollow&#x22;"}**
- **Group by Asset in Asset Depreciations and Balances report *by anandbaburajan*** [*frappe#38923*](https://github.com/frappe/frappe/pull/38923){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1117](https://gitlab.com/dokos/dokos/-/merge_requests/1117){rel="&#x22;nofollow&#x22;"}**
- **Skip disabled accounts in COA *by GursheenK*** [*frappe#38551*](https://github.com/frappe/frappe/pull/38551){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1103](https://gitlab.com/dokos/dokos/-/merge_requests/1103){rel="&#x22;nofollow&#x22;"}**
- **Utility to create journal entries from the bank reconciliation dashboard*&#x2A; &#x2A;*[!1094](https://gitlab.com/dokos/dokos/-/merge_requests/1094){rel="&#x22;nofollow&#x22;"}**
- **Remove german CoA "SKR04 ohne Kontonummern" and rename other CoA files *by barredterra*** [*frappe#38805*](https://github.com/frappe/frappe/pull/38805){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1090](https://gitlab.com/dokos/dokos/-/merge_requests/1090){rel="&#x22;nofollow&#x22;"}**
- **Merge taxes from mapped docs *by deepeshgarg007*** [*frappe#38346*](https://github.com/frappe/frappe/pull/38346){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1089](https://gitlab.com/dokos/dokos/-/merge_requests/1089){rel="&#x22;nofollow&#x22;"}**
- **Utility to debug financial reports *by ruthra-kumar*** [*frappe#38496*](https://github.com/frappe/frappe/pull/38496){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1088](https://gitlab.com/dokos/dokos/-/merge_requests/1088){rel="&#x22;nofollow&#x22;"}**
- **Voucher subtype for general ledger *by GursheenK*** [*frappe#38822*](https://github.com/frappe/frappe/pull/38822){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1077](https://gitlab.com/dokos/dokos/-/merge_requests/1077){rel="&#x22;nofollow&#x22;"}**
- **Provision to add items in Stock Reservation dialog *by s-aga-r*** [*frappe#38558*](https://github.com/frappe/frappe/pull/38558){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1071](https://gitlab.com/dokos/dokos/-/merge_requests/1071){rel="&#x22;nofollow&#x22;"}**
- **Update company.py *by hyaray*** [*frappe#38660*](https://github.com/frappe/frappe/pull/38660){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1068](https://gitlab.com/dokos/dokos/-/merge_requests/1068){rel="&#x22;nofollow&#x22;"}**
- **Discount percentage in print*&#x2A; &#x2A;*[!1059](https://gitlab.com/dokos/dokos/-/merge_requests/1059){rel="&#x22;nofollow&#x22;"}**
- **Total\_asset\_cost field *by anandbaburajan*** [*frappe#38879*](https://github.com/frappe/frappe/pull/38879){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1057](https://gitlab.com/dokos/dokos/-/merge_requests/1057){rel="&#x22;nofollow&#x22;"}**
- **Margin calculation on quotations improvement*&#x2A; &#x2A;*[!1051](https://gitlab.com/dokos/dokos/-/merge_requests/1051){rel="&#x22;nofollow&#x22;"}**
- **(pos): Improve UX of POS on tablets*&#x2A; &#x2A;*[!1020](https://gitlab.com/dokos/dokos/-/merge_requests/1020){rel="&#x22;nofollow&#x22;"}**

## Corrections de bugs

- **Taxes on print format*&#x2A; &#x2A;*[!1181](https://gitlab.com/dokos/dokos/-/merge_requests/1181){rel="&#x22;nofollow&#x22;"}**
- **Make bank reconciliation page extendable*&#x2A; &#x2A;*[!1182](https://gitlab.com/dokos/dokos/-/merge_requests/1182){rel="&#x22;nofollow&#x22;"}**
- **Inventory dimension negative stock validation *by rohitwaghchaure**&#x2A; &#x2A;*[!1177](https://gitlab.com/dokos/dokos/-/merge_requests/1177){rel="&#x22;nofollow&#x22;"}**
- **Creating Asset Activity while Importing Asset (backport #39113) &#x2A;by mergify [bot]**&#x2A; &#x2A;*[!1176](https://gitlab.com/dokos/dokos/-/merge_requests/1176){rel="&#x22;nofollow&#x22;"}**
- **Delete e commerce module*&#x2A; &#x2A;*[!1175](https://gitlab.com/dokos/dokos/-/merge_requests/1175){rel="&#x22;nofollow&#x22;"}**
- **French translations*&#x2A; &#x2A;*[!1174](https://gitlab.com/dokos/dokos/-/merge_requests/1174){rel="&#x22;nofollow&#x22;"}**
- **(Employee): Treeview *by barredterra**&#x2A; &#x2A;*[!1169](https://gitlab.com/dokos/dokos/-/merge_requests/1169){rel="&#x22;nofollow&#x22;"}**
- **Remove `parent_field` parameter from calls to `rebuild_tree` *by barredterra**&#x2A; &#x2A;*[!1168](https://gitlab.com/dokos/dokos/-/merge_requests/1168){rel="&#x22;nofollow&#x22;"}**
- **Serial / batch barcode scanner *by rohitwaghchaure**&#x2A; &#x2A;*[!1163](https://gitlab.com/dokos/dokos/-/merge_requests/1163){rel="&#x22;nofollow&#x22;"}**
- **(ContactAddressQuickEntry): Fix mandatory and default df properties*&#x2A; &#x2A;*[!1162](https://gitlab.com/dokos/dokos/-/merge_requests/1162){rel="&#x22;nofollow&#x22;"}**
- **(sales): Ensure markup\_percentage is strictly in range 0-100%*&#x2A; &#x2A;*[!1161](https://gitlab.com/dokos/dokos/-/merge_requests/1161){rel="&#x22;nofollow&#x22;"}**
- **Flaky demo test case *by deepeshgarg007**&#x2A; &#x2A;*[!1157](https://gitlab.com/dokos/dokos/-/merge_requests/1157){rel="&#x22;nofollow&#x22;"}**
- **Ignore cancelled payments in Sales/Purchase Register *by ruthra-kumar**&#x2A; &#x2A;*[!1156](https://gitlab.com/dokos/dokos/-/merge_requests/1156){rel="&#x22;nofollow&#x22;"}**
- **(UX): Dont override framework's permission check messages *by ankush**&#x2A; &#x2A;*[!1152](https://gitlab.com/dokos/dokos/-/merge_requests/1152){rel="&#x22;nofollow&#x22;"}**
- **Typerror on multi select dialog *by ruthra-kumar**&#x2A; &#x2A;*[!1151](https://gitlab.com/dokos/dokos/-/merge_requests/1151){rel="&#x22;nofollow&#x22;"}**
- **Ignore UP on "allowed to transact with" *by ankush**&#x2A; &#x2A;*[!1146](https://gitlab.com/dokos/dokos/-/merge_requests/1146){rel="&#x22;nofollow&#x22;"}**
- **On cancellation of document cancel the serial and batch bundle *by rohitwaghchaure**&#x2A; &#x2A;*[!1141](https://gitlab.com/dokos/dokos/-/merge_requests/1141){rel="&#x22;nofollow&#x22;"}**
- **Variant Items, List View Enabled to Variant Status Change *by creative-paramu**&#x2A; &#x2A;*[!1140](https://gitlab.com/dokos/dokos/-/merge_requests/1140){rel="&#x22;nofollow&#x22;"}**
- **Undefined error in Budget Variance and Profitability report *by ruthra-kumar**&#x2A; &#x2A;*[!1137](https://gitlab.com/dokos/dokos/-/merge_requests/1137){rel="&#x22;nofollow&#x22;"}**
- **French translations*&#x2A; &#x2A;*[!1136](https://gitlab.com/dokos/dokos/-/merge_requests/1136){rel="&#x22;nofollow&#x22;"}**
- **Missing data and translations*&#x2A; &#x2A;*[!1135](https://gitlab.com/dokos/dokos/-/merge_requests/1135){rel="&#x22;nofollow&#x22;"}**
- **Display report only for rows with item code*&#x2A; &#x2A;*[!1134](https://gitlab.com/dokos/dokos/-/merge_requests/1134){rel="&#x22;nofollow&#x22;"}**
- **(DX): Capture tracebacks with context *by ankush*** [*frappe#39060*](https://github.com/frappe/frappe/pull/39060){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1114](https://gitlab.com/dokos/dokos/-/merge_requests/1114){rel="&#x22;nofollow&#x22;"}**
- **Default\_roles hook doesn't exist anymore *by blaggacao*** [*frappe#39032*](https://github.com/frappe/frappe/pull/39032){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1116](https://gitlab.com/dokos/dokos/-/merge_requests/1116){rel="&#x22;nofollow&#x22;"}**
- **Unable to save Sales Invoice *by deepeshgarg007*** [*frappe#39059*](https://github.com/frappe/frappe/pull/39059){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1115](https://gitlab.com/dokos/dokos/-/merge_requests/1115){rel="&#x22;nofollow&#x22;"}**
- **Take quantity into account when setting asset's gross purchase amt *by anandbaburajan*** [*frappe#39056*](https://github.com/frappe/frappe/pull/39056){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1112](https://gitlab.com/dokos/dokos/-/merge_requests/1112){rel="&#x22;nofollow&#x22;"}**
- **Work order with multi level, fetch operting cost from sub-assembly *by rohitwaghchaure*** [*frappe#38992*](https://github.com/frappe/frappe/pull/38992){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1107](https://gitlab.com/dokos/dokos/-/merge_requests/1107){rel="&#x22;nofollow&#x22;"}**
- **Non stock uom validation for serial and batch *by rohitwaghchaure*** [*frappe#39018*](https://github.com/frappe/frappe/pull/39018){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1106](https://gitlab.com/dokos/dokos/-/merge_requests/1106){rel="&#x22;nofollow&#x22;"}**
- **UX improvements to support page*&#x2A; &#x2A;*[!1104](https://gitlab.com/dokos/dokos/-/merge_requests/1104){rel="&#x22;nofollow&#x22;"}**
- **Validate account in Sales/Purchase Taxes and Charges Template *by deepeshgarg007*** [*frappe#39013*](https://github.com/frappe/frappe/pull/39013){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1102](https://gitlab.com/dokos/dokos/-/merge_requests/1102){rel="&#x22;nofollow&#x22;"}**
- **Purchase return without item code not working *by rohitwaghchaure*** [*frappe#39014*](https://github.com/frappe/frappe/pull/39014){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1101](https://gitlab.com/dokos/dokos/-/merge_requests/1101){rel="&#x22;nofollow&#x22;"}**
- **Incorrect net profit in Profit and Loss Statement *by ruthra-kumar*** [*frappe#38969*](https://github.com/frappe/frappe/pull/38969){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1093](https://gitlab.com/dokos/dokos/-/merge_requests/1093){rel="&#x22;nofollow&#x22;"}**
- **Serial and batch bundle company mandatory error *by rohitwaghchaure*** [*frappe#38994*](https://github.com/frappe/frappe/pull/38994){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1097](https://gitlab.com/dokos/dokos/-/merge_requests/1097){rel="&#x22;nofollow&#x22;"}**
- **Set default letter head in accounts controller*&#x2A; &#x2A;*[!1100](https://gitlab.com/dokos/dokos/-/merge_requests/1100){rel="&#x22;nofollow&#x22;"}**
- **Auto fetch not working if bundle exists *by rohitwaghchaure*** [*frappe#39002*](https://github.com/frappe/frappe/pull/39002){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1098](https://gitlab.com/dokos/dokos/-/merge_requests/1098){rel="&#x22;nofollow&#x22;"}**
- **Remove non existing field*&#x2A; &#x2A;*[!1095](https://gitlab.com/dokos/dokos/-/merge_requests/1095){rel="&#x22;nofollow&#x22;"}**
- **Remove bad defaults *by ankush*** [*frappe#38986*](https://github.com/frappe/frappe/pull/38986){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1092](https://gitlab.com/dokos/dokos/-/merge_requests/1092){rel="&#x22;nofollow&#x22;"}**
- **Incorrect qty in serial batch bundle against pick list *by rohitwaghchaure*** [*frappe#38964*](https://github.com/frappe/frappe/pull/38964){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1085](https://gitlab.com/dokos/dokos/-/merge_requests/1085){rel="&#x22;nofollow&#x22;"}**
- **Not able to cancel sales invoice *by rohitwaghchaure*** [*frappe#38979*](https://github.com/frappe/frappe/pull/38979){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1091](https://gitlab.com/dokos/dokos/-/merge_requests/1091){rel="&#x22;nofollow&#x22;"}**
- **Correct logic for overlap error *by VihangT*** [*frappe#38967*](https://github.com/frappe/frappe/pull/38967){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1086](https://gitlab.com/dokos/dokos/-/merge_requests/1086){rel="&#x22;nofollow&#x22;"}**
- **Use `Stock Qty` while getting `POS Reserved Qty` *by s-aga-r*** [*frappe#38962*](https://github.com/frappe/frappe/pull/38962){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1084](https://gitlab.com/dokos/dokos/-/merge_requests/1084){rel="&#x22;nofollow&#x22;"}**
- **Min order qty optional in production plan *by rohitwaghchaure*** [*frappe#38956*](https://github.com/frappe/frappe/pull/38956){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1083](https://gitlab.com/dokos/dokos/-/merge_requests/1083){rel="&#x22;nofollow&#x22;"}**
- **Do not make serial batch bundle for zero qty *by rohitwaghchaure*** [*frappe#38949*](https://github.com/frappe/frappe/pull/38949){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1081](https://gitlab.com/dokos/dokos/-/merge_requests/1081){rel="&#x22;nofollow&#x22;"}**
- **Not able to import serial batch bundle using csv *by rohitwaghchaure*** [*frappe#38950*](https://github.com/frappe/frappe/pull/38950){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1082](https://gitlab.com/dokos/dokos/-/merge_requests/1082){rel="&#x22;nofollow&#x22;"}**
- **(ux): Make PR and PI Item rate field readonly based on `Maintain Same Rate` *by s-aga-r*** [*frappe#38942*](https://github.com/frappe/frappe/pull/38942){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1079](https://gitlab.com/dokos/dokos/-/merge_requests/1079){rel="&#x22;nofollow&#x22;"}**
- **Incorrect price list in customer-wise item price report *by ruthra-kumar*** [*frappe#38891*](https://github.com/frappe/frappe/pull/38891){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1080](https://gitlab.com/dokos/dokos/-/merge_requests/1080){rel="&#x22;nofollow&#x22;"}**
- **(Project): German translation for actual time *by wojosc*** [*frappe#38837*](https://github.com/frappe/frappe/pull/38837){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1078](https://gitlab.com/dokos/dokos/-/merge_requests/1078){rel="&#x22;nofollow&#x22;"}**
- **Missing remarks and journal in pi gl entries*&#x2A; &#x2A;*[!1076](https://gitlab.com/dokos/dokos/-/merge_requests/1076){rel="&#x22;nofollow&#x22;"}**
- **Reset the incoming rate on changing of the warehouse *by rohitwaghchaure*** [*frappe#38925*](https://github.com/frappe/frappe/pull/38925){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1075](https://gitlab.com/dokos/dokos/-/merge_requests/1075){rel="&#x22;nofollow&#x22;"}**
- **Translation*&#x2A; &#x2A;*[!1074](https://gitlab.com/dokos/dokos/-/merge_requests/1074){rel="&#x22;nofollow&#x22;"}**
- **`Reserved Stock` report *by s-aga-r*** [*frappe#38922*](https://github.com/frappe/frappe/pull/38922){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1072](https://gitlab.com/dokos/dokos/-/merge_requests/1072){rel="&#x22;nofollow&#x22;"}**
- **Revert setting valuation rate as cost price*&#x2A; &#x2A;*[!1070](https://gitlab.com/dokos/dokos/-/merge_requests/1070){rel="&#x22;nofollow&#x22;"}**
- **Set email as option in customer*&#x2A; &#x2A;*[!1069](https://gitlab.com/dokos/dokos/-/merge_requests/1069){rel="&#x22;nofollow&#x22;"}**
- **Fixup broken JSON files *by ankush*** [*frappe#38915*](https://github.com/frappe/frappe/pull/38915){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1067](https://gitlab.com/dokos/dokos/-/merge_requests/1067){rel="&#x22;nofollow&#x22;"}**
- **Additional\_asset\_cost field *by anandbaburajan*** [*frappe#38904*](https://github.com/frappe/frappe/pull/38904){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1065](https://gitlab.com/dokos/dokos/-/merge_requests/1065){rel="&#x22;nofollow&#x22;"}**
- **Get balance transaction directly if id is present in payout*&#x2A; &#x2A;*[!1064](https://gitlab.com/dokos/dokos/-/merge_requests/1064){rel="&#x22;nofollow&#x22;"}**
- **Renamed function*&#x2A; &#x2A;*[!1063](https://gitlab.com/dokos/dokos/-/merge_requests/1063){rel="&#x22;nofollow&#x22;"}**
- **Reposting not fixing valuation rate for sales return using movin… (backport #38895) &#x2A;by mergify [bot]*** [*frappe#38897*](https://github.com/frappe/frappe/pull/38897){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1062](https://gitlab.com/dokos/dokos/-/merge_requests/1062){rel="&#x22;nofollow&#x22;"}**
- **Do not reset the basic rate for the material receipt stock entry (backport #38896) &#x2A;by mergify [bot]*** [*frappe#38898*](https://github.com/frappe/frappe/pull/38898){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1061](https://gitlab.com/dokos/dokos/-/merge_requests/1061){rel="&#x22;nofollow&#x22;"}**
- **Typeerror on pos order summary to new order screen *by ruthra-kumar*** [*frappe#38893*](https://github.com/frappe/frappe/pull/38893){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1060](https://gitlab.com/dokos/dokos/-/merge_requests/1060){rel="&#x22;nofollow&#x22;"}**
- **French translations corrections*&#x2A; &#x2A;*[!1058](https://gitlab.com/dokos/dokos/-/merge_requests/1058){rel="&#x22;nofollow&#x22;"}**
- **Allow to set rate manually for service item in BOM (backport #38880) &#x2A;by mergify [bot]*** [*frappe#38882*](https://github.com/frappe/frappe/pull/38882){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1056](https://gitlab.com/dokos/dokos/-/merge_requests/1056){rel="&#x22;nofollow&#x22;"}**
- **Local reference error in BOM *by niyazrazak*** [*frappe#38850*](https://github.com/frappe/frappe/pull/38850){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1055](https://gitlab.com/dokos/dokos/-/merge_requests/1055){rel="&#x22;nofollow&#x22;"}**
- **Typerror on tree doctypes - Item Group, Customer Group, Supplier Group and Territory *by ruthra-kumar*** [*frappe#38870*](https://github.com/frappe/frappe/pull/38870){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1053](https://gitlab.com/dokos/dokos/-/merge_requests/1053){rel="&#x22;nofollow&#x22;"}**
- **Use party account currency when party account is specified *by dj12djdjs*** [*frappe#38838*](https://github.com/frappe/frappe/pull/38838){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1052](https://gitlab.com/dokos/dokos/-/merge_requests/1052){rel="&#x22;nofollow&#x22;"}**
- **If not budget then don't validate (backport #38861) &#x2A;by mergify [bot]*** [*frappe#38864*](https://github.com/frappe/frappe/pull/38864){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1050](https://gitlab.com/dokos/dokos/-/merge_requests/1050){rel="&#x22;nofollow&#x22;"}**
- **Incoming rate for sales return with Moving Average valuation method (backport #38849) &#x2A;by mergify [bot]*** [*frappe#38863*](https://github.com/frappe/frappe/pull/38863){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1049](https://gitlab.com/dokos/dokos/-/merge_requests/1049){rel="&#x22;nofollow&#x22;"}**
- **On closed unreserved the production plan qty (backport #38848) &#x2A;by mergify [bot]*** [*frappe#38859*](https://github.com/frappe/frappe/pull/38859){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1048](https://gitlab.com/dokos/dokos/-/merge_requests/1048){rel="&#x22;nofollow&#x22;"}**
- **Set `fg-itm-qty` based on `qty` instead of the other way round in Subcontracting POs *by SvbZ3r0*** [*frappe#38842*](https://github.com/frappe/frappe/pull/38842){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1047](https://gitlab.com/dokos/dokos/-/merge_requests/1047){rel="&#x22;nofollow&#x22;"}**
- **Item variant with manufacturer (backport #38845) &#x2A;by mergify [bot]*** [*frappe#38847*](https://github.com/frappe/frappe/pull/38847){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1046](https://gitlab.com/dokos/dokos/-/merge_requests/1046){rel="&#x22;nofollow&#x22;"}**
- **Wrong paid and cn amount on pos invoice *by rtdany10*** [*frappe#38797*](https://github.com/frappe/frappe/pull/38797){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1044](https://gitlab.com/dokos/dokos/-/merge_requests/1044){rel="&#x22;nofollow&#x22;"}**
- **Not able to make inter-company po from so (backport #38826) &#x2A;by mergify [bot]*** [*frappe#38828*](https://github.com/frappe/frappe/pull/38828){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1043](https://gitlab.com/dokos/dokos/-/merge_requests/1043){rel="&#x22;nofollow&#x22;"}**
- **Not able to cancel SCR with Batch (backport #38817) &#x2A;by mergify [bot]*** [*frappe#38821*](https://github.com/frappe/frappe/pull/38821){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1041](https://gitlab.com/dokos/dokos/-/merge_requests/1041){rel="&#x22;nofollow&#x22;"}**
- **Make GL and JV against fields dynamic links *by GursheenK*** [*frappe#37232*](https://github.com/frappe/frappe/pull/37232){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1028](https://gitlab.com/dokos/dokos/-/merge_requests/1028){rel="&#x22;nofollow&#x22;"}**
- **Simplify logic*&#x2A; &#x2A;*[!1036](https://gitlab.com/dokos/dokos/-/merge_requests/1036){rel="&#x22;nofollow&#x22;"}**
- **Precision for status determination*&#x2A; &#x2A;*[!1035](https://gitlab.com/dokos/dokos/-/merge_requests/1035){rel="&#x22;nofollow&#x22;"}**
- **Groups for current accounts in German CoAs *by barredterra*** [*frappe#38803*](https://github.com/frappe/frappe/pull/38803){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1034](https://gitlab.com/dokos/dokos/-/merge_requests/1034){rel="&#x22;nofollow&#x22;"}**
- Use v4 branch for Dodock, fix Docker build

## Maintenance et organisation

- **Flag to control loyalty point creation at invoice level *by ruthra-kumar**&#x2A; &#x2A;*[!1147](https://gitlab.com/dokos/dokos/-/merge_requests/1147){rel="&#x22;nofollow&#x22;"}**
- **(perf): Replace account subquery with 'in' condition *by ruthra-kumar*** [*frappe#39023*](https://github.com/frappe/frappe/pull/39023){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1118](https://gitlab.com/dokos/dokos/-/merge_requests/1118){rel="&#x22;nofollow&#x22;"}**
- **Ignore ERR journals in Statment of Accounts *by ruthra-kumar*** [*frappe#38820*](https://github.com/frappe/frappe/pull/38820){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1038](https://gitlab.com/dokos/dokos/-/merge_requests/1038){rel="&#x22;nofollow&#x22;"}**

## Améliorations de performance

- **Index item\_code in bom explosion item *by ankush**&#x2A; &#x2A;*[!1139](https://gitlab.com/dokos/dokos/-/merge_requests/1139){rel="&#x22;nofollow&#x22;"}**
- **Drop unused/duplicate/sub-optimal indexes *by ankush*** [*frappe#38884*](https://github.com/frappe/frappe/pull/38884){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1066](https://gitlab.com/dokos/dokos/-/merge_requests/1066){rel="&#x22;nofollow&#x22;"}**
- **Use estimated rows instead of actual rows *by ankush*** [*frappe#38830*](https://github.com/frappe/frappe/pull/38830){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1054](https://gitlab.com/dokos/dokos/-/merge_requests/1054){rel="&#x22;nofollow&#x22;"}**
- **Index `return_against` on delivery note *by ankush*** [*frappe#38827*](https://github.com/frappe/frappe/pull/38827){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1042](https://gitlab.com/dokos/dokos/-/merge_requests/1042){rel="&#x22;nofollow&#x22;"}**

## Tests et intégration continue

- **Message to indicate how to reconcile a credit note in v4*&#x2A; &#x2A;*[!1073](https://gitlab.com/dokos/dokos/-/merge_requests/1073){rel="&#x22;nofollow&#x22;"}**

---

**Contributeurs**

- **Charles-Henri Decultot** (63)
- **ruthra kumar** (43)
- **Gursheen Anand** (34)
- **s-aga-r** (18)
- **rohitwaghchaure** (14)
- **Ankush Menat** (9)
- **Corentin Forler** (7)
- **Deepesh Garg** (6)
- **Anand Baburajan** (4)
- **Raffael Meyer** (3)

et 11 autres contributeurs…

- Dany Robert
- Devin Slauenwhite
- Gursheen Kaur Anand
- David Arnold
- Gughan Ravikumar
- NIYAZ RAZAK
- Parameshwari Palanisamy
- VihangT
- Wolfram Schmidt
- barredterra
- hyaray

---

**Différentiel complet:** [v4.1.0...v4.2.0](https://gitlab.com/dokos/dokos/-/compare/v4.1.0...v4.2.0){rel="&#x22;nofollow&#x22;"}:br&#x2A;*Tag:** [v4.2.0](https://gitlab.com/dokos/dokos/-/tags/v4.2.0){rel="&#x22;nofollow&#x22;"}


# v3.0.0

::callout
La version 3.0.0 de Dokos est basée sur la version 14 d'ERPNext
Une grande partie des changements cités ci-dessous ont été développés par l'équipe de Frappe Technologies et les contributeurs aux logiciels de l'éco-système Frappe/ERPNext
Le détail des changements publiés dans Dokos est disponible sur [Gitlab](https://gitlab.com/dokos/dokos/-/releases){rel=""nofollow""}
::

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Cette page n'indique que les nouvelles fonctionnalités les plus importantes pour chaque module.
::

## Migration vers la v3.x.x

> [Guide de migration pour les utilisateurs auto-hébergés](https://doc.dokos.io/v5/dodock/administration/migration-v3)

> [Migration de Dokos: v2 > v3 (ERPNext v13 > v14)](https://github.com/frappe/erpnext/wiki/Migration-Guide-to-ERPNext-version-14){rel="&#x22;nofollow&#x22;"}

## Evolutions

### Comptabilité

- 📄 Comptabilité commune pour les clients/fournisseurs. Il est désormais possible de lier un client à fournisseur.
- 📄 Création de règles d'allocation des écritures comptables par centre de coûts.
- 📄 Nouvelle méthode de comptabilisation des factures d'acomptes. La facture est désormais comptabilisée normalement et le compte de produits est remplacé par le compte d'acomptes. Le paiement est comptabilisé normalement et la régularisation a lieu lors de l'enregistrement de la facture finale.

> La méthode de comptabilisation des acomptes a changé.
> Si vous avez des acomptes non alloués, il faut les solder via une écriture de journal avant de créer la facture finale.
>
> *Exemple d'écriture de journal pour un acompte de 1000 €*
> |Compte|Débit|Crédit|Type de tiers|Tiers|Type de référence|Nom du document de référence|
> \|----|----|----|----|----|----|----|----|
> |419 - Acomptes|1000|0|Client|Mon Client|Ecriture de paiement|N° de l'écriture de paiement de l'acompte|
> |512 - Banque|0|1000|||||

- 📄 Nouvel outil de réconciliation des paiements
- 📄 Les centres de coûts distribués sont désormais remplacés par des allocations de centres de coûts
- 📄 Un livre des paiements enregistre l'ensemble des écritures comptables liées aux paiement et facilite la réconciliation et le reporting
- 📄 Nouvel outil de fusion des comptes comptables
- 📄 Changement d'API de récupération de taux de change de frankfurter.app à exchangerate.host
- 📈 Option pour grouper les écritures GL par contrepartie dans le Grand Livre
- 📄 Enregistrement de la TVA par article dans des champs dédiés dans les documents de vente et d'achats
- 📈 Nouveau rapport *Budget de trésorerie*
- 📄 Format d'impression par défaut pour les factures de vente
- 📄 Possibilité de désactiver les modèles de taxes et modèles de taxe par article

### Ventes

- 📄 Option pour saisir un code de réduction dans le point de vente
- 📄 Les factures de point de vente peuvent désormais être fusionnées par groupe de client.
- 📄 Scan de codes barres dans les devis

### Achats

- 📄 Séparation des options de sous-traitance dans un module dédié

### Stocks

- 📄 Nouvelle option de valorisation en LIFO
- 📄 Taux de valorisation par lot
- 📄 Amélioration de la lecture des codes barres
- 📄 Autorisation de sur-transfert pour les demandes de matériel
- 📄 Option pour scanner dans les listes de sélection (Pick List)
- 📄 Possibilité d'avoir des codes barres différents par unité de mesure
- 📄 Les unités de mesure disponibles sont celles disponibles dans les données de base de l'article
- 📄 Support pour les ensembles de produits dans les listes de sélection
- 📄 Option pour créer une seule liste de sélection/bon de livraison depuis plusieurs commandes client
- 📄 L'autorisation d'enregistrer des stocks négatifs se fait désormais au niveau des articles

### Gestion des actifs

- 📄 Possibilité de diviser un actif immobilisé
- 📄 Possibilité de créer des actifs immobilisés groupés sur la base d'un achat
- 📄 Possibilité d'envoyer un actif en réparation

### Production

- 📄 Amélioration de la performance de l'outil de mise à jour des nomenclatures
- 📄 Possibilité de mettre des articles au rebut dans les cartes de travail
- 📄 Gestion des pertes de production
- 📈 Synthèse du plan de production
- 📈 Rapport de matériaux consommés par ordre de travail
- 📄 Nouvelle option pour fermer définitivement un ordre de travail
- 📄 Nouveau module pour la gestion de la sous-traitance

### CRM

- 📄 Amélioration du flux CRM:


  - Création d'un nouveau type de document **Prospect** permettant un meilleur suivi des personnes morales
  - Renommage du document **Prospect** (Lead) de la version 2 en **Piste**
  - Page **Paramètres du CRM** dédiée
  - Option pour sélectionner les concurrents lors de la perte d'une opportunité ou d'un devis
  - Sections pour gérer ses activités et ses notes dans les pistes, prospects et opportunités
- 📈 Nouveau rapport *Analyse du pipeline de vente*
- 📈 Nouveau rapport *Récapitulatif des opportunités par stade de vente*

### Ressources Humaines

::callout
Les modules RH et Paie ont été transférés dans une application dédiée: :br<https://gitlab.com/dokos/hrms>{rel=""nofollow""}
::

- 🏢 Organigramme des employés
- 📄 Nouveau document *Griefs des employés*
- 📄 Suivi des entretiens à multiples étapes
- 📈 Nouveau rapport *Sorties d'employés*
- 📄 Nouveau document *Entretien de sortie*
- 🔔 Rappels configurables pour les employés dans les Paramètres RH
- 📄 Relevé complet et final de paie
- 📈 Nouveau rapport *Calcul de l'impôt sur le revenu*
- 📄 Possibilité d'affecter plusieurs quarts à un employé par jour

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Certaines fonctionnalités de paie listées ci-dessus ne sont pas encore applicables à un usage en France
::

### Lieu

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
- 📈 Amélioration du rapport *Taux de réservation des articles*
- 📄 Nouvelle page de réservation de créneaux sur le site web
::

### Localisations

- 📄 E-Facturation KSA (Arabie Saoudite)
- 📈 Rapport d'audit de TVA (Afrique du sud)
- 📄 Préparation à la déclaration de TVA (France)
- 🌍 L'intégration DATEV a été transférée dans une application séparée: <https://github.com/alyf-de/erpnext_datev>{rel="&#x22;nofollow&#x22;"} (Allemagne)
- 🌍 Toutes les localisations spécifiques à l'Allemagne ont été transférées dans une application séparée: <https://github.com/alyf-de/erpnext_germany>{rel="&#x22;nofollow&#x22;"} (Allemagne)
- 📄 Nouveau document *Préparation à la déclaration de TVA* (France)
- 📄 Initialisation d'un module régional pour l'Algérie (Algérie)

### Intégrations

- 📄 L'intégration TaxJar a été améliorée

::callout
Une intégration avec Nextcloud est désormais disponible pour synchroniser les fichiers de Dokos sur votre instance Nextcloud.
<https://gitlab.com/dokos/nextcloud>{rel=""nofollow""}
::

::callout
Une intégration avec Hiboutik permet de synchroniser les données de vente de votre point de vente Hiboutik vers Dokos
<https://gitlab.com/dokos/hiboutik>{rel=""nofollow""}
::


# v3.10.0

::callout
La version 3.10.0 de Dokos est basée sur la version 14 d'ERPNext
Une grande partie des changements cités ci-dessous ont été développés par l'équipe de Frappe Technologies et les contributeurs aux logiciels de l'éco-système Frappe/ERPNext
Le détail des changements publiés dans Dokos est disponible sur [Gitlab](https://gitlab.com/dokos/dokos/-/releases/v3.10.0){rel=""nofollow""}
::

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Cette page n'indique que les nouvelles fonctionnalités les plus importantes pour chaque module.
::

### Découvertes de document

- Amélioration des *tours* dans les types de documents **Client** et **Fournisseur**

### Sous-assemblage

- Demandes de matériel pour les articles de sous-assemblage :br
  👉 [ERPNext](https://github.com/frappe/erpnext/pull/33135){rel="&#x22;nofollow&#x22;"}

### Incoterms

- Support des incoterms dans les transactions de vente et d'achat :br
  👉 [ERPNext](https://github.com/frappe/erpnext/pull/33022){rel="&#x22;nofollow&#x22;"}


# v3.11.0

::callout
La version 3.11.0 de Dokos est basée sur la version 14 d'ERPNext
Une grande partie des changements cités ci-dessous ont été développés par l'équipe de Frappe Technologies et les contributeurs aux logiciels de l'éco-système Frappe/ERPNext
Le détail des changements publiés dans Dokos est disponible sur [Gitlab](https://gitlab.com/dokos/dokos/-/releases/v3.11.0){rel=""nofollow""}
::

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Cette page n'indique que les nouvelles fonctionnalités les plus importantes pour chaque module.
::

### Stocks

- Nouveau rapport: Solde de stock par entrepôts :br
  👉 [ERPNext](https://github.com/frappe/erpnext/pull/33236){rel="&#x22;nofollow&#x22;"}

### Comptabilité

- Nouvelle option dans les paramètres de comptabilité permettant de ne pas fusionner les lignes d'écritures comptables associées aux mêmes comptes.

**Fontionnement**

> Pour l'écriture de journal suivante:
>
> | Compte | Débit | Crédit |
> | ------ | ----- | ------ |
> | 4xxxxx | 100   | 0      |
> | 4xxxxx | 0     | 50     |
>
> **Enregistrement comptable**
>
> | Compte | Débit | Crédit |
> | ------ | ----- | ------ |
> | 4xxxxx | 100   | 50     |
>
> **Avec cette nouvelle option**
>
> | Compte | Débit | Crédit |
> | ------ | ----- | ------ |
> | 4xxxxx | 100   | 0      |
> | 4xxxxx | 0     | 50     |


# v3.12.0

::callout
La version 3.12.0 de Dokos est basée sur la version 14 d'ERPNext
Une grande partie des changements cités ci-dessous ont été développés par l'équipe de Frappe Technologies et les contributeurs aux logiciels de l'éco-système Frappe/ERPNext
Le détail des changements publiés dans Dokos est disponible sur [Gitlab](https://gitlab.com/dokos/dokos/-/releases/v3.12.0){rel=""nofollow""}
::

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Cette page n'indique que les nouvelles fonctionnalités les plus importantes pour chaque module.
::

### Incoterms

- Ajout d'un champ dans les factures pour indiquer le lieu de destination :br
  👉 [ERPNext](https://github.com/frappe/erpnext/pull/33305){rel="&#x22;nofollow&#x22;"}

### Factures de vente (France)

- Nouvelle option dans les paramètres de comptabilité permettant de valider la chronologie des factures de vente. :br
  Si cette option est cochée, la validation de la facture sera bloquée si la chronologie des factures n'est pas respectée.

### Comptabilité

- Il est désormais possible d'ajouter un champ personnalisé *remarks* dans les tableaux de taxes et frais (ventes/achats) afin de personnaliser les libellés des écritures comptables correspondantes. :b&#x72;
  Par défaut, le libellé sera: &#x2A;/ Client (Fournisseur): {nom du client/fournisseur}*{de="" description="" la="" ligne=""}

### Fichier des écritures comptables (France)

- Nouvelle option permettant d'exporter un FEC avec les PDF des pièces dans un fichier zip.

### Pistes

- Le numéro Whatsapp est ajouté aux options de recherche des pistes :br
  👉 [ERPNext](https://github.com/frappe/erpnext/pull/33253){rel="&#x22;nofollow&#x22;"}


# v3.13.0

::callout
La version 3.13.0 de Dokos est basée sur la version 14 d'ERPNext
Une grande partie des changements cités ci-dessous ont été développés par l'équipe de Frappe Technologies et les contributeurs aux logiciels de l'éco-système Frappe/ERPNext
Le détail des changements publiés dans Dokos est disponible sur [Gitlab](https://gitlab.com/dokos/dokos/-/releases/v3.13.0){rel=""nofollow""}
::

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Cette page n'indique que les nouvelles fonctionnalités les plus importantes pour chaque module.
::

### Dimensions comptables

- Ajout des dimensions comptables dans les demandes de paiement :br
  👉 [ERPNext](https://github.com/frappe/erpnext/pull/33411){rel="&#x22;nofollow&#x22;"}

### Appels d'offre

- Ajout de nouvelles options d'impression pour les appels d'offre:


  - Sélection du format d'impression
  - Sélection de la langue
  - Sélection d'un en-tête :br
    👉 [ERPNext](https://github.com/frappe/erpnext/pull/33339){rel="&#x22;nofollow&#x22;"}


# v3.14.0

::callout
La version 3.14.0 de Dokos est basée sur la version 14 d'ERPNext
Une grande partie des changements cités ci-dessous ont été développés par l'équipe de Frappe Technologies et les contributeurs aux logiciels de l'éco-système Frappe/ERPNext
Le détail des changements publiés dans Dokos est disponible sur [Gitlab](https://gitlab.com/dokos/dokos/-/releases/v3.14.0){rel=""nofollow""}
::

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Cette page n'indique que les nouvelles fonctionnalités les plus importantes pour chaque module.
::

### Tableau de bord de la fiche Article

- Ajout d'un *hook* `after_refresh` sur le tableau de bord de la fiche Article. :br
  Cela permet aux développeurs d'ajouter des fonctionnalités ou de modifier les données après leur récupération par le tableau de bord. :br
  👉 [ERPNext](https://github.com/frappe/erpnext/pull/33372){rel="&#x22;nofollow&#x22;"}

### Intégration Exotel

- Possibilité d'utiliser le paramètre de l'API Exotel `CustomField`:br
  👉 [ERPNext](https://github.com/frappe/erpnext/pull/33338){rel="&#x22;nofollow&#x22;"}


# v3.15.0

::callout
La version 3.15.0 de Dokos est basée sur la version 14 d'ERPNext
Une grande partie des changements cités ci-dessous ont été développés par l'équipe de Frappe Technologies et les contributeurs aux logiciels de l'éco-système Frappe/ERPNext
Le détail des changements publiés dans Dokos est disponible sur [Gitlab](https://gitlab.com/dokos/dokos/-/releases/v3.15.0){rel=""nofollow""}
::

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Cette page n'indique que les nouvelles fonctionnalités les plus importantes pour chaque module.
::

### Abonnements

- Les quantités dans les plans d'abonnement sont désormais des nombres réels au lieu de nombres entiers.


# v3.16.0

::callout
La version 3.16.0 de Dokos est basée sur la version 14 d'ERPNext
Une grande partie des changements cités ci-dessous ont été développés par l'équipe de Frappe Technologies et les contributeurs aux logiciels de l'éco-système Frappe/ERPNext
Le détail des changements publiés dans Dokos est disponible sur [Gitlab](https://gitlab.com/dokos/dokos/-/releases/v3.16.0){rel=""nofollow""}
::

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Cette page n'indique que les nouvelles fonctionnalités les plus importantes pour chaque module.
::

### Panier

- Si les comptes de tiers ne sont pas correctement configurés, le système renvoie une erreur lors de l'ajout d'un article dans le panier.

### E Commerce

- Amélioration de la pagination dans les listes des produits
- Ajout d'un bouton pour cacher/voir les filtres de la liste de produits en vue mobile
- La section *Filtres* est désormais cachée si aucun filtre n'est défini

### Stock

- Ajout d'un hook `after_bin_qty_update` après la mise à jour effective des fiches d'inventaire.
  Ce hook est notamment utilisé dans l'intégration WooCommerce pour mettre à jour les soldes de stock.

### Production

- Possibilité de catégoriser les stations de travail par type de station de travail. :br
  Cela permet notamment de sélectionner un type de station de travail dans les nomenclatures et d'automatiser la sélection d'une station de travail disponible en fonction de son type dans les cartes de travail. :br
  👉 [ERPNext](https://github.com/frappe/erpnext/pull/32911){rel="&#x22;nofollow&#x22;"}


# v3.17.0

::callout
La version 3.17.0 de Dokos est basée sur la version 14 d'ERPNext
Une grande partie des changements cités ci-dessous ont été développés par l'équipe de Frappe Technologies et les contributeurs aux logiciels de l'éco-système Frappe/ERPNext
Le détail des changements publiés dans Dokos est disponible sur [Gitlab](https://gitlab.com/dokos/dokos/-/releases/v3.17.0){rel=""nofollow""}
::

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Cette page n'indique que les nouvelles fonctionnalités les plus importantes pour chaque module.
::

### Stocks

- Possibilité de récupérer une liste d'articles depuis une écriture de transit pour créer une écriture de stock :br
  👉 [ERPNext](https://github.com/frappe/erpnext/pull/33785){rel="&#x22;nofollow&#x22;"}

### Production

- Possibilité d'ajouter des coûts d'exploitation unitaires dans une nomenclature pour ne pas avoir à créer de cartes de travail lors du processus de production :br
  👉 [ERPNext](https://github.com/frappe/erpnext/pull/33595){rel="&#x22;nofollow&#x22;"}
- Rapport *Récapitulatif des ordres de travail*: Ajout d'un filtre de sélection pour choisir la date de référence :br
  👉 [ERPNext](https://github.com/frappe/erpnext/pull/33684){rel="&#x22;nofollow&#x22;"}

### Taux de change

- Nouvelle option permettant de désactiver l'utilisation de l'API de récupération des taux de change (Paramètres des taux de change) :br
  👉 [ERPNext](https://github.com/frappe/erpnext/pull/33593){rel="&#x22;nofollow&#x22;"}


# v3.18.0

::callout
La version 3.18.0 de Dokos est basée sur la version 14 d'ERPNext
Une grande partie des changements cités ci-dessous ont été développés par l'équipe de Frappe Technologies et les contributeurs aux logiciels de l'éco-système Frappe/ERPNext
Le détail des changements publiés dans Dokos est disponible sur [Gitlab](https://gitlab.com/dokos/dokos/-/releases/v3.18.0){rel=""nofollow""}
::

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Cette page n'indique que les nouvelles fonctionnalités les plus importantes pour chaque module.
::

### Abonnements

- Ajout d'un champ caché enregistrant le jour de facturation. :br
  Cette option permet de mieux gérer les facturations en fin de mois.


# v3.19.0

::callout
La version 3.19.0 de Dokos est basée sur la version 14 d'ERPNext
Une grande partie des changements cités ci-dessous ont été développés par l'équipe de Frappe Technologies et les contributeurs aux logiciels de l'éco-système Frappe/ERPNext
Le détail des changements publiés dans Dokos est disponible sur [Gitlab](https://gitlab.com/dokos/dokos/-/releases/v3.19.0){rel=""nofollow""}
::

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Cette page n'indique que les nouvelles fonctionnalités les plus importantes pour chaque module.
::

### Lieu

- Ajout d'un formulaire d'inscription au lieu [Documentation](https://doc.dokos.io/v5/dokos/lieu/portails/formulaire-inscription-lieu)
- Ajout de nouvelles fonctionnalités liées aux inscriptions aux événements:

  - Possibilité d'ajouter un montant à payer lors de l'inscription
  - Possibilité d'utiliser un formulaire web personnalisé et de demander des informations additionnelles lors de l'inscription en ligne :br
    👉 [Documentation](https://doc.dokos.io/v5/dokos/lieu/evenements)
- Création d'une page de réservation simplifiée (`/book-resources`) *🚧 Documentation à venir 🚧*
- Nouvelle fonctionnalité permettant de générer un site web commun pour plusieurs lieux :br
  👉 [Documentation](https://doc.dokos.io/v5/dokos/lieu/multi-societe)
- Les abonnements apparaîssent désormais dans le calendrier des réservations d'articles
- Il est désormais possible de permettre des réservations d'article le jour même
- Un nouveau champ `Article réservé`, disponible dans les lignes de plan d'abonnement, permet de réserver un article pendant toute la durée de vie d'un abonnement.

### Clients

- Amélioration de la recherche des clients en donnant la priorité à la recherche du début du nom.

### Plan comptable

- Nouvelle option dans les paramètres de comptabilité, permettant de ne pas afficher les soldes des comptes dans le plan comptable. :br
  Cette option peut être utile si la page met du temps à charger à cause de la récupération de tous les soldes. :br
  👉 [ERPNext](https://github.com/frappe/erpnext/pull/33502){rel="&#x22;nofollow&#x22;"}

### Rapports

- Ajout d'un filtre `entrepôt` dans le rapport **Bénéfice Brut**:br
  👉 [ERPNext](https://github.com/frappe/erpnext/pull/33397){rel="&#x22;nofollow&#x22;"}

### Point de vente

- Gestion de plusieurs prix différents pour un même article (ou variante d'article) :br
  👉 [ERPNext](https://github.com/frappe/erpnext/pull/33397){rel="&#x22;nofollow&#x22;"}

### E-Commerce

- L'appel à l'API `get_doc("E Commerce Settings")` a été remplacé par la fonction `get_shopping_cart_settings()` afin de pouvoir fonctionner en mode multi-société.


# v3.1.0

::callout
La version 3.1.0 de Dokos est basée sur la version 14 d'ERPNext
Une grande partie des changements cités ci-dessous ont été développés par l'équipe de Frappe Technologies et les contributeurs aux logiciels de l'éco-système Frappe/ERPNext
Le détail des changements publiés dans Dokos est disponible sur [Gitlab](https://gitlab.com/dokos/dokos/-/releases/v3.1.0){rel=""nofollow""}
::

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Cette page n'indique que les nouvelles fonctionnalités les plus importantes pour chaque module.
::

### Actifs immobilisés

- Nouvelle fonctionnalité permettant la capitalisation des actifs *🚧 Documentation à venir 🚧*:br
  👉 [ERPNext](https://github.com/frappe/erpnext/pull/27466){rel="&#x22;nofollow&#x22;"}


# v3.20.0

::callout
La version 3.20.0 de Dokos est basée sur la version 14 d'ERPNext
Une grande partie des changements cités ci-dessous ont été développés par l'équipe de Frappe Technologies et les contributeurs aux logiciels de l'éco-système Frappe/ERPNext
Le détail des changements publiés dans Dokos est disponible sur [Gitlab](https://gitlab.com/dokos/dokos/-/releases/v3.20.0){rel=""nofollow""}
::

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Cette page n'indique que les nouvelles fonctionnalités les plus importantes pour chaque module.
::

### Commandes client

- Nouvelle option, dans les paramètres des ventes, pour permettre la création de commandes clients à partir de devis expirés. :br
  👉 [ERPNext](https://github.com/frappe/erpnext/pull/33952){rel="&#x22;nofollow&#x22;"}

### Déclaration de TVA (France)

- Amélioration de la préparation à la déclaration de TVA

### Données de base

- Lors de l'installation de Dokos, un certain nombre de données de base sont ajoutées sur un nouveau site. :br
  Jusqu'à présent, ces données étaient traduites en fonction de la langue sélectionnée par le premier utilisateur. :br
  Désormais ces données sont créées en anglais, et déclarées comme traduisibles pour pouvoir être traduite en fonction de la langue de chaque utilisateur.
  Ce changement n'est pas rétroactif. :br
  👉 [ERPNext](https://github.com/frappe/erpnext/pull/33996){rel="&#x22;nofollow&#x22;"}

### Prêts

- Ajout de nouveaux filtres dans le `Rapport d'intérêts des prêts`:br
  👉 [ERPNext](https://github.com/frappe/erpnext/pull/33907){rel="&#x22;nofollow&#x22;"}


# v3.21.0

::callout
La version 3.21.0 de Dokos est basée sur la version 14 d'ERPNext
Une grande partie des changements cités ci-dessous ont été développés par l'équipe de Frappe Technologies et les contributeurs aux logiciels de l'éco-système Frappe/ERPNext
Le détail des changements publiés dans Dokos est disponible sur [Gitlab](https://gitlab.com/dokos/dokos/-/releases/v3.21.0){rel=""nofollow""}
::

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Cette page n'indique que les nouvelles fonctionnalités les plus importantes pour chaque module.
::

### Articles

- Ré-organisation de la fiche Article pour mettre le champ `Est un article en stock` plus haut.
- Affichage d'une note sous le champ de configuration des réservations simultanées.

### Réservations d'articles

- Affichage d'un message si l'article sélectionné n'est pas réservable (Un filtre sera ajouté dans une prochaine version)
- Amélioration de la gestion des collisions avec les réservations récurrentes
- Meilleure gestion des filtres dans l'API `_get_events`

### Modèles d'abonnements

- Ajout d'une option pour permettre l'annulation automatique de l'abonnement à la fin de la première période d'abonnement

### Demande de matériel

- Nouvelle option pour permettre de faire directement un transfert de stock en transit depuis les demandes de matériel. :br
  👉 [ERPNext](https://github.com/frappe/erpnext/pull/34061){rel="&#x22;nofollow&#x22;"}


# v3.22.0

::callout
La version 3.22.0 de Dokos est basée sur la version 14 d'ERPNext
Une grande partie des changements cités ci-dessous ont été développés par l'équipe de Frappe Technologies et les contributeurs aux logiciels de l'éco-système Frappe/ERPNext
Le détail des changements publiés dans Dokos est disponible sur [Gitlab](https://gitlab.com/dokos/dokos/-/releases/v3.22.0){rel=""nofollow""}
::

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Cette page n'indique que les nouvelles fonctionnalités les plus importantes pour chaque module.
::

### Lieu

- Nouvelle option permettant d'ajouter automatiquement un profil de rôle à tous les utilisateurs liés à un client/fournisseur.
- Nouvelle option permettant de définir un rôle permettant aux utilisateurs de pouvoir réserver un créneau en ligne sans devoir passer par le panier. :br
  Cette option se configure dans les paramètres du lieu.

### Abonnements

- Ajout d'une section *Gestion du Lieu* dans les lignes des plans d'abonnement

### Stocks

- Utilisation de la librairie [`barcodenumber`](https://pypi.org/project/barcodenumber/){rel="&#x22;nofollow&#x22;"} pour la validation des codes barres dans les articles. :br
  Cette librairie permet de gérer plus de types de codes barres. :br
  👉 [ERPNext](https://github.com/frappe/erpnext/pull/33863){rel="&#x22;nofollow&#x22;"}
- Nouvelle option permettant de basculer d'un reposting des stocks par transaction à un reposting des stocks par entrepôt (+ rapide) :br
  👉 [ERPNext](https://github.com/frappe/erpnext/pull/34115){rel="&#x22;nofollow&#x22;"}

### Synchronisation bancaire

- Ajout d'un champ `type de transaction` dans les transactions bancaires.
- Mise à jour de l'intégration avec [Plaid](https://plaid.com/en-eu/){rel="&#x22;nofollow&#x22;"}:br
  👉 [ERPNext](https://github.com/frappe/erpnext/pull/33986){rel="&#x22;nofollow&#x22;"}


# v3.23.0

::callout
La version 3.23.0 de Dokos est basée sur la version 14 d'ERPNext
Une grande partie des changements cités ci-dessous ont été développés par l'équipe de Frappe Technologies et les contributeurs aux logiciels de l'éco-système Frappe/ERPNext
Le détail des changements publiés dans Dokos est disponible sur [Gitlab](https://gitlab.com/dokos/dokos/-/releases/v3.23.0){rel=""nofollow""}
::

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Cette page n'indique que les nouvelles fonctionnalités les plus importantes pour chaque module.
::

### Lieu

- Un bouton permet désormais d'ajouter automatiquement un champ personnalisé `role_profile_name` dans les fiches **Client**, **Fournisseur**, **Abonnement**, **Modèle d'abonnement**

### Site web

- Ajout d'un barre latérale proposant les dernières réservations sur la page de réservation en ligne `/book-resources`
- Si l'unité de mesure sélectionnée dans l'article de site web n'est pas convertissable en minutes, un message d'alerte apparaît sur le site e-commerce.
- La date de début du calendrier de réservation en ligne peut désormais être récupérée dans les paramètres de requêtes de la page.


# v3.24.0

::callout
La version 3.24.0 de Dokos est basée sur la version 14 d'ERPNext
Une grande partie des changements cités ci-dessous ont été développés par l'équipe de Frappe Technologies et les contributeurs aux logiciels de l'éco-système Frappe/ERPNext
Le détail des changements publiés dans Dokos est disponible sur [Gitlab](https://gitlab.com/dokos/dokos/-/releases/v3.24.0){rel=""nofollow""}
::

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Cette page n'indique que les nouvelles fonctionnalités les plus importantes pour chaque module.
::

### Lieu

- Il est désormais possible de définir un libellé personnalisé pour le menu de sélection du mode Multi-société disponible sur le site web.

### Site web

- Ajout d'un barre latérale proposant les dernières réservations sur la page de réservation en ligne `/book-resources`
- Si l'unité de mesure sélectionnée dans l'article de site web n'est pas convertissable en minutes, un message d'alerte apparaît sur le site e-commerce.
- La date de début du calendrier de réservation en ligne peut désormais être récupérée dans les paramètres de requêtes de la page.

### Stocks

- Le champ `Est un article en stock` est désormais décoché par défaut sur tous les sites.


# v3.25.0

::callout
La version 3.25.0 de Dokos est basée sur la version 14 d'ERPNext
Une grande partie des changements cités ci-dessous ont été développés par l'équipe de Frappe Technologies et les contributeurs aux logiciels de l'éco-système Frappe/ERPNext
Le détail des changements publiés dans Dokos est disponible sur [Gitlab](https://gitlab.com/dokos/dokos/-/releases/v3.25.0){rel=""nofollow""}
::

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Cette page n'indique que les nouvelles fonctionnalités les plus importantes pour chaque module.
::

### Achats

- Il est désormais possible d'utiliser le prix d'achat des factures d'achat pour calculer les réintégrations de frais à l'arrivée (via les paramètres des achats). :br
  👉 [ERPNext](https://github.com/frappe/erpnext/pull/34235){rel="&#x22;nofollow&#x22;"}

### Site web

- Ajout d'un bouton *Retour* sur les pages des articles pour revenir sur la page de réservation globale.

### Docker

- Des images Docker sont désormais générées automatiquement pour chaque nouvelle version de Dokos


# v3.26.0

::callout
La version 3.26.0 de Dokos est basée sur la version 14 d'ERPNext
Une grande partie des changements cités ci-dessous ont été développés par l'équipe de Frappe Technologies et les contributeurs aux logiciels de l'éco-système Frappe/ERPNext
Le détail des changements publiés dans Dokos est disponible sur [Gitlab](https://gitlab.com/dokos/dokos/-/releases/v3.26.0){rel=""nofollow""}
::

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Cette page n'indique que les nouvelles fonctionnalités les plus importantes pour chaque module.
::

### Devis

- Il est désormais possible de proposer des options dans les devis :br
  👉 [ERPNext](https://github.com/frappe/erpnext/pull/33874){rel="&#x22;nofollow&#x22;"}

### Articles

- Ajout d'un texte d'aide sous le champ `description` dans la fiche Article

### Site web

- Amélioration de la page `book-resources`

### Intégration continue

- Il est désormais possible de déclencher la pipeline Gitlab d'intégration continue pour une branche spécifique de Dodock

> Ex. `[dodock-branch=fix-set-monday-as-first-day-of-the-week]`


# v3.27.0

::callout
La version 3.27.0 de Dokos est basée sur la version 14 d'ERPNext
Une grande partie des changements cités ci-dessous ont été développés par l'équipe de Frappe Technologies et les contributeurs aux logiciels de l'éco-système Frappe/ERPNext
Le détail des changements publiés dans Dokos est disponible sur [Gitlab](https://gitlab.com/dokos/dokos/-/releases/v3.27.0){rel=""nofollow""}
::

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Cette page n'indique que les nouvelles fonctionnalités les plus importantes pour chaque module.
::

### Déclaration de TVA (France)

- Le rapport *Préparation à la déclaration de TVA* a été amélioré pour mieux prendre en compte les écritures de journal et certains cas d'usage du tableau de taxes et frais (ventes/achats)


# v3.28.0

::callout
La version 3.28.0 de Dokos est basée sur la version 14 d'ERPNext
Une grande partie des changements cités ci-dessous ont été développés par l'équipe de Frappe Technologies et les contributeurs aux logiciels de l'éco-système Frappe/ERPNext
Le détail des changements publiés dans Dokos est disponible sur [Gitlab](https://gitlab.com/dokos/dokos/-/releases/v3.28.0){rel=""nofollow""}
::

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Cette page n'indique que les nouvelles fonctionnalités les plus importantes pour chaque module.
::

### Crédits de réservation

- Refonte du système de gestion des crédits de réservation :br
  👉 [Documentation](https://doc.dokos.io/v5/dokos/lieu/credit-reservation)

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Un patch de migration permet de migrer les soldes de l'ancien système vers le nouveau. :br
Cependant les règles d'allocation récurrentes ne peuvent être migrées. :br
Si vous aviez des règles d'allocation récurrentes, vous pouvez les adapter pour les ajouter dans les abonnements de vos clients.
::

- Nouveau rapport **Solde de crédits de réservation**

### Site web

- Nouvelle page `/checkout` pour la finalisation du panier.
  Dans certains cas, comme les achats via crédits de réservation, le passage de commande n'est plus nécessaire et les utilisateurs peuvent simplement valider leur sélection sans finaliser une commande.
- Le nombre de crédits correspondant à une réservation est désormais indiqué sur les pages de sélection des articles sur le site web. :br
  Seuls les utilisateurs disposant de crédits peuvent voir la correspondance.
- Refonte de la barre latérale dans les portails utilisateur.

### Découverte des documents

- Ajout de *Tours* pour les types de documents suivants:


  - Abonnement
  - Type de crédit de réservation
  - Addition de crédits de réservation
  - Déduction de crédit de réservation


# v3.29.0

::callout
La version 3.29.0 de Dokos est basée sur la version 14 d'ERPNext
Une grande partie des changements cités ci-dessous ont été développés par l'équipe de Frappe Technologies et les contributeurs aux logiciels de l'éco-système Frappe/ERPNext
Le détail des changements publiés dans Dokos est disponible sur [Gitlab](https://gitlab.com/dokos/dokos/-/releases/v3.29.0){rel=""nofollow""}
::

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Cette page n'indique que les nouvelles fonctionnalités les plus importantes pour chaque module.
::

### Lieu

- Nouvel outil de configuration des calendriers dans le type de document **Calendrier de réservation d'articles**:br
  👉 [Dokos](https://gitlab.com/dokos/dokos/-/merge_requests/92){rel="&#x22;nofollow&#x22;"}

### Développeurs

- La méthode `erpnext.selling.doctype.customer.customer.get_customer_list` est dépréciée. :br
  Elle sera supprimée dans une prochaine version. :br
  👉 [ERPNext](https://github.com/frappe/erpnext/pull/34624){rel="&#x22;nofollow&#x22;"}


# v3.2.0

::callout
La version 3.2.0 de Dokos est basée sur la version 14 d'ERPNext
Une grande partie des changements cités ci-dessous ont été développés par l'équipe de Frappe Technologies et les contributeurs aux logiciels de l'éco-système Frappe/ERPNext
Le détail des changements publiés dans Dokos est disponible sur [Gitlab](https://gitlab.com/dokos/dokos/-/releases/v3.2.0){rel=""nofollow""}
::

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Cette page n'indique que les nouvelles fonctionnalités les plus importantes pour chaque module.
::

### Gestion de stocks

- Un indicateur auditif indique le statut d'un scan de code barre :br
  👉 [ERPNext](https://github.com/frappe/erpnext/pull/32245){rel="&#x22;nofollow&#x22;"}


# v3.30.0

::callout
La version 3.30.0 de Dokos est basée sur la version 14 d'ERPNext
Une grande partie des changements cités ci-dessous ont été développés par l'équipe de Frappe Technologies et les contributeurs aux logiciels de l'éco-système Frappe/ERPNext
Le détail des changements publiés dans Dokos est disponible sur [Gitlab](https://gitlab.com/dokos/dokos/-/releases/v3.30.0){rel=""nofollow""}
::

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Cette page n'indique que les nouvelles fonctionnalités les plus importantes pour chaque module.
::

### Inscriptions aux événements

- Ajout d'un case à cocher pour permettre les inscriptions multiples à un événement par un même utilisateur. :br
  👉 [Dokos](https://gitlab.com/dokos/dokos/-/merge_requests/94){rel="&#x22;nofollow&#x22;"}

### Comptabilité

- Un message alerte apparaît désormais lorsqu'une écriture de journal contient plusieurs lignes associées à des journaux différents.

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Dans la prochaine version majeure, il ne sera plus possible que de créer une écriture de journal par journal comptable pour éviter les erreurs de saisie.
::


# v3.31.0

::callout
La version 3.31.0 de Dokos est basée sur la version 14 d'ERPNext
Une grande partie des changements cités ci-dessous ont été développés par l'équipe de Frappe Technologies et les contributeurs aux logiciels de l'éco-système Frappe/ERPNext
Le détail des changements publiés dans Dokos est disponible sur [Gitlab](https://gitlab.com/dokos/dokos/-/releases/v3.31.0){rel=""nofollow""}
::

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Cette page n'indique que les nouvelles fonctionnalités les plus importantes pour chaque module.
::

### Achats

- Nouveaux espaces de travail pour les achats
- Nouvelles cartes statistiques et nouveaux graphiques
  👉 [Dokos](https://gitlab.com/dokos/dokos/-/merge_requests/88){rel="&#x22;nofollow&#x22;"}

### Taxes et frais

- Lorsque la ligne de référence n'est pas la ligne précédente, le libellé du champ est automatiquement ajusté
  👉 [Dokos](https://gitlab.com/dokos/dokos/-/merge_requests/99){rel="&#x22;nofollow&#x22;"}


# v3.32.0

::callout
La version 3.32.0 de Dokos est basée sur la version 14 d'ERPNext
Une grande partie des changements cités ci-dessous ont été développés par l'équipe de Frappe Technologies et les contributeurs aux logiciels de l'éco-système Frappe/ERPNext
Le détail des changements publiés dans Dokos est disponible sur [Gitlab](https://gitlab.com/dokos/dokos/-/releases/v3.32.0){rel=""nofollow""}
::

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Cette page n'indique que les nouvelles fonctionnalités les plus importantes pour chaque module.
::

### Frais de livraison

- Nouvelles option pour le détermination des frais de livraison:


  - Via une formule personnalisée
  - Via un `hook` (pour les développeurs d'application) :br
    👉 [Dokos](https://gitlab.com/dokos/dokos/-/merge_requests/95){rel="&#x22;nofollow&#x22;"}

### Panier (ECommerce)

- Amélioration de la fonctionnalité de sélection d'adresses
- Correction du fonctionnement des codes promotionnels

### Re-comptabilisation des stocks

- Option permettant d'envoyer les notifications de tentatives de re-comptabilisations aux personnes ayant un rôle spécifique :br
  👉 [ERPNext](https://github.com/frappe/erpnext/pull/35161){rel="&#x22;nofollow&#x22;"}

### Gestion de stock

- Dans les fiches d'inventaire, la quantité correspondant aux matières première associées à un plan de production sont désormais réservées
  👉 [ERPNext](https://github.com/frappe/erpnext/pull/35144){rel="&#x22;nofollow&#x22;"}

### Ventes

- Nouveaux espaces de travail pour les ventes :br
  👉 [Dokos](https://gitlab.com/dokos/dokos/-/merge_requests/113){rel="&#x22;nofollow&#x22;"}


# v3.33.0

::callout
La version 3.33.0 de Dokos est basée sur la version 14 d'ERPNext
Une grande partie des changements cités ci-dessous ont été développés par l'équipe de Frappe Technologies et les contributeurs aux logiciels de l'éco-système Frappe/ERPNext
Le détail des changements publiés dans Dokos est disponible sur [Gitlab](https://gitlab.com/dokos/dokos/-/releases/v3.33.0){rel=""nofollow""}
::

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Cette page n'indique que les nouvelles fonctionnalités les plus importantes pour chaque module.
::

### Points de collecte

- Nouvelles option permettant d'associer une règle de livraison à des points de collecte :br
  👉 [Dokos](https://gitlab.com/dokos/dokos/-/merge_requests/114){rel="&#x22;nofollow&#x22;"}

### Paiements en ligne

- Si le paiement en ligne est activé, le système redirigera désormais vos clients directement vers la page de paiement à la validation de la commande

### Production

- Lorsque des éléments de sous-assemblages sont déjà disponible ou vont bientôt être disponibles, vous pouvez désormais décider de ne pas réserver les matières premières correspondant à ces sous-assemblage dans vos plans de production. :br
  👉 [ERPNext](https://github.com/frappe/erpnext/pull/35381){rel="&#x22;nofollow&#x22;"}

### Gestion de stocks

- Il est désormais possible de lancer une re-comptabilisation des stocks depuis le rapport **Comparaison entre les stocks et la comptabilité**
  👉 [ERPNext](https://github.com/frappe/erpnext/pull/35365){rel="&#x22;nofollow&#x22;"}

### Dimensions comptables

- Il est désormais possible de définir des conditions pour rendre une dimension comptable obligatoire dans les documents
  👉 [ERPNext](https://github.com/frappe/erpnext/pull/33896){rel="&#x22;nofollow&#x22;"}

### Gestion de projets

- Le projet est désormais récupéré depuis une feuille de temps, lorsque celle-ci est importée dans une facture :br
  👉 [ERPNext](https://github.com/frappe/erpnext/pull/35146){rel="&#x22;nofollow&#x22;"}

### Développeurs

- Ajout d'une option de formatage automatique des fichiers JSON dans pre-commit


# v3.34.0

::callout
La version 3.34.0 de Dokos est basée sur la version 14 d'ERPNext
Une grande partie des changements cités ci-dessous ont été développés par l'équipe de Frappe Technologies et les contributeurs aux logiciels de l'éco-système Frappe/ERPNext
Le détail des changements publiés dans Dokos est disponible sur [Gitlab](https://gitlab.com/dokos/dokos/-/releases/v3.34.0){rel=""nofollow""}
::

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Cette page n'indique que les nouvelles fonctionnalités les plus importantes pour chaque module.
::

### Journaux comptables

- Les journaux comptables récupérés pour les documents de facturation et de paiement sont désormais affichés explicitement dans un champ dédié :br
  Dans les écritures de journal, le journal comptable configuré par défaut est de ce fait proposé et peut ensuite être modifié

### Plans comptables

- Ajout du plan comptable Portugais SNC
  👉 [ERPNext](https://github.com/frappe/erpnext/pull/35486){rel="&#x22;nofollow&#x22;"}

### Panier

- Le formulaire d'ajout d'une nouvelle adresse dans le panier peut désormais être personnalisé depuis les **Paramètres E-Commerce**:br
  👉 [Dokos](https://gitlab.com/dokos/dokos/-/merge_requests/118){rel="&#x22;nofollow&#x22;"}
- Ajout de la possibilité d'ajouter des blocs web personnalisés dans le panier :br
  👉 [Dokos](https://gitlab.com/dokos/dokos/-/merge_requests/117){rel="&#x22;nofollow&#x22;"}
- Ajout d'un modèle de bloc web pour les achats groupés :br
  👉 [Dokos](https://gitlab.com/dokos/dokos/-/merge_requests/117){rel="&#x22;nofollow&#x22;"}

### Finance

- Création d'un nouvel espace de travail **Finance**, regroupant les sous-espaces de travail **Comptabilité**, **Flux de Trésorerie**, **Budgets et Analytique** et **Taxes**
- Nouveau graphique du tableau de bord **Solde du relevé bancaire**

### Gestion des actions

- Nouvelles cartes statistiques pour la gestion des actions


# v3.35.0

::callout
La version 3.35.0 de Dokos est basée sur la version 14 d'ERPNext
Une grande partie des changements cités ci-dessous ont été développés par l'équipe de Frappe Technologies et les contributeurs aux logiciels de l'éco-système Frappe/ERPNext
Le détail des changements publiés dans Dokos est disponible sur [Gitlab](https://gitlab.com/dokos/dokos/-/releases/v3.35.0){rel=""nofollow""}
::

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Cette page n'indique que les nouvelles fonctionnalités les plus importantes pour chaque module.
::

### Gestion d'un lieu

- Il est désormais possible de configurer les conversions d'unités de mesure de temps (Demi-journée, Journée, etc...) directement depuis le document **Paramètres du lieu**

### Profils de rôles

- Des profils de rôles par défaut sont désormais créés sur les nouveaux sites
  👉 [ERPNext](https://github.com/frappe/erpnext/pull/35584){rel="&#x22;nofollow&#x22;"}

### Finance

- De nouveaux graphiques (**Produits principaux** / **Charges principales**) ont été ajoutés à l'espace de travail **Finance**
  👉 [Dokos](https://gitlab.com/dokos/dokos/-/merge_requests/118){rel="&#x22;nofollow&#x22;"}


# v3.3.0

::callout
La version 3.3.0 de Dokos est basée sur la version 14 d'ERPNext
Une grande partie des changements cités ci-dessous ont été développés par l'équipe de Frappe Technologies et les contributeurs aux logiciels de l'éco-système Frappe/ERPNext
Le détail des changements publiés dans Dokos est disponible sur [Gitlab](https://gitlab.com/dokos/dokos/-/releases/v3.3.0){rel=""nofollow""}
::

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Cette page n'indique que les nouvelles fonctionnalités les plus importantes pour chaque module.
::

### Ecritures de journal

- Lors de récupération de la valeur d'un champ provenant d'un modèle, les logiques clients/serveur sont déclenchées :br
  👉 [ERPNext](https://github.com/frappe/erpnext/pull/32478){rel="&#x22;nofollow&#x22;"}

### Interface

- Amélioration des pages du portail utilisateur


# v3.4.0

::callout
La version 3.4.0 de Dokos est basée sur la version 14 d'ERPNext
Une grande partie des changements cités ci-dessous ont été développés par l'équipe de Frappe Technologies et les contributeurs aux logiciels de l'éco-système Frappe/ERPNext
Le détail des changements publiés dans Dokos est disponible sur [Gitlab](https://gitlab.com/dokos/dokos/-/releases/v3.4.0){rel=""nofollow""}
::

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Cette page n'indique que les nouvelles fonctionnalités les plus importantes pour chaque module.
::

### Production

- Une nouvelle option permet de retransférer les composants non consommés liés à un ordre de travail :br
  👉 [ERPNext](https://github.com/frappe/erpnext/pull/32393){rel="&#x22;nofollow&#x22;"}


# v3.5.0

::callout
La version 3.5.0 de Dokos est basée sur la version 14 d'ERPNext
Une grande partie des changements cités ci-dessous ont été développés par l'équipe de Frappe Technologies et les contributeurs aux logiciels de l'éco-système Frappe/ERPNext
Le détail des changements publiés dans Dokos est disponible sur [Gitlab](https://gitlab.com/dokos/dokos/-/releases/v3.5.0){rel=""nofollow""}
::

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Cette page n'indique que les nouvelles fonctionnalités les plus importantes pour chaque module.
::

### Paiements

- Nouveau rapport: Livre des paiements :br
  👉 [ERPNext](https://github.com/frappe/erpnext/pull/32651){rel="&#x22;nofollow&#x22;"}

### Bilan

- Lorsque l'on clique sur un compte client/fournisseur dans le bilan, on est automatiquement renvoyé vers les rapports *Comptes Clients*/*Comptes fournisseurs*:br
  👉 [ERPNext](https://github.com/frappe/erpnext/pull/32529){rel="&#x22;nofollow&#x22;"}

### Prêts

- Types de calendrier de remboursement pour les prêts à terme :br
  👉 [ERPNext](https://github.com/frappe/erpnext/pull/32424){rel="&#x22;nofollow&#x22;"}


# v3.6.0

::callout
La version 3.6.0 de Dokos est basée sur la version 14 d'ERPNext
Une grande partie des changements cités ci-dessous ont été développés par l'équipe de Frappe Technologies et les contributeurs aux logiciels de l'éco-système Frappe/ERPNext
Le détail des changements publiés dans Dokos est disponible sur [Gitlab](https://gitlab.com/dokos/dokos/-/releases/v3.6.0){rel=""nofollow""}
::

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Cette page n'indique que les nouvelles fonctionnalités les plus importantes pour chaque module.
::

### Règles de prix

- Nouvelles options de calcul des produits offerts: possibilité d'arrondir la quantité offerte et d'appliquer le calcul sur la base d'une quantité donnée.

> Ex. 1 produit gratuit pour 3 produits achetés :br
> 👉 [ERPNext](https://github.com/frappe/erpnext/pull/32577){rel="&#x22;nofollow&#x22;"}

### Situation de compte client

- Un saut de page a été ajouté entre chaque client lors de la génération d'un PDF consolidé. :br
  👉 [ERPNext](https://github.com/frappe/erpnext/pull/32620){rel="&#x22;nofollow&#x22;"}


# v3.7.0

::callout
La version 3.7.0 de Dokos est basée sur la version 14 d'ERPNext
Une grande partie des changements cités ci-dessous ont été développés par l'équipe de Frappe Technologies et les contributeurs aux logiciels de l'éco-système Frappe/ERPNext
Le détail des changements publiés dans Dokos est disponible sur [Gitlab](https://gitlab.com/dokos/dokos/-/releases/v3.7.0){rel=""nofollow""}
::

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Cette page n'indique que les nouvelles fonctionnalités les plus importantes pour chaque module.
::

### Espaces de travail

- Nouvel espace de travail pour les fonctionnalités E-Commerce

> Cet espace de travail étend l'espace de travail *Site Web*

### Plans comptables

- Nouveau plan comptable pour les micro-entreprises Hongroises :br
  👉 [ERPNext](https://github.com/frappe/erpnext/pull/32809){rel="&#x22;nofollow&#x22;"}

### TDS (Inde)

- Nouvelle fonctionnalité permettant le calcul du TDS par article :br
  👉 [ERPNext](https://github.com/frappe/erpnext/pull/32646){rel="&#x22;nofollow&#x22;"}


# v3.8.0

::callout
La version 3.8.0 de Dokos est basée sur la version 14 d'ERPNext
Une grande partie des changements cités ci-dessous ont été développés par l'équipe de Frappe Technologies et les contributeurs aux logiciels de l'éco-système Frappe/ERPNext
Le détail des changements publiés dans Dokos est disponible sur [Gitlab](https://gitlab.com/dokos/dokos/-/releases/v3.8.0){rel=""nofollow""}
::

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Cette page n'indique que les nouvelles fonctionnalités les plus importantes pour chaque module.
::

### Libellés comptables

- Le champ *Remarques* disponible dans les factures et utilisé comme libellé pour les écritures comptables a désormais les valeurs par défaut suivantes:

  - Factures de vente: Facture de vente: {Nom du document} / Client: {Nom du client}
  - Factures d'achat: Facture d'achat: {Nom du document} / Fournisseur: {Nom du client}
- Il est possible d'ajouter des variables en Jinja dans les remarques. Elles seront automatiquement interprétées au moment de la validation.

> Ex. &#x2A;Facture de vente: {{ doc.name }}*

- Il est également possible d'ajouter un champ **remarks** dans les lignes de facturation pour générer un libellé dans les écritures comptables correspondantes.
  Par défaut, le libellé sera: &#x2A;Article: {quantité} {code article} - {unité de mesure} / Client (Fournisseur): {nom du client ou du fournisseur}*

### Situation de compte client

- Ajout d'un filtre *Afficher les valeurs nettes dans le compte de tiers*:br
  👉 [ERPNext](https://github.com/frappe/erpnext/pull/32921){rel="&#x22;nofollow&#x22;"}


# v3.9.0

::callout
La version 3.9.0 de Dokos est basée sur la version 14 d'ERPNext
Une grande partie des changements cités ci-dessous ont été développés par l'équipe de Frappe Technologies et les contributeurs aux logiciels de l'éco-système Frappe/ERPNext
Le détail des changements publiés dans Dokos est disponible sur [Gitlab](https://gitlab.com/dokos/dokos/-/releases/v3.9.0){rel=""nofollow""}
::

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Cette page n'indique que les nouvelles fonctionnalités les plus importantes pour chaque module.
::

### Pistes

- Les pistes ne sont plus désactivées et basculées en lecture seule après la création d'une opportunité

### TDS (Inde)

- Calcul du TDS par article dans les commandes fournisseur :br
  👉 [ERPNext](https://github.com/frappe/erpnext/pull/33063){rel="&#x22;nofollow&#x22;"}


# V2.0.0

::callout
La version 2.0.0 de Dokos est basée sur la version 13 d'ERPNext
::

## Achats

- 🚁 Possibilité de comparer des devis fournisseurs
- 🚁 Scan de code-barres dans les reçus d'achat
- 🚁 Possibilité de gérer plusieurs unités de mesure dans les appels d'offres

Et aussi...

- (RFQ / SQ) Lien vers les demandes d'articles dans la section **Outils**
- Aperçu de l'e-mail du fournisseur dans la RFQ
- Correctifs UX des devis fournisseurs
- Lien entre la commande ouverte et les devis
- Case à cocher dans le document fournisseur pour permettre la création de la facture d'achat sans commande fournisseur
- Disposition pour faire une demande de devis contre une opportunité
- La marge sur la liste de prix est maintenant affichée dans les transactions d'achat
- Validation de base pour le n° PAN indien dans le fournisseur
- L'unité de mesure du taux de stock est désormais synchronisée dans les transactions d'achat

## Comptabilité

- 🚀 Grand livre inaltérable: les écritures du grand livre ne peuvent plus êtes supprimées
- 🚀 Affichage du bilan comptable selon les standards français pour les sociétés françaises
- ✈️ Déduction automatique de la TVA pour les paiements GoCardless
- ✈️ Répartition des paiements en fonctions des termes des paiements dans les factures
- ✈️ Possibilité d’ajouter et de configurer des journaux comptables pour chaque type de document
- ✈️ Le nommage automatique par défaut des écritures de grand livre a été modifié pour être basé sur l'exercice fiscal
- ✈️ Nouvelle fonction permettant de créer des centres de coûts distribués
- ✈️ Ajout d'une option **facture d'acompte** dans les options de facturation
- 🚁 Fonction d'ajustement des journaux comptables pour les transactions associées à des écritures comptables
- 🚁 Nouveau rapport calculant le revenu mensuel récurrent (MRR)
- 🚁 Validation et mise à jour des comptes des filiales lors du changement du nom / ajout d'un compte.
- 🚁 En mode multi-sociétés, si un compte est renommé, cela renomme également le compte correspondant pour la filiale.
- 🚁 Possibilités de grouper par clients ou fournisseurs au sein des rapports de comptes débiteurs / créditeurs
- 🚁 Possibilité de créer des modèles d'écritures de journal
- 🚁 Un compte par défaut est désormais configurable pour les écritures de virement interbancaire dans la page de la Société
- 🚁 Nouvelle fonctionnalité de création de relances
- 🚁 Nouveau rapport permettant d'éditer les situation de compte clients
- 🚁 Nouveau rapport *Récapitulatif des taxes liées aux transactions*
- 🚁 Nouveau hook pour récupérer les dimensions comptables créées dans des applications personnalisées
- 🚁 Dimensions comptables configurables

Et aussi...

- Possibilité de définir manuellement une écriture de paiement ou une écriture de journal comme rapprochée
- Amélioration de l'importation des transactions bancaires OFX
- Colonnes masquées peuvent être ajoutées avec le numéro de compte dans les exportations CSV / XLSX
- Prélèvement SEPA dans l'espace de travail comptable
- Ajout de la colonne cost\_center dans les rapports **comptes débiteurs**
- Possibilité de mettre à jour l'intégration des comptes
- Changement technique pour gérer la création des factures d'ouverture
- Supprimer le type inutilisé: option "Général" supprimée en mode de paiement
- Mise à jour de l'intégration des comptes
- Ajouter une fonctionnalité de visite pour les paramètres de compte
- Nouveau champ de filtre dans le relevé des rapprochements bancaires
- Option ajoutée pour ajouter des remarques personnalisées dans l' écriture de paiement
- Ajouter un lien vers la facture finale dans la facture d'acompte
- Obtenir la prochaine date de facturation dans l'abonnement via la méthode **get\_next\_invoice\_date**
- Ajouter Résumé dans les rapports comptables
- Autoriser la sélection de la catégorie de retenue d'impôt aux factures
- Le changement de nom du centre de coûts doit être effectué via une boîte de dialogue dédiée
- Fonction pour ajouter une description dans les modèles de taxes qui seront récupérés dans les factures et affichés sur le format d'impression
- Les utilisateurs du rôle de contrôleur de crédit sont informés de l'extension de la limite de crédit
- Autoriser le changement de nom pour la catégorie de taxe

## CRM

- 🚁 Nouveau type de document vidéo
- 🚁 Intégration Youtube
- 🚁 Possibilité d'utiliser le language Jinja (variables) dans les modèles de contrat
- 🚁 Intégrations LinkedIn et Twitter

Et aussi...

- Calcul automatique du montant de l'opportunité lorsque des articles sont ajoutés
- L'état du prospect passe à Ouvert si le prochain contact est aujourd'hui
- Lien vers le client dans le journal des appels
- Ajout d'un champ de téléphone dans la demande de produit
- Vue du calendrier dans l'opportunité
- Les étapes de vente peuvent désormais être renommées
- Ajouter un langage d'impression au prospect et à l'opportunité
- CSS supplémentaire pour le doctype d'événement
- Doctype amélioré du journal des appels
- Nouveau doctype: Paramètres d'appel vocal

## Intégrations

- 🚀 Nouveau connecteur Woocommerce:

  - · Gestion du stock
  - · Gestion de la TVA et des frais divers
  - · Configuration automatique des Webhooks
  - · Factures de ventes, bons de livraisons et paiements créés automatiquement
- 🚁 Les paiements Stripe peuvent désormais être traités immédiatement depuis les demandes de paiement
- 🚁 Les Webhooks Stripe peuvent désormais être créés/supprimés directement depuis les paramètres Stripe
- 🚁 Les abonnements Stripe peuvent désormais être gérés directement par Dokos, sans avoir à créer des plans d'abonnement sur Stripe
- 🚁 Intégration avec TaxJar

Et aussi...

- L'API Razorpay a été modifiée pour utiliser l'API Python Razorpay au lieu de requêtes HTTP directes
- Possibilité de désactiver une passerelle de paiement
- Dodock utilise désormais une version plus récente de l'API Stripe (2.49.0)
- Intégration avec la passerelle de paiement Paytm
- Possibilité de lier un client Oauth2 générique
- Synchroniser les anciennes commandes Shopify
- Ajouter la gestion des statuts différents de WooCommerce + les frais de stripe dans le refactor d'intégration de Woocommerce
- Ajouter un espace de travail dans la page des intégrations
- Ajouter un espace de travail d'intégration à intégrer dans une catégorie plus globale "Nouveaux espaces de travail"
- Ajouter un champ de compte bancaire dans les paramètres GoCardless
- Possibilité de créer un élément de facture Stripe dans les plans d'abonnement
- Intégration WooCommerce refactorisée: l'adresse de livraison et le contact peuvent être enregistrés dans le client WooCommerce
- Numéro de demande de paiement ajouté aux métadonnées GoCardless
- Amélioration des recharges de prêt
- Fonctionnalité pour réassocier un compte bancaire avec Plaid lorsque le lien a expiré

## Impressions

- 🚁 Possibilité de définir de nouvelles options d'impression dans les documents transactionnels
- 🚁 Nouvelle option pour imprimer l'unité de mesure après la quantité

Et aussi...

- Nouveau style d'impression: Twenty Twenty
- État de chargement amélioré pour l'aperçu avant impression
- Les aperçus d'impression sont désormais rendus dans un iFrame pour éviter les conflits de style avec le site
- Disposition améliorée des colonnes au format d'impression
- Paramètre contextuel pour l'impression après la quantité
- Hook pour récupérer des paramètres d'impression supplémentaires dans le print\_controller

## Lieu

- 🚀 Nouveau module **Lieu**
- 🚁 Réservations d'articles
- 🚁 Crédits de réservations
- 🚁 Fonction permettant de créer des règles de crédit de réservation (automatisation de l'ajout / suppression de crédits de réservation)
- 🚁 Possibilité de confirmer une réservation d'article uniquement lorsque le paiement est traité
- 🚁 Possibilité de faire des réservations d'articles associées des événements
- 🚁 Inscriptions à des postes d'événements
- 🚁 Les dates de "Réservation d'articles" sont modifiées en fonction des modifications apportées aux événements

Et aussi...

- Nouvelle option pour décider jusqu'à quand une réservation d'article peut être annulée sur le portail
- Nouvelles options Premier jour de la semaine suivant et Premier jour du mois suivant dans la règle de date comptable de la règle de crédit de réservation d'article DocType
- Commutateur disponible dans les paramètres du lieu pour bloquer les chevauchements dans les réservations d'articles sur le bureau (cela a déjà été géré sur le portail)
- "Nouvelles règles d'expiration dans les règles de crédit de réservation d'articles pour gérer le cas suivant:


  - Dernier jour du mois
  - Dernier jour de l'année"
- Ne déduisez pas les crédits de réservation lorsque les règles de tarification sont appliquées
- Règles de crédit de réservation récurrente
- Nouvel outil pour lier les devis / commandes clients et les réservations d'articles
- Nouveau rapport: taux de réservation d'article

## Paie

- 🚀 Nouveau module de **Paie**
- 🚁 Paie calculée sur le centre de coûts des employés
- 🚁 Gestion du multi-devises

Et aussi...

- Dalle d'impôt sur le revenu
- Paie basée sur la fréquentation
- Doctype du certificat de déduction inférieure
- Ajout des détails du congé dans le bulletin de salaire
- Possibilité de calculer le cumul de l'année dans les composants de la fiche de salaire
- Possibilité de calculer le cumul de l'année dans les composants de la fiche de salaire

## Point de vente

- 🚀 Nouveau page pour un point de vente amélioré
- 🚁 Nouveau document intermédiaire: Facture de point de vente, consolidées en facture de vente une fois par jour
- 🚁 Les factures de point de vente sont scellées pour assurer la conformité avec la loi française

## Projets

- 🚁 Création de tâches dépendantes via les modèles de projets

Et aussi...

- Toutes les heures sont désormais facturées par défaut dans les feuilles de temps
- Tableau de bord pour la feuille de temps

## Prêts

- 🚀 Nouveau module de **gestion des prêts**
- 🚁 Tableau de bord des prêts

Et aussi...

- Fonction d'utilité pour obtenir un éventuel montant de décaissement du prêt
- Amélioration des recharges de prêt

## Production

- 🚁 Nouvelle fonction pour marquer les articles que le fournisseur doit se procurer dans les nomenclatures
- 🚁 Possibilité de planifer la production pour les commandes client / les demandes de matériel et les ordres de travail
- 🚁 Prévision de la production à l'aide de la méthode de lissage exponentiel
- 🚁 Possibilité de créer des modèles de nomenclature

Et aussi...

- Filtre de statut de la commande client ajouté pour le plan de production
- Possibilité d'ouvrir / fermer un plan de production
- ID de séquence ajouté dans le routage pour l'achèvement des opérations de manière séquentielle
- Autoriser la nomenclature à utiliser le même article que la matière première
- MRP au niveau des parents dans le plan de production

## Qualité

- 🚁 Possibilité de créer des documents d'inspection de la qualité liés aux cartes de travail
- 🚁 Possibilité d'ajouter des formules de calcul dans les documents d'inspection de la qualité
- 🚁 Les règles d'inspection de la qualité peuvent être basées sur des valeurs numériques ou libres

Et aussi...

- Introduire un groupe de paramètres dans l'inspection de la qualité

## Ressources humaines

- 🚁 Nouvelle fonction permettant d'allouer automatiquement des congés sur la base de la politique de congés
- 🚁 Les jours fériés français peuvent être automatiquement ajoutés à la liste des jours fériés pour le sociétés françaises
- 🚁 Nouvelle option dans les type de congé: congé partiellement payé
- 🚁 Nouveau type de document: Promesse d'embauche
- 🚁 Les entrées et les sorties des employées sont désormais ajoutées dans les documents de présence
- 🚁 L'approbateur des notes de frais peut être maintenant configuré par département

Et aussi...

- Nouvelle alerte pour informer le validateur qu'une note de frais sera soumise avec un montant sanctionné égal à 0
- Téléchargement JSON pour HSN sage résumé extérieur
- Ignorer la participation pour les vacances à partir du téléchargement de la participation
- Nouveaux rapports Solde des congés des employés
- Améliorations de la feuille de présence mensuelle
- Analyse des recrutements
- Ajouter une case à cocher pour désactiver la notification de congé dans les paramètres RH
- Le suivi de l'audit a été activé dans les paramètres RH

## Régional

- 🚁 Rapport de TVA 201 pour les Emirats Arabes Unis
- 🚁 E-facture pour l'Inde

Et aussi...

- Arrondi normal pour les taxes TPS
- Option permettant de configurer la longueur du numéro de compte pour le rapport DATEV
- Validation de l'exercice pour le rapport DATEV
- Ajouter un modèle d'adresse pour le Luxembourg
- Nouveau module régional pour la Turquie
- Les modèles d'adresses régionales sont désormais centralisés
- Nouvelle fonctionnalité pour ajouter un pourboire dans la paie pour l'Inde et les EAU
- Supprimer la validation de la facture de vente allemande
- Temporaire contre compte dans le rapport DATEV
- Arbre d'équité séparé dans CoA SKR04

## Stocks

- 🚁 Nouveau type de document Envoi dans lequel on peut configurer les paramètres d'envoi des colis

  - · Ouvre la voie à l'intégration avec des passerelles d'envoi de colis
- 🚁 Affichage du solde de chaque N° de série dans le livre d'inventaire
- 🚁 Nouvelle fonction permettan d'assigner des règles d'affectation automatique à un entrepot
- 🚁 Suivi des retours amélioré pour les reçus d'achat / bons de livraison
- 🚁 Nouveau rapport de quantité de stock vs décompte de numéro de série
- 🚁 Gestion du multi devises dans les réintégrations de frais à l'arrivée
- 🚁 Amélioration du système de recalcul des valorisation de stock

Et aussi...

- Valider si les attributs d'éléments supprimés existent dans les variantes
- Nouvelle règle pour interroger les entrepôts: trier les entrepôts en fonction de la quantité d'articles de manière décroissante
- Demande de matériel et amélioration de la saisie de stock
- Transfert de stock inter-entrepôts sur taux de valorisation avec imposition
- Définir automatiquement le numéro de lot sur la série pas de sélection
- Quantité totale et tableau de bord ajoutés à Batch
- Afficher la quantité réelle pour l'entrepôt dans la facture de vente
- L'inventaire perpétuel est désormais désactivé par défaut

## Support

- 🚁 Nouveau rapport: Analyse des tickets de support
- 🚁 Nouveau rapport: Récapitulatif des tickets de support

Et aussi...

- Les clients désactivés ne sont plus sélectionnés dans le fichier doctype dans le champ client
- Ajout de la recherche à la page d'assistance
- Mesures des problèmes et améliorations des SLA

## Téléphonie

- 🚁 Nouveau module **Téléphonie** (module technique)

## Ventes

- 🚁 Possibilité de définir un contact comme contact de facturation dans les contacts
- 🚁 Possibilités d'ajouter des conditions dans les Règles de prix
- 🚁 Possibilité de configurer des remises sur les paiements anticipés
- 🚁 Règles de prix récursives (1 acheté 1 gratuit, 2 acheté 2 gratuits, etc...)
- 🚁 Possibilité de récupérer des feuilles de temps à partir des factures de vente

Et aussi...

- Projet ajouté dans le rapport d'analyse des ventes
- L'objet de la demande de paiement est maintenant affiché sur le portail de paiement
- Activer la ligne totale dans le rapport sur les bénéfices bruts
- Ajouter un lien Visite de maintenance dans les tableaux de bord Client et Commande client
- Territory Wise Treeview dans le rapport "Acquisition de clients et fidélisation"
- La marge brute est désormais calculée dans les éléments de campagne de devis

## Site web et portail

- 🚁 Nouvelle page de support sur le site Web
- 🚁 Nouveau portail pour la gestion des abonnements
- 🚁 Nouveau thème standard appelé Dokos
- 🚁 Nouvelle page de *panier*

Et aussi...

- Amélioration de l'interface utilisateur du portail
- La réservation d'article peut être supprimée directement du calendrier du portail avant de valider le panier
- Autoriser l'accès des utilisateurs système au portail
- Améliorations de la page du panier
- API pour renvoyer le résultat d'un document créé par un formulaire Web au formulaire Web pour un traitement ultérieur
- Possibilité de définir des conditions sur les champs de formulaire Web pour gérer leur affichage
- Option pour anonymiser l'IP pour Google Analytics
- Mettre à jour la disposition et le doctype pour les paramètres à propos de nous
- Lorsque des messages d'erreur sont affichés sur le site Web, la trace de la pile est maintenant masquée par défaut
- Page de connexion refactorisée: Ajouter des options sociales à la conception de la connexion
- Améliorations du site Web
- Nouveau module de modèle Web pour pouvoir créer des modèles Web à utiliser dans les pages Web
- Ajoutez des routes dynamiques à la page Web
- Option pour définir une page d'inscription personnalisée
- Amélioration de l'interface utilisateur du portail et du site Web
- Nouveau portail pour voir les détails de l'événement
- Nouvelle option pour ajouter un bouton d'actions d'en-tête personnalisé dans les listes de portail
- Ajouter une page d'accueil au site Web
- Mineur: autoriser le formulaire Web à suivre les autorisations du document
- Option de donner un commentaire sur les articles d'aide
- Ajouter la balise H1 aux pages À propos et Contact pour le référencement
- Amélioration du référencement du site: ajout d'un lien principal canonique pour le référencement
- La bibliothèque Unicons est désormais disponible sur le site
- Nouvelle mise en page pour la page de documentation sur le site Web
- Améliorer le fil d'Ariane et la description de la recherche sur le site Web
- Rendre le logo facultatif dans le témoignage
- JS et CSS personnalisés peuvent désormais être ajoutés aux formulaires Web
- Intégration avec Google Indexing API
- Il est désormais possible d'activer / désactiver les commentaires sur le blog
- Le suivi du site Web est maintenant intégré
- Les éléments de la barre latérale du portail sont maintenant ajoutés à la barre de navigation mobile
- Option d'aperçu de la recherche Google dans le blog
- Partage sur les réseaux sociaux dans les articles de blog
- Mettre à jour l'avatar sur la barre de navigation du site Web


# V2.10.0

::callout
La version 2.10 de Dokos est basée sur la version 13 d'ERPNext :br
Le détail des changements publiés dans Dokos est disponible sur [Gitlab](https://gitlab.com/dokos/dokos/-/releases){rel=""nofollow""}
::

## Réservations d'article

- 🚀 Ajout d'un indicateur affichant le nombre de réservations simultanées encore disponibles pour un article et un créneau horaire donné


# V2.11.0

::callout
La version 2.11 de Dokos est basée sur la version 13 d'ERPNext :br
Le détail des changements publiés dans Dokos est disponible sur [Gitlab](https://gitlab.com/dokos/dokos/-/releases){rel=""nofollow""}
::

## Ventes/Achats

- 🚀 Ajout d'une option dans les paramètres de comptabilité pour définir un délai de paiement par défaut pour tous les clients/fournisseurs.


# V2.12.0

::callout
La version 2.12 de Dokos est basée sur la version 13 d'ERPNext :br
Le détail des changements publiés dans Dokos est disponible sur [Gitlab](https://gitlab.com/dokos/dokos/-/releases){rel=""nofollow""}
::

## Projets

- 🚀 Ajout du nom du projet à côté de son identifiant dans tous les champs de type *Lien*

## Abonnements

- 🚀 Création d'un statut **Abonné** pour les clients associés à un abonnement en cours


# V2.13.0

::callout
La version 2.13 de Dokos est basée sur la version 13 d'ERPNext :br
Le détail des changements publiés dans Dokos est disponible sur [Gitlab](https://gitlab.com/dokos/dokos/-/releases){rel=""nofollow""}
::

## Transactions bancaire

- 🚀 Création d'un nouveau type de document **Catégorie de transaction bancaire** pour permettre la catégorisation des transactions bancaires


# V2.14.0

::callout
La version 2.14 de Dokos est basée sur la version 13 d'ERPNext :br
Le détail des changements publiés dans Dokos est disponible sur [Gitlab](https://gitlab.com/dokos/dokos/-/releases){rel=""nofollow""}
::

## Transactions bancaire

- 🚀 Création d'un nouveau rapport **Catégories de transactions bancaires** accompagné de deux graphiques de tableau de bord.


# V2.15.0

::callout
La version 2.15 de Dokos est basée sur la version 13 d'ERPNext :br
Le détail des changements publiés dans Dokos est disponible sur [Gitlab](https://gitlab.com/dokos/dokos/-/releases){rel=""nofollow""}
::

## Panier

- 🚀 Lorsque le client n'a pas d'adresse enregistré, un popup s'ouvre désormais automatiquement au moment du passage de la commande au lieu d'un message d'erreur.


# V2.16.0

::callout
La version 2.16 de Dokos est basée sur la version 13 d'ERPNext :br
Le détail des changements publiés dans Dokos est disponible sur [Gitlab](https://gitlab.com/dokos/dokos/-/releases){rel=""nofollow""}
::

## Comptabilité

- 🚀 Ajout d'un champ **Numéro d'écriture comptable** dans les écritures de grand livre. Ce numéro est partagé avec toutes les écritures de grand livre liées au même document de référence et remplace l'identifiant de l'écriture de grand livre dans le FEC.


# V2.17.0

::callout
La version 2.17 de Dokos est basée sur la version 13 d'ERPNext :br
Le détail des changements publiés dans Dokos est disponible sur [Gitlab](https://gitlab.com/dokos/dokos/-/releases){rel=""nofollow""}
::

## Rapprochement bancaire

- 🚀 Le système de rapprochement automatique permet désormais de rapprocher des paiements fournisseurs lorsque le numéro de facture fournisseur est saisi dans Dokos et disponible dans les références de la transaction bancaire


# V2.18.0

::callout
La version 2.18 de Dokos est basée sur la version 13 d'ERPNext :br
Le détail des changements publiés dans Dokos est disponible sur [Gitlab](https://gitlab.com/dokos/dokos/-/releases){rel=""nofollow""}
::

## Ecritures de journal

- 🚀 Possibilité de sélectionner un journal comptable au niveau de l'en-tête d'une écriture de journal. Celui-ci sera repris par défaut dans toutes les lignes de l'écriture de journal.


# V2.1.0

::callout
La version 2.1.0 de Dokos est basée sur la version 13 d'ERPNext
::

## Comptabilité

- 🚀 Nouvelle fonctionnalité pour générer des écritures d'ajustement de clôture (produits différés / charges différées)

## Achats

- 🚀 Nouveau champ avec le total stock disponible dans les commandes fournisseurs
- 🚀 Possibilité de créer des reçus d'achat à partir des factures d'achat
- 🚁 Possibilité de configurer une action lorsque le taux de vente ou le taux d'achat n'est pas maintenu

## Ressources humaines

- 🚀 Partager le document avec les approbateurs des employés même s'ils n'ont pas l'accès au document.
- 🚀 Nouvelle fonctionnalité pour créer un type d'utilisateur spécifique uniquement pour les employés qui doivent accéder au système uniquement pour utiliser la partie RH.
- 🚁 Nouveau document pour les références des employés

## Projets

- 🚀 Nouveau rapport: Rentabilité d'un projet
- 🚀 Nouveau rapport: Heures utilisées par les employés
- 🚁 Nouveau rapport: Récapitulatif des tâches retardées

## Régional

- 🚁 Possibilité de générer des factures électroniques en masse pour l'Inde
- 🚁 Nouveau champ pour le type de document dans les factures électroniques pour l'Italie
- 🚁 Améliorations des fonctionnalités de la facture électronique en Inde: calcul automatique de la distance pour les générations de factures électroniques

## Ventes

- 🚁 Nouveau champ pour activer / désactiver le total arrondi dans les transactions de vente (auparavant, la seule option était au niveau du système)
- 🚁 Possibilité de configurer une action lorsque le taux de vente ou le taux d'achat n'est pas maintenu
- 🚁 Fonction pour réessayer de soumettre un document de fermeture de point de vente en cas d'échec

## Stocks

- 🚀 Ajout du champ des rôles autorisés dans les paramètres de compte et de stock pour la sur-facturation et la sur-livraison / réception respectivement.


# V2.2.0

::callout
La version 2.2.0 de Dokos est basée sur la version 13 d'ERPNext
::

## Ventes / Panier

🚀 La possibilité de lier un article à un modèle d'abonnement. Ce qui permet la :

- Création automatique d'un abonnement à partir d'une commande client
- Création automatique d'un abonnement à partir de l'ajout d'un article dans le panier du site web


# V2.3.0

::callout
La version 2.3 de Dokos est basée sur la version 13 d'ERPNext :br
Le détail des changements publiés dans Dokos est disponible sur [Gitlab](https://gitlab.com/dokos/dokos/-/releases){rel=""nofollow""}
::

## RH

- 🚀 Calendrier de planification de ressources
- 🚀 Détermination automatique des présences sur la base des affectations de quart


# V2.4.0

::callout
La version 2.4 de Dokos est basée sur la version 13 d'ERPNext :br
Le détail des changements publiés dans Dokos est disponible sur [Gitlab](https://gitlab.com/dokos/dokos/-/releases){rel=""nofollow""}
::

## Comptabilité

- 🚀 Il est désormais possible de restreindre les modèles de taxe d'article à certains types de transaction (Achats/Ventes)


# V2.5.0

::callout
La version 2.5 de Dokos est basée sur la version 13 d'ERPNext :br
Le détail des changements publiés dans Dokos est disponible sur [Gitlab](https://gitlab.com/dokos/dokos/-/releases){rel=""nofollow""}
::

## Abonnements

- 🚀 Un bouton dans les abonnements permet désormais de lier a posteriori une facture déjà validée avec un abonnement


# V2.6.0

::callout
La version 2.6 de Dokos est basée sur la version 13 d'ERPNext :br
Le détail des changements publiés dans Dokos est disponible sur [Gitlab](https://gitlab.com/dokos/dokos/-/releases){rel=""nofollow""}
::

## Abonnements

- 🚀 Il est désormais possible de configurer un modèle d'email utilisé pour générer une demande de paiement et le modèle de passerelles de paiement à utiliser dans les abonnements


# V2.7.0

::callout
La version 2.7 de Dokos est basée sur la version 13 d'ERPNext :br
Le détail des changements publiés dans Dokos est disponible sur [Gitlab](https://gitlab.com/dokos/dokos/-/releases){rel=""nofollow""}
::

## Demandes de paiement

- 🚀 Une nouvelle variable `payment_can_be_processed_immediately` est désormais disponible dans les messages des demandes de paiement. Elle peut être utilisée dans les modèles d'email.


# V2.8.0

::callout
La version 2.7 de Dokos est basée sur la version 13 d'ERPNext :br
Le détail des changements publiés dans Dokos est disponible sur [Gitlab](https://gitlab.com/dokos/dokos/-/releases){rel=""nofollow""}
::

## Abonnements

- 🚀 Amélioration du flux de création et d'envoi d'une demande de paiement depuis un abonnement


# V2.9.0

::callout
La version 2.9 de Dokos est basée sur la version 13 d'ERPNext :br
Le détail des changements publiés dans Dokos est disponible sur [Gitlab](https://gitlab.com/dokos/dokos/-/releases){rel=""nofollow""}
::

## Rapprochement bancaire

- 🚀 Amélioration de l'outil de rapprochement automatique
- 🚀 Développement d'un outil de rapprochement automatique pour les transactions de GoCardless
- 🚀 Fusion de l'outil de rapprochement automatique des transactions Stripe avec les autres options de rapprochement automatique pour avoir un bouton unique


# V1.0.0

🎉 Lire [l'article de blog](https://dokos.io/blog/dokos-nouvel-erp-open-source){rel="&#x22;nofollow&#x22;"} 🎉

La v1.0.0 de dokos est basée sur ERPNext v12.x.x
Vous trouverez ci-dessous les principales différences avec ERPNext.

- Les domaines suivants ne sont pas présent dans dokos:


  - Hospitalité
  - Santé
  - Education
  - À But Non Lucratif
  - Agriculture
- Le hub a été supprimé de dokos
- Les types de documents suivants ont été supprimé de dokos:


  - POS Settings (Paramètres du point de vente): Le point de vente hors ligne a été entièrement désactivé dans dokos
  - Cashier closing (Clôture du caissier)
  - Cashier closing payments (Paiements de clôture du caissier)
  - Bank Statement Settings (Paramètres de relevé bancaire)
  - Bank Statement Setting Item (Elément de paramètre de relevé bancaire)
  - Bank Statement Transaction Entry (Transaction bancaire)
  - Bank Statement Transaction Invoice Item (Poste de facture d'une transaction bancaire)
  - Bank Statement Transaction Payment Item (Poste de paiement d'une transaction bancaire)
  - Bank Statement Transaction Settings (Paramètre de transaction bancaire)
  - Bank Statement Transaction Settings Item (Paramètre de transaction bancaire)
  - Subscription Invoice (Facture d'abonnement)
  - Subscription Settings (Paramètres d'abonnement)
  - Subscriber (Abonné)
- Le point de vente hors ligne a été entièrement supprimé car il n'était pas conforme et reposait sur une solution de conservation des données non permanente (LocalStorage).
- La fonctionalité d'abonnement a été complètement refondue et il désormais possible de:


  - Générer une commande client avant la génération d'une facture de vente
  - Lier un abonnement avec un abonnement sur une passerelle de paiement et faire en sorte que son cycle de vie soit géré via les webhooks de cette plateforme
- Les intégration Stripe et GoCardless ont été refondues pour gérer les abonnements et générer des événements via les webhooks
- Un nouveau type de document **Prélèvement Sepa** permet de générer un fichier XML aux formats pain.008.001.02, pain.008.002.02 ou pain.008.003.02
- Vous pouvez désormais étendre la date de fin de validité de vos devis
- Les factures de ventes/factures d'achat/écritures de paiement n'obtiennent leur nom définitif qu'après validation. Cela résout un problème règlementaire que des utilisateurs pouvaient rencontrer dans certains pays.
- Un nouveau type de document **Réservation d'articles** permet d'ouvrir les réservations via votre portail pour vos clients.
- Refonte de la page &#x2A;*Profil (/me)** du portail pour intégrer un module de mise à jour des méthodes de paiement (Seul Stripe est compatible pour l'instant)


# V1.1.0

🎉 Lire [l'article de blog](https://dokos.io/blog/nouveautes-version-1-1){rel="&#x22;nofollow&#x22;"} 🎉

#### Fonctionnalités

- Possibilité de poser des demi-journées de congés
- Nouveaux paramètres pour les exports DATEV
- Possibilité de permettre des réservations d'articles simultanées
- La période avant suppression des réservations d'articles en brouillon est désormais configurable
- La liste des réservations d'articles par utilisateur est désormais disponible sur le portail
- Modèle d'adresse spécifique pour la France (Nouvelles installations seulement. Pour les installations existantes, voir la documentation)
- Possibilité de mettre des valeurs dynamiques (en Jinja) dans les modèles de contrats

#### Corrections de bug

- Problèmes d'autorisations pour les abonnements générés depuis les webhooks
- Bug lors de la récupération des informations des prospects dans les opportunités et devis
- Corrections pour le connecteur Shopify
- Problèmes avec les adresses dans le panier
- Addition de créneaux avec deux unités de mesures différentes dans le panier
- Traduction de "variant of" dans le panier
- Nouveau message "Veuillez sélectionner une unité de mesure" lorsqu'aucune n'est sélectionnée

#### Modifications

- Le message par défaut pour les demandes de paiement situé dans les comptes de passerelle de paiement a été remplacé par un modèle d'email dans les modèles de passerelles de paiement.


# V1.2.0

🎉 Lire [l'article de blog](https://dokos.io/blog/nouveautes-version-1-2){rel="&#x22;nofollow&#x22;"} 🎉

#### Fonctionnalités

- Format OFX pour les imports de transactions bancaires
- La clé de paiement est désormais générée avant la validation dans les demandes de paiement, permettant de voir le rendu du modèle de message avant envoi
- Le total net et le total TTC sont désormais simulés pour vous donner un aperçu des montants à facturer dans les abonnements
- Les paramètres d'actifs ont été supprimés. Ce paramètrage se fait désormais par société
- Les contenus des modèles de campagnes d'emailing sont désormais rendus pour une meilleure prévisualisation
- Les réservations d'articles peuvent désormais être synchronisées avec Google Agenda
- Les articles peuvent désormais être liés à un calendrier Google Agenda
- Des articles alternatifs sont désormais proposés si aucun créneau de réservation n'est disponible pour un article sur le portail
- Possibilité de dupliquer un projets avec ses tâches
- Possibilité de différencier les taux de change à l'achat et à la vente

#### Corrections de bug

- Amélioration de l'expérience utilisateur des demandes de paiement
- Amélioration du connecteur Woocommerce
- Amélioration des abonnements GoCardless
- Amélioration de la gestion des webhooks de paiement
- Amélioration du connecteur Shopify
- Amélioration des fiches employés et des notes de frais
- Amélioration de l'outil de mise à jour des listes de matériaux
- Amélioration du plan de production


# V1.3.0

🎉 Lire [l'article de blog](https://dokos.io/blog/nouveautes-version-1-3){rel="&#x22;nofollow&#x22;"} 🎉

#### Fonctionnalités

- Refonte du flux de création d'actifs
- Outil de prise de rendez-vous dans le CRM
- Nouvelle API pour la création de clients Stripe
- Possibilité de filtrer le rapport "Comptes créditeurs" par termes de paiement
- Addition des données de base dans le fichier zip DATEV [Allemagne]
- Taxe par article par code HSN [Inde]
- La recherche de produits sur le site web inclus désormais les champs de métadonnées
- Nouveau rapport permettant de comparer les valeurs d'inventaire et comptable
- Nouveau tableau de bord de rapprochement bancaire
- Nouveau hook `auto_reconciliation_methods` pour les méthodes de rapprochement automatiques personnalisées
- Le type de document **Rapprochement bancaire** a été renommé **Date de rapprochement bancaire**
- Rapprochement automatique par numéro ESR [Suisse]
- Gestion des remboursements d'avances versées aux employés
- Facturation électronique pour l'Italie
- Possibilité d'ajouter des champs personnalisés dans le point de vente
- Possibilité de créer des lignes d'abonnement avec date de début et date de fin
- Récapitulatif d'activité dans les projets

#### Corrections de bugs majeurs

- Amélioration de la performance lors de la validation des factures
- Amélioration de l'expérience utilisateur dans les nomenclatures
- Correction de la valorisation des produits finis dans les reçus d'achat
- Les modèles de sujet sont désormais rendus correctement dans les campagnes d'emailing
- Correction des règles de tarification pour les devis fait à des prospects
- Amélioration de la gestion des abonnements avec Stripe et GoCardless


# V1.4.0

🎉 Lire [l'article de blog](https://dokos.io/blog/nouveautes-version-1-4){rel="&#x22;nofollow&#x22;"} 🎉

#### Nouvelles fonctionnalités

- Nouvelle option d'amortissement linéaire au prorata sur 360 jours pour les actifs
- La démo peut désormais être générée en français et en anglais

#### Corrections de bugs majeurs

- Corrrection dans la mise à jour automatique des abonnements lors d'un paiement Stripe ou GoCardless


# API

::swagger{app="dokos"}
::


# Gérer les factures fournisseurs e-invoice

Dokos permet de recevoir des factures fournisseurs électroniques (e-invoices) via une plateforme approuvée, et de les piloter jusqu'à leur intégration comptable. Chaque facture traverse un cycle de vie composé de statuts successifs, depuis la réception jusqu'au traitement final.

## Le cycle de vie d'une e-invoice

L'arrivée d'une e-invoice dans Dokos déclenche un cycle de vie automatique. La facture passe par une série de statuts dépendant des actions de validation effectuées par vos soins.

::mermaid
flowchart LR
A\[Réception] --> B\[En attente validation]
B --> C{Action utilisateur}
C -->|Validation| D\[Intégrée en facture]
C -->|Refus| E\[Refusée]
C -->|Ignorée| F\[Abandonnée]

::

### Statuts de cycle de vie

Les statuts principaux d'une e-invoice sont les suivants :

- **Réceptionnée** — La facture vient d'arriver via la plateforme approuvée et n'a pas encore été traitée.
- **En attente de validation** — La facture a été rattachée à une facture fournisseur existante ou en cours de création ; elle attend une action de votre part pour finaliser l'intégration.
- **Intégrée** — La facture est convertie en facture fournisseur Dokos et est disponible pour le traitement comptable.
- **Refusée** — La facture a été rejetée manuellement par l'utilisateur ; le motif du refus est transmis à la plateforme.
- **Abandonnée** — La facture a été ignorée sans action pendant la durée configurée ; elle ne sera plus proposée.

## Recevoir une e-invoice

Lorsqu'une facture parvient sur la plateforme approuvée reliée à Dokos, elle apparaît automatiquement dans la liste des **e-invoices**.

1. Accédez à la liste des **e-invoices** depuis le module Achats.
2. Ouvrez la facture reçue pour consulter les informations transmises : fournisseur, montant, date d'émission, lignes de prestation, etc.
3. Pour préparer l'intégration, créez une **facture fournisseur** Dokos correspondante et rattachez l'e-invoice à celle-ci.

La facture passe alors au statut **En attente de validation**.

## Refuser une e-invoice reçue

Toutes les factures reçues ne sont pas forcément à intégrer : erreur de destinataire, doublon, litige avec le fournisseur, etc. Vous pouvez refuser une e-invoice directement depuis la **facture fournisseur** Dokos à laquelle elle est rattachée.

1. Ouvrez la **facture fournisseur** liée à l'e-invoice.
2. Cliquez sur le bouton **Refuser la facture** dans la barre d'action.
3. Une fenêtre s'ouvre pour sélectionner le motif de refus. Les motifs proposés sont lisibles et explicites, afin que le fournisseur puisse comprendre sans ambiguïté la raison du refus.
4. Validez la fenêtre : la facture passe au statut **Refusée** et le motif est transmis à la plateforme approuvée.

::callout
**Motifs de refus**
La liste des motifs de refus disponibles est exposée par la plateforme approuvée. Chaque motif est accompagné d'un libellé complet, lisible par un utilisateur non technique.
::

## Exemple

La société **Maison Verte SARL** reçoit une e-invoice du fournisseur **Bureau Moderne**. Le comptable ouvre la facture, constate qu'il s'agit d'un doublon d'une facture déjà enregistrée la semaine précédente, et clique sur **Refuser la facture** depuis la facture fournisseur Dokos. Le motif « Doublon » est sélectionné et transmis à la plateforme. L'e-invoice passe au statut **Refusée** et n'apparaîtra plus dans les relances d'intégration.

## Paramétrage de la durée d'abandon

Pour éviter que des e-invoices non traitées ne s'accumulent, Dokos bascule automatiquement au statut **Abandonnée** toute facture restée en attente de validation au-delà d'une durée configurable.

- La durée d'attente est paramétrée au niveau de la plateforme approuvée.
- Une facture abandonnée reste consultable mais n'est plus proposée pour intégration active.
- Vous pouvez réactiver manuellement une facture abandonnée si nécessaire.

## Points de vigilance

- Une e-invoice refusée ne peut pas être réintégrée automatiquement ; en cas d'erreur, il faut demander au fournisseur de renvoyer la facture.
- Le motif de refus est transmis à la plateforme approuvée et peut être consulté par le fournisseur.
- Vérifiez que le rattachement à la facture fournisseur est correct avant de refuser : un refus erroné nécessite une nouvelle émission côté fournisseur.


# Analyser le vieillissement des stocks

Le rapport de **vieillissement des stocks** vous permet d'analyser la durée pendant laquelle vos articles sont restés en stock. Cela vous aide à identifier les articles qui stagnent, à optimiser vos rotations de stock et à prendre des décisions éclairées sur les promotions ou les liquidations.

## Accéder au rapport

1. Allez dans **Stock > Rapports > Vieillissement des stocks**.
2. Sélectionnez l'**entrepôt** et la **date de référence** pour l'analyse.
3. Cliquez sur **Afficher le rapport**.

## Comprendre les données du rapport

Le rapport affiche les informations suivantes pour chaque article :

- **Article** : Le nom de l'article.
- **Quantité totale** : La quantité totale en stock à la date de référence.
- **Âge moyen (jours)** : L'âge moyen des articles en stock, calculé en jours.
- **Valeur totale** : La valeur totale des articles en stock.
- **Répartition par tranche d'âge** : La quantité et la valeur des articles réparties dans différentes tranches d'âge (par exemple, 0-30 jours, 31-60 jours, etc.).

### Exemple avec les données de démonstration

Prenons l'exemple de l'article **Chaise de bureau ergonomique** pour l'entrepôt **Magasin Principal** :

| Tranche d'âge (jours) | Quantité | Valeur (€) |
| --------------------- | -------- | ---------- |
| 0-30                  | 10       | 1500       |
| 31-60                 | 5        | 750        |
| 61-90                 | 2        | 300        |
| 91+                   | 3        | 450        |

Dans cet exemple, vous pouvez voir que 3 unités de la chaise sont en stock depuis plus de 90 jours. Cela peut indiquer un besoin de promotion pour écouler ces articles.

## Configurer les tranches d'âge

Par défaut, le rapport utilise les tranches d'âge suivantes : 0-30 jours, 31-60 jours, 61-90 jours et 91+ jours. Vous pouvez personnaliser ces tranches en modifiant les paramètres du rapport :

1. Cliquez sur le bouton **Modifier** dans la barre d'outils du rapport.
2. Dans la section **Tranches d'âge**, entrez vos tranches personnalisées sous forme de liste (par exemple, `0,30,60,90,120`).
3. Cliquez sur **Enregistrer** pour appliquer les modifications.

## Utiliser les filtres pour affiner l'analyse

Vous pouvez utiliser les filtres suivants pour affiner votre analyse :

- **Groupe d'articles** : Filtrez par groupe d'articles pour analyser des catégories spécifiques.
- **Marque** : Filtrez par marque pour analyser les articles d'une marque particulière.
- **Fournisseur** : Filtrez par fournisseur pour analyser les articles fournis par un partenaire spécifique.

## Exporter le rapport

Pour exporter le rapport :

1. Cliquez sur le bouton **Exporter** dans la barre d'outils du rapport.
2. Sélectionnez le format d'exportation (CSV, Excel, JSON).
3. Le fichier sera téléchargé sur votre appareil.

## Bonnes pratiques

- **Analyse régulière** : Exécutez ce rapport mensuellement pour identifier les tendances et prendre des mesures proactives.
- **Actions correctives** : Pour les articles avec un âge élevé, envisagez des promotions, des liquidations ou des retours aux fournisseurs.
- **Optimisation des stocks** : Utilisez les données pour ajuster vos commandes et éviter le surstockage.

::mermaid
flowchart TD
A\[Accéder au rapport] --> B\[Sélectionner l'entrepôt et la date]
B --> C\[Afficher le rapport]
C --> D\[Analyser les tranches d'âge]
D --> E\[Identifier les articles stagnants]
E --> F\[Prendre des actions correctives]
F --> G\[Optimiser les stocks]

::

## Personnalisation avancée

\::: dokos
Pour les développeurs ou les utilisateurs avancés, il est possible de personnaliser davantage le rapport via des scripts ou des modifications du code. Par exemple, vous pouvez modifier la logique de calcul des tranches d'âge ou ajouter des colonnes supplémentaires au rapport.

Consultez la documentation technique pour plus d'informations sur la personnalisation du rapport de vieillissement des stocks.
\:::


# Signature électronique sur les fiches

Dokos RH permet désormais d'ajouter une signature électronique directement sur les fiches des employés, contrats, ou tout autre document RH nécessitant une validation formelle. Cette fonctionnalité est particulièrement utile pour les processus de validation, les contrats de travail, ou les formulaires d'embauche.

## Activer la signature électronique

Pour activer la signature électronique sur une fiche spécifique :

1. Ouvrez la fiche concernée (par exemple, un **Contrat de travail** ou une **Fiche employé**).
2. Cliquez sur le bouton **Modifier** en haut à droite.
3. Dans la barre latérale droite, recherchez le panneau **Signature électronique**.
4. Cliquez sur **Activer la signature** pour afficher le champ de signature.

::mermaid
flowchart TD
A\[Ouvrir la fiche] --> B\[Cliquer sur Modifier]
B --> C\[Afficher le panneau Signature électronique]
C --> D\[Activer la signature]
D --> E\[Signer le document]

::

## Signer un document

Une fois le panneau de signature activé :

1. Le champ de signature s'affiche sous forme d'une zone de dessin.
2. Utilisez votre souris, votre stylet ou votre doigt (sur mobile) pour signer directement dans la zone.
3. Cliquez sur **Enregistrer** pour valider la signature.
4. La signature est alors attachée à la fiche et peut être consultée ou téléchargée.

::tip
Pour effacer une signature et recommencer, cliquez sur **Effacer** avant d'enregistrer.
::

## Consulter ou télécharger une signature

Une fois une signature enregistrée :

- Elle est visible dans le panneau **Signature électronique** de la fiche.
- Vous pouvez la télécharger au format PNG en cliquant sur **Télécharger la signature**.
- La signature est également incluse dans les exports PDF de la fiche si l'option est activée.

::mermaid
flowchart TD
A\[Consulter la fiche signée] --> B\[Afficher le panneau Signature électronique]
B --> C\[Télécharger la signature]
C --> D\[Exporter la fiche en PDF]

::

## Cas d'usage

### Validation d'un contrat de travail

1. Le responsable RH prépare un **Contrat de travail** pour un nouvel employé.
2. Il active la signature électronique sur la fiche du contrat.
3. L'employé signe électroniquement le contrat depuis son espace Dokos.
4. Le contrat signé est automatiquement enregistré et peut être partagé avec les parties prenantes.

### Approbation d'une fiche employé

1. Un manager souhaite valider les informations d'un employé (par exemple, une modification de poste).
2. Il ouvre la **Fiche employé** et active la signature électronique.
3. Il signe la fiche pour confirmer son approbation.
4. La signature est enregistrée et horodatée, garantissant la traçabilité du processus.

## Configuration avancée

Pour personnaliser les paramètres de la signature électronique (par exemple, activer/désactiver la signature pour certains types de fiches) :

1. Allez dans **Paramètres > Personnalisation > Personnaliser les formulaires**.
2. Sélectionnez le type de fiche concerné (par exemple, **Contrat de travail**).
3. Ajoutez un champ personnalisé de type **Section Break** nommé **Signature électronique**.
4. Enregistrez les modifications.

::dokos
Pour les administrateurs système, il est possible de configurer des règles d'accès spécifiques pour la signature électronique via les **Rôles et Permissions**.
::


# Dokos CLI

`dokos` est un utilitaire en ligne de commande, léger, qui s'appuie sur l'**API REST de Frappe/Dokos**. Il permet de lire et d'écrire des données d'un site Dokos — consulter des DocTypes, exécuter des rapports, inspecter des schémas et des permissions, créer ou modifier des documents — directement depuis un terminal ou depuis un agent IA.

Le même outil expose un **serveur MCP** (`dokos mcp`) : les agents (Claude Code, agy, Vibe CLI, OpenCode) accèdent alors aux mêmes capacités sous forme d'outils, sans passer par le terminal.

::mermaid
flowchart LR
subgraph Clients
H(Terminal\nun humain)
A(Agent IA\nClaude Code / agy / Vibe / OpenCode)
end
H -->|commandes dokos| CLI
A -->|outils MCP| MCP
subgraph dokos-cli
CLI(dokos\nligne de commande)
MCP(dokos mcp\nserveur MCP)
end
CLI -->|API REST| API(API REST\nFrappe / Dokos)
MCP -->|API REST| API
API --> S\[(Site Dokos)]

::

## À quoi sert `dokos`

- **Interroger un site** — listes de documents, lecture d'un document, comptages, valeurs de champs, rapports.
- **Écrire des données** — création, mise à jour, soumission, annulation, suppression, renommage, mise à jour en masse.
- **Explorer le modèle** — schémas de DocTypes et permissions, cache local du catalogue.
- **Équiper un agent IA** — enregistrer le serveur MCP et installer l'assistant Dokos dans vos runtimes d'agents en une commande.

## Deux modes d'utilisation

| Mode            | Comment                                                             | Pour qui                                                              |
| --------------- | ------------------------------------------------------------------- | --------------------------------------------------------------------- |
| **Terminal**    | Commandes `dokos …`, sortie en tableau, JSON structuré ou JSON brut | Administrateurs, développeurs, scripts                                |
| **Agent (MCP)** | `dokos mcp` + `dokos agent install`                                 | Assistants IA qui lisent et mettent à jour le site en langage naturel |

## Prérequis

- **Python ≥ 3.11**
- **pipx** (recommandé) ou pip
- Un site Dokos/Frappe accessible, avec une clé et un secret d'API — ou un *bench* local que `dokos` peut détecter automatiquement.

::callout{color="blue" icon="i-mdi-information"}
Cette section décrit l'outil `dokos-cli` (terminal + MCP). Elle est destinée aux **administrateurs, développeurs et intégrateurs**. Elle ne concerne pas l'utilisation quotidienne de l'interface Dokos.
::

## Pour commencer

1. [Installation](https://doc.dokos.io/v5/dokos-cli/installation) — installer `dokos` et le tenir à jour.
2. [Configuration](https://doc.dokos.io/v5/dokos-cli/configuration) — connecter la CLI à un site Dokos.
3. [Commandes](https://doc.dokos.io/v5/dokos-cli/commandes) — interroger et modifier les données.
4. [Intégration avec les agents](https://doc.dokos.io/v5/dokos-cli/integration-agents) — brancher `dokos` sur Claude Code, agy, Vibe CLI et OpenCode.


# Installation

`dokos` est un paquet Python standard. Il installe une seule commande : `dokos`.

## Prérequis

- **Python ≥ 3.11**
- **pipx** (recommandé) ou pip

::callout{color="blue" icon="i-mdi-information"}
Le dépôt `dokos-cli` est privé. Pour l'installer ou vérifier les mises à jour, un **jeton GitLab** (`GITLAB_TOKEN`) est nécessaire, ou une configuration via `dokos configure`.
::

## Installation recommandée (pipx)

pipx installe l'outil dans un environnement isolé et le rend disponible partout. Épinglez une version publiée (`<tag>`) :

```bash
pipx install "git+https://gitlab.com/dokos/dokos-cli.git@<tag>"
```

## Installation pour le développement (éditable)

Depuis une copie locale du dépôt :

```bash
pip install -e .
```

Cette méthode installe la commande `dokos` en mode éditable : les modifications du code source sont prises en compte immédiatement.

## Vérifier l'installation

```bash
dokos --help
dokos get-list "User" --limit 5
```

La première commande affiche l'aide et la liste des commandes disponibles. La seconde nécessite une [configuration](https://doc.dokos.io/v5/dokos-cli/configuration) valide vers un site.

## Mises à jour

`dokos` vérifie au plus une fois par jour si une nouvelle version publiée existe sur GitLab et affiche un message discret le cas échéant.

```bash
dokos self-update          # met à jour selon la méthode d'installation détectée
dokos self-update --check  # signale seulement si une mise à jour est disponible (n'installe rien)
```

La mise à jour s'adapte à la méthode d'installation :

| Installation                 | Comportement de `dokos self-update`                       |
| ---------------------------- | --------------------------------------------------------- |
| **pipx**                     | `pipx install --force`                                    |
| **pip**                      | `pip install -U`                                          |
| **éditable (développement)** | jamais modifiée — affiche seulement les étapes `git pull` |

::callout{color="amber" icon="i-mdi-key-outline"}
La détection de version interroge un dépôt privé : exportez `GITLAB_TOKEN`, ou enregistrez un jeton via `dokos configure`.
::


# Configuration

`dokos` a besoin de trois informations pour dialoguer avec un site : son **URL**, une **clé d'API** et un **secret d'API**. Plusieurs façons de les fournir coexistent.

## Ordre de résolution des identifiants

`dokos` résout les identifiants **dans cet ordre** :

1. Les variables d'environnement `DOKOS_URL`, `DOKOS_API_KEY`, `DOKOS_API_SECRET` (si les trois sont définies) l'emportent.
2. Sinon, le fichier `~/.config/dokos/config.json`.
3. Sinon, la commande s'arrête avec un message pointant vers `dokos configure`.

## A. Site distant, en interactif

```bash
dokos configure
```

L'assistant demande l'URL, la clé et le secret d'API, vérifie la connexion, puis enregistre le tout dans `~/.config/dokos/config.json` (permissions `0600`).

::callout{color="blue" icon="i-mdi-information"}
La clé et le secret se génèrent dans votre profil Dokos → **Accès API** → **Générer les clés**. Le secret n'est affiché qu'une seule fois.
::

## B. Bench local, en automatique

Si un *bench* Dokos tourne sur la même machine, laissez `dokos` le détecter et émettre les clés pour vous :

```bash
dokos use-site                                # depuis l'intérieur du bench (ou --bench <chemin>)
dokos use-site dev.localhost                  # cibler un site précis
dokos use-site dev.localhost --user jane@example.com   # agir en tant qu'un utilisateur donné
```

`dokos` remonte jusqu'à la racine du bench, choisit ou demande le site, puis **demande pour quel utilisateur** émettre les clés (par défaut `Administrator`). Les clés héritent des rôles et permissions de cet utilisateur : **ce sont ses droits qui gouvernent** ce que les commandes peuvent lire et écrire.

## C. Onboarding en une commande

```bash
dokos setup
```

Un assistant guidé autour de `use-site` pour relier un bench/site local.

## D. Site distant, en non interactif

Pratique pour les scripts et les agents :

```bash
dokos add-site akyer \
  --url https://akyer.dokos.cloud \
  --api-key CLE --api-secret SECRET
```

## Variables d'environnement

```bash
export DOKOS_URL="https://votre-site.dokos.cloud"
export DOKOS_API_KEY="..."
export DOKOS_API_SECRET="..."
```

| Variable           | Rôle                                                                 |
| ------------------ | -------------------------------------------------------------------- |
| `DOKOS_URL`        | URL de base du site                                                  |
| `DOKOS_API_KEY`    | Clé d'API                                                            |
| `DOKOS_API_SECRET` | Secret d'API                                                         |
| `GITLAB_TOKEN`     | Jeton utilisé par `dokos self-update` pour interroger le dépôt privé |

## Registre multi-sites

`dokos` gère plusieurs sites dans un même fichier de configuration et permet de basculer de l'un à l'autre :

```bash
dokos configure --name dashboard     # enregistrer un site distant sous un nom
dokos use-site --name staging        # relier un bench local sous un nom
dokos sites                          # lister les sites et afficher l'actif
dokos use dashboard                  # changer de site actif
```

Structure du fichier `~/.config/dokos/config.json` :

```json
{
  "sites": {
    "mysite": {
      "url": "https://votre-site.dokos.cloud",
      "api_key": "...",
      "api_secret": "..."
    }
  },
  "active_site": "mysite",
  "gitlab_token": "..."
}
```

## Éditer une clé de configuration

```bash
dokos config list                    # toutes les clés, valeurs masquées, et leur source
dokos config set url https://demo.dokos.cloud
dokos config get api_secret --show-secrets
dokos config unset gitlab_token
dokos config path                    # emplacement du fichier
```

## Cache du catalogue

`dokos sync` télécharge la liste des DocTypes et des rapports dans deux fichiers Markdown lisibles par un LLM :

```text
~/.config/dokos/doctypes.md
~/.config/dokos/reports.md
```

Le cache est régénéré automatiquement s'il est absent ou vieux de plus de 30 jours. Relancez `dokos sync` manuellement après une mise à jour des applications Dokos.


# Commandes

Toutes les commandes s'exécutent sur le **site actif** ([voir la configuration](https://doc.dokos.io/v5/dokos-cli/configuration)). Chaque commande de données peut produire trois formats de sortie.

## Modes de sortie

| Option     | Sortie                                                                 | Quand l'utiliser                           |
| ---------- | ---------------------------------------------------------------------- | ------------------------------------------ |
| *(aucune)* | Tableau enrichi dans le terminal                                       | lecture par un humain                      |
| `--json`   | `{"data": [...], "next": [...]}` avec des commandes de suivi suggérées | enchaînement d'outils / usage par un agent |
| `--quiet`  | JSON brut uniquement                                                   | redirection vers `jq` ou un script         |

```bash
dokos get-list "Item" --quiet | jq '.[].item_code'
```

## Lecture

| Commande                                   | Rôle                                                |
| ------------------------------------------ | --------------------------------------------------- |
| `dokos get-list <DocType>`                 | Liste paginée de documents                          |
| `dokos get <DocType> <nom>`                | Un document complet                                 |
| `dokos get-count <DocType>`                | Nombre de documents (avec filtres)                  |
| `dokos get-value <DocType> <champ>`        | Un ou plusieurs champs d'un document                |
| `dokos get-single-value <DocType> <champ>` | Un champ d'un DocType *Single* (paramètres globaux) |

```bash
dokos get-list "Sales Invoice" \
  --filters '[["status","=","Overdue"]]' \
  --fields '["name","customer","grand_total"]' --json

dokos get "User" "Administrator"
```

## Rapports

| Commande                 | Rôle                                              |
| ------------------------ | ------------------------------------------------- |
| `dokos run-report <nom>` | Exécuter un *Query Report* et renvoyer ses lignes |
| `dokos report list`      | Lister les rapports                               |
| `dokos report get <nom>` | Détails d'un rapport                              |
| `dokos report run <nom>` | Exécuter un rapport                               |
| `dokos report create`    | Créer un *Query Report* à partir de SQL           |

```bash
dokos run-report "Accounts Receivable" --filters '{"company":"Dokos SAS"}'
```

## Schéma et permissions

| Commande                    | Rôle                                  |
| --------------------------- | ------------------------------------- |
| `dokos meta get <DocType>`  | Schéma compact (champs + indicateurs) |
| `dokos perms get <DocType>` | Règles de permissions par rôle        |

```bash
dokos meta get "Sales Invoice"
```

::callout{color="blue" icon="i-mdi-lightbulb-on-outline"}
Avant d'écrire, un `dokos meta get` permet de connaître les champs obligatoires et les options des champs *Link* / *Select*.
::

## Écriture

| Commande                                           | Rôle                                                    |
| -------------------------------------------------- | ------------------------------------------------------- |
| `dokos set-value <DocType> <nom> <champ> <valeur>` | Modifier un champ                                       |
| `dokos insert`                                     | Créer un document depuis un objet JSON                  |
| `dokos save`                                       | Mettre à jour un document existant depuis un objet JSON |
| `dokos submit` / `dokos cancel`                    | Soumettre / annuler un document                         |
| `dokos delete`                                     | Supprimer un document                                   |
| `dokos rename`                                     | Renommer un document                                    |
| `dokos bulk-update`                                | Mise à jour en masse depuis un tableau JSON             |

```bash
dokos set-value "Task" "TASK-0001" status "Completed"
```

::callout{color="amber" icon="i-mdi-alert"}
Les commandes d'écriture modifient des données réelles sur le site actif. Les droits utilisés sont ceux de l'utilisateur dont proviennent la clé et le secret d'API.
::

## Appel de méthode serveur (RPC)

`dokos call` invoque n'importe quelle méthode serveur *whitelistée* par son chemin pointé :

```bash
dokos call frappe.client.get_count --args '{"doctype":"Task"}'
```

## Découverte pour les agents

Chaque commande de données répond à un indicateur caché `--agent` qui décrit son contrat (commande, description, arguments, options, pièges) au format JSON. C'est ce que les agents utilisent pour s'auto-documenter :

```bash
dokos get-list --agent
```


# Intégration avec les agents (MCP)

`dokos` expose ses capacités aux agents IA de deux façons : un **serveur MCP** (Model Context Protocol) et une **compétence** (skill) prête pour le prompt. Une seule commande, `dokos agent install`, câble le tout dans vos runtimes.

## Installation clé en main

`dokos agent install` fait trois choses pour chaque runtime détecté : il &#x2A;*enregistre le serveur MCP `dokos`**, **auto-approuve les outils en lecture seule**, et &#x2A;*installe la compétence `dokos-erp`** dans la bibliothèque centrale `~/.agents/skills` (partagée par tous les runtimes).

```bash
dokos agent install --print                 # prévisualiser, sans rien écrire
dokos agent install                         # installer dans tous les runtimes détectés
dokos agent install --runtime claude,vibe   # un sous-ensemble : claude,vibe,opencode,agy
```

L'opération est **idempotente** : relancer ne change rien. Les lectures s'exécutent sans confirmation ; les écritures restent soumises à validation.

::mermaid
flowchart TD
I(dokos agent install)
I --> C(Claude Code)
I --> G(agy)
I --> V(Vibe CLI)
I --> O(OpenCode)
I --> L[Bibliothèque de compétences\n~/.agents/skills\ncompétence dokos-erp]


```text
C -->|claude mcp add-json\n~/.claude/settings.json| MCP(serveur MCP\ndokos mcp)
G -->|agy plugin import claude| MCP
V -->|~/.vibe/config.toml| MCP
O -->|~/.config/opencode/opencode.json| MCP

L -.->|lien symbolique| C
L -.->|lien symbolique| G
L -.->|lien symbolique| V
L -.->|lien symbolique| O
```
::

::callout{color="blue" icon="i-mdi-information"}
La compétence est installée **une seule fois** dans `~/.agents/skills`, puis partagée à chaque runtime par lien symbolique. Seuls l'enregistrement MCP et la liste d'auto-approbation diffèrent d'un runtime à l'autre. `agy` importe sa configuration depuis Claude : appliquez donc la cible Claude en premier.
::

## Enregistrement manuel du serveur MCP

Si vous n'utilisez pas l'installateur, enregistrez le serveur à la main. Il s'exécute en **stdio** — l'agent le lance comme sous-processus.

```bash
dokos mcp --print-config     # affiche l'extrait d'enregistrement, puis quitte
dokos mcp                    # lance le serveur MCP en stdio
```

```json
{
  "mcpServers": {
    "dokos": { "command": "dokos", "args": ["mcp"] }
  }
}
```

Pour Claude Code, cet extrait va dans `.mcp.json` ; OpenCode et Vibe utilisent leur propre configuration MCP.

## Outils exposés

Chaque outil est une fine enveloppe autour des mêmes fonctions que les commandes du terminal. Les résultats sont des dictionnaires compacts pour limiter l'empreinte en jetons ; les erreurs sont renvoyées sous la forme `{"error": "..."}`.

**Données Frappe/Dokos (REST) :**

| Outil                                            | Rôle                                                 |
| ------------------------------------------------ | ---------------------------------------------------- |
| `meta_get(doctype)`                              | Schéma compact d'un DocType                          |
| `perms_get(doctype)`                             | Règles de permissions d'un DocType                   |
| `doc_get(doctype, name)`                         | Lire un document complet                             |
| `doc_list(doctype, filters?, fields?, limit=20)` | Lister des documents                                 |
| `run_report(report_name, filters?)`              | Exécuter un *Query Report*                           |
| `doc_create(doc)`                                | Créer un document — **écriture**                     |
| `doc_update(doctype, name, fields)`              | Mettre à jour un document — **écriture**             |
| `report_create(report_name, query, ref_doctype)` | Créer un *Query Report* depuis du SQL — **écriture** |

**Sites (registre multi-sites) :**

| Outil                                                        | Rôle                                             |
| ------------------------------------------------------------ | ------------------------------------------------ |
| `site_list()`                                                | Lister les sites configurés                      |
| `site_current()`                                             | Afficher le site actif                           |
| `site_use(name)`                                             | Changer de site actif                            |
| `site_add(name, url, api_key, api_secret, make_active=True)` | Enregistrer un site — **écrit des identifiants** |

::callout{color="green" icon="i-mdi-shield-check-outline"}
`dokos agent install` n'auto-approuve que les outils en **lecture seule** : `doc_get`, `doc_list`, `run_report`, `meta_get`, `perms_get`, `site_list`, `site_current`. Les outils d'écriture restent soumis à confirmation dans les réglages de permissions de l'agent.
::

## Compétence sans MCP

Pour les agents qui préfèrent une « compétence » injectée dans le prompt plutôt que des outils MCP :

```bash
dokos skill        # affiche skills/SKILL.md
```

`SKILL.md` résume les commandes de la CLI et ses modes de sortie.

## Conseils pour les agents

- Utilisez `--json` (terminal) ou les outils MCP pour enchaîner les appels — la charge `--json` inclut un tableau `next` de commandes de suivi suggérées.
- Lancez `dokos sync` une fois pour que l'agent puisse lire `~/.config/dokos/doctypes.md` et `reports.md` et découvrir les noms exacts (sensibles à la casse).
- Préférez un `meta get` avant d'écrire, pour connaître les champs obligatoires et les options des champs *Link* / *Select*.


# Bienvenue

Dodock est un modèle applicatif low-code permettant de créer des applications métier rapidement. Il sert de moteur aux application de l'éco-système Dokos.

::callout{color="teal" icon="i-heroicons-light-bulb"}
L'application Dodock est une adaptation de l'application Frappe par [Frappe Technologies](https://github.com/frappe/frappe){rel=""nofollow""}
::

Les principales fonctionnalités de Dodock

::card-group
  :::card{icon="i-carbon-container-software" title="Interface administrateur"}
  Définissez vos formulaires et bénéficiez d'un interface utilisateur avec des espaces de travail, des listes, des calendriers, des rapports et plus encore.
  :::

  :::card{icon="i-eos-icons-role-binding-outlined" title="Rôles et autorisations"}
  Donnez des accès restreints à certaines fonctionnalités à vos différentes catégories d'utilisateurs.
  :::

  :::card{icon="i-octicon-workflow-24" title="Workflows"}
  Mettez en place des flux de validation métier en quelques clics pour n'importe quel type de document.
  :::

  :::card{icon="i-mdi-api" title="API REST"}
  Tous vos formulaires sont associés à une API REST et peuvent déclencher des Webhooks.
  :::

  :::card{icon="i-codicon-terminal-powershell" title="Low Code"}
  Proposez des fonctionnalités standards à vos utilisateurs et laissez les étendre grâce aux outils low-code intégrés.
  :::

  :::card{icon="i-mdi-toolbox-outline" title="Boîte à outils"}
  Oauth/OpenID, gestionnaire de tâches de fonds, Socket.io, Redis Pub/Sub,... Dodock est fourni avec tous les outils pour créer des applications métier puissantes, stables et évolutives.
  :::
::


# Configuration de l'intégration Pappers

Pour activer la recherche et validation des entreprises françaises par SIREN/SIRET dans Dokos, vous devez configurer l'intégration avec **Pappers**, un service externe fournissant les données officielles des entreprises françaises.

## Prérequis

- Un compte actif sur [Pappers](https://www.pappers.fr){rel="&#x22;nofollow&#x22;"}
- Une clé API Pappers valide

## Configuration dans Dokos

1. Allez dans **Paramètres > Intégrations > Pappers**
2. Activez l'intégration en cochant la case **Activer Pappers**
3. Saisissez votre **Clé API Pappers** dans le champ dédié
4. Sauvegardez les modifications

::warning
Sans cette configuration, la recherche et validation des numéros SIREN/SIRET ne fonctionneront pas.
::

## Voir aussi

- [Recherche et validation d'entreprise par SIREN/SIRET](https://doc.dokos.io/v5/dokos/parametrage/siren-siret)
- [Documentation officielle Pappers](https://www.pappers.fr/api/documentation){rel="&#x22;nofollow&#x22;"}


# Personnalisation de l'interface

Dokos propose dans ses **Paramètres** (via la barre de navigation) de personnaliser l'interface pour l'adapter au mieux à vos besoins.

## Identité visuelle

- Remplacez le logo Dokos par le vôtre.
- Ajoutez un widget d'annonce pour diffuser des messages à toute l'équipe.

## Tableaux de bord et statistiques

![administration\_personnalisation\_de\_l\_interface](https://doc.dokos.io/generalites_dokos/administrer_son_site/administration_personnalisation.png)

Dokos propose de nombreux outils de visualisation :

- Cartes statistiques (près de 100 préexistantes).
- Graphiques de tableau de bord.
- Cartes de résumé (particulièrement utiles pour les moyennes et grandes entreprises).

## Types de documents personnalisés

Dokos vous offre la possibilité de créer vos propres types de documents adaptés à vos besoins spécifiques. Par exemple :

- Un document "annonce" pour publier des offres.
- Un formulaire web pour permettre des réservations.
- Des documents interconnectés pour suivre votre processus métier.

**À noter** : Les personnalisations que vous effectuez (ajout/suppression de champs) ne seront jamais écrasées lors des mises à jour.

## Totaux et montants sur les liens du tableau de bord :badge{text="Dokos" type="warning"}

> **Exemple — Maison Verte SARL**
> Sur la fiche client de Maison Verte SARL, le tableau de bord affiche non seulement le nombre de factures de vente, mais aussi le total facturé (4 800,00 €) et le montant encore dû (1 200,00 €). Le commercial voit en un coup d'œil la situation financière du client sans ouvrir chaque facture.

Le tableau de bord d'une fiche (client, fournisseur, article…) affiche des liens vers les documents liés avec, en option, des totaux monétaires calculés à la volée. Cette configuration est réservée aux administrateurs et développeurs : elle se définit dans le fichier de configuration du tableau de bord du type de formulaire concerné.

::dokos
**Configuration pour les administrateurs et développeurs**

Chaque groupe de liens dans la configuration du tableau de bord peut recevoir une clé `summary_fields` associant un type de formulaire à un calcul de total. Les options disponibles sont :

| Clé            | Rôle                                                                                                       |
| -------------- | ---------------------------------------------------------------------------------------------------------- |
| `field`        | Champ numérique dont la somme est calculée (ex. `net_total`)                                               |
| `label`        | Libellé affiché pour le total (ex. "Total facturé")                                                        |
| `fieldtype`    | Type d'affichage : `Currency`, `Float`, `Int`                                                              |
| `open_field`   | Champ pour le calcul du sous-total "ouvert" (ex. `outstanding_amount`)                                     |
| `open_label`   | Libellé du sous-total ouvert (ex. "En attente")                                                            |
| `open_filters` | Filtres supplémentaires pour le sous-total ouvert (ex. `{"docstatus": 1, "outstanding_amount": [">", 0]}`) |

Exemple tiré de la fiche client :

```python
"summary_fields": {
    "Sales Invoice": {
        "field": "net_total",
        "label": _("Total Billed"),
        "fieldtype": "Currency",
        "open_field": "outstanding_amount",
        "open_label": _("Outstanding"),
        "open_filters": {"docstatus": 1, "outstanding_amount": [">", 0]},
    },
}
```
::

::demo-link{demo="Dokompany" doctype="Customer"}
Voir une fiche client dans la démo — le tableau de bord affiche les totaux facturés et le montant en attente
::

## Icônes sur les types de formulaires :badge{text="Dokos" type="warning"}

> **Exemple — Dupont Conseil**
> L'administrateur de Dupont Conseil crée un type de formulaire personnalisé "Dossier client" et lui attribue l'icône `folder`. Partout où un lien vers ce formulaire apparaît dans l'interface — champs de recherche, listes liées, résultats de recherche globale — une petite icône dossier s'affiche à gauche pour distinguer visuellement ce type de document.

Chaque type de formulaire dans Dokos peut recevoir une icône issue de la bibliothèque d'icônes Frappe. Cette icône s'affiche à gauche des champs de saisie qui pointent vers ce formulaire, aidant les utilisateurs à identifier le type de document associé sans lire le nom complet.

::dokos
La configuration de l'icône se fait directement sur le formulaire du **Type de document**, dans le champ **Icône**. Cette option est destinée aux administrateurs et développeurs qui créent ou modifient des types de formulaires personnalisés. Les types de formulaires fournis par Dokos sont déjà configurés avec leurs icônes par défaut.
::

::demo-link{demo="Dokompany" doctype="Sales Order"}
Ouvrir un bon de commande dans la démo — les champs de lien affichent l'icône du type de document associé
::

## Modification en masse dans les tables enfants

> **Exemple — Maison Verte SARL**
> Un gestionnaire saisit un bon de commande pour Maison Verte SARL avec vingt lignes d'articles. Il réalise que la date de livraison prévue est incorrecte sur dix d'entre elles. Au lieu de corriger chaque ligne une par une, il coche les dix lignes concernées, clique sur **Modifier**, saisit la nouvelle date une seule fois, et toutes les lignes sélectionnées sont mises à jour instantanément.

Lorsqu'un formulaire contient une table enfant (lignes d'articles, plannings, etc.), il est possible de modifier plusieurs lignes simultanément. Cette fonctionnalité évite les saisies répétitives et réduit les risques d'erreur.

### Comment l'utiliser

1. Ouvrez le document concerné (bon de commande, facture, feuille de temps…).
2. Dans la table enfant, cochez les cases à gauche des lignes à modifier.
3. Un bouton **Modifier** (icône crayon) apparaît dans la barre d'outils de la table.
4. Cliquez sur **Modifier** : une fenêtre s'ouvre avec les champs modifiables.
5. Renseignez uniquement les champs à changer — les champs laissés vides ne seront pas affectés.
6. Cliquez sur **Mettre à jour** : toutes les lignes sélectionnées sont mises à jour dans le formulaire.
7. Enregistrez le document pour valider les changements.

> **Bon à savoir** : Sur un document déjà soumis, seuls les champs autorisés à la modification après soumission apparaissent dans la fenêtre de modification en masse.

### Activer ou désactiver cette option

Par défaut, la modification en masse est activée sur toutes les tables enfants. Un administrateur peut la désactiver champ par champ depuis **Personnaliser le formulaire** :

1. Allez dans **Personnaliser le formulaire** (menu Configuration ou barre de recherche).
2. Sélectionnez le type de formulaire concerné (ex. *Bon de commande*).
3. Repérez le champ de type **Table** correspondant à la table enfant.
4. Décochez l'option **Autoriser la modification en masse**.
5. Cliquez sur **Mettre à jour**.

::dokos
**Pour les développeurs** : l'option est également configurable directement dans la définition du DocType via le champ `allow_bulk_edit` sur le champ de type `Table`. Elle peut aussi être positionnée dans le fichier JSON du DocType pour les types de formulaires personnalisés gérés en code.
::

## Largeur des colonnes dans la vue liste

> **Exemple — Bureau Moderne**
> La responsable achats de Bureau Moderne consulte la liste des bons de commande. La colonne "Fournisseur" est trop étroite et tronque les noms. Elle fait glisser le bord de la colonne vers la droite pour l'élargir : la largeur est sauvegardée automatiquement et restera en place à chaque prochaine ouverture de la liste.

Dans toutes les vues liste de Dokos, vous pouvez ajuster la largeur de chaque colonne selon vos préférences. Ces réglages sont personnels et persistent d'une session à l'autre.

### Trois façons d'ajuster les largeurs

::mermaid
flowchart LR
A\[Largeur définie
sur le champ] -->|priorité basse| B\[Paramètres
de la vue liste]
B -->|priorité moyenne| C\[Glisser-déposer
dans l'en-tête]
C -->|priorité haute| D\[Largeur affichée]

::

#### 1. Glisser-déposer directement dans l'en-tête de liste

C'est la méthode la plus rapide pour un ajustement ponctuel :

1. Positionnez le pointeur sur le **séparateur vertical** entre deux en-têtes de colonne — une fine poignée apparaît.
2. Cliquez et faites glisser vers la gauche ou la droite pour modifier la largeur.
3. Relâchez : la nouvelle largeur est enregistrée automatiquement dans les Paramètres de la vue liste.

> **Bon à savoir** : Les poignées de redimensionnement sont toujours légèrement visibles au repos. Survolez la ligne d'en-têtes pour les faire apparaître toutes en même temps. Survolez directement une poignée pour la mettre en évidence.

#### 2. Paramètres de la vue liste

Pour régler les largeurs de plusieurs colonnes à la fois :

1. Cliquez sur le menu &#x2A;*⋮** (en haut à droite de la liste) puis sur **Paramètres de la vue liste**.
2. Dans le dialogue, la colonne &#x2A;*Largeur (px)** apparaît à côté de chaque champ affiché.
3. Saisissez la valeur souhaitée en pixels (minimum 50 px, maximum 400 px).
4. Cliquez sur **Enregistrer**.

#### 3. Définition sur le champ (administrateurs)

Un administrateur peut définir une largeur par défaut directement sur un champ depuis **Personnaliser le formulaire**. Cette valeur s'applique à tous les utilisateurs qui n'ont pas encore défini leur propre réglage.

### Contraintes

| Paramètre        | Valeur                                   |
| ---------------- | ---------------------------------------- |
| Largeur minimale | 50 px                                    |
| Largeur maximale | 400 px                                   |
| Sauvegarde       | Automatique après chaque glisser-déposer |
| Portée           | Par utilisateur et par vue liste         |


# Bibliothèque de composants UI `@framework/ui`

Dodock v5 intègre désormais la bibliothèque de composants UI `@framework/ui`, backportée depuis la branche `develop` de Frappe. Cette bibliothèque offre aux développeurs et administrateurs un ensemble de composants Vue.js réutilisables pour personnaliser et enrichir l'interface utilisateur de Dokos.

## Composants disponibles

La bibliothèque `@framework/ui` inclut les composants suivants, conçus pour être utilisés dans des applications personnalisées ou des extensions de l'interface :

### Composants de formulaire

#### `FormLayout`

Un rendu de formulaire piloté par schéma, supportant les grilles, les téléversements de fichiers et les éditeurs de code.

**Cas d'usage** :

- Création de formulaires dynamiques sans écrire de HTML personnalisé.
- Intégration de champs complexes comme les éditeurs de code ou les téléversements de fichiers.

**Exemple d'utilisation** :

```javascript
import { FormLayout } from '@framework/ui';

// Définir un schéma de formulaire
const schema = {
  fields: [
    {
      fieldtype: 'Data',
      fieldname: 'customer_name',
      label: 'Nom du client',
      reqd: 1
    },
    {
      fieldtype: 'Attach',
      fieldname: 'attachment',
      label: 'Pièce jointe'
    }
  ]
};

// Rendre le formulaire dans un dialogue
const dialog = new frappe.ui.Dialog({
  title: 'Nouveau client',
  size: 'large'
});

dialog.body.appendChild(FormLayout.render(schema));
dialog.show();
```

#### `PhoneInput`

Un champ de saisie pour les numéros de téléphone avec validation automatique des indicatifs internationaux.

**Cas d'usage** :

- Saisie de numéros de téléphone pour les fiches clients ou fournisseurs.
- Validation des numéros en fonction du pays sélectionné.

**Exemple d'utilisation** :

```javascript
import { PhoneInput } from '@framework/ui';

// Ajouter un champ PhoneInput à un formulaire
const phoneField = PhoneInput.create({
  label: 'Téléphone',
  fieldname: 'phone',
  country: 'FR' // Indicatif par défaut
});

frm.add_custom_field(phoneField);
```

### Composants de notification

#### `Notifications`

Un panneau de notifications extensible, permettant de filtrer les notifications par application et par type.

**Cas d'usage** :

- Centralisation des notifications pour les utilisateurs.
- Filtrage des notifications par application (ex. : Dokos, CRM, Helpdesk).

**Configuration** :
Les notifications sont gérées via les doctypes **Notification Type** et **Notification Type Preference**, permettant de définir des types de notifications personnalisés et de configurer les préférences d'envoi (email, popup, etc.).

::dokos
**Pour les développeurs** :

- Les notifications sont stockées dans le doctype **Notification Log**, qui inclut désormais des champs pour le titre, la description et l'application source.
- Les préférences d'email par type de notification sont configurables via **Notification Type Preference**.
::

### Composants de liste et tableau de bord

#### `ActivityTimeline`

Un composant affichant une timeline des activités liées à un document (emails, commentaires, modifications).

**Cas d'usage** :

- Visualisation de l'historique des interactions avec un client ou un fournisseur.
- Suivi des modifications apportées à un document.

**Exemple d'utilisation** :

```javascript
import { ActivityTimeline } from '@framework/ui';

// Récupérer les activités pour un document
frappe.call({
  method: 'frappe.desk.form.activity.get_activity_timeline',
  args: {
    doctype: 'Customer',
    docname: 'Maison Verte SARL'
  },
  callback: function(r) {
    if (r.message) {
      // Afficher la timeline dans un conteneur
      const timeline = ActivityTimeline.create(r.message);
      $('.timeline-container').append(timeline);
    }
  }
});
```

#### `ListViewControls`

Un ensemble de contrôles pour personnaliser les vues liste (filtres, colonnes, paramètres).

**Cas d'usage** :

- Ajout de colonnes synthétiques dans les vues liste.
- Personnalisation des paramètres de colonne (largeur, ordre).

**Exemple d'utilisation** :

```javascript
import { ListViewControls } from '@framework/ui';

// Ajouter une colonne synthétique à une vue liste
frappe.listview_settings['Sales Invoice'] = {
  onload: function(listview) {
    const controls = ListViewControls.create(listview);
    controls.addSyntheticColumn({
      label: 'Montant dû',
      fieldname: 'outstanding_amount',
      fieldtype: 'Currency'
    });
  }
};
```

### Composants de composition

#### `Composer`

Un composant pour rédiger des emails ou des commentaires avec une interface riche.

**Cas d'usage** :

- Rédaction d'emails directement depuis un document (ex. : fiche client).
- Ajout de commentaires avec mise en forme.

**Exemple d'utilisation** :

```javascript
import { Composer } from '@framework/ui';

// Ouvrir un compositeur d'email
const composer = Composer.create({
  doctype: 'Customer',
  docname: 'Maison Verte SARL',
  type: 'email',
  subject: 'Suivi de votre commande'
});

composer.show();
```

## Configuration des types de notifications

La bibliothèque `@framework/ui` introduit des doctypes pour gérer les types de notifications et leurs préférences :

### `Notification Type`

Ce doctype permet de définir des types de notifications personnalisés, avec les champs suivants :

| Champ             | Description                                       |
| ----------------- | ------------------------------------------------- |
| **Nom**           | Identifiant unique du type de notification.       |
| **Module**        | Module associé (ex. : Dokos, CRM).                |
| **Application**   | Application source (ex. : `dokos`, `frappe`).     |
| **Titre**         | Titre affiché dans le panneau de notifications.   |
| **Description**   | Description détaillée de la notification.         |
| **Document Type** | Type de document associé (ex. : `Sales Invoice`). |
| **Chemin**        | Chemin vers le document ou l'action à effectuer.  |

### `Notification Type Preference`

Ce doctype permet de configurer les préférences d'envoi pour chaque type de notification :

| Champ                    | Description                                       |
| ------------------------ | ------------------------------------------------- |
| **Utilisateur**          | Utilisateur concerné par les préférences.         |
| **Type de notification** | Type de notification associé.                     |
| **Préférence d'email**   | Activer/désactiver l'envoi d'emails pour ce type. |
| **Préférence de popup**  | Activer/désactiver les notifications popup.       |

### `Notification Log`

Ce doctype stocke les notifications envoyées aux utilisateurs, avec les champs suivants :

| Champ                    | Description                                           |
| ------------------------ | ----------------------------------------------------- |
| **Utilisateur**          | Destinataire de la notification.                      |
| **Type de notification** | Type de notification (lien vers `Notification Type`). |
| **Titre**                | Titre de la notification.                             |
| **Description**          | Description détaillée.                                |
| **Application**          | Application source (ex. : `dokos`).                   |
| **Document Type**        | Type de document associé.                             |
| **Document Name**        | Nom du document associé.                              |
| **Lu**                   | Statut de lecture de la notification.                 |

## Personnalisation de l'interface avec `@framework/ui`

### Ajouter un composant à un formulaire personnalisé

1. **Importer le composant** :
   ```javascript
   import { FormLayout } from '@framework/ui';
   ```
2. **Définir un schéma** :
   ```javascript
   const schema = {
     fields: [
       {
         fieldtype: 'Data',
         fieldname: 'customer_name',
         label: 'Nom du client'
       }
     ]
   };
   ```
3. **Rendre le composant** :
   ```javascript
   const form = FormLayout.render(schema);
   $('.form-container').append(form);
   ```

### Intégrer un composant dans une vue liste

1. **Importer le composant** :
   ```javascript
   import { ListViewControls } from '@framework/ui';
   ```
2. **Configurer la vue liste** :
   ```javascript
   frappe.listview_settings['Sales Invoice'] = {
     onload: function(listview) {
       const controls = ListViewControls.create(listview);
       controls.addSyntheticColumn({
         label: 'Montant dû',
         fieldname: 'outstanding_amount',
         fieldtype: 'Currency'
       });
     }
   };
   ```

## Bonnes pratiques

- **Réutilisabilité** : Les composants `@framework/ui` sont conçus pour être réutilisés dans plusieurs applications. Évitez de dupliquer du code en les intégrant dans vos personnalisations.
- **Performance** : Les composants sont optimisés pour minimiser les temps de chargement. Utilisez-les avec parcimonie dans les vues liste ou les formulaires fréquemment utilisés.
- **Compatibilité** : Les composants sont compatibles avec les versions récentes de Vue.js (v3). Assurez-vous que vos personnalisations utilisent une version compatible.
- **Documentation** : Consultez la documentation officielle de Frappe pour des exemples supplémentaires et des mises à jour sur les composants disponibles.

## Exemple complet : Ajouter une timeline d'activités à la fiche client

**Objectif** : Afficher une timeline des activités (emails, commentaires) sur la fiche client.

1. **Créer un script personnalisé pour le DocType `Customer`** :
   ```javascript
   // customer.js
   frappe.ui.form.on('Customer', {
     refresh: function(frm) {
       // Importer le composant ActivityTimeline
       import('@framework/ui').then(({ ActivityTimeline }) => {
         // Récupérer les activités
         frappe.call({
           method: 'frappe.desk.form.activity.get_activity_timeline',
           args: {
             doctype: 'Customer',
             docname: frm.doc.name
           },
           callback: function(r) {
             if (r.message) {
               // Créer et afficher la timeline
               const timeline = ActivityTimeline.create(r.message);
               frm.add_custom_section('activity_timeline', 'Timeline des activités');
               frm.fields_dict['activity_timeline'].$wrapper.append(timeline);
             }
           }
         });
       });
     }
   });
   ```
2. **Ajouter le script au DocType** :

   - Allez dans **Personnaliser le formulaire** > **Customer**.
   - Ajoutez le chemin vers le script dans le champ **Script personnalisé**.
3. **Résultat** :

   - La fiche client affiche désormais une section **Timeline des activités** avec l'historique des interactions.

::dokos
**Pour les administrateurs** :

- Les composants `@framework/ui` sont disponibles pour tous les types de formulaires personnalisés.
- Pour les utiliser, assurez-vous que les scripts personnalisés sont activés dans les **Paramètres système**.
::

## Limitations et contraintes

- **Compatibilité** : Les composants `@framework/ui` sont conçus pour Dodock v5 et versions ultérieures. Ils ne sont pas compatibles avec les versions antérieures.
- **Personnalisation** : Certains composants peuvent nécessiter des ajustements pour s'intégrer parfaitement à des interfaces personnalisées.
- **Documentation** : La documentation complète des composants est disponible dans le dépôt Frappe. Consultez les fichiers `.md` dans le dossier `ui/` pour des détails supplémentaires.

## Ressources supplémentaires

- [Documentation officielle de Frappe UI](https://github.com/frappe/frappe/tree/develop/ui){rel="&#x22;nofollow&#x22;"}
- [Exemples de composants](https://github.com/frappe/frappe/tree/develop/ui/examples){rel="&#x22;nofollow&#x22;"}
- [Guide de contribution](https://github.com/frappe/frappe/blob/develop/CONTRIBUTING.md){rel="&#x22;nofollow&#x22;"}


# Le Recorder – Suivi des requêtes et événements

Le **Recorder** est un outil de diagnostic avancé qui permet aux administrateurs de suivre et d'analyser les requêtes, les événements du cycle de vie des documents, ainsi que les performances des scripts et webhooks exécutés sur le serveur. Il est particulièrement utile pour déboguer des comportements complexes ou optimiser les performances.

## Activer le Recorder

1. Accédez au **Recorder** via la barre de recherche.
2. Cliquez sur **Configurer le Recorder**.
3. Activez les options souhaitées :


   - **Enregistrer les requêtes** : Capture toutes les requêtes exécutées.
   - **Capturer la chronologie du cycle de vie des documents** : Enregistre les événements liés aux documents (ex : `on_update`, `before_insert`).
4. Cliquez sur **Démarrer l'enregistrement**.

::mermaid
flowchart TD
A\[Accéder au Recorder] --> B\[Configurer le Recorder]
B --> C\[Activer les options]
C --> D\[Démarrer l'enregistrement]
D --> E\[Exécuter des actions sur Dokos]
E --> F\[Analyser les résultats]

::

## Analyser les requêtes

Le Recorder affiche une liste des requêtes enregistrées avec les détails suivants :

- **Durée** : Temps d'exécution de la requête.
- **Nombre de requêtes SQL** : Nombre de requêtes SQL exécutées.
- **Apps impliquées** : Applications (Dokos, ERPNext, etc.) ayant contribué à la requête.
- **Événements** : Nombre d'événements du cycle de vie des documents capturés.

Pour analyser une requête spécifique :

1. Cliquez sur une entrée dans la liste.
2. Consultez les détails, y compris la **chronologie des événements**.

## Chronologie du cycle de vie des documents

La nouvelle fonctionnalité **Capture du cycle de vie des documents** permet de visualiser les événements déclenchés lors des opérations sur un document (ex : création, mise à jour, suppression). Chaque événement est attribué à l'application qui l'a déclenché (ex : Dokos, ERPNext).

### Exemple d'utilisation

1. **Scénario** : Un utilisateur met à jour un **Bon de commande**.
2. **Résultat** : Le Recorder capture les événements suivants :

   - `before_save` (Dokos)
   - `validate` (ERPNext)
   - `on_update` (Dokos)
   - `after_save` (ERPNext)
3. **Analyse** :

   - Vérifiez l'ordre des événements pour identifier des comportements inattendus.
   - Identifiez les applications responsables de chaque étape.
   - Optimisez les scripts ou webhooks si des événements prennent trop de temps.

::mermaid
flowchart TD
A\[Mise à jour d'un Bon de commande] --> B\[before\_save - Dokos]
B --> C\[validate - ERPNext]
C --> D\[on\_update - Dokos]
D --> E\[after\_save - ERPNext]

::

## Filtrer les résultats

Utilisez les filtres pour affiner votre analyse :

- **Durée minimale** : Affiche uniquement les requêtes dépassant un certain temps.
- **Nombre d'événements** : Filtre les requêtes avec un nombre spécifique d'événements.
- **Apps impliquées** : Sélectionnez une ou plusieurs applications pour cibler les requêtes.

## Bonnes pratiques

- **Activer temporairement** : Le Recorder peut impacter les performances. Activez-le uniquement pour le débogage.
- **Cibler des actions spécifiques** : Limitez l'enregistrement à des opérations critiques pour éviter une surcharge de données.
- **Analyser les goulots d'étranglement** : Utilisez les données de durée et de requêtes SQL pour identifier les scripts ou webhooks à optimiser.

## Exemple concret : Déboguer un retard de traitement

**Problème** : Un utilisateur signale que la création d'un **Client** prend plusieurs secondes.

**Solution** :

1. Activez le Recorder avec l'option **Capturer la chronologie du cycle de vie des documents**.
2. Créez un nouveau **Client** (ex : "Maison Verte SARL").
3. Consultez le Recorder pour identifier les événements déclenchés.
4. Analysez la durée de chaque événement et les applications impliquées.
5. Identifiez un script personnalisé dans l'application "Gestion des Clients" qui ralentit le processus.
6. Optimisez ou désactivez le script pour résoudre le problème.

::mermaid
flowchart TD
A\[Création d'un Client] --> B\[before\_insert - Dokos]
B --> C\[validate - ERPNext]
C --> D\[Script personnalisé - Gestion des Clients]
D --> E\[after\_insert - Dokos]
style D fill:#f96,stroke:#333

::

## Limitations

- **Accès restreint** : Seuls les administrateurs peuvent utiliser le Recorder.
- **Impact sur les performances** : L'enregistrement peut ralentir le serveur. Utilisez-le avec précaution en production.
- **Données temporaires** : Les enregistrements ne sont pas persistants après un redémarrage du serveur.


# La boîte de dialogue « À propos »

La boîte de dialogue **À propos** vous permet de consulter les informations techniques relatives à votre installation Dodock : version des applications, mentions légales et informations sur le framework.

## Accéder à la boîte de dialogue

Vous pouvez ouvrir la boîte de dialogue « À propos » depuis le menu de profil utilisateur, accessible en cliquant sur votre avatar en bas du menu latéral, puis en sélectionnant **À propos**.

## Informations affichées

La boîte de dialogue présente :

- Le **logo et le nom** du framework (Dodock / Frappe)
- La **liste des applications installées** sur votre instance, avec leur numéro de version respectif
- Les **mentions légales** et informations de licence

Ces informations sont utiles pour :

- Vérifier la version de Dokos installée avant de contacter le support
- Confirmer quelles applications sont actives sur votre instance
- Communiquer les versions exactes lors d'un signalement de bug

**Exemple :** si vous contactez le support Dokos suite à un comportement inattendu sur une facture, ouvrez la boîte de dialogue « À propos » et transmettez les numéros de version affichés pour accélérer le diagnostic.

## Interface redessinée

Depuis la mise à jour du framework, la boîte de dialogue « À propos » bénéficie d'un **nouveau design** plus épuré :

- Présentation visuelle modernisée avec le logo du framework mis en avant
- Liste des applications plus lisible
- Meilleure cohérence avec le reste de l'interface Dodock


# Architecture technique

Dodock est un framework applicatif full-stack fondé sur les métadonnées. Il fournit tous les outils nécessaires pour déployer des applications métier en production : base de données, cache, tâches de fond et notifications temps réel.

## Vue d'ensemble

L'architecture de Dodock s'organise autour du concept de **bench** : un environnement qui héberge plusieurs **sites** (tenants) partageant les mêmes **applications**.

![Architecture Dodock](https://doc.dokos.io/content/dodock/architecture.svg)

### Concepts clés

| Concept         | Description                                                      |
| --------------- | ---------------------------------------------------------------- |
| **Bench**       | Environnement complet contenant applications, sites et processus |
| **Application** | Package Python qui étend le framework (dodock, dokos, etc.)      |
| **Site**        | Tenant avec sa propre base de données et configuration           |
| **DocType**     | Définition d'un type de document (schéma + comportements)        |
| **Document**    | Instance d'un DocType (enregistrement en base)                   |

### Architecture multi-tenant

Dodock est une plateforme **multi-tenant**. Chaque tenant (appelé "site") possède :

- Sa propre **base de données**
- Ses propres **fichiers** uploadés
- Sa propre **configuration**

Les applications sont partagées entre tous les sites du bench.

---

## Pile technique

Dodock repose sur une pile technique moderne et éprouvée.

### Composants principaux

| Composant       | Technologie                    | Rôle                            |
| --------------- | ------------------------------ | ------------------------------- |
| Base de données | **MariaDB**                    | Stockage persistant des données |
| Cache           | **Redis**                      | Cache, files d'attente, pub/sub |
| Backend         | **Python** (Werkzeug/Gunicorn) | Logique métier et API REST      |
| Temps réel      | **Node.js** (Socket.io)        | Notifications en direct         |
| Frontend        | **JavaScript** (Vue.js)        | Interface utilisateur           |
| Reverse Proxy   | **Nginx**                      | Routage et SSL (production)     |

### MariaDB

MariaDB stocke toutes les données : documents, métadonnées des DocTypes, utilisateurs et configurations. **Chaque site possède sa propre base de données**, garantissant une isolation complète en environnement multi-tenant.

### Redis

Trois instances Redis distinctes assurent différentes fonctions :

| Instance            | Rôle                                         |
| ------------------- | -------------------------------------------- |
| **redis\_cache**    | Cache en mémoire pour accélérer les lectures |
| **redis\_queue**    | Files d'attente pour les tâches de fond (RQ) |
| **redis\_socketio** | Pub/Sub pour la communication temps réel     |

---

## Structure des répertoires

L'initialisation d'un bench avec `bench init` crée cette structure :

```text
dokos-bench/
├── apps/                         # Applications installées
│   ├── frappe/                   # Framework (obligatoire)
│   ├── erpnext/                  # Application métier
│   └── custom_app/               # Applications personnalisées
│
├── sites/                        # Sites hébergés
│   ├── assets/                   # Assets compilés (JS, CSS)
│   ├── apps.txt                  # Apps installables
│   ├── common_site_config.json   # Configuration partagée
│   └── monsite.localhost/        # Répertoire du site
│       ├── site_config.json      # Configuration du site
│       ├── private/              # Fichiers privés
│       ├── public/               # Fichiers publics
│       └── locks/                # Verrous de synchronisation
│
├── config/                       # Configuration Redis
│   ├── redis_cache.conf
│   ├── redis_queue.conf
│   └── redis_socketio.conf
│
├── logs/                         # Journaux des processus
├── env/                          # Environnement virtuel Python
└── Procfile                      # Définition des processus
```

---

## Processus et services

L'exécution de Dodock nécessite des **services système** (base de données, cache) et des **processus applicatifs** (serveur web, workers).

Les services système dépendent de l'architecture de déploiement. Les processus applicatifs sont définis dans le `Procfile` en développement et dans `config/supervisor.conf` en production.

### Services système

| Service        | Rôle                                          |
| -------------- | --------------------------------------------- |
| **MariaDB**    | Base de données relationnelle                 |
| **Redis**      | Cache et files d'attente pour les workers     |
| **Nginx**      | Reverse proxy (production uniquement)         |
| **Supervisor** | Gestion des processus (production uniquement) |

### Processus applicatifs

**Serveur WSGI** : répond aux requêtes HTTP. En développement, `bench start` lance le serveur Werkzeug. En production, Gunicorn est configuré automatiquement via Supervisor.

**Workers Redis** : exécutent les tâches de fond (emails, rapports, calculs). Démarrés automatiquement par `bench start` en développement, configurés dans Supervisor en production.

**Scheduler** : planifie l'exécution des tâches programmées (horaires, quotidiennes, etc.). Même gestion que les workers.

### Développement vs Production

| Aspect        | Développement          | Production               |
| ------------- | ---------------------- | ------------------------ |
| Lancement     | `bench start`          | Supervisor               |
| Configuration | `Procfile`             | `config/supervisor.conf` |
| Serveur WSGI  | Werkzeug (mono-thread) | Gunicorn (multi-workers) |
| Reverse proxy | Non                    | Nginx                    |

### developer\_mode

`developer_mode` est un paramètre distinct du mode de déploiement. Lorsqu'il est activé, les modifications apportées aux DocTypes, rapports et autres composants via l'interface sont répercutées dans le dépôt de l'application.

Cette option s'active dans le fichier `site_config.json` du site :

```bash
sites/{votre_site}/site_config.json
```

```json
{
  "developer_mode": 1
}
```

**Activé** : les modifications apportées aux DocTypes, rapports, scripts et autres composants sont sauvegardées dans le code source de l'application. Elles peuvent être versionnées avec Git, partagées et déployées sur d'autres instances.

**Désactivé** : les modifications restent isolées sur l'instance courante. Elles ne sont pas synchronisées avec le dépôt de l'application, ce qui complique le suivi des changements et la collaboration.

L'accès complet aux options de développement nécessite d'être connecté en tant qu'**Administrator**.

---

### Résolution du site

Le framework détermine le site cible selon :

1. L'en-tête HTTP `Host` de la requête
2. L'en-tête `X-Frappe-Site-Name` (pour les API)
3. Le fichier `currentsite.txt` (en développement)

### Configuration

Chaque site possède un fichier `site_config.json` :

```json
{
  "db_name": "site1_db",
  "db_password": "••••••••",
  "encryption_key": "••••••••"
}
```

La configuration commune se trouve dans `common_site_config.json`.

---

## Cycle de vie d'une requête

1. **Réception** : Nginx reçoit la requête HTTP/WebSocket
2. **Routage** : Nginx route vers Gunicorn (HTTP) ou Socket.io (WebSocket)
3. **Résolution** : Le framework identifie le site via l'en-tête Host
4. **Authentification** : Vérification de la session utilisateur
5. **Cache** : Consultation du cache Redis
6. **Base de données** : Requête MariaDB si nécessaire
7. **Logique métier** : Exécution des contrôleurs et hooks
8. **Réponse** : Sérialisation JSON/HTML et envoi

---

## Pour aller plus loin

::card-group
  :::card
  ---
  icon: i-mdi-database-outline
  title: Modèle de données
  to: https://doc.dokos.io/v5/dodock/architecture/modele-donnees
  ---
  DocTypes, Documents et métadonnées
  :::

  :::card
  ---
  icon: i-mdi-folder-outline
  title: Structure d'une application
  to: https://doc.dokos.io/v5/dodock/architecture/structure-application
  ---
  Organisation et points d'extension
  :::

  :::card
  ---
  icon: i-mdi-console
  title: Commandes Bench
  to: https://doc.dokos.io/v5/dodock/administration/commandes
  ---
  Référence des commandes CLI
  :::
::


# Modèle de données

Dans Dodock, **tout est Document**. Cette abstraction uniforme simplifie le développement, l'extension et la maintenance des applications.

## Concepts fondamentaux

### DocType et Document

Un **DocType** est la définition d'un type de document : il décrit les champs, les comportements et les permissions. Un **Document** est une instance de ce DocType, c'est-à-dire un enregistrement en base de données.

::mermaid
```text
flowchart TB
    subgraph DocType["DocType : Facture de vente"]
        D1["Champs : client, montant, date, articles..."]
        D2["Permissions : lecture, création, soumission..."]
        D3["Comportements : soumissible, nommage auto..."]
    end

    DocType -->|définit| Documents

    subgraph Documents["Documents (instances)"]
        DOC1["FACT-00001<br/>Client A<br/>1 500 €"]
        DOC2["FACT-00002<br/>Client B<br/>2 300 €"]
        DOC3["FACT-00003<br/>Client A<br/>890 €"]
    end
```
::

### Analogie avec les bases de données

| Concept Dodock | Équivalent SQL | Description                     |
| -------------- | -------------- | ------------------------------- |
| DocType        | Table + Schéma | Définition de la structure      |
| Document       | Ligne (row)    | Enregistrement de données       |
| DocField       | Colonne        | Champ du document               |
| Link           | Clé étrangère  | Référence vers un autre DocType |
| Table          | Table enfant   | Relation 1-N intégrée           |

::callout{color="teal" icon="i-heroicons-light-bulb"}
**Fait amusant** : Un DocType est lui-même un Document, stocké dans le DocType "DocType". Cette approche récursive permet de modifier la structure des données depuis l'interface utilisateur.
::

---

## Types de champs (DocField)

Chaque champ d'un DocType est défini par :

- **fieldname** : Nom technique (snake\_case)
- **fieldtype** : Type de données
- **label** : Libellé affiché
- **reqd** : Obligatoire ou non

### Types de champs disponibles

| Type         | Description               | Exemple             |
| ------------ | ------------------------- | ------------------- |
| **Data**     | Texte court               | Nom, référence      |
| **Text**     | Texte long                | Description         |
| **Int**      | Nombre entier             | Quantité            |
| **Float**    | Nombre décimal            | Taux                |
| **Currency** | Montant monétaire         | Prix, total         |
| **Date**     | Date                      | Date de facturation |
| **Datetime** | Date et heure             | Horodatage          |
| **Check**    | Case à cocher             | Actif/Inactif       |
| **Select**   | Liste déroulante          | Statut              |
| **Link**     | Référence vers un DocType | Client, Article     |
| **Table**    | Table enfant              | Lignes de facture   |
| **Attach**   | Fichier joint             | Document PDF        |

### Champs de mise en page

| Type              | Description               |
| ----------------- | ------------------------- |
| **Section Break** | Nouvelle section          |
| **Column Break**  | Nouvelle colonne          |
| **Tab Break**     | Nouvel onglet             |
| **HTML**          | Contenu HTML personnalisé |

---

## Champs standards

Tous les documents possèdent automatiquement ces champs de métadonnées :

| Champ         | Type        | Description                      |
| ------------- | ----------- | -------------------------------- |
| `name`        | Data        | Identifiant unique du document   |
| `owner`       | Link (User) | Utilisateur créateur             |
| `creation`    | Datetime    | Date de création                 |
| `modified`    | Datetime    | Date de dernière modification    |
| `modified_by` | Link (User) | Dernier utilisateur modificateur |
| `docstatus`   | Int         | État du document                 |

### États du document (docstatus)

Pour les DocTypes **soumissibles** :

| Valeur | État      | Description             |
| ------ | --------- | ----------------------- |
| 0      | Brouillon | Modifiable, non validé  |
| 1      | Soumis    | Validé, non modifiable  |
| 2      | Annulé    | Annulé après soumission |

---

## Nommage des documents

Le champ `name` est l'identifiant unique de chaque document. Plusieurs stratégies de nommage sont disponibles :

| Stratégie      | Exemple           | Usage                   |
| -------------- | ----------------- | ----------------------- |
| **Série**      | `FACT-2024-00001` | Documents numérotés     |
| **Champ**      | Valeur d'un champ | Noms uniques naturels   |
| **Expression** | `{client}-{date}` | Combinaison de valeurs  |
| **Hash**       | `a1b2c3d4e5`      | Identifiants aléatoires |
| **Prompt**     | Saisie manuelle   | Cas particuliers        |

### Exemple de série

```python
# Dans le DocType, définir autoname :
autoname = "naming_series:"

# L'utilisateur choisit parmi les séries définies :
# FACT-.YYYY.-.#####  → FACT-2024-00001
# FAC-.MM.-.####      → FAC-01-0001
```

---

## Relations entre DocTypes

### Link (relation 1-1 ou N-1)

Un champ **Link** crée une référence vers un autre DocType.

::mermaid
```text
erDiagram
    Facture ||--o{ Client : "client (Link)"
    Facture {
        string name
        string client
        date date_facturation
        float montant
    }
    Client {
        string name
        string nom_complet
        string email
    }
```
::

### Table (relation 1-N)

Un champ **Table** intègre une table enfant directement dans le document parent.

::mermaid
```text
erDiagram
    FactureDeVente ||--|{ LigneFacture : "articles (Table)"
    FactureDeVente {
        string name
        string client
        date date
        float total
    }
    LigneFacture {
        string parent
        string article
        int quantite
        float montant
    }
```
::

**Exemple concret :**

| Facture de vente | Client A          |
| ---------------- | ----------------- |
| Date             | 2024-01-15        |
| **Articles**     |                   |
| ART-001          | 5 × 100 € = 500 € |
| ART-002          | 3 × 100 € = 300 € |
| **Total**        | **800 €**         |

---

## Cycle de vie d'un document

::mermaid
```text
flowchart TD
    A[before_insert] --> B[validate]
    B --> C{INSERT / SAVE}
    C --> D[after_insert<br/>after_save]
    D --> E{Soumission ?}
    E -->|oui| F[on_submit]
    E -->|non| G{Suppression ?}
    F --> H{Annulation ?}
    H -->|oui| I[on_cancel]
    H -->|non| G
    I --> G
    G -->|oui| J[on_trash]
    G -->|non| K((Fin))
    J --> K
```
::

### Événements disponibles

| Événement       | Moment           | Usage typique           |
| --------------- | ---------------- | ----------------------- |
| `before_insert` | Avant création   | Valeurs par défaut      |
| `validate`      | Avant sauvegarde | Validations métier      |
| `before_save`   | Avant sauvegarde | Calculs automatiques    |
| `after_insert`  | Après création   | Notifications           |
| `after_save`    | Après sauvegarde | Actions post-sauvegarde |
| `on_submit`     | À la soumission  | Écritures comptables    |
| `on_cancel`     | À l'annulation   | Contre-passations       |
| `on_trash`      | À la suppression | Nettoyage               |

---

## Pour aller plus loin

::card-group
  :::card
  ---
  icon: i-mdi-cog
  title: Personnaliser les DocTypes
  to: https://doc.dokos.io/v5/dodock/fonctionnalites/personnalisations/doctype
  ---
  Ajouter des champs et comportements
  :::

  :::card
  ---
  icon: i-mdi-api
  title: API Documents
  to: https://doc.dokos.io/v5/dodock/ressources/api/document_api
  ---
  Référence complète de l'API
  :::

  :::card
  ---
  icon: i-mdi-lock
  title: Rôles et permissions
  to: https://doc.dokos.io/v5/dodock/fonctionnalites/utilisateurs/role-et-autorisations
  ---
  Gérer les accès
  :::
::


# Structure d'une application

Une application Dodock est un package Python qui étend le framework. Elle s'installe dans le dossier `apps/` du bench.

---

## Arborescence

```text
mon_app/
├── mon_app/
│   ├── __init__.py
│   ├── hooks.py                  # Configuration et points d'extension
│   ├── modules.txt               # Liste des modules
│   ├── patches.txt               # Migrations de données
│   │
│   ├── templates/                # Templates Jinja (emails, impressions)
│   │   └── includes/
│   │
│   ├── www/                      # Pages du portail web public
│   │   └── ma_page.html
│   │
│   ├── public/                   # Assets statiques servis par le navigateur
│   │   ├── css/
│   │   ├── js/
│   │   └── images/
│   │
│   └── mon_module/               # Module métier
│       ├── __init__.py
│       ├── doctype/              # DocTypes du module
│       └── report/               # Rapports du module
│
├── pyproject.toml                # Dépendances Python
├── package.json                  # Dépendances Node.js (optionnel)
├── license.txt
├── MANIFEST.in
└── setup.py
```

---

## Dossiers principaux

| Dossier               | Contenu                                                              |
| --------------------- | -------------------------------------------------------------------- |
| `templates/`          | Templates Jinja pour emails, impressions PDF, snippets réutilisables |
| `templates/includes/` | Fragments HTML réutilisables dans d'autres templates                 |
| `www/`                | Pages web publiques accessibles sans authentification                |
| `public/`             | Fichiers statiques (CSS, JS, images) servis au navigateur            |
| `[module]/`           | Module métier contenant DocTypes et rapports                         |
| `[module]/doctype/`   | Définitions et contrôleurs des DocTypes                              |
| `[module]/report/`    | Rapports personnalisés (script reports)                              |

---

## Fichiers à la racine

| Fichier            | Rôle                                                     |
| ------------------ | -------------------------------------------------------- |
| `requirements.txt` | Dépendances Python (pip)                                 |
| `package.json`     | Dépendances Node.js pour les assets frontend (optionnel) |
| `setup.py`         | Configuration du package Python pour l'installation      |
| `MANIFEST.in`      | Liste des fichiers à inclure dans le package distribué   |
| `license.txt`      | Licence de l'application                                 |

---

## Fichiers de configuration

### hooks.py

Point d'entrée de l'application. Contient les métadonnées et la configuration des extensions.

```python
app_name = "mon_app"
app_title = "Mon Application"
app_publisher = "Mon Entreprise"
app_version = "1.0.0"

required_apps = ["dodock"]
```

### modules.txt

Liste des modules de l'application, un par ligne. Chaque module correspond à un dossier contenant des DocTypes et rapports.

```text
Mon Module
Autre Module
```

### patches.txt

Liste des migrations de données à exécuter lors des mises à jour.

```text
mon_app.patches.v1_0.migration_initiale
mon_app.patches.v1_1.ajouter_champ
```

---

## Structure d'un DocType

Chaque DocType possède son propre dossier :

```text
mon_doctype/
├── mon_doctype.json      # Définition (champs, permissions)
├── mon_doctype.py        # Contrôleur Python
├── mon_doctype.js        # Script client
├── mon_doctype_list.js   # Vue liste (optionnel)
└── test_mon_doctype.py   # Tests unitaires
```

| Fichier     | Rôle                                                 |
| ----------- | ---------------------------------------------------- |
| `.json`     | Schéma du DocType : champs, options, permissions     |
| `.py`       | Logique métier côté serveur (validation, événements) |
| `.js`       | Comportement de l'interface utilisateur              |
| `_list.js`  | Personnalisation de la vue liste                     |
| `test_*.py` | Tests automatisés                                    |

---

## Pour aller plus loin

::card-group
  :::card
  ---
  icon: i-mdi-database-outline
  title: Modèle de données
  to: https://doc.dokos.io/v5/dodock/architecture/modele-donnees
  ---
  DocTypes, Documents et métadonnées
  :::

  :::card
  ---
  icon: i-mdi-cog
  title: Personnalisations
  to: https://doc.dokos.io/v5/dodock/fonctionnalites/personnalisations/doctype
  ---
  Étendre les DocTypes existants
  :::
::


# Installation

::card-group
  :::card
  ---
  title: Installation standard
  to: https://doc.dokos.io/v5/dodock/installation/manuelle
  ---
  Installation complète sur un serveur Linux, pour un contrôle complet du logiciel
  :::

  :::card
  ---
  title: Installation Docker
  to: https://doc.dokos.io/v5/dodock/installation/docker
  ---
  Installation avec Docker, pour un déploiement rapide et simple
  :::
::


# Installation de Dokos v5 sur Ubuntu 24.04

::callout{color="teal" icon="i-heroicons-chat-bubble-left-right"}
Ce guide a été testé sur Ubuntu 24.04. Si une erreur se produit lors de l'installation, n'hésitez pas à poster un message sur le [forum](https://community.dokos.io){rel=""nofollow""} de la communauté. [Ce guide d'installation existe aussi pour Dokos v4](https://doc.dokos.io/v5/dodock/installation/plus/dokos-v4).
::

## Pré-requis

Le serveur Ubuntu doit posséder au moins 4 Go de RAM, 40 Go d'espace disque, ainsi qu'un utilisateur **non root** avec accès `sudo`.

### Création d'un utilisateur

Si ça n'est pas déjà le cas, par exemple si votre serveur est nouvellement créé, vous devrez créer un utilisateur non-root et lui donner les droits `sudo`. Ensuite, connectez-vous à votre serveur via SSH avec cet utilisateur.

Commandes pour créer un utilisateur

```sh
adduser dokos
```

```sh
usermod -aG sudo dokos
rsync --archive --chown=dokos:dokos ~/.ssh /home/dokos
exit
```

Ces étapes sont extraites du [guide de démarrage Ubuntu par Digital Ocean](https://www.digitalocean.com/community/tutorials/initial-server-setup-with-ubuntu){rel="&#x22;nofollow&#x22;"}.

### Python (v3.14 ou +)

Tout d'abord, vérifiez que Python 3.14 ou ultérieur est installé sur votre machine, puis installez les paquets supplémentaires.

```sh
python3.14 --version
# Python 3.14.x
sudo apt-get install python3.14 python3.14-dev python3.14-venv
```

Vous pouvez installer Python 3.14 avec les commandes suivantes :

```sh
sudo add-apt-repository ppa:deadsnakes/ppa
sudo apt-get update -y
sudo apt-get install python3.14 python3.14-dev python3.14-venv
```

### Git, Redis, wkhtmltopdf, etc.

Ensuite, installez les paquets suivants :

```sh
# Mise à jour des dépôts
sudo apt-get install -y git redis-server ca-certificates file pkg-config default-libmysqlclient-dev build-essential xvfb libfontconfig wkhtmltopdf
```

::callout{color="teal" icon="i-heroicons-light-bulb"}
`wkhtmltopdf` est utilisé pour produire des documents PDF depuis Dodock/Dokos.
Il s'agit de la version *0.12.6 with patched qt*.
::

### MariaDB (v10.8 ou ultérieur)

```sh
sudo apt-get install -y mariadb-server mariadb-client
```

Pendant l'installation, vous devrez choisir un mot de passe pour l'utilisateur *root* pour votre base de données.
Ce dernier doit être précieusement conservé, il vous sera demandé lors de la création de chaque site et pour certaines opérations de maintenance.

Pour le configurer ou le modifier, vous pouvez lancer la commande suivante :

```sh
sudo mariadb-secure-installation
# > Enter current password for root (enter for none):
# Laissez vide et appuyez sur Entrée à la première question.

# > Switch to unix_socket authentication [Y/n] n
# Répondre non (n) à la question, car nous utiliserons l'authentification par mot de passe.

# > Set root password? [Y/n] Y
# Répondre oui (Y), puis entrer un mot de passe sécurisé pour l'utilisateur `root` de la base de données.
# Ce mot de passe sera demandé à chaque création de site, ainsi que lors ce certaines opérations de maintenance.

# Ensuite, répondre oui (Y) à toutes les questions suivantes.
# > Remove anonymous users? [Y/n] Y
# > Disallow root login remotely? [Y/n] Y
# > Remove test database and access to it? [Y/n] Y
# > Reload privilege tables now? [Y/n] Y
```

Vérifiez que vous pouvez vous connecter à la base de données avec le mot de passe que vous avez défini :

```sh
mysql -u root -p
# Pour quitter la console, tapez `exit`
```

### NodeJS (v20 ou ultérieur) et yarn

Vous pouvez installer NodeJS via [nvm](https://github.com/nvm-sh/nvm#installing-and-updating){rel="&#x22;nofollow&#x22;"} ou le gestionnaire de paquets de votre distribution.

```sh
curl -o - https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
. "$HOME/.nvm/nvm.sh"
nvm install 24
npm install -g yarn

# Créez un lien symbolique pour que NodeJS soit accessible facilement à tous les utilisateurs
sudo ln -s $(which node) /usr/bin/
```

Vérifiez que NodeJS a bien été installé

```sh
node -v
# v24.x.y
```

### Dokos CLI

Dokos CLI est une ligne de commande, adaptée de [Bench](https://github.com/frappe/bench){rel="&#x22;nofollow&#x22;"}, permettant de gérer vos sites et applications Dodock. Vous pouvez l'installer grâce à `pip`.

```sh
export PATH=$PATH:$HOME/.local/bin
printf '\n%s\n' 'export PATH=$PATH:$HOME/.local/bin' >> ~/.bashrc
pip install --user --upgrade --quiet --break-system-packages dokos-cli
```

Ensuite, vérifiez que Dokos CLI a bien été installée :

```sh
bench --version
# 2.9.2
```

::callout{color="teal" icon="i-heroicons-light-bulb"}
Si la commande `bench` n'est pas trouvée, relancez votre terminal pour que les modifications de votre variable d'environnement `PATH` soient prises en compte. En dernier recours, vous pouvez aussi ajouter la ligne `export PATH=$PATH:$HOME/.local/bin` à votre fichier `~/.bashrc`.
::

## Démarrage du serveur et installation d'un site

### Création d'un bench

Un bench est un ensemble de sites et d'applications, et se crée avec les commandes suivantes :

```sh
cd  # Retournez dans votre dossier personnel
bench init dokos-bench --version v5 --python $(which python3.14)
cd dokos-bench
```

Ensuite, téléchargez les applications que vous souhaitez installer sur vos sites.
Nous vous recommandons les applications suivantes pour démarrer, mais [beaucoup d'autres applications sont disponibles](https://doc.dokos.io/v5/integrations).

```sh
# Téléchargez les applications de base
bench get-app --branch v5 payments
bench get-app --branch v5 dokos
bench get-app --branch v5 webshop
bench get-app --branch v5 hrms
# bench get-app --branch v5 blog
# bench get-app --branch v5 bookings
```

### Démarrage du serveur

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Si vous souhaitez installer Dokos en *mode développement*, suivez les instructions suivantes. Vous pouvez ignorer les instructions du *mode production*.

[Cliquez ici pour afficher/masquer les instructions du mode développement]{.font-medium.underline}

Activer le `developer_mode` et lancer le serveur avec `bench start` vous permet de voir vos modifications de code en temps réel. Vous devrez lancer le serveur manuellement à chaque redémarrage de votre ordinateur.

```sh
# Dans un NOUVEAU terminal, lancez le serveur de développement manuellement
bench start

# Vous pouvez masquer la fenêtre

# Retournez dans le terminal précédent, puis créez un site.
bench new-site monsite.dokos.cloud

# Puis activez le mode développeur
bench --site monsite.dokos.cloud set-config developer_mode 1
```
::

::div{.doc-install--production-only}
Vérifiez que vous êtes bien dans le *bench* que vous venez de créer puis lancez les commandes suivantes pour activer le *mode production* de Dokos.

```sh
sudo mkdir -p /root/.config/pip
printf "[global]\nbreak-system-packages = true\n" | sudo tee -a /root/.config/pip/pip.conf
sudo python3 -m pip install -U -q dokos-cli
sudo -H bench setup production $USER
```

  :::callout{color="teal" icon="i-heroicons-chat-bubble-left-right"}
  <https://discuss.frappe.io/t/guide-how-to-install-erpnext-v16-on-linux-ubuntu-24-04-step-by-step-instructions/159255#p-491392-seven-setup-production-environment-9>{rel=""nofollow""}
  :::
::

### Création d'un site

Créez votre site et installez les applications dont vous avez besoin.

```sh
# Créez un site (remplacez `monsite.dokos.cloud` par le nom de domaine de votre choix)
bench new-site monsite.dokos.cloud

# Installez les applications dont vous avez besoin
bench --site monsite.dokos.cloud install-app payments dokos webshop hrms
```

::callout{color="teal" icon="i-heroicons-chat-bubble-left-right"}
Si une erreur se produit lors de l'installation, n'hésitez pas à poster un message sur le [forum](https://community.dokos.io){rel=""nofollow""}.
::

### Finaliser l'installation

Par défaut, Nginx accède aux fichiers de votre site en tant qu'utilisateur `www-data` à l'aide d'un lien symbolique.
Pour que cela fonctionne, vous devez donner à Nginx le droit de traverser votre dossier utilisateur et suivre le lien symbolique.

```sh
setfacl --modify user:www-data:x ~
```

Une fois le site créé, vous pouvez vous connecter et accéder à l'interface d'administration avec l'une des adresses suivantes :

- Si vous avez un enregistrement DNS configuré qui pointe vers votre serveur : <http://monsite.dokos.cloud>{rel="&#x22;nofollow&#x22;"}
- Si Dokos est installé sur votre ordinateur directement en mode développement : <http://localhost:8000>{rel="&#x22;nofollow&#x22;"}

Utilisez les identifiants suivants :

- Adresse email : `Administrator`
- Mot de passe : le mot de passe que vous avez choisi lors de la création du site.

Suivez les instructions du « Setup Wizard », l'outil d'installation de Dokos, pour finaliser l'installation.

### Pour aller plus loin

Pour le rendre accessible depuis l'extérieur, il faut configurer un enregistrement DNS qui pointe vers votre serveur, et configurer Let's Encrypt pour obtenir un certificat SSL.

::card-group
  :::card
  ---
  icon: i-mdi-lock-outline
  title: DNS multi-tenant
  to: https://doc.dokos.io/v5/dodock/administration/domaine
  ---
  Configuration du nom de domaine
  :::

  :::card
  ---
  icon: i-mdi-lock-outline
  title: Let's Encrypt
  to: https://doc.dokos.io/v5/dodock/administration/certificat
  ---
  Configuration du certificat SSL avec Let's Encrypt
  :::
::

### Questions Fréquentes

> Le site s'affiche sans mise en forme ni couleurs ?

- Vérifiez que votre dossier utilisateur serveur est bien accessible pour Nginx.
- Vous pouvez donner les droits de lecture en lançant `chmod +x /home/{votre utilisateur}`

### Références

- <https://community.dokos.io/t/installation-v5-auto-heberge/1784>{rel="&#x22;nofollow&#x22;"}
- <https://discuss.frappe.io/t/guide-how-to-install-erpnext-v16-on-linux-ubuntu-24-04-step-by-step-instructions/159255>{rel="&#x22;nofollow&#x22;"}


# Installation de Dokos avec Docker

## Pré-requis

### Installer Docker

Si Docker n'est pas installé sur votre serveur, vous pouvez utiliser la commande suivante ou [vous reporter à la documentation de Docker](https://docs.docker.com/engine/install/){rel="&#x22;nofollow&#x22;"}.

```bash
curl -fsSL https://get.docker.com | sudo bash
```

Ensuite, suivez [les étapes de post-installation Docker si nécessaire](https://docs.docker.com/engine/install/linux-postinstall/){rel="&#x22;nofollow&#x22;"}.

```bash
sudo groupadd docker
sudo usermod -aG docker $USER
exit
```

Enfin, vérifiez l'installation de Docker avec les commandes suivantes.

```bash
docker --version
docker compose version
docker run hello-world
```

### Télécharger le fichier Compose pour Dokos

Téléchargez le fichier `compose.yaml` pour Dokos depuis le dépôt GitLab de Docli (`bench` comme nous le verrons plus tard).
Par défaut, la version de Dokos utilisée est la dernière version stable, disponible avec le tag `latest`.

```bash
curl -o compose.yaml https://gitlab.com/dokos/docli/-/raw/develop/compose/dokos.yaml
```

## Lancer Dokos

Vous pouvez ensuite lancer le conteneur de Dokos avec :

```bash
docker compose up -d
```

La création du site peut prendre quelques minutes. Pendant cette étape, le site ne sera pas actif et donc indisponible dans votre navigateur.

## Accéder à Dokos

Vous pouvez accéder à Dokos en accédant au port 8080 du serveur dans votre navigateur, par exemple <http://localhost:8080>{rel="&#x22;nofollow&#x22;"} si le conteneur tourne sur votre ordinateur.

Ensuite, vous pouvez vous connecter avec les identifiants suivants :

- Nom d'utilisateur : `Administrator`
- Mot de passe : `admin`

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
N'oubliez pas de changer le mot de passe de l'utilisateur `Administrator` après la finalisation de l'installation.
Pour changer le mot de passe d'administration, cliquez sur l'avatar (cercle coloré en haut tout à droite), puis cliquez sur l'option Mes Paramètres.
Cliquez sur l'onglet Paramètres, puis ouvrez la section Modification de mot de passe, dans laquelle vous pourrez changer le mot de passe.
::

## Arrêter Dokos

Pour arrêter Dokos, vous pouvez utiliser la commande suivante :

```bash
docker compose down
```

## Configurer son nom de domaine

Pour accéder à Dokos via votre nom de domaine (ex. <https://demo.dokos.cloud>{rel="&#x22;nofollow&#x22;"}), il va falloir installer les éléments suivants sur votre serveur:

- *Nginx*: Reverse proxy permettant de rediriger votre nom de domaine vers le port 8080 de votre serveur
- *Certbot*: Utilitaire permettant de créer un certificat SSL pour une connexion sécurisée

::callout{color="teal" icon="i-heroicons-light-bulb"}
La configuration présentée ici est simple et a pour but de vous permettre de déployer facilement un site Dokos. :br
Nous vous recommandons de renforcer cette configuration avec toutes les mesures de sécurité qui vous semblent appropriées.
::

### 1. Effectuer une redirection DNS

La première étape consiste à aller dans les paramètres DNS de votre nom de domaine et à ajouter une entrée de redirection A vers le serveur sur lequel vous avez installé Dokos.

Ex. demo.dokos.cloud | A | 15.237.107.35

### 2. Installation de Nginx

Sur Ubuntu, l'installation de Nginx se fait avec la commande suivante:
`sudo apt install nginx`

Une foix Nginx installé, créez un fichier de configuration pour votre site dans le dossier `/etc/nginx/sites-enabled/`:

`sudo nano /etc/nginx/sites-enabled/demo.conf`

Ajoutez-y une redirection vers le port 8080 dans ce fichier et enregistrez le:

```text
server {
    server_name demo.dokos.cloud; # A remplacer par votre nom de domaine

    location / {
        proxy_set_header   X-Forwarded-For $remote_addr;
        proxy_set_header   Host $http_host;
        proxy_pass         http://127.0.0.1:8080;
    }
}
```

Redémarrez Nginx et connectez-vous à l'adresse `demo.dokos.cloud` pour vérifier que la redirection fonctionne bien.

```text
sudo nginx -t
sudo systemctl reload nginx
```

### 3. Création d'un certificat

Installez certbot (<https://certbot.eff.org/>{rel="&#x22;nofollow&#x22;"}) sur votre système. :br
Pour Ubuntu:

```bash
sudo snap install --classic certbot
sudo ln -s /snap/bin/certbot /usr/bin/certbot
```

Lancez certbot pour générer un certificat: `sudo certbot --nginx`

Rechargez la page de votre site (ex. `demo.dokos.cloud`), vous pourrez constater que votre certificat est actif.

### 4. Configuration du nom de domaine dans Docker

Le nom de domaine configuré par défaut est <http://localhost:8080>{rel="&#x22;nofollow&#x22;"} ceci afin de permettre que les images s'affichent sur les PDF imprimés.

Pour définir le nom de domaine dans la configuration du site afin qu'il corresponde à la configuration serveur, vous pouvez exécuter la commande suivante :

```bash
docker compose run backend bench --site frontend set-config host_name https://site.example.com'
```

## Sauvegarder, restaurer, mettre à jour

### Sauvegarder Dokos

Pour sauvegarder Dokos **une fois lancé**, vous pouvez utiliser la commande suivante :

```bash
# Le système doit être up pour effectuer une sauvegarde
docker compose run backend bench backup --with-files --compress
```

Si vous souhaitez récupérer ces sauvegardes depuis l'extérieur du conteneur, vous avez plusieurs possibilités :

- Utiliser `docker cp` pour copier les fichiers depuis le conteneur vers votre machine.

  ```bash
  docker cp dokos-backend-1:/home/frappe/frappe-bench/sites/frontend/private/backups/ ./dokos-backups
  ```
- Utiliser `docker run` pour dupliquer les volumes `db-data` et `sites`.
  <https://docs.docker.com/storage/volumes/#back-up-restore-or-migrate-data-volumes>{rel="&#x22;nofollow&#x22;"}

### Restaurer Dokos

Pour restaurer Dokos, vous devez d'abord démarrer le système et suivre cette procédure :

```bash
# Le projet dokos doit être up pour effectuer une restauration
docker compose up -d

# Lister les sauvegardes disponibles
docker compose run backend ls sites/frontend/private/backups

# Restaurer la sauvegarde en spécifiant le nom du fichier
docker compose run backend bench restore \
    [...]-frontend-database.sql.gz \
    --with-public-files [...]-frontend-files.tar.gz \
    --with-private-files [...]-frontend-private-files.tar.gz
```

### Mettre à jour Dokos

Pour mettre à jour Dokos, vous pouvez utiliser la commande suivante :

```bash
# Modifiez le numéro de version dans le fichier compose.yaml si besoin

# Télécharger les nouvelles images Docker
docker compose pull

# Relancer les conteneurs
docker compose down
docker compose up -d

# Migrer les sites
docker compose run backend bench --site all migrate
```

### Résolution de problèmes

- La page du bureau est vide après une mise à jour : il faut toujours démonter les conteneurs avec la commande `docker compose down` après une mise à jour.


# Installation de Dokos v4 sur Ubuntu 24.04

::callout{color="teal" icon="i-heroicons-chat-bubble-left-right"}
Ce guide a été testé sur Ubuntu 24.04. Si une erreur se produit lors de l'installation, n'hésitez pas à poster un message sur le [forum](https://community.dokos.io){rel=""nofollow""} de la communauté. [Ce guide d'installation existe aussi pour Ubuntu 22](https://doc.dokos.io/v5/dodock/installation/plus/ubuntu-22).
::

## Pré-requis

Le serveur Ubuntu doit posséder au moins 4 Go de RAM, 40 Go d'espace disque, ainsi qu'un utilisateur **non root** avec accès `sudo`.

### Création d'un utilisateur

Si ça n'est pas déjà le cas, par exemple si votre serveur est nouvellement créé, vous devrez créer un utilisateur non-root et lui donner les droits `sudo`. Ensuite, connectez-vous à votre serveur via SSH avec cet utilisateur.

Commandes pour créer un utilisateur

```sh
adduser dokos
```

```sh
usermod -aG sudo dokos
rsync --archive --chown=dokos:dokos ~/.ssh /home/dokos
exit
```

Ces étapes sont extraites du [guide de démarrage Ubuntu par Digital Ocean](https://www.digitalocean.com/community/tutorials/initial-server-setup-with-ubuntu){rel="&#x22;nofollow&#x22;"}.

### Python (v3.10 à v3.12)

Tout d'abord, vérifiez que Python 3.10 ou ultérieur est installé sur votre machine.

```sh
python3 --version
# Python 3.12.3
```

Ensuite, installez pip et venv :

```sh
sudo apt-get update -y
sudo apt-get install -y python3-pip python3-venv
```

### Git, Redis et wkhtmltopdf

Ensuite, installez les paquets suivants :

```sh
# Mise à jour des dépôts
sudo apt-get install -y git redis-server ca-certificates file
sudo apt-get install -y xvfb libfontconfig wkhtmltopdf
```

::callout{color="teal" icon="i-heroicons-light-bulb"}
`wkhtmltopdf` est utilisé pour produire des documents PDF depuis Dodock/Dokos.
Il s'agit de la version *0.12.6 with patched qt*.
::

### MariaDB (v10.8 ou ultérieur)

```sh
sudo apt-get install -y mariadb-server mariadb-client
```

Pendant l'installation, vous devrez choisir un mot de passe pour l'utilisateur *root* pour votre base de données.
Ce dernier doit être précieusement conservé, il vous sera demandé lors de la création de chaque site et pour certaines opérations de maintenance.

Pour le configurer ou le modifier, vous pouvez lancer la commande suivante :

```sh
sudo mariadb-secure-installation
# > Enter current password for root (enter for none):
# Laissez vide et appuyez sur Entrée à la première question.

# > Switch to unix_socket authentication [Y/n] n
# Répondre non (n) à la question, car nous utiliserons l'authentification par mot de passe.

# > Set root password? [Y/n] Y
# Répondre oui (Y), puis entrer un mot de passe sécurisé pour l'utilisateur `root` de la base de données.
# Ce mot de passe sera demandé à chaque création de site, ainsi que lors ce certaines opérations de maintenance.

# Ensuite, répondre oui (Y) à toutes les questions suivantes.
# > Remove anonymous users? [Y/n] Y
# > Disallow root login remotely? [Y/n] Y
# > Remove test database and access to it? [Y/n] Y
# > Reload privilege tables now? [Y/n] Y
```

Vérifiez que vous pouvez vous connecter à la base de données avec le mot de passe que vous avez défini :

```sh
mysql -u root -p
# Pour quitter la console, tapez `exit`
```

### NodeJS (v20 ou ultérieur) et yarn

Vous pouvez installer NodeJS via [nvm](https://github.com/nvm-sh/nvm#installing-and-updating){rel="&#x22;nofollow&#x22;"} ou le gestionnaire de paquets de votre distribution.

```sh
curl -o - https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
. "$HOME/.nvm/nvm.sh"
nvm install 20
npm install -g yarn

# Créez un lien symbolique pour que NodeJS soit accessible facilement à tous les utilisateurs
sudo ln -s $(which node) /usr/bin/
```

Vérifiez que NodeJS a bien été installé

```sh
node -v
# v20.x.y
```

### Dokos CLI

Dokos CLI est une ligne de commande, adaptée de [Bench](https://github.com/frappe/bench){rel="&#x22;nofollow&#x22;"}, permettant de gérer vos sites et applications Dodock. Vous pouvez l'installer grâce à `pip`.

```sh
export PATH=$PATH:$HOME/.local/bin
printf '\n%s\n' 'export PATH=$PATH:$HOME/.local/bin' >> ~/.bashrc
pip install --user --upgrade --quiet --break-system-packages dokos-cli
```

Ensuite, vérifiez que Dokos CLI a bien été installée :

```sh
bench --version
# 2.8.1
```

::callout{color="teal" icon="i-heroicons-light-bulb"}
Si la commande `bench` n'est pas trouvée, relancez votre terminal pour que les modifications de votre variable d'environnement `PATH` soient prises en compte. En dernier recours, vous pouvez aussi ajouter la ligne `export PATH=$PATH:$HOME/.local/bin` à votre fichier `~/.bashrc`.
::

## Démarrage du serveur et installation d'un site

### Création d'un bench

Un bench est un ensemble de sites et d'applications, et se crée avec les commandes suivantes :

```sh
cd  # Retournez dans votre dossier personnel
bench init dokos-bench --version v4
cd dokos-bench
```

Ensuite, téléchargez les applications que vous souhaitez installer sur vos sites.
Nous vous recommandons les applications suivantes pour démarrer, mais [beaucoup d'autres applications sont disponibles](https://doc.dokos.io/v5/integrations)

```sh
# Téléchargez les applications de base
bench get-app --branch v4 payments
bench get-app --branch v4 dokos
bench get-app --branch v4 webshop
bench get-app --branch v4 hrms
```

### Démarrage du serveur

::callout
---
class: bg-amber-500/10
color: amber
icon: i-heroicons-exclamation-triangle
---
Si vous souhaitez installer Dokos en *mode développement*, suivez les instructions suivantes. Vous pouvez ignorer les instructions du *mode production*.

[Cliquez ici pour afficher/masquer les instructions du mode développement]{.font-medium.underline}

Activer le `developer_mode` et lancer le serveur avec `bench start` vous permet de voir vos modifications de code en temps réel. Vous devrez lancer le serveur manuellement à chaque redémarrage de votre ordinateur.

```sh
# Dans un nouveau terminal, lancez le serveur de développement manuellement
bench start

# Retournez dans le terminal précédent puis activez le mode développeur
bench --site monsite.dokos.cloud set-config developer_mode 1
```
::

::div{.doc-install--production-only}
Vérifiez que vous êtes bien dans le *bench* que vous venez de créer puis lancez les commandes suivantes pour activer le *mode production* de Dokos.

```sh
sudo mkdir -p /root/.config/pip
printf "[global]\nbreak-system-packages = true\n" | sudo tee -a /root/.config/pip/pip.conf
sudo python3 -m pip install -U -q dokos-cli
sudo -H bench setup production $USER
```
::

### Création d'un site

Créez votre site et installez les applications dont vous avez besoin.

```sh
# Créez un site (remplacez `monsite.dokos.cloud` par le nom de domaine de votre choix)
bench new-site monsite.dokos.cloud

# Installez les applications dont vous avez besoin
bench --site monsite.dokos.cloud install-app payments dokos webshop hrms
```

::callout{color="teal" icon="i-heroicons-chat-bubble-left-right"}
Si une erreur se produit lors de l'installation, n'hésitez pas à poster un message sur le [forum](https://community.dokos.io){rel=""nofollow""}.
::

### Finaliser l'installation

Par défaut, Nginx accède aux fichiers de votre site en tant qu'utilisateur `www-data` à l'aide d'un lien symbolique.
Pour que cela fonctionne, vous devez donner à Nginx le droit de traverser votre dossier utilisateur et suivre le lien symbolique.

```sh
setfacl --modify user:www-data:x ~
```

Une fois le site créé, vous pouvez vous connecter et accéder à l'interface d'administration avec l'une des adresses suivantes :

- Si vous avez un enregistrement DNS configuré qui pointe vers votre serveur : <http://monsite.dokos.cloud>{rel="&#x22;nofollow&#x22;"}
- Si Dokos est installé sur votre ordinateur directement en mode développement : <http://localhost:8000>{rel="&#x22;nofollow&#x22;"}

Utilisez les identifiants suivants :

- Adresse email : `Administrator`
- Mot de passe : le mot de passe que vous avez choisi lors de la création du site.

Suivez les instructions du « Setup Wizard », l'outil d'installation de Dokos, pour finaliser l'installation.

### Pour aller plus loin

Pour le rendre accessible depuis l'extérieur, il faut configurer un enregistrement DNS qui pointe vers votre serveur, et configurer Let's Encrypt pour obtenir un certificat SSL.

::card-group
  :::card
  ---
  icon: i-mdi-lock-outline
  title: DNS multi-tenant
  to: https://doc.dokos.io/v5/dodock/administration/domaine
  ---
  Configuration du nom de domaine
  :::

  :::card
  ---
  icon: i-mdi-lock-outline
  title: Let's Encrypt
  to: https://doc.dokos.io/v5/dodock/administration/certificat
  ---
  Configuration du certificat SSL avec Let's Encrypt
  :::
::

### Questions Fréquentes

> Le site s'affiche sans mise en forme ni couleurs ?

- Vérifiez que votre dossier utilisateur serveur est bien accessible pour Nginx.
- Vous pouvez donner les droits de lecture en lançant `chmod +x /home/{votre utilisateur}`


# Docker personnalisé

> Ce tutoriel utilise l'outil [Frappe Docker](https://github.com/frappe/frappe_docker){rel="&#x22;nofollow&#x22;"} pour déployer Dokos sous Docker. :br
> Pour bien comprendre Frappe Docker, veuillez vous référer à sa [documentation](https://github.com/frappe/frappe_docker/#production){rel="&#x22;nofollow&#x22;"}.

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Ce tutoriel est à destination de la communauté Dokos et dépend du projet Frappe Docker, il peut donc ne pas être à jour.
N'hésitez pas à ouvrir un ticket sur <https://gitlab/dokos/documentation>{rel=""nofollow""} si c'est le cas.
::

# Configuration avancée avec Docker

## Frappe Docker

[Frappe Docker](https://github.com/frappe/frappe_docker){rel="&#x22;nofollow&#x22;"} est un projet communautaire permettant d'installer Frappe et ERPNext dans des conteneurs Docker. :br
Dodock étant basé sur le framework Frappe, il est possible d'utiliser ce projet en changeant quelques éléments afin de lancer Dodock et Dokos dans des conteneurs Docker.

## Docker

Si Docker et Docker Compose ne sont pas installés sur votre serveur, vous pouvez utiliser la commande suivante ou vous reporter à la documentation de Docker.

```text
# Install docker and docker-compose-plugin
curl -fsSL https://get.docker.com | bash
```

## Création des images

Afin de pouvoir lancer un site Dokos dans un conteneur Docker, il faut commencer par construire les images qui seront utilisées. :br
Les modifications de configuration proposées ci-dessous permettent de générer des images incluant Dodock, Payments, Dokos et HRMS. :br
Vous pouvez modifier la configuration pour exclure HRMS ou Payments + Dokos.

> Rappel: Payments est une application nécessaire au fonctionnement de Dokos. Vous ne pouvez pas l'exclure sans exclure Dokos.

1. Étape 1: Clonez `https://github.com/frappe/frappe_docker`

```bash
git clone https://github.com/frappe/frappe_docker
```

2. Étape 2: Configurez les applications à installer dans l'image finale.

```bash
export APPS_JSON='[
    {
        "url": "https://gitlab.com/dokos/payments",
        "branch": "v4"
    },
    {
        "url": "https://gitlab.com/dokos/hrms",
        "branch": "v4"
    },
    {
        "url": "https://gitlab.com/dokos/dokos",
        "branch": "v4"
    }
]'
export APPS_JSON_BASE64=$(echo ${APPS_JSON} | base64 -w 0)
```

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Pour chaque variable de version pensez à mettre à jour avec la version de l'application que vous souhaitez installer. :br
Les dernières versions sont disponibles dans les répertoires GitLab de chaque application.
::

3. Étape 3: Construisez l'image à partir de `images/custom/Dockerfile`.

```bash
docker build \
  --build-arg=FRAPPE_PATH=https://gitlab.com/dokos/dodock \
  --build-arg=FRAPPE_BRANCH=v4 \
  --build-arg=PYTHON_VERSION=3.10 \
  --build-arg=NODE_VERSION=18.17.0 \
  --build-arg=APPS_JSON_BASE64=$APPS_JSON_BASE64 \
  --tag=custom-dokos:v4 \
  --file=images/custom/Containerfile .
```

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Pour la variable `FRAPPE_BRANCH`, pensez à la mettre à jour avec la version de Dodock que vous souhaitez installer.
::

## Création d'un site Dokos

Avant de lancer la création de votre site Dokos, éditez le fichier `pwd.yml` et remplacez la version des images d'ERPNext par le tag que vous avez utilisé lors de la construction de vos images.

```diff
@@ -2,7 +2,7 @@ version: "3"
 
 services:
   backend:
-    image: frappe/erpnext:v14.17.1
+    image: custom-dokos:v4
 
   configurator:
-    image: frappe/erpnext:v14.17.1
+    image: custom-dokos:v4
 
   create-site:
-    image: frappe/erpnext:v14.17.1
+    image: custom-dokos:v4

   frontend:
-    image: frappe/erpnext:v14.17.1
+    image: custom-dokos:v4
 
   queue-default:
-    image: frappe/erpnext:v14.17.1
+    image: custom-dokos:v4
 
   queue-long:
-    image: frappe/erpnext:v14.17.1
+    image: custom-dokos:v4
 
   queue-short:
-    image: frappe/erpnext:v14.17.1
+    image: custom-dokos:v4
 
   scheduler:
-    image: frappe/erpnext:v14.17.1
+    image: custom-dokos:v4
 
   websocket:
-    image: frappe/erpnext:v14.17.1
+    image: custom-dokos:v4
```

De plus, si vous souhaitez installer HRMS sur votre site, modifiez la ligne suivante :

```diff
@@ -68,7 +68,7 @@ services:
           fi
         done;
         echo "sites/common_site_config.json found";
-        bench new-site frontend --no-mariadb-socket --admin-password=admin --db-root-password=admin --install-app erpnext --set-default;
+        bench new-site frontend --no-mariadb-socket --admin-password=admin --db-root-password=admin --install-app dokos --install-app hrms --set-default;
```

Vous pouvez ensuite lancer votre site Dokos, en utilisant la commande :

```bash
docker compose -p dokos -f pwd.yml up -d
```

L'installation du site peut prendre quelques minutes, vous pouvez suivre son avancement avec la commande `docker logs dokos-create-site-1 -f`, ou simplement attendre avec `docker wait dokos-create-site-1`.

Ensuite, vous pouvez suivre les instructions de l'installation standard Docker de Dokos.

## Anciennes méthodes et liens utiles

- [Communauté Dokos --- Fichier .gitlab-ci.yml pour génération automatique d'images Docker de Dokos](https://community.dokos.io/t/fichier-gitlab-ci-yml-pour-generation-automatique-dimages-docker-de-dokos/629){rel="&#x22;nofollow&#x22;"} (par Adrien)
- [GitLab --- Dokidocker](https://gitlab.com/dokos/dokidocker){rel="&#x22;nofollow&#x22;"} (par Dokos)
- [GitHub --- Monogramm/docker-dokos-ext](https://github.com/Monogramm/docker-dokos-ext){rel="&#x22;nofollow&#x22;"} (par Christophe et Mathieu)


# Installation sur RHEL

::community-tutorial-notice
::

# Installation de Dokos sur plateformes RHEL (CentOS, AlmaLinux, RockyLinux) 8 et 9

Ce guide explique comment installer Dokos v2 ou v3 sur les plateformes Redhat (RHEL, AlmaLinux, CentOS, RockyLinux) EL8 ou EL9.

Bien qu'en dehors du scope du présent document, il convient de préparer le système hôte pour l'ERP Dokos comme suit:

- Le chemin /var contiendra les fichiers de l'ERP, une partition dédiée est souhaitable
- Configurer les éventuels guest tools s'il s'agit d'une machine virtuelle (VMWare, Qemu, HyperV...)
- Configurer un serveur NTP de préférence intra-réseau
- Configurer la sécurité, les accès, ainsi que la traçabilité (voir guide sécurité dédié ainsi que guide OpenSCAP)
- Configurer le tuning machine (voir guide dédié tuned-adm avec profil dédié NPF-APP et valeurs thread siblings)
- Installer les outils de diagnostics habituels (net-tools bind-utils nano sysstat iotop htop iftop atop nmon telnet lsof traceroute) disponibles essentiellement sur le depot EPEL
- Configurer la supervision (Prometheus ou SNMPd)

## Installation des prérequis

### Prérequis standards

Installer les paquets permettant la compilation des modules yarn

```sh
dnf install -y git tar bzip2 openssl-devel libffi-devel gcc
```

Pour la mise en production, il faudra en outre installer l'outil d'automatisation ansible:

```sh
# Pour RHEL 8 et clones
dnf -y install ansible
# Pour RHEL 9 et clones
dnf -y install ansible-core
```

### Configuration spécifique du système

#### Modèle Inotify (mode développement uniquement)

Lors de l'exécution de Dokos en mode développement, le kernel hook inotify est utilisé par le framework JS pour surveiller les changements de fichiers. Par défaut, la limite de fichiers que RHEL 8 surveille est fixé à 8192 pour des raisons de performances, et les logs du framework peuvent contenir des erreurs de type

> `UnhandledPromiseRejectionWarning: Error: ENOSPC: System limit for number of file watchers reached, watch '/var/dokos/dokos-erp/apps/frappe/frappe/public/scss/common/quill.scss' 23:53:21 watch.1 | at FSWatcher.<computed> (internal/fs/watchers.js:243:19)`

Pour un environnement de développement, il est possible de lever cette limite comme suit:

```sh
echo "fs.inotify.max_user_watches=$((1024*512))" | sudo tee -a /etc/sysctl.d/90-dokos.conf
```

Chaque fichier surveillé consomme 1Ko de mémoire, dans notre exemple, pour surveiller 512Ko fichiers, il faudra 512Mo de mémoire vive.

Dans un environnement de production, il faut penser à vider les caches de fichiers précédents de nodejs afin de réduire cette quantité de fichiers à surveiller.

#### Mémoire VM

Afin d'éviter que les enregistrements en tâche de fond échouent si la mémoire vive est faible:

```sh
echo "vm.overcommit_memory=1" | sudo tee -a /etc/sysctl.d/90-dokos.conf
```

#### TCP Backlog

Pour optimiser les performances de redis, il faudra modifier le paramètre suivant:

```sh
echo "net.core.somaxconn=65535" | sudo tee -a /etc/sysctl.d/90-dokos.conf
```

#### Chargement paramètres

Il faudra recharger les paramètres à la volée pour une application sans attendre le redémarrage.

```sh
sysctl --load /etc/sysctl.d/90-dokos.conf
```

#### Désactivation des Transparent Huge Pages (THP) via le mode opt-in par processus en utilisant la directive « madvise »

Il faudra changer les arguments kernel dans /etc/default/grub comme suit en ajoutant « transparent\_hugepage=madvise ». Exemple:

> ```sh
> GRUB_CMDLINE_LINUX="crashkernel=auto resume=UUID=598eec09-15a8-4cc9-b1ed-17d2b41b5594 transparent_hugepage=madvise"
> ```

Une fois enregistré, il faudra recréer une configuration de boot

```sh
find /boot -iname "grub.cfg" | xargs grub2-mkconfig -o
```

### Préparation du service de base de données MySQL

#### Installation et préparation de la base de données MariaDB

S'assurer que la version de MariaDB soit >= 10.3.x via la commande suivante:

```sh
dnf list mariadb-server
```

Lancer l'installation via la commandes suivantes:

```sh
# Pour RHEL 8 et clones
dnf -y install mariadb-server mariadb-devel
# Pour RHEL 9 et clones
dnf -y install mariadb-server
```

#### Configuration du serveur et du client

Ajouter les directives suivantes dans la section `[mysql]` du fichier `/etc/my.cnf.d/mariadb-server.cnf`

```sh
# NETPERFECT-BZ012: Optimisation des performances mono serveur
table_cache             = 1000
# NETPERFECT-BZ131: Permet l'import de fichiers SQL disposant de INSERT statements trop longs (ERROR 2006 (HY000) at line 696: MySQL server has gone away)
max_allowed_packet      = 128M
# NETPERFECT-BZ065: Augmenter la taille du fichier log INNODB pour permetttre de jouer de plus grandes requêtes (info: MySQL server has gone away.). Additional info: https://jira.kopano.io/browse/KC-1053
innodb_log_file_size    = 128M
# NETPERFECT-BZ213: Augmenter la durée maximale d'absence de requête pour éviter l'erreur (MySQL server has gone away)
wait_timeout            = 288000
# NETPERFECT-BZ003: Chaque table INNODB doit posséder son propre fichier afin de faciliter la récuperation de données en cas de crash
innodb-file-per-table   = 1

# NETPERFECT-BZ401: Do not set client handshake (dokos)
character-set-client-handshake = FALSE
# NETPERFECT-BZ232: Set default collation for most applications
character-set-server           = utf8mb4
# NETPERFECT-BZ232: Set default collation for most applications
collation-server               = utf8mb4_unicode_ci
```

Ajouter les directives suivantes dans la section `[mysql]` du fichier `etc/my.cnf.d/mysql-clients.cnf`

```sh
NETPERFECT-BZ232: Set default collation for most applications
default-character-set = utf8mb4
```

Une fois configuré, vous pourrez lancer le service MariaDB avec la commande suivante

```sh
systemctl enable --now mariadb
```

la configuration de sécurité se fera en lançant la commande

```sh
mariadb-secure-installation
```

La configuration est légèrement différente entre RHEL 8 et RHEL 9. Depuis RHEL 9, les connexions en tant qu'utilisateur root sont possibles sans mot de passe en utilisant un socket unix.

Sous RHEL 8, il faudra ajouter un fichier de mot de passe afin d'arriver à un résultat identique.

Créer le fichier `/root/.my.cnf` suivant

```sh
[client]
password="VotreMotDePasseSuperSécuriséMySQL"
```

### Préparation de la base de données redis

Depuis le Framework Frappe v13 (dokos v2.x), le prérequis minimal est redis 6.x.

RHEL 8 est fourni avec redis 5.x par défaut et RHEL 9 est fourni avec redis 6.x par défaut.

```sh
# Pour RHEL 8 et clones
dnf module enable redis:6
dnf install redis -y
# Pour RHEL 9 et clones
dnf install redis -y
```

### Préparation de l'environnement nodeJS

Depuis le Framework Frappe v13 (dokos v2.x), le prérequis minimal est nodejs 14.x.

Depuis le Framework Frappe v14 (dokos v3.x), le prérequis minimal est nodejs 16.x

RHEL 8 est fourni avec nodejs 14.x par défaut et RHEL 9 est fourni avec nodejs 16.x par défaut.

```sh
# Pour RHEL 8 et clones
dnf module enable nodejs:14
dnf install nodejs -y
# Pour RHEL 9 et clones
dnf install nodejs -y
```

### Installation du manager de packages JS yarn

#### Solution d'installation en tant que paquet RPM

Cette solution à l'avantage de mettre à jour automatiquement yarn avec le système.

Depuis le framework Frappe v13, le prérequis minimal est yarn 1.12.

Installation du dépôt yarn

```sh
curl --silent --location https://dl.yarnpkg.com/rpm/yarn.repo | tee /etc/yum.repos.d/yarn.repo
rpm --import https://dl.yarnpkg.com/rpm/pubkey.gpg
```

Installation de yarn

```sh
dnf install -y yarn
```

#### Solujtion d'installation via npm

Alternativement, il est possible d'installer yarn via le gestionnaire de packages nodejs:

```sh
npm install -g yarn
```

### Préparation de l'environnement Python

Depuis le Framework Frappe v13 (dokos v2.x), le prérequis minimal est python 3.8.x

Depuis le Framework Frappe v14 (dokos v3.x), le prérequis minimal est python 3.10.x

#### Configuration de python pour dokos v2.x

RHEL 8 est fourni avec python 3.8. RHEL 9 est fourni avec python 3.9.

Pour dokos v2.x, il sera donc possible d'utiliser l'interpréteur système

```sh
dnf install -y python-pip
python3 -m pip install --upgrade pip
python3 -m pip install --upgrade setuptools wheel virtualenv
```

#### Configuration de python pour dokos v3.x

Dokos v3.x utilise python 3.10+. Au 12/12/2022, aucune dépot officiel de python 3.10 n'existe pour RHEL. Il faudra donc compiler manuellement Python et l'installer dans un chemin alternatif `/usr/local/bin/python3` pour ne pas interférer avec l'interpréteur python fourni par le système.

```sh
# Dépendances de compilation python
dnf install -y wget yum-utils make gcc openssl-devel bzip2-devel libffi-devel zlib-devel
# Dépendances de compilation de modules python nécessaires pour le framework Frappe
dnf install -y libpq-devel gcc-c++ libjpeg-turbo-devel libjpeg-turbo-utils
mkdir /opt/python310 && cd /opt/python310
# Attention: Vérifier sur python.org s'il existe une archive plus récente
curl -OL https://www.python.org/ftp/python/3.10.9/Python-3.10.9.tgz
tar xvf Python-3.10.9.tgz
cd Python-3.10.9
./configure --with-system-ffi --with-computed-gotos --enable-loadable-sqlite-extensions
make -j ${nproc}
make altinstall
alias python3=/usr/local/bin/python3
```

### Installation de wkhtmltopdf

Il faut se rendre sur la page « <https://github.com/wkhtmltopdf/packaging/releases>{rel="&#x22;nofollow&#x22;"} pour télécharger la dernière version.

```sh
# Pour RHEL 8 et clones
cd /opt
curl -OL https://github.com/wkhtmltopdf/packaging/releases/download/0.12.6.1-2/wkhtmltox-0.12.6.1-2.almalinux8.x86_64.rpm
dnf localinstall wkhtmltox-0.12.6.1-2.almalinux8.x86_64.rpm
dnf install nodejs -y
# Pour RHEL 9 et clones
cd /opt
curl -OL https://github.com/wkhtmltopdf/packaging/releases/download/0.12.6.1-2/wkhtmltox-0.12.6.1-2.almalinux9.x86_64.rpm
dnf localinstall wkhtmltox-0.12.6.1-2.almalinux9.x86_64.rpm
```

La version de wkhtmlpdf doit avoir été compilée avec le support de la librairie qt.

Il est possible de vérifier que le patch QT soit appliqué avec la commande suivante

```sh
wkhtmltopdf -v 2>&1 | grep qt
```

> wkhtmltopdf 0.12.6 (with patched qt)

Afin que les documents PDF générés par Dokos soient conformes à leur version HTML, il conviendra également d'installer les polices Truetype Microsoft avec la commande suivante:

```text
dnf localinstall https://www.itzgeek.com/msttcore-fonts-2.0-3.noarch.rpm
```

## Installation de l'ERP Dokos

L'ERP Dokos est un fork de erpnext, lui même basé sur le framework Frappe. Le framework Frappe s'administre avec l'outil `bench` (aussi nommé `docli` chez Dokos).

### Création de l'utilisateur dédié

Afin d'améliorer la sécurité, dokos devrait être installé en tant qu'utilisateur non root.

Création d'un utilisateur dédié dont le dossier utilisateur sera stocké dans /var/dokos

```sh
user-add --home-dir /var/dokos -G wheel dokos
# Création d'un mot de passe pour l'utilisateur dokos
passwd dokos
su - dokos
```

### Installation du Framework docli (Frappe Bench)

Afin que l'installation se déroule avec succès, il est conseillé de régler temporairement les variables linguistiques sur le standard C, afin que les scripts d'installations automatisés reçoivent des sorties standards des commandes telles que date sans se soucier de la langue.

```sh
# En tant qu'utilisateur dokos
export LC_ALL=C.UTF-8
cd /var/dokos && sudo python3 -m pip install dokos-cli
```

Cette opération installera une copie locale de `docli` qui est un alias de `bench`

#### Création d'une nouvelle instance Dodock (Frappe framework)

```sh
# En tant qu'utilisateur dokos
cd /var/dokos && docli init --frappe-branch master dokos-erp
```

Le résultat devrait ressembler à ceci:

> $ /usr/local/bin/virtualenv --quiet env -p python3 :br
> $ /var/dokos/dokos-erp/env/bin/python -m pip install --quiet --upgrade pip :br
> Getting dodock :br
> $ git clone <https://gitlab.com/dokos/dodock.git>{rel="&#x22;nofollow&#x22;"} --branch master --depth 1 --origin upstream :br
> Clonage dans 'dodock'... :br
> remote: Enumerating objects: 4828, done. :br
> remote: Counting objects: 100% (4828/4828), done. :br
> remote: Compressing objects: 100% (4556/4556), done. :br
> remote: Total 4828 (delta 447), reused 2995 (delta 197), pack-reused 0 :br
> Réception d'objets: 100% (4828/4828), 21.74 Mio | 13.96 Mio/s, fait. :br
> Résolution des deltas: 100% (447/447), fait. :br
> Installing frappe :br
> $ /var/dokos/dokos-erp/env/bin/python -m pip install --quiet --upgrade -e /var/dokos/dokos-erp/apps/frappe :br
> $ yarn install :br
> yarn install v1.22.18 :br
> \[1/4] Resolving packages... :br
> \[2/4] Fetching packages... :br
> \[3/4] Linking dependencies... :br
> warning " > @fullcalendar/vue\@5.10.1" has incorrect peer dependency "vue@^2.6.12". :br
> warning " > bootstrap\@4.5.0" has unmet peer dependency "jquery\@1.9.1 - 3". :br
> warning " > bootstrap\@4.5.0" has unmet peer dependency "popper.js@^1.16.0". :br
> \[4/4] Building fresh packages... :br
> Done in 15.04s. :br
> $ bench build :br
> yarn run v1.22.18 :br
> $ FRAPPE\_ENV=production node rollup/build.js :br
> clean: postcss.plugin was deprecated. Migration guide: :br<https://evilmartians.com/chronicles/postcss-8-plugin-migration>{rel="&#x22;nofollow&#x22;"}:br
> Production mode :br
> ✔ Built js/moment-bundle.min.js :br
> ✔ Built js/libs.min.js
>
> Building frappe assets...
>
> ✔ Built js/checkout.min.js :br
> ✔ Built js/dialog.min.js :br
> ✔ Built js/user\_profile\_controller.min.js :br
> ✔ Built js/frappe-vue.min.js :br
> ✔ Built js/bootstrap-4-web.min.js :br
> ✔ Built js/barcode\_scanner.min.js :br
> Browserslist: caniuse-lite is outdated. Please run: :br
> npx browserslist\@latest --update-db :br
> Browserslist: caniuse-lite is outdated. Please run next command \`yarn upgrade caniuse-lite browserslist\` :br
> ✔ Built css/frappe-rtl.css :br
> ✔ Built js/frappe-recorder.min.js :br
> ✔ Built css/report.min.css :br
> ✔ Built js/web\_form.min.js :br
> ✔ Built css/web\_form.css :br
> ✔ Built css/frappe-chat-web.css :br
> ✔ Built js/report.min.js :br
> ✔ Built js/data\_import\_tools.min.js :br
> ✔ Built js/chat.js :br
> ✔ Built js/frappe-web.min.js :br
> ✔ Built js/desk.min.js :br
> ✔ Built js/events-portal.min.js :br
> ✔ Built js/list.min.js :br
> ✔ Built css/printview\.css :br
> ✔ Built js/control.min.js :br
> ✔ Built css/website-calendar.min.css :br
> ✔ Built css/email.css :br
> ✔ Built css/login.css :br
> ✔ Built css/frappe-web-b4.css :br
> ✔ Built js/form.min.js :br
> ✔ Built css/desk.min.css :br
> ✨ Done in 111.635s :br
> Done in 113.26s. :br
> SUCCESS: Bench dokos-erp initialized

#### Installation des dépendances python du framework Frappe

Au lieu d'une installation en tant que site-packages, les dépendances du framework Frappe seront installés directement dans l'environnement virtuel python crée pour le framework.

```sh
# En tant qu'utilisateur dokos
python3 -m venv /var/dokos/dokos-erp/env
/var/dokos/dokos-erp/env/bin/python -m pip install --upgrade -e /var/dokos/dokos-erp/apps/frappe
```

#### Installation de l'application ERP dokos

UNe fois le framework configuré, il sera alors possible d'installer dokos comme suit

```sh
# En tant qu'utilisateur dokos
cd /var/dokos/dokos-erp && docli get-app --branch master https://gitlab.com/dokos/dokos
```

La sortie devrait ressembler à ceci:

> Getting dokos :br
> $ git clone <https://gitlab.com/dokos/dokos>{rel="&#x22;nofollow&#x22;"} --branch master --depth 1 --origin upstream :br
> Cloning into 'dokos'... :br
> warning: redirecting to <https://gitlab.com/dokos/dokos.git/>{rel="&#x22;nofollow&#x22;"}:br
> remote: Enumerating objects: 5773, done. :br
> remote: Counting objects: 100% (5773/5773), done. :br
> remote: Compressing objects: 100% (4740/4740), done. :br
> remote: Total 5773 (delta 1454), reused 3419 (delta 796), pack-reused 0 :br
> Receiving objects: 100% (5773/5773), 17.10 MiB | 17.00 MiB/s, done. :br
> Resolving deltas: 100% (1454/1454), done. :br
> Installing erpnext :br
> $ /var/dokos/dokos-erp/env/bin/python -m pip install --quiet --upgrade -e /var/dokos/dokos-erp/apps/erpnext :br
> $ yarn install :br
> yarn install v1.22.18 :br
> \[1/4] Resolving packages... :br
> \[2/4] Fetching packages... :br
> \[3/4] Linking dependencies... :br
> \[4/4] Building fresh packages... :br
> Done in 1.53s. :br
> $ bench build --app erpnext :br
> yarn run v1.22.18 :br
> $ FRAPPE\_ENV=production node rollup/build.js --app erpnext :br
> clean: postcss.plugin was deprecated. Migration guide: :br<https://evilmartians.com/chronicles/postcss-8-plugin-migration>{rel="&#x22;nofollow&#x22;"}:br
> Production mode :br
> ✔ Built js/moment-bundle.min.js :br
> ✔ Built js/libs.min.js
>
> Building erpnext assets...
>
> ✔ Built js/erpnext-web.min.js :br
> ✔ Built js/item-dashboard.min.js :br
> ✔ Built js/erpnext.min.js :br
> ✔ Built js/portal-payments.min.js :br
> ✔ Built js/point-of-sale.min.js :br
> Browserslist: caniuse-lite is outdated. Please run: :br
> npx browserslist\@latest --update-db :br
> Browserslist: caniuse-lite is outdated. Please run next command \`yarn upgrade caniuse-lite browserslist\` :br
> ✔ Built css/erpnext-web.css :br
> ✔ Built css/erpnext.css :br
> ✔ Built js/bank-reconciliation.min.js :br
> ✔ Built js/bank-transaction-importer.min.js :br
> ✔ Built js/portal-calendars.min.js :br
> ✔ Built js/resource-calendar.min.js :br
> ✨ Done in 38.242s :br
> Done in 39.81s.

Note: L'erreur suivante peut apparaître

```sh
ERROR: pip's dependency resolver does not currently take into account all the packages that are installed. This behaviour is the source of the following dependency conflicts. frappe 2.13.0 requires PyJWT~=1.7.1, but you have pyjwt 2.3.0 which is incompatible.
```

#### Création d'un site

Par défaut, l'application dokos installée sur le framework n'est pas accessible publiquement.

Il convient de créer un site (nom de domaine) sur lequel le framework servira les applications qu'il héberge.

Le nom du site devra respecter la nomenclature DNS et pourra être un FQDN arbitraire (exemple: erp.masociete.local) ou un FQDN attaché à un nom de domaine existant (exemple: erp.monsite-societe.fr)

```sh
# En tant qu'utilisateur dokos
cd /var/dokos/dokos-erp && docli new-site <FQDN DE VORTE SITE>
docli --site <FQDN DE VOTRE SITE> set-config hostname http://<FQDN DE VOTRE SITE]
```

Dans le cas d'un FQDN arbitraire qui n'est pas résolu par un serveur DNS, il faudra ajouter les entrées suivantes au fichier `/etc/hosts` permettant au serveur local de résoudre le nom du site

```sh
127.0.0.1   localhost localhost.localdomain localhost4 localhost4.localdomain4 <FQDN DE VOTRE SITE>
::1         localhost localhost.localdomain localhost6 localhost6.localdomain6 <FQDN DE VOTRE SITE>
```

La sortie de la commande de création de site devrait ressembler à ceci:

> MySQL root password:
>
> Installing frappe... :br
> Updating DocTypes for frappe : \[========================================] 100% :br
> Updating country info : \[========================================] 100% :br
> Set Administrator password: :br
> Re-enter Administrator password: :br
> \*\*\* Scheduler is disabled \*\*\* :br
> Current Site set to `<FQDN DE VOTRE SITE>`

#### Installation de l'application dokos sur le site crée

```sh
# En tant qu'utilisateur dokos
cd /var/dokos/dokos-erp && docli --site <FQDN DE VOTRE SITE> install-app dokos
```

La sortie devrait ressembler à ceci:

> Installing erpnext... :br
> Updating DocTypes for erpnext : \[========================================] 100% :br
> Updating customizations for Address :br
> Updating customizations for Contact :br
> Updating customizations for Payment Gateway

#### Fin d'installation

L'installation de l'ERP dokos est terminée et vous pouvez mettre fin à la session de l'utilisateur dokos.

```sh
# Redevenir utilisateur root
exit
```

A partir d'ici, vous pouvez tester dokos en mode développement ou alors configurer le serveur en mode production.

#### Optionnel: Démarrage du framework et l'ensemble des sites en mode développement

```sh
# En tant qu'utilisateur root
sudo -u dokos "cd /var/dokos/dokos-erp && docli start"
```

Remarque: Si les logs sont remplis d'erreurs de type `ENOSPC`, il faudra vérifier la configuration du nombre de noeuds inotify (voir ci-dessus) et vérifier l'espace disque disponible.

Dokos sera servi sur le port 8000. Il faudra donc configurer le parefeu.

```sh
# En tant qu'utilisateur root
firewall-cmd --add-port=8000/tcp
```

Cette commande ouvrira le port 8000 jusqu'au redémarrage du serveur. Si aucune mise en production aura lieu sur ce serveur, il sera possible de configurer de rendre cette configuration permanente

```sh
# En tant qu'utilisateur root
firewall-cmd --runtime-to-permanent
```

L'environnement dokos sera disponible à l'adresse `http://[IP-DU-SERVEUR]:8000`

## Mise en production

### Configuration de l'environnement de production

#### Ajout des dépendances nécessaires à la mise en production

Le dépot EPEL est repuis pour fail2ban et supervisor.

```sh
# En tant qu'utilisateur root
dnf install -y epel-release
dnf install -y fail2ban nginx supervisor
```

#### Droits d'accès

```sh
# En tant qu'utilisateur root
chmod 750 /var/dokos
usermod -aG dokos nginx
```

#### Configuration SELinux

Le système de production crée un lien symbolique du fchier nginx de configuration local vers le dossier de configuration nginx.

Il est nécessaire de changer le contexte de sécurité SELinux pour autoriser le chargement de ce fichier par nginx hors du dossier /etc/nginx.

```sh
# En tant qu'utilisateur root
semanage fcontext -a -t httpd_config_t /var/dokos/dokos-erp/config/nginx.conf
restorecon -Rv /var/dokos/dokos-erp/config/nginx.conf
```

Il faudra également autoriser nginx à se connecter à internet:

```sh
# En tant qu'utilisateur root
setsebool -P httpd_can_network_connect 1
```

Enfin, il faudra rendre le dossier sites lisible pour nginx:

```sh
# En tant qu'utilisateur root
site=[NOM SITE DOKOS]
http_ro_content=(/var/dokos/dokos-erp/sites/assets /var/dokos/dokos-erp/apps/frappe/frappe/public /var/dokos/dokos-erp/apps/erpnext/erpnext/public /var/dokos/dokos-erp/apps/erpnext/node_modules /var/dokos/dokos-erp/apps/frappe/node_modules /var/dokos/dokos-erp/sites/$site/public)
http_rw_content=(/var/dokos/dokos-erp/sites/$site/public/files /var/dokos/dokos-erp/sites/$site/private/files)
for path in ${http_ro_content[@]}; do semanage fcontext -a -t httpd_sys_content_t "${path}(/.*)?"; restorecon -Rv "${path}"; done
for path in ${http_rw_content[@]}; do semanage fcontext -a -t httpd_sys_rw_content_t "${path}(/.*)?"; restorecon -Rv "{$path}"; done
```

### Setup automatisé production Dokos

#### Choix de la gestion des services

Afin de vérifier la bonne exécution de l'ensemble des services, il faudra choisir entre utiliser des services systemd ou utiliser supervisord. Dans ce guide, nous utiliserons supervisord.

```sh
# En tant qu'utilisateur dokos
cd /var/dokos/dokos-erp && docli setup supervisor
```

#### Setup de production

Note: les patchs <https://gitlab.com/dokos/docli/-/merge_requests/2>{rel="&#x22;nofollow&#x22;"} <https://gitlab.com/dokos/docli/-/merge_requests/3>{rel="&#x22;nofollow&#x22;"} et <https://gitlab.com/dokos/docli/-/merge_requests/4>{rel="&#x22;nofollow&#x22;"} doivent être intégrés.

L'action suivante configurera supervisord et nginx:

```sh
# En tant qu'utilisateur dokos
cd /var/dokos/dokos-erp && sudo env "PATH=$PATH" docli setup production dokos
```

#### Vérification

Afin de vérifier que l'ensemble des processus nécessaires au fonctionnement de dokos sont actifs, il faudra exécuter les commandes suivantes:

```sh
supervisorctl status
systemctl status nginx
```

### Setup services supplémentaires

#### Firewall

Pour un serveur de production, il faudra ouvrir les ports HTTP et HTTPS de manière permanente:

```sh
# En tant qu'utilisateur dokos
cd /var/dokos/dokos-erp && sudo env "PATH=$PATH" docli setup firewall
```

#### Fail2ban

Fail2ban permettra de bannir une IP tentant une authentification par brute force

```sh
# En tant qu'utilisateur dokos
cd /var/dokos/dokos-erp && sudo env "PATH=$PATH" docli setup fail2ban
```


# Installation par script

::community-tutorial-notice
::

# Installation à l'aide d'un script bash

Il est possible d'installer Dokos sous Debian 12 ou Ubuntu 22.04 à l'aide du script ci dessous qui va installer tous les paquets nécessaires et poser les questions de paramétrage tel que le nom de la Base de Données, de l'utilisateur et de son mot de passe. Dokos sera installé dans le dossier "$HOME/$bench\_folder" de l'utilisateur qui lance le script.

```text
#!/usr/bin/env bash

# Retrieve server IP
server_ip=$(hostname -I | awk '{print $1}')

#Retrieve script folder
script_folder=$(pwd)

# Setting up colors for echo commands
YELLOW='\033[1;33m'
GREEN='\033[0;32m'
RED='\033[0;31m'
LIGHT_BLUE='\033[1;34m'
NC='\033[0m' # No Color

# Checking Supported OS and distribution
SUPPORTED_DISTRIBUTIONS=("Ubuntu" "Debian")
SUPPORTED_VERSIONS=("22.04" "12")

check_os() {
    local os_name=$(lsb_release -is)
    local os_version=$(lsb_release -rs)
    local os_supported=false
    local version_supported=false

    for i in "${SUPPORTED_DISTRIBUTIONS[@]}"; do
        if [[ "$i" = "$os_name" ]]; then
            os_supported=true
            break
        fi
    done

    for i in "${SUPPORTED_VERSIONS[@]}"; do
        if [[ "$i" = "$os_version" ]]; then
            version_supported=true
            break
        fi
    done

    if [[ "$os_supported" = false ]] || [[ "$version_supported" = false ]]; then
        echo -e "${RED}This script is not compatible with your operating system or its version.${NC}"
        exit 1
    fi
}

# Detect the platform (similar to $OSTYPE)
OS="`uname`"
case $OS in
  'Linux')
    OS='Linux'
    if [ -f /etc/redhat-release ] ; then
      DISTRO='CentOS'
    elif [ -f /etc/debian_version ] ; then
      if [ "$(lsb_release -si)" == "Ubuntu" ]; then
        DISTRO='Ubuntu'
      else
        DISTRO='Debian'
      fi
    fi
    ;;
  *) ;;
esac


ask_twice() {
    local prompt="$1"
    local secret="$2"
    local val1 val2

    while true; do
        if [ "$secret" = "true" ]; then

            read -rsp "$prompt: " val1

            echo >&2
        else
            read -rp "$prompt: " val1
            echo >&2
        fi
        
        if [ "$secret" = "true" ]; then
            read -rsp "Confirm password: " val2
            echo >&2
        else
            read -rp "Confirm password: " val2
            echo >&2
        fi

        if [ "$val1" = "$val2" ]; then
            printf "${GREEN}Password confirmed${NC}" >&2
            echo "$val1"
            break
        else
            printf "${RED}Inputs do not match. Please try again${NC}\n" >&2
            echo -e "\n"
        fi
    done
}
echo -e "${LIGHT_BLUE}Welcome to the Dokos Installer...${NC}"
echo -e "\n"
sleep 3

# Check OS and version compatibility for all versions
check_os

bench_folder="dokos-bench-folder"
benchdir="$HOME/$bench_folder"

#First Let's take you home
cd $(sudo -u $USER echo $HOME)
echo -e "\n"

#Now let's make sure your instance has the most updated packages
echo -e "${YELLOW}Updating system packages...${NC}"
sleep 2
sudo apt update
sudo apt upgrade -y
echo -e "${GREEN}System packages updated.${NC}"
sleep 2

#Now let's install a couple of requirements: git, curl and pip
echo -e "${YELLOW}Installing preliminary package requirements${NC}"
sleep 3
sudo apt install software-properties-common git curl -y

#Next we'll install the python environment manager...
py_version=$(python3 --version 2>&1 | awk '{print $2}')
py_major=$(echo "$py_version" | cut -d '.' -f 1)
py_minor=$(echo "$py_version" | cut -d '.' -f 2)
py_version=$(echo "$py_major"."$py_minor")
echo -e "${YELLOW}Installing additional Python packages and Redis Server${NC}"
sleep 2
sudo apt install ca-certificates git python3-dev python3-setuptools python3-venv python3-pip python3-distutils redis-server xvfb libfontconfig wkhtmltopdf -y && \
# Mise à jour des dépôts
sudo apt --fix-broken install -y && \
sudo apt install fontconfig xvfb libfontconfig xfonts-base xfonts-75dpi libxrender1 -y && \

echo -e "${GREEN}Done!${NC}"
sleep 1
echo -e "\n"
#... And mariadb with some extra needed applications.
echo -e "${YELLOW}Now installing MariaDB.${NC}"
sleep 2
sudo apt install mariadb-server mariadb-client -y
echo -e "${GREEN}MariaDB and other packages have been installed successfully.${NC}"
sleep 2


#Install NVM, Node, npm and yarn
echo -e ${YELLOW}"Now to install NVM, Node, npm and yarn${NC}"
sleep 2
curl https://raw.githubusercontent.com/creationix/nvm/master/install.sh | bash

# Add environment variables to .profile
echo 'export NVM_DIR="$HOME/.nvm"' >> ~/.profile
echo '[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"  # This loads nvm' >> ~/.profile
echo '[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"  # This loads nvm bash_completion' >> ~/.profile

# Source .profile to load the new environment variables in the current session
source ~/.profile

# Conditional Node.js installation based on the version of ERPNext selected
nvm install 18
node_version="18"
sudo apt-get -qq install npm -y
sudo npm install -g yarn
echo -e "${GREEN}Package installation complete!${NC}"
sleep 2

# Now let's reactivate virtual environment if needed and install bench
echo -e "${YELLOW}Now let's reactivate virtual environment if needed and install bench${NC}"
sleep 4
python3 -m venv $USER && \
source $USER/bin/activate
nvm use $node_version
pip3 install --upgrade --quiet dokos-cli


#Initiate bench in $bench_folder folder, but get a supervisor can't restart bench error...
echo -e "${YELLOW}Initialising bench in $bench_folder folder.${NC}" 
echo -e "${LIGHT_BLUE}If you get a restart failed, don't worry, we will resolve that later.${NC}"
sleep 4
bench init $bench_folder --version v4 --verbose
echo -e "${GREEN}Bench installation complete!${NC}"
sleep 2

sudo -k

# Prompt user for site name
echo -e "${YELLOW}Preparing for new site installation. This could take a minute... or two so please be patient.${NC}"
read -p "Enter the site name (If you wish to install SSL later, please enter a FQDN): " site_name
sleep 1
admin_pwd=$(ask_twice "Enter the Administrator password" "true")
echo -e "\n"
sleep 1

#Next let's set some important parameters.
read -p "Choose a name for Dokos's database and database's username: " db_name
sleep 1
db_pwd=$(ask_twice "Choose a password for the Dokos's database's username" "true")
echo -e "\n"
sleep 1

#Now we'll go through the required settings of the mysql_secure_installation...
echo -e ${YELLOW}"Now we'll go ahead to apply MariaDB security settings...${NC}"
sleep 2
    
sudo mysql -u root -e "CREATE USER '$db_name'@'localhost' IDENTIFIED BY '$db_pwd';"
sudo mysql -u root -e "CREATE DATABASE IF NOT EXISTS $db_name CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;"
sudo mysql -u root -e "GRANT ALL PRIVILEGES ON $db_name . * TO '$db_name'@'localhost';"
sudo mysql -u root -e "FLUSH PRIVILEGES;"

#sudo service mysql restart
echo -e "${GREEN}MariaDB settings done!${NC}"
echo -e "\n"
sleep 1

echo -e "${YELLOW}Now setting up your site. This might take a few minutes. Please wait...${NC}"
sleep 1
# Change directory to $bench_folder
cd $bench_folder && \

sudo chmod -R o+rx /home/$(echo $USER)

echo -e "${YELLOW}Installing apps Payments, Dokos and Hrms to the bench. Please wait...${NC}"
sleep 1
bench get-app --branch v4 payments
bench get-app --branch v4 dokos
bench get-app --branch v4 hrms

echo -e "${YELLOW}Installing the website and initalising its database. Please wait...${NC}"
sleep 1

bench new-site $site_name --db-name $db_name --db-password $db_pwd --no-setup-db --admin-password $admin_pwd

### fail2ban était installé et paramétré par la commande "sudo bench setup production $USER" mais n'est plus traité dans ce script du coup

echo -e "${YELLOW}Installing packages and dependencies for Production...${NC}"
sleep 2

# Install and setup supervisor and nginx config
sudo apt install nginx supervisor -y
sudo bash -c 'cat << EOF >> /etc/nginx/conf.d/'"$bench_folder"'.conf
upstream '"$bench_folder"'-frappe {
    server 127.0.0.1:8000 fail_timeout=0;
}

upstream '"$bench_folder"'-socketio-server {
    server 127.0.0.1:9000 fail_timeout=0;
}

server {
    
    listen 80;
    listen [::]:80;

    server_name '"$site_name"';

    root '"$benchdir"'/sites;

    proxy_buffer_size 128k;
    proxy_buffers 4 256k;
    proxy_busy_buffers_size 256k;

    add_header X-Frame-Options "SAMEORIGIN";
    add_header Strict-Transport-Security "max-age=63072000; includeSubDomains; preload";
    add_header X-Content-Type-Options nosniff;
    add_header X-XSS-Protection "1; mode=block";
    add_header Referrer-Policy "same-origin, strict-origin-when-cross-origin";

    location /assets {
        try_files \$uri =404;
    }

    location ~ ^/protected/(.*) {
        internal;
        try_files /'"$site_name"'/\$1 =404;
    }

    location /socket.io {
        proxy_http_version 1.1;
        proxy_set_header Upgrade \$http_upgrade;
        proxy_set_header Connection "upgrade";
        proxy_set_header X-Frappe-Site-Name '"$site_name"';
        proxy_set_header Origin $scheme://\$http_host;
        proxy_set_header Host '"$site_name"';

        proxy_pass http://'"$bench_folder"'-socketio-server;
    }

    location ^~ /.well-known/acme-challenge/ {
        default_type "text/plain";
        root /var/www/letsencrypt;
    }

    location = /.well-known/acme-challenge/ {
        return 404;
    }

    location / {

        rewrite ^(.+)/\$ \$1 permanent;
        rewrite ^(.+)/index\.html\$ \$1 permanent;
        rewrite ^(.+)\.html\$ \$1 permanent;

        location ~* ^/files/.*.(htm|html|svg|xml) {
            add_header Content-disposition "attachment";
            try_files /'"$site_name"'/public/\$uri @webserver;
        }

        try_files /'"$site_name"'/public/\$uri @webserver;
    }

    location @webserver {
        proxy_http_version 1.1;
        proxy_set_header X-Forwarded-For \$remote_addr;
        proxy_set_header X-Forwarded-Proto \$scheme;
        proxy_set_header X-Frappe-Site-Name '"$site_name"';
        proxy_set_header Host '"$site_name"';
        proxy_set_header X-Use-X-Accel-Redirect True;
        proxy_read_timeout 120;
        proxy_redirect off;

        proxy_pass  http://'"$bench_folder"'-frappe;
    }

    # error pages
    error_page 502 /502.html;
    location /502.html {
        root /usr/local/lib/python'"$py_version"'/dist-packages/bench/config/templates;
        internal;
    }
    
    # optimizations
    sendfile on;
    keepalive_timeout 15;
    client_max_body_size 50m;
    client_body_buffer_size 16K;
    client_header_buffer_size 1k;
    large_client_header_buffers 4 32k;

    # enable gzip compresion
    gzip on;
    gzip_http_version 1.1;
    gzip_comp_level 5;
    gzip_min_length 256;
    gzip_proxied any;
    gzip_vary on;
    gzip_types
        application/atom+xml
        application/javascript
        application/json
        application/rss+xml
        application/vnd.ms-fontobject
        application/x-font-ttf
        application/font-woff
        application/x-web-app-manifest+json
        application/xhtml+xml
        application/xml
        font/opentype
        image/svg+xml
        image/x-icon
        text/css
        text/plain
        text/x-component
        ;

    tcp_nodelay on;
    server_tokens off;

    open_file_cache max=65000 inactive=1m;
    open_file_cache_valid 5s;
    open_file_cache_min_uses 1;
    open_file_cache_errors on;

}
EOF'

sudo bash -c 'cat << EOF >> /etc/supervisor/conf.d/'"$bench_folder"'.conf
; Notes:
; priority=1 --> Lower priorities indicate programs that start first and shut down last
; killasgroup=true --> send kill signal to child processes too

[program:'"$bench_folder"'-frappe-web]
command='"$benchdir"'/env/bin/gunicorn -b 127.0.0.1:8000 -w 3 --max-requests 5000 --max-requests-jitter 500 -t 120 frappe.app:application --preload
priority=4
autostart=true
autorestart=true
stdout_logfile='"$benchdir"'/logs/web.log
stderr_logfile='"$benchdir"'/logs/web.error.log
user='"$USER"'
directory='"$benchdir"'/sites

[program:'"$bench_folder"'-frappe-schedule]
command=/usr/local/bin/bench schedule
priority=3
autostart=true
autorestart=true
stdout_logfile='"$benchdir"'/logs/schedule.log
stderr_logfile='"$benchdir"'/logs/schedule.error.log
user='"$USER"'
directory='"$benchdir"'

[program:'"$bench_folder"'-frappe-default-worker]
command=/usr/local/bin/bench worker --queue default
priority=4
autostart=true
autorestart=true
stdout_logfile='"$benchdir"'/logs/worker.log
stderr_logfile='"$benchdir"'/logs/worker.error.log
user='"$USER"'
stopwaitsecs=1560
directory='"$benchdir"'
killasgroup=true
numprocs=1
process_name=%(program_name)s-%(process_num)d

[program:'"$bench_folder"'-frappe-short-worker]
command=/usr/local/bin/bench worker --queue short
priority=4
autostart=true
autorestart=true
stdout_logfile='"$benchdir"'/logs/worker.log
stderr_logfile='"$benchdir"'/logs/worker.error.log
user='"$USER"'
stopwaitsecs=360
directory='"$benchdir"'
killasgroup=true
numprocs=1
process_name=%(program_name)s-%(process_num)d

[program:'"$bench_folder"'-frappe-long-worker]
command=/usr/local/bin/bench worker --queue long
priority=4
autostart=true
autorestart=true
stdout_logfile='"$benchdir"'/logs/worker.log
stderr_logfile='"$benchdir"'/logs/worker.error.log
user='"$USER"'
stopwaitsecs=1560
directory='"$benchdir"'
killasgroup=true
numprocs=1
process_name=%(program_name)s-%(process_num)d

[program:'"$bench_folder"'-redis-cache]
command=/usr/bin/redis-server '"$benchdir"'/config/redis_cache.conf
priority=1
autostart=true
autorestart=true
stdout_logfile='"$benchdir"'/logs/redis-cache.log
stderr_logfile='"$benchdir"'/logs/redis-cache.error.log
user='"$USER"'
directory='"$benchdir"'/sites

[program:'"$bench_folder"'-redis-queue]
command=/usr/bin/redis-server '"$benchdir"'/config/redis_queue.conf
priority=1
autostart=true
autorestart=true
stdout_logfile='"$benchdir"'/logs/redis-queue.log
stderr_logfile='"$benchdir"'/logs/redis-queue.error.log
user='"$USER"'
directory='"$benchdir"'/sites

[program:'"$bench_folder"'-node-socketio]
command=/usr/bin/node '"$benchdir"'/apps/frappe/socketio.js
priority=4
autostart=true
autorestart=true
stdout_logfile='"$benchdir"'/logs/node-socketio.log
stderr_logfile='"$benchdir"'/logs/node-socketio.error.log
user='"$USER"'
directory='"$benchdir"'

[group:'"$bench_folder"'-web]"$HOME/$bench_folder"
programs='"$bench_folder"'-frappe-schedule,'"$bench_folder"'-frappe-default-worker,'"$bench_folder"'-frappe-short-worker,'"$bench_folder"'-frappe-long-worker

[group:'"$bench_folder"'-redis]
programs='"$bench_folder"'-redis-cache,'"$bench_folder"'-redis-queue
EOF'

echo -e "${YELLOW}Applying necessary permissions to supervisor...${NC}"
sleep 1
# Change ownership of supervisord.conf
sudo sed -i '6i chown='"$USER"':'"$USER"'' /etc/supervisor/supervisord.conf && \

sudo bash -c 'cat << EOF >> /etc/hosts
127.0.1.1 '"$site_name"'
EOF'

# Restart nginx and supervisor
sudo service nginx restart
sudo service supervisor restart
/usr/bin/supervisorctl reread
/usr/bin/supervisorctl update
sudo service nginx reload

echo -e "${YELLOW}Enabling Scheduler...${NC}"
sleep 1

# Enable and resume the scheduler for the site
bench --site $site_name scheduler enable && \
bench --site $site_name scheduler resume && \

echo -e "${YELLOW}Adding apps Payments, Dokos and Hrms to your website.${NC}"
sleep 1
bench --site $site_name install-app payments
bench --site $site_name install-app dokos
bench --site $site_name install-app hrms

echo -e "${YELLOW}Restarting bench to apply all changes and optimizing environment pernissions.${NC}"
sleep 1

#Now to make sure the environment is fully setup
sudo chmod 755 /home/$(echo $USER)
sleep 3
printf "${GREEN}Production setup complete! "
printf '\xF0\x9F\x8E\x86'
printf "${NC}\n"
sleep 3


# Now let's reactivate virtual environment
if [ -z "$py_version" ] || [ "$py_major" -lt 3 ] || [ "$py_major" -eq 3 -a "$py_minor" -lt 10 ]; then
    deactivate
fi

echo -e "${GREEN}--------------------------------------------------------------------------------"
echo -e "Congratulations! You have successfully installed Dokos 4."
echo -e "You can start using your new ERPNext installation by visiting http://$site_name"
echo -e "(if you have enabled SSL and used a Fully Qualified Domain Name"
echo -e "during installation) or http://$server_ip to begin."
echo -e "Install additional apps as required. Visit https://docs.erpnext.com for Documentation."
echo -e "Enjoy using ERPNext!"
echo -e "--------------------------------------------------------------------------------${NC}"
```


# Installation sur Ubuntu 22.04

## Pré-requis

| Logiciel                                     | Usage                               |
| -------------------------------------------- | ----------------------------------- |
| Python 3.10+                                 |                                     |
| Node.js 18                                   |                                     |
| Redis 6                                      | Cache et mises à jour en temps réel |
| MariaDB 10.4.x                               | Base de données                     |
| yarn 1.12+                                   | Gestion des dépendances Javascript  |
| wkhtmltopdf (version 0.12.6 with patched qt) | Génération de PDF                   |
| cron                                         | Planification des tâches de fond    |
| NGINX                                        | Proxy en production                 |

### Python 3.10

Tout d'abord, vérifiez que Python 3.10+ est installé sur votre machine

```sh
python3 --version
# Python 3.10.6
```

Ensuite, installez pip et venv :

```sh
sudo apt-get update -y
sudo apt-get install -y python3-pip python3-venv
```

### Git, Redis et wkhtmltopdf

Ensuite, installez les paquets suivants :

```sh
# Mise à jour des dépôts
sudo apt-get install -y ca-certificates
sudo apt-get update -y

sudo apt-get install -y git redis-server xvfb libfontconfig wkhtmltopdf
```

::callout{color="teal" icon="i-heroicons-light-bulb"}
`wkhtmltopdf` est utilisé pour produire des documents PDF depuis Dodock/Dokos.
::

### MariaDB (v10.4 à v10.8)

```sh
sudo apt-get install -y mariadb-server
sudo apt-get install -y mariadb-client  # optionnel
```

Dodock nécessite une configuration particulière de MariaDB. :br
Éditez le fichier de configuration `/etc/mysql/my.cnf` pour y ajouter les lignes de configuration ci-dessous.

*Exemple de commande pour éditer ce fichier:*

> `sudo nano /etc/mysql/my.cnf`

*Lignes de configuration à ajouter à la fin du fichier*

```yaml
# Dodock Install
[mysqld]
character-set-client-handshake = FALSE
character-set-server = utf8mb4
collation-server = utf8mb4_unicode_ci

[mysql]
default-character-set = utf8mb4
```

Redémarrer le service mysql

```sh
sudo service mysql restart
```

Pendant l'installation, vous devrez choisir un mot de passe pour l'utilisateur *root* pour votre base de données.
Pour le configurer ou le modifier, vous pouvez lancer la commande suivante :

```sh
sudo mariadb-secure-installation
# > Enter current password for root (enter for none):
# Appuyer simplement sur Entrée à la première question.

# > Switch to unix_socket authentication [Y/n]
# Répondre non (n) à la question, car nous utiliserons l'authentification par mot de passe.

# > Set root password? [Y/n]
# Répondre oui (Y), puis entrer un mot de passe sécurisé pour l'utilisateur `root` de la base de données.
# Ce mot de passe sera demandé à chaque création de site, ainsi que lors des opérations de maintenance.

# Ensuite, répondre oui (Y) à toutes les questions suivantes.
```

Vérifiez que vous pouvez vous connecter à la base de données

```sh
mysql -u root -p
# Pour quitter la console, tapez `exit`
```

### NodeJS (v18) et yarn

Vous pouvez installer NodeJS via [nvm](https://github.com/nvm-sh/nvm){rel="&#x22;nofollow&#x22;"} ou le gestionnaire de paquets de votre distribution.

Par exemple :

```sh
curl -o - https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.5/install.sh | bash
. "$HOME/.nvm/nvm.sh"
nvm install 18
npm install -g yarn

# Create a symlink to your usr path
sudo ln -s $(which node) /usr/bin/
```

Vérifiez que NodeJS a bien été installé

```sh
node -v
# v18.xx.y
```

### Dokos CLI

Dokos CLI est une ligne de commande, adaptée de [Bench](https://github.com/frappe/bench){rel="&#x22;nofollow&#x22;"}, permettant de gérer vos sites et applications Dodock. :br
Vous pouvez l'installer grâce à pip

```sh
export PATH=$PATH:$HOME/.local/bin
python3 -m pip install --upgrade --quiet dokos-cli
```

Ensuite, vérifiez que Dokos CLI a bien été installée :

```sh
bench --version
# 2.5.3
```

::callout{color="teal" icon="i-heroicons-light-bulb"}
Si la commande `bench` n'est pas trouvée, relancez votre terminal pour que les modifications de votre variable d'environnement `PATH` soient prises en compte.
En dernier recours, vous pouvez aussi ajouter la ligne `export PATH=$PATH:$HOME/.local/bin` à votre fichier `~/.bashrc`.
::

## Démarrage du serveur et installation d'un site

### Création d'un bench

Un bench est un ensemble de sites et d'applications, et se crée avec les commandes suivantes :

```sh
cd  # Retournez dans votre dossier personnel
bench init dokos-bench --version v4
cd dokos-bench
```

Ensuite, téléchargez les applications que vous souhaitez installer sur vos sites.
Nous vous recommandons les applications suivantes pour démarrer, mais [beaucoup d'autres applications sont disponibles](https://doc.dokos.io/v5/integrations)

```sh
# Téléchargez les applications de base
bench get-app --branch v4 payments
bench get-app --branch v4 dokos
bench get-app --branch v4 webshop
bench get-app --branch v4 hrms
```

### Démarrage du serveur

Vérifiez que vous êtes bien dans le `bench` que vous venez de créez puis lancez les commandes suivantes pour activer le mode `production` de Dokos.

```sh
cd dokos-bench # ici dokos-bench est le nom de votre bench et peut être différent

sudo python3 -m pip install -U -q dokos-cli
sudo -H bench setup production $USER
```

### Création d'un site

Créez votre site et installez les applications dont vous avez besoin.

```sh
# Créez un site (remplacez `monsite.dokos.cloud` par le nom de domaine de votre choix)
bench new-site monsite.dokos.cloud

# Installez les applications dont vous avez besoin
bench --site monsite.dokos.cloud install-app payments
bench --site monsite.dokos.cloud install-app dokos
bench --site monsite.dokos.cloud install-app webshop
bench --site monsite.dokos.cloud install-app hrms
```

::callout{color="teal" icon="i-heroicons-light-bulb"}
Si une erreur se produit lors de l'installation, n'hésitez pas à poster un message sur le [forum](https://community.dokos.io){rel=""nofollow""}.
::

### Finaliser l'installation

Une fois le site créé, vous pouvez vous connecter et accéder à l'interface d'administration avec l'une des adresses suivantes :

- Si Dokos est installé sur votre ordinateur directement : <http://localhost>{rel="&#x22;nofollow&#x22;"}.
- Si vous avez un enregistrement DNS configuré qui pointe vers votre serveur : <http://monsite.dokos.cloud>{rel="&#x22;nofollow&#x22;"}.

Utilisez les identifiants suivants :

- Adresse email : `Administrator`
- Mot de passe : le mot de passe que vous avez choisi lors de la création du site.

Suivez les instructions du « Setup Wizard », l'outil d'installation de Dokos, pour finaliser l'installation.

### Pour aller plus loin

Pour le rendre accessible depuis l'extérieur, il faut configurer un enregistrement DNS qui pointe vers votre serveur, et configurer Let's Encrypt pour obtenir un certificat SSL.

::card-group
  :::card
  ---
  icon: i-mdi-lock-outline
  title: DNS multi-tenant
  to: https://doc.dokos.io/v5/dodock/administration/domaine
  ---
  Configuration du nom de domaine
  :::

  :::card
  ---
  icon: i-mdi-lock-outline
  title: Let's Encrypt
  to: https://doc.dokos.io/v5/dodock/administration/certificat
  ---
  Configuration du certificat SSL avec Let's Encrypt
  :::
::

### Questions Fréquentes

> Le site s'affiche sans mise en forme ni couleurs ?

- Vérifiez que votre dossier utilisateur serveur est bien accessible pour Nginx.
- Vous pouvez donner les droits de lecture en lançant `chmod +x /home/{votre utilisateur}`


# Administration

::card-group
  :::card
  ---
  title: Mettre à jour
  to: https://doc.dokos.io/v5/dodock/administration/mises-a-jour
  ---
  Mettre à jour Dokos/Dodock
  :::

  :::card
  ---
  title: Certificats HTTPS
  to: https://doc.dokos.io/v5/dodock/installation/docker
  ---
  Configurer des certificats SSL avec Let's Encrypt
  :::
::


# Bench

::callout{color="teal" icon="i-heroicons-light-bulb"}
Dodock est basé sur le modèle applicatif [Frappe](https://frappeframework.com/docs/v14/user/en/basics/architecture){rel=""nofollow""} et en partage la même architecture.
::

Chaque site Dodock est installé dans un `bench`. :br
Un `bench` est un environnement virtuel Python dans lequel est installé le framework, les applications et un ou plusieurs sites.

::callout{color="yellow" icon="i-heroicons-light-bulb"}
Les commandes suivantes sont principalement destinées à l'installation standard (hors-conteneur).
::

## Créer un dossier *bench*

```sh
bench init [nom du bench]
```

## Créer un site

```sh
bench new-site [mon.site.fr]
```

## Définir un site par défaut

Permet de ne pas avoir à préciser le nom du site à chaque commande.

```sh
bench use [mon.site.fr]
```

## Basculer en mode production

```sh
sudo bench setup production [USER]
```

## Paramètrer des sauvegardes

```sh
bench setup backups
```

## Regénérer la configuration de Nginx

```sh
bench setup nginx
```

## Télécharger une application

```sh
bench get-app [URL git de l'application]
```

## Installer une application

```sh
bench --site [nom du site] install-app [nom de l'application]
```


# Multi-tenant

Une fois que vous avez installé **Dodock** vous voudrez certainement activer sa fonctionnalité DNS Multitenant pour y accéder depuis votre nom de domaine.

## Multi-tenant basé sur les ports

Par défaut un port spécifique de votre serveur est attribué à votre nouveau site.
Le port 80 est attribué au premier, le port 81 au deuxième, etc...

Pour modifier le port attribué à un site, vous pouvez lancer:
`bench set-nginx-port {votre site} {numéro de port}`

Par exemple:
`bench set-nginx-port siteexemple.com 81`

## Multi-tenant basé sur l'adresse DNS

Afin de simplifier la gestion de votre serveur web, vous pouvez activer la fonctionnalité DNS Multitenant.
Cette fonctionnalité vous permet de simplement nommer le dossier contenant votre site comme votre nom de domaine et de laisser **Dodock** gérer le reste:

Pour activer le mode DNS Multitenant, lancez:
`bench config dns_multitenant on`

Si vous avez déjà créé un site, vous pouvez le renommer avec:
`mv sites/{ancien nom du site} sites/{nouveau nom du site}`

## Créer un nouveau site

Pour créer un nouveau site, vous pouvez lancer:
`bench new-site {votre site}`

## Relancez le serveur web

Une fois que vous avez modifié le port, activé le mode DNS Multitenant ou créé un nouveau site, vous devez mettre à jour la configuration de Nginx (serveur web).

1. Regénérez le fichier de configuration: `bench setup nginx`
2. Rechargez Nginx: `sudo systemctl reload nginx` ou `sudo service nginx reload`

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Pour que la redirection DNS fonctionne, il faut également que vous ajoutiez une entrée DNS de type A pointant vers le serveur sur lequel est installé Dodock.
::

## Pour aller plus loin

::card-group
  :::card
  ---
  icon: i-mdi-lock-outline
  title: Let's Encrypt
  to: https://doc.dokos.io/v5/dodock/administration/certificat
  ---
  Configuration du certificat SSL avec Let's Encrypt
  :::
::


# Installer une application

L'éco-système Dokos est composé de multiples applications (appelées module, plugins, add-ons dans d'autres logiciels). :br
Vous pouvez installer ces applications sur votre site Dokos, sous couvert qu'elles soient compatibles avec votre installation de base et les autres applications déjà installées sur votre site. :br
En cas de doute, n'hésitez pas à poser la question sur le forum ou à ouvrir un ticket sur la page Gitlab/Gihtub de l'application concernée.

[Tableau de compatibilité](https://doc.dokos.io/dodock/frappe-products){rel="&#x22;nofollow&#x22;"}

## Télécharger une application

Pour télécharger une application, placez-vous dans votre dossier *bench* et entrez la commande suivante:

`bench get-app --branch [v4/develop/etc...] bookings https://gitlab.com/dokos/bookings.git`

Pour les applications maintenues par Dokos, la branche de production est la `v4`. :br
C'est la branche recommandée pour la majorité des usages. Elle garantie une compatibilité avec les branches `v4` de Dodock et Dokos.

Dans l'écosystème Frappe, la branche principale compatible avec la v4 de Dokos est `version-15`, mais cela peut varier selon les applications. :br
Nous vous recommandons de toujours utiliser les branches sur lesquelles sont publiées les versions officielles de chaque application.

La branch `develop`, récupérée par défaut si vous spécifiez pas la version dans la commande ci-dessus est destinée aux développeurs. :br
Elle contient la future version majeure de l'application.

## Installer une application

Une fois téléchargée localement et installée sur votre *bench*, vous pouvez choisir d'installer votre application sur un ou plusieurs sites avec la commande:

`bench --site [mon-site] install-app bookings`

N'hésitez pas à faire une mise à jour après l'installation.

## Commandes pour les applications principales de l'écosystème Dokos

- **Dokos**: `bench get-app --branch v4 https://gitlab.com/dokos/dokos.git`
- **Payments**: `bench get-app --branch v4 https://gitlab.com/dokos/payments.git`
- **Webshop**: `bench get-app --branch v4 https://gitlab.com/dokos/webshop.git`
- **Dokos RH**: `bench get-app --branch v4 https://gitlab.com/dokos/hrms.git`
- **WooCommerce**: `bench get-app --branch v4 https://gitlab.com/dokos/dokos-woocommerce.git`
- **Construction**: `bench get-app --branch v4 https://gitlab.com/dokos/construction.git`
- **Bookings**: `bench get-app --branch v4 https://gitlab.com/dokos/bookings.git`
- **Hiboutik**: `bench get-app --branch v4 https://gitlab.com/dokos/hiboutik.git`
- **OCR**: `bench get-app --branch v4 https://gitlab.com/dokos/ocr.git`
- **E-transactions**: `bench get-app --branch v5 https://gitlab.com/dokos/etransactions.git`

## Commandes pour les applications de l'écosystème Frappe

- **Insights**: `bench get-app --branch version-3 https://github.com/frappe/insights.git`
- **CRM**: `bench get-app --branch main https://github.com/frappe/crm.git`
- **Helpdesk**: `bench get-app --branch main https://github.com/frappe/helpdesk.git`
- **LMS**: `bench get-app --branch main https://github.com/frappe/lms.git`
- **Builder**: `bench get-app --branch master https://github.com/frappe/builder.git`
- **Raven**: `bench get-app --branch main https://github.com/The-Commit-Company/raven.git`


# Mises à jour

La mise à jour de Dokos est simple, mais peut demander des connaissance des Linux/Python/NodeJS en cas d'erreur.

## Commande principale

Allez dans votre dossier bench (`home/{utilisateur}/{votre_bench}`) et lancez:

`bench update --restart-supervisor`

Cette commande effectuera les actions suivantes:

1. Mise à jour de vos applications avec la dernière version disponible sur Gitlab
2. Bascule de votre application en mode maintenance
3. Mise à jour de votre environnement python avec toute nouvelle dépendance requise
4. Lancement de tous les patches et migrations nécessaires à la mise à jour de votre base de données
5. Consolidation de tous vos fichiers javascript et CSS
6. Bascule de votre application en mode normal

## Commandes décomposées

La commande `bench update` peut se décompser en plusieurs commandes, qui sont :

- `bench update --pull` récupérera seulement les derniers changements pour chaque application
- `bench update --patch` lancera seulement les patches et migrations pour votre base de données
- `bench update --build` consolidera seulement vos fichiers JS et CSS nécessaires à l'interface utilisateur
- `bench update --bench` mettra à jour seulement l'application docli (Bench)
- `bench update --requirements` mettra à jour seulement les dépendances python et nodejs dans votre environnement

## Réinitialisation des répertoires git

Si vous rencontrez une erreur lors de la mise à jour, car l'une de vos application rencontre un conflit **git**, vous pouvez utilisez la commande suivante pour le réinitialiser. Cela peut se produire lorsque votre site est en mode développement et que vous modifiez ou ajoutez des documents standards, par exemple.

- `bench update --reset --restart-supervisor`

## Résolution des problèmes

Si un patch tombe en erreur lors d'une mise à jour, veuillez publier un message sur le [forum communautaire](https://community.dokos.io){rel="&#x22;nofollow&#x22;"} avec une copie intégrale du message erreur. Attendez la correction, le cas échéant, et lancez de nouveau `bench update`.

Si vous avez des applications personnalisées dans votre dossier bench, veuillez vous assurer qu'elles n'interférent pas avec le processus de mise à jour standard.

Avant de rapporter un problème potentiel, veuillez tester la mise à jour à nouveau dans un environnement sans application personnalisée.

## Commandes utiles

- `bench set-maintenance-mode off` désactive le mode maintenance
- Pour désactiver totalement l'envoi d'emails et notifications, ainsi que les prélèvements automatiques :


  - `bench set-config -g mute_emails 1`
  - `bench set-config -g mute_payment_gateways 1`
  - `bench set-config -g mute_notifications 1`


# Configuration des emails

Vous pouvez configurer des comptes d'envoi et de réception par défaut ainsi que des comptes pour chacun de vos utilisateurs.

## 1. Ajoutez un nom de domaine email

Lors de la configuration de votre compte email vous devez commencer par enregistrer les paramètres de connexion à votre fournisseur d'email.

Si plusieurs utilisateurs ont un nom de domaine commun, il est recommandé de créer un nom de domaine email dans dokos pour faire ce paramétrage une seule fois.

Pour accéder aux paramètrages des noms des domaine email, allez sur :

> Accueil > Paramètres > Email / Notifications > **Nom de domaine email**

### 1.1 Comment configurer le nouveau domaine ?

1. Allez sur la liste Nom de domaine email, cliquez sur **Ajouter un Nouveau nom de domaine**.
2. Indiquez un **Exemple d'adresse email**: Ex. `hello@dokos.io`

### 1.2 Emails entrants

**Serveur email entrant**: Enregistrez les paramètres fournis par votre fournisseur d'email ou l'hébergeur de votre serveur email
Ex. `imap.gmail.com`, `SSL0.OVH.NET`,...

Pour Gmail, voici les informations [**ici**](<https://support.google.com/mail/answer/7126229?hl=fr#zippy=%2C%C3%A9tape-v%C3%A9rifier-quimap-est-activ%C3%A9&#xA;>).
Pour Outlook, voici les informations [**ici**](https://support.microsoft.com/fr-fr/office/param%C3%A8tres-du-serveur-que-vous-devez-r%C3%A9cup%C3%A9rer-aupr%C3%A8s-de-votre-fournisseur-de-courrier-c82de912-adcc-4787-8283-45a1161f3cc3).

- Si les paramètres ci-dessus correspondent au protocole IMAP, cochez la case **Utiliser IMAP**
- Si vous souhaitez utiliser le protocole SSL pour la réception de vos emails, cochez la case **Utiliser SSL**
- Définissez le port à utiliser pour recevoir les emails.
  Si vous ne renseignez pas ce champ, dokos utilisera les ports standards définis par la librairie [imaplib](https://docs.python.org/3.6/library/imaplib.html){rel="&#x22;nofollow&#x22;"} si vous utilisez le protocole IMAP ou la libraire [poplib](https://docs.python.org/3.6/library/poplib.html){rel="&#x22;nofollow&#x22;"} sinon.
- Définissez un taille maximale pour les pièces jointes
  **Ancienne API non utilisée actuellement - va être dépréciée**

### 1.3 Emails sortants

- **Serveur email sortant**
  Enregistrez les paramètres fournis par votre fournisseur d'email ou l'hébergeur de votre serveur email
  Ex. `smtp.gmail.com`, `SSL0.OVH.NET`,...

Pour Gmail, voici les informations [**ici**](<https://support.google.com/mail/answer/7126229?hl=fr#zippy=%2C%C3%A9tape-v%C3%A9rifier-quimap-est-activ%C3%A9&#xA;>).
Pour Outlook, voici les informations [**ici**](https://support.microsoft.com/fr-fr/office/param%C3%A8tres-du-serveur-que-vous-devez-r%C3%A9cup%C3%A9rer-aupr%C3%A8s-de-votre-fournisseur-de-courrier-c82de912-adcc-4787-8283-45a1161f3cc3).

- Si vous souhaitez utiliser le protocole SSL pour l'envoi de vos emails, cochez la case **Utiliser TLS**
- Définissez le port à utiliser pour recevoir les emails.
  Si vous ne renseignez pas ce champ, dokos utilisera le port 587.

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Il est nécessaire que sur votre compte messagerie, l'accès IMAP soit activé.
::

![activer\_l'imap.png](https://doc.dokos.io/content/settings/email/activer_limap.png)

## 2. Ajoutez un Compte email

Vous pouvez créer un ou plusieurs comptes emails pour vous et vos collaborateurs.
Si vous souhaitez que Dokos envoie automatiquement des emails (notifications, rapports hebdomadaires, etc...) il faudra également créer au moins une boîte d'envoi par défaut.

### 2.1 Nouveau compte email

1. **Adresse email**: Entrez l'adresse email du compte que vous souhaitez ajouter dans dokos
2. **Utiliser un email d'identification différent** : Si l'adresse email de connexion à votre compte n'est pas celle renseignée dans le champ précédent, définissez là dans le champ **Identifiant de connexion à la boîte email**.
   Ex. Votre adresse courante est `jean@masociete.com` mais l'identifiant de connexion est `jean123456`.
3. **Mot de passe**: Le mot de passe de connexion à votre compte email
   &#x2A;Pour Google, il est préférable d'utiliser l'authentification OAuth (voir ci-dessous). Si vous n'utilisez pas OAuth, il est important d'activer **Mot de passe d'application**. Indiquez ce mot de passe pour le champ **Mot de Passe**.*

![capture\_d’écran\_2021-11-25\_à\_15.01.04.png](https://doc.dokos.io/content/settings/email/capture_decran_2021-11-25_a_15.01.04.png)

**En attente du mot de passe**: Si vous créez un compte email pour vos collaborateurs sans connaître leur mot de passe, cochez cette case.
Lors de leur prochaine connexion, un popup leur demandera de définir leur mot de passe pour que leur compte email puisse se connecter à votre serveur d'emails.
**Encoder le mot de passe en ASCII**: A cocher si votre fournisseur d'emails requiert des mots de passe encodés en ASCII.
**Nom du compte email**: Choisissez un nom pour ce compte email. Ex. `Notifications` ou `Jean Dupond`**Domaine** ou **Service**: Si vous avez configuré un domaine email, sélectionnez le ici, sinon vous pouvez choisir un des services proposés ou bien laisser ces deux champs vides pour configurer manuellement vos paramètres d'accès à vos comptes email.

#### Configurer un compte Gmail (OAuth)

Afin d'améliorer la sécurité, la connexion des comptes Gmail se fait de préférence via le protocole OAuth. Voici les étapes pour configurer un compte email Gmail avec OAuth dans Dokos :

**Étape 1 : Créer les identifiants OAuth sur Google Cloud**

Créez les identifiants API (Client ID et Client Secret) sur la console Google Cloud.
Vous pouvez vous référer à la [documentation de paramétrage Google](https://doc.dokos.io/v5/dokos/integrations/google#_1-param%C3%A9trage-pour-agenda-drive-and-contacts) pour la création de l'application sur la console Google.

**Étape 2 : Créer une Application Connectée dans Dokos**

1. Allez dans **Intégrations > Application connectée** et cliquez sur **Ajouter**.
2. **Nom du fournisseur** : `Gmail`
3. Renseignez la **Configuration OpenID** : `https://accounts.google.com/.well-known/openid-configuration`
4. Ajoutez les **Identifiants du Client** obtenus précédemment : **N° de client** et **Secret client**.
5. Dans la table **Périmètres**, ajoutez une ligne avec le périmètre `https://mail.google.com`.
6. Dans la table **Paramètres de requête**, ajoutez le paramètre `access_type` avec la valeur `offline` pour permettre le rafraîchissement automatique du jeton d'accès.
7. Cliquez sur le bouton **Obtenir la configuration OpenID** pour remplir automatiquement les points de terminaison (URI d'autorisation, URI des informations utilisateur, etc.).
8. Enregistrez l'application connectée.

![Application Connectée Gmail](https://doc.dokos.io/content/settings/email/gmail_oauth.png)

**Étape 3 : Créer et authentifier le compte email**

1. Allez dans la liste des **Comptes Email** et créez un nouveau compte.
2. Renseignez l'**Adresse e-mail** et le **Domaine**. Cochez **Activer Entrant** et/ou **Activer Sortant** selon vos besoins.
3. Dans la section **Authentification**, sélectionnez la **Méthode** `OAuth`.
4. Dans le champ **Application connectée**, sélectionnez l'application `Gmail` créée à l'étape précédente.
5. Sauvegardez le compte email.
6. Cliquez sur le bouton **Autoriser l'accès API** et suivez les instructions de connexion Google pour finaliser l'authentification.

![Compte Email Gmail](https://doc.dokos.io/content/settings/email/gmail_email_account.png)

### 2.2 Réception d'emails

**Recevoir les emails de ce compte**: cochez cette case si vous souhaitez recevoir les emails de ce compte email

- Pour les éléments de paramétrage du compte, voir la section concernant les noms de domaine email (**Utiliser IMAP**, **Serveur email**, **Utiliser SSL**, **Port**, **Taille maximale de la pièce jointe**)
  **Ajouter à**: Tous les emails envoyés à cette adresse seront directement liés à un document existant ou à un nouveau document de ce type de document.
  Cela peut être utile, par exemple, pour créer une nouvelle opportunité à chaque fois que quelqu'un envoie un email à une adresse de type `commercial@masociete.com`.
  Vous pouvez ajouter de nouveaux types de document via le hook `email_append_to` dans une application personnalisée.
  **Définir comme étant le compte d'email entrant par défaut**: Permet d'avoir une email de réponse générique (champ `reply-to` des emails) si le compte d'envoi ne permet pas de recevoir des emails.
  **Option de synchronisation d'email**: Choisissez entre `TOUS` et `NON LUS` pour la première synchronisation de votre boîte email.
  `TOUS` récupérera les x derniers emails de votre boîte email, tandis que `NON LUS` récupérera les x derniers emails non lus de votre boîte email.
  **Nbre d'emails à récupérer lors de la synchronisation initiale**: Sélectionnez le nombre d'emails à récupérer lors de la synchronisation initiale.

### 2.3. Liens automatiques

Après activation de cette option, dokos va générer une adresse email spécifique pour chaque document.

![automatic\_link.png](https://doc.dokos.io/content/setup/emails/automatic_link.png)

Si vous envoyez un email à cette adresse, celui-ci sera automatiquement lié au document correspondant.

Cette option ne fonctionne qu'avec un seul compte email.

### 2.4 Notifications en l'absence de réponse

Vous pouvez configurer l'envoi d'une notification si vous n'avez pas reçu de réponse au bout de x minutes.

- Cochez la case **Notifier si aucune réponse**
- Définissez la période de temps avant de déclencher la notification (en minutes).

::callout
Si vous souhaitez mettre une durée de plusieurs jours, utilisez la calculatrice intégrée aux champs de dokos. :br
Ex. Pour 2 jours, entrez `60*24*2` et dokos pourra calculer le nombre de minutes.
::

**Envoyer une notification à**: Ajoutez les adresses emails des personnes concernées par cette notification

### 2.5 Envoi d'emails

- Si vous souhaitez que ce compte email envoie des emails, cochez la case **Envoyer des emails depuis ce compte**.
- Pour les éléments de paramétrage du compte, voir la section concernant les noms de domaine email (**Serveur SMTP**, **Utiliser TLS**, **Port**)
- **Définir comme étant le compte d'emails sortants par défaut**: En cochant cette case, vous définissez ce compte email comme étant le compte email par défaut de votre instance dokos. Tous les emails envoyés automatiquement par le système ou par des utilisateurs sans compte email attribué passeront par ce compte.
- **Toujours utiliser l'adresse email du compte comme expéditeur**: Lorsque vos emails sont envoyés, l'adresse email de ce compte est utilisée comme nom d'expéditeur. C'est l'option recommandée lorsque votre nom comporte des caractères spéciaux pour éviter de terminer dans les spams de votre destinataire.
- **Toujours utiliser le nom du compte en tant que nom d'expéditeur**: Lorsque vos emails sont envoyés, le nom du compte email est utilisé comme nom d'expéditeur. Cette option est prioritaire par rapport à l'option ci-dessus.
- **Ajouter un lien de désabonnement dans les emails**: Ajoute un lien `Se désinscrire` en bas de chaque email
- **État du courrier électronique**: Si vous cochez cette case, dokos vous indiquera si votre email a été lu par votre destinataire. Si vous l'envoyez à plusieurs destinataires, il suffit qu'un seul le lise pour qu'il soit considéré comme lu.
- **Désactiver l'authentification sur le server SMTP**: Option pour les serveurs SMTP sans authentification.

### 2.6 Signature

Cette signature sera ajoutée au dessus du pied de page et sous la signature individuelle de l'utilisateur envoyant l'email.

::callout
La signature d'un email peut être composé de 2 niveau dans dokos:

- La signature de l'utilisateur - `Utilisateurs et autorisations > Utilisateur`
- La signature du compte email - `Paramètres > Compte email`
::

### 2.7 Réponses automatiques

Vous pouvez activer cette option pour envoyer une réponse automatique lorsque vous recevez un email.
Vous pouvez formater votre message avec des variables en utilisant le language [Jinja](https://palletsprojects.com/p/jinja/).
Le type de document de référence est une `Communication`.

### 2.8 Pied de page

Vous pouvez définir un pied de page qui apparaîtra au dessus du pied de page global défini dans les paramètres système.

::callout
Le pied de page d'un email peut être composé de 3 niveaux dans dokos:

- Le pied de page du compte email - `Paramètres > Compte email`
- Le pied de page global de l'instance - `Paramètres > Paramètres Système`
- Le pied de page standard de dokos - `Paramètres > Paramètres Système`
::


# Confidentialité et télémétrie

## Aucune collecte de données

Dodock ne transmet aucune donnée à des serveurs externes. Toutes les fonctions de télémétrie présentes dans le framework Frappe d'origine ont été désactivées dans Dodock.

Concrètement, les appels suivants sont neutralisés :

- Envoi d'événements d'utilisation (pages visitées, actions effectuées)
- Rapport d'erreurs automatique vers un service tiers
- Collecte de statistiques d'installation (version, modules actifs, nombre d'utilisateurs)

Ces désactivations sont effectives dès l'installation, sans configuration requise de la part de l'administrateur.

## Ce qui reste sur votre instance

Les journaux d'activité (logs d'accès, historique des modifications, journaux d'erreurs) restent **sur votre instance uniquement**. Ils ne quittent jamais votre serveur et sont accessibles depuis la **Console système** pour les administrateurs.

::demo-link{demo="Dokompany" path="/app/system-console"}
Accéder à la console système dans la démo
::

## Pour les administrateurs

Aucune action n'est requise pour désactiver la télémétrie — elle est inactive par défaut dans toutes les installations Dodock. Il n'existe pas de paramètre pour la réactiver.

Si votre organisation est soumise à des exigences de conformité (RGPD, hébergement souverain, etc.), vous pouvez documenter ce point en citant l'absence de télémétrie comme une caractéristique architecturale de Dodock.


# Certificat SSL

Vous pouvez amener votre propre certificat pour sécuriser votre installation Dokos ou générer un nouveau certificate en utilisant Let's Encrypt.

## Pré-requis

1. Votre bench doit être en mode DNS Multitenant
2. Votre domaine web doit rediriger vers le serveur de votre site
3. Vous devez pouvoir exécuter les commandes avec des droits administrateur (root)

## Installer Let's Encrypt

<https://certbot.eff.org/>{rel="&#x22;nofollow&#x22;"}

## Génére un nouveau certificat

`sudo -H bench setup lets-encrypt {votre site}`

## Générer un nouveau certificat pour un domaine personnalisé

`sudo -H bench setup lets-encrypt {votre site} --custom-domain {votre domaine personnalisé}`

## Renouveler un certificat

Chaque certificat Let's Encrypt est valide pendant 3 mois. Vous pouvez les renouveler 30 jours avant qu'ils expirent.
La génération d'un nouveau domaine crée automatiquement une tâche cron qui tente de renouveler le certificat automatiquement.
Si ce renouvelement automatique ne fonctionne pas, vous pouvez quand même renouveler votre certificat manuellement en lançant:

`sudo bench renew-lets-encrypt`


# Migrer vers la version 3 de Dokos

::callout
Si vous souhaitez **installer** Dokos pour la première fois, consultez le [guide d'installation rapide](https://doc.dokos.io/v5/dodock/installation) plutôt que ce guide de migration.
::

La version 3 de Dokos nécessite Python 3.10 et NodeJS 16 pour fonctionner. Si vous avez précédemment installé **Dokos v2**, une mise à jour de certains paquets logiciels et une migration du dossier bench est nécessaire avant d'installer Dokos v3.

📄 Ce guide est destiné aux installations de Dokos auto-hébergées sous Ubuntu.

:br:br

## Prérequis (Node 16, Python 3.10)

### Installer NodeJS 16

Pour installer NodeJS 16 sur Ubuntu, vous pouvez utiliser le gestionnaire de versions [`nvm`](https://github.com/nvm-sh/nvm){rel="&#x22;nofollow&#x22;"}, ou alternativement utiliser les commandes suivantes :

```sh
wget -qO- https://deb.nodesource.com/setup_16.x | sudo -E bash -
sudo apt install -y nodejs
node --version
```

Puis vérifiez l'installation avec `node --version`.

### Installer Python 3.10

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Il faut installer Python 3.10 **sans remplacer** la version de Python installée par défaut avec Ubuntu, car cela pourrait interférer avec le fonctionnement de certains outils comme `apt`.
::

Pour installer Python 3.10 sur Ubuntu, il est recommandé d'utiliser le paquet `deadsnakes/ppa`. L'installation peut s'effectuer comme ci-dessous :

```sh
sudo add-apt-repository ppa:deadsnakes/ppa

sudo apt-get update

sudo apt-get install python3.10
sudo apt-get install python3.10-dev
sudo apt-get install python3.10-distutils

sudo update-alternatives --install /usr/bin/python3 python3 /usr/bin/python3.10 1

sudo update-alternatives --config python3

python3 -V
```

Vous pouvez vérifier que Python 3.10 est installé avec `python3 -V`, avant de poursuivre comme suit :

```sh
curl -sS https://bootstrap.pypa.io/get-pip.py | python3.10

pip install dokos-cli --upgrade
```

## Finaliser la migration

### Migration de l'environnement virtuel de votre bench

Une fois Python 3.10 et Node 16 correctement installés, vous pouvez poursuivre avec la migration du dossier de bench vers la nouvelle version de Python.

```sh
bench migrate-env python3.10
```

::callout
Chaque bench est un environnement virtuel Python séparé des autres environnements virtuels. Seul `dokos-cli` utilise la version de Python par défaut du système.
::

### Ajout des nouvelles applications

Certains modules de Dokos sont désormais publiés dans des modules séparés. Si vous utilisez certaines de leurs fonctionnalités, commencez par les ajouter dans votre bench.

#### Payments

Cette application est à installer obligatoirement pour permettre à Dokos de fonctionner.
Elle sert à gérer les passerelles de paiement.

```text
bench get-app https://gitlab.com/dokos/payments --branch v3.x.x
```

#### HRMS

Cette application contient les éléments du module RH de la version 2 de Dokos.

```text
bench get-app https://gitlab.com/dokos/hrms --branch v3.x.x
```

#### WooCommerce

Cette application permet de faire fonctionner l'intégration avec WooCommerce.

```text
bench get-app https://gitlab.com/dokos/woocommerce --branch v3.x.x
```

### Montée de version de Dodock/Dokos

Après la récupération des nouvelles applications, changez de branche pour passer sur la version 3 de Dodock/Dokos.

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Il est possible que certains messages d'erreur apparaîssent au début de la migration, indiquant que certaines requêtes SQL sont invalides. Vous pouvez les ignorer, ils sont liés à des nouveaux champs ajoutés dès que les scripts de migration seront déployés.
::

```text
bench switch-to-branch v3.x.x frappe erpnext --upgrade
```

### Installation des nouvelles applications sur votre site

Installez les nouvelles applications sur votre site

```text
bench install-app payments
bench install-app hrms
bench install-app woocommerce
```

### Relancez une mise à jour

Enfin, [mettez à jour Dokos/Dodock](https://doc.dokos.io/v5/dodock/administration/mises-a-jour) normalement.

```text
bench update --reset
```

::callout{color="green"}
Si l'installation s'est passée correctement, vous pouvez désormais profiter des [nouvelles fonctionnalités de Dokos v3](https://doc.dokos.io/v5/dodock/versions/v3.x.x/v3_0_0).
::

:br:br

## Dépannage

::callout
Vérifiez que les paquets prérequis sont correctement installés avec les commandes suivantes :

```sh
python3 --version
pip --version
node --version
yarn --version
docli --version / bench --version
```
::

### La migration du bench échoue

Si les prérequis sont correctement installés, il est normalement possible de migrer un bench d'une version de Python à une autre avec la commande `bench migrate-env python3.10`.

Si jamais cela ne fonctionne pas, il peut être plus simple de créer un nouveau bench puis d'y déplacer un site depuis l'ancien bench.

Tout d'abord, créez un nouveau bench sous Python 3.10 avec la commande `bench init bench-nouveau --python python3.10`

Déplacez-y le dossier contenant votre site dans ce nouveau bench `mv ~/bench-ancien/sites/mon_site ~/bench-nouveau/sites/`, puis exécutez la commande `bench setup production {votre utilisateur} && bench update` dans le nouveau bench.

Vous aurez peut-être besoin d'installer de nouveau les applications tierces que vous avez pu installer. Vous pouvez consulter la liste de ces applications avec la commande `cat ~/bench-ancien/sites/apps.txt`.

::callout
Pour toute question ou demande d'aide, vous pouvez vous rendre sur le [forum de la communauté](https://community.dokos.io){rel=""nofollow""}.
::

### Python/`apt-get` ne fonctionne plus

Si jamais votre installation globale de Python (Python 3.4 sous Ubuntu 18) ne fonctionne plus, vous pouvez réinstaller la version système de Python en suivant ce lien :
<https://askubuntu.com/questions/1196401/how-to-fix-python3-after-messing-it-up/1200793#1200793>{rel="&#x22;nofollow&#x22;"}

### ModuleNotFoundError: No module named `virtualenv`

Si cette erreur se produit, il suffit de reinstaller *virtualenv* avec la commande `pip install virtualenv`.

::callout
Si vous rencontrez trop de difficultés à migrer votre bench existant, n'hésitez pas à créer un nouveau bench sous python3.10, à couper/copier le dossier contenant les éléments de votre site dans ce nouveau bench et à lancer la mise à jour dans ce nouveau bench.
::

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
N'oubliez jamais de **sauvegarder** avant d'effectuer n'importe quelle opération de migration.
::


# Migrer vers la version 4 de Dokos

::callout
Si vous souhaitez **installer** Dokos pour la première fois, consultez le [guide d'installation rapide](https://doc.dokos.io/v5/dodock/installation) plutôt que ce guide de migration.
::

La version 4 de Dokos nécessite Python 3.10 ou Python 3.11 et NodeJS 18 pour fonctionner. :br
Si vous avez précédemment installé **Dokos v3**, une mise à jour de certains paquets logiciels et une migration du dossier bench est nécessaire avant d'installer Dokos v4.

📄 Ce guide est destiné aux installations de Dokos auto-hébergées sous Ubuntu.

:br:br

## Prérequis (Node 18, Python 3.10)

### Installer NodeJS 18

Pour installer NodeJS 18 sur Ubuntu, vous pouvez utiliser le gestionnaire de versions [`nvm`](https://github.com/nvm-sh/nvm){rel="&#x22;nofollow&#x22;"}, ou alternativement utiliser les commandes suivantes :

```sh
wget -qO- https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt install -y nodejs
node --version
```

Puis vérifiez l'installation avec `node --version`.

### Installer Python 3.10

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Il faut installer Python 3.10 **sans remplacer** la version de Python installée par défaut avec Ubuntu, car cela pourrait interférer avec le fonctionnement de certains outils comme `apt`.
::

Pour installer Python 3.10 sur Ubuntu, il est recommandé d'utiliser le paquet `deadsnakes/ppa`. L'installation peut s'effectuer comme ci-dessous :

```sh
sudo add-apt-repository ppa:deadsnakes/ppa

sudo apt-get update

sudo apt-get install python3.10
sudo apt-get install python3.10-dev
sudo apt-get install python3.10-distutils

sudo update-alternatives --install /usr/bin/python3 python3 /usr/bin/python3.10 1

sudo update-alternatives --config python3

python3 -V
```

Vous pouvez vérifier que Python 3.10 est installé avec `python3 -V`, avant de poursuivre comme suit :

```sh
curl -sS https://bootstrap.pypa.io/get-pip.py | python3.10

pip install dokos-cli --upgrade
```

## Finaliser la migration

### Migration de l'environnement virtuel de votre bench

Une fois Python 3.10 et Node 18 correctement installés, vous pouvez poursuivre avec la migration du dossier de bench vers la nouvelle version de Python.

::callout
Si votre `bench` est déjà sous Python 3.10, vous pouvez passer cette étape..
::

```sh
bench migrate-env python3.10
```

::callout
Chaque bench est un environnement virtuel Python séparé des autres environnements virtuels. Seul `dokos-cli` utilise la version de Python par défaut du système.
::

### Ajout des nouvelles applications

Certains modules de Dokos sont désormais publiés dans des modules séparés. Si vous utilisez certaines de leurs fonctionnalités, commencez par les ajouter dans votre bench.

#### Webshop

Cette application est à installer uniquement si vous utilisez les fonctionnalités eCommerce de Dokos.

```text
bench get-app https://gitlab.com/dokos/webshop --branch v4
```

### Montée de version de Dodock/Dokos

Après la récupération des nouvelles applications, changez de branche pour passer sur la version 4 de Dodock/Dokos.

```text
bench switch-to-branch v4 frappe erpnext hrms payments --upgrade
```

### Installation des nouvelles applications sur votre site

Installez les nouvelles applications sur votre site

```text
bench install-app webshop
```

### Relancez une mise à jour

Enfin, [mettez à jour Dokos/Dodock](https://doc.dokos.io/v5/dodock/administration/mises-a-jour) normalement.

```text
bench update --reset
```

::callout{color="green"}
Si l'installation s'est passée correctement, vous pouvez désormais profiter des [nouvelles fonctionnalités de Dokos v4](https://doc.dokos.io/v5/dodock/versions/v4.x.x/v4_0_0).
::

:br:br

## Dépannage

::callout
Vérifiez que les paquets prérequis sont correctement installés avec les commandes suivantes :

```sh
python3 --version
pip --version
node --version
yarn --version
docli --version / bench --version
```
::

### La migration du bench échoue

Si les prérequis sont correctement installés, il est normalement possible de migrer un bench d'une version de Python à une autre avec la commande `bench migrate-env python3.10`.

Si jamais cela ne fonctionne pas, il peut être plus simple de créer un nouveau bench puis d'y déplacer un site depuis l'ancien bench.

Tout d'abord, créez un nouveau bench sous Python 3.10 avec la commande `bench init bench-nouveau --python python3.10`

Déplacez-y le dossier contenant votre site dans ce nouveau bench `mv ~/bench-ancien/sites/mon_site ~/bench-nouveau/sites/`, puis exécutez la commande `bench setup production {votre utilisateur} && bench update` dans le nouveau bench.

Vous aurez peut-être besoin d'installer de nouveau les applications tierces que vous avez pu installer. Vous pouvez consulter la liste de ces applications avec la commande `cat ~/bench-ancien/sites/apps.txt`.

::callout
Pour toute question ou demande d'aide, vous pouvez vous rendre sur le [forum de la communauté](https://community.dokos.io){rel=""nofollow""}.
::

### Python/`apt-get` ne fonctionne plus

Si jamais votre installation globale de Python (Python 3.4 sous Ubuntu 18) ne fonctionne plus, vous pouvez réinstaller la version système de Python en suivant ce lien :
<https://askubuntu.com/questions/1196401/how-to-fix-python3-after-messing-it-up/1200793#1200793>{rel="&#x22;nofollow&#x22;"}

### ModuleNotFoundError: No module named `virtualenv`

Si cette erreur se produit, il suffit de reinstaller *virtualenv* avec la commande `pip install virtualenv`.

::callout
Si vous rencontrez trop de difficultés à migrer votre bench existant, n'hésitez pas à créer un nouveau bench sous python3.10, à couper/copier le dossier contenant les éléments de votre site dans ce nouveau bench et à lancer la mise à jour dans ce nouveau bench.
::

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
N'oubliez jamais de **sauvegarder** avant d'effectuer n'importe quelle opération de migration.
::

### Activer les scripts serveur si besoin

Pour des raisons de sécurité, les scripts serveur sont maintenant désactivés par défaut. Pour les activer, il faut configurer la clé `server_script_enabled` dans les paramètres du bench avec `bench set-config -g server_script_enabled 1`. Il n'est pas possible d'activer les scripts serveur au niveau d'un site.


# Migrer vers la version 5 de Dokos

::callout
Si vous souhaitez **installer** Dokos pour la première fois, consultez le [guide d'installation rapide](https://doc.dokos.io/v5/dodock/installation) plutôt que ce guide de migration.
::

La version 5 de Dokos nécessite &#x2A;*Python 3.14+** et &#x2A;*NodeJS 24+** pour fonctionner.
Si vous utilisez actuellement **Dokos v4**, une mise à jour de certains paquets logiciels et une migration du dossier bench est nécessaire avant d'installer Dokos v5.

📄 Ce guide est destiné aux installations de Dokos auto-hébergées sous Ubuntu.

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
N'oubliez jamais de **sauvegarder** avant d'effectuer n'importe quelle opération de migration.
::

:br:br

## Prérequis (Node 24, Python 3.14)

### Installer NodeJS 24

Pour installer NodeJS 24 sur Ubuntu, vous pouvez utiliser le gestionnaire de versions [`nvm`](https://github.com/nvm-sh/nvm){rel="&#x22;nofollow&#x22;"}, ou alternativement utiliser les commandes suivantes :

```sh
wget -qO- https://deb.nodesource.com/setup_24.x | sudo -E bash -
sudo apt install -y nodejs
node --version
```

Puis vérifiez l'installation avec `node --version`.

### Installer Python 3.14

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Il faut installer Python 3.14 **sans remplacer** la version de Python installée par défaut avec Ubuntu, car cela pourrait interférer avec le fonctionnement de certains outils comme `apt`.
::

Pour installer Python 3.14 sur Ubuntu, il est recommandé d'utiliser le paquet `deadsnakes/ppa`. L'installation peut s'effectuer comme ci-dessous :

```sh
sudo add-apt-repository ppa:deadsnakes/ppa

sudo apt-get update

sudo apt-get install python3.14
sudo apt-get install python3.14-dev
sudo apt-get install python3.14-distutils
sudo apt-get install python3.14-venv
sudo apt-get install libmariadb-dev

sudo update-alternatives --install /usr/bin/python3 python3 /usr/bin/python3.14 1

sudo update-alternatives --config python3

python3 -V
```

Vous pouvez vérifier que Python 3.14 est installé avec `python3 -V`, avant de poursuivre comme suit :

```sh
curl -sS https://bootstrap.pypa.io/get-pip.py | python3.14

pip install dokos-cli --upgrade
```

## Changements importants dans Dodock v5

### Nouvelles applications séparées de Dodock

Dans la version 5, plusieurs modules ont été extraits de Dodock/Frappe et publiés en tant qu'applications indépendantes. Si vous utilisez leurs fonctionnalités, vous devrez les installer séparément :

- **Blog** : gestion des articles de blog
- **Energy Points** : système de points d'énergie et gamification
- **Newsletter** : gestion des newsletters
- **Backup Integrations** : intégrations pour les sauvegardes (S3, etc.)

### Nouvelle application eTransactions

L'application **eTransactions** ([gitlab.com/dokos/etransactions](https://gitlab.com/dokos/etransactions){rel="&#x22;nofollow&#x22;"}) est une nouvelle application disponible en V5 permettant de lire les factures électroniques aux formats **UBL** et **CII**.

::callout{color="blue" icon="i-heroicons-information-circle"}
**Super PDP** a annoncé sa connexion avec **AFNOR**. Les développements pour se connecter à la Plateforme Agréée vont pouvoir démarrer prochainement.
::

::callout{color="blue" icon="i-heroicons-information-circle"}
L'application **E-transactions** remplace l'application OCR à partir de Dokos V5. Si vous utilisiez l'application OCR, installez E-transactions — Dokos migre automatiquement vos paramètres. Vous pouvez ensuite désinstaller OCR.
::

```sh
# Récupérer la nouvelle application eTransactions
bench get-app https://gitlab.com/dokos/etransactions --branch v5

# Installer eTransactions sur votre site
bench --site {nom_du_site} install-app etransactions
```

### Autres changements notables

- La navigation utilise désormais une **barre latérale persistante** basée sur le doctype Workspace Sidebar. Les espaces de travail standard modifiés seront réinitialisés lors de la migration.
- Le tri par défaut des vues de liste est maintenant par `creation` au lieu de `modified`.
- L'accès à la console système est désormais restreint aux Administrateurs par défaut.
- Les champs `Country` requièrent maintenant des codes ISO 3166 ALPHA-2 valides.

## Finaliser la migration

### Migration de l'environnement virtuel de votre bench

Une fois Python 3.14 et Node 24 correctement installés, vous pouvez poursuivre avec la migration du dossier de bench vers la nouvelle version de Python.

::callout
Si votre `bench` est déjà sous Python 3.14, vous pouvez passer cette étape.
::

```sh
bench migrate-env python3.14
```

::callout
Chaque bench est un environnement virtuel Python séparé des autres environnements virtuels. Seul `dokos-cli` utilise la version de Python par défaut du système.
::

### Ajout des nouvelles applications

Certains modules de Dodock sont désormais publiés dans des applications séparées. Si vous utilisez certaines de leurs fonctionnalités, commencez par les ajouter dans votre bench.

#### Blog

```sh
bench get-app https://github.com/frappe/blog --branch version-16
```

#### Energy Points

```sh
bench get-app https://github.com/frappe/eps --branch version-16
```

#### Newsletter

```sh
bench get-app https://github.com/frappe/newsletter --branch version-16
```

#### Backup Integrations

```sh
bench get-app https://github.com/frappe/offsite_backups --branch version-16
```

### Montée de version de Dodock/Dokos

Après la récupération des nouvelles applications, changez de branche pour passer sur la version 5 de Dodock/Dokos.

```sh
bench switch-to-branch v5 frappe erpnext hrms payments --upgrade
```

### Installation des nouvelles applications sur votre site

Installez les nouvelles applications souhaitées sur votre site :

```sh
bench --site {nom_du_site} install-app blog
bench --site {nom_du_site} install-app energy_points
bench --site {nom_du_site} install-app newsletter
bench --site {nom_du_site} install-app backup_integrations
```

### Relancez une mise à jour

Enfin, [mettez à jour Dokos/Dodock](https://doc.dokos.io/v5/dodock/administration/mises-a-jour) normalement.

```sh
bench update --reset
```

::callout{color="green"}
Si l'installation s'est passée correctement, vous pouvez désormais profiter des nouvelles fonctionnalités de Dokos v5.
::

:br:br

## Dépannage

::callout
Vérifiez que les paquets prérequis sont correctement installés avec les commandes suivantes :

```sh
python3 --version
pip --version
node --version
yarn --version
docli --version / bench --version
```
::

### La migration du bench échoue

Si les prérequis sont correctement installés, il est normalement possible de migrer un bench d'une version de Python à une autre avec la commande `bench migrate-env python3.14`.

Si jamais cela ne fonctionne pas, il peut être plus simple de créer un nouveau bench puis d'y déplacer un site depuis l'ancien bench.

Tout d'abord, créez un nouveau bench sous Python 3.14 avec la commande `bench init bench-nouveau --python python3.14`

Déplacez-y le dossier contenant votre site dans ce nouveau bench `mv ~/bench-ancien/sites/mon_site ~/bench-nouveau/sites/`, puis exécutez la commande `bench setup production {votre utilisateur} && bench update` dans le nouveau bench.

Vous aurez peut-être besoin d'installer de nouveau les applications tierces que vous avez pu installer. Vous pouvez consulter la liste de ces applications avec la commande `cat ~/bench-ancien/sites/apps.txt`.

::callout
Pour toute question ou demande d'aide, vous pouvez vous rendre sur le [forum de la communauté](https://community.dokos.io){rel=""nofollow""}.
::

### Python/`apt-get` ne fonctionne plus

Si jamais votre installation globale de Python ne fonctionne plus, vous pouvez réinstaller la version système de Python en suivant ce lien :
<https://askubuntu.com/questions/1196401/how-to-fix-python3-after-messing-it-up/1196790#1196790>{rel="&#x22;nofollow&#x22;"}

### ModuleNotFoundError: No module named `virtualenv`

Si cette erreur se produit, il suffit de reinstaller *virtualenv* avec la commande `pip install virtualenv`.

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Si vous rencontrez trop de difficultés à migrer votre bench existant, n'hésitez pas à créer un nouveau bench sous python3.14, à couper/copier le dossier contenant les éléments de votre site dans ce nouveau bench et à lancer la mise à jour dans ce nouveau bench.
::

### Activer les scripts serveur si besoin

Pour des raisons de sécurité, les scripts serveur sont désactivés par défaut. Pour les activer, il faut configurer la clé `server_script_enabled` dans les paramètres du bench avec `bench set-config -g server_script_enabled 1`. Il n'est pas possible d'activer les scripts serveur au niveau d'un site.


# Migrer depuis ERPNext

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
**Effectuez une sauvegarde de vos données/votre environnement avant de commencer à suivre ce guide.**:br
Attention, ce guide n'a pas été testé sur les dernières versions d'ERPNext et Dokos.
Vous pouvez remonter tout problème sur le [système de suivi des tickets Dokos](https://gitlab.com/dokos/dokos/issues){rel=""nofollow""} ou le [forum](https://community.dokos.io){rel=""nofollow""}.
::

# Migrer depuis ERPNext

- Ce guide de migration a été testé pour une migration d'ERPNext v11.x.x et v12.x.x vers Dokos v1.x.x ou Dokos v2.x.x
- Il est recommandé de mettre à jour ERPNext vers la version v11.x.x ou v12.x.x avant de suivre ce guide

## Pré-requis

Votre environnement **bench** doit fonctionner avec Python 3 (Python 3.10 minimum).

Si ce n'est pas le cas, lancez la commande suivante depuis votre dossier bench (\`home/{utilisateur}/{votre\_bench}):

`bench migrate-env python3`

## Passer sur dokos

### Changez l'URL de dépôt et mettre à jour **bench**

- Dans le dossier local de votre utilisateur, allez dans le dossier de l'application **bench**

```sh
# soit :
cd "$HOME/.bench"
# ou alors :
cd "$HOME/bench-repo"
```

Généralement votre utilisateur est appelé `frappe`, mais cela peut aussi être un autre utilisateur, créé lors de l'installation de Frappe/ERPNext

- Changez l'URL du dépôt et mettez à jour l'application:

```sh
git remote set-url origin https://gitlab.com/dokos/docli.git
git fetch origin
git reset --hard origin/master
pip install -e .
```

### Changez l'URL dépôt par défaut de chaque application

- Depuis votre dossier bench, généralement `/home/frappe/frappe-bench`, lancez les commandes suivantes

```sh
bench remote-reset-url dodock
bench remote-reset-url dokos

# Et, le cas échéant :
bench remote-reset-url payments  # Paiements
bench remote-reset-url hrms  # Gestion des ressources humaines
```

- Ensuite migrez sur la branche courante pour configurer l'environnement de production

```text
# Depuis ERPNext v14 ou antérieur
bench switch-to-branch v3.x.x

# Pour ERPNext v15
bench switch-to-branch v4
```

> Les applications Frappe et ERPNext ne sont pas encore renommées en dodock et dokos dans **bench**.
> De ce fait, à l'exception de la modification des URL de dépôts et l'installation d'applications, vous devez encore appeler chaque application par son nom d'origine.

### Vérifier que l'application est prête à être mise à jour

- Depuis votre dossier bench - généralement `/home/frappe/frappe-bench` - lancez la commande suivante

```sh
bench remote-urls
```

Le résultat doit contenir:

```sh
frappe   https://gitlab.com/dokos/dodock.git
erpnext  https://gitlab.com/dokos/dokos.git
```

### Mettre à jour l'application

- Depuis votre dossier bench - généralement `/home/frappe/frappe-bench` - lancez la commande suivante

```sh
bench update --reset
```

Si vous rencontrez des problèmes lors de la migration, veuillez ouvrir un ticket dans le système de suivi des [tickets dokos](https://gitlab.com/dokos/dokos/issues){rel="&#x22;nofollow&#x22;"}


# Commandes

::hero-announcement
---
label: Dokos CLI est un adaptation de la ligne de commande Frappe Bench
to: https://github.com/frappe/bench
---
::

## Dokos CLI

Dokos CLI est une ligne de commande permettant de gérer ses dossiers (appelés *bench*), ses sites et ses applications.

### Commandes incluses dans Dokos CLI

Pour voir la liste des commandes à jour, vous pouvez lancer `bench --help` depuis votre dossier *bench*. :br
Pour accéder aux options de chacune des commandes ci-dessous, saisissez `bench {commande} --help`.

| Commande                | Description                                                                                                   |
| ----------------------- | ------------------------------------------------------------------------------------------------------------- |
| backup-all-sites        | Lancement d'une sauvegarde de tous les sites dans un *bench*                                                  |
| config                  | Modification de la configuration du *bench*                                                                   |
| disable-production      | Désactivation de l'environnement de production (ou mode de production) pour ce *bench*                        |
| download-translations   | Téléchargement des dernières traductions                                                                      |
| drop                    | Sauvegarde et suppression d'un dossier bench                                                                  |
| exclude-app             | Exclusion une application des mises à jour                                                                    |
| find                    | Recherche récursive pour trouver un dossier `bench`                                                           |
| get                     | Alias pour `get-app`                                                                                          |
| get-app                 | Permet de cloner et installer une application depuis un répertoire git distant ou local                       |
| include-app             | Inclus l'application dans la liste des applications à mettre à jour                                           |
| init                    | Initialise un nouveau dossier `bench`                                                                         |
| install                 | *Installation des dépendances système*                                                                        |
| migrate-env             | Migration de l'environnement virtuel python vers une nouvelle version                                         |
| new-app                 | Création d'une nouvelle application sur Dodock                                                                |
| pip                     | Utilisation de la version de pip de l'environnement virtuel. Utilisez `bench pip --help` pour en savoir plus. |
| release                 | Publication d'une nouvelle version d'une application - Interne à l'équipe Dokos                               |
| remote-reset-url        | Réinitialise les adresses distantes des applications Dodock et Dokos                                          |
| remote-set-url          | Alias pour `git remote set-url upstream {URL}`. Trouve l'application à mettre à jour grâce à l'URL            |
| remote-urls             | Affiche les URL des répertoires distants des applications installées                                          |
| remove                  | Alias pour `remove-app`                                                                                       |
| remove-app              | Supprime une application du `bench`                                                                           |
| renew-lets-encrypt      | Renouvelle les certificats Let's Encrypt et crée une entrée CRON                                              |
| restart                 | Redémarre les processus Supervisor ou Systemd                                                                 |
| retry-upgrade           | Relance une mise à jour tombée en erreur                                                                      |
| rm                      | Alias pour `remove-app`                                                                                       |
| set-mariadb-host        | Configuration d'un hôte MariaDB pour ce `bench`                                                               |
| set-nginx-port          | Configuration d'un port associé à Nginx pour un site                                                          |
| set-redis-cache-host    | Configuration d'un hôte Redis Cache pour ce `bench`                                                           |
| set-redis-queue-host    | Configuration d'un hôte Redis Queue pour ce `bench`                                                           |
| set-redis-socketio-host | Configuration d'un hôte Redis SocketIO pour ce `bench`                                                        |
| set-ssl-certificate     | Configuration d'un chemin vers un certificat SSL pour un site                                                 |
| set-ssl-key             | Configuration d'un chemin vers la clé privée d'un certificat SSL pour un site                                 |
| set-url-root            | Configuration d'une URL de base pour un site                                                                  |
| setup                   | Groupe de commandes pour configurer son `bench`. Utilisez `bench setup --help` pour en savoir plus.           |
| src                     | Impression du chemin vers le code source installé de Dokos CLI                                                |
| start                   | Démarrage du mode `développeur` de Dodock                                                                     |
| switch-to-branch        | Basculement des applications indiquées vers la branche voulue                                                 |
| switch-to-develop       | Basculement des applications indiquées vers la branche `develop`                                              |
| update                  | Lancement d'une opération de mise à jour                                                                      |

### Commandes incluses dans le framework Dodock

| Commande                   | Description                                                                                        |
| -------------------------- | -------------------------------------------------------------------------------------------------- |
| add-system-manager         | Ajoute un nouveau responsable système                                                              |
| add-to-email-queue         | Ajoute un email dans un fichier local au journal des emails                                        |
| add-to-hosts               | Ajoute le site dans le fichier `/etc/hosts`                                                        |
| add-user                   | Ajoute un utilisateur                                                                              |
| backup                     | Lance une sauvegarde locale                                                                        |
| browse                     | Ouvre le site dans le navigateur                                                                   |
| build                      | Compile et minifie les fichiers JS et CSS                                                          |
| build-message-files        | Build message files for translation                                                                |
| build-search-index         | Construit les index de recherche                                                                   |
| bulk-rename                | Renomme des documents via un fichier csv                                                           |
| cleanup-translations       | Nettoye les fichiers de traduction                                                                 |
| clear-cache                | Vide le cache du site                                                                              |
| clear-log-table            | Vide la table de log                                                                               |
| clear-website-cache        | Vide le cache du site web                                                                          |
| console                    | Lance une console iPython                                                                          |
| create-rq-users            | Crée des utilisateurs RQ                                                                           |
| data-import                | Importe des données depuis des fichiers CSV                                                        |
| db-console                 | Ouvre une console de base de données                                                               |
| destroy-all-sessions       | Déconnecte tous les utilisateurs                                                                   |
| disable-scheduler          | Désactive le planificateur                                                                         |
| disable-user               | Désactive un utilisateur                                                                           |
| doctor                     | Affiche un diagnostic des tâches de fond                                                           |
| drop-site                  | Supprime le site et sa base de données                                                             |
| enable-scheduler           | Active le planificateur                                                                            |
| execute                    | Exécute une fonction                                                                               |
| export-csv                 | Exporte des données en CSV                                                                         |
| export-doc                 | Exporte les données d'un document en CSV                                                           |
| export-fixtures            | Exporte les données spécifiées dans le fichier *hooks* > *fixtures* dans un dossier *fixtures*     |
| export-json                | Exporte des données en JSON                                                                        |
| get-untranslated           | Exporte les chaînes de caractères non traduites                                                    |
| import-doc                 | Importe un document enregistré dans un fichier JSON                                                |
| install-app                | Installe une application sur un site                                                               |
| jupyter                    | Ouvre un [Notebook Jupyter](https://jupyter.org/){rel="&#x22;nofollow&#x22;"}                      |
| list-apps                  | Liste les applications installées sur un site                                                      |
| make-app                   | Crée la structure d'une nouvelle application                                                       |
| mariadb                    | Ouvre une console mariadb                                                                          |
| new-language               | Crée un nouveau fichier de traduction pour une langue donnée                                       |
| new-site                   | Crée un nouveau site                                                                               |
| ngrok                      | Crée un nouveau tunnel ngrok                                                                       |
| ngrok-webhook              | Lance une migration de base de données                                                             |
| partial-restore            | Lance une restoration partielle                                                                    |
| postgres                   | Lance une console postgres                                                                         |
| publish-realtime           | Publie des événements en temps réel sur le site                                                    |
| purge-jobs                 | Supprime les tâches de fond programmées en file d'attente                                          |
| ready-for-migration        | Vérifie si le site est prêt pour la migration                                                      |
| rebuild-global-search      | Lance la construction des index de recherche globale                                               |
| reinstall                  | Réinstalle un site                                                                                 |
| reload-doc                 | Synchronise le schéma d'un type de document                                                        |
| reload-doctype             | Synchronise le schéma d'un type de document                                                        |
| remove-from-installed-apps | Supprime une application de la liste des applications installées                                   |
| reload-doctype             | Synchronise le schéma d'un type de document                                                        |
| request                    | Lance une requête en temps qu'Administrateur                                                       |
| reset-perms                | Réinitialise les autorisations standard pour tous les types de documents                           |
| restore                    | Restaure la base de données avec une sauvegarde                                                    |
| run-parallel-tests         | Lance les tests en parallèle                                                                       |
| run-patch                  | Lance un patch de migration                                                                        |
| run-tests                  | Lance les tests Python                                                                             |
| run-ui-tests               | Lance les tests Cypress                                                                            |
| schedule                   | Lance le planificateur                                                                             |
| scheduler                  | Permet de changer l'état du planificateur                                                          |
| request                    | Lance une requête en temps qu'Administrateur                                                       |
| serve                      | Lance un serveur de développement                                                                  |
| set-admin-password         | Défini un mot de passe administrateur                                                              |
| set-config                 | Mets à jour le fichier `site_config.json`                                                          |
| set-last-active-for-user   | Modifie la date de dernière activité d'un utilisateur                                              |
| set-maintenance-mode       | Mets le site en mode maintenance                                                                   |
| set-password               | Modifie le mot de passe d'un utilisateur                                                           |
| show-config                | Imprime les variables d'environnement du site                                                      |
| show-pending-jobs          | Affiche les tâches de fond en attente                                                              |
| start-recording            | Lance l'enregistrement des requêtes en base des données                                            |
| stop-recording             | Arrête l'enregistrement des requêtes en base des données                                           |
| transform-database         | Permet de modifier les paramètres internes des tables en modifiant le format de ligne et le moteur |
| trigger-scheduler-event    | Déclenche une tâche de fond programmé                                                              |
| trim-database              | Nettoye la base de données                                                                         |
| trim-tables                | Nettoye les tables indiquées                                                                       |
| uninstall-app              | Désinstalle l'application du site                                                                  |
| update-translations        | Met à jour le fichier de traduction à partir d'un fichier CSV                                      |
| use                        | Défini le site par défaut                                                                          |
| version                    | Affiche les versions de toutes les applications installées                                         |
| watch                      | Recompile automatiquement les fichiers JS et CSS en cas de modification                            |
| worker                     | Lance un nouveau worker                                                                            |


# Génération d'images de prévisualisation

Depuis la v16, Dodock embarque un Chromium headless pour la génération PDF. Ce même Chromium peut désormais être réutilisé pour **capturer une image de prévisualisation** (screenshot) à partir d'un contenu HTML ou d'une URL — sans installer de dépendance supplémentaire, sans appel réseau externe, et avec un accès complet aux ressources locales (`/assets`, `/files`).

::dokos
Cette fonctionnalité est une **API Python réservée aux développeurs**. Elle n'expose pas d'endpoint HTTP : l'appel se fait exclusivement depuis du code Python (extension, hook, script serveur).
::

## Pourquoi cette approche

Avant cette fonctionnalité, générer une image de prévisualisation nécessitait l'application séparée `preview_generator`, qui embarquait Playwright et un second Chromium, et effectuait un appel HTTP vers `preview.frappe.cloud`. Cela impliquait :

- Une dépendance lourde à installer et maintenir indépendamment du framework
- L'impossibilité d'accéder aux ressources locales depuis le service hébergé
- Un aller-retour réseau pour quelque chose que le framework peut faire en local

Le Chromium déjà présent dans Dodock pour la génération PDF est désormais réutilisé directement, ce qui supprime ces contraintes.

## Utilisation

```python
from frappe.utils.preview import get_preview_from_html, get_preview_from_url

# Capturer une image à partir d'un HTML
image_bytes = get_preview_from_html("<h1>Bonjour</h1>", format="webp")

# Capturer une image à partir d'une URL
image_bytes = get_preview_from_url("https://example.com", format="jpg")
```

Les deux fonctions retournent des **bytes** représentant l'image encodée dans le format demandé.

### Formats supportés

| Format | Valeur à passer     |
| ------ | ------------------- |
| JPEG   | `"jpg"` ou `"jpeg"` |
| WebP   | `"webp"`            |

Chrome capture nativement JPEG et WebP — aucune conversion via Pillow n'est nécessaire.

## Comportement technique

::mermaid
sequenceDiagram
participant Code
participant preview.py
participant ChromePDFGenerator
participant Chromium


```text
Code->>preview.py: get_preview_from_html(html) / get_preview_from_url(url)
preview.py->>ChromePDFGenerator: Enregistrement du navigateur (add_browser)
preview.py->>Chromium: Connexion WebSocket (CDP)
Chromium-->>preview.py: Contexte de navigation isolé
alt HTML
    preview.py->>Chromium: Injection du contenu HTML + interception des ressources locales
else URL
    preview.py->>Chromium: Navigation vers l'URL
end
preview.py->>Chromium: Capture d'écran (1280×720, média screen)
Chromium-->>preview.py: Image en base64
preview.py->>Chromium: Fermeture du contexte
preview.py->>ChromePDFGenerator: Désenregistrement (remove_browser)
preview.py-->>Code: bytes de l'image
```
::

**Points clés :**

- La capture s'effectue à une résolution fixe de **1280×720 pixels** (résolution historique de référence)
- Le rendu utilise le &#x2A;*mode média `screen`** (et non `print`)
- Les ressources locales (`/assets`, `/files`) sont interceptées et servies depuis le disque — elles s'affichent correctement, contrairement à un appel vers un service externe
- Le singleton Chromium du générateur PDF est partagé : la génération d'aperçus et la génération PDF coexistent sans lancer plusieurs instances

## Prérequis

Chromium doit être installé sur le bench. Il est téléchargé automatiquement lorsque le **moteur Chrome** est activé pour la génération PDF (voir [Moteurs de génération PDF](https://doc.dokos.io/v5/dokos/generalites/impression-et-pdf#moteur-chrome)).

Si Chromium n'est pas disponible, les appels à `get_preview_from_html` et `get_preview_from_url` échouent avec une erreur explicite.

## Sécurité — surface SSRF

::callout{color="orange" icon="i-heroicons-exclamation-triangle"}
`get_preview_from_url` accepte n'importe quelle URL et ordonne à Chromium de la charger côté serveur. Cela constitue une **surface d'attaque SSRF** (Server-Side Request Forgery) si l'URL est fournie par un utilisateur non contrôlé. Cette API est volontairement **non exposée comme endpoint HTTP** : elle doit uniquement être appelée depuis du code de confiance (extension, hook, script serveur maîtrisé).

Ne jamais passer directement une URL fournie par un utilisateur sans validation préalable.
::

## Exemple d'usage dans une extension

```python
import frappe
from frappe.utils.preview import get_preview_from_html

def generer_apercu_modele(nom_modele: str) -> str:
    """Génère un aperçu WebP d'un modèle HTML et le sauvegarde comme fichier Dokos."""
    modele = frappe.get_doc("Mon Modele", nom_modele)
    html = frappe.render_template(modele.contenu_html, {"doc": modele})

    image_bytes = get_preview_from_html(html, format="webp")

    fichier = frappe.get_doc({
        "doctype": "File",
        "file_name": f"apercu_{nom_modele}.webp",
        "content": image_bytes,
        "is_private": 0,
    })
    fichier.insert()
    return fichier.file_url
```

## Voir aussi

- [Génération PDF avec Chrome](https://doc.dokos.io/v5/dokos/generalites/impression-et-pdf#moteur-chrome)
- [Formats d'impression](https://doc.dokos.io/v5/dokos/generalites/impression-et-pdf)


# Exécution sécurisée des scripts

Dodock permet d'exécuter des scripts Python et des templates Jinja directement depuis l'interface (Scripts serveur, formats d'impression, e-mails, etc.). Pour protéger l'installation contre des accès non autorisés aux données ou aux opérations critiques, le moteur distingue deux contextes d'exécution aux permissions distinctes.

## Deux contextes, deux niveaux de permissions

::mermaid
flowchart TD
A\[Script / Template] --> B{Quel contexte ?}
B -->|Template Jinja\nFormat d'impression\nE-mail| C\[render\_safe\_globals\n🔒 Lecture seule]
B -->|Script serveur\nCrochet Python\nAutomate| D\[exec\_safe\_globals\n✏️ Lecture + Écriture]
C --> E\[get\_doc, get\_list, get\_meta…\nPas d'écriture en base\nPas de file d'attente]
D --> F\[get\_doc, get\_list, get\_meta…\nnew\_doc, enqueue, sendmail…\nAccès étendu]

::

### Contexte de rendu — `render_safe_globals`

Utilisé par le moteur de templates Jinja (formats d'impression, modèles d'e-mail, aperçus). Ce contexte est **strictement en lecture** : aucune opération d'écriture en base de données, aucune mise en file d'attente de tâches en arrière-plan ne sont accessibles.

Fonctions disponibles (liste principale) :

| Fonction                             | Rôle                                                                |
| ------------------------------------ | ------------------------------------------------------------------- |
| `frappe.get_doc`                     | Récupère un document (objet déshydraté, sans méthodes d'écriture)   |
| `frappe.get_list` / `frappe.get_all` | Interroge des listes de documents                                   |
| `frappe.get_meta`                    | Retourne les métadonnées d'un DocType (objet déshydraté)            |
| `frappe.get_cached_doc`              | Récupère un document depuis le cache                                |
| `frappe.get_last_doc`                | Retourne le dernier document d'un type                              |
| `frappe.copy_doc`                    | Crée une copie locale d'un document                                 |
| `frappe.get_mapped_doc`              | Mappe un document vers un autre type                                |
| `frappe.sendmail`                    | Envoie un e-mail (retourne le nom du message, sans accès aux files) |
| Filtres et macros Jinja standards    | Formatage, dates, devises…                                          |

> **Remarque** : Les objets retournés par ces fonctions sont **déshydratés** — ils exposent les données du document (champs, tables enfants) mais pas les méthodes Python internes (`save`, `submit`, `delete`, etc.). Cela empêche tout effet de bord depuis un template.

### Contexte d'exécution — `exec_safe_globals`

Utilisé par les **Scripts serveur**, les automatisations et les crochets Python configurés via l'interface. Ce contexte étend le contexte de rendu avec des capacités d'écriture contrôlées.

Fonctions supplémentaires disponibles :

| Fonction                                     | Rôle                                                                                                              |
| -------------------------------------------- | ----------------------------------------------------------------------------------------------------------------- |
| `frappe.new_doc`                             | Crée un nouveau document (objet déshydraté prêt à l'enregistrement)                                               |
| `frappe.enqueue`                             | Met une tâche en file d'attente en arrière-plan                                                                   |
| QueryBuilder (lecture seule via `frappe.qb`) | Construit des requêtes SQL en lecture — les opérations d'écriture (`INSERT`, `UPDATE`, `DELETE`) restent bloquées |

> **Sécurité QueryBuilder** : même dans le contexte d'exécution, le QueryBuilder est restreint aux opérations de lecture. Les tentatives d'écriture via `frappe.qb` déclenchent une exception.

## Objets déshydratés

L'un des mécanismes clés de cette architecture est la **déshydratation** des objets retournés par les fonctions d'accès aux documents.

Un objet `Document` Frappe standard expose de nombreuses méthodes Python (`save()`, `submit()`, `delete()`, `reload()`, etc.) qui modifient la base de données. Dans un contexte sécurisé, ces méthodes ne doivent pas être accessibles à du code non vérifié.

La déshydratation consiste à convertir l'objet `Document` en un dictionnaire enrichi (`_dict`) qui :

- expose tous les **champs et leur valeur** (y compris les tables enfants)
- expose les métadonnées utiles (nom du DocType, statut de soumission, etc.)
- **ne contient aucune méthode** pouvant modifier la base de données

```python
# Ce que le script reçoit (objet déshydraté)
doc = frappe.get_doc("Sales Order", "SAL-ORD-2024-00001")
print(doc.customer)        # ✅ Lecture des champs
print(doc.items[0].qty)    # ✅ Accès aux tables enfants
doc.save()                 # ❌ AttributeError — méthode non disponible
```

## Mode développement

En environnement de développement (`developer_mode = 1`), les restrictions du contexte de rendu peuvent être assouplies pour faciliter le débogage des templates. Ce comportement est **opt-out** : l'assouplissement est actif par défaut en mode développement mais toujours désactivé en production.

::callout{type="warning"}
**Ne jamais tester en production la permissivité du mode développement.** Les restrictions de `render_safe_globals` sont conçues pour protéger les données en environnement de production ; leur désactivation expose l'installation à des risques de sécurité.
::

## Cas d'usage et bonnes pratiques

### Formats d'impression et modèles d'e-mail

Ces templates s'exécutent toujours dans le contexte `render_safe_globals`. Si un template génère une erreur du type `AttributeError` sur une méthode comme `save`, c'est le comportement attendu : le template tente d'appeler une opération d'écriture interdite.

**Bonne pratique** : limiter les templates Jinja à l'affichage de données. Toute logique de transformation complexe doit être déplacée vers un Script serveur ou un crochet Python.

### Scripts serveur

Les Scripts serveur disposent du contexte `exec_safe_globals`. Ils peuvent créer des documents, envoyer des e-mails et déclencher des tâches en arrière-plan, mais restent isolés du reste de l'environnement Python (pas d'import de modules arbitraires, pas d'accès au système de fichiers).

```python
# Exemple — Script serveur : créer un document et envoyer un e-mail
commande = frappe.new_doc("Sales Order")
commande.customer = "Maison Verte SARL"
commande.delivery_date = frappe.utils.add_days(frappe.utils.today(), 7)
# Ajout de lignes...
commande.insert()

frappe.sendmail(
    recipients=["contact@maisonverte.fr"],
    subject="Votre commande a été créée",
    message=f"Commande {commande.name} enregistrée."
)
```

### Identifier le contexte actif

Si vous développez une fonction utilitaire appelée depuis plusieurs contextes, vous pouvez vérifier les globals disponibles plutôt que de supposer le contexte :

```python
# Vérifier si l'exécution se trouve dans un contexte sécurisé
import frappe
if frappe.flags.in_safe_exec:
    # Comportement adapté au contexte sécurisé
    pass
```

## Architecture — fichiers concernés

| Fichier                         | Rôle                                                                                                        |
| ------------------------------- | ----------------------------------------------------------------------------------------------------------- |
| `frappe/utils/safe_exec.py`     | Définition de `render_safe_globals`, `exec_safe_globals`, `safer_exec` et des utilitaires de déshydratation |
| `frappe/utils/jinja.py`         | Intégration de `render_safe_globals` dans le moteur de templates Jinja (`get_jenv`)                         |
| `frappe/model/meta.py`          | Sérialisation des métadonnées en `_dict` pour la déshydratation                                             |
| `frappe/query_builder/utils.py` | Restriction du QueryBuilder aux opérations de lecture dans les contextes sécurisés                          |


# Mise en forme des exports Excel (XLSX)

Depuis cette version, les exports au format Excel bénéficient d'une **mise en forme automatique** (en-têtes en gras, indentation des rapports arborescents, formats numériques et monétaires) et d'un nouveau hook `get_xlsx_styles` qui vous permet de personnaliser entièrement le style de chaque cellule, ligne ou colonne.

Le moteur d'export a également été migré vers **xlsxwriter** en mode `constant_memory`, ce qui réduit sensiblement l'utilisation mémoire et améliore les performances sur les grands ensembles de données.

## Mise en forme automatique

Lorsqu'un utilisateur clique sur **Exporter → Excel** depuis un rapport Script ou un rapport Query, Dodock applique automatiquement :

| Élément                       | Style appliqué                                             |
| ----------------------------- | ---------------------------------------------------------- |
| Ligne d'en-têtes              | Texte en gras, alignement centré                           |
| Ligne de filtres (si incluse) | Libellés en gras                                           |
| Ligne de totaux (si présente) | Texte en gras                                              |
| Colonnes arborescentes        | Indentation proportionnelle au niveau                      |
| Champs Float / Percent        | Format numérique avec décimales                            |
| Champs Date / Time / Datetime | Format de date ou heure localisé                           |
| Champs Currency               | Format monétaire avec symbole et précision selon la locale |

Aucune configuration n'est nécessaire pour bénéficier de ces styles.

## Hook `get_xlsx_styles` — style personnalisé

Pour aller plus loin, vous pouvez définir la fonction `get_xlsx_styles` directement dans le fichier Python de votre rapport.

### Signature

```python
def get_xlsx_styles(columns, data, filters):
    """
    Retourne un dictionnaire de styles à appliquer sur le fichier Excel.

    Paramètres
    ----------
    columns : list[dict]
        Liste des colonnes du rapport (fieldname, label, fieldtype, …).
    data : list[list]
        Lignes de données du rapport.
    filters : dict
        Filtres appliqués par l'utilisateur.

    Retour
    ------
    dict | None
        Dictionnaire de styles, ou None pour n'appliquer aucun style personnalisé.
    """
    ...
```

### Structure du dictionnaire de styles

Le dictionnaire retourné peut contenir trois clés optionnelles :

```python
{
    "columns": {
        # Clé = index (int) ou fieldname (str) de la colonne
        0: {"bold": True, "bg_color": "#DDEBF7"},
        "montant": {"num_format": "#,##0.00 €"},
    },
    "rows": {
        # Clé = index de la ligne dans `data` (0 = première ligne de données)
        0: {"bold": True, "font_color": "#FFFFFF", "bg_color": "#2E75B6"},
    },
    "cells": {
        # Clé = tuple (index_ligne, index_colonne)
        (0, 2): {"italic": True, "border": 1},
    },
}
```

Toutes les propriétés de format acceptées par **xlsxwriter** sont utilisables : `bold`, `italic`, `font_color`, `bg_color`, `border`, `align`, `valign`, `num_format`, `font_size`, etc.

### Exemple complet

Cet exemple met en évidence la première colonne en bleu et marque en rouge toute ligne dont le montant dépasse 10 000 €.

```python
# mon_rapport.py

def execute(filters=None):
    columns = [
        {"fieldname": "client", "label": "Client", "fieldtype": "Data", "width": 200},
        {"fieldname": "montant", "label": "Montant (€)", "fieldtype": "Currency", "width": 120},
    ]
    data = [
        ["Maison Verte SARL", 8500],
        ["Bureau Moderne", 15200],
    ]
    return columns, data


def get_xlsx_styles(columns, data, filters):
    styles = {
        "columns": {
            "client": {"bg_color": "#DDEBF7", "bold": True},
        },
        "rows": {},
        "cells": {},
    }

    for row_idx, row in enumerate(data):
        montant = row[1] if len(row) > 1 else 0
        if montant and montant > 10000:
            styles["rows"][row_idx] = {"font_color": "#C00000", "bold": True}

    return styles
```

## Changements techniques (ruptures de compatibilité)

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Ces changements concernent uniquement les développeurs qui appellent directement les fonctions utilitaires d'export. Les utilisateurs finaux ne sont pas impactés.
::

### Nouvelle signature de `build_xlsx_data`

La fonction attend désormais le champ `report_name` dans le dictionnaire `data` et retourne un triplet :

```python
# Avant
result, header_index = build_xlsx_data(data, visible_idx, include_filters)

# Après
result, column_widths, styles = build_xlsx_data(data, visible_idx, include_filters)
# `data` doit contenir la clé `report_name`
```

### Changement de la structure des filtres

```python
# Avant
data.filters        # filtres affichés dans l'export

# Après
data.applied_filters  # filtres affichés dans l'export (anciennement data.filters)
data.filters          # filtres bruts transmis au rapport
```

### Nouvelle fonction `make_xls` pour le format `.xls`

La fonction `make_xlsx` utilise désormais exclusivement **xlsxwriter** et ne prend plus en charge le format `.xls` (ancienne génération). Pour produire un fichier `.xls`, utilisez la nouvelle fonction `make_xls` (basée sur openpyxl) :

```python
from frappe.utils.xlsxutils import make_xlsx, make_xls

# Export .xlsx avec mise en forme
wb = make_xlsx(data, "Nom de l'onglet", styles=my_styles)

# Export .xls (compatibilité)
wb = make_xls(data, "Nom de l'onglet")
```

Le paramètre `styles` de `make_xlsx` accepte le même dictionnaire que celui retourné par `get_xlsx_styles`.

## Flux de génération d'un export Excel

::mermaid
sequenceDiagram
participant U as Utilisateur
participant R as Interface Rapport
participant B as build_xlsx_data
participant S as get_xlsx_styles
participant X as make_xlsx (xlsxwriter)


```text
U->>R: Clique sur Exporter → Excel
R->>B: build_xlsx_data(data, visible_idx, include_filters)
B-->>R: result, column_widths, styles_auto
R->>S: get_xlsx_styles(columns, data, filters) [si défini]
S-->>R: styles_perso
R->>X: make_xlsx(result, sheet_name, styles=merge(styles_auto, styles_perso))
X-->>U: Fichier .xlsx téléchargé
```
::

## Performance

Grâce au mode `constant_memory` de xlsxwriter, l'empreinte mémoire reste stable quelle que soit la taille du rapport. Sur un rapport de 1 000 lignes × 14 colonnes avec indentation :

| Implémentation        | Temps moyen |
| --------------------- | ----------- |
| Ancienne (openpyxl)   | \~101 ms    |
| Nouvelle (xlsxwriter) | \~76 ms     |


# Fonctionnalités de base

## Bureau

::card-group
  :::card
  ---
  title: Utilisateurs
  to: https://doc.dokos.io/v5/dodock/fonctionnalites/utilisateurs
  ---
  Gestion des utilisateurs, des rôles et des autorisations
  :::

  :::card
  ---
  title: Outils
  to: https://doc.dokos.io/v5/dodock/fonctionnalites/outils
  ---
  Outils du quotidien
  :::

  :::card
  ---
  title: Bureau
  to: https://doc.dokos.io/v5/dodock/fonctionnalites/bureau
  ---
  Configuration et options du bureau
  :::

  :::card
  ---
  title: Emails
  to: https://doc.dokos.io/v5/dodock/administration/emails
  ---
  Configuration et gestion des emails
  :::
::

## Documents et flux de gestion

::card-group
  :::card
  ---
  title: Flux de travail
  to: https://doc.dokos.io/v5/dodock/fonctionnalites/workflows
  ---
  Création des flux de travail (workflows)
  :::

  :::card
  ---
  title: Personnalisations
  to: https://doc.dokos.io/v5/dodock/fonctionnalites/personnalisations
  ---
  Personnalisation des documents et des flux du bureau
  :::

  :::card
  ---
  title: Impression de documents
  to: https://doc.dokos.io/v5/dodock/fonctionnalites/impression
  ---
  Configuration pour les impressions de documents
  :::

  :::card
  ---
  title: Webhooks
  to: https://doc.dokos.io/v5/dodock/fonctionnalites/webhooks
  ---
  Création de webhooks envoyés depuis votre site
  :::

  :::card
  ---
  title: Notifications
  to: https://doc.dokos.io/v5/dodock/fonctionnalites/notifications
  ---
  Création de notifications
  :::

  :::card
  ---
  title: Règles de nommage
  to: https://doc.dokos.io/v5/dodock/fonctionnalites/nommage
  ---
  Configuration des règles de nommage des documents
  :::
::

## Données de base

::card-group
  :::card
  ---
  title: Contacts et adresses
  to: https://doc.dokos.io/v5/dodock/fonctionnalites/contacts-adresses
  ---
  Gestion des contacts et adresses
  :::

  :::card
  ---
  title: Pays et devises
  to: https://doc.dokos.io/v5/dodock/fonctionnalites/referentiel-pays-et-devises
  ---
  Gestion des pays et devises
  :::
::

## Site web et intégrations

::card-group
  :::card
  ---
  title: Site Web
  to: https://doc.dokos.io/v5/dodock/fonctionnalites/site-web
  ---
  Configuration de votre site web
  :::

  :::card
  ---
  title: Intégrations
  to: https://doc.dokos.io/v5/dodock/fonctionnalites/integrations
  ---
  Intégrations disponibles dans le framework
  :::
::


# Utilisateurs

## 1. Ajouter un utilisateur

Un utilisateur est une personne qui a accès au système avec un ensemble défini d’autorisation. Chaque utilisateur dispose d'un profil unique qui inclut des informations personnelles, des paramètres de sécurité, et des rôles spécifiques.

La gestion des utilisateurs et des rôles est essentielle pour contrôler l'accès aux données et aux fonctionnalités du système. En définissant clairement les rôles et les autorisations, vous pouvez garantir que chaque utilisateur a accès uniquement aux informations et aux outils dont il a besoin pour accomplir son travail, tout en protégeant les données confidentielles.

Les utilisateurs peuvent être ajoutés par le responsable système.

Il existe deux principaux types d'utilisateurs :

- **Utilisateurs du site Web** : clients, fournisseurs, étudiants, etc., qui n'ont accès qu'au portail/site web et à aucun module.
- **Utilisateurs du système** : personnes utilisant Dokos dans l'organisation et ayant accès aux modules, aux données de l'organisation, etc.

Dans la fiche utilisateur, de nombreuses informations peuvent être saisies manuellement. Pour simplifier le processus, les informations que les utilisateurs du site web doivent saisir sont limitées au prénom, au nom et à l'adresse e-mail.

L'adresse e-mail est la clé unique (ID) identifiant les utilisateurs.

## 2. Comment créer un nouvel utilisateur

> Administration > Utilisateurs et autorisations > **Utilisateur**

![Image permettant de visualiser l'ajout d'un nouvel utilisateur](https://doc.dokos.io/new-utilisateur-details.png)

Un email de bienvenue est envoyé lors de la création d'un nouvel utilisateur. Ce message de bienvenue est modifiable selon vos besoins (Paramètres système > email). Cependant, il est important d’être vigilant lors de la modification de cet email, car il contient un lien permettant à l'utilisateur de définir ou de modifier son mot de passe.
Pour garantir la sécurité et la fonctionnalité du lien de modification de mot de passe, une configuration spécifique est requise. Assurez-vous que le lien de réinitialisation de mot de passe inclus dans l'email est correctement configuré et testé.

Vous avez la possibilité d'envoyer un e-mail de bienvenue en laissant cochée la case correspondante. (3)

![Image permettant de visualiser un mail type de bienvenue.](https://doc.dokos.io/mail-bienvenue.png)

## 3. Caractéristiques

### 3.1. Rôle, restrictions et profil de rôle

- **Rôle**

Un rôle est un ensemble d'autorisations définissant ce qu'un utilisateur peut voir ou faire dans le système. Les rôles permettent de regrouper les utilisateurs ayant des responsabilités similaires.

Après l'enregistrement, une liste de rôles accompagnée de cases à cocher s'affichera. Sélectionnez simplement les rôles que vous souhaitez attribuer à l'utilisateur en cochant les cases correspondantes, puis enregistrez le document.

::callout{icon="i-heroicons-light-bulb"}
Si aucun rôle n'est attribué, l'utilisateur sera défini comme utilisateur de site web uniquement. (Rôle client)
::

- Vous pouvez visualiser les autorisations par défaut des rôles en cliquant dessus.

![Image permettant de visualiser la section rôles et autorisations](https://doc.dokos.io/rolesetautorisations.png)

::callout
Par défaut, l'accès à la fiches employé, permet lorsque l'employé est responsable de la gestion d'autres salariés, d'avoir automatiquement la visibilité sur les fiches de paie des salariés qu'il supervise.
::

::callout{color="red" icon="i-heroicons-exclamation-triangle"}
Particularité : lorsque l'on crée un employé et qu'on l'associe à un utilisateur, une case est cochée par défaut, définissant deux restrictions : l'une sur la société à laquelle l'employé est associé et l'autre sur l'employé lui-même. Ce qui aura pour effet de restreindre tous les documents contenant le champ employé et/ou société. Attention, si vous décochez cette case, elle sera automatiquement recochée à chaque enregistrement effectué sur la fiche. C'est un point de vigilance important lorsque les employés perdent l'accès défini suite au décochage de cette case.
::

- **Restrictions utilisateurs**

Chaque rôle possède des autorisations prédéfinies qui déterminent ce que les utilisateurs avec ce rôle peuvent faire dans le système. Ces autorisations couvrent des actions comme lire, créer, modifier, annuler, etc des documents pour différents modules et types de documents.

![Image permettant de visualiser le bouton autorisations](https://doc.dokos.io/utilisateur-autorisation.png)

Le bouton "Définir des restrictions utilisateurs" est une fonctionnalité qui permet d'ajouter des règles de restriction plus spécifiques aux utilisateurs au-delà des autorisations globales définies par leurs rôles. Cette fonctionnalité est essentielle pour affiner le contrôle d'accès et renforcer la sécurité des données.

(Par exemple, en mode multi-société, vous pouvez ajouter une restriction pour qu'un utilisateur ait accès uniquement à une des sociétés. Par conséquent, les documents contenant l'information de la société (Champ de type lien) ne seront accessibles que si l'utilisateur a les permissions pour cette société spécifique.)

Exemple concret : Comptable

**Rôle** : Comptable.

**Restrictions Utilisateurs** :
Accès complet aux modules financiers et comptables (factures, paiements, rapports financiers).
Peut consulter les informations de facturation des membres mais ne peut pas modifier les informations client.
Accès restreint aux données des utilisateurs à des fins de facturation uniquement.

- **Profil de rôle**

Vous pouvez définir des profils de rôle à utiliser comme modèle qui sélectionne plusieurs rôles d'ensemble.
Les **profils de rôle** permettent une gestion efficace et sécurisée des autorisations des utilisateurs. En créant des profils de rôle personnalisés, vous pouvez **adapter le système à vos besoins spécifiques**, améliorer la sécurité des données, **simplifier la gestion des utilisateurs**, et **assurer une maintenance** aisée des permissions, vous pouvez mettre à jour les profils de rôle une fois, et tous les utilisateurs ayant ce profil bénéficieront automatiquement des nouvelles permissions.

::callout
Rendez-vous sur la page [**Rôle et profil de rôle**](https://doc.dokos.io/v5/dodock/fonctionnalites/utilisateurs/roles#r%C3%B4le-et-profil-de-r%C3%B4le) de la documentation dodock.
::

### 3.2 Mot de passe

Lorsque vous créez un nouvel utilisateur, vous devez fournir des informations telles que le nom, l'adresse e-mail et le rôle. Une fois ces informations saisies, Dokos offre la possibilité d'envoyer un e-mail de bienvenue à l'utilisateur.

> Attention : Cet e-mail de bienvenue contient un lien pour que l'utilisateur puisse définir son mot de passe. Il est crucial de configurer ce lien de manière sécurisée, car il permet à l'utilisateur de créer un mot de passe pour accéder à Dokos (Portail et/ou bureau).

- Définition du Mot de Passe

En cliquant sur le lien fourni dans l'e-mail de bienvenue, l'utilisateur sera redirigé vers une page où il pourra définir son mot de passe. Assurez-vous que votre système est configuré pour appliquer des politiques de mot de passe robustes (comme la longueur minimale et l'inclusion de caractères spéciaux) pour renforcer la sécurité.

**Score minimum du mot de passe** : Score pour le vérificateur de force du mot de passe
Un score de 2 est moyen Un score de 3 est fort Un score de 4 est très fort.

**Limite de génération de lien de réinitialisation de mot de passe** : Ceci permet de limiter le nombre de demandes de réinitialisation de mot de passe par heure, la valeur par défaut est 3. Le paramétrer sur 0 autorisera un nombre illimité de demandes de génération de lien de réinitialisation de mot de passe.

- Réinitialisation du Mot de Passe

Les utilisateurs peuvent réinitialiser leur mot de passe à tout moment en utilisant l'option "Mot de passe oublié". Les administrateurs ont également la possibilité de réinitialiser les mots de passe des utilisateurs si nécessaire.
En suivant ces bonnes pratiques, vous assurez une gestion sécurisée et efficace des mots de passe.

- **Définir un nouveau mot de passe** : En tant que gestionnaire système, vous pouvez définir un nouveau mot de passe pour l'utilisateur.
- **Envoyer une notification de mise à jour du mot de passe** : Envoyez une notification par e-mail à l'utilisateur indiquant que son mot de passe a été modifié.
- **Déconnectez-vous de tous les appareils lors du changement de mot de passe** : lorsque vous modifiez le mot de passe de l'utilisateur, cela déconnecte l'utilisateur du PC et de tout appareil mobile auquel il s'est connecté.

![Image permettant de visualiser la zone mot de passe](https://doc.dokos.io/mdp-utilisateur.png)

- **Réinitialiser le mot de passe** : un e-mail contenant des instructions pour réinitialiser le mot de passe de l'utilisateur sera envoyé au compte de messagerie de l'utilisateur .
- **Réinitialiser le secret OTP** : réinitialiser le secret OTP pour se connecter via l'authentification à deux facteurs.

**Sécurité des mots de passe**

::callout
Il n'y a aucune possibilité de récupérer les mots de passe, le seul moyen d'avoir accès à votre compte en cas d'oubli de mot de passe est par la réinitialisation.
::

**Auto-hébergement :**

- Console Bench : Pour les insatallations auto-hébergées, les administrateurs peuvent utiliser la console Bench pour réinitialiser les mots de passe des utilisateurs.

Rendez sur la page Administration -> [Commandes](https://doc.dokos.io/v5/dodock/administration/commandes)

*set-admin-password: Défini un mot de passe administrateur*

### **Authentification à Double Facteur**

::callout{color="red" icon="i-heroicons-exclamation-triangle"}
La double authentification est une mesure de sécurité essentielle pour protéger votre entreprise et vos données. Elle combine quelque chose que vous savez (votre mot de passe) avec quelque chose que vous avez (un code temporaire) pour assurer une protection optimale.
::

> paramètres > paramètres système > Connexion
> ![Image permettant de visualiser l'Authentification à double facteur.](https://doc.dokos.io/authentification-double-facteur.png)

**Pourquoi utiliser la Double Authentification ?**

- Sécurité renforcée : Même si votre mot de passe est compromis, l'accès à votre compte est protégé par un second facteur de vérification.
- Prévention des accès non autorisés : Elle empêche les accès non autorisés même si des informations de connexion sont volées.

**Comment fonctionne la Double Authentification ?**

- Accéder aux Paramètres système > Connexion : Accédez aux paramètres de sécurité pour activer la double authentification pour les utilisateurs.
- Choisir la méthode : Dokos propose plusieurs méthodes d’authentification telles que les applications d'authentification OTP (par exemple, Google Authenticator, Microsoft Authenticator, 2FA Authenticator), e-mail et les codes SMS (Service payant).

**Processus de Connexion**

- Saisie du mot de passe : Lors de la connexion, l'utilisateur saisit son nom d'utilisateur et son mot de passe comme d'habitude.
- Deuxième facteur : Après avoir entré le mot de passe, l'utilisateur est invité à fournir le second facteur. Si une application d'authentification OTP est utilisée, il doit entrer le code temporaire généré par l'application.

**Utilisation des Applications d'Authentification**

- Installation de l'Application : Les utilisateurs doivent installer une application d'authentification compatible (comme Google Authenticator) sur leur smartphone.
- Lien avec Dokos : Lors de la configuration initiale, Dokos fournit un code QR que les utilisateurs scannent avec l'application d'authentification. Cela lie le compte Dokos à l'application pour générer les codes de vérification.

### 3.4 Suivi des documents

Avec cette option, vous pouvez suivre divers documents dans le système et recevoir des notifications par e-mail lorsqu'ils sont mis à jour.

### 3.5 Email

- **Envoyer des notifications pour les fils de discussion par courrier électronique** : l'utilisateur recevra des notifications pour les conversations par courrier électronique qui ont lieu dans des types de documents tels que les opportunités.
- **Envoyez-moi une copie des e - mails sortants** : envoie à l'utilisateur une copie des e-mails qu'ils envoient. Ceci est utile pour suivre si l'e-mail a été envoyé.
- **Autorisé dans les mentions** : autorise le nom de cet utilisateur à apparaître dans les conversations du fil de discussion afin qu'il puisse être mentionné à l'aide de «@».
- **Signature d'e-mail** : l'ajout d'une signature d'e-mail ici la définira par défaut pour tous les e-mails sortants de l'utilisateur. Ceci est différent d'un pied de page défini à partir du fichier principal de la société .

### 3.6 Modules activés

Les utilisateurs auront accès à tous les modules pour lesquels ils ont un accès basé sur les rôles. Si vous souhaitez restreindre l'accès à certains modules pour cet utilisateur, décochez les modules de cette liste.

### 3.7 Paramètres de sécurité

- **Sessions simultanées** : sessions de connexion simultanées auxquelles l'utilisateur est autorisé. Vous pouvez utiliser le même ensemble d'informations d'identification pour plusieurs utilisateurs en autorisant plus de sessions. Cela peut être restreint globalement à partir des paramètres système . Pour un compte cloud, le nombre total de sessions simultanées ne peut pas dépasser le nombre total d'utilisateurs abonnés.
- **Type d'utilisateur** : si l'utilisateur a un rôle coché autre que Client, Fournisseur, Patient ou Étudiant, il devient automatiquement un utilisateur système. Ce champ est en lecture seule.
- **Connexion après, connexion avant** : si vous souhaitez donner à l'utilisateur l'accès au système uniquement entre les heures de bureau ou pendant les week-ends, spécifiez-le ici. Par exemple, si les heures de bureau sont de 10 h à 18 h, définissez les heures d'ouverture de session après, de connexion avant à 10 h et 18 h.
- **Restreindre IP** : limitez la connexion de l'utilisateur aux adresses IP spécifiées ici. Cela peut être utilisé pour que l'utilisateur ne puisse se connecter qu'à partir d'ordinateurs de bureau. Plusieurs adresses IP peuvent être ajoutées séparées par des virgules.

Cette section affiche également d'autres détails tels que la dernière connexion, la dernière adresse IP et l'heure de la dernière activité de l'utilisateur.

### 3.8 Authentification tierce

Cela permettra aux utilisateurs d'utiliser Facebook, Google ou GitHub pour se connecter. Pour utiliser cette fonctionnalité, inscrivez-vous à un compte développeur avec Facebook, Google, GitHub, etc. Créez une application sur leur console, spécifiez un nom d'application, l'URL d'origine et l'URL de rappel, copiez l'ID client et les informations secrètes du client ici pour commencer à utiliser.

### 3.9 Accès API

Vous pouvez générer des clés secrètes API à partir de cette section à l'aide du bouton Générer des clés. Cela peut être utilisé pour accéder aux données de votre compte à partir d'une autre application, par exemple, un système de point de vente hors ligne.

## 4. Méthodes de connexion

Dans les paramètres système, sous la section Sécurité, si vous cochez la case **Autoriser la connexion à l'aide du numéro de mobile**, un numéro de mobile peut également être utilisé pour vous connecter. Même si un numéro de mobile sera unique, il ne sera pas traité comme un identifiant d'utilisateur.

**Types de connexion** :

- Connectez-vous par e-mail
- Connectez-vous avec e-mail ou mobile


# Rôle et profil de rôle

Un **rôle** définit les **autorisations** d'accès à **divers documents** dans Dokos.

Les **rôles définissent un ensemble d'autorisations** qui peuvent être définies à **partir du gestionnaire d'autorisations de rôles** . Les rôles les plus couramment utilisés sont déjà définis dans Dokos, vous pouvez utiliser le système avec eux. Si nécessaire, vous pouvez ajouter d'autres rôles.
Par exemple, si vous attribuez le rôle Utilisateur commercial à un utilisateur, celui-ci pourra accéder à des documents tels que Devis et Commandes client, car les autorisations sont déjà définies pour le rôle Utilisateur commercial.

Les profils de rôle stockent différents rôles afin que plusieurs rôles puissent être attribués à la fois.

Les **profils de rôle servent de modèle** pour stocker et sélectionner plusieurs rôles. Ce profil de rôle peut ensuite être attribué à un utilisateur.

Par exemple, un superviseur des ventes aura les rôles Employé, Directeur des ventes, Utilisateur des ventes et Directeur principal des ventes. Les profils de rôle sont utiles pour attribuer plusieurs rôles à la fois lors de l'ajout de plusieurs employés.

---

Pour accéder au **rôle**, allez sur :

> Accueil > Utilisateurs et autorisations > **Rôle**

![ajouter\_un\_rôle.png](https://doc.dokos.io/content/setup/role-ande-role-profile/ajouter_un_role.png)

## 1. Comment ajouter un rôle ?

### 1.1 Ajout rapide

1. Allez dans la liste des rôles, cliquez sur &#x2A;*➕ Ajouter Rôle.**
2. Entrez un **nom** pour le rôle.

![ajout\_rapide.png](https://doc.dokos.io/content/setup/role-ande-role-profile/ajout_rapide.png)

### 1.2 Ajout complet

1. Modifier en pleine page
2. **Nom** du rôle
3. Chemin de la **page d'Accueil**
4. **Désactivé** le rôle, si la case est cochée le rôle sera désactivé.
5. **Choisissez si le rôle dispose d'un accès au bureau**. Un rôle disposant d'un accès au bureau peut accéder aux modules Dokos et aux documents de l'organisation. Le niveau d'accès dépend des rôles attribués à l'utilisateur.
6. **Authentification à double facteur** : Vous pouvez ajouter une authentification à deux facteurs pour le rôle et la restreindre à un domaine spécifique.
7. **Enregistrer**.

![création\_d'un\_rôle.png](https://doc.dokos.io/content/setup/role-ande-role-profile/creation_dun_role.png)

## 2. Caractéristiques

### 2.1 Paramètres de navigation

Cochez les cases pour laisser les actions actives au nouveau rôle.

- Barre de recherche
- Notifications
- Chat

### 2.2 Paramètre de la liste

Cochez les cases pour laisser les actions actives au nouveau rôle.

- Barre latérale
- Actions en masse
- Voir la sélection de vues

### 2.3 Paramètre du formulaire

Cochez les cases pour laisser les actions actives au nouveau rôle.

- Barre latérale
- Chronologie
- Tableau de bord
- Personnalisé

![caractéristiques\_rôles.png](https://doc.dokos.io/content/setup/role-ande-role-profile/caracteristiques_roles.png)

### 2.4 Gestionnaire des rôles

À partir de là, vous pouvez accéder au gestionnaire d'autorisations de rôles et définir des autorisations pour le rôle sur différents types de document.

![gestionnaire\_des\_rôles.png](https://doc.dokos.io/content/setup/role-ande-role-profile/gestionnaire_des_roles.png)

## 2. Comment ajouter un profil de rôle ?

Pour accéder au profil de rôle, allez sur :

> Accueil > Utilisateurs et autorisations > Autorisations > **Profil de rôle**

![profil\_de\_rôle.png](https://doc.dokos.io/content/setup/role-ande-role-profile/profil_de_role.png)

1. Allez dans la **liste Profil de rôle*&#x2A;, cliquez sur **➕ Ajouter Profil de rôle**.
2. Entrez un **nom**.
3. Sélectionnez les rôles que vous souhaitez attribuer à ce profil.
4. **Enregistrer**.

![type\_de\_profil.png](https://doc.dokos.io/content/setup/role-ande-role-profile/type_de_profil.png)


# Autorisations basées sur les rôles

Les **autorisations** d'accès à différents documents peuvent être contrôlées à l'aide des autorisations basées sur les rôles.

Dokos dispose d'un **système d'autorisation basé sur les rôles**. Cela signifie que vous pouvez attribuer des rôles aux utilisateurs et que des autorisations peuvent être définies sur des rôles.

Le gestionnaire d'autorisations de rôle vous permet de définir quels rôles peuvent accéder à quels documents et avec quelles autorisations (lecture, écriture, soumission, etc.).

Une fois les rôles attribués à un utilisateur, leur accès peut être limité à des documents spécifiques. La structure d'autorisation vous permet de définir différentes règles d'autorisation pour différents champs à l'aide d'un concept appelé Niveau d'autorisation d'un champ.

---

Pour accéder au **gestionnaire d'autorisations de rôle**, allez sur :

> Accueil > Utilisateurs et autorisations > **Gestionnaire d'autorisations de rôle**

## 1. Comment utiliser le gestionnaire d'autorisations de rôle ?

![gestionnaire\_des\_rôles.png](https://doc.dokos.io/content/setup/role-ande-role-profile/gestionnaire_des_roles.png)

Les autorisations sont appliquées à une combinaison de :

- **Rôles** : Comme nous l'avons vu précédemment, les utilisateurs se voient attribuer des rôles et c'est sur ces rôles que les règles d'autorisation sont appliquées. Par exemple, un utilisateur commercial peut se voir attribuer les rôles d'un employé et d'un utilisateur commercial.

Les exemples de rôles incluent le gestionnaire de comptes, l'employé, l'utilisateur des ressources humaines, etc.

- **Types de documents** : chaque type de document, maître ou transaction, possède une liste distincte d'autorisations basées sur les rôles, comme illustré dans la capture d'écran précédente.

Des exemples de types de documents sont la facture de vente, la demande de congé, la saisie de stock, etc.

- **Niveaux d'autorisation** : Dans chaque document, vous pouvez regrouper les champs par "niveaux". Chaque groupe de champs est désigné par un numéro unique (0 à 9). Un ensemble distinct de règles d'autorisation peut être appliqué à chaque groupe de champs. Par défaut, tous les champs sont de niveau 0.

L'autorisation **Niveau** relie les champs de niveau X à une règle d'autorisation de niveau X.

- **Étapes du document** : les autorisations sont appliquées à chaque étape du document, comme la création, l'enregistrement, la soumission, l'annulation et la modification. Un rôle peut être autorisé à imprimer, envoyer par e-mail, importer ou exporter des données, accéder à des rapports ou définir des autorisations utilisateur.
- **Autorisations utilisateur** : en utilisant les autorisations utilisateur dans Dokos, un utilisateur peut être limité à accéder uniquement à des documents spécifiques pour ce type de document. Par exemple: un seul territoire de tous les territoires. Les autorisations utilisateur définies pour d'autres types de document sont également appliquées si elles sont liées au type de document actuel via les champs de lien.

Par exemple, un client est un champ de lien dans une commande client ou un devis. Dans le gestionnaire d'autorisations de rôle, les autorisations utilisateur peuvent être définies à l'aide du bouton **Définir les autorisations utilisateur**.

Pour définir les **autorisations utilisateur en fonction des documents** / **champs**, allez sur :

> Accueil > Utilisateurs et autorisations> Autorisations > **Autorisations utilisateur**

- **Ajouter une nouvelle règle** : dans le gestionnaire des autorisations de rôle, pour ajouter une nouvelle règle, cliquez sur le bouton Ajouter une nouvelle règle et une fenêtre contextuelle vous demandera de sélectionner un rôle et un niveau d'autorisation. Une fois que vous sélectionnez ceci et cliquez sur «Ajouter», cela ajoutera une nouvelle ligne à votre tableau de règles.

## 2. Fonctionnement des autorisations basées sur les rôles

La demande de congé est un bon exemple qui englobe tous les domaines d'un système d'autorisation.

- Il doit être créé par un employé. Pour cela, le rôle d'employé doit disposer des autorisations de lecture, d'écriture et de création.

![employé\_congés.png](https://doc.dokos.io/content/setup/role-ande-role-profile/employe_conges.png)

- **Un employé** ne devrait pouvoir accéder qu'à sa demande de congé. Par conséquent, l'enregistrement des autorisations utilisateur doit être créé pour chaque combinaison utilisateur-employé.
- Si vous souhaitez qu'un employé sélectionne uniquement un document dans un autre document et ne dispose pas d'un accès en lecture à ce document dans son ensemble, n'accordez que Sélection permanente au rôle Employé.
- **Le responsable des ressources humaines** doit pouvoir voir toutes les demandes de congé. Créez une règle d'autorisation pour HR Manager au niveau 0, avec des autorisations de lecture. Appliquer les autorisations utilisateur doit être désactivé.

![rh\_-\_rôle.png](https://doc.dokos.io/content/setup/role-ande-role-profile/rh_-_role.png)

- L'**approbateur de congés** devrait être en mesure de voir et de mettre à jour les demandes de congé des employés sous sa responsabilité. L'approbateur de congé a un accès en lecture et en écriture au niveau 0. Les documents d'employés pertinents doivent être inscrits dans les autorisations d'utilisateur des approbateurs de congé. (Cet effort est réduit pour les approbateurs de congé mentionnés dans les documents des employés, en créant par programme des enregistrements d'autorisation utilisateur).

![approbateur\_de\_congé\_-\_rôle.png](https://doc.dokos.io/content/setup/role-ande-role-profile/approbateur_de_conge_-_role.png)

- Il ne doit être approuvé / rejeté que par l'utilisateur des ressources humaines ou l'approbateur de congé. Le champ Statut d'une demande de congé est défini au niveau 1. L'utilisateur des RH et l'approbateur de congé reçoivent des autorisations de lecture et d'écriture pour le niveau 0, tandis que tous les autres (tous) ont l'autorisation de lecture pour le niveau 1.
- **L'Utilisateur RH** doit être en mesure de déléguer des demandes de congé à ses subordonnés. L'utilisateur HR a le droit de définir les autorisations de l'utilisateur. Un utilisateur avec le rôle d'utilisateur HR serait en mesure de définir des autorisations utilisateur sur l'application de congé pour d'autres utilisateurs.

![demande\_de\_congé\_rh.png](https://doc.dokos.io/content/setup/role-ande-role-profile/demande_de_conge_rh.png)


# Autorisations des utilisateurs

Les **autorisations utilisateur** sont un moyen de **restreindre l'accès des utilisateurs** à des **documents particuliers**.

Les autorisations basées sur les rôles permettent de définir un accès complet (par défaut) à un type de document (doctype) comme la facture de vente, les commandes, le devis, etc. Cela signifie que lorsque vous attribuez un rôle d'utilisateur de vente à un utilisateur, il peut accéder à toutes les commandes et Citations.

Les autorisations utilisateur peuvent être utilisées pour restreindre l'accès à certains documents en fonction des champs de lien dans le document. Par exemple, considérez que vous faites des affaires avec plusieurs territoires et que vous souhaitez restreindre l'accès de certains utilisateurs commerciaux aux devis / bons de commande appartenant à un territoire particulier. Cela peut être fait via les autorisations utilisateur. Les restrictions peuvent être définies sur le client, le fournisseur, le groupe de clients, le groupe de fournisseurs, etc.

La définition des autorisations utilisateur est particulièrement utile lorsque vous souhaitez restreindre en fonction :

- **Permettre à l'utilisateur d'accéder aux données appartenant à une organisation**
- **Permettre à l'utilisateur d'accéder aux données relatives à un client ou un territoire spécifique**.

---

Pour accéder aux **autorisations des utilisateurs**, allez sur :

Accueil > Utilisateur et autorisations > **Autorisations utilisateur**

![autorisation\_utilisateurs.png](https://doc.dokos.io/content/setup/user-permissions/autorisation_utilisateurs.png)

## 1. Comment créer des autorisations utilisateur

1. Accédez à la liste des autorisations utilisateur, cliquez sur **➕ Ajouter autorisation utilisateur**.
2. Sélectionnez l'utilisateur pour lequel la règle doit être appliquée.
3. Sélectionnez le type de document à autoriser (par exemple "Société").
4. Sous Pour Valeur, sélectionnez l'élément spécifique que vous souhaitez autoriser (le nom de la «Société).
5. Si vous cochez «Est par défaut», la valeur sélectionnée dans «Pour valeur» sera utilisée par défaut pour toutes les futures transactions de cet utilisateur. C'est si la société 'Unico Plastics Inc.' est sélectionné comme «Pour la valeur», cette société sera définie par défaut pour toutes les futures transactions de cet utilisateur.

![création\_nouvelle\_autorisation.png](https://doc.dokos.io/content/setup/user-permissions/creation_nouvelle_autorisation.png)

> Remarque : Une seule autorisation d'utilisateur unique peut être définie par défaut pour un type de document particulier pour un utilisateur spécifique.

## 2. Plus d'actions d'autorisation utilisateur

### 2.1 Contrôle avancé

Dans Contrôle avancé, vous pouvez avoir une meilleure maîtrise de l'endroit où l'autorisation utilisateur est appliquée.

#### 2.1.1 Applicable pour :

Vous pouvez éventuellement appliquer des autorisations utilisateur uniquement pour un type de document spécifique en définissant le Type de document après avoir décoché la case Appliquer à tous les types de document. L' option Définir Applicable pour rendra l'autorisation de l'utilisateur actuel applicable uniquement sous le modèle de type de document sélectionné.

Dans l'autorisation utilisateur ci-dessus, l'utilisateur ne pourra accéder qu'aux commandes de vente de la société sélectionnée.

Remarque: si Applicable pour n'est pas défini, l'autorisation utilisateur s'appliquera à tous les types de documents associés.

#### 2.1.2 Masquer les descendants

La valeur de **Autoriser** peut être un DocType avec une arborescence, qui aura des enregistrements avec une relation parent-enfant ou ancêtre-descendant.

Supposons que **Pour la valeur**, «Dokompany.», a une société enfant «Dokompany services». Lorsqu'une autorisation utilisateur est créée pour «Dokompany», les autorisations pour ses descendants sont également accordées.

Masquer les descendants n'est visible que lors de la sélection d'un type de document d'arborescence. En activant cette case à cocher, les autorisations pour les descendants de For Value ne seront pas accordées.

Un utilisateur qui peut afficher les enregistrements de «Dokompany» ne pourra pas voir ceux de «Dokompany services».

## 2.2 Ignorer les autorisations des utilisateurs sur certains champs

Une autre façon de permettre aux documents d'être vus par tous ceux qui ont été restreints par les autorisations utilisateur est de cocher «Ignorer les autorisations utilisateur» sur un champ particulier en accédant à Personnaliser le formulaire .

Par exemple, vous ne voulez pas que les actifs soient limités pour aucun utilisateur, puis sélectionnez Actif dans le type de formulaire. Sous le tableau des champs, développez le champ Société et cochez "Ignorer les autorisations utilisateur".

## 2.3 Autorisations strictes

Cela restreint l'accès des utilisateurs aux documents de manière plus stricte.

## 2.4 Vérification de l'application des autorisations utilisateur

Enfin, une fois que vous avez créé votre modèle d'autorisation hermétique et que vous souhaitez vérifier comment il s'applique à divers utilisateurs. Vous pouvez le voir via le rapport Documents autorisés pour l'utilisateur . À l'aide de ce rapport, vous pouvez sélectionner l' utilisateur et le type de document et afficher les documents auxquels un utilisateur particulier peut accéder.

Cochez la case Afficher les autorisations pour afficher les niveaux d'accès en lecture / écriture / soumission et les autres niveaux d'accès.

> Remarque : Si vous ne pouvez pas accéder à la commande client ou à tout autre type de document de cette liste, assurez-vous que vous avez correctement défini les rôles .


# Autorisation de rôle pour la page et le rapport

**L'accès à différentes pages et rapports peut être contrôlé dans Autorisation de rôle pour la page et le rapport.**

Les **types de documents** sont **Commande client**, **Client**, **Fournisseur**, etc. Il s'agit d'un type de document, ce qui signifie qu'ils peuvent contenir plusieurs documents de ce type. Une **page** est une page unique comme les **paramètres de vente** . Vous ne pouvez pas créer plusieurs paramètres de vente, mais vous pouvez créer plusieurs commandes client.

Dans Dokos, l'utilisateur peut créer une interface utilisateur personnalisée à l'aide de Page et un rapport personnalisé à l'aide du Générateur de rapports ou d'un rapport de requête. Dokos dispose d'un système d'autorisation basé sur les rôles dans lequel vous pouvez attribuer des rôles à l'utilisateur. Le même rôle peut être attribué à la page et au rapport pour y accéder.

Si l'utilisateur a activé le mode développeur, il peut ajouter les rôles directement dans la page et l'enregistrement de rapport. Dans ce cas, les autorisations seront également reflétées dans le fichier JSON de la page / du rapport. Considérez que vous souhaitez restreindre les rôles qui peuvent accéder à certaines pages et rapports dans Dokos, cela peut être fait via l'autorisation de rôle pour la page et le rapport.

---

Pour accéder à l'autorisation de rôle pour la page et le rapport, allez sur :

> Accueil > Utilisateurs et autorisations> **Autorisation de rôle pour la page et le rapport**

![autorisation\_utilisateurs.png](https://doc.dokos.io/content/setup/user-permissions/autorisation_utilisateurs.png)

## 1. 1. Comment utiliser l'autorisation de rôle pour l'outil de page et de rapport

![autorisation\_pour\_la\_page\_et\_la\_rapport.png](https://doc.dokos.io/content/setup/user-permissions/autorisation_pour_la_page_et_la_rapport.png)

Si le mode développeur est désactivé, l'utilisateur peut attribuer les rôles à la page et au rapport à l'aide de la page «Autorisation de rôle pour la page et le rapport».

![autorisation\_rapport.png](https://doc.dokos.io/content/setup/user-permissions/autorisation_rapport.png)

### 1.1 Réinitialiser les valeurs par défaut

À l'aide du bouton **Rétablir les valeurs par défaut**, l'utilisateur peut supprimer les autorisations personnalisées appliquées à une page ou à un rapport. Ensuite, les autorisations par défaut seront applicables sur cette page ou sur ce rapport.

## 2. Définition des autorisations de rôle à partir de la page / du rapport en tant que développeur

### 2.1 Autorisations de rôle pour la page

> Allez sur : Accueil > Développeur > **Page**.

- Ajoutez une ligne et sélectionnez les autres rôles pouvant accéder à la page.

### 2.2 Autorisations de rôle pour le rapport

> Allez sur : Accueil > Développeur > Rapport.

- Ajoutez des lignes avec des rôles qui peuvent accéder au rapport.

![rapport\_-\_gérer\_autorisations.png](https://doc.dokos.io/content/setup/user-permissions/rapport_-_gerer_autorisations.png)


# Administrateur

**L'administrateur est au-dessus du Gestionnaire système et dispose de tous les droits et autorisations pour un compte Dokos.**

Un gestionnaire système dispose également d'autorisations sur la plupart des éléments du système, mais l'administrateur dispose d'un accès illimité.

1. Si votre compte Dokos est hébergé dans le cloud chez nous, vous ne pourrez pas accéder à votre compte Dokos en tant qu'administrateur.
2. Pour les comptes hébergés dans le cloud, les mises à niveau sont gérées à partir du backend. Nous réservons les identifiants de connexion administrateur avec nous afin que nous puissions mettre à niveau tous les comptes Dokos du client à partir du backend.
3. Étant donné que sur un seul serveur nous pouvons héberger de nombreux comptes Dokos de clients, par mesure de sécurité, nous ne pouvons pas partager les informations d'identification du compte administrateur avec un utilisateur hébergé dans le cloud. (une exception serait si vous achetez un grand nombre d'utilisateurs et que votre compte est exclusivement hébergé sur un serveur).
4. Pour les comptes locaux auto-hébergés, les informations d'identification de l'administrateur sont avec l'utilisateur du compte.


# Configurer l'authentification à double facteur

L'authentification à double facteur permet vérifier l'identité de celui qui essaye de se connecter en lui envoyant un email de vérification, en demandant un code généré par une application d"authentification ou en envoyant un SMS au numéro de téléphone du demandeur.

Il est recommandé d'activer l'authentification à double facteur pour améliorer la sécurité de son site Dokos.

## Activer l'authentification à double facteur

1. Dans les **Paramètres Système**, ouvrez la section **Authentification à Double Facteur** et cochez l'option **Autoriser l'authentification à double facteur**
2. Sélectionnez les options qui s'appliquent à votre site.
3. Selectionnez la méthode d'authentification
4. Mettez un nom d'émetteur que vos utilisateurs pourront reconnaître facilement

## Méthode d'authentification

### Email

A chaque connexion, un email est envoyé à l'utilisateur avec un code temporaire de connexion.
L'utilisateur doit copier ce code et le coller dans la fenêtre qui s'est ouverte sur le site Dokos.

### Application OTP

Les applications pouvant être utilisées sont (liste non exhaustive): FreeOTP, Google Authenticator, Lastpass Authenticator, Authy, Duo Mobile ou Bitwarden Authenticator.

#### Première connexion

Lors de la première connexion, l'utilisateur reçoit un email avec un lien le renvoyant vers le site Dokos.
Sur la page, il doit scanner le QRCode généré par Dokos avec son application OTP.

![otp\_qrcode.png](https://doc.dokos.io/content/\(unsorted\)/otp_qrcode.png)

### Connexion à Dokos

Lors de chaque connexion à Dokos, l'utilisateur doit ouvrir son application OTP et entrer le code correspondant au site Dokos dans la fenêtre qui s'ouvre.
Il n'y a pas d'envoi d'email.

### SMS

Pour recevoir un SMS de vérification, configurez l'accès à une passerelle d'envoi de SMS dans les **Paramètres des SMS**.
L'utilisateur reçoit un SMS à chaque connexion, qu'il peut saisir dans la fenêtre qui s'ouvre aprsè avoir entré ses identifiants.


# Partager un document

**Vous pouvez partager des documents avec d'autres utilisateurs via le partage dans DOKOS.**

En plus des autorisations d'utilisateur et de rôle, vous pouvez également partager un document avec un autre utilisateur si vous disposez des droits de partage pour ce document. Notez qu'un document partagé sera visible par l'autre utilisateur même si le document est restreint via les autorisations utilisateur.

---

## 1. Comment partager un document ?

Pour partager un document, ouvrez le document, cliquez sur l'icône &#x2A;*➕** sous **Partage avec** et sélectionnez l'utilisateur avec lequel vous souhaitez partager :

![partager\_un\_doc.png](https://doc.dokos.io/content/setup/user-permissions/partager_un_doc.png)

Dans la fenêtre contextuelle, vous pouvez sélectionner tous les utilisateurs ou un utilisateur en particulier.

L'accès en lecture, en écriture, en soumission et en partage peut être accordé à l'utilisateur pour ce document.


# Utilisateur limité

**L'utilisateur aura un accès limité au système.**

Les utilisateurs limités peuvent accéder uniquement aux documents spécifiques des modules spécifiques. Certains utilisateurs n'utilisent pas tous les modules et n'ont besoin que de modules spécifiques. Par exemple, dans l'entreprise, pour enregistrer la demande de présence quotidienne ou de congé, chaque employé a eu accès au système requis. Mais supposons que 500 personnes travaillent dans l'entreprise, dont seulement 100 utilisent tous les documents et les 400 autres n'ont besoin que de documents pour les demandes de présence ou de congé quotidiennes. Ces utilisateurs sont des utilisateurs limités.

Le document Type d'utilisateur joue un rôle important pour gérer ce cas d'utilisation. Il existe des types d'utilisateurs par défaut, **utilisateur système** et **utilisateur du site Web**, l'utilisateur système peut accéder au bureau et au portail du site Web, tandis que l'utilisateur du site Web ne peut accéder qu'au portail du site Web. Pour gérer le cas d'accès limité aux documents pour les employés par défaut, Dokos a ajouté un nouveau type d'utilisateur

---

## 1. Type d'utilisateur

Pour accéder au document **Type d'utilisateur**, allez sur :

> Utilisateurs > **Type d'utilisateur**

![type\_d'utilisateur.png](https://doc.dokos.io/content/setup/user-permissions/type_dutilisateur.png)

**L'utilisateur du site Web** et l'**utilisateur du système** seront des types d'utilisateurs standard et ceux-ci ne peuvent être ni supprimés ni modifiés. Cependant, les types d'utilisateurs non standard (personnalisés) peuvent être supprimés, créés, modifiés. Par défaut, les droits de suppression ne sont accordés à aucun utilisateur.

## 2. Type d'utilisateur standard

### 2.1 Pour le type d'utilisateur non standard

L'utilisateur doit sélectionner le rôle personnalisé, le document sur lequel il souhaite appliquer l'autorisation de l'utilisateur et le nom de champ de l'utilisateur.

Dans l'image ci-dessus, l'employé a le champ de lien ID utilisateur qui est lié au document utilisateur. Étant donné que "Appliquer l'autorisation utilisateur sur" a été défini comme "Employé", l'utilisateur de l'employé concerné ne peut afficher que les documents dans lesquels le champ Employé respectif est lié. Par exemple, l'employé ne peut consulter que la fiche de salaire qui a été créée avec son identifiant d'employé.

![types\_de\_doc\_et\_autorisation.png](https://doc.dokos.io/content/setup/user-permissions/types_de_doc_et_autorisation.png)

#### 2.1.1 Types de documents

Les utilisateurs de type utilisateur non standard ne peuvent accéder qu'aux documents qui ont été mentionnés dans le type d'utilisateur.

Le tableau ci-dessus agit également en tant que gestionnaire des autorisations de rôle pour ce type d'utilisateur particulier (Employee Self Service dans notre cas). Employee Self Service en tant que rôle ne sera pas accessible dans le gestionnaire d'autorisations de rôle général.

![types\_de\_document.png](https://doc.dokos.io/content/setup/user-permissions/types_de_document.png)

#### 2.1.2 Types de documents (sélectionnez les autorisations uniquement)

Dans ce tableau, vous devez répertorier tous les doctypes auxquels vous voulez que l'utilisateur du libre-service employé ait un accès. Il n'y a pas de limite au nombre de doctypes que vous pouvez ajouter ici. Les utilisateurs ne seront pas en mesure de créer les enregistrements pour les documents auxquels ils ont accès à une autorisation de sélection.

![modules\_autorisés.png](https://doc.dokos.io/content/setup/user-permissions/modules_autorises.png)

## 3. Ajout d'un utilisateur non standard

Lors de l'ajout du nouvel utilisateur, l'utilisateur doit sélectionner le type d'utilisateur. Dans le cas d'un type d'utilisateur non standard, l'utilisateur concerné doit être lié au document qui a été défini dans le champ "Appliquer l'autorisation utilisateur sur".


# Référentiel

## 1. Pays

::tour{demo="Mappemonde" doctype="country"}
Voir la liste des pays dans la démo
::

Une liste de pays par défaut est disponible dans Dokos. Vous pouvez également ajouter un nouveau pays en y renseignant le format de date, le format d'heure ainsi que le fuseau horaire correspondant.

![Cette image permet de visualiser la liste des pays disponibles.](https://doc.dokos.io/liste-pays.png)

## 2. Devises

::tour{demo="Mappemonde" doctype="currency"}
Voir la liste des devises dans la démo
::

Une liste de devises est disponible par défaut dans Dokos. Vous avez également la possibilité de créer une devise personnalisée selon vos besoins.

![Cette image permet de visualiser le formulaire pour la devise €.](https://doc.dokos.io/devise-euro.png)

## 3.Langues

::tour{demo="Mappemonde" doctype="language"}
Voir la liste des Langues dans la démo
::

Une liste de langue est disponible, tout comme les pays et devises.

![Cette image permet de visualiser la liste des langues disponibles.](https://doc.dokos.io/langues.png)


# Impressions

## Gestion des impressions

::card-group
  :::card
  ---
  title: Formats d'impression
  to: https://doc.dokos.io/v5/dodock/fonctionnalites/impression/format-impression
  ---
  Création et personnalisation de vos formats d'impression
  :::

  :::card
  ---
  title: En-tête
  to: https://doc.dokos.io/v5/dodock/fonctionnalites/impression/en-tete
  ---
  Gestion des en-têtes et pieds de page
  :::

  :::card
  ---
  title: Page de couverture
  to: https://doc.dokos.io/v5/dodock/fonctionnalites/impression/format-impression#_35-page-de-couverture
  ---
  Pages de couverture
  :::

  :::card
  ---
  title: Style d'impression
  to: https://doc.dokos.io/v5/dodock/fonctionnalites/impression/style-impression
  ---
  Gestion du style de vos formats d'impression
  :::

  :::card
  ---
  title: Impression Réseau
  to: https://doc.dokos.io/v5/dodock/fonctionnalites/impression/format-impression#_23-serveur-dimpression
  ---
  Impressions via le réseau
  :::

  :::card
  ---
  title: Impression Brute
  to: https://doc.dokos.io/v5/dodock/fonctionnalites/impression/impression-brute
  ---
  Impressions brutes pour les imprimantes thermiques
  :::
::


# Formats d'impression

Vous pouvez utiliser les styles et paramètres d'impression pré-configurés ou personnaliser complètement vos formats d'impression directement depuis l'interface utilisateur.

## 1. Configurer un format d'impression

Afin de configurer vos formats d'impression, dokos vous fournit deux niveaux de paramétrage:

1. Paramètres d'impression
   Ces paramètres sont globaux et affectent tous les formats d'impression.
2. Format d'impression
   Chaque format d'impression a ses propres paramètres applicable seulement pour lui-même.

## 2. Paramètres d'impression

Afin de configurer vos paramètres d'impression, allez sur :

> Paramètres > **Format d'impression**.

### 2.1 Paramètres PDF

- **Envoyer les impressions en PDF**: Cela enverra tous les documents joints à un email au format PDF.
  Dans le cas contraire, toutes les impressions de documents seront envoyées au format HTML.
- **Répéter l'en-tête et le pied de page sur les PDF**: L'en-tête et le pied de page du PDF seront répétés sur toutes les pages.
  Dans le cas contraire, l'en-tête sera seulement ajouté sur la première page et le pied de page ne sera pas affiché.
- **Taille de la page en PDF**: Les tailles de pages officiellement supportées sont `A4` et `Lettre`.

::callout
Si besoin, vous pouvez personnaliser le champ de taille de la page en PDF pour ajouter d'autres options supportées par [wkhtmltopdf](https://github.com/wkhtmltopdf/wkhtmltopdf/blob/master/src/lib/pdfsettings.cc){rel=""nofollow""} (La librairie de génération de PDF).\:br
Ex. A0, A1,..., A5, A6,... Folio, Tabloid,...
::

### 2.2 Paramètres de la page

- **Imprimer avec un en-tête**: Active l'option `En-tête` de l'aperçu avant impression par défaut.
  Cette option peut être activée/désactivée dans chaque aperçu avant impression.
- **Impression des articles compacte**: Active un format d'impression plus compact pour les tableaux d'articles.
- **Autoriser les impression des documents en brouillon**: Autorise l'impression des documents en brouillon.
- **Envoyer un lien web vers le document dans les emails**: Si activé, ajoutera un lien pour voir une version HTML du document imprimé dans le navigateur du destinataire.
- **Toujours ajouter "Brouillon" pour l'impression des documents brouillons**: Ajoute le mot `BROUILLON` en haut des impressions de tous les documents en brouillon.
- **Autoriser les sauts de page dans les tableaux**: Si activé, les utilisateurs peuvent créer des sauts de page entre deux articles en cochant la case correspondante dans chaque ligne d'article.
- **Autoriser les impressions des documents annulés**: Autorise l'impression de documents annulés.
- **Impression des taxes avec un montant nul**: Imprimera les lignes de taxes avec une valeur égale à 0. Dans le cas contraire, elles ne seront pas imprimées.

### 2.3 Serveur d'impression

Vous pouvez configurer un serveur d'impression lié à dokos en ajoutant l'adresse IP du serveur et le port de connexion.
dokos récupérera toutes les imprimantes liées à cette adresse et vous pourrez sélectionner l'imprimante à utiliser afin de pouvoir imprimer des documents depuis le logiciel.

⚠️ **Vous devrez peut-être installer des librairies python additionnelles sur vos serveurs**

### 2.4 Style d'impression

Un style d'impression est une feuille CSS ajoutant du style à votre format d'impression. Vous pouvez utiliser le framework [Bootstrap 3.3](https://getbootstrap.com/docs/3.3/getting-started/){rel="&#x22;nofollow&#x22;"} avec ses classes et composants.

Vous pouvez choisir entre différents styles d'impression fournis par défaut avec dokos ou créer votre propre style d'impression.

Un style d'impression sera appliqué par défaut à tous les formats d'impression créés pour votre site dokos.
Ils peuvent être écrasés dans chaque format d'impression par du style CSS spécifique.

De ce fait, il est recommandé de créer un style de base qui sera appliqué à tous les formats d'impression de vos documents et de seulement ajouter du style spécifique pour chaque format d'impression si besoin.

Les formats d'impression standards ne peuvent pas être modifiés, car ils peuvent être mis à jour avec le logiciel dans le temps.
A la place, il est recommandé de copier le format d'impression standard que vous souhaitez modifier, de l'éditer et de le sélectionner dans vos paramètres d'impression.
Vous pouvez aussi désactiver les styles d'impression que vous ne souhaitez pas utiliser.

### 2.5 Polices

Vous pouvez choisir différentes polices fournies par défaut et ajuster la taille de police standard de vos formats d'impression.

## 3. Format d'impression

Il y a plusieurs types de formats d'impression:

1. **Standard**: Inclus avec le code de dokos et peuvent être mis à jour dans le temps. Ces formats d'impression peuvent être copiés pour être personnalisés.
2. **Non standard** et non **personnalisé**: Formats d'impression personnalisé modifié via l'**Editeur de format d'impression**.
3. **Non standard** et **personnalisé**: Formats d'impression personnalisés en [Jinja](https://jinja.palletsprojects.com/en/master/){rel="&#x22;nofollow&#x22;"} et générés sur le serveur ou dans le navigateur.

Un format d'impression peut être créé et modifié via deux canaux différents:

1. Allez à `Paramètres > Format d'impression` et cliquez sur nouveau ou sélectionnez le format à éditer.
2. Si votre format d'impression est **non standard** et n'est pas **personnalisé**, vous pouvez allez à `Paramètres > Editeur de format d'impression` et sélectionner votre format d'impression ou un document de référence pour en créer un nouveau.

### 3.1 Format d'impression standard

Les formats d'impression standards sont fournis avec le logiciel et peuvent être utilisés tels quels ou personnalisés.
Afin de les personnaliser, vous devez faire une copie (`Menu > Dupliquer`) et nommer votre copie différemment du format standard.

Chaque format d'impression est lié avec un module et un type de document de référence.
Vous avez accès à tous les champs de la référence et votre format d'impression sera uniquement proposé dans l'aperçu avant impression de ce type de document.

Lorsque vous dupliquez un format d'impression, assurez vous de conserver le même type de format: si `Format personnalisé` n'est pas coché, vous devez utiliser l'éditeur de format d'impression pour le personnaliser. Dans le cas contraire, vous créerez simplement un format d'impression complètement différent.

### 3.2 Formats d'impression spécifiques aux utilisateurs

#### 3.2.1 Format personnalisé

Un format d'impression personnalisé peut être de deux types:

- JINJA: Sera imprimé sur le serveur
- JS: Sera imprimé dans le navigateur

Vous pouvez construire votre format d'impression en HTML en utilisant le language [Jinja](https://jinja.palletsprojects.com/en/master/){rel="&#x22;nofollow&#x22;"} et ajouter du style en CSS en utilisant les classes et composants de [Bootstrap 3.3](https://getbootstrap.com/docs/3.3/getting-started/){rel="&#x22;nofollow&#x22;"}.

Si votre imprimante permet l'impression brute, vous pouvez lui envoyer des commandes spécifiques en cochant **Impression brute**.

### 3.3 Format généré via l'éditeur de format d'impression

Si vous préférez utiliser l'éditeur de format d'impression, vous pouvez définir quelques paramètres additionnels pour votre format d'impression:

- **Alignez les étiquettes à droite**: Alignera tous les libellés à droite. Si désactivé, tous les libellés seront alignés à gauche par défaut.
- **Afficher les titres de section**: Affichera le titre de chaque section dans le format d'impression. Chaque titre est personnalisable dans l'éditeur de format d'impression.
- **Afficher les sauts de Ligne après chaque section**: Ajoutera des sauts de lignes après chaque section.
- **Langue d'impression par défault**: Sera sélectionné par défaut lors de l'impression du document.
- **Police de caractère**: Ecrasera la police globale sélectionnée dans les paramètres d'impression.

Vous pouvez aussi ajouter du style en CSS pour écraser le style par défaut de votre format d'impression.

#### 3.3.1 Modifier le format

Vous pouvez ensuite cliquer sur `Modifier le format` pour commencer à éditer votre format d'impression.

L'éditeur de format d'impression vous donnera la possibilité d'ajouter des sections et colonnes ainsi que d'éditer la section titre de votre format d'impression.

#### 3.3.2 Sections et colonnes

Vous pouvez ajouter autant de sections que vous le souhaitez et jusqu'à 4 colonnes par section.
Cliquez simplement sur la roue en haut à droite de chaque section pour les configurer:

- **Nb de Colonnes**: Ajoutez jusqu'à 4 colonnes.
- **Titre de la section**: Editez le titre de la section. Il sera seulement affiché sur le paramètre est activé dans les propriétés du format d'impression (voir ci-dessus)
- **Saut de page**: Ajoutera un saut de page juste sous cette section.

Vous pouvez aussi supprimer une section en cliquant sur le bouton `supprimer`.

#### 3.3.3 Section titre

Vous pouvez aussi éditer la section titre affichée en haut de la première page de votre document.
Modifiez simplement le libellé ou personnalisés la section complètement si vous êtes à l'aise en HTML et/ou Jinja.

#### 3.3.3 Champs

Une fois que votre structure de document est prête, glissez/déposez simplement des champs dans chaque colonne pour les afficher sur votre format d'impression.
Si le champ n'a pas de valeur, il ne sera pas affiché.

Par défaut, vous pouvez ajouter tous les champs disponibles dans le document de référence.
Si vous souhaitez récupérer la valeur d'un champ disponible dans un document lié avec votre document de référence, vous pouvez ajouter un champ `HTML personnalisé` et utiliser du code Jinja.

Ex. Vous voulez afficher le compte bancaire par défaut d'un client dans sa facture:

```text
{% set bank_account = frappe.db.get_value("Customer", doc.customer, "default_bank_account") %}
<div class="row">
    <div class="col-md-3 text-right">{{ _("Bank Account") }}</div>
    <div class="col-md-9">{{ bank_account or '' }}</div>
</div>
```

#### 3.3.5 Traductions

Si vous ajoutez des libellés traductibles dans votre code, n'oubliez pas d'ajouter également des traductions pour toutes les langues que vous envisagez d'utiliser dans le type de document `Traduction`.

### 3.4 Formats d'impression multiples

Si vous avez plusieurs formats d'impression pour un document, cliquez sur `Format par défaut pour ce type de document` pour définir le plus utilisé comme étant le format par défaut pour ce document.

### 3.5 Page de couverture

::tour{demo="Mappemonde" doctype="cover-page"}
Créer une page de couverture dans la démo
::

Une page de couverture est une page qui est ajoutée avant l'impression de votre PDF.
Il ne peut s'agir que d'un document en PDF qui sera ensuite concaténé avec le document généré par Dokos.

Créez une nouvelle page de couverture via le type de document "Page de couverture", puis sélectionnez la dans vos formats d'impression.

### 3.6 Cas d'usage

#### 3.6.1 Ajouter un titre au dessus des lignes d'articles dans les transactions d'achat/vente

Pour ajouter un titre au dessus d'une ligne dans une transaction, il suffit d'ajouter un champ personnalisé:

👉 Allez dans le menu "Personnaliser un formulaire".
👉 Cherchez le type de document correspondant à votre tableau d'articles, par exemple "Article de la facture de vente".
👉 Ajoutez un champ dans ce document, mettez "Title" ou "Print Title" dans le libellé et cochez les cases **Autoriser les modifications après validation** et **Masquer à l'impression**.
\:thumbsup: Cliquez sur "Mettre à jour"

Vous pouvez désormais mettre un titre qui apparaîtra juste au dessus de la ligne d'articles concernée.

#### 3.6.2 Ajouter un titre au dessus du tableau des articles

Pour ajouter un titre ou un champ de texte libre au dessus du tableau des articles, il suffit d'ajouter un champ personnalisé:

👉 Allez dans le menu "Personnaliser un formulaire".
👉 Cherchez le type de document pour lequel vous souhaitez ajouter ce champ.
👉 Choisissez le type de champ qui vous convient le mieux et donnez lui un libellé.
\:thumbsup: Cliquez sur "Mettre à jour"

Ensuite allez dans votre format d'impression et ajoutez ce champ juste au dessus du tableau des articles. Il apparaîtra désormais sur vos impressions de document.


# En-tête de lettre

Chaque entreprise a un en-tête par défaut. Ces valeurs d'en-tête sont généralement définies comme en-tête et pied de page dans les documents. Dans DOKOS, vous pouvez capturer ces détails dans le masque d'en-tête.

Ces détails apparaîtront dans le format d'impression des transactions comme le bon de commande, la facture de vente, le bulletin de salaire, le bon de commande, etc. Dans DOKOS, l'en-tête de lettre sert uniquement à configurer la partie supérieure du document, les autres contenus sont préformatés et peut être configuré via le format d' impression et les en- têtes d'impression .

Pour accéder à l'**en-tête**, allez sur :

> Accueil > Paramètres > **En-tête**

![en-tête\_document.png](https://doc.dokos.io/content/setup/print/en-tete_document.png)

## 1. Comment créer un en-tête de lettre

1. Allez dans la liste des en-têtes, cliquez sur Nouveau.
2. Entrez un nom pour l'en-tête. Vous pouvez créer un en-tête de lettre distinct pour différents bureaux.
3. Choisissez s'il est basé sur une image ou sur HTML.
4. Vous pouvez saisir des détails dans un en-tête en utilisant :

- **Image du logo** : cliquez sur le bouton Joindre pour joindre une image. Une fois l'image insérée, le code HTML correspondant sera généré automatiquement.
- Autres informations (comme l'adresse, le numéro d'identification fiscale, etc.) que vous souhaitez mettre sur votre en-tête.

![création\_en-tête\_image.png](https://doc.dokos.io/content/setup/print/creation_en-tete_image.png)

Si vous souhaitez en faire l'en-tête par défaut, cliquez sur **En-tête par défaut**.

5. Après avoir saisi les valeurs dans la section En-tête et pied de page, enregistrez l'en-tête.

Vous pouvez définir l'en-tête basé sur HTML pour y apporter des modifications :

![création\_en-tête\_html.png](https://doc.dokos.io/content/setup/print/creation_en-tete_html.png)


# Paramètres d'impression

**Dans les paramètres d'impression, vous pouvez définir vos préférences d'impression telles que la taille du papier, la taille du texte par défaut et si vous souhaitez imprimer au format PDF ou HTML, etc.**

Comme DOKOS est une application basée sur un navigateur, la commande d'impression réelle est exécutée par le navigateur que vous utilisez.

---

Pour modifier les **paramètres d'impression**, allez sur :

> Accueil > Paramètres > **Paramètres d'impression**

Il existe différentes configurations disponibles dans les paramètres d'impression. Apprenons à leur sujet.

## 1. Paramètres PDF

### 1.1 PDF ou HTML

Lorsque vous envoyez un document par e-mail (comme une commande client / une facture) à partir de DOKOS, il est envoyé au format PDF ou HTML. Le fichier est envoyé au format PDF par défaut. Si vous souhaitez envoyer un document au format HTML, il vous suffit de décocher l'option **Envoyer Imprimer en PDF**.

### 1.2 Répéter l'en-tête et le pied de page en PDF

L'en-tête est un modèle dans lequel vous pouvez définir l'en-tête et le pied de page standard qui sont ajoutés au format d'impression du document. Si cette propriété est activée, l'en-tête et le pied de page sont ajoutés à chaque page. Si vous ne voulez pas que l'en-tête et le pied de page se répètent sur chaque page, désactivez simplement ce paramètre.

### 1.3 Taille de la page PDF

Le format par défaut pour l'impression des pages PDF est A4, vous pouvez le changer en format de papier à Lettre.

## 2. Paramètres de la page

### 2.1 Imprimer avec du papier à en-tête

L'activation de cette propriété cochera automatiquement l'option En-tête lors de l'impression d'un document. Notez que vous devez définir l'En-tête par défaut ou en sélectionner un dans la transaction pour qu'il apparaisse dans la vue d'impression.

### 2.2 Impression d'articles compacts

Les transactions telles que les commandes / factures ont un tableau détaillant les articles achetés ou vendus. Il comporte plusieurs colonnes telles que Nom de l'élément, Description, Montant du taux, etc. S'il y a plusieurs colonnes dans la table Elément, alors le format d'impression semble un peu encombré. Vous pouvez améliorer la vue du tableau en activant l'impression compacte d'élément.

Selon ce paramètre, il n'y aura que quatre colonnes dans le format d'impression, à savoir: Description, Qté, Taux et Montant.

Les valeurs des autres colonnes (comme le nom, la description, l'image, les numéros de série, etc.) sont concaténées dans la colonne Description.

### 2.3 Autoriser l'impression pour le brouillon

Les documents (principalement des transactions) comportent deux étapes d'authentification, Enregistrer et Soumettre. Les documents enregistrés sont le premier brouillon et ne sont pas soumis au système. L'impression est donc limitée pour les documents à ce stade. Toutefois, si vous souhaitez autoriser également les utilisateurs à imprimer des documents au stade Brouillon, cochez cette case.

### 2.4 Toujours ajouter l'en-tête "Brouillon" pour l'impression des brouillons de documents

L'activation de ce paramètre imprime également "Brouillon" au format d'impression, indiquant ainsi que le document partagé n'est pas encore complètement authentifié.

### 2.5 Autoriser le saut de page à l'intérieur du tableau

Si la description d'un élément capture plus que l'espace habituel d'une page, l'activation de ce paramètre divisera les détails de l'élément sur la page suivante. Par conséquent, un saut de page sera inséré entre la description de l'élément et le reste des détails sera poussé à la page suivante.

### 2.6 Autoriser l'impression pour annulé

Les transactions annulées sont celles qui n'ont aucun impact sur les rapports. Si vous souhaitez autoriser l'impression des transactions annulées, activez ce paramètre. Une transaction ne peut être annulée qu'une fois soumise.

### 2.7 Imprimer les taxes avec un montant nul

Dans les transactions de vente et d'achat, vous pouvez ajouter appliquer plusieurs taxes sur l'article. Par défaut, dans le format d'impression, seules les taxes dont le montant est calculé sont visibles. Si vous souhaitez également imprimer la taxe qui n'a pas été appliquée et dont le montant de taxe est nul, activez ce paramètre.

## 3. Serveur d'impression

Vous pouvez activer le serveur d'impression en renseignant l'adresse IP et le port du serveur d'impression. Ensuite, choisissez l'imprimante par défaut.

## 4. Impression brute

Vous pouvez activer l'impression brute et imprimer sur de nombreuses imprimantes thermiques prises en charge. Lisez Raw Printing pour en savoir plus.

## 5. Style d'impression

Choisissez le style d'impression de vos documents. Par défaut, le syle Modern est sélectionné.

Vous pouvez aussi créer votre propre modèle d'impression en cliquant sur Style d'impression > **Ajouter un nouveau style d'impression**

### 5.1 Création d'un nouveau style d'impression

1. Indiquez le **nom** du style d'impression
2. **Désactivé**, si la case est cochée alors le modèle d'impression sera désactivé.
3. **Standard**, si la case est cochée alors le modèle d'impression sera utilisé comme modèle par défaut pour les impressions de vos documents.
4. **CSS** : Insérez ici le format de votre modèle d'impression au format CSS
5. **Enregistrer**

## 6. Polices du texte

- Type de police de caractère
- Taille de la police (en point)


# Style d'impression

Dans Style d'impression, vous pouvez définir des styles CSS personnalisés appliqués aux formats d'impression.

DOKOS est livré avec des styles prédéfinis pour l'impression de documents. Vous pouvez également créer de nouveaux styles à l'aide de CSS qui peuvent être appliqués à tous vos formats d'impression.

Les styles d'impression standard de DOKOS sont: Monochrome, Moderne et Classique.

---

Pour créer un **nouveau style d'impression**, allez sur :

Accueil > Paramètres > **Style d'impression**

![liste\_style\_d'impression.png](https://doc.dokos.io/content/setup/print/liste_style_dimpression.png)

## 1. Comment créer un nouveau style d'impression

1. Allez dans la **liste Style d'impression*&#x2A;, cliquez sur **➕ Nouveau Style d'impression**.
2. Entrez un **nom** pour le style d'impression.
3. Entrez le **CSS** qui définira à quoi ressemblera le style.
4. **Enregistrer**.

![créeer\_nouveau\_style\_impression.png](https://doc.dokos.io/content/setup/print/creeer_nouveau_style_impression.png)

Les styles que vous créez ici s'appliquent aux formats d'impression standard et personnalisés. Pour connaître les différentes classes CSS disponibles, vous pouvez créer un format d'impression standard, ouvrir dans une nouvelle page et voir la source.

Un style d'impression par défaut peut être défini dans les &#x2A;*paramètres d'impression.**

Tous les styles de format d'impression sont basés sur le framework CSS Bootstrap (version 3).


# Impression Brute

**L'envoi d'une chaîne de commandes à une imprimante directement dans sa langue maternelle s'appelle l'impression brute.**

De nombreuses imprimantes thermiques ont besoin de ces commandes brutes pour exécuter des fonctions telles que l'impression de codes-barres, l'impression de reçus, l'impression d'étiquettes, etc. L'impression brute contourne les pilotes de l'imprimante dans la plupart des cas, ce qui les rend très rapides et fiables. L'impression brute est également capable d'exécuter certaines fonctions avancées telles que la découpe du papier des reçus, l'éjection des tiroirs-caisses, etc.

## Installation

Suivre le guide d'ERPNext.

> <https://docs.erpnext.com/docs/user/manual/en/raw-printing>{rel="&#x22;nofollow&#x22;"}

1. Installer QZ Tray — <https://qz.io/download/>{rel="&#x22;nofollow&#x22;"}
2. Tester que QZ Tray fonctionne — <https://demo.qz.io/>{rel="&#x22;nofollow&#x22;"}
3. (Linux : Éventuellement réinstaller QZ Tray en installant certutils d'abord)
4. Activer l'impression brute dans les Paramètres d'Impression
5. Créer un format d'impression — <https://labelary.com/viewer.html>{rel="&#x22;nofollow&#x22;"}

![Bouton d'accès aux formats d'impression](https://doc.dokos.io/content/dodock/format-impression-brute.png)

6. Imprimer un document en utilisant le format d'impression correspondant
7. Sélectionner l'imprimante à utiliser

![Bouton d'accès aux paramètres d'impression brute](https://doc.dokos.io/content/dodock/format-impression-brute.png)![Table d'impression brute](https://doc.dokos.io/content/dodock/correspondance-impression-brute.png)

Développement : tester en créant une imprimante virtuelle

Si la commande lpadmin n'est pas installée, installer CUPS (guide en français).

`sudo lpadmin -p tofile -E -v socket://localhost:7777 -m raw`

```perl
#!/usr/bin/perl
use IO::Socket::INET;
$myport=7777;
$pserve=IO::Socket::INET->new(LocalPort => $myport,Type=>SOCK_STREAM,Reuse=>1,Listen=>1) or die "can't do that $!\n";
while ($pjob=$pserve->accept()) {
  open(J,">>/private/tmp/x") or print "having issues $!\n";
  print J "New job...\n";
  print STDOUT "New job...\n";
  while (<$pjob>) {
    print J "$_";
    print STDOUT "$_";
  }
  close J;
  close $pjob;
}
```

Source : <https://aplawrence.com/MacOSX/macosxcupstofile.html>{rel="&#x22;nofollow&#x22;"}

> Pour aller plus loin
>
> <https://qz.io/docs/setting-up-a-raw-printer-in-ubuntu-linux>{rel="&#x22;nofollow&#x22;"}
>
> <https://qz.io/docs/signing>{rel="&#x22;nofollow&#x22;"}
>
> <https://askubuntu.com/questions/1051602/virtual-printer>{rel="&#x22;nofollow&#x22;"}
>
> Impression client-side via adresse IP — <https://discuss.frappe.io/t/tutorial-printing-directly-to-zebra-label-printer-from-any-local-device/98802>{rel="&#x22;nofollow&#x22;"}


# Intégrations

## Options d'intégrations avec des systèmes externes

::card-group
  :::card
  ---
  title: OAuth
  to: https://doc.dokos.io/v5/dodock/fonctionnalites/integrations/oauth
  ---
  :::

  :::card
  ---
  title: Connecteurs sociaux
  to: https://doc.dokos.io/v5/dodock/fonctionnalites/integrations/connecteurs-sociaux
  ---
  Connecteurs sociaux
  :::

  :::card
  ---
  title: LDAP
  to: https://doc.dokos.io/v5/dodock/fonctionnalites/integrations/ldap
  ---
  :::

  :::card
  ---
  title: Demandes d'intégration
  to: https://doc.dokos.io/v5/dodock/fonctionnalites/integrations/demandes-integrations
  ---
  Réceptions de webhooks
  :::

  :::card
  ---
  title: Google
  to: https://doc.dokos.io/v5/dodock/fonctionnalites/integrations/google
  ---
  Connecteurs avec les services Google
  :::

  :::card
  ---
  title: S3
  to: https://doc.dokos.io/v5/dodock/fonctionnalites/integrations/s3
  ---
  Connecteur avec les services compatibles S3
  :::

  :::card{title="Dropbox" to="https://doc.dokos.io/v5/dokos/integrations/dropbox"}
  Connecteur avec Dropbox
  :::
::


# Oauth

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
🚧 Rédaction en cours 🚧
::


# Connecteurs Sociaux

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
🚧 Rédaction en cours 🚧
::


# Ldap

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
🚧 Rédaction en cours 🚧
::


# Demandes Integrations

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
🚧 Rédaction en cours 🚧
::


# Google

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
🚧 Rédaction en cours 🚧
::


# S3

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
🚧 Rédaction en cours 🚧
::


# Dropbox

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
🚧 Rédaction en cours 🚧
::


# Webhooks

Les Webhooks sont des "rappels HTTP définis par l'utilisateur". Pour un DocType sélectionné, vous pouvez créer un webhook qui se déclenche sur des événements de document spécifiques sous certaines conditions, si nécessaire.

Lorsque doc\_eventse se produit, le site source envoie une requête HTTP à l'URL configuré pour le webhook. Les utilisateurs peuvent configurer ces webhooks pour utiliser des événements sur un site pour invoquer un comportement sur un autre.

---

Pour accéder à la liste des **Webhook**, aller sur :

> Accueil > Intégrations > Paramètres > Webhook

![liste\_webhook.png](https://doc.dokos.io/content/integrations/webhook/liste_webhook.png)

## 1. Comment configurer un Webhook ?

1. Sélectionnez le **Type de document** pour lequel le Webhook doit être déclenché (par exemple Devis client).
2. Sélectionnez l'événement Doc qui déclenchera le Webhook (par exemple on\_update).

![événement\_doc.png](https://doc.dokos.io/content/integrations/webhook/evenement_doc.png)

### 1.1 Déclencheur du webhook

3. En option, vous pouvez définir des conditions de document supplémentaires pour déclencher des Webhooks pour des scénarios spécifiques.

![déclencheur\_du\_webhook.png](https://doc.dokos.io/content/integration/webhook/de%CC%81clencheur_du_webhook.png)

### 1.2 Requête Webhook

4. Saisissez une URL de requête valide qui recevra les données du Webhook.
5. Sélectionnez la méthode de demande. POSTest la méthode par défaut.

![requête\_webhook.png](https://doc.dokos.io/content/integrations/webhook/requete_webhook.png)

### 1.3 Sécurité des webhooks

Pour éventuellement ajouter de la sécurité à vos demandes de webhook et vous assurer que le webhook est envoyé depuis Dokos, vous pouvez configurer un **Webhook Secret** avec la demande. Ne partagez pas le secret publiquement.

![sécurité\_webhook.png](https://doc.dokos.io/content/integrations/webhook/securite_webhook.png)

### 1.4 En-Têtes Webhook

6. Vous pouvez éventuellement ajouter des en-têtes HTTP à la requête. (par exemple utile pour envoyer une clé API, si nécessaire).

Vous pouvez également désactiver un webhook en décochant la Enabledcase. Seuls les webhooks activés sont déclenchés.

![en\_tête\_webhook.png](https://doc.dokos.io/content/integrations/webhook/en_tete_webhook.png)

### 1.5 Données du Webhook

Si la structure de votre demande est basée sur des formulaires, vous pouvez sélectionner des champs dans le document du tableau, qui utilise le nom du champ comme fichier key.
Si la structure de votre demande est basée sur JSON, vous pouvez insérer des champs du document à l'aide de modèles jinja (assurez-vous d'envelopper vos champs avec des guillemets doubles).

![données\_webhook.png](https://doc.dokos.io/content/integrations/webhook/donnees_webhook.png)

### 1.6 Journal des demandes de webhook

Un journal de demande de webhook est créé pour chaque demande réussie avec tous les détails pertinents


# Notifications

## 1. Généralités

![Cette image permet de visualiser la zone des notifications.](https://doc.dokos.io/notifications-bureau.png)

La cloche devient rouge avec un point pour indiquer à l'utilisateur qu'il a une notification. Une fois la notification consultée, celle-ci reste accessible dans l'historique.

## 2. Paramètres des notifications

::tour{demo="Mappemonde" doctype="notification-settings"}
Consultez les paramètres des notifications dans la démo
::

Cette section permet de configurer de manière précise les modalités de réception des notifications, que ce soit par e-mail ou via le système interne. Vous pouvez personnaliser ces notifications en fonction des événements spécifiques, tels que les assignations, mentions ou rappels, pour mieux suivre vos actions et événements importants.

## 3. Créer une notification

::tour{demo="Mappemonde" doctype="notification"}
Créer une notification dans la démo
::

![Cette image permet de visualiser le formulaire de création d'une notification.](https://doc.dokos.io/formulaire-notification.png)

1. Indiquez le nom du document
2. Sélectionnez le type de canal : Email, Outils collaboratifs (Slack, RocketChat,etc) Notification système ou SMS)
3. Envoyer une alerte lors de l'événement

![Cette image permet de visualiser le détail pour remplir le formulaire.](https://doc.dokos.io/evenement-declencheur.png)

4. Sélectionnez le type de document sur lequel vous souhaitez observer les modifications.

**Les événements sont** :

- Nouveau : déclenchement lorsqu'un nouveau document du type sélectionné est créé.
- Enregistrer/Valider/Annuler : déclenchement lors de l'enregistrement, la soumission ou l'annulation d'un document du type sélectionné.
- Jours avant/Jours après : alerte générée un certain nombre de jours avant ou après la date de référence, utile pour rappeler des échéances ou des suivis.
- Changement de valeur : déclenchement lors d'une modification spécifique dans le type sélectionné.
- Méthode : notification envoyée lors de l'activation d'une méthode particulière (ex. : before\_insert).
- Personnalisé : notification envoyée à une adresse e-mail définie.

5. Conditions

- Définissez des conditions supplémentaires si nécessaire.
- Définissez les destinataires de cette alerte. Le destinataire peut être soit un champ du document, soit une liste d'adresses e-mail fixes.

6. Destinataires

![Cette image permet de visualiser la zone destinaires dans le formulaire.](https://doc.dokos.io/destinataire.png)

7. Message

Définissez un message.

- Personnalisation :
  Utilisez des balises HTML et Jinja pour personnaliser le contenu dynamique. Par exemple, afficher les détails de la transaction ou des commentaires spécifiques associés au document.

## 4. Canal d'envoi

### 4.1. Notifications des outils collaboratifs

Si vous préférez que vos notifications soient envoyées vers un canal externe dédié, vous pouvez opter pour l'option "Canal externe" et configurer l'URL Webhook correspondante.

### 4.2. Notifications système

Les notifications système sont utiles pour suivre les tâches à faire, les mentions, les documents partagés, et les points d’énergie. Elles apparaissent dans le menu déroulant des notifications en haut à droite de la barre de navigation.

Si ce canal est sélectionné, une notification système sera envoyée à la place d'un e-mail ou d'une autre notification externe.

### 4.3. . SMS

Pour utiliser ce canal, vous devez terminer la configuration des paramètres SMS.

## 5. Test

![Cette image permet de visualiser l'option pour tester la notification.](https://doc.dokos.io/tester-notifications.png)

Une fois la configuration de votre notification terminée, vous avez la possibilité de tester son bon fonctionnement.


# Nommage des Documents

Dans Dokos, chaque document peut être associé à une règle de nommage, déterminant comment il sera identifié. L'identifiant du document est enregistré dans le champ `name`, accessible dans les filtres et rapports via les libellés **Nom** ou parfois **ID**.

Les règles de nommage sont définies lors de la création du type de document et peuvent être personnalisées pour chaque site en fonction des besoins de l'organisation.

## Règles de Nommage Disponibles

- **Défini par l'utilisateur :** À la création du document, une fenêtre contextuelle invite l'utilisateur à nommer le document.
- **Par Nom de Champ :** Vous pouvez indiquer un champ à l'intérieur du document. Sa valeur sera utilisée pour nommer le document.
- **Champ "Nom de Série" :** En ajoutant un champ `naming_series` dans le document, vous définissez un préfixe de série pour le nom du document.
- **Expression :** Similaire au "Nom de Série", cette option ne propose cependant pas de choix aux utilisateurs.
- **Aléatoire :** Le document est identifié par une chaîne de caractères aléatoire.
- **Par Script :** Ajoutez une méthode `autoname` dans votre contrôleur Python ou utilisez un script Python pour nommer le document.

## Modification d'une Règle de Nommage Standard

Pour ajuster une règle de nommage, accédez à **Personnaliser un Formulaire** et rendez-vous dans la section *Nom*. Chaque règle de nommage modifie la valeur du champ `Nom Auto`, utilisée lors de la création du document pour le nommer.

## Gestion des Masques de Numérotation

Pour ajuster les masques de numérotation pour différents documents, accédez à la section **Paramètres** > **Paramètres de Nommage des Documents**.

Les documents disponibles ici sont ceux qui comportent un champ nommé `naming_series`.

::callout{color="teal" icon="i-heroicons-light-bulb"}
Si vous souhaitez appliquer un masque de numérotation à un document existant, suivez ces étapes :

1. Personnalisez le document en ajoutant un champ (qui peut être masqué) nommé `naming_series`.
2. Choisissez ensuite la règle de nommage **Champ "Nom de Série"**.
::

### Modification d'un Masque de Numérotation

1. Choisissez le type de document (transaction) pour lequel vous voulez ajuster les masques.
2. Vous verrez la liste des masques disponibles pour ce type de document.
3. Modifiez ou ajoutez des masques dans le champ **Liste des Masques pour ce Document**.
4. Une fois vos masques configurés, sauvegardez les modifications en cliquant sur **Mettre à Jour**.

Un outil de test de masque de numérotation ainsi qu'une documentation détaillée sur les variables disponibles sont disponibles sur la droite de la page.

### Mise à Jour du Compteur lié à un Masque

Si vous avez besoin de reprendre le compteur associé à un masque de numérotation (par exemple après l'import de données d'un autre système), suivez ces étapes pour mettre à jour la valeur du compteur pour que la prochaine transaction utilise le nombre suivant.

Exemple : Vous souhaitez que la prochaine facture porte le numéro FACT-2599, et le dernier numéro utilisé était 2598.

1. Choisissez le préfixe/masque concerné.
2. Entrez la valeur actuelle du compteur.
3. Cliquez sur **Mettre à Jour** pour actualiser votre masque.

## Les règles de nommage des documents

Les règles de nommage de document dans Dodock constituent un outil puissant qui vous permet de standardiser et d'automatiser la dénomination de vos fichiers en fonction de conditions spécifiques. Cette fonctionnalité vous permet de gagner du temps tout en maintenant une cohérence dans la manière dont vos documents sont nommés et classés.

### Vue d'ensemble

Les règles de nommage de document vous offrent la possibilité de créer des modèles de dénomination prédéfinis pour différents types de documents. Chaque règle de nommage se compose d'un masque de numérotation et d'un compteur associé. Lorsqu'un document est créé ou importé dans Dodock, le système applique la règle de nommage appropriée en fonction des conditions que vous avez définies et de la priorité accordée à chaque règle.

### Création de Règles de Nommage

1. Accéder à la gestion des règles de Nommage
   Vous trouverez les règles de nommages dans les Paramètres ou en cherchant *Règle de nommage des documents* dans la barre de recherche
2. Configuration du masque de numérotation
   Chaque règle de nommage doit être configurée avec un masque de numérotation. Ce masque définit la structure du nom du fichier en incluant des variables dynamiques. Par exemple, si vous voulez nommer vos factures avec le format "FACTURE-001", le masque serait "FACTURE-{NUMERO}".
3. Définition des conditions
   Vous pouvez spécifier des conditions qui déterminent quand cette règle de nommage spécifique doit être appliquée. Par exemple, vous pourriez choisir que la règle s'applique uniquement aux factures d'avoir.
4. Attribution de priorité
   Si plusieurs règles de nommage s'appliquent aux mêmes documents, vous pouvez définir une priorité pour chacune d'entre elles. La règle avec la priorité la plus élevée sera appliquée.
5. Gestion des compteurs
   Chaque règle de nommage dispose de son propre compteur. Vous pouvez mettre à jour ce compteur manuellement, ce qui est particulièrement utile si vous devez revenir en arrière et créer un nouveau document avec un numéro précédent.


# Flux de travail

::callout{color="teal" icon="i-heroicons-light-bulb"}
Les flux de travail sont aussi communément appelés par leur terme anglais: Workflows
::

Avec les flux de travail, vous pouvez réécrire comment un processus / flux de travail est approuvé dans Dokos.

Vous pouvez définir plusieurs niveaux d'approbation pour un flux de travail dans Dokos. Pour permettre à plusieurs personnes de soumettre plusieurs demandes, pour des approbations par plusieurs utilisateurs, Dokos vous demande de remplir les conditions du flux de travail. Dokos suit les multiples autorisations avant la soumission.

Un exemple de Flux de travail de demande de congé est donné ci-dessous :

Ceci est un exemple d'approbation à deux niveaux avec annulation. Si un utilisateur demande un congé, sa demande sera envoyée au service des ressources humaines. Le service des ressources humaines (utilisateur des ressources humaines) rejettera ou approuvera cette demande. En conséquence, l'utilisateur obtiendra son statut Approuvé ou Rejeté.

---

Pour accéder à **la liste de flux de travail** et des **règles de transition**, allez sur :

> Accueil > Paramètres > **Flux de travail**

Une fois qu'un flux de travail est créé, vous pouvez effectuer des actions sur celui-ci via les actions de flux de travail.

![liste\_flux\_de\_travail.png](https://doc.dokos.io/content/setup/workflows/liste_flux_de_travail.png)

## 1. Prérequis avant utilisation

Avant de créer un Flux de travail, il est conseillé de les créer d'abord:

- États de flux de travail tels que Approuvé, Annulé, etc.

## 2. Comment créer un flux de travail

### 2.1 Ajouter un nouveau flux de travail

1. Accédez à la liste de Flux de travail, cliquez sur **➕ Ajouter Flux de travail**.
2. Entrez un **nom** pour le Flux de travail et sélectionnez le Document Type sur lequel appliquer.
3. Entrez les différents états du Flux de travail. Entrez le statut du document pour eux, sélectionnez le champ à mettre à jour dans la colonne Champ de mise à jour, entrez la valeur à mettre à jour sous Mettre à jour la valeur.

![créer\_un\_flux\_de\_travail.png](https://doc.dokos.io/content/setup/workflows/creer_un_flux_de_travail.png)

Les états du Flux de travail peuvent avoir des couleurs différentes selon l'état. Par exemple: vert pour le succès.

Les différents États de document :

- En attente = 0
- Approuvé = 1
- Annulé = 2
- Rejeté = 0.

Par exemple, un employé demande une demande de congé pour une période. Le document sera enregistré.

![etat\_flux\_de\_travail.png](https://doc.dokos.io/content/setup/workflows/etat_flux_de_travail.png)

Le champ que vous sélectionnez sous Champ de mise à jour sera mis à jour pour le type de document lorsque l'état change. La valeur de mise à jour est le texte qui apparaît sur le champ sélectionné dans le champ de mise à jour. Donc, ici, le champ d'état est mis à jour en Appliqué, Approuvé, etc.

4. Entrez les règles de transition.

Indiquez les actions qu'un approbateur peut entreprendre sur la demande de congé. L'état suivant est l'état dans lequel se trouve le type de document lorsque l'action est appliquée. Donc, ici, l'état passe de Appliqué à Approuvé par HR lorsque l'action Approuver est exécutée sur celui-ci.

![règle\_de\_transition\_flux\_de\_travail.png](https://doc.dokos.io/content/setup/workflows/regle_de_transition_flux_de_travail.png)

5. Sous Champ d'état du flux de travail, entrez un nom pour le champ personnalisé qui sera ajouté au document type, quittez l'application dans ce cas.
6. Lors de l'enregistrement, le champ personnalisé sera créé dans le document type.

### 2.2 Points à noter lors de la création d'un Flux de travail

- La création d'un flux de travail dans Dokos remplace essentiellement le flux de travail normal Enregistrer et soumettre. Ainsi, le document fonctionnera en fonction de votre flux de travail et non en fonction du flux de travail de code prédéfini. Par conséquent, il se peut qu'il n'y ait pas de bouton / option Soumettre si vous ne l'avez pas spécifié dans le flux de travail que vous créez.
- Si vous n'appliquez pas de flux de travail à un document et que ce document peut être soumis, alors il a le flux de travail par défaut avec les états: Brouillon - Soumis - Annulé. Si vous appliquez un flux de travail à un document à soumettre, ces états par défaut doivent être gérés par l'utilisateur.
- Un document ne peut être annulé que s'il est soumis.
- Si vous souhaitez donner la possibilité d'annuler, vous devrez écrire une étape de transition de flux de travail indiquant que vous pouvez annuler à partir de la soumission.
- Si les champs de la colonne Mettre à jour le champ ne sont pas mis à jour, un nouveau champ personnalisé sera créé avec le nom que vous avez défini dans le champ **Champ d'état du flux de travail**.

### 2.3 Autres options pour un flux de travail

- **Est actif** : en cochant cette case, tous les autres flux de travail pour le DocType sélectionné deviennent inactifs.
- **Ne pas remplacer le statut** : le statut de ce flux de travail ne remplacera pas le statut du document (Quitter l'application) dans la vue de liste.
- **Envoyer des alertes par e-mail** : des e-mails seront envoyés à l'utilisateur avec les prochaines actions de workflow possibles.

## 3. Caractéristiques

### 3.1 Activer / Désactiver l'état facultatif du flux de travail

Dans les États, l'état de flux de travail facultatif signifie que l'état peut ne pas faire partie de l'approbation finale.

Par exemple, des états comme Annulé ou Rejeté peuvent être facultatifs.

> Remarque : les actions de workflow ne sont pas créées pour les états facultatifs.

### 3.2 Conditions

Vous pouvez également ajouter une condition pour que la transition soit applicable. Par exemple, dans ce cas, si quelqu'un demande un congé de plus de 5 jours, un rôle particulier doit approuver. Pour que cela se produise dans la transition particulière, vous pouvez définir une propriété pour Condition sous Approuvé par les RH comme :

```text
doc.total_leave_days <= 5
```

Ensuite, si quelqu'un a demandé un congé de moins de 5 jours, seule cette transition particulière s'appliquera. Voici total\_leave\_daysle nom de champ du champ «Nombre total de jours de congé» de demande de congé. Pour voir le nom de champ d'un champ, allez dans Menu> Personnaliser.

Sur Dokos vous pouvez utiliser date / heure, session, obtenir une valeur et obtenir des fonctions de liste dans vos expressions de condition.

**Fonctions autorisées :**

- frappe.db.get\_value
- frappe.db.get\_list
- frappe.session
- frappe.utils.now\_datetime
- frappe.utils.get\_datetime
- frappe.utils.add à ce jour
- frappe.utils.now

Exemples:

Cela peut être étendu à n'importe quelle propriété du document.

```text
doc.creation > frappe.utils.add_to_date(frappe.utils.now_datetime(), days=-5, as_string=True, as_datetime=True)
```

## 4. Exemple de processus de demande de congé

Lorsqu'une demande de congé est enregistrée par l'employé, le statut du document passe à **Appliqué**.

Lorsque l'utilisateur RH se connecte, il peut approuver ou rejeter. S'il est approuvé, le statut du document passe à **Approuvé**


# Personnalisation des documents

## 1. Personnaliser un formulaire

- Quels sont les avantages ?

1. **Adaptation à votre entreprise** : Permet d'adapter les formulaires aux besoins spécifiques de votre entreprise.
2. **Efficacité améliorée** : Facilite l'entrée de données en affichant uniquement les champs pertinents.
3. **Gestion des données précise** : Collecte des informations pertinentes sans surcharge de données inutiles.
4. **Amélioration de l'expérience utilisateur** : Interface utilisateur simplifiée et personnalisée, améliorant ainsi l'expérience des utilisateurs.

- Comment personnaliser un formulaire ?

![Cette image permet de visualiser la zone pour personnaliser d'un formulaire.](https://doc.dokos.io/personnaliserformulaire.png)

**Cas concret** : Sur l'image ci-dessous, nous allons ajouter un champ à la fenêtre de création rapide du formulaire client.

::callout
Vous pouvez obtenir le nom des champs en survolant le champ qui vous intéresse et en cliquant sur Alt.
::

![personnalisationformulaireajoutrapide.png](https://doc.dokos.io/personnalisationformulaireajoutrapide.png)

# Type de document

Un type de document est le bloc de construction de base de toute application basée sur le framework Frappe.

Il décrit le **Modèle** et la **Vue de vos données**. Il contient quels champs sont stockés pour vos données et comment ils se comportent les uns avec les autres. Il contient des informations sur la façon dont vos données sont nommées. Les formulaires tels que les bons de commande, les factures de vente, les bons de travail sont ajoutés en tant que DocTypes dans le backend.

Le type de document vous permet d'insérer des formulaires personnalisés dans Dokos selon vos besoins.

---

Faites bien la différence entre **Type de document** et un **document**

**Un Type de document** : le plan ou “moule”
Définitions des champs, propriétés et droits d’accès

**Document** : C'est une instance, c'est-à-dire un exemplaire tiré du plan.

## 1. Créer un nouveau modèle de **Type de document**

1. Allez sur la liste de tous les types de document
2. Cliquez sur **+ Ajouter Type de document**
   Ou vous pouvez saisir **Type de document** dans la barre de recherche.

![doctype\_1.png](https://doc.dokos.io/content/cas_usage_booming_tiers_lieu/revue_de_presse/doctype_1.png)

3. Accédez au formulaire qui permet de définir les **informations du nouveau document**.
4. Nommer le document dans le champ **Nom**
5. Sélectionnez le **module** qui sera associé au document.

![doctype\_2.png](https://doc.dokos.io/content/cas_usage_booming_tiers_lieu/revue_de_presse/doctype_2.png)

Dans le partie **contenu**, vous pouvez définir tous les champs du document. Il s'agit des champs que les utilisateurs devront remplir pour valider une Revue de presse.

Dans ce cas là, vous pouvez ajouter les champs suivants :

- Utilisateur
- Date de publication
- Sujet de la revue de presse
- Description de la revue de presse

Etc..

### 1.1 **Les informations de la table**

1. **Libelle** : Nom du champ créé.
2. Le **Type** permet de définir le type de ces données, il existe plusieurs choix possible. &#x2A;Les plus utilisés sont :*\* Type **Donnée** : Vous pouvez renseigner du texte personnalisé.


   - Type **Lien** : Vous pouvez choisir les données d'un autre document et il vous permet de rediriger et lier le document à un autre.
   - Type **Date** : le champ est mis sous le format d'une date.
   - Type **Saut de colonne** : Il permet de créer un saut de ligne entre les champs.
   - Type **Saut de section** : Vous permet de segmenter votre document en plusieurs parties. Par exemple, Détails généraux, Table des articles, Termes et conditions etc..
   - Type **Sélectionner** : Vous pouve donner des choix en **Options**
     …
3. **Obligation**: Si la case est coché, ce champ sera obligatoire pour pouvoir le valider.
4. **Options** : Quand le **Type** de donnée est **Sélectionner** ou **Lien**, vous devez saisir les choix ou le nom de type de document pour rediriger la page...

![doctype\_3.png](https://doc.dokos.io/content/cas_usage_booming_tiers_lieu/revue_de_presse/doctype_3.png)

5. Le champ suivant est le **Nom automatique** qui sera généré à la création d'un document.

Vous pouvez définir la façon de nommer les différents documents en ce type. Par défaut c’est aléatoire. Ici on utilise la façon [série], on remplit "REVUE.#####" dans ce champ.
![doctype\_4.png](https://doc.dokos.io/content/cas_usage_booming_tiers_lieu/revue_de_presse/doctype_4.png)

6. **Enregistrer** le nouveau document.
7. Créez votre premier document pour votre revue de presse en allant sur :

> Accueil > Module > \*\*\*\*
> ou en recherchant Revue de presse dans la barre de recherche.

![doc\_revue\_de\_presse5.png](https://doc.dokos.io/content/cas_usage_booming_tiers_lieu/revue_de_presse/doc_revue_de_presse5.png)

### 1.2 Paramètres du formulaire

Des paramètres supplémentaires pour le formulaire, les champs d'image, les pièces jointes, la chronologie, etc. peuvent être configurés ici. Pour en savoir plus sur Form, visitez Personnaliser le formulaire .

### 1.3 Paramètres d'affichage

Ici, vous pouvez définir les paramètres d'affichage pour le DocType, comme les champs de recherche, le champ de tri par défaut, l'ordre de tri par défaut, etc.

### 1.4 Règles d'autorisation

Vous pouvez définir ici les règles d'autorisation pour le DocType et configurer les utilisateurs qui pourront utiliser ou apporter des modifications à ce DocType. En savoir plus sur les utilisateurs et les autorisations ici.

### 1.5 Vue Web

Vous pouvez choisir si vous souhaitez une vue Web de ce DocType ou non. Avoir une vue Web pour un DocType permettra aux utilisateurs de votre site Web d'avoir accès aux formulaires. N'hésitez pas à en savoir plus sur les utilisateurs du site Web .

### 1.6 Icône du type de document :badge{text="Dodock" type="warning"}

Le champ **Icône** permet d'associer une icône visuelle au type de document. Cette icône est affichée dans :

- Les **champs de type Lien** qui pointent vers ce DocType — une petite icône apparaît à gauche de la valeur saisie dans le formulaire
- Les **résultats de la recherche globale** — chaque suggestion est préfixée par l'icône du type de document correspondant

Les icônes disponibles proviennent de la bibliothèque **Lucide**. Les formats `fa-*` (Font Awesome) et `uil-*` (Unicons) ne sont pas affichés dans les champs Lien.

Pour les types de document fournis par Dodock, les icônes sont préconfigurées. Pour les DocTypes personnalisés, configurez l'icône ici afin de bénéficier de ces améliorations visuelles dans tout le bureau.

Voir [Champs de formulaire](https://doc.dokos.io/v5/dodock/fonctionnalites/personnalisations/champs-formulaire) pour le détail complet du comportement.

### 1.7 Plus de propriétés

- **Est soumissible** : Vous pouvez choisir si vous souhaitez que ce DocType soit uniquement 'Enregistré' ou qu'il soit également 'Soumis' en cochant et décochant cette case.
- **Est une table enfant** : vous pouvez définir si vous voulez que le nouveau DocType soit une table enfant dans un autre DocType. Consultez la table enfant pour plus d'informations.
- **Est Unique** : Si coché, ce Doctype deviendra un formulaire unique, comme Bon de Commande, que l'utilisateur ne pourra pas reproduire. Par exemple, les paramètres de vente dans le module de vente sont un seul DocType.
- **Est une arborescence** : Quelques DocTypes dans ERPNext sont structurés en arbres, dans lesquels il y a des DocTypes parents et des DocTypes enfants. Par exemple, Doctype Company est structurée en arbre, il y a des sociétés mères ainsi que des sociétés enfants, que nous appelons des filiales. Si vous souhaitez que vos DocTypes soient structurés de la même manière, vous pouvez activer cette option.
- **Entrée rapide** : Vous pouvez sélectionner si vous souhaitez qu'une entrée rapide soit effectuée pour ce DocType. Cela vous permettra de n'entrer que quelques informations obligatoires et d'enregistrer le DocType, afin qu'une saisie rapide soit effectuée. Par exemple, cochez Saisie rapide dans Écriture au journal
- **Suivi des modifications** : Vous pouvez sélectionner cette option si vous souhaitez conserver un journal des modifications apportées à chaque formulaire. Consultez le document Versioning pour plus de compréhension à ce sujet.
- **Suivre les vues** : Vous pouvez sélectionner cette option si vous souhaitez conserver un journal de tous les utilisateurs qui ont vu ce formulaire.
- **Personnalisé** : Ce champ sera coché par défaut lors de l'ajout de Custom Doctype. De même, si vous personnalisez un DocType qui existe déjà dans le système, ce champ par défaut sera décoché.


# Traductions personnalisées

**Avec les traductions personnalisées, l'utilisateur peut imprimer le document du client et du fournisseur dans leur langue locale.**

Par exemple, si vous avez des clients allemands, anglais, italiens, etc. et qui souhaitent des devis dans leur langue il est possible d'utiliser les traductions personnalisées.

## 1. Définir la langue

Dans la fiche client, sélectionnez la langue par défaut. Disons que la langue par défaut du client est l'anglais.

De la même manière, vous pouvez également définir la langue par défaut dans la fiche fournisseur.

### 1.1 Aperçu avant impression dans la langue du parti

Dans l'aperçu avant impression d'une transaction, les valeurs seront traduites dans la langue de la partie.

Aperçu avant impression de l'offre client dans la langue par défaut du client.

### 1.2 Modification de la langue d'impression dans l'aperçu

L'utilisateur a la possibilité de sélectionner une autre langue sur la vue d'impression.

![choix\_langue\_impression.png](https://doc.dokos.io/content/setup/custom-translations/choix_langue_impression.png)

## 2. Traductions personnalisées

Les utilisateurs peuvent définir leurs traductions personnalisées à l'aide du formulaire Traductions personnalisées. Par exemple, si un utilisateur souhaite définir une description d'un produit dans la langue du client (anglais). Pour cela, créez une nouvelle traduction avec une langue comme l'anglais, entrez les données source et les informations traduites.

> Accueil > Personnalisation > Autre > Traductions personnalisées > **➕ Ajouter traduction**

![liste\_traductions.png](https://doc.dokos.io/content/setup/custom-translations/liste_traductions.png)

La traduction est appliquée lorsque l'utilisateur sélectionne la langue en tant qu'espagnol dans l'aperçu avant impression du devis fournisseur. Notez qu'aucune traduction n'est appliquée pour la description du deuxième élément car il n'a pas été créé dans la liste Traduction.

![traduction.png](https://doc.dokos.io/content/setup/custom-translations/traduction.png)

## 3. Traductions contextuelles :badge{text="Dodock" type="warning"}

Un même terme peut avoir des traductions différentes selon le contexte dans lequel il apparaît. Par exemple, le mot anglais "Order" peut se traduire par "Commande" dans un contexte commercial, mais par "Ordre" dans un contexte RH. Sans contexte, le moteur de traduction retourne toujours la même valeur, ce qui peut créer des ambiguïtés dans des métiers avec des vocabulaires spécialisés.

Dodock permet d'associer un **contexte** à une traduction personnalisée. Lorsqu'un contexte est défini, il prend la priorité sur la traduction générique pour ce même terme.

### Pour les administrateurs

Dans le formulaire **Traductions personnalisées**, renseignez le champ **Contexte** en plus de la langue et de la chaîne source. Ce contexte est un identifiant libre (par exemple `"Ventes"`, `"RH"`, `"Impression"`) qui correspond au contexte déclaré dans le code de l'application.

Si une application utilise un contexte que vous souhaitez adapter, renseignez exactement le même identifiant de contexte dans votre traduction personnalisée — la traduction contextuelle sera alors appliquée en priorité.

> Accueil > Personnalisation > Autre > Traductions personnalisées > **➕ Ajouter traduction** > renseigner le champ **Contexte**

### Pour les développeurs d'applications

Le moteur de traduction de Dodock stocke les traductions contextuelles sous la clé composée `{chaîne}:::{contexte}`. Au moment de la résolution, il cherche d'abord la clé contextuelle, puis retombe sur la traduction générique si elle n'existe pas.

**En Python**, passez le paramètre `context` à la fonction `_()` ou `_lt()` :

```python
from frappe import _

label = _("Order", context="Ventes")       # → "Commande"
label = _("Order", context="RH")           # → "Ordre"
label = _("Order")                          # → traduction générique
```

**En JavaScript**, le contexte n'est pas encore exposé dans l'API `__()` cliente — les traductions contextuelles sont résolues côté serveur lors du rendu des labels et des formats d'impression.

::callout{color="teal" icon="i-heroicons-light-bulb"}
Lors de la création d'une application, déclarez des contextes explicites pour tout terme métier susceptible d'être ambigu. Cela permet aux administrateurs d'ajuster les traductions sans modifier le code.
::

## Voir aussi

- [Personnalisation des documents](https://doc.dokos.io/v5/dodock/fonctionnalites/personnalisations/doctype)
- [Formats d'impression](https://doc.dokos.io/v5/dodock/fonctionnalites/impression/format-impression)


# Champs de formulaire

## Icône du type de document sur les champs Lien :badge{text="Dodock" type="warning"}

Les champs de type **Lien** affichent automatiquement l'icône associée au type de document cible, à gauche de la valeur saisie. Cette icône permet d'identifier visuellement le type de document référencé sans lire le libellé du champ.

L'icône est récupérée depuis la configuration du type de document (champ **Icône** sur le formulaire DocType). Elle s'actualise dynamiquement si le type cible change (champs **Lien dynamique**).

L'icône n'est pas affichée dans les situations suivantes :

- Dans une **table enfant** (grille)
- Sur les **formulaires en lecture seule**
- Dans les **filtres de liste**
- Sur le **site web public** (portail utilisateur)

### Pour les développeurs d'applications

L'icône est automatique dès que le type de document cible possède un champ `icon` renseigné. Pour les DocTypes personnalisés, configurez l'icône depuis le formulaire **Type de document** > champ **Icône** (bibliothèque Lucide).

Pour désactiver l'icône sur un champ spécifique, ajoutez l'attribut `no_icon: 1` dans la définition du champ.

::demo-link{demo="Dokompany" doctype="Sales Order"}
Voir un bon de commande dans la démo — les champs Lien affichent l'icône du type de document associé
::

## Bouton d'effacement sur les champs Lien :badge{text="Dodock" type="warning"}

Un bouton &#x2A;*✕** est affiché en permanence sur les champs de type Lien dès qu'une valeur est saisie. Un clic sur ce bouton efface la valeur et remet le champ à vide immédiatement.

Dans Frappe standard, ce bouton n'est visible qu'au survol de la souris et son affichage dépend d'un paramètre système. Dans Dodock, il est toujours activé sans configuration.

### Pour les développeurs d'applications

Le comportement est contrôlé par la méthode `is_clear_button_enabled()` du contrôle Link, qui retourne `true` inconditionnellement dans Dodock. Ce comportement s'applique à tous les champs Lien et Lien dynamique dans les formulaires du bureau.

## Voir aussi

- [Personnalisation des documents](https://doc.dokos.io/v5/dodock/fonctionnalites/personnalisations/doctype)
- [Types de document](https://doc.dokos.io/v5/dodock/fonctionnalites/personnalisations/doctype)


# Paquets

Les paquets sont des mécanismes de transport d'éléments personnalisés entre sites Dokos. :br
On peut les voir comme des applications légères ou des plugins contenant un ou plusieurs modules et des documents associés

## Concevoir un paquet

Pour créer un paquet, il faut commencer par créer les éléments qui composeront ce paquet. :br
L'idéal est de créer un **Module**, puis des documents associés comme:

- Des types de document
- Des formulaires web
- Des scripts clients/serveur
- Des pages web
- etc...

Associez bien tous les documents créé au module qui sera exporté dans votre paquet.

## Génerer un paquet

Une fois tous les éléments composant votre paquet créés, allez dans le menu **Paquet** (**Administration > Personnalisations**) et créez un nouveau paquet. :br
Donnez lui un nom et une licence.

Ouvrez le module créé plus tôt et associez le avec ce paquet.

## Publier un paquet

Depuis votre paquet, cliquez sur **Publication du paquet** et créez une nouvelle publication. :br
Donnez un numéro de version à votre paquet et renseignez les notes associées. :br
Quand votre paquet est prêt à être publié, cochez la case **Publié**.

Un fichier **.gz** est généré que vous pouvez télécharger: votre paquet est prêt à être importé dans un autre site.

## Importer un paquet

Pour importer un paquet, ouvrez l'outil d'**Import de paquet** disponible dans le menu **Administration > Personnalisations**.

Créez un nouvel import de paquet, joignez le fichier *.gz* contenant votre paquet, cochez la case **Activer** et enregistrez. 🎉


# Workspaces

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
🚧 Rédaction en cours 🚧
::


# Tableau de bord

Le tableau de bord offre une vue d'ensemble des principaux indicateurs de performance pertinents pour le processus métier.

Chaque tableau de bord se compose d'un ou de plusieurs graphiques de tableau de bord, chacun d'eux étant configuré avec une source de données appelée Source de graphique de tableau de bord.

Pour accéder au **tableau de bord**, allez sur :

> Accueil > Personnalisation > Tableaux de bord > Tableau de bord

## 1. Comment créer un nouveau tableau de bord

1. Allez dans la liste des tableaux de bord et cliquez sur Nouveau.
2. Entrez le nom du module pour lequel vous souhaitez voir le tableau de bord.
3. Entrez les graphiques du tableau de bord que vous souhaitez paramétrer pour ce tableau de bord.
4. Enregistrer.

Lorsque vous cliquez sur **Voir le tableau de bord**, vous pourrez voir le tableau de bord donnant la représentation graphique de vos transactions.

## 2. Ajout de graphiques au tableau de bord

Ajoutez des graphiques à ce tableau de bord en sélectionnant des graphiques existants Dashboard Chartou en en créant de nouveaux.

Enregistrez les modifications et cliquez sur le bouton pour voir le tableau de bord.

## 3. Création d'un nouveau graphique de tableau de bord

Pour créer un nouveau tableau de bord, accédez à

> Accueil > Personnalisations > Tableaux de bord > Tableau de bord> Nouveau

Donnez un nom au graphique, il apparaîtra dans le tableau de bord en tant qu'étiquette du graphique et sélectionnez comme source de données pour ce graphique.

> Remarque : Le nouveau grapgique ne peut être créé que par l'utilisateur administrateur en mode développeur.

## 4. Utilisation des tableaux de bord

Chaque graphique sera affiché en fonction des champs définis dans le tableau de bord correspondant. Le résultat de la source du graphique de tableau de bord est mis en cache pour éviter les requêtes redondantes. Étant donné que les données du graphique peuvent être obsolètes, chaque graphique affichera également la dernière heure synchronisée.

Les filtres utilisés pour générer les données du graphique peuvent également être modifiés en cliquant sur **Définir les filtres**. Le graphique sera actualisé automatiquement en fonction des filtres récemment définis.

Pour obtenir les données les plus récentes, chaque graphique doit être actualisé avec force en cliquant sur le bouton **Forcer l'actualisation** dans le menu déroulant.


# Scripts Python

**Un script python vous permet d'écrire un script exécuté sur le server et généré via un événement de document ou via l'API**

## 1. Comment créer un script python

Pour créer un script python

1. Vous devez ajouter la clé `server_script_enabled` et la définir comme étant vrai (ou 1) dans le fichier site\_config.json de votre site.
2. Pour ajouter / modifier un script python, assurez-vous d'avoir le rôle **Gestionnaire de script**
3. Créez un nouveau script python vis "Nouveau script python" dans la barre d'outils
4. Choisissez le type de script python (Evénement de document / API)
5. Choisissez le type de document de référence et le nom de l'événement, ou le nom de la méthode, ajoutez votre script et enregistrez.

## 2. Fonctionnalités

### 2.1 Autoriser les scripts python

Les scripts python doivent être activés via le fichier site\_config.json

```text
bench --site {votre_site} set-config server_script_enabled true
```

### 2.2 Evénements de document

Pour les scripts qui sont lancés via des événements de documents, vous devez définir le type de document de référence et nom de l'événement générateur

- Avant l'insertion
- Avant l'enregistrement
- Après l'enregistrement
- Avant la validation
- Après la validation
- Avant l'annulation
- Après l'annulation
- Avant la suppression
- Après la suppression

### 2.3 Scripts API

Vous pouvez créer une nouvelle API qui sera accessible via `api/method/[methodname]` en sélectionnant le type de script "API"

Si vous voulez qu'un utilisateur invité (non connecté) accède à l'API, cochez la case "Autoriser les invités".

La réponse sera envoyés dans un objet de type `frappe.response["message"]`

### 2.3 Securité

dokos utilise la librairie RestrictedPython pour restreindre l'accès aux méthodes disponibles pour les scripts python. Seules les méthodes sûres, listées ci-dessous sont disponibles dans les scripts serveur.

```py
json # module json
dict # dict interne
frappe._ # méthode de traduction
frappe._dict # méthode interne frappe._dict
frappe.flags # flags globaux

# FORMATTAGE
frappe.format # frappe.format_value(value, dict(fieldtype='Currency'))
frappe.format_value # frappe.format_value(value, dict(fieldtype='Currency'))
frappe.date_format # format de date par défaut
frappe.format_date # retourne une date sous la forme "1er septembre 2019"

# SESSION
frappe.form_dict # paramètres de requêtes / formulaires
frappe.request # objet de requête
frappe.response # objet de réponse
frappe.session.user # utilisateur actuel
frappe.session.csrf_token # jeton CSRF de la session en cours
frappe.user  # utilisateur actuel
frappe.get_fullname # nom complet de l'utilisateur actuel
frappe.get_gravatar # frappe.utils.get_gravatar_url
frappe.full_name = # nom complet de l'utilisateur actuel

# ACCES AUX DONNEES
frappe.get_meta # obtenir l'objet de métadonnées
frappe.get_doc
frappe.get_cached_doc
frappe.get_list
frappe.get_all
frappe.get_system_settings

# BASE DE DONNEE
frappe.db.get_list
frappe.db.get_all
frappe.db.get_value
frappe.db.get_single_value
frappe.db.get_default
frappe.db.escape

# UTILITAIRES
frappe.msgprint # msgprint
log # création d'un log dans la console du navigateur
frappe.log_error # création d'un log d'erreur
frappe.get_hooks # hooks de l'application
frappe.utils # méthodes de frappe.utils
frappe.render_template # frappe.render_template,
frappe.get_url # frappe.utils.get_url
frappe.socketio_port # port pour socketio
frappe.sanitize_html # Assainissement du HTML
style.border_color # '#d1d8dd'
guess_mimetype = mimetypes.guess_type,
html2text = html2text,
dev_server # Vrai si en mode développeur
```

## 3. Exemples

### 3.1 Changer la valeur d'une propriété avant enregistrement

Type de script: **Avant l'enregistrement**

```py
if "test" in doc.description:
    doc.status = 'Closed'
```

### 3.2 Validation personnalisée

Type de script:: **Avant l'enregistrement**

```py
if "validate" in doc.description:
    raise frappe.ValidationError
```

### 3.3. Auto création d'une ToDo

Type de script: **Après l'enregistrement**

```py
if doc.allocted_to:
    frappe.get_doc(dict(
        doctype = 'ToDo'
        owner = doc.allocated_to,
        description = doc.subject
    )).insert()
```

### 3.4 API

- Type de script: **API**
- Nom de la méthode: `test_method`

```py
frappe.response['message'] = "hello"
```

Requête: `/api/method/test_method`

### 3.5 Création d'une réservation d'articles quand d'autres salles sont réservées

- Type de script: **Après l'enregistrement**

👨‍💼 Le cas d’usage (réel)
Un tiers-lieu a deux salles de réunions : la salle 1 (1ère étage) et 2 (2e) qu’ils louent à des assos, entreprises etc. Ils souhaitent proposer la salle 1 pour du coworking lorsqu’elle n’est pas utilisée avec à terme la possibilité pour les usagers de réserver eux-mêmes en ligne.

🤔 Problème : il faut pouvoir empêcher la réservation du coworking quand les deux salles sont louées.

💡 Une solution : Un script Python qui vient automatiquement réserver tout les créneaux de coworking lorsque il y a chevauchement entre les réservations de la salle 1 et 2.

```py
#****Script parameters****
master_room1 = "Salle réunion 1"
master_room2 = "Salle réunion 2"
slave_room = "Salle de coworking"

# Constraint: If two master rooms are booked at the same time, then the slave room is booked
# too during the overlap
#****0/ Script only does something if item is one of the two master rooms****
if doc.item == master_room1 or doc.item == master_room2:
    #****1/ Get list of bookings confirmed on the same day, exclusive of the slave room****
    booking_list = frappe.db.get_list('Item Booking',
        filters=[
            ['status','=', 'Confirmed'],
            ['name','!=', doc.name],
            ['item', '!=', slave_room],
            ['starts_on','>=',frappe.utils.getdate(doc.starts_on)],
            ['starts_on' ,'<',frappe.utils.add_to_date(frappe.utils.getdate(doc.ends_on),days=1) ]
        ],
        fields=['name'],
        as_list=True
    )
    # Assign datetime data to variables for clearer code
    start1 = frappe.utils.get_datetime(doc.starts_on)
    end1 = frappe.utils.get_datetime(doc.ends_on)
    #****2/ Cycle through all the slots identified to check for overlaps****
    for x in booking_list:
        item_booking = frappe.get_doc('Item Booking', ''.join(x))
        # Assign datetime data to variables for clearer code
        start2 = frappe.utils.get_datetime(item_booking.starts_on)
        end2 = frappe.utils.get_datetime(item_booking.ends_on)
        #-- Conditions to check for overlaps (hard to get one's head around without a schematic) --
        # Initialisation of a flag to check if one of the condition is met
        overlapflag = 0
        # Initialisation of slave start and end as the same as current doc
        slavestart = start1
        slaveend = end1
        # Tail of previous slots overlaps with current doc
        if end2 > start1 and end2 < end1:
            slaveend = end2
            overlapflag = overlapflag + 1
        # Start of previous slots overlaps with tail of current doc
        if start2 > start1 and start2 < end1:
            slavestart = start2
            overlapflag = overlapflag + 1
        # Current doc is completely contained by previous slot
        if start2 < start1 and end2 > end1:
            slavestart = start1
            slaveend = end1
            overlapflag = overlapflag + 1
        #****3/Create a new slot to book the room if an overlap has been found****
        if overlapflag:
            # Get number of simultaneous bookings allowed
            slave_item = frappe.get_doc("Item", slave_room)
            n_slots = slave_item.simultaneous_bookings_allowed
            frappe.msgprint("Nombre de slots = " + str(n_slots))
            # Create enough slots to fill the slave room
            for x in range(n_slots):
                frappe.msgprint("Création d'une réservation pour l'article : " + slave_room)
                slave = frappe.get_doc({
                    "doctype": "Item Booking",
                    "title" : "résa scriptée",
                    "item" : slave_room,
                    "status" : "Confirmed",
                    "starts_on" : slavestart,
                    "ends_on" : slaveend
                    })
                slave.insert()
        overlapflag = 0
    else:
        pass
```


# Scripts Client

Les scripts client permettent d'interagir directement avec l'interface utilisateur et de modifier son comportement.

## Exemples

**Vérifier qu'une pièce jointe a bien été ajoutée à un document de type *Note de frais* avant son enregistrement ou sa validation**

```javascript
frappe.ui.form.on('Expense Claim', {
  before_save(frm) {
    validate_attachments(frm)
  },

  before_submit(frm) {
    validate_attachments(frm)
  }
})

const validate_attachments = (frm) => {
  // On vérifie que le document a déjà été enregistré, car l'ajout d'une pièce jointe n'est possible qu'après le premier enregistrement
  // On vérifie également si une pièce jointe a déjà été ajoutée au document
  if (!frm.is_new() && !frm.attachments.get_attachments().length) {
    frappe.show_alert({
        message:"Veuillez ajouter des justificatifs pour votre note de frais",
        indicator: "orange"
    })

    // Variante: On peut également afficher un popup au lieu d'une alerte
    // Dans ce cas remplacez frappe.show_alert... par le code ci-dessous
    /*
    const dialog = new frappe.ui.Dialog({
        title: "Justificatifs manquants",
        minimizable: false,
        size: 'large'
    });
    dialog.msg_area = $('<div class="msgprint">').appendTo(dialog.body);
    const msg = "Veuillez ajouter des justificatifs pour votre note de frais";
    dialog.msg_area.append(msg);
    dialog.show()
    */


   // frappe.validated permet d'indiquer au framework que la validation a échoué. Le document ne pourra pas être enregistré
    frappe.validated = false;
  };
}
```


# Modèles Jinja

Le langage Jinja est utilisé dans Dokos pour créer des modèles d'email, des notifications et des formats d'impression personnalisés complexes en y intégrant des variables. Il permet de mélanger du language HTML avec des variables en Python.

Pour en savoir plus sur le langage Jinja et avoir accès à la documentation: [Jinja](https://palletsprojects.com/p/jinja/){rel="&#x22;nofollow&#x22;"}

## Les variables

Lorsque vous envoyez un email depuis un document, qu'un notification est envoyée ou que vous imprimer un document, vous avez accès à tous les champs qui composent votre document de référence. :br
Vous pouvez donc les appeler en utilisant la syntaxe:

```text
{{ doc.nom_du_champ }}
```

`doc` fait référence au document de référence - certain document peuvent également donner accès à d'autres variables - et `nom_du_champ` doit être remplacé par le nom du champ correspondant. :br
La liste des champs composant un document est disponible en cliquant sur l'onglet "Menu > Personnaliser". Le nom du champ est la valeur de la colonne "Nom" du tableau des champs.

## Les méthodes

Souvent l'accès à une variable n'est pas suffisant pour afficher les informations qui nous intéressent et il faut qu'on puisse soit changer le format d'affichage de la valeur soit avoir accès aux valeurs renseignées dans d'autres documents.

Dokos donne accès à un certain nombre de méthodes qui peuvent être appelées en Jinja pour ces besoins:

```py
json # module json
dict # dict interne
frappe._ # méthode de traduction
frappe._dict # méthode interne frappe._dict
frappe.flags # flags globaux

# FORMATTAGE
frappe.format # frappe.format_value(value, dict(fieldtype='Currency'))
frappe.format_value # frappe.format_value(value, dict(fieldtype='Currency'))
frappe.date_format # format de date par défaut
frappe.format_date # retourne une date sous la forme "1er septembre 2019"

# SESSION
frappe.form_dict # paramètres de requêtes / formulaires
frappe.request # objet de requête
frappe.response # objet de réponse
frappe.session.user # utilisateur actuel
frappe.session.csrf_token # jeton CSRF de la session en cours
frappe.user  # utilisateur actuel
frappe.get_fullname # nom complet de l'utilisateur actuel
frappe.get_gravatar # frappe.utils.get_gravatar_url
frappe.full_name = # nom complet de l'utilisateur actuel

# ACCES AUX DONNEES
frappe.get_meta # obtenir l'objet de métadonnées
frappe.get_doc
frappe.get_cached_doc
frappe.get_list
frappe.get_all
frappe.get_system_settings

# BASE DE DONNEE
frappe.db.get_list
frappe.db.get_all
frappe.db.get_value
frappe.db.get_single_value
frappe.db.get_default
frappe.db.escape

# UTILITAIRES
frappe.msgprint # msgprint
frappe.get_hooks # hooks de l'application
frappe.utils # méthodes de frappe.utils
frappe.render_template # frappe.render_template,
frappe.get_url # frappe.utils.get_url
frappe.socketio_port # port pour socketio
frappe.sanitize_html # Assainissement du HTML
style.border_color # '#d1d8dd'
guess_mimetype = mimetypes.guess_type,
html2text = html2text,
dev_server # Vrai si en mode développeur
```

## Exemple de modèle d'email

Dans cet exemple, on peut utiliser ce modèle dans tous les documents qui ont un champ "contact\_person" (Personne de contact). Dans notre cas nous comptons utiliser ce modèle depuis les factures de vente.

Le script va d'abord aller chercher le contenu de la fiche "Contact" correspondant à la personne renseignée dans le champ "contact\_person" et l'enregistrer dans une variable "contact". :br
On a ensuite accès aux valeurs de tous les champs de cette fiche contact et on peut récupérer le prénom de notre contact dans notre email.

```text
{% set contact = frappe.get_doc("Contact", contact_person) %}
Bonjour {{ contact.first_name }},

Veuillez trouver ci-joint votre facture.

Le total à régler est de {{ doc.grand_total }}

Bien cordialement,

XXX

```

> Vous avez sûrement remarqué que dans les modèles d'email on n'utilise pas le préfixe `doc.` avant d'appeler un champ de notre document de référence.
> C'est une différence historique de fonctionnement entre les modèles d'emails et les autres documents qui sera probablement corrigée à l'avenir.

## Exemple de notification

Nous souhaitons envoyer une notification automatique lorsque quelqu'un fait une réservation de salle en ligne.
Contrairement aux modèles d'email que l'on peut modifier dans l'éditeur d'email avant envoi, les notifications sont envoyées toutes seules et il faut donc s'assurer qu'elles sont correctement formattées. On va donc utiliser du HTML dans notre modèle pour garantir la structure de notre email.

Cet exemple est un email envoyé lors de la création de la commande correspondant à la validation de la réservation - lorsque l'utilisateur·rice clique sur "Passer la commande" dans son panier.

```html
<!--On affiche directement le nom du contact ou rien si ce champ n'est pas rempli-->
<p>Bonjour {{ doc.contact_display or "" }},</p>

<p>Merci pour votre réservation, celle-ci est bien prise en compte.</p>
<p>En voici le détail :</p>

<!--On affiche le détail de sa réservation dans un tableau. Vous pouvez utiliser la librairie Bootstrap pour le formattage.-->
<table class="table table-bordered">
    <thead>
        <tr>
            <th>Description</th>
            <th>Heure et date</th>
        </tr>
    </thead>
    <tbody>
        <!--On itère sur les différentes lignes de la commande pour en imprimer le détail-->
        {% for item in doc.items %}
        <!--On utilise la méthode frappe.db.get_value pour récupérer l'heure de début et l'heure de fin de la réservation d'article correspondant à la ligne de commande-->
        {% set booking_start = frappe.db.get_value("Item Booking", item.item_booking, "starts_on") %}
        {% set booking_end = frappe.db.get_value("Item Booking", item.item_booking, "ends_on") %}
        <tr>
            <td>{{ item.description or "" }}</td>
            <td>
                <!--On utilise la méthode frappe.utils.formatdate pour formatter la date de début de la réservation-->
                <span>{{ frappe.utils.formatdate(booking_start) }} </span>
                <!--On utilise la méthode frappe.utils.get_time pour récupérer l'heure de début et de fin de la réservation et on la formatte avec la méthode standard Python strftime-->
                <span>{{ frappe.utils.get_time(booking_start).strftime("%H:%M") }} - {{ frappe.utils.get_time(booking_end).strftime("%H:%M") }}</span>
            </td>
        </tr>
        <!--On indique à Jinja que notre itération s'arrête là-->
        {% endfor %}
    </tbody>
</table>


<br>
<p>Si vous avez une question ou besoin d'information pour préparer votre venue, n'hésitez pas à revenir vers moi.</p>

<p>A bientôt,</p>

<p>XXXXX</p>
```

## Exemple de format d'impression

Il est possible de créer vos propres formats d'impression personnalisés en Jinja dans Dokos.
Voici un exemple de facture entièrement personnalisée:

```html
{% if letter_head and not no_letterhead %}
<div class="letter-head">{{ letter_head }}</div>
{% endif %}
<div class="row">
    <div class="col-xs-6 col-xs-push-6">
        <div class="row">
            {% set salutation = frappe.db.get_value("Customer", doc.customer, "salutation") %}
            <div class="col-xs-12 text-left "><strong>{{ salutation or '' }} {{ doc.customer_name }}</strong></div>
        </div>
        {% if doc.customer_address %}
            {% set client_address = frappe.get_doc("Address", doc.customer_address) %}
            <div class="row">
                <div class="col-xs-12 text-left">
                    {{ client_address.address_line1 }}<br> {% if client_address.address_line2 %}{{ client_address.address_line2 }}<br>{% endif %} {{ client_address.pincode }} {{ client_address.city }}<br> {{ client_address.country }}
                </div>
            </div>
        {% endif %}
    </div>
</div>
{% if doc.print_heading_template %}
    {{ frappe.render_template(doc.print_heading_template, {"doc":doc}) }}
{% else %}
    <div class="print-heading">
        <h2>{{ doc.select_print_heading or (doc.print_heading if doc.print_heading != None else _(doc.doctype)) }}</h2>
    </div>
{% endif %}
{%- if doc.meta.is_submittable and doc.docstatus==0 and (print_settings==None or print_settings.add_draft_heading) -%}
    <div class="text-center" document-status="draft">
        <h4 style="margin: 0px;">{{ _("DRAFT") }}</h4>
    </div>
{%- endif -%}
{%- if doc.meta.is_submittable and doc.docstatus==2-%}
    <div class="text-center" document-status="cancelled">
        <h4 style="margin: 0px;">{{ _("CANCELLED") }}</h4>
    </div>
{%- endif -%}
<div>
    <div id="footer-html" class="visible-pdf">
        {% if not no_letterhead and footer %}
        <div class="letter-head-footer visible-pdf">
            {{ footer }}
        </div>
        {% endif %}
        <p class="text-center small page-number visible-pdf">
            {{ _("Page {0} of {1}").format('<span class="page"></span>', '<span class="topage"></span>') }}
        </p>
    </div>

    <div class="row">
        <div class="col-xs-6">
      {% set account_manager = frappe.db.get_value("Customer", doc.customer, "account_manager") %}
      {% if account_manager %}
      {% set user = frappe.get_doc("User", account_manager) %}
            <div class="row">
                <div class="col-xs-4 text-left"> <label>{{ _("Contact") }}</label> </div>
                <div class="col-xs-8 text-left ">
                    <strong>{{ user.first_name or ''}} {{ user.last_name or '' }}</strong></div>
            </div>
            <div class="row">
                <div class="col-xs-4 text-left"> <label>{{ _("Email") }}</label> </div>
                <div class="col-xs-8 text-left ">
                    {{ user.email or ''}}</div>
            </div>
            <div class="row">
                <div class="col-xs-4 text-left"> <label>{{ _("Phone") }}</label> </div>
                <div class="col-xs-8 text-left ">
                    {{ user.phone or ''}}</div>
            </div>
      {% endif %}
        </div>

        <div class="col-xs-6">
            <div class="row">
                <div class="col-xs-5 text-left"><label>{{ _("Invoice Number") }}</label></div>
                <div class="col-xs-7 text-left ">{{ doc.sub_heading if doc.sub_heading != None else doc.name }}</div>
            </div>
            <div class="row">
                <div class="col-xs-5 text-left"> <label>{{ _("Date") }}</label> </div>
                <div class="col-xs-7 text-left ">{{ doc.get_formatted("posting_date") or ''}}</div>
            </div>
            <div class="row">
                <div class="col-xs-5 text-left"> <label>{{ _("Due Date") }}</label> </div>
                <div class="col-xs-7 text-left">
                    {{ doc.get_formatted("due_date") or ''}}</div>
            </div>
        </div>
    </div>

    <table class="table table-condensed table-bordered">
        <tr>
            <th>{{ _("Description") }}</th>
            <th>{{ _("Quantity") }}</th>
            <th class="text-right">{{ _("Rate") }}</th>
            <th class="text-right">{{ _("Amount") }}</th>
        </tr>
        {%- for row in doc.items -%}
        <tr>
            <td style="width: 55%;">{{ row.item_name or '' }}</td>
            <td style="width: 15%;">{{ row.get_formatted("qty") }} {{ row.stock_uom }}</td>
            <td style="width: 15%; text-align: right;">

                {{ row.get_formatted("rate", doc) or ''}}
                <td style="width: 15%; text-align: right;">{{ row.get_formatted("amount", doc) or ''}}</td>
        </tr>
        {%- endfor -%}
        </tbody>
    </table>

    <div class="row">
        <div class="col-xs-6 text-right"></div>
        <div class="col-xs-4 text-right"><label>{{ _("Total") }}</label></div>
        <div class="col-xs-2 text-right">{{ doc.get_formatted("total") or '' }}</div>
    </div>
    <br>
    {%- if doc.discount_amount -%}
        <div class="row">
            <div class="col-xs-6 text-right"></div>
            <div class="col-xs-4 text-right"><label>{{ _("Discount") }}</label></div>
            <div class="col-xs-2 text-right">- {{ doc.get_formatted("discount_amount") }}</div>
        </div>
        <div class="row">
            <div class="col-xs-6 text-right"></div>
            <div class="col-xs-4 text-right"><label>{{ _("Net Total") }}</label></div>
            <div class="col-xs-2 text-right">{{ doc.get_formatted("net_total") or '' }}</div>
        </div>
        <br>
    {%- endif -%}
    {%- for row in doc.taxes -%}
        {%- if row.tax_amount_after_discount_amount -%}
            <div class="row">
                <div class="col-xs-6 text-right"></div>
                <div class="col-xs-4 text-right"><label>{{ row.description }}</label></div>
                <div class="col-xs-2 text-right">{{ row.get_formatted("tax_amount_after_discount_amount", doc) }}</div>
            </div>
        {%- endif -%}
    {%- endfor -%}

    {%- if doc.taxes or doc.discount_amount -%}
        <br>
        <div class="row">
            <div class="col-xs-6 text-right"></div>
            <div class="col-xs-4 text-right"><label>{{ _("Grand Total") }}</label></div>
            <div class="col-xs-2 text-right"><strong>{{ doc.get_formatted("grand_total") }}</strong></div>
        </div>
    {% endif %}
    {% set customer = frappe.get_doc("Customer", doc.customer) %}
    {% if customer.tax_id %}
        <br>
        <div class="row">
            <div class="col-xs-2 text-left"><label>{{ _("Customer VAT N°") }}</label></div>
            <div class="col-xs-10">{{ customer.tax_id }}</div>
        </div>
        </div>
    {% endif %}
    <br>
    {% if doc.remarks -%}
        <div class="row">
            <div class="col-xs-2 text-left"><label>{{ _("Remarks") }}</label></div>
            <div class="col-xs-10">{{ doc.remarks }}</div>
        </div>
    {%- endif %}

    <br>
    <div class="row">
        <div class="col-xs-12 text-left"><label>{{ _("IBAN") }}</label></div>
    </div>
    <div class="row">
        <div class="col-xs-12 text-left">
            <p>ABCXXXXXXXXXXXXXX</p>
        </div>
    </div>

    <p style="page-break-after:always;"></p>

    <div class="row">
        <div class="col-xs-12 text-left">{{ doc.terms or '' }}</div>
    </div>
</div>
```


# Packages

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
🚧 Rédaction en cours 🚧
::


# Vue du calendrier

Vous pouvez créer des vues du calendrier personnalisées pour vos types de documents.

1. Cherchez "Vue du calendrier" dans la barre de recherche ou dans le module "Personnalisations".
2. Créez une nouvelle "Vue du calendrier"
3. Sélectionnez le type de document de référence - le document pour lequel vous souhaitez avoir une vue du calendrier personnalisée - et configurez votre nouvelle vue du calendrier.

#### Options disponibles

- **Champ de sujet:** Le champ contenant le sujet dans votre document
- **Date de début:** Le champ contenant la date de début de votre événement de calendrier
- **Champ pour la date de fin:** Le champ contenant la date de fin de votre événement de calendrier
- **Champ pour toute la journée:** Le champ à cocher définissant l'événement de calendrier comme durant toute la journée
- **Champ de statut:** Le champ contenant le statut du document
- **Champ de couleur**: Le champ contenant la couleur du document
- **Champ de règle de récurrence:** Le champ contenant les informations des événements récurrents
- **Champ de statut secondaire**: Le champ contenant un statut secondaire. Ce statut secondaire sera affiché à gauche de l'événement dans le calendrier.
  Vous pouvez utiliser le tableau de correspondance en dessous pour définir les couleurs qui seront affichées dans le calendrier pour chaque statut secondaire.
- **Heure minimum quotidienne**: L'heure de démarrage des journées dans votre calendrier
- **Heure minimum quotidienne**: L'heure de fin des journées dans votre calendrier

#### Utiliser les vues de calendrier personnalisées

Vous pouvez créer autant de vues de calendrier que nécessaire. :br
Ces vues personnalisées seront disponibles dans le menu déroulant "Calendrier" de la barre latérale gauche.

Si vous ne les voyez pas immédiatement après les avoir créé, pensez à "Recharger" la page.


# Supprimer des champs personnalisés par code

Lorsque vous développez une application personnalisée sur Dokos, il est courant d'ajouter des champs personnalisés via des fichiers de configuration (`custom_fields`). Dokos propose désormais une fonction dédiée pour **supprimer ces champs par code**, utile lors de migrations, de mises à jour de modules ou de nettoyages de données.

## La fonction `delete_custom_fields`

La fonction `delete_custom_fields` est disponible dans le module `frappe.custom.doctype.custom_field.custom_field`. Elle permet de supprimer un ou plusieurs champs personnalisés associés à des types de formulaires spécifiques.

::dokos
**Utilisation réservée aux développeurs**

Cette fonction est destinée aux développeurs qui construisent ou maintiennent des applications sur Dodock/Dokos. Elle ne s'utilise pas depuis l'interface utilisateur.
::

## Syntaxe

```python
from frappe.custom.doctype.custom_field.custom_field import delete_custom_fields

delete_custom_fields(custom_fields, ignore_if_not_exists=True)
```

### Paramètres

| Paramètre              | Type   | Description                                                                                                                                           |
| ---------------------- | ------ | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
| `custom_fields`        | `dict` | Dictionnaire associant un nom de DocType à une liste de définitions de champs (chaque définition doit contenir au minimum la clé `fieldname`)         |
| `ignore_if_not_exists` | `bool` | Si `True` (valeur par défaut), aucune erreur n'est levée si le champ n'existe pas. Si `False`, une exception est déclenchée pour tout champ manquant. |

## Exemples d'utilisation

### Supprimer un champ personnalisé sur un seul DocType

```python
from frappe.custom.doctype.custom_field.custom_field import delete_custom_fields

delete_custom_fields({
    "Customer": [
        {"fieldname": "custom_loyalty_tier"}
    ]
})
```

Dans cet exemple, le champ `custom_loyalty_tier` est supprimé du DocType `Customer`. Si le champ n'existe pas, aucune erreur n'est levée (comportement par défaut).

### Supprimer plusieurs champs sur plusieurs DocTypes

```python
from frappe.custom.doctype.custom_field.custom_field import delete_custom_fields

delete_custom_fields({
    "Customer": [
        {"fieldname": "custom_loyalty_tier"},
        {"fieldname": "custom_account_manager"}
    ],
    "Sales Invoice": [
        {"fieldname": "custom_campaign_code"}
    ]
})
```

### Forcer l'erreur si un champ est absent

```python
from frappe.custom.doctype.custom_field.custom_field import delete_custom_fields

delete_custom_fields(
    {
        "Supplier": [
            {"fieldname": "custom_supplier_category"}
        ]
    },
    ignore_if_not_exists=False
)
```

Avec `ignore_if_not_exists=False`, une exception est levée si `custom_supplier_category` n'existe pas sur `Supplier`. Utile pour s'assurer qu'une migration s'exécute dans un contexte précis.

## Cas d'usage typiques

- **Migration de module** : lors de la refonte d'un module, supprimer les anciens champs devenus obsolètes sans intervention manuelle en base.
- **Patch de mise à jour** : dans un fichier `patches.txt`, appeler `delete_custom_fields` pour nettoyer les résidus d'une ancienne version.
- **Tests automatisés** : créer puis supprimer des champs personnalisés dans des tests pour garantir la reproductibilité.

## Comportement technique

- Après suppression, le cache Frappe est automatiquement vidé pour que les modifications soient immédiatement prises en compte.
- La fonction utilise le système de hooks Frappe par défaut ; il est possible de contourner les hooks en passant les arguments appropriés si besoin dans des contextes avancés.
- La suppression est définitive : les données éventuellement stockées dans ces champs sont perdues si elles ne sont pas sauvegardées ailleurs.

::callout{type="warning"}
**Attention aux données** : supprimer un champ personnalisé supprime également sa définition en base. Si des documents existants contiennent des valeurs dans ce champ, ces valeurs ne seront plus accessibles après suppression. Prévoyez une migration des données si nécessaire.
::


# Liste à faire

La liste à faire ou To Do est une liste d'activités qui doivent être effectuées par une personne en particulier.

Dans DOKOS, To DO est un outil simple où vous pouvez définir les activités à réaliser. La liste des choses à faire regroupera toutes les activités qui vous sont assignées et par vous.

Une tâche est également créée automatiquement lorsqu'un autre document vous est attribué. Commander la création ToDo-Auto

---

Pour accéder à la **liste ToDo**, allez sur :

> Accueil > Outils > **ToDo**

![liste\_todo.png](https://doc.dokos.io/content/setup/todo/liste_todo.png)

## 1. Comment créer une tâche

1. Accédez à la **liste ToDo** et cliquez sur ➕ Ajouter ToDo.
2. Vous serez redirigé vers une entrée rapide pour ToDo, dans laquelle vous devrez entrer la description de la tâche.
3. **Enregistrer**.

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
**Remarque** : Lors de la création d'une tâche à l'aide de la saisie rapide, la tâche par défaut est attribuée au créateur. Pour éviter cela et l'attribuer à d'autres utilisateurs, assurez-vous de modifier la tâche en pleine page.
::

![créer\_todo.png](https://doc.dokos.io/content/setup/todo/creer_todo.png)

### Notification ToDo

Une fois qu'une tâche est créée, l'utilisateur affecté recevra une notification pour la tâche.

### 1.1. Options supplémentaires lors de la création d'une tâche

- **Statut** : vous pouvez définir le statut de la tâche. Lors de la création, le statut de la tâche serait «Ouvert» par défaut. L'utilisateur peut le changer en «Fermé» lorsque l'affectation est terminée.
- **Priorité** : vous pouvez définir la priorité de cette tâche sur Faible, Moyenne ou Élevée.
- **Couleur** : vous pouvez choisir d'attribuer une couleur à chacune de vos tâches. Par exemple, une tâche créée comme rappel hebdomadaire pour l'envoi de rapports peut se voir attribuer la couleur Violet, tandis que toutes les tâches personnelles peuvent se voir attribuer la couleur jaune.
- **Date d'échéance** : vous pouvez ajouter la date d'échéance à toutes les tâches.
- **Attribué à** : dans les cas où vous attribuez une tâche à un autre utilisateur DOKOS, vous pouvez le faire ici.

### 1.2. Les références

Chaque document dans DOKOS a une option appelée **Attribuer à** dans la barre latérale. En utilisant cette option, n'importe quel Dcoument peut être assigné à l'utilisateur. L'utilisateur se verrait attribuer une tâche simultanément.

- **Type de référence** : lorsqu'une tâche est créée à partir d'un autre document, par exemple une tâche ou un problème, le type de document de référence est lié à la tâche ici. Vous pouvez également choisir d'ajouter un type de document de référence manuellement.
- **Nom de référence** : lors de l'attribution via un autre DocType, le nom du DocType de référence est également lié ici.
- **Affectation par** : lorsque vous recevez une tâche à faire via un autre type de document, le nom de la personne qui effectue l'affectation est également marqué.

![référence\_todo.png](https://doc.dokos.io/content/setup/todo/reference_todo.png)

## 2. Statuts ToDo

ToDo a 3 statuts, chacun décrivant l'état actuel d'une tâche.

- **Ouvrir** : une tâche par défaut est marquée comme ouverte lors de sa création.
- **Fermé** : lorsqu'une activité est terminée, la tâche peut être marquée comme «Fermée», «Résolue» ou «Terminée». En outre, pour des conditions telles que Problème résolu ou tâche terminée; le ToDo se ferme automatiquement. Il peut également être rouvert si nécessaire.
- **Annulé** : lorsqu'un utilisateur est retiré de l'attribution d'une tâche / tâche / problème, la tâche liée à ce document est automatiquement «annulée».


# Jalons

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
🚧 Rédaction en cours 🚧
::


# Mise à jour en masse

::tour{demo="Mappemonde" doctype="bulk-update"}
Créer une mise à jour en masse dans la démo
::

La fonctionnalité de Mise à jour en masse permet de modifier rapidement plusieurs enregistrements à la fois dans le système. En sélectionnant un type de document spécifique, un champ à modifier, ainsi que la nouvelle valeur à appliquer, les utilisateurs peuvent effectuer des mises à jour sur plusieurs enregistrements simultanément, tout en définissant des conditions précises à travers des requêtes SQL. Cette interface facilite ainsi la gestion de grandes quantités de données en un seul clic, avec une limite de 500 enregistrements par mise à jour.

## 1. Mise à jour

1. Accédez à la mise à jour en masse.
2. Sélectionnez le type de document, comme Devis.
3. Sélectionnez le champ à mettre à jour, comme le territoire.
4. Saisissez une nouvelle valeur **valide** à mettre à jour.
5. Saisissez toutes les conditions applicables, par exemple, status="Brouillon" affectera uniquement les documents au stade Brouillon.
6. Sélectionnez la limite, c'est-à-dire le nombre de documents (devis) à mettre à jour.

::callout
Remarque : vous ne pouvez mettre à jour que les champs qui peuvent être mis à jour normalement à une étape donnée. Par exemple, la date de validité ne peut pas être mise à jour pour les devis soumis.
::


# Points d'énergie

Dodock permet l'attribution de points d'énergie aux utilisateurs qui accomplissent certaines actions. Ces points d'énergie ont pour seul objectif de rendre l'usage du logiciel plus ludique pour les utilisateurs : c'est un outil de *gamification*.

Ces points d'énergie sont associés à des points de revue qui peuvent être attribués aux utilisateurs afin de leur permettre d'apprécier ou de critiquer les tâches accomplies par d'autres utilisateurs dans une optique de collaboration.

## 1. Paramètres des points d'énergie

::tour{doctype="Energy Point Settings"}
Voir les paramètres de points d'énergie
::

Les paramètres de point d'énergie permettent d'activer ou désactiver globalement l'attribution de points d'énergie.

Ils permettent également de définir des règles d'attribution des points de revue via deux mécanismes:

1. Une attribution automatique à une périodicité prévue et selon des règles définies par rôle
2. Une attribution manuelle à un utilisateur via un bouton dédié

### 1.1. Points de revue

Ce tableau permet d'attribuer automatiquement un nombre prédéfini de points de revue à tous les utilisateurs ayant un rôle donné.: Si un utilisateur a plusieurs rôles, seul le nombre de points le plus élevé associé à un de ses rôles lui sera attribué.

Utilisation : Le système d'évaluation peut être utilisé pour « apprécier » ou « critiquer » le travail d'un autre utilisateur.

![Cette image permet de visualiser la fenêtre d'attribution de points.](https://doc.dokos.io/revue-points-d-energie.png)![Cette image permet de visualiser la zone pour l'attribution des points à un autre utilisateur.](https://doc.dokos.io/revues.png)![Cette image permet de voir la fenêtre "ajouter une revue"](https://doc.dokos.io/details-revue.png)![Cette image permet de visualiser les points.](https://doc.dokos.io/visualisation-points-revues.png)

## 2. Règles de points d'énergie

> Créer des règles de points d'énergie dans un système de gamification peut être une excellente façon d'encourager et de motiver les utilisateurs. Cependant, il est essentiel de faire preuve de vigilance pour éviter toute frustration parmi les utilisateurs. Voici quelques points à considérer pour garantir que le système reste juste et équitable :
>
> 1. **Égalité des Opportunités :** Assurez-vous que les règles de points sont accessibles et compréhensibles pour tous les utilisateurs. Cela signifie que les critères d'attribution des points doivent être clairs et transparents, sans ambiguïté.
> 2. **Equité :** Évitez de créer des règles qui maintiennent un groupe d'utilisateurs au détriment d'autres. Chaque utilisateur devrait avoir la possibilité d'atteindre les mêmes objectifs et d'obtenir des points en fonction de ses contributions.
> 3. **Communication :** Communiquez clairement les règles de points et les critères d'attribution aux utilisateurs. Expliquez comment le système fonctionne et comment les points sont attribués. Cela réduit les malentendus et les frustrations.
> 4. **Flexibilité :** Offrez la possibilité d'ajuster les règles de points en fonction des retours d'utilisateurs. Si une règle suscite des préoccupations ou n'est pas perçue comme équitable, il est important de réévaluer et de faire les ajustements nécessaires.

::tour{doctype="Energy Point Rule"}
Voir les règles de points d'énergie
::

![Cette image permet de visualiser la fenêtre des points d'énergie.](https://doc.dokos.io/points-energie.png)

La règle de points d'énergie comporte les champs suivants:

- Nom de la règle : Choisir un nom compréhensible de tous

- Type de document de référence : Type de document sur lequel vous souhaitez appliquer la règle.
- Pour l'événement sur le document : Nouveau-elle, Valider, Annuler, Modification de valeur et Personnalisé. &#x2A;*Remarque:** Si l'option "Modification de valeur ou Personnalisée" est sélectionnée, le champ "Conditions" devient obligatoire
- Points : Points à attribuer, définir une quantité cohérente selon la tâche.
- Allouer des points aux utilisateurs assignés : Si cette case est cochée, les utilisateurs affectés au document de référence obtiendront des points respectifs.
- Champ de l'utilisateur : Champ à partir duquel l'utilisateur sera sélectionné. Par exemple : Si "modifier par" est sélectionné, la dernière personne à valider le document obtiendra les points.
- Champ multiplicateur : Champ qui stocke la valeur du multiplicateur. Ce champ peut prendre des valeurs numériques et décimales qui seront multipliées par des points définis dans la règle. Par exemple : 2 (multiplicateur) \* 10 (points définis dans la règle) = 20 points

![Cette image permet de visualiser la zone "champ multiplicateur".](https://doc.dokos.io/champ-multiplicateur.png)

- Condition : Condition pour l'attribution des points. Par exemple : `doc.status == 'Closed'` La condition ci-dessus vérifiera si le `status`champ du document est « Fermé » et si oui, les points seront attribués à l'utilisateur.
- Appliquer une seule fois : La règle ne sera appliquée qu’une seule fois par document.

### 2.1. Règles créées par défaut

Lors de la première utilisation de Dodock, un certain nombre de règles sont créées par défaut. Vous pouvez ensuite les supprimer ou les modifier en fonction des besoins de votre organisation.

|                                               |                            |
| --------------------------------------------- | -------------------------- |
|                                               |                            |
|                                               |                            |
|                                               |                            |
| Règle                                         | Nombre de points attribués |
| A la création d'un**Article**                 | 5                          |
| A la création d'un**Client**                  | 5                          |
| A la création d'une**Piste**                  | 2                          |
| A la conversion d'une**Opportunité**          | 10                         |
| A la validation d'une**Commande client**      | 10                         |
| A la validation d'une**Commande fournisseur** | 10                         |
| A l'achèvement d'une**Tâche**                 | 5                          |

### Exemple Pratique

Imaginez qu'un utilisateur valide une commande client. Selon les règles configurées, cette action pourrait lui rapporter 10 points d'énergie. Ces points sont ensuite visibles sur son tableau de bord dans l'onglet profil, ce qui lui permet de voir ses contributions et son engagement de manière concrète.

## 3. Journal des points d'énergie

Tous les points d'énergie attribués sont enregistrés dans un journal des points d'énergie.

[Voir le journal des points d'énergie](https://tierslieux.dokos.io/app/energy-point-settings){rel="&#x22;nofollow&#x22;"}

![Cette image permet de visualiser le journal des points d'énergie.](https://doc.dokos.io/journal-des-points-d-energie.png)

### 3.1. Classement

::tour{demo="Mappemonde" doctype="leaderboard"}
Voir le classement des employés
::

Les utilisateurs accumulent des points d'énergie, et ces points sont utilisés pour créer un classement. Ce classement permet de visualiser et de comparer les performances des différents utilisateurs au sein de l'entreprise. Il peut être utilisé pour identifier les utilisateurs les plus actifs.

![Image permettant de visualiser le classement avec différents critères.](https://doc.dokos.io/classement.png)

## 4. Désactiver les points d'énergie

Vous pouvez désactiver les points d'énergie globalement depuis les **Paramètres de points d'énergie**.

![Cette image permet de visualiser la zone pour activer ou désactiver les point d''énergie.](https://doc.dokos.io/activer-point-d-energie.png)

Chaque utilisateur peut également désactiver les notifications associés aux points d'énergie depuis l'icône de notifications (🔔) > ⚙ > Paramètres des emails / Notifications système

![Image permettant de visualiser les paramètres de notifications](https://doc.dokos.io/notification-point-d-energie.png)

> Vous pouvez personnaliser le formulaire afin de désactiver par défaut les notifications pour tous les utilisateurs.
>
> ![Visualisation des paramètres de notifications afin de personnaliser le document.](https://doc.dokos.io/parametres-notifications-personnalisation.png)![parametresnotificationspointenergie.png](https://doc.dokos.io/parametres-notifications-point-energie.png)

### 5. Mon profil

Un historique est disponible dans le profil utilisateur.

![Cette image permet de visualiser le profil de l'utilisateur.](https://doc.dokos.io/profil.png)

#### Supprimer le profil :

Si la fonctionnalité des points d'énergie ne vous est pas utile, vous pouvez supprimer la section profil de la barre de navigation de l'utilisateur pour éviter d'avoir des données vides.

> vous devez vous rendre dans les paramètres de la barre de navigation.

![Image permettant de visualiser les paramètres de la barre de navigation .](https://doc.dokos.io/parametre-barre-de-navigation.png)


# Notes

Notes est un outil qui peut être utilisé à des fins de prise de notes personnelles. Vous pouvez l'utiliser pour enregistrer vos listes, les mots de passe fréquemment utilisés, les termes et conditions, ou tout autre document qui doit être partagé ou conservé pour référence.

Pour accéder à la **liste des Notes**, allez sur :

> Accueil > Outils > Notes

## 1. Comment créer une nouvelle note

1. Allez dans la liste des notes et cliquez sur **➕ Ajouter Note**.
2. Entrez le titre de la note.
3. Entrez le contenu de la note. La zone de contenu est une zone d'éditeur de texte pour vous permettre de mettre en forme le contenu selon vos besoins.
4. Enregistrer.

## 2. Visibilité des notes

Vous pouvez choisir si vous souhaitez ou non que cette note particulière soit publique. Rendre une note publique vous permettra de la partager entre les utilisateurs de votre compte DOKOS.

Une fois que vous avez activé la création d'une note publique, il y aura une autre case à cocher, disant **Notifier les utilisateurs avec une fenêtre contextuelle lorsqu'ils se connectent**.

Vous pouvez également choisir si vous souhaitez donner à certains utilisateurs spécifiques, le droit de lire, d'écrire ou de partager votre note. Cela peut être fait à partir de l'option «Partager» dans la barre latérale gauche.

## 3. Notification pour les notes

L'activation de cette propriété garantirait que chaque fois qu'un utilisateur se connecte à son compte, il y aura une notification contextuelle pour la note.


# Événements

---

::tour{demo="Mappemonde" doctype="Event"}
Découvrir les événements dans la démo
::

## 1. Créer l'événement

![Image permettant de visualiser le formulaire pour la création d'un nouvel événement.](https://doc.dokos.io/evenement-nouveau-formulaire.png)

### 1. Détails

- Ajoutez le **Sujet**
- Définissez une **Catégorie d'événement** : L'événement peut être une réunion, un événement, un appel, l'envoi d'un email, autre.
- Sélectionnez un **Type d'événement** : Il peut être public ou privé. Si l'événement est public, l'onglet "Site web" apparait.
- Indiquez **Commence le** : Indiquez la date de début
- Indiquez **Termine le** : Indiquez la date de fin
- Pour voir le **Statut** : Visualiser le statut de votre événement
- **Toute la journée** : Cochez la case si votre événement dure toute la journée.
- **Répéter cet événement** : Cochez la case pour répéter cet événement. Une fenêtre s'ouvrira et vous allez pouvoir indiquer la fréquence, répété jusqu'au, intervalle de fréquence.
- **Synchroniser avec Google Agenda** : Cochez la case pour synchroniser l'événement sur Google Agenda.

### 2. Site web

![Cette image permet de visualiser l'onglet site web.](https://doc.dokos.io/evenement-site-web.png)

- **Publié** : Cochez cette case pour rendre l'événement visible sur le site web. Cela rendra l'événement accessible au public ou aux utilisateurs désignés en fonction des paramètres de visibilité.
- **Visible pour** :


  - **Tous** : L'événement sera visible par tous les visiteurs du site web, qu'ils soient connectés ou non.
  - **Rôle** : Limitez la visibilité de l'événement aux utilisateurs connectés avec un rôle spécifique. Par exemple, seuls les administrateurs ou un groupe particulier d'utilisateurs pourront voir l'événement.
- **Autoriser les inscriptions** : Activez cette option pour permettre aux participants de s'inscrire en ligne pour l'événement.
- **Autoriser inscriptions multiples** : Permet aux utilisateurs de s'inscrire pour plusieurs places à partir d'un seul compte utilisateur/adresse email.
- **Autoriser les annulations** : Cochez cette case pour permettre aux participants d'annuler leur inscription.
- **Formulaire d'inscription** : Sélectionnez le formulaire web que les participants utiliseront pour s'inscrire à l'événement. Ce formulaire peut être personnalisé pour collecter des informations spécifiques nécessaires à l'événement.

> **Le formulaire web permet d'activer la collecte d'un paiement à la validation du formulaire par l'utilisateur.**

### 3. Participants et références

![Cette image permet de visualiser l'onglet : participants et références.](https://doc.dokos.io/evenement-participants.png)

#### **Participants**

Dans cette section, vous avez la possibilité d'indiquer les participants qui seront présents pour l'événement. La liste de participants peut inclure des personnes s'étant inscrites via le portail en ligne ou des personnes que vous ajoutez manuellement, comme des intervenants. Si les participants s'inscrivent en ligne, un document *Inscription à l'événement* sera automatiquement généré et accessible depuis la liste de *Liens* de l'événement.

#### **Référence de l'événement**

**Fonctionnalité**

- **Type de document de référence** : Cette colonne vous permet de sélectionner le type de document dans Dokos que vous souhaitez associer à l'événement. Par exemple, cela pourrait être une tâche, un projet, une commande de vente, etc.
- **Nom de la référence** : Une fois le type de document de référence choisi, cette colonne vous permet de spécifier le nom ou l'identifiant précis du document à lier. Cela établit un lien direct entre l'événement et ce document spécifique.

**Utilisation**

- **Suivi des liens** : En associant des documents à un événement, vous pouvez facilement accéder aux informations pertinentes sans avoir à naviguer manuellement dans différents modules.
- **Contexte et coordination** : Cela permet de fournir un contexte supplémentaire à l'événement. Par exemple, si une réunion est organisée pour discuter d'un projet particulier, lier ce projet à l'événement aide à centraliser les informations et à améliorer la coordination.
- **Gestion intégrée** : La gestion des événements devient plus intégrée avec les autres processus de l'entreprise, permettant une meilleure traçabilité et une gestion plus cohérente.

Exemple :

**Réunion de Projet** :

- **Type de document de référence** : Projet
- **Nom de la référence** : Projet 258-A

Cela signifie que la réunion est directement liée au projet "Projet 258-A", facilitant l'accès rapide aux détails du projet pendant la réunion.

::callout{color="teal" icon="i-heroicons-light-bulb"}
Dokos propose un certain nombre de champs *par défaut* dans la fiche Evénement. Vous êtes libre de cacher ceux que vous ne souhaitez pas utiliser (ex. Synchronisation Google Agenda) et d'ajouter de nouveaux champs (ex. Besoin d'équipe technique/sécurité/ménage...)
::

## 2. Inscription à un événement

Lorsque vous créez un événement public, vous pouvez permettre les inscriptions en ligne. Chaque inscription générera un document *Inscription à un événement* contenant les coordonnées de la personne qui s'est inscrite ainsi que le statut de son inscription (Confirmée / Annulée)
Vous pouvez créer une inscription manuellement depuis le bureau de Dokos si vous ne souhaitez pas permettre les inscriptions en ligne.

::tour{demo="Mappemonde" doctype="Event Registration"}
Voir des inscriptions aux événements dans la démo
::

### Permettre les inscriptions en ligne

Si le type d'événement de votre événement est **Public**, une section **Site web** apparaît en haut. Commencez par **Publier** votre événement pour le rendre visible sur le site web.
Vous avez la possibilité de définir différentes options de visibilité:

- *Tous*: Votre événement est visible à tous, utilisateurs connectés comme utilisateurs invités. Tout le monde peut y accéder depuis Internet.
- *Rôle*: Votre événement est visibile uniquement aux utilisateurs connectés ayant le rôle que vous avez choisi. Cette option est pratique pour publier des événements réservés à vos utilisateurs/clients.

### Personnaliser le formulaire d'inscription

Sans personnalisations, le formulaire d'inscription demande les informations suivantes:

- Nom
- Prénom
- Adresse email
- Numéro de mobile

Dans un certain nombre de cas, vous voudrez collecter des informations additionnelles ou même un paiement une fois le formulaire rempli. Il faut alors utiliser un formulaire web.

#### Utilisation d'un formulaire web

Un formulaire web est une version publique d'un formulaire (Type de document) de Dokos. Il reprend les champs de son document référence, mais peut être personnalisé pour n'afficher que quelques champs publiquement.

Il faut donc que nous utilisions un formulaire associé au type de document **Inscription à un événement** pour qu'une fois rempli en ligne, une **Inscription à un événement** soit automatiquement créée.

::demo-link{demo="Mappemonde" path="/app/web-form/event-registration-form"}
Un formulaire *event-registration-form* existe déjà dans Dokos. Vous pouvez l'utiliser en l'état ou le dupliquer pour le personnaliser.
::

![Cette image permet de visualiser le formulaire web pour la réservation en ligne.](https://doc.dokos.io/evenement-formulaireweb.png)

Dans ce formulaire web, vous pouvez ajouter des champs provenant de votre document de référence (via le bouton *Obtenir des champs*) et éventuellement autoriser les paiements.

::callout
Avant d'ajouter de nouveaux champs dans un formulaire web, il faut commencer par les ajouter dans le document de référence via l'outil *Personnaliser le formulaire*
::

Une fois votre formulaire configuré, publiez le pour l'activer.

### Collecter un paiement lors de la réservation

Le formulaire web permet d'activer la collecte d'un paiement à la validation du formulaire par l'utilisateur.

Dans l'onglet *Paiements*, choisissez d'activer les paiements puis sélectionnez les options correspondants à votre usage:

- Vous pouvez récupérer le montant depuis un champ *Montant de l'inscription* présent dans la fiche de l'événement.\:brCela vous permet d'utiliser le même formulaire web pour tous vos événements, même si le montant associé à chaque événement est différent.
- Le type de paiement sera probablement *Paiement immédiat* dans la majorité des cas: les inscrits paieront uniquement leur inscription et leurs coordonnées de paiement n'ont pas besoin d'être enregistrées par la plateforme de paiement pour un paiement ultérieur.\:brIl se peut cependant que certains événements ouvrent des droits supplémentaires qui nécessitent des paiements ultérieurs.\:brDans ce cas, l'option *Paiement initial suivi de paiements automatiques* peut être adaptée.

![Cette image permet de visualiser la zone pour permettre de configurer les paiements.](https://doc.dokos.io/evenement-formulaire-inscription.png)![Cette image permet de visualiser le formulaire site web pour définir les paiement sur le site.](https://doc.dokos.io/evenement-formulaire-site-web.png)

## Flux d'inscription

Voici un exemple de flux d'inscription à un événement, avec paiement.

::demo-link{demo="Mappemonde" path="/app/web-form/event-registration-form"}
Cet exemple utilise le formulaire web *event-registration-form*
::

![Flux d'inscription](https://doc.dokos.io/content/lieu/event/event_registration.gif)


# Fichier

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
🚧 Rédaction en cours 🚧
::


# Groupe Email

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
🚧 Rédaction en cours 🚧
::


# Newsletter

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
🚧 Rédaction en cours 🚧
::


# Répétition automatique

### Qu'est-ce que la répétition automatique ?

La répétition automatique est une fonctionnalité qui permet de générer automatiquement des documents à des intervalles réguliers. Cela est particulièrement utile pour des documents comme les factures récurrentes, les commandes d'achat répétées.

### Avantages de la répétition automatique

- Gain de temps : Automatiser la création de documents récurrents libère du temps pour les employés, leur permettant de se concentrer sur des tâches plus stratégiques.
- Réduction des erreurs : En automatisant les tâches répétitives, on minimise les erreurs humaines potentielles liées à la saisie manuelle des données.

### Utilisations courantes

- Factures récurrentes

Pour les entreprises qui facturent leurs clients de manière régulière, la répétition automatique peut créer des factures mensuelles ou annuelles sans intervention manuelle, assurant ainsi que les paiements sont demandés en temps voulu.

- Commandes d'achat

Les répétitions automatiques peuvent être configurées pour générer des commandes d'achat récurrentes pour les fournisseurs, garantissant ainsi que les stocks sont régulièrement réapprovisionnés.

### Comment configurer une répétition automatique ?

- Créer le document initial :
  D'abord, créez le document de base que vous souhaitez répéter. Par exemple, une facture que vous devez envoyer chaque mois.
- Activer la répétition :
  Ouvrez le document que vous souhaitez automatiser.
  Cherchez l'option de "Répétition" dans le formulaire du document.

![Image permettant de visualiser la répétition dans un document.](https://doc.dokos.io/repetition-auto.png)

- Définir les paramètres de répétition :
- Intervalle : Choisissez la fréquence de la répétition (quotidienne, hebdomadaire, mensuelle, annuelle).
- Date de début : Indiquez quand la répétition doit commencer.
- Date de fin (optionnelle) : Vous pouvez également définir une date de fin pour la répétition, après laquelle les documents ne seront plus générés automatiquement.
- Sauvegarder et activer :
  Sauvegardez les paramètres et activez la répétition. Dokos créera désormais automatiquement le document aux intervalles spécifiés.

![Image permettant de visualiser la fenêtre répétition.](https://doc.dokos.io/repetition-fenetre.png)


# Regle Attribution

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
🚧 Rédaction en cours 🚧
::


# Paramètres du site web

## ➜ Options de création de site web

### Utilisation du module site web intégré dans Dokos

Dokos offre un module de création de site web intégré qui vous permet de créer et de gérer facilement votre site web directement depuis le bureau.

### Installation de **Frappe Builder**

Il est possible de bénéficier des fonctionnalités avancées de Frappe Builder. Frappe Builder est un constructeur de sites web à faible code conçu pour créer des pages web. C'est un éditeur visuel intuitif.
les clients Dokos Cloud peuvent envoyer un mail à <help@dokos.io> pour demander l'installation sur leur site.

::tour{demo="Mappemonde" doctype="website-settingsm"}
Utiliser les paramètres du site web dans la démo
::

## 1. Page d'accueil

![Cette image permet de visualiser le formulaire : Paramètre du site web.](https://doc.dokos.io/definir-la-page-d-accueil.png)

### 1.1. **Page d'Accueil**

- **Page d'accueil :** Ce champ permet de spécifier la page qui servira de page d'accueil du site web. > Vous pouvez également définir une page Web comme page de destination.
- **Préfixe de titre :** Il s'agit d'un texte optionnel qui sera affiché dans la fenêtre du navigateur avant le titre de la page. Par exemple, si vous entrez "MonEntreprise", le titre de la page d'accueil pourrait apparaître comme "MonEntreprise- Titre de la page".

### 1.2. **Page de connexion**

- **Nom de l'application :** C'est le nom de l'application qui sera affiché sur la page de connexion. Ici. Vous pouvez y indiquer le nom de votre entreprise.
- **Logo de l'application :** Permet de joindre un logo qui sera affiché sur la page de connexion.
- **Désactiver les inscriptions :** En cochant cette case, vous empêchez les nouveaux utilisateurs de s'inscrire eux-mêmes. Les nouveaux utilisateurs devront être enregistrés manuellement par les administrateurs du système.
- **Afficher le pied de page à la connexion :** Si cette case est cochée, le pied de page du site sera affiché sur la page de connexion.

### 1.3. **Thème**

- **Thème du Site Web :** Ce menu déroulant permet de choisir le thème graphique du site web. Le thème peut être personnalisé pour correspondre à l'identité visuelle de votre entreprise.

![Cette image permet de visualiser la section : Thème du site Web.](https://doc.dokos.io/theme-du-site-web.png)

::tour{demo="Mappemonde" doctype="website-theme"}
Créer un thème du site web dans la démo
::

#### 1.3.1. **Configuration du thème**

- **Thème :**\* Nom du thème : Donnez un nom à votre thème pour le reconnaître facilement, par exemple "Thème Entreprise Moderne".
- **Police Google Font :**\* Sélectionnez une police Google Font appropriée pour votre site. Par exemple, "Roboto", "Open Sans" ou "Lato".
- **Taille de la police :**\* Définissez une taille de police par défaut, comme "16px" ou "14px".
- **Propriétés de la police :**\* Vous pouvez garder les propriétés actuelles ou les ajuster en fonction des styles de votre police choisie. Exemple : "wght\@300;400;500;600;700;800".> Les propriétés de la police permettent de définir différents niveaux d'épaisseur pour le texte. Les valeurs typiques pour le poids de la police (weight) vont de 100 (très fin) à 900 (très épais).
- **Boutons :**\* Permet de personnaliser l'esthétique des boutons.
- Couleurs1) &#x2A;*Couleurs :**\* Choisissez des couleurs de texte, généralement un gris foncé ou noir pour une bonne lisibilité, par exemple, "#333333".

#### 1.3.2. **Feuille de style**

- **Ecrasements de style personnalisés**

Vous pouvez utiliser cette section pour ajouter des styles CSS personnalisés qui écraseront les styles par défaut du thème.

- **SCSS personnalisé**

Si vous préférez utiliser SCSS pour une gestion plus avancée des styles, vous pouvez ajouter des styles SCSS dans cette section.

- **Inclure le thème de l'application**

Vous pouvez voir les différentes applications pour lesquelles le thème sera appliqué. Assurez vous de cocher toutes les applications pertinentes pour que le thème soit cohérent à travers tous les modules de votre site

::callout
Rendez-vous sur la page [**Thème du site web**](https://doc.dokos.io/v5/dodock/fonctionnalites/site-web/theme-site-web) de la documentation.
::

#### 1.3.3. **Script**

- Cette section vous permet d'ajouter du JavaScript personnalisé à votre thème. Le JavaScript peut être utilisé pour ajouter des interactions dynamiques, améliorer l'expérience utilisateur et intégrer des fonctionnalités supplémentaires sur votre site web.

## 2. Barre de navigation

![Cette image permet de visualiser le formulaire : Barre de navigation.](https://doc.dokos.io/barre-de-navigation.png)

### 2.1. **Marque**

1. **Logo :** Vous pouvez télécharger une image de logo pour votre site. L'image doit avoir une largeur d'environ 150px avec un fond transparent pour une meilleure intégration visuelle.
2. **Image de l'application :** Vous pouvez joindre une image pour l'icône de l'application.
3. **Marque HTML :** Vous pouvez ajouter du code HTML personnalisé qui sera affiché en tant que marque sur votre site web. Par exemple, vous pouvez inclure des balises pour styliser du texte ou intégrer d'autres éléments HTML.
4. **Favicon :** Téléchargez un favicon pour votre site. Un favicon est une petite icône qui apparaît dans l'onglet du navigateur. Assurez-vous que le fichier est au format .ico et que sa taille est de 16x16 px ou 32x32 px.

### 2.2. **Barre de navigation**

1. **Articles de la barre supérieure :**\* Cette section vous permet de définir les éléments de menu qui apparaîtront dans la barre de navigation supérieure.
2. **Options de la barre de navigation :**\* &#x2A;*Cacher le bouton de connexion :** Cochez cette case pour masquer le bouton de connexion dans la barre de navigation.


   - **Inclure la recherche dans la barre du haut :** Cochez cette case pour inclure une barre de recherche dans la navigation supérieure.
   - **Voir le sélecteur de langue :** Cochez cette case pour afficher un sélecteur de langue dans la barre de navigation, permettant aux utilisateurs **non connectés** de changer la langue du site car le logiciel utilise automatiquement la langue définie pour les utilisateurs connectés.

### 2.3. **Modèle de barre de navigation**

1. **Modèle de barre de navigation :**\* Sélectionnez un modèle prédéfini pour la barre de navigation. Cela peut inclure différents styles et dispositions de menu.Exemple : Seconde barre de navigation
2. **Appel à l'action :**\* &#x2A;*Appel à action :** Vous pouvez ajouter un bouton d'appel à l'action dans la barre de navigation. Ce bouton incite les utilisateurs à entreprendre une action spécifique, comme s'inscrire à une newsletter, télécharger un document, ou acheter un produit.


   - **URL d'appel à action :** Spécifiez l'URL vers laquelle le bouton d'appel à l'action redirigera les utilisateurs.

### 2.4. **Bannière**

1. **Bannière HTML :**\* Vous pouvez ajouter du code HTML pour créer une bannière personnalisée qui sera affichée au-dessus de la barre de navigation principale. Cela peut être utilisé pour des annonces, des promotions ou d'autres messages importants.

Vous pouvez écrire n'importe quel balisage HTML et Bootstrap 4 valide ici.

```html
<div style="margin-left: var(--web-sidebar-width);">
    <div class="alert alert-warning border border-warning m-2">
        Nous sommes fermés du 1er au 20 août.
    </div>
</div>
```

```js
document.addEventListener('DOMContentLoaded', function() {
    alert('Bienvenue sur notre site web !');
});
```

## 3. Pied de page

![Cette image permet de visualiser le formulaire : Pied de page.](https://doc.dokos.io/pied-de-page.png)

Cette section permet de définir les liens et les éléments qui apparaissent dans le pied de page de votre site web.

### 3.1. &#x2A;*Éléments du Pied de page :**

- **Étiquette :** Le texte qui sera affiché pour chaque élément dans le pied de page. Par exemple, "Contactez-nous" et "Blog".
- **URL :** Le lien vers lequel chaque étiquette redirigera l'utilisateur. Par exemple, "contact" et "blog".

### 3.2. **Détails du pied de page**

Cette section vous permet d'ajouter des informations supplémentaires et des détails spécifiques pour le pied de page.

- **Droit d'auteur :**\* Texte de droit d'auteur à afficher dans le pied de page, par exemple, "Mon entreprise".
- **Logo du pied de page :**\* &#x2A;*Joindre :** Vous permet de télécharger un logo spécifique qui apparaîtra dans le pied de page.
- **Masquer le formulaire d'inscription dans le pied de page :**\* &#x2A;*Case à cocher :** En cochant cette option, vous masquez le formulaire d'inscription qui pourrait sinon apparaître dans le pied de page.
- **Adresse :**\* Vous pouvez entrer l'adresse physique ou d'autres informations de contact.
- **Pied de page "Propulsé par" :**\* Vous pouvez entrer du texte ou un lien qui indique par qui le site est propulsé ou développé.

## 4. Intégrations

![Cette image permet de visualiser le formulaire : Intégration.](https://doc.dokos.io/integration.png)

Cette section vous permet de configurer divers outils d'intégration pour votre site web, notamment les outils d'analyse et les paramètres de suppression de compte.

### 4.1. **Analytique**

- **Activer le suivi des actions sur site web dans l'application :** Cochez cette case pour activer le suivi des actions des utilisateurs sur votre site web. Cela vous permet de collecter des données sur la manière dont les utilisateurs interagissent avec votre site, ce qui peut être utile pour l'amélioration continue de l'expérience utilisateur.
- **Activer l'indexation Google :** Cochez cette case pour permettre à Google d'indexer votre site web. Cela rendra votre site visible dans les résultats de recherche Google.
- **ID Google Analytics :** :callout[Cette fonctionnalité n'est plus disponible depuis le 01/07/2024. N'hésitez pas à prendre contact avec le support pour plus de renseignements.]{color="Red" icon="i-material-symbols-brand-awareness"}

### 4.2. **Paramètres de suppression du compte**

- **Supprimer automatiquement le compte au bout de (heures) :**\* Spécifiez le délai (en heures) après lequel les comptes utilisateurs seront automatiquement supprimés. Par exemple, si vous entrez "72", les comptes seront supprimés après 72 heures d'inactivité ou selon la politique de suppression que vous avez définie.
- **Afficher un lien pour la suppression du compte dans la page Mon Compte :**\* Cochez cette case pour afficher un lien permettant aux utilisateurs de supprimer leur compte depuis la page "Mon Compte". Cela donne aux utilisateurs le contrôle sur la suppression de leurs propres comptes.

## 5. En-têtes, Robots

Cette section permet d'ajouter du code HTML et des directives pour les robots des moteurs de recherche. C'est une partie importante pour la gestion du référencement (SEO) et l'intégration de certains services externes.

## 6. Redirections

La section Redirections vous permet de configurer des redirections d'URL sur votre site web. Les redirections sont essentielles pour gérer les changements de structure de votre site, les pages supprimées ou déplacées, et pour améliorer l'expérience utilisateur en s'assurant que les visiteurs et les moteurs de recherche sont automatiquement redirigés vers les nouvelles URL appropriées.

Si vous migrez votre site Web existant vers un site Web basé sur Dokos, vous pouvez mapper vos anciens itinéraires vers les nouveaux ici et ces redirections seront récupérées par Google et vous aideront à maintenir votre classement SEO.

## 7. Créer une page d'inscription personnalisée

En ajoutant un lien vers un formulaire web personnalisé dans le champ "Formulaire d'inscription personnalisé", vous remplacez le formulaire d'inscription standard par ce formulaire personnalisé.

Pour que cela fonctionne correctement, il faut que votre formulaire web soit lié au type de document Utilisateur et qu'il contienne au moins les champs suivants:

- `email`: Email
- `first_name`: Prénom

Assurez-vous également que votre formulaire est publié et que l'option **Autoriser les modifications** est cochée.

## 8. En savoir plus sur l'intégrations Google

### 8.1. Indexation Google

Comment configurer l'indexation Google automatisée Afin de permettre à Dokos de demander aux robots d'indexation de Google d'indexer une page Web, vous devez autoriser Dokos à envoyer une demande chaque fois que l'utilisateur demande les données.

L'intégration de Google Drive est configurée avec les étapes suivantes :

- Créer des informations d'identification OAuth 2.0 via les paramètres Google
- Activer l'indexation dans les paramètres du site Web
- Cliquez maintenant sur Autoriser l'accès à l' indexation API pour autoriser Dokos à envoyer une demande de publication.

Une fois Autorisé, une demande d'indexation est automatiquement envoyée lors de la création/mise à jour/corbeille de tout nouvel article de blog ou page Web créé via l'utilisateur.

### 8.2. Google Analytics

Vous pouvez activer Google Analytics sur votre site Web.

Obtenez simplement votre identifiant Google Analytics à partir de votre console Google.

Par défaut, Google Analytics recueillera l'adresse IP complète des visiteurs de votre site Web. En cochant "Google Analytics Anonymize IP", Dokos demandera à Google Analytics d'anonymiser l'adresse IP avant qu'elle ne soit envoyée aux serveurs de Google. Vous pouvez en savoir plus sur l'effet de ce paramètre dans la documentation de Google.


# Page web

## ➜ Options de création de site web

### Utilisation du module site web intégré dans Dokos

Dokos offre un module de création de site web intégré qui vous permet de créer et de gérer facilement votre site web directement depuis le bureau.

### Installation de **Frappe Builder**

Il est possible de bénéficier des fonctionnalités avancées de Frappe Builder. Frappe Builder est un constructeur de sites web à faible code conçu pour créer des pages web. C'est un éditeur visuel intuitif.
les clients Dokos Cloud peuvent envoyer un mail à <help@dokos.io> pour demander l'installation sur leur site.

## 1. Pré-requis

- Voir la configuration des paramètres du site web.

## 2. Création d'une nouvelle page Web

### 2.1. Contenu

![Cette image permet de visualiser le formulaire : Nouvelle page web.](https://doc.dokos.io/page-web.png)

1. **Titre** :

- Champ obligatoire où vous devez entrer le titre de votre page. Le titre est extrêmement important pour les moteurs de recherche, choisissez donc un titre qui inclut les mots-clés pertinents. Ce titre sera utilisé pour générer l'URL par défaut de la page.

2. **Route** :

- Permet de définir l'URL personnalisée de la page. Si laissé vide, une route sera automatiquement générée basée sur le titre.

3. **Chemin Dynamique** :

- Option à cocher si vous souhaitez utiliser des variables dynamiques dans l'URL.

Exemple de route dynamique : `/project/<name>`, où `<name>` est une variable qui changera en fonction des données.

4. **Publié** :

- Cochez cette case pour publier la page immédiatement après l'enregistrement. Si cette option n'est pas cochée, la page sera sauvegardée comme brouillon.

5. **Connexion requise** :

- Cochez cette case si l'accès à la page nécessite que l'utilisateur soit connecté.

6. **Module (pour l'export)** :

- Sélectionnez le module dans lequel la page sera exportée.

#### 2.1.1. Section Contenu

1. **Type de Contenu** :

- Sélectionnez un type de format pour construire votre bloc.
  ![Cette image permet de visualiser le menu déroulant pour définir un format de création de contenu dans le formulaire nouvelle page web.](https://doc.dokos.io/type-de-contenu-page-web.png)

- **Modèle dynamique** : Utilisez cette option si vous souhaitez baser votre page sur un modèle dynamique.

2. **Constructeur de page :**

**Blocs de construction de page** :

- Permet d'ajouter un modèle de bloc web à la page. Vous pouvez choisir parmi plusieurs types de blocs prédéfinis (comme des cartes de produits, des listes d'articles de blog, etc.).

> Vous pouvez créer vos propres modèles de page web.

- **Modifier les valeurs** : Après avoir ajouté un bloc, personnaliser le contenu et les paramètres du bloc.

### 2.2. Scripts

![Cette image permet de visualiser le formulaire : nouvelle page web et plus précisément la partie scripts.](https://doc.dokos.io/script-page-web.png)

#### 2.2.1. Contexte

**Script de contexte :**

- Ce champ en python vous permet de définir des scripts de contexte qui seront exécutés avant le rendu de la page web. Cela est utile pour préparer ou manipuler des données avant qu'elles ne soient affichées.

#### 2.2.2. Script

**JavaScript :**

- Ce champ vous permet d'ajouter des scripts JavaScript personnalisés à votre page web. Le JavaScript ajouté ici peut être utilisé pour ajouter des interactions dynamiques, améliorer l'expérience utilisateur, ou intégrer des fonctionnalités supplémentaires sur votre site web.
- Il est recommandé d'écrire votre script à l'intérieur du rappel `frappe.ready` pour s'assurer que le script est exécuté après le chargement complet de la page :

````js
     frappe.ready(() => {
     // your script here
     });
     ```text
````

### 2.3. Style

![Cette image permet de visualiser l'onglet : Style du formulaire page web.](https://doc.dokos.io/style-page-web.png)

**Insérer du style**

- Cochez cette case pour activer l'insertion de styles CSS personnalisés sur la page web. Si cette option n'est pas cochée, les styles ajoutés ne seront pas appliqués.

**Aligner le texte**

- Utilisez l'option d'alignement du texte pour définir comment le texte doit être aligné sur la page, que ce soit à gauche, au centre, ou à droite.

**CSS**

- Utilisez ce champ pour ajouter du code CSS personnalisé. Le CSS ajouté ici sera appliqué à la page web, vous permettant de styliser et de personnaliser l'apparence de la page selon vos besoins.

  - Exemple de CSS :
  ````js
    body {
    background-color: #f5f5f5;
    font-family: 'Lato', sans-serif;
    }\:brh1 {
    color: #6F2B51;
    text-align: center;
    }\:brp {
    font-size: 16px;
    line-height: 1.5;
    }\:br.btn-primary {
    background-color: #6F2B51;
    border-radius: 0.25rem;
    }\`\`\`text\`\`\`text\`\`\`text```text

  ````

**Largeur complète**

- Cochez cette case pour utiliser la largeur complète de l'écran pour votre page web. Cette option est utile si vous souhaitez que votre contenu s'étende sur toute la largeur de l'écran.

**Afficher le titre**

- Cochez cette case pour afficher le titre de la page sur la page web. Si cette option n'est pas cochée, le titre de la page ne sera pas visible sur la page.

### 2.4. Paramètres

![Cette image permet de visualiser l'onglet : Paramètres dans le formulaire, page web.](https://doc.dokos.io/parametres-page-web.png)

1. **Dates de publication** :

- Utilisez cette section pour planifier la publication et la dépublication de la page automatiquement. Cela est utile pour les annonces temporaires, les événements, etc.

2. **Meta tags** :

- Remplissez les champs de titre et de description pour améliorer le référencement de votre page. Ajoutez une image pour enrichir l'aperçu de la page lors du partage sur les réseaux sociaux. Ajouter des étiquettes meta personnalisées supplémentaires. Ces étiquettes peuvent inclure des informations comme des mots-clés, des auteurs, etc.

3. **Barre latérale** :

- Activez et configurez la barre latérale pour offrir une navigation supplémentaire ou des fonctionnalités additionnelles à vos visiteurs.

4. **Commentaires** :

- Activez les commentaires pour permettre aux utilisateurs d'interagir et de laisser des retours sur votre page.

### En-tête et fil d'Ariane

#### En-tête

- Utilisez ce champ pour ajouter du code HTML personnalisé qui sera affiché dans la section d'en-tête de votre page web. Cela peut inclure du texte, des images, des liens, ou tout autre élément HTML.

#### Fil d'Ariane

- Le fil d'Ariane montre la hiérarchie de navigation et permet aux utilisateurs de savoir où ils se trouvent sur le site.
- Utilisez ce champ pour ajouter des éléments de fil d'Ariane qui seront affichés en haut de la page pour aider les utilisateurs à naviguer.

![Cette image permet de visualiser un exemple de fil d'ariane.](https://doc.dokos.io/fil-d-ariane.png)![Cette image permet de visualiser le fil d'ariane sur le site.](https://doc.dokos.io/fil-d-ariane-plus.png)


# Thème du site web

## 1. **Thème**

::tour{demo="Mappemonde" doctype="website-theme"}
Créer un thème de site web dans la démo.
::

![Cette image permet de visualiser la section : Thème du site Web.](https://doc.dokos.io/theme-du-site-web.png)

### 1.1. **Configuration du thème**

**Thème :**

- Nom du thème : Donnez un nom à votre thème pour le reconnaître facilement, par exemple "Thème Entreprise Moderne".

**Police Google Font :**

- Sélectionnez une police Google Font appropriée pour votre site. Par exemple, "Roboto", "Open Sans" ou "Lato".

**Taille de la police :**

- Définissez une taille de police par défaut, comme "16px" ou "14px".

**Propriétés de la police :**

- Vous pouvez garder les propriétés actuelles ou les ajuster en fonction des styles de votre police choisie.

> Exemple : "wght\@300;400;500;600;700;800".> Les propriétés de la police permettent de définir différents niveaux d'épaisseur pour le texte. Les valeurs typiques pour le poids de la police (weight) vont de 100 (très fin) à 900 (très épais).

**Boutons :**

- Permet de personnaliser l'esthétique des boutons.

**Couleurs :**

- Choisissez des couleurs de texte, généralement un gris foncé ou noir pour une bonne lisibilité, par exemple, "#333333".

### 1.2. **Feuille de style**

![Cette image permet de visualiser le formulaire : Feuille de style.](https://doc.dokos.io/feuille-de-style-theme-du-site.png)

- **Ecrasements de style personnalisés**

Vous pouvez utiliser cette section pour ajouter des styles CSS personnalisés qui écraseront les styles par défaut du thème.

Exemple : Redéfinir la largeur maximale du conteneur

```text
$container-max-widths: (
  sm: 540px,
  md: 720px,
  lg: 960px,
  xl: 1140px
);
```

- **SCSS personnalisé**

Si vous préférez utiliser SCSS pour une gestion plus avancée des styles, vous pouvez ajouter des styles SCSS dans cette section.

Exemples :

- Personnalisation des liens :

```text
a {
  color: #6F2B51; 
}

a:hover {
  color: darken(#6F2B51, 10%); 
}
```

- Personnalisation des boutons :

```text
.btn-primary {
    background-color: $teal;
    color: $orange;
}
```

- **Inclure le thème de l'application**

Vous pouvez voir les différentes applications pour lesquelles le thème sera appliqué. Assurez vous de cocher toutes les applications pertinentes pour que le thème soit cohérent à travers tous les modules de votre site.

> Utilisation de [**Bootstrap 4**]{style="color:blue;"} : Bibliothèque de styles CSS et JavaScript open-source qui facilite la création de sites web réactifs et modernes

### 1.3. **Script**

![Cette image permet de visualiser le formulaire : Script.](https://doc.dokos.io/script-theme-du-site.png)

- Cette section vous permet d'ajouter du JavaScript personnalisé à votre thème. Le JavaScript peut être utilisé pour ajouter des interactions dynamiques, améliorer l'expérience utilisateur et intégrer des fonctionnalités supplémentaires sur votre site web.

Exemple : Pour afficher une fenêtre de bienvenue

```js
document.addEventListener('DOMContentLoaded', function() {
    alert('Bienvenue sur notre site web !');
});
```

::callout
**Remarque** : Assurez-vous de choisir le thème que vous avez créé dans les paramètres du site Web pour l'appliquer.
::

### 2. Fichiers de thème inclus

Si vous jetez un œil au thème par défaut généré par la boîte de dialogue de configuration, il importe frappe/public/scss/websiteet erpnext/public/scss/website. Ce sont les fichiers de thème par défaut pour frappeet erpnextapp. Si vous avez installé d'autres applications, elles peuvent également fournir leur propre website.scssfichier.

La section "Fichiers de thème inclus" répertorie toutes les applications installées. Chaque application peut apporter son propre fichier de thème ( [app] /public/scss/website.scss). Un thème peut être complet, fournissant des styles pour l'ensemble du site Web, ou simplement un module complémentaire. Par exemple, il peut styliser uniquement les éléments qu'il introduit. En cochant les cases, vous pouvez choisir quel thème doit être inclus dans votre site Web.

###


# Formulaires web

## 1. Dans quels cas utiliser un formulaire Web :

- **Inscriptions** : Utilisé pour s'inscrire à des événements, des newsletters, des services en ligne, etc.
- **Enquêtes** : Permet de recueillir des opinions, des retours d'expérience
- **Traitement des candidatures** : Permet de collecter et de trier les candidatures pour des emplois ou du bénévolat.
- **Formulaires de demande** : Pour des demandes de support technique, des demandes de remboursement, etc.

## 2. Avantages des formulaires Web :

- **Efficacité et gain de temps** : Les formulaires Web permettent d'automatiser la collecte de données, réduisant ainsi le besoin de saisie manuelle et minimisant les erreurs humaines.
- **Accessibilité** : Disponibles 24/7.
- **Structuration des données** : Les données collectées via des formulaires Web sont généralement bien structurées, facilitant leur analyse et leur traitement.
- **Personnalisation** : Les formulaires Web peuvent être personnalisés pour répondre aux besoins spécifiques de votre entreprise.

## 3. Formulaire Web et type de document

::tour{demo="Mappemonde" doctype="web-form"}
Créer un formulaire Web dans la démo
::

![Cette image de visualiser les formulaires web par défaut dans le système.](https://doc.dokos.io/module-formulaire-web.png)

::callout
Pour créer votre formulaire web, vous devez utiliser un type de document. Vous pouvez soit utiliser un type de document existant, comme "Inscription à un événement", soit en créer un nouveau.
::

![Cette image permet de visualiser la sélection de type de document dans le formulaire web.](https://doc.dokos.io/selectionner-un-type-de-document.png)

## 4. Créer un nouveau type de document

::tour{demo="Mappemonde" doctype="doctype"}
Créer un type de document Web dans la démo
::

![Cette image permet de visualiser les formulaires : Type de document](https://doc.dokos.io/module-type-de-document.png)

1. Accéder à la création d'un type de document

- Allez dans le module **Personnalisation > Type de document** .

2. Configurer le type de document

![Cette image de visualiser le formulaire permettant de créer un nouveau type de document.](https://doc.dokos.io/new-doctype.png)

- Entrez le nom du type de document et sélectionnez le module approprié.
- Cochez l'option : Formulaire personnalisé.

3. Ajouter les Champs au type de document

![Cette image permet de visualiser : Le champ donnée pour les petites informations (Nom, prénom)](https://doc.dokos.io/le-champ-donnee-pour-les-petites-informations.png)

- Une fois le type de document créé, ajoutez les champs nécessaires en spécifiant les étiquettes, les types de champs, les noms de champs, et en cochant l'option "obligatoire" pour les champs obligatoires.

![Cette image permet de visualiser :  Le champ sélection](https://doc.dokos.io/le-champ-selection.png)

> Voici la visualisation du type de document :

![Cette image permet de visualiser un aperçu du type de document.](https://doc.dokos.io/apercu-du-formulaire.png)

::callout
Pour aller plus loin, rendez-vous sur la page [**Type de document**](https://doc.dokos.io/v5/dodock/ressources/concepts/doctype) de notre documentation.
::

## 5. Créer le formulaire Web

#### 5.1. Remplir les informations générales

1. Titre :

- Entrez le titre de votre formulaire.
- Exemple : "Retour sur l'Atelier Sécurité des Machines".

2. Route :

- Laissez ce champ vide si vous ne souhaitez pas définir une URL spécifique pour votre formulaire. Dokos générera une URL automatiquement.

3. Sélectionner un type de document :

- Choisissez le type de document que vous avez créé.
- Exemple : Retour Atelier Securite Machines.

4. Module :

- Sélectionnez le module dans lequel le formulaire sera enregistré.
- Exemple : Module central.

5. Est un formulaire standard :

- Laissez cette option décochée si vous souhaitez utiliser des personnalisations spécifiques pour ce formulaire.

6. Introduction :

Ajoutez une introduction pour les utilisateurs.

- Exemple : "Merci de remplir ce formulaire pour nous donner votre avis sur l'atelier de sécurité des machines que vous avez suivi."

7. Champs de formulaire web :

- Cliquez sur : Obtenir le champs.

8. Pied de page :

- Ajoutez un texte de pied de page si nécessaire.
- Exemple : "Merci pour votre participation !"

#### 5.2. Configuration des Paramètres du Formulaire Web

1. Connexion obligatoire :

- Connexion obligatoire : Cochez cette option si vous souhaitez que les utilisateurs se connectent avant de pouvoir remplir le formulaire. Cela est utile si vous voulez restreindre l'accès aux utilisateurs enregistrés.

2. Anonyme :

- Anonyme : Cochez cette option si vous souhaitez permettre des réponses anonymes. Les utilisateurs ne seront pas tenus de fournir des informations d'identification.

3. Appliquer les autorisations du document :

- Cochez cette option si vous voulez appliquer les autorisations définies dans le type de document associé au formulaire. Cela garantit que seuls les utilisateurs avec les bonnes autorisations peuvent accéder ou soumettre le formulaire.

4. Autoriser les impressions :

- Cochez cette option si vous voulez permettre aux utilisateurs d'imprimer le formulaire rempli.

5. Autoriser les formulaires incomplets :

- Cochez cette option si vous voulez permettre aux utilisateurs de soumettre le formulaire même si certains champs obligatoires ne sont pas remplis. Cela peut être utile dans certains cas où des informations partiellement remplies sont acceptables.

6. Taille Maximum des pièces jointes :

- Indiquez la taille maximale des fichiers que les utilisateurs peuvent joindre au formulaire. Par exemple, entrez 5 pour permettre des pièces jointes jusqu'à 5 Mo.

7. Filtres :

- Si vous avez plusieurs formulaires Web pour un même type de document, vous pouvez ajouter des conditions spécifiques pour afficher le bon formulaire en fonction de certains critères.
- Par exemple, vous pouvez filtrer par année ou par toute autre condition définie dans le Doctype.

8. Paramètres de la barre latérale

- Afficher la barre latérale : Cochez cette option si vous souhaitez afficher une barre latérale avec des informations ou des liens supplémentaires lorsque les utilisateurs remplissent le formulaire.

#### 5.3. Configuration des personnalisations du formulaire Web

1. Libellé du bouton de validation

- Libellé du bouton de validation : Entrez le texte que vous souhaitez afficher sur le bouton de soumission du formulaire.
- Par exemple, "Envoyer".

2. Image de la bannière

- Image de la bannière : Cliquez sur "Joindre" pour télécharger une image de bannière qui sera affichée en haut du formulaire.

3. Après envoi du formulaire

- Titre en cas de succès : Entrez le titre qui sera affiché lorsque le formulaire sera soumis avec succès. Par exemple, "Merci pour votre retour !".

4. Lien de succès

- Lien de succès : Entrez l'URL vers laquelle vous souhaitez rediriger les utilisateurs après la soumission réussie du formulaire. Cela pourrait être une page de remerciement ou une page de confirmation.

5. Message de succès

- Message de succès : Entrez le message qui sera affiché après la soumission réussie du formulaire.
- Par exemple, "Votre soumission a été enregistrée avec succès. Nous vous contacterons bientôt."

6. Meta

- Meta-titre : Entrez un titre pour les métadonnées du formulaire. Cela peut aider pour le référencement et les aperçus des liens.
- Meta image : Cliquez sur "Joindre" pour télécharger une image qui sera utilisée comme vignette pour les aperçus des liens.
- Metadescription : Ajoutez une description pour les métadonnées du formulaire. Cela apparaîtra dans les résultats de recherche et les aperçus des liens pour fournir un résumé du formulaire.

7. Scripts / Style

- Script client : Ajoutez des scripts JavaScript personnalisés.
- CSS personnalisé : Ajoutez des styles CSS personnalisés pour ajuster l'apparence du formulaire.

#### 5.4. Configuration des options de paiement dans le formulaire Web

1. Accepter des paiements

- Cochez la case "Accepter des paiements" pour activer les options de paiement dans votre formulaire.

2. Passerelle de paiement

- Entrez le nom de la passerelle de paiement que vous utilisez (par exemple, Stripe, PayPal, etc.). Assurez-vous que votre passerelle de paiement est configurée dans Dokos.

3. Type de paiement

Sélectionnez le type de paiement parmi les options disponibles.

4. Montant récupéré depuis un champ

- Si vous voulez que le montant à payer soit déterminé dynamiquement en fonction d'un champ spécifique du formulaire, cochez cette case et sélectionnez le champ approprié.

5. Montant

- Entrez le montant fixe à payer si vous n'utilisez pas l'option de montant récupéré depuis un champ.

6. Étiquette du bouton

- Entrez le texte que vous souhaitez afficher sur le bouton de paiement.
- Par exemple, "Payer maintenant".

7. Aide affichée sur le bouton

- Ajoutez des instructions ou des informations d'aide qui seront affichées lorsque l'utilisateur survolera le bouton de paiement.

#### 5.5. Résultat

- Lorsque qu'un utilisateur soumet un formulaire sur le site web, les données sont enregistrées dans le type de document associé à ce formulaire.

![Cette image permet de visualiser sur le portail le formulaire web.](https://doc.dokos.io/visualiser-sur-le-site.png)


# Pages "À Propos" et "Formulaire de Contact"

## 1. Généralités

### 1.1. Paramètres de la page "A propos"

La page "À Propos" sert à fournir une vue d'ensemble de votre entreprise. Elle présente votre mission, vos valeurs et votre vision, raconte votre histoire, et introduit les membres clés de votre équipe. Elle aide à établir la confiance avec vos visiteurs. De plus, elle met en avant ce qui nous rend uniques par rapport à vos concurrents et facilite la prise de contact en fournissant vos informations de contact et des liens vers d'autres pages importantes.

### 1.2. Paramètres du "formulaire de contact"

La page "Paramètres du formulaire de contact" permet d'assurer que les visiteurs de votre site web puissent facilement vous contacter. En remplissant ces informations de manière complète et précise, vous garantissez une communication efficace et professionnelle avec vos clients et prospects.

## 2. Paramètres de la page "A propos".

::tour{demo="Mappemonde" doctype="contact-us-settings"}
Créer une page À propos dans la démo
::

![Cette image permet de visualiser le formulaire : À propos.](https://doc.dokos.io/about.png)

1. **Titre de la Page** : Vous pouvez entrer le titre de la page "À Propos".
2. **Présentation de la Société** :

- Un éditeur de texte pour entrer la présentation ou la description de la société.

3. **Histoire de la Société** :

- Un tableau pour ajouter des événements chronologiques relatifs à l'histoire de l'entreprise. Vous pouvez ajouter l'année et surligner des événements spécifiques.

4. **Membres de l'Équipe** :

- Un tableau pour ajouter les membres de l'équipe avec des colonnes pour le nom complet, un lien vers une image et une biographie.


  - Pied de page : Indiquez des éléments qui vont figurer en pied de page.

## 3. Paramètres du "formulaire de contact"

::tour{demo="Mappemonde" doctype="contact-us-settings"}
Créer une page contact dans la démo
::

![Cette image permet de visualiser le formulaire : Contact.](https://doc.dokos.io/formulaire-contact.png)

La page "Paramètres du formulaire de contact" vous permet de configurer les informations et les options de votre formulaire de contact sur votre site web.

1. **Introduction**

- **Transférer à l'Adresse email** : Entrez l'adresse email où les demandes de contact seront envoyées. Si aucune adresse n'est renseignée, la demande de contact sera envoyée dans les opportunités sur le bureau Dokos.


  - **Titre** : Par défaut, ce champ est rempli avec "Contactez-nous". Vous pouvez personnaliser ce titre selon vos besoins.
  - **Introduction** : Utilisez l'éditeur de texte pour ajouter une introduction à la page "Contactez-nous". Ce texte doit accueillir les visiteurs et les encourager à utiliser le formulaire pour toute question ou demande.

2. **Options de Requête**

- Vous pouvez spécifier les options de contact disponibles, telles que "Demande de Ventes", "Demande d'Aide", etc. Chaque option doit être sur une nouvelle ligne ou séparée par des virgules.

3. **Adresse**

- **Titre de l'Adresse** : Titre de l'adresse de votre entreprise.
- **Ville** : Nom de la ville.
- **État** : Nom de l'état ou région.
- **Code Postal** : Code postal de l'adresse.
- **Pays** : Pays de l'adresse.
- **Téléphone** : Numéro de téléphone de contact.
- **Adresse email** : Adresse email de contact.


# Blog

## 1. Paramètres

::tour{demo="Mappemonde" doctype="blog-settings"}
visualiser les paramètres du blog dans la démo.
::

![Cette image permet de visualiser le module : Paramètres du blog.](https://doc.dokos.io/parametre-du-blog.png)

Les paramètres du blog vous permettent de configurer et de personnaliser les options pour la gestion et la publication des articles de blog.

#### 1.1. Paramètres

1. **Titre du blog** :

- Le titre principal de votre blog qui sera affiché en haut de la page d'accueil du blog. Entrez un titre qui représente le thème ou l'objectif de votre blog.

2. **Introduction du blog** :

- Une brève description ou introduction qui apparaîtra en haut de la page d'accueil du blog.

3. **Image** :
   Ajouter une image.

#### 1.2. Options de configuration

1. **Connexion requise** :

- Activez cette option si vous souhaitez que les utilisateurs du portail/site web se connectent avant de pouvoir lire le blog.

2. **Autoriser le partage social** :

- Permet aux lecteurs de partager les articles de votre blog sur les réseaux sociaux.

3. **Autoriser les invités à commenter** :

- Permet aux utilisateurs non connectés de laisser des commentaires sur les articles du blog.

4. **Naviguer par catégorie** :

- Ajoute une navigation par catégorie pour organiser les articles du blog. Cochez cette case pour permettre aux lecteurs de filtrer les articles par catégorie.

5. **Afficher un "Appel à action" dans le blog** :

- Affiche un bouton d'appel à l'action dans votre blog pour encourager une action spécifique des lecteurs.


  - Cochez cette case si vous souhaitez inclure des appels à l'action (par exemple, "S'inscrire à la newsletter").
  - Exemple : Appel à Action


    - **Titre** : Rejoignez notre Communauté !
    - **Sous-titres** : Ne manquez plus aucune mise à jour et profitez d'avantages exclusifs en vous inscrivant à notre newsletter.
    - **Libellé de l'incitation à l'action** : S'inscrire Maintenant
    - **URL de l'incitation à l'action** : https\://exemple/inscription-newsletter

#### 1.3. Limites d'usage

1. **Limite de likes** :

- Définissez le nombre maximal de "likes" qu'un utilisateur portail/site web peut attribuer par heure.

2. **Limite de commentaires** :

- **Description** : Définissez le nombre maximal de commentaires qu'un utilisateur portail/site web peut laisser par heure.

## 2. Catégorie du blog

::tour{demo="Mappemonde" doctype="blog-category"}
Créer une catégorie du blog dans la démo
::

![Cette image permet de visualiser le formulaire : Catégorie du blog.](https://doc.dokos.io/categorie-du-blog.png)

Pour organiser efficacement les articles de votre blog, vous pouvez créer des catégories.

#### 2.1. Remplir le formulaire de création

1. **Publié**

- Cochez cette case pour rendre la catégorie visible sur le blog.

2. **Titre**

- Entrez le titre de la nouvelle catégorie du blog. Ce champ est obligatoire.\:br**Exemple** : "Actualités de l'Entreprise"

3. **Description**

- Ajoutez une description pour cette catégorie. Cette description peut fournir plus de détails sur le type de contenu que les visiteurs peuvent s'attendre à trouver dans cette catégorie.

4. **Image**

- Ajoutez une image représentative pour cette catégorie en cliquant sur "Joindre". Cette image peut être utilisée pour illustrer la catégorie sur votre blog.

## 3. Blogueur

::tour{demo="Mappemonde" doctype="blogger"}
Créer un blogueur dans la démo
::

![Cette image permet de visualiser le formulaire : Blogueur.](https://doc.dokos.io/blogueur.png)

Pour gérer efficacement les contributions sur votre blog, vous pouvez créer des profils de blogueurs.

#### 3.1. Remplir le formulaire de création

1. **Désactivé**

- Laissez cette case décochée si vous souhaitez que le profil du blogueur soit actif immédiatement.

2. **Nom court**:br**Nom Complet**
3. **Utilisateur**

- Sélectionnez l'utilisateur Dokos associé au blogueur.

4. **Biographie**

- Fournissez une biographie pour le blogueur, donnant plus de détails sur ses compétences, ses intérêts et ses contributions.

5. **Avatar**

- Ajoutez une image de profil pour le blogueur.

## 4. Article de blog

::tour{demo="Mappemonde" doctype="blog-post"}
Créer un article de blog dans la démo
::

![Cette image permet de visualiser le formulaire pour créer un nouvel article de blog.](https://doc.dokos.io/new-article-blog.png)

#### 4.1. Remplir le formulaire de création

1. **Titre**

- Entrez le titre de l'article de blog.\:br**Exemple** : "Découvrez notre Nouveau Tiers Lieu"

2. **Catégorie du blog**

- Sélectionnez la catégorie à laquelle l'article appartient.

3. **Blogueur**

- Sélectionnez le blogueur qui écrit l'article.

4. **Route**

- L'URL de l'article. Laissez ce champ vide pour que Dokos le génère automatiquement.

5. **Intro du blog**

- Une introduction ou un résumé de l'article.\:br**Exemple** : "Rejoignez-nous pour découvrir notre nouveau tiers lieu, un espace de collaboration et de créativité."

6. **Description pour la page de recherche**

- Une courte description pour la page de résultats de recherche, en texte brut.\:br**Exemple** : "Découvrez notre espace collaboratif dédié à la créativité et à l'innovation."

7. **Type de Contenu**

- Sélectionnez le format de contenu (Markdown, texte riche ou HTLM).

8. **Contenu**

- Rédigez votre article.

#### 4.2. Options supplémentaires

1. **Mis en avant**

- Cochez cette case pour mettre l'article en avant sur le blog.

2. **Cacher le bouton d'incitation à l'action**

- Cochez si vous ne souhaitez pas afficher le bouton d'appel à l'action.

3. **Autoriser les notifications par email**

- Envoie des notifications par email pour les nouveaux commentaires ou likes.

4. **Désactiver les commentaires**

- Cochez si vous ne souhaitez pas permettre les commentaires.

5. **Désactiver les 'likes'**

- Cochez si vous ne souhaitez pas permettre les likes.

#### 4.3. Meta tags

Les balises méta sont des balises HTML qui décrivent une page et son contenu à un moteur de recherche ou à une plate-forme de médias sociaux.

1. **Meta-titre**

- Titre pour les moteurs de recherche.
  **Exemple** : "Nouveau Tiers Lieu - Espace Collaboratif et Créatif"

2. **Meta image**

- Image pour les moteurs de recherche et les partages sociaux.

3. **Meta description**

- Description pour les moteurs de recherche.

**Exemple** : "Découvrez notre nouveau tiers lieu, un espace de collaboration et de créativité pour entrepreneurs et créatifs."

> Si vous laissez cette section vide, l'introduction du blog ou les 140 premiers caractères du blog seront affichés comme méta description. De la même manière, si vous laissez la méta image vide, la première image du blog sera sélectionnée.

#### 4.4. Vérifier l'aperçu de la publication

Lors de la soumission du blog, vous pouvez également prévisualiser à quoi ressemblera le blog lorsqu'il sera partagé sur une plate-forme de médias sociaux comme Facebook ou Twitter. Pour le vérifier, utilisez les outils de débogage proposés par les plateformes :

- **Facebook** : Débogueur de partage
- **Twitter** : validateur de carte
- **LinkedIn** : inspecteur de poste

Pour vérifier l'aperçu de la publication, entrez simplement le lien page Web/blog dans l'outil :

En utilisant ces outils, vous pouvez optimiser votre article de blog pour le partage.


# Articles Aide

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
🚧 Rédaction en cours 🚧
::


# Portail

## 1. Avantages du portail

**1.1. Accès centralisé aux informations :**

Permet aux utilisateurs d'accéder facilement à toutes les informations pertinentes, telles que les projets, les commandes, les factures, les devis, etc., à partir d'un seul endroit.

**1.2. Interface personnalisable :**

Les administrateurs peuvent personnaliser le portail pour qu'il corresponde aux besoins spécifiques de leur organisation, en ajoutant ou en supprimant des éléments de menu, en modifiant les routes et en configurant les rôles.

**1.3. Interaction client :**

Permet aux clients de suivre leurs commandes, de consulter leurs factures, de soumettre des demandes de support et d'accéder à d'autres services pertinents.

**1.4. Support et documentation :**

Fournit un accès direct à des articles d'aide, des forums, et des tickets de support, facilitant ainsi la résolution de problèmes et la recherche d'informations.

**1.5. Transparence et suivi :**

Les utilisateurs peuvent suivre l'avancement de leurs demandes, commandes, et projets en temps réel, offrant ainsi une meilleure transparence.

![Cette image permet de visualiser le formulaire : Portail.](https://doc.dokos.io/portail-barre-laterale.png)

## 2. Paramètres du Portail

2.1. **Rôle attribué par défaut au moment de l'inscription**

- Vous pouvez définir ici le rôle qui sera automatiquement attribué aux nouveaux utilisateurs lorsqu'ils s'inscrivent sur le portail. Cliquez sur le champ pour sélectionner un rôle parmi ceux disponibles .

> Si aucun rôle n'est attribué, le rôle par défaut sera : Client

2.2. **Page d'accueil par défaut du portail**

- Ce champ vous permet de définir la page qui sera affichée par défaut lorsque les utilisateurs se connectent au portail. Pour obtenir le portail en page d'accueil définissez la route avec `/me`.

Par exemple, vous pouvez définir la route `/app` ou toute autre page que vous avez créée, telle que `/home`, etc.

2.3. Configurer le menu standard

> Le menu standard est mis à jour régulièrement. Si vous souhaitez garder le contrôle sur votre menu, utilisez le menu personnalisé. Vous pouvez utiliser les éléments présents dans la barre standard et les intégrer dans votre barre personnalisée en utilisant les routes qui vous intéressent.

- Vous pouvez activer ou désactiver des éléments du menu standard en cochant ou décochant les cases dans la colonne **Activé**. Vous pouvez de manière plus simple : &#x2A;*Masquer le Menu standard.**\* Modifiez les routes, les types de documents et les rôles associés aux différents éléments du menu.

![Cette image permet de visualiser le menu de la barre latérale.](https://doc.dokos.io/portail-section.png)

Voici les différentes possibilités de pages disponibles :

|    |                         |        |                      |                                 |             |
| -- | ----------------------- | ------ | -------------------- | ------------------------------- | ----------- |
| N° | Titre                   | Activé | Route                | Type de document de référence   | Rôle        |
| 1  | Événements              | ✔      | /events              | Événement                       | Client      |
| 2  | Projets                 | ✔      | /project             | Projet                          | Client      |
| 3  | Demande de devis        | ✔      | /rfq                 | Appel d'offre                   | Fournisseur |
| 4  | Devis fournisseur       | ✔      | /supplier-quotations | Devis Fournisseur               | Fournisseur |
| 5  | Commandes d'achat       | ✔      | /purchase-orders     | Commande fournisseur            | Fournisseur |
| 6  | Factures d'achat        | ✔      | /purchase-invoices   | Facture d'achat                 | Fournisseur |
| 7  | Devis                   | ✔      | /quotations          | Devis                           | Client      |
| 8  | Commandes               | ✔      | /orders              | Commande client                 | Client      |
| 9  | Factures                | ✔      | /invoices            | Facture de vente                | Client      |
| 10 | Livraisons              | ✔      | /shipments           | Bon de livraison                | Client      |
| 11 | Problèmes               | ✔      | /issues              | Ticket                          | Client      |
| 12 | Adresses                | ✔      | /addresses           | Adresse                         | Client      |
| 13 | Feuilles de temps       | ✔      | /timesheets          | Feuille de temps                | Client      |
| 14 | Newsletter              | ✔      | /newsletters         | Newsletter                      | Client      |
| 15 | Demande de matériel     | ✔      | /material-requests   | Demande de matériel             | Client      |
| 16 | Réservations            | ✔      | /bookings            | Réservation d'articles          | Client      |
| 17 | Réservations de créneau | ✔      | /event-slots         | Inscription à un poste bénévole | Bénévole    |
| 18 | Prise de rendez-vous    | ✔      | /book\_appointment   |                                 | Client      |
| 19 | Abonnements             | ✔      | /subscriptions       | Abonnement                      | Client      |

Voici un exemple : Events

![Cette image permet de visualiser un exemple pour la barre latérale standard.](https://doc.dokos.io/portail-ex-barre-laterale.png)

2.4. **Personnaliser la barre latérale**

![Cette image permet de visualiser la zone permettant de personnaliser le barre latérale](https://doc.dokos.io/portail-barre-perso.png)

- Dans la section **Barre latérale personnalisée**, ajoutez ou supprimez des éléments en fonction de vos besoins.
- Définissez les routes et les types de documents pour chaque élément.5.

2.5. **Créer des pages personnalisées**

- Allez dans le module **Site web** et sélectionnez **Pages Web**.Créez une nouvelle page en définissant son titre, sa route, et en ajoutant le contenu souhaité.Paramètres de la page web. Cochez la case : Afficher la barre latérale pour permettre à la barre latérale de rester visible lorsque l'on clique sur le lien.

![Cette image permet de visualiser le formulaire : Page Web / Paramètres](https://doc.dokos.io/page-web-pour-portail.png)

2.6. **Ajouter des liens de menu personnalisés**

- Allez dans **Paramètres du portail** et ajoutez des éléments dans la **Barre Latérale Personnalisée** pour lier les nouvelles pages web que vous avez créées.


# Donnees Personnelles

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
🚧 Rédaction en cours 🚧
::


# Espaces Travail

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
🚧 Rédaction en cours 🚧
::


# Tableau de bord

Le tableau de bord offre une vue d'ensemble des principaux indicateurs de performance pertinents pour le processus métier.

Chaque tableau de bord se compose d'un ou de plusieurs graphiques de tableau de bord, chacun d'eux étant configuré avec une source de données appelée Source de graphique de tableau de bord.

Pour accéder au **tableau de bord**, allez sur :

> Accueil > Personnalisation > Tableaux de bord > Tableau de bord

## 1. Comment créer un nouveau tableau de bord

1. Allez dans la liste des tableaux de bord et cliquez sur Nouveau.
2. Entrez le nom du module pour lequel vous souhaitez voir le tableau de bord.
3. Entrez les graphiques du tableau de bord que vous souhaitez paramétrer pour ce tableau de bord.
4. Enregistrer.

Lorsque vous cliquez sur **Voir le tableau de bord**, vous pourrez voir le tableau de bord donnant la représentation graphique de vos transactions.

## 2. Ajout de graphiques au tableau de bord

Ajoutez des graphiques à ce tableau de bord en sélectionnant des graphiques existants Dashboard Chartou en en créant de nouveaux.

Enregistrez les modifications et cliquez sur le bouton pour voir le tableau de bord.

## 3. Création d'un nouveau graphique de tableau de bord

Pour créer un nouveau tableau de bord, accédez à

> Accueil > Personnalisations > Tableaux de bord > Tableau de bord> Nouveau

Donnez un nom au graphique, il apparaîtra dans le tableau de bord en tant qu'étiquette du graphique et sélectionnez comme source de données pour ce graphique.

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Remarque : Le nouveau grapgique ne peut être créé que par l'utilisateur administrateur en mode développeur.
::

## 4. Utilisation des tableaux de bord

Chaque graphique sera affiché en fonction des champs définis dans le tableau de bord correspondant. Le résultat de la source du graphique de tableau de bord est mis en cache pour éviter les requêtes redondantes. Étant donné que les données du graphique peuvent être obsolètes, chaque graphique affichera également la dernière heure synchronisée.

Les filtres utilisés pour générer les données du graphique peuvent également être modifiés en cliquant sur **Définir les filtres**. Le graphique sera actualisé automatiquement en fonction des filtres récemment définis.

Pour obtenir les données les plus récentes, chaque graphique doit être actualisé avec force en cliquant sur le bouton **Forcer l'actualisation** dans le menu déroulant.


# Graphiques Tableau Bord

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
🚧 Rédaction en cours 🚧
::


# Cartes Statistiques

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
🚧 Rédaction en cours 🚧
::


# Onboarding

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
🚧 Rédaction en cours 🚧
::


# Vue Calendrier

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
🚧 Rédaction en cours 🚧
::


# Console Systeme

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
🚧 Rédaction en cours 🚧
::


# Cartes de résumé

Les cartes de résumé sont des widgets d'espace de travail qui permettent d'accéder rapidement à des listes filtrées de documents.

![Titre: Facture de vente. Bouton: Créer. Section: Février. Brouillon: 2, En Retard: 4, Impayé: 0. Section: Documents liés. Commandes: 95 à facturer, Paiements: 31 en attente. Séparateur. Lien vers: Compte Stripe. Lien vers: Documentation (Intranet). Texte libre: Contactez Alice pour plus d'informations sur la facturation des clients.](https://doc.dokos.io/content/customizations/workspace/carte-de-resume.png)

## Filtrage

Le filtrage des documents se fait à l'aide d'une liste de filtres, précisée sous la forme d'un code Python

```python
[
    ["docstatus", "=", 0],  # Les documents au statut de Brouillon
    ["modified", ">=", last_month],  # Et modifiés lors des 30 derniers jours
]
```

Tous les éléments qui sont contenus à l'intérieur d'une Section ont accès à une variable spéciale appelée `parent_filters` qui permettent de reprendre rapidement la liste des filtres de la Section. En dehors de ce cas d'usage, ajouter des filtres sur une Section ne sert à rien.

```python
parent_filters + [["docstatus", "=", 0]]
```

## Cartes publiques, filtrage avancé, libellés dynamiques

Si vous êtes Responsable Système, vous avez accès à plus de fonctionnalités en créant des **cartes publiques**.
Lorsqu'une carte est marquée comme publique, elle peut contenir des filtrages plus avancés ainsi que des libellés dynamiques.
De plus, une carte publique est accessible à tous les utilisateurs. Cependant, les documents qui ne sont pas accessibles à l'utilisateur connecté ne seront pas décomptés.

### Filtrage avancé

Une carte publique donne accès à la variable `frappe` et toutes ses fonctionnalités, de la même manière que dans un Script Serveur ou un filtre de Notification.

```python
[
    ["allocated_to", "=", frappe.session.user],
    ["company", "=", frappe.db.get_default("company", frappe.session.user) or "Dokompany"],
    ["price_list", "=", frappe.db.get_single_value("Selling Settings", "selling_price_list")],
]
```

### Libellés dynamiques

Les libellés dynamiques s'écrivent sous la forme d'une expression Python placées entre deux paires d'accolades.

```jinja
{{ frappe.utils.format_date(frappe.utils.now(), "MMMM").capitalize() }}
```


# Visites Guidées

## Visite guidée d'un type de documents

::callout{icon="i-heroicons-light-bulb" to="https://doc.dokos.io/#"}
En savoir plus sur la notion de **Type de document**
::

## Visite guidée d'un espace de travail

::callout{icon="i-heroicons-light-bulb" to="https://doc.dokos.io/#"}
En savoir plus sur la notion d'**Espace de travail**
::

## Visite guidée d'une page

::callout{icon="i-heroicons-light-bulb" to="https://doc.dokos.io/#"}
En savoir plus sur la notion de **Page**
::


# Recherche globale

La barre de recherche globale est accessible depuis n'importe quelle page du bureau via le raccourci **Ctrl+G** (ou **Cmd+G** sur Mac) ou en cliquant sur l'icône de recherche dans la barre de navigation.

Elle permet de trouver et d'ouvrir en une frappe :

- Des **documents** (clients, factures, articles…)
- Des **types de formulaire** (pour accéder à la liste ou créer un nouveau document)
- Des **espaces de travail**
- Des **rapports** et **tableaux de bord**
- Des **pages** du bureau
- Des **actions rapides** (créer un document, ouvrir la boîte de réception…)

## Icônes contextuelles dans les résultats :badge{text="Dodock" type="warning"}

Dodock enrichit chaque résultat de recherche avec une icône qui identifie visuellement la nature du résultat :

| Type de résultat                  | Icône              |
| --------------------------------- | ------------------ |
| Document récent                   | Fichier texte      |
| Type de formulaire (liste)        | Liste              |
| Type de formulaire (arborescence) | Liste hiérarchique |
| Tableau de bord                   | Tableau            |
| Page                              | Image              |
| Rapport                           | Tableau            |
| Espace de travail                 | Grille             |
| Créer un document                 | Cercle +           |
| Boîte de réception email          | Boîte de réception |
| Calendrier                        | Calendrier         |
| Pages restreintes                 | Cadenas            |

Ces icônes permettent de distinguer d'un coup d'œil un document d'une action ou d'une vue, sans lire entièrement le libellé du résultat.

::demo-link{demo="Dokompany" path="/app"}
Ouvrir la démo et utiliser Ctrl+G pour tester la recherche globale
::

## Pour les développeurs d'applications

Les icônes sont générées dans `frappe/public/js/frappe/ui/toolbar/search_utils.js` via la fonction `make_icon()`. Chaque type de résultat possède un branchement dédié qui choisit l'icône Lucide correspondante.

Pour que les documents d'un DocType personnalisé bénéficient d'une icône dans les résultats de recherche, configurez le champ **Icône** sur le formulaire **Type de document**. L'icône apparaîtra dans les résultats "Documents récents" et dans les suggestions de type de formulaire.

Les DocTypes sans icône configurée s'affichent avec l'icône fichier texte générique.

## Voir aussi

- [Espaces de travail](https://doc.dokos.io/v5/dodock/fonctionnalites/bureau/espaces-travail)
- [Champs de formulaire](https://doc.dokos.io/v5/dodock/fonctionnalites/personnalisations/champs-formulaire)


# Contact

Un contact peut être associé à un prospect, un client, un fournisseur, un actionnaire, un partenaire commercial ou un utilisateur.

Vous pouvez également ajouter un contact en tant qu'enregistrement autonome sans le lier à l'une des entités répertoriées ci-dessus.

---

Pour accéder à la liste de **contacts**, allez sur :

> Accueil > CRM > Pipeline des ventes > **Contact**

## 1. Comment créer un contact

1. Allez dans la liste des contacts et cliquez sur ➕ Ajouter contact.
2. Remplir les différents champs pour complèter la fiche :

   - Prénom
   - Nom
   - Utilisateur du site
   - Adresse
   - Salutation
   - Désignation
   - Genre
   - Nom de la société

Vous pouvez aussi synchroniser les contatcs avec Google.

## 2. Caractéristiques

### 2.1 Lier un contact à plusieurs entités

- Un contact peut être lié à plusieurs clients ou à plusieurs fournisseurs.
- Un contact peut également être lié aux clients et aux fournisseurs en même temps.

Cochez la case **Principal**, pour que le contact soit le contact principal.

### 2.2 Inviter le contact en tant qu'utilisateur

Vous pouvez autoriser les contacts de vos clients et fournisseurs à se connecter à votre système Dokos et à consulter les données les concernant. Consultez le portail client pour plus de détails à ce sujet. Vous pouvez envoyer une invitation par e-mail à un contact en cliquant sur le bouton «Inviter en tant qu'utilisateur».


# Genres

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
🚧 Rédaction en cours 🚧
::


# Salutation

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
🚧 Rédaction en cours 🚧
::


# Adresses

Vous pouvez enregistrer les adresses associées à un prospect, un client, un fournisseur, un actionnaire, un partenaire commercial ou un entrepôt.

Vous pouvez également ajouter une adresse en tant qu'enregistrement autonome sans la lier à l'une des entités répertoriées ci-dessus.

---

Pour accéder à la liste d'adresses, accédez à:

> Accueil > CRM > **Adresse**

## 1. Comment créer une adresse

1. Allez dans la liste d'adresses et cliquez sur ➕ Ajouter adresse.
2. **Remplir les différents pour complèter la fiche** :

- Sélectionnez le type d'adresse.
- Entrez les détails dans la **ligne d'adresse 1**, la **ligne d'adresse 2**, la **ville**, le **code postal**, l'état, le pays.
- Saisissez l'**adresse e-mail**, le **téléphone** et le **fax**.
- Séléectionnez la catégorie de taxe.
- Adresse de **Facturation Principale**, cochez la case si oui
- Adresse de **Livraison Principale**, cochez la case si oui.
- Désactivé, cochez la case si vous voulez désactiver l'adresse.
- **Enregistrer**.

![créer\_adresse.png](https://doc.dokos.io/content/crm/address/creer_adresse.png)

Pour importer plusieurs adresses à partir d'une feuille de calcul, utilisez l'outil d'importation de données .

# 2. Caractéristiques

## 2.1 Lier une adresse à plusieurs entités

Une adresse peut être liée à plusieurs clients ou à plusieurs fournisseurs.

Une adresse peut également être liée aux clients et aux fournisseurs en même temps.

## 2.2 Titre de l'adresse

Si l'adresse n'est liée à aucune entité, vous devez ajouter manuellement un titre.

Si l'adresse est liée à une entité comme un client ou un fournisseur, le titre est généré automatiquement au format «Nom d'entité-Type d'adresse».

## 2.3 Adresse de facturation et adresse de livraion préférées

Si vous cochez **Adresse de livraison préférée**, l'adresse sera automatiquement ajoutée dans l'adresse de livraison dans les transactions **Commande client**, **Facture vente** et **Bon de livraison**.

De même, si vous cochez **Adresse de facturation préférée**, l'adresse sera automatiquement ajoutée dans l'adresse de facturation dans les transactions **Commande client**, **Facture vente** et **Bon de livraison**.

## 2.4 Référence

Si vous souhaitez relier cette adresse à un tiers vous pouvez le sélectionner en ajoutant une ligne. Ce tiers peut-être un Prospect, Client, Fournisseur etc.

1. Sélectionner le **Type de document lié**.
2. **Nom du lien** : Nom du tiers.
3. **Titre du lien** : Un lien est généré.

# Modèle d'adresse


# Espace de travail

## 1 . Espace De travail

Lorsque vous vous connectez à Dokos, la page de Bureau s'affiche. Elle comprend une barre latérale permanente, organisée par catégories. Chaque élément de cette barre latérale mène à une page appelée Espace de travail.

Un espace de travail correspond à un module spécifique. Il est composé des éléments suivants :

- Une section Tableau de bord dédiée au module en question.
- Une section de raccourcis pour accéder rapidement aux éléments fréquemment utilisés. Une section regroupant des fonctionnalités.

### 1.1. Espace de travail standard

Chaque module de Dokos est doté d'un espace de travail standard, préconfiguré avec des raccourcis et des liens adaptés.

Vous pouvez personnaliser cet espace de travail à l'aide de l'option Personnaliser l’espace de travail, disponible dans le coin supérieur droit de chaque espace de travail.

::callout
Remarque : ces personnalisations seront spécifiques à l’utilisateur et ne seront visibles que par cet utilisateur.
::

### 1.2. Espace de travail personnalisable

[Visualiser l'espace de travail de l'onglet Performance](https://tierslieux.dokos.io/app/workspace/Performance){rel="&#x22;nofollow&#x22;"}

Vous avez la possibilité de créer vos propres espaces de travail en ajoutant simplement un nouveau document d'espace de travail ou en modifiant l'espace déjà existant.


# Page

🚧 Rédaction en cours 🚧


# Rapport

🚧 Rédaction en cours 🚧


# Type De Document

🚧 Rédaction en cours 🚧


# PaymentController v2 — Architecture des passerelles de paiement

Cette page s'adresse aux **développeurs** qui souhaitent créer ou intégrer une passerelle de paiement compatible avec l'interface `PaymentController` (version 2) introduite dans `frappe/payments`.

---

## Contexte

Jusqu'à présent, les passerelles de paiement dans Dokos suivaient une interface dite **v1** : chaque intégration implémentait sa propre logique d'initialisation de session et de retour de paiement, directement dans le code de la Demande de paiement.

L'interface **v2** (`PaymentController`) centralise cette logique dans l'application `payments` et expose un contrat clair via `PaymentController.initiate()`. La Demande de paiement délègue entièrement à cette classe dès qu'elle détecte une passerelle v2.

---

## Détection automatique de la version

Lors de la validation d'une Demande de paiement, Dokos appelle `_is_v2_gateway(payment_gateway)` pour déterminer quelle branche exécuter :

- **v2 détecté** → `_process_v2_gateway()` est appelé
- **v1 ou fallback** → comportement legacy inchangé

La détection repose sur `payments.utils.is_v2_gateway()`. Si l'application `payments` ne dispose pas de cette fonction (version ancienne), le système bascule silencieusement en mode v1.

::mermaid
flowchart TD
A\[Demande de paiement soumise] --> B{Canal = Phone ?}
B -- Oui --> C\[Flux téléphone legacy]
B -- Non --> D{\_is\_v2\_gateway ?}
D -- Oui --> E\[\_process\_v2\_gateway]
D -- Non --> F\[Flux legacy v1]
E --> G\[PaymentController.initiate]
G --> H\[Payment Session Log créé]
H --> I\[payment\_url défini]
F --> J\[URL passerelle v1]

::

---

## Implémenter une passerelle v2

Pour qu'une passerelle soit reconnue comme v2, elle doit :

1. **Être déclarée v2** dans `payments.utils.is_v2_gateway()` — cette logique est gérée côté application `payments`.
2. **Hériter de `PaymentController`** (depuis `payments.controllers.payment_controller`) et implémenter la méthode `initiate(tx_data)`.

### Méthode `initiate(tx_data)`

Cette méthode reçoit un dictionnaire `TxData` et doit :

- Créer un **Payment Session Log** dans Frappe
- Retourner un objet contenant au minimum `payment_url` (l'URL vers laquelle le client sera redirigé)

---

## Structure de `TxData`

Lors d'une demande de paiement v2, Dokos construit un objet `TxData` via `get_tx_data()`. Voici les champs transmis :

| Champ               | Valeur                             | Description                      |
| ------------------- | ---------------------------------- | -------------------------------- |
| `reference_doctype` | `Payment Request`                  | Type du document de référence    |
| `reference_docname` | Nom de la Demande de paiement      | Identifiant unique de la demande |
| `payer_name`        | Nom du tiers (client/fournisseur)  | Nom affiché au payeur            |
| `payer_email`       | Email du contact                   | Email du payeur                  |
| `amount`            | Résultat de `get_request_amount()` | Montant partiel ou total         |
| `currency`          | Devise de la demande               | ISO 4217                         |
| `contact`           | Champs contact filtrés             | Voir ci-dessous                  |
| `address`           | Champs adresse filtrés             | Voir ci-dessous                  |

::callout{icon="i-heroicons-information-circle"}
**Montant partiel** : `get_request_amount()` est utilisé (et non `grand_total`) afin de prendre en charge les scénarios de **paiement partiel**. Une facture peut faire l'objet de plusieurs demandes de paiement successives.
::

::callout{icon="i-heroicons-information-circle"}
**Référence** : `reference_doctype` pointe vers `Payment Request` (et non la facture ou la commande sous-jacente) car c'est la Demande de paiement qui gère les callbacks et la réconciliation comptable.
::

### Champs contact transmis

Seuls les champs pertinents pour le paiement sont transmis (pas le document Contact complet) :

- `email_id`
- `mobile_no`
- `phone`

### Champs adresse transmis

- `address_line1`
- `address_line2`
- `city`
- `state`
- `pincode`
- `country`

---

## Exemple d'implémentation

Voici la structure minimale d'une passerelle v2 :

```python
from payments.controllers.payment_controller import PaymentController

class MaPasserelleController(PaymentController):

    def initiate(self, tx_data: dict) -> dict:
        """
        Initialise une session de paiement.

        Args:
            tx_data: Dictionnaire TxData fourni par Dokos.

        Returns:
            dict avec au minimum 'payment_url'.
        """
        # 1. Créer la session côté passerelle externe
        session = self._create_remote_session(
            amount=tx_data["amount"],
            currency=tx_data["currency"],
            customer_email=tx_data["contact"].get("email_id"),
        )

        # 2. Créer le Payment Session Log dans Frappe
        self.create_payment_session_log(
            reference_doctype=tx_data["reference_doctype"],
            reference_docname=tx_data["reference_docname"],
            session_id=session.id,
        )

        # 3. Retourner l'URL de paiement
        return {"payment_url": session.checkout_url}
```

---

## Compatibilité ascendante

Les passerelles v1 existantes **ne sont pas affectées**. Le code de la Demande de paiement vérifie d'abord si la passerelle est v2 avant toute modification de comportement. En l'absence de l'application `payments` dans la version requise, le système bascule automatiquement sur le flux v1.

---

## Dépendances

Cette fonctionnalité nécessite :

- `frappe/payments` avec le support `PaymentController` ([PR #192](https://github.com/frappe/payments/pull/192){rel="&#x22;nofollow&#x22;"})
- Dokos ≥ version incluant cette MR

---

## Voir aussi

- [Passerelles de paiement](https://doc.dokos.io/v5/dokos/comptabilite/passerelles-paiements) — configuration des passerelles dans l'interface
- [Demande de paiement](https://doc.dokos.io/v5/dokos/ventes/demande-de-paiement) — utilisation côté métier


# Inclure un champ dans le modèle d'import

La propriété **Inclure dans le modèle d'import** (`in_import_template`) permet de définir quels champs d'un formulaire sont pré-cochés par défaut dans la fenêtre de sélection des colonnes lors du téléchargement d'un modèle d'import ou de l'export de données.

> **Exemple — Bureau Moderne**
> L'administrateur de Bureau Moderne configure le formulaire Fournisseur pour que les champs "Nom du fournisseur", "Groupe de fournisseurs" et "Pays" soient toujours pré-cochés à l'ouverture du modèle d'import. Ses collègues n'ont plus à chercher ces colonnes dans la liste : elles apparaissent directement sélectionnées, prêtes à être exportées.

## À quoi sert cette propriété ?

Lorsqu'un utilisateur ouvre la fenêtre de téléchargement du modèle d'import (ou d'export de données), il voit une liste de cases à cocher correspondant aux champs du formulaire. Sans configuration particulière, aucun champ n'est coché par défaut et l'utilisateur doit sélectionner manuellement chaque colonne souhaitée.

En activant **Inclure dans le modèle d'import** sur un champ, celui-ci sera automatiquement coché à l'ouverture de la fenêtre, guidant ainsi les utilisateurs vers les colonnes les plus pertinentes pour leur flux de travail.

## Comment configurer cette propriété ?

Deux méthodes sont disponibles selon votre situation.

### Via Personnaliser le formulaire (sans code)

Cette méthode convient pour les formulaires existants que vous souhaitez adapter sans modifier le code source.

1. Allez dans **Personnaliser le formulaire** (Paramètres > Personnalisation > Personnaliser le formulaire).
2. Sélectionnez le **Type de document** concerné (ex. : Client, Fournisseur, Article).
3. Dans la liste des champs, trouvez le champ à configurer et développez ses propriétés.
4. Cochez l'option **Inclure dans le modèle d'import**.
5. Cliquez sur **Mettre à jour**.

### Via la définition du DocField (dans le code)

Pour les développeurs qui créent ou modifient un type de document dans le code de l'application :

```python
# Extrait d'un fichier .json de DocType
{
    "fieldname": "supplier_group",
    "fieldtype": "Link",
    "label": "Groupe de fournisseurs",
    "options": "Supplier Group",
    "in_import_template": 1
}
```

La propriété `in_import_template` accepte `1` (inclus) ou `0` (non inclus, valeur par défaut).

## Comportement détaillé

::mermaid
flowchart TD
A\[Utilisateur ouvre la fenêtre\nd'import/export] --> B{Action choisie}
B --> |Télécharger modèle vierge\nInsertion| C\[Champs avec in\_import\_template\npré-cochés\nChamp ID masqué si numérotation auto]
B --> |Exporter des données| D\[Champs avec in\_import\_template\npré-cochés\nChamp ID toujours présent\nOption Modèle vierge masquée]
C --> E\[Utilisateur ajuste\nla sélection si besoin]
D --> E
E --> F\[Téléchargement du fichier]

::

| Contexte                               | Comportement                                                                                                            |
| -------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
| Téléchargement d'un modèle d'insertion | Les champs configurés sont pré-cochés. Le champ ID est masqué si l'identifiant est attribué automatiquement.            |
| Export de données existantes           | Les champs configurés sont pré-cochés. Le champ ID est toujours présent. L'option "Modèle vierge" n'est pas disponible. |
| Champ obligatoire                      | Signalé par un astérisque (\*) dans la liste.                                                                           |
| Champ conditionnel                     | Signalé par une icône d'avertissement avec une info-bulle expliquant la condition d'affichage.                          |

## Points d'attention

- Pré-cocher un champ ne le rend pas obligatoire dans le fichier : l'utilisateur peut toujours décocher un champ avant de télécharger.
- Cette propriété n'a pas d'effet sur les imports effectués par API ou script — elle s'applique uniquement à l'interface graphique de la fenêtre de sélection des colonnes.
- Les champs masqués ou en lecture seule ne peuvent pas être inclus dans le modèle d'import, indépendamment de cette propriété.


# Rapports préparés

Les **rapports préparés** (*Prepared Reports*) permettent d'exécuter des rapports volumineux en arrière-plan et de consulter les résultats une fois le traitement terminé, sans bloquer l'interface utilisateur.

## Fonctionnement général

Lorsqu'un rapport basé sur un script (*Script Report*) met trop de temps à s'exécuter, Dodock peut l'activer automatiquement en mode « rapport préparé ». Un observateur surveille la durée d'exécution et, si elle dépasse **15 secondes**, bascule automatiquement le rapport en mode préparé.

::mermaid
sequenceDiagram
participant U as Utilisateur
participant D as Dodock
participant Q as File d'attente
U->>D: Lance le rapport
D->>D: Exécution du script
alt Durée > 15 secondes
D->>D: Active le mode préparé automatiquement
D->>Q: Planifie l'exécution en arrière-plan
Q-->>U: Notifie quand le rapport est prêt
else Durée ≤ 15 secondes
D-->>U: Affiche le résultat directement
end

::

## Option : désactiver l'automatisation du rapport préparé

Pour certains rapports, le basculement automatique en mode préparé n'est pas souhaitable — par exemple si le rapport doit toujours s'exécuter en temps réel, ou si l'activation automatique pose des problèmes dans un contexte personnalisé.

Depuis la version **15**, chaque rapport dispose d'un champ dédié :

| Champ                                          | Nom technique                        | Description                                                                                               |
| ---------------------------------------------- | ------------------------------------ | --------------------------------------------------------------------------------------------------------- |
| Désactiver l'automatisation du rapport préparé | `disable_prepared_report_automation` | Si coché, l'observateur de 15 secondes n'activera jamais automatiquement le mode préparé pour ce rapport. |

::callout{color="blue" icon="i-mdi-information"}
Ce champ remplace l'ancien `disable_prepared_report` utilisé dans les versions précédentes. Une migration automatique (`copy_disable_prepared_report_to_prepared_report`) copie la valeur de l'ancien champ vers le nouveau lors de la mise à jour.
::

### Configurer l'option via l'interface

1. Accédez à **Paramètres → Rapport** (ou recherchez le nom du rapport dans la barre de recherche).
2. Ouvrez la fiche du rapport concerné.
3. Dans la section **Paramètres**, cochez **Désactiver l'automatisation du rapport préparé**.
4. Enregistrez.

Une fois cette option activée, le rapport ne passera jamais automatiquement en mode préparé, quelle que soit sa durée d'exécution.

### Configurer l'option par code

Si vous gérez vos rapports via des fichiers JSON (typique dans le développement d'applications), ajoutez le champ dans le fichier `.json` du doctype Report :

```json
{
  "disable_prepared_report_automation": 1
}
```

Ou dans un patch ou un script de migration Python :

```python
import frappe

frappe.db.set_value(
    "Report",
    "Nom du rapport",
    "disable_prepared_report_automation",
    1
)
frappe.db.commit()
```

## Migration depuis l'ancien champ

Si votre instance utilisait `disable_prepared_report` (champ désormais obsolète), la mise à jour vers la version 15 exécute automatiquement un patch qui :

1. Identifie tous les rapports ayant `disable_prepared_report = 1`.
2. Copie cette valeur dans `disable_prepared_report_automation = 1`.

Aucune action manuelle n'est requise de votre part.

## Cas d'usage recommandés

| Situation                                                                     | Recommandation                                            |
| ----------------------------------------------------------------------------- | --------------------------------------------------------- |
| Rapport rapide (< 15 s) utilisé en temps réel                                 | Laisser l'automatisation active (comportement par défaut) |
| Rapport lent accepté par les utilisateurs en arrière-plan                     | Laisser l'automatisation active                           |
| Rapport dont le mode préparé cause des problèmes fonctionnels                 | Cocher **Désactiver l'automatisation**                    |
| Rapport toujours destiné à s'exécuter en temps réel, quelle que soit la durée | Cocher **Désactiver l'automatisation**                    |

::callout{color="orange" icon="i-mdi-alert"}
**Attention** : Désactiver l'automatisation sur un rapport lent peut dégrader l'expérience utilisateur, car l'interface sera bloquée pendant toute la durée d'exécution. Évaluez cette option avec soin.
::


# Ressources

::callout{color="teal" icon="i-heroicons-light-bulb"}
🚧 Rédaction en cours 🚧
::


# API de documents

L'API de documents donne accès aux instances de types de documents Dodock. :br
Chaque instance est dérivée de la classe `frappe.model.Document` et représente une entrée unique dans la table correspondante de la base de données.

## frappe.get\_doc

### frappe.get\_doc(doctype, name)

Renvoie un object de type `Document` pour une entrée identifiée par un type de document et un nom. :br
Si le type de document est Unique, le nom n'est pas requis.

```python
# Obtenir un document existant
doc = frappe.get_doc('Task', 'TASK00002')
doc.title = 'Test'
doc.save()

# Obtenir un document unique
doc = frappe.get_doc('System Settings') # Vous pouvez aussi utilise frappe.get_single('System Settings')
doc.timezone # Asia/Kolkata
```

### frappe.get\_doc(dict)

Renvoi en mémoire un nouvel object de type `Document` qui n'existe pas encore dans la base de données.

```python
# Création d'un nouveau Document
doc = frappe.get_doc({
    'doctype': 'Task',
    'title': 'New Task'
})
doc.insert()
```

### frappe.get\_doc(doctype={document\_type}, key1 = value1, key2 = value2, ...)

Renvoi en mémoire un nouvel objet de type `Document` qui n'existe pas encore dans la base de données.

```python
# Crée un nouvel object avec des arguments sous forme de clé/valeur
user = frappe.get_doc(doctype='User', email_id='test@example.com')
user.insert()
```

## frappe.get\_cached\_doc

Similaire à `frappe.get_doc`, mais cherche d'abord le document dans le cache avant de requêter la base de données.

## frappe.new\_doc

`frappe.new_doc(doctype)`

Méthode alternative pour créer un nouveau `Document`.

```python
# Crée un nouveau Document
doc = frappe.new_doc('Task')
doc.title = 'New Task 2'
doc.insert()
```

## frappe.delete\_doc

`frappe.delete_doc(doctype, name)`

Supprime les entrées et les entrées enfant associées de la base de données. :br
Supprime également d'autre documents liés comme les Communication, Commentaires, etc...

```python
frappe.delete_doc('Task', 'TASK00002')
```

## frappe.rename\_doc

`frappe.rename_doc(doctype, old_name, new_name, merge=False)`

Renomme un document (modification de la clé primaire). :br
Si l'option `merge=True` et qu'un document existe déjà avec le nouveau nom, le document renommé sera fusionné avec le document existant.

```python
frappe.rename_doc('Task', 'TASK00002', 'TASK00003')
```

::warning
Le renommage ne sera autorisé que si l'option correspondante est activée dans le formulaire du type de document correspondant.
::

## frappe.get\_meta

`frappe.get_meta(doctype)`

Renvoi les métadonnées associées à un type de document. :br
Renvoi également pour les champs personnalisés et les propriétés personnalisées.

```python
meta = frappe.get_meta('Task')
meta.has_field('status') # True
meta.get_custom_fields() # [field1, field2, ..]
```

Pour obtenir le document original, sans champs personnalisés ou propriétés personnalises, utilisez `frappe.get_doc('DocType', doctype_name)`

## Méthodes de document

Cette section liste les méthodes communes disponibles dans un objet de type `Document`.

### doc.insert

Cette méthode insert un nouveau document dans la table de la base de données. :br
Elle déclenche la vérification des autorisations utilisateur et exécute les méthodes `before_insert`, `validate`, `on_update`, `after_insert` si elles présentes dans le contrôleur.

Des *flags* permettent de ne pas déclencher certaines vérification.

```python
doc.insert(
    ignore_permissions=True, # ignore la validation des autorisations de l'utilisateur
    ignore_links=True, # ignore la validation des liens présents dans le document
    ignore_if_duplicate=True, # n'insère pas le document si un document avec un identifiant identique existe déjà
    ignore_mandatory=True # insère même si certains champs obligatoires ne sont pas remplis
)
```

### doc.save

Cette méthode enregistrte les changements apportés à un document existant. :br
Elle déclenche la vérification des autorisations utilisateur et exécute les méthodes `validate` avant la mise à jour et `on_update` après la mise à jour des valeurs.

```python
doc.save(
    ignore_permissions=True, # ignore les autorisations de l'utilisateur
    ignore_version=True # ne crée pas de document de Version pour cette mise à jour
)
```

### doc.delete

Supprime l'entrée du document de la table de la base de données. :br
Cette méthode est un alias pour `frappe.delete_doc`

```python
doc.delete()
```

### doc.get\_doc\_before\_save

Renvoi la version du document avant les modifications qui viennent d'être effectuées. :br
Vous pouvez l'utiliser pour comparer ce qui a été modifié depuis la denière version.

```python
old_doc = doc.get_doc_before_save()
if old_doc.price != doc.price:
    # le prix a changé
    pass
```

### doc.reload

Requête les dernières valeurs dans la base de données et mets à jour l'état du document.
Quand vous travaillez avec un document, il peut arriver qu'une autre fonction dans le code mette à jour des valeurs dans ce document directement dans la base de données. Dans ce cas vous pouvez utiliser cette méthode pour recharger le document.

```python
doc.reload()
```

### doc.check\_permission

Renvoi une erreur si l'utilisateur de la session n'a pas les autorisations pour le type d'autorisation demandé.

```python
doc.check_permission(permtype='write') # Renvoi une erreur si l'utilisateur n'a pas les droits d'écrire sur ce document
```

### doc.get\_title

Obtenez le titre du document sur la base de la métadonnée `title_field` ou d'un champ appelé `title` ou `name`.

```python
title = doc.get_title()
```

### doc.notify\_update

Publie un événement en temps réel pour indiquer que le document a été modifié. :br
Des gestionnaires d'événement côté client réagissent à cet événement et mettent à jour le formulaire.

```python
doc.notify_update()
```

### doc.db\_set

Inscrit la value d'un champ du document directement dans la base de données et mets à jour la date et heure de modification.

::warning
Cette méthode ne déclenche pas de validations de contrôleur et doit être utilisée avec attention.
::

```python
# Mets à jour la valeur dans la base de données, mets à jour l'horodatage du document
doc.db_set('price', 2300)

# Mets à jour la valeur dans la base de données et déclenche doc.notify_update()
doc.db_set('price', 2300, notify=True)

# Mets à jour la valeur dans la base de données et déclenche frappe.db.commit()
doc.db_set('price', 2300, commit=True)

#Mets à jour la valeur dans la base de données sans mettre à jour l'horodatage
doc.db_set('price', 2300, update_modified=False)
```

### doc.get\_url

Renvoie l'URL vers ce document. Ex.`/app/task/TASK00002`

```python
url = doc.get_url()
```

### doc.add\_comment

Ajoute un commentaire au document. Le commentaire sera visible dans la chronologie de la vue de formulaire.

```python
# Ajoute un simple commentaire
doc.add_comment('Comment', text='Test Comment')

# Ajoute un commentaire de type 'Edit/Modification'
doc.add_comment('Edit', 'Values changed')

# Ajoute un commentaire de type 'Shared/Partagé'
doc.add_comment("Shared", "{0} a partagé ce document avec tout le monde".format(user))
```

### doc.add\_seen

Ajoute l'utilisateur actif/donné à la liste des utilisateurs ayant vu ce document. :br
Cette méthode mets à jour la colonne `_seen` de la table et stocke les données au format JSON.

```python
# Ajoute John à la liste des utilisateurs ayant vu le document
doc.add_seen('john@doe.com')

# Ajoute l'utilisateur actif à la liste des utilisateurs ayant vu le document
doc.add_seen()
```

::warning
Cette méthode ne fonctionne que `Suivre les vues de document` est activé dans le type de document.
::

### doc.add\_viewed

Ajoute une entrée au journal des vues quand un utilisateur voit le document (ouvre le formulaire).

```python
# Ajoute une entrée dans le journal des vues pour l'utilisateur John
doc.add_viewed('john@doe.com')

# Ajoute une entrée dans le journal des vues pour l'utilisateur actif
doc.add_viewed()
```

::warning
Cette méthode ne fonctionne que si "Suivre les vues de document" est activé pour ce type de document.
::

### doc.run\_method

Exécute une méthode si elle définie dans le contrôleur et déclenche également les hooks correspondants.

```python
doc.run_method('validate')
```

### doc.queue\_action

Exécute une méthode de contrôleur en tâche de fons. :br
Si la méthode a une fonction interne, comme `_submit` pour `submit`, cette fonction interne sera appelée à la place.

```python
doc.queue_action('send_emails', emails=email_list, message='Howdy')
```


# API Base de données

## frappe.db.get\_list

`frappe.db.get_list(doctype, filters, or_filters, fields, order_by, group_by, start, page_length)`

- Vous pouvez également utiliser l'alias `frappe.get_list`

Retourne une liste de document d'une table de `doctype`. Il s'agit d'un habillage pour une requête `SELECT`.
Prend également en compte les autorisations de l'utilisateur de la session.

```python
frappe.db.get_list('Task',
    filters={
        'status': 'Open'
    },
    fields=['subject', 'date'],
    order_by='date desc',
    start=10,
    page_length=20,
    as_list=True
)
# résultat
(('Mettre à jour le branding et le design', '2020-09-04'),
('Documentation manquante', '2020-09-02'),
('Levée de fonds pour la fondation', '2020-09-03'))

# Tâches avec une date après le 08/09/2020
frappe.db.get_list('Task', filters={
    'date': ['>', '2019-09-08']
})

# Tâches avec un sujet contenant le mot "test"
frappe.db.get_list('Task', filters={
    'subject': ['like', '%test%']
})

# Compter le nombre de tâches groupées par statut
frappe.db.get_list('Task',
    fields=['count(name) as count', 'status'],
    group_by='status'
)
# résultat
[{'count': 1, 'status': 'Working'},
 {'count': 2, 'status': 'Overdue'},
 {'count': 2, 'status': 'Open'},
 {'count': 1, 'status': 'Filed'},
 {'count': 20, 'status': 'Completed'},
 {'count': 1, 'status': 'Cancelled'}]
```

## frappe.db.get\_all

`frappe.db.get_all(doctype, filters, or_filters, fields, order_by, group_by, start, page_length)`

- Vous pouvez également utiliser l'alias `frappe.get_all`

Identique à `frappe.db.get_list` mais récupèrera les entrées sans prendre en compte les autorisations de l'utilisateur de la session.

## frappe.db.get\_value

`frappe.db.get_value(doctype, name, fieldname)` or `frappe.db.get_value(doctype, filters, fieldname)`

- Vous pouvez également utiliser les alias `frappe.get_value` et `frappe.db.get_values`

Retourne la valeur d'un champ d'un document ou une liste de valeurs.

```python
# valeur simple
sujet = frappe.db.get_value('Task', 'TASK00002', 'subject')

# valeurs multiples
sujet, description = frappe.db.get_value('Task', 'TASK00002', ['subject', 'description'])

# dictionnaire
task_dict = frappe.db.get_value('Task', 'TASK00002', ['subject', 'description'], as_dict=1)
task_dict.subject
task_dict.description

# avec des filtres, retourne la première entrée correpondant à ces filtres
subject, description = frappe.db.get_value('Task', {'status': 'Open'}, ['subject', 'description'])
```

## frappe.db.get\_single\_value

`frappe.db.get_single_value(doctype, fieldname)`

Retourne une valeur de champ d'une type de document unique.

```python
timezone = frappe.db.get_single_value('System Settings', 'timezone')
```

## frappe.db.set\_value

`frappe.db.set_value(doctype, name, fieldname, value)`

- Vous pouvez également utiliser l'alias `frappe.db.update`

Renseigne la valeur d'un champ dans la base de donnée, n'appelle par les logiques de l'ORM mais mets à jour l'horodatage modifié (sauf si explicitement contre-indiqué).

```python
# mise à jour de la valeur d'un champ
frappe.db.set_value('Task', 'TASK00002', 'subject', 'New Subject')

# mise à jour de la valeur de plusieurs champ
frappe.db.set_value('Task', 'TASK00002', {
    'subject': 'New Subject',
    'description': 'New Description'
})

# mise à jour dans modifier l'horodatage
frappe.db.set_value('Task', 'TASK00002', 'subject', 'New Subject', update_modified=False)
```

> Cette méthode ne déclenchera les logiques associées à l'ORM comme `validate` et `on_update`. :br
> Utilisez cette méthod pour mettre à jour des champs cachés ou si vous êtes certains de ce que vous faites.

## frappe.db.exists

`frappe.db.exists(doctype, name)`

Renvoi `true` si l'enregistrement existe.

```python
# vérifie si un enregistrement existe grâce à son nom
frappe.db.exists('Task', 'TASK00002') # True

# vérifie si un enregistrement existe grâce à des filtres
frappe.db.exists({
    'doctype': 'Task',
    'status': 'Open',
    'subject': 'New Task'
})
```

## frappe.db.count

`frappe.db.count(doctype, filters)`

Renvoi le nombre d'enregistrements pour un `doctype` et des `filtres` donnés.

```python
# nombre total de Tâches
frappe.db.count('Task')

# nombre total de tâches ouvertes
frappe.db.count('Task', {'status': 'Open'})
```

## frappe.db.delete

`frappe.db.delete(doctype, filters)`

Supprime un enregistrement d'un `doctype` correspondant aux filtres passés.

```python
frappe.db.delete('Task', {
    'status': 'Cancelled'
})
```

## frappe.db.commit

`frappe.db.commit()`

Valide la transaction en cours. Déclenche la requête SQL `COMMIT`.

> Dodock lancera automatiquement `frappe.db.commit()` à la fin d'une requête web de type
> `POST` ou `PUT` réussie. Par contre elle ne sera pas lancée pour les requêtes `GET`.
>
> Vous n'avez pas besoin d'appeler cette méthode explicitement la plupart du temps, mais
> vous pouvez l'appeler pour valider vos transactions en plusieurs fois.

## frappe.db.rollback

`frappe.db.rollback()`

Rollback de la transaction en cours. Déclenche la requête SQL `ROLLBACK`.

> Doock va automatiquement déclencher `frappe.db.rollback()` si une exception est générée
> pendant une requête web de type `POST` ou `PUT`. Utilisez cette méthode si vous avez besoin
> de faire un rollback plus tôt dans une transaction.


# API Rest

Le modèle applicatif Dodock crée de nouveaux points de terminaison REST pour chaque type de document (DocType) créé dans le système.
Vous pouvez aussi accèder aux méthodes python via leur chemin en pointillé en leur ajoutant un décorateur "whitelist".

## Authentification

Vous pouvez vous authentifier grâce à une méthode basée sur des mots de passe ou grâce à une méthode basée sur des jetons d'accès.

### Authentification par mot de passe

L'authentification par mot de passe utilise des cookies et les données de la session pour conserver l'authentification dans les requêtes subséquentes. :br
Dans la plupart des cas, la libraire que vous utilisez pour faire vos appels REST gère les données de la session, mais si ça n'est pas le cas utilisez plutôt la méthode par jetons.

```js
fetch('http://<url-de-base>/api/method/login', {
    method: 'POST',
    headers: {
        'Accept': 'application/json',
        'Content-Type': 'application/json',
    },
    body: JSON.stringify({
        usr: 'identifiant ou email',
        pwd: 'mot de passe'
    })
})
.then(r => r.json())
.then(r => {
    console.log(r);
})
```

### Authentification par jeton

Un jeton est une paire de clé API et de secret d'API. :br
Vous devez d'abord créer un utilisateur pour l'API et générer des clés dans la section d'accès API du formulaire utilisateur.

Le jeton est généré en concaténant `api_key` et `api_secret` avec un double points `:`.
Passez la chaîne de caractère du jeton `api_key:api_secret` dans l'en-tête d'autorisation de la requête.

```js
fetch('http://<url-de-base>/api/method/frappe.auth.get_logged_user', {
    headers: {
        'Authorization': 'token api_key:api_secret'
    }
})
.then(r => r.json())
.then(r => {
    console.log(r);
})
```

## Liste de documents

Pour obtenir une liste de documents pour un type de document (doctype) donné, envoyé une requête `GET` à `/api/resource/:doctype`. :br
Par défaut, cette requête vous renverra 20 documents et récupèrera uniquement le nom de ces documents.

```bash
GET /api/resource/:doctype
```

Réponse

```json
{
  "data": [
    {
      "name": "b57566801d"
    },
    {
      "name": "b63b71df37"
    },
    {
      "name": "1fea4af0f4"
    },
    {
      "name": "4ca0cc6e0e"
    },
  ]
}
```

Vous pouvez indiquer quels champs récupérer dans le paramètre `fields`. Il faut que ce soit une liste JSON.

```bash
GET /api/resource/:doctype?fields=["field1", "field2"]
```

Vous pouvez filtrer les documents en passant un paramètre `filters`. Les filtres doivent être en liste, avec chaque filtre au format: [champ, opérateur, valeur]

```bash
GET /api/resource/:doctype?filters=[["field1", "=", "value1"], ["field2", ">", "value2"]]
```

Vous pouvez aussi passer un champ d'ordre et de tri. Il faut que le format soit `nom_du_champ asc` ou `nom_du_champ desc`. L'espace doit être encodé comme un URL.

```bash
GET /api/resource/:doctype?order_by=title%20desc
```

Vous pouvez aussi paginer les résultats en fournissant les paramètres `limit_start` et `limit_page_length`.

````bash
GET /api/resource/:doctype?limit_start=10&limit_page_length=20
```New

# Body
{"description": "Nouvelle ToDo"}
````

Réponse

```json
{
  "data": {
    "name": "af2e2d0e33",
    "owner": "Administrator",
    "creation": "2019-06-03 14:19:00.281026",
    "modified": "2019-06-03 14:19:00.281026",
    "modified_by": "Administrator",
    "idx": 0,
    "docstatus": 0,
    "status": "Open",
    "priority": "Medium",
    "description": "Nouvelle ToDo",
    "doctype": "ToDo"
  }
}
```

### LECTURE

Récupérez un document en envoyant une requête `GET` à `/api/resource/:doctype/:name`.

```bash
GET /api/resource/:doctype/:name
```

Réponse

```json
{
  "data": {
    "name": "bf2e760e13",
    "owner": "Administrator",
    "creation": "2019-06-03 14:19:00.281026",
    "modified": "2019-06-03 14:19:00.281026",
    "modified_by": "Administrator",
    "idx": 0,
    "docstatus": 0,
    "status": "Open",
    "priority": "Medium",
    "description": "<p>Description Test</p>",
    "doctype": "ToDo"
  }
}
```

### MISE A JOUR

Mettez à jour un document en envoyant une requête `PUT` à `/api/resource/:doctype/:name`.
Vous n'avez pas besoin d'envoyer le document entier, seulement les champs que vous souhaitez mettre à jour.

```bash
PUT /api/resource/:doctype/:name

# Body
{"description": "Nouvelle description"}
```

Réponse

```json
{
  "data": {
    "name": "bf2e760e13",
    "owner": "Administrator",
    "creation": "2019-06-03 14:19:00.281026",
    "modified": "2019-06-03 14:21:00.785117",
    "modified_by": "Administrator",
    "idx": 0,
    "docstatus": 0,
    "status": "Open",
    "priority": "Medium",
    "description": "New description",
    "doctype": "ToDo"
  }
}
```

### SUPPRESSION

Supprimez une document en envoyant une requête `DELETE` à `/api/resource/:doctype/:name`.

```bash
DELETE /api/resource/:doctype/:name
```

Réponse

```text
{"message": "ok"}
```

## Appels de procédures à distance

Dodock vous permet de lancer des méthodes python arbitraires en utilisant l'API REST pour gérer des logiques personnalisées. Ces méthodes doivent être décorées avec la méthode `frappe.whitelist()` pour les rendre accessible via REST.

Pour lancer la méthode python whitelisté `frappe.auth.get_logged_user`, envoyez une requête au point de terminaison `/api/method/frappe.auth.get_logged_user`.

```bash
GET /api/method/frappe.auth.get_logged_user
```

Réponse

```json
{
  "message": "john@doe.com"
}
```

- Si votre méthode renvoie uniquement des valeurs, vous devez envoyer une requête `GET`.
- Si votre méthode modifie l'état de la base de données, utilisez `POST`. Après une requête `POST` réussie, le framework appelle automatiquement `frappe.db.commit()` pour valider les modifications dans la base de données.
- Une réponse de réussite renverra un objet JSON avec une clé `message`.
- Une réponse d'erreur renverra un objet JSON avec une clé `exc` contenant une trace d'erreur et `exc_type` contenant l'exception générée.
- La valeur de sortie de la méthode sera convertie en JSON et envoyée comme réponse.

## Téléchargement de fichiers

Il existe une méthode dédiée `/api/method/upload_file` qui accepte un fichier binaire et le télécharge dans le système.

Voici la commande curl:

```bash
curl -X POST \
  http://<url-de-base>/api/method/upload_file \
  -H 'Accept: application/json' \
  -H 'Authorization: token xxxx:yyyy' \
  -F file=@/chemin/vers/le/fichier.png
```

Si vous utilisez du code client en Javascript pour télécharger vos fichiers, vous pouvez ajouter les fichiers téléchargés à un objet FormData et envoyer une requête XHR.


# API Jinja

Voici la liste de méthodes en whitelist que Dodock fourni pour l'utilisation dans les modèles Jinja.

## frappe.format

`frappe.format(value, df, doc)`

Formatte une valeur brute (enregistrée dans la base de donnée) dans un format présentable pour les utilisateurs.
Par exemple, converti 2020-09-08 en 08/09/2020

Usage
{% raw %}

```html
<div>{{ frappe.format('2020-09-08', {'fieldtype': 'Date'}) }}</div>

<!-- résultat -->
<div>09-08-2020</div>
```

{% endraw %}

## frappe.format\_date

`frappe.format_date(date_string)`

Formatte une date en un format long lisible par utilisateur.

Usage
{% raw %}

```html
<div>{{ frappe.format_date('2020-09-08') }}</div>

<!-- résultat -->
<div>8 septembre 2020</div>
```

{% endraw %}

## frappe.get\_url

`frappe.get_url()`

Renvoi l'URL du site

Usage
{% raw %}

```html
<div>{{ frappe.get_url() }}</div>

<!-- résultat -->
<div>https://dokos.io</div>
```

{% endraw %}

## frappe.get\_doc

`frappe.get_doc(doctype, name)`

Renvoi un document grâce à son nom.

Usage
{% raw %}

```html
<div>
    {% set doc = frappe.get_doc('Task', 'TASK00002') %}
    {{ doc.title }} - {{ doc.status }}
</div>

<!-- résultat -->
<div>
    Acheter des oeufs - Ouvert
</div>
```

{% endraw %}

## frappe.get\_all

`frappe.get_all(doctype, filters, fields, order_by, start, page_length)`

Renvoi une liste de tous les enregistrements d'un type de document.

```python
frappe.get_all(doctype, filters, fields, order_by, start, page_length)
```

Usage
{% raw %}

```html
<div>
    {% set tasks = frappe.get_all('Task', filters={'status': 'Open'}, fields=['title', 'due_date'], order_by='due_date asc') %}
    {% for task in tasks %}
    <div>
        <h3>{{ task.title }}</h3>
        <p>Date d'échéance: {{ frappe.format_date(task.due_date) }}</p>
    </div>
    {% endfor %}
</div>

<!-- résultat -->
<div>
    <div>
        <h3>Design du site web</h3>
        <p>Date d'échéance: 8 septembre 2020</p>
    </div>
    <div>
        <h3>Ajouter des méta-tags sur le site web</h3>
        <p>Date d'échéance: 22 septembre 2020</p>
    </div>
</div>
```

{% endraw %}

## frappe.get\_list

`frappe.get_list(doctype, filters, fields, order_by, start, page_length)`

Similaire à `frappe.get_all` mais filtre les enregistrements en fonction des autorisations de l'utilisateur connecté.

## frappe.db.get\_value

`frappe.db.get_value(doctype, name, fieldname)`

Renvoi la valeur d'un champ (ou une liste de valeurs) depuis un document.

Usage
{% raw %}

```html
<div>
    <span>
        {% set company_abbreviation = frappe.db.get_value('Company', 'Mon Tiers Lieux', 'abbr') %}
        {{ company_abbreviation }}
    </span>
    <div>
        {% set title, description = frappe.db.get_value('Task', 'TASK00002', ['title', 'description']) %}
        <h3>{{ title }}</h3>
        <p>{{ description }}</p>
    </div>
</div>

<!-- résultat -->
<div>
    <span>MTL</span>
</div>
```

{% endraw %}

## frappe.db.get\_single\_value

`frappe.db.get_single_value(doctype, fieldname)`

Renvoi la valeur d'un champ d'un type de document unique.

Usage
{% raw %}

```html
<div>
    <span>
        {% set timezone = frappe.db.get_single_value('System Settings', 'time_zone') %}
        {{ timezone }}
    </span>
</div>

<!-- résultat -->
<div>
    <span>
        Europe/Paris
    </span>
</div>
```

{% endraw %}

## frappe.get\_system\_settings

`frappe.get_system_settings(fieldname)`

Renvoi la valeur d'un champ des paramètres système.

Usage
{% raw %}

```html
<div>
    {% if frappe.get_system_settings('country') == 'France' %}
    <button>Payer avec GoCardless</button>
    {% else %}
    <button>Payer avec Stripe</button>
    {% endif %}
</div>

<!-- résultat -->
<div>
    <button>Payer avec GoCardless</button>
</div>
```

{% endraw %}

## frappe.get\_meta

`frappe.get_meta(doctype)`

Renvoi les métadonnées d'un type de document. Elle contiennent des informations comme les champs ou le nom du champ du titre, le champ image, etc...

Usage
{% raw %}

```html
<div>
    <span>
        {% set meta = frappe.get_meta('Task') %}
        La tâche a {{ meta.fields | len }} champs.
        {% if meta.get_field('status') %}
        Elle a aussi un champ de statut.
        {% endif %}
    </span>
</div>

<!-- résultat -->
<div>
    <span>
        La tâche à 18 champs. Elle a aussi un champ de statut.
    </span>
</div>
```

{% endraw %}

## frappe.get\_fullname

`frappe.get_fullname(user_email)`

Renvoi le nom complet de l'utilisateur auquel appartient cet email. Si aucun utilisateur n'est passé, le système considèrera qu'il s'agit de l'utilisateur connecté.

Usage
{% raw %}

```html
<div>
    <span>Le nom complet de martine@dokos.io est {{ frappe.get_fullname('martine@dokos.io') }}</span>
    <span>L'utilisateur connecté en ce moment s'appelle {{ frappe.get_fullname() }}</span>
</div>

<!-- résultat -->
<div>
    <span>Le nom complet de martine@dokos.io est Martine Dupond</span>
    <span>L'utilisateur connecté en ce moment s'appelle Jean Martin</span>
</div>
```

{% endraw %}

## frappe.render\_template

`frappe.render_template(template_name, context)`

Interprète un modèle (chaine de caractères ou fichier) Jinja avec son contexte.

Usage
{% raw %}

```html
<div>
    <!-- interprète un fichier jinja -->
    {{ frappe.render_template('templates/includes/footer/footer.html', {}) }}

    <!-- interprète une chaine de caractères Jinja -->
    <p>{{ frappe.render_template('{{ foo }}', {'foo': 'bar'}) }}</p>
</div>

<!-- résultat -->
<div>
    <footer class="web-footer">
        <!-- footer complet html -->
    </footer>
    <p>bar</p>
</div>
```

{% endraw %}

## frappe.\_

`frappe._(string)` or `_(string)`

Usage
{% raw %}

```html
<div>
    <p>{{ _('This string should get translated') }}</p>
</div>

<!-- résultat -->
<div>
    <p>Cette chaine de caractère doit être traduite</p>
</div>
```

{% endraw %}

## frappe.session.user

Renvoi le nom de l'utilisateur de la session en cours

## frappe.session.csrf\_token

Renvoi le jeton CSRF de la session en cours

## frappe.form\_dict

Si le modèle est évalué dans une requête web, `frappe.form_dict` renvoi un dictionnaire de paramètres de requête, sinon il renvoi `None`.

## frappe.fmt\_money

`frappe.fmt_money(amount, precision, currency, format)`

Formatte une valeur brute (enregistrée dans la base de donnée) dans un format présentable pour les utilisateurs.
Par exemple, converti 2000 en 2000,00 €

Usage
{% raw %}

```html
<div>{{ frappe.utils.fmt_money(doc.grand_total or '', currency=doc.currency) }}</div>

<!-- résultat -->
<div>2000,00 €</div>
```

{% endraw %}


# Créer une réservation d'article via l'API avec Postman

::callout{color="teal" icon="i-heroicons-light-bulb"}
Postman est une plateforme permettant d'utiliser une API. Nous l'utilisons ici pour simplifier les appels à l'API de Dokos.
<https://www.postman.com/>{rel=""nofollow""}
::

1. Créez un nouvel onglet
2. Sélectionnez le type d'appel `POST`
3. Entrez l'URL de votre site suivi de la ressource que vous souhaitez créer: Item Booking (Réservation d'articles)

Exemple: `http://localhost:8000/api/resource/Item Booking`

4. Dans la section *Headers* ajoutez les deux clés/valeurs suivantes:

| KEY           | VALUE                               |
| ------------- | ----------------------------------- |
| Authorization | token [clé publique] : [clé privée] |
| Content-Type  | application/json                    |

> Vous pouvez récupérer une clé publique et une clé privée associée à un utilisateur en allant dans ses paramètres utilisateur; section Accès API.

5. Dans la section *Body*, cochez *raw* et ajoutez un objet contenant les valeurs qu'on souhaite associer à notre réservation:

Exemple:

```text
{
    "item": "Salle de coworking",
    "starts_on": "2022-04-01 08:00:00",
    "ends_on": "2022-04-01 18:00:00",
    "user": "roslynlepicier@armyspy.com"
}
```

> Seuls les champs `item`, `starts_on` et `ends_on` sont obligatoires, mais il est possible d'ajouter une valeur pour n'importe quel autre champ disponible dans le document.
> Pour connaître les champs disponible et leur caractère obligatoire ou non, il suffit d'aller dans la liste de Réservations d'article et de sélectionner Menu (...) > Personnaliser.


# Créer une commande client via l'API avec Postman

> Postman est une plateforme permettant d'utiliser une API. Nous l'utilisons ici pour simplifier les appels à l'API de Dokos.
> <https://www.postman.com/>{rel="&#x22;nofollow&#x22;"}

1. Créez un nouvel onglet
2. Sélectionnez le type d'appel `POST`
3. Entrez l'URL de votre site suivi de la ressource que vous souhaitez créer: Sales Order (Commande client)

Exemple: `http://localhost:8000/api/resource/Sales Order`

4. Dans la section *Headers* ajoutez les deux clés/valeurs suivantes:

| KEY           | VALUE                               |
| ------------- | ----------------------------------- |
| Authorization | token [clé publique] : [clé privée] |
| Content-Type  | application/json                    |

> Vous pouvez récupérer une clé publique et une clé privée associée à un utilisateur en allant dans ses paramètres utilisateur; section Accès API.

5. Dans la section *Body*, cochez *raw* et ajoutez un objet contenant les valeurs qu'on souhaite associer à notre réservation:

Exemple:

```text
{
    "customer": "Roslyn Lépicier",
    "items": [
        {
            "item_code": "Salle de coworking",
            "delivery_date": "2022-04-01",
            "qty": 1,
            "uom": "Heure"
        }
    ]
}
```

Exemple en associant votre commande à une réservation d'articles:
&#x2A;Vous pouvez, par exemple, créer une réservation d'articles et inclure son *nom* dans votre requête.*

```text
{
    "customer": "Roslyn Lépicier",
    "items": [
        {
            "item_code": "Salle de coworking",
            "delivery_date": "2022-04-01",
            "qty": 1,
            "uom": "Heure",
            "item_booking": "STO-BOOK-2022-00102"
        }
    ]
}
```

> Seuls le champ `customer`et une ligne de commande (`items`) sont obligatoires, mais il est possible d'ajouter une valeur pour n'importe quel autre champ disponible dans le document.
> Pour connaître les champs disponible et leur caractère obligatoire ou non, il suffit d'aller dans la liste de Réservations d'article et de sélectionner Menu (...) > Personnaliser.
> Pour les tables enfants (*Sales Order Item* par exemple), sélectionnez *Personnaliser une table enfant* dans la page de personnalisation de formulaire.

## Valider une commande

Pour valider une commande vous pouvez passer le statut de document 1 dans votre document:

```text
{
    "customer": "Roslyn Lépicier",
    "docstatus": 1,
    "items": [
        {
            "item_code": "Salle de coworking",
            "delivery_date": "2022-04-01",
            "qty": 1,
            "uom": "Heure",
            "item_booking": "STO-BOOK-2022-00102"
        }
    ]
}
```

Vous pouvez également utiliser l'API suivante pour soumettre un brouillon déjà créé et renvoyé par l'API:

`http://localhost:8000/api/method/frappe.client.submit`

Avec, dans le corps de l'appel, un brouillon de commande créé précédemment:

```text
{
    "doc": {
        "name": "SAL-ORD-2022-00116",
        "owner": "thierry@dokos.io",
        "creation": "2022-03-01 18:31:44.895404",
        "modified": "2022-03-01 18:31:44.895404",
        "modified_by": "thierry@dokos.io",
        "parent": null,
        "parentfield": null,
        "parenttype": null,
        "idx": 0,
        "docstatus": 0,
        "title": "{customer_name}",
        "naming_series": "SAL-ORD-.YYYY.-",
        "customer": "Roslyn L\u00e9picier",
        "customer_name": "Roslyn L\u00e9picier",
        "order_type": "Sales",
        "skip_delivery_note": 0,
        "amended_from": null,
        "company": "MappeMonde",
        "transaction_date": "2022-03-01",
        "delivery_date": "2022-04-01",
        "po_no": null,
        "po_date": null,
        "tax_id": null,
        "customer_address": "Roslyn L\u00e9picier-Facturation",
        "address_display": "23 rue Clement Marot<br>66100 PERPIGNAN<br>\nFrance<br>\n",
        "contact_person": "Roslyn L\u00e9picier-Roslyn L\u00e9picier",
        "contact_display": "Roslyn L\u00e9picier",
        "contact_phone": "04.37.73.66.41",
        "contact_mobile": "",
        "contact_email": "RoslynLepicier@armyspy.com",
        "company_address": null,
        "company_address_display": null,
        "shipping_address_name": "Roslyn L\u00e9picier-Facturation",
        "shipping_address": "23 rue Clement Marot<br>66100 PERPIGNAN<br>\nFrance<br>\n",
        "customer_group": "Tous les Groupes Client",
        "territory": "Tous les Territoires",
        "currency": "EUR",
        "conversion_rate": 1.0,
        "selling_price_list": "Vente Standard",
        "price_list_currency": "EUR",
        "plc_conversion_rate": 1.0,
        "ignore_pricing_rule": 0,
        "set_warehouse": null,
        "scan_barcode": null,
        "total_qty": 1.0,
        "base_total": 5.0,
        "base_net_total": 5.0,
        "total_net_weight": 0.0,
        "total": 5.0,
        "net_total": 5.0,
        "tax_category": "",
        "shipping_rule": null,
        "taxes_and_charges": null,
        "other_charges_calculation": null,
        "base_total_taxes_and_charges": 0.0,
        "total_taxes_and_charges": 0.0,
        "loyalty_points": 0,
        "loyalty_amount": 0.0,
        "coupon_code": null,
        "apply_discount_on": "Grand Total",
        "base_discount_amount": 0.0,
        "additional_discount_percentage": 0.0,
        "discount_amount": 0.0,
        "base_grand_total": 5.0,
        "base_rounding_adjustment": 0.0,
        "base_rounded_total": 5.0,
        "base_in_words": "Five Euro",
        "grand_total": 5.0,
        "rounding_adjustment": 0.0,
        "rounded_total": 5.0,
        "in_words": "Five Euro",
        "advance_paid": 0.0,
        "disable_rounded_total": 0,
        "payment_terms_template": null,
        "tc_name": null,
        "terms": null,
        "is_internal_customer": 0,
        "represents_company": null,
        "inter_company_order_reference": null,
        "project": null,
        "party_account_currency": null,
        "source": null,
        "campaign": null,
        "external_reference": null,
        "language": "fr",
        "letter_head": null,
        "select_print_heading": null,
        "group_same_items": 0,
        "status": "Draft",
        "delivery_status": "Not Delivered",
        "per_delivered": 0.0,
        "per_billed": 0.0,
        "billing_status": "Not Billed",
        "sales_partner": null,
        "commission_rate": 0.0,
        "total_commission": 0.0,
        "from_date": null,
        "to_date": null,
        "subscription": null,
        "auto_repeat": null,
        "doctype": "Sales Order",
        "items": [
            {
                "name": "5317c1c489",
                "owner": "thierry@dokos.io",
                "creation": "2022-03-01 18:31:44.895404",
                "modified": "2022-03-01 18:31:44.895404",
                "modified_by": "thierry@dokos.io",
                "parent": "SAL-ORD-2022-00116",
                "parentfield": "items",
                "parenttype": "Sales Order",
                "idx": 1,
                "docstatus": 0,
                "item_code": "Salle de coworking",
                "customer_item_code": null,
                "ensure_delivery_based_on_produced_serial_no": 0,
                "delivery_date": "2022-04-01",
                "item_name": "Salle de coworking",
                "description": "<div><p>R\u00e9servez votre place dans notre salle de coworking</p></div>",
                "item_group": "Coworking",
                "brand": null,
                "image": "/assets/tierslieux/images/coworking.jpg",
                "qty": 1.0,
                "stock_uom": "Heure",
                "uom": "Heure",
                "conversion_factor": 1.0,
                "stock_qty": 1.0,
                "price_list_rate": 5.0,
                "base_price_list_rate": 5.0,
                "margin_type": "",
                "margin_rate_or_amount": 0.0,
                "rate_with_margin": 0.0,
                "discount_percentage": 0.0,
                "discount_amount": 0.0,
                "base_rate_with_margin": 0.0,
                "rate": 5.0,
                "amount": 5.0,
                "item_tax_template": null,
                "base_rate": 5.0,
                "base_amount": 5.0,
                "pricing_rules": "[]",
                "stock_uom_rate": 5.0,
                "is_free_item": 0,
                "net_rate": 5.0,
                "net_amount": 5.0,
                "base_net_rate": 5.0,
                "base_net_amount": 5.0,
                "billed_amt": 0.0,
                "valuation_rate": 0.0,
                "gross_profit": 5.0,
                "delivered_by_supplier": 0,
                "supplier": null,
                "weight_per_unit": 0.0,
                "total_weight": 0.0,
                "weight_uom": null,
                "warehouse": "Magasins - MM",
                "target_warehouse": null,
                "prevdoc_docname": null,
                "against_blanket_order": 0,
                "blanket_order": null,
                "blanket_order_rate": 0.0,
                "bom_no": null,
                "projected_qty": 0.0,
                "actual_qty": 0.0,
                "ordered_qty": 0.0,
                "planned_qty": 0.0,
                "work_order_qty": 0.0,
                "delivered_qty": 0.0,
                "produced_qty": 0.0,
                "returned_qty": 0.0,
                "additional_notes": null,
                "item_booking": "STO-BOOK-2022-00102",
                "page_break": 0,
                "item_tax_rate": "[]",
                "transaction_date": "2022-03-01",
                "doctype": "Sales Order Item",
                "__unsaved": 1
            }
        ],
        "pricing_rules": [],
        "taxes": [],
        "packed_items": [],
        "payment_schedule": [
            {
                "name": "242d92065b",
                "owner": null,
                "creation": "2022-03-01 18:31:45.484130",
                "modified": "2022-03-01 18:31:45.484130",
                "modified_by": "thierry@dokos.io",
                "parent": "SAL-ORD-2022-00116",
                "parentfield": "payment_schedule",
                "parenttype": "Sales Order",
                "idx": 1,
                "docstatus": 0,
                "payment_term": null,
                "description": null,
                "due_date": "2022-03-01",
                "mode_of_payment": null,
                "invoice_portion": 100.0,
                "discount_type": null,
                "discount_date": null,
                "discount": 0.0,
                "payment_amount": 5.0,
                "outstanding": 5.0,
                "paid_amount": 0.0,
                "discounted_amount": 0.0,
                "base_payment_amount": 5.0,
                "doctype": "Payment Schedule"
            }
        ],
        "sales_team": []
    }
}
```

> Vous pouvez trouver d'autres méthodes d'API disponibles dans ce fichier: <https://gitlab.com/dokos/dodock/-/blob/develop/frappe/client.py>{rel="&#x22;nofollow&#x22;"}

## Créer une facture à partir d'une commande

Vous pouvez créer une facture depuis une commande existante en appelant l'API suivante:

`http://localhost:8000/api/method/erpnext.selling.doctype.sales_order.sales_order.make_sales_invoice`

Corps de l'appel:

```text
{
    "source_name": "SAL-ORD-2022-00116"
}
```

Ensuite il ne vous reste plus qu'à poster la facture directement ou via les API de frappe.client

> Vous pouvez modifier le contenu de la facture avant de la poster, pour changer les quantités ou montants facturés par exemple.

## Créer un paiement à partir d'une commande

Vous pouvez créer un paiement à partir d'une commande en appelant l'API suivante:

`http://localhost:8000/api/method/erpnext.accounts.doctype.payment_entry.payment_entry.get_payment_entry`

Corps de l'appel:

```text
{
        "dt": "Sales Order",
        "dn": "SAL-ORD-2022-00116"
}
```

Ensuite il ne vous reste plus qu'à poster le paiement directement ou via les API de frappe.client


# Contacts

Pour récupérer les contacts associés au client *Francis Charpentier*:

`http://localhost:8000/api/resource/Contact?filters=[["Dynamic Link", "link_doctype", "=", "Customer"], ["Dynamic Link", "link_name", "=", "Francis Charpentier"]]`

# Adresses

Par exemple pour récupérer les adresses associés au client *Francis Charpentier*:

`http://localhost:8000/api/resource/Address?filters=[["Dynamic Link", "link_doctype", "=", "Customer"], ["Dynamic Link", "link_name", "=", "Francis Charpentier"]]`


# Table of content

- [Documents API](https://doc.dokos.io/v5/dodock/ressources/api/exemples/python-documents-api)
- [Database API](https://doc.dokos.io/v5/dodock/ressources/api/exemples/python-database-api)
- [Jinja API](https://doc.dokos.io/v5/dodock/ressources/api/exemples/python-jinja-api)
- [REST API](https://doc.dokos.io/v5/dodock/ressources/api/exemples/rest-api)


# Contacts

Pour récupérer les contacts associés au client *Francis Charpentier*:

`http://localhost:8000/api/resource/Contact?filters=[["Dynamic Link", "link_doctype", "=", "Customer"], ["Dynamic Link", "link_name", "=", "Francis Charpentier"]]`

# Adresses

Par exemple pour récupérer les adresses associés au client *Francis Charpentier*:

`http://localhost:8000/api/resource/Address?filters=[["Dynamic Link", "link_doctype", "=", "Customer"], ["Dynamic Link", "link_name", "=", "Francis Charpentier"]]`


# Créer une réservation d'article via l'API avec Postman

::callout
Postman est une plateforme permettant d'utiliser une API. Nous l'utilisons ici pour simplifier les appels à l'API de Dokos.
<https://www.postman.com/>{rel=""nofollow""}
::

1. Créez un nouvel onglet
2. Sélectionnez le type d'appel `POST`
3. Entrez l'URL de votre site suivi de la ressource que vous souhaitez créer: Item Booking (Réservation d'articles)

Exemple: `http://localhost:8000/api/resource/Item Booking`

4. Dans la section *Headers* ajoutez les deux clés/valeurs suivantes:

| KEY           | VALUE                               |
| ------------- | ----------------------------------- |
| Authorization | token [clé publique] : [clé privée] |
| Content-Type  | application/json                    |

::callout
Vous pouvez récupérer une clé publique et une clé privée associée à un utilisateur en allant dans ses paramètres utilisateur; section Accès API.
::

5. Dans la section *Body*, cochez *raw* et ajoutez un objet contenant les valeurs qu'on souhaite associer à notre réservation:

Exemple:

```text
{
    "item": "Salle de coworking",
    "starts_on": "2022-04-01 08:00:00",
    "ends_on": "2022-04-01 18:00:00",
    "user": "roslynlepicier@armyspy.com"
}
```

::callout
Seuls les champs `item`, `starts_on` et `ends_on` sont obligatoires, mais il est possible d'ajouter une valeur pour n'importe quel autre champ disponible dans le document.
Pour connaître les champs disponible et leur caractère obligatoire ou non, il suffit d'aller dans la liste de Réservations d'article et de sélectionner Menu (...) > Personnaliser.
::


# Python Database API

## frappe.db.get\_list

`frappe.db.get_list(doctype, filters, or_filters, fields, order_by, group_by, start, page_length)`

- Also aliased to `frappe.get_list`

Returns a list of records from a `doctype` table. ORM Wrapper for a `SELECT`
query. Will also apply user permissions for the records for the session user.

```python
frappe.db.get_list('Task',
    filters={
        'status': 'Open'
    },
    fields=['subject', 'date'],
    order_by='date desc',
    start=10,
    page_length=20,
    as_list=True
)
# output
(('Update Branding and Design', '2020-09-04'),
('Missing Documentation', '2020-09-02'),
('Fundraiser for Foundation', '2020-09-03'))

# Tasks with date after 2020-09-08
frappe.db.get_list('Task', filters={
    'date': ['>', '2020-09-08']
})

# Tasks with subject that contains "test"
frappe.db.get_list('Task', filters={
    'subject': ['like', '%test%']
})

# Count number of tasks grouped by status
frappe.db.get_list('Task',
    fields=['count(name) as count', 'status'],
    group_by='status'
)
# output
[{'count': 1, 'status': 'Working'},
 {'count': 2, 'status': 'Overdue'},
 {'count': 2, 'status': 'Open'},
 {'count': 1, 'status': 'Filed'},
 {'count': 20, 'status': 'Completed'},
 {'count': 1, 'status': 'Cancelled'}]
```

## frappe.db.get\_all

`frappe.db.get_all(doctype, filters, or_filters, fields, order_by, group_by, start, page_length)`

- Also aliased to `frappe.get_all`

Same as `frappe.db.get_list` but will fetch all records without applying permissions.

## frappe.db.get\_value

`frappe.db.get_value(doctype, name, fieldname)` or `frappe.db.get_value(doctype, filters, fieldname)`

- Also aliased to `frappe.get_value` and `frappe.db.get_values`

Returns a document's field value or a list of values.

```python
# single value
subject = frappe.db.get_value('Task', 'TASK00002', 'subject')

# multiple values
subject, description = frappe.db.get_value('Task', 'TASK00002', ['subject', 'description'])

# as dict
task_dict = frappe.db.get_value('Task', 'TASK00002', ['subject', 'description'], as_dict=1)
task_dict.subject
task_dict.description

# with filters, will return the first record that matches filters
subject, description = frappe.db.get_value('Task', {'status': 'Open'}, ['subject', 'description'])
```

## frappe.db.get\_single\_value

`frappe.db.get_single_value(doctype, fieldname)`

Returns a field value from a Single DocType.

```python
timezone = frappe.db.get_single_value('System Settings', 'timezone')
```

## frappe.db.set\_value

`frappe.db.set_value(doctype, name, fieldname, value)`

- Also aliased to `frappe.db.update`

Sets a field's value in the database, does not call the ORM triggers but updates
the modified timestamp (unless specified not to).

```python
# update a field value
frappe.db.set_value('Task', 'TASK00002', 'subject', 'New Subject')

# update multiple values
frappe.db.set_value('Task', 'TASK00002', {
    'subject': 'New Subject',
    'description': 'New Description'
})

# update without updating the `modified` timestamp
frappe.db.set_value('Task', 'TASK00002', 'subject', 'New Subject', update_modified=False)
```

> This method won't call ORM triggers like `validate` and `on_update`. Use this
> method to update hidden fields or if you know what you are doing.

## frappe.db.exists

`frappe.db.exists(doctype, name)`

Returns true if a document record exists.

```python
# check if record exists by name
frappe.db.exists('Task', 'TASK00002') # True

# check if record exists by filters
frappe.db.exists({
    'doctype': 'Task',
    'status': 'Open',
    'subject': 'New Task'
})
```

## frappe.db.count

`frappe.db.count(doctype, filters)`

Returns number of records for a given `doctype` and `filters`.

```python
# total number of Task records
frappe.db.count('Task')

# total number of Open tasks
frappe.db.count('Task', {'status': 'Open'})
```

## frappe.db.delete

`frappe.db.delete(doctype, filters)`

Delete `doctype` records that match `filters`.

```python
frappe.db.delete('Task', {
    'status': 'Cancelled'
})
```

## frappe.db.commit

`frappe.db.commit()`

Commits current transaction. Calls SQL `COMMIT`.

> Frappe will automatically run `frappe.db.commit()` at the end of a successful
> Web Request of type `POST` or `PUT`. It does not run on `GET` requests.
>
> You dont need to call this explicitly in most cases. Use this if you have to
> commit early in a transaction.

## frappe.db.rollback

`frappe.db.rollback()`

Rollbacks current transaction. Calls SQL `ROLLBACK`.

> Frappe will automatically run `frappe.db.rollback()` if an exception is thrown
> during a Web Request of type `POST` or `PUT`. Use this if you have to rollback
> early in a transaction.


# Python Documents API

The document API gives access to instances of DocTypes in Dodock. :br
It is derived from `frappe.model.Document` class and represents a single record in the database table.

## frappe.get\_doc

### frappe.get\_doc(doctype, name)

Returns a Document object of the record identified by doctype and name. If doctype is a Single DocType name is not required.

```python
# get an existing document
doc = frappe.get_doc('Task', 'TASK00002')
doc.title = 'Test'
doc.save()

# get a single doctype
doc = frappe.get_doc('System Settings')
doc.timezone # Asia/Kolkata
```

### frappe.get\_doc(dict)

Returns a new Document object in memory which does not exist yet in the database.

```python
# create a new document
doc = frappe.get_doc({
    'doctype': 'Task',
    'title': 'New Task'
})
doc.insert()
```

### frappe.get\_doc(doctype={document\_type}, key1 = value1, key2 = value2, ...)

Returns a new Document object in memory which does not exist yet in the database.

```python
# create new object with keyword arguments
user = frappe.get_doc(doctype='User', email_id='test@example.com')
user.insert()
```

## frappe.get\_cached\_doc

Similar to frappe.get\_doc but will look up the document in cache first before hitting the database.

## frappe.new\_doc

`frappe.new_doc(doctype)`

Alternative way to create a new Document.

```python
# create a new document
doc = frappe.new_doc('Task')
doc.title = 'New Task 2'
doc.insert()
```

## frappe.delete\_doc

`frappe.delete_doc(doctype, name)`

Deletes the record and its children from the database. Also deletes other documents like Communication, Comments, etc linked to it.

```python
frappe.delete_doc('Task', 'TASK00002')
```

## frappe.rename\_doc

`frappe.rename_doc(doctype, old_name, new_name, merge=False)`

Rename a document's name (primary key) from old\_name to new\_name. If merge is True and a record with new\_name exists, will merge the record with it.

```python
frappe.rename_doc('Task', 'TASK00002', 'TASK00003')
```

::warning
Rename will only work if Allow Rename is set in the DocType Form.
::

## frappe.get\_meta

`frappe.get_meta(doctype)`

Returns meta information for a doctype. This will also apply custom fields and property setters.

```python
meta = frappe.get_meta('Task')
meta.has_field('status') # True
meta.get_custom_fields() # [field1, field2, ..]
```

To get the original document of DocType (without custom fields and property setters) use frappe.get\_doc('DocType', doctype\_name)

## Document Methods

This section lists out common methods that are available on the doc object.

### doc.insert

This method inserts a new document into the database table. It will check for user permissions and execute before\_insert, validate, on\_update, after\_insert methods if they are written in the controller.

It has some escape hatches that can be used to skip certain checks explained below.

```python
doc.insert(
    ignore_permissions=True, # ignore write permissions during insert
    ignore_links=True, # ignore Link validation in the document
    ignore_if_duplicate=True, # dont insert if DuplicateEntryError is thrown
    ignore_mandatory=True # insert even if mandatory fields are not set
)
```

### doc.save

This method saves changes to an existing document. This will check for user permissions and execute validate before updating and on\_update after updating values.

```python
doc.save(
    ignore_permissions=True, # ignore write permissions during insert
    ignore_version=True # do not create a version record
)
```

### doc.delete

Delete the document record from the database table. This method is an alias to frappe.delete\_doc.

```python
doc.delete()
```

### doc.get\_doc\_before\_save

Will return a version of the doc before the changes were made. You can use it to compare what changed from the last version.

```python
old_doc = doc.get_doc_before_save()
if old_doc.price != doc.price:
    # price changed
    pass
```

### doc.reload

Will get the latest values from the database and update the doc state.

When you are working with a document, it may happen that some other part of code updates the value of some field directly in the database. In such cases you can use this method to reload the doc.

```python
doc.reload()
```

### doc.check\_permission

Throw if the current user has no permission for the provided permtype.

```python
doc.check_permission(permtype='write') # throws if no write permission
```

### doc.get\_title

Get the document title based on title\_field or field named title or name.

```python
title = doc.get_title()
```

### doc.notify\_update

Publish realtime event to indicate that the document has been modified. Client side event handlers react to this event by updating the form.

```python
doc.notify_update()
```

### doc.db\_set

Set a field value of the document directly in the database and update the modified timestamp.

::warning
This method does not trigger controller validations and should be used very carefully.
::

```python
# updates value in database, updates the modified timestamp
doc.db_set('price', 2300)

# updates value in database, will trigger doc.notify_update()
doc.db_set('price', 2300, notify=True)

# updates value in database, will also run frappe.db.commit()
doc.db_set('price', 2300, commit=True)

# updates value in database, does not update the modified timestamp
doc.db_set('price', 2300, update_modified=False)
```

### doc.get\_url

Returns Desk URL for this document. For e.g: `/desk#Form/Task/TASK00002`

```python
url = doc.get_url()
```

### doc.add\_comment

Add a comment to this document. Will show up in timeline in Form view.

```python
# add a simple comment
doc.add_comment('Comment', text='Test Comment')

# add a comment of type Edit
doc.add_comment('Edit', 'Values changed')

# add a comment of type Shared
doc.add_comment("Shared", "{0} shared this document with everyone".format(user))
```

### doc.add\_seen

Add the given/current user to list of users who have seen this document. Will update the \_seen column in the table. It is stored as a JSON Array.

```python
# add john to list of seen
doc.add_seen('john@doe.com')

# add session user to list of seen
doc.add_seen()
```

::warning
This works only if Track Seen is enabled in the DocType.
::

### doc.add\_viewed

Add a view log when a user views a document i.e opens the Form.

```python
# add a view log by john
doc.add_viewed('john@doe.com')

# add a view log by session user
doc.add_viewed()
```

::warning
This works only if Track Views is enabled in the DocType.
::

### doc.run\_method

Run method if defined in controller, will also trigger hooks if defined.

```python
doc.run_method('validate')
```

### doc.queue\_action

Run a controller method in background. If the method has an inner function, like `_submit` for `submit`, it will call that method instead.

```python
doc.queue_action('send_emails', emails=email_list, message='Howdy')
```


# API Jinja

Voici la liste de méthodes en whitelist que Dodock fourni pour l'utilisation dans les modèles Jinja.

## frappe.format

`frappe.format(value, df, doc)`

Formatte une valeur brute (enregistrée dans la base de donnée) dans un format présentable pour les utilisateurs.
Par exemple, converti 2020-09-08 en 08/09/2020

Usage
{% raw %}

```html
<div>{{ frappe.format('2020-09-08', {'fieldtype': 'Date'}) }}</div>

<!-- résultat -->
<div>09-08-2020</div>
```

{% endraw %}

## frappe.format\_date

`frappe.format_date(date_string)`

Formatte une date en un format long lisible par utilisateur.

Usage
{% raw %}

```html
<div>{{ frappe.format_date('2020-09-08') }}</div>

<!-- résultat -->
<div>8 septembre 2020</div>
```

{% endraw %}

## frappe.get\_url

`frappe.get_url()`

Renvoi l'URL du site

Usage
{% raw %}

```html
<div>{{ frappe.get_url() }}</div>

<!-- résultat -->
<div>https://dokos.io</div>
```

{% endraw %}

## frappe.get\_doc

`frappe.get_doc(doctype, name)`

Renvoi un document grâce à son nom.

Usage
{% raw %}

```html
<div>
    {% set doc = frappe.get_doc('Task', 'TASK00002') %}
    {{ doc.title }} - {{ doc.status }}
</div>

<!-- résultat -->
<div>
    Acheter des oeufs - Ouvert
</div>
```

{% endraw %}

## frappe.get\_all

`frappe.get_all(doctype, filters, fields, order_by, start, page_length)`

Renvoi une liste de tous les enregistrements d'un type de document.

```python
frappe.get_all(doctype, filters, fields, order_by, start, page_length)
```

Usage
{% raw %}

```html
<div>
    {% set tasks = frappe.get_all('Task', filters={'status': 'Open'}, fields=['title', 'due_date'], order_by='due_date asc') %}
    {% for task in tasks %}
    <div>
        <h3>{{ task.title }}</h3>
        <p>Date d'échéance: {{ frappe.format_date(task.due_date) }}</p>
    </div>
    {% endfor %}
</div>

<!-- résultat -->
<div>
    <div>
        <h3>Design du site web</h3>
        <p>Date d'échéance: 8 septembre 2020</p>
    </div>
    <div>
        <h3>Ajouter des méta-tags sur le site web</h3>
        <p>Date d'échéance: 22 septembre 2020</p>
    </div>
</div>
```

{% endraw %}

## frappe.get\_list

`frappe.get_list(doctype, filters, fields, order_by, start, page_length)`

Similaire à `frappe.get_all` mais filtre les enregistrements en fonction des autorisations de l'utilisateur connecté.

## frappe.db.get\_value

`frappe.db.get_value(doctype, name, fieldname)`

Renvoi la valeur d'un champ (ou une liste de valeurs) depuis un document.

Usage
{% raw %}

```html
<div>
    <span>
        {% set company_abbreviation = frappe.db.get_value('Company', 'Mon Tiers Lieux', 'abbr') %}
        {{ company_abbreviation }}
    </span>
    <div>
        {% set title, description = frappe.db.get_value('Task', 'TASK00002', ['title', 'description']) %}
        <h3>{{ title }}</h3>
        <p>{{ description }}</p>
    </div>
</div>

<!-- résultat -->
<div>
    <span>MTL</span>
</div>
```

{% endraw %}

## frappe.db.get\_single\_value

`frappe.db.get_single_value(doctype, fieldname)`

Renvoi la valeur d'un champ d'un type de document unique.

Usage
{% raw %}

```html
<div>
    <span>
        {% set timezone = frappe.db.get_single_value('System Settings', 'time_zone') %}
        {{ timezone }}
    </span>
</div>

<!-- résultat -->
<div>
    <span>
        Europe/Paris
    </span>
</div>
```

{% endraw %}

## frappe.get\_system\_settings

`frappe.get_system_settings(fieldname)`

Renvoi la valeur d'un champ des paramètres système.

Usage
{% raw %}

```html
<div>
    {% if frappe.get_system_settings('country') == 'France' %}
    <button>Payer avec GoCardless</button>
    {% else %}
    <button>Payer avec Stripe</button>
    {% endif %}
</div>

<!-- résultat -->
<div>
    <button>Payer avec GoCardless</button>
</div>
```

{% endraw %}

## frappe.get\_meta

`frappe.get_meta(doctype)`

Renvoi les métadonnées d'un type de document. Elle contiennent des informations comme les champs ou le nom du champ du titre, le champ image, etc...

Usage
{% raw %}

```html
<div>
    <span>
        {% set meta = frappe.get_meta('Task') %}
        La tâche a {{ meta.fields | len }} champs.
        {% if meta.get_field('status') %}
        Elle a aussi un champ de statut.
        {% endif %}
    </span>
</div>

<!-- résultat -->
<div>
    <span>
        La tâche à 18 champs. Elle a aussi un champ de statut.
    </span>
</div>
```

{% endraw %}

## frappe.get\_fullname

`frappe.get_fullname(user_email)`

Renvoi le nom complet de l'utilisateur auquel appartient cet email. Si aucun utilisateur n'est passé, le système considèrera qu'il s'agit de l'utilisateur connecté.

Usage
{% raw %}

```html
<div>
    <span>Le nom complet de martine@dokos.io est {{ frappe.get_fullname('martine@dokos.io') }}</span>
    <span>L'utilisateur connecté en ce moment s'appelle {{ frappe.get_fullname() }}</span>
</div>

<!-- résultat -->
<div>
    <span>Le nom complet de martine@dokos.io est Martine Dupond</span>
    <span>L'utilisateur connecté en ce moment s'appelle Jean Martin</span>
</div>
```

{% endraw %}

## frappe.render\_template

`frappe.render_template(template_name, context)`

Interprète un modèle (chaine de caractères ou fichier) Jinja avec son contexte.

Usage
{% raw %}

```html
<div>
    <!-- interprète un fichier jinja -->
    {{ frappe.render_template('templates/includes/footer/footer.html', {}) }}

    <!-- interprète une chaine de caractères Jinja -->
    <p>{{ frappe.render_template('{{ foo }}', {'foo': 'bar'}) }}</p>
</div>

<!-- résultat -->
<div>
    <footer class="web-footer">
        <!-- footer complet html -->
    </footer>
    <p>bar</p>
</div>
```

{% endraw %}

## frappe.\_

`frappe._(string)` or `_(string)`

Usage
{% raw %}

```html
<div>
    <p>{{ _('This string should get translated') }}</p>
</div>

<!-- résultat -->
<div>
    <p>Cette chaine de caractère doit être traduite</p>
</div>
```

{% endraw %}

## frappe.session.user

Renvoi le nom de l'utilisateur de la session en cours

## frappe.session.csrf\_token

Renvoi le jeton CSRF de la session en cours

## frappe.form\_dict

Si le modèle est évalué dans une requête web, `frappe.form_dict` renvoi un dictionnaire de paramètres de requête, sinon il renvoi `None`.

## frappe.fmt\_money

`frappe.fmt_money(amount, precision, currency, format)`

Formatte une valeur brute (enregistrée dans la base de donnée) dans un format présentable pour les utilisateurs.
Par exemple, converti 2000 en 2000,00 €

Usage
{% raw %}

```html
<div>{{ frappe.utils.fmt_money(doc.grand_total or '', currency=doc.currency) }}</div>

<!-- résultat -->
<div>2000,00 €</div>
```

{% endraw %}


# REST API

The Dodock framework automatically creates new REST API endpoints for every DocType you create in the system. :br
You can also access you python methods through their dotted path by whitelisting them.

## Authentication

You can either authenticate yourself through the password base authentication method or through the token based authentication method.

### Password based authentication

Password based authentication relies on cookies and session data to maintain authentication in subsequent requests. :br
In most cases, the library you are using to issue REST calls will handle session data, but if it doesn't you should use Token based authentication.

```js
fetch('http://<base-url>/api/method/login', {
    method: 'POST',
    headers: {
        'Accept': 'application/json',
        'Content-Type': 'application/json',
    },
    body: JSON.stringify({
        usr: 'username or email',
        pwd: 'password'
    })
})
.then(r => r.json())
.then(r => {
    console.log(r);
})
```

### Token base authentication

A token is a pair of API Key and API Secret. :br
First, you must create an API User and then generate the keys in the API Access section in the User form.

The token is generated by concatenating `api_key` and `api_secret` with a colon `:`.
Pass the string token `api_key:api_secret` to the Authorization header in the request.

```js
fetch('http://<base-url>/api/method/frappe.auth.get_logged_user', {
    headers: {
        'Authorization': 'token api_key:api_secret'
    }
})
.then(r => r.json())
.then(r => {
    console.log(r);
})
```

## Listing documents

To get a list of records of a DocType, send a `GET` request at `/api/resource/:doctype`. :br
By default, it will return 20 records and will only fetch the name of the records.

```bash
GET /api/resource/:doctype
```

Response

```json
{
  "data": [
    {
      "name": "b57566801d"
    },
    {
      "name": "b63b71df37"
    },
    {
      "name": "1fea4af0f4"
    },
    {
      "name": "4ca0cc6e0e"
    },
  ]
}
```

You can specify which fields to fetch in the `fields` param. It should be a JSON array.

```bash
GET /api/resource/:doctype?fields=["field1", "field2"]
```

You can filter the records by passing `filters` param. Filters should be an array, where each filter is of the format: [field, operator, value]

```bash
GET /api/resource/:doctype?filters=[["field1", "=", "value1"], ["field2", ">", "value2"]]
```

You can also provide the sort field and order. It should be of the format `fieldname asc` or `fieldname desc`. The space should be URL encoded.

```bash
GET /api/resource/:doctype?order_by=title%20desc
```

You can also page the results by providing the `limit_start` and `limit_page_length` params.

```bash
GET /api/resource/:doctype?limit_start=10&limit_page_length=20
```

## CRUD Operations

Dodock generates REST endpoints for CRUD operations for all DocTypes automatically. :br
Make sure you set the following headers in your requests so that you get proper JSON responses.

```json
{
    "Accept": "application/json",
    "Content-Type": "application/json",
}
```

### CREATE

Create a new document by sending a `POST` request to `/api/resource/:doctype`. Send the document as JSON in the Request Body.

```bash
POST /api/resource/:doctype

# Body
{"description": "New ToDo"}
```

Response

```json
{
  "data": {
    "name": "af2e2d0e33",
    "owner": "Administrator",
    "creation": "2019-06-03 14:19:00.281026",
    "modified": "2019-06-03 14:19:00.281026",
    "modified_by": "Administrator",
    "idx": 0,
    "docstatus": 0,
    "status": "Open",
    "priority": "Medium",
    "description": "New ToDo",
    "doctype": "ToDo"
  }
}
```

### READ

Get a document by sending a `GET` request to `/api/resource/:doctype/:name`.

```bash
GET /api/resource/:doctype/:name
```

Response

```json
{
  "data": {
    "name": "bf2e760e13",
    "owner": "Administrator",
    "creation": "2019-06-03 14:19:00.281026",
    "modified": "2019-06-03 14:19:00.281026",
    "modified_by": "Administrator",
    "idx": 0,
    "docstatus": 0,
    "status": "Open",
    "priority": "Medium",
    "description": "<p>Test description</p>",
    "doctype": "ToDo"
  }
}
```

### UPDATE

Update a document by sending a `PUT` request to `/api/resource/:doctype/:name`. :br
You don't need to send the whole document, instead you can just send the fields that you want to update.

```bash
PUT /api/resource/:doctype/:name

# Body
{"description": "New description"}
```

Response

```json
{
  "data": {
    "name": "bf2e760e13",
    "owner": "Administrator",
    "creation": "2019-06-03 14:19:00.281026",
    "modified": "2019-06-03 14:21:00.785117",
    "modified_by": "Administrator",
    "idx": 0,
    "docstatus": 0,
    "status": "Open",
    "priority": "Medium",
    "description": "New description",
    "doctype": "ToDo"
  }
}
```

### DELETE

Delete a document by sending a `DELETE` request to `/api/resource/:doctype/:name`.

```bash
DELETE /api/resource/:doctype/:name
```

Response

```text
{"message": "ok"}
```

## Remote Procedure Calls

Dodock allows you to trigger arbitrary python methods using the REST API for handling custom logic. These methods must be marked as whitelisted to make them accessible via REST.

To run a whitelisted python method at `frappe.auth.get_logged_user`, send a request to the endpoint `/api/method/frappe.auth.get_logged_user`.

```bash
GET /api/method/frappe.auth.get_logged_user
```

Response

```json
{
  "message": "john@doe.com"
}
```

- If your method returns some values, you should send a `GET` request.
- If your method changes the state of the database, use `POST`. After a successful `POST` request, the framework will automatically call `frappe.db.commit()` to commit the changes to the database.
- A successful response will return a JSON object with a message key.
- An errored response will return a JSON object with `exc` key which contains the stack trace and `exc_type` which contains the thrown Exception.
- The return value of the method will be converted to a JSON and sent as the response.

## File Upload

There is a dedicated method `/api/method/upload_file` that accepts binary file data and uploads it into the system.

Here is the curl command for it:

```bash
curl -X POST \
  http://<base-url>/api/method/upload_file \
  -H 'Accept: application/json' \
  -H 'Authorization: token xxxx:yyyy' \
  -F file=@/path/to/file/file.png
```

If you are using client side Javascript to upload files, you can append the uploaded files as FormData and send an XHR request.


# Créer une commande client via l'API avec Postman

::callout
Postman est une plateforme permettant d'utiliser une API. Nous l'utilisons ici pour simplifier les appels à l'API de Dokos. :br<https://www.postman.com/>{rel=""nofollow""}
::

1. Créez un nouvel onglet
2. Sélectionnez le type d'appel `POST`
3. Entrez l'URL de votre site suivi de la ressource que vous souhaitez créer: Sales Order (Commande client)

Exemple: `http://localhost:8000/api/resource/Sales Order`

4. Dans la section *Headers* ajoutez les deux clés/valeurs suivantes:

| KEY           | VALUE                               |
| ------------- | ----------------------------------- |
| Authorization | token [clé publique] : [clé privée] |
| Content-Type  | application/json                    |

::callout
Vous pouvez récupérer une clé publique et une clé privée associée à un utilisateur en allant dans ses paramètres utilisateur; section Accès API.
::

5. Dans la section *Body*, cochez *raw* et ajoutez un objet contenant les valeurs qu'on souhaite associer à notre réservation:

Exemple:

```text
{
    "customer": "Roslyn Lépicier",
    "items": [
        {
            "item_code": "Salle de coworking",
            "delivery_date": "2022-04-01",
            "qty": 1,
            "uom": "Heure"
        }
    ]
}
```

Exemple en associant votre commande à une réservation d'articles:
&#x2A;Vous pouvez, par exemple, créer une réservation d'articles et inclure son *nom* dans votre requête.*

```text
{
    "customer": "Roslyn Lépicier",
    "items": [
        {
            "item_code": "Salle de coworking",
            "delivery_date": "2022-04-01",
            "qty": 1,
            "uom": "Heure",
            "item_booking": "STO-BOOK-2022-00102"
        }
    ]
}
```

::callout
Seuls le champ `customer`et une ligne de commande (`items`) sont obligatoires, mais il est possible d'ajouter une valeur pour n'importe quel autre champ disponible dans le document. :br
Pour connaître les champs disponible et leur caractère obligatoire ou non, il suffit d'aller dans la liste de Réservations d'article et de sélectionner Menu (...) > Personnaliser. :br
Pour les tables enfants (*Sales Order Item* par exemple), sélectionnez *Personnaliser une table enfant* dans la page de personnalisation de formulaire.
::

## Valider une commande

Pour valider une commande vous pouvez passer le statut de document 1 dans votre document:

```text
{
    "customer": "Roslyn Lépicier",
    "docstatus": 1,
    "items": [
        {
            "item_code": "Salle de coworking",
            "delivery_date": "2022-04-01",
            "qty": 1,
            "uom": "Heure",
            "item_booking": "STO-BOOK-2022-00102"
        }
    ]
}
```

Vous pouvez également utiliser l'API suivante pour soumettre un brouillon déjà créé et renvoyé par l'API:

`http://localhost:8000/api/method/frappe.client.submit`

Avec, dans le corps de l'appel, un brouillon de commande créé précédemment:

```text
{
    "doc": {
        "name": "SAL-ORD-2022-00116",
        "owner": "thierry@dokos.io",
        "creation": "2022-03-01 18:31:44.895404",
        "modified": "2022-03-01 18:31:44.895404",
        "modified_by": "thierry@dokos.io",
        "parent": null,
        "parentfield": null,
        "parenttype": null,
        "idx": 0,
        "docstatus": 0,
        "title": "{customer_name}",
        "naming_series": "SAL-ORD-.YYYY.-",
        "customer": "Roslyn L\u00e9picier",
        "customer_name": "Roslyn L\u00e9picier",
        "order_type": "Sales",
        "skip_delivery_note": 0,
        "amended_from": null,
        "company": "MappeMonde",
        "transaction_date": "2022-03-01",
        "delivery_date": "2022-04-01",
        "po_no": null,
        "po_date": null,
        "tax_id": null,
        "customer_address": "Roslyn L\u00e9picier-Facturation",
        "address_display": "23 rue Clement Marot<br>66100 PERPIGNAN<br>\nFrance<br>\n",
        "contact_person": "Roslyn L\u00e9picier-Roslyn L\u00e9picier",
        "contact_display": "Roslyn L\u00e9picier",
        "contact_phone": "04.37.73.66.41",
        "contact_mobile": "",
        "contact_email": "RoslynLepicier@armyspy.com",
        "company_address": null,
        "company_address_display": null,
        "shipping_address_name": "Roslyn L\u00e9picier-Facturation",
        "shipping_address": "23 rue Clement Marot<br>66100 PERPIGNAN<br>\nFrance<br>\n",
        "customer_group": "Tous les Groupes Client",
        "territory": "Tous les Territoires",
        "currency": "EUR",
        "conversion_rate": 1.0,
        "selling_price_list": "Vente Standard",
        "price_list_currency": "EUR",
        "plc_conversion_rate": 1.0,
        "ignore_pricing_rule": 0,
        "set_warehouse": null,
        "scan_barcode": null,
        "total_qty": 1.0,
        "base_total": 5.0,
        "base_net_total": 5.0,
        "total_net_weight": 0.0,
        "total": 5.0,
        "net_total": 5.0,
        "tax_category": "",
        "shipping_rule": null,
        "taxes_and_charges": null,
        "other_charges_calculation": null,
        "base_total_taxes_and_charges": 0.0,
        "total_taxes_and_charges": 0.0,
        "loyalty_points": 0,
        "loyalty_amount": 0.0,
        "coupon_code": null,
        "apply_discount_on": "Grand Total",
        "base_discount_amount": 0.0,
        "additional_discount_percentage": 0.0,
        "discount_amount": 0.0,
        "base_grand_total": 5.0,
        "base_rounding_adjustment": 0.0,
        "base_rounded_total": 5.0,
        "base_in_words": "Five Euro",
        "grand_total": 5.0,
        "rounding_adjustment": 0.0,
        "rounded_total": 5.0,
        "in_words": "Five Euro",
        "advance_paid": 0.0,
        "disable_rounded_total": 0,
        "payment_terms_template": null,
        "tc_name": null,
        "terms": null,
        "is_internal_customer": 0,
        "represents_company": null,
        "inter_company_order_reference": null,
        "project": null,
        "party_account_currency": null,
        "source": null,
        "campaign": null,
        "external_reference": null,
        "language": "fr",
        "letter_head": null,
        "select_print_heading": null,
        "group_same_items": 0,
        "status": "Draft",
        "delivery_status": "Not Delivered",
        "per_delivered": 0.0,
        "per_billed": 0.0,
        "billing_status": "Not Billed",
        "sales_partner": null,
        "commission_rate": 0.0,
        "total_commission": 0.0,
        "from_date": null,
        "to_date": null,
        "subscription": null,
        "auto_repeat": null,
        "doctype": "Sales Order",
        "items": [
            {
                "name": "5317c1c489",
                "owner": "thierry@dokos.io",
                "creation": "2022-03-01 18:31:44.895404",
                "modified": "2022-03-01 18:31:44.895404",
                "modified_by": "thierry@dokos.io",
                "parent": "SAL-ORD-2022-00116",
                "parentfield": "items",
                "parenttype": "Sales Order",
                "idx": 1,
                "docstatus": 0,
                "item_code": "Salle de coworking",
                "customer_item_code": null,
                "ensure_delivery_based_on_produced_serial_no": 0,
                "delivery_date": "2022-04-01",
                "item_name": "Salle de coworking",
                "description": "<div><p>R\u00e9servez votre place dans notre salle de coworking</p></div>",
                "item_group": "Coworking",
                "brand": null,
                "image": "/assets/tierslieux/images/coworking.jpg",
                "qty": 1.0,
                "stock_uom": "Heure",
                "uom": "Heure",
                "conversion_factor": 1.0,
                "stock_qty": 1.0,
                "price_list_rate": 5.0,
                "base_price_list_rate": 5.0,
                "margin_type": "",
                "margin_rate_or_amount": 0.0,
                "rate_with_margin": 0.0,
                "discount_percentage": 0.0,
                "discount_amount": 0.0,
                "base_rate_with_margin": 0.0,
                "rate": 5.0,
                "amount": 5.0,
                "item_tax_template": null,
                "base_rate": 5.0,
                "base_amount": 5.0,
                "pricing_rules": "[]",
                "stock_uom_rate": 5.0,
                "is_free_item": 0,
                "net_rate": 5.0,
                "net_amount": 5.0,
                "base_net_rate": 5.0,
                "base_net_amount": 5.0,
                "billed_amt": 0.0,
                "valuation_rate": 0.0,
                "gross_profit": 5.0,
                "delivered_by_supplier": 0,
                "supplier": null,
                "weight_per_unit": 0.0,
                "total_weight": 0.0,
                "weight_uom": null,
                "warehouse": "Magasins - MM",
                "target_warehouse": null,
                "prevdoc_docname": null,
                "against_blanket_order": 0,
                "blanket_order": null,
                "blanket_order_rate": 0.0,
                "bom_no": null,
                "projected_qty": 0.0,
                "actual_qty": 0.0,
                "ordered_qty": 0.0,
                "planned_qty": 0.0,
                "work_order_qty": 0.0,
                "delivered_qty": 0.0,
                "produced_qty": 0.0,
                "returned_qty": 0.0,
                "additional_notes": null,
                "item_booking": "STO-BOOK-2022-00102",
                "page_break": 0,
                "item_tax_rate": "[]",
                "transaction_date": "2022-03-01",
                "doctype": "Sales Order Item",
                "__unsaved": 1
            }
        ],
        "pricing_rules": [],
        "taxes": [],
        "packed_items": [],
        "payment_schedule": [
            {
                "name": "242d92065b",
                "owner": null,
                "creation": "2022-03-01 18:31:45.484130",
                "modified": "2022-03-01 18:31:45.484130",
                "modified_by": "thierry@dokos.io",
                "parent": "SAL-ORD-2022-00116",
                "parentfield": "payment_schedule",
                "parenttype": "Sales Order",
                "idx": 1,
                "docstatus": 0,
                "payment_term": null,
                "description": null,
                "due_date": "2022-03-01",
                "mode_of_payment": null,
                "invoice_portion": 100.0,
                "discount_type": null,
                "discount_date": null,
                "discount": 0.0,
                "payment_amount": 5.0,
                "outstanding": 5.0,
                "paid_amount": 0.0,
                "discounted_amount": 0.0,
                "base_payment_amount": 5.0,
                "doctype": "Payment Schedule"
            }
        ],
        "sales_team": []
    }
}
```

::callout
Vous pouvez trouver d'autres méthodes d'API disponibles dans ce fichier: <https://gitlab.com/dokos/dodock/-/blob/develop/frappe/client.py>{rel=""nofollow""}
::

## Créer une facture à partir d'une commande

Vous pouvez créer une facture depuis une commande existante en appelant l'API suivante:

`http://localhost:8000/api/method/erpnext.selling.doctype.sales_order.sales_order.make_sales_invoice`

Corps de l'appel:

```text
{
    "source_name": "SAL-ORD-2022-00116"
}
```

Ensuite il ne vous reste plus qu'à poster la facture directement ou via les API de frappe.client

::callout
Vous pouvez modifier le contenu de la facture avant de la poster, pour changer les quantités ou montants facturés par exemple.
::

## Créer un paiement à partir d'une commande

Vous pouvez créer un paiement à partir d'une commande en appelant l'API suivante:

`http://localhost:8000/api/method/erpnext.accounts.doctype.payment_entry.payment_entry.get_payment_entry`

Corps de l'appel:

```text
{
        "dt": "Sales Order",
        "dn": "SAL-ORD-2022-00116"
}
```

Ensuite il ne vous reste plus qu'à poster le paiement directement ou via les API de frappe.client


# Ressources

::swagger{app="dodock"}
::


# Type de document

Un type de document est le bloc de construction de base de toute application basée sur le framework Frappe.

Il décrit le **Modèle** et la **Vue de vos données**. Il contient quels champs sont stockés pour vos données et comment ils se comportent les uns avec les autres. Il contient des informations sur la façon dont vos données sont nommées. Les formulaires tels que les bons de commande, les factures de vente, les bons de travail sont ajoutés en tant que DocTypes dans le backend.

Le type de document vous permet d'insérer des formulaires personnalisés dans Dokos selon vos besoins.

---

Faites bien la différence entre **Type de document** et un **document**

**Un Type de document** : le plan ou “moule”
Définitions des champs, propriétés et droits d’accès

**Document** : C'est une instance, c'est-à-dire un exemplaire tiré du plan.

## 1. Créer un nouveau modèle de **Type de document**

1. Allez sur la liste de tous les types de document
2. Cliquez sur **+ Ajouter Type de document**
   Ou vous pouvez saisir **Type de document** dans la barre de recherche.

![doctype\_1.png](https://doc.dokos.io/content/cas_usage_booming_tiers_lieu/revue_de_presse/doctype_1.png)

3. Accédez au formulaire qui permet de définir les **informations du nouveau document**.
4. Nommer le document dans le champ **Nom**
5. Sélectionnez le **module** qui sera associé au document.

![doctype\_2.png](https://doc.dokos.io/content/cas_usage_booming_tiers_lieu/revue_de_presse/doctype_2.png)

Dans le partie **contenu**, vous pouvez définir tous les champs du document. Il s'agit des champs que les utilisateurs devront remplir pour valider une Revue de presse.

Dans ce cas là, vous pouvez ajouter les champs suivants :

- Utilisateur
- Date de publication
- Sujet de la revue de presse
- Description de la revue de presse

Etc..

### 1.1 **Les informations de la table**

1. **Libelle** : Nom du champ créé.
2. Le **Type** permet de définir le type de ces données, il existe plusieurs choix possible. &#x2A;Les plus utilisés sont :*

   - Type **Donnée** : Vous pouvez renseigner du texte personnalisé.
   - Type **Lien** : Vous pouvez choisir les données d'un autre document et il vous permet de rediriger et lier le document à un autre.
   - Type **Date** : le champ est mis sous le format d'une date.
   - Type **Saut de colonne** : Il permet de créer un saut de ligne entre les champs.
   - Type **Saut de section** : Vous permet de segmenter votre document en plusieurs parties. Par exemple, Détails généraux, Table des articles, Termes et conditions etc..
   - Type **Sélectionner** : Vous pouve donner des choix en **Options**
     …
3. **Obligation**: Si la case est coché, ce champ sera obligatoire pour pouvoir le valider.
4. **Options** : Quand le **Type** de donnée est **Sélectionner** ou **Lien**, vous devez saisir les choix ou le nom de type de document pour rediriger la page...

![doctype\_3.png](https://doc.dokos.io/content/cas_usage_booming_tiers_lieu/revue_de_presse/doctype_3.png)

5. Le champ suivant est le **Nom automatique** qui sera généré à la création d'un document.

Vous pouvez définir la façon de nommer les différents documents en ce type. Par défaut c’est aléatoire. Ici on utilise la façon [série], on remplit "REVUE.#####" dans ce champ.
![doctype\_4.png](https://doc.dokos.io/content/cas_usage_booming_tiers_lieu/revue_de_presse/doctype_4.png)

6. **Enregistrer** le nouveau document.
7. Créez votre premier document pour votre revue de presse en allant sur :

> Accueil > Module > ****{nom-de-votre-doctype=""}
> ou en recherchant Revue de presse dans la barre de recherche.

![doc\_revue\_de\_presse5.png](https://doc.dokos.io/content/cas_usage_booming_tiers_lieu/revue_de_presse/doc_revue_de_presse5.png)

### 1.2 Paramètres du formulaire

Des paramètres supplémentaires pour le formulaire, les champs d'image, les pièces jointes, la chronologie, etc. peuvent être configurés ici. Pour en savoir plus sur Form, visitez Personnaliser le formulaire .

### 1.3 Paramètres d'affichage

Ici, vous pouvez définir les paramètres d'affichage pour le DocType, comme les champs de recherche, le champ de tri par défaut, l'ordre de tri par défaut, etc.

### 1.4 Règles d'autorisation

Vous pouvez définir ici les règles d'autorisation pour le DocType et configurer les utilisateurs qui pourront utiliser ou apporter des modifications à ce DocType. En savoir plus sur les utilisateurs et les autorisations ici.

### 1.5 Vue Web

Vous pouvez choisir si vous souhaitez une vue Web de ce DocType ou non. Avoir une vue Web pour un DocType permettra aux utilisateurs de votre site Web d'avoir accès aux formulaires. N'hésitez pas à en savoir plus sur les utilisateurs du site Web .

### 1.6 Plus de propriétés

- **Est soumissible** : Vous pouvez choisir si vous souhaitez que ce DocType soit uniquement 'Enregistré' ou qu'il soit également 'Soumis' en cochant et décochant cette case.
- **Est une table enfant** : vous pouvez définir si vous voulez que le nouveau DocType soit une table enfant dans un autre DocType. Consultez la table enfant pour plus d'informations.
- **Est Unique** : Si coché, ce Doctype deviendra un formulaire unique, comme Bon de Commande, que l'utilisateur ne pourra pas reproduire. Par exemple, les paramètres de vente dans le module de vente sont un seul DocType.
- **Est une arborescence** : Quelques DocTypes dans ERPNext sont structurés en arbres, dans lesquels il y a des DocTypes parents et des DocTypes enfants. Par exemple, Doctype Company est structurée en arbre, il y a des sociétés mères ainsi que des sociétés enfants, que nous appelons des filiales. Si vous souhaitez que vos DocTypes soient structurés de la même manière, vous pouvez activer cette option.
- **Entrée rapide** : Vous pouvez sélectionner si vous souhaitez qu'une entrée rapide soit effectuée pour ce DocType. Cela vous permettra de n'entrer que quelques informations obligatoires et d'enregistrer le DocType, afin qu'une saisie rapide soit effectuée. Par exemple, cochez Saisie rapide dans Écriture au journal
- **Suivi des modifications** : Vous pouvez sélectionner cette option si vous souhaitez conserver un journal des modifications apportées à chaque formulaire. Consultez le document Versioning pour plus de compréhension à ce sujet.
- **Suivre les vues** : Vous pouvez sélectionner cette option si vous souhaitez conserver un journal de tous les utilisateurs qui ont vu ce formulaire.
- **Personnalisé** : Ce champ sera coché par défaut lors de l'ajout de Custom Doctype. De même, si vous personnalisez un DocType qui existe déjà dans le système, ce champ par défaut sera décoché.


# Modèles Jinja

Le langage Jinja est utilisé dans *Dokos* pour créer des modèles d'email, des notifications et des formats d'impression personnalisés complexes en y intégrant des variables. Il permet de mélanger du language HTML avec des variables en Python.

Pour en savoir plus sur le langage Jinja et avoir accès à la documentation: [Jinja](https://palletsprojects.com/p/jinja/){rel="&#x22;nofollow&#x22;"}

## Les variables

Lorsque vous envoyez un email depuis un document, qu'un notification est envoyée ou que vous imprimer un document, vous avez accès à tous les champs qui composent votre document de référence. :br
Vous pouvez donc les appeler en utilisant la syntaxe:

```text
{{ doc.nom_du_champ }}
```

`doc` fait référence au document de référence - certain document peuvent également donner accès à d'autres variables - et `nom_du_champ` doit être remplacé par le nom du champ correspondant. :br
La liste des champs composant un document est disponible en cliquant sur l'onglet "Menu > Personnaliser". Le nom du champ est la valeur de la colonne "Nom" du tableau des champs.

## Les méthodes

Souvent l'accès à une variable n'est pas suffisant pour afficher les informations qui nous intéressent et il faut qu'on puisse soit changer le format d'affichage de la valeur soit avoir accès aux valeurs renseignées dans d'autres documents.

*Dokos* donne accès à un certain nombre de méthodes qui peuvent être appelées en Jinja pour ces besoins:

```py
json # module json
dict # dict interne
frappe._ # méthode de traduction
frappe._dict # méthode interne frappe._dict
frappe.flags # flags globaux

# FORMATTAGE
frappe.format # frappe.format_value(value, dict(fieldtype='Currency'))
frappe.format_value # frappe.format_value(value, dict(fieldtype='Currency'))
frappe.date_format # format de date par défaut
frappe.format_date # retourne une date sous la forme "1er septembre 2019"

# SESSION
frappe.form_dict # paramètres de requêtes / formulaires
frappe.request # objet de requête
frappe.response # objet de réponse
frappe.session.user # utilisateur actuel
frappe.session.csrf_token # jeton CSRF de la session en cours
frappe.user  # utilisateur actuel
frappe.get_fullname # nom complet de l'utilisateur actuel
frappe.get_gravatar # frappe.utils.get_gravatar_url
frappe.full_name = # nom complet de l'utilisateur actuel

# ACCES AUX DONNEES
frappe.get_meta # obtenir l'objet de métadonnées
frappe.get_doc
frappe.get_cached_doc
frappe.get_list
frappe.get_all
frappe.get_system_settings

# BASE DE DONNEE
frappe.db.get_list
frappe.db.get_all
frappe.db.get_value
frappe.db.get_single_value
frappe.db.get_default
frappe.db.escape

# UTILITAIRES
frappe.msgprint # msgprint
frappe.get_hooks # hooks de l'application
frappe.utils # méthodes de frappe.utils
frappe.render_template # frappe.render_template,
frappe.get_url # frappe.utils.get_url
frappe.socketio_port # port pour socketio
frappe.sanitize_html # Assainissement du HTML
style.border_color # '#d1d8dd'
guess_mimetype = mimetypes.guess_type,
html2text = html2text,
dev_server # Vrai si en mode développeur
```

## Exemple de modèle d'email

Dans cet exemple, on peut utiliser ce modèle dans tous les documents qui ont un champ "contact\_person" (Personne de contact). Dans notre cas nous comptons utiliser ce modèle depuis les factures de vente.

Le script va d'abord aller chercher le contenu de la fiche "Contact" correspondant à la personne renseignée dans le champ "contact\_person" et l'enregistrer dans une variable "contact". :br
On a ensuite accès aux valeurs de tous les champs de cette fiche contact et on peut récupérer le prénom de notre contact dans notre email.

```text
{% set contact = frappe.get_doc("Contact", contact_person) %}
Bonjour {{ contact.first_name }},

Veuillez trouver ci-joint votre facture.

Le total à régler est de {{ doc.grand_total }}

Bien cordialement,

XXX

```

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Vous avez sûrement remarqué que dans les modèles d'email on n'utilise pas le préfixe `doc.` avant d'appeler un champ de notre document de référence.
C'est une différence historique de fonctionnement entre les modèles d'emails et les autres documents qui sera probablement corrigée à l'avenir.
::

## Exemple de notification

Nous souhaitons envoyer une notification automatique lorsque quelqu'un fait une réservation de salle en ligne.
Contrairement aux modèles d'email que l'on peut modifier dans l'éditeur d'email avant envoi, les notifications sont envoyées toutes seules et il faut donc s'assurer qu'elles sont correctement formattées. On va donc utiliser du HTML dans notre modèle pour garantir la structure de notre email.

Cet exemple est un email envoyé lors de la création de la commande correspondant à la validation de la réservation - lorsque l'utilisateur·rice clique sur "Passer la commande" dans son panier.

```html
<!--On affiche directement le nom du contact ou rien si ce champ n'est pas rempli-->
<p>Bonjour {{ doc.contact_display or "" }},</p>

<p>Merci pour votre réservation, celle-ci est bien prise en compte.</p>
<p>En voici le détail :</p>

<!--On affiche le détail de sa réservation dans un tableau. Vous pouvez utiliser la librairie Bootstrap pour le formattage.-->
<table class="table table-bordered">
    <thead>
        <tr>
            <th>Description</th>
            <th>Heure et date</th>
        </tr>
    </thead>
    <tbody>
        <!--On itère sur les différentes lignes de la commande pour en imprimer le détail-->
        {% for item in doc.items %}
        <!--On utilise la méthode frappe.db.get_value pour récupérer l'heure de début et l'heure de fin de la réservation d'article correspondant à la ligne de commande-->
        {% set booking_start = frappe.db.get_value("Item Booking", item.item_booking, "starts_on") %}
        {% set booking_end = frappe.db.get_value("Item Booking", item.item_booking, "ends_on") %}
        <tr>
            <td>{{ item.description or "" }}</td>
            <td>
                <!--On utilise la méthode frappe.utils.formatdate pour formatter la date de début de la réservation-->
                <span>{{ frappe.utils.formatdate(booking_start) }} </span>
                <!--On utilise la méthode frappe.utils.get_time pour récupérer l'heure de début et de fin de la réservation et on la formatte avec la méthode standard Python strftime-->
                <span>{{ frappe.utils.get_time(booking_start).strftime("%H:%M") }} - {{ frappe.utils.get_time(booking_end).strftime("%H:%M") }}</span>
            </td>
        </tr>
        <!--On indique à Jinja que notre itération s'arrête là-->
        {% endfor %}
    </tbody>
</table>


<br>
<p>Si vous avez une question ou besoin d'information pour préparer votre venue, n'hésitez pas à revenir vers moi.</p>

<p>A bientôt,</p>

<p>XXXXX</p>
```

## Exemple de format d'impression

Il est possible de créer vos propres formats d'impression personnalisés en Jinja dans *Dokos*.
Voici un exemple de facture entièrement personnalisée:

```html
{% if letter_head and not no_letterhead %}
<div class="letter-head">{{ letter_head }}</div>
{% endif %}
<div class="row">
    <div class="col-xs-6 col-xs-push-6">
        <div class="row">
            {% set salutation = frappe.db.get_value("Customer", doc.customer, "salutation") %}
            <div class="col-xs-12 text-left "><strong>{{ salutation or '' }} {{ doc.customer_name }}</strong></div>
        </div>
        {% if doc.customer_address %}
            {% set client_address = frappe.get_doc("Address", doc.customer_address) %}
            <div class="row">
                <div class="col-xs-12 text-left">
                    {{ client_address.address_line1 }}<br> {% if client_address.address_line2 %}{{ client_address.address_line2 }}<br>{% endif %} {{ client_address.pincode }} {{ client_address.city }}<br> {{ client_address.country }}
                </div>
            </div>
        {% endif %}
    </div>
</div>
{% if doc.print_heading_template %}
    {{ frappe.render_template(doc.print_heading_template, {"doc":doc}) }}
{% else %}
    <div class="print-heading">
        <h2>{{ doc.select_print_heading or (doc.print_heading if doc.print_heading != None else _(doc.doctype)) }}</h2>
    </div>
{% endif %}
{%- if doc.meta.is_submittable and doc.docstatus==0 and (print_settings==None or print_settings.add_draft_heading) -%}
    <div class="text-center" document-status="draft">
        <h4 style="margin: 0px;">{{ _("DRAFT") }}</h4>
    </div>
{%- endif -%}
{%- if doc.meta.is_submittable and doc.docstatus==2-%}
    <div class="text-center" document-status="cancelled">
        <h4 style="margin: 0px;">{{ _("CANCELLED") }}</h4>
    </div>
{%- endif -%}
<div>
    <div id="footer-html" class="visible-pdf">
        {% if not no_letterhead and footer %}
        <div class="letter-head-footer visible-pdf">
            {{ footer }}
        </div>
        {% endif %}
        <p class="text-center small page-number visible-pdf">
            {{ _("Page {0} of {1}").format('<span class="page"></span>', '<span class="topage"></span>') }}
        </p>
    </div>

    <div class="row">
        <div class="col-xs-6">
      {% set account_manager = frappe.db.get_value("Customer", doc.customer, "account_manager") %}
      {% if account_manager %}
      {% set user = frappe.get_doc("User", account_manager) %}
            <div class="row">
                <div class="col-xs-4 text-left"> <label>{{ _("Contact") }}</label> </div>
                <div class="col-xs-8 text-left ">
                    <strong>{{ user.first_name or ''}} {{ user.last_name or '' }}</strong></div>
            </div>
            <div class="row">
                <div class="col-xs-4 text-left"> <label>{{ _("Email") }}</label> </div>
                <div class="col-xs-8 text-left ">
                    {{ user.email or ''}}</div>
            </div>
            <div class="row">
                <div class="col-xs-4 text-left"> <label>{{ _("Phone") }}</label> </div>
                <div class="col-xs-8 text-left ">
                    {{ user.phone or ''}}</div>
            </div>
      {% endif %}
        </div>

        <div class="col-xs-6">
            <div class="row">
                <div class="col-xs-5 text-left"><label>{{ _("Invoice Number") }}</label></div>
                <div class="col-xs-7 text-left ">{{ doc.sub_heading if doc.sub_heading != None else doc.name }}</div>
            </div>
            <div class="row">
                <div class="col-xs-5 text-left"> <label>{{ _("Date") }}</label> </div>
                <div class="col-xs-7 text-left ">{{ doc.get_formatted("posting_date") or ''}}</div>
            </div>
            <div class="row">
                <div class="col-xs-5 text-left"> <label>{{ _("Due Date") }}</label> </div>
                <div class="col-xs-7 text-left">
                    {{ doc.get_formatted("due_date") or ''}}</div>
            </div>
        </div>
    </div>

    <table class="table table-condensed table-bordered">
        <tr>
            <th>{{ _("Description") }}</th>
            <th>{{ _("Quantity") }}</th>
            <th class="text-right">{{ _("Rate") }}</th>
            <th class="text-right">{{ _("Amount") }}</th>
        </tr>
        {%- for row in doc.items -%}
        <tr>
            <td style="width: 55%;">{{ row.item_name or '' }}</td>
            <td style="width: 15%;">{{ row.get_formatted("qty") }} {{ row.stock_uom }}</td>
            <td style="width: 15%; text-align: right;">

                {{ row.get_formatted("rate", doc) or ''}}
                <td style="width: 15%; text-align: right;">{{ row.get_formatted("amount", doc) or ''}}</td>
        </tr>
        {%- endfor -%}
        </tbody>
    </table>

    <div class="row">
        <div class="col-xs-6 text-right"></div>
        <div class="col-xs-4 text-right"><label>{{ _("Total") }}</label></div>
        <div class="col-xs-2 text-right">{{ doc.get_formatted("total") or '' }}</div>
    </div>
    <br>
    {%- if doc.discount_amount -%}
        <div class="row">
            <div class="col-xs-6 text-right"></div>
            <div class="col-xs-4 text-right"><label>{{ _("Discount") }}</label></div>
            <div class="col-xs-2 text-right">- {{ doc.get_formatted("discount_amount") }}</div>
        </div>
        <div class="row">
            <div class="col-xs-6 text-right"></div>
            <div class="col-xs-4 text-right"><label>{{ _("Net Total") }}</label></div>
            <div class="col-xs-2 text-right">{{ doc.get_formatted("net_total") or '' }}</div>
        </div>
        <br>
    {%- endif -%}
    {%- for row in doc.taxes -%}
        {%- if row.tax_amount_after_discount_amount -%}
            <div class="row">
                <div class="col-xs-6 text-right"></div>
                <div class="col-xs-4 text-right"><label>{{ row.description }}</label></div>
                <div class="col-xs-2 text-right">{{ row.get_formatted("tax_amount_after_discount_amount", doc) }}</div>
            </div>
        {%- endif -%}
    {%- endfor -%}

    {%- if doc.taxes or doc.discount_amount -%}
        <br>
        <div class="row">
            <div class="col-xs-6 text-right"></div>
            <div class="col-xs-4 text-right"><label>{{ _("Grand Total") }}</label></div>
            <div class="col-xs-2 text-right"><strong>{{ doc.get_formatted("grand_total") }}</strong></div>
        </div>
    {% endif %}
    {% set customer = frappe.get_doc("Customer", doc.customer) %}
    {% if customer.tax_id %}
        <br>
        <div class="row">
            <div class="col-xs-2 text-left"><label>{{ _("Customer VAT N°") }}</label></div>
            <div class="col-xs-10">{{ customer.tax_id }}</div>
        </div>
        </div>
    {% endif %}
    <br>
    {% if doc.remarks -%}
        <div class="row">
            <div class="col-xs-2 text-left"><label>{{ _("Remarks") }}</label></div>
            <div class="col-xs-10">{{ doc.remarks }}</div>
        </div>
    {%- endif %}

    <br>
    <div class="row">
        <div class="col-xs-12 text-left"><label>{{ _("IBAN") }}</label></div>
    </div>
    <div class="row">
        <div class="col-xs-12 text-left">
            <p>ABCXXXXXXXXXXXXXX</p>
        </div>
    </div>

    <p style="page-break-after:always;"></p>

    <div class="row">
        <div class="col-xs-12 text-left">{{ doc.terms or '' }}</div>
    </div>
</div>
```


# Scripts serveur Python

**Un script serveur Python vous permet d'écrire un script exécuté sur le serveur et déclenché via un événement de document ou via un appel à l'API web**

## 1. Comment créer un script serveur en Python

Pour créer un script serveur

1. Vous devez ajouter la clé `server_script_enabled` et la définir à `true` (ou `1`) dans le fichier common\_site\_config.json du bench.
2. Pour ajouter / modifier un script serveur, assurez-vous d'avoir le rôle **Gestionnaire de script**
3. Créez un nouveau script serveur via "Nouveau script serveur" dans la barre d'outils
4. Choisissez le type de script serveur (Evénement de document / API)
5. Choisissez le type de document de référence et le nom de l'événement, ou le nom de la méthode, ajoutez votre script et enregistrez.

> Depuis 2024

## 2. Fonctionnalités

### 2.1 Autoriser les scripts serveur

Les scripts serveur doivent être activés via le fichier common\_site\_config.json ou avec la ligne de commande suivante :

```sh
bench set-config -g server_script_enabled true
```

### 2.2 Evénements de document

Pour les scripts qui sont lancés via des événements de documents, vous devez définir le type de document de référence et nom de l'événement générateur

- Avant l'insertion
- Avant l'enregistrement
- Après l'enregistrement
- Avant la validation
- Après la validation
- Avant l'annulation
- Après l'annulation
- Avant la suppression
- Après la suppression

### 2.3 Scripts API

Vous pouvez créer une nouvelle API qui sera accessible via `/api/method/[methodname]` en sélectionnant le type de script "API"

Si vous voulez qu'un utilisateur invité (non connecté) accède à l'API, cochez la case "Autoriser les invités".

La réponse sera envoyés dans un objet de type `frappe.response["message"]`

### 2.3 Securité

Dokos utilise la librairie RestrictedPython pour restreindre l'accès aux méthodes disponibles pour les scripts Python. Seules les méthodes sûres, listées ci-dessous sont disponibles dans les scripts serveur.

```py
json # module json
dict # dict interne
_ # méthode de traduction
_dict # méthode interne frappe._dict
frappe.flags # flags globaux

# FORMATTAGE
frappe.format_value # frappe.format_value(value, dict(fieldtype='Currency'))
frappe.date_format # format de date par défaut
frappe.format_date # retourne une date sous la forme "1er septembre 2019"

# SESSION
frappe.form_dict # paramètres de requêtes / formulaires
frappe.request # objet de requête
frappe.response # objet de réponse
frappe.session.user # utilisateur actuel
frappe.session.csrf_token # jeton CSRF de la session en cours
frappe.user  # utilisateur actuel
frappe.get_fullname # nom complet de l'utilisateur actuel
frappe.get_gravatar # frappe.utils.get_gravatar_url
frappe.full_name = # nom complet de l'utilisateur actuel

# ACCES AUX DONNEES
frappe.get_meta # obtenir l'objet de métadonnées
frappe.get_doc
frappe.get_cached_doc
frappe.get_list
frappe.get_all
frappe.get_system_settings

# BASE DE DONNEE
frappe.db.get_list
frappe.db.get_all
frappe.db.get_value
frappe.db.get_single_value
frappe.db.get_default
frappe.db.escape

# UTILITAIRES
frappe.msgprint # msgprint
log # création d'un log dans la console du navigateur
frappe.log_error # création d'un log d'erreur
frappe.get_hooks # hooks de l'application
frappe.utils # méthodes de frappe.utils
frappe.render_template # frappe.render_template,
frappe.get_url # frappe.utils.get_url
frappe.socketio_port # port pour socketio
frappe.sanitize_html # Assainissement du HTML
style.border_color # '#d1d8dd'
guess_mimetype = mimetypes.guess_type
html2text = html2text
dev_server # Vrai si en mode développeur
```

## 3. Exemples

### 3.1 Changer la valeur d'une propriété avant enregistrement

Type de script: **Avant l'enregistrement**

```py
if "test" in doc.description:
    doc.status = 'Closed'
```

### 3.2 Validation personnalisée

Type de script:: **Avant l'enregistrement**

```py
if "validate" in doc.description:
    raise frappe.ValidationError
```

### 3.3. Auto création d'une ToDo

Type de script: **Après l'enregistrement**

```py
if doc.allocted_to:
    frappe.get_doc(dict(
        doctype = 'ToDo'
        owner = doc.allocated_to,
        description = doc.subject
    )).insert()
```

### 3.4 API

- Type de script: **API**
- Nom de la méthode: `test_method`

```py
frappe.response['message'] = "hello"
```

Requête: `/api/method/test_method`

### 3.5 Création d'une réservation d'articles quand d'autres salles sont réservées

- Type de script: **Après l'enregistrement**

👨‍💼 Le cas d’usage (réel)
Un tiers-lieu a deux salles de réunions : la salle 1 (1ère étage) et 2 (2e) qu’ils louent à des assos, entreprises etc. Ils souhaitent proposer la salle 1 pour du coworking lorsqu’elle n’est pas utilisée avec à terme la possibilité pour les usagers de réserver eux-mêmes en ligne.

🤔 Problème : il faut pouvoir empêcher la réservation du coworking quand les deux salles sont louées.

💡 Une solution : Un script Python qui vient automatiquement réserver tout les créneaux de coworking lorsque il y a chevauchement entre les réservations de la salle 1 et 2.

```py
#****Script parameters****
master_room1 = "Salle réunion 1"
master_room2 = "Salle réunion 2"
slave_room = "Salle de coworking"

# Constraint: If two master rooms are booked at the same time, then the slave room is booked
# too during the overlap
#****0/ Script only does something if item is one of the two master rooms****
if doc.item == master_room1 or doc.item == master_room2:
    #****1/ Get list of bookings confirmed on the same day, exclusive of the slave room****
    booking_list = frappe.db.get_list('Item Booking',
        filters=[
            ['status','=', 'Confirmed'],
            ['name','!=', doc.name],
            ['item', '!=', slave_room],
            ['starts_on','>=',frappe.utils.getdate(doc.starts_on)],
            ['starts_on' ,'<',frappe.utils.add_to_date(frappe.utils.getdate(doc.ends_on),days=1) ]
        ],
        fields=['name'],
        as_list=True
    )
    # Assign datetime data to variables for clearer code
    start1 = frappe.utils.get_datetime(doc.starts_on)
    end1 = frappe.utils.get_datetime(doc.ends_on)
    #****2/ Cycle through all the slots identified to check for overlaps****
    for x in booking_list:
        item_booking = frappe.get_doc('Item Booking', ''.join(x))
        # Assign datetime data to variables for clearer code
        start2 = frappe.utils.get_datetime(item_booking.starts_on)
        end2 = frappe.utils.get_datetime(item_booking.ends_on)
        #-- Conditions to check for overlaps (hard to get one's head around without a schematic) --
        # Initialisation of a flag to check if one of the condition is met
        overlapflag = 0
        # Initialisation of slave start and end as the same as current doc
        slavestart = start1
        slaveend = end1
        # Tail of previous slots overlaps with current doc
        if end2 > start1 and end2 < end1:
            slaveend = end2
            overlapflag = overlapflag + 1
        # Start of previous slots overlaps with tail of current doc
        if start2 > start1 and start2 < end1:
            slavestart = start2
            overlapflag = overlapflag + 1
        # Current doc is completely contained by previous slot
        if start2 < start1 and end2 > end1:
            slavestart = start1
            slaveend = end1
            overlapflag = overlapflag + 1
        #****3/Create a new slot to book the room if an overlap has been found****
        if overlapflag:
            # Get number of simultaneous bookings allowed
            slave_item = frappe.get_doc("Item", slave_room)
            n_slots = slave_item.simultaneous_bookings_allowed
            frappe.msgprint("Nombre de slots = " + str(n_slots))
            # Create enough slots to fill the slave room
            for x in range(n_slots):
                frappe.msgprint("Création d'une réservation pour l'article : " + slave_room)
                slave = frappe.get_doc({
                    "doctype": "Item Booking",
                    "title" : "résa scriptée",
                    "item" : slave_room,
                    "status" : "Confirmed",
                    "starts_on" : slavestart,
                    "ends_on" : slaveend
                    })
                slave.insert()
        overlapflag = 0
    else:
        pass
```


# Joindre/Joindre une image

Les champs **Joindre** (`Attach`) et **Joindre une image** (`Attach Image`) permettent de stocker un lien vers un fichier ou une image.

Le contenu du champ dans un document est donc un lien vers un fichier ou une image, comme par exemple :

- `/files/image.jpg`
- `/private/files/fichier.pdf`
- `http://www.domaine.com/fichier.pdf`

Dans le cas d'un fichier privé, ce dernier n'est accessible que par les utilisateurs connectés et ayant les droits d'accès de lecture du Fichier lié à ce champ.

## Options

Il est possible de définir une valeur *options* pour les champs de type **Joindre** et **Joindre une image**.

Pour l'instant, les deux valeurs possibles du champ *options* sont :

- `Private` : le fichier sera forcément privé
- `Public` : le fichier sera forcément public

Si aucune valeur n'est définie (par défaut), le Fichier joint pourra être privé ou public selon le choix de l'utilisateur et le contexte d'utilisation du champ (e.g. formulaire web).

Les champs avec *options* valant `Private` sont utiles pour tous les types de documents destinés à être publiés sur le site web et accessible aux visiteurs (Guest), comme par exemple les documents de type **Page** ou **Article de Blog**.

## Pour aller plus loin

- [Documentation Frappe sur les types de champ](https://frappeframework.com/docs/v14/user/en/basics/doctypes/fieldtypes#attach){rel="&#x22;nofollow&#x22;"}


# Tous les DocFields

<https://frappeframework.com/docs/v14/user/en/basics/doctypes/fieldtypes>{rel="&#x22;nofollow&#x22;"}


# Applications personnalisées

Vous pouvez créer des applications personnalisées.


# Créer des champs additionnels à l'aide d'une application personnalisée

En plus de vos propres DocTypes, il est possible de créer des champs personnalisés via une application personnalisée, pour simplifier la maintenance, synchroniser plusieurs sites (dev, test, préprod, prod, …), le tout sans utiliser l'interface graphique de personnalisation.

```py [my_app/hooks.py]
after_install = "my_app.install.after_install"
after_migrate = "my_app.install.after_migrate"
```

```py [my_app/install.py]
import frappe
from frappe.custom.doctype.custom_field.custom_field import create_custom_fields

# The existing OLD_FIELDS will always be deleted first.
# Make sure to include all fields that you create in this list.
# When removing a field from the CUSTOM_FIELDS list, keep its entry in the OLD_FIELDS.
# This will ensure that future migrations will correctly remove obsolete fields.
# The fields will be created in module MODULE.
# System generated property setters are always removed before migrate.
# Make sure to keep them in the PROPERTY_SETTERS list until they become obsolete.

MODULE = "My App"

OLD_FIELDS = [
    ("Customer", "my_field"),
]

CUSTOM_FIELDS = {
    "Customer": [
        {
            "fieldname": "my_app_field",
            "label": "My Field",
            "fieldtype": "Data",
            "insert_after": "customer_name",
        },
    ],
}

PROPERTY_SETTERS = [
    # {
    #   "name": "DOCTYPE-FIELD-PROPERTY",
    #   "doc_type": "DOCTYPE",
    #   "doctype_or_field": "DocField",
    #   "field_name": "FIELD",
    #   "property": "PROPERTY",
    #   "value": "VALUE",
    # },
]


def after_install():
    after_migrate()


def after_migrate():
    for dt, fieldname in OLD_FIELDS:
        if name := frappe.db.exists("Custom Field", {"dt": dt, "fieldname": fieldname}):
            frappe.delete_doc("Custom Field", name)

    # Add `module` property and `insert_after` if missing
    for fields in CUSTOM_FIELDS.values():
        prev_field = None
        for field in fields:
            field["module"] = MODULE
            if prev_field and not field.get("insert_after"):
                field["insert_after"] = prev_field["fieldname"]
            prev_field = field

    create_custom_fields(CUSTOM_FIELDS)

    # Insert property setters
    for ps in PROPERTY_SETTERS:
        assert ps["name"], "Property Setter name is required"
        frappe.delete_doc_if_exists("Property Setter", ps["name"])

        doc = frappe.new_doc("Property Setter")  # type: ignore
        doc.is_system_generated = True
        doc.module = MODULE
        doc.update(ps)
        doc.insert()
```


# Filtres

> ##### Je dispose de l'arbre de groupes d'articles suivant et je souhaite filtrer sur tous les articles appartenant au groupe parent *Produits*

::card
#title
Groupes d'articles

#description
- **Produits**

  - *Catégorie A*
  - *Catégorie B*
  - *Catégorie C*
  - *Catégorie D*
::

En filtrant sur les `Descendants de` **Produits**, je peux obtenir tous les articles associés aux groupes d'articles *Catégorie A*, *Catégorie B*, *Catégorie C* ou *Catégorie D*
Si je sélectionne `Egal ou descendants de` **Produits**, je peux obtenir tous les articles associés aux groupes d'articles *Produits*, *Catégorie A*, *Catégorie B*, *Catégorie C* ou *Catégorie D*

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Il est recommandé de ne jamais sélectionner un *groupe parent* dans une transaction. :br
Celle-ci risquerait de ne pas être comptabilisée correctement dans les rapports, puisque le système s'attend à additionner les montants des *enfants* pour obtenir les montant applicable au *groupe parent*
::


# Documentation Frappe

::callout{color="teal" icon="i-heroicons-light-bulb"}
<https://frappeframework.com/docs/v14/user/en/introduction>{rel=""nofollow""}
::


# Limitation de concurrence

Certaines méthodes exposées via `@frappe.whitelist()` peuvent monopoliser un worker Gunicorn pendant toute leur durée d'exécution (génération de rapports complexes, requêtes analytiques lourdes, exports volumineux…). Une rafale de requêtes simultanées peut épuiser tous les workers disponibles et rendre le site complètement inaccessible.

Le décorateur `@frappe.concurrent_limit()` résout ce problème en limitant le nombre d'exécutions simultanées d'une méthode donnée.

## Principe de fonctionnement

::mermaid
sequenceDiagram
participant Client
participant Gunicorn
participant Redis
participant Fonction


```text
Client->>Gunicorn: Requête HTTP
Gunicorn->>Redis: BLPOP token (attente max wait_timeout s)
alt Token disponible
    Redis-->>Gunicorn: token
    Gunicorn->>Fonction: exécution
    Fonction-->>Gunicorn: résultat
    Gunicorn->>Redis: LPUSH token (restitution)
    Gunicorn-->>Client: 200 OK
else Aucun token disponible avant timeout
    Redis-->>Gunicorn: timeout
    Gunicorn-->>Client: 503 Service Unavailable (Retry-After: Xs)
end
```
::

Techniquement, un **pool de jetons** est stocké dans une liste Redis. Chaque slot de concurrence autorisé correspond à un jeton dans cette liste :

- Au démarrage d'une requête, un jeton est extrait de la liste (`BLPOP`).
- À la fin de l'exécution (succès ou erreur), le jeton est restitué (`LPUSH`).
- Si aucun jeton n'est disponible avant l'expiration du délai `wait_timeout`, la requête reçoit une réponse **503** avec un en-tête `Retry-After`.

### Auto-guérison après crash

En cas de crash d'un worker (le jeton n'est jamais restitué), le pool se reconstruit automatiquement grâce à une **TTL d'une heure** sur la clé de capacité Redis. Le site se rétablit sans intervention manuelle.

## Usage

### Décoration d'une méthode exposée

```python
import frappe

@frappe.whitelist()
@frappe.concurrent_limit(limit=3)
def endpoint_couteux(*args, **kwargs):
    # traitement long...
    pass
```

::callout{icon="i-mdi-alert" type="warning"}
`@frappe.concurrent_limit()` doit toujours être placé **après** `@frappe.whitelist()` (c'est-à-dire plus proche de la définition de la fonction).
::

### Paramètres

| Paramètre      | Type         | Défaut       | Description                                                                                                                                               |
| -------------- | ------------ | ------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `limit`        | `int | None` | Auto-détecté | Nombre maximal d'exécutions simultanées. Si `None`, calculé automatiquement : `workers × threads ÷ 2`, dérivé de la ligne de commande du master Gunicorn. |
| `wait_timeout` | `int`        | `10`         | Durée maximale d'attente en secondes avant de renvoyer un 503.                                                                                            |

### Exemple avec délai d'attente personnalisé

```python
@frappe.whitelist()
@frappe.concurrent_limit(limit=5, wait_timeout=30)
def export_rapport_annuel(annee: int):
    """Export pouvant prendre jusqu'à 20 secondes — on tolère une attente de 30 s."""
    ...
```

## Comportement hors requête HTTP

Le décorateur est un **no-op** dans les contextes suivants :

- Jobs en arrière-plan (workers)
- Commandes CLI (`bench execute`, scripts)
- Tests automatisés

Cela évite tout blocage involontaire lors des opérations de maintenance ou de développement.

## Réponse 503 et en-tête `Retry-After`

Lorsque le délai d'attente est dépassé, le framework renvoie automatiquement :

```http
HTTP/1.1 503 Service Unavailable
Retry-After: 10
Content-Type: application/json

{"exc_type": "TooManyConcurrentRequests", "exception": "...", ...}
```

Les clients (applications front-end, intégrations tierces) peuvent lire cet en-tête pour planifier une nouvelle tentative.

## Introspection : obtenir les statistiques de concurrence

Une fonction utilitaire `get_stats` permet de consulter l'état courant du pool pour une fonction donnée :

```python
from frappe.concurrency_limiter import get_stats

stats = get_stats("mon_app.api.endpoint_couteux")
# Exemple de retour :
# {"capacity": 3, "available": 1, "in_use": 2}
```

Cela peut être utile pour des tableaux de bord de supervision ou des alertes opérationnelles.

## Cas d'usage recommandés

| Situation                              | Recommandation                         |
| -------------------------------------- | -------------------------------------- |
| Génération de rapport analytique lourd | `limit=2`, `wait_timeout=60`           |
| Export CSV/Excel de grande volumétrie  | `limit=3`, `wait_timeout=30`           |
| Appel à une API externe lente          | `limit=5`, `wait_timeout=15`           |
| Calcul de prix avec beaucoup de règles | `limit=None` (auto), `wait_timeout=10` |

## Points d'attention

::callout{icon="i-mdi-information" type="info"}
La limite automatique (`limit=None`) est calculée une seule fois au démarrage du worker, à partir de la ligne de commande du master Gunicorn. Si vous modifiez le nombre de workers sans redémarrer l'application, la limite ne sera pas recalculée automatiquement.
::

::callout{icon="i-mdi-alert" type="warning"}
N'appliquez ce décorateur qu'aux méthodes réellement coûteuses. Sur des endpoints rapides, le passage par Redis introduit une latence inutile.
::

## Référence technique

- **Module principal** : `frappe/concurrency_limiter.py`
- **Sémaphore Redis** : `frappe/utils/redis_semaphore.py`
- **Exception levée** : `frappe.exceptions.TooManyConcurrentRequests`
- **Tests** : `frappe/tests/test_concurrency_limiter.py`


# Un logiciel Open-source

La platefome de Dokos est un logiciel libre et open source publié sous licence GNU General Public License (GPLv3). Cette licence vous accorde :

- La liberté d'utiliser le logiciel à quelque fin que ce soit
- La liberté de changer le logiciel en fonction de vos besoins
- La liberté de partager le logiciel avec n'importe qui
- La liberté de partager les changements que vous apportez
- Le code source de Dokos et des modules annexes est disponible sur GitLab à l'adresse <https://gitlab.com/dokos>{rel="&#x22;nofollow&#x22;"}.

### Quels sont les avantages d'un logiciel open-source ?

1. Il n'y a pas de verrouillage avec un fournisseur spécifique.
2. Vous pouvez héberger l'application n'importe où, y compris sur votre propre serveur, pour obtenir l'entière propriété et la confidentialité des données.
3. Vous pouvez accéder à une communauté pour obtenir de l'aide.
4. Vous pouvez bénéficier de l'utilisation d'un produit qui est critiqué et utilisé par un large éventail de personnes, qui ont signalé des centaines de problèmes et des suggestions pour améliorer le produit.

### Un accompagnement possible pour utiliser le logiciel de Dokos

Bien que Dokos soit gratuit et open source, faire fonctionner un serveur pour Dokos, l'implémenter et le prendre en charge n'est pas une tâche facile.

Vous pouvez opter pour une aide professionnelle sur [www.dokos.io](http://www.dokos.io){rel="&#x22;nofollow&#x22;"}. :br
Cela vous permettra de vous concentrer sur la gestion de votre activité et contribuer au financement de ce projet.

### Vous souhaitez contribuer

- Répondez à des questions sur le [Forum](https://community.dokos.io){rel="&#x22;nofollow&#x22;"}
- Remontez les problèmes/bugs que vous rencontrez sur [Gitlab](https://gitlab.com/dokos/dokos/issues){rel="&#x22;nofollow&#x22;"}
- Participez à la rédaction de cette [documentation](https://doc.dokos.io/v5/dodock/contribuer/documentation)
- [Traduisez](https://doc.dokos.io/v5/dodock/contribuer/traductions) ce logiciel dans votre langue


# Traductions

Tous les textes dans Dokos sont traductibles. :br
Si vous trouvez un mot non traductible, veuillez ouvrir un ticket sur [Gitlab](https://gitlab.com/dokos/dokos/issues){rel="&#x22;nofollow&#x22;"}.

## Mécanisme de traduction

Dokos est composé de plusieurs niveaux de données traductibles. Certaines chaînes de caractère traductibles sont disponibles dans des fichiers Python ou Javascript et certaines données enregistrées dans la base de données ont aussi besoin d'être traduites dans l'interface utilisateur pour être lisibles par tous les utilisateurs.

Les catégories principales de données traductibles sont:

- Les mots composant les types de documents
- Les mots dans les fichier Python
- Les mots dans les fichier Javascript
- Les mots dans les fichier HTML
- Les mots dans les fichier VueJs

### Version 1

Afin de permettre les traductions contextuelles pour les langues ayant plusieurs signification pour le même mot, nous avons décidé de permettre différentes traductions pour chacune de ces catégories et, dans le cas des fichiers de code, pour chaque fichier composant le système.

Ces traductions sont disponibles dans des fichiers JSON, disponibles dans le dossier `{nom de l'application}/translations/`

Chaque fichier traductible est listé dans le fichier de traduction JSON:

Avec les mots traductibles correspondants:

### Version 2

Dans la version 2 (et plus) de Dodock/Dokos nous avons décidé d'implémenter l'API contextuelle de Frappe. :br
Chaque chaîne de caractères dans le système peut être traduite telle quelle ou associée à un contexte pour la différencier des chaînes de caractères identiques dans d'autres parties du logiciel.

#### API Python

Les chaînes de caractères traduisibles sont annotées en utilisant la méthode `_` (tiret bas).

`frappe._(chaîne de caractères, contexte)`

::callout
Exemple d'une traduction française :br
frappe.*("Apply") = "Appliquer" :br
frappe.*("Apply", "Job Offer") = "Postuler"
::

#### API Javascript

Les chaînes de caractères traduisibles sont annotées en utilisant la méthode `__` (double tiret bas).

`__(string, [replace], context)`

::callout
Exemple d'une traduction française
\_\_("Apply") = Appliquer :br
\_\_("Apply", null, "Job Offer") = Postuler :br
\_\_("Monthly on day {}", [date\_day] ) = Mensuellement le [jour]
::

### Contextes automatiques

Chaque champ associé à un type de document aura automatiquement le nom du type de document passé en contexte.

::callout
To = A (en général) :br
To = Unité de mesure finale (dans le type de document Facteur de conversion de l'unité de mesure)

Cela se traduira par deux lignes dans le fichier csv: :br
To,A :br
To,Unité de mesure finale,UOM Conversion Factor
::

#### Format de fichier

Les traductions sont disponibles dans un fichier CSV de la forme:

`chaîne traduisible, traduction, contexte,`

S'il n'y a pas de contexte, le format peut être:

`chaîne traduisible, traduction,`

## Corriger des traductions existantes

En utilisant Dokos, vous vous rendez-compte qu'un mot ou une phrase est mal traduite dans votre langue.
Vous avez deux options:

- Créer un ticket sur [Gitlab](https://gitlab.com/dokos/dokos/issues){rel="&#x22;nofollow&#x22;"} décrivant le mot ou la phrase mal traduite et en fournissant la traduction correcte.
  Soyez, s'il vous plaît, très précis (une impression écran est toujours la bienvenue) et gardez en tête que notre équipe ne parle peut-être pas votre langue et aura des difficultés à faire la correction si votre description n'est pas assez précise.
- Allez sur le [code source de dokos](https://gitlab.com/dokos/dokos/tree/develop/erpnext/translations){rel="&#x22;nofollow&#x22;"} ou de [dodock](https://gitlab.com/dokos/dodock/tree/develop/frappe/translations){rel="&#x22;nofollow&#x22;"}.
  Trouvez le fichier correspondant à votre langue, éditez le et proposez une [**merge request**](https://docs.gitlab.com/ee/user/project/merge_requests/){rel="&#x22;nofollow&#x22;"}.
  Cette option est recommandée si vous prévoyez de modifier un grand nombre de traductions en une fois.

## Traduire de nouveaux mots

Si vous souhaitez mettre à jour des mots ou phrases correspondant à la dernière mise à jour de Dokos, vous pouvez aussi récupérer la liste de toutes les chaînes de caractères non encore traduites, les traduires et les fusionner avec les traductions existantes:

### Etape 1 - Obtenir toutes les phrases non traduites

`bench get-untranslated {code de la langue} {chemin vers un fichier temporaire}.json --app {l'application que vous souhaitez traduire}`

Ex. `bench get-untranslated fr /home/dokos_fr.json --app dokos`

### Etape 2 - Traduisez le fichier

Traduisez toutes les phrases dans le fichier JSON généré.

### Etape 3 - Mettez à jour les traductions existantes

Fusionnez vos nouvelles traductions avec les traductions existantes en utilisant la commande suivante:

`bench update-translations {code de la langue} {chemin vers un fichier temporaire}.json {l'application que vous souhaitez traduire}`

Ex. `bench update-translations fr /home/dokos_fr.json dokos`

### Etape 4 - Migrez votre application pour terminer la mise à jour

Afin de voir les phrases traduites sur votre site, lancez:

`bench migrate`

### Etape 5 - Proposez une **merge request**

Une fois vos traductions finalisées, n'oubliez pas de contribuer au projet en ouvrant une **merge request**.
Cela ne prend que quelques minutes, mais aide énormément à améliorer le logiciel pour tout le monde !

## Ajouter une nouvelle langue

Afin d'ajouter une nouvelle langue à Dokos, vous pouvez utiliser la commande suivante:

`bench new-language {code de la langue} {application}`

Ex. `bench new-language de dokos`

Un nouveau fichier contenant tous les mots/phrases traductibles sera créé dans le dossier `translations`.


# Documentation

Vous pouvez participer à la rédaction et à l'amélioration de cette documentation de différentes manières:

1. En ouvrant des tickets avec vos remarques/propositions de corrections ou suggestions sur [Gitlab](https://gitlab.com/dokos/documentation){rel="&#x22;nofollow&#x22;"}
2. En ouvrant une `Merge Request` contenant une proposition d'amélioration ou une correction sur [Gitlab](https://gitlab.com/dokos/documentation){rel="&#x22;nofollow&#x22;"}

## Modifier une page existante

## Créer une nouvelle page


# Conventions de Code

Ces conventions sont adaptées des [Contribution Guidelines](https://github.com/frappe/erpnext/wiki/Contribution-Guidelines){rel="&#x22;nofollow&#x22;"} du framework Frappe. Dokos étant basé sur Frappe/ERPNext, nous suivons les mêmes standards pour assurer la cohérence et faciliter les contributions croisées.

Le code source de Dokos est disponible sur [GitLab](https://gitlab.com/dokos){rel="&#x22;nofollow&#x22;"}.

---

## Standards de Code

### Messages utilisateur

Tous les textes affichés à l'utilisateur doivent être traduisibles:

- En Python: `_("texte")`
- En JavaScript: `__("texte")`

```python
frappe.msgprint(_("Facture {0} soumise").format(self.name))
```

```javascript
frappe.msgprint(__("Facture {0} créée", [doc.name]));
```

### Longueur des fonctions

Les fonctions ne devraient pas dépasser **10 lignes de code**. Une fonction plus longue indique généralement qu'elle fait trop de choses.

::callout
Signes qu'une fonction est trop complexe:

- Plus d'un niveau d'indentation
- Des "paragraphes" séparés par des lignes vides
::

### Indentation

Utilisez des **tabs** (caractères de tabulation), pas des espaces. C'est la convention historique de Frappe.

Les chaînes multi-lignes et expressions doivent être indentées de façon cohérente:

```python
D = frappe.qb.DocType("Accounting Dimension")
query = frappe.qb.from_(D).select(D.label, D.fieldname, D.document_type).where(D.disabled == 0).run(as_dict=1)
```

```python
Dimension = frappe.qb.DocType("Accounting Dimension")
query = (
    frappe.qb.from_(Dimension)
    .select(
        Dimension.label,
        Dimension.fieldname,
        Dimension.document_type,
    )
    .where(Dimension.disabled == 0)
)
results = query.run(as_dict=1)
```

### Ordre des fonctions

La fonction appelante doit être placée en haut, les fonctions appelées en dessous:

```python
def fa():
    fb()
    fc()

def fb():
    pass

def fc():
    pass
```

### Conditions multiples

Évitez de regrouper plusieurs conditions sur une seule ligne. Séparez-les pour améliorer la lisibilité.

### Logique métier

**Toute la logique métier doit être implémentée côté serveur (Python).** Lors des appels REST API, seul le code Python s'exécute. Le JavaScript est réservé à l'amélioration de l'expérience utilisateur.

### Commentaires

Le code doit être auto-explicatif, mais les commentaires expliquant le **pourquoi** sont essentiels. Chaque méthode devrait avoir une brève explication de son but.

### APIs dépréciées

Évitez ces APIs obsolètes:

- `cur_frm` - Utilisez le paramètre `frm` des handlers
- `$c_obj()` - Utilisez `frappe.call()`
- `get_query` - Utilisez `set_query`
- `add_fetch` - Utilisez les Link fields avec `fetch_from`

---

## Sécurité du Code

> Adapté de [Code Security Guidelines - Frappe/ERPNext](https://github.com/frappe/erpnext/wiki/Code-Security-Guidelines){rel="&#x22;nofollow&#x22;"}

### Injections SQL

::callout{color="red" icon="i-mdi-alert"}
**`frappe.db.sql()` est proscrit sur Dokos.** Utilisez le Query Builder (`frappe.qb`) ou les méthodes ORM.
::

```python
# RECOMMANDÉ - Query Builder
from frappe.query_builder import DocType

User = DocType('User')
query = (
    frappe.qb.from_(User)
    .select(User.name, User.email)
    .where(User.name == user)
)
result = query.run(as_dict=True)

# RECOMMANDÉ - Méthodes ORM (cas simples)
frappe.get_all('User',
    fields=['name', 'email'],
    filters={'name': user}
)

frappe.get_value('User', user, ['name', 'email'])
```

Avantages du [Query Builder](https://docs.frappe.io/framework/user/en/api/query-builder){rel="&#x22;nofollow&#x22;"} :

- **Protection contre les injections SQL** : paramétrage automatique des valeurs
- **Compatibilité cross-database** : même syntaxe pour MariaDB et PostgreSQL
- **API Python typée** : objets Field et Function au lieu de chaînes de caractères

### Création de documents

Les méthodes whitelistées acceptant des dictionnaires peuvent contourner les permissions. Ajoutez des vérifications explicites:

```python
@frappe.whitelist()
def create_document(values: dict):
    frappe.only_for('System User')
    if values['doctype'] not in ('ToDo', 'Note', 'Task'):
        frappe.throw(_('Type de document invalide'))
    doc = frappe.get_doc(values).insert()
    return doc
```

### Injection de code

- Évitez `eval()` et `exec()`
- Utilisez uniquement `frappe.safe_eval` ou `frappe.utils.safe_exec.safe_exec`

### Traversée de répertoires

Ne permettez jamais aux utilisateurs de contrôler les chemins de fichiers. Utilisez l'API du DocType "File".

### Permissions par défaut

- `frappe.get_doc()` ne vérifie **PAS** les permissions par défaut
- Préférez `frappe.get_list()` à `frappe.get_all()` pour appliquer les permissions
- Vérifiez explicitement les permissions dans les méthodes whitelistées:

```python
@frappe.whitelist()
def get_document(doctype: str, name: str):
    doc = frappe.get_doc(doctype, name)
    doc.check_permission("read")
    return doc
```

### Validation des types

Utilisez les annotations de type pour validation automatique:

```python
@frappe.whitelist()
def get_user(name: str):
    doc = frappe.get_doc("User", name)
    doc.check_permission("read")
    return doc
```

---

## Checklist Merge Request

> Adapté de [Pull Request Checklist - Frappe/ERPNext](https://github.com/frappe/erpnext/wiki/Pull-Request-Checklist){rel="&#x22;nofollow&#x22;"}

### Branches cibles

- `develop` - À utiliser par défaut. Les corrections seront backportés sur la branche principale au cas par cas.
- `vX-dev`- À utiliser pour une publication dans une version mineur.
- `vX-fix` - Uniquement si le correctif n'est pas applicable en develop (e.g. rupture de rétro-comptabilité).

### Messages de commit

Format **Conventional Commits**: `type(scope): description`

| Type       | Description                             |
| ---------- | --------------------------------------- |
| `feat`     | Nouvelle fonctionnalité                 |
| `fix`      | Correction de bug                       |
| `docs`     | Documentation uniquement                |
| `refactor` | Refactoring sans changement fonctionnel |
| `test`     | Ajout ou modification de tests          |

### Vérifications avant soumission

- Tous les tests passent
- Pre-commit hooks installés (`ruff`, `prettier`, `eslint`)
- Documentation mise à jour si nécessaire
- Screenshots ou GIF pour les changements d'interface
- Activez l'option "Allow edits from maintainers"

### Contenu à éviter

N'incluez pas de changements automatisés (linters de masse, corrections IA non revues) sans validation manuelle.

---

## Références

Ces conventions sont dérivées de la documentation officielle Frappe/ERPNext:

- [Contribution Guidelines](https://github.com/frappe/erpnext/wiki/Contribution-Guidelines){rel="&#x22;nofollow&#x22;"}
- [Coding Standards](https://github.com/frappe/erpnext/wiki/Coding-Standards){rel="&#x22;nofollow&#x22;"}
- [Code Security Guidelines](https://github.com/frappe/erpnext/wiki/Code-Security-Guidelines){rel="&#x22;nofollow&#x22;"}
- [Pull Request Checklist](https://github.com/frappe/erpnext/wiki/Pull-Request-Checklist){rel="&#x22;nofollow&#x22;"}

Pour contribuer à Dokos: [GitLab Dokos](https://gitlab.com/dokos/dokos/-/merge_requests){rel="&#x22;nofollow&#x22;"}


# Configuration de reCAPTCHA

## Introduction

reCAPTCHA est un service gratuit fourni par Google qui protège vos sites web contre les spams et les abus. Dans Dokos, vous pouvez activer reCAPTCHA pour sécuriser les formulaires accessibles depuis votre portail web, tels que les formulaires de candidature en ligne.

## Prérequis

Avant de configurer reCAPTCHA, vous devez obtenir des clés API depuis la console d'administration Google reCAPTCHA :

1. Rendez-vous sur [Google reCAPTCHA Admin Console](https://www.google.com/recaptcha/admin/){rel="&#x22;nofollow&#x22;"}.
2. Inscrivez votre site en fournissant un libellé (ex: "Dokos - Maison Verte SARL") et sélectionnez **reCAPTCHA v2** (case à cocher "Je ne suis pas un robot").
3. Ajoutez les domaines autorisés (ex: `votredomaine.dokos.cloud`).
4. Acceptez les conditions d'utilisation et cliquez sur **Soumettre**.
5. Notez la **Clé du site** et la **Clé secrète** fournies par Google.

## Configuration dans Dokos

### 1. Activer reCAPTCHA pour les candidatures en ligne

1. Allez dans **Ressources Humaines > Paramètres RH**.
2. Dans la section **Sécurité des formulaires**, activez l'option **Activer reCAPTCHA pour les candidatures en ligne**.
3. Saisissez la **Clé du site reCAPTCHA** et la **Clé secrète reCAPTCHA** obtenues précédemment.
4. Enregistrez les modifications.

> **Exemple** : Pour sécuriser le formulaire de candidature de Maison Verte SARL, l'administrateur saisit les clés reCAPTCHA dans les Paramètres RH. Les candidats doivent désormais valider une case "Je ne suis pas un robot" avant de soumettre leur candidature.

### 2. Personnalisation des messages d'erreur

Si un utilisateur échoue à la vérification reCAPTCHA, un message d'erreur s'affiche. Vous pouvez personnaliser ce message via :

> **Paramètres > Personnalisation des données > Messages système**

Recherchez le message **reCAPTCHA verification failed** et modifiez-le selon vos besoins (ex: "Veuillez cocher la case de vérification pour prouver que vous n'êtes pas un robot.").

## Bonnes pratiques

- **Testez la configuration** : Après activation, soumettez une candidature test pour vérifier que reCAPTCHA fonctionne correctement.
- **Surveillez les soumissions** : Consultez régulièrement les logs de reCAPTCHA dans la console Google pour détecter d'éventuelles tentatives de spam.
- **Équilibrez sécurité et expérience utilisateur** : reCAPTCHA peut dissuader certains utilisateurs légitimes. Assurez-vous que son utilisation est justifiée par un volume élevé de spams.

## Dépannage

### Problème : reCAPTCHA ne s'affiche pas

- Vérifiez que les clés API sont correctement saisies dans les Paramètres RH.
- Assurez-vous que le domaine de votre site est bien enregistré dans la console Google reCAPTCHA.
- Videz le cache de votre navigateur et rechargez la page.

### Problème : Les soumissions sont bloquées malgré une vérification réussie

- Vérifiez que l'option **Activer reCAPTCHA pour les candidatures en ligne** est bien cochée.
- Consultez les logs du serveur Dokos pour identifier d'éventuelles erreurs côté backend.

::mermaid
flowchart TD
A\[Candidat soumet le formulaire] --> B{reCAPTCHA validé ?}
B -->|Oui| C\[Candidature enregistrée]
B -->|Non| D\[Message d'erreur affiché]

::

## Limites

- reCAPTCHA v2 (case à cocher) est actuellement le seul type supporté dans Dokos.
- Les clés reCAPTCHA sont liées à un domaine spécifique. Si vous utilisez plusieurs domaines, vous devrez configurer des clés distinctes pour chacun.

## Ressources supplémentaires

- [Documentation officielle Google reCAPTCHA](https://developers.google.com/recaptcha){rel="&#x22;nofollow&#x22;"}
- [Guide de dépannage reCAPTCHA](https://developers.google.com/recaptcha/docs/faq){rel="&#x22;nofollow&#x22;"}


# Fonctions JSON dans le Query Builder

Dodock expose trois fonctions SQL spécialisées pour manipuler des champs contenant des données JSON : `JSONValue`, `JSONExtract` et `JSONContains`. Ces fonctions permettent d'extraire ou de filtrer des valeurs imbriquées dans un champ JSON directement depuis le Query Builder Python, sans avoir à charger l'ensemble des documents en mémoire.

::callout{icon="i-mdi-information-outline"}
Ces fonctions reposent sur les fonctions JSON natives de MariaDB (`JSON_VALUE`, `JSON_EXTRACT`, `JSON_CONTAINS`). Elles nécessitent MariaDB 10.2.3 ou supérieur.
::

## Import

```python
from frappe.query_builder.functions import JSONValue, JSONExtract, JSONContains
```

## JSONValue

`JSONValue(champ, chemin)` extrait une **valeur scalaire** (chaîne, nombre, booléen) depuis un champ JSON en suivant un chemin [JSONPath](https://goessner.net/articles/JsonPath/){rel="&#x22;nofollow&#x22;"}.

### Syntaxe

```python
JSONValue(champ, chemin_jsonpath)
```

| Paramètre         | Type           | Description                               |
| ----------------- | -------------- | ----------------------------------------- |
| `champ`           | Colonne Dodock | Champ du DocType contenant la valeur JSON |
| `chemin_jsonpath` | `str`          | Expression JSONPath commençant par `$`    |

### Exemple : filtrer sur une valeur imbriquée

Soit un DocType `Profile` avec un champ `preferences_json` stockant :

```json
{"notifications": {"email": true, "sms": false}, "language": "en"}
```

```python
import frappe
from frappe.query_builder.functions import JSONValue

Profile = frappe.qb.DocType("Profile")

resultats = (
    frappe.qb.from_(Profile)
    .select(
        Profile.customer_name,
        JSONValue(Profile.preferences_json, "$.notifications.email").as_("notif_email"),
        JSONValue(Profile.preferences_json, "$.language").as_("langue"),
    )
    .where(JSONValue(Profile.preferences_json, "$.notifications.email") == "true")
).run(as_dict=True)
```

Cette requête retourne uniquement les profils dont les notifications par e-mail sont activées, en exposant directement les valeurs extraites comme colonnes nommées.

## JSONExtract

`JSONExtract(champ, chemin)` extrait une **valeur ou un fragment JSON** (y compris un tableau ou un objet imbriqué) depuis un champ JSON. Contrairement à `JSONValue`, le résultat peut être un tableau JSON ou un objet, pas seulement une valeur scalaire.

### Syntaxe

```python
JSONExtract(champ, chemin_jsonpath)
```

### Exemple : extraire un tableau imbriqué

Soit un DocType `Sales Order` avec un champ `applied_discounts_json` stockant :

```json
{"codes": ["WELCOME10", "FREESHIP", "VIP"]}
```

```python
from frappe.query_builder.functions import JSONExtract

SalesOrder = frappe.qb.DocType("Sales Order")

codes = (
    frappe.qb.from_(SalesOrder)
    .select(
        SalesOrder.name,
        JSONExtract(SalesOrder.applied_discounts_json, "$.codes").as_("codes_remise"),
    )
).run(as_dict=True)
```

Le résultat de `JSONExtract` sur un tableau est une chaîne JSON de type `["WELCOME10", "FREESHIP", "VIP"]`, que vous pouvez ensuite passer à `JSONContains`.

## JSONContains

`JSONContains(cible, valeur)` vérifie si une valeur est **contenue** dans un document ou un tableau JSON. Elle est particulièrement utile pour filtrer des listes stockées en JSON.

### Syntaxe

```python
JSONContains(cible, valeur)
```

| Paramètre | Type                                 | Description                                  |
| --------- | ------------------------------------ | -------------------------------------------- |
| `cible`   | Colonne ou résultat de `JSONExtract` | Fragment JSON dans lequel chercher           |
| `valeur`  | `str`                                | Valeur JSON à rechercher (encodée en chaîne) |

### Exemple : filtrer les commandes contenant un code promo

```python
import frappe
from frappe.query_builder.functions import JSONContains, JSONExtract

SalesOrder = frappe.qb.DocType("Sales Order")

commandes = (
    frappe.qb.from_(SalesOrder)
    .select(SalesOrder.name, SalesOrder.customer)
    .where(
        JSONContains(
            JSONExtract(SalesOrder.applied_discounts_json, "$.codes"),
            '"FREESHIP"',
        )
    )
).run(as_dict=True)
```

::callout{color="amber" icon="i-mdi-alert-outline"}
**Attention au guillemets** : pour rechercher une chaîne dans un tableau JSON, la valeur doit être encodée comme valeur JSON valide, donc entourée de guillemets doubles : `'"FREESHIP"'` et non `'FREESHIP'`.
::

## Combiner les fonctions

Les trois fonctions sont composables. Voici un exemple réel combinant `JSONExtract` et `JSONContains` pour filtrer les commandes client ayant bénéficié de la livraison gratuite :

::mermaid
flowchart LR
A\[SalesOrder.applied\_discounts\_json] --> B\[JSONExtract: $.codes]
B --> C\[JSONContains: FREESHIP]
C --> D{Inclure dans les résultats ?}
D -- Oui --> E\[Commande retournée]
D -- Non --> F\[Ignorée]

::

```python
import frappe
from frappe.query_builder.functions import JSONContains, JSONExtract, JSONValue

SalesOrder = frappe.qb.DocType("Sales Order")
Profile = frappe.qb.DocType("Profile")

# Commandes avec livraison gratuite pour les clients ayant activé les notifications e-mail
resultats = (
    frappe.qb.from_(SalesOrder)
    .inner_join(Profile)
    .on(SalesOrder.customer == Profile.name)
    .select(SalesOrder.name, SalesOrder.customer, SalesOrder.grand_total)
    .where(
        JSONContains(
            JSONExtract(SalesOrder.applied_discounts_json, "$.codes"),
            '"FREESHIP"',
        )
    )
    .where(JSONValue(Profile.preferences_json, "$.notifications.email") == "true")
).run(as_dict=True)
```

## Référence rapide

| Fonction                      | Équivalent SQL    | Retourne                | Cas d'usage typique                  |
| ----------------------------- | ----------------- | ----------------------- | ------------------------------------ |
| `JSONValue(champ, chemin)`    | `JSON_VALUE()`    | Valeur scalaire         | Lire `$.language`, `$.price`         |
| `JSONExtract(champ, chemin)`  | `JSON_EXTRACT()`  | Valeur ou fragment JSON | Extraire un tableau `$.codes`        |
| `JSONContains(cible, valeur)` | `JSON_CONTAINS()` | `0` ou `1`              | Vérifier la présence dans un tableau |

## Ressources complémentaires

- [Documentation officielle Frappe — Query Builder](https://docs.frappe.io/framework/user/en/api/query-builder#json-functions){rel="&#x22;nofollow&#x22;"}
- [Référence JSON\_VALUE MariaDB](https://mariadb.com/kb/en/json_value/){rel="&#x22;nofollow&#x22;"}
- [Référence JSON\_EXTRACT MariaDB](https://mariadb.com/kb/en/json_extract/){rel="&#x22;nofollow&#x22;"}
- [Référence JSON\_CONTAINS MariaDB](https://mariadb.com/kb/en/json_contains/){rel="&#x22;nofollow&#x22;"}


# Configuration avancée de la couverture de code

Dokos et Frappe permettent de mesurer la couverture de code lors de l'exécution des tests unitaires. Cette fonctionnalité aide les développeurs à identifier les parties du code qui ne sont pas testées et à améliorer la qualité des applications.

## Exclusions de couverture par application

Depuis la version 5 de Dokos, chaque application peut définir ses propres règles d'exclusion de couverture de code. Cela permet une gestion plus fine et plus adaptée aux besoins spécifiques de chaque projet.

### Configuration des exclusions

Pour configurer les exclusions de couverture pour une application spécifique, vous devez créer ou modifier le fichier `.coveragerc` à la racine de votre application. Voici un exemple de configuration :

```ini
[run]
omit =
    */tests/*
    */doctype/*/test_*.py
    */patches/*
    */hooks.py
```

### Fonctionnement

1. **Détection automatique** : Lors de l'exécution des tests avec couverture, le système recherche automatiquement un fichier `.coveragerc` dans le répertoire de chaque application testée.
2. **Priorité** : Les règles définies dans le `.coveragerc` de l'application prennent le pas sur les exclusions globales définies dans Frappe.
3. **Application** : Les exclusions sont appliquées uniquement aux fichiers de l'application concernée, sans affecter les autres applications testées simultanément.

### Exemple pratique

Supposons que vous développiez une application personnalisée appelée `ma_super_app` et que vous souhaitiez exclure certains fichiers spécifiques de la couverture de code :

1. Créez un fichier `.coveragerc` à la racine de votre application :
   ```bash
   touch apps/ma_super_app/.coveragerc
   ```
2. Éditez le fichier pour ajouter vos exclusions :
   ```ini
   [run]
   omit =
       */ma_super_app/utils/legacy_code.py
       */ma_super_app/doctype/ancien_module/*
   ```
3. Exécutez vos tests avec la couverture de code :
   ```bash
   bench --site [nom_du_site] run-tests --app ma_super_app --coverage
   ```
4. Consultez le rapport de couverture généré dans `sites/[nom_du_site]/coverage` pour vérifier que vos exclusions ont été prises en compte.

## Bonnes pratiques

- **Exclusions ciblées** : N'excluez que les fichiers qui ne peuvent pas ou ne doivent pas être testés (code legacy, fichiers générés automatiquement, etc.).
- **Documentation** : Documentez les raisons des exclusions dans un commentaire dans le fichier `.coveragerc` pour faciliter la maintenance.
- **Revues régulières** : Passez en revue vos exclusions périodiquement pour vous assurer qu'elles sont toujours pertinentes.
- **Tests unitaires** : Même si certains fichiers sont exclus de la couverture, essayez de maintenir une bonne couverture globale pour garantir la qualité de votre code.

## Commandes utiles

```bash
# Exécuter les tests avec couverture pour une application spécifique
bench --site [nom_du_site] run-tests --app [nom_de_l_app] --coverage

# Générer un rapport HTML de la couverture
coverage html -d sites/[nom_du_site]/coverage
```

## Intégration avec les outils CI/CD

Cette fonctionnalité est particulièrement utile dans les pipelines CI/CD pour :

- Maintenir des seuils de couverture cohérents entre différentes applications
- Exclure automatiquement les fichiers non pertinents des rapports de couverture
- Adapter les exigences de couverture aux spécificités de chaque projet

::mermaid
flowchart TD
A\[Début des tests] --> B\[Détection des applications]
B --> C\[Recherche de .coveragerc]
C --> D{.coveragerc trouvé ?}
D -->|Oui| E\[Application des exclusions locales]
D -->|Non| F\[Application des exclusions globales]
E --> G\[Exécution des tests]
F --> G
G --> H\[Génération du rapport]
H --> I\[Fin]

::

\::: info
Cette fonctionnalité est particulièrement utile pour les développeurs travaillant sur des applications personnalisées ou des extensions de Dokos, permettant une configuration plus fine et adaptée aux besoins spécifiques de chaque projet.
\:::


# Migration vers la V5 — Guide pour les développeurs et intégrateurs

::callout{color="blue" icon="i-heroicons-information-circle"}
Cette page s'adresse aux équipes qui maintiennent des applications personnalisées, des forks ou des intégrations via l'API. Si vous utilisez Dokos sans personnalisation de code, elle ne vous concerne pas.

Si votre site est hébergé par Dokos, la migration technique est prise en charge par notre équipe — vous n'avez pas à vous occuper de l'infrastructure. En revanche, si vous avez développé des personnalisations, vérifiez les points ci-dessous qui vous concernent.
::

La V5 de Dokos s'appuie sur la V16 de Frappe et ERPNext. Cette montée de version introduit des changements structurels significatifs. Certains sont transparents, d'autres nécessitent une action de votre part avant ou après la migration.

---

## Prérequis techniques

Avant toute chose, vérifiez vos dépendances. Les versions minimales ont été relevées :

- **Python 3.14** ou supérieur
- **NodeJS 24** ou supérieur

::callout{color="red" icon="i-heroicons-exclamation-triangle"}
Si votre environnement ne répond pas à ces prérequis, la migration ne pourra pas aboutir. C'est le premier point à vérifier.
::

---

## Changements structurels dans Frappe

### Modules extraits en applications distinctes

Plusieurs modules ont quitté le cœur de Frappe pour devenir des applications indépendantes. Si vous les utilisiez — directement ou via des dépendances — ils devront être réinstallés séparément :

- Energy Points
- Newsletter
- Backup Integrations
- Blog

### Tri par défaut changé : `modified` → `creation`

C'est probablement le changement le plus silencieux et le plus susceptible de créer des comportements inattendus dans vos applications.

À partir de la V16, toutes les vues liste et la plupart des APIs Frappe trient par défaut selon la date de **création** (`creation`) et non plus par date de **modification** (`modified`).

**Ce que vous devez faire :**

1. Auditez votre code pour identifier les endroits où le tri implicite par `modified` affecte votre logique métier
2. Mettez à jour l'ordre de tri par défaut de vos DocTypes personnalisés de `modified` vers `creation`
3. Partout où vous avez besoin d'un tri par `modified`, rendez-le explicite : `order_by='modified desc'`

Les APIs concernées : `frappe.get_all()`, `frappe.get_list()`, `frappe.db.get_value()`, `frappe.db.get_values()`, `frappe.qb.get_query()`.

Si vous souhaitez conserver l'index sur `modified` après la migration, vous pouvez le ré-ajouter dans le contrôleur de votre DocType :

```python
def on_doctype_update():
    frappe.db.add_index("Doctype Name", ["modified"])
```

### Passage au Query Builder pour `get_list` et `get_all`

`frappe.get_all()` et `frappe.get_list()` utilisent désormais le nouveau Query Builder en backend. Des ajustements de compatibilité peuvent être nécessaires selon l'usage que vous en faites, notamment pour les appels de fonctions SQL comme `sum`. Consultez le guide de migration officiel vers le Query Builder pour les détails et exemples.

### Méthodes whitelistées nécessitant désormais POST

Les méthodes suivantes n'acceptent plus que des requêtes POST :

- `/api/method/logout`
- `/api/method/web_logout`
- `/api/method/upload_file`
- `/api/method/frappe.www.login.send_login_link`

Si votre code client appelle ces méthodes en GET, mettez-le à jour.

### Code pays obligatoire et validé

Le champ **Code** du DocType **Pays** est maintenant obligatoire et doit respecter la norme ISO 3166 ALPHA-2. Si votre base contient des pays personnalisés ou des codes non conformes, ils devront être corrigés avant la migration.

### `frappe.flags.in_test` est déprécié

Remplacez `frappe.flags.in_test` par `frappe.in_test`. L'ancien attribut sera supprimé dans une prochaine version. Si vous modifiez cette valeur dans vos tests, utilisez `frappe.tests.utils.toggle_test_mode` qui met à jour les deux attributs simultanément.

### `db.get_value` convertit maintenant les résultats des Single DocTypes

Jusqu'ici, `db.get_value` retournait toujours des chaînes de caractères pour les Single DocTypes. Ce comportement a été corrigé — les valeurs sont maintenant retournées dans leur type réel. Si votre code comparait ces valeurs à des chaînes, adaptez-le :

```python
# Avant
if frappe.db.get_value("Settings", "Settings", "enabled") == "1":

# Après
if frappe.db.get_value("Settings", "Settings", "enabled") == 1:
```

### Chargement du code JS en IIFE

Les fichiers JS des Rapports, Graphiques de tableau de bord et Pages sont maintenant évalués comme des [IIFEs](https://developer.mozilla.org/fr/docs/Glossary/IIFE){rel="&#x22;nofollow&#x22;"}. Si votre code reposait intentionnellement sur la pollution du scope global, il devra être mis à jour. Il reste possible de modifier le scope global en mutant explicitement l'objet `window`.

### `meta.get_valid_columns()` exclut désormais les champs virtuels

Si votre code supposait que les champs virtuels figuraient dans `get_valid_columns()`, vous devrez l'adapter.

### Vue carte : comportement aligné sur la vue liste

La vue carte affiche maintenant les 20 premiers éléments avec pagination, comme la vue liste. L'ancien comportement (chargement de tous les enregistrements en une seule fois) a été supprimé. Sur les grands jeux de données, c'est un gain de performance significatif — mais si votre code s'appuyait sur ce chargement complet, anticipez l'adaptation.

---

## Changements côté ERPNext

### Facturation des feuilles de temps via l'API

Si vous créez des factures de vente via l'API et récupériez automatiquement les feuilles de temps non facturées liées à un projet, ce comportement n'est plus automatique. Un appel supplémentaire est maintenant nécessaire :

```text
PUT /api/v2/document/Sales%20Invoice/SINV-0001/method/add_timesheet_data
```

### Suppression de méthodes whitelistées

Deux méthodes ont été supprimées. Si vous les appelez dans des scripts ou intégrations, adaptez votre code pour utiliser directement `frappe.new_doc` :

- `erpnext.accounts.doctype.bank_account.bank_account.make_bank_account`
- `erpnext.accounts.doctype.pricing_rule.pricing_rule.make_pricing_rule`

---

## Un blocage, une question ?

Ouvrez une issue sur notre [GitLab](https://gitlab.com/dokos){rel="&#x22;nofollow&#x22;"} ou venez en parler sur le [forum](https://community.dokos.io){rel="&#x22;nofollow&#x22;"}. Une migration qui se passe bien, c'est aussi notre responsabilité — on préfère qu'on le sache tôt plutôt que vous voir avancer seuls face à un comportement inattendu.


# v5.0.0

::callout{color="red" icon="i-heroicons-fire"}
Si vous êtes Responsable Système de votre site Dodock, veuillez prendre connaissance des informations de migration avant la mise à jour de votre site.

Veuillez aussi consulter les informations concernant [Dokos](https://doc.dokos.io/v5/dokos/versions/v5.x.x/v5_0_0) si vous utilisez Dokos.
::

::callout
La version 5.0.0 de Dodock est basée sur la version 16 de Frappe.
Une grande partie des changements cités ci-dessous ont été développés par l'équipe de Frappe Technologies et les contributeurs aux logiciels de l'éco-système Frappe/ERPNext.
Le détail des changements publiés dans Dodock est disponible sur [GitLab](https://gitlab.com/dokos/dodock/-/releases/v5.0.0){rel=""nofollow""}
::

---

La V5 est là. C'est une version qui nous tient à cœur, parce qu'elle est le fruit d'un travail patient : analyser ce que vous vivez au quotidien dans Dokos, identifier ce qui freine, ce qui peut être simplifié, ce qui manquait. Pas pour cocher des cases, mais parce que votre usage réel est notre boussole.

Elle s'appuie sur la V16 d'ERPNext, que nous avons parcourue, triée, adaptée — avec une seule question en tête : comment être vraiment utiles pour vous ?

---

::tabs
  :::tabs-item{icon="i-heroicons-users" label="Tous les utilisateurs"}
  ## Ce qui change pour tous

  ### Une interface repensée en profondeur

  Ce n'est pas un simple rafraîchissement visuel — c'est une réorganisation de fond.

  La barre de navigation est maintenant sur le côté gauche, organisée par sections. Votre profil, vos notifications et l'aide ont migré là aussi — plus besoin de chercher en haut à droite. Le bureau central regroupe toutes vos applications au même endroit, accessible en deux clics depuis n'importe quelle page.

  Si vous travaillez sur mobile ou tablette, vous allez apprécier : la navigation a été unifiée en une seule barre, la recherche est accessible directement, et les listes sont bien plus lisibles sur petit écran.

  Dokos arbore aussi une nouvelle couleur principale. C'est un détail, mais il marque visuellement le passage à une nouvelle étape.

  :br

  ![Nouveau bureau central Dokos V5 avec navigation latérale gauche](https://doc.dokos.io/content/versions-v5/document-presentation-version-v5/dokos-v5-bureau-central-navigation-sidebar.png)

  :br

  ### Retrouvez ce que vous cherchez, plus vite

  Les listes affichent maintenant des filtres par défaut, pensés pour les cas les plus courants. Vous pouvez les personnaliser, les enregistrer (par page ou globalement) et utiliser les options "comme" ou "est égal à" selon que vous cherchez quelque chose d'approximatif ou d'exact. Plus besoin de connaître l'intitulé précis d'un champ pour trouver ce que vous voulez.

  :br

  ### Naviguez entre vos documents sans perdre le fil

  Depuis une facture, vous voyez directement les documents liés — commandes, bons de livraison, paiements — et vous pouvez y accéder en un clic. La timeline du document vous montre l'historique complet de ce qui s'est passé. Fini les allers-retours entre les écrans pour reconstituer un dossier.

  :br

  ### Le tiroir latéral

  Sur certaines listes et certains documents, un panneau s'ouvre sur le côté pour renseigner des informations sans quitter ce que vous étiez en train de faire. C'est particulièrement utile lors des rapprochements bancaires : vous restez dans le flux sans perdre le contexte.

  :br

  ### Les actions en masse

  Fermer ou rouvrir plusieurs documents en une seule action, directement depuis la liste. Ce qui prenait plusieurs minutes se fait maintenant en quelques secondes.

  ---

   

  :br

  ## Comptabilité & Finance

  ### Un nouveau tableau de bord pour la réconciliation bancaire

  C'est l'un des changements les plus structurants de cette version. L'interface est plus claire, les filtres plus précis. Vous pouvez maintenant créer une écriture de journal directement depuis le tableau de bord de rapprochement, sans quitter l'écran. Dokos peut aussi identifier automatiquement à quel tiers correspond une transaction bancaire, en s'appuyant sur les informations déjà présentes.

  :br

  ![Tableau de bord de réconciliation bancaire Dokos V5](https://doc.dokos.io/content/versions-v5/document-presentation-version-v5/dokos-v5-rapprochement-bancaire-tableau-de-bord.png)

  :br

  ### Vos états financiers retiennent vos préférences

  Quand vous naviguez entre votre bilan et votre compte de résultat, vos filtres restent en place. Ce n'est pas grand-chose, mais si vous le faites régulièrement, vous verrez immédiatement la différence.

  :br

  ### La gestion des acomptes a été entièrement revue

  Il n'y a plus d'article d'acompte à créer ou à sélectionner manuellement : l'acompte est calculé directement à la création de la facture, puis ventilé automatiquement selon les taux de TVA présents dans la commande. C'était l'un des points qui posait le plus de questions — et que plusieurs d'entre vous avaient remontés. Côté fournisseur, vous pouvez désormais saisir des factures d'acompte et les déduire automatiquement lors de la facturation finale.

  :br

  ### La gestion des taxes simplifiée

  Le tableau de taxes, qui demandait de comprendre plusieurs colonnes pour configurer quelque chose de simple, a été remplacé par une interface allégée. Vous sélectionnez votre régime de TVA, Dokos s'occupe du reste. Pour ceux qui souhaitent conserver l'ancien affichage, il reste accessible via le bouton "affichage".

  :br

  ![Nouvelle interface de gestion des taxes TVA dans Dokos V5](https://doc.dokos.io/content/versions-v5/document-presentation-version-v5/dokos-v5-interface-taxes-tva-simplifiee.png)

  ---

   

  :br

  ## Facturation électronique — où on en est

  La réforme avance, et Dokos avance avec elle. Voici la situation exacte, sans détour.

  Un nouveau module **eTransaction** remplace l'actuel module OCR. Son déploiement se fait en trois étapes :

  - **Étape 1 — Lire les factures reçues** : en cours de finalisation. Vous pourrez recevoir et traiter des factures électroniques de vos fournisseurs directement dans Dokos.
  - **Étape 2 — Générer vos factures** : à chaque validation d'une facture de vente, Dokos produira automatiquement la version électronique conforme.
  - **Étape 3 — Se connecter aux Plateformes Agréées** : via l'API standardisée AFNOR, pour la transmission dans le cadre légal.

  Vous serez informés des avancées sur le forum.

  ---

   

  :br

  ## RGPD — des outils directement dans Dokos

  Vous pouvez maintenant tagger vos données personnelles dans Dokos (un champ client ou membre, une adresse, un contact) et créer des règles de rétention adaptées à votre structure : combien de temps conserver cette donnée, que faire à l'échéance. C'est accessible sans être développeur, et ça vous donne une base documentaire solide si vous devez justifier votre conformité auprès d'un client ou d'un auditeur.

  ---

   

  :br

  ## RH : congés et absences

  Pour ceux qui gèrent une équipe salariée, quelques améliorations bienvenues : ajustement manuel des congés possible, gestion de la demi-journée dans les listes de jours fériés, et attribution de ces listes simplifiée.

  :br

  :callout[Un point de clarté utile : **la paie n'est pas gérée dans Dokos**. Nous vous recommandons un logiciel de paie dédié, connecté à votre comptabilité Dokos.]{icon="i-heroicons-information-circle"}

  ---

  :br

  ## Ce qui n'a pas changé

  Vos données, vos paramètres, vos modèles d'impression, vos exports, vos configurations de taxes. Tout ce que vous avez mis en place reste en place.

  Les sites avec des personnalisations spécifiques seront migrés dans un second temps, après vérification de la compatibilité de chaque adaptation. Vous serez prévenus avant toute bascule.

  :br

  :callout[**Un comportement inattendu ?** Signalez-le sur notre [GitLab](https://gitlab.com/dokos){rel=""nofollow""} ou venez en parler sur le [forum](https://community.dokos.io){rel=""nofollow""}. On est là, et chaque retour compte.]{icon="i-heroicons-chat-bubble-left-right"}
  :::

  :::tabs-item{icon="i-heroicons-building-office" label="Tiers-lieux"}
  ## Les réservations : ce qui change

  C'est le cœur de votre usage, et c'est là que cette version apporte des changements concrets.

  :br

  ### Le planning est devenu interactif

  Jusqu'ici, le planning était une vue figée. Maintenant, il réagit. Les noms de ressources sont des liens cliquables vers leur page de détail. En survolant une cellule, une mise en évidence subtile vous indique exactement quelle ressource et quel jour sont concernés. Un clic sur une cellule vous emmène directement sur la page de réservation, avec la ressource et la date déjà pré-remplies.

  :br

  ![Planning de réservations interactif Dokos V5 pour tiers-lieux](https://doc.dokos.io/content/versions-v5/document-presentation-version-v5/dokos-v5-planning-reservations-interactif-tiers-lieu.png)

  :br

  ### Toutes vos ressources publiées sont visibles dans le planning

  Une ressource active et publiée apparaît maintenant systématiquement dans le planning, même si aucune réservation n'y est encore associée. La vue est complète dès l'ouverture.

  :br

  ### Vos membres retrouvent leurs réservations facilement

  Deux nouvelles pages font leur apparition côté portail : **Mes réservations** et **Mes inscriptions aux événements**. Chacune affiche les réservations à venir et passées, avec une pagination claire et un filtre par onglets. Vos membres n'ont plus besoin de vous contacter pour retrouver l'historique de leurs réservations.

  :br

  ![Page Mes réservations du portail membre Dokos V5](https://doc.dokos.io/content/versions-v5/document-presentation-version-v5/dokos-v5-portail-membre-mes-reservations.png)

  :br

  ### Le remboursement de crédit sur annulation

  Quand un membre annule une réservation, vous pouvez maintenant lui restituer automatiquement ses crédits, sans manipulation manuelle de votre côté. C'est configurable dans les paramètres de votre lieu : vous choisissez si le remboursement est automatique ou non. Un message de confirmation s'affiche pour informer le membre au moment de l'annulation.

  :br

  ### Les réservations non confirmées ne bloquent plus les créneaux, si vous le souhaitez

  Une option dans les paramètres de lieu vous permet de choisir si les réservations en attente de confirmation occupent ou non les créneaux de disponibilité. Utile quand vous avez beaucoup de demandes en cours de validation et que vous ne voulez pas bloquer inutilement votre planning.

  :br

  ### Synchronisation Google Calendar

  Les titres de vos événements se synchronisent maintenant correctement avec vos réservations dans Dokos. Avant, seul le nom de la ressource s'affichait — ou rien du tout. Maintenant, le titre de l'événement est repris fidèlement.

  :br

  ### Le dépôt de garantie lié au contrat

  Le lien entre un dépôt de garantie et son contrat de réservation est maintenant visible directement depuis le contrat. Plus besoin de naviguer entre les deux documents pour vérifier qu'ils sont bien associés.

  :br

  ### Diaporama sur la page de détail d'une ressource

  Sur le portail, la page de détail d'une ressource affiche maintenant un carrousel d'images si vous avez configuré un diaporama. Navigation par flèches, points indicateurs, glissement tactile — et si aucun diaporama n'est configuré, l'image principale s'affiche comme avant.

  :br

  ### Filtres sur la page des événements

  La page des événements à venir du portail propose maintenant des filtres par **catégorie** (badges cliquables) et par **lieu** (menu déroulant). Le filtre lieu n'apparaît que s'il y a au moins deux lieux distincts.

  :br

  ### Un tableau de bord dédié aux réservations

  Le workspace Bookings dispose maintenant de 4 widgets pour visualiser l'activité en un coup d'œil :

  - **Occupation du jour** — taux d'occupation de chaque ressource en temps réel
  - **Disponibilité des ressources** — matrice sur 7 jours avec statuts Ouvert / Partiel / Complet / Fermé
  - **Activité de réservation** — heatmap annuelle de l'activité
  - **Consommation de crédits** — évolution par type de crédit avec estimation d'épuisement

  :br

  ### Dialogue guidé pour les contrats de réservation

  Quand vous créez un nouveau contrat, un dialogue s'affiche automatiquement en deux étapes : sélection du type de contrat, puis sélection du client. Plus besoin de savoir par où commencer.

  :br

  ### Les ressources liées remplacent les bundles d'articles

  Pour associer plusieurs ressources à une réservation (ex : une salle + son équipement), vous utilisez maintenant une table de **ressources liées** directement sur la fiche ressource — sans passer par les bundles d'articles. L'interface affiche les ressources liées sous forme de cartes avec photo, quantité modifiable et suppression rapide.

  Lors d'une réservation, les réservations enfants pour chaque ressource liée sont créées automatiquement.

  :br

  ### Icônes de services : accès à 1 500 icônes

  Le champ d'icône sur les services de réservation utilise maintenant le sélecteur natif Frappe, qui donne accès à l'ensemble des icônes Lucide (\~1 500). Les icônes précédemment configurées sont migrées automatiquement.

  ---

  :br

  ## Une note sur la suite

  Le module réservations est en évolution active. Ce que vous venez de lire est ce qui est livré et stable au 16 mars 2026. D'autres chantiers sont en cours — nous vous en parlerons sur le forum au fur et à mesure.

  Si vous observez un comportement inattendu ou avez des retours sur votre usage quotidien, c'est exactement ce dont on a besoin pour continuer à améliorer le module.
  :::

  :::tabs-item{icon="i-heroicons-briefcase" label="PME"}
  ## Ventes & Achats

  ### Créer une facture de vente est devenu plus guidé

  Quand vous créez une nouvelle facture, une fenêtre vous propose maintenant les options de création disponibles selon votre contexte : facture simple, facture d'acompte, facture depuis une commande. Plus besoin de savoir par où commencer — les choix possibles s'affichent devant vous.

  :br

  ![Fenêtre de création guidée de facture de vente Dokos V5](https://doc.dokos.io/content/versions-v5/document-presentation-version-v5/dokos-v5-creation-facture-vente-dialog.png)

  :br

  ### Les prix de vos articles, toujours sous la main

  Un tableau de bord des prix est maintenant accessible directement depuis la fiche article, la fiche client et la fiche fournisseur. Plus besoin de naviguer dans les listes de prix pour vérifier ce qui s'applique à qui.

  :br

  ### Les remises s'affichent clairement

  Le total net après remise est maintenant visible directement sur vos documents. Le pourcentage de remise apparaît également à l'impression — ce que beaucoup d'entre vous demandaient.

  :br

  ### Calculez votre marge directement depuis la facture

  Vous pouvez maintenant calculer votre marge brute en choisissant de la baser sur le taux de valorisation, le dernier prix d'achat, ou le prix fournisseur. Un champ de pourcentage de marge recalcule le prix de vente automatiquement.

  :br

  ### Côté achats

  Vous pouvez envoyer vos appels d'offres depuis une adresse email fixe dédiée, indépendamment de votre compte principal. Et la comparaison des offres fournisseurs est accessible directement depuis l'appel d'offres, sans étape intermédiaire.

  ---

  :br

  ## Stocks

  ### Les rapports de stock acceptent maintenant plusieurs articles et plusieurs entrepôts simultanément

  Si vous avez l'habitude de relancer le même rapport plusieurs fois en changeant un filtre à chaque fois, c'est terminé. Vous sélectionnez tous les articles et tous les entrepôts qui vous intéressent en une seule fois.

  :br

  ### La méthode de valorisation et les entrepôts par défaut sont configurables par société

  Si vous gérez plusieurs entités avec des logiques de stock différentes (une qui valorise en FIFO, une autre au prix moyen), chacune peut maintenant avoir ses propres paramètres sans interférer avec les autres.

  :br

  ### La réservation de stock s'étend à la sous-traitance

  Vous confiez une partie de votre production à un sous-traitant ? Les matières premières peuvent maintenant être réservées directement depuis l'ordre de sous-traitance. Elles ne risquent plus d'être attribuées à une autre commande entre le moment où vous planifiez et celui où vous expédiez.

  :br

  ### Le rapport de traçabilité des lots et numéros de série

  Vous avez besoin de savoir d'où vient un article, par quel lot il est passé, à qui il a été livré ? Ce rapport reconstitue le parcours complet d'un article — de la réception à la livraison — en quelques clics. Utile en cas de rappel produit, de contrôle qualité, ou simplement pour répondre rapidement à une question client.

  ---

  :br

  ## Budgets & multi-sociétés

  ### Les budgets gagnent en souplesse

  Vous pouvez maintenant faire de la révision budgétaire, gérer un budget sur plusieurs exercices fiscaux, et distribuer les montants de façon flexible dans le temps. Pour ceux qui font du suivi budgétaire sérieux, c'est un vrai changement.

  :br

  ### Pour les structures multi-sociétés

  Un rapport de balance consolidée est maintenant disponible, et le flux de trésorerie affiche les soldes d'ouverture et de clôture.
  :::
::


# v4.0.0

::callout{color="red" icon="i-heroicons-fire"}
Si vous êtes Responsable Système de votre site Dodock, veuillez prendre connaissance des informations de migration ci-dessous avant la mise à jour de votre site.

Veuillez aussi consulter les informations concernant [Dokos](https://doc.dokos.io/v5/dokos/versions/v4.x.x/v4_0_0) si vous utilisez Dokos.
::

::callout
La version 4.0.0 de Dodock est basée sur la version 15 de Frappe.
Une grande partie des changements cités ci-dessous ont été développés par l'équipe de Frappe Technologies et les contributeurs aux logiciels de l'éco-système Frappe/ERPNext.
Le détail des changements publiés dans Dodock est disponible sur [GitLab](https://gitlab.com/dokos/dodock/-/releases/v4.0.0){rel=""nofollow""}
::

## Migration vers la v4.x.x

> [Guide de migration pour les utilisateurs auto-hébergés](https://doc.dokos.io/v5/dodock/administration/migration-v4)

> [Migration de Dodock : v3 > v4 (Frappe v14 > v15)](https://github.com/frappe/frappe/wiki/Migrating-to-version-15){rel="&#x22;nofollow&#x22;"}

## Fonctionnalités et améliorations

- Ajout de libellés de ligne dynamiques dans SummaryCard [MR #945](https://gitlab.com/dokos/dodock/-/merge_requests/945){rel="&#x22;nofollow&#x22;"}
- Activation de la redirection vers une URL personnalisée lors du clic sur une notification par TechnicalShree [frappe#22956](https://github.com/frappe/frappe/pull/22956){rel="&#x22;nofollow&#x22;"} [MR #940](https://gitlab.com/dokos/dodock/-/merge_requests/940){rel="&#x22;nofollow&#x22;"}
- Révision de l'état du flux de travail par rtdany10 [frappe#23207](https://github.com/frappe/frappe/pull/23207){rel="&#x22;nofollow&#x22;"} [MR #938](https://gitlab.com/dokos/dodock/-/merge_requests/938){rel="&#x22;nofollow&#x22;"}
- Ajout d'options de personnalisation et de types de ligne dans SummaryCard [MR #935](https://gitlab.com/dokos/dodock/-/merge_requests/935){rel="&#x22;nofollow&#x22;"}
- Autorisation de la définition des champs comme non nuls par akhilnarang [frappe#22804](https://github.com/frappe/frappe/pull/22804){rel="&#x22;nofollow&#x22;"} [MR #934](https://gitlab.com/dokos/dodock/-/merge_requests/934){rel="&#x22;nofollow&#x22;"}
- Autorisation de l'utilisation de `print()` dans `safe_exec()` par akhilnarang [frappe#23084](https://github.com/frappe/frappe/pull/23084){rel="&#x22;nofollow&#x22;"} [MR #932](https://gitlab.com/dokos/dodock/-/merge_requests/932){rel="&#x22;nofollow&#x22;"}
- Ajout de la vue d'image dans le bloc de raccourcis du workspace par sibikumarkuppusamy [frappe#23041](https://github.com/frappe/frappe/pull/23041){rel="&#x22;nofollow&#x22;"} [MR #931](https://gitlab.com/dokos/dodock/-/merge_requests/931){rel="&#x22;nofollow&#x22;"}
- Mise à jour de multi\_select\_dialog.js par hyaray [frappe#23261](https://github.com/frappe/frappe/pull/23261){rel="&#x22;nofollow&#x22;"} [MR #922](https://gitlab.com/dokos/dodock/-/merge_requests/922){rel="&#x22;nofollow&#x22;"}
- Option Bootstrap uniquement si la base de données et l'utilisateur sont gérés de manière externe à Bench par blaggacao [frappe#23170](https://github.com/frappe/frappe/pull/23170){rel="&#x22;nofollow&#x22;"} [MR #904](https://gitlab.com/dokos/dodock/-/merge_requests/904){rel="&#x22;nofollow&#x22;"}
- Implémentation du mappage dans la table enfant par blaggacao [frappe#22592](https://github.com/frappe/frappe/pull/22592){rel="&#x22;nofollow&#x22;"} [MR #903](https://gitlab.com/dokos/dodock/-/merge_requests/903){rel="&#x22;nofollow&#x22;"}
- Fusion de la branche 'event\_image\_display' dans 'develop' (dokos/dodock!897) [MR #900](https://gitlab.com/dokos/dodock/-/merge_requests/900){rel="&#x22;nofollow&#x22;"}
- Autorisation de l'édition au format numérique dans ControlFloat [frappe#23143](https://github.com/frappe/frappe/pull/23143){rel="&#x22;nofollow&#x22;"} [MR #891](https://gitlab.com/dokos/dodock/-/merge_requests/891){rel="&#x22;nofollow&#x22;"}
- Application de filtres aux champs de lien via le générateur de formulaires par RitvikSardana [frappe#22844](https://github.com/frappe/frappe/pull/22844){rel="&#x22;nofollow&#x22;"} [MR #890](https://gitlab.com/dokos/dodock/-/merge_requests/890){rel="&#x22;nofollow&#x22;"}
- Ajout d'une option `Nouveau` pour le bouton principal dans SummaryCard [MR #886](https://gitlab.com/dokos/dodock/-/merge_requests/886){rel="&#x22;nofollow&#x22;"}
- Ajout de pages de couverture pour le verso dans pdf [MR #879](https://gitlab.com/dokos/dodock/-/merge_requests/879){rel="&#x22;nofollow&#x22;"}
- Ajout de la méthode `frappe.views.registerCustomListView` dans list\_view [MR #877](https://gitlab.com/dokos/dodock/-/merge_requests/877){rel="&#x22;nofollow&#x22;"}
- Amélioration de la méthode `get_resource_ids` dans calendar [MR #878](https://gitlab.com/dokos/dodock/-/merge_requests/878){rel="&#x22;nofollow&#x22;"}
- Filtres de date dans le suivi des modifications par GursheenK [frappe#22684](https://github.com/frappe/frappe/pull/22684){rel="&#x22;nofollow&#x22;"} [MR #857](https://gitlab.com/dokos/dodock/-/merge_requests/857){rel="&#x22;nofollow&#x22;"}
- Autorisation de la suppression et ajout de la fonction de suppression de dossier pour les pages par Vishnu7025 [frappe#23077](https://github.com/frappe/frappe/pull/23077){rel="&#x22;nofollow&#x22;"} [MR #842](https://gitlab.com/dokos/dodock/-/merge_requests/842){rel="&#x22;nofollow&#x22;"}
- Importation du scss depuis node\_modules dans les applications également par blaggacao [frappe#22519](https://github.com/frappe/frappe/pull/22519){rel="&#x22;nofollow&#x22;"} [MR #818](https://gitlab.com/dokos/dodock/-/merge_requests/818){rel="&#x22;nofollow&#x22;"}
- Ajout du bouton "Graphique du tableau de bord" par Vishnu7025 [frappe#22960](https://github.com/frappe/frappe/pull/22960){rel="&#x22;nofollow&#x22;"} [MR #814](https://gitlab.com/dokos/dodock/-/merge_requests/814){rel="&#x22;nofollow&#x22;"}
- Option pour définir le type de fichier par défaut de manière programmatique dans export de données par hyaray [frappe#22658](https://github.com/frappe/frappe/pull/22658){rel="&#x22;nofollow&#x22;"} [MR #808](https://gitlab.com/dokos/dodock/-/merge_requests/808){rel="&#x22;nofollow&#x22;"}
- Documentation de Document.remove\_tag par gavindsouza [frappe#22970](https://github.com/frappe/frappe/pull/22970){rel="&#x22;nofollow&#x22;"} [MR #802](https://gitlab.com/dokos/dodock/-/merge_requests/802){rel="&#x22;nofollow&#x22;"}
- Ajustements au style de dokos v4 [MR #767](https://gitlab.com/dokos/dodock/-/merge_requests/767){rel="&#x22;nofollow&#x22;"}
- Ajout d'une traduction contextuelle à "créer un nouveau document" [MR #751](https://gitlab.com/dokos/dodock/-/merge_requests/751){rel="&#x22;nofollow&#x22;"}
- Toujours afficher la flèche dans ControlLink [MR #753](https://gitlab.com/dokos/dodock/-/merge_requests/753){rel="&#x22;nofollow&#x22;"}
- Versionnement de l'API et API v2 (bêta) par ankush [frappe#22300](https://github.com/frappe/frappe/pull/22300){rel="&#x22;nofollow&#x22;"} [MR #732](https://gitlab.com/dokos/dodock/-/merge_requests/732){rel="&#x22;nofollow&#x22;"}
- Limite de fréquence des connexions basée sur l'adresse IP également par ankush [frappe#22774](https://github.com/frappe/frappe/pull/22774){rel="&#x22;nofollow&#x22;"} [MR #741](https://gitlab.com/dokos/dodock/-/merge_requests/741){rel="&#x22;nofollow&#x22;"}
- Actualisation automatique lorsque l'utilisateur met à jour le thème par shridarpatil [frappe#22771](https://github.com/frappe/frappe/pull/22771){rel="&#x22;nofollow&#x22;"} [MR #737](https://gitlab.com/dokos/dodock/-/merge_requests/737){rel="&#x22;nofollow&#x22;"}
- E-mail depuis le champ 'Table Multiselect' dans notification par sayedayman203 [frappe#22733](https://github.com/frappe/frappe/pull/22733){rel="&#x22;nofollow&#x22;"} [MR #719](https://gitlab.com/dokos/dodock/-/merge_requests/719){rel="&#x22;nofollow&#x22;"}
- Autorisation de la suppression et ajout de la fonction de suppression de dossier pour les pages par Vishnu7025 [frappe#23077](https://github.com/frappe/frappe/pull/23077){rel="&#x22;nofollow&#x22;"} [MR #842](https://gitlab.com/dokos/dodock/-/merge_requests/842){rel="&#x22;nofollow&#x22;"}
- Importation du scss depuis node\_modules dans les applications également par blaggacao [frappe#22519](https://github.com/frappe/frappe/pull/22519){rel="&#x22;nofollow&#x22;"} [MR #818](https://gitlab.com/dokos/dodock/-/merge_requests/818){rel="&#x22;nofollow&#x22;"}
- Ajout du bouton "Graphique du tableau de bord" par Vishnu7025 [frappe#22960](https://github.com/frappe/frappe/pull/22960){rel="&#x22;nofollow&#x22;"} [MR #814](https://gitlab.com/dokos/dodock/-/merge_requests/814){rel="&#x22;nofollow&#x22;"}
- Option pour définir le type de fichier par défaut de manière programmatique dans export de données par hyaray [frappe#22658](https://github.com/frappe/frappe/pull/22658){rel="&#x22;nofollow&#x22;"} [MR #808](https://gitlab.com/dokos/dodock/-/merge_requests/808){rel="&#x22;nofollow&#x22;"}
- Documentation de Document.remove\_tag par gavindsouza [frappe#22970](https://github.com/frappe/frappe/pull/22970){rel="&#x22;nofollow&#x22;"} [MR #802](https://gitlab.com/dokos/dodock/-/merge_requests/802){rel="&#x22;nofollow&#x22;"}
- Ajustements au style de dokos v4 [MR #767](https://gitlab.com/dokos/dodock/-/merge_requests/767){rel="&#x22;nofollow&#x22;"}
- Ajout d'une traduction contextuelle à "créer un nouveau document" [MR #751](https://gitlab.com/dokos/dodock/-/merge_requests/751){rel="&#x22;nofollow&#x22;"}
- Toujours afficher la flèche dans ControlLink [MR #753](https://gitlab.com/dokos/dodock/-/merge_requests/753){rel="&#x22;nofollow&#x22;"}
- Versionnement de l'API et API v2 (bêta) par ankush [frappe#22300](https://github.com/frappe/frappe/pull/22300){rel="&#x22;nofollow&#x22;"} [MR #732](https://gitlab.com/dokos/dodock/-/merge_requests/732){rel="&#x22;nofollow&#x22;"}
- Limite de fréquence des connexions basée sur l'adresse IP également par ankush [frappe#22774](https://github.com/frappe/frappe/pull/22774){rel="&#x22;nofollow&#x22;"} [MR #741](https://gitlab.com/dokos/dodock/-/merge_requests/741){rel="&#x22;nofollow&#x22;"}
- Actualisation automatique lorsque l'utilisateur met à jour le thème par shridarpatil [frappe#22771](https://github.com/frappe/frappe/pull/22771){rel="&#x22;nofollow&#x22;"} [MR #737](https://gitlab.com/dokos/dodock/-/merge_requests/737){rel="&#x22;nofollow&#x22;"}
- E-mail depuis le champ 'Table Multiselect' dans notification par sayedayman203 [frappe#22733](https://github.com/frappe/frappe/pull/22733){rel="&#x22;nofollow&#x22;"} [MR #719](https://gitlab.com/dokos/dodock/-/merge_requests/719){rel="&#x22;nofollow&#x22;"}
- Autorisation de la suppression et ajout de la fonction de suppression de dossier pour les pages par Vishnu7025 [frappe#23077](https://github.com/frappe/frappe/pull/23077){rel="&#x22;nofollow&#x22;"} [MR #842](https://gitlab.com/dokos/dodock/-/merge_requests/842){rel="&#x22;nofollow&#x22;"}
- Importation du scss depuis node\_modules dans les applications également par blaggacao [frappe#22519](https://github.com/frappe/frappe/pull/22519){rel="&#x22;nofollow&#x22;"} [MR #818](https://gitlab.com/dokos/dodock/-/merge_requests/818){rel="&#x22;nofollow&#x22;"}
- Ajout du bouton "Graphique du tableau de bord" par Vishnu7025 [frappe#22960](https://github.com/frappe/frappe/pull/22960){rel="&#x22;nofollow&#x22;"} [MR #814](https://gitlab.com/dokos/dodock/-/merge_requests/814){rel="&#x22;nofollow&#x22;"}
- Option pour définir le type de fichier par défaut de manière programmatique dans export de données par hyaray [frappe#22658](https://github.com/frappe/frappe/pull/22658){rel="&#x22;nofollow&#x22;"} [MR #808](https://gitlab.com/dokos/dodock/-/merge_requests/808){rel="&#x22;nofollow&#x22;"}
- Documentation de Document.remove\_tag par gavindsouza [frappe#22970](https://github.com/frappe/frappe/pull/22970){rel="&#x22;nofollow&#x22;"} [MR #802](https://gitlab.com/dokos/dodock/-/merge_requests/802){rel="&#x22;nofollow&#x22;"}
- Ajustements au style de dokos v4 [MR #767](https://gitlab.com/dokos/dodock/-/merge_requests/767){rel="&#x22;nofollow&#x22;"}
- Ajout d'une traduction contextuelle à "créer un nouveau document" [MR #751](https://gitlab.com/dokos/dodock/-/merge_requests/751){rel="&#x22;nofollow&#x22;"}
- Toujours afficher la flèche dans ControlLink [MR #753](https://gitlab.com/dokos/dodock/-/merge_requests/753){rel="&#x22;nofollow&#x22;"}
- Versionnement de l'API et API v2 (bêta) par ankush [frappe#22300](https://github.com/frappe/frappe/pull/22300){rel="&#x22;nofollow&#x22;"} [MR #732](https://gitlab.com/dokos/dodock/-/merge_requests/732){rel="&#x22;nofollow&#x22;"}
- Limite de fréquence des connexions basée sur l'adresse IP également par ankush [frappe#22774](https://github.com/frappe/frappe/pull/22774){rel="&#x22;nofollow&#x22;"} [MR #741](https://gitlab.com/dokos/dodock/-/merge_requests/741){rel="&#x22;nofollow&#x22;"}
- Mise à jour automatique lors de la modification du thème par shridarpatil [Pull Request #22771](https://github.com/frappe/frappe/pull/22771){rel="&#x22;nofollow&#x22;"} [MR #737](https://gitlab.com/dokos/dodock/-/merge_requests/737){rel="&#x22;nofollow&#x22;"}
- Notification par e-mail à partir du champ 'Table Multiselect' par sayedayman203 [Pull Request #22733](https://github.com/frappe/frappe/pull/22733){rel="&#x22;nofollow&#x22;"} [MR #719](https://gitlab.com/dokos/dodock/-/merge_requests/719){rel="&#x22;nofollow&#x22;"}
- Autoriser les clés de connexion sociale à contrôler les inscriptions par ankush [Pull Request #22724](https://github.com/frappe/frappe/pull/22724){rel="&#x22;nofollow&#x22;"} [MR #716](https://gitlab.com/dokos/dodock/-/merge_requests/716){rel="&#x22;nofollow&#x22;"}
- Déplacer les "j'aime" vers la droite, masquer les affectations vides - PR #22659 [Pull Request #22659](https://github.com/frappe/frappe/pull/22659){rel="&#x22;nofollow&#x22;"} [MR #712](https://gitlab.com/dokos/dodock/-/merge_requests/712){rel="&#x22;nofollow&#x22;"}
- Activer `tabSelect` pour awesomplete par akhilnarang [Pull Request #22687](https://github.com/frappe/frappe/pull/22687){rel="&#x22;nofollow&#x22;"} [MR #690](https://gitlab.com/dokos/dodock/-/merge_requests/690){rel="&#x22;nofollow&#x22;"}
- Activer `tabSelect` pour awesomplete par akhilnarang [Pull Request #22636](https://github.com/frappe/frappe/pull/22636){rel="&#x22;nofollow&#x22;"} [MR #677](https://gitlab.com/dokos/dodock/-/merge_requests/677){rel="&#x22;nofollow&#x22;"}
- Améliorer le développement d'OpenID Connect par blaggacao [Pull Request #22330](https://github.com/frappe/frappe/pull/22330){rel="&#x22;nofollow&#x22;"} [MR #670](https://gitlab.com/dokos/dodock/-/merge_requests/670){rel="&#x22;nofollow&#x22;"}
- Corriger les avertissements du linter [MR #641](https://gitlab.com/dokos/dodock/-/merge_requests/641){rel="&#x22;nofollow&#x22;"}
- Redesign (frappe#22191) [MR #623](https://gitlab.com/dokos/dodock/-/merge_requests/623){rel="&#x22;nofollow&#x22;"}
- Liste d'autorisation globale pour les extensions de fichiers par ankush [Pull Request #22531](https://github.com/frappe/frappe/pull/22531){rel="&#x22;nofollow&#x22;"} [MR #634](https://gitlab.com/dokos/dodock/-/merge_requests/634){rel="&#x22;nofollow&#x22;"}
- Renommer le champ 'fieldname' du champ personnalisé par ankush [Pull Request #22513](https://github.com/frappe/frappe/pull/22513){rel="&#x22;nofollow&#x22;"} [MR #625](https://gitlab.com/dokos/dodock/-/merge_requests/625){rel="&#x22;nofollow&#x22;"}
- Vérifier les autorisations d'écriture sur les pièces jointes au doc(type) par barredterra [Pull Request #22500](https://github.com/frappe/frappe/pull/22500){rel="&#x22;nofollow&#x22;"} [MR #621](https://gitlab.com/dokos/dodock/-/merge_requests/621){rel="&#x22;nofollow&#x22;"}
- Provision pour `set_route` pour la carte numérique personnalisée par DaizyModi [Pull Request #21806](https://github.com/frappe/frappe/pull/21806){rel="&#x22;nofollow&#x22;"} [MR #605](https://gitlab.com/dokos/dodock/-/merge_requests/605){rel="&#x22;nofollow&#x22;"}
- Ajouter des icônes personnalisées avec le crochet `app_include_icons` par cogk [Pull Request #22254](https://github.com/frappe/frappe/pull/22254){rel="&#x22;nofollow&#x22;"} [MR #603](https://gitlab.com/dokos/dodock/-/merge_requests/603){rel="&#x22;nofollow&#x22;"}
- Mise à jour en bloc des champs sélectionnés triés par libellés traduits par FHenry [Pull Request #22318](https://github.com/frappe/frappe/pull/22318){rel="&#x22;nofollow&#x22;"} [MR #602](https://gitlab.com/dokos/dodock/-/merge_requests/602){rel="&#x22;nofollow&#x22;"}
- Ajouter l'argument json amont à la requête de fabrication dans les intégrations par blaggacao [Pull Request #22462](https://github.com/frappe/frappe/pull/22462){rel="&#x22;nofollow&#x22;"} [MR #595](https://gitlab.com/dokos/dodock/-/merge_requests/595){rel="&#x22;nofollow&#x22;"}
- Ajouter des emojis aux espaces de travail [MR #593](https://gitlab.com/dokos/dodock/-/merge_requests/593){rel="&#x22;nofollow&#x22;"}
- Onboarding et visite guidée [MR #454](https://gitlab.com/dokos/dodock/-/merge_requests/454){rel="&#x22;nofollow&#x22;"}
- Ajouter un raccourci d'impression par niraj2477 [Pull Request #22471](https://github.com/frappe/frappe/pull/22471){rel="&#x22;nofollow&#x22;"} [MR #590](https://gitlab.com/dokos/dodock/-/merge_requests/590){rel="&#x22;nofollow&#x22;"}
- Voir les requêtes validées dans le journal de la console par shadrak98 [Pull Request #22466](https://github.com/frappe/frappe/pull/22466){rel="&#x22;nofollow&#x22;"} [MR #588](https://gitlab.com/dokos/dodock/-/merge_requests/588){rel="&#x22;nofollow&#x22;"}
- Ajouter une fonctionnalité d'autocomplétion pour le fuseau horaire de l'utilisateur par cogk [Pull Request #22456](https://github.com/frappe/frappe/pull/22456){rel="&#x22;nofollow&#x22;"} [MR #587](https://gitlab.com/dokos/dodock/-/merge_requests/587){rel="&#x22;nofollow&#x22;"}
- Ouvrir le document lié au lieu de la liste lorsque le nombre est égal à 1 [MR #582](https://gitlab.com/dokos/dodock/-/merge_requests/582){rel="&#x22;nofollow&#x22;"}
- Résoudre de légers problèmes de disposition du formulaire [MR #581](https://gitlab.com/dokos/dodock/-/merge_requests/581){rel="&#x22;nofollow&#x22;"}
- Ajouter des icônes personnalisées avec app\_include\_icons [MR #576](https://gitlab.com/dokos/dodock/-/merge_requests/576){rel="&#x22;nofollow&#x22;"}
- Trier par colonne en cliquant sur le titre de la colonne par cogk [Pull Request #22187](https://github.com/frappe/frappe/pull/22187){rel="&#x22;nofollow&#x22;"} [MR #570](https://gitlab.com/dokos/dodock/-/merge_requests/570){rel="&#x22;nofollow&#x22;"}
- Ouvrir les détails du fichier à partir de la recherche par barredterra [Pull Request #22108](https://github.com/frappe/frappe/pull/22108){rel="&#x22;nofollow&#x22;"} [MR #568](https://gitlab.com/dokos/dodock/-/merge_requests/568){rel="&#x22;nofollow&#x22;"}
- Améliorer la réactivité de la liste d'adresses et de contacts par barredterra [Pull Request #22270](https://github.com/frappe/frappe/pull/22270){rel="&#x22;nofollow&#x22;"} [MR #563](https://gitlab.com/dokos/dodock/-/merge_requests/563){rel="&#x22;nofollow&#x22;"}
- Utiliser le champ de lien pour la recherche dans le gestionnaire des autorisations de rôle par FHenry [Pull Request #22232](https://github.com/frappe/frappe/pull/22232){rel="&#x22;nofollow&#x22;"} [MR #560](https://gitlab.com/dokos/dodock/-/merge_requests/560){rel="&#x22;nofollow&#x22;"}
- Gestionnaire de rappel `after_response` par ankush [Pull Request #22398](https://github.com/frappe/frappe/pull/22398){rel="&#x22;nofollow&#x22;"} [MR #556](https://gitlab.com/dokos/dodock/-/merge_requests/556){rel="&#x22;nofollow&#x22;"}
- Journal d'audit par GursheenK [Pull Request #22104](https://github.com/frappe/frappe/pull/22104){rel="&#x22;nofollow&#x22;"} [MR #546](https://gitlab.com/dokos/dodock/-/merge_requests/546){rel="&#x22;nofollow&#x22;"}
- Taille maximale du fichier configurable à partir des paramètres système par ankush [Pull Request #22384](https://github.com/frappe/frappe/pull/22384){rel="&#x22;nofollow&#x22;"} [MR #544](https://gitlab.com/dokos/dodock/-/merge_requests/544){rel="&#x22;nofollow&#x22;"}
- \#22308 par ankush [Pull Request #22389](https://github.com/frappe/frappe/pull/22389){rel="&#x22;nofollow&#x22;"} [MR #548](https://gitlab.com/dokos/dodock/-/merge_requests/548){rel="&#x22;nofollow&#x22;"}
- Développer les assignations au survol par barredterra [Pull Request #22337](https://github.com/frappe/frappe/pull/22337){rel="&#x22;nofollow&#x22;"} [MR #522](https://gitlab.com/dokos/dodock/-/merge_requests/522){rel="&#x22;nofollow&#x22;"}
- Générer dynamiquement le texte de la licence par niraj2477 [Pull Request #22299](https://github.com/frappe/frappe/pull/22299){rel="&#x22;nofollow&#x22;"} [MR #516](https://gitlab.com/dokos/dodock/-/merge_requests/516){rel="&#x22;nofollow&#x22;"}
- Couleurs par défaut et option de mise à jour des options des graphiques avant le rendu des graphiques du rapport
- Style d'onglet plus compact [MR #513](https://gitlab.com/dokos/dodock/-/merge_requests/513){rel="&#x22;nofollow&#x22;"}
- Utiliser `functools.cached_property` par sagarvora [Pull Request #22304](https://github.com/frappe/frappe/pull/22304){rel="&#x22;nofollow&#x22;"} [MR #511](https://gitlab.com/dokos/dodock/-/merge_requests/511){rel="&#x22;nofollow&#x22;"}
- Fusionner la demande de tirage de GHSA-j2w9-8xrr-7g98 [MR #491](https://gitlab.com/dokos/dodock/-/merge_requests/491){rel="&#x22;nofollow&#x22;"}
- Remplacer `on_update` dans la communication par ssiyad [Pull Request #22267](https://github.com/frappe/frappe/pull/22267){rel="&#x22;nofollow&#x22;"} [MR #505](https://gitlab.com/dokos/dodock/-/merge_requests/505){rel="&#x22;nofollow&#x22;"}
- Afficher le titre d'avertissement dans les fichiers publics par barredterra [Pull Request #22242](https://github.com/frappe/frappe/pull/22242){rel="&#x22;nofollow&#x22;"} [MR #503](https://gitlab.com/dokos/dodock/-/merge_requests/503){rel="&#x22;nofollow&#x22;"}
- Rôle `Desk User` par ankush [Pull Request #22224](https://github.com/frappe/frappe/pull/22224){rel="&#x22;nofollow&#x22;"} [MR #476](https://gitlab.com/dokos/dodock/-/merge_requests/476){rel="&#x22;nofollow&#x22;"}
- Envoyer un identifiant de demande unique en tant qu'en-tête de réponse par ankush [Pull Request #22218](https://github.com/frappe/frappe/pull/22218){rel="&#x22;nofollow&#x22;"} [MR #468](https://gitlab.com/dokos/dodock/-/merge_requests/468){rel="&#x22;nofollow&#x22;"}
- Ajout de deux options do\_not\_make\_page et do\_not\_setup\_menu pour l'arborescence par rohitwaghchaure [Pull Request #22190](https://github.com/frappe/frappe/pull/22190){rel="&#x22;nofollow&#x22;"} [MR #450](https://gitlab.com/dokos/dodock/-/merge_requests/450){rel="&#x22;nofollow&#x22;"}
- Ajouter la sélection rapide de plusieurs lignes avec Maj+Clic [MR #444](https://gitlab.com/dokos/dodock/-/merge_requests/444){rel="&#x22;nofollow&#x22;"}
- Tracé de base à l'aide de l'identifiant de trace du moniteur par ankush [Pull Request #22126](https://github.com/frappe/frappe/pull/22126){rel="&#x22;nofollow&#x22;"} [MR #435](https://gitlab.com/dokos/dodock/-/merge_requests/435){rel="&#x22;nofollow&#x22;"}
- Renvoyer le chemin absolu par barredterra [Pull Request #22142](https://github.com/frappe/frappe/pull/22142){rel="&#x22;nofollow&#x22;"} [MR #433](https://gitlab.com/dokos/dodock/-/merge_requests/433){rel="&#x22;nofollow&#x22;"}
- Autoriser la réexécution des correctifs en mode développeur [MR #418](https://gitlab.com/dokos/dodock/-/merge_requests/418){rel="&#x22;nofollow&#x22;"}
- Améliorer attach\_print et permettre d'utiliser sa sortie dans email.make par barredterra [Pull Request #21837](https://github.com/frappe/frappe/pull/21837){rel="&#x22;nofollow&#x22;"} [MR #416](https://gitlab.com/dokos/dodock/-/merge_requests/416){rel="&#x22;nofollow&#x22;"}
- Journaux de réexécution dans la console système par RitvikSardana [Pull Request #22103](https://github.com/frappe/frappe/pull/22103){rel="&#x22;nofollow&#x22;"} [MR #413](https://gitlab.com/dokos/dodock/-/merge_requests/413){rel="&#x22;nofollow&#x22;"}
- [Accessibilité des pièces jointes via la barre latérale](https://gitlab.com/dokos/dodock/-/merge_requests/401){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;[frappe#21819](https://github.com/frappe/frappe/pull/21819){rel="&#x22;nofollow&#x22;"}*
- [Exécution de gunicorn dans la configuration de développement](https://gitlab.com/dokos/dodock/-/merge_requests/406){rel="&#x22;nofollow&#x22;"}
- [Ajout de crochets pour intégrer des routes dynamiques pour différents types de vues web doctype](https://gitlab.com/dokos/dodock/-/merge_requests/402){rel="&#x22;nofollow&#x22;"}
- [Fermeture d'assignation depuis la barre latérale](https://gitlab.com/dokos/dodock/-/merge_requests/398){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;[frappe#21913](https://github.com/frappe/frappe/pull/21913){rel="&#x22;nofollow&#x22;"}*
- [Implémentation du bouton "J'aime" dans l'utilitaire de comparaison](https://gitlab.com/dokos/dodock/-/merge_requests/371){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;[frappe#22017](https://github.com/frappe/frappe/pull/22017){rel="&#x22;nofollow&#x22;"}*
- [Création d'un doctype virtuel pour l'enregistreur frappe](https://gitlab.com/dokos/dodock/-/merge_requests/363){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;[frappe#21908](https://github.com/frappe/frappe/pull/21908){rel="&#x22;nofollow&#x22;"}*
- [Ajout d'un éditeur de texte et de mentions pour les discussions](https://gitlab.com/dokos/dodock/-/merge_requests/343){rel="&#x22;nofollow&#x22;"}
- [Nouvelle fonctionnalité dans le Constructeur de Rapports : Impression de tous les filtres](https://gitlab.com/dokos/dodock/-/merge_requests/348){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;[frappe#21903](https://github.com/frappe/frappe/pull/21903){rel="&#x22;nofollow&#x22;"}*
- [Ajout du bouton "Re-exécuter dans la Console" dans le Doctype Journal de la Console](https://gitlab.com/dokos/dodock/-/merge_requests/340){rel="&#x22;nofollow&#x22;"}
- [Intégration d'une variable d'environnement pour configurer le répertoire de Bench / workdir](https://gitlab.com/dokos/dodock/-/merge_requests/309){rel="&#x22;nofollow&#x22;"}
- [Nouveau paramètre pour forcer le mode de capture web pour les téléchargements de caméra](https://gitlab.com/dokos/dodock/-/merge_requests/306){rel="&#x22;nofollow&#x22;"}
- [Ajout d'un lien rapide vers un tableau Kanban spécifique dans l'espace de travail](https://gitlab.com/dokos/dodock/-/merge_requests/294){rel="&#x22;nofollow&#x22;"}
- [Journalisation des adresses IP pour les activités de connexion/déconnexion](https://gitlab.com/dokos/dodock/-/merge_requests/293){rel="&#x22;nofollow&#x22;"}
- [Nouvelle fonctionnalité (DX) : Annotations de type pour les contrôleurs](https://gitlab.com/dokos/dodock/-/merge_requests/261){rel="&#x22;nofollow&#x22;"}
- [Automatisation des annotations de type Python (DX)](https://gitlab.com/dokos/dodock/-/merge_requests/259){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;[frappe#21776](https://github.com/frappe/frappe/pull/21776){rel="&#x22;nofollow&#x22;"}*
- [Amélioration des rapports avec Tabulator](https://gitlab.com/dokos/dodock/-/merge_requests/235){rel="&#x22;nofollow&#x22;"}
- [Renforcement de la fonction safe\_block\_eval](https://gitlab.com/dokos/dodock/-/merge_requests/190){rel="&#x22;nofollow&#x22;"}
- [Éditeur de Notifications basé sur des Blocs](https://gitlab.com/dokos/dodock/-/merge_requests/156){rel="&#x22;nofollow&#x22;"}
- [Normalisation des requêtes dans l'enregistreur](https://gitlab.com/dokos/dodock/-/merge_requests/236){rel="&#x22;nofollow&#x22;"}
- [Analyseur personnalisé de séquences numériques via des hooks](https://gitlab.com/dokos/dodock/-/merge_requests/224){rel="&#x22;nofollow&#x22;"}
- [Compatibilité PEP517 dans les nouvelles applications](https://gitlab.com/dokos/dodock/-/merge_requests/216){rel="&#x22;nofollow&#x22;"}
- [Amélioration de la recherche des courriels](https://gitlab.com/dokos/dodock/-/merge_requests/214){rel="&#x22;nofollow&#x22;"}
- [Possibilité d'utiliser des champs HTML dans les grilles](https://gitlab.com/dokos/dodock/-/merge_requests/182){rel="&#x22;nofollow&#x22;"}
- [Liaison de l'adresse/du contact sans dynamic\_link](https://gitlab.com/dokos/dodock/-/merge_requests/176){rel="&#x22;nofollow&#x22;"}
- Fusion de diverses propositions d'améliorations (PR)
- Prise en charge de RQ WorkerPool
- Hooks avant/après pour toute installation/désinstallation d'application
- Ajout de l'intégration webhook Discord
- [Intégration webhook Discord ajoutée](https://gitlab.com/dokos/dodock/-/merge_requests/160){rel="&#x22;nofollow&#x22;"}
- Configuration personnalisable du nom d'amendement pour les documents
- Commande de migration des traductions
- Délai d'attente pour le webhook
- Nouvel icône flèche-bas-droite ajouté pour la Carte Numérique
- [Améliorations de la flèche de ControlLink](https://gitlab.com/dokos/dodock/-/merge_requests/154){rel="&#x22;nofollow&#x22;"}
- [Ignorer le destinataire noreply dans send\_auto\_reply](https://gitlab.com/dokos/dodock/-/merge_requests/153){rel="&#x22;nofollow&#x22;"}
- Bouton pour charger davantage de communications dans la chronologie
- Amélioration : Réessai en masse pour la file d'attente d'e-mails et limitation du réessai infini pour certaines exceptions SMTP
- Défilement automatique jusqu'au champ via URL
- Possibilité de réorganiser les champs standard dans le Constructeur de Formulaires
- Enregistrement du PID et de l'utilisateur dans les journaux de demande
- Nouvelle fonction : Réinitialisation de la disposition à l'état d'origine par les utilisateurs
- Réarrangement possible des champs standard dans les formulaires personnalisés
- Paramètre "no\_smtp\_authentication" configurable depuis la configuration du site
- Fonctionnalité : frappe.cache -> frappe.cache
- Lecture seule pour la géolocalisation
- Ajout du paramètre "escapechar" aux utilitaires CSV
- Possibilité de vider les journaux de vue
- Hooks de base de données pour l'exécution d'actions avant/après la validation/annulation
- Nouveau formatage pour les champs "Attach" et "Attach Image"
- URL de webhook dynamique
- Personnalisation du modèle d'e-mail pour le message de bienvenue et la réinitialisation du mot de passe
- **[Nouvelle fonctionnalité : Validation et mise en évidence du code Python pour safe\_block\_eval](https://gitlab.com/dokos/dodock/-/merge_requests/152){rel="&#x22;nofollow&#x22;"}**
- Possibilité de vider les vues des pages web
- Nouvelle fonction : Réexécution des correctifs en mode développeur
- Affichage de l'utilisation de la table DB selon le type de document
- Enregistrement de toutes les requêtes DDL dans les journaux
- Fonctionnalité : Remplissage des champs à partir des kwargs dans frappe.new\_doc
- Utilisation de la version mise en cache du document dans le mapper
- Configuration possible du cron en tant que fréquence du script serveur
- Ajout et suppression simplifiés des modèles d'e-mails avec le bouton de groupe de sélection
- Nouvelle fonction db.get\_column\_type pour postgres
- Intégration des fonctions QB d'Arrondi et de Troncature
- Visite de Découverte
- Journalisation de wkhtmltopdf
- Ajout automatique du modèle patches.txt pour les nouvelles applications
- Améliorations du DocType de Webhook
- **[Amélioration : Définition de l'onglet actif en fonction du #hash de l'URL](https://gitlab.com/dokos/dodock/-/merge_requests/140){rel="&#x22;nofollow&#x22;"}**
- **[Refonte de l'interface de liste](https://gitlab.com/dokos/dodock/-/merge_requests/141){rel="&#x22;nofollow&#x22;"}**
- Recevoir des réponses anonymes depuis le formulaire web
- Nouveau contexte pour les traductions des liens de l'espace de travail
- Ajout du type d'URL dans le raccourci de l'espace de travail
- Obligation de rendre publiques les images du site web
- Intégration de nouvelles analyses de site web
- **[Nouvelle option pour définir un espace de travail par défaut dans le document utilisateur](https://gitlab.com/dokos/dodock/-/merge_requests/113){rel="&#x22;nofollow&#x22;"}**
- **[Ajout d'une option forced\_file\_visibility pour les fichiers privés/publics](https://gitlab.com/dokos/dodock/-/merge_requests/133){rel="&#x22;nofollow&#x22;"}**
- **[Correction : Résolution des problèmes avec les vues de liste](https://gitlab.com/dokos/dodock/-/merge_requests/131){rel="&#x22;nofollow&#x22;"}**
- Amélioration : Rendre le nom du rapport traduisible
- Génération de l'image Docker la plus récente
- Réactivation des notifications pour les mises à jour du système
- **[Correction et optimisation de la construction et du chargement différé](https://gitlab.com/dokos/dodock/-/merge_requests/116){rel="&#x22;nofollow&#x22;"}**
- Nouvelle fonctionnalité : Sélectionner plusieurs lignes en cliquant et faisant glisser sur la case à cocher de la vue en liste
- Amélioration : Encadrer get\_table\_name avec des backticks
- **[Nouvelle fonctionnalité : Génération de base de boilerplate pour le graphique du tableau de bord](https://gitlab.com/dokos/dodock/-/merge_requests/114){rel="&#x22;nofollow&#x22;"}**
- Vue de planification compatible avec le type de vue Calendrier
- Options pour exclure certains champs en tant que ressources et pour ajouter une ressource par défaut
- Nouvelle vue grille horaire de ressource
- Première version de la vue de planification
- Amélioration de l'icône
- Effacement du champ doctype lors de la vidange
- Réactivation des variables dans l'éditeur de texte enrichi
- **[Nouvelle vue de planification](https://gitlab.com/dokos/dodock/-/merge_requests/110){rel="&#x22;nofollow&#x22;"}**
- **[Nouvel éditeur de blocs de modèle](https://gitlab.com/dokos/dodock/-/merge_requests/111){rel="&#x22;nofollow&#x22;"}**
- **[Nouvelle fonctionnalité (AutoRepeat) : Calcul des jours par rapport à la date initiale](https://gitlab.com/dokos/dodock/-/merge_requests/109){rel="&#x22;nofollow&#x22;"}**
- **[Amélioration de la carte de résumé](https://gitlab.com/dokos/dodock/-/merge_requests/107){rel="&#x22;nofollow&#x22;"}**
- Identifiants d'e-mail et de numéros de téléphone cliquables avec moins d'étiquettes
- **[Amélioration du contraste de l'interface utilisateur](https://gitlab.com/dokos/dodock/-/merge_requests/105){rel="&#x22;nofollow&#x22;"}**
- Désactivation globale du partage
- Nouveau décorateur de cache redis
- Affichage de l'état de l'adresse désactivée
- Réactivation du planificateur depuis le bureau
- Ajout de l'en-tête de lettre et d'impression à la fonction d'impression
- **[Nouveau rendu collaboratif JS Jinja](https://gitlab.com/dokos/dodock/-/merge_requests/98){rel="&#x22;nofollow&#x22;"}**
- **[Ajout de boutons d'action dans l'en-tête de la liste pour les éléments sélectionnés](https://gitlab.com/dokos/dodock/-/merge_requests/100){rel="&#x22;nofollow&#x22;"}**
- Journalisation de la date et de l'heure dans le journal des tâches de fond
- Ajout de la campagne et du média à la vue de la page web
- Traduction possible de l'état du flux de travail
- Restructuration des traductions web
- Effacement des journaux de demande du journal d'intégration
- Séparation de la colonne principale et de la colonne latérale
- Conversion de la marge de la barre latérale en unité `rem`
- Augmentation de la taille de police par défaut de la barre latérale
- Refonte de la barre latérale
- **[Restructuration des traductions web](https://gitlab.com/dokos/dodock/-/merge_requests/102){rel="&#x22;nofollow&#x22;"}**
- Ajout des méthodes check\_if\_locked et is\_locked
- **[Utilisation de l'API de composition Vue 3 pour QAMI](https://gitlab.com/dokos/dodock/-/merge_requests/101){rel="&#x22;nofollow&#x22;"}**
- **[Amélioration de la barre latérale](https://gitlab.com/dokos/dodock/-/merge_requests/74){rel="&#x22;nofollow&#x22;"}**
- Ajout automatique d'un préfixe aux champs personnalisés générés par l'utilisateur
- Autorisation de la configuration ttl pour la rétention des travaux RQ
- Ajout de l'attribut is\_standard à la Carte de Résumé
- Simplification du DOM avec l'ajout d'un schéma
- Intégration de traductions à la Carte de Résumé
- Enregistrement de la Carte de Résumé en tant que bloc
- Intégration de JavaScript et de styles pour le bloc
- Création du type de document "Carte de Résumé"
- Nouvelle méthode meta.get\_views\_of\_doctype
- Utilisation de time.monotonic
- Méthodes de configuration pour l'arrondi
- **[Ajout de plus de couleurs](https://gitlab.com/dokos/dodock/-/merge_requests/89){rel="&#x22;nofollow&#x22;"}**
- **[Ajout de plus de couleurs](https://gitlab.com/dokos/dodock/-/merge_requests/87){rel="&#x22;nofollow&#x22;"}**
- Méthodes de configuration pour l'arrondi
- Suppression des utilitaires de fuseau horaire obsolètes
- Suivi du nombre de vues des courriels de la newsletter
- Rappels pour les documents
- Annuler/Refaire
- Nouvelle option convertToUserTz pour corriger les écarts de fuseau horaire
- Hooks {Avant/Après} pour les demandes et les travaux
- Transmission d'arguments supplémentaires à la console de base de données
- Ajustement de la taille de la fenêtre de dialogue d'entrée rapide en fonction des colonnes
- **[Amélioration de la pagination dans la grille](https://gitlab.com/dokos/dodock/-/merge_requests/42){rel="&#x22;nofollow&#x22;"}**
- Masquage/Affichage de l'espace de travail dans la barre latérale
- Validation des indices de type d'exécution

## Refonte du code et des fonctionnalités existantes

- [Améliorations des utilitaires d'abonnement](https://gitlab.com/dokos/dodock/-/merge_requests/352){rel="&#x22;nofollow&#x22;"}
- [Mise à jour de get\_system\_users](https://gitlab.com/dokos/dodock/-/merge_requests/385){rel="&#x22;nofollow&#x22;"}
- [Optimisation des vérifications d'attributs non sécurisés](https://gitlab.com/dokos/dodock/-/merge_requests/378){rel="&#x22;nofollow&#x22;"}
- [Optimisation de la suppression des lignes enfants lors de doc.save](https://gitlab.com/dokos/dodock/-/merge_requests/367){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;[frappe#22003](https://github.com/frappe/frappe/pull/22003){rel="&#x22;nofollow&#x22;"}*
- [Optimisation du code avec sourcery](https://gitlab.com/dokos/dodock/-/merge_requests/361){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;[frappe#21955](https://github.com/frappe/frappe/pull/21955){rel="&#x22;nofollow&#x22;"}*
- [Validation des noms de licence avant l'envoi du texte](https://gitlab.com/dokos/dodock/-/merge_requests/325){rel="&#x22;nofollow&#x22;"}
- [Création de la classe BaseWebCalendar pour le calendrier des événements](https://gitlab.com/dokos/dodock/-/merge_requests/142){rel="&#x22;nofollow&#x22;"}
- [Simplification de la personnalisation du contrôle de géolocalisation](https://gitlab.com/dokos/dodock/-/merge_requests/291){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;[frappe#21734](https://github.com/frappe/frappe/pull/21734){rel="&#x22;nofollow&#x22;"}*
- [Prise en charge de noms de devise traduisibles](https://gitlab.com/dokos/dodock/-/merge_requests/282){rel="&#x22;nofollow&#x22;"}
- [Utilisation de l'API URLSearchParams pour les filtres de vue en liste](https://gitlab.com/dokos/dodock/-/merge_requests/188){rel="&#x22;nofollow&#x22;"}
- [Optimisation des contrôles float, int, currency](https://gitlab.com/dokos/dodock/-/merge_requests/137){rel="&#x22;nofollow&#x22;"}
- Améliorations dans le reporting des rapports préparés
- Mise à jour de `frappe.realtime`
- Suppression de la prise en charge de currentsite.txt
- Attribution d'un espace de noms à tous les travaux RQ
- Dépréciation du mixin broken-img
- Suppression du type de document de capture d'erreur
- Préfixage des noms de champs personnalisés créés depuis Desk
- Considération des documents uniques pour l'utilisation dynamique de set\_value
- Déblocage de l'invocation redis et de la connexion socket Unix
- Utilisation de set\_value
- Suppression du code précédemment déprécié
- Suppression de l'ancien hachage de mot de passe
- Dépréciation de l'importation de fixturs/custom\_scripts
- Fusion des fonctionnalités redis\_socketio et redis\_queue
- Utilisation de frappe.cache dans translate.py
- Optimisation de l'utilisation de frappe.cache
- Utilisation de clés simples au lieu de hachages pour le caching
- Planification de RQ après la validation et les tests
- Déplacement de flush\_realtime\_log vers realtime.py
- Mise en place d'un gestionnaire de rappel générique
- Transfert de flush\_local\_link\_count vers le hook
- Changement de l'implémentation de enqueue\_after\_commit
- Suppression des observateurs de rollback
- Suppression de frappe.db.add\_before\_commit
- Suppression de l'ajout dynamique de \_comments
- Attachement du fichier txt aux e-mails reçus
- Obtention de l'adresse par défaut
- Utilisation de l'ID de travail pour la déduplication des travaux en arrière-plan
- Suppression de la boîte de dialogue de mise à jour du compteur et rendu du compteur modifiable par défaut
- Nettoyage de la récupération des e-mails
- Remplacement de imghdr par filetype
- Utilisation de urljoin pour construire l'URL de l'image
- Formatage de pretty\_date
- Configuration des options de docfield sans méthode
- Renommage des méthodes d'arrondi
- Amélioration du suivi des journaux de webhook
- Simplification de get\_controller
- Utilisation de qb.engine
- Dépréciation complète de db.set\_value sur les documents uniques
- Vérification et suppression des files d'attente en double

## Amélioration de la performance

- [Amélioration de la recherche globale](https://gitlab.com/dokos/dodock/-/merge_requests/353){rel="&#x22;nofollow&#x22;"}
- [Notification aux développeurs concernant l'activation de l'index sur les liens](https://gitlab.com/dokos/dodock/-/merge_requests/320){rel="&#x22;nofollow&#x22;"}
- [Optimisation des performances du fichier : Compression légèrement plus agressive par surajshetty3416](https://gitlab.com/dokos/dodock/-/merge_requests/316){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;[frappe#21899](https://github.com/frappe/frappe/pull/21899){rel="&#x22;nofollow&#x22;"}*
- [Gestion améliorée des documents déjà en cours d'enregistrement](https://gitlab.com/dokos/dodock/-/merge_requests/308){rel="&#x22;nofollow&#x22;"}
- [Index de la table de la file d'attente d'e-mails](https://gitlab.com/dokos/dodock/-/merge_requests/297){rel="&#x22;nofollow&#x22;"}
- [Ajustement de la priorité des processus en arrière-plan](https://gitlab.com/dokos/dodock/-/merge_requests/292){rel="&#x22;nofollow&#x22;"}
- [Optimisation du traitement des nouveaux documents](https://gitlab.com/dokos/dodock/-/merge_requests/281){rel="&#x22;nofollow&#x22;"}
- [Suppression de `ifnull` du filtre `IS SET`](https://gitlab.com/dokos/dodock/-/merge_requests/278){rel="&#x22;nofollow&#x22;"}
- [Amélioration des performances : Réduction des appels et lectures de la base de données dans les requêtes courantes par ankush](https://gitlab.com/dokos/dodock/-/merge_requests/249){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;[frappe#21762](https://github.com/frappe/frappe/pull/21762){rel="&#x22;nofollow&#x22;"}*
- [Obtention plus efficace des types de tâches planifiées en une seule requête](https://gitlab.com/dokos/dodock/-/merge_requests/251){rel="&#x22;nofollow&#x22;"}
- [Optimisation du chargement des liens du tableau de bord](https://gitlab.com/dokos/dodock/-/merge_requests/246){rel="&#x22;nofollow&#x22;"}
- [Amélioration des transitions et du traitement en masse des workflows par ankush](https://gitlab.com/dokos/dodock/-/merge_requests/243){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;[frappe#21737](https://github.com/frappe/frappe/pull/21737){rel="&#x22;nofollow&#x22;"}*
- [Optimisation du chargement initial du bureau : Réduction des requêtes inutiles par ankush](https://gitlab.com/dokos/dodock/-/merge_requests/225){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;[frappe#21695](https://github.com/frappe/frappe/pull/21695){rel="&#x22;nofollow&#x22;"}*
- [Gestion plus précise du cache des ressources par ankush](https://gitlab.com/dokos/dodock/-/merge_requests/223){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;[frappe#21693](https://github.com/frappe/frappe/pull/21693){rel="&#x22;nofollow&#x22;"}*
- [Chargement efficace des statistiques des balises dans la barre latérale par ankush](https://gitlab.com/dokos/dodock/-/merge_requests/221){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;[frappe#21683](https://github.com/frappe/frappe/pull/21683){rel="&#x22;nofollow&#x22;"}*
- [Réduction de la surcharge de l'enregistreur](https://gitlab.com/dokos/dodock/-/merge_requests/197){rel="&#x22;nofollow&#x22;"}
- Optimisation du pré-chargement de modules supplémentaires
- Amélioration des vérifications de permission pour DocShare : Plus de rapidité
- Report de l'importation pydoc
- Utilisation plus efficace de la mémoire du travailleur web
- Pré-chargement des modules courants pour réduire la consommation mémoire
- Optimisation : Suspension de la collecte des déchets avant la création des travailleurs Gunicorn
- Déplacement de l'importation de babel vers la fonction d'extraction
- Réduction de l'utilisation de la mémoire pour les processus en arrière-plan
- Optimisation de certaines icônes
- Chargement efficace des icônes
- [Optimisation du chargement des icônes (site web et bureau)](https://gitlab.com/dokos/dodock/-/merge_requests/157){rel="&#x22;nofollow&#x22;"}
- Accélération de la logique d'exportation de rapports
- Amélioration de la rapidité de la logique d'exportation de rapports
- Optimisation : Requêtes plus rapides pour DocShare
- Index pour l'utilisateur dans le journal de notification
- Partage de la connexion de la file d'attente pour le temps réel

## Maintenance et organisation

- **Prise en charge de Python 3.12 par ankush** [*frappe#22706*](https://github.com/frappe/frappe/pull/22706){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!961](https://gitlab.com/dokos/dodock/-/merge_requests/961){rel="&#x22;nofollow&#x22;"}**
- **Suppression de cacheAcrossSpecs pour éviter les échecs massifs de permission*&#x2A; &#x2A;*[!909](https://gitlab.com/dokos/dodock/-/merge_requests/909){rel="&#x22;nofollow&#x22;"}**
- **Restriction de la version de Python à 3.11 uniquement par blaggacao** [*frappe#23229*](https://github.com/frappe/frappe/pull/23229){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!898](https://gitlab.com/dokos/dodock/-/merge_requests/898){rel="&#x22;nofollow&#x22;"}**
- **Formatage automatique des fichiers Vue avec prettier par surajshetty3416** [*frappe#23203*](https://github.com/frappe/frappe/pull/23203){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!885](https://gitlab.com/dokos/dodock/-/merge_requests/885){rel="&#x22;nofollow&#x22;"}**
- **Test d'intégration Smtp en utilisant smtp4dev par ankush** [*frappe#23094*](https://github.com/frappe/frappe/pull/23094){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!849](https://gitlab.com/dokos/dodock/-/merge_requests/849){rel="&#x22;nofollow&#x22;"}**
- **Mise à jour de PyPDF à la version 3.17.0 par bosue** [*frappe#23060*](https://github.com/frappe/frappe/pull/23060){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!839](https://gitlab.com/dokos/dodock/-/merge_requests/839){rel="&#x22;nofollow&#x22;"}**
- **Correction des tests qui utilisent requests*&#x2A; &#x2A;*[!778](https://gitlab.com/dokos/dodock/-/merge_requests/778){rel="&#x22;nofollow&#x22;"}**
- **Utilisation de l'image de base de docli pour la pipeline*&#x2A; &#x2A;*[!706](https://gitlab.com/dokos/dodock/-/merge_requests/706){rel="&#x22;nofollow&#x22;"}**
- **Mise à jour de postcss de 8.4.24 à 8.4.31 par dependabot [bot]** [*frappe#22615*](https://github.com/frappe/frappe/pull/22615){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!687](https://gitlab.com/dokos/dodock/-/merge_requests/687){rel="&#x22;nofollow&#x22;"}**
- **Correction du test flaky theme switcher UI*&#x2A; &#x2A;*[!640](https://gitlab.com/dokos/dodock/-/merge_requests/640){rel="&#x22;nofollow&#x22;"}**
- **Mise à jour de cypress par surajshetty3416** [*frappe#22505*](https://github.com/frappe/frappe/pull/22505){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!632](https://gitlab.com/dokos/dodock/-/merge_requests/632){rel="&#x22;nofollow&#x22;"}**
- Correction de test\_external\_link\_count
- **Affichage des tests ignorés dans le résumé*&#x2A; &#x2A;*[!580](https://gitlab.com/dokos/dodock/-/merge_requests/580){rel="&#x22;nofollow&#x22;"}**
- Ajout d'un ensemble de propriétés pour configurer le suivi des événements vus
- **Ignorer les changements d'espacement lors de la comparaison HTML par ankush** [*frappe#22386*](https://github.com/frappe/frappe/pull/22386){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!545](https://gitlab.com/dokos/dodock/-/merge_requests/545){rel="&#x22;nofollow&#x22;"}**
- **Mise à jour de frappe-datatable à la version 1.17.3 par surajshetty3416** [*frappe#22347*](https://github.com/frappe/frappe/pull/22347){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!528](https://gitlab.com/dokos/dodock/-/merge_requests/528){rel="&#x22;nofollow&#x22;"}**
- **Mise à jour des dépendances Python par ankush** [*frappe#22294*](https://github.com/frappe/frappe/pull/22294){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!506](https://gitlab.com/dokos/dodock/-/merge_requests/506){rel="&#x22;nofollow&#x22;"}**
- **Mise à jour de gitpython par ankush** [*frappe#22290*](https://github.com/frappe/frappe/pull/22290){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!499](https://gitlab.com/dokos/dodock/-/merge_requests/499){rel="&#x22;nofollow&#x22;"}**
- Autorisation des pipelines déclenchées par un mainteneur
- **Mise à jour de RestrictedPython à la dernière version par ankush** [*frappe#22258*](https://github.com/frappe/frappe/pull/22258){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!483](https://gitlab.com/dokos/dodock/-/merge_requests/483){rel="&#x22;nofollow&#x22;"}**
- **Autorisation des pipelines à partir des MR externes approuvés*&#x2A; &#x2A;*[!456](https://gitlab.com/dokos/dodock/-/merge_requests/456){rel="&#x22;nofollow&#x22;"}**
- **Mise à jour de gunicorn à la dernière version** [*frappe#22086*](https://github.com/frappe/frappe/pull/22086){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!404](https://gitlab.com/dokos/dodock/-/merge_requests/404){rel="&#x22;nofollow&#x22;"}**
- Mise à jour de la version de node
- **[Ajout d'une option pour ignorer les rapports préparés via les options de route](https://gitlab.com/dokos/dodock/-/merge_requests/400){rel="&#x22;nofollow&#x22;"}**
- **[Suppression de la télémétrie à l'échelle du système](https://gitlab.com/dokos/dodock/-/merge_requests/397){rel="&#x22;nofollow&#x22;"}**
- **[\[Tâche\] Traductions françaises en développement](https://gitlab.com/dokos/dodock/-/merge_requests/390){rel="&#x22;nofollow&#x22;"}**
- **[Correction d'une erreur dans le calcul de l'âge du site](https://gitlab.com/dokos/dodock/-/merge_requests/379){rel="&#x22;nofollow&#x22;"}**
- **[Ne pas formater la requête en tant que requise/gras](https://gitlab.com/dokos/dodock/-/merge_requests/373){rel="&#x22;nofollow&#x22;"}**
- **[Utiliser des chaînes de modèle pour le HTML](https://gitlab.com/dokos/dodock/-/merge_requests/369){rel="&#x22;nofollow&#x22;"}**
- **[Changement de l'ordre du code de télémétrie](https://gitlab.com/dokos/dodock/-/merge_requests/365){rel="&#x22;nofollow&#x22;"}**
- **[Correction d'une faute de frappe](https://gitlab.com/dokos/dodock/-/merge_requests/359){rel="&#x22;nofollow&#x22;"}**
- **[Suppression du code inutilisé](https://gitlab.com/dokos/dodock/-/merge_requests/326){rel="&#x22;nofollow&#x22;"}**
- **[Ignorer les tests de console sur PostgreSQL](https://gitlab.com/dokos/dodock/-/merge_requests/298){rel="&#x22;nofollow&#x22;"}**
- **[Suppression des marqueurs de conflit ressemblants](https://gitlab.com/dokos/dodock/-/merge_requests/288){rel="&#x22;nofollow&#x22;"}**
- **[Épingler strictement les réponses à la version 0.23.1 pour éviter les conflits de pip](https://gitlab.com/dokos/dodock/-/merge_requests/277){rel="&#x22;nofollow&#x22;"}**
- **[Suppression de la variable inutilisée](https://gitlab.com/dokos/dodock/-/merge_requests/250){rel="&#x22;nofollow&#x22;"}**
- **[Utiliser une expression cron standard](https://gitlab.com/dokos/dodock/-/merge_requests/252){rel="&#x22;nofollow&#x22;"}**
- Formatage, correction de test\_start\_status
- Retour anticipé en mode lecture seule
- L'analyse de urlparse fait déjà l'analyse pour nous, pas besoin de le faire soi-même
- Ajout d'une traduction au texte dans Update kanban\_settings.js
- Suivi des actions de mise à jour par type de document
- Ajout d'une traduction au texte de confirmation dans Update kanban\_view\.js
- Augmentation de la limite de communication
- Suppression de l'argument inutilisé
- Suppression de l'utilisation de get\_shade
- Augmentation de la limite de communication
- Augmentation de la limite de communication
- Réorganisation des actions du formulaire de personnalisation
- Traductions françaises
- Suppression de socketio du flux de travail de base
- Mise à jour de nombreuses autres bibliothèques
- Utilisation de cgitb comme vendeur
- Ignorer l'engagement de redis.cache
- Ajout de l'entrée "sauté" dans la vue de liste pour le journal de correctif
- Suppression de get\_docname inutilisé
- Ajout de l'entrée "sauté" dans la vue de liste pour le journal de correctif
- Suppression de "select" de ddl prefix
- Suppression de la suppression en double du cache
- Séparation de la clé d'appel de la fonction pour @redis\_cache
- Traductions françaises
- Capturer la version de frappe dans le "heartbeat"
- Augmentation du niveau de journalisation
- Pré-engagement pour les fichiers JSON
- Ajout d'indications de type aux documents, BaseDocument et get\_doc
- Mise à jour de socketio
- Suppression du code mixpanel
- Mise à jour de nombreuses bibliothèques telles que demandes, chardet et dropbox
- Suivi des vues de route pour les premiers jours
- Capitalisation
- Augmentation de la période d'inactivité de la session par défaut
- Formatage de server\_script.json
- Obtention des icônes doctype directement au démarrage
- Ajout de nouveau du nom du rapport préparé dans l'URL
- Ne pas suivre les modifications pour le rapport préparé
- Augmentation de la période d'inactivité de la session par défaut
- Meilleures étiquettes
- Limitation des événements de télémétrie
- Passage des champs "sauté" et "traceback" en lecture seule dans le journal de correctif
- Déplacement de l'avertissement dans un commentaire
- Journalisation des événements de planification "sautés"
- Suivi de la progression de l'intégration
- Définition de la docstring set\_value
- En-tête de lettre et format d'impression par défaut en impression en masse
- Correction de la traduction rapide des listes
- **[Refonte des espaces de travail](https://gitlab.com/dokos/dodock/-/merge_requests/128){rel="&#x22;nofollow&#x22;"}**
- **[Correction de la traduction de l'argent en mots + journalisation get\_all\_docs](https://gitlab.com/dokos/dodock/-/merge_requests/125){rel="&#x22;nofollow&#x22;"}**
- **[Traductions et améliorations pour Form Builder](https://gitlab.com/dokos/dodock/-/merge_requests/124){rel="&#x22;nofollow&#x22;"}**
- Ajout d'une limitation de fréquence utilisateur pour les tests
- Rendre le lien du titre traduisible pour les documents principaux
- **[Corrections pour le widget de graphique](https://gitlab.com/dokos/dodock/-/merge_requests/115){rel="&#x22;nofollow&#x22;"}**
- Mise à jour de FullCalendar et ajout du module complémentaire de ressources
- Nettoyage du CSS de l'indicateur
- Correction du z-index pour le nouvel en-tête de liste
- **[Correction du test\_rename\_doc](https://gitlab.com/dokos/dodock/-/merge_requests/112){rel="&#x22;nofollow&#x22;"}**
- Correction du z-index pour le nouvel en-tête de liste
- Traductions françaises
- Correction du style de la zone de pagination de la liste
- Ajout de l'ordre ascendant au constructeur de requêtes
- Traductions françaises
- Mise à niveau de babel de 2.9.0 à 2.12.1
- **[En cours : Carte de résumé](https://gitlab.com/dokos/dodock/-/merge_requests/94){rel="&#x22;nofollow&#x22;"}**
- Modification des traductions françaises
- Traduction du nouveau bouton dans le formulaire web
- Mise à niveau de babel de 2.9.0 à 2.12.1
- Condition de vérification simplifiée \*
- Simplifier la condition
- Supprimer la fonction auxiliaire inutile
- Suppression du cache local spécial pour les documents
- Suppression de code inutilisé
- Suppression de la fonction dépréciée check\_admin\_or\_system\_manager
- Épingler markupsafe

## Gestion des dépendances

- **[Mise à jour de la version de gunicorn](https://gitlab.com/dokos/dodock/-/merge_requests/404){rel="&#x22;nofollow&#x22;"}**
- **[Mise à jour de la version du client node redis](https://gitlab.com/dokos/dodock/-/merge_requests/268){rel="&#x22;nofollow&#x22;"}**
- **[Mise à jour de la version de bleach par blaggacao](https://gitlab.com/dokos/dodock/-/merge_requests/269){rel="&#x22;nofollow&#x22;"}*&#x2A; &#x2A;[frappe#21782](https://github.com/frappe/frappe/pull/21782){rel="&#x22;nofollow&#x22;"}*
- **[Mise à jour de la version de premailer](https://gitlab.com/dokos/dodock/-/merge_requests/260){rel="&#x22;nofollow&#x22;"}**
- **[Mise à jour de la version de pyyaml](https://gitlab.com/dokos/dodock/-/merge_requests/234){rel="&#x22;nofollow&#x22;"}**
- Mise à jour des dépendances JS
- **[Mise à jour de la version de semver](https://gitlab.com/dokos/dodock/-/merge_requests/183){rel="&#x22;nofollow&#x22;"}**
- Mise à jour de la version de Pydantic
- Mise à jour de la version minimale requise de node
- Mise à jour de la version de RQ
- Ajout de responses en tant que dépendance de développement
- Mise à jour de la bibliothèque PyPDF2
- Mise à jour de plusieurs dépendances
- Suppression de setup.py
- Mise à jour de cryptography et pyOpenSSL
- Mise à jour de la version de redis
- Mise à jour de la version de pymysql
- Mise à jour de la version de frappe-datatable
- Mise à jour de la version de pyyaml


# v4.1.0

::callout
La version 4.1.0 de Dodock est basée sur la version 15 de Frappe.
Une grande partie des changements cités ci-dessous ont été développés par l'équipe de Frappe Technologies et les contributeurs aux logiciels de l'éco-système Frappe/ERPNext.
Le détail des changements publiés dans Dodock est disponible sur [GitLab](https://gitlab.com/dokos/dodock/-/releases/v4.1.0){rel=""nofollow""}
::

::callout
🚧 Traduction à venir 🚧
::

## Fonctionnalités et améliorations

- **Jinja syntax highlighting *by barredterra*** [*frappe#23760*](https://github.com/frappe/frappe/pull/23760){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1144](https://gitlab.com/dokos/dodock/-/merge_requests/1144){rel="&#x22;nofollow&#x22;"}**
- **`describe-database-table` to get stats about a table *by ankush*** [*frappe#23813*](https://github.com/frappe/frappe/pull/23813){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1134](https://gitlab.com/dokos/dodock/-/merge_requests/1134){rel="&#x22;nofollow&#x22;"}**
- **`add-database-index` command to add and persist custom indexes *by ankush*** [*frappe#23787*](https://github.com/frappe/frappe/pull/23787){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1130](https://gitlab.com/dokos/dodock/-/merge_requests/1130){rel="&#x22;nofollow&#x22;"}**
- **Add Assigned To to resources in planning view*&#x2A; &#x2A;*[!1100](https://gitlab.com/dokos/dodock/-/merge_requests/1100){rel="&#x22;nofollow&#x22;"}**
- **(minor): Child table field as standard filter in list view *by szufisher*** [*frappe#23625*](https://github.com/frappe/frappe/pull/23625){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1098](https://gitlab.com/dokos/dodock/-/merge_requests/1098){rel="&#x22;nofollow&#x22;"}**
- **Scoped progress bar on bulk submit/cancel *by barredterra*** [*frappe#23623*](https://github.com/frappe/frappe/pull/23623){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1078](https://gitlab.com/dokos/dodock/-/merge_requests/1078){rel="&#x22;nofollow&#x22;"}**
- **Set sender name in documents created from email *by barredterra*** [*frappe#23554*](https://github.com/frappe/frappe/pull/23554){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1067](https://gitlab.com/dokos/dodock/-/merge_requests/1067){rel="&#x22;nofollow&#x22;"}**
- **Adding country Nepal in get\_number\_system country list *by rbnkoirala*** [*frappe#23582*](https://github.com/frappe/frappe/pull/23582){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1066](https://gitlab.com/dokos/dodock/-/merge_requests/1066){rel="&#x22;nofollow&#x22;"}**
- **Disable assigned thread notification *by maharshivpatel*** [*frappe#23535*](https://github.com/frappe/frappe/pull/23535){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1068](https://gitlab.com/dokos/dodock/-/merge_requests/1068){rel="&#x22;nofollow&#x22;"}**
- **(DX): Button "Pull Emails" *by barredterra*** [*frappe#23553*](https://github.com/frappe/frappe/pull/23553){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1050](https://gitlab.com/dokos/dodock/-/merge_requests/1050){rel="&#x22;nofollow&#x22;"}**
- **(UI): Add subject in timeline communication *by niraj2477*** [*frappe#23520*](https://github.com/frappe/frappe/pull/23520){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1044](https://gitlab.com/dokos/dodock/-/merge_requests/1044){rel="&#x22;nofollow&#x22;"}**
- **Patch and Delete Request to integration utils *by tonspar*** [*frappe#23525*](https://github.com/frappe/frappe/pull/23525){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1038](https://gitlab.com/dokos/dodock/-/merge_requests/1038){rel="&#x22;nofollow&#x22;"}**

## Corrections de bugs

- **(web): Fix password reset status code*&#x2A; &#x2A;*[!1151](https://gitlab.com/dokos/dodock/-/merge_requests/1151){rel="&#x22;nofollow&#x22;"}**
- **Cast SQL booleans to python*&#x2A; &#x2A;*[!1142](https://gitlab.com/dokos/dodock/-/merge_requests/1142){rel="&#x22;nofollow&#x22;"}**
- **Rename disable prepared report to enable prepared report*&#x2A; &#x2A;*[!1141](https://gitlab.com/dokos/dodock/-/merge_requests/1141){rel="&#x22;nofollow&#x22;"}**
- **French translations*&#x2A; &#x2A;*[!1140](https://gitlab.com/dokos/dodock/-/merge_requests/1140){rel="&#x22;nofollow&#x22;"}**
- **Add last name to quick entry form*&#x2A; &#x2A;*[!1139](https://gitlab.com/dokos/dodock/-/merge_requests/1139){rel="&#x22;nofollow&#x22;"}**
- **Keep bottom border in portal lists*&#x2A; &#x2A;*[!1138](https://gitlab.com/dokos/dodock/-/merge_requests/1138){rel="&#x22;nofollow&#x22;"}**
- **Consider user and sender both for "system user" *by ankush*** [*frappe#23806*](https://github.com/frappe/frappe/pull/23806){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1133](https://gitlab.com/dokos/dodock/-/merge_requests/1133){rel="&#x22;nofollow&#x22;"}**
- **(jinja): Update error message in `validate_template` function *by niraj2477*** [*frappe#23783*](https://github.com/frappe/frappe/pull/23783){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1131](https://gitlab.com/dokos/dodock/-/merge_requests/1131){rel="&#x22;nofollow&#x22;"}**
- **(rq\_job): Resolve deprecation warning *by akhilnarang*** [*frappe#23784*](https://github.com/frappe/frappe/pull/23784){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1128](https://gitlab.com/dokos/dodock/-/merge_requests/1128){rel="&#x22;nofollow&#x22;"}**
- **(minor): Avoid use of form object when routing to audit trail *by GursheenK*** [*frappe#23603*](https://github.com/frappe/frappe/pull/23603){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1127](https://gitlab.com/dokos/dodock/-/merge_requests/1127){rel="&#x22;nofollow&#x22;"}**
- **Validate custom portal menu entries during sync*&#x2A; &#x2A;*[!1126](https://gitlab.com/dokos/dodock/-/merge_requests/1126){rel="&#x22;nofollow&#x22;"}**
- **(web): Fix default sidebar colors*&#x2A; &#x2A;*[!1125](https://gitlab.com/dokos/dodock/-/merge_requests/1125){rel="&#x22;nofollow&#x22;"}**
- **(style): Fix dark theme*&#x2A; &#x2A;*[!1124](https://gitlab.com/dokos/dodock/-/merge_requests/1124){rel="&#x22;nofollow&#x22;"}**
- **Discard deleted doctypes unconditionally *by ankush*** [*frappe#23770*](https://github.com/frappe/frappe/pull/23770){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1122](https://gitlab.com/dokos/dodock/-/merge_requests/1122){rel="&#x22;nofollow&#x22;"}**
- **Remove web\_form.py rate limit key *by uhrjun*** [*frappe#23767*](https://github.com/frappe/frappe/pull/23767){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1121](https://gitlab.com/dokos/dodock/-/merge_requests/1121){rel="&#x22;nofollow&#x22;"}**
- **Remove testing internet connection for emails *by phot0n*** [*frappe#23581*](https://github.com/frappe/frappe/pull/23581){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1120](https://gitlab.com/dokos/dodock/-/merge_requests/1120){rel="&#x22;nofollow&#x22;"}**
- **Workflow doc states not existing on new forms *by ankush*** [*frappe#23756*](https://github.com/frappe/frappe/pull/23756){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1118](https://gitlab.com/dokos/dodock/-/merge_requests/1118){rel="&#x22;nofollow&#x22;"}**
- **Eye icon was not working anymore*&#x2A; &#x2A;*[!1117](https://gitlab.com/dokos/dodock/-/merge_requests/1117){rel="&#x22;nofollow&#x22;"}**
- **Correct error message *by ankush*** [*frappe#23746*](https://github.com/frappe/frappe/pull/23746){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1116](https://gitlab.com/dokos/dodock/-/merge_requests/1116){rel="&#x22;nofollow&#x22;"}**
- **(style): Fix buttons (btn-success, font features, disabled*&#x2A; &#x2A;*[!1114](https://gitlab.com/dokos/dodock/-/merge_requests/1114){rel="&#x22;nofollow&#x22;"}**
- **Ignore if controller doesn't have `get_list` attr *by vorasmit*** [*frappe#23736*](https://github.com/frappe/frappe/pull/23736){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1113](https://gitlab.com/dokos/dodock/-/merge_requests/1113){rel="&#x22;nofollow&#x22;"}**
- **Get users for leaderboard *by barredterra*** [*frappe#23737*](https://github.com/frappe/frappe/pull/23737){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1112](https://gitlab.com/dokos/dodock/-/merge_requests/1112){rel="&#x22;nofollow&#x22;"}**
- **Avoid duplicate contact names *by ankush*** [*frappe#23731*](https://github.com/frappe/frappe/pull/23731){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1111](https://gitlab.com/dokos/dodock/-/merge_requests/1111){rel="&#x22;nofollow&#x22;"}**
- **Change webhook header types to small text *by ankush*** [*frappe#23722*](https://github.com/frappe/frappe/pull/23722){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1110](https://gitlab.com/dokos/dodock/-/merge_requests/1110){rel="&#x22;nofollow&#x22;"}**
- **Correct fallback for social login key*&#x2A; &#x2A;*[!1109](https://gitlab.com/dokos/dodock/-/merge_requests/1109){rel="&#x22;nofollow&#x22;"}**
- **Ecsape search string *by ankush*** [*frappe#23717*](https://github.com/frappe/frappe/pull/23717){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1108](https://gitlab.com/dokos/dodock/-/merge_requests/1108){rel="&#x22;nofollow&#x22;"}**
- **Escape username on avatar control *by ankush*** [*frappe#23713*](https://github.com/frappe/frappe/pull/23713){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1107](https://gitlab.com/dokos/dodock/-/merge_requests/1107){rel="&#x22;nofollow&#x22;"}**
- **(list\_settings): Don't count tags to total fields *by blaggacao*** [*frappe#23272*](https://github.com/frappe/frappe/pull/23272){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1102](https://gitlab.com/dokos/dodock/-/merge_requests/1102){rel="&#x22;nofollow&#x22;"}**
- **Set sort\_order to DESC if sort\_field is modified*&#x2A; &#x2A;*[!1099](https://gitlab.com/dokos/dodock/-/merge_requests/1099){rel="&#x22;nofollow&#x22;"}**
- **Check if autoname is promt before setting \_\_newname *by shariquerik*** [*frappe#23672*](https://github.com/frappe/frappe/pull/23672){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1096](https://gitlab.com/dokos/dodock/-/merge_requests/1096){rel="&#x22;nofollow&#x22;"}**
- **Show server script name in traceback *by ankush*** [*frappe#23676*](https://github.com/frappe/frappe/pull/23676){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1094](https://gitlab.com/dokos/dodock/-/merge_requests/1094){rel="&#x22;nofollow&#x22;"}**
- **Add filter in Workspace Card Links Block *by sibikumarkuppusamy*** [*frappe#23578*](https://github.com/frappe/frappe/pull/23578){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1097](https://gitlab.com/dokos/dodock/-/merge_requests/1097){rel="&#x22;nofollow&#x22;"}**
- **Prioritize link\_title if value != link\_title *by shariquerik*** [*frappe#23677*](https://github.com/frappe/frappe/pull/23677){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1093](https://gitlab.com/dokos/dodock/-/merge_requests/1093){rel="&#x22;nofollow&#x22;"}**
- **Typo *by Ponnusamy1-V*** [*frappe#23675*](https://github.com/frappe/frappe/pull/23675){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1092](https://gitlab.com/dokos/dodock/-/merge_requests/1092){rel="&#x22;nofollow&#x22;"}**
- **Switch google drive picker to gis *by TMF42*** [*frappe#23096*](https://github.com/frappe/frappe/pull/23096){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1022](https://gitlab.com/dokos/dodock/-/merge_requests/1022){rel="&#x22;nofollow&#x22;"}**
- **(minor): Some more espresso polish *by rmehta*** [*frappe#23453*](https://github.com/frappe/frappe/pull/23453){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1014](https://gitlab.com/dokos/dodock/-/merge_requests/1014){rel="&#x22;nofollow&#x22;"}**
- **Color indicator style *by surajshetty3416*** [*frappe#23673*](https://github.com/frappe/frappe/pull/23673){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1091](https://gitlab.com/dokos/dodock/-/merge_requests/1091){rel="&#x22;nofollow&#x22;"}**
- **(router): Fix infinite loop when showing File view*&#x2A; &#x2A;*[!1090](https://gitlab.com/dokos/dodock/-/merge_requests/1090){rel="&#x22;nofollow&#x22;"}**
- **Use encoded filename for arabic (latin) language while exporting *by shariquerik*** [*frappe#23659*](https://github.com/frappe/frappe/pull/23659){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1087](https://gitlab.com/dokos/dodock/-/merge_requests/1087){rel="&#x22;nofollow&#x22;"}**
- **Reload whenever the effective language or timezone has changed. *by bosue*** [*frappe#22952*](https://github.com/frappe/frappe/pull/22952){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1069](https://gitlab.com/dokos/dodock/-/merge_requests/1069){rel="&#x22;nofollow&#x22;"}**
- **(geolocation): Modal and state flow *by blaggacao*** [*frappe#22797*](https://github.com/frappe/frappe/pull/22797){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1064](https://gitlab.com/dokos/dodock/-/merge_requests/1064){rel="&#x22;nofollow&#x22;"}**
- **Pass filter to formatter to handle custom logic *by shariquerik*** [*frappe#23665*](https://github.com/frappe/frappe/pull/23665){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1088](https://gitlab.com/dokos/dodock/-/merge_requests/1088){rel="&#x22;nofollow&#x22;"}**
- **(Virtual DocType): Don't call db get\_value in link field validation *by NagariaHussain*** [*frappe#23620*](https://github.com/frappe/frappe/pull/23620){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1089](https://gitlab.com/dokos/dodock/-/merge_requests/1089){rel="&#x22;nofollow&#x22;"}**
- **Remove redundant breadcrumbs*&#x2A; &#x2A;*[!1086](https://gitlab.com/dokos/dodock/-/merge_requests/1086){rel="&#x22;nofollow&#x22;"}**
- **Fix typo in comment*&#x2A; &#x2A;*[!1085](https://gitlab.com/dokos/dodock/-/merge_requests/1085){rel="&#x22;nofollow&#x22;"}**
- **(buttons): Add outline to btn-primary in btn-group*&#x2A; &#x2A;*[!1083](https://gitlab.com/dokos/dodock/-/merge_requests/1083){rel="&#x22;nofollow&#x22;"}**
- **(style): Don't add transition on all elements*&#x2A; &#x2A;*[!1082](https://gitlab.com/dokos/dodock/-/merge_requests/1082){rel="&#x22;nofollow&#x22;"}**
- **(tabulator): Use 'simple' style instead of 'bootstrap4*&#x2A; &#x2A;*[!1081](https://gitlab.com/dokos/dodock/-/merge_requests/1081){rel="&#x22;nofollow&#x22;"}**
- **(Report View): Clear checked items *by barredterra*** [*frappe#23619*](https://github.com/frappe/frappe/pull/23619){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1080](https://gitlab.com/dokos/dodock/-/merge_requests/1080){rel="&#x22;nofollow&#x22;"}**
- **(SummaryCard): Only evaluate complex filters for public cards*&#x2A; &#x2A;*[!1062](https://gitlab.com/dokos/dodock/-/merge_requests/1062){rel="&#x22;nofollow&#x22;"}**
- **Only update primary action if it is new action is provided *by maharshivpatel*** [*frappe#23621*](https://github.com/frappe/frappe/pull/23621){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1076](https://gitlab.com/dokos/dodock/-/merge_requests/1076){rel="&#x22;nofollow&#x22;"}**
- **Modified Number system for Nepal *by ajiragroup*** [*frappe#23613*](https://github.com/frappe/frappe/pull/23613){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1077](https://gitlab.com/dokos/dodock/-/merge_requests/1077){rel="&#x22;nofollow&#x22;"}**
- **Strip html the printview's key value *by shariquerik*** [*frappe#23606*](https://github.com/frappe/frappe/pull/23606){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1072](https://gitlab.com/dokos/dodock/-/merge_requests/1072){rel="&#x22;nofollow&#x22;"}**
- **(workspace): Fix workspace not updating*&#x2A; &#x2A;*[!1070](https://gitlab.com/dokos/dodock/-/merge_requests/1070){rel="&#x22;nofollow&#x22;"}**
- **Only preload icons for desk *by ankush*** [*frappe#23490*](https://github.com/frappe/frappe/pull/23490){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1020](https://gitlab.com/dokos/dodock/-/merge_requests/1020){rel="&#x22;nofollow&#x22;"}**
- **(a11y): Improve desk accessibility *by cogk*** [*frappe#23319*](https://github.com/frappe/frappe/pull/23319){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1057](https://gitlab.com/dokos/dodock/-/merge_requests/1057){rel="&#x22;nofollow&#x22;"}**
- **(workspace): Fix workspace not updating*&#x2A; &#x2A;*[!1070](https://gitlab.com/dokos/dodock/-/merge_requests/1070){rel="&#x22;nofollow&#x22;"}**
- **Use indian numbering for nepal*&#x2A; &#x2A;*[!1063](https://gitlab.com/dokos/dodock/-/merge_requests/1063){rel="&#x22;nofollow&#x22;"}**
- **Update setup\_wizard.py translation *by mahsem*** [*frappe#23583*](https://github.com/frappe/frappe/pull/23583){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1065](https://gitlab.com/dokos/dodock/-/merge_requests/1065){rel="&#x22;nofollow&#x22;"}**
- **Auto fetch module on report*&#x2A; &#x2A;*[!1037](https://gitlab.com/dokos/dodock/-/merge_requests/1037){rel="&#x22;nofollow&#x22;"}**
- **Fix Linter issue with validate\_silent\_authorization(). *by bosue*** [*frappe#23577*](https://github.com/frappe/frappe/pull/23577){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1060](https://gitlab.com/dokos/dodock/-/merge_requests/1060){rel="&#x22;nofollow&#x22;"}**
- **Turn Route History read-only. *by bosue*** [*frappe#23585*](https://github.com/frappe/frappe/pull/23585){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1059](https://gitlab.com/dokos/dodock/-/merge_requests/1059){rel="&#x22;nofollow&#x22;"}**
- **(UX): Highlight tabbed element *by ankush*** [*frappe#23573*](https://github.com/frappe/frappe/pull/23573){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1058](https://gitlab.com/dokos/dodock/-/merge_requests/1058){rel="&#x22;nofollow&#x22;"}**
- **Fix Linter issue from #23557 *by bosue*** [*frappe#23567*](https://github.com/frappe/frappe/pull/23567){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1054](https://gitlab.com/dokos/dodock/-/merge_requests/1054){rel="&#x22;nofollow&#x22;"}**
- **Move SMS Log module from ERPNext to Frappe *by strongjaw15*** [*frappe#23557*](https://github.com/frappe/frappe/pull/23557){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1052](https://gitlab.com/dokos/dodock/-/merge_requests/1052){rel="&#x22;nofollow&#x22;"}**
- **Load languages that have capital letters *by HarryPaulo*** [*frappe#23320*](https://github.com/frappe/frappe/pull/23320){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1051](https://gitlab.com/dokos/dodock/-/merge_requests/1051){rel="&#x22;nofollow&#x22;"}**
- **Quicklist *by barredterra*** [*frappe#23548*](https://github.com/frappe/frappe/pull/23548){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1047](https://gitlab.com/dokos/dodock/-/merge_requests/1047){rel="&#x22;nofollow&#x22;"}**
- **(UX): Add group by information in report view URLs *by ankush*** [*frappe#23547*](https://github.com/frappe/frappe/pull/23547){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1046](https://gitlab.com/dokos/dodock/-/merge_requests/1046){rel="&#x22;nofollow&#x22;"}**
- **Preserve title case in String.prototype.plural. *by bosue*** [*frappe#23465*](https://github.com/frappe/frappe/pull/23465){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1043](https://gitlab.com/dokos/dodock/-/merge_requests/1043){rel="&#x22;nofollow&#x22;"}**

## Maintenance et organisation

- **(data\_import): Handle RQ timeouts better *by akhilnarang*** [*frappe#23811*](https://github.com/frappe/frappe/pull/23811){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1143](https://gitlab.com/dokos/dodock/-/merge_requests/1143){rel="&#x22;nofollow&#x22;"}**
- **Simplify conditional logic *by barredterra*** [*frappe#23609*](https://github.com/frappe/frappe/pull/23609){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1084](https://gitlab.com/dokos/dodock/-/merge_requests/1084){rel="&#x22;nofollow&#x22;"}**
- **(ci): Use docli's CI base YAML file*&#x2A; &#x2A;*[!1061](https://gitlab.com/dokos/dodock/-/merge_requests/1061){rel="&#x22;nofollow&#x22;"}**
- **(ci): Use docli's CI base YAML file*&#x2A; &#x2A;*[!1061](https://gitlab.com/dokos/dodock/-/merge_requests/1061){rel="&#x22;nofollow&#x22;"}**
- **OAuth flow without breaking routing convention" *by ankush*** [*frappe#23565*](https://github.com/frappe/frappe/pull/23565){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1053](https://gitlab.com/dokos/dodock/-/merge_requests/1053){rel="&#x22;nofollow&#x22;"}**
- **Store reference to leaflet draw control *by barredterra*** [*frappe#23233*](https://github.com/frappe/frappe/pull/23233){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1048](https://gitlab.com/dokos/dodock/-/merge_requests/1048){rel="&#x22;nofollow&#x22;"}**
- **Indicate that weak hash functions are not `usedforsecurity` *by ankush*** [*frappe#23540*](https://github.com/frappe/frappe/pull/23540){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1042](https://gitlab.com/dokos/dodock/-/merge_requests/1042){rel="&#x22;nofollow&#x22;"}**
- **Execute last instance of webhook trigger on documents *by ruthra-kumar*** [*frappe#23442*](https://github.com/frappe/frappe/pull/23442){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1041](https://gitlab.com/dokos/dodock/-/merge_requests/1041){rel="&#x22;nofollow&#x22;"}**

## Améliorations de performance

- **(migrate): Update only affected users via role profile *by ankush*** [*frappe#23821*](https://github.com/frappe/frappe/pull/23821){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1137](https://gitlab.com/dokos/dodock/-/merge_requests/1137){rel="&#x22;nofollow&#x22;"}**
- **(migrate): Only re-evaluate users which are potentially changed *by ankush*** [*frappe#23820*](https://github.com/frappe/frappe/pull/23820){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1136](https://gitlab.com/dokos/dodock/-/merge_requests/1136){rel="&#x22;nofollow&#x22;"}**
- **Primary key is never nullable *by ankush*** [*frappe#23788*](https://github.com/frappe/frappe/pull/23788){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1129](https://gitlab.com/dokos/dodock/-/merge_requests/1129){rel="&#x22;nofollow&#x22;"}**
- **Simplify dynamic route evaluation to speed up route resolution *by surajshetty3416*** [*frappe#23698*](https://github.com/frappe/frappe/pull/23698){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1104](https://gitlab.com/dokos/dodock/-/merge_requests/1104){rel="&#x22;nofollow&#x22;"}**

## Tests et intégration continue

- **Pin editorjs *by ankush*** [*frappe#23534*](https://github.com/frappe/frappe/pull/23534){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1040](https://gitlab.com/dokos/dodock/-/merge_requests/1040){rel="&#x22;nofollow&#x22;"}**
- **(deps): Bump @adobe/css-tools from 4.3.1 to 4.3.2 &#x2A;by dependabot [bot]*** [*frappe#23532*](https://github.com/frappe/frappe/pull/23532){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1039](https://gitlab.com/dokos/dodock/-/merge_requests/1039){rel="&#x22;nofollow&#x22;"}**
- **Make control\_phone UI test idempotent and a bit more reliable. *by bosue*** [*frappe#23569*](https://github.com/frappe/frappe/pull/23569){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1055](https://gitlab.com/dokos/dodock/-/merge_requests/1055){rel="&#x22;nofollow&#x22;"}**
- **Fixing flaky test *by shariquerik*** [*frappe#23537*](https://github.com/frappe/frappe/pull/23537){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1045](https://gitlab.com/dokos/dodock/-/merge_requests/1045){rel="&#x22;nofollow&#x22;"}**
- **Skip permissions.js UI test*&#x2A; &#x2A;*[!1036](https://gitlab.com/dokos/dodock/-/merge_requests/1036){rel="&#x22;nofollow&#x22;"}**

---

**Contributeurs**

- **Corentin Forler** (39)
- **Ankush Menat** (22)
- **barredterra** (18)
- **Charles-Henri Decultot** (11)
- **Shariq Ansari** (11)
- **Bernd Oliver Sünderhauf** (7)
- **14987** (4)
- **David Arnold** (4)
- **Raffael Meyer** (3)
- **Suraj Shetty** (3)

et 22 autres contributeurs...

- Akhil Narang
- Maharshi Patel
- ajiragroup
- Arjun
- Corin Wenger
- Fisher Yu
- Gursheen Kaur Anand
- HarryPaulo
- Md Hussain Nagaria
- Niraj Gautam
- Ponnusamy
- Rabin Koirala
- Ritwik Puri
- Sagar Vora
- Smit Vora
- Thomas Fojan
- Trusted Computer
- hyaray
- mahsem
- ruthra kumar
- sibi kumar k
- tonspar

---

**Différentiel complet:** [v4.0.0...v4.1.0](https://gitlab.com/dokos/dodock/-/compare/v4.0.0...v4.1.0){rel="&#x22;nofollow&#x22;"}:br&#x2A;*Tag:** [v4.1.0](https://gitlab.com/dokos/dodock/-/tags/v4.1.0){rel="&#x22;nofollow&#x22;"}


# v4.2.0

::callout
La version 4.2.0 de Dodock est basée sur la version 15 de Frappe.
Une grande partie des changements cités ci-dessous ont été développés par l'équipe de Frappe Technologies et les contributeurs aux logiciels de l'éco-système Frappe/ERPNext.
Le détail des changements publiés dans Dodock est disponible sur [GitLab](https://gitlab.com/dokos/dodock/-/releases/v4.2.0){rel=""nofollow""}
::

::callout
🚧 Traduction à venir 🚧
::

## Fonctionnalités et améliorations

- **Support background jobs in recorder *by akhilnarang**&#x2A; &#x2A;*[!1296](https://gitlab.com/dokos/dodock/-/merge_requests/1296){rel="&#x22;nofollow&#x22;"}**
- **Knowledge base improvements*&#x2A; &#x2A;*[!1233](https://gitlab.com/dokos/dodock/-/merge_requests/1233){rel="&#x22;nofollow&#x22;"}**
- **Simple procline for scheduler*&#x2A; &#x2A;*[!1229](https://gitlab.com/dokos/dodock/-/merge_requests/1229){rel="&#x22;nofollow&#x22;"}**
- **(minor): Hook to add custom path resolver *by surajshetty3416*** [*frappe#24018*](https://github.com/frappe/frappe/pull/24018){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1225](https://gitlab.com/dokos/dodock/-/merge_requests/1225){rel="&#x22;nofollow&#x22;"}**
- **Sort multicheck by label *by barredterra*** [*frappe#23985*](https://github.com/frappe/frappe/pull/23985){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1211](https://gitlab.com/dokos/dodock/-/merge_requests/1211){rel="&#x22;nofollow&#x22;"}**
- **Include / skip disabled records from treeview *by GursheenK*** [*frappe#23590*](https://github.com/frappe/frappe/pull/23590){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1207](https://gitlab.com/dokos/dodock/-/merge_requests/1207){rel="&#x22;nofollow&#x22;"}**
- **(notification): Add button to disable standard notification, fix form loading*&#x2A; &#x2A;*[!1194](https://gitlab.com/dokos/dodock/-/merge_requests/1194){rel="&#x22;nofollow&#x22;"}**
- **(Newsletter): Redirect to welcome URL *by barredterra*** [*frappe#23431*](https://github.com/frappe/frappe/pull/23431){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1177](https://gitlab.com/dokos/dodock/-/merge_requests/1177){rel="&#x22;nofollow&#x22;"}**
- **Add "Edit Calendard View" button on Calendar View*&#x2A; &#x2A;*[!1174](https://gitlab.com/dokos/dodock/-/merge_requests/1174){rel="&#x22;nofollow&#x22;"}**
- **Allow setting a custom http status code for redirects *by akhilnarang*** [*frappe#23765*](https://github.com/frappe/frappe/pull/23765){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1171](https://gitlab.com/dokos/dodock/-/merge_requests/1171){rel="&#x22;nofollow&#x22;"}**
- **New app boilerplate *by barredterra*** [*frappe#23847*](https://github.com/frappe/frappe/pull/23847){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1154](https://gitlab.com/dokos/dodock/-/merge_requests/1154){rel="&#x22;nofollow&#x22;"}**
- **(minor): Include filter values in exported report excel *by GursheenK*** [*frappe#23512*](https://github.com/frappe/frappe/pull/23512){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1150](https://gitlab.com/dokos/dodock/-/merge_requests/1150){rel="&#x22;nofollow&#x22;"}**

## Corrections de bugs

- **In some use case page has no inner toolbar*&#x2A; &#x2A;*[!1298](https://gitlab.com/dokos/dodock/-/merge_requests/1298){rel="&#x22;nofollow&#x22;"}**
- **(recorder): Normalize `IN` in SQL queries *by ankush**&#x2A; &#x2A;*[!1294](https://gitlab.com/dokos/dodock/-/merge_requests/1294){rel="&#x22;nofollow&#x22;"}**
- **(router): Don't capture clicks on links with target attr *by cogk**&#x2A; &#x2A;*[!1293](https://gitlab.com/dokos/dodock/-/merge_requests/1293){rel="&#x22;nofollow&#x22;"}**
- **Number card only gives integer *by fadilsiddique**&#x2A; &#x2A;*[!1292](https://gitlab.com/dokos/dodock/-/merge_requests/1292){rel="&#x22;nofollow&#x22;"}**
- **Use correct parent field in rebuild\_tree() *by barredterra**&#x2A; &#x2A;*[!1284](https://gitlab.com/dokos/dodock/-/merge_requests/1284){rel="&#x22;nofollow&#x22;"}**
- **(UX): Permission error messages *by ankush**&#x2A; &#x2A;*[!1282](https://gitlab.com/dokos/dodock/-/merge_requests/1282){rel="&#x22;nofollow&#x22;"}**
- **Don't add fallback for child table perms *by ankush**&#x2A; &#x2A;*[!1280](https://gitlab.com/dokos/dodock/-/merge_requests/1280){rel="&#x22;nofollow&#x22;"}**
- **Syntax highlighting in report *by ankush**&#x2A; &#x2A;*[!1276](https://gitlab.com/dokos/dodock/-/merge_requests/1276){rel="&#x22;nofollow&#x22;"}**
- **Timeout occurs when there are too many users linked to the profile *by AlexandreLumertz**&#x2A; &#x2A;*[!1274](https://gitlab.com/dokos/dodock/-/merge_requests/1274){rel="&#x22;nofollow&#x22;"}**
- **Syntax highlighting in system console [frappe]*&#x2A; &#x2A;*[!1278](https://gitlab.com/dokos/dodock/-/merge_requests/1278){rel="&#x22;nofollow&#x22;"}**
- **Broken `dynamic_link` to `link` formatting in query report *by nextchamp-saqib**&#x2A; &#x2A;*[!1273](https://gitlab.com/dokos/dodock/-/merge_requests/1273){rel="&#x22;nofollow&#x22;"}**
- **Validate server scripts with FrappeTransformer *by ankush**&#x2A; &#x2A;*[!1267](https://gitlab.com/dokos/dodock/-/merge_requests/1267){rel="&#x22;nofollow&#x22;"}**
- **Remove Guest permission on Help Article *by barredterra**&#x2A; &#x2A;*[!1266](https://gitlab.com/dokos/dodock/-/merge_requests/1266){rel="&#x22;nofollow&#x22;"}**
- **French translations*&#x2A; &#x2A;*[!1262](https://gitlab.com/dokos/dodock/-/merge_requests/1262){rel="&#x22;nofollow&#x22;"}**
- **Translations and display logic*&#x2A; &#x2A;*[!1261](https://gitlab.com/dokos/dodock/-/merge_requests/1261){rel="&#x22;nofollow&#x22;"}**
- **(Blog Post): Correct indicator filter *by barredterra*** [*frappe#24039*](https://github.com/frappe/frappe/pull/24039){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1238](https://gitlab.com/dokos/dodock/-/merge_requests/1238){rel="&#x22;nofollow&#x22;"}**
- **Base class replace on `has_web_view` update *by NagariaHussain*** [*frappe#24038*](https://github.com/frappe/frappe/pull/24038){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1237](https://gitlab.com/dokos/dodock/-/merge_requests/1237){rel="&#x22;nofollow&#x22;"}**
- **Allow guests to view published Newsletters*&#x2A; &#x2A;*[!1235](https://gitlab.com/dokos/dodock/-/merge_requests/1235){rel="&#x22;nofollow&#x22;"}**
- **Correct perm check for guests*&#x2A; &#x2A;*[!1234](https://gitlab.com/dokos/dodock/-/merge_requests/1234){rel="&#x22;nofollow&#x22;"}**
- **Show right permission for user cannot create doctypes *by pateljannat*** [*frappe#24027*](https://github.com/frappe/frappe/pull/24027){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1231](https://gitlab.com/dokos/dodock/-/merge_requests/1231){rel="&#x22;nofollow&#x22;"}**
- **(DX): Filter version logs with changes to field *by ankush*** [*frappe#24023*](https://github.com/frappe/frappe/pull/24023){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1230](https://gitlab.com/dokos/dodock/-/merge_requests/1230){rel="&#x22;nofollow&#x22;"}**
- **Misc errors from sentry *by ankush*** [*frappe#24009*](https://github.com/frappe/frappe/pull/24009){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1222](https://gitlab.com/dokos/dodock/-/merge_requests/1222){rel="&#x22;nofollow&#x22;"}**
- **Add a shortcut to Go to website*&#x2A; &#x2A;*[!1219](https://gitlab.com/dokos/dodock/-/merge_requests/1219){rel="&#x22;nofollow&#x22;"}**
- **Do not change global search label to lower case *by surajshetty3416*** [*frappe#24019*](https://github.com/frappe/frappe/pull/24019){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1226](https://gitlab.com/dokos/dodock/-/merge_requests/1226){rel="&#x22;nofollow&#x22;"}**
- **Force `[]` as default for child tables *by ankush*** [*frappe#24000*](https://github.com/frappe/frappe/pull/24000){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1215](https://gitlab.com/dokos/dodock/-/merge_requests/1215){rel="&#x22;nofollow&#x22;"}**
- **Incorrect duplicate filter check *by ankush*** [*frappe#24001*](https://github.com/frappe/frappe/pull/24001){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1217](https://gitlab.com/dokos/dodock/-/merge_requests/1217){rel="&#x22;nofollow&#x22;"}**
- **Deterministic fixture import order &#x2A;by mergify [bot]*** [*frappe#22210*](https://github.com/frappe/frappe/pull/22210){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1216](https://gitlab.com/dokos/dodock/-/merge_requests/1216){rel="&#x22;nofollow&#x22;"}**
- **(text\_editor): Fix bubble's link tooltip clipping" *by ankush*** [*frappe#23999*](https://github.com/frappe/frappe/pull/23999){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1214](https://gitlab.com/dokos/dodock/-/merge_requests/1214){rel="&#x22;nofollow&#x22;"}**
- **Sudan country info (backport #23709) &#x2A;by mergify [bot]*** [*frappe#23998*](https://github.com/frappe/frappe/pull/23998){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1213](https://gitlab.com/dokos/dodock/-/merge_requests/1213){rel="&#x22;nofollow&#x22;"}**
- **Initialize child tables correctly *by ankush*** [*frappe#23982*](https://github.com/frappe/frappe/pull/23982){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1208](https://gitlab.com/dokos/dodock/-/merge_requests/1208){rel="&#x22;nofollow&#x22;"}**
- **Number card layout *by fadilsiddique*** [*frappe#23287*](https://github.com/frappe/frappe/pull/23287){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1201](https://gitlab.com/dokos/dodock/-/merge_requests/1201){rel="&#x22;nofollow&#x22;"}**
- **(Geo): Add timezone for palestinian territory country *by aghanem*** [*frappe#23986*](https://github.com/frappe/frappe/pull/23986){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1210](https://gitlab.com/dokos/dodock/-/merge_requests/1210){rel="&#x22;nofollow&#x22;"}**
- **(Data Import): Show failed import logs *by niraj2477*** [*frappe#23975*](https://github.com/frappe/frappe/pull/23975){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1212](https://gitlab.com/dokos/dodock/-/merge_requests/1212){rel="&#x22;nofollow&#x22;"}**
- **Strip exc from json response if traceback not allowed *by revant*** [*frappe#23989*](https://github.com/frappe/frappe/pull/23989){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1209](https://gitlab.com/dokos/dodock/-/merge_requests/1209){rel="&#x22;nofollow&#x22;"}**
- **(text\_editor): Fix bubble's link tooltip clipping *by cogk*** [*frappe#23911*](https://github.com/frappe/frappe/pull/23911){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1203](https://gitlab.com/dokos/dodock/-/merge_requests/1203){rel="&#x22;nofollow&#x22;"}**
- **Roles editor *by pateljannat*** [*frappe#23976*](https://github.com/frappe/frappe/pull/23976){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1205](https://gitlab.com/dokos/dodock/-/merge_requests/1205){rel="&#x22;nofollow&#x22;"}**
- **(minor): Mobile menu class *by maharshivpatel*** [*frappe#23970*](https://github.com/frappe/frappe/pull/23970){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1200](https://gitlab.com/dokos/dodock/-/merge_requests/1200){rel="&#x22;nofollow&#x22;"}**
- **(minor): Onboarding check if element available *by maharshivpatel*** [*frappe#23947*](https://github.com/frappe/frappe/pull/23947){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1199](https://gitlab.com/dokos/dodock/-/merge_requests/1199){rel="&#x22;nofollow&#x22;"}**
- **Show relative path in loaded JS *by ankush*** [*frappe#23964*](https://github.com/frappe/frappe/pull/23964){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1197](https://gitlab.com/dokos/dodock/-/merge_requests/1197){rel="&#x22;nofollow&#x22;"}**
- **Solve the problem that there is no forEach instance method in HT… *by fierflame*** [*frappe#23948*](https://github.com/frappe/frappe/pull/23948){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1195](https://gitlab.com/dokos/dodock/-/merge_requests/1195){rel="&#x22;nofollow&#x22;"}**
- **Add skip\_dirty\_trigger param for child\_table *by jjaycaneza*** [*frappe#23892*](https://github.com/frappe/frappe/pull/23892){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1196](https://gitlab.com/dokos/dodock/-/merge_requests/1196){rel="&#x22;nofollow&#x22;"}**
- **Solve the problem that the document editor will report an error … *by fierflame*** [*frappe#23940*](https://github.com/frappe/frappe/pull/23940){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1193](https://gitlab.com/dokos/dodock/-/merge_requests/1193){rel="&#x22;nofollow&#x22;"}**
- **Use system font for printing *by barredterra*** [*frappe#23935*](https://github.com/frappe/frappe/pull/23935){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1191](https://gitlab.com/dokos/dodock/-/merge_requests/1191){rel="&#x22;nofollow&#x22;"}**
- **(database): Do not call begin in updatedb after syncing *by sunxiaoguang*** [*frappe#23934*](https://github.com/frappe/frappe/pull/23934){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1189](https://gitlab.com/dokos/dodock/-/merge_requests/1189){rel="&#x22;nofollow&#x22;"}**
- **(document): Pass parent\_doc and parentfield for child in \_set\_defaults*&#x2A; &#x2A;*[!1188](https://gitlab.com/dokos/dodock/-/merge_requests/1188){rel="&#x22;nofollow&#x22;"}**
- **Minor fix *by shariquerik*** [*frappe#23921*](https://github.com/frappe/frappe/pull/23921){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1187](https://gitlab.com/dokos/dodock/-/merge_requests/1187){rel="&#x22;nofollow&#x22;"}**
- **Missing translated fields*&#x2A; &#x2A;*[!1186](https://gitlab.com/dokos/dodock/-/merge_requests/1186){rel="&#x22;nofollow&#x22;"}**
- **(workspace): Fix widget rendering for EditorJS v2.28** [*frappe#23918*](https://github.com/frappe/frappe/pull/23918){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1184](https://gitlab.com/dokos/dodock/-/merge_requests/1184){rel="&#x22;nofollow&#x22;"}**
- **Set default child table fields on save *by ankush*** [*frappe#23913*](https://github.com/frappe/frappe/pull/23913){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1181](https://gitlab.com/dokos/dodock/-/merge_requests/1181){rel="&#x22;nofollow&#x22;"}**
- **(style): Clean-up dark theme*&#x2A; &#x2A;*[!1185](https://gitlab.com/dokos/dodock/-/merge_requests/1185){rel="&#x22;nofollow&#x22;"}**
- **Check the correct email account" *by barredterra*** [*frappe#23914*](https://github.com/frappe/frappe/pull/23914){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1183](https://gitlab.com/dokos/dodock/-/merge_requests/1183){rel="&#x22;nofollow&#x22;"}**
- **Missing comma in translations file *by barredterra*** [*frappe#23915*](https://github.com/frappe/frappe/pull/23915){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1182](https://gitlab.com/dokos/dodock/-/merge_requests/1182){rel="&#x22;nofollow&#x22;"}**
- **(redirect): Make the status codes a `select` field instead of `int` *by akhilnarang*** [*frappe#23912*](https://github.com/frappe/frappe/pull/23912){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1180](https://gitlab.com/dokos/dodock/-/merge_requests/1180){rel="&#x22;nofollow&#x22;"}**
- **(ui): Clean-up permission manager UI*&#x2A; &#x2A;*[!1176](https://gitlab.com/dokos/dodock/-/merge_requests/1176){rel="&#x22;nofollow&#x22;"}**
- **Fix datepicker colors on website*&#x2A; &#x2A;*[!1175](https://gitlab.com/dokos/dodock/-/merge_requests/1175){rel="&#x22;nofollow&#x22;"}**
- **Allow aspect ratio options to crop from sidebar image field *by shariquerik*** [*frappe#23893*](https://github.com/frappe/frappe/pull/23893){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1173](https://gitlab.com/dokos/dodock/-/merge_requests/1173){rel="&#x22;nofollow&#x22;"}**
- **Error when displaying dashboard with number card using average a… *by bourouffala*** [*frappe#23883*](https://github.com/frappe/frappe/pull/23883){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1168](https://gitlab.com/dokos/dodock/-/merge_requests/1168){rel="&#x22;nofollow&#x22;"}**
- **Optimize clear\_permissions\_cache method *by kunhimohamed*** [*frappe#23858*](https://github.com/frappe/frappe/pull/23858){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1165](https://gitlab.com/dokos/dodock/-/merge_requests/1165){rel="&#x22;nofollow&#x22;"}**
- **Don't allow deleting original doc if amendment exists *by ankush*** [*frappe#23874*](https://github.com/frappe/frappe/pull/23874){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1164](https://gitlab.com/dokos/dodock/-/merge_requests/1164){rel="&#x22;nofollow&#x22;"}**
- **Render new doctype dialog box if doctype is not copied *by DaizyModi*** [*frappe#23854*](https://github.com/frappe/frappe/pull/23854){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1163](https://gitlab.com/dokos/dodock/-/merge_requests/1163){rel="&#x22;nofollow&#x22;"}**
- **Ignore and gracefully handle img optimization failure *by ankush*** [*frappe#23873*](https://github.com/frappe/frappe/pull/23873){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1162](https://gitlab.com/dokos/dodock/-/merge_requests/1162){rel="&#x22;nofollow&#x22;"}**
- **Allow clearing deleted documents *by ankush*** [*frappe#23866*](https://github.com/frappe/frappe/pull/23866){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1160](https://gitlab.com/dokos/dodock/-/merge_requests/1160){rel="&#x22;nofollow&#x22;"}**
- **Skip virtual fields in perm level checks during DB Query *by ankush*** [*frappe#23865*](https://github.com/frappe/frappe/pull/23865){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1159](https://gitlab.com/dokos/dodock/-/merge_requests/1159){rel="&#x22;nofollow&#x22;"}**
- **(TextEditor): Use document's body as bounds for Quill*&#x2A; &#x2A;*[!1158](https://gitlab.com/dokos/dodock/-/merge_requests/1158){rel="&#x22;nofollow&#x22;"}**
- **Treat Document Links entries as all non-std fields *by marination*** [*frappe#23432*](https://github.com/frappe/frappe/pull/23432){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1157](https://gitlab.com/dokos/dodock/-/merge_requests/1157){rel="&#x22;nofollow&#x22;"}**
- **Dont pass removed parameter `name` *by sagarvora*** [*frappe#23855*](https://github.com/frappe/frappe/pull/23855){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1156](https://gitlab.com/dokos/dodock/-/merge_requests/1156){rel="&#x22;nofollow&#x22;"}**
- **Planning view fixes and ux enhancements*&#x2A; &#x2A;*[!1155](https://gitlab.com/dokos/dodock/-/merge_requests/1155){rel="&#x22;nofollow&#x22;"}**
- **(web): Fix password reset status code*&#x2A; &#x2A;*[!1146](https://gitlab.com/dokos/dodock/-/merge_requests/1146){rel="&#x22;nofollow&#x22;"}**
- **(ControlLink): Add `no_icon` property*&#x2A; &#x2A;*[!1147](https://gitlab.com/dokos/dodock/-/merge_requests/1147){rel="&#x22;nofollow&#x22;"}**
- **Do not send reminder when an event is cancelled by Google*&#x2A; &#x2A;*[!1148](https://gitlab.com/dokos/dodock/-/merge_requests/1148){rel="&#x22;nofollow&#x22;"}**

## Maintenance et organisation

- **Remove unused parameter from rebuild\_tree, add type hints *by barredterra**&#x2A; &#x2A;*[!1295](https://gitlab.com/dokos/dodock/-/merge_requests/1295){rel="&#x22;nofollow&#x22;"}**
- **Remove dead handling for "fnargs" *by ankush**&#x2A; &#x2A;*[!1263](https://gitlab.com/dokos/dodock/-/merge_requests/1263){rel="&#x22;nofollow&#x22;"}**
- **Postgres version check*&#x2A; &#x2A;*[!1198](https://gitlab.com/dokos/dodock/-/merge_requests/1198){rel="&#x22;nofollow&#x22;"}**

## Documentation

- **Add Python API missing docstrings / type hints *by NagariaHussain*** [*frappe#23827*](https://github.com/frappe/frappe/pull/23827){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1170](https://gitlab.com/dokos/dodock/-/merge_requests/1170){rel="&#x22;nofollow&#x22;"}**

## Améliorations de performance

- **Skip ifnull checks on `modified` field *by ankush*** [*frappe#24042*](https://github.com/frappe/frappe/pull/24042){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1239](https://gitlab.com/dokos/dodock/-/merge_requests/1239){rel="&#x22;nofollow&#x22;"}**
- **Skip network call if no doc *by ankush*** [*frappe#23967*](https://github.com/frappe/frappe/pull/23967){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1202](https://gitlab.com/dokos/dodock/-/merge_requests/1202){rel="&#x22;nofollow&#x22;"}**
- **Don't extract gzipped backups *by akhilnarang*** [*frappe#22915*](https://github.com/frappe/frappe/pull/22915){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1190](https://gitlab.com/dokos/dodock/-/merge_requests/1190){rel="&#x22;nofollow&#x22;"}**
- **Use set for tracking whitelisted methods *by ankush*** [*frappe#23905*](https://github.com/frappe/frappe/pull/23905){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1178](https://gitlab.com/dokos/dodock/-/merge_requests/1178){rel="&#x22;nofollow&#x22;"}**

## Tests et intégration continue

- **Fix ui tests *by ankush**&#x2A; &#x2A;*[!1299](https://gitlab.com/dokos/dodock/-/merge_requests/1299){rel="&#x22;nofollow&#x22;"}**
- **(deps): Bump datatable to latest *by shariquerik**&#x2A; &#x2A;*[!1277](https://gitlab.com/dokos/dodock/-/merge_requests/1277){rel="&#x22;nofollow&#x22;"}**
- **Remove invalid assertion *by ankush**&#x2A; &#x2A;*[!1275](https://gitlab.com/dokos/dodock/-/merge_requests/1275){rel="&#x22;nofollow&#x22;"}**
- **Add setproctitle as dependency *by ankush*** [*frappe#24007*](https://github.com/frappe/frappe/pull/24007){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1223](https://gitlab.com/dokos/dodock/-/merge_requests/1223){rel="&#x22;nofollow&#x22;"}**
- **Less flaky datet picker test *by ankush*** [*frappe#24015*](https://github.com/frappe/frappe/pull/24015){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1224](https://gitlab.com/dokos/dodock/-/merge_requests/1224){rel="&#x22;nofollow&#x22;"}**
- **Use doctype that supports prompt naming *by ankush*** [*frappe#23980*](https://github.com/frappe/frappe/pull/23980){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1206](https://gitlab.com/dokos/dodock/-/merge_requests/1206){rel="&#x22;nofollow&#x22;"}**
- **(deps): Bump datatable to latest *by shariquerik*** [*frappe#23894*](https://github.com/frappe/frappe/pull/23894){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1172](https://gitlab.com/dokos/dodock/-/merge_requests/1172){rel="&#x22;nofollow&#x22;"}**
- **Flaky currency UI test *by ankush*** [*frappe#23834*](https://github.com/frappe/frappe/pull/23834){rel="&#x22;nofollow&#x22;"&#x7D; &#x2A;*[!1149](https://gitlab.com/dokos/dodock/-/merge_requests/1149){rel="&#x22;nofollow&#x22;"}**

---

**Contributeurs**

- **Ankush Menat** (40)
- **Akhil Narang** (27)
- **Charles-Henri Decultot** (25)
- **Corentin Forler** (18)
- **Gursheen Anand** (14)
- **Raffael Meyer** (6)
- **Shariq Ansari** (5)
- **Maharshi Patel** (4)
- **barredterra** (4)
- **Hussain Nagaria** (3)

et 18 autres contributeurs...

- Suraj Shetty
- Fierflame
- Jannat Patel
- Saqib Ansari
- marination
- 14987
- Anas AlGhanem
- Daizy Modi
- Fadil SIddique
- Gursheen Kaur Anand
- Justine Jay
- Kunhi
- Revant Nandgaonkar
- Sagar Vora
- Xiaoguang Sun
- bourouffala
- fadilsid
- 猛火

---

**Différentiel complet:** [v4.1.0...v4.2.0](https://gitlab.com/dokos/dodock/-/compare/v4.1.0...v4.2.0){rel="&#x22;nofollow&#x22;"}:br&#x2A;*Tag:** [v4.2.0](https://gitlab.com/dokos/dodock/-/tags/v4.2.0){rel="&#x22;nofollow&#x22;"}


# v4.3.0

::callout
La version 4.3.0 de Dodock est basée sur la version 15 de Frappe.
Une grande partie des changements cités ci-dessous ont été développés par l'équipe de Frappe Technologies et les contributeurs aux logiciels de l'éco-système Frappe/ERPNext.
Le détail des changements publiés dans Dodock est disponible sur [GitLab](https://gitlab.com/dokos/dodock/-/releases/v4.3.0){rel=""nofollow""}
::

::callout
🚧 Traduction à venir 🚧
::

## Fonctionnalités et améliorations

- **Option to keep the blog and web pages to logged in users only*&#x2A; &#x2A;*[!1308](https://gitlab.com/dokos/dodock/-/merge_requests/1308){rel="&#x22;nofollow&#x22;"}**
- **Merge branch 'help\_article\_permissions' into 'develop' (dokos/dodock!1304)*&#x2A; &#x2A;*[!1305](https://gitlab.com/dokos/dodock/-/merge_requests/1305){rel="&#x22;nofollow&#x22;"}**

## Corrections de bugs

- **(test\_recorder): Explicitly stop recorder before calling post process *by akhilnarang**&#x2A; &#x2A;*[!1311](https://gitlab.com/dokos/dodock/-/merge_requests/1311){rel="&#x22;nofollow&#x22;"}**
- **(Web Form): Make button label translatable *by barredterra**&#x2A; &#x2A;*[!1307](https://gitlab.com/dokos/dodock/-/merge_requests/1307){rel="&#x22;nofollow&#x22;"}**
- **Correctly save topic*&#x2A; &#x2A;*[!1309](https://gitlab.com/dokos/dodock/-/merge_requests/1309){rel="&#x22;nofollow&#x22;"}**

---

**Contributeurs**

- **Charles-Henri Decultot** (7)
- **Akhil Narang** (1)
- **Raffael Meyer** (1)

---

**Différentiel complet:** [v4.2.0...v4.3.0](https://gitlab.com/dokos/dodock/-/compare/v4.2.0...v4.3.0){rel="&#x22;nofollow&#x22;"}:br&#x2A;*Tag:** [v4.3.0](https://gitlab.com/dokos/dodock/-/tags/v4.3.0){rel="&#x22;nofollow&#x22;"}


# v4.4.0

::callout
La version 4.3.0 de Dodock est basée sur la version 15 de Frappe.
Une grande partie des changements cités ci-dessous ont été développés par l'équipe de Frappe Technologies et les contributeurs aux logiciels de l'éco-système Frappe/ERPNext.
Le détail des changements publiés dans Dodock est disponible sur [GitLab](https://gitlab.com/dokos/dodock/-/releases/v4.4.0){rel=""nofollow""}
::

::callout
🚧 Traduction à venir 🚧
::

## Fonctionnalités et améliorations

- **(Catalog): Add docname if there is a title field*&#x2A; &#x2A;*[!1435](https://gitlab.com/dokos/dodock/-/merge_requests/1435){rel="&#x22;nofollow&#x22;"}**
- **Add a default search filter to Catalog*&#x2A; &#x2A;*[!1424](https://gitlab.com/dokos/dodock/-/merge_requests/1424){rel="&#x22;nofollow&#x22;"}**
- **Extend perm debugging to popular controllers *by ankush**&#x2A; &#x2A;*[!1396](https://gitlab.com/dokos/dodock/-/merge_requests/1396){rel="&#x22;nofollow&#x22;"}**
- **Permission debugger *by ankush**&#x2A; &#x2A;*[!1383](https://gitlab.com/dokos/dodock/-/merge_requests/1383){rel="&#x22;nofollow&#x22;"}**
- **Add Catalog UI class*&#x2A; &#x2A;*[!1364](https://gitlab.com/dokos/dodock/-/merge_requests/1364){rel="&#x22;nofollow&#x22;"}**
- **Merge branch 'event\_website\_permissions' into 'develop' (dokos/dodock!1330)*&#x2A; &#x2A;*[!1331](https://gitlab.com/dokos/dodock/-/merge_requests/1331){rel="&#x22;nofollow&#x22;"}**

## Corrections de bugs

- **Misc *by ankush**&#x2A; &#x2A;*[!1448](https://gitlab.com/dokos/dodock/-/merge_requests/1448){rel="&#x22;nofollow&#x22;"}**
- **(UX): Show status indicator in moblie view *by ankush**&#x2A; &#x2A;*[!1447](https://gitlab.com/dokos/dodock/-/merge_requests/1447){rel="&#x22;nofollow&#x22;"}**
- **(mobile-ui): Tabs should scroll instead of stack *by ankush**&#x2A; &#x2A;*[!1446](https://gitlab.com/dokos/dodock/-/merge_requests/1446){rel="&#x22;nofollow&#x22;"}**
- **Collapse sidebar on picking workspace *by ankush**&#x2A; &#x2A;*[!1445](https://gitlab.com/dokos/dodock/-/merge_requests/1445){rel="&#x22;nofollow&#x22;"}**
- **Remove missing field*&#x2A; &#x2A;*[!1444](https://gitlab.com/dokos/dodock/-/merge_requests/1444){rel="&#x22;nofollow&#x22;"}**
- **Convert status field data to String before guessing the style *by RitvikSardana**&#x2A; &#x2A;*[!1433](https://gitlab.com/dokos/dodock/-/merge_requests/1433){rel="&#x22;nofollow&#x22;"}**
- **Typeerror [frappe]*&#x2A; &#x2A;*[!1434](https://gitlab.com/dokos/dodock/-/merge_requests/1434){rel="&#x22;nofollow&#x22;"}**
- **(minor): Increase rate limit for web form *by maharshivpatel**&#x2A; &#x2A;*[!1432](https://gitlab.com/dokos/dodock/-/merge_requests/1432){rel="&#x22;nofollow&#x22;"}**
- **Strip html instead of escaping when creating/updating workspace *by sagarvora**&#x2A; &#x2A;*[!1431](https://gitlab.com/dokos/dodock/-/merge_requests/1431){rel="&#x22;nofollow&#x22;"}**
- Fix conflicts
- **Select field should not have debounce *by RitvikSardana**&#x2A; &#x2A;*[!1415](https://gitlab.com/dokos/dodock/-/merge_requests/1415){rel="&#x22;nofollow&#x22;"}**
- **Rename permission debugger to inspector [frappe]*&#x2A; &#x2A;*[!1417](https://gitlab.com/dokos/dodock/-/merge_requests/1417){rel="&#x22;nofollow&#x22;"}**
- **Remove\_custom\_button bug *by safwansamsudeen**&#x2A; &#x2A;*[!1416](https://gitlab.com/dokos/dodock/-/merge_requests/1416){rel="&#x22;nofollow&#x22;"}**
- **Print perm check logs from DB query *by ankush**&#x2A; &#x2A;*[!1406](https://gitlab.com/dokos/dodock/-/merge_requests/1406){rel="&#x22;nofollow&#x22;"}**
- **(response): Fixup non-ASCII character filenames *by akhilnarang**&#x2A; &#x2A;*[!1405](https://gitlab.com/dokos/dodock/-/merge_requests/1405){rel="&#x22;nofollow&#x22;"}**
- **(FileUploader): Fix upload outside of dialog*&#x2A; &#x2A;*[!1404](https://gitlab.com/dokos/dodock/-/merge_requests/1404){rel="&#x22;nofollow&#x22;"}**
- **(DX): Type annotations for Meta *by ankush**&#x2A; &#x2A;*[!1394](https://gitlab.com/dokos/dodock/-/merge_requests/1394){rel="&#x22;nofollow&#x22;"}**
- **Include workspaces without domain restriction *by barredterra**&#x2A; &#x2A;*[!1393](https://gitlab.com/dokos/dodock/-/merge_requests/1393){rel="&#x22;nofollow&#x22;"}**
- **Set correct recipient when reply to own email *by maharshivpatel**&#x2A; &#x2A;*[!1392](https://gitlab.com/dokos/dodock/-/merge_requests/1392){rel="&#x22;nofollow&#x22;"}**
- **Pass parent doctype on dashboard chart *by ankush**&#x2A; &#x2A;*[!1384](https://gitlab.com/dokos/dodock/-/merge_requests/1384){rel="&#x22;nofollow&#x22;"}**
- **(restore): Check backup directory and bench directory if we can't find the file *by akhilnarang**&#x2A; &#x2A;*[!1379](https://gitlab.com/dokos/dodock/-/merge_requests/1379){rel="&#x22;nofollow&#x22;"}**
- **Added validation if upload is clicked without uploading file *by shariquerik**&#x2A; &#x2A;*[!1376](https://gitlab.com/dokos/dodock/-/merge_requests/1376){rel="&#x22;nofollow&#x22;"}**
- **Don't update docstatus *by ankush**&#x2A; &#x2A;*[!1378](https://gitlab.com/dokos/dodock/-/merge_requests/1378){rel="&#x22;nofollow&#x22;"}**
- **Added invalid conditions for number fields *by shariquerik**&#x2A; &#x2A;*[!1377](https://gitlab.com/dokos/dodock/-/merge_requests/1377){rel="&#x22;nofollow&#x22;"}**
- **Duplicate field in filters *by ankush**&#x2A; &#x2A;*[!1375](https://gitlab.com/dokos/dodock/-/merge_requests/1375){rel="&#x22;nofollow&#x22;"}**
- **Count correction when a tag is deleted *by RitvikSardana**&#x2A; &#x2A;*[!1368](https://gitlab.com/dokos/dodock/-/merge_requests/1368){rel="&#x22;nofollow&#x22;"}**
- **Bom creator tree view not working *by rohitwaghchaure**&#x2A; &#x2A;*[!1367](https://gitlab.com/dokos/dodock/-/merge_requests/1367){rel="&#x22;nofollow&#x22;"}**
- **Set ignore\_permissions on get\_receiver\_list in notification.py *by batonac**&#x2A; &#x2A;*[!1359](https://gitlab.com/dokos/dodock/-/merge_requests/1359){rel="&#x22;nofollow&#x22;"}**
- **(communication): Don't change email case *by akhilnarang**&#x2A; &#x2A;*[!1362](https://gitlab.com/dokos/dodock/-/merge_requests/1362){rel="&#x22;nofollow&#x22;"}**
- **Allowed standard fields in data export ( creation, owner) *by shariquerik**&#x2A; &#x2A;*[!1363](https://gitlab.com/dokos/dodock/-/merge_requests/1363){rel="&#x22;nofollow&#x22;"}**
- **Handle empty value of datetime control *by surajshetty3416**&#x2A; &#x2A;*[!1361](https://gitlab.com/dokos/dodock/-/merge_requests/1361){rel="&#x22;nofollow&#x22;"}**
- **Correct logic for can\_cancel *by ankush**&#x2A; &#x2A;*[!1358](https://gitlab.com/dokos/dodock/-/merge_requests/1358){rel="&#x22;nofollow&#x22;"}**
- **Delete existing children first to avoid `UniqueValidationError` *by sagarvora**&#x2A; &#x2A;*[!1357](https://gitlab.com/dokos/dodock/-/merge_requests/1357){rel="&#x22;nofollow&#x22;"}**
- **Skip no-value fields for rename *by ankush**&#x2A; &#x2A;*[!1343](https://gitlab.com/dokos/dodock/-/merge_requests/1343){rel="&#x22;nofollow&#x22;"}**
- **(website): Fix footer on login page*&#x2A; &#x2A;*[!1341](https://gitlab.com/dokos/dodock/-/merge_requests/1341){rel="&#x22;nofollow&#x22;"}**
- **Unpublish article when category is unpublished #15361*&#x2A; &#x2A;*[!1347](https://gitlab.com/dokos/dodock/-/merge_requests/1347){rel="&#x22;nofollow&#x22;"}**
- **Show footer on login via Website Settings, fixes #24153*&#x2A; &#x2A;*[!1346](https://gitlab.com/dokos/dodock/-/merge_requests/1346){rel="&#x22;nofollow&#x22;"}**
- **Drop icon column, unsupported, fixes #23826*&#x2A; &#x2A;*[!1345](https://gitlab.com/dokos/dodock/-/merge_requests/1345){rel="&#x22;nofollow&#x22;"}**
- **Ignore user settings on report doc *by ankush**&#x2A; &#x2A;*[!1344](https://gitlab.com/dokos/dodock/-/merge_requests/1344){rel="&#x22;nofollow&#x22;"}**
- **(minor): Don't load user\_info for Administrator twice. fixes #22211 *by rmehta**&#x2A; &#x2A;*[!1342](https://gitlab.com/dokos/dodock/-/merge_requests/1342){rel="&#x22;nofollow&#x22;"}**
- **Added precision field in webform field *by shariquerik**&#x2A; &#x2A;*[!1340](https://gitlab.com/dokos/dodock/-/merge_requests/1340){rel="&#x22;nofollow&#x22;"}**
- **Copy content on reply *by shariquerik**&#x2A; &#x2A;*[!1339](https://gitlab.com/dokos/dodock/-/merge_requests/1339){rel="&#x22;nofollow&#x22;"}**
- **Webhook error logging fails *by ankush**&#x2A; &#x2A;*[!1338](https://gitlab.com/dokos/dodock/-/merge_requests/1338){rel="&#x22;nofollow&#x22;"}**
- **Remove the Autocomplete cache feature *by Shankarv19bcr**&#x2A; &#x2A;*[!1337](https://gitlab.com/dokos/dodock/-/merge_requests/1337){rel="&#x22;nofollow&#x22;"}**
- **(MultiCheck): Use df.sort\_options to enable/disable sort*&#x2A; &#x2A;*[!1335](https://gitlab.com/dokos/dodock/-/merge_requests/1335){rel="&#x22;nofollow&#x22;"}**
- **(OTP): Autofocus OTP input, fix placeholder*&#x2A; &#x2A;*[!1334](https://gitlab.com/dokos/dodock/-/merge_requests/1334){rel="&#x22;nofollow&#x22;"}**
- **Mobile issue with form pop up *by safwansamsudeen**&#x2A; &#x2A;*[!1315](https://gitlab.com/dokos/dodock/-/merge_requests/1315){rel="&#x22;nofollow&#x22;"}**

## Maintenance et organisation

- **Set pipefail in shell before running piped backup/restore commands *by akhilnarang**&#x2A; &#x2A;*[!1360](https://gitlab.com/dokos/dodock/-/merge_requests/1360){rel="&#x22;nofollow&#x22;"}**

## Tests et intégration continue

- **Increase delay after focus [frappe]*&#x2A; &#x2A;*[!1395](https://gitlab.com/dokos/dodock/-/merge_requests/1395){rel="&#x22;nofollow&#x22;"}**
- **(deps): Bump frappe-datable to v1.17.14 *by RitvikSardana**&#x2A; &#x2A;*[!1336](https://gitlab.com/dokos/dodock/-/merge_requests/1336){rel="&#x22;nofollow&#x22;"}**

---

**Contributeurs**

- **Ankush Menat** (21)
- **Charles-Henri Decultot** (15)
- **Corentin Forler** (14)
- **Shariq Ansari** (7)
- **Akhil Narang** (6)
- **RitvikSardana** (4)
- **Rushabh Mehta** (4)
- **Maharshi Patel** (2)
- **Safwan Samsudeen** (2)
- **Sagar Vora** (2)

et 5 autres contributeurs...

- Kevin Shenk
- Suraj Shetty
- V Shankar
- barredterra
- rohitwaghchaure

---

**Différentiel complet:** [v4.2.0...v4.3.0](https://gitlab.com/dokos/dodock/-/compare/v4.2.0...v4.3.0){rel="&#x22;nofollow&#x22;"}:br&#x2A;*Tag:** [v4.3.0](https://gitlab.com/dokos/dodock/-/tags/v4.3.0){rel="&#x22;nofollow&#x22;"}


# V3.0.0

::callout
La version 3.0.0 de Dodock est basée sur la version 14 de Frappe :br
Une grande partie des changements cités ci-dessous ont été développés par l'équipe de Frappe Technologies et les contributeurs aux logiciels de l'éco-système Frappe/ERPNext :br
Le détail des changements publiés dans Dodock est disponible sur [Gitlab](https://gitlab.com/dokos/dodock/-/releases/v3.0.0){rel=""nofollow""}
::

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Cette page n'indique que les nouvelles fonctionnalités les plus importantes pour chaque module.
::

## Migration vers la v3.x.x

> [Guide de migration pour les utilisateurs auto-hébergés](https://doc.dokos.io/v5/dodock/administration/migration-v3)

> [Migration de Dodock: v2 > v3 (Frappe v13 > v14)](https://github.com/frappe/frappe/wiki/Migrating-to-Version-14){rel="&#x22;nofollow&#x22;"}

### Site web

- 📄 Evaluations dans les billets de blog
- 📄 Nouveau bloc web *Discussions* pour autoriser les discussions sur votre site web
- 📄 Formulaires web à plusieurs étapes grâce à l'ajout de sauts de page
- 📄 Image *Splash* configurable dans les paramètres du site web
- 📄 Nouveau portail E-Commerce
- 📄 Options de recherche dans le site E-Commerce

### Framework

- 🚀 Nouveau type de champs **Séparateurs d'onglets**
- 🚀 Nouvel éditeur de format d'impression (L'ancien éditeur est toujours disponible par défaut pour le moment)
- 🚀 Nouvel éditeur d'espaces de travail en glisser-déposer
- 🚀 Les espaces de travail peuvent être limités à certains rôles
- 🚀 Nouveau widget dans les espaces de travail: *listes rapides*
- 🚀 Amélioration du traitement de données en masse depuis les listes
- 🚀 Le type de document *Nom de série* a été supprimé et remplacé par les *Paramètres de nommage des documents*
- 🚀 Nouvelle option pour renforcer le contrôle des numéros de téléphone dans les champs de type *Données*
- 📄 Option pour optimiser et réduire la taille des images au moment de leur chargement
- 📄 Les liens vers certains types de document peuvent désormais être traduits si l'option correspondante est cochée dans les métadonnées du type de document
- 📄 Nouvelle option pour afficher le titre de certains types de documents dans les liens au lieu de leur nom (ID)
- 📈 Les graphiques de tableau de bord peuvent désormais être limités à certains rôles
- 🚀 Nouvelle option `df.enable_mentions` pour autoriser les mentions dans tous les champs de type \*Texte"
- 🚀 Nouveau *hook* régional `doctype_regional_js`
- 🚀 Possibilité d'utiliser CTRL+Z / CTRL+SHIFT+Z pour annuler/relancer la dernière action dans un document
- 🚀 CTRL+G ouvre désormais un pop-up permettant de naviguer rapidement entre deux fonctionnalités
- 🚀 Nouveau constructeur de requêtes en Python `frappe.qb`
- 🚀 Nouvelles options de recherche dans les tables enfants
- 🚀 Outil graphique de configuration de la vue en grille des tables enfants
- 🚀 Types de champs virtuels
- 📄 Possibilité de définir le premier jour de la semaine dans les paramètres système
- 🚀 Option pour crypter les sauvegardes de base de données
- 🚀 Option pour activer le sélecteur de fichiers Google Drive


# V3.10.0

::callout
La version 3.10.0 de Dodock est basée sur la version 14 de Frappe :br
Une grande partie des changements cités ci-dessous ont été développés par l'équipe de Frappe Technologies et les contributeurs aux logiciels de l'éco-système Frappe/ERPNext :br
Le détail des changements publiés dans Dodock est disponible sur [Gitlab](https://gitlab.com/dokos/dodock/-/releases/v3.10.0){rel=""nofollow""}
::

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Cette page n'indique que les nouvelles fonctionnalités les plus importantes pour chaque module.
::

### Requêtes SQL

- Ajout d'un timeout par défaut sur les requêtes SQL

### Performance

- Ajout des règles de nommage de document en cache


# V3.11.0

::callout
La version 3.11.0 de Dodock est basée sur la version 14 de Frappe :br
Une grande partie des changements cités ci-dessous ont été développés par l'équipe de Frappe Technologies et les contributeurs aux logiciels de l'éco-système Frappe/ERPNext :br
Le détail des changements publiés dans Dodock est disponible sur [Gitlab](https://gitlab.com/dokos/dodock/-/releases/v3.11.0){rel=""nofollow""}
::

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Cette page n'indique que les nouvelles fonctionnalités les plus importantes pour chaque module.
::

### API

- Ajout du paramètres `letterhead` à l'API `frappe.get_print`

### Documentation

- Nouveau champ permettant d'ajouter un lien vers de la documentation externe dans tous les champs des formulaires

### Variables d'environnement

- Nouvelles clés `app_include_js` et `app_include_css` dans le fichier `site_config.json` pour exposer des fichiers JS et CSS externes sur tous les sites.


# V3.12.0

::callout
La version 3.12.0 de Dodock est basée sur la version 14 de Frappe :br
Une grande partie des changements cités ci-dessous ont été développés par l'équipe de Frappe Technologies et les contributeurs aux logiciels de l'éco-système Frappe/ERPNext :br
Le détail des changements publiés dans Dodock est disponible sur [Gitlab](https://gitlab.com/dokos/dodock/-/releases/v3.12.0){rel=""nofollow""}
::

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Cette page n'indique que les nouvelles fonctionnalités les plus importantes pour chaque module.
::

### Découvertes des documents (tours)

- Il est désormais possible d'ajouter des *tours* (accessible via le bouton de menu **Découvrir le document**) via un fichier dédié appelé `{type de document}_tour.js` ajouté directement dans le dossier du type de document.
- Une nouvelle API permet de naviguer entre les séparateurs d'onglet.

  - *Dans l'étape précédente*: next\_step\_tab
  - *Dans l'étape suivante*: previous\_step\_tab
  > Voir les tours des type de document **Client** ou **Fournisseur** pour avoir un exemple
- Le champ `title` n'est plus obligatoire dans les étapes. S'il n'est pas donné, il est remplacé par le libellé du champ.

### Création et personnalisation de formulaire

- Les options proposées dans le menu *Récupérer depuis le champ* sont désormais triées. :br
  👉 [Frappe](https://github.com/frappe/frappe/pull/19019){rel="&#x22;nofollow&#x22;"}


# V3.13.0

::callout
La version 3.13.0 de Dodock est basée sur la version 14 de Frappe :br
Une grande partie des changements cités ci-dessous ont été développés par l'équipe de Frappe Technologies et les contributeurs aux logiciels de l'éco-système Frappe/ERPNext :br
Le détail des changements publiés dans Dodock est disponible sur [Gitlab](https://gitlab.com/dokos/dodock/-/releases/v3.13.0){rel=""nofollow""}
::

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Cette page n'indique que les nouvelles fonctionnalités les plus importantes pour chaque module.
::

### Communications

- Il est désormais possible de supprimer automatiquement les anciennes communications en paramétrant un nombre de jours avant suppression dans les **Paramètres des journaux**.
  La règle de suppression est la suivante:


  - La date de modification doit être supérieure ou égale à la durée indiquée dans les paramètres des journaux
  - La communication doit avoir le statut **Ouvert**
  - La communication doit être de type **Réception**
  - La communication ne doit pas être liée à un document de référence

👉 L'objectif est de supprimer toutes les communications correspondant à des emails entrants qui ne sont pas utilisés dans Dokos.

### Performance

- Le cache n'est plus vidé par défaut lors de l'installation pour un gain d'environ 12% pour la durée d'installation. :br
  👉 [Frappe](https://github.com/frappe/frappe/pull/19019){rel="&#x22;nofollow&#x22;"}


# V3.14.0

::callout
La version 3.14.0 de Dodock est basée sur la version 14 de Frappe :br
Une grande partie des changements cités ci-dessous ont été développés par l'équipe de Frappe Technologies et les contributeurs aux logiciels de l'éco-système Frappe/ERPNext :br
Le détail des changements publiés dans Dodock est disponible sur [Gitlab](https://gitlab.com/dokos/dodock/-/releases/v3.14.0){rel=""nofollow""}
::

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Cette page n'indique que les nouvelles fonctionnalités les plus importantes pour chaque module.
::

### Fichiers

- Ajout d'un système de vérouillage des fichiers pour éviter les conflits lors d'écritures simultanées. :br
  👉 [Frappe](https://github.com/frappe/frappe/pull/19133){rel="&#x22;nofollow&#x22;"}

### Insertions en masse

- Il est désormais possible d'insérer des documents sous forme d'objets *Document* en masse. :br
  👉 [Frappe](https://github.com/frappe/frappe/pull/15705){rel="&#x22;nofollow&#x22;"}

### Interface utilisateur

- Les en-têtes de séparateurs d'onglet sont désormais bloqués en haut de page lors de la navigation. :br
  👉 [Frappe](https://github.com/frappe/frappe/pull/18906){rel="&#x22;nofollow&#x22;"}


# V3.15.0

::callout
La version 3.15.0 de Dodock est basée sur la version 14 de Frappe :br
Une grande partie des changements cités ci-dessous ont été développés par l'équipe de Frappe Technologies et les contributeurs aux logiciels de l'éco-système Frappe/ERPNext :br
Le détail des changements publiés dans Dodock est disponible sur [Gitlab](https://gitlab.com/dokos/dodock/-/releases/v3.15.0){rel=""nofollow""}
::

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Cette page n'indique que les nouvelles fonctionnalités les plus importantes pour chaque module.
::

### Formulaires web

- Ajout d'une section permettant de définir des méta-tags dans les formulaires web. :br
  👉 [Frappe](https://github.com/frappe/frappe/pull/19306){rel="&#x22;nofollow&#x22;"}

### API d'impression

- Les paramètres `language` et `letter_head` ont été ajoutés à l'API `download_pdf`. :br
  👉 [Frappe](https://github.com/frappe/frappe/pull/19284){rel="&#x22;nofollow&#x22;"}

### Rapports

- Un bouton permet désormais de sélectionner toutes les colonnes disponibles dans un rapport pour les ajouter à l'impression. :br
  👉 [Frappe](https://github.com/frappe/frappe/pull/19236){rel="&#x22;nofollow&#x22;"}

### Enregistreur

- L'enregistreur de requêtes (outil d'analyse des requêtes passées au système) peut désormais être configuré plus finement grâce à un décorateur. :br
  👉 [Frappe](https://github.com/frappe/frappe/pull/19220){rel="&#x22;nofollow&#x22;"}

### API d'export en csv

- `frappe.utils.csvutils.to_csv`: Ajout d'une option `delimiter` correspondant à l'option `delimiter` de *UnicodeWriter*
- `frappe.core.api.files.zip_files`: Ajout d'une option `filename` pour nommer le fichier zip créé


# V3.16.0

::callout
La version 3.16.0 de Dodock est basée sur la version 14 de Frappe :br
Une grande partie des changements cités ci-dessous ont été développés par l'équipe de Frappe Technologies et les contributeurs aux logiciels de l'éco-système Frappe/ERPNext :br
Le détail des changements publiés dans Dodock est disponible sur [Gitlab](https://gitlab.com/dokos/dodock/-/releases/v3.16.0){rel=""nofollow""}
::

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Cette page n'indique que les nouvelles fonctionnalités les plus importantes pour chaque module.
::

### Hooks

- Nouveau *hook* `ignore_links_on_delete` permettant d'ignorer certains liens lors de la suppression d'un document. :br
  👉 [Frappe](https://github.com/frappe/frappe/pull/19347){rel="&#x22;nofollow&#x22;"}


# V3.17.0

::callout
La version 3.17.0 de Dodock est basée sur la version 14 de Frappe :br
Une grande partie des changements cités ci-dessous ont été développés par l'équipe de Frappe Technologies et les contributeurs aux logiciels de l'éco-système Frappe/ERPNext :br
Le détail des changements publiés dans Dodock est disponible sur [Gitlab](https://gitlab.com/dokos/dodock/-/releases/v3.17.0){rel=""nofollow""}
::

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Cette page n'indique que les nouvelles fonctionnalités les plus importantes pour chaque module.
::

### Personnalisations / Développement

- Lorsque l'on maintient la touche `alt` enfoncée, le nom du champ (ID) s'affiche désormais


# V3.18.0

::callout
La version 3.18.0 de Dodock est basée sur la version 14 de Frappe :br
Une grande partie des changements cités ci-dessous ont été développés par l'équipe de Frappe Technologies et les contributeurs aux logiciels de l'éco-système Frappe/ERPNext :br
Le détail des changements publiés dans Dodock est disponible sur [Gitlab](https://gitlab.com/dokos/dodock/-/releases/v3.18.0){rel=""nofollow""}
::

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Cette page n'indique que les nouvelles fonctionnalités les plus importantes pour chaque module.
::

### Connexion

- Nouvelle option de connexion permettant de se connecter avec un lien envoyé par email :br
  👉 [Frappe](https://github.com/frappe/frappe/pull/19363){rel="&#x22;nofollow&#x22;"}


# V3.19.0

::callout
La version 3.19.0 de Dodock est basée sur la version 14 de Frappe :br
Une grande partie des changements cités ci-dessous ont été développés par l'équipe de Frappe Technologies et les contributeurs aux logiciels de l'éco-système Frappe/ERPNext :br
Le détail des changements publiés dans Dodock est disponible sur [Gitlab](https://gitlab.com/dokos/dodock/-/releases/v3.19.0){rel=""nofollow""}
::

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Cette page n'indique que les nouvelles fonctionnalités les plus importantes pour chaque module.
::

### Espaces de travail

- Une nouvelle option permet de cacher/afficher un espace de travail depuis la barre latérale :br
  👉 [Frappe](https://github.com/frappe/frappe/pull/19539){rel="&#x22;nofollow&#x22;"}

### Formulaires web

- Il est désormais possible d'ajouter la colonne `name` (ID) dans la vue en liste des formulaires web

### Expérience développeurs

- Ajout d'une méthode `__repr__` dans la classe `DocField`:br
  👉 [Frappe](https://github.com/frappe/frappe/pull/19479){rel="&#x22;nofollow&#x22;"}


# V3.1.0

::callout
La version 3.1.0 de Dodock est basée sur la version 14 de Frappe :br
Une grande partie des changements cités ci-dessous ont été développés par l'équipe de Frappe Technologies et les contributeurs aux logiciels de l'éco-système Frappe/ERPNext :br
Le détail des changements publiés dans Dodock est disponible sur [Gitlab](https://gitlab.com/dokos/dodock/-/releases/v3.1.0){rel=""nofollow""}
::

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Cette page n'indique que les nouvelles fonctionnalités les plus importantes pour chaque module.
::

### Scripts python

- Ajout de la méthode `make_put_requests` dans les scripts python

### Kanban

- Simplification du dialogue de création de tableaux Kanban
- Il est désormais possible de créer plusieurs tableaux Kanban pour un même type de document

### Performance

- Supression d'anciens index non utilisés


# V3.20.0

::callout
La version 3.20.0 de Dodock est basée sur la version 14 de Frappe :br
Une grande partie des changements cités ci-dessous ont été développés par l'équipe de Frappe Technologies et les contributeurs aux logiciels de l'éco-système Frappe/ERPNext :br
Le détail des changements publiés dans Dodock est disponible sur [Gitlab](https://gitlab.com/dokos/dodock/-/releases/v3.20.0){rel=""nofollow""}
::

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Cette page n'indique que les nouvelles fonctionnalités les plus importantes pour chaque module.
::

### Espaces de travail

- Ajout d'un lien vers les **Paramètres de la barre de navigation** dans l'espace de travail **Paramètres**:br
  👉 [Dodock](https://gitlab.com/dokos/dodock/-/merge_requests/5){rel="&#x22;nofollow&#x22;"}

### Expérience Développeur

- Nouvelle commande permettant de créer un patch de migration `bench create-patch`:br
  👉 [Frappe](https://github.com/frappe/frappe/pull/19722){rel="&#x22;nofollow&#x22;"}
- Ajout de la balise `content` dans la liste des balises HTML acceptables par le framework :br
  👉 [Frappe](https://github.com/frappe/frappe/pull/19667){rel="&#x22;nofollow&#x22;"}

### Personnalisations

- Les utilisateurs peuvent désormais modifier l'ordre de résolution des *Hooks* depuis le document **Applications installées**:br
  👉 [Frappe](https://github.com/frappe/frappe/pull/19653){rel="&#x22;nofollow&#x22;"}

### Emails

- La connexion aux comptes emails via Oauth passe désormais par le type de document **Application connectée** pour standardiser ce type de connexion. :br
  👉 [Frappe](https://github.com/frappe/frappe/pull/18750){rel="&#x22;nofollow&#x22;"}


# V3.21.0

::callout
La version 3.21.0 de Dodock est basée sur la version 14 de Frappe :br
Une grande partie des changements cités ci-dessous ont été développés par l'équipe de Frappe Technologies et les contributeurs aux logiciels de l'éco-système Frappe/ERPNext :br
Le détail des changements publiés dans Dodock est disponible sur [Gitlab](https://gitlab.com/dokos/dodock/-/releases/v3.21.0){rel=""nofollow""}
::

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Cette page n'indique que les nouvelles fonctionnalités les plus importantes pour chaque module.
::

### Formulaires web

- Amélioration des formulaires web et des fonctions de paiement

  - Ajout d'une classe css de type `btn-default` ou `btn-danger` sur le bouton de publication des formulaires web
  - Ajout d'un bouton *Voir la liste*
  - Amélioration des messages d'erreur
  - Meilleure gestion du chargement des traductions
  - Récupération automatique des devises dans le document source :br
    👉 [Dodock](https://gitlab.com/dokos/dodock/-/merge_requests/63){rel="&#x22;nofollow&#x22;"}
- Ajout d'un texte de pied de page
- Ajout de deux nouvelles méthodes `webform_validate_doc` et `webform_accept_doc`:br
  👉 [Dodock](https://gitlab.com/dokos/dodock/-/merge_requests/57){rel="&#x22;nofollow&#x22;"}

### Demandes d'intégration

- Les messages d'erreur sont désormais affichés en haut du formulaire :br
  👉 [Dodock](https://gitlab.com/dokos/dodock/-/merge_requests/62){rel="&#x22;nofollow&#x22;"}

### Champs de type *Lien*

- Amélioration du fonctionnement en supprimant le délai avant affichage et en améliorant la gestion du cache :br
  👉 [Dodock](https://gitlab.com/dokos/dodock/-/merge_requests/60){rel="&#x22;nofollow&#x22;"}
  👉 [Dodock](https://gitlab.com/dokos/dodock/-/merge_requests/61){rel="&#x22;nofollow&#x22;"}


# V3.22.0

::callout
La version 3.22.0 de Dodock est basée sur la version 14 de Frappe :br
Une grande partie des changements cités ci-dessous ont été développés par l'équipe de Frappe Technologies et les contributeurs aux logiciels de l'éco-système Frappe/ERPNext :br
Le détail des changements publiés dans Dodock est disponible sur [Gitlab](https://gitlab.com/dokos/dodock/-/releases/v3.22.0){rel=""nofollow""}
::

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Cette page n'indique que les nouvelles fonctionnalités les plus importantes pour chaque module.
::

### Blog

- Ajout d'un bouton **Publier** dans les billets de blog :br
  👉 [Frappe](https://github.com/frappe/frappe/pull/20066){rel="&#x22;nofollow&#x22;"}

### Gestion des session

- Lorsqu'une session est expirée, les utilisateurs sont désormais redirigés vers la page de connexion au lieu d'avoir un popup de connexion dédié :br
  👉 [Frappe](https://github.com/frappe/frappe/pull/20018){rel="&#x22;nofollow&#x22;"}

### Personnalisations

- L'option **Récupérer depuis le champ** a été améliorée pour proposer les options dans un champ de sélection au lieu d'un petit texte :br
  👉 [Frappe](https://github.com/frappe/frappe/pull/20046){rel="&#x22;nofollow&#x22;"}


# V3.23.0

::callout
La version 3.23.0 de Dodock est basée sur la version 14 de Frappe :br
Une grande partie des changements cités ci-dessous ont été développés par l'équipe de Frappe Technologies et les contributeurs aux logiciels de l'éco-système Frappe/ERPNext :br
Le détail des changements publiés dans Dodock est disponible sur [Gitlab](https://gitlab.com/dokos/dodock/-/releases/v3.23.0){rel=""nofollow""}
::

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Cette page n'indique que les nouvelles fonctionnalités les plus importantes pour chaque module.
::

### Formulaires web

- Ajout d'une méthode `get_webform_context` dans les contrôleurs des documents de référence pour modifier le contexte des formulaires web

### Calendriers

- Ajout d'une option `convertToUserTz` dans les calendriers pour mieux gérer les erreurs liées aux fuseaux horaires :br
  👉 [Frappe](https://github.com/frappe/frappe/pull/20051){rel="&#x22;nofollow&#x22;"}

### Expérience utilisateur

- Ajout d'icônes dans les champs de type `Lien` ou `Lien Dynamique`:br
  👉 [Dodock](https://gitlab.com/dokos/dodock/-/merge_requests/71){rel="&#x22;nofollow&#x22;"}
- Ajout d'une méthode `frappe.utils.font_icon` pour renvoyer une icône font-awesome ou unicons :br
  👉 [Dodock](https://gitlab.com/dokos/dodock/-/merge_requests/71){rel="&#x22;nofollow&#x22;"}

### Documents

- Lorsqu'un document lié n'existe pas, le contrôleur renvoie désormais une erreur :br
  👉 [Dodock](https://gitlab.com/dokos/dodock/-/merge_requests/69){rel="&#x22;nofollow&#x22;"}
- Lorsque la valeur passée dans un champ de type `Lien` n'est pas une chaîne de caractères, le contrôleur renvoie désormais une erreur :br
  👉 [Dodock](https://gitlab.com/dokos/dodock/-/merge_requests/69){rel="&#x22;nofollow&#x22;"}


# V3.24.0

::callout
La version 3.24.0 de Dodock est basée sur la version 14 de Frappe :br
Une grande partie des changements cités ci-dessous ont été développés par l'équipe de Frappe Technologies et les contributeurs aux logiciels de l'éco-système Frappe/ERPNext :br
Le détail des changements publiés dans Dodock est disponible sur [Gitlab](https://gitlab.com/dokos/dodock/-/releases/v3.24.0){rel=""nofollow""}
::

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Cette page n'indique que les nouvelles fonctionnalités les plus importantes pour chaque module.
::

### Site web

- Création de composants `BackButton` et `FloatingButton` utilisés pour la navigation sur le site web :br
  👉 [Dodock](https://gitlab.com/dokos/dodock/-/merge_requests/72){rel="&#x22;nofollow&#x22;"}

### Vue Liste

- Un nouveau paramètre dans les paramètres de vue en liste permet de désactiver le décompte des commentaires :br
  👉 [Frappe](https://github.com/frappe/frappe/pull/20039){rel="&#x22;nofollow&#x22;"}


# V3.25.0

::callout
La version 3.25.0 de Dodock est basée sur la version 14 de Frappe :br
Une grande partie des changements cités ci-dessous ont été développés par l'équipe de Frappe Technologies et les contributeurs aux logiciels de l'éco-système Frappe/ERPNext :br
Le détail des changements publiés dans Dodock est disponible sur [Gitlab](https://gitlab.com/dokos/dodock/-/releases/v3.25.0){rel=""nofollow""}
::

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Cette page n'indique que les nouvelles fonctionnalités les plus importantes pour chaque module.
::

### Images Docker

- Des images Docker sont désormais créées lors de la publication de chaque nouvelle version :br
  👉 [Répertoire Docker](https://gitlab.com/dokos/dodock/container_registry/){rel="&#x22;nofollow&#x22;"}

### Liens

- Le composant de prévisualisation des documents liés a été amélioré
  👉 [Dodock](https://gitlab.com/dokos/dodock/-/merge_requests/73){rel="&#x22;nofollow&#x22;"}


# V3.26.0

::callout
La version 3.26.0 de Dodock est basée sur la version 14 de Frappe :br
Une grande partie des changements cités ci-dessous ont été développés par l'équipe de Frappe Technologies et les contributeurs aux logiciels de l'éco-système Frappe/ERPNext :br
Le détail des changements publiés dans Dodock est disponible sur [Gitlab](https://gitlab.com/dokos/dodock/-/releases/v3.26.0){rel=""nofollow""}
::

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Cette page n'indique que les nouvelles fonctionnalités les plus importantes pour chaque module.
::

### Espaces de travail

- Il est désormais possible d'ajouter des cartes statistiques dans les espaces de travail :br
  👉 [Frappe](https://github.com/frappe/frappe/pull/20065){rel="&#x22;nofollow&#x22;"}

### Accessibilité

- Amélioration des contrastes des boutons dans l'éditeur de texte :br
  👉 [Dodock](https://gitlab.com/dokos/dodock/-/merge_requests/79){rel="&#x22;nofollow&#x22;"}

### Docker

- Il est possible de forcer la création d'une image en indiquant `[build]` dans le titre d'un commit :br
  👉 [Dodock](https://gitlab.com/dokos/dodock/-/merge_requests/76){rel="&#x22;nofollow&#x22;"}


# V3.27.0

::callout
La version 3.27.0 de Dodock est basée sur la version 14 de Frappe :br
Une grande partie des changements cités ci-dessous ont été développés par l'équipe de Frappe Technologies et les contributeurs aux logiciels de l'éco-système Frappe/ERPNext :br
Le détail des changements publiés dans Dodock est disponible sur [Gitlab](https://gitlab.com/dokos/dodock/-/releases/v3.27.0){rel=""nofollow""}
::

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Cette page n'indique que les nouvelles fonctionnalités les plus importantes pour chaque module.
::

### Calcul d'arrondis

- La méthode de calcul des arrondis est désormais configurable dans les paramètres système :br
  👉 [Frappe](https://github.com/frappe/frappe/pull/20258){rel="&#x22;nofollow&#x22;"}

### Espaces de travail

- Addition d'un nouveau composant **Carte de résumé**
  👉 [Dodock](https://gitlab.com/dokos/dodock/-/merge_requests/94){rel="&#x22;nofollow&#x22;"}

### Site web

- Amélioration de la fonction `cleanup_page_name` pour permettre l'ajout de caractères non latins et d'emojis dans les URL des pages générées par Dodock :br
  👉 [Dodock](https://gitlab.com/dokos/dodock/-/merge_requests/93){rel="&#x22;nofollow&#x22;"}

### Tests

- L'exécuteur de tests utilise désormais `time.monotonic` au lieu de `time.time` pour les journaux de tests :br
  👉 [Dodock](https://gitlab.com/dokos/dodock/-/merge_requests/92){rel="&#x22;nofollow&#x22;"}

### Développeurs

- Ajout de deux nouvelles méthodes `frappe.model.meta.get_views_of_doctype` (*Python*) et `frappe.model.get_views_of_doctype` (*Javascript*) permettant d'obtenir les vues associées à chaque type de document :br
  👉 [Dodock](https://gitlab.com/dokos/dodock/-/merge_requests/94){rel="&#x22;nofollow&#x22;"}


# V3.28.0

::callout
La version 3.28.0 de Dodock est basée sur la version 14 de Frappe :br
Une grande partie des changements cités ci-dessous ont été développés par l'équipe de Frappe Technologies et les contributeurs aux logiciels de l'éco-système Frappe/ERPNext :br
Le détail des changements publiés dans Dodock est disponible sur [Gitlab](https://gitlab.com/dokos/dodock/-/releases/v3.28.0){rel=""nofollow""}
::

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Cette page n'indique que les nouvelles fonctionnalités les plus importantes pour chaque module.
::

### Espaces de travail

- Ajout de liens vers les **En-têtes** de document et les **Titres d'impression** dans l'espace de travail **Paramètres**

### Flux de travail

- Les titres des **Etats de flux de travail** sont désormais traduits dans les champs de type *Lien*. Cela permet d'avoir une liste d'états de flux de travail traduisibles en plusieurs langues. :br
  👉 [Frappe](https://github.com/frappe/frappe/pull/20326){rel="&#x22;nofollow&#x22;"}

### Grilles (Tables enfant)

- L'affichage du bouton **Modifier** a été amélioré pour disparaître s'il n'y a pas assez de place sur la page :br
  👉 [Dodock](https://gitlab.com/dokos/dodock/-/merge_requests/101){rel="&#x22;nofollow&#x22;"}

### Vue Liste

- Des boutons d'action ont été ajoutés directement dans l'en-tête de la liste lorsque l'on sélectionne plusieurs lignes. Il s'agit d'une alternative à &#x2A;Actions > {Action à exécuter}*:br
  👉 [Dodock](https://gitlab.com/dokos/dodock/-/merge_requests/101){rel="&#x22;nofollow&#x22;"}

### Traduction du site web

- Refonte globale du système de traduction sur le site web pour l'améliorer :br
  👉 [Dodock](https://gitlab.com/dokos/dodock/-/merge_requests/102){rel="&#x22;nofollow&#x22;"}

### Portail utilisateur

- Refonte de la barre latérale du portail utilisateur (site web) pour la moderniser :br
  👉 [Dodock](https://gitlab.com/dokos/dodock/-/merge_requests/74){rel="&#x22;nofollow&#x22;"}

### Développeurs

- Ajout de deux nouvelles méthodes dans la classe *Document* `check_if_locked` et `is_locked`


# V3.29.0

::callout
La version 3.29.0 de Dodock est basée sur la version 14 de Frappe :br
Une grande partie des changements cités ci-dessous ont été développés par l'équipe de Frappe Technologies et les contributeurs aux logiciels de l'éco-système Frappe/ERPNext :br
Le détail des changements publiés dans Dodock est disponible sur [Gitlab](https://gitlab.com/dokos/dodock/-/releases/v3.29.0){rel=""nofollow""}
::

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Cette page n'indique que les nouvelles fonctionnalités les plus importantes pour chaque module.
::

### Vue Planning

- Nouvelle vue **Planning** permettant d'afficher des événements par ressource :br
  👉 [Dodock](https://gitlab.com/dokos/dodock/-/merge_requests/110){rel="&#x22;nofollow&#x22;"}

### Editeur de texte

- En ajoutant l'option `Template` dans les paramètres d'un champ de type "Editeur de texte", un sélecteur de variable apparaît :br
  👉 [Dodock](https://gitlab.com/dokos/dodock/-/merge_requests/111){rel="&#x22;nofollow&#x22;"}

### Calendrier

- Amélioration du calendrier en mode *Nuit*:br
  👉 [Dodock](https://gitlab.com/dokos/dodock/-/merge_requests/118){rel="&#x22;nofollow&#x22;"}

### Vue Liste

- Dans la vue en liste, il est désormais possible de cliquer pour sélectionner une ligne, puis de laisser glisser sa souris pour sélectionner les suivantes. :br
  👉 [Frappe](https://github.com/frappe/frappe/pull/20457){rel="&#x22;nofollow&#x22;"}

### Autorisations

- Une nouvelle option disponible dans les *Paramètres système* permettent de désactiver le partage de documents. :br
  Dans ce cas, il faudra donner les bonnes autorisations à tous les utilisateurs pour qu'ils puissent accéder à un document. :br
  👉 [Frappe](https://github.com/frappe/frappe/pull/20318){rel="&#x22;nofollow&#x22;"}

### Adresses

- Le caractère *désactivé* d'une adresse est affichée dans les documents utilisant le modèle de liste d'adresse :br
  👉 [Frappe](https://github.com/frappe/frappe/pull/20446){rel="&#x22;nofollow&#x22;"}

### Portail

- La couleur de fond de la barre latérale du portail est désormais configurable via le **Thème du site web**
  👉 [Dodock](https://gitlab.com/dokos/dodock/-/merge_requests/104){rel="&#x22;nofollow&#x22;"}

### Expérience utilisateur

- Amélioration du contraste des boutons dans les listes et globalement dans le logiciel :br
  👉 [Dodock](https://gitlab.com/dokos/dodock/-/merge_requests/117){rel="&#x22;nofollow&#x22;"}

### Expérience développeur

- Lors de la création d'une **Source du graphique de tableau de bord**, les fichiers de contrôleurs `javascript` et `python` sont automatiquement créés sur le disque. :br
  👉 [Dodock](https://gitlab.com/dokos/dodock/-/merge_requests/114){rel="&#x22;nofollow&#x22;"}
- Un nouveau décorateur `@redis_cache` permet de mettre plus facilement des fonctions dans le cache redis. :br
  👉 [Frappe](https://github.com/frappe/frappe/pull/20452){rel="&#x22;nofollow&#x22;"}

### API

- La fonction `frappe.utils.get_table_name` renvoie désormais les noms des tables :br
  👉 [Frappe](https://github.com/frappe/frappe/pull/20553){rel="&#x22;nofollow&#x22;"}


# V3.2.0

::callout
La version 3.2.0 de Dodock est basée sur la version 14 de Frappe :br
Une grande partie des changements cités ci-dessous ont été développés par l'équipe de Frappe Technologies et les contributeurs aux logiciels de l'éco-système Frappe/ERPNext :br
Le détail des changements publiés dans Dodock est disponible sur [Gitlab](https://gitlab.com/dokos/dodock/-/releases/v3.2.0){rel=""nofollow""}
::

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Cette page n'indique que les nouvelles fonctionnalités les plus importantes pour chaque module.
::

### Evénéments

- Nouveau statut **Terminé** (Completed) dans le type de document Evénement


# V3.30.0

::callout
La version 3.30.0 de Dodock est basée sur la version 14 de Frappe :br
Une grande partie des changements cités ci-dessous ont été développés par l'équipe de Frappe Technologies et les contributeurs aux logiciels de l'éco-système Frappe/ERPNext :br
Le détail des changements publiés dans Dodock est disponible sur [Gitlab](https://gitlab.com/dokos/dodock/-/releases/v3.30.0){rel=""nofollow""}
::

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Cette page n'indique que les nouvelles fonctionnalités les plus importantes pour chaque module.
::

### Espaces de travail

- Les espaces de travail de Dodock ont été simplifié.

  - Un nouvel espace de travail **Administration** regroupe toutes les fonctionnalités *techniques* de Dodock.
  - Des cartes statistiques ont été ajoutées dans tous les espaces de travail d'administration et un graphique d'analyse du site web dans l'espace de travail **Site Web**.
  - L'espace de travail **Développements** a été supprimé et fusionné dans les autres espaces de travail.
    👉 [Dodock](https://gitlab.com/dokos/dodock/-/merge_requests/128){rel="&#x22;nofollow&#x22;"}
- Une nouvelle option permet à chaque utilisateur de définir un espace de travail par défaut dans sa fiche Utilisateur. :br
  Lors de la connexion à Dokos ou s'il clique sur l'icône en haut à gauche, l'utilisateur sera redirigé vers cet espace de travail. :br
  👉 [Dodock](https://gitlab.com/dokos/dodock/-/merge_requests/113){rel="&#x22;nofollow&#x22;"}

### Fichiers

- Il est désormais possible de forcer la visibilité public/privé d'un fichier via les **Options** disponibles dans les champs de type **Joindre** et **Joindre une image**.
  Il suffit d'inscrire **Public** ou **Public** dans le champ **Options** pour que le fichier téléchargé soit automatiquement considéré comme public ou privé. :br
  Dans ce cas, le bouton de sélection public/privé habituel n'apparaît plus.
  👉 [Dodock](https://gitlab.com/dokos/dodock/-/merge_requests/133){rel="&#x22;nofollow&#x22;"}

### Site Web

- Les images ajoutées dans les paramètres du site web sont désormais Publiques par défaut.

### Rapports

- Les noms des rapports sont désormais traduits dans la **Vue Liste**

### Devise

- Un patch correctif force l'affichage du symbole € à droite du montant
- Les fractions de devises sont désormais traduites. :br
  👉 [Dodock](https://gitlab.com/dokos/dodock/-/merge_requests/125){rel="&#x22;nofollow&#x22;"}

### Mises à jour de Dodock

- Un popup prévient désormais les utilisateurs en auto-hébergement lorsqu'une nouvelle mise à jour est disponible.


# V3.31.0

::callout
La version 3.31.0 de Dodock est basée sur la version 14 de Frappe :br
Une grande partie des changements cités ci-dessous ont été développés par l'équipe de Frappe Technologies et les contributeurs aux logiciels de l'éco-système Frappe/ERPNext :br
Le détail des changements publiés dans Dodock est disponible sur [Gitlab](https://gitlab.com/dokos/dodock/-/releases/v3.31.0){rel=""nofollow""}
::

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Cette page n'indique que les nouvelles fonctionnalités les plus importantes pour chaque module.
::

### Expérience Utilisateur

- Nouvelle icône à côté des boutons *Annuler*
  👉 [Dodock](https://gitlab.com/dokos/dodock/-/merge_requests/135){rel="&#x22;nofollow&#x22;"}
- Amélioration des ombres en mode *Nuit*,
  👉 [Dodock](https://gitlab.com/dokos/dodock/-/merge_requests/135){rel="&#x22;nofollow&#x22;"}

### API de formulaire

- Nouvelle méthode `set_df_properties` pour définir plusieurs méthodes en une seule ligne de code. :br
  👉 [Dodock](https://gitlab.com/dokos/dodock/-/merge_requests/135){rel="&#x22;nofollow&#x22;"}
- Nouvelle méthode `safe_block_eval` pour pouvoir évaluer des blocs de plusieurs lignes de code. :br
  👉 [Dodock](https://gitlab.com/dokos/dodock/-/merge_requests/135){rel="&#x22;nofollow&#x22;"}


# V3.32.0

::callout
La version 3.32.0 de Dodock est basée sur la version 14 de Frappe :br
Une grande partie des changements cités ci-dessous ont été développés par l'équipe de Frappe Technologies et les contributeurs aux logiciels de l'éco-système Frappe/ERPNext :br
Le détail des changements publiés dans Dodock est disponible sur [Gitlab](https://gitlab.com/dokos/dodock/-/releases/v3.32.0){rel=""nofollow""}
::

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Cette page n'indique que les nouvelles fonctionnalités les plus importantes pour chaque module.
::

### Formulaires web

- Il est désormais possible d'obtenir des réponses anonymes via un formulaire web. :br
  👉 [Frappe](https://github.com/frappe/frappe/pull/20798){rel="&#x22;nofollow&#x22;"}

### Navigation

- Les onglets de formulaire disposent désormais de leur propre URL :br
  👉 [Dodock](https://gitlab.com/dokos/dodock/-/merge_requests/140){rel="&#x22;nofollow&#x22;"}

### Espaces de travail

- Vous pouvez désormais ajouter un raccourci vers un lien externe. :br
  👉 [Frappe](https://github.com/frappe/frappe/pull/20769){rel="&#x22;nofollow&#x22;"}

### Vue Liste

- Les documents non enregistrés sont désormais mis en évidence dans la vue **Liste**.
- L'icône indiquant le nombre de commentaires est grisée s'il n'y a aucun commentaire dans le document. :br
  👉 [Dodock](https://gitlab.com/dokos/dodock/-/merge_requests/141){rel="&#x22;nofollow&#x22;"}

### Traductions

- Le contexte *Workspace* a été ajouté aux titres et aux liens de la barre latérale des espaces de travail pour améliorer leur traduction


# V3.33.0

::callout
La version 3.33.0 de Dodock est basée sur la version 14 de Frappe :br
Une grande partie des changements cités ci-dessous ont été développés par l'équipe de Frappe Technologies et les contributeurs aux logiciels de l'éco-système Frappe/ERPNext :br
Le détail des changements publiés dans Dodock est disponible sur [Gitlab](https://gitlab.com/dokos/dodock/-/releases/v3.33.0){rel=""nofollow""}
::

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Cette page n'indique que les nouvelles fonctionnalités les plus importantes pour chaque module.
::

### Adresses

- Ajout d'une méthode `get_address_display` permettant de récupérer le contenu formaté d'une adresse :br
  👉 [Frappe](https://github.com/frappe/frappe/pull/20900){rel="&#x22;nofollow&#x22;"}

### Patchs

- Les journaux de patchs contiennent désormais le détail des erreurs ayant eu lieu lors de la migration :br
  👉 [Frappe](https://github.com/frappe/frappe/pull/20931){rel="&#x22;nofollow&#x22;"}

### Impression en masse

- Suppression des en-têtes de lettres désactivées de la liste des en-têtes proposés lors d'une impression en masse
- L'en-tête de lettre par défaut et le format d'impression par défaut sont désormais automatiquement sélectionnés :br
  👉 [Frappe](https://github.com/frappe/frappe/pull/20853){rel="&#x22;nofollow&#x22;"}

### Performance

- Amélioration de la performance lors du téléchargement d'un fichier privé :br
  👉 [Frappe](https://github.com/frappe/frappe/pull/20856){rel="&#x22;nofollow&#x22;"}


# V3.34.0

::callout
La version 3.34.0 de Dodock est basée sur la version 14 de Frappe :br
Une grande partie des changements cités ci-dessous ont été développés par l'équipe de Frappe Technologies et les contributeurs aux logiciels de l'éco-système Frappe/ERPNext :br
Le détail des changements publiés dans Dodock est disponible sur [Gitlab](https://gitlab.com/dokos/dodock/-/releases/v3.34.0){rel=""nofollow""}
::

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Cette page n'indique que les nouvelles fonctionnalités les plus importantes pour chaque module.
::

### Mode lecture seule

- Lorsqu'un site est en mode *Lecture seule* une bannière affichée en haut de la page l'indique aux utilisateurs :br
  👉 [Dodock](https://gitlab.com/dokos/dodock/-/merge_requests/149){rel="&#x22;nofollow&#x22;"}

### Formulaire de configuration initiale

- Un indicateur de progression permet désormais de suivre l'avancée de la configuration lors de la première connexion au système :br
  👉 [Dodock](https://gitlab.com/dokos/dodock/-/merge_requests/150){rel="&#x22;nofollow&#x22;"}

### Scripts Python

- Il est désormais possible de mettre une limite de requêtes dans les scripts python
  👉 [Frappe](https://github.com/frappe/frappe/pull/20980){rel="&#x22;nofollow&#x22;"}

### Webhooks

- Amélioration du formulaire **Webhook**:br
  👉 [Frappe](https://github.com/frappe/frappe/pull/21061){rel="&#x22;nofollow&#x22;"}

### Formulaire d'envoi d'emails

- Ajout d'un bouton `Réinitialiser & Ajouter un modèle` dans le formulaire d'envoi d'emails :br
  👉 [Frappe](https://github.com/frappe/frappe/pull/21138){rel="&#x22;nofollow&#x22;"}

### Expérience Utilisateur

- Amélioration de la vue Calendrier sur le site web
- Amélioration des boutons de type "Radio"
  👉 [Dodock](https://gitlab.com/dokos/dodock/-/merge_requests/143){rel="&#x22;nofollow&#x22;"}

### Expérience Développeurs

- Un utilitaire `frappe.utils.is_desk` a été ajouté pour savoir si l'on se trouve sur le bureau ou le site web
  👉 [Dodock](https://gitlab.com/dokos/dodock/-/merge_requests/143){rel="&#x22;nofollow&#x22;"}
- Ajout de méthode `Round` et `Truncate` dans `frappe.qb`
  👉 [Frappe](https://github.com/frappe/frappe/pull/21127){rel="&#x22;nofollow&#x22;"}
- Ajout d'une méthode `db.get_column_type` pour PostgreSQL
  👉 [Frappe](https://github.com/frappe/frappe/pull/21125){rel="&#x22;nofollow&#x22;"}
- Ajout d'une option de formatage automatique des fichiers JSON dans pre-commit
- Mise à jour des version de `requests`, `chardet` et `dropbox`


# V3.35.0

::callout
La version 3.35.0 de Dodock est basée sur la version 14 de Frappe :br
Une grande partie des changements cités ci-dessous ont été développés par l'équipe de Frappe Technologies et les contributeurs aux logiciels de l'éco-système Frappe/ERPNext :br
Le détail des changements publiés dans Dodock est disponible sur [Gitlab](https://gitlab.com/dokos/dodock/-/releases/v3.35.0){rel=""nofollow""}
::

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Cette page n'indique que les nouvelles fonctionnalités les plus importantes pour chaque module.
::

### Scripts Python

- Il est désormais possible d'utiliser un format CRON pour définir la fréquence d'un script Python
  👉 [Frappe](https://github.com/frappe/frappe/pull/21142){rel="&#x22;nofollow&#x22;"}

### Développeurs

- Ajout du paramètre `escapechar` dans la methode `to_csv`
- Correction du formatage des champs `Joindre` et `Joindre une image`:br
  👉 [Frappe](https://github.com/frappe/frappe/pull/21206){rel="&#x22;nofollow&#x22;"}
- Il est désormais possible d'utiliser les versions mises en cache des documents via la méthode `get_mapped_doc`:br
  👉 [Frappe](https://github.com/frappe/frappe/pull/21186){rel="&#x22;nofollow&#x22;"}
- Les documents contenant des champs de type `Code` ont été corrigés pour que le code soit correctement validé et coloré. :br
  👉 [Dodock](https://gitlab.com/dokos/dodock/-/merge_requests/152){rel="&#x22;nofollow&#x22;"}


# V3.36.0

::callout
La version 3.36.0 de Dodock est basée sur la version 14 de Frappe :br
Une grande partie des changements cités ci-dessous ont été développés par l'équipe de Frappe Technologies et les contributeurs aux logiciels de l'éco-système Frappe/ERPNext :br
Le détail des changements publiés dans Dodock est disponible sur [Gitlab](https://gitlab.com/dokos/dodock/-/releases/v3.36.0){rel=""nofollow""}
::

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Cette page n'indique que les nouvelles fonctionnalités les plus importantes pour chaque module.
::

### Expérience Utilisateur

- Vous pouvez désormais naviguer directement vers un champ en le spécifiant dans l'URL :br
  👉 [Frappe](https://github.com/frappe/frappe/pull/21174){rel="&#x22;nofollow&#x22;"}

### Emails

- Il est désormais possible de configurer une connexion SMTP sans authentification depuis les variables d'environnement :br
  👉 [Frappe](https://github.com/frappe/frappe/pull/21274){rel="&#x22;nofollow&#x22;"}

### Geo-localisation

- Les champs de type `Geo-localisation` peuvent désormais être affichés en lecture seule :br
  👉 [Frappe](https://github.com/frappe/frappe/pull/16561){rel="&#x22;nofollow&#x22;"}

### Développeurs

- Montées de version de `cryptography` et `pyOpenSSL`


# V3.37.0

::callout
La version 3.37.0 de Dodock est basée sur la version 14 de Frappe :br
Une grande partie des changements cités ci-dessous ont été développés par l'équipe de Frappe Technologies et les contributeurs aux logiciels de l'éco-système Frappe/ERPNext :br
Le détail des changements publiés dans Dodock est disponible sur [Gitlab](https://gitlab.com/dokos/dodock/-/releases/v3.37.0){rel=""nofollow""}
::

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Cette page n'indique que les nouvelles fonctionnalités les plus importantes pour chaque module.
::

### Refonte des types de champs &#x2A;Float (nombre réel)*, &#x2A;Int (nombre entier)* et &#x2A;Currency (devise)*

- Meilleur formatage des valeurs et ajout d'un slider
- Ajout d'options de formatage low-code :br
  👉 [Dodock](https://gitlab.com/dokos/dodock/-/merge_requests/137){rel="&#x22;nofollow&#x22;"}

### Intégration avec Discord

- Il est désormais possible d'envoyer des notifications dans Discord via les URL de webhook entrant :br
  👉 [Dodock](https://gitlab.com/dokos/dodock/-/merge_requests/160){rel="&#x22;nofollow&#x22;"}

### Ligne de commande

- Ajout d'une nouvelle ligne de commande `migrate-translations` pour migrer facilement les traductions entre deux applications
  👉 [Frappe](https://github.com/frappe/frappe/pull/21362){rel="&#x22;nofollow&#x22;"}


# V3.3.0

::callout
La version 3.3.0 de Dodock est basée sur la version 14 de Frappe :br
Une grande partie des changements cités ci-dessous ont été développés par l'équipe de Frappe Technologies et les contributeurs aux logiciels de l'éco-système Frappe/ERPNext :br
Le détail des changements publiés dans Dodock est disponible sur [Gitlab](https://gitlab.com/dokos/dodock/-/releases/v3.3.0){rel=""nofollow""}
::

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Cette page n'indique que les nouvelles fonctionnalités les plus importantes pour chaque module.
::

### Vue Kanban

- Nouvelle option pour supprimer un tableau Kanban

### Rapports automatiques par email

- Nouvelle option permettant d'indiquer l'expéditeur

### Fil d'Ariane

- Nouvelle option permettant de créer un objet `frappe.breadcrumbs.workspace` pour définir des espaces de travail préférés pour certains types de documents

### Performance

- Amélioration du cache des métadonnées de document


# V3.4.0

::callout
La version 3.4.0 de Dodock est basée sur la version 14 de Frappe :br
Une grande partie des changements cités ci-dessous ont été développés par l'équipe de Frappe Technologies et les contributeurs aux logiciels de l'éco-système Frappe/ERPNext :br
Le détail des changements publiés dans Dodock est disponible sur [Gitlab](https://gitlab.com/dokos/dodock/-/releases/v3.4.0){rel=""nofollow""}
::

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Cette page n'indique que les nouvelles fonctionnalités les plus importantes pour chaque module.
::

### Monitoring de l'application

- Il est désormais possible de passer des options personnalisées dans `frappe.monitor`

### Performance

- Amélioration de la performance du planificateur en utilisant la date de dernière modification au lieu de la date de création


# V3.5.0

::callout
La version 3.5.0 de Dodock est basée sur la version 14 de Frappe :br
Une grande partie des changements cités ci-dessous ont été développés par l'équipe de Frappe Technologies et les contributeurs aux logiciels de l'éco-système Frappe/ERPNext :br
Le détail des changements publiés dans Dodock est disponible sur [Gitlab](https://gitlab.com/dokos/dodock/-/releases/v3.5.0){rel=""nofollow""}
::

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Cette page n'indique que les nouvelles fonctionnalités les plus importantes pour chaque module.
::

### Abonnements

- Ajout d'une bannière d'abonnement sur tous les sites pour permettre la mise en place de formule d'abonnements pour les sites hébérgés.


# V3.6.0

::callout
La version 3.6.0 de Dodock est basée sur la version 14 de Frappe :br
Une grande partie des changements cités ci-dessous ont été développés par l'équipe de Frappe Technologies et les contributeurs aux logiciels de l'éco-système Frappe/ERPNext :br
Le détail des changements publiés dans Dodock est disponible sur [Gitlab](https://gitlab.com/dokos/dodock/-/releases/v3.6.0){rel=""nofollow""}
::

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Cette page n'indique que les nouvelles fonctionnalités les plus importantes pour chaque module.
::

### Vue Liste

- Support de l'option de champs **Voir le titre au lieu du nom** dans la vue en liste

### Journaux de notification

- Support du nettoyage automatique des journaux de notification


# V3.7.0

::callout
La version 3.7.0 de Dodock est basée sur la version 14 de Frappe :br
Une grande partie des changements cités ci-dessous ont été développés par l'équipe de Frappe Technologies et les contributeurs aux logiciels de l'éco-système Frappe/ERPNext :br
Le détail des changements publiés dans Dodock est disponible sur [Gitlab](https://gitlab.com/dokos/dodock/-/releases/v3.7.0){rel=""nofollow""}
::

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Cette page n'indique que les nouvelles fonctionnalités les plus importantes pour chaque module.
::

### Vues de document

- Les vues de document sont désormais configurable dans le formulaire de type de document ou via des personnalisations

### Rapports

- Amélioration du nommage de document pour les PDF générés depuis un rapport
- Nouveau rapport **Utilisation de la base de données par table**
- Nouvelle option d'export sans modèle de données ni en-tête

### Mise en page de type de document

- Support de la synchronisatio de nouveaux champs dans une mise en page de type de document existante

### Recherche

- La recherche se fait désormais sur le titre traduit s'il est affiché

### Performance

- Amélioration du cache des traductions


# V3.8.0

::callout
La version 3.8.0 de Dodock est basée sur la version 14 de Frappe :br
Une grande partie des changements cités ci-dessous ont été développés par l'équipe de Frappe Technologies et les contributeurs aux logiciels de l'éco-système Frappe/ERPNext :br
Le détail des changements publiés dans Dodock est disponible sur [Gitlab](https://gitlab.com/dokos/dodock/-/releases/v3.8.0){rel=""nofollow""}
::

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Cette page n'indique que les nouvelles fonctionnalités les plus importantes pour chaque module.
::

### Mises à jour

- Nouveau mode de mise à jour pendant lequel le site reste accessible en lecture seule

### Découvertes des documents

- Support de découvertes de document (Form Tour) par langue
- Possibilité d'inclure un tour dans un fichier `*_tour.js`

### Nommage de documents

- Suppression de l'option de casse du titre (ne fonctionnait plus depuis de nombreuses versions)


# V3.9.0

::callout
La version 3.9.0 de Dodock est basée sur la version 14 de Frappe :br
Une grande partie des changements cités ci-dessous ont été développés par l'équipe de Frappe Technologies et les contributeurs aux logiciels de l'éco-système Frappe/ERPNext :br
Le détail des changements publiés dans Dodock est disponible sur [Gitlab](https://gitlab.com/dokos/dodock/-/releases/v3.9.0){rel=""nofollow""}
::

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Cette page n'indique que les nouvelles fonctionnalités les plus importantes pour chaque module.
::

### Espaces de travail

- Ajout du Suivi des jalons dans les espaces de travail


# V2.0.0

::callout
La version 2.0.0 de Dodock est basée sur la version 13 de Frappe
::

- 🚀 Nouveaux tableaux de bords pour chaque module
- 🚀 Nouveaux espaces de travail
- 🚁 Nouveau hook permettant de remplacer une classe de type de document (contrôleur) via une application personnalisée
- 🚁 Nouveau contrôle (composant UI) pour définir des durées
- 🚁 Fonctionnalité de flux d'événements permettant la synchronisation de deux instances Dodock
- 🚁 Dodock est désormais compatible avec Python 3.8 et Python 3.9


  - · Dodock ne sera plus compatible avec Python 3.6 dans une prochaine version mineure
- 🚁 Sélecteur de thème (CTRL + SHIFT + G)
- 🚁 Aide contextuelle dans certains documents (menu d'aide *Découvrir le document*)
- 🚁 Nouveau Hook pour définir un thème de site Web personnalisé
- 🚁 Toutes les méthodes de document appelées depuis le client doivent être mises en *whitelist*
- 🚁 Les scripts personnalisés ont été renommés en Script Client
- 🚁 Les scrips clients peuvent être étendus à la vue en liste
- 🚁 Les invités peuvent désormais avoir accès au bureau avec des autorisations limitées
- 🚁 Système amélioré pour sceller les documents qui ne doivent pas être supprimés

Et aussi...

- Dans les rapports, les colonnes cachées sont désormais exportées quand un utilisateur exporte un rapport en CSV ou XLSX
- Nouvelle fonctionnalité pour ajouter une page de garde au-dessus d'un format d'impression en PDF
- L'API `get_roles` est maintenant sur liste blanche (disponible via l'API client)
- Option pour configurer les en-têtes CORPS dans le fichier de configuration du serveur
- Option pour afficher les valeurs absolues dans les formats d'impression
- Case à cocher ajoutée dans certains doctypes pour afficher les valeurs absolues dans les formats d'impression
- Prise en charge ajoutée pour le format de date DD-Mon-YY dans l'outil d'importation de données
- Option d'effectuer une requête d'autorisation personnalisée via un script serveur
- Options pour ajouter des événements conditionnels dans la fonctionnalité Event Streaming
- L'API bench list-apps renvoie désormais toutes les applications installées sur tous les sites
- API qui valide un fichier de sauvegarde SQL avant de démarrer une restauration de site
- Ajout de filtres et de champs order\_by dans l'API frappe.get\_last\_doc
- Option sur les docfields pour éviter d'avoir des valeurs négatives dans les champs Int, Float et Currency
- les paramètres du calendrier est couvert par les paramètres de la vue Gantt
- Possibilité de créer une nouvelle vue de la grille de fichiers
- Nouvelle option de paramètre `as_list` dans l'API` frappe.msgprint`
- Nouveau paramètre `lang` dans l'API` format_date`, `format_datetime` et` format_date`
- Structure des fichiers SCSS refactorisée
- Compresser les fichiers privés et publics pendant la sauvegarde
- Ajouter des icônes pour salesforce et fairlogin
- Utiliser les icônes Social par défaut
- Ajouter des icônes pour les connexions sociales
- Définir les icônes de fournisseur par défaut
- Nouvelle option pour passer un paramètre `lang` (language) dans` global_date_format` pour renvoyer une date localisée
- Commande `bench execute` améliorée, elle permet d'exécuter tout ce que la console autoriserait
- Nouvelle fonction pour écrire des requêtes de console directement dans l'interface utilisateur au lieu d'avoir à utiliser l'interface de ligne de commande
- Bibliothèque de préfixeurs automatiques pour analyser le CSS
- Modifications majeures de l'API de recherche
- Technique pour résoudre les problèmes de connexion avec l'application mobile
- Dodock autorise désormais les mots de passe de plus de 140 caractères
- Informations sur le pays Congo
- Fonctionnalité pour afficher une boîte de dialogue plus grande pour l'API `frappe.msgprint` et` frappe.throw`
- Autoriser l'envoi d'e-mails via Server Script
- Nouvelle disposition de grille de formulaire
- Nouvelle API pour valider et nettoyer les entrées de recherche pour les requêtes
- Nouvelle API pour gérer les balises
- Nouvelle API `frappe.utils.time_diff_in_minutes`
- Nouveau paramètre dans le DocType du support de communication
- Nouvelle API pour récupérer les sauvegardes
- Nouvelle option pour actualiser tous les graphiques et cartes dans le tableau de bord
- Nouvelles images Docker sont créées automatiquement pour chaque version
- Avertissement émis lorsqu'une restauration de base de données est effectuée sur une ancienne version de Dodock
- Possibilité de sauvegarder et restaurer un site postgreSQL
- L'API Google Python a été mise à jour vers une version plus récente
- le fichier site\_config.json est maintenant inclus dans les sauvegardes
- Option pour ajouter `mute_notifications` dans site\_config.json pour désactiver les notifications envoyées depuis un site
- Nouvelle option pour envoyer le paramètre `no_backup` dans l'API` remove_app`
- Extensions 'md', 'json', 'js', 'xml' ajoutées dans la fonction de découverte de rendu des modèles Jinja
- Nouveau hook `override_whitelisted_methods` pour remplacer les fonctions 'open\_mapped\_docs'
- Mettre à niveau Datatable vers la v1.15.3
- Fonctionnalité pour ajouter filepreview pour attacher le contrôle
- Ajouter la vérification hmac du webhook
- Les logs sont désormais enregistrés pour chaque site indépendamment sur le serveur
- Possibilité d'exécuter la commande de construction pour chaque application indépendamment
- Possibilité de désactiver les commentaires sur le site
- Possibilité d'ajuster l'intervalle minimum du programmateur (60 secondes par défaut jusqu'à présent)
- Fonctionnalité de surveillance intégrée
- Exigences LDAP3 ajoutées
- Les mots de passe LDAP peuvent désormais être réinitialisés à partir des paramètres utilisateur
- L'authentification à 2 facteurs peut désormais être activée pour les utilisateurs LDAP
- Nouveaux paramètres système pour déconnecter l'utilisateur lors du changement de mot de passe
- Les e-mails peuvent maintenant être ajoutés à n'importe quel doctype sans avoir besoin de configurer un hook
- Les scripts de serveur peuvent désormais être planifiés pour une exécution ultérieure
- Les icônes du classement sont déjà écrites dans Dodock
- Cartes source pour les fichiers css / scss / less
- Fonctionnalité de limitation de débit intégrée
- Les données des applications installées sont désormais stockées dans un seul DocType
- Nouvelle fonctionnalité pour créer des doctypes virtuels
- Fonctionnalité pour l'importation paresseuse de modules python
- Système d'étanchéité refactorisé
- Provision pour reconstruire l'ensemble imbriqué à partir de l'arborescence
- Masquer les enregistrements enfants pour un DocType imbriqué via les autorisations utilisateur
- Utilise pour obtenir la date et l'heure dans un fuseau horaire spécifique
- `frappe.bold` a été ajouté aux globaux sécurisés de scripts serveur
- Nouvel événement `before_validate` dans les scripts serveur
- Nouveau `before_commit` ajouté dans les transactions de base de données
- Ajouter des valeurs par défaut globales aux paramètres
- Option d'afficher l'heure de l'événement et la fin de l'événement dans une vue de calendrier, via une vue de calendrier personnalisée
- Option d'afficher l'heure de l'événement et la fin de l'événement dans une vue de calendrier, via une vue de calendrier personnalisée
- Option de rendre les fichiers publics disponibles sur le portail de l'événement
- Améliorations de la vue du calendrier
- Autoriser le HTML dans les modèles d'e-mails
- Nouveau bouton dans "Personnaliser le formulaire" pour personnaliser rapidement une table enfant
- Nouvelle option dans les paramètres système pour supprimer les données EXIF dans le fichier d'images avant de les télécharger sur le serveur
- Traduire le titre du tableau Kanboard
- Possibilité d'ajouter un message personnalisé pendant les chargements via l'API open\_mapped\_doc
- Portail pour permettre aux utilisateurs de s'inscrire à un événement
- Nouvelle API Autoriser le saut ou la sauvegarde uniquement de DocTypes spécifiques pendant les sauvegardes
- Nouvelle position pour le bouton de défilement vers le haut
- Nouvelle règle de fil d'Ariane pour la page d'impression: les utilisateurs peuvent désormais revenir au document à l'aide de ces nouveaux fil d'Ariane
- Nouvelle option pour ajouter des liens et des actions à un formulaire directement dans la vue de formulaire personnalisée
- Style de création formel d'impression amélioré
- Les aperçus d'impression de formulaires sont désormais affichés dans un itinéraire séparé
- Nouvelle API pour réinitialiser une section d'intégration de module
- Option pour créer une règle d'attribution basée sur la valeur d'un champ
- Option pour mettre le symbole de devise à gauche ou à droite de la valeur de la devise. Le format de valeur «En mots» a également été amélioré.
- Nouveau doctype pour modifier les paramètres de plusieurs documents journaux
- Nouveau `frappe.utils.make_chart` pour créer un graphique avec des arguments
- Icône mise à jour pour les intégrations de médias sociaux
- Style amélioré pour la fonctionnalité de visite de formulaire
- Styles améliorés pour les cartes d'intégration
- Nouvelles icônes dans la barre latérale de la page Classement
- Nouvelle logique de routage pour les étapes d'intégration
- Nouvelle API `frappe.Plyr` pour afficher des vidéos intégrées
- Possibilité d'ajouter des vidéos intégrées dans les cartes d'intégration
- Nouvelles paires de couleurs ajoutées aux variables de couleurs standard pour les thèmes clairs et foncés
- Fonctionnalité améliorée du gestionnaire d'autorisations de rôle
- Le titre de l'événement est maintenant affiché dans les info-bulles dans les événements du calendrier
- Choisir d'ajouter une classe CSS personnalisée lors de la création d'un groupe de widgets
- Nouvelle règle d'affectation: possibilité de définir une date d'échéance personnalisée pour les affectations
- Ajouter Gantt Rebranded Styles
- Page des travaux d'arrière-plan améliorés: ajouter un état vide pour les travaux d'arrière-plan
- Refactoriser les tâches d'arrière-plan
- Structure améliorée de la page "Télécharger des sauvegardes"
- Nouveau composant d'interface utilisateur de sélecteur de couleurs
- Nouveau bouton pour appliquer des filtres dans le composant UI Filtres
- Nouvelle icône de chevron pour ouvrir / fermer un chevron de section pour les formulaires
- Améliorations de la page de connexion
- Ajouter un espacement après la tête de section de formulaire
- Règle de nommage des documents
- Icônes pour "l'état vide" pour les grilles et les bordures
- La barre latérale est maintenant masquée lors de l'affichage de la vue Kanban
- Afficher l'alerte de changement de thème pendant 3 secondes seulement
- Ajouter des filtres à la vue du calendrier
- Inverser les couleurs de l'avatar en mode couleur sombre
- Utilisateur: ajouter une limite horaire pour les demandes de réinitialisation de mot de passe
- Mettre à jour la vue de l'image
- Utiliser une petite icône dans l'action de groupe d'avatar
- Possibilité de passer un paramètre `icon` dans la fonction` get_icon_label` de l'API de la page
- Une icône a été ajoutée dans le bouton `Changer d'utilisateur` de la page de profil utilisateur
- Une classe `hover-active` a été ajoutée sur les nœuds parents dans l'arborescence pour afficher le nœud dans une couleur différente lorsqu'il est survolé
- Possibilité d'ajouter une icône pour chaque carte de bureau
- Nouveau bouton `Personnaliser` ajouté sur les espaces de travail pour permettre aux utilisateurs finaux de personnaliser chaque espace de travail
- Mettre à jour l'arrière-plan de l'état de mise au point de awesomebar
- Mettre à jour le poids du titre de la carte Kanban
- Possibilité d'afficher plusieurs racines dans l'arborescence
- Nouvelle option pour envoyer une notification à tous les destinataires d'un document
- Supprimer le champ d'état inutilisé des contacts
- Réduire le rayon de la bordure de l'élément déroulant
- Nouvelle présentation des statistiques utilisateur dans la barre latérale
- Mettre à jour l'avatar et la mise en page de la barre latérale
- Supprimer les anciennes icônes
- Ajouter des icônes pour le profil utilisateur
- Regrouper les articles similaires comme ceux-ci ensemble
- Mettre à jour l'espacement des éléments de la liste déroulante
- Mettre à jour le titre Kanban
- Mettre à jour le nouveau bouton d'affectation pour le kanban
- Mettre à jour le style d'avatar
- Chevaucher l'avatar dans le partage de la barre latérale du formulaire
- Icônes ajoutées dans la liste déroulante de sélection de vue (en vue de liste)
- Autoriser l'icône dans la liste déroulante
- Ajouter une nouvelle icône de petit fichier
- Ajouter une icône de tableau de bord
- Panneau de notification amélioré dans la barre de navigation: supprimez l'animation des diapositives sur les notifications
- Ajouter des états nuls à la notification et aux événements
- Fonctionnalité permettant d'autoriser différents noms de champ pour définir une récurrence de calendrier
- Ajuster la taille de la police pour les cases à cocher
- Masquer le libellé du bouton principal dans le mobile si l'icône est présente
- Afficher uniquement le bouton de création pour l'état nul dans le mobile
- Texte désactivé pour les éléments d'action dans le message de la chronologie
- Amélioration du style pour l'icône de fermeture: icône de remplacement fermer le remplissage globalement
- Nouvelle option pour désactiver le script personnalisé
- Lien pour envoyer un e-mail à un document ajouté dans la chronologie
- La chronologie sera mise à jour en temps réel chaque fois que docinfo sera mis à jour
- Fonctionnalité pour définir un champ de date flexible dans la récurrence du calendrier
- Nouveaux correctifs et fonctionnalités de l'interface utilisateur
- Nouvelle API get\_link\_to\_doctype en contact
- Script serveur: autoriser frappe.db.sql pour la lecture
- Autoriser get\_print et attacher l'impression dans les scripts du serveur
- Controls / text\_editor: redimensionner l'image pour l'éditeur de démarques
- Fonctionnalité pour ajouter des fonctionnalités et des filtres dans les rapports via le Report DocType
- Rapport préparé: paramètre système pour supprimer automatiquement les anciens rapports préparés
- Restauration en bloc de documents dans la vue Liste des documents supprimés
- Fonction permettant de définir les doctypes liés à ignorer lors de l'annulation d'un document
- Chaîne SMS ajoutée mais chaîne Whatsapp supprimée sincèrement
- Rapport: possibilité d'afficher le numéro d'index des lignes de la table enfant
- Fonction pour ajouter des informations sur la version du document et partager des informations sur la nouvelle chronologie du document
- Améliorations de la répétition automatique
- La barre de navigation peut maintenant être configurée via un DocType: Paramètres de la barre de navigation
- Nouvelle API dans le doctype d'événement: ajoutez des méthodes de contrôleur pour ajouter des participants à l'événement
- Nouvelle chronologie et aperçu avant impression
- Possibilité de masquer les modules en fonction du domaine sélectionné
- Nouvelle chronologie dans doctypes
- Possibilité de créer des cartes statistiquees
- Les tableaux de bord peuvent être synchronisés à partir de fichiers JSON dans une application personnalisée
- Fullcalendar library mise à jour vers la v5
- Frappe Charts mis à jour vers la v2
- Sélecteur de plage de dates dans le classement
- Nouveau hook: `additional_timeline_content`
- Autorisation de rôle: si l'accès au bureau est supprimé d'un rôle, essayez de le supprimer également des utilisateurs
- Le site n'envoie pas de notification si une communication est créée à partir d'un e-mail
- Un nouveau bouton est disponible dans le menu de chaque doctype si une visite est disponible
- Afficher les utilisateurs qui rédigent actuellement un e-mail sur un formulaire
- Le champ personnalisé créé par l'administrateur ne peut être supprimé que par l'administrateur
- Nouvelle fonctionnalité pour tester une notification lors de la créer
- Afficher l'icône du téléphone si le gestionnaire d'appels téléphoniques est disponible
- Définir le temps de réponse moyen dans la documentation parent d'une communication
- Afficher un avertissement si les documents ont des états de flux de travail qui n'existent pas dans le flux de travail
- La vue de liste peut maintenant être configurée depuis le menu> Paramètres de la vue de liste
- API de résumé de rapport: affiche les métriques les plus importantes pour chaque rapport au-dessus du graphique
- Nouveaux tableaux de bord refactorisés
- Possibilité de minimiser les popups de message
- API pour indiquer l'orientation du PDF
- Les e-mails et les numéros de téléphone peuvent désormais être validés automatiquement pour les champs de données si Email ou Téléphone sont ajoutés comme options
- Nouvelle vue du calendrier pour ToDo
- Les documents ne sont plus enregistrés s'il n'y a pas eu de mise à jour
- Nouvel attribut de colonne de rapport disable\_total
- Définir le site par défaut à l'aide de FRAPPE\_SITE environnement variable
- Les fenêtres contextuelles de prévisualisation peuvent maintenant être configurées à partir de "Personnaliser le formulaire"
- Les champs de code sont maintenant développés / réduits
- La boîte de dialogue des e-mails peut maintenant être réduite
- Intégration par module
- Nouvelle vue du calendrier dans les notifications
- Possibilité de créer des espaces de travail personnalisés
- Boîte de dialogue de sélection multiple repensée
- Possibilité de filtrer pour importer des e-mails dans des groupes de messagerie
- La règle de nom automatique définit la personnalisation peut être définie dans le formulaire Personnaliser
- Ajouter une option pour effectuer des affectations via la boîte de dialogue d'affectation
- Afficher les images en Kanban
- Espace réservé pour les champs Select
- Améliorations des newsletters
- Remplacez localStorage par localforage pour stocker les brouillons
- Renommez «Script personnalisé» en «Script client»
- Ajouter copy\_doc aux globals safe\_exec
- Nouveau hook pour le CSS personnalisé dans d'autres applications
- Possibilité de joindre une photo de la webcam
- Possibilité de définir la page de bureau par défaut
- Fonctionnalité pour créer et attribuer des profils de module
- Ajouter une icône au bouton d'action de la chronologie
- La signature du compte de messagerie est maintenant récupérée dans le email de dialogue
- Les avatars sont ajoutés dans l'e-mail du journal des points d'énergie pour les meilleurs
- Style d'e-mail amélioré: ajoutez l'argument with\_container et mettez à jour le style d'e-mail
- Mettre à jour le modèle d'e-mail standard pour correspondre au nouveau style
- Fonction de mise à jour automatique des groupes de messagerie
- Nouvel espace de travail "Build"
- Modification de l'API pour afficher ou masquer le popup d'alerte d'autorisation
- Nouvelle autorisation "Sélectionner" permettant uniquement de sélectionner un document sans le lire
- Possibilité de cliquer sur breadcrumb pour copier le nom du document
- Les fichiers config.py ont été supprimés au profit du nouveau Workspace DocType
- La page de bureau a été renommée en espace de travail
- Nouveau sélecteur de thème et ajouter un sélecteur de thème à la barre de navigation
- Le nom du document est désormais disponible dans le fil d'Ariane
- La condition de transition de flux de travail autorise les fonctions datetime
- Un accès au desk peut être donné aux clients
- Nouvelle fonctionnalité pour basculer la barre latérale dans les listes et les documents
- Nouveau sélecteur de thème
- Popup Attribuer à affiche désormais les images utilisateur
- La pilule de données peut maintenant avoir des images
- L'échantillon de sélection de couleur peut être sélectionné via le clavier
- Un bouton permet d'afficher / masquer les éléments liés à l'activité dans la chronologie
- Nouveau système de routage avec des URL plus jolies
- Nouveau système de routage avec des URL plus jolies
- A desk access can now be given to guests


# V2.10.0

::callout
La version 2.10 de Dodock est basée sur la version 13 de Frappe :br
Le détail des changements publiés dans Dodock est disponible sur [Gitlab](https://gitlab.com/dokos/dodock/-/releases){rel=""nofollow""}
::

## Graphiques

- 🚀 Ajout d'une option permettant de grouper des documents par personne assignée dans les graphiques de tableau de bord


# V2.11.0

::callout
La version 2.11 de Dodock est basée sur la version 13 de Frappe
Le détail des changements publiés dans Dodock est disponible sur [Gitlab](https://gitlab.com/dokos/dodock/-/releases){rel=""nofollow""}
::

## Contacts

- 🚀 Configuration d'une règle d'autorisation de site web `has_website_permissions` par défaut pour les contacts. L'utilisateur peut avoir accès au contenu d'une fiche contact si son utilisateur est lié à ce contact

## Framework

- 🚀 Ajout de l'API `frappe.db.commit` dans les scripts python
- 🚀 Les notes de version peuvent désormais être différentes en fonction de la langue de l'utilisateur. Il suffit pour cela de créer un sous-dossier `fr` par exemple.
- 🚁 La langue d'impression définie dans le document à imprimer (champ `language`) prime désormais sur la langue d'impression par défaut du format d'impression


# V2.13.0

::callout
La version 2.13 de Dodock est basée sur la version 13 de Frappe :br
Le détail des changements publiés dans Dodock est disponible sur [Gitlab](https://gitlab.com/dokos/dodock/-/releases){rel=""nofollow""}
::

## Dodock

- 🚀 Ajout d'un nouvel opérateur dans les filtres: `égal ou descendant de`


# V2.14.0

::callout
La version 2.14 de Dodock est basée sur la version 13 de Frappe :br
Le détail des changements publiés dans Dodock est disponible sur [Gitlab](https://gitlab.com/dokos/dodock/-/releases){rel=""nofollow""}
::

## Notifications

- 🚀 Il est désormais possible d'utiliser les fonctions `frappe.db.get_value` et `frappe.get_list` dans les conditions des notifications.

## Site web

- 🚀 Nouveau bloc web disponible: Hero avec image d'arrière plan


# V2.15.0

::callout
La version 2.15 de Dodock est basée sur la version 13 de Frappe :br
Le détail des changements publiés dans Dodock est disponible sur [Gitlab](https://gitlab.com/dokos/dodock/-/releases){rel=""nofollow""}
::

## Panier

- 🚀 Lorsque le client n'a pas d'adresse enregistré, un popup s'ouvre désormais automatiquement au moment du passage de la commande au lieu d'un message d'erreur.


# V2.16.0

::callout
La version 2.16 de Dodock est basée sur la version 13 de Frappe
Le détail des changements publiés dans Dodock est disponible sur [Gitlab](https://gitlab.com/dokos/dodock/-/releases){rel=""nofollow""}
::

## Comptabilité

- 🚀 Ajout d'un champ **Numéro d'écriture comptable** dans les écritures de grand livre. Ce numéro est partagé avec toutes les écritures de grand livre liées au même document de référence et remplace l'identifiant de l'écriture de grand livre dans le FEC.


# V2.1.0

::callout
La version 2.1 de Dodock est basée sur la version 13 de Frappe
::

- 🚀 Possibilité de partager un document et de donner des droits de soumission
- 🚀 Possibilité de créer des types d'utilisateurs personnalisés
- 🚀 Possibilité de créer un site Web en plusieurs langues et de montrer un sélecteur de langue aux utilisateurs
- 🚀 Possibilité de mentionner un groupe d'utilisateurs dans les commentaires de formulaire
- 🚀 Possibilité d'enregistrer des données personnalisées dans le champ JSON pour les rapports de requête et les rapports personnalisés
- 🚁 Mise à jour des dépendances pour Python3
- 🚁 Fonction permettant de copier une configuration doctype sur deux sites
- 🚁 Nouveau style standard pour les barres de défilement
- 🚁 Toutes les dépendances python ont été mises à jour
- 🚁 Nouvelle fonctionnalité de saisie semi-automatique dans les scripts serveur
- 🚁 Nouveau hook pour autoriser les codes d'autorisation personnalisés
- 🚁 Nouvelle API pour définir différentes tailles de boutons pour les boutons de formulaires
- 🚁 SourceURL n'est pas disponible dans la console pour les scripts client injectés
- 🚁 Nouvelle fonctionnalité de changer de thème avec les touches gauche / droite
- 🚁 Nouvel exploit pour ajouter des étapes de suppression dans l'outil de suppression de données
- 🚁 Option pour formater la liste des applications pour un site donné dans l'utilitaire de ligne de commande
- 🚁 Ajouter une option de type de champ de mot de passe pour Web Form
- 🚁 Nouvelle URL d'option pour le type de champ de données
- 🚁 Ajouter \_ repr \_ simple pour les DocTypes
- 🚁 Ajouter la commande run-parallel-tests pour exécuter des tests d'application en parallèle


# V2.2.0

::callout
La version 2.2 de Dodock est basée sur la version 13 de Frappe
::

🚀 Possibilité d'envoyer des notifications via les outils collaboratifs suivants:

- Google Chat
- Mattermost
- Rocket.Chat


# V2.3.0

::callout
La version 2.3 de Dodock est basée sur la version 13 de Frappe :br
Le détail des changements publiés dans Dodock est disponible sur [Gitlab](https://gitlab.com/dokos/dodock/-/releases){rel=""nofollow""}
::

- 🚀 Nouvelle vue en liste pour les événements du portail


# V2.4.0

::callout
La version 2.4 de Dodock est basée sur la version 13 de Frappe :br
Le détail des changements publiés dans Dodock est disponible sur [Gitlab](https://gitlab.com/dokos/dodock/-/releases){rel=""nofollow""}
::

- 🚀 Le sujet n'est désormais plus un champ obligatoire dans les modèles d'email
- 🚀 Un indicateur de couleur bleu s'affiche dans la vue en liste à la réception d'un email associé avec un document


# V2.5.0

::callout
La version 2.5 de Dodock est basée sur la version 13 de Frappe :br
Le détail des changements publiés dans Dodock est disponible sur [Gitlab](https://gitlab.com/dokos/dodock/-/releases){rel=""nofollow""}
::

## Portail

- 🚀 Nouveau *Modèle de bloc web* permettant de créer un trombinoscope sur le portail ou le site web


# V2.6.0

::callout
La version 2.6 de Dodock est basée sur la version 13 de Frappe :br
Le détail des changements publiés dans Dodock est disponible sur [Gitlab](https://gitlab.com/dokos/dodock/-/releases){rel=""nofollow""}
::

## Portail

- 🚀 Tous les champs proposés dans le modèle de bloc web *Trombinoscope* sont désormais optionnels


# V2.7.0

::callout
La version 2.7 de Dodock est basée sur la version 13 de Frappe :br
Le détail des changements publiés dans Dodock est disponible sur [Gitlab](https://gitlab.com/dokos/dodock/-/releases){rel=""nofollow""}
::

## Framework

- 🚀 Il est désormais possible de cacher les secondes dans les champs de type **Durée**
- 🚀 Les types de documents dont les noms doivent être traduits dans l'interface (DocType, Pays, etc...) sont désormais configurables via les hooks


# V2.8.0

::callout
La version 2.8 de Dodock est basée sur la version 13 de Frappe
Le détail des changements publiés dans Dodock est disponible sur [Gitlab](https://gitlab.com/dokos/dodock/-/releases){rel=""nofollow""}
::

- 🚀 Il est désormais possible de passer des paramètres dans la page `/message` pour afficher un titre et un corps de message. Ex. `/message?title=Hello&message=World`


# V2.9.0

::callout
La version 2.9 de Dodock est basée sur la version 13 de Frappe :br
Le détail des changements publiés dans Dodock est disponible sur [Gitlab](https://gitlab.com/dokos/dodock/-/releases){rel=""nofollow""}
::

- 🚀 Nouvelle option dans les paramètres système pour modifier la date/heure d'un document lors de l'envoi d'un email


# V1.0.0

🎉 Lire [l'article de blog](https://dokos.io/blog/dokos-nouvel-erp-open-source){rel="&#x22;nofollow&#x22;"} 🎉

La v1.0.0 de dokos est basée sur Frappe v12.x.x
Vous trouverez ci-dessous les principales différences avec Frappe.

- L'interface utilisateur a été améliorée avec quelques changements majeurs:

  - Le bureau est désormais un grand tableau de bord sur lequel vous pouvez attacher trois types d'éléments: calendriers, graphiques et cartes


    1. Les calendriers récupèrent les événements de tous les types de document avec une "vue calendrier"
    2. Les graphiques peuvent être créé dans le type de document "Graphique du tableau de bord" sur la base n'importe quel type de document ou via des scripts personnalisés dans une application personnalisée
    3. Les cartes peuvent être créées dans le type de document "Carte du tableau de bord" sur la base de n'importe quel type de document ou via des scripts personnalisés dans une application personnalisée
  - Les modules sont désormais accessibles via une barre latérale
  - Les détails des modules (types de documents/pages/rapports) peuvent être trouvés en cliquant sur le module correspondant dans la barre latérale
  - Chaque module peut disposer de son propre tableau de bord
  - L'interface utilisateur est désormais en plein écran par défaut
  - Le bureau est également moins accessible sur mobiles pour le moment. Le décision actuelle est de l'optimiser pour les tablettes et les écrans d'ordinateur.
- Les documents peuvent désormais être nommés définitivement après validation. (Utile pour les factures par exemple. Voir ci-dessus)
- Les types de document peuvent être scellés désormais:

  - Ils sont intégrés dans une chaîne cryptée, garantissant ainsi qu'ils ne puissent pas être supprimés du système sans trace.
  - Cela replace le type de document "Transaction Log"
- Les impressions de documents peuvent être suivies désormais: l'horodatage de la première impression est enregistré dans la base de données et toutes les impressions suivantes peuvent être marquées comme étant des duplicata.
- Le système de traduction a été refondu:

  - Les traductions sont désormais spécifiques d'un fichier, réduisant ainsi le risque de colision dans certaines langues.
  - Le format du fichier de traduction est désormais le JSON
- L'intégration Stripe est désormais disponible uniquement dans dokos
- Multiples améliorations de l'interface du portail


# V1.1.0

🎉 Lire [l'article de blog](https://dokos.io/blog/nouveautes-version-1-1){rel="&#x22;nofollow&#x22;"} 🎉

#### Fonctionnalités

- [Scripts en python](https://doc.dokos.io/v5/dodock/ressources/concepts/scripts-python)
- Centre de notification centralisé
- Vue en liste configurable
- Les emails non gérés de plus de 30 jours sont désormais supprimés toutes les nuits
- Possibilité d'ajouter des sauts de page dans les formats d'impression

#### Corrections de bug

- Correction du diagramme d'activité
- L'email de création d'un utilisateur depuis un contact était envoyé en double
- Problèmes de performance du bureau à cause d'une désactivation de cache
- Problèmes de formatage des devises
- Suppression automatique des caractères spéciaux lors de la création des liens de site web
- Possibilité de définir la largeur des colonnes en % dans les formats d'impression

#### Modifications

- Suppression du hook `jenv`

## Intégrations

🎉 Nouvelle application [Zapier](https://zapier.com){rel="&#x22;nofollow&#x22;"} disponible en version beta. :br
Envoyez-nous un email à <hello@dokos.io> pour être invité.


# V1.2.0

🎉 Lire [l'article de blog](https://dokos.io/blog/nouveautes-version-1-2){rel="&#x22;nofollow&#x22;"} 🎉

#### Fonctionnalités

- Possibilité de désactiver la création automatique des contacts depuis les emails reçus
- Refonte du calendrier (FullCalendar v4)
- Nouveau système de récurrence pour le type de document Evénement (RRULE - RFC5545)
- Les participants aux événements limités au type de document "Contact"
- Possibilité de lier l'intégration Google Agenda avec d'autres types de documents (pas seulement Evénement)
- Possibilité de "grouper" dans les graphiques du tableau de bord
- Le planificateur est désormais automatiquement activé s'il est désactivé lors d'une connexion
- Le panneau ouvert par défaut sur le centre de notification est désormais "Documents ouverts"

#### Corrections de bug

- Corrections dans les répétitions automatiques
- Amélioration du chat
- Sur le portail les utilisateurs peuvent désormais voir uniquement les adresses qu'ils ont créé
- Améliorations de l'outil d'import de données
- Les rapports préparés sont désormais des fichiers privés
- Amélioration du contrôleur de code barre
- Navigation au clavier améliorée dans les lignes de tableaux


# V1.3.0

🎉 Lire [l'article de blog](https://dokos.io/blog/nouveautes-version-1-3){rel="&#x22;nofollow&#x22;"} 🎉

#### Fonctionnalités

- Nouvelle API de commande Razorpay
- Mise à jour de Font Awesome vers la v5
- Addition de Unicons
- Nouvelles icônes dans les panneaux latéraux de listes et formulaires
- Suppression complète des tests Selenium
- Nouvelle option pour créer une section sans ligne inférieure dans les types de document
- Les formats d'impression et les notifications standard peuvent désormais être désactivés
- L'icône en haut à gauche du bureau peut désormais être personnalisée dans les paramètres système
- Possibilité d'utiliser les hooks "avant enregistrement" et "après enregistrement" dans les scripts python
- Possibilité d'autoriser la création d'une écriture rapide pour un type de document dans les personnalisations de document
- Possibilité de définir des méthodes Jinja personnalisées grâce au hook `jenv`
- Les emails peuvent désormais être envoyés via SSL
- Possibilité de définir un schéma de base de donnée personnalisé dans site\_config
- Messages améliorés lors de la fusion de documents
- Lors de l'annulation d'un document, tous les documents liés sont affichés dans un popup et il est possible de les annuler d'un simple click
- Nouveau hook `auto_cancel_exempted_doctypes` pour gérer les exceptions liés à l'annulation en masse par simple click
- Possibilité de se connecter avec [Fairlogin](https://www.fairkom.eu/en/fairlogin){rel="&#x22;nofollow&#x22;"} via la méthode `login_via_fairlogin`
- En-têtes de sécurité dans les webhooks
- Possibilité de créer plusieurs webhooks pour un type de document et un événement
- Possibilié de ne pas afficher les secondes dans le sélecteur de dates
- Les champs obligatoires et en lecture seule peuvent être rendus dépendant d'autres champs dans le formulaire de personnalisation
- La configuration Google peut être ajoutée dans le fichier site\_config
- Mise à jour de Muuri grid vers la v0.8
- Le pop up de mise à jour n'est désormais affiché qu'aux responsables système

#### Corrections de bugs majeurs

- Les emails sont désormais en conformité avec la RFC5322 (Python 3)


# V1.4.0

🎉 Lire [l'article de blog](https://dokos.io/blog/nouveautes-version-1-4){rel="&#x22;nofollow&#x22;"} 🎉

#### Nouvelles fonctionnalités

- Une nouvelle vue "Carte" est disponible lorsque la connexion avec Google Maps est activée
- A chaque fois qu'un document est renommé, l'information est conservée à des fins d'audit

#### Corrections de bugs majeurs

- Corrections dans l'éditeur d'email
- Correction dans l'éditeur Jinja graphique du module de modèles d'emails


# Applications et compatibilité

## Compatibilité entre l'écosystème Frappe et Dokos

Le framework Dodock, et Frappe sur lequel il est basé, ont permis la construction d'un écosystème d'application qui s'enrichit régulièrement.\:br
Cet écosystème est constitué de plusieurs applications, développées par l'équipe de Frappe Technologies et par l'équipe Dokos.\:br
Les applications compatibles avec Dodock peuvent être installées sur votre site.\:br
Si vous êtes hébergés sur le cloud Dokos, veuillez nous contacter via le portail de support pour demander leur installation.

## Application construites sur Dodock

Les applications listées ci-dessous sont compatibles avec Dodock, l'adaptation de Frappe maintenue par l'équipe Dokos.

| Application                                                                                 | Documentation                                                                                    | Application correspondante dans le Frappeverse                             |
| ------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------- |
| [Payments](https://gitlab.com/dokos/payments){rel="&#x22;nofollow&#x22;"}                   | <https://doc.dokos.io>{rel="&#x22;nofollow&#x22;"}                                               | [Payments](https://github.com/frappe/payments){rel="&#x22;nofollow&#x22;"} |
| [Dokos](https://gitlab.com/dokos/dokos){rel="&#x22;nofollow&#x22;"}                         | <https://doc.dokos.io>{rel="&#x22;nofollow&#x22;"}                                               | [ERPNext](https://github.com/frappe/erpnext){rel="&#x22;nofollow&#x22;"}   |
| [HRMS](https://gitlab.com/dokos/hrms){rel="&#x22;nofollow&#x22;"}                           | <https://doc.dokos.io>{rel="&#x22;nofollow&#x22;"}                                               | [Frappe HR](https://github.com/frappe/hrms){rel="&#x22;nofollow&#x22;"}    |
| [Venues Federation](https://gitlab.com/dokos/venues-federation){rel="&#x22;nofollow&#x22;"} | <https://doc.dokos.io/federation-lieux/federation-de-lieux/annuaire>{rel="&#x22;nofollow&#x22;"} |                                                                            |
| [Federated Venue](https://gitlab.com/dokos/federated-venue){rel="&#x22;nofollow&#x22;"}     | <https://doc.dokos.io/federation-lieux/lieux/application-dokos>{rel="&#x22;nofollow&#x22;"}      |                                                                            |
| [eSignature](https://gitlab.com/dokos/esignature){rel="&#x22;nofollow&#x22;"}               | <https://doc.dokos.io/integrations/esignature>{rel="&#x22;nofollow&#x22;"}                       |                                                                            |
| [Nextcloud](https://gitlab.com/dokos/nextcloud){rel="&#x22;nofollow&#x22;"}                 | En développement                                                                                 |                                                                            |
| [Hiboutik](https://gitlab.com/dokos/hiboutik){rel="&#x22;nofollow&#x22;"}                   | <https://doc.dokos.io/integrations/hiboutik>{rel="&#x22;nofollow&#x22;"}                         |                                                                            |
| [WooCommerce](https://gitlab.com/dokos/dokos-woocommerce){rel="&#x22;nofollow&#x22;"}       | <https://doc.dokos.io/integrations/woocommerce>{rel="&#x22;nofollow&#x22;"}                      |                                                                            |
| [Construction](https://gitlab.com/dokos/construction){rel="&#x22;nofollow&#x22;"}           | <https://doc.dokos.io/dokos/chantiers>{rel="&#x22;nofollow&#x22;"}                               |                                                                            |
| [ToobibPro](https://framagit.org/toobib/toobib-pro){rel="&#x22;nofollow&#x22;"}             | <https://doc.dokos.io/toobibpro>{rel="&#x22;nofollow&#x22;"}                                     |                                                                            |

## Applications [Frappe](https://frappe.io/products){rel="&#x22;nofollow&#x22;"}

| Application                                                                           | Compatibilité avec Dodock |
| ------------------------------------------------------------------------------------- | ------------------------- |
| [Frappe Helpdesk](https://frappe.io/helpdesk){rel="&#x22;nofollow&#x22;"}             | ✅                         |
| [Frappe Learning](https://frappe.io/learning){rel="&#x22;nofollow&#x22;"}             | ✅                         |
| [Frappe Wiki](https://frappe.io/wiki){rel="&#x22;nofollow&#x22;"}                     | ✅                         |
| [Frappe Insights](https://frappe.io/insights){rel="&#x22;nofollow&#x22;"}             | ✅                         |
| [Frappe Gameplan](https://frappe.io/gameplan){rel="&#x22;nofollow&#x22;"}             | ✅                         |
| [Frappe CRM](https://frappe.io/crm){rel="&#x22;nofollow&#x22;"}                       | ✅                         |
| [Frappe Builder](https://frappe.io/builder){rel="&#x22;nofollow&#x22;"}               | ✅                         |
| [Frappe Print Designer](https://frappe.io/print-designer){rel="&#x22;nofollow&#x22;"} | ✅                         |

✅ Compatibilité vérifiée\:br
⚠️ Compatibilité non vérifiée\:br
❌ Non Compatible


# Frappe Builder

## Site web

::callout
<https://frappe.io/builder>{rel=""nofollow""}
::

## Documentation

Il n'existe pas encore de documentation complète pour l'utilisation de Frappe Builder.

Voici les ressources à votre disposition pour prendre en main cet outil:

- [Présentation de Frappe Builder](https://www.youtube.com/live/cBpWblmUm3c){rel="&#x22;nofollow&#x22;"}
- [Création d'un site web en direct - Partie 1](https://www.youtube.com/watch?v=Iw9471qc41k){rel="&#x22;nofollow&#x22;"}
- [Création d'un site web en direct - Partie 2](https://www.youtube.com/watch?v=4nBPhNEleWg){rel="&#x22;nofollow&#x22;"}


# Frappe CRM

## Site web

::callout
<https://frappe.io/crm>{rel=""nofollow""}
::

## Documentation

[Documentation Frappe](https://docs.frappe.io/crm/introduction){rel="&#x22;nofollow&#x22;"}

## Ressource

[Lancement en direct et démonstration de Frappe CRM, avec Shariq Ansari.](https://www.youtube.com/live/ixNnB7fOlfo){rel="&#x22;nofollow&#x22;"}


# Frappe Helpdesk

## Site web

::callout
<https://frappe.io/helpdesk>{rel=""nofollow""}
::

## Documentation

[Documentation Frappe](https://docs.frappe.io/helpdesk/introduction){rel="&#x22;nofollow&#x22;"}


# Frappe Insights

## Site web

::callout
<https://frappe.io/insights>{rel=""nofollow""}
::

## Documentation

[Documentation Frappe](https://docs.frappeinsights.com/){rel="&#x22;nofollow&#x22;"}

## Ressource

[Apprendre Frappe Insights v2, avec Saqib Ansari](https://www.youtube.com/live/GQ6lVYzZCDk){rel="&#x22;nofollow&#x22;"}


# Frappe Learning

## Site web

::callout
<https://frappe.io/learning>{rel=""nofollow""}
::

## Documentation

[Documentation Frappe](https://docs.frappe.io/learning/introduction){rel="&#x22;nofollow&#x22;"}

## Ressource

[Ép. 20 : Frappe LMS pour démarrage avec Hussain, ft. Jannat Patel](https://www.youtube.com/live/LeZC5PtPkd0){rel="&#x22;nofollow&#x22;"}


# Print Designer

Print Designer est une application distincte, publiée par Frappe Technologies, qui remplace le constructeur de format d'impression classique par un éditeur visuel WYSIWYG (ce que vous concevez est ce qui s'imprime). Elle s'appuie sur le moteur **Chrome** pour la génération PDF, ce qui permet d'utiliser des mises en page modernes impossibles avec WKHTMLTOPDF.

## Fonctionnalités principales

- **Éditeur visuel** — positionnez les éléments par glisser-déposer avec un aperçu en temps réel
- **Données dynamiques** — intégrez les champs du document et des documents liés
- **Tableaux** — outil dédié à la conception de tableaux avec lignes dynamiques
- **En-tête et pied de page** — conception séparée et répétée sur chaque page
- **Multi-pages** — gérez plusieurs modèles de pages dans un seul format
- **Scripts personnalisés** — les utilisateurs avancés peuvent injecter du HTML ou de la logique métier

## Prérequis

- Dokos v5 ou supérieur
- Le moteur Chrome doit être disponible sur le serveur (Chromium est téléchargé automatiquement \~150 Mo à l'installation)

## Installation

::callout
Afin d'avoir Print Designer sur votre site Dokos, installez l'application depuis votre bench :

```sh
bench get-app print_designer
bench --site [mon-site] install-app print_designer
```

Si vous êtes client Dokos Cloud, contactez <help@dokos.cloud> pour demander l'installation.
::

## Rapport avec le moteur d'impression

Print Designer utilise exclusivement le moteur **Chrome** pour générer les PDF. Cela signifie que :

- Toutes les fonctionnalités CSS modernes sont disponibles (Grid, Flexbox, variables CSS)
- Les sauts de page sont gérés de manière fiable
- Les problèmes de dernière page blanche propres à WKHTMLTOPDF ne se produisent pas

> Voir aussi : [Moteurs de génération PDF](https://doc.dokos.io/v5/dokos/generalites/impression-et-pdf#moteurs-de-g%C3%A9n%C3%A9ration-pdf)

## Ressources

- [Site officiel](https://frappe.io/print-designer){rel="&#x22;nofollow&#x22;"}
- [Ép. 17 : Fonctionnalité de conception d'impression, formats et plaisir, ft. Maharshi Patel](https://www.youtube.com/live/zv60Ar4yqrM){rel="&#x22;nofollow&#x22;"}


# Frappe Wiki

## Site web

::callout
<https://frappe.io/wiki>{rel=""nofollow""}
::

## Documentation

[Documentation Frappe](https://docs.frappe.io/wiki/welcome-to-wiki){rel="&#x22;nofollow&#x22;"}


# Site web

::callout
<https://thecommit.company/products/raven>{rel=""nofollow""}
::

## Documentation

Il n'existe actuellement aucune documentation disponible pour Raven.


# Property Setters — Création et suppression en masse

Les **Property Setters** permettent de modifier le comportement de champs existants (valeur par défaut, obligatoire, masqué…) sans toucher au code source du formulaire. Ils sont couramment utilisés dans les applications custom pour adapter l'interface à un contexte métier spécifique.

## Création en masse

Frappe/Dodock fournit deux fonctions pour créer des Property Setters par programmation :

- `frappe.make_property_setter` — crée un seul Property Setter
- `frappe.make_property_setters` — crée plusieurs Property Setters en une seule fois

Usage typique dans un fichier `setup.py` ou `install.py` d'une application :

```python
import frappe

PROPERTY_SETTERS = [
    {
        "doctype": "Todo",
        "fieldname": "status",
        "property": "default",
        "property_type": "Data",
        "value": "Required",
    },
    {
        "doctype": "Todo",
        "fieldname": "priority",
        "property": "hidden",
        "property_type": "Check",
        "value": "1",
    },
]

def setup():
    frappe.make_property_setters(PROPERTY_SETTERS)
```

## Suppression en masse

Depuis la version incluant cette amélioration, une fonction symétrique est disponible pour **supprimer** des Property Setters en utilisant la même structure de données que lors de la création. Cela simplifie la maintenance des fichiers `uninstall.py`.

```python
from frappe.custom.doctype.property_setter.property_setter import delete_property_setters

PROPERTY_SETTERS = [
    {
        "doctype": "Todo",
        "fieldname": "status",
        "property": "default",
        "property_type": "Data",
        "value": "Required",
    },
    {
        "doctype": "Todo",
        "fieldname": "priority",
        "property": "hidden",
        "property_type": "Check",
        "value": "1",
    },
]

def uninstall():
    delete_property_setters(PROPERTY_SETTERS)
```

### Champs reconnus

La fonction `delete_property_setters` accepte une liste de dictionnaires. Les clés suivantes sont reconnues pour identifier le Property Setter à supprimer :

| Clé             | Obligatoire | Description                                                        |
| --------------- | ----------- | ------------------------------------------------------------------ |
| `doctype`       | ✅           | Type de document cible (ex. `"Todo"`)                              |
| `fieldname`     | ✅           | Nom du champ concerné                                              |
| `property`      | ✅           | Propriété modifiée (ex. `"default"`, `"hidden"`)                   |
| `property_type` | ✅           | Type de la propriété (ex. `"Data"`, `"Check"`)                     |
| `value`         | —           | Valeur (non utilisée pour l'identification lors de la suppression) |

> **Note** : Les champs `doctype`, `fieldname`, `property` et `property_type` sont requis. Une exception est levée si l'un d'eux est manquant.

## Cas d'usage complet — Cycle de vie d'une application

Une application custom suit généralement ce cycle :

::mermaid
flowchart LR
A\[install.py / setup.py] -->|make\_property\_setters| B\[(Property Setters en base)]
B -->|Personnalise l'interface| C\[Utilisateurs]
D\[uninstall.py] -->|delete\_property\_setters| B

::

Exemple de structure cohérente :

```python
# mon_app/setup/install.py
from frappe.custom.doctype.property_setter.property_setter import make_property_setter
import frappe

PROPERTY_SETTERS = [
    {
        "doctype": "Customer",
        "fieldname": "customer_group",
        "property": "default",
        "property_type": "Data",
        "value": "Particulier",
    },
]

def after_install():
    frappe.make_property_setters(PROPERTY_SETTERS)


# mon_app/setup/uninstall.py
from frappe.custom.doctype.property_setter.property_setter import delete_property_setters

def before_uninstall():
    delete_property_setters(PROPERTY_SETTERS)
```

::callout{type="info"}
Contrairement à la suppression manuelle via l'interface **Personnalisation du formulaire**, `delete_property_setters` est atomique : soit tous les Property Setters sont supprimés, soit une exception est levée si les champs requis sont manquants.
::


# Modèles d'e-mail

Les modèles d'e-mail permettent de préparer à l'avance des messages types — confirmation de commande, relance de facture, accusé de réception — et de les réutiliser en un clic depuis n'importe quel document.

Depuis la version qui intègre le champ **Type de document de référence**, vous pouvez associer un modèle à un type de document précis. Le modèle ne s'affiche alors que lorsque l'utilisateur envoie un e-mail depuis ce type de document, ce qui évite de présenter des modèles inadaptés et remplis de variables Jinja incompatibles.

## Créer un modèle d'e-mail

::tour{demo="Mappemonde" doctype="email-template"}
Consultez les modèles d'e-mail dans la démo
::

1. Allez dans **Paramètres > Modèle d'e-mail** puis cliquez sur **Nouveau**.
2. Donnez un **Nom** explicite au modèle (par exemple : *Confirmation de commande client*).
3. Rédigez l'**Objet** et le **Corps** du message. Vous pouvez utiliser des variables Jinja pour personnaliser le contenu (voir ci-dessous).
4. Renseignez éventuellement le champ **Type de document de référence** pour limiter la visibilité du modèle.
5. Enregistrez.

## Limiter un modèle à un type de document

Le champ **Type de document de référence** (Reference DocType) est optionnel. Son comportement :

| Valeur du champ    | Où le modèle apparaît                                         |
| ------------------ | ------------------------------------------------------------- |
| *(vide)*           | Dans la fenêtre d'e-mail de **tous** les documents            |
| `Commande client`  | Uniquement dans la fenêtre d'e-mail des **Commandes client**  |
| `Facture de vente` | Uniquement dans la fenêtre d'e-mail des **Factures de vente** |

::callout{color="blue" icon="i-mdi-information"}
Les modèles sans type de document de référence restent visibles partout. Vos modèles existants ne sont donc pas impactés par cette fonctionnalité.
::

### Exemple concret

Maison Verte SARL utilise trois modèles :

- **Bienvenue générale** — aucun type de référence → apparaît sur tous les documents
- **Confirmation de commande** — référence : *Commande client* → visible uniquement depuis une commande client
- **Relance facture impayée** — référence : *Facture de vente* → visible uniquement depuis une facture de vente

Quand Alice, commerciale chez Maison Verte SARL, ouvre la fenêtre d'envoi d'e-mail sur la commande CMD-00042 passée par Bureau Moderne, elle voit :

- ✅ Bienvenue générale
- ✅ Confirmation de commande
- ❌ Relance facture impayée &#x2A;(masqué, car ce modèle est réservé aux factures)*

## Utiliser un modèle lors d'un envoi d'e-mail

1. Ouvrez le document depuis lequel vous souhaitez envoyer un e-mail.
2. Cliquez sur le bouton **E-mail** dans la barre d'actions (ou depuis la section Commentaires / Activité).
3. Dans la fenêtre d'e-mail, développez **Plus d'options**.
4. Cliquez sur le champ **Modèle d'e-mail** : seuls les modèles compatibles avec ce type de document s'affichent.
5. Sélectionnez le modèle souhaité — l'objet et le corps sont pré-remplis automatiquement.
6. Ajustez si nécessaire, puis cliquez sur **Envoyer**.

## Utiliser les variables Jinja dans un modèle

Les modèles d'e-mail acceptent la syntaxe Jinja2. Le document courant est accessible via la variable `doc`.

**Exemple pour une commande client :**

```text
Objet : Confirmation de votre commande {{ doc.name }}

Bonjour {{ doc.contact_display }},

Nous avons bien enregistré votre commande {{ doc.name }}
du {{ doc.transaction_date }} pour un montant de {{ doc.grand_total }} €.

Cordialement,
L'équipe Maison Verte SARL
```

::callout{color="orange" icon="i-mdi-alert"}
Si vous utilisez des variables spécifiques à un type de document (par exemple `doc.delivery_date` sur une commande), pensez à renseigner le **Type de document de référence** correspondant. Sans cette restriction, le modèle pourrait s'afficher sur des documents qui ne possèdent pas ces champs et provoquer une erreur lors de l'envoi.
::

## Flux de sélection d'un modèle

::mermaid
flowchart TD
A\[Utilisateur ouvre la fenêtre e-mail\nsur un document] --> B{Le modèle a-t-il un\nType de document\nde référence ?}
B -- Non --> C\[✅ Modèle affiché\npour tous les documents]
B -- Oui --> D{Le type correspond-il\nau document courant ?}
D -- Oui --> E\[✅ Modèle affiché]
D -- Non --> F\[❌ Modèle masqué]

::

## En savoir plus

- [Notifications](https://doc.dokos.io/v5/dodock/fonctionnalites/notifications)
- [Paramètres e-mail](https://doc.dokos.io/v5/dodock/administration/emails)


# Connexion Google via OAuth — Application Connectée

Cette page décrit la configuration d'une **Application Connectée** (Connected App) pour s'authentifier auprès des services Google via OAuth 2.0, notamment pour les comptes e-mail Gmail.

::callout{color="blue" icon="i-mdi-information-outline"}
Cette méthode est distincte des **Paramètres Google** (Agenda, Drive, Contacts). Elle est utilisée par exemple pour connecter un compte Gmail via IMAP/SMTP avec OAuth, ou pour appeler une API Google personnalisée depuis un script.
::

## Pourquoi une configuration spécifique pour Google ?

Google impose des conditions particulières pour délivrer un **jeton de rafraîchissement** (`refresh_token`) :

- Le paramètre `access_type=offline` doit être présent dans l'URL d'autorisation.
- Le paramètre `prompt=consent` doit forcer l'affichage de l'écran de consentement.

Sans ces deux paramètres, Google ne fournit qu'un jeton d'accès valable \~1 heure, sans possibilité de le renouveler automatiquement. Le compte se retrouve alors bloqué après expiration, avec un message &#x2A;« Veuillez autoriser OAuth »*.

Depuis la version incluant ce correctif, Dodock ajoute automatiquement ces paramètres lorsque l'URI d'autorisation contient `accounts.google.com`.

## Prérequis : créer un client OAuth sur Google Cloud

1. Rendez-vous sur <https://console.cloud.google.com/>{rel="&#x22;nofollow&#x22;"}.
2. Utilisez un projet existant ou créez-en un nouveau.
3. Dans **API et services**, cliquez sur **Identifiants**.
4. Cliquez sur **Créer des identifiants** → **ID client OAuth**.
5. Choisissez le type **Application Web**.
6. Dans **URI de redirection autorisés**, ajoutez :

   ```text
   https://{votresite}/api/method/frappe.integrations.doctype.connected_app.connected_app.oauth2_callback
   ```
7. Enregistrez et notez le **Client ID** et le **Client Secret**.

## Créer l'Application Connectée dans Dodock

> Accueil > Intégrations > **Application Connectée**

1. Cliquez sur **Nouvelle Application Connectée**.
2. Renseignez les champs suivants :

| Champ                  | Valeur pour Google                                        |
| ---------------------- | --------------------------------------------------------- |
| **Fournisseur**        | `google` (ou tout nom explicite)                          |
| **URI d'autorisation** | `https://accounts.google.com/o/oauth2/auth`               |
| **URI de jeton**       | `https://oauth2.googleapis.com/token`                     |
| **Client ID**          | Valeur copiée depuis Google Cloud                         |
| **Client Secret**      | Valeur copiée depuis Google Cloud                         |
| **Périmètre (Scopes)** | Selon l'usage (ex. `https://mail.google.com/` pour Gmail) |

3. **Enregistrez** le document.

::callout{color="green" icon="i-mdi-check-circle-outline"}
Dodock détecte automatiquement que l'URI contient `accounts.google.com` et ajoute `access_type=offline` et `prompt=consent` à l'URL d'autorisation. Vous n'avez pas à les saisir manuellement dans la table des paramètres.
::

## Autoriser l'accès (flux d'autorisation)

Après enregistrement, vous devez autoriser l'accès une première fois pour que Google émette un `refresh_token` :

1. Ouvrez l'Application Connectée.
2. Cliquez sur le bouton **Autoriser l'accès** (ou accédez à l'URL générée).
3. Connectez-vous avec le compte Google souhaité.
4. Acceptez les autorisations demandées — l'écran de consentement doit s'afficher (grâce à `prompt=consent`).
5. Vous êtes redirigé vers Dodock ; le **Cache de jeton** est créé avec un `refresh_token` valide.

::mermaid
sequenceDiagram
participant U as Utilisateur
participant D as Dodock
participant G as Google OAuth


```text
U->>D: Clique sur "Autoriser l'accès"
D->>G: Redirige avec access_type=offline&prompt=consent
G->>U: Affiche l'écran de consentement
U->>G: Accepte les autorisations
G->>D: Retourne code d'autorisation + refresh_token
D->>D: Stocke access_token + refresh_token dans Cache de jeton
D->>U: Connexion établie
```
::

## Renouvellement automatique du jeton

Une fois autorisé, Dodock renouvelle le jeton d'accès automatiquement :

::mermaid
sequenceDiagram
participant D as Dodock
participant G as Google OAuth


```text
D->>D: access_token expiré (après ~1h)
D->>G: Demande de renouvellement avec refresh_token
G->>D: Nouveau access_token
D->>D: Met à jour le Cache de jeton (refresh_token conservé)
```
::

Si le `refresh_token` est absent du cache (comptes configurés avant ce correctif), Dodock affiche désormais un message clair :

> *« Ce jeton est expiré et ne dispose pas de jeton de rafraîchissement. Veuillez ré-autoriser avec un accès hors ligne. »*

Cela indique qu'une nouvelle autorisation est requise (voir section suivante).

## Ré-autoriser un compte existant

Si votre compte Gmail (ou autre service Google) rencontrait des erreurs périodiques d'autorisation avant ce correctif, vous devez effectuer une ré-autorisation unique :

1. Ouvrez l'**Application Connectée** concernée.
2. **Enregistrez** le document (ce qui déclenche l'ajout automatique de `access_type=offline`).
3. Cliquez sur **Autoriser l'accès** et suivez le flux de consentement Google.
4. Vérifiez que le **Cache de jeton** associé contient bien un `refresh_token`.

::callout{color="orange" icon="i-mdi-alert-outline"}
Cette ré-autorisation unique est nécessaire même si le code a été mis à jour. Sans elle, Google ne peut pas émettre de nouveau `refresh_token` pour les sessions existantes.
::

## Vérifier le Cache de jeton

> Accueil > Intégrations > **Cache de jeton**

Le Cache de jeton stocke les jetons OAuth associés à chaque Application Connectée. Vous pouvez y vérifier :

- La présence d'un **Jeton de rafraîchissement** (non vide = configuration correcte).
- La date d'expiration du jeton d'accès en cours.

::callout{color="blue" icon="i-mdi-shield-lock-outline"}
Le `refresh_token` n'est jamais écrasé par un renouvellement normal (Google ne le renvoie pas à chaque rafraîchissement). Dodock le préserve automatiquement.
::

## Résolution des problèmes courants

| Symptôme                                                                   | Cause probable                                    | Action                                                |
| -------------------------------------------------------------------------- | ------------------------------------------------- | ----------------------------------------------------- |
| *« Veuillez autoriser OAuth »* répété                                      | Pas de `refresh_token` stocké                     | Ré-autoriser via l'Application Connectée              |
| *« Ré-autoriser avec un accès hors ligne »*                                | `refresh_token` absent du cache après expiration  | Ré-autoriser (voir section ci-dessus)                 |
| Erreur Google `invalid_request: Missing required parameter: refresh_token` | Ancienne configuration sans `access_type=offline` | Enregistrer l'Application Connectée puis ré-autoriser |
| Le compte fonctionne pendant \~1h puis échoue                              | Idem                                              | Idem                                                  |


# Boîte de dialogue des paramètres

Dokos introduit une nouvelle boîte de dialogue des paramètres (`frappe.ui.SettingsDialog`) qui permet de regrouper et d'organiser les options de configuration de manière intuitive. Cette fonctionnalité est particulièrement utile pour les modules nécessitant plusieurs sections de configuration.

## Fonctionnement

La boîte de dialogue des paramètres se présente sous la forme d'un panneau latéral avec deux sections principales :

1. **Rail de navigation vertical** : Liste les groupes et onglets disponibles.
2. **Panneau principal** : Affiche le contenu de l'onglet sélectionné, avec des champs de formulaire, des descriptions et des actions.

::mermaid
flowchart LR
A\[Rail de navigation] -->|Sélection| B\[Panneau principal]
B -->|Actions| C\[Sauvegarde/Annulation]

::

## Utilisation de base

Pour ouvrir une boîte de dialogue des paramètres, utilisez le code suivant :

```javascript
new frappe.ui.SettingsDialog({
  title: __('Paramètres'),
  default_tab: "preferences",
  tabs: [{
    group: __('Configuration'),
    items: [{
      id: "preferences",
      label: __('Préférences'),
      icon: "sliders-vertical",
      title: __('Préférences'),
      description: __('Gérez vos préférences'),
      fields: [
        {
          label: __('Thème sombre'),
          fieldname: "dark_mode",
          fieldtype: "Switch"
        }
      ],
      actions: [{
        label: __('Sauvegarder'),
        primary: true,
        click(panel) {
          const values = panel.get_values();
          // Logique de sauvegarde
        }
      }]
    }]
  }]
}).show();
```

## Contrôle Switch

Le contrôle `Switch` (`fieldtype: "Switch"`) est un nouvel élément d'interface qui permet d'activer ou de désactiver une option de manière visuelle. Il est utilisable dans n'importe quel formulaire ou boîte de dialogue.

### Exemple d'utilisation

```javascript
{
  label: __('Activer la fonctionnalité'),
  fieldname: "enable_feature",
  fieldtype: "Switch",
  default: 1
}
```

### Comportement

- Cliquer n'importe où sur la ligne active/désactive le switch.
- La valeur renvoyée par `get_values()` est `1` (activé) ou `0` (désactivé).
- Compatible avec les validations de champ (obligatoire, lecture seule, etc.).

## Personnalisation avancée

### Panneaux dynamiques

Chaque panneau (`SettingsDialogPanel`) peut être mis à jour dynamiquement avec `panel.set_view()` :

```javascript
panel.set_view({
  title: __('Nouveau titre'),
  description: __('Nouvelle description'),
  fields: [ /* nouveaux champs */ ],
  actions: [ /* nouvelles actions */ ]
});
```

### Méthodes utiles

| Méthode                                | Description                                 |
| -------------------------------------- | ------------------------------------------- |
| `panel.get_values()`                   | Récupère les valeurs du formulaire          |
| `panel.set_values(values)`             | Définit les valeurs du formulaire           |
| `panel.refresh()`                      | Réinitialise le panneau à sa vue par défaut |
| `panel.set_header(title, description)` | Met à jour le titre et la description       |

## Exemple complet

Voici un exemple complet de configuration pour un module de gestion des notifications :

```javascript
new frappe.ui.SettingsDialog({
  title: __('Paramètres des notifications'),
  default_tab: "email",
  tabs: [{
    group: __('Canaux'),
    items: [
      {
        id: "email",
        label: __('Email'),
        icon: "envelope",
        title: __('Notifications par email'),
        description: __('Configurez les notifications envoyées par email'),
        fields: [
          {
            label: __('Activer les emails'),
            fieldname: "enable_emails",
            fieldtype: "Switch",
            default: 1
          },
          {
            label: __('Fréquence'),
            fieldname: "email_frequency",
            fieldtype: "Select",
            options: ["Immédiat", "Quotidien", "Hebdomadaire"],
            depends_on: "eval:doc.enable_emails"
          }
        ],
        actions: [
          {
            label: __('Sauvegarder'),
            primary: true,
            click(panel) {
              const values = panel.get_values();
              frappe.call({
                method: "module.api.save_settings",
                args: { values },
                callback: () => {
                  frappe.show_alert({
                    message: __('Paramètres sauvegardés'),
                    indicator: 'green'
                  });
                }
              });
            }
          }
        ]
      }
    ]
  }]
}).show();
```

## Bonnes pratiques

1. **Regroupez les options logiquement** : Utilisez les groupes et onglets pour organiser les paramètres par thème.
2. **Utilisez des descriptions claires** : Chaque onglet doit avoir une description qui explique son utilité.
3. **Limitez le nombre d'actions** : Privilégiez une action principale (ex: "Sauvegarder") et évitez les actions secondaires inutiles.
4. **Testez la navigation** : Assurez-vous que le passage d'un onglet à l'autre fonctionne sans perte de données.
5. **Utilisez le contrôle Switch pour les options binaires** : Il offre une meilleure expérience utilisateur que les cases à cocher classiques.

## Cas d'usage

- **Configuration des préférences utilisateur** : Thème, langue, fuseau horaire.
- **Paramètres de module** : Notifications, intégrations, options de synchronisation.
- **Tableaux de bord personnalisables** : Choix des widgets à afficher.

\::: tip
Pour les développeurs, ces primitives sont réutilisables dans n'importe quel module Dokos. Consultez la documentation technique pour plus de détails sur l'API.
\:::


# Frise chronologique de l'activité

La frise chronologique de l'activité dans Dokos vous permet de suivre l'évolution d'un document de manière détaillée. Elle affiche désormais non seulement les créations, emails, commentaires et versions, mais aussi les **modifications**, **jalons** et **partages** associés au document.

## Éléments affichés dans la frise

La frise chronologique regroupe désormais les informations suivantes :

- **Création** du document
- **Modifications** apportées au document (même si aucune version n'est enregistrée)
- **Emails** envoyés ou reçus en lien avec le document
- **Commentaires** et **journaux** d'activité
- **Consultations** du document
- **Versions** enregistrées (le cas échéant)
- **Jalons** (changements de valeur dans les champs suivis)
- **Partages** du document avec d'autres utilisateurs

::mermaid
flowchart TD
A\[Document] --> B\[Création]
A --> C\[Modifications]
A --> D\[Emails]
A --> E\[Commentaires & Journaux]
A --> F\[Consultations]
A --> G\[Versions]
A --> H\[Jalons]
A --> I\[Partages]

::

## Visualisation des modifications

Lorsque vous modifiez un document, cette action est désormais enregistrée dans la frise chronologique, même si le document ne suit pas les versions. Cela vous permet de savoir **quand** et **par qui** le document a été modifié pour la dernière fois.

::info
**Exemple** : Si vous modifiez le champ "Statut" d'un devis "DV-2026-001" pour le passer de "Brouillon" à "Envoyé", cette modification apparaîtra dans la frise chronologique avec l'utilisateur qui a effectué le changement et l'horodatage.
::

## Suivi des jalons

Les jalons représentent des changements importants dans les champs suivis d'un document. Par exemple, si vous suivez le champ "Statut" d'un projet, chaque changement de statut (de "En cours" à "Terminé", par exemple) sera enregistré comme un jalon.

La frise chronologique affiche désormais jusqu'à **20 jalons** par document, vous permettant de retracer l'historique complet des changements clés.

::info
**Exemple** : Pour un projet "Projet Alpha", les changements de statut ("Planification" → "En cours" → "Terminé") apparaissent comme des jalons dans la frise, avec la date et l'utilisateur responsable.
::

## Gestion des partages

Lorsque vous partagez un document avec un autre utilisateur, cette action est désormais visible dans la frise chronologique. Vous pouvez voir :

- **Qui** a partagé le document
- **Avec qui** le document a été partagé
- **Quand** le partage a eu lieu

::info
**Exemple** : Si vous partagez le devis "DV-2026-001" avec l'utilisateur "Jean Dupont", cette action apparaîtra dans la frise avec la mention "Partagé avec Jean Dupont par [votre nom] le [date] ".
::

## Permissions et confidentialité

La frise chronologique respecte les permissions définies dans Dokos :

- Les utilisateurs ne voient que les **champs auxquels ils ont accès** dans les jalons.
- Les informations de partage sont affichées uniquement si l'utilisateur a les droits nécessaires.
- Les modifications et versions sont visibles selon les permissions du document.

## Comment accéder à la frise chronologique ?

1. Ouvrez un document dans Dokos (par exemple, un devis, une facture ou un projet).
2. Cliquez sur l'onglet **Activité** dans la barre latérale droite.
3. La frise chronologique s'affiche, montrant tous les événements liés au document.

::tip
Utilisez la frise chronologique pour :

- Retracer l'historique complet d'un document.
- Identifier qui a effectué des modifications clés.
- Vérifier les partages et les accès au document.
- Suivre l'évolution des statuts ou autres champs importants.
::


# Gestion des formulaires

## Introduction

Les formulaires dans Dokos permettent de saisir et modifier des données de manière structurée. Cette page explique les fonctionnalités avancées liées à la gestion des formulaires, notamment la personnalisation des champs et le comportement des commits.

## Personnalisation des champs

### Structure des champs

Chaque champ dans un formulaire peut être configuré pour répondre à des besoins spécifiques. Voici les éléments clés à connaître :

- **Types de champs** : Texte, Numérique, Date, Table, Sélection multiple, etc.
- **Comportement par défaut** : Valeurs par défaut, champs obligatoires, masquage conditionnel.

### Exemple de configuration

Pour configurer un champ de type **Table** dans un formulaire de commande client :

1. Accédez à **Développeur > Doctype > Commande Client**.
2. Ajoutez un champ de type **Table** et liez-le à un doctype enfant (ex: **Articles de Commande**).
3. Configurez les valeurs par défaut pour les lignes de la table.

## Nouveautés dans la gestion des commits (v5)

### Mécanisme de commit des champs

Depuis la version 5 de Dokos, un nouveau mécanisme de commit a été introduit pour améliorer la réactivité et la précision des formulaires. Voici ce qui change :

- **Commit au niveau du champ** : Chaque champ émet désormais un événement `change` lorsqu'une modification est validée (par exemple, après avoir quitté le champ ou appuyé sur Entrée).
- **Séparation des clés serveurs et clients** : Les identifiants des lignes dans une table sont désormais gérés séparément pour éviter les conflits entre les données côté client et côté serveur.
- **Gestion des nouvelles lignes** : Lorsqu'une nouvelle ligne est ajoutée dans une table, un identifiant temporaire (`__row_id`) est généré côté client. Cet identifiant est remplacé par un `name` côté serveur lors de l'enregistrement.

### Impact sur les formulaires avec tables

#### Avant

- Les modifications dans une table étaient suivies globalement, ce qui pouvait entraîner des pertes de données ou des comportements inattendus (ex: sélection de lignes perdue après enregistrement).
- Les valeurs par défaut des champs enfants dans une table n'étaient pas appliquées automatiquement.

#### Après

- **Précision des commits** : Chaque cellule d'une table émet un commit avec le nom du champ et l'identifiant de la ligne concernée. Cela permet de suivre précisément les modifications.
- **Conservation des sélections** : Les sélections de lignes dans une table sont désormais conservées après un enregistrement, sauf pour la première sauvegarde d'une ligne ajoutée dans la session en cours.
- **Application des valeurs par défaut** : Les valeurs par défaut des champs enfants sont désormais appliquées correctement lors de l'ajout d'une nouvelle ligne.

### Exemple d'utilisation

Prenons l'exemple d'un formulaire de **Commande Client** avec une table d'articles :

1. **Ajout d'une nouvelle ligne** :

   - Une nouvelle ligne est ajoutée à la table **Articles de Commande**.
   - Un identifiant temporaire (`__row_id`) est généré pour cette ligne.
   - Les valeurs par défaut (ex: quantité = 1, unité de mesure = "Unité") sont appliquées automatiquement.
2. **Modification d'une cellule** :

   - L'utilisateur modifie la quantité d'un article.
   - Un commit est émis avec le champ `qty` et l'identifiant de la ligne concernée.
3. **Enregistrement du formulaire** :

   - La ligne est enregistrée côté serveur et reçoit un `name` permanent.
   - Les sélections de lignes sont conservées.

::mermaid
flowchart TD
A\[Ajout d'une nouvelle ligne] --> B\[Génération de \_\_row\_id]
B --> C\[Application des valeurs par défaut]
C --> D\[Modification d'une cellule]
D --> E\[Émission d'un commit]
E --> F\[Enregistrement du formulaire]
F --> G\[Remplacement de \_\_row\_id par name]
G --> H\[Conservation des sélections]

::

## Bonnes pratiques

### Pour les utilisateurs

- **Valider les modifications** : Après avoir modifié un champ, quittez-le ou appuyez sur Entrée pour déclencher le commit. Cela garantit que les modifications sont prises en compte.
- **Vérifier les sélections** : Après avoir enregistré un formulaire contenant une table, vérifiez que les sélections de lignes sont toujours actives.

### Pour les développeurs

- **Utilisation des événements** : Si vous développez une fonctionnalité qui réagit aux modifications d'un formulaire, utilisez l'événement `commit` plutôt que de surveiller les changements globaux du document.
- **Gestion des identifiants** : Lors de la création de nouvelles lignes dans une table, utilisez l'identifiant temporaire (`__row_id`) pour suivre les modifications côté client avant l'enregistrement.

## Dépannage

### Problèmes courants

| Problème                                                   | Cause possible                                          | Solution                                                                                                                   |
| ---------------------------------------------------------- | ------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |
| Les modifications dans une table ne sont pas enregistrées  | Le champ n'a pas émis de commit                         | Vérifiez que le champ a bien été quitté ou validé avant l'enregistrement                                                   |
| Les sélections de lignes sont perdues après enregistrement | Première sauvegarde d'une ligne ajoutée dans la session | Ce comportement est normal pour la première sauvegarde. Les sélections seront conservées lors des enregistrements suivants |
| Les valeurs par défaut ne sont pas appliquées              | Configuration incorrecte des valeurs par défaut         | Vérifiez la configuration des champs enfants dans le doctype                                                               |

### Journalisation des commits

Pour déboguer les commits émis par les champs, vous pouvez activer la journalisation dans la console du navigateur :

```javascript
// Activer la journalisation des commits
frappe.ui.form.on('Commande Client', {
    refresh: function(frm) {
        frm.fields.forEach(field => {
            if (field.df.fieldtype === 'Table') {
                field.grid.grid_rows.forEach(row => {
                    row.docfields.forEach(docfield => {
                        frappe.model.on('commit', docfield.fieldname, (fieldname, value) => {
                            console.log(`Commit émis pour ${fieldname}:`, value);
                        });
                    });
                });
            } else {
                frappe.model.on('commit', field.df.fieldname, (fieldname, value) => {
                    console.log(`Commit émis pour ${fieldname}:`, value);
                });
            }
        });
    }
});
```

## Conclusion

Le nouveau mécanisme de commit des champs dans Dokos v5 améliore la précision et la réactivité des formulaires, notamment pour les tables. En suivant les bonnes pratiques décrites ici, les utilisateurs et développeurs peuvent tirer pleinement parti de ces améliorations.

Pour plus d'informations sur la personnalisation des formulaires, consultez la section [Personnalisation de l'interface](https://doc.dokos.io/../personnalisation/personnaliser-l-interface).


# Configurer les séries de nommage

Les séries de nommage permettent de définir des masques de numérotation automatiques pour vos documents (devis, factures, commandes, etc.). Avec cette fonctionnalité intégrée au framework Dodock, vous pouvez désormais configurer et modifier ces séries directement depuis l'interface, sans avoir besoin de passer par des scripts personnalisés.

## Accéder à la configuration des séries

1. Ouvrez le document pour lequel vous souhaitez modifier la série de nommage (par exemple, un devis ou une facture).
2. Cliquez sur le champ **Série** (généralement situé en haut du formulaire).
3. Une boîte de dialogue s'ouvre, affichant les séries disponibles pour ce type de document.

::tip
Si le champ Série n'apparaît pas, vérifiez que le document est en mode brouillon et que le type de document est configuré pour utiliser des séries de nommage (voir [Configurer les types de documents](https://doc.dokos.io/#)).
::

## Modifier une série de nommage

La boîte de dialogue des séries de nommage affiche :

- **Les séries disponibles** : Liste des masques de numérotation configurés pour ce type de document.
- **Prévisualisation** : Exemple de numéro généré pour chaque série.
- **Série par défaut** : La série actuellement sélectionnée comme valeur par défaut.

### Étapes pour modifier une série :

1. Dans la boîte de dialogue, sélectionnez la série que vous souhaitez définir comme nouvelle valeur par défaut.
2. Cliquez sur **Mettre à jour** pour appliquer les changements.
3. La série sélectionnée devient la nouvelle valeur par défaut pour tous les nouveaux documents de ce type.

\:::info Exemple
Pour un devis client, vous pourriez avoir les séries suivantes :

- **DV-.YYYY.-.#####** → Génère des numéros comme `DV-2026-00001`
- **DV-CLIENT-.MM.-.#####** → Génère des numéros comme `DV-MaisonVerte-06-00001`

En sélectionnant `DV-CLIENT-.MM.-.#####`, tous les nouveaux devis utiliseront ce masque.
\:::

## Bonnes pratiques

- **Utilisez des préfixes clairs** : Par exemple, `FACT-` pour les factures, `CMD-` pour les commandes.
- **Incluez des variables dynamiques** : Comme `.YYYY.` pour l'année ou `.MM.` pour le mois, afin de faciliter le classement.
- **Testez les séries** : Vérifiez toujours la prévisualisation avant de valider une série.
- **Limitez le nombre de séries** : Trop de séries peuvent rendre la sélection confuse pour les utilisateurs.

## Résoudre les problèmes courants

### Le champ Série n'apparaît pas

- Vérifiez que le type de document est configuré pour utiliser des séries de nommage (dans **Paramètres > Types de documents**).
- Assurez-vous que le document est en mode brouillon.

### La série ne se met pas à jour

- Actualisez la page après avoir modifié la série.
- Vérifiez que vous avez les droits d'accès pour modifier les séries (rôle **Administrateur** ou **Système**).

### Les numéros générés ne correspondent pas à la prévisualisation

- Vérifiez que la série est correctement configurée dans **Paramètres > Séries de nommage**.
- Assurez-vous qu'il n'y a pas de scripts personnalisés qui écrasent la numérotation.

## Personnalisation avancée

Pour les développeurs ou administrateurs système, il est possible de configurer des séries de nommage directement depuis le code ou via des scripts. Consultez la section [Personnaliser l'interface](https://doc.dokos.io/v5/dodock/interface/personnalisation/personnaliser_l_interface) pour plus de détails.

::dokos
### Configuration technique

La boîte de dialogue des séries de nommage est désormais intégrée au framework Dodock et peut être appelée depuis n'importe quel formulaire via le contrôleur `NamingSeriesController`. Voici un exemple d'utilisation dans un script client :

```javascript
frappe.ui.form.on('Quotation', {
    refresh(frm) {
        if (frm.doc.docstatus === 0) {
            frm.add_custom_button(__('Modifier la série'), function() {
                frappe.ui.form.NamingSeriesController.show_naming_series_dialog(
                    frm.doctype,
                    (data) => {
                        frm.set_value('naming_series', data.naming_series_options);
                        frm.refresh_field('naming_series');
                    }
                );
            });
        }
    }
});
```

**Méthodes disponibles :**

- `show_naming_series_dialog(doctype, on_update)` : Ouvre la boîte de dialogue pour le type de document spécifié.
- `render_table(fieldname, transactions)` : Affiche un tableau des séries disponibles dans un champ personnalisé.

**Événements :**

- `on_update({doctype, naming_series_options})` : Callback appelé après la mise à jour d'une série.
::

::mermaid
sequenceDiagram
participant Utilisateur as Utilisateur
participant Formulaire as Formulaire
participant Dialogue as Boîte de dialogue des séries
participant Serveur as Serveur


```text
Utilisateur->>Formulaire: Clique sur le champ Série
Formulaire->>Dialogue: Ouvre la boîte de dialogue
Dialogue->>Serveur: Charge les séries disponibles
Serveur-->>Dialogue: Retourne les séries et prévisualisations
Dialogue-->>Utilisateur: Affiche les séries
Utilisateur->>Dialogue: Sélectionne une série et clique sur Mettre à jour
Dialogue->>Serveur: Met à jour la série par défaut
Serveur-->>Dialogue: Confirme la mise à jour
Dialogue->>Formulaire: Met à jour le champ Série
Formulaire-->>Utilisateur: Affiche la nouvelle série
```
::


# PersonnaliserLInterface

\--- title: "Personnaliser l'interface et les comportements" description: "Étendre les fonctionnalités de Dokos avec des hooks et des scripts personnalisés" icon: i-mdi-puzzle-edit-outline ---

# Personnaliser l'interface et les comportements

Dokos permet d'étendre ses fonctionnalités grâce à des hooks et des scripts personnalisés. Voici comment adapter le calcul des taxes et d'autres comportements spécifiques.

## Hooks disponibles

### Résolveur de base taxable pour les types de frais personnalisés

**Cas d'usage** :

- Calculer des taxes sur le prix maximum de vente (MRP) en Inde
- Déterminer des valeurs taxables spécifiques pour certains impôts au Brésil

**Implémentation** :

1. Déclarez le hook dans le fichier `hooks.py` de votre application :

```python
# hooks.py
erpnext_taxable_base_resolvers = {"Sur MRP": "mon_app.taxes.sur_mrp"}
```

2. Créez la fonction de calcul dans votre module :

```python
# mon_app/taxes.py
def sur_mrp(calc, item, tax):
    """Calcule la base taxable sur le prix maximum de vente (MRP)"""
    return item.price_list_rate * item.qty
```

3. Implémentez le miroir côté client (JavaScript) :

```javascript
// Dans un fichier JavaScript de votre application
erpnext.taxable_base_resolvers["Sur MRP"] = (calc, item) => item.price_list_rate * item.qty;
```

**Exemple concret** :

- Article : prix de vente 1000, MRP 1200
- Taxe de 10% incluse dans le prix → 120
- Prix net du produit = 880

\::: tip
Pour les développeurs :

- Le hook reçoit les objets `calc` (calculateur de taxes), `item` (ligne d'article) et `tax` (configuration de la taxe)
- La fonction doit retourner la valeur taxable calculée
- Le miroir client doit retourner le même résultat que la version serveur
  \:::

## Autres personnalisations courantes

*(Contenu existant préservé intégralement...)*


# Configuration régionale des salaires

Dokos HRMS permet de personnaliser le calcul des salaires en fonction des réglementations locales grâce à des *hooks régionaux*. Ces hooks permettent d'appliquer des déductions ou des ajustements spécifiques avant le calcul final du salaire.

## Concepts clés

- **Hook régional** : Point d'extension dans le code permettant d'injecter une logique spécifique à une région ou un pays.
- **Override régional** : Mécanisme permettant de remplacer ou d'étendre une fonctionnalité standard par une version adaptée à une région.

## Configuration de base

Pour activer les hooks régionaux dans HRMS, vous devez d'abord configurer votre instance pour une région spécifique. Cela se fait via un fichier de configuration Python.

### Étape 1 : Créer un module régional

Créez un nouveau module dans votre application personnalisée (par exemple `hrms_regional`) avec la structure suivante :

```text
hrms_regional/
├── __init__.py
├── hooks.py
└── payroll/
    └── overrides.py
```

### Étape 2 : Déclarer le module régional

Dans le fichier `hooks.py` de votre module, déclarez les overrides régionaux :

```python
# hrms_regional/hooks.py
from frappe import _

app_include_js = ["public/js/hrms_regional.js"]

regional_overrides = {
    "France": "hrms_regional.payroll.overrides.france"
}
```

### Étape 3 : Implémenter les overrides

Dans le fichier `overrides.py`, implémentez la logique spécifique à votre région. Par exemple, pour la France :

```python
# hrms_regional/payroll/overrides/france.py
def apply_regional_deductions(salary_slip):
    """Applique les déductions spécifiques à la France."""
    # Exemple : Déduction pour frais professionnels
    if salary_slip.get("designation") == "Cadre":
        salary_slip.append("deductions", {
            "salary_component": "Frais professionnels",
            "amount": 100.0
        })
    
    return salary_slip
```

## Utilisation des hooks régionaux dans les bulletins de salaire

Le hook régional est automatiquement appelé avant le calcul final des totaux du bulletin de salaire. Voici comment cela fonctionne :

1. Un bulletin de salaire est généré pour un employé.
2. Dokos vérifie si un override régional est configuré pour le pays de l'employé.
3. Si un override existe, la fonction `apply_regional_deductions` (ou équivalente) est appelée.
4. Les déductions ou ajustements régionaux sont appliqués.
5. Le calcul final du salaire est effectué.

### Exemple : Bulletin de salaire pour un employé en France

**Scénario** :

- Employé : Jean Dupont (Cadre chez Maison Verte SARL)
- Salaire de base : 3 000 €
- Région : France

**Résultat attendu** :

- Une déduction de 100 € pour frais professionnels est appliquée.

::mermaid
flowchart TD
A\[Génération du bulletin de salaire] --> B{Vérification de la région}
B -->|France| C\[Appel de apply\_regional\_deductions]
C --> D\[Application des déductions spécifiques]
D --> E\[Calcul final du salaire]
B -->|Autre région| E

::

## Bonnes pratiques

1. **Modularité** : Gardez chaque override régional dans un fichier séparé pour faciliter la maintenance.
2. **Documentation** : Documentez chaque déduction ou ajustement régional dans le code.
3. **Tests** : Testez toujours vos overrides avec des données réelles avant de les déployer en production.
4. **Compatibilité** : Assurez-vous que vos overrides n'entrent pas en conflit avec d'autres personnalisations.

## Dépannage

### Problème : Le hook régional n'est pas appelé

1. Vérifiez que le pays de l'employé est correctement configuré dans son profil.
2. Assurez-vous que le module régional est bien installé et activé.
3. Vérifiez que le nom de la région dans `regional_overrides` correspond exactement au pays configuré.

### Problème : Les déductions ne sont pas appliquées

1. Vérifiez que la fonction `apply_regional_deductions` est correctement implémentée.
2. Assurez-vous que les conditions dans votre code sont correctes (par exemple, la désignation de l'employé).
3. Consultez les logs de Dokos pour identifier d'éventuelles erreurs.

## Exemple complet : Configuration pour la Belgique

Pour illustrer, voici comment configurer un hook régional pour la Belgique :

### Fichier `hooks.py`

```python
regional_overrides = {
    "Belgique": "hrms_regional.payroll.overrides.belgique"
}
```

### Fichier `belgique.py`

```python
# hrms_regional/payroll/overrides/belgique.py
def apply_regional_deductions(salary_slip):
    """Applique les déductions spécifiques à la Belgique."""
    # Exemple : Précompte professionnel
    if salary_slip.get("monthly_salary") > 2500:
        precompte = salary_slip.monthly_salary * 0.25
        salary_slip.append("deductions", {
            "salary_component": "Précompte professionnel",
            "amount": precompte
        })
    
    return salary_slip
```

### Résultat

Pour un employé en Belgique avec un salaire mensuel de 3 000 €, une déduction de 750 € (25%) pour le précompte professionnel sera automatiquement appliquée.

\::: tip
Pour plus d'informations sur la personnalisation des salaires, consultez la [documentation officielle de Frappe HRMS](https://docs.frappe.io){rel="&#x22;nofollow&#x22;"}.
\:::


# Personnalisation des onglets dans les formulaires

Dokos vous permet de personnaliser dynamiquement les onglets affichés dans vos formulaires en fonction de règles métiers spécifiques. Cette fonctionnalité est particulièrement utile pour :

- Masquer des onglets non pertinents pour certains utilisateurs
- Renommer des onglets pour les adapter à votre terminologie interne
- Contrôler l'onglet actif par défaut selon le contexte

## Configuration des overrides d'onglets

Les overrides d'onglets fonctionnent de manière similaire aux overrides de champs et s'appliquent après la résolution du layout du formulaire.

### Syntaxe de base

```javascript
{
  "overrides": {
    "tab": {
      "Nom de l'onglet": {
        "hidden": 1,
        "label": "Nouveau libellé"
      }
    }
  }
}
```

### Exemple pratique

**Scénario** : Dans le formulaire Client, vous souhaitez masquer l'onglet "Comptabilité" pour les clients de type "Particulier" et renommer l'onglet "Détails" en "Informations principales".

1. Créez un script client pour le DocType "Client" :

```javascript
frappe.ui.form.on('Client', {
  refresh(frm) {
    if (frm.doc.type_client === "Particulier") {
      frm.set_df_property('tab', 'hidden', 1, 'Comptabilité');
      frm.set_df_property('tab', 'label', "Informations principales", 'Détails');
    }
  }
});
```

2. Le résultat :

- Pour un client professionnel : tous les onglets sont visibles
- Pour un client particulier : l'onglet Comptabilité est masqué et l'onglet Détails est renommé

::mermaid
flowchart TD
A\[Ouverture formulaire Client] --> B{Type client ?}
B -->|Professionnel| C\[Afficher tous les onglets]
B -->|Particulier| D\[Masquer Comptabilité
Renommer Détails]

::

## Contrôle de l'onglet actif

La nouvelle propriété `update:activeTab` vous permet de connaître l'onglet effectivement affiché après résolution des règles de visibilité.

### Cas d'usage

**Scénario** : Vous souhaitez afficher un message d'avertissement uniquement lorsque l'utilisateur consulte l'onglet "Commandes" d'un fournisseur.

```javascript
frappe.ui.form.on('Fournisseur', {
  onload(frm) {
    frm.on('update:activeTab', (tabIdentity) => {
      if (tabIdentity === "Commandes") {
        frappe.show_alert({
          message: "Vérifiez les délais de livraison avant toute nouvelle commande",
          indicator: 'orange'
        });
      }
    });
  }
});
```

## Bonnes pratiques

1. **Identité des onglets** : L'identité d'un onglet est déterminée par son libellé d'origine. Si vous renommez un onglet, son identité reste inchangée pour les références dans le code.
2. **Règles de dépendance** : Les overrides s'appliquent après la résolution des `depends_on`, ce qui permet à une règle `show()` de lever un masquage conditionnel.
3. **Consistance** : Utilisez la fonction `tabStripLabel` pour obtenir le libellé affiché d'un onglet et maintenir la cohérence avec l'interface.

```javascript
const displayedLabel = frappe.ui.form.tabStripLabel(frm, "Détails");
```

4. **Tests** : Vérifiez toujours le comportement avec différents jeux de données pour vous assurer que les règles s'appliquent comme prévu.

## Exemple complet avec données demo

**Configuration pour le formulaire Fournisseur "Bureau Moderne"** :

1. Masquer l'onglet "Comptabilité" si le fournisseur n'a pas de compte bancaire enregistré
2. Renommer l'onglet "Détails" en "Informations générales"
3. Afficher un message lorsque l'onglet "Produits" est actif

```javascript
frappe.ui.form.on('Fournisseur', {
  refresh(frm) {
    // 1. Masquer Comptabilité si pas de compte bancaire
    if (!frm.doc.account) {
      frm.set_df_property('tab', 'hidden', 1, 'Comptabilité');
    }

    // 2. Renommer l'onglet Détails
    frm.set_df_property('tab', 'label', "Informations générales", 'Détails');

    // 3. Message pour l'onglet Produits
    frm.on('update:activeTab', (tabIdentity) => {
      if (tabIdentity === "Produits") {
        frappe.show_alert({
          message: `Ce fournisseur propose ${frm.doc.items_distributed || 0} produits dans notre catalogue`,
          indicator: 'blue'
        });
      }
    });
  }
});
```

\::: tip
Pour les formulaires complexes, envisagez de créer des scripts séparés pour chaque règle métier afin de faciliter la maintenance.
\:::

\::: warning
Les overrides d'onglets ne fonctionnent pas dans les vues de type PanelLayout (comme les panneaux latéraux), où tous les champs sont affichés en liste continue.
\:::


# Personnalisation de l'accès aux fichiers

Dokos permet de personnaliser les règles d'accès aux fichiers en utilisant des hooks de développement. Ces hooks permettent aux applications installées de modifier dynamiquement les permissions, offrant une flexibilité accrue pour des cas d'usage spécifiques comme les intégrations avec des services externes (ex: Drive).

## Hook pour contourner les permissions des fichiers

Un nouveau hook a été introduit pour permettre à une application (comme **Drive**) de contourner les vérifications de permissions par défaut sur les fichiers. Ce hook est particulièrement utile lorsque des règles de permissions spécifiques doivent être appliquées, indépendamment des configurations standards de Dokos.

### Utilisation du hook

Pour activer ce hook, une application doit le déclarer dans son fichier `hooks.py` comme suit :

```python
# hooks.py
def overwrite_file_permissions():
    return True  # Active le contournement des permissions
```

### Comportement et implications

- **Activation** : Dès qu'une application active ce hook (`return True`), **toutes les vérifications de permissions sur les fichiers sont désactivées** pour tous les utilisateurs, y compris les invités.
- **Priorité** : Si plusieurs applications définissent ce hook, une valeur `False` prendra le dessus sur `True` (le contournement ne sera pas activé).
- **Sécurité** : Ce hook doit être utilisé avec prudence, car il peut exposer des fichiers sensibles si mal configuré. Il est recommandé de l'activer uniquement pour des cas d'usage spécifiques et contrôlés.

### Exemple d'utilisation avec Drive

Supposons que vous utilisiez l'application **Drive** pour gérer des fichiers partagés avec des utilisateurs externes. Voici comment ce hook peut être utilisé pour garantir que les permissions de Drive priment sur celles de Dokos :

1. **Déclarer le hook dans `hooks.py`** :

   ```python
   # apps/drive/hooks.py
   ```

def overwrite\_file\_permissions():
return True

```text

2. **Vérifier l'impact** :
- Tous les fichiers gérés par Drive seront accessibles sans vérification de permissions.
- Les autres fichiers (non gérés par Drive) resteront soumis aux règles de permissions standards.

### Bonnes pratiques

- **Limitez l'utilisation** : Ce hook doit être réservé aux applications qui nécessitent un contrôle total sur les permissions des fichiers, comme les intégrations avec des services de stockage externes.
- **Documentez les risques** : Informez les administrateurs que l'activation de ce hook peut exposer des fichiers sensibles à des utilisateurs non autorisés.
- **Testez en environnement contrôlé** : Avant de déployer ce hook en production, vérifiez son impact dans un environnement de test.

### Diagramme de flux

Voici un aperçu du fonctionnement du hook dans le processus de vérification des permissions :

<mermaid>
flowchart TD
 A[Demande d'accès à un fichier] --> B{Vérification du hook
`overwrite_file_permissions`}
 B -->|True| C[Accès autorisé
sans vérification]
 B -->|False| D[Vérification des permissions
standards]
 D --> E{Permissions accordées ?}
 E -->|Oui| C
 E -->|Non| F[Accès refusé]
</mermaid>

## Autres hooks pour les fichiers

Dokos propose également d'autres hooks pour personnaliser l'accès aux fichiers :

- **`has_permission`** : Permet de définir des règles de permissions personnalisées pour un type de document spécifique.
- **`get_permission_query_conditions`** : Filtre les requêtes pour restreindre l'accès aux fichiers en fonction des rôles ou des utilisateurs.

Pour plus d'informations sur ces hooks, consultez la [documentation officielle de Frappe](https://frappeframework.com/docs/user/en/api/hooks).

:::dokos
Cette fonctionnalité est destinée aux développeurs et administrateurs système. Une mauvaise configuration peut compromettre la sécurité des fichiers.
:::
```


# Suivi d'utilisation (Télémétrie)

Dodock intègre un mécanisme léger de **télémétrie** qui collecte des données d'utilisation anonymisées sur les instances récentes. Ces données aident l'équipe Dokos à comprendre quelles fonctionnalités sont les plus utilisées et à orienter les priorités de développement.

::callout{type="info"}
La télémétrie ne collecte **aucune donnée personnelle** ni aucun contenu métier (noms de clients, montants, documents…). Seules des informations de navigation agrégées et anonymisées sont transmises.
::

## Fonctionnement général

Le module de télémétrie s'appuie sur un fournisseur interne appelé **Pulse**. Il s'initialise au démarrage de l'interface et enregistre des événements discrets tout au long de la session de l'utilisateur.

::mermaid
sequenceDiagram
participant Navigateur
participant RouteurFrappe
participant Pulse
participant FileAttente
participant Serveur as API Dodock


```text
Navigateur->>Pulse: init()
Pulse->>Pulse: register_pageview_handler()
Pulse->>RouteurFrappe: on("change", handler)

Navigateur->>RouteurFrappe: navigation vers une page
RouteurFrappe-->>Pulse: événement "change"
Pulse->>Pulse: scrub_route() — suppression des identifiants
Pulse->>FileAttente: add({ event: "pageview", route })

alt file pleine ou intervalle écoulé
    FileAttente->>Serveur: envoi du lot d'événements
    Serveur-->>FileAttente: succès / erreur (3 tentatives)
end

Navigateur->>Pulse: fermeture de l'onglet (beforeunload)
Pulse->>Serveur: sendBeacon() — envoi des événements restants
```
::

## Capture des vues de pages

Depuis la version intégrant la MR #39991, Dodock enregistre automatiquement un événement `pageview` à chaque changement de route dans l'interface.

### Conditions d'activation

La capture des vues de pages est activée uniquement pour les **instances récentes** (sites dont l'ancienneté est inférieure à un seuil configuré). Les instances plus anciennes ne sont pas concernées afin d'éviter tout impact sur des environnements de production établis.

### Données collectées

Pour chaque vue de page, l'événement transmis contient uniquement la **route nettoyée**, c'est-à-dire le chemin de navigation dans l'application sans aucun identifiant de document.

Exemples de transformation :

| Route brute naviguée                | Route transmise           |
| ----------------------------------- | ------------------------- |
| `/app/purchase-order/PO-2025-00042` | `/app/purchase-order`     |
| `/app/customer/Maison Verte SARL`   | `/app/customer`           |
| `/app/item` (liste)                 | `/app/item`               |
| `/app/Form/Sales Invoice`           | `/app/Form/Sales Invoice` |

La fonction `scrub_route` supprime le troisième segment de la route lorsqu'il correspond à un nom de document (différent du type de document). Les listes et les pages de configuration ne sont pas modifiées.

### Idempotence

Le gestionnaire de vues de pages (`register_pageview_handler`) n'est enregistré qu'**une seule fois** par session, même si `init()` est appelé plusieurs fois. Cela évite les doublons d'événements lors de rechargements partiels de l'interface.

### Gestion des erreurs

Toute erreur survenant lors de la capture ou de l'envoi d'un événement est silencieusement ignorée (bloc `try/catch`). La télémétrie ne peut donc pas interrompre ni dégrader l'expérience utilisateur.

## Envoi des données

Les événements sont mis en **file d'attente locale** et envoyés par lot au serveur selon deux déclencheurs :

1. **Intervalle de temps** : la file est vidée périodiquement.
2. **Fermeture de l'onglet** : les événements restants sont envoyés via `navigator.sendBeacon()` pour garantir leur transmission même lors d'une fermeture abrupte du navigateur.

En cas d'échec de l'envoi, le système effectue jusqu'à **3 tentatives** avant d'abandonner.

## Désactivation

La télémétrie peut être désactivée au niveau de l'instance dans les paramètres système de Dodock. Lorsqu'elle est désactivée, aucun événement n'est capturé ni transmis.

::callout{type="tip"}
Pour les environnements entièrement isolés du réseau (air-gap), la désactivation de la télémétrie est recommandée afin d'éviter des tentatives de connexion sortantes inutiles.
::


# Boîte de dialogue À propos

La boîte de dialogue **À propos** vous permet de consulter les versions des applications installées sur votre instance Dokos et de les copier facilement pour les partager avec le support technique ou les intégrateurs.

## Accéder à la boîte de dialogue

1. Cliquez sur votre **photo de profil** en haut à droite de l'écran.
2. Sélectionnez **À propos** dans le menu déroulant.

![Accès à la boîte de dialogue À propos](https://doc.dokos.io/docs/assets/figures/dodock/about-dialog-access.png){.shadow-lg.rounded-lg}


Menu d'accès à la boîte de dialogue À propos

## Fonctionnalités disponibles

### Copier toutes les versions des applications

Un bouton **Copier les versions des applications** est disponible en haut de la boîte de dialogue. En cliquant dessus, vous copiez dans votre presse-papiers un résumé de toutes les applications installées avec leurs versions respectives, au format JSON.

**Exemple de résultat copié :**

```json
{
  "dokos": "5.x.x-develop (abc1234)",
  "frappe": "17.x.x-develop (def5678)",
  "erpnext": "17.x.x-develop (ghi9012)",
  "hrms": "17.0.0-dev",
  "mon_application_personnalisee": "0.0.1"
}
```

### Copier la version d'une application spécifique

Chaque ligne d'application est cliquable. En cliquant sur une ligne, vous copiez uniquement le nom et la version de cette application dans votre presse-papiers.

**Exemple de résultat pour une seule application :**

```text
erpnext: 17.0.0-dev
```

![Fonctionnalités de la boîte de dialogue À propos](https://doc.dokos.io/docs/assets/figures/dodock/about-dialog-features.png){.shadow-lg.rounded-lg}


Bouton de copie globale et lignes cliquables

### Accessibilité

- **Navigation au clavier** : Vous pouvez naviguer entre les lignes d'applications à l'aide de la touche **Tab**.
- **Curseur** : Le curseur change en **pointeur** lorsque vous survolez une ligne d'application, indiquant qu'elle est cliquable.

## Cas d'usage

Cette fonctionnalité est particulièrement utile lorsque :

- Vous contactez le **support technique** et devez fournir les versions exactes de vos applications.
- Vous travaillez avec un **intégrateur** qui a besoin de connaître votre environnement pour diagnostiquer un problème.
- Vous gérez **plusieurs instances Dokos** et souhaitez comparer les versions des applications installées.

\::: tip Astuce
Pour coller le contenu copié, utilisez le raccourci **Ctrl + V** (ou **Cmd + V** sur Mac) dans n'importe quel éditeur de texte ou champ de saisie.
\:::


# Rédaction des emails sensibles après envoi

Dokos protège automatiquement les informations sensibles contenues dans certains emails en masquant leur contenu **après** leur envoi réussi. Cette fonctionnalité s'applique notamment aux emails de bienvenue et de réinitialisation de mot de passe.

## Pourquoi cette fonctionnalité ?

Lorsqu'un utilisateur reçoit un email contenant des informations sensibles comme un lien de réinitialisation de mot de passe, ces données ne doivent pas rester stockées en clair dans la base de données. Auparavant, le masquage intervenait trop tôt, ce qui pouvait empêcher l'envoi correct de l'email en cas de tentative ultérieure (par exemple si le serveur SMTP était temporairement indisponible).

Avec cette amélioration, Dokos :

- Conserve le message complet tant que l'email n'est pas envoyé avec succès
- Remplace le contenu par un message générique **uniquement après confirmation de l'envoi**
- Garantit que l'utilisateur reçoit toujours le contenu complet
- Élimine les risques de stockage prolongé des données sensibles

## Fonctionnement technique

1. **Création de l'email** : Le message est généré avec toutes ses informations (lien de réinitialisation, etc.)
2. **Tentative d'envoi** : Dokos tente d'envoyer l'email via le serveur SMTP configuré
3. **Confirmation d'envoi** : Si l'envoi réussit, le système remplace immédiatement le contenu sensible par un message de masquage
4. **Stockage sécurisé** : Seule la version masquée reste dans la base de données

::mermaid
flowchart TD
A\[Création email] --> B\[Tentative d'envoi]
B -->|Succès| C\[Masquage du contenu]
B -->|Échec| D\[Conservation du message complet]
D --> B
C --> E\[Stockage version masquée]

::

## Emails concernés

Cette protection s'applique automatiquement aux :

- Emails de bienvenue envoyés lors de la création d'un compte utilisateur
- Emails de réinitialisation de mot de passe

## Configuration

Aucune configuration n'est nécessaire - la fonctionnalité est activée par défaut. Pour les développeurs souhaitant l'appliquer à d'autres types d'emails, il est possible de passer le paramètre `redact_message_after_send=True` lors de l'appel à `frappe.sendmail()`.

## Vérification du fonctionnement

Pour confirmer que la fonctionnalité fonctionne correctement :

1. Allez dans **Email > File d'attente des emails**
2. Envoyez un email de réinitialisation de mot de passe à un utilisateur test
3. Une fois l'email marqué comme "Envoyé", ouvrez-le dans la file d'attente
4. Vous devriez voir un message de ce type :

```text
Ce message a été masqué après envoi pour protéger les informations sensibles.
```

## Bonnes pratiques

- **Ne modifiez pas manuellement** les emails dans la file d'attente après leur envoi
- **Vérifiez régulièrement** que vos templates d'emails de bienvenue et de réinitialisation contiennent bien toutes les informations nécessaires
- **Testez systématiquement** les processus de création de compte et de réinitialisation de mot de passe après toute mise à jour

## Résolution des problèmes

Si un utilisateur ne reçoit pas son email de réinitialisation :

1. Vérifiez d'abord que l'email n'est pas dans les spams
2. Consultez la file d'attente des emails pour voir son statut
3. Si l'email est marqué comme "Non envoyé", vérifiez :


   - La configuration SMTP dans **Paramètres > Email > Paramètres Email**
   - Que le serveur SMTP est accessible
   - Les logs système pour d'éventuelles erreurs

\::: info
Cette fonctionnalité est disponible à partir de la version 16.28.0 de Dokos.
\:::


# Créer un formulaire web

Les formulaires web dans Dokos permettent de collecter des informations depuis des utilisateurs externes sans nécessiter de compte utilisateur. Ils sont idéaux pour des enquêtes, des inscriptions, ou des demandes d'informations.

## Configuration de base

1. Allez dans **Développeur > Site Web > Formulaire Web**.
2. Cliquez sur **Nouveau**.
3. Remplissez les champs suivants :

   - **Nom du formulaire** : Un identifiant unique pour le formulaire.
   - **Type de document** : Le type de document (doctype) qui sera créé ou mis à jour via ce formulaire.
   - **Route** : L'URL où le formulaire sera accessible (ex: `/enquete-satisfaction`).
   - **Titre** : Le titre affiché en haut du formulaire.
   - **Introduction** : Un texte d'introduction pour guider l'utilisateur.
4. Sauvegardez le formulaire.

## Configurer les champs du formulaire

1. Dans l'onglet **Champs**, ajoutez les champs que vous souhaitez afficher dans le formulaire.
2. Pour chaque champ, vous pouvez définir :


   - **Libellé** : Le nom affiché pour le champ.
   - **Champ requis** : Si le champ doit être obligatoire.
   - **Masqué** : Si le champ doit être masqué (utile pour les valeurs pré-remplies).

## Configurer les permissions

1. Dans l'onglet **Permissions**, configurez les options suivantes :


   - **Accès requis par clé** : Activez cette option si vous souhaitez restreindre l'accès au formulaire via une clé unique (voir [Utiliser les requêtes de formulaire web](https://doc.dokos.io/#utiliser-les-requ%C3%AAtes-de-formulaire-web)).
   - **Connexion requise** : Si l'utilisateur doit être connecté pour accéder au formulaire.
   - **Autoriser l'édition** : Si les utilisateurs peuvent modifier les documents existants via ce formulaire.
   - **Autoriser les soumissions multiples** : Si un même utilisateur peut soumettre plusieurs fois le formulaire.
   - **Autoriser la suppression** : Si les utilisateurs peuvent supprimer des documents via ce formulaire.
   - **Afficher la liste** : Si les utilisateurs peuvent voir la liste des documents créés via ce formulaire.

## Utiliser les requêtes de formulaire web

Les **Requêtes de formulaire web** permettent de générer des liens uniques pour des utilisateurs spécifiques, avec des données pré-remplies. Cela est particulièrement utile pour les enquêtes de satisfaction ou les invitations personnalisées.

### Créer une requête de formulaire web

1. Allez dans **Développeur > Site Web > Requête de formulaire web**.
2. Cliquez sur **Nouveau**.
3. Remplissez les champs suivants :

   - **Formulaire web** : Sélectionnez le formulaire web associé.
   - **Clé** : Une clé unique sera générée automatiquement. Vous pouvez la modifier si nécessaire.
   - **Date d'expiration** : Définissez une date d'expiration pour la requête (optionnel).
   - **Valeurs du formulaire** : Ajoutez des valeurs pré-remplies qui seront affichées à l'utilisateur (ex: `{"nom": "Maison Verte SARL"}`).
   - **Valeurs du document** : Ajoutez des valeurs cachées qui seront appliquées lors de la soumission (ex: `{"client": "Maison Verte SARL"}`).
   - **Références** : Ajoutez des documents existants qui pourront être modifiés ou consultés via cette requête (ex: un document **Client** spécifique).
4. Sauvegardez la requête.

### Partager le lien de la requête

Une fois la requête créée, vous pouvez partager le lien suivant avec l'utilisateur :

```text
https://votre-site.dokos.cloud/<route-du-formulaire>?key=<clé-de-la-requête>
```

Par exemple :

```text
https://votre-site.dokos.cloud/enquete-satisfaction?key=abc123xyz
```

### Comportement des requêtes

- **Accès restreint** : Seuls les utilisateurs avec une clé valide peuvent accéder au formulaire.
- **Données pré-remplies** : Les valeurs définies dans **Valeurs du formulaire** sont affichées et modifiables par l'utilisateur.
- **Données cachées** : Les valeurs définies dans **Valeurs du document** sont appliquées lors de la soumission sans être visibles par l'utilisateur.
- **Modification de documents existants** : Si des documents sont référencés dans la requête, l'utilisateur peut les modifier ou les consulter via le même lien.
- **Soumissions multiples** : Si **Autoriser les soumissions multiples** est activé, l'utilisateur peut soumettre plusieurs fois le formulaire.
- **Liste des documents** : Si **Afficher la liste** est activé, l'utilisateur peut voir la liste des documents créés ou référencés via cette requête.

## Exemple d'utilisation : Enquête de satisfaction client

### Scénario

Vous souhaitez envoyer une enquête de satisfaction à un client spécifique, **Maison Verte SARL**, sans lui donner accès à la liste complète de vos clients.

### Étapes

1. **Créer le formulaire web** :

   - **Nom du formulaire** : `enquete-satisfaction`
   - **Type de document** : `Enquête de satisfaction`
   - **Route** : `/enquete-satisfaction`
   - **Titre** : `Enquête de satisfaction client`
   - **Introduction** : `Merci de prendre quelques minutes pour répondre à cette enquête.`
   - Activez **Accès requis par clé** dans les permissions.
2. **Ajouter les champs** :

   - `note` (Type : Entier, Libellé : `Note sur 10`)
   - `commentaire` (Type : Texte long, Libellé : `Commentaires`)
3. **Créer une requête de formulaire web** :

   - **Formulaire web** : `enquete-satisfaction`
   - **Valeurs du formulaire** : `{"client": "Maison Verte SARL"}`
   - **Valeurs du document** : `{"client_associe": "Maison Verte SARL"}`
   - **Références** : Ajoutez le document **Client** `Maison Verte SARL` si vous souhaitez permettre à l'utilisateur de consulter ou modifier ses informations.
4. **Partager le lien** :
   Envoyez le lien suivant au client :
   ```text
   https://votre-site.dokos.cloud/enquete-satisfaction?key=abc123xyz
   ```
5. **Résultat** :

   - Le client accède au formulaire avec son nom pré-rempli.
   - Il peut soumettre l'enquête sans voir les autres clients.
   - Les données soumises sont enregistrées dans un document **Enquête de satisfaction** avec le champ `client_associe` automatiquement rempli.

## Bonnes pratiques

- **Sécurité** : Utilisez toujours des clés uniques et des dates d'expiration pour les requêtes sensibles.
- **Expérience utilisateur** : Privilégiez des formulaires courts et clairs pour maximiser le taux de réponse.
- **Suivi** : Utilisez le champ `first_used_on` dans les requêtes pour suivre quand un utilisateur a accédé au formulaire pour la première fois.
- **Personnalisation** : Utilisez les **Valeurs du formulaire** pour personnaliser l'expérience utilisateur (ex: afficher le nom du client).

::mermaid
flowchart TD
A\[Créer un formulaire web] --> B\[Configurer les champs]
B --> C\[Configurer les permissions]
C --> D\[Créer une requête de formulaire web]
D --> E\[Partager le lien avec la clé]
E --> F\[Utilisateur soumet le formulaire]
F --> G\[Données enregistrées dans Dokos]
::


# Gestion des utilisateurs

Dodock vous permet de gérer efficacement les utilisateurs de votre système, y compris l'invitation de nouveaux utilisateurs et la gestion de leurs accès.

## Inviter un nouvel utilisateur

Pour inviter un nouvel utilisateur à rejoindre votre instance Dokos :

1. Allez dans **Paramètres > Utilisateurs > Utilisateur**
2. Cliquez sur **Nouveau**
3. Remplissez les informations requises (nom, prénom, email)
4. Sélectionnez le rôle approprié
5. Cliquez sur **Enregistrer**
6. Un email d'invitation sera envoyé à l'utilisateur avec un lien pour créer son mot de passe

## Renvoi d'une invitation utilisateur

Dans certains cas, l'email d'invitation peut ne pas parvenir à son destinataire ou expirer. Dodock offre maintenant la possibilité de renvoyer une invitation utilisateur :

### Depuis l'interface

1. Allez dans **Paramètres > Utilisateurs > Invitation utilisateur**
2. Recherchez l'invitation concernée
3. Cliquez sur le bouton **Renvoyer l'invitation** dans la barre d'outils
4. Confirmez l'action dans la boîte de dialogue

::mermaid
sequenceDiagram
participant Admin as Administrateur
participant System as Système Dokos
participant User as Utilisateur


```text
Admin->>System: Clique sur "Renvoyer l'invitation"
System->>System: Vérifie le statut de l'invitation
System->>User: Envoie un nouvel email d'invitation
User->>System: Clique sur le lien d'invitation
System->>User: Affiche le formulaire de création de mot de passe
```
::

### Via l'API

Les développeurs peuvent également renvoyer une invitation via l'API :

```python
import frappe

# Renvoyer une invitation utilisateur
doc = frappe.get_doc("User Invitation", "nom-de-l-invitation")
doc.resend_invitation()
```

\::: info
Le renvoi d'invitation est particulièrement utile dans les cas suivants :

- L'email original a été perdu ou n'est pas arrivé
- L'invitation a expiré (généralement après 48 heures)
- L'utilisateur n'a pas complété la création de son compte
  \:::

## Gestion des rôles et permissions

Dodock utilise un système de rôles et permissions pour contrôler l'accès aux différentes fonctionnalités :

1. Allez dans **Paramètres > Utilisateurs > Rôle**
2. Créez ou modifiez un rôle existant
3. Définissez les permissions pour chaque module et document
4. Assignez le rôle aux utilisateurs appropriés

## Désactiver un utilisateur

Pour désactiver temporairement un utilisateur :

1. Allez dans **Paramètres > Utilisateurs > Utilisateur**
2. Ouvrez le document de l'utilisateur concerné
3. Décochez la case **Actif**
4. Enregistrez les modifications

\::: warning
La désactivation d'un utilisateur ne supprime pas ses données mais empêche simplement son accès au système.
\:::

## Réinitialisation du mot de passe

Pour réinitialiser le mot de passe d'un utilisateur :

1. Allez dans **Paramètres > Utilisateurs > Utilisateur**
2. Ouvrez le document de l'utilisateur
3. Cliquez sur **Réinitialiser le mot de passe*&#x2A; dans le menu &#x2A;*...**
4. Un email de réinitialisation sera envoyé à l'utilisateur

## Bonnes pratiques

- Utilisez des rôles spécifiques plutôt que des rôles génériques comme "System Manager"
- Limitez le nombre d'utilisateurs avec des privilèges administratifs
- Vérifiez régulièrement les utilisateurs inactifs
- Utilisez la fonction de renvoi d'invitation pour les utilisateurs qui n'ont pas complété leur inscription
- Documentez les procédures d'accès pour les nouveaux utilisateurs


# Vérification des images Dokos et notifications en cas d'échec

Dokos intègre un mécanisme de vérification automatique des images Docker après leur construction dans le cadre de son pipeline CI/CD. Ce processus permet de s'assurer que les images générées sont fonctionnelles et de notifier les administrateurs en cas d'échec.

## Processus de vérification

Après la construction d'une image Dokos dans le pipeline GitLab CI, les étapes suivantes sont exécutées automatiquement :

1. **Vérification de l'image** : L'image Docker est lancée pour confirmer qu'elle démarre correctement.
2. **Tests de santé** : Des requêtes sont effectuées pour vérifier que les services essentiels (comme le serveur web) répondent.
3. **Journalisation** : Les logs de démarrage sont analysés pour détecter d'éventuelles erreurs.

Si l'une de ces étapes échoue, le pipeline est marqué comme échoué et une notification est envoyée.

::mermaid
flowchart TD
A\[Construction de l'image] --> B\[Lancement de l'image]
B --> C\[Vérification des services]
C -->|Succès| D\[Pipeline réussi]
C -->|Échec| E\[Notification envoyée]
E --> F\[Pipeline échoué]

::

## Configuration des notifications

Les notifications en cas d'échec de construction ou de vérification des images sont envoyées via les canaux configurés dans GitLab. Voici comment personnaliser ces notifications :

### 1. Configurer les destinataires

Pour recevoir les notifications, vous devez configurer les destinataires dans le fichier `.gitlab-ci.yml` :

```yaml
notifications:
  email:
    to:
      - admin@votredomaine.com
      - equipe-dev@votredomaine.com
```

### 2. Personnaliser le message de notification

Le message de notification peut être personnalisé pour inclure des informations spécifiques à votre environnement. Voici un exemple de configuration :

```yaml
notify_failure:
  script:
    - |
      echo "La construction de l'image Dokos a échoué. Consultez les logs du pipeline pour plus de détails : $CI_PIPELINE_URL" | mail -s "[Dokos] Échec de la construction de l'image" $NOTIFICATION_EMAILS
```

### 3. Intégration avec des outils externes

Vous pouvez également configurer des intégrations avec des outils comme Slack ou Mattermost pour recevoir les notifications directement dans vos canaux de communication :

```yaml
notify_slack:
  script:
    - curl -X POST -H 'Content-type: application/json' --data "{\"text\":\"La construction de l'image Dokos a échoué. Consultez les logs : $CI_PIPELINE_URL\"}" $SLACK_WEBHOOK_URL
```

## Bonnes pratiques

- **Surveillance proactive** : Configurez des alertes pour être informé immédiatement en cas d'échec.
- **Journalisation** : Conservez les logs des pipelines pour faciliter le débogage.
- **Tests réguliers** : Vérifiez périodiquement que les notifications fonctionnent en simulant un échec.

## Exemple de configuration complète

Voici un extrait du fichier `.gitlab-ci.yml` illustrant la configuration de la vérification des images et des notifications :

```yaml
check_image:
  stage: test
  script:
    - docker run -d --name dokos_test $CI_REGISTRY_IMAGE:$CI_COMMIT_REF_SLUG
    - sleep 30
    - docker exec dokos_test curl -s http://localhost:8000/api/method/ping || exit 1
    - docker logs dokos_test > build.log
    - grep -q "Site dokos initialized" build.log || exit 1
  after_script:
    - docker stop dokos_test && docker rm dokos_test

notify_failure:
  stage: .post
  script:
    - |
      if [ $CI_JOB_STATUS == "failed" ]; then
        echo "La vérification de l'image Dokos a échoué. Pipeline : $CI_PIPELINE_URL" | mail -s "[Dokos] Échec de la vérification de l'image" admin@votredomaine.com
      fi
  when: on_failure
```

## Dépannage

Si les notifications ne sont pas reçues :

- Vérifiez que les adresses e-mail ou les webhooks sont correctement configurés.
- Consultez les logs du job `notify_failure` dans GitLab CI pour identifier les erreurs.
- Assurez-vous que le serveur SMTP ou l'outil externe (Slack, Mattermost) est accessible depuis le runner GitLab.


# Intégrations

Dodock et Dokos disposent d'un certains nombre d'intégrations natives et certaines sont disponibles via les applications additionnelles proposées ci-dessous.

::card-group
  :::card
  ---
  icon: i-ic-twotone-payments
  title: Payments
  to: https://doc.dokos.io/v5/integrations/payments
  ---
  Application permettant les paiements via Stripe, Braintree, Paypal, etc...
  :::

  :::card
  ---
  icon: i-clarity-digital-signature-line
  title: eSignature
  to: https://doc.dokos.io/v5/integrations/esignature
  ---
  Application permettant la signature électronique via Adobe Sign
  :::

  :::card
  ---
  icon: i-logos-woocommerce-icon
  title: Dokos Woocommerce
  to: https://doc.dokos.io/v5/integrations/woocommerce
  ---
  Application permettant la synchronisation des commandes WooCommerce dans Dokos
  :::

  :::card
  ---
  icon: i-ic-baseline-point-of-sale
  title: Dokos Hiboutik
  to: https://doc.dokos.io/v5/integrations/hiboutik
  ---
  Application permettant la synchronisation des commandes Hiboutik dans Dokos
  :::

  :::card
  ---
  icon: i-feather-zap
  title: Zapier
  to: https://doc.dokos.io/v5/integrations/zapier
  ---
  Application Zapier permettant de créer des flux de données via Zapier
  :::

  :::card
  ---
  icon: i-mdi-receipt-text-check-outline
  title: E-transactions
  to: https://doc.dokos.io/v5/integrations/etransaction
  ---
  Facturation électronique (UBL/CII), connexion PDP et extraction OCR des factures fournisseur via Amazon Textract
  :::

  :::card
  ---
  icon: i-mdi-robot-outline
  title: IA
  to: https://doc.dokos.io/v5/integrations/ia
  ---
  Assistant conversationnel, flux automatisés et connexion à un assistant externe comme Claude
  :::

  :::card
  ---
  icon: i-mdi-map-marker
  title: Badge inter-lieux
  to: https://doc.dokos.io/v5/federation-lieux
  ---
  Gestion du Badge inter-lieux de fédération de lieux
  :::
::


# Payments

::callout{color="teal" icon="i-heroicons-light-bulb"}
L'application Payments est une adaptation de l'application du même nom développée par [Frappe Technologies](https://github.com/frappe/payments)
::

::card-group
  :::card
  ---
  icon: i-fa6-brands-cc-stripe
  title: Intégration Stripe
  to: https://doc.dokos.io/v5/integrations/payments/stripe
  ---
  :::

  :::card
  ---
  icon: i-fa6-brands-cc-paypal
  title: Intégration Paypal
  to: https://doc.dokos.io/v5/integrations/payments/paypal
  ---
  :::

  :::card
  ---
  icon: i-simple-icons-sepa
  title: Intégration GoCardless
  to: https://doc.dokos.io/v5/integrations/payments/gocardless
  ---
  :::

  :::card
  ---
  icon: i-simple-icons-contactlesspayment
  title: Intégration Stancer
  to: https://doc.dokos.io/v5/integrations/payments/stancer
  ---
  :::

  :::card
  ---
  icon: i-simple-icons-contactlesspayment
  title: Intégration HelloAsso
  to: https://doc.dokos.io/v5/integrations/payments/helloasso
  ---
  :::

  :::card
  ---
  icon: i-arcticons-sumup
  title: Intégration SumUp
  to: https://doc.dokos.io/v5/integrations/payments/sumup
  ---
  :::
::


# Stripe

L'intégration avec [Stripe](https://stripe.com/fr){rel="&#x22;nofollow&#x22;"} permet de proposer des paiements par carte bancaire ou prélèvements SEPA sur votre site Dokos.

::logos
---
logos:
  - i-heroicons-credit-card-20-solid
  - i-simple-icons-sepa
---
::

Vous pouvez connecter votre compte Stripe à Dokos pour collecter des paiements.

::tabs
  :::div{icon="i-mdi-ev-plug-chademo" label="Fonctionnement"}
  ### Paiement ponctuel

  L'intégration Stripe peut servir pour collecter des paiements ponctuels ou récurrents par carte bancaire ou prélèvements SEPA de deux manières.

  #### 1. Génération d'un lien de paiement

  Vous pouvez générer un lien de paiement en créant une demande de paiement. :br
  Vos clients peuvent payer une commande ou facture ponctuelle. :br
  Si la demande de paiement est associée à un abonnement, la carte est enregistrée et peut servir lors d'un paiement futur.

  #### 2. Paiement sur le site e-commerce

  Si le mode de paiement associé à votre passerelle de paiement Stripe est autorisé sur le site e-commerce, vous pourrez collecter des paiements via Stripe lors d'achats sur le webshop.

  ### Enregistrement des données de paiement

  Aucune donnée de paiement n'est enregistrée sur votre site Dokos. :br
  Seules deux données sont enregistrées dans la fiche client: l'identifiant du client et l'idenfiant de la méthode de paiement par défaut utilisée. :br
  Cela permet à Dokos d'utiliser le même client Stripe et de réutiliser la méthode de paiement lorsque cela est possible.
  :::

  :::div{icon="i-mdi-checkbox-multiple-marked-outline" label="Configuration"}
  1. Paramètres Stripe
     Dans le document **Paramètres Stripe**, saisissez la clé publiable et la clé secrète fournies par Stripe. :br
     Ces clés peuvent être trouvées dans la section `Développeur > Clés API` du tableau de bord Stripe.

  Puis configurer automatiquement les webhooks sur Stripe en cliquant sur le bouton *Webhooks > Créer des webhooks Stripe*

    ::::callout{color="teal" icon="i-heroicons-light-bulb"}
    Des webhooks sont des informations envoyées de Stripe à Dokos quand le statut du paiement est mis à jour. Comme cela peut prendre plusieurs secondes après le paiement, ces informations sont envoyées séparément du flux de paiement.
    ::::

  2. Mode de paiement
     Pour pouvoir utiliser votre passerelle Stripe, vous devez créer un mode de paiement associé. :br
     Créez un mode de paiement et liez le avec votre passerelle Stripe dans l'onglet **Passerelle de paiement**. :br
     Pensez à renseigner l'onglet **Portail** pour la page de paiement.
  3. Paramètres E-commerce
     Si vous avez installé l'application **Webshop**[/dokos/e-commerce], vous devez autoriser votre nouvelle méthode de paiement dans la section **Modes de paiement autorisés** des **Paramètres E-Commerce**. :br
     Attention, cette section n'apparaît que si la caisse est activée.
  :::
::

::div{icon="i-mdi-test-tube" label="Tester"}
Vous pouvez tester cette intégration sur l'un de nos sites de démonstrations.

1. Créez une commande client ou une facture de vente
2. Créez une demande de paiement
3. A la validation de la demande de paiement, copiez-collez le lien de paiement dans un nouvel onglet pour tester le paiement sans être déjà connecté·e
::

\::


# Paypal

## Intégration avec Paypal

Afin de configurer une intégration avec Paypal, vous devez ajouter les éléments suivants:

- Ouvrez les `Paramètres Paypal`
  Allez dans `Intégrations > Paramètres Paypal`
- Ajoutez le nom d'utilisateur, le mot de passe et la signature de votre application Paypal
  Ces informations peuvent être obtenues en créant un compte sur `https://developer.paypal.com/` puis en créant une nouvelle application
- Cochez `Utiliser la sandbox` s'il s'agit d'une application Paypal de test (Sandbox)

## Usage

- [Passerelles de paiement](https://doc.dokos.io/v5/dokos/comptabilite/passerelles-paiements)


# GoCardless

::logos
---
logos:
  - i-simple-icons-sepa
---
::

Vous pouvez connecter votre compte GoCardless à Dokos pour collecter des paiements.

::tabs
  :::div{icon="i-mdi-ev-plug-chademo" label="Fonctionnement"}
  ### Paiement ponctuel

  L'intégration GoCardless peut servir pour collecter des paiements ponctuels ou récurrents par prélèvement SEPA de deux manières.

  #### 1. Génération d'un lien de paiement

  Vous pouvez générer un lien de paiement en créant une demande de paiement. :br
  Vos clients peuvent payer une commande ou facture ponctuelle. :br
  Si la demande de paiement est associée à un abonnement, la mandat de prélèvement est enregistrée et peut servir lors d'un paiement futur.

  #### 2. Paiement sur le site e-commerce

  Si le mode de paiement associé à votre passerelle de paiement GoCardless est autorisé sur le site e-commerce, vous pourrez collecter des paiements via GoCardless lors d'achats sur le webshop.

  ### Enregistrement des données de paiement

  Aucune donnée de paiement n'est enregistrée sur votre site Dokos. :br
  Seules deux données sont enregistrées dans la fiche client: l'identifiant du client et l'idenfiant de la méthode de paiement par défaut utilisée. :br
  Cela permet à Dokos d'utiliser le même client GoCardless et de réutiliser le mandat de prélèvement lorsque cela est possible.
  :::

  :::div{icon="i-mdi-checkbox-multiple-marked-outline" label="Configuration"}
  1. Paramètres GoCardless
     Dans le document **Paramètres GoCardless**, saisissez le jeton d'accès fournies par GoCardless.

  #### Webhooks

  Pour intégrer les webhooks GoCardless dans dokos, créez un nouveau `endpoint` en cliquant sur `Développeurs > Créer > Endpoint de webhook`.
  Donnez lui un nom logique et ajoutez l'URL suivante:

  `https://{votre_site}/api/method/erpnext.erpnext_integrations.doctype.gocardless_settings.webhooks?account={nom_de_votre_compte_gocardless}`

  Remplacez {votre\_site} et {nom\_de\_votre\_compte\_gocardless} par l'URL de votre site (exemple: `myerp.dokos.io`) et le nom de votre compte GoCardless dans dokos (exemple: `ABC`)

  Vous pouvez laisser le champ `Secret` libre, car il sera automatiquement généré par GoCardless.

  Enregistrez, puis copiez-collez le `Secret` généré dans vos paramètres GoCardless dans dokos.

    ::::callout{color="teal" icon="i-heroicons-light-bulb"}
    Des webhooks sont des informations envoyées de GoCardless à Dokos quand le statut du paiement est mis à jour. Comme cela peut prendre plusieurs secondes après le paiement, ces informations sont envoyées séparément du flux de paiement.
    ::::

  2. Mode de paiement
     Pour pouvoir utiliser votre passerelle GoCardless, vous devez créer un mode de paiement associé. :br
     Créez un mode de paiement et liez le avec votre passerelle GoCardless dans l'onglet **Passerelle de paiement**. :br
     Pensez à renseigner l'onglet **Portail** pour la page de paiement.
  3. Paramètres E-commerce
     Si vous avez installé l'application **Webshop**[/dokos/e-commerce], vous devez autoriser votre nouvelle méthode de paiement dans la section **Modes de paiement autorisés** des **Paramètres E-Commerce**. :br
     Attention, cette section n'apparaît que si la caisse est activée.
  :::
::

::div{icon="i-mdi-test-tube" label="Tester"}
Vous pouvez tester cette intégration sur l'un de nos sites de démonstrations.

1. Créez une commande client ou une facture de vente
2. Créez une demande de paiement
3. A la validation de la demande de paiement, copiez-collez le lien de paiement dans un nouvel onglet pour tester le paiement sans être déjà connecté·e
::

\::


# Stancer

## Intégration avec Stancer

::logos
---
logos:
  - i-heroicons-credit-card-20-solid
  - i-simple-icons-sepa
---
::

Vous pouvez connecter votre compte Stancer à Dokos pour collecter des paiements.

::tabs
  :::div{icon="i-mdi-ev-plug-chademo" label="Fonctionnement"}
  ### Paiement ponctuel

  L'intégration Stancer peut servir pour collecter des paiements ponctuels par carte bancaire de deux manières.

  #### 1. Génération d'un lien de paiement

  Vous pouvez générer un lien de paiement en créant une demande de paiement. :br
  Vos clients peuvent payer une commande ou facture ponctuelle. :br
  Si la demande de paiement est associée à un abonnement, la carte est enregistrée et peut servir lors d'un paiement futur.

  #### 2. Paiement sur le site e-commerce

  Si le mode de paiement associé à votre passerelle de paiement Stancer est autorisé sur le site e-commerce, vous pourrez collecter des paiements via Stancer lors d'achats sur le webshop.

  ### Enregistrement des données de paiement

  Aucune donnée de paiement n'est enregistrée sur votre site Dokos. :br
  Seules deux données sont enregistrées dans la fiche client: l'identifiant du client et l'idenfiant de la méthode de paiement par défaut utilisée. :br
  Cela permet à Dokos d'utiliser le même client Stancer et de réutiliser la méthode de paiement lorsque cela est possible.
  :::

  :::div{icon="i-mdi-checkbox-multiple-marked-outline" label="Configuration"}
  1. Paramètres Stancer
     Dans le document **Paramètres Stancer**, saisissez la clé publique et la clé privée fournies par Stancer. :br
     Ces éléments peuvent être récupérées sur votre compte Stancer.

  La clé secrète du Webhook sera générées automatiquement enregistrée par Dokos.

    ::::callout{type="warning"}
    Le connecteur se base sur la version 2 de l'API de Stancer. Les webhooks ne sont pas encore disponible au 01/10/2024.
    ::::

  2. Mode de paiement
     Pour pouvoir utiliser votre passerelle Stancer, vous devez créer un mode de paiement associé. :br
     Créez un mode de paiement et liez le avec votre passerelle Stancer dans l'onglet **Passerelle de paiement**. :br
     Pensez à renseigner l'onglet **Portail** pour la page de paiement.
  3. Paramètres E-commerce
     Si vous avez installé l'application **Webshop**[/dokos/e-commerce], vous devez autoriser votre nouvelle méthode de paiement dans la section **Modes de paiement autorisés** des **Paramètres E-Commerce**. :br
     Attention, cette section n'apparaît que si la caisse est activée.
  :::
::

::div{icon="i-mdi-test-tube" label="Tester"}
Vous pouvez tester cette intégration sur l'un de nos sites de démonstrations.

1. Créez une commande client ou une facture de vente
2. Créez une demande de paiement
3. A la validation de la demande de paiement, copiez-collez le lien de paiement dans un nouvel onglet pour tester le paiement sans être déjà connecté·e
::

\::


# HelloAsso

## Intégration avec HelloAsso

::callout{color="red" icon="i-heroicons-exclamation-triangle"}
Attention, prenez garde à bien confirmer que votre association est vérifiée par HelloAsso avant de configurer l'intégration des paiements HelloAsso. L'Autorité de Contrôle Prudentiel et de Résolution demande à HelloAsso de collecter et d'analyser différentes informations afin de se prémunir contre les risques de fraudes, de blanchiment d’argent et de financement d’activités terroristes.

- [Vérifier l'état de vérification de votre compte association](https://www.helloasso.com/Redirect.aspx?ref=helloasso-admin&type=authentification){rel=""nofollow""}
- [Voir l'aide liée à la vérification de votre association dans le Centre d'Aide HelloAsso](https://centredaide.helloasso.com/association?thematic=verification-de-mon-compte-association){rel=""nofollow""}
- [En savoir plus sur cette vérification réglementaire](https://centredaide.helloasso.com/association?question=qu-est-ce-que-la-verification-chez-helloasso){rel=""nofollow""}
::

::logos
---
logos:
  - i-heroicons-credit-card-20-solid
---
::

Vous pouvez connecter Dokos au [checkout HelloAsso](https://www.helloasso.com/outils/checkout){rel="&#x22;nofollow&#x22;"} pour collecter des paiements en ligne.

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Cette intégration est réservée aux associations.
Le modèle solidaire de HelloAsso garantit que 100% du paiement sera versé à l’association. :br
Les utilisateurs/adhérents peuvent laisser une contribution volontaire à HelloAsso au moment de leur paiement pour soutenir le modèle d'HelloAsso.
::

::tabs
  :::div{icon="i-mdi-ev-plug-chademo" label="Fonctionnement"}
  ### Paiement ponctuel

  L'intégration HelloAsso peut servir pour collecter des paiements ponctuels par carte bancaire de deux manières.

  #### 1. Génération d'un lien de paiement

  Vous pouvez générer un lien de paiement en créant une demande de paiement. :br
  Vos clients peuvent payer une commande ou facture ponctuelle. :br
  Par contre si la demande de paiement est associée à un abonnement, la carte ne sera pas enregistrée et ne pourra pas servir lors d'un paiement futur. Pour ce cas d'usage, veuillez utiliser une autre passerelle de paiement.

  #### 2. Paiement sur le site e-commerce

  Si le mode de paiement associé à votre passerelle de paiement HelloAsso est autorisé sur le site e-commerce, vous pourrez collecter des paiements via HelloAsso lors d'achats sur le webshop.

  ### Enregistrement des données de paiement

  Aucune donnée de paiement n'est enregistrée sur votre site Dokos.
  :::

  :::div{icon="i-mdi-checkbox-multiple-marked-outline" label="Configuration"}
  1. Paramètres HelloAsso
     Dans le document **Paramètres HelloAsso**, saisissez l'identifiant client et le secret client disponibles dans la section **Intégrations et API** de votre compte Association.
  2. Mode de paiement
     Pour pouvoir utiliser votre passerelle HelloAsso, vous devez créer un mode de paiement associé. :br
     Créez un mode de paiement et liez le avec votre passerelle HelloAsso dans l'onglet **Passerelle de paiement**. :br
     Pensez à renseigner l'onglet **Portail** pour la page de paiement.
  3. Paramètres E-commerce
     Si vous avez installé l'application **Webshop**[/dokos/e-commerce], vous devez autoriser votre nouvelle méthode de paiement dans la section **Modes de paiement autorisés** des **Paramètres E-Commerce**. :br
     Attention, cette section n'apparaît que si la caisse est activée.
  :::

  :::div{icon="i-mdi-test-tube" label="Tester"}
  Vous pouvez tester cette intégration sur l'un de nos sites de démonstrations.

  1. Créez une commande client ou une facture de vente
  2. Créez une demande de paiement
  3. A la validation de la demande de paiement, copiez-collez le lien de paiement dans un nouvel onglet pour tester le paiement sans être déjà connecté·e
  :::
::


# Sumup

## Intégration avec SumUp

Dokos propose une intégration avec SumUp pour collecter des paiements via l'application mobile et le terminal de paiement SumUp.

### Configuration

#### Portail développeur SumUp

Créez un compte développeur SumUp pour obtenir les clés nécessaires à la mise en place de cette intégration.

Sur le compte développeur SumUp, récupérez les informations suivantes:

1. Le compte marchand à utiliser

![Compte marchand](https://doc.dokos.io/content/paiements/sumup/merchant-account.png)

2. Les clés publiques et privées pour connecter Dokos à ce compte SumUp

![Clés publiques et privées](https://doc.dokos.io/content/paiements/sumup/public-secret-keys.png)

3. La clé d'affiliation et l'identifiant d'application

![Clé d'affiliation](https://doc.dokos.io/content/paiements/sumup/affiliation-key.png)

#### Paramètres SumUp dans Dokos

Saisissez les informations récupérées à l'étape 1 dans les champs appropriés dans le document Paramètres SumUp dans Dokos.

![Paramètres SumUp](https://doc.dokos.io/content/paiements/sumup/parametres-sumup.png)

#### Mode de paiement

Créez un mode de paiement pour les paiements par SumUp et sélectionnez la passerelle de paiement SumUp pour les sociétés concernées par ce nouveau mode de paiement.

![Mode de paiement SumUp](https://doc.dokos.io/content/paiements/sumup/mode-de-paiement.png)

##### Usage

Dans les factures de vente, demande de paiement et sur le point de vente, un bouton **Payer avec SumUp** apparaît désormais et permet de déclencher un paiement via l'application mobile SumUp installée sur l'appareil.

> L'intégration avec SumUp nécessite l'usage d'un appareil mobile sur lequel l'application mobile SumUp est installée

**Factures de vente**![Bouton sur les factures de vente](https://doc.dokos.io/content/paiements/sumup/facture-de-vente.png)

**Point de vente**![Bouton sur le point de vente](https://doc.dokos.io/content/paiements/sumup/point-de-vente.png)


# API

::swagger{app="payments"}
::


# v1.0.1

::callout
Le détail des changements publiés dans Payments est disponible sur [Gitlab](https://gitlab.com/dokos/payments/-/releases/v1.0.1){rel=""nofollow""}
::

### 🎉 Première version officielle de l'application **Payments**

::callout
Les fonctionnalités disponibles dans *Payments* étaient déjà disponibles dans la version 2 de Dokos. :br
Nous avons fait le choix d'en faire une application à part, suite à la création de l'application [Payments](https://github.com/frappe/payments){rel=""nofollow""} par Frappe Technologies pour en faciliter la maintenance.
::

- Aucune nouveauté dans cette première version, seule une migration des modules de Dokos vers une application dédiée.


# v1.1.0

::callout
Le détail des changements publiés dans Payments est disponible sur [Gitlab](https://gitlab.com/dokos/payments/-/releases/v1.0.1){rel=""nofollow""}
::

### Refonte du connecteur Stripe

- Abandon de la page intégrée à Dokos pour utiliser la page native de Stripe via l'API Stripe Checkout :br
  👉 [Sripe Checkout](https://stripe.com/fr/payments/checkout){rel="&#x22;nofollow&#x22;"}

### Formulaires web

- Amélioration des fonctionnalités de paiement dans les formulaires web via de nouvelles options:


  - Paiement immédiat 👉 Un seul paiement
  - Paiements automatiques 👉 Récupération d'une méthode de paiement pour demander des paiements dans le futur
  - Paiement initial suivi de paiements automatiques 👉 Un paiement au moment de la validation du formulaire, et enregistrement de la méthode de paiement pour demander des paiements additionnels dans le futur


# eSignature

L'application eSignature propose des intégrations pour faciliter la signature électronique depuis Dodock/Dokos.

Elle est compatible avec les versions suivantes:

| Framework | Version                    |
| --------- | -------------------------- |
| Dodock    | Version 3 ou plus récente  |
| Frappe    | Version 14 ou plus récente |

## Installation

Pour installer l'application eSignature sur votre site Dokos, placez vous dans votre `bench` et lancez les commandes suivantes:

```text
bench get-app git@gitlab.com:dokos/esignature.git
bench --site {votre site} install-app esignature
```

Connectez-vous ou rechargez votre site pour découvrir un nouvel espace de travail *eSignature*

## Intégrations

Liste des intégrations disponibles

- Docusign
- Adobe Sign (déprécié)


# Adobe Sign

> 🚧 Cette intégration est en cours de développement et considérée comme instable

# Adobe Sign

L'application eSignature propose une intégration avec Adobe Sign.
Si vous disposez d'un abonnement Adobe Sign, vous pouvez vous connecter directement depuis Dodock ou Dokos pour envoyer des demandes de signature depuis vos documents métiers (devis, bons de commande, etc...)

## Configuration

La connexion entre eSignature et Adobe Sign utilise le protocole Oauth. :br
Il faut créer une clé publique et une clé privée dans votre compte Adobe et copier-coller ces éléments dans le document *Paramètres Adobe* de l'application eSignature.

1. Créez une nouvelle application API dans votre compte Adobe Sign

![adobe\_api\_app.png](https://doc.dokos.io/content/integrations/esignature/adobe_api_app.png)

2. Cliquez sur la ligne de votre application puis sur Afficher/modifier

![adobe\_edit\_app.png](https://doc.dokos.io/content/integrations/esignature/adobe_edit_app.png)

3. Créez un nouveau *Secret* et copiez-collez le code de l'application et le secret dans les champs correspondants de la page **Paramètres Adobe** de l'application eSignature

*Adobe Sign*![adobe\_secrets.png](https://doc.dokos.io/content/integrations/esignature/adobe_secrets.png)

*eSignature*![esignature\_secrets.png](https://doc.dokos.io/content/integrations/esignature/esignature_secrets.png)

4. Enregistrez la page **Paramètres Adobe** et copiez la valeur apparu dans le champ **URI de redirection**
5. Dans votre compte Adobe Sign, cliquez à nouveau sur votre application puis sur **Configurer OAuth pour l'application**![adobe\_configure\_oauth.png](https://doc.dokos.io/content/integrations/esignature/adobe_configure_oauth.png)
6. Collez l'**URI de redirection** dans le champ correspondant
7. Configurez les droits que vous souhaitez donner à eSignature sur votre compte Adobe Sign

> L'application eSignature a besoin, au minimum, des droits suivants pour fonctionner correctement:
>
> - agreement\_read
> - agreement\_write
> - agreement\_send
> - webhook\_read
> - webhook\_write

Vous pouvez restreindre la portée de l'intégration à un groupe particulier ou bien à un utilisateur.

## Connexion

Une fois la configuration terminée, vous pouvez connecter votre site Dodock/Dokos à Adobe Sign en cliquant sur le bouton **Gestion des jetons > Se connecter à Adobe**

## Webhooks

Après la connexion à Adobe Sign, utilisez l'action **Actions > Créer des webhooks** pour générer automatiquement un webhook dans l'application Adobe Sign. :br
Cette action créera un webhook dans Adobe Sign afin de recevoir des mises à jour de statut et d'évenement en temps réel. :br
Tous les webhooks reçus généreront un document **Adobe Webhook**

## Usage

::mermaid
sequenceDiagram
eSignature-->Adobe Sign: Sélection d'un ou plusieurs fichiers
eSignature->>Adobe Sign: Envoi des fichiers
Adobe Sign->>eSignature: Validation du chargement des fichiers
eSignature->>Adobe Sign: Création d'un accord
Adobe Sign->>eSignature: Envoi du numéro d'accord et du lien de signature
Adobe Sign-->>eSignature: Envoi de webhooks pour le suivi du statut de l'accord

::

### Création d'un accord

Il est possible de créer un accord depuis n'importe quel document dans Dodock/Dokos.

1. Cliquez sur le bouton *Demander une signature électronique*![esignature\_button.png](https://doc.dokos.io/content/\(unsorted\)/esignature_button.png)
2. Ajoutez/sélectionnez un ou plusieurs fichiers
3. Ajoutez un ou plusieurs signataires. Vous pouvez sélectionner le rôle de chaque utilisateur. :callout[N'oubliez pas de vous ajouter si vous devez signer aussi.]{color="amber" icon="i-heroicons-exclamation-triangle"}
4. Donner un nom à votre accord
5. Envoyez votre accord en signature/approbation

### Signature de l'accord

Après envoi de votre accord en signature, celui-ci met quelques secondes à être créé.

1. Tant que l'envoi aux signataires n'est pas effectif ou s'il y a une erreur, l'accord apparaît en rouge:
   ![agreement\_to\_sign.png](https://doc.dokos.io/content/\(unsorted\)/agreement_to_sign.png)
   En cliquant dessus vous accéderez au document **Accord Adobe Sign** contenant les détails de l'accord.
2. Dès que l'accord a été envoyé aux signataires, l'accord apparaît en jaune:

En cliquant dessus vous accéderez à la page de signature

S'il y a plusieurs signataires, l'accord apparaîtra en vert pour les utilisateurs ayant déjà signé, en attendant que tout le monde signe.

3. Dès que l'accord est signé par tous les signataires, l'accord apparaît en bleu:
   ![archived\_agreement.png](https://doc.dokos.io/content/\(unsorted\)/archived_agreement.png)

En cliquant dessus, vous pouvez télécharger le document final signé.

### Intégration avec les workflows

Lorsque vous créez un accord, vous pouvez cocher la case **Validation de workflow** pour chaque signataire.
Si cette case est cochée, la signature déclenchera la validation de l'état de workflow en cours si le signataire a le rôle permettant cette validation.


# API

::swagger{app="esignature"}
::


# v1.0.0

::callout
Le détail des changements publiés dans eSignature est disponible sur [Gitlab](https://gitlab.com/dokos/payments/-/releases/v1.0.0){rel=""nofollow""}
::

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Cette version n'est pas encore publiée. :br
Ces notes de version sont indicatives et présentent les futures fonctionnalités de l'application eSignature.
::

- Mise en place du flux d'authentification OAuth
- Mise en place du flux d'agrément/signature
- Création des composants de la barre latérale de documents, permettant de déclencher un flux de signature
- Espace de travail dédié


# Intégration WooCommerce

L'application Dokos WooCommerce propose un connecteur pour faciliter l'intégration des commandes créées depuis WooCommerce dans Dokos.

Elle est compatible avec les versions suivantes:

| Application | Version                    |
| ----------- | -------------------------- |
| Dokos       | Version 4 ou plus récente  |
| ERPNext     | Version 15 ou plus récente |

## Installation

Pour installer l'application Dokos WooCommerce sur votre site Dokos, placez vous dans votre `bench` et lancez les commandes suivantes:

```text
bench get-app git@gitlab.com:dokos/dokos-woocommerce.git
bench --site {votre site} install-app dokos-woocommerce
```

Connectez-vous ou rechargez votre site pour découvrir un nouvel espace de travail *WooCommerce*

## Flux d'intégration disponibles

::mermaid
sequenceDiagram
WooCommerce->>Dokos: Récupérations des produits
Dokos-->WooCommerce: Envoi des articles
WooCommerce->>Dokos: Récupération des commandes client
Dokos->>WooCommerce: Mise à jour des stocks
Dokos-->WooCommerce: Synchronisation des clients
::


# Intégration WooCommerce

À l'aide de l'intégration WooCommerce, le système crée des commandes client dans Dokos pour les commandes créées sur WooCommerce à l'aide du webhook WooCommerce.

Lors de la création d'une commande client à partir de WooCommerce, si le client ou l'article est manquant dans Dokos, le système créera un nouveau client/article en utilisant les détails respectifs des données de commande WooCommerce. Il crée également une adresse liée au client en utilisant les détails d'expédition des données de commande.

Il possible de créer des connexions entre plusieurs site Woocommerce et votre site Dokos.

## Configuration

### Générer la clé API et le secret API

1. Dans la barre latérale de votre site WooCommerce, cliquez sur **Paramètres**.
2. Cliquez sur l'onglet **Avancé** puis cliquez sur le lien API REST.

![wc-add-key.png](https://doc.dokos.io/content/integrations/woocommerce/wc-add-key.png)

3. Cliquez sur le bouton **Ajouter une clé**. Fournissez les détails nécessaires et cliquez sur le bouton **Générer la clé API**.

![wc-generate-keys.png](https://doc.dokos.io/content/integrations/woocommerce/wc-generate-keys.png)

### Paramètres Woocommerce

1. Sur votre site Dokos, allez dans : **Accueil > Intégrations > Paramètres > Paramètres Woocommerce**.
2. Dokos permettant la connexion avec plusieurs sites WooCommerce, vous pouvez créer un document de paramétrage par site.
3. Collez la clé API et le secret générés à l'étape précédente dans les champs **Clé consommateur API** et **Secret consommateur API**.
4. Dans l'**URL du serveur Woocommerce**, collez l'url de votre site WooCommerce.
5. Assurez-vous que **Activer la synchronisation** est coché.
6. Sélectionnez le « **Compte de taxe** » et le « **Compte de fret et d'expédition** dans la section Détails du compte.
7. Sélectionnez **Création d'utilisateurs** dans la section Paramètres par défaut. Cet utilisateur sera utilisé pour créer des clients, des articles et des commandes clients. Assurez-vous que l'utilisateur dispose des autorisations appropriées.
8. Sélectionnez la **Société** qui sera utilisée pour créer les commandes client.
9. Cliquez sur **Enregistrer**.
10. Après avoir enregistré les paramètres Woocommerce, **Secret** et **Endpoint** sont générés automatiquement.

::tour{doctype="Woocommerce Settings"}
Voir les paramètres WooCommerce dans la démo
::

### Paramètres des Webhook Woocommerce

> Les Webhooks sont créées automatiquement dans WooCommerce lors de l'enregistrement du document Paramètres WooCommerce. :br
> Si vous rencontrer un problème, vous pouvez les créer manuellement de la manière suivante.

1. Depuis la barre latérale de votre site woocommerce, allez dans **Paramètres**.
2. Cliquez sur l'onglet **Avancé** puis sur le lien **Webhooks** puis sur le bouton **Ajouter un webhook**.
3. Donnez au **webhook un nom de votre choix**.
4. Cliquez sur la liste déroulante Statut et sélectionnez **Actif**.
5. Sélectionnez le sujet comme **Commande créée**.
6. Copiez le doctype **Endpoint** du **Woocommerce Settings** dans votre site Dokos et collez-le dans le champ **Delivery URL**.
7. Copiez **Secret** du doctype **Paramètres Woocommerce** dans votre site Dokos et collez-le dans le champ **Secret**.
8. Conservez la VERSION API telle quelle et cliquez sur Enregistrer le Webhook.

![wc-webhook.png](https://doc.dokos.io/content/integrations/woocommerce/wc-webhook.png)

### Synchronisation des stocks

La synchronisation des stocks s'effectue à deux moments différentes:

1. A chaque entrée/sortie de stock d'un article - *Uniquement avec Dokos, non applicable avec ERPNext*
2. Une fois par heure pour tous les articles entrés/sortis lors des deux dernières heures

Si l'article est une variante, le modèle d'article correspondant est également mis à jour. :br
La quantité mise à jour correspondra à la somme des quantités de ses variantes actives.

#### Synchroniser les stocks des variations de produits

Lorsque vous utilisez des variations de produits dans WooCommerce, vous devez créer un modèle d'article et des variantes dans Dokos. :br
Les variantes doivent ensuite être bien associées aux ID des variations dans WooCommerce, tandis que le modèle doit être associé au modèle dans WooCommerce.


# Intégration WooCommerce Bookings

Le connecteur WooCommerce peut être étendu pour intégrer les réservations de créneaux effectuées via le plugin **WooCommerce Bookings**

Aucune configuration particulière n'est nécessaire.

## Fonctionnement

Lors de la récupération des lignes de commandes provenant de WooCommerce, si un article sélectionné a la propriété **Autoriser les réservations d'article** activée, Dokos vérifie s'il existe une réservation adossée à la ligne de commande.

Si une réservation existe, elle sera créée dans Dokos.
Pour la synchroniser automatiquement avec Google Agenda, pensez à cocher la case correspondante dans les paramètres du lieu.

## Limites

WooCommerce Booking ne permet que la mise à jour des réservations sur Wordpress (aucune API n'est disponible à ce jour pour la création de réservations): <https://woocommerce.github.io/woocommerce-bookings-api-docs/#create-a-booking-incomplete-do-not-use>{rel="&#x22;nofollow&#x22;"})

De même l'intégration Google Agenda ne permet que la création de *Disponibilités du magasin* mais pas la mise à jour des réservations (<https://woocommerce.com/document/google-calendar-integration/>{rel="&#x22;nofollow&#x22;"}).

Vous pouvez donc:

- Activer l'intégration avec Google Agenda pour bloquer des créneaux depuis Dokos en sélectionnant cet agenda dans toutes vos réservations.
- Mettre en place une tâche Zapier (ou autre) qui duplique toutes vos réservations de/vers l'agenda de WooCommerce.

::callout{color="teal" icon="i-heroicons-light-bulb"}
La problématique n°1 est d'éviter d'avoir à créer ses réservations dans deux agendas différents.
::


# API

::swagger{app="dokos_woocommerce"}
::


# v1.0.0

::callout
Le détail des changements publiés dans Dokos WooCommerce est disponible sur [Gitlab](https://gitlab.com/dokos/dokos-woocommerce/-/releases/v1.0.0){rel=""nofollow""}
::

### 🎉 Première version officielle de l'intégration entre Dokos et WooCommerce

::callout
Cette intégration était déjà fonctionnelle dans la version 2 de Dokos sous la forme d'un module intégré à Dokos :br
Nous avons fait le choix d'en faire une application à part pour en faciliter la maintenance.
::

- Toutes les commandes provenant de WooCommerce sont intégrées sous forme brute via un nouveau type de document **Commande WooCommerce**.
  Ce document sert de journal d'intégration et permet de suivre le statut de chaque commande intégrée, ainsi que de trouver facilement la Commande Client associée dans Dokos.

  - Un bouton **Réessayer** dans les Commandes WooCommerce pour relancer une intégration tombée en erreur.
  - Un tableau de lien permet de faire le lien entre une commande WooCommerce et une commande client Dokos.
- Ajout d'un espace de travail **WooCommerce** sous l'espace de travail **Intégrations**
- Il est désormais possible de connecter plusieurs sites WooCommerce à un même site Dokos.
  > Ex. Si vous avez un site B2B et un site B2C, vous pouvez centraliser la gestion de stocks sous Dokos pour ces deux sites.


# v1.1.0

::callout
Le détail des changements publiés dans Dokos WooCommerce est disponible sur [Gitlab](https://gitlab.com/dokos/dokos-woocommerce/-/releases/v1.1.0){rel=""nofollow""}
::

### Synchronisation des clients

- Il est désormais possible d'envoyer la liste de vos clients existants dans Dokos vers WooCommerce.
- Vous pouvez synchroniser les numéros de TVA de vos clients


# v1.2.0

::callout
Le détail des changements publiés dans Dokos WooCommerce est disponible sur [Gitlab](https://gitlab.com/dokos/dokos-woocommerce/-/releases/v1.2.0){rel=""nofollow""}
::

### Ajout d'une routine pour la synchronisation des commandes

- Jusqu'à présent, la synchronisation des commandes WooCommerce dépendait uniquement des réceptions de webhooks provenant de WooCommerce. :br
  Nous avons ajouté une routine qui vérifie cette synchronisation une fois par heure.


# v1.3.0

::callout
Le détail des changements publiés dans Dokos WooCommerce est disponible sur [Gitlab](https://gitlab.com/dokos/dokos-woocommerce/-/releases/v1.3.0){rel=""nofollow""}
::

### Synchronisation de stocks

- Une nouvelle option permet de choisir si la synchronisation de stock doit être faite sur la base du stock réel ou du stock projeté.

### Synchronisation des clients

- Une nouvelle option permet de filtrer les clients à synchroniser en fonction de leur **Groupe de client**.


  - Vous pouvez filtrer les clients appartenant à certains **Groupes de clients** et créer une équivalence avec un rôle dans WooCommerce.
  - La synchronisation des rôles est optionnelle


# v1.4.0

::callout
Le détail des changements publiés dans Dokos WooCommerce est disponible sur [Gitlab](https://gitlab.com/dokos/dokos-woocommerce/-/releases/v1.4.0){rel=""nofollow""}
::

### Synchronisation des clients

- Une routine synchronise désormais les clients une fois par heure. :br
  Auparavant c'était une option à déclencher manuellement depuis les **Paramètres WooCommerce**


# v1.5.0

::callout
Le détail des changements publiés dans Dokos WooCommerce est disponible sur [Gitlab](https://gitlab.com/dokos/dokos-woocommerce/-/releases/v1.5.0){rel=""nofollow""}
::

### Validation des commandes

- L'intégration vérifie désormais si le total de la commande WooCommerce correspond bien au total de la commande client dans Dokos. :br
  Lorsque ce n'est pas le cas, le document **Commande WooCommerce** tombe en erreur et la **Commande client** reste en brouillon.


# Connecteur Hiboutik

Le connecteur Hiboutik permet la synchronisation des ventes entre Hiboutik et Dokos. :br
L'objectif de cette connexion est de permettre la centralisation des données de vente et des écritures comptables associées dans Dokos.
Ce connecteur n'est pas inclus directement dans Dokos et doit être installé en plus sur votre serveur.

::callout{color="teal" icon="i-heroicons-light-bulb"}
Le module Point de Vente de Dokos est concerné par loi de finances 2018 sur les logiciels de caisse. Ce module n’est actuellement pas certifié par un organisme accrédité, mais il est possible de le faire attester par un intégrateur. Pour rappel, la loi concerne « tous les commerçants qui enregistrent les paiements de leurs clients via une caisse enregistreuse ou un logiciel de caisse », sauf certaines exceptions précisées ici : [Professionnels : tout savoir sur la nouvelle règlementation des logiciels de caisse | economie.gouv.fr](https://www.economie.gouv.fr/entreprises/logiciel-caisse-reglementation){rel=""nofollow""}.
::

## Installation

Suive les instructions sur le répertoire de l'application: <https://gitlab.com/dokos/hiboutik>{rel="&#x22;nofollow&#x22;"}

> Pour les utilisateurs de Dokos Cloud, veuillez contacter le [support](mailto\:help@dokos.cloud) pour que l'application soit installée directement sur votre site.

## Configuration

1. Créez un compte Hiboutik
2. Dans la section Paramètres > Utilisateur > Gestion des accès, vérifiez que votre utilisateur a suffisemment de droits pour gérer les ventes, les produits, les clients, les stocks (paramètres numéros 135, 139, 157, 158, 204, 212 à minima)
   Vérifiez également qu'il peut gérer les webhooks.
3. Allez dans la section Paramètres > API:

![hiboutik\_api\_settings.png](https://doc.dokos.io/content/integrations/hiboutik_api_settings.png)

Dans Dokos, dans l'espace de travail **Intégrations**, ouvrez le document **Paramètres Hiboutik**:

- Activez la synchronisation
- Remplissez les paramètres de connexion à l'API en reprenant les éléments visibles sur Hiboutik.
- Sélectionnez ou créez un profil de point de vente
- Sélectionnez un compte pour l'enregistrement des remises globales
- Enregistrez et ajoutez les modèles de taxe d'article correspondant aux taux de TVA présents dans Hiboutik
- Ajoutez les modes de paiement disponibles sur Hiboutik et leur correspondance dans Dokos

Si l'enregistrement des paramètres s'est bien déroulé, vous devriez voir apparaître les URL de webhooks configurées par Dokos sur Hiboutik:
![hiboutik\_webhooks.png](https://doc.dokos.io/content/integrations/hiboutik_webhooks.png)

## Première synchronisation

Avant de lancer la première synchronisation, allez dans les fiches **Article** des articles que vous souhaitez synchroniser avec Hiboutik et cochez la case "Synchroniser avec Hiboutik".

> Dokos est la source de vos données: Seuls les articles ajoutés sur Dokos pourront être synchronisés avec Hiboutik.
> Si vous ajoutez des produits sur Hiboutik, ceux-ci ne seront pas synchronisés et leurs ventes ne pourront pas être rappatriées dans Dokos.

Vous pouvez ensuite lancer une synchronisation de tous les articles et des clients particulier, ayant le type de client "Individuel".

## Synchronisation des articles

Les articles sont synchronisés automatiquement une fois par heure.
A chaque mouvement de stock dans Dokos, les stocks de Hiboutik sont mis à jour.

> Pour le moment l'intégration ne permet pas la synchronisation des images entre Dokos et Hiboutik.
> Vous devez ajouter des images pour vos articles directement sur Hiboutik.

Les données synchronisées sont les suivantes:

- Libellé <> Nom de l'article
- Prix <> Prix de l'article (Associé à la liste de prix du profil de point de vente)
- Taxe <> Taxe d'article par défaut
- Stock <> Stock dans l'entrepôt du profil de point de vente
- Référence externe <> Code de l'article

> Les prix doivent être entrés TTC dans dokos.
> La taxe d'article peut être ajouté au niveau du groupe d'article dans dokos (si le groupe est un noeud feuille, i.e. case "Est un groupe" décochée).

### Alertes de niveau de stock

En cas de diminution du stock d'un produit en dessous du niveau d'alerte saisi dans la fiche produit sur Hiboutik, Dokos peut envoyer une notification dans Hiboutik pour prévenir les équipes utilisant la caisse.
Pour cela, cochez la case **Envoyer une notification pour les alertes de stock** dans les paramètres Hiboutik.

## Synchronisation des ventes

Chaque vente ou note de crédit créée sur Hiboutik est récupérée dans Dokos via le type de document **Vente Hiboutik**.
Ce document permet ensuite de créer une facture de vente dans Dokos.
Vous pouvez créer une **règle de nommage** pour que ces factures soient associées à une série différente de celle de vos autres factures.

Les ventes sont intégrées dans Dokos via des **Webhooks** configurés par Dokos sur votre site Hiboutik.
Les webhooks permettent une intégration des ventes en temps réel.
Une routine, lancée une fois par heure vérifie que toutes les ventes ont bien été intégrées dans Dokos.

## Intégration des mouvements de caisse

Une fois par heure, Dokos intègre les mouvements de caisse créés sur Hiboutik.
Vous pouvez ensuite les comptabiliser en cliquant sur le bouton + à droite du lien vers les écritures de journal.
A la validation de l'écriture de journal, le statut du mouvement de caisse passe automatiquement à **Complété**

## Crédits clients

Si une vente est vendue via un crédit client, Dokos ne créera aucune écriture de paiement associée à la facture associée à cette vente.

Pour solder le crédit client, il faut utiliser le mode de paiement **DIV** dans Hiboutik, mettre un montant négatif associé au mode de paiement **CRED** puis saisir le montant réellement payé par le client avec les autres modes de paiement.
Dokos créera une ou plusieurs écritures de paiement correspondant aux montants dépassant le montant de la vente en cours.
Ces écritures de paiement pourront ensuite être réconciliées manuellement avec les factures correspondantes via l'outil de réconciliation des paiements.


# API

::swagger{app="hiboutik"}
::


# v1.0.0

::callout
Le détail des changements publiés dans Hiboutik est disponible sur [Gitlab](https://gitlab.com/dokos/hiboutik/-/releases/v1.0.0){rel=""nofollow""}
::

### 🎉 Première version officielle de l'intégration entre Dokos et Hiboutik

- Synchronisation des ventes Hiboutik
- Synchronisation des mouvements de caisse
- Synchronisation des stocks
- Gestion des modes de paiement, dont les crédits clients ajoutés sur Hiboutik
- Ajout d'un espace de travail intégré à l'espace de travail **Intégrations**
- Ajout d'un document de logs des appels API, activable via la variable d'environnement `log_hiboutik_api`


# v1.1.0

::callout
Le détail des changements publiés dans Hiboutik est disponible sur [Gitlab](https://gitlab.com/dokos/hiboutik/-/releases/v1.1.0){rel=""nofollow""}
::

### Synchronisation des articles

- Les articles sont mis à jour sur Hiboutik à chaque modification dans Dokos


# v1.2.0

::callout
Le détail des changements publiés dans Hiboutik est disponible sur [Gitlab](https://gitlab.com/dokos/hiboutik/-/releases/v1.2.0){rel=""nofollow""}
::

### Synchronisation des clients

- Il est désormais possible de configurer le type de clients à synchroniser.

### Création des factures

- Une nouvelle option permet de laisser les factures associées à des clients non génériques en **Brouillon**.
  Elles pourront être validées manuellement ultérieurement.


# Open Banking

Le connecteur bancaire est composé de deux applications fonctionnant ensemble: Bank et Bank API.

::card-group
  :::card
  ---
  icon: i-fluent-building-bank-toolbox-24-regular
  title: Bank
  to: https://doc.dokos.io/v5/integrations/banks/bank
  ---
  Application permettant d'intégrer de récupérer ses transactions bancaire
  :::

  :::card
  ---
  icon: i-fluent-building-bank-link-16-filled
  title: Bank API
  to: https://doc.dokos.io/v5/integrations/banks/bank-api
  ---
  Middleware faisant la liaison entre l'application Bank et un ou plusieurs fournisseurs open-banking.
  :::
::


# Bank

Cette application est un connecteur bancaire, permettant d'intégrer vos transactions bancaires en accédant à votre banque via un fournisseur d'Open-banking. :br
Actuellement

## Configuration

Pour utiliser cette API en mode développement depuis un site Dokos, pensez à configurer correctement le nom de votre site, notamment pour la réception des webhooks nécessaires à la connexion initiale avec la banque.

Pour cela vous pouvez utiliser un outil comme [localtunnel](https://github.com/localtunnel/localtunnel){rel="&#x22;nofollow&#x22;"}

- Définissez la variable d'environnement `host_name` dans le fichier `sites/{test_site}/site_config.json`

::callout
Avec localtunnel, ce sera l'URL fournie par localtunnel
::

- Définissez la variable `restart_supervisor_on_update: 1` dans le fichier `sites/common_site_config.json`

::callout
Cela évitera que Dodock renvoie le numéro du port utilisé à la fin de l'URL hôte (ex. *<https://monsite.com:8000>{rel=""nofollow""}*)
::

## Connexion

Pour vous connecter, il faut ajouter les variables d'environnement suivantes dans votre fichier `site_config.json`:

- `bank_connector_url`: L'URL du site sur lequel est installé l'application **Bank API**
- `bank_connector_key`: Clé publique de connexion au site sur lequel est installée l'application **Bank API**
- `bank_connector_secret`: Clé privée de connexion au site sur lequel est installée l'application **Bank API**

::callout
Les clés publiques et privées peuvent être obtenues en créant un utilisateur sur le site sur lequel est installée l'application **Bank API**
::


# Bank API

::callout
Cette application permet de faire le lien entre l'application Bank et les fournisseurs de solutions d'open-banking. :br
Elle doit être un installée sur un site Dodock/Dokos distant et sert de passerelle pour les sites Dokos *clients*.
::

**Cette documentation est principalement à destination des développeurs souhaitant créer des services autour de cette application**

## Connexion

Pour vous connecter, il faut utiliser une combinaison clé privé/clé secrète qui doit être passée dans la requête: [Documentation de l'API](https://doc.dokos.io/v5/dodock/ressources/api/rest_api#authentification-par-jeton)

- `api_key`: Clé publique de connexion au site
- `api_secret`: Clé privée de connexion au site

::callout
Les clés publiques et privées peuvent être obtenues en créant un utilisateur sur le site sur lequel est installée l'application **Bank API**
::

## Flux de Connexion

Ici *Bank* représente l'application [Bank](https://doc.dokos.io/v5/integrations/banks/bank) utilisée avec Dokos, mais peut être remplacée par une application tierce.

::mermaid
sequenceDiagram
Bank->>Bank API: Demande de lien de connexion (get\_bridge\_connect\_link)
Bank API->>Bridge: Demande de lien de connexion
Bank API->>Bank: Envoi du lien de connexion
Bank->>Bridge: Connexion à la banque
Bridge-->>Bank API: Redirection après la connexion
Bank API-->>Bank: Redirection vers la page de déclenchement du flux
Bank API-->>Bank: Envoi d'un webhook de confirmation de validation du flux
Bank->>Bank API: Récupération de l'identifiant d'Item envoyé par Bridge pour stockage local

::

## Démarrer avec Bank API

Pour récupérer des transactions bancaires associées à un compte bancaire, il faut mettre en place, a minima, le flux suivant:

1. Récupérer un lien de connexion/authentification. L'authentification se passe sur le site du fournisseur Open-Banking. :br
   👉 *get\_bridge\_connect\_link*

Dans certains cas, il faudra aussi obtenir des liens d'authentification [SCA](https://docs.bridgeapi.io/docs/strong-customer-authentication){rel="&#x22;nofollow&#x22;"} ou [Pro](https://docs.bridgeapi.io/docs/business-accounts){rel="&#x22;nofollow&#x22;"}

2. A la fin du flux d'authentification, enregistrer l'identifiant d'Item (terme Bridge pour désigner la banque)
3. Récupérer tous les comptes bancaires associés avec cet item :br
   👉 *get\_bank\_accounts*
4. Récupérer les transactions associées à cet item :br
   👉 *get\_bank\_transactions*

## Méthodes d'API

L'ensemble des méthodes d'API ci-dessous peuvent être appelées à l'adresse: :br`https://{URL_DU_SITE_BANK_API}/api/method/bank_api.bridge.{NOM_DE_LA_METHODE}`

#### get\_bridge\_connect\_link

Cette méthode permet d'obtenir un lien d'authentification Bridge Connect.&#x20;:b&#x72;*/api/method/bank\_api.bridge.get\_bridge\_connect\_link*

- `base_url`: URL de base du site demandeur
- `bank`: Nom de la banque concernée
- `redirect_url`: URL de redirection après la connexion avec la banque
- `item_id`: Identitiant de l'Item, si connu
- `site`: Identifiant du site - Il s'agit d'une clé permettant d'identifier le site/client demandeur
- `user`: ID d'utilisateur
- `webhook_url`: URL à laquelle envoyer des webhooks

#### get\_bridge\_edit\_link

Cette méthode permet d'obtenir un lien d'authentification Bridge Connect en mode **Edition**.&#x20;:b&#x72;*/api/method/bank\_api.bridge.get\_bridge\_edit\_link*

- `base_url`: URL de base du site demandeur
- `bank`: Nom de la banque concernée
- `redirect_url`: URL de redirection après la connexion avec la banque
- `item_id`: Identitiant de l'Item
- `site`: Identifiant du site
- `user`: ID d'utilisateur
- `webhook_url`: URL à laquelle envoyer des webhooks

#### get\_sca\_authentication\_link

Cette méthode permet d'obtenir un lien de rafraîchissement Strong Customer Authentication.&#x20;:b&#x72;*/api/method/bank\_api.bridge.get\_sca\_authentication\_link*

- `base_url`: URL de base du site demandeur
- `bank`: Nom de la banque concernée
- `redirect_url`: URL de redirection après la connexion avec la banque
- `item_id`: Identitiant de l'Item
- `site`: Identifiant du site
- `user`: ID d'utilisateur
- `webhook_url`: URL à laquelle envoyer des webhooks

#### get\_pro\_confirmation\_link

Cette méthode permet d'obtenir un lien de rafraîchissement Business accounts.&#x20;:b&#x72;*/api/method/bank\_api.bridge.get\_pro\_confirmation\_link*

- `base_url`: URL de base du site demandeur
- `bank`: Nom de la banque concernée
- `redirect_url`: URL de redirection après la connexion avec la banque
- `item_id`: Identitiant de l'Item, si connu
- `site`: Identifiant du site
- `webhook_url`: URL à laquelle envoyer des webhooks

#### get\_bridge\_item\_id

Cette méthode permet d'obtenir l'identifiant de l'Item Bridge et le nom de la banque associés à une requête d'authentification.&#x20;:b&#x72;*/api/method/bank\_api.bridge.get\_bridge\_item\_id*

- `request`: Identifiant de la requête de connexion

#### get\_bridge\_item\_details

Cette méthode permet d'obtenir le document Bridge Item correspondant à un identifiant.&#x20;:b&#x72;*/api/method/bank\_api.bridge.get\_bridge\_item\_details*

- `item_id`: Identitiant de l'Item

#### delete\_bridge\_item\_id

Cette méthode permet de supprimer un Item.&#x20;:b&#x72;*/api/method/bank\_api.bridge.delete\_bridge\_item\_id*

- `item_id`: Identitiant de l'Item
- `user`: ID d'utilisateur

#### post\_item\_refresh

Cette méthode permet de demander le rafraîchissement d'un Item.&#x20;:b&#x72;*/api/method/bank\_api.bridge.post\_item\_refresh*

- `item_id`: Identitiant de l'Item
- `user`: ID d'utilisateur

#### get\_bank\_accounts

Cette méthode permet de récupérer les comptes bancaires associés à un Item.&#x20;:b&#x72;*/api/method/bank\_api.bridge.get\_bank\_accounts*

- `item_id`: Identitiant de l'Item
- `user`: ID d'utilisateur

#### get\_single\_bank

Cette méthode permet de récupérer le détail d'une banque.&#x20;:b&#x72;*/api/method/bank\_api.bridge.get\_single\_bank*

- `bank_id`: Identitiant de l'Item

#### get\_bank\_transactions\_by\_account

Cette méthode permet de récupérer les transactions associées à un compte bancaire.&#x20;:b&#x72;*/api/method/bank\_api.bridge.get\_bank\_transactions\_by\_account*

- `account_id`: Identitiant du compte bancaire.
- `user`: ID d'utilisateur

#### get\_bank\_transactions

Cette méthode permet de récupérer les transactions bancaires associées à un Item.&#x20;:b&#x72;*/api/method/bank\_api.bridge.get\_bank\_transactions*

- `since`: Date (`format: yyyy-mm-dd`) de modifications des transactions la plus ancienne.
- `lang`: Langue de la demande. Les catégories seront renvoyées dans cette langue
- `user`: ID d'utilisateur

#### get\_category

Cette méthode permet de récupérer le détail d'une catégorie Bridge.&#x20;:b&#x72;*/api/method/bank\_api.bridge.get\_category*

- `lang`: Langue de la demande. Les catégories seront renvoyées dans cette langue
- `category_id`: Identitiant de la catégorie, si connu


# E-transactions — Facturation électronique et OCR dans Dokos

::tabs
  :::div{icon="i-mdi-ev-plug-chademo" label="Fonctionnalités"}
  ## Facturation électronique de bout en bout

  E-transactions couvre l'ensemble du cycle de la facturation électronique française : la connexion à une **Plateforme Agréée**, l'émission des factures de vente au format structuré, la réception automatique des factures fournisseur, et l'extraction OCR des PDF. Trois piliers complémentaires :

  - **Émission** — à la validation d'une facture de vente, Dokos génère la facture électronique (Factur-X / CII ou UBL / Peppol) et l'achemine vers votre Plateforme Agréée. Voir [Émettre des factures électroniques](https://doc.dokos.io/v5/integrations/etransaction/emission-factures-electroniques).
  - **Réception** — Dokos récupère vos factures fournisseur depuis la plateforme, lit leurs données structurées (UBL, CII) et prépare la facture d'achat. Voir [Recevoir des factures électroniques](https://doc.dokos.io/v5/integrations/etransaction/reception-factures-electroniques).
  - **OCR** — pour les factures fournisseur reçues en PDF non structuré, Dokos extrait automatiquement les données (voir ci-dessous).

  ### Se connecter à une Plateforme Agréée

  Dokos se connecte aux Plateformes Agréées (SuperPDP, Esalink) via une configuration unique par société. Pour démarrer :

  1. [Se connecter à une Plateforme Agréée](https://doc.dokos.io/v5/integrations/etransaction/plateformes-agreees) — plateformes prises en charge et principe de connexion.
  2. [Inscrire votre société à l'annuaire](https://doc.dokos.io/v5/integrations/etransaction/inscription-annuaire) — informations requises et parcours d'inscription.
  3. [Configurer clients et fournisseurs](https://doc.dokos.io/v5/integrations/etransaction/configuration-clients-fournisseurs) — données d'identification et annuaire.

  ---

  ## Extraction de données par OCR

  E-transactions intègre la reconnaissance optique de caractères (OCR) pour traiter les factures fournisseur reçues en PDF. Dokos envoie chaque fichier à Amazon Textract, en extrait les données structurées, puis crée automatiquement une facture fournisseur.

    ::::mermaid
    flowchart LR
    B\[Banette de factures d'achat] --> D\[Demande d'extraction OCR]
    D --> E\[Facture fournisseur]
    E --> C\[Commande fournisseur]
    E --> G\[Reçu d'achat]
    C --> F\[Facture d'achat]
    G --> F\[Facture d'achat]
    E --> F\[Facture d'achat]

    ::::

  Le traitement se déroule en plusieurs étapes :

  1. Les PDF sont déposés dans une **banette de factures d'achat** (manuellement ou par email automatique).
  2. Depuis la banette, Dokos génère une demande d'extraction de données pour chaque fichier.
  3. Amazon Textract analyse le PDF et renvoie les données sous forme structurée.
  4. Dokos crée une **facture fournisseur** et recherche automatiquement une commande fournisseur ou un reçu d'achat correspondant.
  5. Depuis la facture en attente, l'utilisateur crée la facture d'achat définitive selon les options configurées.

  ### Statuts des factures fournisseur

    ::::mermaid
    flowchart TD
    A\["En attente (aucune commande/reçu associé)"] --> B\["En cours (document associé à une commande/reçu)"]
    B --> C\["Prêt (toutes les commandes/reçus associés sont validés)"]
    C --> D\["Terminé (factures d'achat créées et validées)"]
    A --> E\["Fermé (document fermé, ne sera pas traité)"]
    ::::
  :::

  :::div{icon="i-mdi-ev-plug-chademo" label="Installation"}
  ## Application E-transactions

    ::::callout
    Afin d'avoir ces fonctionnalités sur votre site Dokos, veuillez installer l'application [E-transactions](https://gitlab.com/dokos/etransactions){rel=""nofollow""}. :br
    Si vous êtes client Dokos Cloud, vous pouvez faire une demande d'installation à l'adresse <help@dokos.cloud>
    ::::

  ```sh
  bench get-app --branch v5 https://gitlab.com/dokos/etransactions.git
  bench --site [mon-site] install-app etransactions
  ```

  E-transactions remplace l'application OCR à partir de Dokos V5. Si vous utilisiez déjà l'application OCR, Dokos migre automatiquement vos paramètres existants lors de l'installation.
  :::

  :::div{icon="i-mdi-checkbox-multiple-marked-outline" label="Paramétrage"}
  ## Connexion à Amazon Textract

  Pour activer l'extraction OCR, Dokos doit être connecté à un compte Amazon Textract. Créez un utilisateur IAM sur AWS avec, au minimum, les autorisations suivantes :

  **Accès Amazon Textract**

  - Lecture : `AnalyzeDocument`, `AnalyzeExpense`, `GetDocumentAnalysis`, `GetExpenseAnalysis`, `GetDocumentTextDetection`
  - Écriture : `StartDocumentAnalysis`, `StartExpenseAnalysis`, `StartDocumentTextDetection`

  **Accès Amazon S3**

  - Liste : `ListBucket`
  - Écriture : `CreateBucket`, `DeleteObject`, `DeleteObjectVersion`, `PutObject`

  Pour un premier test sans gestion fine des autorisations, vous pouvez attribuer les trois politiques suivantes :

  - `AmazonS3FullAccess`
  - `AmazonTextractFullAccess`
  - `AmazonTextractServiceRole`

    ::::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
    La gestion des rôles et politiques d'autorisation dépend d'AWS. Reportez-vous à la documentation Amazon Textract pour toute implémentation en production.
    ::::

  Une fois l'utilisateur IAM créé, copiez la clé d'accès et le secret dans le document **Paramètres E-transactions** de votre site Dokos.

  ## Paramètres de création de factures

  Le document **Paramètres E-transactions** permet de configurer le comportement lors de la création des factures d'achat :

  - **Création sans commande fournisseur** : autorise la création d'une facture d'achat directement depuis la facture en attente, sans passer par une commande ou un reçu.
  - **Blocage si montant TTC supérieur** : empêche la création d'une facture d'achat si le montant TTC est supérieur à celui extrait par l'OCR.
  - **Blocage si montant HT supérieur** : même règle appliquée au montant hors taxes.

  ## Réception automatique de factures par email

  Dokos peut créer automatiquement une entrée dans la banette de factures d'achat pour chaque email reçu sur une adresse dédiée. Ajoutez un compte email dans Dokos, puis dans la section **Détails IMAP**, configurez la règle suivante :

  | Nom du dossier | Ajouter à                    |
  | -------------- | ---------------------------- |
  | INBOX          | Banette de factures d'achats |

  Tout email contenant une pièce jointe PDF sera ainsi acheminé automatiquement vers la banette pour traitement OCR.
  :::
::


# Se connecter à une Plateforme Agréée dans Dokos

La facturation électronique française oblige chaque entreprise à émettre, recevoir et déclarer ses factures via une **Plateforme Agréée**. Dokos s'y connecte pour vous : une fois la plateforme configurée, l'émission, la réception et le suivi des factures se font directement depuis vos factures de vente et d'achat habituelles.

## Rôle d'une Plateforme Agréée :badge{text="Dokos" type="warning"}

Une Plateforme Agréée (aussi appelée PDP, Plateforme de Dématérialisation Partenaire) est l'intermédiaire officiel qui transmet vos factures électroniques à vos partenaires et à l'administration fiscale. Dokos ne transmet jamais une facture en direct : il la remet toujours à la plateforme que vous avez choisie, qui se charge de l'acheminement et du suivi réglementaire.

Dokos s'appuie sur une **connexion unifiée** : quelle que soit la plateforme retenue, l'émission, la réception et le suivi de cycle de vie fonctionnent de la même façon dans l'interface. Vous choisissez votre plateforme une fois, et le reste de Dokos s'adapte automatiquement.

## Plateformes prises en charge :badge{text="Dokos" type="warning"}

Dokos prend en charge trois types de connexion, à choisir selon votre prestataire.

- **SuperPDP** — plateforme certifiée avec connexion moderne. Elle gère l'annuaire Peppol (facturation internationale), l'e-reporting (transmission des données B2C et intracommunautaires) et la connexion se fait par autorisation sécurisée en un clic.
- **Esalink (HUBTIMIZE)** — plateforme conforme au standard AFNOR, avec **inscription automatisée** de votre société depuis Dokos et validation d'identité (KYC).
- **Plateforme personnalisée (AFNOR)** — pour toute autre plateforme respectant le standard AFNOR. Vous saisissez manuellement les identifiants fournis par votre prestataire.

::callout{color="blue" icon="i-heroicons-information-circle"}
Le choix de la plateforme dépend de votre prestataire de dématérialisation. En cas de doute, rapprochez-vous de votre expert-comptable ou de Dokos Cloud.
::

Quelle que soit la plateforme retenue, Dokos passe par la même interface interne : vos factures de vente et d'achat n'ont pas à connaître la plateforme utilisée.

::mermaid
flowchart LR
A\[Factures de vente et d'achat] --> B\[Interface unifiée E-transactions]
B --> C\[SuperPDP]
B --> D\[Esalink / HUBTIMIZE]
B --> E\[Plateforme personnalisée AFNOR]

::

## Quelle plateforme choisir :badge{text="Dokos" type="warning"}

Le choix se fait moins sur des fonctionnalités que sur votre situation : la façon dont Dokos est hébergé, et le prestataire avec lequel vous avez déjà un contrat. Quatre cas se présentent.

### Esalink via PDPLibre, pour les clients Dokos Cloud

[PDPLibre](https://pdplibre.org/){rel="&#x22;nofollow&#x22;"} est une association à but non lucratif, au code ouvert, qui mutualise l'accès à une Plateforme Agréée pour éviter aux entreprises un « péage numérique » — c'est-à-dire de payer un tiers pour le simple droit d'émettre leurs factures. Dokos en est **partenaire et membre fondateur**, et à ce titre ses clients **Dokos Cloud** accèdent à la plateforme Esalink (HUBTIMIZE) sans avoir à souscrire de contrat séparé : les identifiants partenaires sont fournis et maintenus par Dokos Cloud.

C'est la voie la plus simple, et celle recommandée si vous êtes hébergé sur Dokos Cloud. L'inscription de votre société se fait ensuite directement depuis Dokos.

### Esalink pour les installations auto-hébergées

Si Dokos est installé sur votre propre infrastructure, l'accès mutualisé de Dokos Cloud ne s'applique pas : votre installation a besoin de ses propres **clés de connexion** à Esalink. Pour les obtenir, **rapprochez-vous de Dokos SAS**.

Esalink ne contractualise en effet qu'exceptionnellement en direct avec les entreprises : hors très gros volumes de factures, l'accès passe par un **éditeur ou un intégrateur**. Dokos SAS joue ce rôle et vous remet les clés à déclarer sur votre installation. Si vos volumes sont importants, un contrat direct avec Esalink reste envisageable — Dokos SAS vous orientera.

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Sans clés de connexion, Dokos refuse la création d'une plateforme Esalink et l'annonce explicitement. Sur Dokos Cloud, écrivez à **<help@dokos.cloud>** pour l'activer. En auto-hébergement, contactez **Dokos SAS** pour obtenir vos clés.
::

### SuperPDP, sur inscription et clés d'API

SuperPDP est une plateforme certifiée que vous rejoignez par vos propres moyens : vous créez un compte sur SuperPDP et y récupérez vos **clés de connexion** — un **identifiant client** et un **secret client**. Il ne reste plus qu'à les saisir dans Dokos, sans autre démarche.

C'est aussi la plateforme la plus complète : elle est la seule à gérer l'annuaire **Peppol** pour la facturation internationale, l'**e-reporting** des opérations B2C, et à proposer un **mode bac à sable** permettant d'envoyer une facture de test de bout en bout.

### Une autre plateforme, via l'API AFNOR

Toute plateforme respectant le standard **AFNOR XP Z12-013** peut être raccordée sans développement spécifique : Dokos parle directement ce standard. Vous ajoutez une **Plateforme personnalisée** et saisissez l'URL du service, l'identifiant et le secret remis par votre prestataire.

Cette voie est la plus ouverte, mais aussi la plus limitée, car Dokos ne connaît pas les spécificités de la plateforme :

- l'**inscription à l'annuaire** ne peut pas se faire depuis Dokos — elle passe par le portail de votre prestataire ;
- l'**e-reporting B2C** n'est pas pris en charge ;
- seul l'&#x2A;*annuaire français (PPF)** est interrogé, à l'exclusion de Peppol.

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Chaque plateforme AFNOR interprète le standard à sa manière. Une plateforme autre que SuperPDP ou Esalink doit donc être **validée au cas par cas**, en émettant et en recevant une facture de test avant toute mise en production.
::

## Configuration d'une plateforme par société :badge{text="Dokos" type="warning"}

Chaque plateforme se configure au niveau de la **société**, depuis les *Paramètres E-transactions*, onglet **Plateforme Agréée**. Une même société peut disposer de plusieurs plateformes, chacune avec son périmètre :

- **Ventes** — émission de vos factures clients ;
- **Achats** — réception de vos factures fournisseur ;
- **Les deux** — émission et réception sur la même plateforme.

Chaque plateforme peut être activée ou désactivée, et passée en **mode bac à sable** pour tester votre configuration avant la mise en production. Tant qu'une plateforme n'est pas active, aucune facture n'est transmise.

::dokos
La configuration se fait dans *Paramètres E-transactions → Plateforme Agréée*. Utilisez les boutons **SuperPDP**, **Esalink** ou **Plateforme personnalisée** pour ajouter une connexion, puis renseignez son périmètre et son environnement.
::

## Test de connexion et suivi de santé :badge{text="Dokos" type="warning"}

Dokos vérifie que vos identifiants fonctionnent avant toute transmission. Depuis la liste des plateformes, le bouton **Tester la connexion** effectue un contrôle immédiat sans rien enregistrer ni envoyer.

En complément, Dokos réalise chaque jour un **contrôle de santé** automatique de vos plateformes actives et conserve le résultat (connexion valide ou en erreur, date et message). Un voyant vous alerte si une connexion cesse de fonctionner, par exemple à l'expiration d'un identifiant, afin de corriger la situation avant qu'une facture ne parte en échec.

## Voir aussi

- [Inscrire votre société à l'annuaire](https://doc.dokos.io/v5/integrations/etransaction/inscription-annuaire)
- [Configurer clients et fournisseurs](https://doc.dokos.io/v5/integrations/etransaction/configuration-clients-fournisseurs)
- [Émettre des factures électroniques](https://doc.dokos.io/v5/integrations/etransaction/emission-factures-electroniques)
- [Recevoir des factures électroniques](https://doc.dokos.io/v5/integrations/etransaction/reception-factures-electroniques)


# Inscrire votre société à l'annuaire de facturation

Pour recevoir des factures électroniques, votre société doit être **joignable** : elle s'inscrit d'abord sur une Plateforme Agréée, qui lui attribue ses identifiants de connexion, puis déclare son **adresse électronique à l'annuaire** de facturation. Sans entrée d'annuaire, aucun de vos clients ne peut vous adresser de facture.

Le parcours se déroule donc en deux temps : l'**inscription sur la plateforme**, dont le déroulé dépend de la plateforme choisie, puis l'**inscription à l'annuaire**, identique dans son principe.

::callout{color="blue" icon="i-heroicons-information-circle"}
Votre société est déjà inscrite sur sa plateforme ? Rendez-vous directement à la section [Inscription à l'annuaire](https://doc.dokos.io/#inscription-%C3%A0-lannuaire).
::

## Informations société requises :badge{text="Dokos" type="warning"}

Avant toute inscription, Dokos vérifie que votre société est prête à émettre. Un tableau de bord d'**état de préparation** signale ce qui manque encore.

Sont nécessaires : le **numéro SIREN**, le **numéro de TVA**, une **adresse par défaut** complète (voie, code postal, ville, pays), une **adresse électronique** de réception (identifiant d'annuaire ou, à défaut, une adresse email) et un **régime de TVA** pour la déclaration périodique (e-reporting). Une fois ces éléments présents et une plateforme active, votre société peut émettre.

::callout{color="blue" icon="i-heroicons-light-bulb"}
Le bouton **Remplir depuis SIRENE** sur la fiche société renseigne automatiquement le SIREN, le numéro de TVA et l'adresse du siège à partir de l'annuaire officiel des entreprises.
::

## Inscription SuperPDP :badge{text="Dokos" type="warning"}

Le raccordement à SuperPDP tient en deux étapes : récupérer vos clés de connexion, puis les saisir dans Dokos. Vous n'avez **aucune application à déclarer** sur la plateforme.

1. Créez votre compte sur SuperPDP et récupérez-y vos clés de connexion : un **identifiant client** et un **secret client**.
2. Dans *Paramètres E-transactions*, ajoutez une plateforme **SuperPDP**, saisissez ces deux clés, puis enregistrez. Le bouton **Tester la connexion** confirme immédiatement qu'elles sont valides.

SuperPDP procède ensuite à sa propre vérification d'identité de l'entreprise (KYB). Vous pouvez consulter cet état depuis la configuration de la plateforme.

::mermaid
flowchart LR
A\[Créer son compte sur SuperPDP] --> B\[Récupérer identifiant et secret client]
B --> C\[Ajouter la plateforme SuperPDP dans Dokos]
C --> D\[Saisir les clés et tester la connexion]
D --> E\[Vérification KYB par SuperPDP]

::

::callout{color="blue" icon="i-heroicons-light-bulb"}
En mode bac à sable, le bouton **Lancer le test sandbox** émet une facture de test de bout en bout vers SuperPDP. C'est le moyen le plus sûr de valider votre configuration avant la première facture réelle.
::

## Inscription Esalink :badge{text="Dokos" type="warning"}

Esalink (HUBTIMIZE) permet une **inscription automatisée** de votre société directement depuis Dokos, avec validation d'identité (KYC).

1. Ajoutez une plateforme **Esalink**. Elle apparaît d'abord comme **Non inscrite**.
2. Ouvrez sa configuration, puis cliquez sur **Inscrire sur Esalink**. Dokos pré-remplit le formulaire à partir de votre société : SIREN, raison sociale, numéro de TVA, adresse et **email de contact**. Cet email recevra le message de validation KYC — vérifiez-le avec soin.
3. À la soumission, Dokos crée le compte chez HUBTIMIZE, déclenche l'envoi de l'email KYC et récupère automatiquement les identifiants de connexion. Le compte passe en **En attente de validation**.

Cette même étape déclare aussi votre **première adresse de routage** à l'annuaire, celle qui correspond au numéro SIREN de la société. Vous n'avez donc rien à faire de plus pour être joignable.

Le formulaire d'inscription affiche cette **adresse de routage** dans un champ modifiable. Elle reprend par défaut l'identifiant légal choisi — SIREN ou SIRET — et il n'y a aucune raison d'y toucher dans le cas courant. Vous pouvez néanmoins l'ajuster pour router vos factures vers un point de réception plus précis, comme expliqué ci-dessous.

Tant que la vérification d'identité n'est pas terminée, le compte reste inactif. Dokos vérifie le statut chaque heure et **active** la plateforme dès qu'elle passe à « Actif ». Les boutons **Rafraîchir le statut** et **Renvoyer l'email KYC** permettent d'accélérer ou de relancer la démarche.

::mermaid
flowchart LR
A\[Ajouter la plateforme Esalink] --> B\[Non inscrite]
B --> C\[Inscrire sur Esalink]
C --> D\[Compte créé, email KYC envoyé, adresse de routage déclarée]
D --> E\[En attente de validation]
E -- Validation KYC --> F\[Actif]
F --> G\[Plateforme activée automatiquement]

::

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
L'inscription Esalink suppose que les clés de connexion soient en place sur votre site. Sur Dokos Cloud, elles sont fournies par Dokos ; en auto-hébergement, rapprochez-vous de **Dokos SAS** pour les obtenir. Voir [Quelle plateforme choisir](https://doc.dokos.io/v5/integrations/etransaction/plateformes-agreees#quelle-plateforme-choisir).
::

## Plateforme personnalisée :badge{text="Dokos" type="warning"}

Pour toute autre plateforme conforme au standard AFNOR, ajoutez une **Plateforme personnalisée** et saisissez l'**identifiant** et le **secret** fournis par votre prestataire, ainsi que l'**URL de base** de son service. Le bouton **Tester la connexion** confirme que les identifiants sont valides avant la première transmission.

L'inscription de la société et son inscription à l'annuaire se font alors **sur le portail de votre prestataire**, et non depuis Dokos.

## Rôle de l'annuaire de facturation électronique :badge{text="Dokos" type="warning"}

L'annuaire est le registre officiel qui indique, pour chaque entreprise, **sous quel identifiant et via quelle plateforme** lui adresser une facture électronique. C'est l'équivalent d'un annuaire téléphonique : vos clients y cherchent votre société, y trouvent votre adresse électronique, et leur plateforme achemine la facture vers la vôtre.

Une entrée d'annuaire associe un **identifiant** — le plus souvent votre numéro SIREN — à la plateforme qui reçoit vos factures. Tant que cette entrée n'existe pas, vos clients ne peuvent pas vous facturer par voie électronique, même si votre plateforme est active.

::callout{color="blue" icon="i-heroicons-information-circle"}
Ne confondez pas les deux usages de l'annuaire. Cette page traite de l'inscription de **votre société**, pour que l'on puisse vous facturer. La consultation de l'annuaire pour **vos clients**, afin de savoir où leur envoyer vos factures, est décrite dans [Clients et fournisseurs pour la facture électronique](https://doc.dokos.io/v5/integrations/etransaction/configuration-clients-fournisseurs).
::

## Inscription à l'annuaire :badge{text="Dokos" type="warning"}

L'inscription à l'annuaire se fait depuis la configuration de la plateforme, par le bouton **Inscription à l'annuaire**. Le dialogue liste les entrées déjà déclarées — **Identifiant**, **Annuaire**, **Statut** — et permet d'en ajouter ou d'en supprimer.

Pour ajouter une entrée, renseignez deux champs :

- **Annuaire** — `FR (PPF)` pour l'annuaire français, ou `Peppol` pour le réseau international.
- **Identifiant** — Dokos le pré-remplit avec le SIREN de votre société, sous la forme `0225:123456789`, où `0225` désigne le schéma « SIREN ». Un identifiant Peppol doit toujours porter son propre schéma, par exemple `0088:1234567890123`.

Validez par **Ajouter une entrée**. L'entrée apparaît alors dans la liste avec son statut.

::mermaid
flowchart LR
A\[Configuration de la plateforme] --> B\[Inscription à l'annuaire]
B --> C\[Choisir l'annuaire : FR PPF ou Peppol]
C --> D\[Identifiant, pré-rempli au SIREN]
D --> E\[Ajouter une entrée]
E --> F\[Société joignable par ses clients]

::

Le bouton **Inscription à l'annuaire** n'est proposé que sur les plateformes qui savent inscrire votre société depuis Dokos : **SuperPDP**, et **Esalink** une fois la société inscrite. Sur une **plateforme personnalisée**, l'inscription à l'annuaire relève du portail de votre prestataire.

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Sur SuperPDP, l'entrée est enregistrée immédiatement. Sur Esalink, chaque demande d'identifiant est validée par la plateforme et **prend effet à une date de début située au moins dix jours dans le futur**. Anticipez ce délai : une inscription demandée aujourd'hui ne vous rend pas joignable aujourd'hui.
::

## Identifiants supplémentaires et établissements :badge{text="Dokos" type="warning"}

Une entrée au SIREN suffit à recevoir les factures de toute la société. Vous pouvez néanmoins déclarer des **identifiants supplémentaires** lorsque plusieurs adresses de réception sont nécessaires.

C'est le cas lorsqu'un **établissement** doit être adressé séparément — vous inscrivez alors son **SIRET** — ou lorsque vous échangez avec des partenaires européens, ce qui suppose une entrée dans l'annuaire **Peppol** en plus de l'annuaire français. Chaque entrée s'ajoute par le même dialogue, et se supprime de la même façon si elle n'a plus lieu d'être.

## Préfixe et suffixe d'adressage :badge{text="Dokos" type="warning"}

Une adresse de routage n'est pas figée sur le seul numéro d'identification : elle accepte un **préfixe ou un suffixe** qui désigne un point de réception plus fin que l'entreprise ou l'établissement. C'est ce qui permet d'aiguiller les factures vers un service, une unité ou un site donné, plutôt que vers une boîte unique pour toute la société.

Une entreprise peut ainsi distinguer l'adresse par défaut de son établissement, celle de son service Achats, celle de sa comptabilité ou celle d'un site géographique — chacune devenant une adresse de routage distincte, déclarée comme une entrée d'annuaire à part entière.

Dans Dokos, il suffit de modifier l'**adresse de routage** proposée lors de l'inscription, ou d'ajouter une entrée supplémentaire portant l'identifiant suffixé.

::callout{color="blue" icon="i-heroicons-information-circle"}
Les conventions d'adressage — codes de routage, formats de suffixe et exemples — sont détaillées par Esalink dans son article [L'annuaire de la réforme 2026](https://www.esalink.com/blog/annuaire-reforme2026/){rel=""nofollow""}. Vérifiez le format attendu par votre plateforme avant de déclarer une adresse suffixée.
::

## Voir aussi

- [Se connecter à une Plateforme Agréée](https://doc.dokos.io/v5/integrations/etransaction/plateformes-agreees)
- [Configurer clients et fournisseurs](https://doc.dokos.io/v5/integrations/etransaction/configuration-clients-fournisseurs)
- [Émettre des factures électroniques](https://doc.dokos.io/v5/integrations/etransaction/emission-factures-electroniques)
- [Recevoir des factures électroniques](https://doc.dokos.io/v5/integrations/etransaction/reception-factures-electroniques)


# Clients et fournisseurs pour la facture électronique

Pour qu'une facture électronique parte vers le bon destinataire et qu'une facture reçue soit rattachée au bon fournisseur, Dokos a besoin de données d'identification précises sur vos tiers. La plupart se remplissent une seule fois, à la création de la fiche.

## Données à renseigner sur un client :badge{text="Dokos" type="warning"}

Un client destinataire de factures électroniques doit être identifiable de façon fiable. Dokos s'appuie sur le **numéro SIREN** et le **numéro de TVA** du client pour le classer (entreprise, administration, particulier) et pour interroger l'annuaire officiel.

Le **profil e-invoice** est le déclencheur : tant qu'il n'est pas renseigné sur la fiche client, aucune facture électronique n'est générée pour ce client. Vous pouvez aussi préciser une **référence acheteur** (code service) ou un **numéro de marché** pour les factures adressées au secteur public.

::callout{color="blue" icon="i-heroicons-light-bulb"}
Le bouton **Remplir depuis SIRENE** sur la fiche client renseigne automatiquement le SIREN, le numéro de TVA et l'adresse du siège.
::

## Annuaire et routage des clients :badge{text="Dokos" type="warning"}

L'annuaire indique par quelle plateforme joindre un client et sous quelle adresse électronique. Dokos **synchronise automatiquement** ces informations depuis la Plateforme Agréée à partir du SIREN du client : type d'entité (entreprise, administration, particulier), état d'activité et adresse de réception.

La synchronisation se déclenche périodiquement et se relance manuellement depuis la fiche client. Pour un client international, vous choisissez l'annuaire **Peppol** plutôt que l'annuaire français. Vous pouvez également rattacher un client à une plateforme dédiée si vous n'utilisez pas la même pour tous.

## Établissements et SIRET :badge{text="Dokos" type="warning"}

Une même entreprise cliente peut avoir plusieurs établissements, chacun identifié par un **SIRET**. Le SIRET renseigné sur une **adresse** relie cette adresse à la bonne ligne d'annuaire : c'est ce qui permet à Dokos d'acheminer la facture vers le bon établissement. Une référence acheteur propre à un établissement prend le pas sur celle définie au niveau du client.

## Données à renseigner sur un fournisseur :badge{text="Dokos" type="warning"}

Côté réception, Dokos rattache chaque facture entrante au bon fournisseur grâce à ses données d'identification. Renseignez le **numéro SIREN**, le **numéro de TVA** et, si vous le connaissez, l'**adresse électronique** du fournisseur.

Lorsqu'une facture arrive, Dokos recherche le fournisseur correspondant en priorité par son numéro de TVA, puis par son IBAN, par un éventuel **alias de nom** et enfin par son nom. Plus ces données sont complètes, plus le rapprochement est fiable et automatique.

## Vérifier l'état de préparation d'un tiers :badge{text="Dokos" type="warning"}

Dokos affiche un **état de préparation** pour chaque client, qui signale en un coup d'œil les données manquantes ou incohérentes avant l'émission d'une facture. Les contrôles portent notamment sur la présence et la validité du SIREN, la cohérence entre le SIREN et le numéro de TVA, l'adresse de facturation avec son SIRET, et la prise en charge du client dans l'annuaire.

Certains signaux sont **bloquants** — une donnée indispensable manque, la facture ne peut pas être transmise — tandis que d'autres sont de simples **avertissements** invitant à vérifier une valeur. Corriger ces points depuis la fiche du tiers évite les rejets ultérieurs par la Plateforme Agréée. Lorsqu'une facture est refusée, Dokos ramène le message de la plateforme vers la donnée à corriger (fiche client, société ou paramètres).

## Voir aussi

- [Émettre des factures électroniques](https://doc.dokos.io/v5/integrations/etransaction/emission-factures-electroniques)
- [Recevoir des factures électroniques](https://doc.dokos.io/v5/integrations/etransaction/reception-factures-electroniques)
- [Inscrire votre société à l'annuaire](https://doc.dokos.io/v5/integrations/etransaction/inscription-annuaire)
- [Factures de vente](https://doc.dokos.io/v5/dokos/ventes/facture-de-vente)


# Émettre des factures électroniques dans Dokos

À la validation d'une **facture de vente**, Dokos génère automatiquement la facture électronique au format structuré attendu, puis l'achemine vers votre Plateforme Agréée. Vous continuez à travailler depuis votre facture de vente habituelle ; toute la mécanique réglementaire est prise en charge en arrière-plan.

## Classification automatique de la facture :badge{text="Dokos" type="warning"}

Dokos détermine automatiquement la nature de chaque facture, car elle conditionne son traitement réglementaire. À partir des données du client, la facture est classée en **B2B** (entreprise), **B2G** (administration publique), **B2C** (particulier) ou **B2Bi** (partenaire étranger).

Les factures B2B et B2G sont transmises comme **factures électroniques structurées**. Les factures B2C et B2Bi relèvent de l'**e-reporting** : Dokos en transmet les données à l'administration sans échanger de facture structurée avec le destinataire.

## Format de la facture électronique :badge{text="Dokos" type="warning"}

Dokos choisit le format le mieux adapté au destinataire. Par défaut, pour une facture domestique, il génère un fichier **Factur-X / CII** (données structurées intégrées au PDF). Pour un destinataire joignable via l'annuaire international, il produit un fichier **UBL / Peppol BIS 3.0**. Pour une facture destinée au secteur public, Dokos bascule automatiquement sur le profil adapté à Chorus Pro.

## Acheminement vers la plateforme :badge{text="Dokos" type="warning"}

Dokos achemine la facture vers le bon destinataire à partir de la ligne d'annuaire du client, ou du **SIRET** de l'établissement facturé lorsque le client possède plusieurs établissements. Le format et le destinataire sont donc déduits automatiquement des données du client et de l'adresse retenue.

::mermaid
flowchart LR
A\[Facture de vente validée] --> B\[Classification B2B / B2G / B2C]
B --> C{Facture structurée ?}
C -- B2B / B2G --> D\[Génération Factur-X ou Peppol]
D --> E\[Envoi à la Plateforme Agréée]
E --> F\[Suivi du statut et du cycle de vie]
C -- B2C / B2Bi --> G\[E-reporting des données]

::

## Envoi et suivi du cycle de vie :badge{text="Dokos" type="warning"}

L'envoi peut être **automatique** — Dokos transmet la facture dès sa validation si l'option est activée sur la plateforme — ou **manuel**, depuis la facture de vente. Dans les deux cas, un panneau affiche le **statut** de la facture sur la plateforme.

Dokos suit ensuite le **cycle de vie** de la facture : reçue par le destinataire, approuvée, mise en litige, payée… Ces statuts remontent automatiquement et peuvent aussi être déclenchés par Dokos, par exemple à l'enregistrement d'un paiement.

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Une facture déjà transmise ne peut pas être simplement annulée. Utilisez l'action **Annuler avec cycle de vie** : Dokos signale d'abord l'annulation à la plateforme, puis annule la facture.
::

## E-reporting des ventes B2C et intracommunautaires :badge{text="Dokos" type="warning"}

Pour les factures aux particuliers et à certains partenaires étrangers, Dokos prépare automatiquement les **données d'e-reporting** (montants hors taxes, TVA par taux) et les transmet à la plateforme selon la périodicité déclarée dans le régime de TVA de votre société. Les données de paiement sont transmises de la même façon lorsqu'elles sont requises.

## Voir aussi

- [Recevoir des factures électroniques](https://doc.dokos.io/v5/integrations/etransaction/reception-factures-electroniques)
- [Configurer clients et fournisseurs](https://doc.dokos.io/v5/integrations/etransaction/configuration-clients-fournisseurs)
- [Se connecter à une Plateforme Agréée](https://doc.dokos.io/v5/integrations/etransaction/plateformes-agreees)
- [Factures de vente](https://doc.dokos.io/v5/dokos/ventes/facture-de-vente)


# Recevoir des factures électroniques dans Dokos

Dokos récupère périodiquement vos factures fournisseur depuis la Plateforme Agréée, lit leurs données structurées et prépare une **facture fournisseur en attente** dans la banette. Vous n'avez plus qu'à vérifier le rapprochement et à créer la facture d'achat définitive.

## Récupération automatique des factures entrantes :badge{text="Dokos" type="warning"}

Dokos interroge automatiquement la plateforme à intervalle régulier pour détecter les nouvelles factures adressées à votre société. Chaque facture inédite est téléchargée, puis déposée dans la **banette de factures d'achat**, sans que vous ayez à vous connecter à la plateforme. Un responsable comptable reçoit une notification à chaque nouvelle arrivée.

## Lecture des données structurées :badge{text="Dokos" type="warning"}

Dokos lit directement le contenu structuré de la facture, aux formats **UBL** et **CII** (y compris les données intégrées à un PDF Factur-X). Il en extrait le fournisseur, les montants hors taxes et de TVA, les articles, les conditions de paiement et les coordonnées bancaires (IBAN, BIC), sans ressaisie manuelle.

## Rapprochement du fournisseur :badge{text="Dokos" type="warning"}

Dokos rattache chaque facture reçue au bon fournisseur automatiquement. Il recherche une correspondance par **numéro de TVA**, puis par **IBAN**, par **alias de nom** et enfin par nom, et affiche un **niveau de confiance**. Vous confirmez ou corrigez le fournisseur proposé avant de poursuivre.

::mermaid
flowchart TD
A\[Plateforme Agréée] --> B\[Récupération automatique]
B --> C\[Banette de factures d'achat]
C --> D\[Lecture des données UBL / CII]
D --> E\[Rapprochement du fournisseur]
E --> F\[Création de la facture d'achat]

::

## De la banette à la facture d'achat :badge{text="Dokos" type="warning"}

Depuis la facture fournisseur en attente, Dokos crée la **facture d'achat** définitive, avec ou sans commande fournisseur associée selon votre configuration. La facture fournisseur suit les mêmes statuts que les factures traitées par OCR : **En attente**, **En cours**, **Prêt** puis **Terminé**, ce qui vous donne une vue claire de ce qui reste à traiter.

Dokos remonte également les **statuts de cycle de vie** vers l'émetteur — prise en charge, approbation — automatiquement à l'enregistrement ou à la validation de la facture d'achat, selon vos paramètres.

::callout{color="blue" icon="i-heroicons-information-circle"}
La réception de factures structurées et l'extraction OCR des PDF partagent la même banette de factures d'achat. Vous traitez toutes vos factures fournisseur au même endroit.
::

## Voir aussi

- [Émettre des factures électroniques](https://doc.dokos.io/v5/integrations/etransaction/emission-factures-electroniques)
- [Configurer clients et fournisseurs](https://doc.dokos.io/v5/integrations/etransaction/configuration-clients-fournisseurs)
- [Se connecter à une Plateforme Agréée](https://doc.dokos.io/v5/integrations/etransaction/plateformes-agreees)


# L'intelligence artificielle dans Dokos

Dokos ne se contente pas d'un chat greffé sur l'interface : l'IA travaille **sur vos données réelles**, avec **vos permissions**, et laisse une trace de tout ce qu'elle fait. Elle intervient à trois endroits — répondre à une question, préparer un travail récurrent, et ouvrir votre site à un assistant externe.

::mermaid
flowchart LR
U(Vous) --> A[Assistant\nconversationnel]
E(Événement\nou planification) --> F[Flux\nautomatisé]
X(Assistant externe\nClaude, agy, Vibe...) --> M[Passerelle MCP]


```text
A --> V{Validation}
F --> V
M --> V
V --> D[(Votre site Dokos)]
D --> J[Journal d'audit]
```
::

## Trois usages

**Poser une question et obtenir une action.** L'assistant lit vos documents, exécute vos rapports, cherche dans la documentation et le wiki interne, explique pourquoi un utilisateur n'a pas accès à un écran — et, quand vous le lui demandez, prépare la création ou la modification d'un document que vous validez d'un clic.

**Confier une tâche récurrente.** Un flux se déclenche sur un événement (une opportunité créée, une demande de matériel enregistrée), à heure fixe ou à la demande. Il rédige, calcule, compare, puis dépose le résultat dans une boîte de réception où vous l'approuvez ou le rejetez.

**Travailler depuis un assistant externe.** Claude Code, Claude Cowork, agy, Vibe CLI et OpenCode se connectent à votre site via Dokos CLI et manipulent les mêmes données, avec les mêmes garde-fous.

::callout{color="green" icon="i-mdi-shield-check-outline"}
L'IA est **désactivée tant que vous ne l'activez pas**. Rien n'est envoyé à un fournisseur de modèles, aucun flux ne s'exécute et aucun outil n'apparaît dans l'interface avant l'activation et la saisie d'une clé d'accès.
::

## Par où commencer

::card-group
  :::card
  ---
  icon: i-mdi-cog-outline
  title: Activer et paramétrer l'IA
  to: https://doc.dokos.io/v5/integrations/ia/configuration
  ---
  Activation, clé d'accès au fournisseur, choix des modèles, garde-fous et journal d'audit
  :::

  :::card
  ---
  icon: i-mdi-chat-processing-outline
  title: L'assistant
  to: https://doc.dokos.io/v5/integrations/ia/assistant
  ---
  Dialoguer avec votre site : lecture, rapports, recherche documentaire, propositions d'écriture et compétences
  :::

  :::card
  ---
  icon: i-mdi-sitemap-outline
  title: Les flux automatisés
  to: https://doc.dokos.io/v5/integrations/ia/flux-automatises
  ---
  Déclencher un traitement sur un événement, une planification ou un appel externe, avec approbation humaine
  :::

  :::card
  ---
  icon: i-mdi-transit-connection-variant
  title: Connecter des outils externes
  to: https://doc.dokos.io/v5/integrations/ia/serveurs-mcp
  ---
  Donner à l'assistant l'accès à vos autres applications via des serveurs MCP
  :::

  :::card
  ---
  icon: i-mdi-console
  title: Piloter Dokos depuis un assistant externe
  to: https://doc.dokos.io/v5/integrations/ia/assistants-externes
  ---
  Claude Code, Claude Cowork, agy, Vibe CLI et OpenCode connectés à votre site avec Dokos CLI
  :::
::

## Prérequis

L'application **Dokos AI** doit être installée sur votre site, et une clé d'accès à un fournisseur de modèles doit être enregistrée dans les paramètres de l'IA. Pour un site hébergé sur Dokos Cloud, l'installation se demande depuis votre tableau de bord ; pour une installation autogérée, elle se fait comme celle de toute application additionnelle.

## Voir aussi

- [Activer et paramétrer l'IA](https://doc.dokos.io/v5/integrations/ia/configuration)
- [Dokos CLI](https://doc.dokos.io/v5/dokos-cli) — l'outil en ligne de commande et son serveur MCP


# Activer et paramétrer l'IA

Tant que l'IA n'est pas activée, elle n'existe pas pour vos utilisateurs : aucun assistant dans l'interface, aucun flux qui s'exécute, aucune donnée transmise à un fournisseur de modèles. L'activation se fait une seule fois, depuis les **Paramètres de l'IA**, et ouvre ensuite capacité par capacité ce que l'IA a le droit de faire.

## Activer et connecter un fournisseur de modèles

Dokos ne fabrique pas de modèle : il en consomme, via **OpenRouter**, qui donne accès aux modèles de Google, Anthropic, OpenAI et Mistral avec une seule clé. Créez un compte chez ce fournisseur, générez une clé, collez-la dans les paramètres et testez-la : le bouton de test valide la clé immédiatement, sans attendre la première question d'un utilisateur.

La consommation est facturée par le fournisseur, à l'usage. Dokos compte les jetons consommés à chaque exécution et les affiche dans le suivi, ce qui permet de rattacher une dépense à un flux précis.

## Choisir les modèles selon la tâche

Toutes les tâches ne méritent pas le même modèle. Dokos en distingue trois usages, que vous associez chacun à un modèle de votre choix :

| Usage                | À quoi il sert                                                                                                                                                          |
| -------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Logique et agent** | Le modèle principal : raisonner, enchaîner des outils, préparer une écriture. C'est lui qui répond dans l'assistant et qui exécute les flux.                            |
| **Rapide**           | Les tâches courtes et répétitives — reformuler, classer, compléter un champ de texte. Moins coûteux, il évite de mobiliser le modèle principal pour un travail trivial. |
| **OCR et vision**    | La lecture d'images et de PDF : factures scannées, justificatifs, documents non structurés.                                                                             |

Le catalogue des modèles disponibles est fourni avec l'application ; vous pouvez en désactiver, en ajouter, et changer d'affectation à tout moment sans toucher au reste de la configuration.

::callout{color="teal" icon="i-mdi-lightbulb-on-outline"}
Un **prompt global** vous permet de donner à l'assistant un contexte valable pour toutes les conversations : le nom de votre société, votre secteur, vos conventions internes, la langue à employer. C'est le moyen le plus simple d'obtenir des réponses qui parlent votre vocabulaire plutôt qu'un vocabulaire générique.
::

## Ouvrir les capacités sensibles, une par une

Quatre capacités élargissent ce que l'IA peut atteindre au-delà de vos données. Elles sont **toutes fermées par défaut** et s'ouvrent séparément, en connaissance de cause.

**La recherche web.** L'assistant interroge le web uniquement quand la documentation Dokos et votre base de connaissances internes ne répondent pas. Activez-la si vos utilisateurs posent des questions qui débordent du périmètre du site.

**Les appels HTTP sortants.** L'assistant et les flux peuvent appeler des services externes en HTTPS — mais seulement vers les hôtes que vous avez explicitement listés. Sans liste, aucun appel ne part. C'est ce qui permet à un flux d'aller chercher un taux de change ou de notifier un outil tiers, sans ouvrir la porte au reste d'internet.

**Les serveurs MCP.** Ils donnent à l'assistant l'accès aux outils d'autres applications. Voir [Connecter des outils externes](https://doc.dokos.io/v5/integrations/ia/serveurs-mcp).

**Le pont Raven.** Vos utilisateurs dialoguent avec l'assistant en envoyant un message direct à un bot dans Raven, sans quitter leur messagerie d'équipe.

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Les serveurs MCP de type **commande locale** exécutent un programme sur votre serveur Dokos. Cette possibilité fait l'objet d'une autorisation distincte, à n'accorder que si vous maîtrisez ce que ces commandes exécutent.
::

## Suivre ce que l'IA a fait

Le **journal d'audit** enregistre chaque événement notable : qui a agi, sur quel flux et quelle exécution, depuis quelle origine et quelle adresse, avec quel résultat et combien de jetons consommés. Une décision refusée y figure avec son motif, au même titre qu'une action réussie.

C'est le document à ouvrir en premier quand quelqu'un demande « qu'est-ce que l'IA a modifié hier ? » — et la réponse à apporter à un auditeur qui s'interroge sur l'automatisation d'un processus comptable ou RH.

::callout{color="green" icon="i-mdi-shield-check-outline"}
L'IA n'élargit jamais les droits de personne. L'assistant interroge le site avec les permissions de l'utilisateur connecté ; un flux s'exécute avec celles de l'utilisateur désigné pour le porter. Ce que l'IA ne pourrait pas ouvrir manuellement, elle ne le voit pas.
::

## Voir aussi

- [L'assistant](https://doc.dokos.io/v5/integrations/ia/assistant)
- [Les flux automatisés](https://doc.dokos.io/v5/integrations/ia/flux-automatises)
- [Connecter des outils externes](https://doc.dokos.io/v5/integrations/ia/serveurs-mcp)


# L'assistant

L'assistant est le point d'entrée quotidien de l'IA : vous posez une question en français, il va chercher la réponse dans vos données réelles, et vous répond en citant ce qu'il a consulté. Quand la réponse suppose une action — créer un devis, corriger un champ, assigner un rôle — il la **prépare et vous la soumet** plutôt que de l'exécuter dans votre dos.

> **Exemple — Dokompany**
> « Quels clients ont dépassé leur encours autorisé ce mois-ci ? » L'assistant exécute le rapport des créances, croise les résultats avec les limites de crédit, et vous renvoie la liste avec le montant de dépassement pour chacun. Vous enchaînez : « prépare une relance pour les trois premiers » — il rédige les trois messages et attend votre feu vert.

## Trois endroits pour lui parler

**L'espace Dokos AI** rassemble les conversations, les flux et le suivi. Il s'ouvre depuis l'icône **AI Assistant** de votre bureau et démarre sur la boîte de réception, c'est-à-dire sur la seule question qui compte en arrivant : qu'est-ce qui m'attend ?

**Le bouton IA dans les formulaires** agit sur le document que vous avez sous les yeux. À côté des champs de texte, il propose de rédiger ou de reformuler un contenu à partir du contexte du document — description d'article, conditions d'une offre, compte rendu d'intervention — et vous voyez la proposition avant qu'elle ne remplace quoi que ce soit.

**Raven**, si vous l'utilisez, permet de dialoguer avec l'assistant par message direct, sans quitter votre messagerie d'équipe. Cette passerelle s'active dans les [paramètres de l'IA](https://doc.dokos.io/v5/integrations/ia/configuration).

## Ce qu'il sait faire

| Domaine              | Ce que vous pouvez lui demander                                                                                       |
| -------------------- | --------------------------------------------------------------------------------------------------------------------- |
| **Vos données**      | Retrouver un document, lister ce qui correspond à un critère, comparer, compter, vérifier l'existence d'une fiche     |
| **Vos analyses**     | Lister les rapports disponibles, les exécuter avec vos filtres, en agréger les résultats, retrouver un graphique      |
| **La connaissance**  | Chercher dans la documentation Dokos, dans votre wiki interne, dans vos cours et vos notes publiques                  |
| **Les permissions**  | Expliquer pourquoi un utilisateur ne peut pas ouvrir un écran ou valider un document, et proposer les rôles à ajouter |
| **La mise en forme** | Rédiger un modèle d'impression, écrire un script de formulaire, composer un espace de travail et sa navigation        |
| **L'écriture**       | Préparer la création ou la modification d'un document, remplir un champ, le tout soumis à votre validation            |

## La boîte de réception : rien ne passe sans vous

Tout ce sur quoi l'IA attend un humain arrive au même endroit : une écriture que l'assistant a préparée, une étape d'un flux qui exige une approbation. Vous y voyez ce qui est proposé, sur quel document, à la demande de qui — et vous approuvez ou vous rejetez.

C'est ce qui rend l'automatisation acceptable : une proposition non validée ne devient jamais un document. Un rejet est enregistré dans le [journal d'audit](https://doc.dokos.io/v5/integrations/ia/configuration) avec son motif, au même titre qu'une approbation.

::callout{color="green" icon="i-mdi-shield-check-outline"}
L'assistant travaille avec **vos** permissions. Il ne lit pas un document que vous ne pourriez pas ouvrir et ne prépare pas une écriture que vous ne pourriez pas faire vous-même. Un utilisateur des ventes et un comptable ne verront pas les mêmes réponses à la même question.
::

## Les compétences : lui apprendre vos façons de faire

Une **compétence** est une fiche d'instructions qui spécialise l'assistant sur un sujet : quoi vérifier avant d'agir, quels outils employer, dans quel ordre, avec quelles précautions. L'assistant charge la compétence utile au moment où elle sert, plutôt que de tout garder en tête en permanence.

Dokos en fournit une bibliothèque, qui couvre la création et la modification de documents, la génération de rapports, la mise en page des formulaires et des impressions, la recherche documentaire et le diagnostic de permissions.

Vous pouvez surtout **écrire les vôtres**. Une compétence maison décrit un processus propre à votre organisation — votre procédure de validation des devis, vos règles de remise, la manière dont vous qualifiez un litige — et l'assistant l'applique ensuite systématiquement. Chaque compétence indique le domaine qu'elle couvre, le modèle à employer (rapide ou principal), les outils auxquels elle donne accès, et peut s'appuyer sur des **documents de référence** que l'assistant consulte à la demande : un barème, une grille tarifaire, un extrait de contrat type.

> **Exemple — Mappemonde**
> Une compétence « qualification d'une demande d'espace » décrit les questions à poser (dates, nombre de personnes, équipements), les disponibilités à vérifier et la grille tarifaire à appliquer. Toute demande entrante est traitée de la même façon, quel que soit le collaborateur qui la reçoit.

Les mêmes compétences alimentent les [flux automatisés](https://doc.dokos.io/v5/integrations/ia/flux-automatises) : elles sont écrites une fois et servent partout. Vous pouvez également en publier une vers les [assistants externes](https://doc.dokos.io/v5/integrations/ia/assistants-externes), compétence par compétence, en cochant **Partager avec les assistants externes**.

## Voir aussi

- [Activer et paramétrer l'IA](https://doc.dokos.io/v5/integrations/ia/configuration)
- [Les flux automatisés](https://doc.dokos.io/v5/integrations/ia/flux-automatises)


# Les flux automatisés

Un **flux** applique la même séquence à chaque fois qu'une situation se présente : une opportunité est créée, une demande de matériel est enregistrée, une candidature arrive. L'IA rédige, compare, calcule — puis dépose le résultat dans la [boîte de réception](https://doc.dokos.io/v5/integrations/ia/assistant) où une personne approuve ou rejette. Le motif récurrent est toujours le même : **déclencheur → l'IA prépare → un humain valide → le document est écrit**.

::mermaid
flowchart LR
T\[Déclencheur\névénement / planification / appel] --> P\[Étapes\nrédaction, appels d'outils, conditions]
P --> A{Approbation}
A -->|approuvé| W\[Écriture dans Dokos]
A -->|rejeté| S\[Rejet consigné]
W --> L\[Suivi des exécutions]
S --> L

::

## Quatre façons de déclencher un flux

**Sur un événement de document** — à la création, à la modification, à la validation ou à l'annulation d'un type de document donné. Une condition permet de restreindre le déclenchement aux cas qui vous intéressent, par exemple les seules opportunités au-delà d'un certain montant.

**Sur une planification** — toutes les heures, chaque jour, chaque semaine ou chaque mois, pour les traitements de fond : synthèse hebdomadaire, contrôle de cohérence, relances.

**À la demande** — vous lancez le flux vous-même, ce qui est aussi le mode dans lequel vous le mettez au point avant de l'automatiser.

**Par appel externe** — un système tiers déclenche le flux par un appel entrant, signé par un secret partagé et restreint aux adresses que vous autorisez.

## Ce qu'un flux enchaîne

Les étapes se composent dans un éditeur visuel. Chacune fait une chose : demander à l'IA de rédiger ou d'analyser, appeler un outil Dokos, appeler un outil fourni par un [serveur MCP externe](https://doc.dokos.io/v5/integrations/ia/serveurs-mcp), tester une condition pour bifurquer, exécuter un script, ou **marquer un point d'approbation** où l'exécution s'arrête jusqu'à décision humaine.

::callout{color="teal" icon="i-mdi-lightbulb-on-outline"}
Une galerie de flux prêts à l'emploi vous évite de partir d'une page blanche : rédiger un **devis à partir d'une opportunité** en s'inspirant des devis passés, produire une **note de sourcing** à partir d'une demande de matériel et de l'historique d'achat, **trier et répondre** à une demande de support, ou **évaluer une candidature** au regard du poste. Chacun s'installe désactivé, pour que vous puissiez le relire et l'adapter avant de l'activer.
::

## Garder la main

Trois réglages déterminent ce qu'un flux a le droit de faire, et ils se règlent flux par flux.

**Au nom de qui il s'exécute.** Un flux porte l'identité d'un utilisateur désigné : ce sont ses permissions qui s'appliquent. Un flux qui traite des candidatures ne doit pas être porté par un utilisateur qui voit la comptabilité.

**S'il écrit sans surveillance.** Par défaut, un flux prépare et attend. L'écriture non surveillée doit être explicitement autorisée, et n'a de sens que pour un traitement dont vous avez vérifié le comportement sur plusieurs exécutions réelles.

**Combien il peut consommer.** Un plafond de jetons par exécution empêche une boucle ou un document anormalement volumineux de faire dériver la facture du fournisseur de modèles.

## Interprété ou compilé

Un flux s'exécute de deux manières. En mode **interprété**, le modèle décide à chaque exécution : c'est souple, adapté aux tâches qui demandent du jugement, et cela consomme des jetons à chaque passage.

En mode **compilé**, vous décrivez le traitement en français une fois ; Dokos en génère un script que vous relisez et validez, puis c'est ce script qui s'exécute. Le comportement devient identique d'une exécution à l'autre et ne coûte plus rien en jetons. Dokos garde trace de la version validée : si la description change après coup, le flux signale que le script relu n'est plus à jour.

::callout{color="blue" icon="i-mdi-information"}
Commencez en interprété, le temps d'ajuster les consignes sur des cas réels. Passez en compilé quand le traitement est stabilisé et que vous voulez de la constance plutôt que du jugement.
::

## Suivre les exécutions

Chaque exécution est conservée : son déclencheur, le document concerné, les étapes franchies, celle qui a échoué le cas échéant, et les jetons consommés. Vous ouvrez une exécution pour comprendre ce que l'IA a lu et produit à chaque étape — c'est là qu'on diagnostique un flux qui répond à côté, avant de reprendre ses consignes.

## Voir aussi

- [L'assistant](https://doc.dokos.io/v5/integrations/ia/assistant) — la boîte de réception où les approbations arrivent
- [Activer et paramétrer l'IA](https://doc.dokos.io/v5/integrations/ia/configuration) — le journal d'audit


# Connecter des outils externes à l'assistant

L'assistant sait tout faire sur votre site Dokos — et rien en dehors. Le **MCP** (Model Context Protocol) est la norme qui comble cet écart : un service tiers expose ses opérations sous forme d'outils, vous le déclarez dans Dokos, et l'assistant peut les employer au cours d'une conversation ou d'un [flux automatisé](https://doc.dokos.io/v5/integrations/ia/flux-automatises), en même temps que les outils Dokos.

> **Exemple — Dokompany**
> Un serveur MCP relié à la plateforme de transport expose une opération de suivi de colis. « Où en est la livraison de la commande SO-0142 ? » : l'assistant lit la commande dans Dokos, y trouve le numéro de suivi, interroge le transporteur, et répond en une seule fois — sans que personne n'ouvre deux applications.

## Déclarer un serveur

Un serveur se décrit par la façon de le joindre et par ce qu'on l'autorise à faire. Dokos joint un service distant en HTTPS, avec un jeton d'authentification et, si nécessaire, des en-têtes supplémentaires. Un délai d'attente maximal évite qu'un service lent ne bloque une conversation.

Une fois la connexion établie, Dokos **interroge le serveur pour lister ses outils**. Vous cochez ceux que vous autorisez : un serveur qui expose vingt opérations n'en donne que celles que vous avez retenues. Un outil ajouté plus tard par l'éditeur du service n'est pas utilisable tant que vous ne l'avez pas autorisé à votre tour.

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Les serveurs de type **commande locale** ne sont pas joints par le réseau : ils exécutent un programme sur votre serveur Dokos. Cette possibilité est fermée par défaut et fait l'objet d'une autorisation distincte dans les [paramètres de l'IA](https://doc.dokos.io/v5/integrations/ia/configuration). Ne l'ouvrez que pour des commandes dont vous maîtrisez le contenu.
::

## Restreindre l'usage

Deux garde-fous s'appliquent à chaque serveur, indépendamment des permissions Dokos habituelles.

**La confirmation obligatoire.** Les outils du serveur ne s'exécutent qu'après accord explicite de l'utilisateur. À réserver aux services qui agissent sur le monde réel — envoyer un message, déclencher une commande, débiter un compte.

**La restriction par rôle.** Seuls les porteurs d'un rôle donné peuvent employer ce serveur. Un connecteur vers l'outil de paie n'a pas à être accessible à l'ensemble des utilisateurs simplement parce qu'il est déclaré.

::callout{color="blue" icon="i-mdi-information"}
L'usage des serveurs MCP doit être activé globalement dans les paramètres de l'IA avant qu'un serveur déclaré ne devienne utilisable. Tant que cette activation n'est pas faite, aucun outil externe n'est proposé à l'assistant.
::

## L'inverse : exposer Dokos à un assistant externe

Le MCP fonctionne dans les deux sens. Ici, Dokos consomme les outils d'un service tiers ; il peut aussi **être** le service consommé, et fournir vos données à Claude ou à un autre assistant. Voir [Piloter Dokos depuis un assistant externe](https://doc.dokos.io/v5/integrations/ia/assistants-externes).

## Voir aussi

- [Activer et paramétrer l'IA](https://doc.dokos.io/v5/integrations/ia/configuration)
- [Les flux automatisés](https://doc.dokos.io/v5/integrations/ia/flux-automatises)


# Piloter Dokos depuis un assistant externe

L'[assistant intégré](https://doc.dokos.io/v5/integrations/ia/assistant) vit dans Dokos. À l'inverse, un assistant que vous utilisez déjà ailleurs — Claude Code dans un terminal, l'application Claude sur votre poste, agy, Vibe CLI, OpenCode — peut travailler **sur** votre site Dokos. Il lit vos documents, exécute vos rapports et prépare vos écritures, avec les mêmes permissions et les mêmes confirmations.

C'est **Dokos CLI** qui fait la jonction : le même outil sert de ligne de commande pour un administrateur et de passerelle MCP pour un assistant.

::mermaid
flowchart LR
A(Claude Code / Cowork\nagy / Vibe CLI / OpenCode) -->|outils MCP| C\[dokos mcp]
C -->|API REST| S\[(Votre site Dokos)]

::

::callout{color="blue" icon="i-mdi-information"}
Cette page décrit le branchement du point de vue de l'usage. L'installation de l'outil, la connexion à un site et la référence complète des commandes se trouvent dans la section [Dokos CLI](https://doc.dokos.io/v5/dokos-cli).
::

## Prérequis

Dokos CLI installé sur le poste, et connecté à votre site — voir [Installation](https://doc.dokos.io/v5/dokos-cli/installation) et [Configuration](https://doc.dokos.io/v5/dokos-cli/configuration) :

```bash
dokos configure     # enregistre l'URL du site et une clé d'API
dokos sites         # vérifie quel site est actif
```

Les droits de l'assistant sont ceux de l'utilisateur dont la clé d'API est enregistrée. Une clé issue d'un compte restreint donne un assistant restreint : c'est le premier levier de contrôle, avant tout réglage.

## Les assistants en terminal : une commande

```bash
dokos agent install --print     # prévisualiser sans rien écrire
dokos agent install             # installer dans tous les runtimes détectés
```

La commande enregistre la passerelle auprès de chaque assistant détecté, **auto-approuve les seuls outils de lecture**, et installe l'assistant Dokos dans une bibliothèque partagée par tous les runtimes. Les lectures s'exécutent alors sans interruption, les écritures continuent de demander confirmation en langage clair. L'opération est sans effet si elle est relancée.

## L'application Claude : un plugin

Claude Cowork et l'application Claude de bureau ne lisent pas la configuration des outils en terminal : elles s'équipent par **plugin**. Dans Claude, ouvrez **Customize → Plugins → Add marketplace**, saisissez `https://gitlab.com/dokos/dokos-cli`, puis installez le plugin `dokos`.

Le plugin demande le &#x2A;*chemin de l'exécutable `dokos`** : une application de bureau n'hérite pas des chemins de votre terminal, il faut donc le lui indiquer. Récupérez-le avec `which dokos` (macOS, Linux) ou `where dokos` (Windows).

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
La session Claude doit s'exécuter **en local**. Une session exécutée dans le cloud ne peut pas lancer un programme sur votre poste : les outils Dokos n'y apparaîtront simplement pas.
::

## Explorer sans risque : les sites en lecture seule

Un site peut être marqué en lecture seule. Toute écriture est alors refusée **avant même que la demande ne quitte le poste**, quel que soit l'assistant employé et quelles que soient ses permissions sur le site.

```bash
dokos sites --read-only production
dokos sites --writable production     # et inversement
```

C'est la manière recommandée de laisser un assistant explorer un site de production : analyser des données, préparer un rapport, comprendre un paramétrage, sans qu'aucune modification ne soit possible.

## Les compétences suivent le site

Les [compétences](https://doc.dokos.io/v5/integrations/ia/assistant) que vous écrivez dans Dokos ne servent pas qu'à l'assistant intégré. Dokos CLI récupère celles que le site publie et les installe localement, si bien que votre assistant externe applique **vos** procédures et pas seulement des connaissances génériques.

```bash
dokos skill pull    # récupérer les compétences du site actif
dokos skill list    # voir la bibliothèque locale et l'origine de chaque compétence
```

Une compétence n'est publiée que si vous l'avez explicitement autorisée — la case **Partager avec les assistants externes** dans l'éditeur de compétences. Le site refuse en outre de publier une compétence qui s'appuie sur un outil propre à l'application, sans équivalent hors de Dokos : mieux vaut ne pas l'envoyer que l'envoyer inutilisable.

La récupération est incrémentale et se rafraîchit automatiquement une fois par jour au démarrage d'une session. Une compétence que vous avez écrite localement n'est jamais écrasée par une compétence du site portant le même nom. Sur un site où l'application Dokos AI n'est pas installée, l'assistant fonctionne simplement avec les compétences fournies avec l'outil.

## Voir aussi

- [Dokos CLI — Intégration avec les agents](https://doc.dokos.io/v5/dokos-cli/integration-agents) — le détail technique : outils exposés, enregistrement manuel, conseils d'usage
- [L'assistant](https://doc.dokos.io/v5/integrations/ia/assistant) — l'assistant intégré à Dokos
- [Connecter des outils externes à l'assistant](https://doc.dokos.io/v5/integrations/ia/serveurs-mcp) — le branchement inverse


# Intégration Make

Make est une plateforme permettant à des personnes sans connaissances techniques de connecter différentes applications entre elles.

## Ajouter le module Make spécifique à Dokos

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Suivez ce lien pour ajouter le module d'intégration Dokos à vos scénarios Make : <https://www.make.com/en/hq/app-invitation/da0cc23461714dc01f33812bf6a5d808>{rel=""nofollow""}
::

## Ajouter le module Make spécifique à Dokos

Ouvrez Dokos et créez un nouveau compte utilisateur spécifique à Make ou réutilisez votre compte personnel. Ce compte est celui qui effectuera toutes les actions pour le compte de Make. Naviguez dans le document Utilisateur, rendez-vous dans l'onglet Paramètres puis la section Accès API. Cliquez sur le bouton "Générer des clés API" puis conservez les informations de secret et d'identifiant API pour l'étape suivante.

## Terminer la configuration sur Make

Ajoutez un module de l'application Dokos, puis créez une nouvelle connection avec les paramètres suivants :

- **Nom de domaine Dokos** : Entrez le nom de domaine de votre site Dokos (ex. `demo.dokos.cloud`)
- **Clé API de l'Utilisateur** : Collez l'identifiant généré à l'étape précédente
- **Secret API de l'Utilisateur** : Collez la clé secrète générée à l'étape précédente

### Déclencher un Scénario à partir de Dokos

Ajoutez le module Webhook dans Make, puis créez un document Webhook dans Dokos à partir des informations données dans Make.


# Application Zapier

Zapier est une plateforme permettant à des personnes sans connaissances techniques de connecter différentes applications entre elles.

::callout{color="amber" icon="i-heroicons-exclamation-triangle"}
Cette application est en version beta sur invitation en cliquant sur ce [lien](https://zapier.com/developer/public-invite/33806/ce6c67ecce01c7125330cee32bd60910/){rel=""nofollow""}.
Pour les utilisateurs d'ERPNext, cette application est également compatible avec la version 12.x.x.
::

## Installer l'application Zapier

### Récupérer l'URI de redirection

> Allez sur zapier.com et connectez-vous ou créez-vous un compte

1. Dans la section `My Apps` cliquez dans `Connect a new account` et cherchez `dokos`:br![zapier\_new\_connection.png](https://doc.dokos.io/content/integrations/zapier/zapier_new_connection.png)
2. Dans la fenêtre qui s'ouvre, copiez l'adresse de redirection (Redirect URI) affichée au dessus des champs Client ID et Client Secret.
   Il s'agit de la même adresse, donc vous pouvez n'en copier qu'une seule. :br![zapier\_auth.png](https://doc.dokos.io/content/integrations/zapier/zapier_auth.png)
3. Gardez cette fenête ouverte pour terminer la connexion après l'étape 1.2.

### Enregistrer une nouvelle connection sur dokos

> Ouvrez dokos et allez dans le module `Intégrations`

1. Créez un nouveau document `Client OAuth`, donnez un nom à l'application cliente (Ex. Zapier) et collez l'URI de redirection copiée plus haut dans les champs `URIs de redirection` et `URI de redirection par défaut`.

![dokos\_oauth.png](https://doc.dokos.io/content/integrations/zapier/dokos_oauth.png)

1. Enregistrez et dokos va générer automatiquement les deux informations manquantes pour terminer notre connexion à Zapier: L'ID client et le secret client. :br
   Copiez ces deux clés.

![dokos\_client\_keys.png](https://doc.dokos.io/content/integrations/zapier/dokos_client_keys.png)

### Configurer les connexions sociales

> Pour permettre les intégrations de type OAuth2, il faut avoir au moins une clé de connexion sociale Dodock.

1. Allez dans `Intégrations > Clé de connexion sociale`
2. Créez une nouvelle clé de connexion de sociale
3. Dans le champ **Fournisseur de connexion sociale** sélectionnez `Dodock`
4. Dans le champ **URL de base** entrez l'URL de base de votre site sans les éventuels sous-domaines.
   Ex: Si votre URL est `https://demo.dokos.io`, entrez `https://dokos.io`

![frappe\_social\_login.png](https://doc.dokos.io/content/integrations/zapier/frappe_social_login.png)

1. Enregistrez

### Terminer l'authentification de Zapier

> Retournez sur Zapier et ouvrez à nouveau la fenêtre de la section 1.1.

- **Base URL**: Entrez l'URL de base de votre site dokos. Ex. `https://demo.dokos.io`
- **Client ID**: Collez la clé générée à l'étape 1.2. correspondante
- **Client Secret**: Collez la clé générée à l'étape 1.2. correspondante

1. Cliquez sur `Yes, Continue`
2. Vous allez être redirigé sur votre site dokos pour valider l'authentification. Cliquez sur `Autoriser`

🎉 Votre application Zapier est désormais connectée à votre site dokos. :br
Vous pouvez créer votre premier Zap.

### Créer un Zap

L'application Zapier **dokos** permet de créer deux types d'interactions:

- La génération d'un Zap en fonction d'un événement affectant un document
- La recherche ou la création d'un document

### Génération d'un Zap

Pour générer un nouveau Zap, séléctionnez l'application **dokos** dans l'éditeur de Zap.

1. Dans le champ **Choose Trigger Event** sélectionnez **Document events**.
2. Sélectionnez le compte à utiliser. Il s'agit probablement du compte créé à l'étape 1.
3. Dans la section **Customize Document**, sélectionnez:


   - Le **DocType** (Type de document) utilisé pour déclencher un Zap
   - L'événement (**Trigger Event**) qui déclenchera ce Zap.
     Cet évément peut être l'un des suivants:


     - **After insert**: Après la création d'un document
     - **On change**: Après la modification du document (peut être déclenché en même temps que `On update` ou `On submit`)
     - **On update**: Après l'enregistrement du document
     - **On submit**: Après la validation du document
     - **On update after submit**: Après enregistrement d'un document déjà soumis. Possible seulement si certains champs sont éditables après validation.
     - **On cancel**: Après l'annulation du document
     - **On trash**: Après suppression du document
   - Les champs à envoyer à Zapier (**Webhook Data**)
     Cliquez sur le bouton + pour ajouter un champ supplémentaire

::callout{color="teal" icon="i-heroicons-light-bulb"}
L'intégration avec Zapier crée des nouveaux Webhooks dans dokos. :br
Vous pouvez les retrouver en allant dans `Intégrations > Webhooks`.
::

Vous pouvez ensuite enregistrer et créer votre action avec une autre application Zapier ou avec l'application dokos si vous le souhaitez.

### Déclenchement d'une action sur dokos

Il existe deux types d'actions disponibles sur dokos: **Créer un document** (Create Document) ou **Rechercher un document** (Find Document)

#### Création de document

Un fois que vous avez sélectionné le type de document à créer, choisissez des valeurs pour les champs obligatoires et testez votre Zap.
Un nouveau document devrait être créé sur votre site dokos.

#### Recherche de document

Si vous sélectionnez la recherche de documents, vous pouvez définir 3 paramètres:
1\. Le nombre de document maximum à récupérer
2\. Le nom des champs à récupérer
3\. Un filtre pour trouver votre/vos documents
Si vous cherchez un document en particulier, pensez à filtrer par identifiant (Nom dans dokos).

En cochant la case `Create dokos Document if it doesn't exist yet?` vous autorisez Zapier à créer un nouveau document s'il ne trouve pas de document correspondant à vos filtres.

Une fois votre document trouvé ou créé, vous pouvez passer à l'étape suivante et le réutiliser dans un autre Zap.

### Formats des données

#### Dates

Lorsque vous envoyez un champ de type **Date** ou **Date/Heure**(Datetime), vous devez utiliser les formats suivants:

- **Date**: `YYYY-MM-DD`
  Ex: 2019-11-30
- **Date/Heure**: `YYYY-MM-DD HH:mm:ss`
  Ex: 2019-11-30 08:30:00

Vous pouvez utiliser les outils [Zapier Formatter](https://zapier.com/help/create/format/modify-date-formats-in-zaps){rel="&#x22;nofollow&#x22;"} pour cela si besoin.
Pour le format **Date/Heure**, vous pouvez sélectionner l'option "Use a Custom Value":

![zapier\_datetime.png](https://doc.dokos.io/content/integrations/zapier/zapier_datetime.png)

#### Listes

L'application n'autorise pas encore l'envoi de listes dans les objects composant les documents.
Veuillez envoyer un mail à <help@dokos.io> si cette limitation vous pose des problèmes d'intégrations.