# 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](/types/#scalars) `ID!` | The record’s id — a UUID the platform assigned when the record was created; every reference to this record uses it. |
| `sysId` | [String](/types/#scalars) `String!` | The group-scoped human-facing system id (EV-…). |
| `type` | [String](/types/#scalars) `String!` | The kind of record — always `OrgVendor` here. |
| `caption` | [String](/types/#scalars) `String!` | The record’s display name — what people see it called. |
| `status` | [String](/types/#scalars) `String!` | The FSM state: active \| inactive \| doomed. |
| `parentId` | [ID](/types/#scalars) `ID!` | The parent Organization; for an OrgVendor parentId!== rootId. |
| `rootId` | [ID](/types/#scalars) `ID!` | The org-group family root. |
| `createdAt` | [String](/types/#scalars) `String!` | When the record was created, as a UTC timestamp. |
| `updatedAt` | [String](/types/#scalars) `String!` | When the record last changed, as a UTC timestamp. |
| `revisionNum` | [Int](/types/#scalars) `Int!` | How many times this record has been edited; the first save is 0. |
| `revision` | [ID](/types/#scalars) `ID!` | The OCC revision token — supply it on every mutation of this record; rotates on every write. |
| `refCaptions` | [RefCaption](/types/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](/types/#scalars) `ID!` | The selected group Vendor — set at creation, IMMUTABLE thereafter. |
| `accountNumber` | [String](/types/#scalars) | The org account number WITH the vendor; optional + editable. |
| `terms` | [String](/types/#scalars) | Free-text terms NOTES. |
| `purchasingCurrency` | [String](/types/#scalars) | The purchasing currency — STRICT ISO-4217 alphabetic SHAPE (three uppercase letters). |
| `paymentTerms` | [String](/types/#scalars) | The canned payment terms; a non-canned token is VALIDATION/INVALID. Optional + editable. |
| `incotermCode` | [String](/types/#scalars) | The canned Incoterms-2020 delivery term; a non-canned code is VALIDATION/INVALID. Optional + editable. |
| `leadTimeDays` | [Int](/types/#scalars) | The vendor's DEFAULT lead time in days (1..730; the OrgVendorItem may override per item); optional + editable. |
| `defaultShipToLogicalFacilityId` | [ID](/types/#scalars) | The default ship-to LogicalFacility; optional + editable. |
| `billToContactId` | [ID](/types/#scalars) | The billing Contact pointer; optional + editable. |
| `returnsToContactId` | [ID](/types/#scalars) | The return-to-vendor target Contact pointer; optional + editable. |
| `orderMinimum` | [MoneyEntry](/types/MoneyEntry/) | The order minimum — currency-matched to purchasingCurrency; optional + editable. |
| `freeFreightThreshold` | [MoneyEntry](/types/MoneyEntry/) | The free-freight threshold — currency-matched like orderMinimum; optional + editable. |
| `requireCatalogItem` | [Boolean](/types/#scalars) | 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](/types/#scalars) | Optional mutable merchant reference code; uniqueness NOT enforced. |

## Used by

- [createOrgVendor](/reference/org-vendor/createOrgVendor/)
- [deactivateOrgVendor](/reference/org-vendor/deactivateOrgVendor/)
- [doomOrgVendor](/reference/org-vendor/doomOrgVendor/)
- [orgVendor](/reference/org-vendor/orgVendor/)
- [reactivateOrgVendor](/reference/org-vendor/reactivateOrgVendor/)
- [updateOrgVendor](/reference/org-vendor/updateOrgVendor/)