Configurer l'appariement de documents

Dernière mise à jour : 02.09.2025 • Temps de lecture : ~12 minutes

Avec Smart Processing, vous mettez en place un système complet et dynamique d'appariement de documents. La configuration est si flexible qualmost tout processus d'appariement peut être représenté – du classique appariement 2-/3-voies pour les factures entrantes à des scénarios individuels tels que les affectations de données maîtres ou des processus spéciaux.

Ce guide décrit :

comment activer l'appariement dans un modèle de processus,
quelles options globales sont disponibles,
comment configurer l'étape de configuration de l'appariement étape par étape,
et comment compléter la logique de processus supplémentaire ou remplacer la logique standard par des Codeunits d'exécution personnalisés.

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 utiliser des configurations d'exemple.

Astuce

Importez un workflow d'exemple au début. Vous y trouverez des configurations préconfigurées (par exemple, appariement de factures) que vous pouvez utiliser comme référence.

Activer l'appariement de documents dans le modèle de processus

Ouvrez votre modèle de processus.
Activez l'option Activer l'appariement de documents.
Après activation, le bouton Configuration de l'appariement apparaît dans les actions, vous permettant de passer à la configuration.

Options globales d'appariement

Ces options affectent toutes les configurations d'appariement au sein du modèle :

Option	Description	Recommandation
Appariement automatique de documents	Effectue automatiquement un appariement lors du traitement des documents. Le statut d'appariement est visible dans le brouillon. L'appariement n'est enregistré (code de transaction '110') que si au moins une ligne est appariée avec succès.	Activez si des types de documents standardisés (facture, commande) sont traités.
Appariement obligatoire	Le document ne peut être traité que s'il est entièrement apparié.	Utilisez lorsque des données sans erreur sont absolument requises (par exemple, factures).
Ignorer la création lors de l'appariement	Spécifiez si la création du document doit être ignorée si un appariement valide est trouvé. Lorsqu'il est activé et que la condition d'exécution d'importation n'est pas définie sur 'Jamais', la page de document ouverte après le traitement est résolue à partir de la configuration d'appariement plutôt que de créer un nouveau document. Cela n'a de sens que si la configuration d'appariement traite un autre processus propre, tel qu'un codeunit personnalisé comme "Devis de vente à commande."

Remarque

Utilisez Ignorer la création lors de l'appariement uniquement si votre codeunit prend en charge l'ensemble du processus, y compris les validations. Sinon, vous risquez d'obtenir des documents incorrects ou incomplets.

Configuration de l'appariement

La configuration de l'appariement est le cœur du processus d'appariement. Ici, il est défini quelles lignes du document sont appariées avec quelles lignes dans Business Central.

Exemple typique : Appariement 3-voies pour les factures entrantes → Commande d'achat ↔ Réception de marchandises ↔ Facture.

Important

L'appariement se fait exclusivement au niveau des lignes. Les valeurs d'en-tête (par exemple, numéro de facture, date) ne sont pas appariées.

Étape 1 : Démarrer

Nom de la configuration d'appariement – nom unique, visible plus tard dans le processus. Non modifiable par la suite.
Appariement obligatoire – détermine si chaque ligne entrante doit être appariée.

Étape 2 : Table d'appariement

Catégorie de document d'appariement – détermine la catégorie de document (y compris la table de lignes).
Filtre de table d'appariement (Filtre d'en-tête) – restreint 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 – aucun filtre.
Texte de recherche – utilise des champs capturés lors de la capture.
Champ de modèle – utilise des valeurs des champs de modèle.
Valeur fixe – définit une valeur fixe.
Autoriser la valeur nulle – détermine si des valeurs vides sont autorisées.

Astuce

Utilisez des critères uniques tels que Numéro de document ou Référence externe pour minimiser le travail manuel.

Étape 3 : Configuration de l'appariement (Champs d'affichage et d'appariement)

Ici, vous déterminez quels champs sont affichés et lesquels sont utilisés pour l'appariement.

Champs d'affichage – aident à la vérification manuelle (par exemple, quantité, description).
Champs de modèle d'appariement – lient les champs de document avec les colonnes de table.

Exemple :

Nom du champ	Champ de modèle d'appariement	But
Quantité	Quantité (du modèle)	Apparier la quantité de la facture avec la réception de marchandises

Options :

Accepter la déviation → Permet des déviations qui ne sont pas considérées comme des erreurs. En combinaison avec le codeunit 5673350 "SIM_DI Update Deviating Fields", de telles déviations peuvent être corrigées automatiquement. Plus d'informations à ce sujet se trouvent dans la section Codeunits de processus disponibles (Simova & Standard).
Tolérance d'appariement → Définit une tolérance numérique pour les champs Décimal et Entier. Lorsqu'elle est définie, la logique d'appariement accepte les valeurs où la différence absolue entre la valeur entrante et la valeur d'enregistrement est inférieure ou égale à la tolérance. Ce champ n'est activé que pour les types de données Décimal et Entier. Lorsque la tolérance est 0 ou non définie, le champ affiche Aucun et l'égalité stricte est appliquée. Pour les champs Texte, l'appariement effectue une normalisation des espaces (réduction de plusieurs caractères d'espace) avant la comparaison insensible à la casse pour améliorer la fiabilité de l'appariement.

Meilleure pratique pour la tolérance d'appariement

Utilisez Tolérance d'appariement pour les champs où de légères différences d'arrondi ou des déviations insignifiantes sont acceptables (par exemple, champs de quantité ou de prix avec arrondi). Pour des champs stricts comme les numéros de document ou les références, laissez la tolérance à 0 pour imposer un appariement exact.

Étape 4 : Automatisation (Auto-Appariement)

Avec cette option, le système attribue automatiquement les lignes.

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 la valeur nulle – permet le filtrage avec des valeurs vides.

Meilleure pratique

Filtrez par champs uniques comme No.. Exemple : Ligne entrante.No. = Ligne de table.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 d'appariement, vous pouvez spécifier quels champs dans l'en-tête du document d'appariement doivent être mis à jour après un appariement réussi. Cette option étend l'appariement pour permettre l'édition ciblée ou l'écrasement des données d'en-tête en plus des champs de ligne.

Champ	Description
Nom du champ de table	Indique le nom du champ cible qui sera mis à jour dans le processus d'appariement.
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	Spécifie le champ du champ source dont la valeur doit être prise dans le cas 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 un ajustement automatique des données d'en-tête dès qu'un document a été apparié avec succès — par exemple, pour mettre à jour les champs de publication, de statut ou de date et ainsi compléter l'ensemble du processus.

Codeunits d'exécution personnalisés :

Définissez quel codeunit est exécuté après un appariement réussi.

Condition d'exécution – contrôle quand le codeunit s'exécute : • Sur appariement unique → uniquement sur appariement unique. • Toujours → également avec plusieurs configurations.
Codeunit d'exécution – numéro du codeunit à exécuter.

Important

Le statut de l'appariement doit être Entièrement apparié, sinon les processus ne seront pas exécutés.

Codeunits de processus disponibles (Simova & Standard)

Après l'appariement, des codeunits peuvent être automatiquement démarrés. Ceux-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)	Appariement 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 à la facture.
`5673321 "SIM_DI Purch.-Get Order"`	Importe les lignes de commande dans la facture. Intégrer dans le processus	Appariement 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 déviations (lorsque Accepter la déviation est actif). (Remplacer la logique de processus)	Facture entrante avec déviation de prix/quantité.	Quantité déviante dans la facture → Codeunit écrase les données cibles avec les valeurs de la facture.
Exemple `83 "Sales-Quote to Order"` (BC Standard)	Convertit un devis de vente en commande.	Remplacer la logique de processus dans les scénarios de vente.	Le document de devis est directement converti 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 déviations

Document : Facture entrante avec quantité déviante
Configuration : Accepter la déviation active
Codeunit : 5673350
Résultat : La déviation est acceptée et les données cibles sont mises à jour.

Dépannage

Aucun résultat avec les filtres – Vérifiez les paramètres de filtre (sensibilité à la casse, Autoriser la valeur nulle).
Le mappage automatique ne s'applique pas – Définissez le nom du champ de table et le champ de ligne entrante sur des valeurs uniques.
Le processus d'exécution ne s'exécute pas – Vérifiez le statut d'appariement (Entièrement apparié) et assurez-vous que Activer le codeunit d'exécution est actif.

Prochaines étapes

Apparier les lignes de documents