Configurer le Matching de Documents
Date : 02.09.2025 • Temps de lecture : ~12 minutes
Avec Smart Processing, vous mettez en place un matching de documents dynamique et complet. La configuration est si flexible qu'elle peut représenter presque tous les processus de matching – du matching classique à ⅔ voies pour les factures entrantes jusqu'à des scénarios individuels tels que l'attribution de données de base ou des processus spéciaux.
Ce guide décrit :
- comment activer le matching dans un modèle de processus,
- quelles options globales sont disponibles,
- comment configurer le Line Matching Setup étape par étape,
- et comment compléter ou remplacer la logique standard avec des Custom Execution Codeunits.
Prérequis
- Un modèle de processus est disponible.
- La catégorie de document pertinente (avec table de lignes) existe.
- Optionnel : Un workflow standard a été importé pour pouvoir utiliser des configurations d'exemple.
Conseil
Importez d'abord un workflow d'exemple. Vous y trouverez des configurations préconfigurées (par exemple, le matching de factures) sur lesquelles vous pouvez vous baser.
Activer le Matching de Documents dans le Modèle de Processus
- Ouvrez votre modèle de processus.
- Activez l'option Activate Document Matching.
- Après activation, le bouton Matching Setup apparaît dans les actions, vous permettant de passer à la configuration.
Options Globales de Matching
Ces options affectent tous les setups de matching au sein du modèle :
| Option | Description | Recommandation |
|---|---|---|
| Automatic Document Matching | Effectue automatiquement un matching lors du traitement des documents. Le statut de matching est visible dans le brouillon. | À activer si des types de documents standardisés (facture, commande) sont traités. |
| Matching Mandatory | Le document ne peut être traité que s'il est entièrement matché. | À utiliser si des données sans erreur sont impérativement requises (par exemple, pour les factures). |
| Skip Creation on Match | Indique si la création du document doit être ignorée lorsqu'un matching valide est trouvé. Cela n'a de sens que si la configuration de matching traite un autre processus propre, par exemple une codeunit personnalisée comme « Sales-Quote to Order ». |
Remarque
Utilisez Skip Creation on Match uniquement si votre codeunit prend en charge l'ensemble du processus, y compris les validations. Sinon, vous risquez d'avoir des documents erronés ou incomplets.
Configuration du Matching
La Configuration du Matching est le cœur du processus de matching. C'est ici que vous définissez quelles lignes du document sont mises en correspondance avec quelles lignes dans Business Central.
Exemple typique : Matching à 3 voies pour les factures entrantes → Commande d'achat ↔ Réception de marchandises ↔ Facture.
Important
Le matching se fait exclusivement au niveau des lignes. Les valeurs d'en-tête (par exemple, numéro de facture, date) ne sont pas mises en correspondance.
Étape 1 : Démarrer
- Nom de la Configuration de Matching – nom unique, visible plus tard dans le processus. Non modifiable par la suite.
- Matching Obligatoire – détermine si chaque ligne entrante doit être obligatoirement matchée.
Étape 2 : Table de Matching
- Catégorie de Document de Matching – détermine la catégorie de document (y compris la table de lignes).
- Filtre de Table de Matching (Filtre d'En-tête) – limite les documents cibles.
Exemple : La facture contient la référence « 123 » → Filtre sur No. = 123. Le système trouve immédiatement l'en-tête correspondant et les lignes associées.
Options de Filtre :
- Aucun – pas de filtre.
- Texte de Recherche – utilise des champs qui ont été capturés lors de la capture.
- Champ de Modèle – utilise des valeurs provenant des champs de modèle.
- Valeur Fixe – définit une valeur fixe.
- Autoriser Valeur Nulle – détermine si les valeurs vides sont autorisées.
Conseil
Utilisez des critères uniques tels que Numéro de Document ou Référence Externe pour minimiser le travail manuel.
Étape 3 : Configuration du Matching (Champs d'Affichage et de Matching)
Ici, vous déterminez quels champs sont affichés et quels champs sont utilisés pour le matching.
- Champs d'Affichage – aident à la vérification manuelle (par exemple, quantité, description).
- Champs de Modèle de Matching – lient les champs de document aux colonnes de table.
Exemple :
| Nom du Champ | Champ de Modèle de Matching | Objectif |
|---|---|---|
| Quantité | Quantité (du Modèle) | Matching de la quantité de la facture avec la réception de marchandises |
Option :
Accept Deviation → Autorise les écarts qui ne sont pas considérés comme des erreurs. En combinaison avec la codeunit 5673350 "SIM_DI Update Deviating Fields", de tels écarts peuvent être corrigés automatiquement. Vous trouverez plus d'informations dans la section Codeunits de Processus Disponibles (Simova & Standard).
Étape 4 : Automatisation (Auto-Matching)
Avec cette option, le système associe les lignes automatiquement.
- Nom du Champ de Table – colonne dans la table cible (par exemple, No.).
- Champ de Ligne Entrante – champ de la ligne entrante (par exemple, numéro d'article).
- Autoriser Valeur Nulle – permet le filtrage avec des valeurs vides.
Meilleure Pratique
Filtrez par champs uniques comme No.. Exemple : Incoming Line.No. = Table Line.No. → liaison automatique sans intervention manuelle.
Étape 5 : Processus d'Exécution Personnalisé (optionnel)
Mettre à jour les Champs d'En-tête :
Avec la fonction « Mettre à jour les Champs d'En-tête » dans la Configuration du Profil de Matching, vous pouvez définir quels champs dans l'en-tête du document correspondant doivent être mis à jour après un matching réussi. Cette option étend le matching en permettant de modifier ou de remplacer spécifiquement les données d'en-tête en plus des champs de ligne.
| Champ | Description |
|---|---|
| Nom du Champ de Table | Désigne le nom du champ cible qui sera mis à jour dans le processus de matching. |
| Option de Valeur de Champ | Détermine comment la nouvelle valeur de champ est déterminée : • Valeur Fixe – Une valeur fixe est définie. • Champ de Modèle – La valeur est prise d'un autre champ du modèle. |
| Champ de Modèle | Indique le champ de la source dont la valeur doit être reprise en cas de sélection de l'option Champ de Modèle. |
| Valeur de Champ Fixe | Si Valeur Fixe est choisie, cette entrée définit la valeur fixe qui sera écrite dans le champ d'en-tête. |
Remarque : Cette configuration permet d'ajuster automatiquement les données d'en-tête dès qu'un document a été correctement matché — par exemple, pour mettre à jour les champs de comptabilité, de statut ou de date, complétant ainsi entièrement le processus.
Codeunits d'Exécution Personnalisées :
Définissez quelle codeunit doit être exécutée après un matching réussi.
-
Condition d'Exécution – contrôle quand la codeunit s'exécute : • On unique match → uniquement en cas de matching unique. • Always → même en cas de plusieurs setups.
-
Codeunit d'Exécution – numéro de la codeunit à exécuter.
Important
Le statut du matching doit être Fully matched, sinon les processus ne seront pas exécutés.
Codeunits de Processus Disponibles (Simova & Standard)
Après le matching, des codeunits peuvent être lancées automatiquement. Celles-ci complètent la logique ou la remplacent complètement.
| Codeunit | Description | Scénario Typique | Exemple |
|---|---|---|---|
5673320 "SIM_DI Purch.-Get Receipts" |
Importe les lignes de réception de marchandises dans la facture. (Intégrer dans le Processus) | Matching à 3 voies (Commande ↔ Réception de marchandises ↔ Facture). | Facture avec réception de marchandises : Les positions de la réception de marchandises sont transférées dans la facture. |
5673321 "SIM_DI Purch.-Get Order" |
Importe les lignes de commande dans la facture. Intégrer dans le Processus | Matching à 2 voies (Commande ↔ Facture). | Facture entrante sans réception de marchandises : Les lignes de commande sont transférées. |
5673350 "SIM_DI Update Deviating Fields" |
Met à jour les champs avec des écarts (si Accept Deviation est actif). (Remplacer la Logique de Processus) | Facture entrante avec écart de prix/quantité. | Écart de quantité dans la facture → La codeunit remplace les données cibles par les valeurs de la facture. |
Ex. 83 "Sales-Quote to Order" (Standard BC) |
Transforme une offre de vente en commande. | Remplacer la Logique de Processus dans les Scénarios de Vente. | Le document d'offre est directement transféré en commande. |
Exemples Pratiques
Transférer les Réceptions de Marchandises
- Document : Facture entrante
- Configuration : Commande + Réception de marchandises
- Codeunit :
5673320 - Résultat : Les lignes de réception de marchandises sont automatiquement insérées.
Importer les Lignes de Commande
- Document : Facture entrante sans réception de marchandises
- Codeunit :
5673321 - Résultat : La facture reçoit les positions de la commande.
Gérer les Écarts
- Document : Facture entrante avec quantité différente
- Configuration : Accept Deviation actif
- Codeunit :
5673350 - Résultat : L'écart est accepté et les données cibles sont mises à jour.
Dépannage
- Aucun résultat avec les filtres – Vérifiez les paramètres de filtre (majuscules/minuscules, Autoriser Valeur Nulle).
- Le mapping automatique ne fonctionne pas – Réglez le Nom du Champ de Table et le Champ de Ligne Entrante sur des valeurs uniques.
- Le Processus d'Exécution ne fonctionne pas – Vérifiez le statut de matching (Fully matched) et assurez-vous que Enable Execution Codeunit est actif.