iotoms Docs

Update a supplier quotation

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

Edits a supplier quotation's header and, if items is sent, replaces all its lines; the total is recalculated. Only DRAFT or RECEIVED quotes can be edited, and only while their request for quote still accepts quotes.

How to use it

  1. Get the quotation ID from List supplier quotations; it must still be DRAFT or RECEIVED and its RFQ must still accept quotes.
  2. Send only the header fields to change; sending items replaces every line, omitting it keeps the current lines.
  3. The total is recalculated by the server and the updated quotation is returned.

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.

Request Body

application/json
  1. body
vendorQuoteRef?|

New vendor reference. Omit to keep.

quoteDate?|

New quotation date (YYYY-MM-DD). Omit to keep.

Formatdate
validUntil?|

New validity end date (YYYY-MM-DD); cannot be before the quote date. Omit to keep.

Formatdate
currency?|

New currency code. Omit to keep.

notes?|

New notes. Omit to keep.

items?array<>|

Full new set of lines, replacing all existing lines. Omit to keep the current lines.

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 PATCH 'https://beta.iotoms.com/api/v1/procurement/quotations/497f6eca-6276-4993-bfeb-53cbbbba6f08' \  -H 'X-TenantID: your-tenant-code' \  -H 'Content-Type: application/json' \  -d '{}'
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"  }}