Operations pillar · v0.16.0
vendor Vendor
Vendor master record.
$id · https://corpospec.com/schemas/v0.16.0/vendor.schema.json
Fields
| Field | Type | Required | Description |
|---|---|---|---|
| category | VendorCategory | yes | Vendor category. |
| display_name | string | yes | |
| id | PathRef | yes | Path-based cross-reference relative to .corpospec/ root. Pattern: `^[a-z0-9_-]+(/[a-z0-9_.-]+)+$` |
| internal_owner | PathRef | yes | PathRef to the internal owner (sponsor / KAM). |
| jurisdiction | IsoCountry | yes | ISO 3166-1 alpha-2 country code. |
| legal_name | string | yes | |
| onboarded_at | IsoDate | yes | ISO 8601 date (YYYY-MM-DD). |
| registered_address | PostalAddress | yes | Registered address. |
| relationship | VendorRelationship | yes | Relationship category. |
| spend_currency | IsoCurrency | yes | Annual spend currency + amount (latest closed FY). |
| spend_per_year | number | yes | |
| status | VendorStatus | yes | Lifecycle. |
| dpa_ref | PathRef? | — | PathRef to active DPA (Art. 28). |
| gdpr_role | string? | — | GDPR role assigned to this vendor. |
| last_risk_assessment | PathRef? | — | Last risk-assessment record (vendor_risk_assessment). |
| lei | Lei? | — | LEI per ISO 17442. |
| master_agreement | PathRef? | — | PathRef to active master service / framework agreement. |
| parent_vendor | PathRef? | — | Parent vendor (LEI Level-2 relationship). |
| primary_contact | VendorContact? | — | Primary contact (often KAM / partner-success manager). |
| processing_record_refs | PathRef[] | — | Processing records this vendor participates in. |
| tax_id | string? | — | Tax identification number. |
| terminated_at | IsoDate? | — | |
| wikidata_qid | WikidataQid? | — | Wikidata QID for public identification. |
Definitions
Shared types referenced within this schema.
IsoCountry
ISO 3166-1 alpha-2 country code.
pattern: ^[A-Z]{2}$
IsoCurrency
ISO 4217 currency code.
pattern: ^[A-Z]{3}$
IsoDate
ISO 8601 date (YYYY-MM-DD).
type: string
Lei
ISO 17442 Legal Entity Identifier (20-character alphanumeric).
pattern: ^[A-Z0-9]{18}[0-9]{2}$
PathRef
Path-based cross-reference relative to .corpospec/ root.
Pattern: `^[a-z0-9_-]+(/[a-z0-9_.-]+)+$`
pattern: ^[a-z0-9_-]+(/[a-z0-9_.-]+)+$
PostalAddress
Physical address aligned with schema.org PostalAddress.
type: object
VendorCategory
Vendor category.
VendorContact
Primary contact.
type: object
VendorRelationship
Relationship category.
VendorStatus
Lifecycle.
WikidataQid
Wikidata Q-identifier (`Q123`, `Q92779`). Optional global-discoverability
hook on Entity / Person / Party / Brand records. See BDR 0080 §4.
pattern: ^Q[1-9][0-9]*$
Reference in your YAML
# yaml-language-server: $schema=https://corpospec.com/schemas/v0.16.0/vendor.schema.json