{"items":[{"type":"link","label":"Orderwerks REST API","link":"/openapi","routeSlug":"/openapi","content":{"contentType":"overview","meta":{"name":"Orderwerks REST API"},"children":[{"nodeType":"container","panels":[{"title":"Download OpenAPI description","titleTranslationKey":"download.description.title","children":[{"kind":"download","label":"openapi.json","url":"/_bundle/openapi.json?download"},{"kind":"download","label":"openapi.yaml","url":"/_bundle/openapi.yaml?download"}]},{"title":"Overview","titleTranslationKey":"info.title","children":[]},{"title":"Languages","titleTranslationKey":"languages.title","children":[{"kind":"languages","options":[{"key":"curl","title":"curl","lang":"curl"},{"key":"javascript","title":"JavaScript","lang":"JavaScript"},{"key":"node","title":"Node.js","lang":"Node.js"},{"key":"python","title":"Python","lang":"Python"},{"key":"java","title":"Java","lang":"Java"},{"key":"csharp","title":"C#","lang":"C#"},{"key":"php","title":"PHP","lang":"PHP"},{"key":"go","title":"Go","lang":"Go"},{"key":"ruby","title":"Ruby","lang":"Ruby"},{"key":"r","title":"R","lang":"R"},{"key":"payload","title":"Payload","lang":"Payload"}]}]},{"title":"Servers","titleTranslationKey":"servers.title","children":[{"kind":"servers","servers":[{"url":"/_mock/openapi","description":"Mock server","isMockServer":true},{"url":"https://owapi.orderwerks.com","description":"Production"}],"mode":"default"}]}],"children":[{"nodeType":"overview-section-wrapper","children":[{"nodeType":"header","level":1,"label":"Orderwerks REST API (1.19)","showPageActions":true},{"nodeType":"overview-section-wrapper","children":[{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Orderwerks REST API lets integrators read and write customers (vendors), catalogs, catalog items,"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"price groups and orders for a supplier account."},"children":[]}]}]}]}],"sectionId":"/openapi"}],"sectionId":"/openapi"},{"nodeType":"overview-section-wrapper","children":[{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":1,"id":"section/authentication"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Every request must carry one of two header sets. Each endpoint lists which set it accepts under"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authorizations"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"API key and secret"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (recommended for integrations): send "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"x-apiKey"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"x-apiSecret"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Requests"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"authenticated this way run as the supplier's master user. Add a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"vendorGuid"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" header to act in the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"context of one customer, and optionally a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"userGuid"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" header to attribute the call to a specific user."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"User session headers"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (used by the Orderwerks web and mobile apps): send "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"userGuid"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"userToken"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"(the JWT issued at login) and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"supplierGuid"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", plus "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"vendorGuid"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" when acting for a customer."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"API keys are created in the Orderwerks web app under Business Settings. The secret is shown once, at creation."},"children":[]}]}]}]}],"sectionId":"/openapi/section/authentication"},{"nodeType":"overview-section-wrapper","children":[{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":1,"id":"section/conventions"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Conventions"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Paths are versioned per resource ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"/v1/..."},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"/v2/..."},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"); a few legacy paths have no version segment."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Responses are JSON. There is no common envelope; each endpoint documents its own shape."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Paged list endpoints take "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"limit"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (default 25, maximum 100) and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"offset"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"offset"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is a "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"page number"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":","},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"not a row count: the server skips "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"offset * limit"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" rows."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Delta sync: list endpoints that return "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"serverTimestamp"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" accept it back as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"lastUpdatedAt"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" on the next"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"call to fetch only rows changed since then. Soft-deleted rows are included in delta responses with"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"deleted_at"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" set."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Errors return "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"4xx"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"/"},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"5xx"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" with a JSON body of the form "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"{ \"message\": \"...\" }"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". A few legacy endpoints"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"return a plain-text message instead; those are noted individually."},"children":[]}]}]}]}]}],"sectionId":"/openapi/section/conventions"},{"nodeType":"overview-section-wrapper","children":[{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":1,"id":"section/terminology"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Terminology"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Orderwerks calls the business operating the account the "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"supplier"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", and the customers who place orders"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"vendors"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (also \"accounts\" or \"customers\" in the apps). Vendor endpoints are customer endpoints."},"children":[]}]}]}]}],"sectionId":"/openapi/section/terminology"}]}]}},{"type":"link","label":"Authentication","link":"/openapi/section/authentication","routeSlug":"/openapi/section/authentication","content":null},{"type":"link","label":"Conventions","link":"/openapi/section/conventions","routeSlug":"/openapi/section/conventions","content":null},{"type":"link","label":"Terminology","link":"/openapi/section/terminology","routeSlug":"/openapi/section/terminology","content":null},{"type":"separator","label":"Customers","content":null},{"type":"group","label":"Vendors","link":"/openapi/vendors","routeSlug":"/openapi/vendors","items":[{"label":"List customers","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/vendors/listvendors","routeSlug":"/openapi/vendors/listvendors","metadata":{"seo":{"title":"List customers","description":"Returns the supplier's customers (vendors) as a paged list of supplier-to-customer connections; the customerrecord is under Vendor on each row. Requires supplier-level access."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"listVendors","name":"List customers","isWebhook":false,"pointer":"/paths/~1vendors/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List customers","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Returns the supplier's customers (vendors) as a paged list of supplier-to-customer connections; the customer"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"record is under "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Vendor"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" on each row. Requires supplier-level access."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Supports delta sync: pass the returned "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"serverTimestamp"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" back as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"lastUpdatedAt"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to receive only customers"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"changed since then."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"ApiKey","scopes":[],"type":"apiKey","in":"header","paramName":"x-apiKey","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Supplier API key. Always sent together with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"x-apiSecret"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"name":"ApiSecret","scopes":[],"type":"apiKey","in":"header","paramName":"x-apiSecret","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Supplier API secret. Always sent together with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"x-apiKey"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]}]},{"schemes":[{"name":"UserGuid","scopes":[],"type":"apiKey","in":"header","paramName":"userGuid","description":"GUID of the authenticated user (user session headers)."},{"name":"UserToken","scopes":[],"type":"apiKey","in":"header","paramName":"userToken","description":"JWT issued to the user at login (user session headers)."},{"name":"SupplierGuid","scopes":[],"type":"apiKey","in":"header","paramName":"supplierGuid","description":"GUID of the supplier account the user is acting in (user session headers)."}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"limit","in":"query","schemaId":"schema_22","description":"Number of rows per page."},{"name":"offset","in":"query","schemaId":"schema_23","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Zero-based "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"page number"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". The server skips "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"offset * limit"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" rows."},"children":[]}]}]}]},{"name":"lastUpdatedAt","in":"query","schemaId":"schema_24","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Delta-sync cursor. Pass the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"serverTimestamp"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" returned by the previous call to receive only rows created, updated or soft-deleted since then (deleted rows carry "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"deleted_at"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"). Accepts ISO-8601 ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"2026-09-01T14:00:00.000Z"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":") or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"YYYY-MM-DD HH:mm:ss"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (treated as UTC). The server re-fetches a 60-second overlap window to absorb clock skew. An unparsable value returns "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"code: INVALID_DELTA_CURSOR"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"name":"name","in":"query","schemaId":"schema_25","description":"Filter by customer name (contains match)."},{"name":"category","in":"query","schemaId":"schema_25","description":"Filter by customer category."},{"name":"state_license","in":"query","schemaId":"schema_25","description":"Filter by state license number."},{"name":"filter_inactive","in":"query","schemaId":"schema_26","description":"Exclude inactive customers."},{"name":"filterInactive","in":"query","schemaId":"schema_26","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Alias of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"filter_inactive"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"name":"order_by","in":"query","schemaId":"schema_25","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Column to sort by (for example "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]}]}]}]},{"name":"order_dir","in":"query","schemaId":"schema_27"},{"name":"nameGuidOnly","in":"query","schemaId":"schema_26","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Return only "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"guid"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for each customer (faster for pickers)."},"children":[]}]}]}]}],"pointer":"/paths/~1vendors/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/vendors","servers":[{"url":"/_mock/openapi","description":"Mock server","isMockServer":true},{"url":"https://owapi.orderwerks.com","description":"Production"}],"parameters":{"path":[],"query":[{"name":"limit","in":"query","required":false,"schemaId":"schema_22"},{"name":"offset","in":"query","required":false,"schemaId":"schema_23"},{"name":"lastUpdatedAt","in":"query","required":false,"example":"2026-09-01T14:00:00.000Z","schemaId":"schema_24"},{"name":"name","in":"query","schemaId":"schema_25"},{"name":"category","in":"query","schemaId":"schema_25"},{"name":"state_license","in":"query","schemaId":"schema_25"},{"name":"filter_inactive","in":"query","schemaId":"schema_26"},{"name":"filterInactive","in":"query","schemaId":"schema_26"},{"name":"order_by","in":"query","schemaId":"schema_25"},{"name":"order_dir","in":"query","schemaId":"schema_27"},{"name":"nameGuidOnly","in":"query","schemaId":"schema_26"}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"ApiKey","type":"apiKey","name":"x-apiKey","in":"header"},{"id":"ApiSecret","type":"apiKey","name":"x-apiSecret","in":"header"}],"scopes":[]},{"schemes":[{"id":"UserGuid","type":"apiKey","name":"userGuid","in":"header"},{"id":"UserToken","type":"apiKey","name":"userToken","in":"header"},{"id":"SupplierGuid","type":"apiKey","name":"supplierGuid","in":"header"}],"scopes":[]}],"responseCodes":["200","400","401","403"],"pointer":"/vendors","href":"vendors/listvendors","openApiOperationId":"listVendors","summary":"List customers","securityGroups":[{"ApiKey":[],"ApiSecret":[]},{"UserGuid":[],"UserToken":[],"SupplierGuid":[]}]},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/openapi","description":"Mock server","isMockServer":true},{"url":"https://owapi.orderwerks.com","description":"Production"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"A page of customers.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/VendorListResponse"}},"schemaId":"components/schemas/VendorListResponse"},{"code":"400","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Bad request. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"code"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"INVALID_DELTA_CURSOR"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" when "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"lastUpdatedAt"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" cannot be parsed."},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error"}},"schemaId":"components/schemas/Error"},{"code":"401","description":"Missing or invalid credentials.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1vendors/get/responses/401/content/application~1json/example"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1vendors/get/responses/401/content/application~1json/example"]},{"code":"403","description":"The credentials are valid but the user lacks the access level this endpoint requires.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1vendors/get/responses/403/content/application~1json/example"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1vendors/get/responses/403/content/application~1json/example"]}],"pointer":"/paths/~1vendors/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/VendorListResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/VendorListResponse"}}},{"code":"400","schemaId":"components/schemas/Error","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error"}}},{"code":"401","schemaId":"components/schemas/Error","exampleIds":["paths/~1vendors/get/responses/401/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1vendors/get/responses/401/content/application~1json/example"]}}},{"code":"403","schemaId":"components/schemas/Error","exampleIds":["paths/~1vendors/get/responses/403/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1vendors/get/responses/403/content/application~1json/example"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/vendors/listvendors"}],"panels":[]}]},"httpPath":"/vendors"},{"label":"Create a customer","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/vendors/createvendor","routeSlug":"/openapi/vendors/createvendor","metadata":{"seo":{"title":"Create a customer","description":"Creates a customer (vendor) with optional billing address, shipping address, primary contact and account note,without an order. Idempotent on supplier + newVendor.email: a retry after a lost response returns the existingcustomer's references instead of creating a duplicate."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"createVendor","name":"Create a customer","isWebhook":false,"pointer":"/paths/~1vendors/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Create a customer","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Creates a customer (vendor) with optional billing address, shipping address, primary contact and account note,"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"without an order. Idempotent on supplier + "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"newVendor.email"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": a retry after a lost response returns the existing"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"customer's references instead of creating a duplicate."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Accepts user session headers only. Contact support to request API key access for this endpoint."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"UserGuid","scopes":[],"type":"apiKey","in":"header","paramName":"userGuid","description":"GUID of the authenticated user (user session headers)."},{"name":"UserToken","scopes":[],"type":"apiKey","in":"header","paramName":"userToken","description":"JWT issued to the user at login (user session headers)."},{"name":"SupplierGuid","scopes":[],"type":"apiKey","in":"header","paramName":"supplierGuid","description":"GUID of the supplier account the user is acting in (user session headers)."}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/CreateVendorRequest","exampleIds":["paths/~1vendors/post/requestBody/content/application~1json/example"]}},"schemaId":"components/schemas/CreateVendorRequest","exampleIds":["paths/~1vendors/post/requestBody/content/application~1json/example"],"pointer":"/paths/~1vendors/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/vendors","servers":[{"url":"/_mock/openapi","description":"Mock server","isMockServer":true},{"url":"https://owapi.orderwerks.com","description":"Production"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"UserGuid","type":"apiKey","name":"userGuid","in":"header"},{"id":"UserToken","type":"apiKey","name":"userToken","in":"header"},{"id":"SupplierGuid","type":"apiKey","name":"supplierGuid","in":"header"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/CreateVendorRequest","exampleIds":["paths/~1vendors/post/requestBody/content/application~1json/example"]}},"responseCodes":["200","400","401","500"],"pointer":"/vendors","href":"vendors/createvendor","openApiOperationId":"createVendor","summary":"Create a customer"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/openapi","description":"Mock server","isMockServer":true},{"url":"https://owapi.orderwerks.com","description":"Production"}],"schemaId":"components/schemas/CreateVendorRequest","exampleIds":["paths/~1vendors/post/requestBody/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/CreateVendorRequest","exampleIds":["paths/~1vendors/post/requestBody/content/application~1json/example"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"The created (or matched) customer.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/CreateVendorResponse"}},"schemaId":"components/schemas/CreateVendorResponse"},{"code":"400","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Validation failure ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"newVendor"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"newVendor.name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" missing)."},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ReconcileErrors"}},"schemaId":"components/schemas/ReconcileErrors"},{"code":"401","description":"Missing or invalid credentials.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1vendors/post/responses/401/content/application~1json/example"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1vendors/post/responses/401/content/application~1json/example"]},{"code":"500","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Unexpected server error. Some legacy endpoints return the message as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"text/plain"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" instead of JSON."},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json","text/plain"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error"},"text/plain":{"schemaId":"schema_25"}},"schemaId":"components/schemas/Error"}],"pointer":"/paths/~1vendors/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/CreateVendorResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/CreateVendorResponse"}}},{"code":"400","schemaId":"components/schemas/ReconcileErrors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ReconcileErrors"}}},{"code":"401","schemaId":"components/schemas/Error","exampleIds":["paths/~1vendors/post/responses/401/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1vendors/post/responses/401/content/application~1json/example"]}}},{"code":"500","schemaId":"components/schemas/Error","mediaTypes":["application/json","text/plain"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error"},"text/plain":{"schemaId":"schema_25"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/vendors/createvendor"}],"panels":[]}]},"httpPath":"/vendors"},{"label":"Get a customer","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/vendors/getvendor","routeSlug":"/openapi/vendors/getvendor","metadata":{"seo":{"title":"Get a customer","description":"Returns one customer (vendor) with its addresses, integration links and shipping preferences."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getVendor","name":"Get a customer","isWebhook":false,"pointer":"/paths/~1v1~1vendors~1{vendorGuid}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get a customer","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Returns one customer (vendor) with its addresses, integration links and shipping preferences."},{"nodeType":"security","requirements":[{"schemes":[{"name":"ApiKey","scopes":[],"type":"apiKey","in":"header","paramName":"x-apiKey","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Supplier API key. Always sent together with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"x-apiSecret"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"name":"ApiSecret","scopes":[],"type":"apiKey","in":"header","paramName":"x-apiSecret","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Supplier API secret. Always sent together with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"x-apiKey"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]}]},{"schemes":[{"name":"UserGuid","scopes":[],"type":"apiKey","in":"header","paramName":"userGuid","description":"GUID of the authenticated user (user session headers)."},{"name":"UserToken","scopes":[],"type":"apiKey","in":"header","paramName":"userToken","description":"JWT issued to the user at login (user session headers)."},{"name":"SupplierGuid","scopes":[],"type":"apiKey","in":"header","paramName":"supplierGuid","description":"GUID of the supplier account the user is acting in (user session headers)."}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"vendorGuid","in":"path","schemaId":"schema_28","description":"GUID of the customer (vendor).","required":true}],"pointer":"/paths/~1v1~1vendors~1{vendorGuid}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/v1/vendors/{vendorGuid}","servers":[{"url":"/_mock/openapi","description":"Mock server","isMockServer":true},{"url":"https://owapi.orderwerks.com","description":"Production"}],"parameters":{"path":[{"name":"vendorGuid","in":"path","required":true,"schemaId":"schema_28"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"ApiKey","type":"apiKey","name":"x-apiKey","in":"header"},{"id":"ApiSecret","type":"apiKey","name":"x-apiSecret","in":"header"}],"scopes":[]},{"schemes":[{"id":"UserGuid","type":"apiKey","name":"userGuid","in":"header"},{"id":"UserToken","type":"apiKey","name":"userToken","in":"header"},{"id":"SupplierGuid","type":"apiKey","name":"supplierGuid","in":"header"}],"scopes":[]}],"responseCodes":["200","400","401","403","404"],"pointer":"/v1/vendors/{vendorGuid}","href":"vendors/getvendor","openApiOperationId":"getVendor","summary":"Get a customer","securityGroups":[{"ApiKey":[],"ApiSecret":[]},{"UserGuid":[],"UserToken":[],"SupplierGuid":[]}]},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/openapi","description":"Mock server","isMockServer":true},{"url":"https://owapi.orderwerks.com","description":"Production"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"The customer.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Vendor"}},"schemaId":"components/schemas/Vendor"},{"code":"400","description":"The request is malformed or references a resource the supplier does not own (for example an unknown catalog GUID).","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error"}},"schemaId":"components/schemas/Error"},{"code":"401","description":"Missing or invalid credentials.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1v1~1vendors~1{vendorGuid}/get/responses/401/content/application~1json/example"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1v1~1vendors~1{vendorGuid}/get/responses/401/content/application~1json/example"]},{"code":"403","description":"The credentials are valid but the user lacks the access level this endpoint requires.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1v1~1vendors~1{vendorGuid}/get/responses/403/content/application~1json/example"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1v1~1vendors~1{vendorGuid}/get/responses/403/content/application~1json/example"]},{"code":"404","description":"No resource with that GUID is visible to the authenticated supplier.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error"}},"schemaId":"components/schemas/Error"}],"pointer":"/paths/~1v1~1vendors~1{vendorGuid}/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/Vendor","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Vendor"}}},{"code":"400","schemaId":"components/schemas/Error","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error"}}},{"code":"401","schemaId":"components/schemas/Error","exampleIds":["paths/~1v1~1vendors~1{vendorGuid}/get/responses/401/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1v1~1vendors~1{vendorGuid}/get/responses/401/content/application~1json/example"]}}},{"code":"403","schemaId":"components/schemas/Error","exampleIds":["paths/~1v1~1vendors~1{vendorGuid}/get/responses/403/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1v1~1vendors~1{vendorGuid}/get/responses/403/content/application~1json/example"]}}},{"code":"404","schemaId":"components/schemas/Error","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/vendors/getvendor"}],"panels":[]}]},"httpPath":"/v1/vendors/{vendorGuid}"},{"label":"Update a customer","deprecated":false,"httpVerb":"put","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/vendors/updatevendor","routeSlug":"/openapi/vendors/updatevendor","metadata":{"seo":{"title":"Update a customer","description":"Updates a customer's name, email, addresses and settings. name and email are required; everything else isoptional and left unchanged when omitted."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"updateVendor","name":"Update a customer","isWebhook":false,"pointer":"/paths/~1v1~1vendors~1{vendorGuid}/put","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Update a customer","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Updates a customer's name, email, addresses and settings. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"email"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" are required; everything else is"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"optional and left unchanged when omitted."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Accepts user session headers only. Contact support to request API key access for this endpoint."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"UserGuid","scopes":[],"type":"apiKey","in":"header","paramName":"userGuid","description":"GUID of the authenticated user (user session headers)."},{"name":"UserToken","scopes":[],"type":"apiKey","in":"header","paramName":"userToken","description":"JWT issued to the user at login (user session headers)."},{"name":"SupplierGuid","scopes":[],"type":"apiKey","in":"header","paramName":"supplierGuid","description":"GUID of the supplier account the user is acting in (user session headers)."}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"vendorGuid","in":"path","schemaId":"schema_28","description":"GUID of the customer (vendor).","required":true}],"pointer":"/paths/~1v1~1vendors~1{vendorGuid}/put/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/UpdateVendorRequest","exampleIds":["paths/~1v1~1vendors~1{vendorGuid}/put/requestBody/content/application~1json/example"]}},"schemaId":"components/schemas/UpdateVendorRequest","exampleIds":["paths/~1v1~1vendors~1{vendorGuid}/put/requestBody/content/application~1json/example"],"pointer":"/paths/~1v1~1vendors~1{vendorGuid}/put/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PUT","path":"/v1/vendors/{vendorGuid}","servers":[{"url":"/_mock/openapi","description":"Mock server","isMockServer":true},{"url":"https://owapi.orderwerks.com","description":"Production"}],"parameters":{"path":[{"name":"vendorGuid","in":"path","required":true,"schemaId":"schema_28"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"UserGuid","type":"apiKey","name":"userGuid","in":"header"},{"id":"UserToken","type":"apiKey","name":"userToken","in":"header"},{"id":"SupplierGuid","type":"apiKey","name":"supplierGuid","in":"header"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/UpdateVendorRequest","exampleIds":["paths/~1v1~1vendors~1{vendorGuid}/put/requestBody/content/application~1json/example"]}},"responseCodes":["200","400","401","403"],"pointer":"/v1/vendors/{vendorGuid}","href":"vendors/updatevendor","openApiOperationId":"updateVendor","summary":"Update a customer"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/openapi","description":"Mock server","isMockServer":true},{"url":"https://owapi.orderwerks.com","description":"Production"}],"schemaId":"components/schemas/UpdateVendorRequest","exampleIds":["paths/~1v1~1vendors~1{vendorGuid}/put/requestBody/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/UpdateVendorRequest","exampleIds":["paths/~1v1~1vendors~1{vendorGuid}/put/requestBody/content/application~1json/example"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"The updated customer.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_29"}},"schemaId":"schema_29"},{"code":"400","description":"The request is malformed or references a resource the supplier does not own (for example an unknown catalog GUID).","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error"}},"schemaId":"components/schemas/Error"},{"code":"401","description":"Missing or invalid credentials.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1v1~1vendors~1{vendorGuid}/put/responses/401/content/application~1json/example"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1v1~1vendors~1{vendorGuid}/put/responses/401/content/application~1json/example"]},{"code":"403","description":"The credentials are valid but the user lacks the access level this endpoint requires.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1v1~1vendors~1{vendorGuid}/put/responses/403/content/application~1json/example"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1v1~1vendors~1{vendorGuid}/put/responses/403/content/application~1json/example"]}],"pointer":"/paths/~1v1~1vendors~1{vendorGuid}/put/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_29","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_29"}}},{"code":"400","schemaId":"components/schemas/Error","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error"}}},{"code":"401","schemaId":"components/schemas/Error","exampleIds":["paths/~1v1~1vendors~1{vendorGuid}/put/responses/401/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1v1~1vendors~1{vendorGuid}/put/responses/401/content/application~1json/example"]}}},{"code":"403","schemaId":"components/schemas/Error","exampleIds":["paths/~1v1~1vendors~1{vendorGuid}/put/responses/403/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1v1~1vendors~1{vendorGuid}/put/responses/403/content/application~1json/example"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/vendors/updatevendor"}],"panels":[]}]},"httpPath":"/v1/vendors/{vendorGuid}"}],"content":{"contentType":"group","meta":{"name":"Vendors"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Vendors","showPageActions":true},{"nodeType":"markdoc","content":"Customers of the supplier (called vendors, accounts or customers in the Orderwerks apps). A vendor\ncarries its billing and shipping addresses, price group, payment terms and integration identifiers."}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/vendors","summary":"List customers","prefix":{"name":"get","color":"get"},"badges":[],"link":"/vendors/listvendors","deprecated":false},{"title":"/vendors","summary":"Create a customer","prefix":{"name":"post","color":"post"},"badges":[],"link":"/vendors/createvendor","deprecated":false},{"title":"/v1/vendors/{vendorGuid}","summary":"Get a customer","prefix":{"name":"get","color":"get"},"badges":[],"link":"/vendors/getvendor","deprecated":false},{"title":"/v1/vendors/{vendorGuid}","summary":"Update a customer","prefix":{"name":"put","color":"put"},"badges":[],"link":"/vendors/updatevendor","deprecated":false}]}]}]}]}},{"type":"separator","label":"Catalog","content":null},{"type":"group","label":"Catalogs","link":"/openapi/catalogs","routeSlug":"/openapi/catalogs","items":[{"label":"List catalogs","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/catalogs/listcatalogs","routeSlug":"/openapi/catalogs/listcatalogs","metadata":{"seo":{"title":"List catalogs","description":"Returns the catalogs visible to the caller. Supplier users see every catalog; a customer context (vendorGuid)narrows the list to the catalogs that customer may order from."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"listCatalogs","name":"List catalogs","isWebhook":false,"pointer":"/paths/~1v1~1catalogs/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List catalogs","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Returns the catalogs visible to the caller. Supplier users see every catalog; a customer context ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"vendorGuid"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"narrows the list to the catalogs that customer may order from."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"ApiKey","scopes":[],"type":"apiKey","in":"header","paramName":"x-apiKey","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Supplier API key. Always sent together with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"x-apiSecret"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"name":"ApiSecret","scopes":[],"type":"apiKey","in":"header","paramName":"x-apiSecret","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Supplier API secret. Always sent together with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"x-apiKey"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]}]},{"schemes":[{"name":"UserGuid","scopes":[],"type":"apiKey","in":"header","paramName":"userGuid","description":"GUID of the authenticated user (user session headers)."},{"name":"UserToken","scopes":[],"type":"apiKey","in":"header","paramName":"userToken","description":"JWT issued to the user at login (user session headers)."},{"name":"SupplierGuid","scopes":[],"type":"apiKey","in":"header","paramName":"supplierGuid","description":"GUID of the supplier account the user is acting in (user session headers)."}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"vendorGuid","in":"query","schemaId":"schema_28","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Customer context, as an alternative to the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"vendorGuid"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" header."},"children":[]}]}]}]},{"name":"onlyActive","in":"query","schemaId":"schema_26","description":"Return active catalogs only."},{"name":"checkIfHasCategories","in":"query","schemaId":"schema_26","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Also return "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"catalogsDetails"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" with a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"hasCategories"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" flag per catalog."},"children":[]}]}]}]},{"name":"includeDeletedPriceGroups","in":"query","schemaId":"schema_26","description":"Include soft-deleted price groups under each catalog."}],"pointer":"/paths/~1v1~1catalogs/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"vendorGuid","in":"header","schemaId":"schema_28","description":"GUID of the customer (vendor) to act for. With API key authentication this selects the customer context; with user session headers it is the vendor the user is acting on behalf of."}],"pointer":"/paths/~1v1~1catalogs/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/v1/catalogs","servers":[{"url":"/_mock/openapi","description":"Mock server","isMockServer":true},{"url":"https://owapi.orderwerks.com","description":"Production"}],"parameters":{"path":[],"query":[{"name":"vendorGuid","in":"query","schemaId":"schema_28"},{"name":"onlyActive","in":"query","schemaId":"schema_26"},{"name":"checkIfHasCategories","in":"query","schemaId":"schema_26"},{"name":"includeDeletedPriceGroups","in":"query","schemaId":"schema_26"}],"querystring":[],"header":[{"name":"vendorGuid","in":"header","required":false,"schemaId":"schema_28"}],"cookie":[]},"security":[{"schemes":[{"id":"ApiKey","type":"apiKey","name":"x-apiKey","in":"header"},{"id":"ApiSecret","type":"apiKey","name":"x-apiSecret","in":"header"}],"scopes":[]},{"schemes":[{"id":"UserGuid","type":"apiKey","name":"userGuid","in":"header"},{"id":"UserToken","type":"apiKey","name":"userToken","in":"header"},{"id":"SupplierGuid","type":"apiKey","name":"supplierGuid","in":"header"}],"scopes":[]}],"responseCodes":["200","400","401","403"],"pointer":"/v1/catalogs","href":"catalogs/listcatalogs","openApiOperationId":"listCatalogs","summary":"List catalogs","securityGroups":[{"ApiKey":[],"ApiSecret":[]},{"UserGuid":[],"UserToken":[],"SupplierGuid":[]}]},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/openapi","description":"Mock server","isMockServer":true},{"url":"https://owapi.orderwerks.com","description":"Production"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"The catalogs.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_30"}},"schemaId":"schema_30"},{"code":"400","description":"The request is malformed or references a resource the supplier does not own (for example an unknown catalog GUID).","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error"}},"schemaId":"components/schemas/Error"},{"code":"401","description":"Missing or invalid credentials.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1v1~1catalogs/get/responses/401/content/application~1json/example"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1v1~1catalogs/get/responses/401/content/application~1json/example"]},{"code":"403","description":"The credentials are valid but the user lacks the access level this endpoint requires.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1v1~1catalogs/get/responses/403/content/application~1json/example"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1v1~1catalogs/get/responses/403/content/application~1json/example"]}],"pointer":"/paths/~1v1~1catalogs/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_30","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_30"}}},{"code":"400","schemaId":"components/schemas/Error","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error"}}},{"code":"401","schemaId":"components/schemas/Error","exampleIds":["paths/~1v1~1catalogs/get/responses/401/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1v1~1catalogs/get/responses/401/content/application~1json/example"]}}},{"code":"403","schemaId":"components/schemas/Error","exampleIds":["paths/~1v1~1catalogs/get/responses/403/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1v1~1catalogs/get/responses/403/content/application~1json/example"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/catalogs/listcatalogs"}],"panels":[]}]},"httpPath":"/v1/catalogs"}],"content":{"contentType":"group","meta":{"name":"Catalogs"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Catalogs","showPageActions":true},{"nodeType":"markdoc","content":"A catalog is a priced product list. Every catalog item, price group and order belongs to one catalog."}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/v1/catalogs","summary":"List catalogs","prefix":{"name":"get","color":"get"},"badges":[],"link":"/catalogs/listcatalogs","deprecated":false}]}]}]}]}},{"type":"group","label":"Catalog Items","link":"/openapi/catalog-items","routeSlug":"/openapi/catalog-items","items":[{"label":"List catalog items","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/catalog-items/listcatalogitems","routeSlug":"/openapi/catalog-items/listcatalogitems","metadata":{"seo":{"title":"List catalog items","description":"Paged list of the items in a catalog. With API key authentication each item carries the fixed field set shownin the schema; with user session headers the full item model is returned."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"listCatalogItems","name":"List catalog items","isWebhook":false,"pointer":"/paths/~1v1~1catalog~1{catalogGuid}~1catalog_items/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List catalog items","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Paged list of the items in a catalog. With API key authentication each item carries the fixed field set shown"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"in the schema; with user session headers the full item model is returned."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Supports delta sync: pass the returned "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"serverTimestamp"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" back as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"lastUpdatedAt"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to receive only items created,"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"updated or deleted since then (deleted items carry "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"deleted_at"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"ApiKey","scopes":[],"type":"apiKey","in":"header","paramName":"x-apiKey","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Supplier API key. Always sent together with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"x-apiSecret"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"name":"ApiSecret","scopes":[],"type":"apiKey","in":"header","paramName":"x-apiSecret","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Supplier API secret. Always sent together with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"x-apiKey"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]}]},{"schemes":[{"name":"UserGuid","scopes":[],"type":"apiKey","in":"header","paramName":"userGuid","description":"GUID of the authenticated user (user session headers)."},{"name":"UserToken","scopes":[],"type":"apiKey","in":"header","paramName":"userToken","description":"JWT issued to the user at login (user session headers)."},{"name":"SupplierGuid","scopes":[],"type":"apiKey","in":"header","paramName":"supplierGuid","description":"GUID of the supplier account the user is acting in (user session headers)."}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"catalogGuid","in":"path","schemaId":"schema_28","description":"GUID of the catalog. Must belong to the authenticated supplier.","required":true}],"pointer":"/paths/~1v1~1catalog~1{catalogGuid}~1catalog_items/get/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"limit","in":"query","schemaId":"schema_22","description":"Number of rows per page."},{"name":"offset","in":"query","schemaId":"schema_23","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Zero-based "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"page number"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". The server skips "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"offset * limit"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" rows."},"children":[]}]}]}]},{"name":"lastUpdatedAt","in":"query","schemaId":"schema_24","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Delta-sync cursor. Pass the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"serverTimestamp"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" returned by the previous call to receive only rows created, updated or soft-deleted since then (deleted rows carry "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"deleted_at"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"). Accepts ISO-8601 ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"2026-09-01T14:00:00.000Z"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":") or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"YYYY-MM-DD HH:mm:ss"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (treated as UTC). The server re-fetches a 60-second overlap window to absorb clock skew. An unparsable value returns "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"code: INVALID_DELTA_CURSOR"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"name":"skipTotalCount","in":"query","schemaId":"schema_26","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Skip the total count query; "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"totalCatalogItems"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is then 0. Faster for large catalogs."},"children":[]}]}]}]},{"name":"skipCategoryRetrieval","in":"query","schemaId":"schema_26","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Do not attach "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Category"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" / "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"CategoryHierarchy"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to each item."},"children":[]}]}]}]},{"name":"includeAttributes","in":"query","schemaId":"schema_26","description":"Include item attributes."}],"pointer":"/paths/~1v1~1catalog~1{catalogGuid}~1catalog_items/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"vendorGuid","in":"header","schemaId":"schema_28","description":"GUID of the customer (vendor) to act for. With API key authentication this selects the customer context; with user session headers it is the vendor the user is acting on behalf of."}],"pointer":"/paths/~1v1~1catalog~1{catalogGuid}~1catalog_items/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/v1/catalog/{catalogGuid}/catalog_items","servers":[{"url":"/_mock/openapi","description":"Mock server","isMockServer":true},{"url":"https://owapi.orderwerks.com","description":"Production"}],"parameters":{"path":[{"name":"catalogGuid","in":"path","required":true,"schemaId":"schema_28"}],"query":[{"name":"limit","in":"query","required":false,"schemaId":"schema_22"},{"name":"offset","in":"query","required":false,"schemaId":"schema_23"},{"name":"lastUpdatedAt","in":"query","required":false,"example":"2026-09-01T14:00:00.000Z","schemaId":"schema_24"},{"name":"skipTotalCount","in":"query","schemaId":"schema_26"},{"name":"skipCategoryRetrieval","in":"query","schemaId":"schema_26"},{"name":"includeAttributes","in":"query","schemaId":"schema_26"}],"querystring":[],"header":[{"name":"vendorGuid","in":"header","required":false,"schemaId":"schema_28"}],"cookie":[]},"security":[{"schemes":[{"id":"ApiKey","type":"apiKey","name":"x-apiKey","in":"header"},{"id":"ApiSecret","type":"apiKey","name":"x-apiSecret","in":"header"}],"scopes":[]},{"schemes":[{"id":"UserGuid","type":"apiKey","name":"userGuid","in":"header"},{"id":"UserToken","type":"apiKey","name":"userToken","in":"header"},{"id":"SupplierGuid","type":"apiKey","name":"supplierGuid","in":"header"}],"scopes":[]}],"responseCodes":["200","400","401","403","500"],"pointer":"/v1/catalog/{catalogGuid}/catalog_items","href":"catalog-items/listcatalogitems","openApiOperationId":"listCatalogItems","summary":"List catalog items","securityGroups":[{"ApiKey":[],"ApiSecret":[]},{"UserGuid":[],"UserToken":[],"SupplierGuid":[]}]},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/openapi","description":"Mock server","isMockServer":true},{"url":"https://owapi.orderwerks.com","description":"Production"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"A page of catalog items.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/CatalogItemsPage"}},"schemaId":"components/schemas/CatalogItemsPage"},{"code":"400","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Unknown catalog GUID, or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"code"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"INVALID_DELTA_CURSOR"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" when "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"lastUpdatedAt"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" cannot be parsed."},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error"}},"schemaId":"components/schemas/Error"},{"code":"401","description":"Missing or invalid credentials.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1v1~1catalog~1{catalogGuid}~1catalog_items/get/responses/401/content/application~1json/example"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1v1~1catalog~1{catalogGuid}~1catalog_items/get/responses/401/content/application~1json/example"]},{"code":"403","description":"The credentials are valid but the user lacks the access level this endpoint requires.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1v1~1catalog~1{catalogGuid}~1catalog_items/get/responses/403/content/application~1json/example"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1v1~1catalog~1{catalogGuid}~1catalog_items/get/responses/403/content/application~1json/example"]},{"code":"500","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Unexpected server error. Some legacy endpoints return the message as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"text/plain"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" instead of JSON."},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json","text/plain"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error"},"text/plain":{"schemaId":"schema_25"}},"schemaId":"components/schemas/Error"}],"pointer":"/paths/~1v1~1catalog~1{catalogGuid}~1catalog_items/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/CatalogItemsPage","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/CatalogItemsPage"}}},{"code":"400","schemaId":"components/schemas/Error","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error"}}},{"code":"401","schemaId":"components/schemas/Error","exampleIds":["paths/~1v1~1catalog~1{catalogGuid}~1catalog_items/get/responses/401/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1v1~1catalog~1{catalogGuid}~1catalog_items/get/responses/401/content/application~1json/example"]}}},{"code":"403","schemaId":"components/schemas/Error","exampleIds":["paths/~1v1~1catalog~1{catalogGuid}~1catalog_items/get/responses/403/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1v1~1catalog~1{catalogGuid}~1catalog_items/get/responses/403/content/application~1json/example"]}}},{"code":"500","schemaId":"components/schemas/Error","mediaTypes":["application/json","text/plain"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error"},"text/plain":{"schemaId":"schema_25"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/catalog-items/listcatalogitems"}],"panels":[]}]},"httpPath":"/v1/catalog/{catalogGuid}/catalog_items"},{"label":"Get a catalog item","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/catalog-items/getcatalogitem","routeSlug":"/openapi/catalog-items/getcatalogitem","metadata":{"seo":{"title":"Get a catalog item","description":"Returns one catalog item with its category, attachments, options and attributes."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getCatalogItem","name":"Get a catalog item","isWebhook":false,"pointer":"/paths/~1v1~1catalog~1{catalogGuid}~1catalog_items~1{catalogItemGuid}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get a catalog item","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Returns one catalog item with its category, attachments, options and attributes."},{"nodeType":"security","requirements":[{"schemes":[{"name":"ApiKey","scopes":[],"type":"apiKey","in":"header","paramName":"x-apiKey","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Supplier API key. Always sent together with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"x-apiSecret"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"name":"ApiSecret","scopes":[],"type":"apiKey","in":"header","paramName":"x-apiSecret","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Supplier API secret. Always sent together with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"x-apiKey"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]}]},{"schemes":[{"name":"UserGuid","scopes":[],"type":"apiKey","in":"header","paramName":"userGuid","description":"GUID of the authenticated user (user session headers)."},{"name":"UserToken","scopes":[],"type":"apiKey","in":"header","paramName":"userToken","description":"JWT issued to the user at login (user session headers)."},{"name":"SupplierGuid","scopes":[],"type":"apiKey","in":"header","paramName":"supplierGuid","description":"GUID of the supplier account the user is acting in (user session headers)."}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"catalogGuid","in":"path","schemaId":"schema_28","description":"GUID of the catalog. Must belong to the authenticated supplier.","required":true},{"name":"catalogItemGuid","in":"path","schemaId":"schema_28","description":"GUID of the catalog item.","required":true}],"pointer":"/paths/~1v1~1catalog~1{catalogGuid}~1catalog_items~1{catalogItemGuid}/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"vendorGuid","in":"header","schemaId":"schema_28","description":"GUID of the customer (vendor) to act for. With API key authentication this selects the customer context; with user session headers it is the vendor the user is acting on behalf of."}],"pointer":"/paths/~1v1~1catalog~1{catalogGuid}~1catalog_items~1{catalogItemGuid}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/v1/catalog/{catalogGuid}/catalog_items/{catalogItemGuid}","servers":[{"url":"/_mock/openapi","description":"Mock server","isMockServer":true},{"url":"https://owapi.orderwerks.com","description":"Production"}],"parameters":{"path":[{"name":"catalogGuid","in":"path","required":true,"schemaId":"schema_28"},{"name":"catalogItemGuid","in":"path","required":true,"schemaId":"schema_28"}],"query":[],"querystring":[],"header":[{"name":"vendorGuid","in":"header","required":false,"schemaId":"schema_28"}],"cookie":[]},"security":[{"schemes":[{"id":"ApiKey","type":"apiKey","name":"x-apiKey","in":"header"},{"id":"ApiSecret","type":"apiKey","name":"x-apiSecret","in":"header"}],"scopes":[]},{"schemes":[{"id":"UserGuid","type":"apiKey","name":"userGuid","in":"header"},{"id":"UserToken","type":"apiKey","name":"userToken","in":"header"},{"id":"SupplierGuid","type":"apiKey","name":"supplierGuid","in":"header"}],"scopes":[]}],"responseCodes":["200","400","401","403","404","500"],"pointer":"/v1/catalog/{catalogGuid}/catalog_items/{catalogItemGuid}","href":"catalog-items/getcatalogitem","openApiOperationId":"getCatalogItem","summary":"Get a catalog item","securityGroups":[{"ApiKey":[],"ApiSecret":[]},{"UserGuid":[],"UserToken":[],"SupplierGuid":[]}]},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/openapi","description":"Mock server","isMockServer":true},{"url":"https://owapi.orderwerks.com","description":"Production"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"The catalog item.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_31"}},"schemaId":"schema_31"},{"code":"400","description":"The request is malformed or references a resource the supplier does not own (for example an unknown catalog GUID).","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error"}},"schemaId":"components/schemas/Error"},{"code":"401","description":"Missing or invalid credentials.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1v1~1catalog~1{catalogGuid}~1catalog_items~1{catalogItemGuid}/get/responses/401/content/application~1json/example"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1v1~1catalog~1{catalogGuid}~1catalog_items~1{catalogItemGuid}/get/responses/401/content/application~1json/example"]},{"code":"403","description":"The credentials are valid but the user lacks the access level this endpoint requires.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1v1~1catalog~1{catalogGuid}~1catalog_items~1{catalogItemGuid}/get/responses/403/content/application~1json/example"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1v1~1catalog~1{catalogGuid}~1catalog_items~1{catalogItemGuid}/get/responses/403/content/application~1json/example"]},{"code":"404","description":"No resource with that GUID is visible to the authenticated supplier.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error"}},"schemaId":"components/schemas/Error"},{"code":"500","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Unexpected server error. Some legacy endpoints return the message as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"text/plain"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" instead of JSON."},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json","text/plain"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error"},"text/plain":{"schemaId":"schema_25"}},"schemaId":"components/schemas/Error"}],"pointer":"/paths/~1v1~1catalog~1{catalogGuid}~1catalog_items~1{catalogItemGuid}/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_31","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_31"}}},{"code":"400","schemaId":"components/schemas/Error","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error"}}},{"code":"401","schemaId":"components/schemas/Error","exampleIds":["paths/~1v1~1catalog~1{catalogGuid}~1catalog_items~1{catalogItemGuid}/get/responses/401/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1v1~1catalog~1{catalogGuid}~1catalog_items~1{catalogItemGuid}/get/responses/401/content/application~1json/example"]}}},{"code":"403","schemaId":"components/schemas/Error","exampleIds":["paths/~1v1~1catalog~1{catalogGuid}~1catalog_items~1{catalogItemGuid}/get/responses/403/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1v1~1catalog~1{catalogGuid}~1catalog_items~1{catalogItemGuid}/get/responses/403/content/application~1json/example"]}}},{"code":"404","schemaId":"components/schemas/Error","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error"}}},{"code":"500","schemaId":"components/schemas/Error","mediaTypes":["application/json","text/plain"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error"},"text/plain":{"schemaId":"schema_25"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/catalog-items/getcatalogitem"}],"panels":[]}]},"httpPath":"/v1/catalog/{catalogGuid}/catalog_items/{catalogItemGuid}"},{"label":"Get catalog items by ids or GUIDs","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/catalog-items/getcatalogitemsbybatch","routeSlug":"/openapi/catalog-items/getcatalogitemsbybatch","metadata":{"seo":{"title":"Get catalog items by ids or GUIDs","description":"Returns the requested items in one call. Unknown ids are skipped, not reported."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getCatalogItemsByBatch","name":"Get catalog items by ids or GUIDs","isWebhook":false,"pointer":"/paths/~1v1~1catalog~1{catalogGuid}~1catalog_items~1batch/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get catalog items by ids or GUIDs","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Returns the requested items in one call. Unknown ids are skipped, not reported."},{"nodeType":"security","requirements":[{"schemes":[{"name":"ApiKey","scopes":[],"type":"apiKey","in":"header","paramName":"x-apiKey","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Supplier API key. Always sent together with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"x-apiSecret"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"name":"ApiSecret","scopes":[],"type":"apiKey","in":"header","paramName":"x-apiSecret","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Supplier API secret. Always sent together with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"x-apiKey"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]}]},{"schemes":[{"name":"UserGuid","scopes":[],"type":"apiKey","in":"header","paramName":"userGuid","description":"GUID of the authenticated user (user session headers)."},{"name":"UserToken","scopes":[],"type":"apiKey","in":"header","paramName":"userToken","description":"JWT issued to the user at login (user session headers)."},{"name":"SupplierGuid","scopes":[],"type":"apiKey","in":"header","paramName":"supplierGuid","description":"GUID of the supplier account the user is acting in (user session headers)."}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"catalogGuid","in":"path","schemaId":"schema_28","description":"GUID of the catalog. Must belong to the authenticated supplier.","required":true}],"pointer":"/paths/~1v1~1catalog~1{catalogGuid}~1catalog_items~1batch/post/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"vendorGuid","in":"header","schemaId":"schema_28","description":"GUID of the customer (vendor) to act for. With API key authentication this selects the customer context; with user session headers it is the vendor the user is acting on behalf of."}],"pointer":"/paths/~1v1~1catalog~1{catalogGuid}~1catalog_items~1batch/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/BatchRequest"}},"schemaId":"components/schemas/BatchRequest","pointer":"/paths/~1v1~1catalog~1{catalogGuid}~1catalog_items~1batch/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/v1/catalog/{catalogGuid}/catalog_items/batch","servers":[{"url":"/_mock/openapi","description":"Mock server","isMockServer":true},{"url":"https://owapi.orderwerks.com","description":"Production"}],"parameters":{"path":[{"name":"catalogGuid","in":"path","required":true,"schemaId":"schema_28"}],"query":[],"querystring":[],"header":[{"name":"vendorGuid","in":"header","required":false,"schemaId":"schema_28"}],"cookie":[]},"security":[{"schemes":[{"id":"ApiKey","type":"apiKey","name":"x-apiKey","in":"header"},{"id":"ApiSecret","type":"apiKey","name":"x-apiSecret","in":"header"}],"scopes":[]},{"schemes":[{"id":"UserGuid","type":"apiKey","name":"userGuid","in":"header"},{"id":"UserToken","type":"apiKey","name":"userToken","in":"header"},{"id":"SupplierGuid","type":"apiKey","name":"supplierGuid","in":"header"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/BatchRequest"}},"responseCodes":["200","400","401","403","500"],"pointer":"/v1/catalog/{catalogGuid}/catalog_items/batch","href":"catalog-items/getcatalogitemsbybatch","openApiOperationId":"getCatalogItemsByBatch","summary":"Get catalog items by ids or GUIDs","securityGroups":[{"ApiKey":[],"ApiSecret":[]},{"UserGuid":[],"UserToken":[],"SupplierGuid":[]}]},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/openapi","description":"Mock server","isMockServer":true},{"url":"https://owapi.orderwerks.com","description":"Production"}],"schemaId":"components/schemas/BatchRequest","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/BatchRequest"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"The matching catalog items.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_32"}},"schemaId":"schema_32"},{"code":"400","description":"The request is malformed or references a resource the supplier does not own (for example an unknown catalog GUID).","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error"}},"schemaId":"components/schemas/Error"},{"code":"401","description":"Missing or invalid credentials.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1v1~1catalog~1{catalogGuid}~1catalog_items~1batch/post/responses/401/content/application~1json/example"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1v1~1catalog~1{catalogGuid}~1catalog_items~1batch/post/responses/401/content/application~1json/example"]},{"code":"403","description":"The credentials are valid but the user lacks the access level this endpoint requires.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1v1~1catalog~1{catalogGuid}~1catalog_items~1batch/post/responses/403/content/application~1json/example"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1v1~1catalog~1{catalogGuid}~1catalog_items~1batch/post/responses/403/content/application~1json/example"]},{"code":"500","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Unexpected server error. Some legacy endpoints return the message as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"text/plain"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" instead of JSON."},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json","text/plain"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error"},"text/plain":{"schemaId":"schema_25"}},"schemaId":"components/schemas/Error"}],"pointer":"/paths/~1v1~1catalog~1{catalogGuid}~1catalog_items~1batch/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_32","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_32"}}},{"code":"400","schemaId":"components/schemas/Error","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error"}}},{"code":"401","schemaId":"components/schemas/Error","exampleIds":["paths/~1v1~1catalog~1{catalogGuid}~1catalog_items~1batch/post/responses/401/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1v1~1catalog~1{catalogGuid}~1catalog_items~1batch/post/responses/401/content/application~1json/example"]}}},{"code":"403","schemaId":"components/schemas/Error","exampleIds":["paths/~1v1~1catalog~1{catalogGuid}~1catalog_items~1batch/post/responses/403/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1v1~1catalog~1{catalogGuid}~1catalog_items~1batch/post/responses/403/content/application~1json/example"]}}},{"code":"500","schemaId":"components/schemas/Error","mediaTypes":["application/json","text/plain"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error"},"text/plain":{"schemaId":"schema_25"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/catalog-items/getcatalogitemsbybatch"}],"panels":[]}]},"httpPath":"/v1/catalog/{catalogGuid}/catalog_items/batch"},{"label":"Search catalog items","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/catalog-items/searchcatalogitems","routeSlug":"/openapi/catalog-items/searchcatalogitems","metadata":{"seo":{"title":"Search catalog items","description":"Full-text search over a catalog (name, SKU, description, UPC) with optional category, price-group and attributefilters. This is the endpoint the order-entry screens use."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"searchCatalogItems","name":"Search catalog items","isWebhook":false,"pointer":"/paths/~1v1~1catalog~1{catalogGuid}~1catalog_items~1typeahead/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Search catalog items","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Full-text search over a catalog (name, SKU, description, UPC) with optional category, price-group and attribute"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"filters. This is the endpoint the order-entry screens use."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"priceGroupGuid"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"orderGuid"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is given, items not offered to that price group are excluded and each"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"item's "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"pricing"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is reduced to that single price. A 12-digit numeric "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" performs a UPC lookup instead of a"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"text search."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"ApiKey","scopes":[],"type":"apiKey","in":"header","paramName":"x-apiKey","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Supplier API key. Always sent together with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"x-apiSecret"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"name":"ApiSecret","scopes":[],"type":"apiKey","in":"header","paramName":"x-apiSecret","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Supplier API secret. Always sent together with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"x-apiKey"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]}]},{"schemes":[{"name":"UserGuid","scopes":[],"type":"apiKey","in":"header","paramName":"userGuid","description":"GUID of the authenticated user (user session headers)."},{"name":"UserToken","scopes":[],"type":"apiKey","in":"header","paramName":"userToken","description":"JWT issued to the user at login (user session headers)."},{"name":"SupplierGuid","scopes":[],"type":"apiKey","in":"header","paramName":"supplierGuid","description":"GUID of the supplier account the user is acting in (user session headers)."}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"catalogGuid","in":"path","schemaId":"schema_28","description":"GUID of the catalog. Must belong to the authenticated supplier.","required":true}],"pointer":"/paths/~1v1~1catalog~1{catalogGuid}~1catalog_items~1typeahead/post/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"vendorGuid","in":"header","schemaId":"schema_28","description":"GUID of the customer (vendor) to act for. With API key authentication this selects the customer context; with user session headers it is the vendor the user is acting on behalf of."}],"pointer":"/paths/~1v1~1catalog~1{catalogGuid}~1catalog_items~1typeahead/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/TypeaheadRequest","exampleIds":["paths/~1v1~1catalog~1{catalogGuid}~1catalog_items~1typeahead/post/requestBody/content/application~1json/example"]}},"schemaId":"components/schemas/TypeaheadRequest","exampleIds":["paths/~1v1~1catalog~1{catalogGuid}~1catalog_items~1typeahead/post/requestBody/content/application~1json/example"],"pointer":"/paths/~1v1~1catalog~1{catalogGuid}~1catalog_items~1typeahead/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/v1/catalog/{catalogGuid}/catalog_items/typeahead","servers":[{"url":"/_mock/openapi","description":"Mock server","isMockServer":true},{"url":"https://owapi.orderwerks.com","description":"Production"}],"parameters":{"path":[{"name":"catalogGuid","in":"path","required":true,"schemaId":"schema_28"}],"query":[],"querystring":[],"header":[{"name":"vendorGuid","in":"header","required":false,"schemaId":"schema_28"}],"cookie":[]},"security":[{"schemes":[{"id":"ApiKey","type":"apiKey","name":"x-apiKey","in":"header"},{"id":"ApiSecret","type":"apiKey","name":"x-apiSecret","in":"header"}],"scopes":[]},{"schemes":[{"id":"UserGuid","type":"apiKey","name":"userGuid","in":"header"},{"id":"UserToken","type":"apiKey","name":"userToken","in":"header"},{"id":"SupplierGuid","type":"apiKey","name":"supplierGuid","in":"header"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/TypeaheadRequest","exampleIds":["paths/~1v1~1catalog~1{catalogGuid}~1catalog_items~1typeahead/post/requestBody/content/application~1json/example"]}},"responseCodes":["200","400","401","403","500"],"pointer":"/v1/catalog/{catalogGuid}/catalog_items/typeahead","href":"catalog-items/searchcatalogitems","openApiOperationId":"searchCatalogItems","summary":"Search catalog items","securityGroups":[{"ApiKey":[],"ApiSecret":[]},{"UserGuid":[],"UserToken":[],"SupplierGuid":[]}]},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/openapi","description":"Mock server","isMockServer":true},{"url":"https://owapi.orderwerks.com","description":"Production"}],"schemaId":"components/schemas/TypeaheadRequest","exampleIds":["paths/~1v1~1catalog~1{catalogGuid}~1catalog_items~1typeahead/post/requestBody/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/TypeaheadRequest","exampleIds":["paths/~1v1~1catalog~1{catalogGuid}~1catalog_items~1typeahead/post/requestBody/content/application~1json/example"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Matching catalog items.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/TypeaheadResponse"}},"schemaId":"components/schemas/TypeaheadResponse"},{"code":"400","description":"The request is malformed or references a resource the supplier does not own (for example an unknown catalog GUID).","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error"}},"schemaId":"components/schemas/Error"},{"code":"401","description":"Missing or invalid credentials.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1v1~1catalog~1{catalogGuid}~1catalog_items~1typeahead/post/responses/401/content/application~1json/example"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1v1~1catalog~1{catalogGuid}~1catalog_items~1typeahead/post/responses/401/content/application~1json/example"]},{"code":"403","description":"The credentials are valid but the user lacks the access level this endpoint requires.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1v1~1catalog~1{catalogGuid}~1catalog_items~1typeahead/post/responses/403/content/application~1json/example"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1v1~1catalog~1{catalogGuid}~1catalog_items~1typeahead/post/responses/403/content/application~1json/example"]},{"code":"500","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Unexpected server error. Some legacy endpoints return the message as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"text/plain"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" instead of JSON."},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json","text/plain"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error"},"text/plain":{"schemaId":"schema_25"}},"schemaId":"components/schemas/Error"}],"pointer":"/paths/~1v1~1catalog~1{catalogGuid}~1catalog_items~1typeahead/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/TypeaheadResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/TypeaheadResponse"}}},{"code":"400","schemaId":"components/schemas/Error","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error"}}},{"code":"401","schemaId":"components/schemas/Error","exampleIds":["paths/~1v1~1catalog~1{catalogGuid}~1catalog_items~1typeahead/post/responses/401/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1v1~1catalog~1{catalogGuid}~1catalog_items~1typeahead/post/responses/401/content/application~1json/example"]}}},{"code":"403","schemaId":"components/schemas/Error","exampleIds":["paths/~1v1~1catalog~1{catalogGuid}~1catalog_items~1typeahead/post/responses/403/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1v1~1catalog~1{catalogGuid}~1catalog_items~1typeahead/post/responses/403/content/application~1json/example"]}}},{"code":"500","schemaId":"components/schemas/Error","mediaTypes":["application/json","text/plain"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error"},"text/plain":{"schemaId":"schema_25"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/catalog-items/searchcatalogitems"}],"panels":[]}]},"httpPath":"/v1/catalog/{catalogGuid}/catalog_items/typeahead"},{"label":"Look up catalog items by SKU","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/catalog-items/lookupcatalogitembysku","routeSlug":"/openapi/catalog-items/lookupcatalogitembysku","metadata":{"seo":{"title":"Look up catalog items by SKU","description":"Fast exact-SKU lookup within a catalog. Returns a lightweight projection; use Get a catalog item for the full record."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"lookupCatalogItemBySku","name":"Look up catalog items by SKU","isWebhook":false,"pointer":"/paths/~1v1~1catalog_items~1sku-lookup/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Look up catalog items by SKU","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Fast exact-SKU lookup within a catalog. Returns a lightweight projection; use "},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Get a catalog item"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for the full record."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"ApiKey","scopes":[],"type":"apiKey","in":"header","paramName":"x-apiKey","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Supplier API key. Always sent together with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"x-apiSecret"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"name":"ApiSecret","scopes":[],"type":"apiKey","in":"header","paramName":"x-apiSecret","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Supplier API secret. Always sent together with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"x-apiKey"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]}]},{"schemes":[{"name":"UserGuid","scopes":[],"type":"apiKey","in":"header","paramName":"userGuid","description":"GUID of the authenticated user (user session headers)."},{"name":"UserToken","scopes":[],"type":"apiKey","in":"header","paramName":"userToken","description":"JWT issued to the user at login (user session headers)."},{"name":"SupplierGuid","scopes":[],"type":"apiKey","in":"header","paramName":"supplierGuid","description":"GUID of the supplier account the user is acting in (user session headers)."}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/SkuLookupRequest"}},"schemaId":"components/schemas/SkuLookupRequest","pointer":"/paths/~1v1~1catalog_items~1sku-lookup/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/v1/catalog_items/sku-lookup","servers":[{"url":"/_mock/openapi","description":"Mock server","isMockServer":true},{"url":"https://owapi.orderwerks.com","description":"Production"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"ApiKey","type":"apiKey","name":"x-apiKey","in":"header"},{"id":"ApiSecret","type":"apiKey","name":"x-apiSecret","in":"header"}],"scopes":[]},{"schemes":[{"id":"UserGuid","type":"apiKey","name":"userGuid","in":"header"},{"id":"UserToken","type":"apiKey","name":"userToken","in":"header"},{"id":"SupplierGuid","type":"apiKey","name":"supplierGuid","in":"header"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/SkuLookupRequest"}},"responseCodes":["200","400","401","403","500"],"pointer":"/v1/catalog_items/sku-lookup","href":"catalog-items/lookupcatalogitembysku","openApiOperationId":"lookupCatalogItemBySku","summary":"Look up catalog items by SKU","securityGroups":[{"ApiKey":[],"ApiSecret":[]},{"UserGuid":[],"UserToken":[],"SupplierGuid":[]}]},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/openapi","description":"Mock server","isMockServer":true},{"url":"https://owapi.orderwerks.com","description":"Production"}],"schemaId":"components/schemas/SkuLookupRequest","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/SkuLookupRequest"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Matching items (empty array when none).","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_33"}},"schemaId":"schema_33"},{"code":"400","description":"The request is malformed or references a resource the supplier does not own (for example an unknown catalog GUID).","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error"}},"schemaId":"components/schemas/Error"},{"code":"401","description":"Missing or invalid credentials.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1v1~1catalog_items~1sku-lookup/post/responses/401/content/application~1json/example"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1v1~1catalog_items~1sku-lookup/post/responses/401/content/application~1json/example"]},{"code":"403","description":"The credentials are valid but the user lacks the access level this endpoint requires.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1v1~1catalog_items~1sku-lookup/post/responses/403/content/application~1json/example"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1v1~1catalog_items~1sku-lookup/post/responses/403/content/application~1json/example"]},{"code":"500","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Unexpected server error. Some legacy endpoints return the message as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"text/plain"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" instead of JSON."},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json","text/plain"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error"},"text/plain":{"schemaId":"schema_25"}},"schemaId":"components/schemas/Error"}],"pointer":"/paths/~1v1~1catalog_items~1sku-lookup/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_33","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_33"}}},{"code":"400","schemaId":"components/schemas/Error","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error"}}},{"code":"401","schemaId":"components/schemas/Error","exampleIds":["paths/~1v1~1catalog_items~1sku-lookup/post/responses/401/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1v1~1catalog_items~1sku-lookup/post/responses/401/content/application~1json/example"]}}},{"code":"403","schemaId":"components/schemas/Error","exampleIds":["paths/~1v1~1catalog_items~1sku-lookup/post/responses/403/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1v1~1catalog_items~1sku-lookup/post/responses/403/content/application~1json/example"]}}},{"code":"500","schemaId":"components/schemas/Error","mediaTypes":["application/json","text/plain"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error"},"text/plain":{"schemaId":"schema_25"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/catalog-items/lookupcatalogitembysku"}],"panels":[]}]},"httpPath":"/v1/catalog_items/sku-lookup"},{"label":"List catalog items (legacy path)","deprecated":true,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/catalog-items/listcatalogitemslegacy","routeSlug":"/openapi/catalog-items/listcatalogitemslegacy","metadata":{"seo":{"title":"List catalog items (legacy path)","description":"Legacy alias of GET /v1/catalog/{catalogGuid}/catalog_items. Same parameters and response; use the new path."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"listCatalogItemsLegacy","name":"List catalog items (legacy path)","deprecated":true,"isWebhook":false,"pointer":"/paths/~1v1~1{catalogGuid}~1catalogItems/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List catalog items (legacy path)","isWebhook":false,"deprecated":true,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Legacy alias of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"GET /v1/catalog/{catalogGuid}/catalog_items"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Same parameters and response; use the new path."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"ApiKey","scopes":[],"type":"apiKey","in":"header","paramName":"x-apiKey","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Supplier API key. Always sent together with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"x-apiSecret"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"name":"ApiSecret","scopes":[],"type":"apiKey","in":"header","paramName":"x-apiSecret","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Supplier API secret. Always sent together with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"x-apiKey"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]}]},{"schemes":[{"name":"UserGuid","scopes":[],"type":"apiKey","in":"header","paramName":"userGuid","description":"GUID of the authenticated user (user session headers)."},{"name":"UserToken","scopes":[],"type":"apiKey","in":"header","paramName":"userToken","description":"JWT issued to the user at login (user session headers)."},{"name":"SupplierGuid","scopes":[],"type":"apiKey","in":"header","paramName":"supplierGuid","description":"GUID of the supplier account the user is acting in (user session headers)."}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"catalogGuid","in":"path","schemaId":"schema_28","description":"GUID of the catalog. Must belong to the authenticated supplier.","required":true}],"pointer":"/paths/~1v1~1{catalogGuid}~1catalogItems/get/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"limit","in":"query","schemaId":"schema_22","description":"Number of rows per page."},{"name":"offset","in":"query","schemaId":"schema_23","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Zero-based "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"page number"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". The server skips "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"offset * limit"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" rows."},"children":[]}]}]}]},{"name":"lastUpdatedAt","in":"query","schemaId":"schema_24","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Delta-sync cursor. Pass the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"serverTimestamp"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" returned by the previous call to receive only rows created, updated or soft-deleted since then (deleted rows carry "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"deleted_at"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"). Accepts ISO-8601 ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"2026-09-01T14:00:00.000Z"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":") or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"YYYY-MM-DD HH:mm:ss"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (treated as UTC). The server re-fetches a 60-second overlap window to absorb clock skew. An unparsable value returns "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"code: INVALID_DELTA_CURSOR"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"name":"skipTotalCount","in":"query","schemaId":"schema_26"},{"name":"skipCategoryRetrieval","in":"query","schemaId":"schema_26"},{"name":"includeAttributes","in":"query","schemaId":"schema_26"}],"pointer":"/paths/~1v1~1{catalogGuid}~1catalogItems/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"vendorGuid","in":"header","schemaId":"schema_28","description":"GUID of the customer (vendor) to act for. With API key authentication this selects the customer context; with user session headers it is the vendor the user is acting on behalf of."}],"pointer":"/paths/~1v1~1{catalogGuid}~1catalogItems/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/v1/{catalogGuid}/catalogItems","servers":[{"url":"/_mock/openapi","description":"Mock server","isMockServer":true},{"url":"https://owapi.orderwerks.com","description":"Production"}],"parameters":{"path":[{"name":"catalogGuid","in":"path","required":true,"schemaId":"schema_28"}],"query":[{"name":"limit","in":"query","required":false,"schemaId":"schema_22"},{"name":"offset","in":"query","required":false,"schemaId":"schema_23"},{"name":"lastUpdatedAt","in":"query","required":false,"example":"2026-09-01T14:00:00.000Z","schemaId":"schema_24"},{"name":"skipTotalCount","in":"query","schemaId":"schema_26"},{"name":"skipCategoryRetrieval","in":"query","schemaId":"schema_26"},{"name":"includeAttributes","in":"query","schemaId":"schema_26"}],"querystring":[],"header":[{"name":"vendorGuid","in":"header","required":false,"schemaId":"schema_28"}],"cookie":[]},"security":[{"schemes":[{"id":"ApiKey","type":"apiKey","name":"x-apiKey","in":"header"},{"id":"ApiSecret","type":"apiKey","name":"x-apiSecret","in":"header"}],"scopes":[]},{"schemes":[{"id":"UserGuid","type":"apiKey","name":"userGuid","in":"header"},{"id":"UserToken","type":"apiKey","name":"userToken","in":"header"},{"id":"SupplierGuid","type":"apiKey","name":"supplierGuid","in":"header"}],"scopes":[]}],"responseCodes":["200","400","401","403","500"],"pointer":"/v1/{catalogGuid}/catalogItems","href":"catalog-items/listcatalogitemslegacy","openApiOperationId":"listCatalogItemsLegacy","summary":"List catalog items (legacy path)","securityGroups":[{"ApiKey":[],"ApiSecret":[]},{"UserGuid":[],"UserToken":[],"SupplierGuid":[]}]},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/openapi","description":"Mock server","isMockServer":true},{"url":"https://owapi.orderwerks.com","description":"Production"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"A page of catalog items.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/CatalogItemsPage"}},"schemaId":"components/schemas/CatalogItemsPage"},{"code":"400","description":"The request is malformed or references a resource the supplier does not own (for example an unknown catalog GUID).","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error"}},"schemaId":"components/schemas/Error"},{"code":"401","description":"Missing or invalid credentials.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1v1~1{catalogGuid}~1catalogItems/get/responses/401/content/application~1json/example"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1v1~1{catalogGuid}~1catalogItems/get/responses/401/content/application~1json/example"]},{"code":"403","description":"The credentials are valid but the user lacks the access level this endpoint requires.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1v1~1{catalogGuid}~1catalogItems/get/responses/403/content/application~1json/example"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1v1~1{catalogGuid}~1catalogItems/get/responses/403/content/application~1json/example"]},{"code":"500","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Unexpected server error. Some legacy endpoints return the message as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"text/plain"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" instead of JSON."},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json","text/plain"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error"},"text/plain":{"schemaId":"schema_25"}},"schemaId":"components/schemas/Error"}],"pointer":"/paths/~1v1~1{catalogGuid}~1catalogItems/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/CatalogItemsPage","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/CatalogItemsPage"}}},{"code":"400","schemaId":"components/schemas/Error","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error"}}},{"code":"401","schemaId":"components/schemas/Error","exampleIds":["paths/~1v1~1{catalogGuid}~1catalogItems/get/responses/401/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1v1~1{catalogGuid}~1catalogItems/get/responses/401/content/application~1json/example"]}}},{"code":"403","schemaId":"components/schemas/Error","exampleIds":["paths/~1v1~1{catalogGuid}~1catalogItems/get/responses/403/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1v1~1{catalogGuid}~1catalogItems/get/responses/403/content/application~1json/example"]}}},{"code":"500","schemaId":"components/schemas/Error","mediaTypes":["application/json","text/plain"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error"},"text/plain":{"schemaId":"schema_25"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/catalog-items/listcatalogitemslegacy"}],"panels":[]}]},"httpPath":"/v1/{catalogGuid}/catalogItems"}],"content":{"contentType":"group","meta":{"name":"Catalog Items"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Catalog Items","showPageActions":true},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Products within a catalog. Pricing is a JSON object keyed by price group name; a value of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"\"N/A\""},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" means"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"the item is not offered to that price group."},"children":[]}]}]}]}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/v1/catalog/{catalogGuid}/catalog_items","summary":"List catalog items","prefix":{"name":"get","color":"get"},"badges":[],"link":"/catalog-items/listcatalogitems","deprecated":false},{"title":"/v1/catalog/{catalogGuid}/catalog_items/{catalogItemGuid}","summary":"Get a catalog item","prefix":{"name":"get","color":"get"},"badges":[],"link":"/catalog-items/getcatalogitem","deprecated":false},{"title":"/v1/catalog/{catalogGuid}/catalog_items/batch","summary":"Get catalog items by ids or GUIDs","prefix":{"name":"post","color":"post"},"badges":[],"link":"/catalog-items/getcatalogitemsbybatch","deprecated":false},{"title":"/v1/catalog/{catalogGuid}/catalog_items/typeahead","summary":"Search catalog items","prefix":{"name":"post","color":"post"},"badges":[],"link":"/catalog-items/searchcatalogitems","deprecated":false},{"title":"/v1/catalog_items/sku-lookup","summary":"Look up catalog items by SKU","prefix":{"name":"post","color":"post"},"badges":[],"link":"/catalog-items/lookupcatalogitembysku","deprecated":false},{"title":"/v1/{catalogGuid}/catalogItems","summary":"List catalog items (legacy path)","prefix":{"name":"get","color":"http-deprecated"},"badges":[],"link":"/catalog-items/listcatalogitemslegacy","deprecated":true}]}]}]}]}},{"type":"group","label":"Price Groups","link":"/openapi/price-groups","routeSlug":"/openapi/price-groups","items":[{"label":"List price groups","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/price-groups/listpricegroups","routeSlug":"/openapi/price-groups/listpricegroups","metadata":{"seo":{"title":"List price groups","description":"Returns the price groups defined on a catalog. name is the key used in each catalog item's pricing object."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"listPriceGroups","name":"List price groups","isWebhook":false,"pointer":"/paths/~1v1~1catalog~1{catalogGuid}~1price_groups/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List price groups","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Returns the price groups defined on a catalog. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is the key used in each catalog item's "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"pricing"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" object."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"ApiKey","scopes":[],"type":"apiKey","in":"header","paramName":"x-apiKey","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Supplier API key. Always sent together with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"x-apiSecret"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"name":"ApiSecret","scopes":[],"type":"apiKey","in":"header","paramName":"x-apiSecret","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Supplier API secret. Always sent together with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"x-apiKey"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]}]},{"schemes":[{"name":"UserGuid","scopes":[],"type":"apiKey","in":"header","paramName":"userGuid","description":"GUID of the authenticated user (user session headers)."},{"name":"UserToken","scopes":[],"type":"apiKey","in":"header","paramName":"userToken","description":"JWT issued to the user at login (user session headers)."},{"name":"SupplierGuid","scopes":[],"type":"apiKey","in":"header","paramName":"supplierGuid","description":"GUID of the supplier account the user is acting in (user session headers)."}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"catalogGuid","in":"path","schemaId":"schema_28","description":"GUID of the catalog. Must belong to the authenticated supplier.","required":true}],"pointer":"/paths/~1v1~1catalog~1{catalogGuid}~1price_groups/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/v1/catalog/{catalogGuid}/price_groups","servers":[{"url":"/_mock/openapi","description":"Mock server","isMockServer":true},{"url":"https://owapi.orderwerks.com","description":"Production"}],"parameters":{"path":[{"name":"catalogGuid","in":"path","required":true,"schemaId":"schema_28"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"ApiKey","type":"apiKey","name":"x-apiKey","in":"header"},{"id":"ApiSecret","type":"apiKey","name":"x-apiSecret","in":"header"}],"scopes":[]},{"schemes":[{"id":"UserGuid","type":"apiKey","name":"userGuid","in":"header"},{"id":"UserToken","type":"apiKey","name":"userToken","in":"header"},{"id":"SupplierGuid","type":"apiKey","name":"supplierGuid","in":"header"}],"scopes":[]}],"responseCodes":["200","400","401","500"],"pointer":"/v1/catalog/{catalogGuid}/price_groups","href":"price-groups/listpricegroups","openApiOperationId":"listPriceGroups","summary":"List price groups","securityGroups":[{"ApiKey":[],"ApiSecret":[]},{"UserGuid":[],"UserToken":[],"SupplierGuid":[]}]},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/openapi","description":"Mock server","isMockServer":true},{"url":"https://owapi.orderwerks.com","description":"Production"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"The catalog's price groups.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_34"}},"schemaId":"schema_34"},{"code":"400","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Unknown catalog GUID (plain-text body "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Invalid Catalog Guid"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]}]}]}],"mediaType":"text/plain","mediaTypes":["text/plain"],"mediaTypeContent":{"text/plain":{"schemaId":"schema_25"}},"schemaId":"schema_25"},{"code":"401","description":"Missing or invalid credentials.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1v1~1catalog~1{catalogGuid}~1price_groups/get/responses/401/content/application~1json/example"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1v1~1catalog~1{catalogGuid}~1price_groups/get/responses/401/content/application~1json/example"]},{"code":"500","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Unexpected server error. Some legacy endpoints return the message as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"text/plain"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" instead of JSON."},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json","text/plain"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error"},"text/plain":{"schemaId":"schema_25"}},"schemaId":"components/schemas/Error"}],"pointer":"/paths/~1v1~1catalog~1{catalogGuid}~1price_groups/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_34","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_34"}}},{"code":"400","schemaId":"schema_25","mediaTypes":["text/plain"],"mediaTypeContent":{"text/plain":{"schemaId":"schema_25"}}},{"code":"401","schemaId":"components/schemas/Error","exampleIds":["paths/~1v1~1catalog~1{catalogGuid}~1price_groups/get/responses/401/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1v1~1catalog~1{catalogGuid}~1price_groups/get/responses/401/content/application~1json/example"]}}},{"code":"500","schemaId":"components/schemas/Error","mediaTypes":["application/json","text/plain"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error"},"text/plain":{"schemaId":"schema_25"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/price-groups/listpricegroups"}],"panels":[]}]},"httpPath":"/v1/catalog/{catalogGuid}/price_groups"}],"content":{"contentType":"group","meta":{"name":"Price Groups"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Price Groups","showPageActions":true},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Named price levels within a catalog (for example "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Retail"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Wholesale"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"). Each vendor is assigned one."},"children":[]}]}]}]}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/v1/catalog/{catalogGuid}/price_groups","summary":"List price groups","prefix":{"name":"get","color":"get"},"badges":[],"link":"/price-groups/listpricegroups","deprecated":false}]}]}]}]}},{"type":"separator","label":"Orders","content":null},{"type":"group","label":"Orders","link":"/openapi/orders","routeSlug":"/openapi/orders","items":[{"label":"List orders","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/orders/listordersapi","routeSlug":"/openapi/orders/listordersapi","metadata":{"seo":{"title":"List orders","description":"Paged list of the supplier's orders, newest first, with a reduced projection of each order and its lines(Order_Items carry id, item_no, qty, note and the item's id, name, sku)."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"listOrdersApi","name":"List orders","isWebhook":false,"pointer":"/paths/~1v1~1orders/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List orders","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Paged list of the supplier's orders, newest first, with a reduced projection of each order and its lines"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Order_Items"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" carry "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"item_no"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"qty"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"note"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and the item's "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"sku"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"API key and secret only."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Requests without "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"x-apiKey"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" / "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"x-apiSecret"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" are rejected with a plain-text "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"ApiKey","scopes":[],"type":"apiKey","in":"header","paramName":"x-apiKey","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Supplier API key. Always sent together with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"x-apiSecret"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"name":"ApiSecret","scopes":[],"type":"apiKey","in":"header","paramName":"x-apiSecret","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Supplier API secret. Always sent together with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"x-apiKey"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"limit","in":"query","schemaId":"schema_22","description":"Number of rows per page."},{"name":"offset","in":"query","schemaId":"schema_23","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Zero-based "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"page number"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". The server skips "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"offset * limit"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" rows."},"children":[]}]}]}]},{"name":"from_updated_at","in":"query","schemaId":"schema_25","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Return only orders updated at or after this UTC timestamp ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"YYYY-MM-DD HH:mm:ss"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or ISO-8601)."},"children":[]}]}]}],"example":"2026-09-01 00:00:00"},{"name":"name","in":"query","schemaId":"schema_25","description":"Filter by order number (contains match)."},{"name":"guid","in":"query","schemaId":"schema_28","description":"Return the single order with this GUID."}],"pointer":"/paths/~1v1~1orders/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/v1/orders","servers":[{"url":"/_mock/openapi","description":"Mock server","isMockServer":true},{"url":"https://owapi.orderwerks.com","description":"Production"}],"parameters":{"path":[],"query":[{"name":"limit","in":"query","required":false,"schemaId":"schema_22"},{"name":"offset","in":"query","required":false,"schemaId":"schema_23"},{"name":"from_updated_at","in":"query","example":"2026-09-01 00:00:00","schemaId":"schema_25"},{"name":"name","in":"query","schemaId":"schema_25"},{"name":"guid","in":"query","schemaId":"schema_28"}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"ApiKey","type":"apiKey","name":"x-apiKey","in":"header"},{"id":"ApiSecret","type":"apiKey","name":"x-apiSecret","in":"header"}],"scopes":[]}],"responseCodes":["200","400","500"],"pointer":"/v1/orders","href":"orders/listordersapi","openApiOperationId":"listOrdersApi","summary":"List orders"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/openapi","description":"Mock server","isMockServer":true},{"url":"https://owapi.orderwerks.com","description":"Production"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"A page of orders.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_35"}},"schemaId":"schema_35"},{"code":"400","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Missing API key or secret (plain-text body "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Invalid API Payload"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]}]}]}],"mediaType":"text/plain","mediaTypes":["text/plain"],"mediaTypeContent":{"text/plain":{"schemaId":"schema_25"}},"schemaId":"schema_25"},{"code":"500","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Unexpected server error. Some legacy endpoints return the message as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"text/plain"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" instead of JSON."},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json","text/plain"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error"},"text/plain":{"schemaId":"schema_25"}},"schemaId":"components/schemas/Error"}],"pointer":"/paths/~1v1~1orders/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_35","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_35"}}},{"code":"400","schemaId":"schema_25","mediaTypes":["text/plain"],"mediaTypeContent":{"text/plain":{"schemaId":"schema_25"}}},{"code":"500","schemaId":"components/schemas/Error","mediaTypes":["application/json","text/plain"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error"},"text/plain":{"schemaId":"schema_25"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/orders/listordersapi"}],"panels":[]}]},"httpPath":"/v1/orders"},{"label":"List orders (filtered)","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/orders/listorders","routeSlug":"/openapi/orders/listorders","metadata":{"seo":{"title":"List orders (filtered)","description":"Paged, filterable order list used by the Orderwerks web app. Supplier users see all of the supplier's orders;customer users see their own."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"listOrders","name":"List orders (filtered)","isWebhook":false,"pointer":"/paths/~1v1~1orders~1list/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List orders (filtered)","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Paged, filterable order list used by the Orderwerks web app. Supplier users see all of the supplier's orders;"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"customer users see their own."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Accepts user session headers only. Integrators should use "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"GET /v1/orders"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"UserGuid","scopes":[],"type":"apiKey","in":"header","paramName":"userGuid","description":"GUID of the authenticated user (user session headers)."},{"name":"UserToken","scopes":[],"type":"apiKey","in":"header","paramName":"userToken","description":"JWT issued to the user at login (user session headers)."},{"name":"SupplierGuid","scopes":[],"type":"apiKey","in":"header","paramName":"supplierGuid","description":"GUID of the supplier account the user is acting in (user session headers)."}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"limit","in":"query","schemaId":"schema_22","description":"Number of rows per page."},{"name":"offset","in":"query","schemaId":"schema_23","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Zero-based "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"page number"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". The server skips "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"offset * limit"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" rows."},"children":[]}]}]}]},{"name":"includePercentageFillable","in":"query","schemaId":"schema_26","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Compute "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"percentageFillable"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" per order from current inventory (slower)."},"children":[]}]}]}]},{"name":"queryString","in":"query","schemaId":"schema_25","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"URL-encoded filter string as built by the web app, e.g. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"filter_shipped=true&is_quote=0"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Individual filter keys may also be passed as top-level query parameters."},"children":[]}]}]}]}],"pointer":"/paths/~1v1~1orders~1list/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/v1/orders/list","servers":[{"url":"/_mock/openapi","description":"Mock server","isMockServer":true},{"url":"https://owapi.orderwerks.com","description":"Production"}],"parameters":{"path":[],"query":[{"name":"limit","in":"query","required":false,"schemaId":"schema_22"},{"name":"offset","in":"query","required":false,"schemaId":"schema_23"},{"name":"includePercentageFillable","in":"query","schemaId":"schema_26"},{"name":"queryString","in":"query","schemaId":"schema_25"}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"UserGuid","type":"apiKey","name":"userGuid","in":"header"},{"id":"UserToken","type":"apiKey","name":"userToken","in":"header"},{"id":"SupplierGuid","type":"apiKey","name":"supplierGuid","in":"header"}],"scopes":[]}],"responseCodes":["200","403","500"],"pointer":"/v1/orders/list","href":"orders/listorders","openApiOperationId":"listOrders","summary":"List orders (filtered)"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/openapi","description":"Mock server","isMockServer":true},{"url":"https://owapi.orderwerks.com","description":"Production"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"A page of orders.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_36"}},"schemaId":"schema_36"},{"code":"403","description":"The credentials are valid but the user lacks the access level this endpoint requires.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1v1~1orders~1list/get/responses/403/content/application~1json/example"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1v1~1orders~1list/get/responses/403/content/application~1json/example"]},{"code":"500","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Unexpected server error. Some legacy endpoints return the message as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"text/plain"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" instead of JSON."},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json","text/plain"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error"},"text/plain":{"schemaId":"schema_25"}},"schemaId":"components/schemas/Error"}],"pointer":"/paths/~1v1~1orders~1list/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_36","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_36"}}},{"code":"403","schemaId":"components/schemas/Error","exampleIds":["paths/~1v1~1orders~1list/get/responses/403/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1v1~1orders~1list/get/responses/403/content/application~1json/example"]}}},{"code":"500","schemaId":"components/schemas/Error","mediaTypes":["application/json","text/plain"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error"},"text/plain":{"schemaId":"schema_25"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/orders/listorders"}],"panels":[]}]},"httpPath":"/v1/orders/list"},{"label":"Get an order","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/orders/getorder","routeSlug":"/openapi/orders/getorder","metadata":{"seo":{"title":"Get an order","description":"Returns the full order with its lines, addresses, customer, state history and related records, plus any related orders (backorders, parent order)."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getOrder","name":"Get an order","isWebhook":false,"pointer":"/paths/~1v1~1orders~1{orderGuid}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get an order","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Returns the full order with its lines, addresses, customer, state history and related records, plus any related orders (backorders, parent order)."},{"nodeType":"security","requirements":[{"schemes":[{"name":"ApiKey","scopes":[],"type":"apiKey","in":"header","paramName":"x-apiKey","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Supplier API key. Always sent together with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"x-apiSecret"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"name":"ApiSecret","scopes":[],"type":"apiKey","in":"header","paramName":"x-apiSecret","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Supplier API secret. Always sent together with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"x-apiKey"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]}]},{"schemes":[{"name":"UserGuid","scopes":[],"type":"apiKey","in":"header","paramName":"userGuid","description":"GUID of the authenticated user (user session headers)."},{"name":"UserToken","scopes":[],"type":"apiKey","in":"header","paramName":"userToken","description":"JWT issued to the user at login (user session headers)."},{"name":"SupplierGuid","scopes":[],"type":"apiKey","in":"header","paramName":"supplierGuid","description":"GUID of the supplier account the user is acting in (user session headers)."}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"orderGuid","in":"path","schemaId":"schema_28","description":"GUID of the order.","required":true}],"pointer":"/paths/~1v1~1orders~1{orderGuid}/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"vendorGuid","in":"header","schemaId":"schema_28","description":"GUID of the customer (vendor) to act for. With API key authentication this selects the customer context; with user session headers it is the vendor the user is acting on behalf of."}],"pointer":"/paths/~1v1~1orders~1{orderGuid}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/v1/orders/{orderGuid}","servers":[{"url":"/_mock/openapi","description":"Mock server","isMockServer":true},{"url":"https://owapi.orderwerks.com","description":"Production"}],"parameters":{"path":[{"name":"orderGuid","in":"path","required":true,"schemaId":"schema_28"}],"query":[],"querystring":[],"header":[{"name":"vendorGuid","in":"header","required":false,"schemaId":"schema_28"}],"cookie":[]},"security":[{"schemes":[{"id":"ApiKey","type":"apiKey","name":"x-apiKey","in":"header"},{"id":"ApiSecret","type":"apiKey","name":"x-apiSecret","in":"header"}],"scopes":[]},{"schemes":[{"id":"UserGuid","type":"apiKey","name":"userGuid","in":"header"},{"id":"UserToken","type":"apiKey","name":"userToken","in":"header"},{"id":"SupplierGuid","type":"apiKey","name":"supplierGuid","in":"header"}],"scopes":[]}],"responseCodes":["200","401","500"],"pointer":"/v1/orders/{orderGuid}","href":"orders/getorder","openApiOperationId":"getOrder","summary":"Get an order","securityGroups":[{"ApiKey":[],"ApiSecret":[]},{"UserGuid":[],"UserToken":[],"SupplierGuid":[]}]},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/openapi","description":"Mock server","isMockServer":true},{"url":"https://owapi.orderwerks.com","description":"Production"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"The order.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_37"}},"schemaId":"schema_37"},{"code":"401","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Invalid credentials (plain-text body "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Invalid API Key or Secret"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Invalid Headers"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]}]}]}],"mediaType":"text/plain","mediaTypes":["text/plain"],"mediaTypeContent":{"text/plain":{"schemaId":"schema_25"}},"schemaId":"schema_25"},{"code":"500","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Unexpected server error. Some legacy endpoints return the message as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"text/plain"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" instead of JSON."},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json","text/plain"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error"},"text/plain":{"schemaId":"schema_25"}},"schemaId":"components/schemas/Error"}],"pointer":"/paths/~1v1~1orders~1{orderGuid}/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_37","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_37"}}},{"code":"401","schemaId":"schema_25","mediaTypes":["text/plain"],"mediaTypeContent":{"text/plain":{"schemaId":"schema_25"}}},{"code":"500","schemaId":"components/schemas/Error","mediaTypes":["application/json","text/plain"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error"},"text/plain":{"schemaId":"schema_25"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/orders/getorder"}],"panels":[]}]},"httpPath":"/v1/orders/{orderGuid}"},{"label":"Update an order","deprecated":false,"httpVerb":"put","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/orders/updateorder","routeSlug":"/openapi/orders/updateorder","metadata":{"seo":{"title":"Update an order","description":"Partial update of an order's header fields. Rejected with 403 when the order's current workflow step isread-only for the caller's user type."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"updateOrder","name":"Update an order","isWebhook":false,"pointer":"/paths/~1v1~1orders~1{orderGuid}/put","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Update an order","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Partial update of an order's header fields. Rejected with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"403"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" when the order's current workflow step is"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"read-only for the caller's user type."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Accepts user session headers only."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"UserGuid","scopes":[],"type":"apiKey","in":"header","paramName":"userGuid","description":"GUID of the authenticated user (user session headers)."},{"name":"UserToken","scopes":[],"type":"apiKey","in":"header","paramName":"userToken","description":"JWT issued to the user at login (user session headers)."},{"name":"SupplierGuid","scopes":[],"type":"apiKey","in":"header","paramName":"supplierGuid","description":"GUID of the supplier account the user is acting in (user session headers)."}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"orderGuid","in":"path","schemaId":"schema_28","description":"GUID of the order.","required":true}],"pointer":"/paths/~1v1~1orders~1{orderGuid}/put/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/UpdateOrderRequest","exampleIds":["paths/~1v1~1orders~1{orderGuid}/put/requestBody/content/application~1json/example"]}},"schemaId":"components/schemas/UpdateOrderRequest","exampleIds":["paths/~1v1~1orders~1{orderGuid}/put/requestBody/content/application~1json/example"],"pointer":"/paths/~1v1~1orders~1{orderGuid}/put/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PUT","path":"/v1/orders/{orderGuid}","servers":[{"url":"/_mock/openapi","description":"Mock server","isMockServer":true},{"url":"https://owapi.orderwerks.com","description":"Production"}],"parameters":{"path":[{"name":"orderGuid","in":"path","required":true,"schemaId":"schema_28"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"UserGuid","type":"apiKey","name":"userGuid","in":"header"},{"id":"UserToken","type":"apiKey","name":"userToken","in":"header"},{"id":"SupplierGuid","type":"apiKey","name":"supplierGuid","in":"header"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/UpdateOrderRequest","exampleIds":["paths/~1v1~1orders~1{orderGuid}/put/requestBody/content/application~1json/example"]}},"responseCodes":["200","400","401","403","404","500"],"pointer":"/v1/orders/{orderGuid}","href":"orders/updateorder","openApiOperationId":"updateOrder","summary":"Update an order"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/openapi","description":"Mock server","isMockServer":true},{"url":"https://owapi.orderwerks.com","description":"Production"}],"schemaId":"components/schemas/UpdateOrderRequest","exampleIds":["paths/~1v1~1orders~1{orderGuid}/put/requestBody/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/UpdateOrderRequest","exampleIds":["paths/~1v1~1orders~1{orderGuid}/put/requestBody/content/application~1json/example"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"The updated order.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Order"}},"schemaId":"components/schemas/Order"},{"code":"400","description":"The request is malformed or references a resource the supplier does not own (for example an unknown catalog GUID).","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error"}},"schemaId":"components/schemas/Error"},{"code":"401","description":"Missing or invalid credentials.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1v1~1orders~1{orderGuid}/put/responses/401/content/application~1json/example"]}},"schemaId":"components/schemas/Error","exampleIds":["paths/~1v1~1orders~1{orderGuid}/put/responses/401/content/application~1json/example"]},{"code":"403","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Insufficient access, or the order is read-only at its current workflow step ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"currentStep"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"stepNumber"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" included)."},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_38"}},"schemaId":"schema_38"},{"code":"404","description":"No resource with that GUID is visible to the authenticated supplier.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error"}},"schemaId":"components/schemas/Error"},{"code":"500","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Unexpected server error. Some legacy endpoints return the message as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"text/plain"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" instead of JSON."},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json","text/plain"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error"},"text/plain":{"schemaId":"schema_25"}},"schemaId":"components/schemas/Error"}],"pointer":"/paths/~1v1~1orders~1{orderGuid}/put/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/Order","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Order"}}},{"code":"400","schemaId":"components/schemas/Error","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error"}}},{"code":"401","schemaId":"components/schemas/Error","exampleIds":["paths/~1v1~1orders~1{orderGuid}/put/responses/401/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error","exampleIds":["paths/~1v1~1orders~1{orderGuid}/put/responses/401/content/application~1json/example"]}}},{"code":"403","schemaId":"schema_38","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_38"}}},{"code":"404","schemaId":"components/schemas/Error","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error"}}},{"code":"500","schemaId":"components/schemas/Error","mediaTypes":["application/json","text/plain"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error"},"text/plain":{"schemaId":"schema_25"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/orders/updateorder"}],"panels":[]}]},"httpPath":"/v1/orders/{orderGuid}"},{"label":"Create an order","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/orders/createorderv2","routeSlug":"/openapi/orders/createorderv2","metadata":{"seo":{"title":"Create an order","description":"Creates an order with its lines for an existing customer and, unless remainInPreliminary is true, submits itinto the supplier's workflow. This is the recommended endpoint for integrations."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"createOrderV2","name":"Create an order","isWebhook":false,"pointer":"/paths/~1v2~1order/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Create an order","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Creates an order with its lines for an existing customer and, unless "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"remainInPreliminary"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is true, submits it"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"into the supplier's workflow. This is the recommended endpoint for integrations."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"API key and secret only."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" The order is attributed to the supplier's master user. Requests without"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"x-apiKey"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" / "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"x-apiSecret"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" are rejected with a plain-text "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"ApiKey","scopes":[],"type":"apiKey","in":"header","paramName":"x-apiKey","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Supplier API key. Always sent together with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"x-apiSecret"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"name":"ApiSecret","scopes":[],"type":"apiKey","in":"header","paramName":"x-apiSecret","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Supplier API secret. Always sent together with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"x-apiKey"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/CreateOrderV2Request","exampleIds":["paths/~1v2~1order/post/requestBody/content/application~1json/example"]}},"schemaId":"components/schemas/CreateOrderV2Request","exampleIds":["paths/~1v2~1order/post/requestBody/content/application~1json/example"],"pointer":"/paths/~1v2~1order/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/v2/order","servers":[{"url":"/_mock/openapi","description":"Mock server","isMockServer":true},{"url":"https://owapi.orderwerks.com","description":"Production"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"ApiKey","type":"apiKey","name":"x-apiKey","in":"header"},{"id":"ApiSecret","type":"apiKey","name":"x-apiSecret","in":"header"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/CreateOrderV2Request","exampleIds":["paths/~1v2~1order/post/requestBody/content/application~1json/example"]}},"responseCodes":["200","400","401","500"],"pointer":"/v2/order","href":"orders/createorderv2","openApiOperationId":"createOrderV2","summary":"Create an order"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/openapi","description":"Mock server","isMockServer":true},{"url":"https://owapi.orderwerks.com","description":"Production"}],"schemaId":"components/schemas/CreateOrderV2Request","exampleIds":["paths/~1v2~1order/post/requestBody/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/CreateOrderV2Request","exampleIds":["paths/~1v2~1order/post/requestBody/content/application~1json/example"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"The created order.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_39"}},"schemaId":"schema_39"},{"code":"400","description":"Missing API key or secret, or the customer could not be resolved (plain-text body).","mediaType":"text/plain","mediaTypes":["text/plain"],"mediaTypeContent":{"text/plain":{"schemaId":"schema_40"}},"schemaId":"schema_40"},{"code":"401","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The API key's user may not order for this customer (plain-text body "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Invalid Access"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]}]}]}],"mediaType":"text/plain","mediaTypes":["text/plain"],"mediaTypeContent":{"text/plain":{"schemaId":"schema_25"}},"schemaId":"schema_25"},{"code":"500","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Unexpected server error. Some legacy endpoints return the message as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"text/plain"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" instead of JSON."},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json","text/plain"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error"},"text/plain":{"schemaId":"schema_25"}},"schemaId":"components/schemas/Error"}],"pointer":"/paths/~1v2~1order/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_39","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_39"}}},{"code":"400","schemaId":"schema_40","mediaTypes":["text/plain"],"mediaTypeContent":{"text/plain":{"schemaId":"schema_40"}}},{"code":"401","schemaId":"schema_25","mediaTypes":["text/plain"],"mediaTypeContent":{"text/plain":{"schemaId":"schema_25"}}},{"code":"500","schemaId":"components/schemas/Error","mediaTypes":["application/json","text/plain"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error"},"text/plain":{"schemaId":"schema_25"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/orders/createorderv2"}],"panels":[]}]},"httpPath":"/v2/order"},{"label":"Create an order (with optional new customer)","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/orders/createorderwithitems","routeSlug":"/openapi/orders/createorderwithitems","metadata":{"seo":{"title":"Create an order (with optional new customer)","description":"Creates an order with its lines, optionally creating the customer in the same call (newVendor* fields).Used by the Orderwerks mobile sales app; also available to integrators with an API key."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"createOrderWithItems","name":"Create an order (with optional new customer)","isWebhook":false,"pointer":"/paths/~1v1~1orderWithItems/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Create an order (with optional new customer)","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Creates an order with its lines, optionally creating the customer in the same call ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"newVendor*"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" fields)."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Used by the Orderwerks mobile sales app; also available to integrators with an API key."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Before anything is written the request is validated: the customer must be active and accessible, and every"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"line's item must be active with enough inventory. Failures come back as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" with a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"ReconcileErrors"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" body."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Idempotent on "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"order.api_guid"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": a retry with the same key returns the existing order (and the customer /"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"address / contact references) instead of creating a duplicate."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"ApiKey","scopes":[],"type":"apiKey","in":"header","paramName":"x-apiKey","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Supplier API key. Always sent together with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"x-apiSecret"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"name":"ApiSecret","scopes":[],"type":"apiKey","in":"header","paramName":"x-apiSecret","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Supplier API secret. Always sent together with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"x-apiKey"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]}]},{"schemes":[{"name":"UserGuid","scopes":[],"type":"apiKey","in":"header","paramName":"userGuid","description":"GUID of the authenticated user (user session headers)."},{"name":"UserToken","scopes":[],"type":"apiKey","in":"header","paramName":"userToken","description":"JWT issued to the user at login (user session headers)."},{"name":"SupplierGuid","scopes":[],"type":"apiKey","in":"header","paramName":"supplierGuid","description":"GUID of the supplier account the user is acting in (user session headers)."}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"vendorGuid","in":"header","schemaId":"schema_28","description":"GUID of the customer (vendor) to act for. With API key authentication this selects the customer context; with user session headers it is the vendor the user is acting on behalf of."},{"name":"userGuid","in":"header","schemaId":"schema_28","description":"With API key authentication only: run the request as this user instead of the supplier's master user (the order is attributed to them). Ignored when user session headers are used, where it is part of the credentials."}],"pointer":"/paths/~1v1~1orderWithItems/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/CreateOrderWithItemsRequest","exampleIds":["paths/~1v1~1orderWithItems/post/requestBody/content/application~1json/example"]}},"schemaId":"components/schemas/CreateOrderWithItemsRequest","exampleIds":["paths/~1v1~1orderWithItems/post/requestBody/content/application~1json/example"],"pointer":"/paths/~1v1~1orderWithItems/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/v1/orderWithItems","servers":[{"url":"/_mock/openapi","description":"Mock server","isMockServer":true},{"url":"https://owapi.orderwerks.com","description":"Production"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"vendorGuid","in":"header","required":false,"schemaId":"schema_28"},{"name":"userGuid","in":"header","required":false,"schemaId":"schema_28"}],"cookie":[]},"security":[{"schemes":[{"id":"ApiKey","type":"apiKey","name":"x-apiKey","in":"header"},{"id":"ApiSecret","type":"apiKey","name":"x-apiSecret","in":"header"}],"scopes":[]},{"schemes":[{"id":"UserGuid","type":"apiKey","name":"userGuid","in":"header"},{"id":"UserToken","type":"apiKey","name":"userToken","in":"header"},{"id":"SupplierGuid","type":"apiKey","name":"supplierGuid","in":"header"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/CreateOrderWithItemsRequest","exampleIds":["paths/~1v1~1orderWithItems/post/requestBody/content/application~1json/example"]}},"responseCodes":["200","400","401","500"],"pointer":"/v1/orderWithItems","href":"orders/createorderwithitems","openApiOperationId":"createOrderWithItems","summary":"Create an order (with optional new customer)","securityGroups":[{"ApiKey":[],"ApiSecret":[]},{"UserGuid":[],"UserToken":[],"SupplierGuid":[]}]},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/openapi","description":"Mock server","isMockServer":true},{"url":"https://owapi.orderwerks.com","description":"Production"}],"schemaId":"components/schemas/CreateOrderWithItemsRequest","exampleIds":["paths/~1v1~1orderWithItems/post/requestBody/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/CreateOrderWithItemsRequest","exampleIds":["paths/~1v1~1orderWithItems/post/requestBody/content/application~1json/example"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"The created (or matched) order.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/CreateOrderWithItemsResponse"}},"schemaId":"components/schemas/CreateOrderWithItemsResponse"},{"code":"400","description":"Validation failed.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ReconcileErrors"}},"schemaId":"components/schemas/ReconcileErrors"},{"code":"401","description":"Missing credentials or no access to the customer.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_41"}},"schemaId":"schema_41"},{"code":"500","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Unexpected error. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"noAccountAccess"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" / "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"inactiveAccount"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" are set when that was the cause."},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_42"}},"schemaId":"schema_42"}],"pointer":"/paths/~1v1~1orderWithItems/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/CreateOrderWithItemsResponse","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/CreateOrderWithItemsResponse"}}},{"code":"400","schemaId":"components/schemas/ReconcileErrors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ReconcileErrors"}}},{"code":"401","schemaId":"schema_41","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_41"}}},{"code":"500","schemaId":"schema_42","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_42"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/orders/createorderwithitems"}],"panels":[]}]},"httpPath":"/v1/orderWithItems"},{"label":"Create an empty order (legacy)","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/orders/createorderv1","routeSlug":"/openapi/orders/createorderv1","metadata":{"seo":{"title":"Create an empty order (legacy)","description":"Creates an order header for the customer given in the vendorGuid header, without lines. Lines are addedafterwards through the order-entry screens. Prefer POST /v2/order or POST /v1/orderWithItems."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"createOrderV1","name":"Create an empty order (legacy)","isWebhook":false,"pointer":"/paths/~1v1~1order/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Create an empty order (legacy)","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Creates an order header for the customer given in the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"vendorGuid"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" header, without lines. Lines are added"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"afterwards through the order-entry screens. Prefer "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"POST /v2/order"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"POST /v1/orderWithItems"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Accepts user session headers only. Requests without them are rejected with a plain-text "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"UserGuid","scopes":[],"type":"apiKey","in":"header","paramName":"userGuid","description":"GUID of the authenticated user (user session headers)."},{"name":"UserToken","scopes":[],"type":"apiKey","in":"header","paramName":"userToken","description":"JWT issued to the user at login (user session headers)."},{"name":"SupplierGuid","scopes":[],"type":"apiKey","in":"header","paramName":"supplierGuid","description":"GUID of the supplier account the user is acting in (user session headers)."}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"vendorGuid","in":"header","schemaId":"schema_28","description":"GUID of the customer (vendor) to act for. With API key authentication this selects the customer context; with user session headers it is the vendor the user is acting on behalf of."}],"pointer":"/paths/~1v1~1order/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/CreateOrderV1Request"}},"schemaId":"components/schemas/CreateOrderV1Request","pointer":"/paths/~1v1~1order/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/v1/order","servers":[{"url":"/_mock/openapi","description":"Mock server","isMockServer":true},{"url":"https://owapi.orderwerks.com","description":"Production"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"vendorGuid","in":"header","required":false,"schemaId":"schema_28"}],"cookie":[]},"security":[{"schemes":[{"id":"UserGuid","type":"apiKey","name":"userGuid","in":"header"},{"id":"UserToken","type":"apiKey","name":"userToken","in":"header"},{"id":"SupplierGuid","type":"apiKey","name":"supplierGuid","in":"header"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/CreateOrderV1Request"}},"responseCodes":["200","400","500"],"pointer":"/v1/order","href":"orders/createorderv1","openApiOperationId":"createOrderV1","summary":"Create an empty order (legacy)"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/openapi","description":"Mock server","isMockServer":true},{"url":"https://owapi.orderwerks.com","description":"Production"}],"schemaId":"components/schemas/CreateOrderV1Request","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/CreateOrderV1Request"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"The created order.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_39"}},"schemaId":"schema_39"},{"code":"400","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Missing user session headers (plain-text body "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Invalid API Payload"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]}]}]}],"mediaType":"text/plain","mediaTypes":["text/plain"],"mediaTypeContent":{"text/plain":{"schemaId":"schema_25"}},"schemaId":"schema_25"},{"code":"500","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Unexpected server error. Some legacy endpoints return the message as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"text/plain"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" instead of JSON."},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json","text/plain"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error"},"text/plain":{"schemaId":"schema_25"}},"schemaId":"components/schemas/Error"}],"pointer":"/paths/~1v1~1order/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_39","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_39"}}},{"code":"400","schemaId":"schema_25","mediaTypes":["text/plain"],"mediaTypeContent":{"text/plain":{"schemaId":"schema_25"}}},{"code":"500","schemaId":"components/schemas/Error","mediaTypes":["application/json","text/plain"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error"},"text/plain":{"schemaId":"schema_25"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/orders/createorderv1"}],"panels":[]}]},"httpPath":"/v1/order"},{"label":"Submit an order / advance its state","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/orders/submitorder","routeSlug":"/openapi/orders/submitorder","metadata":{"seo":{"title":"Submit an order / advance its state","description":"Moves an order to the next step of its workflow (or to order_state_id when given), reserving inventory andsending the step's notifications. Orders created through POST /v2/order are submitted automatically; use thisfor orders created with remainInPreliminary: true or by POST /v1/order."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"submitOrder","name":"Submit an order / advance its state","isWebhook":false,"pointer":"/paths/~1v1~1order~1submit/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Submit an order / advance its state","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Moves an order to the next step of its workflow (or to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"order_state_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" when given), reserving inventory and"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"sending the step's notifications. Orders created through "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"POST /v2/order"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" are submitted automatically; use this"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"for orders created with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"remainInPreliminary: true"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or by "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"POST /v1/order"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Accepts user session headers only."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"UserGuid","scopes":[],"type":"apiKey","in":"header","paramName":"userGuid","description":"GUID of the authenticated user (user session headers)."},{"name":"UserToken","scopes":[],"type":"apiKey","in":"header","paramName":"userToken","description":"JWT issued to the user at login (user session headers)."},{"name":"SupplierGuid","scopes":[],"type":"apiKey","in":"header","paramName":"supplierGuid","description":"GUID of the supplier account the user is acting in (user session headers)."}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"vendorGuid","in":"header","schemaId":"schema_28","description":"GUID of the customer (vendor) to act for. With API key authentication this selects the customer context; with user session headers it is the vendor the user is acting on behalf of."}],"pointer":"/paths/~1v1~1order~1submit/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/SubmitOrderRequest","exampleIds":["paths/~1v1~1order~1submit/post/requestBody/content/application~1json/example"]}},"schemaId":"components/schemas/SubmitOrderRequest","exampleIds":["paths/~1v1~1order~1submit/post/requestBody/content/application~1json/example"],"pointer":"/paths/~1v1~1order~1submit/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/v1/order/submit","servers":[{"url":"/_mock/openapi","description":"Mock server","isMockServer":true},{"url":"https://owapi.orderwerks.com","description":"Production"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"vendorGuid","in":"header","required":false,"schemaId":"schema_28"}],"cookie":[]},"security":[{"schemes":[{"id":"UserGuid","type":"apiKey","name":"userGuid","in":"header"},{"id":"UserToken","type":"apiKey","name":"userToken","in":"header"},{"id":"SupplierGuid","type":"apiKey","name":"supplierGuid","in":"header"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/SubmitOrderRequest","exampleIds":["paths/~1v1~1order~1submit/post/requestBody/content/application~1json/example"]}},"responseCodes":["200","400","422","500"],"pointer":"/v1/order/submit","href":"orders/submitorder","openApiOperationId":"submitOrder","summary":"Submit an order / advance its state"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/openapi","description":"Mock server","isMockServer":true},{"url":"https://owapi.orderwerks.com","description":"Production"}],"schemaId":"components/schemas/SubmitOrderRequest","exampleIds":["paths/~1v1~1order~1submit/post/requestBody/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/SubmitOrderRequest","exampleIds":["paths/~1v1~1order~1submit/post/requestBody/content/application~1json/example"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"The order after the transition.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_43"}},"schemaId":"schema_43"},{"code":"400","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Missing credentials or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"orderGuid"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (plain-text body "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Invalid API Payload"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]}]}]}],"mediaType":"text/plain","mediaTypes":["text/plain"],"mediaTypeContent":{"text/plain":{"schemaId":"schema_25"}},"schemaId":"schema_25"},{"code":"422","description":"The transition is blocked (insufficient inventory, backorder limit, pending items on release, serials not assigned).","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/SubmitOrderError"}},"schemaId":"components/schemas/SubmitOrderError"},{"code":"500","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Unexpected server error. Some legacy endpoints return the message as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"text/plain"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" instead of JSON."},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json","text/plain"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error"},"text/plain":{"schemaId":"schema_25"}},"schemaId":"components/schemas/Error"}],"pointer":"/paths/~1v1~1order~1submit/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_43","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_43"}}},{"code":"400","schemaId":"schema_25","mediaTypes":["text/plain"],"mediaTypeContent":{"text/plain":{"schemaId":"schema_25"}}},{"code":"422","schemaId":"components/schemas/SubmitOrderError","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/SubmitOrderError"}}},{"code":"500","schemaId":"components/schemas/Error","mediaTypes":["application/json","text/plain"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Error"},"text/plain":{"schemaId":"schema_25"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/orders/submitorder"}],"panels":[]}]},"httpPath":"/v1/order/submit"}],"content":{"contentType":"group","meta":{"name":"Orders"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Orders","showPageActions":true},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Sales orders. Orders are created in the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"PRELIMINARY"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" state and, unless "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"remainInPreliminary"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is set, are"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"submitted automatically into the supplier's workflow."},"children":[]}]}]}]}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/v1/orders","summary":"List orders","prefix":{"name":"get","color":"get"},"badges":[],"link":"/orders/listordersapi","deprecated":false},{"title":"/v1/orders/list","summary":"List orders (filtered)","prefix":{"name":"get","color":"get"},"badges":[],"link":"/orders/listorders","deprecated":false},{"title":"/v1/orders/{orderGuid}","summary":"Get an order","prefix":{"name":"get","color":"get"},"badges":[],"link":"/orders/getorder","deprecated":false},{"title":"/v1/orders/{orderGuid}","summary":"Update an order","prefix":{"name":"put","color":"put"},"badges":[],"link":"/orders/updateorder","deprecated":false},{"title":"/v2/order","summary":"Create an order","prefix":{"name":"post","color":"post"},"badges":[],"link":"/orders/createorderv2","deprecated":false},{"title":"/v1/orderWithItems","summary":"Create an order (with optional new customer)","prefix":{"name":"post","color":"post"},"badges":[],"link":"/orders/createorderwithitems","deprecated":false},{"title":"/v1/order","summary":"Create an empty order (legacy)","prefix":{"name":"post","color":"post"},"badges":[],"link":"/orders/createorderv1","deprecated":false},{"title":"/v1/order/submit","summary":"Submit an order / advance its state","prefix":{"name":"post","color":"post"},"badges":[],"link":"/orders/submitorder","deprecated":false}]}]}]}]}}],"store":{"schemaStore":{"components/schemas/Error":{"id":"components/schemas/Error","kind":"json-schema","title":"Error","data":{"type":"object","properties":{"message":{"type":"string","description":"Human-readable error message.","example":"Invalid Catalog GUID"},"error":{"type":"string","description":"Underlying error detail, when available."},"code":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Machine-readable code for specific failures (for example "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"INVALID_DELTA_CURSOR"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]}]}]}]}},"required":["message"]}},"components/schemas/EntityRef":{"id":"components/schemas/EntityRef","kind":"json-schema","title":"EntityRef","data":{"type":"object","description":"Minimal reference to a created record, so a client can back-fill its local rows.","properties":{"id":{"type":"integer","example":4821},"guid":{"type":"string","format":"uuid"}},"required":["id","guid"]}},"components/schemas/Address":{"id":"components/schemas/Address","kind":"json-schema","title":"Address","data":{"type":"object","description":"A billing or shipping address. Additional internal fields may be present.","properties":{"id":{"type":"integer"},"guid":{"type":"string","format":"uuid"},"vendor_id":{"type":"integer","nullable":true},"order_id":{"type":"integer","nullable":true},"name":{"type":"string","description":"Contact name at this address."},"company_name":{"type":"string"},"address_line_one":{"type":"string"},"address_line_two":{"type":"string"},"address_line_three":{"type":"string"},"city":{"type":"string"},"state":{"type":"string"},"postal_code":{"type":"string"},"country":{"type":"string"},"phone":{"type":"string"},"fax":{"type":"string"},"email":{"type":"string"},"note":{"type":"string"},"address_internal_id":{"type":"string","description":"Your own identifier for this address, if one was supplied."},"is_vendor_main_ship_to":{"type":"boolean"},"verified":{"type":"boolean","description":"True when the address was verified against a postal database."},"lat":{"type":"number","nullable":true},"lng":{"type":"number","nullable":true},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"}}}},"components/schemas/AddressInput":{"id":"components/schemas/AddressInput","kind":"json-schema","title":"AddressInput","data":{"type":"object","description":"Address fields accepted when creating or updating an address.","properties":{"name":{"type":"string","description":"Contact name at this address.","example":"Jane Doe"},"company_name":{"type":"string","example":"Acme, Inc."},"address_line_one":{"type":"string","example":"123 Any Street"},"address_line_two":{"type":"string","example":"Unit A"},"address_line_three":{"type":"string"},"city":{"type":"string","example":"Anytown"},"state":{"type":"string","example":"CA"},"postal_code":{"type":"string","example":"12345"},"country":{"type":"string","example":"US"},"phone":{"type":"string"},"fax":{"type":"string"},"email":{"type":"string"},"note":{"type":"string"},"address_internal_id":{"type":"string","description":"Your own identifier for this address."}}}},"components/schemas/Vendor":{"id":"components/schemas/Vendor","kind":"json-schema","title":"Vendor","data":{"type":"object","description":"A customer of the supplier. The full model includes many integration-specific fields (QuickBooks, Stripe, FastBound, routing); only the commonly used ones are listed here.","properties":{"id":{"type":"integer"},"guid":{"type":"string","format":"uuid"},"supplier_id":{"type":"integer"},"parent_vendor_id":{"type":"integer","nullable":true},"customer_internal_id":{"type":"string","nullable":true,"description":"Your own identifier for this customer."},"name":{"type":"string"},"email":{"type":"string"},"shipping_email":{"type":"string","nullable":true},"phone":{"type":"string","nullable":true},"cell":{"type":"string","nullable":true},"fax":{"type":"string","nullable":true},"address_line_one":{"type":"string","nullable":true},"address_line_two":{"type":"string","nullable":true},"city":{"type":"string","nullable":true},"state":{"type":"string","nullable":true},"postal_code":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"active":{"type":"boolean"},"tax_exempt":{"type":"boolean"},"resale_tax_id":{"type":"string","nullable":true},"lock_catalog_id":{"type":"integer","nullable":true,"description":"When set, the customer can only order from this catalog."},"price_group_id":{"type":"integer","nullable":true,"description":"Price group used for this customer's pricing."},"payment_type_id":{"type":"integer","nullable":true},"payment_term_id":{"type":"integer","nullable":true},"require_payment":{"type":"boolean"},"credit_limit":{"type":"number","nullable":true},"open_balance":{"type":"number","nullable":true},"is_ecomm_user":{"type":"boolean","description":"True for Orderwerks Online (e-commerce) customers."},"net_term_ecomm_user":{"type":"boolean"},"require_po":{"type":"boolean"},"standing_po":{"type":"string","nullable":true},"hide_pricing":{"type":"boolean"},"currency_id":{"type":"integer","nullable":true},"notes":{"type":"string","nullable":true},"default_order_category_id":{"type":"integer","nullable":true},"route_id":{"type":"integer","nullable":true},"timezone":{"type":"string","nullable":true},"bill_to_id":{"type":"integer","nullable":true},"ship_to_id":{"type":"integer","nullable":true},"Bill_To":{"$ref":"#/components/schemas/Address"},"Ship_To":{"$ref":"#/components/schemas/Address"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"deleted_at":{"type":"string","format":"date-time","nullable":true,"description":"Present only in delta-sync responses for soft-deleted customers."}}}},"components/schemas/VendorInput":{"id":"components/schemas/VendorInput","kind":"json-schema","title":"VendorInput","data":{"type":"object","description":"Customer fields accepted on create.","properties":{"name":{"type":"string","example":"Acme, Inc."},"email":{"type":"string","example":"orders@acme.example"},"customer_internal_id":{"type":"string","description":"Your own identifier for this customer. Used for idempotent matching by some integrations."},"phone":{"type":"string"},"cell":{"type":"string"},"fax":{"type":"string"},"shipping_email":{"type":"string"},"address_line_one":{"type":"string"},"address_line_two":{"type":"string"},"city":{"type":"string"},"state":{"type":"string"},"postal_code":{"type":"string"},"country":{"type":"string"},"active":{"type":"boolean","default":true},"tax_exempt":{"type":"boolean"},"resale_tax_id":{"type":"string"},"price_group_id":{"type":"integer"},"lock_catalog_id":{"type":"integer"},"payment_type_id":{"type":"integer"},"payment_term_id":{"type":"integer"},"require_payment":{"type":"boolean"},"require_po":{"type":"boolean"},"standing_po":{"type":"string"},"hide_pricing":{"type":"boolean"},"is_ecomm_user":{"type":"boolean"},"notes":{"type":"string"},"default_order_category_id":{"type":"integer"},"route_id":{"type":"integer"}},"required":["name"]}},"components/schemas/VendorContactInput":{"id":"components/schemas/VendorContactInput","kind":"json-schema","title":"VendorContactInput","data":{"type":"object","properties":{"name":{"type":"string","example":"Jane Doe"},"email":{"type":"string"},"phone":{"type":"string"},"mobile":{"type":"string"}},"required":["name"]}},"components/schemas/VendorOptions":{"id":"components/schemas/VendorOptions","kind":"json-schema","title":"VendorOptions","data":{"type":"object","description":"Optional customer settings. All fields are optional; omitted fields are left unchanged.","properties":{"active":{"type":"boolean"},"customer_internal_id":{"type":"string"},"lock_catalog_id":{"type":"integer","nullable":true},"price_group_id":{"type":"integer","nullable":true},"payment_type_id":{"type":"integer","nullable":true},"payment_term_id":{"type":"integer"},"require_payment":{"type":"boolean"},"credit_limit":{"type":"number"},"open_balance":{"type":"number","nullable":true},"tax_exempt":{"type":"boolean"},"tax_shipping":{"type":"boolean","nullable":true},"resale_tax_id":{"type":"string"},"is_ecomm_user":{"type":"boolean"},"net_term_ecomm_user":{"type":"boolean"},"require_po":{"type":"boolean"},"hide_pricing":{"type":"boolean"},"shipping_email":{"type":"string"},"default_shipping_instructions":{"type":"string"},"default_order_category_id":{"type":"integer"},"category_id":{"type":"integer"},"parent_vendor_id":{"type":"integer"},"currency_id":{"type":"integer"},"notes":{"type":"string"},"route_id":{"type":"integer"},"default_local_delivery":{"type":"boolean","nullable":true},"default_local_pickup":{"type":"boolean","nullable":true},"timezone":{"type":"string","nullable":true},"create_in_qbo":{"type":"boolean","description":"Create the customer in QuickBooks Online after saving."},"create_in_qbd":{"type":"boolean","description":"Queue the customer for creation in QuickBooks Desktop after saving."}}}},"components/schemas/CreateVendorRequest":{"id":"components/schemas/CreateVendorRequest","kind":"json-schema","title":"CreateVendorRequest","data":{"type":"object","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Mirrors the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"newVendor*"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" block accepted by "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"POST /v1/orderWithItems"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Idempotent on supplier + "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"newVendor.email"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": a retry after a lost response returns the existing customer's references instead of creating a duplicate."},"children":[]}]}]}],"properties":{"newVendor":{"$ref":"#/components/schemas/VendorInput"},"newVendorBillTo":{"$ref":"#/components/schemas/AddressInput"},"newVendorShipTo":{"$ref":"#/components/schemas/AddressInput"},"newVendorContact":{"$ref":"#/components/schemas/VendorContactInput"},"newVendorNote":{"type":"string","description":"Free-text account note stored against the new customer."},"source":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Origin of the record (for example "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"APP"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"). Stored for reporting only."},"children":[]}]}]}]}},"required":["newVendor"]}},"components/schemas/CreateVendorResponse":{"id":"components/schemas/CreateVendorResponse","kind":"json-schema","title":"CreateVendorResponse","data":{"type":"object","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"billTo"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"shipTo"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"contact"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"note"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" references are present only when that record was created (or matched on a retry)."},"children":[]}]}]}],"properties":{"vendor":{"$ref":"#/components/schemas/Vendor"},"billTo":{"$ref":"#/components/schemas/EntityRef"},"shipTo":{"$ref":"#/components/schemas/EntityRef"},"contact":{"$ref":"#/components/schemas/EntityRef"},"note":{"$ref":"#/components/schemas/EntityRef"}},"required":["vendor"]}},"components/schemas/UpdateVendorRequest":{"id":"components/schemas/UpdateVendorRequest","kind":"json-schema","title":"UpdateVendorRequest","data":{"type":"object","properties":{"name":{"type":"string"},"email":{"type":"string"},"billTo":{"$ref":"#/components/schemas/AddressInput"},"shipTo":{"$ref":"#/components/schemas/AddressInput"},"options":{"$ref":"#/components/schemas/VendorOptions"},"tokenOptions":{"type":"object","description":"Connection-level settings for the customer's login (catalog / price group locks, discounts).","properties":{"catalog_id":{"type":"integer","nullable":true},"price_group_id":{"type":"integer","nullable":true},"hide_pricing":{"type":"boolean"},"price_discount_one":{"type":"number","nullable":true},"price_discount_two":{"type":"number"}}},"shippingDetails":{"type":"array","description":"Replaces the customer's saved shipping preferences (carrier / service defaults).","items":{"type":"object","additionalProperties":true}},"shippingAccounts":{"type":"array","description":"Replaces the customer's third-party shipping accounts.","items":{"type":"object","additionalProperties":true}}},"required":["name","email"]}},"components/schemas/VendorConnection":{"id":"components/schemas/VendorConnection","kind":"json-schema","title":"VendorConnection","data":{"type":"object","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A supplier-to-customer connection row. Customer lists are returned as connections because a customer's catalog and price group locks live on the connection; the customer record itself is under "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Vendor"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"properties":{"id":{"type":"integer"},"guid":{"type":"string","format":"uuid"},"supplier_id":{"type":"integer"},"vendor_id":{"type":"integer"},"parent_vendor_id":{"type":"integer","nullable":true},"catalog_id":{"type":"integer","nullable":true,"description":"Catalog the customer is locked to, if any."},"price_group_id":{"type":"integer","nullable":true,"description":"Price group override on the connection, if any."},"hide_pricing":{"type":"boolean"},"price_discount_one":{"type":"number","nullable":true},"price_discount_two":{"type":"number","nullable":true},"is_master":{"type":"boolean"},"route_id":{"type":"integer","nullable":true},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"deleted_at":{"type":"string","format":"date-time","nullable":true},"Vendor":{"$ref":"#/components/schemas/Vendor"},"Price_Group":{"$ref":"#/components/schemas/PriceGroup"}}}},"components/schemas/VendorListResponse":{"id":"components/schemas/VendorListResponse","kind":"json-schema","title":"VendorListResponse","data":{"type":"object","properties":{"supplierVendorTokens":{"type":"array","items":{"$ref":"#/components/schemas/VendorConnection"}},"totalVendors":{"type":"integer","description":"Total matching customers across all pages."},"salesPeopleAssigned":{"type":"array","description":"Sales rep assignments for the customers on this page.","items":{"type":"object","properties":{"id":{"type":"integer"},"vendor_id":{"type":"integer"},"user_id":{"type":"integer"},"User":{"type":"object","properties":{"id":{"type":"integer"},"guid":{"type":"string","format":"uuid"},"name":{"type":"string"},"email":{"type":"string"}}}}}},"serverTimestamp":{"type":"string","format":"date-time","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Pass back as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"lastUpdatedAt"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" on the next call for delta sync."},"children":[]}]}]}]}},"required":["supplierVendorTokens","totalVendors"]}},"components/schemas/Catalog":{"id":"components/schemas/Catalog","kind":"json-schema","title":"Catalog","data":{"type":"object","properties":{"id":{"type":"integer"},"guid":{"type":"string","format":"uuid"},"supplier_id":{"type":"integer"},"name":{"type":"string","example":"Main Catalog"},"email":{"type":"string","nullable":true},"version":{"type":"string","nullable":true},"active":{"type":"boolean"},"order_item_type_id":{"type":"integer"},"currency_id":{"type":"integer","nullable":true},"order_prefix_override":{"type":"string","nullable":true,"description":"Prefix used for order numbers created from this catalog, if overridden."},"last_inventory_update":{"type":"string","format":"date-time","nullable":true},"Price_Groups":{"type":"array","items":{"$ref":"#/components/schemas/PriceGroup"}},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"}}}},"components/schemas/PriceGroup":{"id":"components/schemas/PriceGroup","kind":"json-schema","title":"PriceGroup","data":{"type":"object","properties":{"id":{"type":"integer"},"guid":{"type":"string","format":"uuid"},"catalog_id":{"type":"integer"},"value":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Price group name. This is the key used in a catalog item's "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"pricing"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" object."},"children":[]}]}]}],"example":"Wholesale"},"is_main":{"type":"boolean"},"percentage":{"type":"number","nullable":true},"price_upcharge_type_id":{"type":"integer","nullable":true},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"deleted_at":{"type":"string","format":"date-time","nullable":true}}}},"components/schemas/CatalogItem":{"id":"components/schemas/CatalogItem","kind":"json-schema","title":"CatalogItem","data":{"type":"object","description":"A product. With API key authentication the paged list endpoint returns exactly the fields below; other endpoints (and user session calls) return the full model, which has many more optional fields.","properties":{"id":{"type":"integer"},"guid":{"type":"string","format":"uuid"},"catalog_id":{"type":"integer"},"category_id":{"type":"integer","nullable":true},"sku":{"type":"string"},"upc":{"type":"string","nullable":true},"name":{"type":"string"},"description":{"type":"string","nullable":true},"manufacturer":{"type":"string","nullable":true},"color":{"type":"string","nullable":true},"style":{"type":"string","nullable":true},"active":{"type":"boolean"},"is_taxable":{"type":"boolean"},"msrp":{"type":"number","nullable":true},"cost_per_uom":{"type":"number","nullable":true,"description":"Supplier cost. Omitted for customer (vendor) users."},"pricing":{"type":"object","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Price per price group, keyed by price group name. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"\"N/A\""},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" means not offered to that group."},"children":[]}]}]}],"additionalProperties":{"oneOf":[{"type":"number"},{"type":"string","enum":["N/A"]}]},"example":{"Retail":99.99,"Wholesale":79.99,"Distributor":"N/A"}},"has_inventory":{"type":"boolean","description":"Whether stock is tracked for this item."},"qty_on_hand":{"type":"number"},"qty_incoming":{"type":"number"},"reserved_qty_on_hand":{"type":"number"},"qty_backordered":{"type":"number"},"qty_held_for_backorders":{"type":"number"},"min_qty_on_hand":{"type":"number","nullable":true},"max_qty_on_hand":{"type":"number","nullable":true},"min_order_qty":{"type":"number","nullable":true},"allow_backorder":{"type":"boolean"},"qty_break":{"type":"number","nullable":true,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Quantity at which "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"qty_break_price"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" applies."},"children":[]}]}]}]},"qty_break_price":{"type":"number","nullable":true},"has_serials":{"type":"boolean"},"has_lots":{"type":"boolean"},"has_exp_date":{"type":"boolean"},"width":{"type":"number","nullable":true},"height":{"type":"number","nullable":true},"depth":{"type":"number","nullable":true},"item_weight":{"type":"number","nullable":true},"shipping_weight":{"type":"number","nullable":true},"is_product_group":{"type":"boolean"},"product_group_type":{"type":"string","nullable":true,"enum":["flat","multi",null]},"product_group_display_style":{"type":"string","nullable":true},"group_parent_catalog_item_id":{"type":"integer","nullable":true},"group_sequence":{"type":"integer","nullable":true},"group_title":{"type":"string","nullable":true},"subsection_id":{"type":"integer","nullable":true},"third_party_sku":{"type":"string","nullable":true},"third_party_pricing":{"type":"string","nullable":true},"third_party_size":{"type":"string","nullable":true},"Category":{"$ref":"#/components/schemas/Category"},"CategoryHierarchy":{"type":"array","description":"Root-to-leaf category path, when category retrieval is not skipped.","items":{"$ref":"#/components/schemas/Category"}},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"deleted_at":{"type":"string","format":"date-time","nullable":true,"description":"Present only in delta-sync responses for soft-deleted items."}}}},"components/schemas/Category":{"id":"components/schemas/Category","kind":"json-schema","title":"Category","data":{"type":"object","properties":{"id":{"type":"integer"},"guid":{"type":"string","format":"uuid"},"catalog_id":{"type":"integer"},"parent_category_id":{"type":"integer","nullable":true},"name":{"type":"string"},"sequence":{"type":"integer","nullable":true},"hide_category":{"type":"boolean"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"}}}},"components/schemas/CatalogItemsPage":{"id":"components/schemas/CatalogItemsPage","kind":"json-schema","title":"CatalogItemsPage","data":{"type":"object","properties":{"catalog_items":{"type":"array","items":{"$ref":"#/components/schemas/CatalogItem"}},"totalCatalogItems":{"type":"integer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Total items in the catalog (0 when "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"skipTotalCount=true"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]}]}]}]},"hasMoreItems":{"type":"boolean"},"resource":{"type":"string","example":"catalog_items"},"serverTimestamp":{"type":"string","format":"date-time","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Pass back as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"lastUpdatedAt"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" on the next call for delta sync."},"children":[]}]}]}]}},"required":["catalog_items","totalCatalogItems","hasMoreItems","resource"]}},"components/schemas/BatchRequest":{"id":"components/schemas/BatchRequest","kind":"json-schema","title":"BatchRequest","data":{"type":"object","properties":{"type":{"type":"string","enum":["id","guid"],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Whether "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"values"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" holds numeric ids or GUIDs."},"children":[]}]}]}]},"values":{"type":"array","minItems":1,"items":{"oneOf":[{"type":"integer"},{"type":"string","format":"uuid"}]}}},"required":["type","values"],"example":{"type":"guid","values":["0f5a4b1e-1c9c-4d1a-9b8e-6f4a2a3c1d10","7a1d2e3f-4b5c-4d6e-8f90-a1b2c3d4e5f6"]}}},"components/schemas/TypeaheadRequest":{"id":"components/schemas/TypeaheadRequest","kind":"json-schema","title":"TypeaheadRequest","data":{"type":"object","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Search filters. Only "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is commonly needed; a 12-digit numeric "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" triggers a UPC lookup instead of a text search."},"children":[]}]}]}],"properties":{"name":{"type":"string","description":"Search term. Matches name, SKU and description. Empty string returns the first page of the catalog.","example":"widget"},"limit":{"type":"integer","default":10},"offset":{"type":"integer","default":0,"description":"Zero-based page number."},"priceGroupGuid":{"type":"string","format":"uuid","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Return only items offered to this price group, with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"pricing"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" reduced to that group's price."},"children":[]}]}]}]},"orderGuid":{"type":"string","format":"uuid","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Use the price group of this order (alternative to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"priceGroupGuid"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]}]}]}]},"categoryGuid":{"type":"string","format":"uuid"},"categoryId":{"type":"integer"},"includeSubcategories":{"type":"boolean","description":"With a category filter, also match items in its subcategories."},"onlyActive":{"type":"boolean"},"onlyWithSerials":{"type":"boolean"},"includeTotal":{"type":"boolean","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Populate "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"totalCatalogItems"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (costs an extra count query)."},"children":[]}]}]}]},"includeKitItems":{"type":"boolean"},"includeAttributes":{"type":"boolean"},"includeOptions":{"type":"boolean"},"includeRootCategories":{"type":"boolean","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Also return the catalog's root categories in "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"categories"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},"ignoreProductGroups":{"type":"boolean","description":"Return individual items instead of their product groups."},"singleWildcard":{"type":"boolean","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Match "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"PHRASE%"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (prefix) instead of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"%PHRASE%"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (contains)."},"children":[]}]}]}]},"priceRange":{"type":"object","properties":{"minPrice":{"type":"number"},"maxPrice":{"type":"number"},"priceField":{"type":"string","enum":["msrp","map","cost_per_uom","min_price"],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Field to filter on when no price group is given. Defaults to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"msrp"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]}}},"options":{"type":"object","description":"Field-level search switches and attribute filters.","properties":{"searchName":{"type":"boolean"},"searchSku":{"type":"boolean"},"searchDescription":{"type":"boolean"},"searchUpc":{"type":"boolean"},"attributes":{"type":"object","description":"Attribute name to required value (string, number, boolean, range object or list).","additionalProperties":true}}},"state":{"type":"string","description":"Opaque value echoed back in the response, for correlating concurrent requests."}}}},"components/schemas/TypeaheadResponse":{"id":"components/schemas/TypeaheadResponse","kind":"json-schema","title":"TypeaheadResponse","data":{"type":"object","properties":{"catalog_items":{"type":"array","items":{"$ref":"#/components/schemas/CatalogItem"}},"totalCatalogItems":{"type":"integer"},"resource":{"type":"string","example":"catalog_items"},"offset":{"type":"integer","nullable":true},"state":{"type":"string"},"categories":{"type":"array","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Root categories, when "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"includeRootCategories"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" was true."},"children":[]}]}]}],"items":{"$ref":"#/components/schemas/Category"}}},"required":["catalog_items","resource"]}},"components/schemas/SkuLookupRequest":{"id":"components/schemas/SkuLookupRequest","kind":"json-schema","title":"SkuLookupRequest","data":{"type":"object","properties":{"catalogGuid":{"type":"string","format":"uuid"},"skuName":{"type":"string","description":"Exact SKU to match (case-insensitive, trimmed).","example":"WIDGET-001"}},"required":["catalogGuid","skuName"]}},"components/schemas/Order":{"id":"components/schemas/Order","kind":"json-schema","title":"Order","data":{"type":"object","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A sales order. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"GET /v1/orders"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" returns a reduced projection (the header fields plus id/guid/name of each related record); the single-order and create endpoints return the full model with all relations."},"children":[]}]}]}],"properties":{"id":{"type":"integer"},"guid":{"type":"string","format":"uuid"},"name":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Order number as displayed, e.g. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"ABC-10000"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},"api_guid":{"type":"string","nullable":true,"description":"Client-supplied idempotency key, when the order was created through the API."},"supplier_id":{"type":"integer"},"vendor_id":{"type":"integer","nullable":true},"user_id":{"type":"integer","nullable":true},"catalog_id":{"type":"integer","nullable":true},"price_group_id":{"type":"integer","nullable":true},"category_id":{"type":"integer","nullable":true},"parent_order_id":{"type":"integer","nullable":true},"client_id":{"type":"integer","nullable":true},"project_id":{"type":"integer","nullable":true},"sales_rep_id":{"type":"integer","nullable":true},"ship_to_id":{"type":"integer","nullable":true},"order_state_id":{"type":"integer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Current workflow state id (1 = PRELIMINARY, 2 = SUBMITTED, 8 = SHIPPED, 9 = COMPLETED, 23 = CANCELLED, ...)."},"children":[]}]}]}]},"order_source_id":{"type":"integer","nullable":true,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Origin of the order (1 = ORDERWERKS, 20 = OTHER, 21 = APP, ...)."},"children":[]}]}]}]},"po_no":{"type":"string","nullable":true},"invoice_no":{"type":"string","nullable":true},"description":{"type":"string","nullable":true},"note":{"type":"string","nullable":true},"internal_note":{"type":"string","nullable":true},"shipping_instructions":{"type":"string","nullable":true},"is_quote":{"type":"boolean"},"is_sample":{"type":"boolean"},"is_local_pickup":{"type":"boolean"},"is_local_delivery":{"type":"boolean"},"is_shipped":{"type":"boolean"},"partially_shipped":{"type":"boolean"},"is_on_hold":{"type":"boolean"},"is_cancelled":{"type":"boolean"},"sub_total":{"type":"number","nullable":true},"tax":{"type":"number","nullable":true},"shipping":{"type":"number","nullable":true},"labor":{"type":"number","nullable":true},"discount":{"type":"number","nullable":true},"discount_total":{"type":"number","nullable":true},"other":{"type":"number","nullable":true},"grand_total":{"type":"number","nullable":true},"delivery_date":{"type":"string","nullable":true},"ship_date":{"type":"string","nullable":true},"do_not_ship_before_date":{"type":"string","nullable":true},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"Order_Items":{"type":"array","items":{"$ref":"#/components/schemas/OrderItem"}},"Ship_To":{"$ref":"#/components/schemas/Address"},"Vendor":{"$ref":"#/components/schemas/Vendor"},"Catalog":{"$ref":"#/components/schemas/Catalog"},"Price_Group":{"$ref":"#/components/schemas/PriceGroup"},"Category":{"$ref":"#/components/schemas/Category"},"Order_State":{"type":"object","properties":{"id":{"type":"integer"},"guid":{"type":"string","format":"uuid"},"name":{"type":"string"}}},"User":{"type":"object","description":"User who created the order.","properties":{"id":{"type":"integer"},"guid":{"type":"string","format":"uuid"},"name":{"type":"string"},"email":{"type":"string"}}},"Supplier":{"type":"object","properties":{"id":{"type":"integer"},"guid":{"type":"string","format":"uuid"},"name":{"type":"string"},"email":{"type":"string"}}},"Client":{"type":"object","nullable":true,"description":"End client on behalf of whom the customer placed the order, if any.","properties":{"id":{"type":"integer"},"guid":{"type":"string","format":"uuid"},"name":{"type":"string"}}},"Parent_Order":{"type":"object","nullable":true,"properties":{"id":{"type":"integer"},"guid":{"type":"string","format":"uuid"},"name":{"type":"string"}}},"Order_Detail":{"type":"object","nullable":true,"description":"Supplier-specific extra fields.","additionalProperties":true},"Order_State_Logs":{"type":"array","description":"State transition history.","items":{"type":"object","properties":{"created_at":{"type":"string","format":"date-time"},"User":{"type":"object","properties":{"name":{"type":"string"},"email":{"type":"string"}}},"Order_State":{"type":"object","properties":{"name":{"type":"string"}}}}}},"Assigned_Users":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"guid":{"type":"string","format":"uuid"},"name":{"type":"string"},"email":{"type":"string"}}}}}}},"components/schemas/OrderItem":{"id":"components/schemas/OrderItem","kind":"json-schema","title":"OrderItem","data":{"type":"object","description":"A line on an order. Additional internal fields may be present.","properties":{"id":{"type":"integer"},"guid":{"type":"string","format":"uuid"},"order_id":{"type":"integer"},"catalog_item_id":{"type":"integer"},"catalog_item_guid":{"type":"string","format":"uuid"},"parent_order_item_id":{"type":"integer","nullable":true},"item_no":{"type":"integer","description":"Line number within the order."},"sku":{"type":"string","nullable":true},"name":{"type":"string","nullable":true},"description":{"type":"string","nullable":true},"qty":{"type":"number","description":"Quantity ordered. Never reduced by shipments."},"qty_shipped":{"type":"number","nullable":true},"qty_backordered":{"type":"number","nullable":true},"qty_pending":{"type":"number","nullable":true},"qty_reserved":{"type":"number","nullable":true},"is_manual_price":{"type":"boolean"},"list_price_frozen":{"type":"number","nullable":true,"description":"Unit price captured when the line was created."},"net_price":{"type":"number","nullable":true},"discount":{"type":"number","nullable":true},"discount_total":{"type":"number","nullable":true},"tax":{"type":"number","nullable":true},"total":{"type":"number","nullable":true},"is_credit":{"type":"boolean"},"is_backordered":{"type":"boolean"},"note":{"type":"string","nullable":true},"width":{"type":"number","nullable":true},"height":{"type":"number","nullable":true},"depth":{"type":"number","nullable":true},"selected_options":{"type":"array","nullable":true,"items":{"type":"object","additionalProperties":true}},"Catalog_Item":{"$ref":"#/components/schemas/CatalogItem"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"}}}},"components/schemas/OrderInput":{"id":"components/schemas/OrderInput","kind":"json-schema","title":"OrderInput","data":{"type":"object","description":"Order header fields accepted on create.","properties":{"api_guid":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Your idempotency key for this order (unique per supplier). A retry with the same value returns the existing order instead of creating a duplicate. Honored by "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"POST /v1/orderWithItems"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"4c0d3e2a-8f7b-4c1e-9a6d-0b1c2d3e4f5a"},"name":{"type":"string","description":"Override the generated order number. Leave unset to let Orderwerks assign one."},"po_no":{"type":"string","description":"Customer purchase order number.","example":"PO-77812"},"note":{"type":"string","description":"Note visible to the customer."},"internal_note":{"type":"string","description":"Note visible to supplier users only."},"description":{"type":"string"},"is_quote":{"type":"boolean","default":false},"is_sample":{"type":"boolean","default":false},"shipping_instructions":{"type":"string"},"is_local_pickup":{"type":"boolean"},"is_local_delivery":{"type":"boolean"},"shipping":{"type":"number","description":"Manual shipping charge."},"do_not_ship_before_date":{"type":"string","format":"date"},"shipstation_carrierCode":{"type":"string"},"shipstation_serviceType":{"type":"string"},"shipstation_packageType":{"type":"string"}}}},"components/schemas/OrderItemInput":{"id":"components/schemas/OrderItemInput","kind":"json-schema","title":"OrderItemInput","data":{"type":"object","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A line to add. Identify the product by "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"catalog_item_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"catalog_item_guid"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"properties":{"catalog_item_id":{"type":"integer"},"catalog_item_guid":{"type":"string","format":"uuid"},"qty":{"type":"number","example":12},"item_no":{"type":"integer","description":"Line number. Assigned sequentially when omitted."},"price_group_id":{"type":"integer","description":"Price the line from this price group instead of the order's."},"is_manual_price":{"type":"boolean","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When true, "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"list_price_frozen"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is used as the unit price instead of catalog pricing."},"children":[]}]}]}]},"list_price_frozen":{"type":"number","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Manual unit price. Only honored when "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"is_manual_price"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is true."},"children":[]}]}]}]},"note":{"type":"string"},"description":{"type":"string"},"name":{"type":"string"},"width":{"type":"number"},"height":{"type":"number"},"depth":{"type":"number"},"selected_options":{"type":"array","description":"Chosen item options for configurable products.","items":{"type":"object","additionalProperties":true}},"itemOptionValues":{"type":"array","items":{"type":"object","properties":{"item_option_id":{"type":"integer"},"value":{"description":"Option value; type depends on the option."}}}}},"required":["qty"]}},"components/schemas/CreateOrderV2Request":{"id":"components/schemas/CreateOrderV2Request","kind":"json-schema","title":"CreateOrderV2Request","data":{"type":"object","properties":{"vendorGuid":{"type":"string","format":"uuid","description":"Customer placing the order."},"catalogGuid":{"type":"string","format":"uuid"},"priceGroupGuid":{"type":"string","format":"uuid"},"order":{"$ref":"#/components/schemas/OrderInput"},"orderItems":{"type":"array","minItems":1,"items":{"$ref":"#/components/schemas/OrderItemInput"}},"orderDetails":{"type":"object","description":"Supplier-specific extra order fields.","additionalProperties":true},"shipTo":{"$ref":"#/components/schemas/AddressInput"},"client":{"type":"object","description":"End client the customer is ordering for. Creates a client record linked to the order.","properties":{"name":{"type":"string"},"email":{"type":"string"},"phone":{"type":"string"}},"required":["name"]},"source":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Order source, as a name ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"OTHER"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"APP"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"SHOPIFY"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", ...) or its numeric id."},"children":[]}]}]}],"oneOf":[{"type":"string"},{"type":"integer"}],"example":"OTHER"},"remainInPreliminary":{"type":"boolean","default":false,"description":"When true the order stays in PRELIMINARY instead of being submitted into the workflow."}},"required":["vendorGuid","catalogGuid","priceGroupGuid","order","orderItems"]}},"components/schemas/CreateOrderWithItemsRequest":{"id":"components/schemas/CreateOrderWithItemsRequest","kind":"json-schema","title":"CreateOrderWithItemsRequest","data":{"type":"object","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Either act for an existing customer (send the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"vendorGuid"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" header) or create one inline with the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"newVendor*"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" fields, in which case the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"vendorGuid"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" header is ignored."},"children":[]}]}]}],"properties":{"catalogGuid":{"type":"string","format":"uuid"},"priceGroupGuid":{"type":"string","format":"uuid"},"order":{"$ref":"#/components/schemas/OrderInput"},"orderItems":{"type":"array","minItems":1,"items":{"$ref":"#/components/schemas/OrderItemInput"}},"orderDetails":{"type":"object","description":"Supplier-specific extra order fields.","additionalProperties":true},"shipTo":{"$ref":"#/components/schemas/AddressInput"},"source":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Order source, as a name ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"OTHER"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"APP"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", ...) or its numeric id."},"children":[]}]}]}],"oneOf":[{"type":"string"},{"type":"integer"}]},"workflowGuid":{"type":"string","format":"uuid","description":"Workflow to run the order through, for suppliers with multiple workflows. Defaults to the supplier's default workflow."},"newVendor":{"$ref":"#/components/schemas/VendorInput"},"newVendorBillTo":{"$ref":"#/components/schemas/AddressInput"},"newVendorShipTo":{"$ref":"#/components/schemas/AddressInput"},"newVendorContact":{"$ref":"#/components/schemas/VendorContactInput"},"newVendorNote":{"type":"string"},"remainInPreliminary":{"type":"boolean","description":"When true the order stays in PRELIMINARY. When omitted, the supplier setting \"remain in preliminary\" decides; when false the order is submitted."},"utm":{"type":"object","description":"UTM attribution captured by the client, stamped onto the order.","additionalProperties":{"type":"string"}}},"required":["catalogGuid","priceGroupGuid","order","orderItems"]}},"components/schemas/CreateOrderWithItemsResponse":{"id":"components/schemas/CreateOrderWithItemsResponse","kind":"json-schema","title":"CreateOrderWithItemsResponse","data":{"type":"object","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"vendor"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"billTo"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"shipTo"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"contact"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"note"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" fields are present only when the request created (or matched) that record."},"children":[]}]}]}],"properties":{"order":{"$ref":"#/components/schemas/Order"},"vendor":{"$ref":"#/components/schemas/Vendor"},"billTo":{"$ref":"#/components/schemas/EntityRef"},"shipTo":{"$ref":"#/components/schemas/EntityRef"},"contact":{"$ref":"#/components/schemas/EntityRef"},"note":{"$ref":"#/components/schemas/EntityRef"}},"required":["order"]}},"components/schemas/CreateOrderV1Request":{"id":"components/schemas/CreateOrderV1Request","kind":"json-schema","title":"CreateOrderV1Request","data":{"type":"object","description":"Creates an empty order header. Lines are added afterwards through the order-entry endpoints or the web app.","properties":{"catalogGuid":{"type":"string","format":"uuid"},"priceGroupGuid":{"type":"string","format":"uuid"},"api_guid":{"type":"string","description":"Your idempotency key for this order."},"po_no":{"type":"string"},"note":{"type":"string"},"internal_note":{"type":"string"},"description":{"type":"string"},"is_quote":{"type":"boolean"},"is_sample":{"type":"boolean"},"is_template":{"type":"boolean"},"category_id":{"type":"integer"},"project_id":{"type":"integer"},"shipping_instructions":{"type":"string"},"is_local_pickup":{"type":"boolean"},"is_local_delivery":{"type":"boolean"},"is_dropship":{"type":"boolean"},"shipping":{"type":"number"},"tax":{"type":"number"},"workflow_id":{"type":"integer"},"allow_substitutions":{"type":"boolean"},"allow_backorders":{"type":"boolean"},"do_not_ship_before_date":{"type":"string","format":"date"},"cancel_date":{"type":"string","format":"date"},"tags":{"type":"array","items":{"type":"integer"}},"orderDetails":{"type":"object","additionalProperties":true}}}},"components/schemas/UpdateOrderRequest":{"id":"components/schemas/UpdateOrderRequest","kind":"json-schema","title":"UpdateOrderRequest","data":{"type":"object","description":"Partial update; only supplied fields change. The order must not be read-only at its current workflow step for the caller's user type.","properties":{"name":{"type":"string"},"po_no":{"type":"string"},"note":{"type":"string"},"internal_note":{"type":"string"},"invoice_no":{"type":"string"},"vendor_id":{"type":"integer"},"catalog_id":{"type":"integer"},"price_group_id":{"type":"integer","nullable":true},"project_id":{"type":"integer"},"client_id":{"type":"integer"},"is_sample":{"type":"boolean"},"is_on_hold":{"type":"boolean"},"is_cancelled":{"type":"boolean"},"is_local_delivery":{"type":"boolean"},"shipping":{"type":"number"},"clear_manual_shipping_fee":{"type":"boolean"},"labor":{"type":"number"},"price_adjustment":{"type":"number"},"discount":{"type":"number"},"discount_type_id":{"type":"integer"},"tax_rate_override":{"type":"number","nullable":true},"Ship_To":{"$ref":"#/components/schemas/AddressInput"},"save_address_to_vendor":{"type":"boolean","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Also save "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Ship_To"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" as the customer's default shipping address."},"children":[]}]}]}]},"shipping_warehouse_id":{"type":"integer"},"workflow_id":{"type":"integer","nullable":true},"allow_substitutions":{"type":"boolean"},"allow_backorders":{"type":"boolean"},"approve_decline":{"type":"string","nullable":true,"enum":["APPROVE","DECLINE",null],"description":"Approve or decline a quote."},"tags":{"type":"array","nullable":true,"items":{"type":"integer"}},"do_not_ship_before_date":{"type":"string","format":"date","nullable":true},"cancel_date":{"type":"string","format":"date","nullable":true},"assignedUsers":{"type":"array","items":{"type":"object","properties":{"guid":{"type":"string","format":"uuid"}}}},"details":{"type":"object","description":"Supplier-specific extra order fields.","additionalProperties":true}}}},"components/schemas/SubmitOrderRequest":{"id":"components/schemas/SubmitOrderRequest","kind":"json-schema","title":"SubmitOrderRequest","data":{"type":"object","properties":{"orderGuid":{"type":"string","format":"uuid"},"order_state_id":{"type":"integer","description":"Target workflow state. Defaults to the next step in the order's workflow."},"stateChangeNote":{"type":"string","description":"Note shown to the customer with the state change."},"stateChangeInternalNote":{"type":"string"},"skipInventoryCheck":{"type":"boolean"},"allowPartialFulfillment":{"type":"boolean","description":"When true, reserve what is available and auto-create a backorder for the rest. When false, backorder the whole order if anything is short. When omitted, allocate what is available without creating a backorder."},"useHeldInventory":{"type":"boolean","description":"Draw from inventory held for backorders before on-hand stock."},"skipPendingItemsCheck":{"type":"boolean"},"pendingItemsAction":{"type":"string","enum":["backorder","remove","zero_out"],"description":"What to do with pending backorder lines when moving into a release state."},"customMessage":{"type":"string","description":"Custom text merged into the outbound email for steps that allow it."}},"required":["orderGuid"]}},"components/schemas/ReconcileErrors":{"id":"components/schemas/ReconcileErrors","kind":"json-schema","title":"ReconcileErrors","data":{"type":"object","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Returned with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" when the order cannot be created as requested."},"children":[]}]}]}],"properties":{"isValid":{"type":"boolean","example":false},"inactiveAccount":{"type":"boolean","description":"The customer account is inactive."},"noAccountAccess":{"type":"boolean","description":"The caller may not order for this customer."},"message":{"type":"string"},"errors":{"type":"array","description":"One entry per line that failed validation.","items":{"type":"object","properties":{"sku":{"type":"string"},"name":{"type":"string"},"active":{"type":"boolean"},"inventoryAvailable":{"type":"number"}}}}},"required":["isValid","errors"]}},"components/schemas/SubmitOrderError":{"id":"components/schemas/SubmitOrderError","kind":"json-schema","title":"SubmitOrderError","data":{"type":"object","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Returned with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"422"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" when the order cannot move to the requested state."},"children":[]}]}]}],"properties":{"success":{"type":"boolean","example":false},"errorType":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Present for "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"PendingItemsOnRelease"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"SerialsNotAssigned"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"enum":["PendingItemsOnRelease","SerialsNotAssigned"]},"message":{"type":"string"},"items":{"type":"array","description":"The lines that blocked the transition.","items":{"type":"object","additionalProperties":true}}},"required":["success","message"]}},"schema_22":{"kind":"json-schema","data":{"type":"integer","minimum":1,"maximum":100,"default":25},"id":"schema_22"},"schema_23":{"kind":"json-schema","data":{"type":"integer","minimum":0,"default":0},"id":"schema_23"},"schema_24":{"kind":"json-schema","data":{"type":"string","example":"2026-09-01T14:00:00.000Z"},"id":"schema_24"},"schema_25":{"kind":"json-schema","data":{"type":"string"},"id":"schema_25"},"schema_26":{"kind":"json-schema","data":{"type":"string","enum":["true","false"]},"id":"schema_26"},"schema_27":{"kind":"json-schema","data":{"type":"string","enum":["asc","desc"]},"id":"schema_27"},"schema_28":{"kind":"json-schema","data":{"type":"string","format":"uuid"},"id":"schema_28"},"schema_29":{"kind":"json-schema","data":{"type":"object","properties":{"vendorModel":{"$ref":"#/components/schemas/Vendor"},"resource":{"type":"string","example":"vendor"}}},"id":"schema_29"},"schema_30":{"kind":"json-schema","data":{"type":"object","properties":{"catalogs":{"type":"array","items":{"$ref":"#/components/schemas/Catalog"}},"resource":{"type":"string","example":"Catalog"},"catalogsDetails":{"type":"array","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Present when "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"checkIfHasCategories=true"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"items":{"type":"object","properties":{"catalogGuid":{"type":"string","format":"uuid"},"catalogName":{"type":"string"},"catalogId":{"type":"integer"},"hasCategories":{"type":"boolean"}}}}},"required":["catalogs","resource"]},"id":"schema_30"},"schema_31":{"kind":"json-schema","data":{"type":"object","properties":{"catalog_item":{"$ref":"#/components/schemas/CatalogItem"},"resource":{"type":"string","example":"catalog_item"}},"required":["catalog_item","resource"]},"id":"schema_31"},"schema_32":{"kind":"json-schema","data":{"type":"object","properties":{"catalog_items":{"type":"array","items":{"$ref":"#/components/schemas/CatalogItem"}},"resource":{"type":"string","example":"catalog_items"}},"required":["catalog_items","resource"]},"id":"schema_32"},"schema_33":{"kind":"json-schema","data":{"type":"object","properties":{"catalog_items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"},"sku":{"type":"string","nullable":true},"description":{"type":"string","nullable":true}}}},"resource":{"type":"string","example":"catalog_items"}},"required":["catalog_items","resource"]},"id":"schema_33"},"schema_34":{"kind":"json-schema","data":{"type":"object","properties":{"priceGroups":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"guid":{"type":"string","format":"uuid"},"name":{"type":"string","example":"Wholesale"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"}}}}},"required":["priceGroups"]},"id":"schema_34"},"schema_35":{"kind":"json-schema","data":{"type":"object","properties":{"orders":{"type":"array","items":{"$ref":"#/components/schemas/Order"}},"count":{"type":"integer","description":"Number of orders in this page (not the total)."}},"required":["orders","count"]},"id":"schema_35"},"schema_36":{"kind":"json-schema","data":{"type":"object","properties":{"success":{"type":"boolean"},"orders":{"type":"array","items":{"$ref":"#/components/schemas/Order"}},"totalOrders":{"type":"integer"},"resource":{"type":"string","example":"order"}},"required":["success","orders","totalOrders"]},"id":"schema_36"},"schema_37":{"kind":"json-schema","data":{"type":"object","properties":{"order":{"$ref":"#/components/schemas/Order"},"relatedOrders":{"type":"array","items":{"$ref":"#/components/schemas/Order"}}},"required":["order","relatedOrders"]},"id":"schema_37"},"schema_38":{"kind":"json-schema","data":{"type":"object","properties":{"success":{"type":"boolean","example":false},"message":{"type":"string"},"currentStep":{"type":"string"},"stepNumber":{"type":"integer"}}},"id":"schema_38"},"schema_39":{"kind":"json-schema","data":{"type":"object","properties":{"order":{"$ref":"#/components/schemas/Order"}},"required":["order"]},"id":"schema_39"},"schema_40":{"kind":"json-schema","data":{"type":"string","enum":["Invalid API Payload","Error Locating Account","Error Setting Up Order Accounts"]},"id":"schema_40"},"schema_41":{"kind":"json-schema","data":{"type":"object","properties":{"message":{"type":"string"},"isValid":{"type":"boolean","example":false}}},"id":"schema_41"},"schema_42":{"kind":"json-schema","data":{"type":"object","properties":{"message":{"type":"string"},"errMessage":{"type":"string"},"noAccountAccess":{"type":"boolean"},"inactiveAccount":{"type":"boolean"},"isValid":{"type":"boolean","example":false}}},"id":"schema_42"},"schema_43":{"kind":"json-schema","data":{"type":"object","properties":{"order":{"$ref":"#/components/schemas/Order"},"autoFulfilledItems":{"type":"array","description":"Pending backorder lines that were fulfilled from stock during a release transition.","items":{"type":"object","properties":{"orderItemId":{"type":"integer"},"catalogItemName":{"type":"string"},"catalogItemSku":{"type":"string"},"qtyFulfilled":{"type":"number"},"qtyFromHeld":{"type":"number"},"qtyFromOnHand":{"type":"number"}}}}},"required":["order"]},"id":"schema_43"}},"exampleStore":{"paths/~1vendors/get/responses/401/content/application~1json/example":{"value":{"message":"Unauthorized"},"id":"paths/~1vendors/get/responses/401/content/application~1json/example"},"paths/~1vendors/get/responses/403/content/application~1json/example":{"value":{"message":"Forbidden"},"id":"paths/~1vendors/get/responses/403/content/application~1json/example"},"paths/~1vendors/post/requestBody/content/application~1json/example":{"value":{"newVendor":{"name":"Acme, Inc.","email":"orders@acme.example","phone":"555-0100","customer_internal_id":"ACME-001"},"newVendorBillTo":{"name":"Accounts Payable","company_name":"Acme, Inc.","address_line_one":"123 Any Street","city":"Anytown","state":"CA","postal_code":"12345","country":"US"},"newVendorShipTo":{"name":"Receiving","company_name":"Acme, Inc.","address_line_one":"400 Warehouse Road","city":"Anytown","state":"CA","postal_code":"12345","country":"US"},"newVendorContact":{"name":"Jane Doe","email":"jane@acme.example"}},"id":"paths/~1vendors/post/requestBody/content/application~1json/example"},"paths/~1vendors/post/responses/401/content/application~1json/example":{"value":{"message":"Unauthorized"},"id":"paths/~1vendors/post/responses/401/content/application~1json/example"},"paths/~1v1~1vendors~1{vendorGuid}/get/responses/401/content/application~1json/example":{"value":{"message":"Unauthorized"},"id":"paths/~1v1~1vendors~1{vendorGuid}/get/responses/401/content/application~1json/example"},"paths/~1v1~1vendors~1{vendorGuid}/get/responses/403/content/application~1json/example":{"value":{"message":"Forbidden"},"id":"paths/~1v1~1vendors~1{vendorGuid}/get/responses/403/content/application~1json/example"},"paths/~1v1~1vendors~1{vendorGuid}/put/requestBody/content/application~1json/example":{"value":{"name":"Acme, Inc.","email":"orders@acme.example","options":{"price_group_id":12,"require_po":true}},"id":"paths/~1v1~1vendors~1{vendorGuid}/put/requestBody/content/application~1json/example"},"paths/~1v1~1vendors~1{vendorGuid}/put/responses/401/content/application~1json/example":{"value":{"message":"Unauthorized"},"id":"paths/~1v1~1vendors~1{vendorGuid}/put/responses/401/content/application~1json/example"},"paths/~1v1~1vendors~1{vendorGuid}/put/responses/403/content/application~1json/example":{"value":{"message":"Forbidden"},"id":"paths/~1v1~1vendors~1{vendorGuid}/put/responses/403/content/application~1json/example"},"paths/~1v1~1catalogs/get/responses/401/content/application~1json/example":{"value":{"message":"Unauthorized"},"id":"paths/~1v1~1catalogs/get/responses/401/content/application~1json/example"},"paths/~1v1~1catalogs/get/responses/403/content/application~1json/example":{"value":{"message":"Forbidden"},"id":"paths/~1v1~1catalogs/get/responses/403/content/application~1json/example"},"paths/~1v1~1catalog~1{catalogGuid}~1catalog_items/get/responses/401/content/application~1json/example":{"value":{"message":"Unauthorized"},"id":"paths/~1v1~1catalog~1{catalogGuid}~1catalog_items/get/responses/401/content/application~1json/example"},"paths/~1v1~1catalog~1{catalogGuid}~1catalog_items/get/responses/403/content/application~1json/example":{"value":{"message":"Forbidden"},"id":"paths/~1v1~1catalog~1{catalogGuid}~1catalog_items/get/responses/403/content/application~1json/example"},"paths/~1v1~1catalog~1{catalogGuid}~1catalog_items~1{catalogItemGuid}/get/responses/401/content/application~1json/example":{"value":{"message":"Unauthorized"},"id":"paths/~1v1~1catalog~1{catalogGuid}~1catalog_items~1{catalogItemGuid}/get/responses/401/content/application~1json/example"},"paths/~1v1~1catalog~1{catalogGuid}~1catalog_items~1{catalogItemGuid}/get/responses/403/content/application~1json/example":{"value":{"message":"Forbidden"},"id":"paths/~1v1~1catalog~1{catalogGuid}~1catalog_items~1{catalogItemGuid}/get/responses/403/content/application~1json/example"},"paths/~1v1~1catalog~1{catalogGuid}~1catalog_items~1batch/post/responses/401/content/application~1json/example":{"value":{"message":"Unauthorized"},"id":"paths/~1v1~1catalog~1{catalogGuid}~1catalog_items~1batch/post/responses/401/content/application~1json/example"},"paths/~1v1~1catalog~1{catalogGuid}~1catalog_items~1batch/post/responses/403/content/application~1json/example":{"value":{"message":"Forbidden"},"id":"paths/~1v1~1catalog~1{catalogGuid}~1catalog_items~1batch/post/responses/403/content/application~1json/example"},"paths/~1v1~1catalog~1{catalogGuid}~1catalog_items~1typeahead/post/requestBody/content/application~1json/example":{"value":{"name":"widget","limit":10,"offset":0,"onlyActive":true,"includeTotal":true,"priceGroupGuid":"0f5a4b1e-1c9c-4d1a-9b8e-6f4a2a3c1d10"},"id":"paths/~1v1~1catalog~1{catalogGuid}~1catalog_items~1typeahead/post/requestBody/content/application~1json/example"},"paths/~1v1~1catalog~1{catalogGuid}~1catalog_items~1typeahead/post/responses/401/content/application~1json/example":{"value":{"message":"Unauthorized"},"id":"paths/~1v1~1catalog~1{catalogGuid}~1catalog_items~1typeahead/post/responses/401/content/application~1json/example"},"paths/~1v1~1catalog~1{catalogGuid}~1catalog_items~1typeahead/post/responses/403/content/application~1json/example":{"value":{"message":"Forbidden"},"id":"paths/~1v1~1catalog~1{catalogGuid}~1catalog_items~1typeahead/post/responses/403/content/application~1json/example"},"paths/~1v1~1catalog_items~1sku-lookup/post/responses/401/content/application~1json/example":{"value":{"message":"Unauthorized"},"id":"paths/~1v1~1catalog_items~1sku-lookup/post/responses/401/content/application~1json/example"},"paths/~1v1~1catalog_items~1sku-lookup/post/responses/403/content/application~1json/example":{"value":{"message":"Forbidden"},"id":"paths/~1v1~1catalog_items~1sku-lookup/post/responses/403/content/application~1json/example"},"paths/~1v1~1{catalogGuid}~1catalogItems/get/responses/401/content/application~1json/example":{"value":{"message":"Unauthorized"},"id":"paths/~1v1~1{catalogGuid}~1catalogItems/get/responses/401/content/application~1json/example"},"paths/~1v1~1{catalogGuid}~1catalogItems/get/responses/403/content/application~1json/example":{"value":{"message":"Forbidden"},"id":"paths/~1v1~1{catalogGuid}~1catalogItems/get/responses/403/content/application~1json/example"},"paths/~1v1~1catalog~1{catalogGuid}~1price_groups/get/responses/401/content/application~1json/example":{"value":{"message":"Unauthorized"},"id":"paths/~1v1~1catalog~1{catalogGuid}~1price_groups/get/responses/401/content/application~1json/example"},"paths/~1v1~1orders~1list/get/responses/403/content/application~1json/example":{"value":{"message":"Forbidden"},"id":"paths/~1v1~1orders~1list/get/responses/403/content/application~1json/example"},"paths/~1v1~1orders~1{orderGuid}/put/requestBody/content/application~1json/example":{"value":{"po_no":"PO-77812","note":"Deliver to the rear dock."},"id":"paths/~1v1~1orders~1{orderGuid}/put/requestBody/content/application~1json/example"},"paths/~1v1~1orders~1{orderGuid}/put/responses/401/content/application~1json/example":{"value":{"message":"Unauthorized"},"id":"paths/~1v1~1orders~1{orderGuid}/put/responses/401/content/application~1json/example"},"paths/~1v2~1order/post/requestBody/content/application~1json/example":{"value":{"vendorGuid":"2b7c1d9e-3f4a-4b5c-8d6e-7f8091a2b3c4","catalogGuid":"0f5a4b1e-1c9c-4d1a-9b8e-6f4a2a3c1d10","priceGroupGuid":"9c8b7a6d-5e4f-4a3b-2c1d-0e9f8a7b6c5d","order":{"po_no":"PO-77812","note":"Deliver to the rear dock.","shipping_instructions":"Call on arrival"},"orderItems":[{"catalog_item_guid":"7a1d2e3f-4b5c-4d6e-8f90-a1b2c3d4e5f6","qty":12},{"catalog_item_guid":"1f2e3d4c-5b6a-4978-8a9b-0c1d2e3f4a5b","qty":2,"note":"Gift wrap"}],"shipTo":{"name":"Receiving","company_name":"Acme, Inc.","address_line_one":"400 Warehouse Road","city":"Anytown","state":"CA","postal_code":"12345","country":"US"},"source":"OTHER"},"id":"paths/~1v2~1order/post/requestBody/content/application~1json/example"},"paths/~1v1~1orderWithItems/post/requestBody/content/application~1json/example":{"value":{"catalogGuid":"0f5a4b1e-1c9c-4d1a-9b8e-6f4a2a3c1d10","priceGroupGuid":"9c8b7a6d-5e4f-4a3b-2c1d-0e9f8a7b6c5d","order":{"api_guid":"4c0d3e2a-8f7b-4c1e-9a6d-0b1c2d3e4f5a","po_no":"PO-77812"},"orderItems":[{"catalog_item_id":10432,"qty":6}],"newVendor":{"name":"New Retailer LLC","email":"buyer@newretailer.example"},"newVendorShipTo":{"name":"Receiving","address_line_one":"1 Main St","city":"Anytown","state":"CA","postal_code":"12345","country":"US"}},"id":"paths/~1v1~1orderWithItems/post/requestBody/content/application~1json/example"},"paths/~1v1~1order~1submit/post/requestBody/content/application~1json/example":{"value":{"orderGuid":"6d5c4b3a-2f1e-4d0c-9b8a-7f6e5d4c3b2a","allowPartialFulfillment":true},"id":"paths/~1v1~1order~1submit/post/requestBody/content/application~1json/example"}},"securitySchemeStore":{"ApiKey":{"id":"ApiKey","type":"apiKey","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Supplier API key. Always sent together with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"x-apiSecret"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"in":"header","paramName":"x-apiKey"},"ApiSecret":{"id":"ApiSecret","type":"apiKey","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Supplier API secret. Always sent together with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"x-apiKey"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"in":"header","paramName":"x-apiSecret"},"UserGuid":{"id":"UserGuid","type":"apiKey","description":"GUID of the authenticated user (user session headers).","in":"header","paramName":"userGuid"},"UserToken":{"id":"UserToken","type":"apiKey","description":"JWT issued to the user at login (user session headers).","in":"header","paramName":"userToken"},"SupplierGuid":{"id":"SupplierGuid","type":"apiKey","description":"GUID of the supplier account the user is acting in (user session headers).","in":"header","paramName":"supplierGuid"}},"servers":[{"url":"/_mock/openapi","isMockServer":true,"description":"Mock server"},{"url":"https://owapi.orderwerks.com","description":"Production"}],"logo":{"imageUrl":"https://www.orderwerks.com/assets/images/orderwerks-stacked-logo-grey.svg","altText":"Orderwerks"}},"options":{"layout":"three-panel","sortRequiredPropsFirst":true,"jsonSamplesExpandLevel":3,"schemasExpansionLevel":1,"hideDownloadButtons":false,"hideSidebar":true,"mockServer":{"url":"/_mock/openapi","position":"first","description":"Mock server"},"disableRouter":true,"downloadUrls":[{"url":"/_bundle/openapi.json?download"},{"url":"/_bundle/openapi.yaml?download"}],"excludeFromSearch":false,"specType":"openapi","markdocOptions":{"tags":{},"nodes":{},"components":{}},"metadata":{"title":"Orderwerks REST API","description":"The Orderwerks REST API lets integrators read and write customers (vendors), catalogs, catalog items,\nprice groups and orders for a supplier account.\n\n# Authentication\n\nEvery request must carry one of two header sets. Each endpoint lists which set it accepts under\n**Authorizations**.\n\n**API key and secret** (recommended for integrations): send `x-apiKey` and `x-apiSecret`. Requests\nauthenticated this way run as the supplier's master user. Add a `vendorGuid` header to act in the\ncontext of one customer, and optionally a `userGuid` header to attribute the call to a specific user.\n\n**User session headers** (used by the Orderwerks web and mobile apps): send `userGuid`, `userToken`\n(the JWT issued at login) and `supplierGuid`, plus `vendorGuid` when acting for a customer.\n\nAPI keys are created in the Orderwerks web app under Business Settings. The secret is shown once, at creation.\n\n# Conventions\n\n- Paths are versioned per resource (`/v1/...`, `/v2/...`); a few legacy paths have no version segment.\n- Responses are JSON. There is no common envelope; each endpoint documents its own shape.\n- Paged list endpoints take `limit` (default 25, maximum 100) and `offset`. `offset` is a **page number**,\n  not a row count: the server skips `offset * limit` rows.\n- Delta sync: list endpoints that return `serverTimestamp` accept it back as `lastUpdatedAt` on the next\n  call to fetch only rows changed since then. Soft-deleted rows are included in delta responses with\n  `deleted_at` set.\n- Errors return `4xx`/`5xx` with a JSON body of the form `{ \"message\": \"...\" }`. A few legacy endpoints\n  return a plain-text message instead; those are noted individually.\n\n# Terminology\n\nOrderwerks calls the business operating the account the **supplier**, and the customers who place orders\n**vendors** (also \"accounts\" or \"customers\" in the apps). Vendor endpoints are customer endpoints.\n"}},"baseSlug":"/openapi","routesMapping":{}}