---
title: "Créer un modèle d'extraction"
weight: 40
description: "Préparer le modèle d'extraction d'un fournisseur pour que ScanPdf lise ses factures seul, puis le transférer sur le Dolibarr d'un client."
---

# Créer un modèle d'extraction

Un modèle d'extraction apprend à ScanPdf à reconnaître un fournisseur et à lire ses factures : numéro, dates, montants et lignes. Une fois le modèle prêt, l'utilisateur dépose le PDF et retrouve la facture remplie, lignes comprises ; il n'a plus qu'à vérifier et valider.

Cette page s'adresse à la personne qui prépare les modèles : l'administrateur du Dolibarr, ou le revendeur qui configure ScanPdf pour son client. Elle décrit tout le parcours, du premier import d'un fournisseur jusqu'à l'installation de ses modèles sur une autre instance.

## Avant de commencer

Réunissez :

- **3 à 5 vraies factures du fournisseur**, de mois différents. Ajoutez une facture sur plusieurs pages si ce fournisseur en émet ;
- **la fiche du fournisseur dans Dolibarr**, avec son numéro de TVA intracommunautaire ;
- **les droits ScanPdf** de lecture et de création. Le droit **Expert** donne accès en plus au diagnostic des champs appris (voir [Ajuster un champ appris](#modeles-section-expert)).

Un fournisseur a **un seul modèle par type de document** : un pour ses factures (ses avoirs utilisent le même), un pour ses commandes, et ainsi de suite. Si le fournisseur présente ses factures de plusieurs façons, toutes ces présentations tiennent dans ce même modèle.

> [!TIP]
> Préparez de préférence le modèle directement sur le Dolibarr où il servira. Vous pouvez aussi le préparer sur votre propre instance, puis le transférer : voir [Transférer les modèles sur une autre instance](#modeles-transfert).

## Premier import du fournisseur

Ouvrez ScanDocuments, choisissez **Facture fournisseur** et déposez la première facture. Le fournisseur n'a pas encore de modèle : ScanPdf l'indique par le message **Aucun champ extrait automatiquement**. Cliquez sur **Continuer l'import manuellement**.

![Message Aucun champ extrait automatiquement affiché au premier import d'une facture d'Énergies du Gard, avec les boutons Commander un masque sur-mesure et Continuer l'import manuellement](screenshots/modele-premier-import.webp)

L'éditeur s'ouvre : le PDF à gauche, le formulaire à droite. Si le fournisseur n'apparaît pas en haut du panneau de droite, choisissez-le dans la liste. S'il n'existe pas encore dans Dolibarr, créez-le avec le bouton **+**.

## Remplir les champs en sélectionnant le PDF

Pour chaque champ de l'en-tête (numéro, date de facture, date d'échéance, montant HT, montant TTC) :

1. Cliquez sur le champ, dans le panneau de droite. Il s'entoure de couleur.
2. Sélectionnez la valeur sur le PDF, à la souris, comme on sélectionne un texte.

La valeur s'inscrit dans le champ, se surligne sur le PDF de la même couleur, et ScanPdf passe au champ vide suivant. Il retient surtout **l'endroit où se trouve la valeur** : le texte qui l'entoure sur la facture. C'est ce qui lui permet de la retrouver sur les factures suivantes.

![Champ N° Facture rempli par sélection sur le PDF : la valeur EG-2026-09-5521 surlignée sur la facture et inscrite dans le champ, avec la date et les montants déjà remplis de la même façon](screenshots/modele-selection-champ.webp)

> [!IMPORTANT]
> Un champ tapé au clavier est bien enregistré dans la facture, mais ScanPdf n'en apprend rien. Sélectionnez toujours la valeur sur le PDF quand elle y figure.

Remplissez toujours le **montant HT** et le **montant TTC** : ScanPdf s'en sert pour vérifier les lignes (voir [Lignes de la facture](#modeles-lignes)).

## Mots-clés de détection

Les mots-clés permettent à ScanPdf de reconnaître le fournisseur dès le dépôt du PDF. Ouvrez la section **Mots-clés de détection**, sous les champs de l'en-tête :

1. Cliquez sur **Régénérer depuis le PDF** : ScanPdf propose jusqu'à 5 mots-clés tirés de la facture, en commençant par le numéro de TVA, le site web et le nom du fournisseur.
2. Faites le tri : retirez un mot-clé avec sa croix, ajoutez-en un en le tapant puis en appuyant sur Entrée, ou en le sélectionnant sur le PDF après avoir activé le mode capture (bouton en forme de viseur).
3. Cliquez sur **Enregistrer**.

![Section Mots-clés de détection ouverte : les mots-clés de la facture d'Énergies du Gard (numéro de TVA, site web, nom, adresse) et le message Mots-clés enregistrés](screenshots/modele-mots-cles.webp)

Pour choisir de bons mots-clés :

- **tous les mots-clés doivent figurer sur chaque facture** du fournisseur : il suffit qu'un seul manque pour que le fournisseur ne soit pas reconnu ;
- gardez ce qui est propre au fournisseur et stable d'une facture à l'autre : le numéro de TVA tel qu'il est imprimé, le site web, la raison sociale exacte, une mention du pied de page ;
- écartez les mots que toutes les factures portent ("Facture", "TVA", "Total", "EUR"), les dates, les montants et les numéros de facture ;
- il en faut au moins 5 pour enregistrer.

Le message **Conflit** signale que ces mots-clés désignent déjà un autre fournisseur : ajoutez des mots-clés plus spécifiques.

<a id="modeles-lignes"></a>
## Lignes de la facture

Pour que ScanPdf crée une ligne Dolibarr par ligne du PDF, montrez-lui une fois où se trouve le tableau. Ouvrez l'onglet **Lignes**, puis cliquez sur **Extraction multi-lignes** :

1. **Dessinez un rectangle** autour du tableau, sur le PDF. Incluez la ligne d'en-tête du tableau (Désignation, Qté...) : elle sert à reconnaître le même tableau sur les pages suivantes. Arrêtez le rectangle au-dessus du total général et des mentions légales. Laissez un peu de marge en bas pour les factures plus longues que celle-ci.
2. **Placez les séparateurs de colonnes** : un clic dans le rectangle ajoute un séparateur, on le déplace en le faisant glisser, un double-clic le supprime. Placez chaque séparateur dans l'espace entre deux colonnes.
3. **Vérifiez le rôle de chaque colonne** dans **Configuration des colonnes** : Désignation, Quantité, P.U. HT, Taux TVA, Total HT... ScanPdf le devine d'après l'en-tête du tableau ; corrigez-le au besoin, et choisissez **Ignorer** pour une colonne inutile. Prenez toujours la colonne du taux de TVA quand la facture en a une.

![Zone dessinée autour du tableau de la facture d'Énergies du Gard, en-tête compris, avec trois séparateurs de colonnes, et à droite la configuration des colonnes avec le rôle de chacune](screenshots/modele-zone-colonnes.webp)

4. Cliquez sur **Extraire les données** et comparez les lignes obtenues avec le PDF : leurs totaux HT, TVA et TTC doivent retomber sur ceux de la facture.
5. Cliquez sur **Enregistrer le modèle**, au-dessus du PDF.

![Onglet Lignes après l'extraction : les deux lignes Abonnement septembre 2026 et Consommation 1 150 kWh, et les totaux 212,40 HT et 254,88 TTC identiques à ceux de la facture, avec le bouton Enregistrer le modèle au-dessus du PDF](screenshots/modele-zone-lignes.webp)

Pour un document de plusieurs pages, vous n'avez rien à régler : la zone se prolonge jusqu'en haut des pages suivantes, et ScanPdf écarte seul les pages sans tableau (conditions générales, page blanche).

## Valider la facture

Cliquez sur **Créer dans Dolibarr**. La facture est créée, et ScanPdf enregistre ce que vous avez sélectionné sur le PDF.

## Les factures suivantes

Importez maintenant les autres factures du fournisseur, une par une. ScanPdf reconnaît le fournisseur, remplit l'en-tête et extrait les lignes seul. Vérifiez chaque champ, corrigez si besoin en sélectionnant la bonne valeur sur le PDF, puis validez : chaque correction affine le modèle.

![Nouvel import de la facture d'Énergies du Gard : le fournisseur reconnu, le numéro, la date et les montants remplis sans intervention, et l'alerte de doublon puisque cette facture a déjà été créée](screenshots/modele-deuxieme-import.webp)

Les lignes ne sont reprises que si leur somme redonne les totaux HT et TTC de la facture. Sinon, la facture est créée en une seule ligne et l'éditeur l'indique : c'est souvent le signe d'une autre présentation de facture.

### Fournisseur à plusieurs présentations

Quand un fournisseur change la présentation de ses factures, ou en a plusieurs, ne créez pas de second modèle : sur une facture de l'autre présentation, cliquez sur **Extraction multi-lignes** et dessinez la zone de ce tableau-là. Elle s'ajoute au modèle sans remplacer la première. Un modèle garde jusqu'à cinq zones, et ScanPdf retient à chaque import celle dont les lignes redonnent les totaux.

Pour l'en-tête, sélectionnez les valeurs sur une facture de chaque présentation, et choisissez des mots-clés communs à toutes les présentations.

### De l'apprentissage à l'automatique

Le modèle d'un fournisseur passe par trois modes :

- **Apprentissage** : premiers imports, vous vérifiez et complétez chaque champ ;
- **Semi-automatique** : dès qu'une facture est validée sans correction et que le modèle a ses mots-clés, les champs arrivent remplis et vous les vérifiez ;
- **Automatique** : après 5 imports d'affilée sans correction, le badge **Automatique** s'affiche dans l'éditeur. Ce nombre se règle dans la configuration du module, section **Apprentissage des modèles d'extraction** (voir [la configuration](/scanpdf/configuration)).

Une correction en mode automatique ramène le modèle en semi-automatique, le temps qu'il se confirme de nouveau.

<a id="modeles-transfert"></a>
## Transférer les modèles sur une autre instance

Un modèle préparé sur votre Dolibarr s'installe sur celui de votre client par un fichier d'export. Ce fichier contient tout le modèle : les mots-clés, les zones de lignes, et les champs appris par sélection sur le PDF.

### Exporter

1. Ouvrez **Facturation > Factures fournisseur > Imports > Modèles d'extraction**, ou **GED > ScanPdf > Modèles d'extraction**.
2. Cochez les modèles à transférer.
3. Choisissez l'action **Exporter les modèles (JSON)** et confirmez : le navigateur télécharge le fichier.

![Liste des modèles d'extraction ouverte depuis le menu Factures fournisseur, Imports, Modèles d'extraction : chaque modèle coché sous le nom de son fournisseur, et la liste des actions où figure Exporter les modèles (JSON)](screenshots/modeles-liste-export.webp)

> [!WARNING]
> Pour que ScanPdf retrouve les valeurs sur les factures suivantes, les champs appris gardent de courts extraits des factures déjà importées : numéros, montants, texte autour. Le fichier d'export en contient donc. Remettez-le uniquement au client dont viennent ces factures, ne le diffusez pas ailleurs.

### Importer chez le client

Le fournisseur doit exister dans le Dolibarr du client, avec son numéro de TVA : ScanPdf rattache chaque modèle au bon tiers d'après son numéro de TVA, son nom et ses mots-clés.

1. Sur le Dolibarr du client, ouvrez **Modèles d'extraction**, puis cliquez sur **Importer des modèles**.
2. Choisissez le fichier exporté, puis cliquez sur **Analyser**.
3. Contrôlez l'analyse :
   - **Import automatique (matchs certains)** : le tiers est trouvé sans doute possible, le modèle est coché d'office ;
   - **À vérifier** : choisissez le tiers dans la colonne **Choisir l'émetteur local** et cochez la ligne. Le statut indique pourquoi : plusieurs tiers possibles, couverture partielle des mots-clés, aucun tiers trouvé. Pour un **Modèle déjà présent**, choisissez **Ignorer** pour garder celui du client, ou **Écraser** pour le remplacer.
4. Cliquez sur **Appliquer l'import**.

![Analyse du fichier importé : le modèle d'Énergies du Gard rattaché d'office au tiers du même nom, les modèles déjà présents sur l'instance listés à vérifier avec le choix Ignorer ou Écraser](screenshots/modeles-import-analyse.webp)

Le compte rendu indique les modèles créés, mis à jour et ignorés, et le nombre de **champs appris importés**. Dès l'import suivant d'une facture de ce fournisseur, l'en-tête et les lignes se remplissent comme sur votre instance.

![Compte rendu de l'import : un modèle créé et les champs appris importés](screenshots/modeles-import-resultat.webp)

Après l'installation, rechargez ScanDocuments dans le navigateur pour qu'il tienne compte des nouveaux mots-clés.

### Ce qui reste au client

Le compte de charge et le produit par défaut du fournisseur se choisissent chez le client, avec son comptable. ScanPdf mémorise ensuite le compte retenu à chaque import.

<a id="modeles-section-expert"></a>
## Ajuster un champ appris

Avec le droit **Expert**, l'onglet **ScanPdf** de la fiche du fournisseur affiche une **Section expert (diagnostic)** : la liste des champs appris, avec la valeur retenue et l'expression de recherche tirée du texte qui l'entoure.

![Section expert de la fiche d'Énergies du Gard : le réglage du modèle, puis les quatre champs appris (numéro, date, montants HT et TTC) avec la valeur retenue, l'expression générée et le nombre d'utilisations](screenshots/fiche-fournisseur-section-expert.webp)

Cliquez sur une ligne pour en voir le détail. Vous pouvez :

- modifier l'expression de recherche, la **Tester** puis l'enregistrer ;
- **Réinitialiser ce pattern** quand un champ s'obstine à lire une mauvaise valeur : ScanPdf efface ce qu'il en avait déduit, puis le réapprend aux imports suivants.

## Ça ne marche pas

**Le fournisseur n'est pas reconnu.** Un des mots-clés manque sur cette facture. Retirez de la liste ceux qui changent d'une facture à l'autre et gardez ceux de l'en-tête ou du pied de page.

**Un champ reste vide ou prend une mauvaise valeur.** Sélectionnez la bonne valeur sur le PDF et validez : ScanPdf apprend de la correction. Si l'erreur revient, réinitialisez ce champ dans la [section expert](#modeles-section-expert).

**La facture est créée en une seule ligne.** Les lignes lues ne redonnent pas les totaux de la facture. Vérifiez que les montants HT et TTC sont justes, puis redessinez la zone avec **Extraction multi-lignes** : si la présentation a changé, la nouvelle zone s'ajoute au modèle.

**Rien ne se passe quand je sélectionne une valeur sur le PDF.** Le texte de certains PDF n'est pas lisible par la machine, alors même qu'il s'affiche normalement ; l'éditeur l'indique dans un bandeau orange. Saisissez les champs à la main, ou faites passer le document par la reconnaissance de texte.

**Le menu Modèles d'extraction n'apparaît pas.** Désactivez puis réactivez le module ScanPdf pour mettre ses menus à jour.

Pour aller plus loin, CAP-REL réalise aussi des [modèles sur mesure](https://shop.cap-rel.fr/cat/124).
