iotoms Docs

Get a supplier quotation

GET
/api/v1/procurement/quotations/{id}

Returns one supplier quotation by ID with its header (vendor, dates, currency, total), all quoted lines and each line's award status. A DRAFT or RECEIVED quote whose validity date has passed reads as EXPIRED.

Authorization

BearerAuth
headerAuthorizationBearer <JWT>

Path Parameters

id*string

ID of the record (UUID).

Formatuuid

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?

The supplier quotation with its lines, as it now stands.

Example Request
curl -X GET 'https://beta.iotoms.com/api/v1/procurement/quotations/497f6eca-6276-4993-bfeb-53cbbbba6f08' \  -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"  }}