iotoms Docs

Get goods receipt report

GET
/api/v1/reports/procurement/grn-report

Returns goods receipts whose received date falls between from and to (YYYY-MM-DD, both default to today), with accepted and rejected quantities and the value of accepted goods per receipt, plus totals.

Authorization

BearerAuth
headerAuthorizationBearer <JWT>

Query Parameters

from?string

ISO date (YYYY-MM-DD), defaults to today

Formatdate
to?string

ISO date (YYYY-MM-DD), 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 worked, ERROR when it did not.

message*string

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

data?

Goods receipt totals and the individual receipts for the date range.

Example Request
curl -X GET 'https://beta.iotoms.com/api/v1/reports/procurement/grn-report' \  -H 'X-TenantID: your-tenant-code'
Example Response
{  "status": "string",  "message": "string",  "data": {    "tenantId": "string",    "from": "2019-08-24",    "to": "2019-08-24",    "totalGrns": 0,    "totalAcceptedQty": 0,    "totalRejectedQty": 0,    "entries": [      {        "grnId": "string",        "grnNumber": "string",        "purchaseOrderId": "string",        "vendorName": "string",        "status": "string",        "receivedDate": "2019-08-24",        "receivedBy": "string",        "lineCount": 0,        "totalAcceptedQty": 0,        "totalRejectedQty": 0,        "totalValue": 0      }    ]  }}