Documentmatching configureren

Stand: 02.09.2025 • Leestijd: ~12 minuten

Met Smart Processing richt u een uitgebreide, dynamische documentmatching in. De configuratie is zo flexibel dat vrijwel elk matchingproces kan worden afgebeeld – van de klassieke 2-/3-weg matching bij inkomende facturen tot individuele scenario's zoals stamgegevens toewijzingen of speciale processen.

Deze gids beschrijft:

hoe u matching in een procesjabloon activeert,
welke globale opties beschikbaar zijn,
hoe u de Line Matching Setup stap voor stap instelt,
en hoe u met Custom Execution Codeunits extra proceslogica kunt aanvullen of standaardlogica kunt vervangen.

Voorwaarden

Een procesjabloon (Process Template) is aanwezig.
De relevante documentcategorie (met Line-tabel) bestaat.
Optioneel: Een standaardworkflow is geïmporteerd om voorbeeldinstellingen te kunnen gebruiken.

Tip

Importeer in het begin een voorbeeldworkflow. Daar vindt u vooraf geconfigureerde instellingen (bijv. factuurmatching) waar u zich aan kunt oriënteren.

Documentmatching in het procesjabloon activeren

Open uw procesjabloon.
Activeer de optie Activate Document Matching.
Na activatie verschijnt in de acties de knop Matching Setup, waarmee u naar de configuratie kunt gaan.

Globale matchingopties

Deze opties hebben invloed op alle matchinginstellingen binnen het sjabloon:

Optie	Beschrijving	Aanbeveling
Automatic Document Matching	Voert automatisch een matching uit tijdens de documentverwerking. De matchingstatus is zichtbaar in het concept.	Activeren als gestandaardiseerde documenttypen (factuur, bestelling) worden verwerkt.
Matching Mandatory	Document kan alleen worden verwerkt als het volledig is gematcht.	Gebruiken als foutloze gegevens absoluut noodzakelijk zijn (bijv. facturen).
Skip Creation on Match	Geef aan of de creatie van het document moet worden overgeslagen als er een geldige overeenkomst wordt gevonden. Dit is alleen zinvol als de matchinginstelling een ander eigen proces verwerkt, bijvoorbeeld een aangepaste codeunit zoals "Sales-Quote to Order".

Opmerking

Gebruik Skip Creation on Match alleen als uw codeunit het volledige proces inclusief validaties overneemt. Anders loopt u het risico op foutieve of onvolledige documenten.

Matching Setup

De Matching Setup is het hart van de matching. Hier wordt gedefinieerd welke regels uit het document met welke regels in Business Central worden gematcht.

Typisch voorbeeld: 3-weg matching bij inkomende facturen → Inkooporder ↔ Ontvangst ↔ Factuur.

Belangrijk

Matching vindt uitsluitend op regelniveau plaats. Kopwaarden (bijv. factuurnummer, datum) worden niet gematcht.

Stap 1: Start

Matching Setup Naam – unieke naam, later zichtbaar in het proces. Niet achteraf wijzigbaar.
Mandatory Matching – bepaalt of elke binnenkomende regel verplicht moet worden gematcht.

Stap 2: Matching Tabel

Matching Documentcategorie – bepaalt de documentcategorie (inclusief Line-tabel).
Matching Tabelfilter (Header-filter) – beperkt de doel-documenten.

Voorbeeld: Factuur bevat de referentie "123" → Filter op No. = 123. Het systeem vindt onmiddellijk de bijbehorende header en de bijbehorende regels.

Filteropties:

None – geen filter.
Search Text – gebruikt velden die bij de capture zijn vastgelegd.
Template Field – gebruikt waarden uit sjabloonvelden.
Fixed Value – stelt een vaste waarde in.
Allow Null Value – bepaalt of lege waarden zijn toegestaan.

Tip

Gebruik unieke criteria zoals Documentnummer of externe referentie om handmatige nabewerking te minimaliseren.

Stap 3: Setup Matching (weergave- en matchingvelden)

Hier bepaalt u welke velden worden weergegeven en welke voor de matching worden gebruikt.

Weergavevelden – helpen bij de handmatige controle (bijv. hoeveelheid, beschrijving).
Matching Template Fields – koppelen documentvelden aan tabelkolommen.

Voorbeeld:

Veldnaam	Matching Template Field	Doel
Hoeveelheid	Hoeveelheid (uit sjabloon)	Matching van factuurhoeveelheid met ontvangst

Optie: Accept Deviation → Staat afwijkingen toe die niet als fouten worden beschouwd. In combinatie met de codeunit 5673350 "SIM_DI Update Deviating Fields" kunnen dergelijke afwijkingen automatisch worden gecorrigeerd. Meer hierover vindt u in het gedeelte Beschikbare proces-codeunits (Simova & Standaard).

Stap 4: Automatisering (Auto-Matching)

Met deze optie koppelt het systeem regels automatisch.

Table Field Name – Kolom in de doel-tabel (bijv. No.).
Incoming Line Field – Veld uit de binnenkomende regel (bijv. artikelnummer).
Allow Null Value – staat filtering met lege waarden toe.

Best Practice

Filter op eenduidige velden zoals No.. Voorbeeld: Incoming Line.No. = Table Line.No. → automatische koppeling zonder handmatige ingrepen.

Stap 5: Custom Execution Process (optioneel)

Kopregelvelden bijwerken:

Met de functie „Kopregelvelden bijwerken“ in de Matching-profielsetup kunt u bepalen welke velden in de kopregel van het gematchte document na een succesvolle matching moeten worden bijgewerkt. Deze optie breidt de matching uit met de mogelijkheid om naast de regelvelden ook de kopgegevens gericht te bewerken of te overschrijven.

Veld	Beschrijving
Table Field Name	Geeft de naam van het doelveld aan dat in het matchingproces wordt bijgewerkt.
Field Value Option	Bepaalt hoe de nieuwe veldwaarde wordt bepaald: • Fixed Value – Er wordt een vaste waarde ingesteld. • Template Field – De waarde wordt uit een ander veld van het sjabloon overgenomen.
Template Field	Geeft het veld van het bronveld aan, waarvan de waarde in het geval van de optie Template Field moet worden overgenomen.
Fixed Field Value	Als Fixed Value is gekozen, definieert deze invoer de vaste waarde die in het kopregelveld wordt geschreven.

Opmerking: Deze configuratie maakt het mogelijk om kopgegevens automatisch aan te passen, zodra een document succesvol is gematcht — bijvoorbeeld om boekings-, status- of datumsvelden bij te werken en zo het gehele proces volledig af te ronden.

Custom Execution Codeunits:

Definieer welke codeunit na succesvolle matching moet worden uitgevoerd.

Execution Condition – bepaalt wanneer de codeunit draait: • On unique match → alleen bij unieke matching. • Always → ook bij meerdere instellingen.
Execution Codeunit – Nummer van de uit te voeren codeunit.

Belangrijk

De status van de matching moet Fully matched zijn, anders worden de processen niet uitgevoerd.

Beschikbare proces-codeunits (Simova & Standaard)

Na de matching kunnen codeunits automatisch worden gestart. Deze vullen de logica aan of vervangen deze volledig.

Codeunit	Beschrijving	Typisch scenario	Voorbeeld
`5673320 "SIM_DI Purch.-Get Receipts"`	Importeert ontvangstregels in de factuur. (Integrate into Process )	3-weg matching (Bestelling ↔ Ontvangst ↔ Factuur).	Factuur met ontvangst: De posities uit de ontvangst worden in de factuur overgenomen.
`5673321 "SIM_DI Purch.-Get Order"`	Importeert bestelregels in de factuur. Integrate into Process	2-weg matching (Bestelling ↔ Factuur).	Inkomende factuur zonder ontvangst: Bestelregels worden overgenomen.
`5673350 "SIM_DI Update Deviating Fields"`	Werkt velden met afwijkingen bij (wanneer Accept Deviation actief is). (Replace Process Logic)	Inkomende factuur met prijs-/hoeveelheidsafwijking.	Afwijkende hoeveelheid in factuur → Codeunit overschrijft doelgegevens met factuurwaarden.
Bsp. `83 "Sales-Quote to Order"` (Standaard BC)	Zet een verkoopaanbieding om in een bestelling.	Replace Process Logic in Sales-scenario's.	Aanbiedingsdocument wordt direct in opdracht overgebracht.

Praktijkvoorbeelden

Ontvangsten overnemen

Document: Inkomende factuur
Setup: Bestelling + Ontvangst
Codeunit: 5673320
Resultaat: Ontvangstregels worden automatisch ingevoegd.

Bestelregels importeren

Document: Inkomende factuur zonder ontvangst
Codeunit: 5673321
Resultaat: Factuur ontvangt de posities uit de bestelling.

Afwijkingen behandelen

Document: Inkomende factuur met afwijkende hoeveelheid
Setup: Accept Deviation actief
Codeunit: 5673350
Resultaat: Afwijking wordt geaccepteerd en doelgegevens worden bijgewerkt.

Probleemoplossing

Geen Treffer bij Filters – Filterinstellingen controleren (Hoofd-/kleine letters, Allow Null Value).
Automatische Mapping werkt niet – Table Field Name en Incoming Line Field instellen op eenduidige waarden.
Execution Process draait niet – Matching-status controleren (Fully matched) en ervoor zorgen dat Enable Execution Codeunit actief is.

Volgende stappen

Documentregels matchen