> For the complete documentation index, see [llms.txt](https://docs-fr.docbits.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs-fr.docbits.com/administration-and-setup/settings/document-processing/classification-and-extraction.md).

# Classification et extraction

## Vue d'ensemble

Dans les paramètres **Classification et extraction**, vous pouvez :

* Activer la **division des documents** sur la base des codes QR
* Configurer le **formatage des montants**
* Configurer l'**extraction de tableaux**
* Activer ou désactiver le traitement des fichiers **ZUGFeRD** non pris en charge
* Définir des règles de classification spécifiques
* Suivre les **modèles d'IA** entraînés sur mesure utilisés dans le processus de classification

Cette page décrit en détail tous les paramètres disponibles.

## **Accéder aux paramètres de classification et d'extraction**

Pour accéder aux paramètres **Classification et extraction**, allez dans :\
**Paramètres → Traitement des documents → Classification et extraction**

<figure><img src="https://920984434-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGZNnVmsHh1akmBu1Fqum%2Fuploads%2Fgit-blob-fce45aeca53c80074edc2291a0f13e6cd709a80e%2Fauto_extract_tax_code_1.png?alt=media" alt=""><figcaption></figcaption></figure>

## Division des documents

Dans la section **Division des documents**, vous pouvez configurer si un document téléversé doit être divisé en plusieurs documents dès qu'un **code-barres** apparaît sur l'une de ses pages.

Pour activer cette fonctionnalité :

1. Allez dans la section **Division des documents**.
2. Ouvrez le menu déroulant.

   <figure><img src="https://920984434-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGZNnVmsHh1akmBu1Fqum%2Fuploads%2Fgit-blob-fce45aeca53c80074edc2291a0f13e6cd709a80e%2Fauto_extract_tax_code_1.png?alt=media" alt=""><figcaption></figcaption></figure>
3. Sélectionnez **Diviser par code-barres/code QR**.

   <figure><img src="https://920984434-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGZNnVmsHh1akmBu1Fqum%2Fuploads%2Fgit-blob-fce45aeca53c80074edc2291a0f13e6cd709a80e%2Fauto_extract_tax_code_1.png?alt=media" alt=""><figcaption></figcaption></figure>

Vous aurez ensuite la possibilité de :

* Sélectionner un ou plusieurs types de codes-barres à détecter.
* Indiquer un motif regex auquel le code-barres doit correspondre pour déclencher la division du document.

  <figure><img src="https://920984434-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGZNnVmsHh1akmBu1Fqum%2Fuploads%2Fgit-blob-fce45aeca53c80074edc2291a0f13e6cd709a80e%2Fauto_extract_tax_code_1.png?alt=media" alt=""><figcaption></figcaption></figure>

## Formatage des montants

Dans la section **Formatage des montants**, vous disposez de deux options :

* **Autoriser l'arrondi lors de la comparaison des montants :**\
  Si cette option est activée, une tolérance de ±0,5 est admise lors de la comparaison des montants.\
  Si elle est désactivée, une tolérance par défaut de ±0,05 s'applique.
* **Exiger une correspondance exacte pour la comparaison des montants :**\
  Si cette option est activée, les montants doivent correspondre exactement, sans aucune tolérance.\
  Si elle est désactivée, une tolérance de ±0,05 est admise.

<mark style="color:red;">**Remarque**</mark> : une seule de ces deux options peut être active à la fois.

## Extraction de tableaux

{% hint style="info" %}
**Prérequis pour une extraction de tableaux fonctionnelle**

* Le type de document dispose de **colonnes de tableau** (Paramètres → Paramètres globaux → Types de documents → [Colonnes de tableau](/administration-and-setup/settings/global-settings/document-types/table-columns.md)). Sans colonnes, il n'y a rien dans quoi extraire.
* **Extraction de tableaux** ou **Extraction de tableaux par IA** est activée ci-dessous, pour toute l'organisation.
* Le document contient du texte lisible : l'OCR a été exécuté, ou l'E-Text est utilisé pour les PDF nativement numériques ([Paramètres de l'OCR](/administration-and-setup/settings/document-processing/ocr-settings.md)).
* L'entraînement et les modèles d'IA sont définis **par fournisseur**. Un tableau entraîné ne s'applique qu'aux documents du fournisseur sur lequel il a été entraîné.
  {% endhint %}

Vous pouvez extraire les tableaux des documents en activant soit **Extraction de tableaux**, soit **Extraction de tableaux par IA**. Un tableau entraîné (qu'il soit basé sur l'IA ou manuel) est toujours lié à un fournisseur précis.

**Extraction de tableaux :** active l'extraction de tableaux basée sur des règles. Les tableaux sont entraînés par fournisseur sur l'écran de validation (*Aller à la vue d'extraction de tableau*).\
En savoir plus sur l'entraînement [ici](/administration-and-setup/setup/document-training/training-line-fields-table-training/defining-tables-and-columns.md).

**Extraction de tableaux par IA :** utilise l'IA pour extraire le tableau de n'importe quel fournisseur sans entraînement. Si les résultats pour un fournisseur ne sont pas assez précis, entraînez le tableau de ce fournisseur ; les règles enregistrées prennent alors le pas sur l'IA pour ce fournisseur.

**Utiliser l'extraction de tableaux Vision (IA) :** l'IA lit l'image de la page au lieu de la couche de texte. Utile pour les documents numérisés et les tableaux sans structure de texte claire ; plus lent.

**Utiliser l'extraction structurée (IA) :** l'IA renvoie le tableau dans une structure fixe qui correspond directement aux colonnes de tableau configurées. Recommandé lorsque les en-têtes de colonnes varient beaucoup d'un document à l'autre.

**Extraction de tableaux pour le calcul des coûts :** lorsque cette option est activée, DocBits peut extraire les éléments de coût des tableaux au niveau des lignes et les classer en conséquence.\
Explication détaillée [ici](/administration-and-setup/settings/document-processing/classification-and-extraction/table-extraction-for-costing-element.md).

**Extraction automatique du code fiscal :** lorsque cette option est activée, le système remplit automatiquement le champ **Code fiscal** sur l'écran de validation, à condition qu'un champ de code fiscal soit configuré.\
Plus d'informations sur ce paramètre [ici](/administration-and-setup/settings/document-processing/classification-and-extraction/auto-extract-tax-code.md).

**Enregistrer les règles d'extraction (administrateurs uniquement) :** seuls les administrateurs peuvent cliquer sur *Enregistrer les règles* dans l'entraînement de tableau. Activez cette option lorsque des utilisateurs enregistrent régulièrement des règles qui cassent l'extraction d'un fournisseur.

**Modèle d'IA :** sélectionne le niveau d'IA utilisé pour l'extraction de tableaux : **Fast** (par défaut), **Full** (précision maximale, plus lent) ou **Nexus** (troisième niveau, sur activation). Le tableau sous le sélecteur indique :

* Quels **fournisseurs** utilisent quel modèle d'IA
* S'ils utilisent l'E-Text
* Des options pour supprimer une entrée ou réinitialiser les données d'entraînement

Ce paramètre est expliqué en détail [ici](/administration-and-setup/settings/document-processing/classification-and-extraction/ai-model.md).

### Pourquoi le tableau est-il différent d'un fournisseur à l'autre ?

Tout ce que DocBits apprend sur un tableau est stocké **par fournisseur** :

* **Règles enregistrées** (entraînement de tableau) : position du tableau et mappage de ses colonnes sur la mise en page de ce fournisseur.
* **Étiquettes de tableau AI et règles de formatage** : indications que l'utilisateur a enregistrées pour le tableau AI de ce fournisseur.
* **Modèle d'IA spécifique au fournisseur** : le niveau choisi pour ce fournisseur sous *Plus de paramètres* sur l'écran de validation.

Ainsi, le fournisseur A, qui dispose de règles enregistrées, affiche un tableau déterministe dans l'onglet *Tableau extrait* de l'écran de validation, tandis que le fournisseur B, sans règles, obtient le *Tableau extrait par IA*. Pour que le fournisseur B se comporte comme A, entraînez une fois le tableau de B. Pour réinitialiser un fournisseur, supprimez ses règles sur l'écran de validation ou réinitialisez ses données d'entraînement dans le tableau Modèle d'IA.

### Clés de préférence

Chaque option de cette section est stockée sous forme de préférence d'organisation. Utilisez la clé lorsque vous définissez la valeur via l'API (`/preferences/set_preference`), un script ou le DocBits MCP (`get_preference` / `set_preference`).

| Paramètre (libellé dans l'interface)                                           | Clé de préférence             | Valeurs                                                        |
| ------------------------------------------------------------------------------ | ----------------------------- | -------------------------------------------------------------- |
| Extraction de tableaux                                                         | `TABLE_EXTRACTION_SETTING`    | `true` / `false`                                               |
| Extraction de tableaux par IA                                                  | `USE_AI_TABLE_EXTRACTION`     | `true` / `false`                                               |
| Utiliser l'extraction de tableaux Vision (IA)                                  | `TABLE_EXTRACTION_USE_VISION` | `true` / `false`                                               |
| Utiliser l'extraction structurée (IA)                                          | `USE_STRUCTURED_EXTRACTION`   | `true` / `false`                                               |
| Extraction de tableaux pour le calcul des coûts                                | `CHARGES_TABLE_EXTRACTION`    | `true` / `false`                                               |
| Extraction automatique du code fiscal                                          | `AUTO_EXTRACT_TAX_CODE`       | `true` / `false`                                               |
| Enregistrer les règles d'extraction (administrateurs uniquement)               | `ONLY_ADMIN_CAN_SAVE_RULES`   | `true` / `false`                                               |
| Modèle d'IA                                                                    | `AI_MODEL`                    | `gpt-5.4-mini` (Fast), `gpt-5.5` (Full), `qwen3.8-max` (Nexus) |
| Version de l'extraction de tableaux (boîte de dialogue de confirmation)        | `TBL_EXT_VERSION`             | chaîne de version                                              |
| Paramètres de l'OCR → Utiliser les données IA pour les tableaux si disponibles | `USE_AI_DATA_FOR_TABLE`       | `true` / `false`                                               |
| Paramètres de l'OCR → Utiliser l'E-Text si disponible                          | `USE_ETEXT_IF_AVAILABLE`      | `true` / `false`                                               |

Remarques :

* Les préférences booléennes sont stockées sous forme de chaînes `true` / `false` ; une clé jamais définie compte comme `false`. Si vous envoyez `1` ou `0`, DocBits stocke `true` / `false`.
* `AI_MODEL` non défini équivaut à **Fast**.
* La modification d'une clé prend effet pour les documents traités ensuite. Redémarrez un document pour le réextraire avec le nouveau paramètre.
* Les choix par fournisseur (E-Text, modèle d'IA, règles enregistrées) ne sont pas des préférences d'organisation ; ils se définissent sur l'écran de validation, sous *Plus de paramètres*, pour un document de ce fournisseur.

## Document électronique

**Traiter les PDF ZUGFeRD non pris en charge :** si cette option est activée, les versions **ZUGFeRD** non prises en charge sont traitées comme des PDF standard et le XML intégré est ignoré.

La liste des versions **ZUGFeRD** prises en charge est disponible [ici](/administration-and-setup/settings/global-settings/document-types/edi/zugferd.md).

## **Règles de classification**

Dans la section **Règles de classification**, vous pouvez définir des motifs **regex** et des critères spécifiques pour aider le système à classer automatiquement les documents lors du traitement.

Pour accéder à cette section, cliquez sur l'onglet **Règles de classification** en haut de la page.

<figure><img src="https://920984434-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGZNnVmsHh1akmBu1Fqum%2Fuploads%2Fgit-blob-fce45aeca53c80074edc2291a0f13e6cd709a80e%2Fauto_extract_tax_code_1.png?alt=media" alt=""><figcaption></figcaption></figure>

### **Ajouter une nouvelle règle de classification**

Pour créer une nouvelle règle :

1. Cliquez sur **Ajouter** dans le coin supérieur droit.

   <figure><img src="https://920984434-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGZNnVmsHh1akmBu1Fqum%2Fuploads%2Fgit-blob-fce45aeca53c80074edc2291a0f13e6cd709a80e%2Fauto_extract_tax_code_1.png?alt=media" alt=""><figcaption></figcaption></figure>
2. Renseignez les champs suivants :
   * **Motif** : le motif regex que le système doit rechercher pour déclencher la classification.
   * **Type** : l'endroit où le motif doit être recherché (par exemple **Code-barres**).
   * **Sous-organisation** *(facultatif)* : indique à quelle sous-organisation la règle s'applique.
   * **Type de document** : le type de document à attribuer lorsque le motif correspond.
   * **Sous-type de document** *(facultatif)* : indique un sous-type pour une classification plus fine.

     <figure><img src="https://920984434-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGZNnVmsHh1akmBu1Fqum%2Fuploads%2Fgit-blob-fce45aeca53c80074edc2291a0f13e6cd709a80e%2Fauto_extract_tax_code_1.png?alt=media" alt=""><figcaption></figcaption></figure>
3. Cliquez sur **Enregistrer** pour enregistrer votre règle de classification.

   <figure><img src="https://920984434-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGZNnVmsHh1akmBu1Fqum%2Fuploads%2Fgit-blob-fce45aeca53c80074edc2291a0f13e6cd709a80e%2Fauto_extract_tax_code_1.png?alt=media" alt=""><figcaption></figcaption></figure>

### **Modifier une règle de classification**

Pour modifier une règle existante :

1. Cliquez sur les trois points dans la colonne **Actions**.

   <figure><img src="https://920984434-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGZNnVmsHh1akmBu1Fqum%2Fuploads%2Fgit-blob-fce45aeca53c80074edc2291a0f13e6cd709a80e%2Fauto_extract_tax_code_1.png?alt=media" alt=""><figcaption></figcaption></figure>
2. Sélectionnez **Modifier**.

   <figure><img src="https://920984434-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGZNnVmsHh1akmBu1Fqum%2Fuploads%2Fgit-blob-fce45aeca53c80074edc2291a0f13e6cd709a80e%2Fauto_extract_tax_code_1.png?alt=media" alt=""><figcaption></figcaption></figure>
3. Apportez les modifications souhaitées.
4. Cliquez sur **Enregistrer** pour appliquer les mises à jour.

   <figure><img src="https://920984434-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGZNnVmsHh1akmBu1Fqum%2Fuploads%2Fgit-blob-fce45aeca53c80074edc2291a0f13e6cd709a80e%2Fauto_extract_tax_code_1.png?alt=media" alt=""><figcaption></figcaption></figure>

### **Supprimer une règle de classification**

Pour supprimer une règle :

1. Cliquez sur les trois points dans la colonne **Actions**.

   <figure><img src="https://920984434-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGZNnVmsHh1akmBu1Fqum%2Fuploads%2Fgit-blob-fce45aeca53c80074edc2291a0f13e6cd709a80e%2Fauto_extract_tax_code_1.png?alt=media" alt=""><figcaption></figcaption></figure>
2. Sélectionnez **Supprimer**.

   <figure><img src="https://920984434-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGZNnVmsHh1akmBu1Fqum%2Fuploads%2Fgit-blob-fce45aeca53c80074edc2291a0f13e6cd709a80e%2Fauto_extract_tax_code_1.png?alt=media" alt=""><figcaption></figcaption></figure>

## Modèles d'IA

La section **Modèles d'IA** affiche tous les modèles entraînés sur mesure qui ont été spécifiquement ajustés à vos besoins.

### Accéder à la section Modèles d'IA

Pour ouvrir cette section, cliquez sur l'onglet **Modèles d'IA** situé en haut de la page.

<figure><img src="https://920984434-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGZNnVmsHh1akmBu1Fqum%2Fuploads%2Fgit-blob-fce45aeca53c80074edc2291a0f13e6cd709a80e%2Fauto_extract_tax_code_1.png?alt=media" alt=""><figcaption></figcaption></figure>

### Catégories de modèles

Les modèles sont organisés par catégories. Sous le nom de chaque catégorie figure le nombre de modèles qu'elle contient.\
Cliquez sur une catégorie pour afficher ses détails.

<figure><img src="https://920984434-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGZNnVmsHh1akmBu1Fqum%2Fuploads%2Fgit-blob-fce45aeca53c80074edc2291a0f13e6cd709a80e%2Fauto_extract_tax_code_1.png?alt=media" alt=""><figcaption></figcaption></figure>

En haut de la page de la catégorie sélectionnée, vous verrez les informations clés de chaque modèle :

* **Type** : le type de modèle.
* **Première page uniquement** : indique si le modèle ne traite que la première page d'un document.
* **Version** : le numéro de version du modèle.

### Tableau des modèles

Tous les modèles d'une catégorie sont répertoriés dans un tableau qui contient les informations suivantes :

* **Nom** : le nom du modèle.
* **Modèle suivant** : le modèle qui traitera ensuite la sortie du modèle actuel.
* **Type de document** : le type de document principal attribué par le modèle lors de la classification.
* **Sous-types de document** : les sous-types dans lesquels le document est ensuite classé.
* **Priorité** : le niveau de priorité qui détermine la position du modèle dans la file de classification.

<figure><img src="https://920984434-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGZNnVmsHh1akmBu1Fqum%2Fuploads%2Fgit-blob-fce45aeca53c80074edc2291a0f13e6cd709a80e%2Fauto_extract_tax_code_1.png?alt=media" alt=""><figcaption></figcaption></figure>

### Modifier un modèle

Pour modifier un modèle :

1. Cliquez sur l'icône de crayon dans la colonne **Actions** à côté du modèle à modifier.

   <figure><img src="https://920984434-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGZNnVmsHh1akmBu1Fqum%2Fuploads%2Fgit-blob-fce45aeca53c80074edc2291a0f13e6cd709a80e%2Fauto_extract_tax_code_1.png?alt=media" alt=""><figcaption></figcaption></figure>
2. Mettez à jour les champs disponibles :
   * **Modèle suivant** : sélectionnez le modèle qui doit traiter la sortie du modèle actuel.
   * **Type de document** : choisissez le type de document dans lequel le modèle doit classer l'entrée.
3. Cliquez sur **Enregistrer** pour appliquer vos modifications.

   <figure><img src="https://920984434-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGZNnVmsHh1akmBu1Fqum%2Fuploads%2Fgit-blob-fce45aeca53c80074edc2291a0f13e6cd709a80e%2Fauto_extract_tax_code_1.png?alt=media" alt=""><figcaption></figcaption></figure>
