OrgVendor
object type
An OrgVendor — the per-org purchasing ENABLEMENT of a group Vendor: the trio (accountNumber / terms free-text NOTES / purchasingCurrency [STRICT ISO-4217 SHAPE]) + the commercial payload (canned paymentTerms [the shared registry — CANONICAL over the free-text terms] / canned Incoterms-2020 incotermCode / leadTimeDays / the shipTo-LF + billTo/returnsTo-Contact pointers [SL-b set-time gates] / orderMinimum + freeFreightThreshold Money [currency-matched to purchasingCurrency] / requireCatalogItem [the PO-line gate over the OrgVendorItem junction]). Parent = the ORGANIZATION (not the family root). Deactivate stays FREE (pausing the enablement); doom is blocked by live OrgVendorItems; a NON-doomed enablement blocks the master Vendor doom. Money reuses the MoneyEntry SDL (declared on the Product entry).
Fields
| Field | Type | Notes |
|---|---|---|
id | ID ID! | The record’s id — a UUID the platform assigned when the record was created; every reference to this record uses it. |
sysId | String String! | The group-scoped human-facing system id (EV-…). |
type | String String! | The kind of record — always OrgVendor here. |
caption | String String! | The record’s display name — what people see it called. |
status | String String! | The FSM state: active | inactive | doomed. |
parentId | ID ID! | The parent Organization; for an OrgVendor parentId!== rootId. |
rootId | ID ID! | The org-group family root. |
createdAt | String String! | When the record was created, as a UTC timestamp. |
updatedAt | String String! | When the record last changed, as a UTC timestamp. |
revisionNum | Int Int! | How many times this record has been edited; the first save is 0. |
revision | ID ID! | The OCC revision token — supply it on every mutation of this record; rotates on every write. |
refCaptions | RefCaption [RefCaption!]! | The server-composed captions of this record's declared references (the referenced-caption rule) — one row per referenced id; see RefCaption. |
vendorId | ID ID! | The selected group Vendor — set at creation, IMMUTABLE thereafter. |
accountNumber | String | The org account number WITH the vendor; optional + editable. |
terms | String | Free-text terms NOTES. |
purchasingCurrency | String | The purchasing currency — STRICT ISO-4217 alphabetic SHAPE (three uppercase letters). |
paymentTerms | String | The canned payment terms; a non-canned token is VALIDATION/INVALID. Optional + editable. |
incotermCode | String | The canned Incoterms-2020 delivery term; a non-canned code is VALIDATION/INVALID. Optional + editable. |
leadTimeDays | Int | The vendor's DEFAULT lead time in days (1..730; the OrgVendorItem may override per item); optional + editable. |
defaultShipToLogicalFacilityId | ID | The default ship-to LogicalFacility; optional + editable. |
billToContactId | ID | The billing Contact pointer; optional + editable. |
returnsToContactId | ID | The return-to-vendor target Contact pointer; optional + editable. |
orderMinimum | MoneyEntry | The order minimum — currency-matched to purchasingCurrency; optional + editable. |
freeFreightThreshold | MoneyEntry | The free-freight threshold — currency-matched like orderMinimum; optional + editable. |
requireCatalogItem | Boolean | Require an OrgVendorItem per PO line (the gate; 's own deliberate default-FALSE). ABSENT (null) on pre- records means FALSE; new records always carry it. Editable. |
code | String | Optional mutable merchant reference code; uniqueness NOT enforced. |