iotoms Docs

List supplier quotations

GET
/api/v1/procurement/quotations

Returns supplier quotations with their lines, newest first. Only one filter applies: rfqId if given (oldest first), otherwise vendorId, otherwise status. Not paginated.

Authorization

BearerAuth
headerAuthorizationBearer <JWT>

Query Parameters

rfqId?string

Only quotations answering this request for quote (from List requests for quote). Takes priority over the other filters.

Formatuuid
vendorId?string

Only quotations from this vendor (from List vendors). Used when rfqId is not given.

Formatuuid
status?string

Only quotations with this stored status, e.g. RECEIVED or AWARDED. Used only when neither rfqId nor vendorId is given.

Value in"DRAFT""RECEIVED""AWARDED""PARTIALLY_AWARDED""LOST""EXPIRED""CANCELLED"

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 worked, ERROR when it did not.

message*string

Short human-readable message describing the result, for logs or display; do not parse it.

data?array<>|

Supplier quotations matching the filter, each with its lines. Not paginated.

Example Request
curl -X GET 'https://beta.iotoms.com/api/v1/procurement/quotations' \  -H 'X-TenantID: your-tenant-code'
Example Response
{  "status": "string",  "message": "string",  "data": [    {      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",      "quoteNumber": "string",      "vendorQuoteRef": "string",      "rfqId": "5483c05b-f58d-4a80-82f1-a80d2c5d2632",      "rfqNumber": "string",      "vendorId": "e9b57fab-1850-44d4-8499-71fd15c845a0",      "vendorName": "string",      "quoteDate": "2019-08-24",      "validUntil": "2019-08-24",      "currency": "string",      "status": "string",      "expired": true,      "totalAmount": 0,      "notes": "string",      "items": [        {          "id": 0,          "rfqItemId": 0,          "itemId": "string",          "itemName": "string",          "quotedQty": 0,          "unitPrice": 0,          "extendedAmount": 0,          "unitOfMeasure": "string",          "uomId": "4df47f00-a69d-4ff2-b50d-4a7649a4b70c",          "leadTimeDays": 0,          "minimumOrderQty": 0,          "taxInclusive": true,          "awardStatus": "string",          "awardedQty": 0,          "purchaseOrderId": "84a099d9-2935-4997-a6ac-0d3ee9bbef72",          "notes": "string"        }      ],      "createdBy": "string",      "createdAt": "2019-08-24T14:15:22Z"    }  ]}