Vendor KYS (Know-Your-Supplier)
Before a vendor can be sourced, it must clear KYS — the procurement equivalent of Proptech’s brokerage KYC. The engine runs the same Guardian core and resolves a vendor to one of three standings.
Standings
| Standing | Meaning | Driven by Guardian decision |
|---|---|---|
| Approved | Cleared to source | allow |
| Pending review | Needs a human before sourcing | prepare / escalate |
| Blocked | Hard stop | block |
The standing is derived only from the core decision — there is a single source of truth, no parallel logic.
Rules (fail-closed)
| Condition | Effect |
|---|---|
sanctioned: true | sanctions_hit block flag → Blocked |
kyc: 'failed' | kys_failed block flag → Blocked |
kyc: 'pending' | level → human_licensed_only → Pending review |
rating < minRating (default 3.5) | level → human_licensed_only → Pending review |
| otherwise | full_auto → Approved |
A sanctions match also sets legallyRestricted on the Guardian call, for audit
transparency.
Worked example
From the demo catalogue:
- Cedar Components (rating 4.8, KYS verified, not sanctioned) → Approved.
- Orion Trading (KYS
pending) → Pending review until verification clears. - Vortex Metals (
sanctioned: true) → Blocked, regardless of its 4.4 rating. - Apex Wholesale (rating 3.2, below the 3.5 bar) → Pending review.
Block flags are absolute: a sanctions hit or failed KYS blocks a vendor even with a high rating and clean spend history. See the API Reference.
Last updated on