Vendor invoice "OmniSale GmbH" not auto-matching to PAYPAL*OMNISALE tx
Goal / question¶
Manually-uploaded vendor invoice (vendor "OmniSale GmbH", ref VND-20250424-VFS5) is
NOT auto-matching tx EgxavxxoBveNmSdF78Cx ("Purchase at PAYPAL OMNISALE,
017675198791, CHE, (Jeffero's, **9087)"). Find why — name normalization vs
"PAYPAL OMNISALE" + the "GmbH" legal suffix? amount/date evidence? fingerprint?
Root cause (2026-06-13, with live data)¶
The amount/date/currency evidence is a PERFECT match — the ONLY blocker is a missing
vendor fingerprint:
- TX EgxavxxoBveNmSdF78Cx: 2025-04-25, HK$313.42 debit, uncategorized (no GL → IS an
auto-match candidate), desc "...PAYPAL OMNISALE...".
- Invoice VND-20250424-VFS5: merchant "OmniSale GmbH", date 2025-04-24, amount 313.42,
currency HKD. → amount 313.42==313.42, dates 1 day apart (≤14d window), HKD==HKD. ✅
- Vendor record omnisale-gmbh: NOT FOUND → no fingerprints. The matcher
(vendorMatch.server.ts:133) rejects unfingerprinted vendors as "new vendor" →
suggestion only, never auto-link. So despite perfect amount+date+currency, no link.
DESIGN GAP: a first-seen vendor can never auto-link even on perfect amount+date+currency
evidence — the fingerprint is mandatory name-evidence. Consider letting strong
amount+date+currency evidence at least auto-suggest/link a manual upload.
ALSO: the same purchase was uploaded TWICE — VND-20250424-4ZA7 "Lalal.ai" (40 USD) and
VND-20250424-VFS5 "OmniSale GmbH" (313.42 HKD), same invoiceNumber 778229. OmniSale GmbH
is LALAL.AI's merchant-of-record (the name on the PayPal card line); the OmniSale one is
the correct match. Possible duplicate to reconcile.
FIX: register an "OmniSale GmbH" vendor with fingerprint "OMNISALE" (or "PAYPAL OMNISALE")
→ it auto-links on the next match run (evidence already aligns).
Log¶
- 2026-06-13 created + diagnosed. Root cause = no vendor/fingerprint; evidence otherwise perfect. Fix scoped (register fingerprint), awaiting go-ahead.
- 2026-06-13 DONE (owner one-off): registered fingerprint "OMNISALE" on vendor
omnisale-gmbh(defaultGl 5000) via upsertVendorServer; ran onVendorInvoiceCreated →linked:1. VFS5 now status=matched, txId=EgxavxxoBveNmSdF78Cx; tx booked to GL 5000 with {payee/merchant "OmniSale GmbH", invoiceNumber 778229, matchedFingerprint "OMNISALE"}. Verified live. General user-fingerprint capability → T-031. (USD-40 duplicate 4ZA7 left for owner to delete once T-031 ships delete-unless-matched — T-029b.)