Vendor
Vendor Management
This document details the logic for managing Vendor entities within the Entity Management Service.
Create Logic
Whenever the system encounters:
New
Internal Number: A new Vendor record is created.Existing
Internal Numberwith a new relation: If a new relation with a Recipient Group (identified by itsInternal Number) is detected for an existingInternal Number, a new Vendor record is created.
Update Logic
For existing Vendors (identified by Internal Number):
Upon receiving new data, the system adds missing
IBAN,VAT, andTAXnumbers, while updating existingStreetandZip Codeinformation.
Delete Logic
When a delete action is triggered for a Vendor:
The system first de-links the relationship between the Vendor and any associated Invoices.
The Vendor record is then permanently deleted.
Additional Notes:
All formatted numbers (IBAN, VAT, TAX, etc.) should adhere to a format accepting only letters and numbers.
Vendor Matching
This document details the logic for matching Vendor entities within the Entity Management Service.
Matching Factors (Priority Order)
VAT/TAX Numbers
IBAN
Vendor Name
Recipient Group ID (if available)
Scope of Matching
Organization ID: The primary search scope
Recipient Group ID (optional):
If provided, the system prioritizes Vendors associated with that Group.
If absent, it searches for unassociated Vendors.
Matching Algorithm
The system prioritizes exact matches for VAT/TAX Numbers and IBAN.
If no exact match is found, it applies fuzzy matching with a 75% similarity threshold on the Vendor Name.
When searching within a Recipient Group, results with matching Group IDs are displayed first.
For internal company matching, IBAN is used to identify the relevant Recipient from the Vendor.
Additional Notes
Fuzzy matching uses the "ratio" method.
Invoice Linking Logic
Each Invoice is linked to a single Vendor.