On this page
orgVendorItems
query · in the family Org vendor item
What it does
The org vendor item list — each entry is a vendor’s catalog entry for one of your variants — their cost, their pack, their SKU.
The caller's org-group family's ACTIVE LISTING of OrgVendorItems — doomed records DROP from listings.
What happens
Reads only — changes nothing.
Who may call it
Capability area: Reading your records — Looking up and listing the records of your organization.
- Owner
- System Administrator
- Manager
- Associate Manager
- Warehouse Associate
- Sales Associate
- An API key whose scope allows
api:orgVendorItems
Returns
OrgVendorItem [OrgVendorItem!]! — An org vendor item — the (OrgVendor × Variant) JUNCTION: this org buys THIS variant from THIS enabled vendor, carrying the vendor's part number / list cost / MOQ / lead time. Parent = the OrgVendor (the InventoryItem junction stance). The (orgVendor × variant) pair is unique (a live duplicate is CONFLICT/IDENTITY_TAKEN naming the holder; a doomed holder is taken over). OVIs are OPTIONAL by default. Live OVIs block the parent OrgVendor's doom AND the Variant's doom (CONFLICT/REFERENCED); OrgVendor deactivate stays free. Money reuses the MoneyEntry SDL (declared on the Product entry).
Example request
query ExampleOrgVendorItems {
orgVendorItems {
id
sysId
type
caption
status
parentId
rootId
createdAt
updatedAt
revisionNum
revision
variantId
vendorPartNumber
moq
leadTimeDays
purchasePackId
}
}
Example response
{
"data": {
"orgVendorItems": [
{
"id": "01900000-0000-7000-8000-37386ae00000",
"sysId": "EI-EXMP-0000-000F",
"type": "OrgVendorItem",
"caption": "Blue jeans",
"status": "active",
"parentId": "01900000-0000-7000-8000-065235280000",
"rootId": "01900000-0000-7000-8000-a093dd800000",
"createdAt": "2027-01-31T00:00:00.000Z",
"updatedAt": "2027-01-31T00:00:00.000Z",
"revisionNum": 1,
"revision": "01900000-0000-7000-8000-b7960e180000",
"variantId": "01900000-0000-7000-8000-8415e73b0000",
"vendorPartNumber": "<vendor part number>",
"moq": 1,
"leadTimeDays": 1,
"purchasePackId": "01900000-0000-7000-8000-031157c60000"
}
]
},
"extensions": {
"at": {
"callId": "01EXAMPLE-CALL-ID",
"version": {
"requested": null,
"serviced": {
"name": "genesis",
"number": 0
}
}
}
}
}
Errors this call can answer
VALIDATION/INVALID— Something in the request is not valid. (VALIDATION)AUTHN/REQUIRED— Sign in to do this. (AUTHN)AUTHZ/FORBIDDEN— Your role does not allow this action. (AUTHZ)RATE_LIMIT/THROTTLED— Too many requests in a short time. (RATE_LIMIT)