Documentmatching Configureren

Laatste update: 02.09.2025 • Leestijd: ~12 minuten

Met Smart Processing stel je een uitgebreid, dynamisch documentmatching systeem in. De configuratie is zo flexibel dat bijna elk matchingproces kan worden weergegeven – van de klassieke 2-/3-weg matching voor inkomende facturen tot individuele scenario's zoals masterdata-toewijzingen of speciale processen.

Deze gids beschrijft:

hoe je matching activeert in een proces sjabloon,
welke globale opties beschikbaar zijn,
hoe je de lijnmatching setup stap voor stap instelt,
en hoe je aanvullende proceslogica kunt aanvullen of standaardlogica kunt vervangen door Custom Execution Codeunits.

Voorwaarden

Een proces sjabloon is beschikbaar.
De relevante documentcategorie (met lijn tabel) bestaat.
Optioneel: Een standaard workflow is geïmporteerd om voorbeeldinstellingen te gebruiken.

Tip

Importeer een voorbeeldworkflow aan het begin. Daar vind je vooraf geconfigureerde instellingen (bijv. factuurmatching) die je als referentie kunt gebruiken.

Documentmatching Activeren in het Proces Sjabloon

Open je proces sjabloon.
Activeer de optie Documentmatching Activeren.
Na activatie verschijnt de knop Matching Setup in de acties, waarmee je naar de configuratie kunt schakelen.

Globale Matching Opties

Deze opties hebben invloed op alle matchinginstellingen binnen het sjabloon:

Optie	Beschrijving	Aanbeveling
Automatische Documentmatching	Voert automatisch een match uit tijdens de documentverwerking. De matchingstatus is zichtbaar in het concept. Matching wordt alleen gelogd (transactiecodenummer '110') wanneer ten minste één lijn succesvol is gematcht.	Activeer als gestandaardiseerde documenttypes (factuur, bestelling) worden verwerkt.
Matching Verplicht	Document kan alleen worden verwerkt als het volledig is gematcht.	Gebruik wanneer foutloze gegevens absoluut vereist zijn (bijv. facturen).
Overslaan Creatie bij Match	Geef aan of de creatie van het document moet worden overgeslagen als er een geldige match wordt gevonden. Wanneer ingeschakeld en de Import Uitvoeringsvoorwaarde niet is ingesteld op 'Nooit', wordt de documentpagina die na verwerking wordt geopend, opgelost vanuit de matching setup in plaats van een nieuw document te creëren. Dit heeft alleen zin als de matching setup een ander eigen proces verwerkt, zoals een aangepaste codeunit zoals "Sales-Quote to Order."

Opmerking

Gebruik Overslaan Creatie bij Match alleen als je codeunit het hele proces inclusief validaties overneemt. Anders loop je het risico op onjuiste of onvolledige documenten.

Matching Setup

De Matching Setup is het hart van het matchingproces. Hier wordt gedefinieerd welke lijnen van het document worden gematcht met welke lijnen in Business Central.

Typisch voorbeeld: 3-weg matching voor inkomende facturen → Inkooporder ↔ Goederenontvangst ↔ Factuur.

Belangrijk

Matching vindt exclusief op lijnniveau plaats. Headerwaarden (bijv. factuurnummer, datum) worden niet gematcht.

Stap 1: Start

Matching Setup Naam – unieke naam, later zichtbaar in het proces. Niet achteraf wijzigbaar.
Verplichte Matching – bepaalt of elke inkomende lijn moet worden gematcht.

Stap 2: Matching Tabel

Matching Documentcategorie – bepaalt de documentcategorie (inclusief lijn tabel).
Matching Tabelfilter (Headerfilter) – verkleint de doel documenten.

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

Filteropties:

Geen – geen filter.
Zoektekst – gebruikt velden die tijdens de vastlegging zijn vastgelegd.
Sjabloonveld – gebruikt waarden uit sjabloonvelden.
Vaste Waarde – stelt een vaste waarde in.
Sta Lege Waarde Toe – bepaalt of lege waarden zijn toegestaan.

Tip

Gebruik unieke criteria zoals Documentnummer of Externe Referentie om handmatige herwerking te minimaliseren.

Stap 3: Setup Matching (Weergave- en Matchingvelden)

Hier bepaal je welke velden worden weergegeven en welke worden gebruikt voor matching.

Weergavevelden – helpen bij handmatige verificatie (bijv. hoeveelheid, beschrijving).
Matching Sjabloonvelden – koppelen documentvelden met tabelkolommen.

Voorbeeld:

Veldnaam	Matching Sjabloonveld	Doel
Hoeveelheid	Hoeveelheid (van Sjabloon)	Match factuurhoeveelheid met goederenontvangst

Opties:

Afwijking Accepteren → 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 is te vinden in de sectie Beschikbare Proces Codeunits (Simova & Standaard).
Matching Tolerantie → Definieert een numerieke tolerantie voor Decimaal en Geheel velden. Wanneer ingesteld, accepteert de matchinglogica waarden waarbij het absolute verschil tussen de inkomende waarde en de recordwaarde kleiner dan of gelijk aan de tolerantie is. Dit veld is alleen ingeschakeld voor Decimaal en Geheel datatypes. Wanneer de tolerantie 0 is of niet is ingesteld, geeft het veld Geen weer en wordt strikte gelijkheid afgedwongen. Voor Tekst velden voert matching witruimte-normalisatie uit (samenvouwen van meerdere witruimtekarakters) voordat een hoofdletterongevoelige vergelijking wordt uitgevoerd om de betrouwbaarheid van de matching te verbeteren.

Best Practice voor Matching Tolerantie

Gebruik Matching Tolerantie voor velden waar kleine afrondingsverschillen of onbeduidende afwijkingen acceptabel zijn (bijv. hoeveelheid of prijsvelden met afronding). Voor strikte velden zoals documentnummers of referenties, laat de tolerantie op 0 om exacte matching af te dwingen.

Stap 4: Automatisering (Auto-Matching)

Met deze optie wijst het systeem automatisch lijnen toe.

Tabelveldnaam – kolom in de doeltabel (bijv. Nr.).
Inkomend Lijnveld – veld van de inkomende lijn (bijv. artikelnummer).
Sta Lege Waarde Toe – staat filtering met lege waarden toe.

Best Practice

Filter op unieke velden zoals Nr.. Voorbeeld: Inkomende Lijn.Nr. = Tabel Lijn.Nr. → automatische koppeling zonder handmatige tussenkomst.

Stap 5: Aangepast Uitvoeringsproces (optioneel)

Update Header Velden:

Met de functie "Update Header Velden" in de Matching Profiel Setup kun je specificeren welke velden in de header van het matchingdocument moeten worden bijgewerkt na een succesvolle match. Deze optie breidt matching uit om gerichte bewerking of overschrijving van headergegevens naast lijnvelden mogelijk te maken.

Veld	Beschrijving
Tabelveldnaam	Geeft de naam aan van het doelveld dat zal worden bijgewerkt in het matchingproces.
Veldwaarde-optie	Bepaalt hoe de nieuwe veldwaarde wordt bepaald: • Vaste Waarde – Een vaste waarde wordt ingesteld. • Sjabloonveld – De waarde wordt genomen uit een ander veld van het sjabloon.
Sjabloonveld	Geeft het veld van het bronveld aan waarvan de waarde moet worden genomen in het geval van de Sjabloonveld optie.
Vaste Veldwaarde	Als Vaste Waarde is gekozen, definieert deze invoer de vaste waarde die in het headerveld zal worden geschreven.

Opmerking: Deze configuratie maakt automatische aanpassing van headergegevens mogelijk zodra een document succesvol is gematcht — bijvoorbeeld om boekings-, status- of datumvelden bij te werken en zo het hele proces te voltooien.

Aangepaste Uitvoerings Codeunits:

Definieer welke codeunit wordt uitgevoerd na succesvolle matching.

Uitvoeringsvoorwaarde – bepaalt wanneer de codeunit wordt uitgevoerd: • Bij unieke match → alleen bij unieke matching. • Altijd → ook bij meerdere setups.
Uitvoeringscodeunit – nummer van de codeunit die moet worden uitgevoerd.

Belangrijk

De status van de matching moet Volledig gematcht zijn, anders worden de processen niet uitgevoerd.

Beschikbare Proces Codeunits (Simova & Standaard)

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

Codeunit	Beschrijving	Typisch Scenario	Voorbeeld
`5673320 "SIM_DI Purch.-Get Receipts"`	Importeert goederenontvangstlijnen in de factuur. (Integreren in Proces )	3-weg matching (Bestelling ↔ Goederenontvangst ↔ Factuur).	Factuur met goederenontvangst: De posities van de goederenontvangst worden overgedragen aan de factuur.
`5673321 "SIM_DI Purch.-Get Order"`	Importeert orderlijnen in de factuur. Integreren in Proces	2-weg matching (Bestelling ↔ Factuur).	Inkomende factuur zonder goederenontvangst: Orderlijnen worden overgedragen.
`5673350 "SIM_DI Update Deviating Fields"`	Werkt velden bij met afwijkingen (wanneer Afwijking Accepteren actief is). (Vervang Proceslogica)	Inkomende factuur met prijs/hoeveelheid afwijking.	Afwijkende hoeveelheid in factuur → Codeunit overschrijft doelgegevens met factuurwaarden.
Voorbeeld `83 "Sales-Quote to Order"` (Standaard BC)	Zet een verkoopofferte om in een bestelling.	Vervang Proceslogica in verkoop scenario's.	Offertedocument wordt direct omgezet in een bestelling.

Praktische Voorbeelden

Goederenontvangsten Overdragen

Document: Inkomende Factuur
Setup: Bestelling + Goederenontvangst
Codeunit: 5673320
Resultaat: Goederenontvangstlijnen worden automatisch ingevoegd.

Orderlijnen Importeren

Document: Inkomende Factuur zonder Goederenontvangst
Codeunit: 5673321
Resultaat: Factuur ontvangt de posities van de bestelling.

Afwijkingen Afhandelen

Document: Inkomende Factuur met Afwijkende Hoeveelheid
Setup: Afwijking Accepteren actief
Codeunit: 5673350
Resultaat: Afwijking wordt geaccepteerd en doelgegevens worden bijgewerkt.

Probleemoplossing

Geen hits met filters – Controleer filterinstellingen (hoofdlettergevoeligheid, Sta Lege Waarde Toe).
Automatische mapping wordt niet toegepast – Stel Tabelveldnaam en Inkomend Lijnveld in op unieke waarden.
Uitvoeringsproces wordt niet uitgevoerd – Controleer de matchingstatus (Volledig gematcht) en zorg ervoor dat Uitvoeringscodeunit Inschakelen actief is.

Volgende Stappen

Documentlijnen Matchen