iotoms Docs

Get vendor purchase prices for items

GET
/api/v1/procurement/vendors/{vendorId}/prices

Returns the purchase cost for several items from one vendor in a single call, as of asOf (defaults to today). Each entry says where the price came from: an agreed rate, the vendor's cost, the item's cost, or none. Selling prices are never used.

Authorization

BearerAuth
headerAuthorizationBearer <JWT>

Path Parameters

vendorId*string

ID of the vendor to price the items from (see List vendors).

Formatuuid

Query Parameters

itemIds*array<string>

Comma-separated item ids

asOf?string

Defaults to today

Formatdate

Header Parameters

X-TenantID*string

Your merchant's tenant code — the value typed in the Domain field on the iotoms login screen. See Concepts.

Response Body

OK

*/*
  1. response
status*string

Outcome of the call: SUCCESS when the request was processed; otherwise an error status.

message*string

Short human-readable message describing the outcome, e.g. which record was saved or why the call failed.

data?

The resolved purchase cost for each requested item from this vendor.

Example Request
curl -X GET 'https://beta.iotoms.com/api/v1/procurement/vendors/497f6eca-6276-4993-bfeb-53cbbbba6f08/prices?itemIds=string' \  -H 'X-TenantID: your-tenant-code'
Example Response
{  "status": "string",  "message": "string",  "data": {    "vendorId": "e9b57fab-1850-44d4-8499-71fd15c845a0",    "vendorName": "string",    "asOf": "2019-08-24",    "prices": [      {        "itemId": "string",        "itemName": "string",        "unitPrice": 0,        "origin": "string",        "sourceLabel": "string",        "currency": "string",        "taxInclusive": true,        "unitOfMeasure": "string",        "uomId": "4df47f00-a69d-4ff2-b50d-4a7649a4b70c",        "leadTimeDays": 0,        "minimumOrderQty": 0,        "agreedFrom": "2019-08-24",        "agreedTo": "2019-08-24",        "sourceDocumentNumber": "string",        "lapsedAgreedPrice": 0,        "lapsedAgreedTo": "2019-08-24"      }    ]  }}