Get GRN
This REST API is used to fetch GRN from Uniware by passing GRN code in inflowReceiptCode.
Tip
It is recommended to check out Notes for the reader. You might find this helpful as it contains Guidelines for using API references and Terminologies used here.
Basic Information
| NAME | DETAILS |
|---|---|
| Endpoint: | /services/rest/v1/purchase/inflowReceipt/getInflowReceipt |
| Request Type: | POST |
| Level: | Facility |
| Scheme: | HTTPS |
| Header (Content-Type): | application/json |
| Header (Authorization): | bearer {access-token}, Eg.: bearer b30f3aea-7978-49bb-9ea7-33eddfc80afa |
| Header (Facility): | facility code as in Uniware (refer FAQs) |
Request Payload
{
"inflowReceiptCode": "string"
}Request Payload Details
| PARAMETER | TYPE | DESCRIPTION | MANDATORY | NOTES |
|---|---|---|---|---|
| inflowReceiptCode | string | Receipt code | Yes | - |
Response Payload
{
"successful": true,
"message": "string",
"errors": [
{
"code": 0,
"fieldName": "string",
"description": "string",
"message": "string",
"errorParams": {
"additionalProp1": {},
"additionalProp2": {},
"additionalProp3": {}
}
}
],
"warnings": [
{
"code": 0,
"message": "string",
"description": "string"
}
],
"inflowReceipt": {
"code": "string",
"statusCode": "string",
"created": "2020-07-11T06:41:19.653Z",
"createdBy": "string",
"vendorInvoiceNumber": "string",
"vendorInvoiceDate": "2020-07-11T06:41:19.653Z",
"purchaseOrder": {
"code": "string",
"fromParty": "string",
"vendorCode": "string",
"vendorName": "string",
"vendorAgreement": "string",
"statusCode": "string",
"created": "2020-07-11T06:41:19.653Z",
"approved": "2020-07-11T06:41:19.653Z",
"deliveryDate": "2020-07-11T06:41:19.653Z",
"expiryDate": "2020-07-11T06:41:19.653Z",
"purchaseOrderItems": [
{
"id": 0,
"itemSKU": "string",
"itemTypeCustomFields": {
"additionalProp1": {},
"additionalProp2": {},
"additionalProp3": {}
},
"itemTypeId": 0,
"itemTypeImageUrl": "string",
"itemTypePageUrl": "string",
"itemTypeName": "string",
"vendorSkuCode": "string",
"color": "string",
"brand": "string",
"size": "string",
"quantity": 0,
"rejectedQuantity": 0,
"pendingQuantity": 0,
"unitPrice": 0,
"maxRetailPrice": 0,
"discount": 0,
"discountPercentage": 0,
"subtotal": 0,
"total": 0,
"taxPercentage": 0,
"tax": 0,
"taxType": "string",
"logisticCharges": 0,
"expirable": true,
"shelfLife": 0,
"grnExpiryTolerance": 0,
"scanIdentifier": "string"
}
],
"customFieldValues": [
{
"fieldName": "string",
"fieldValue": {},
"valueType": "string",
"displayName": "string",
"required": true,
"possibleValues": [
"string"
]
}
]
},
"totalReceivedAmount": 0,
"totalRejectedAmount": 0,
"totalQuantity": 0,
"totalRejectedQuantity": 0,
"inflowReceiptItems": [
{
"id": 0,
"purchaseOrderItemId": 0,
"itemSKU": "string",
"itemTypeName": "string",
"itemTypeImageUrl": "string",
"itemTypePageUrl": "string",
"vendorSkuCode": "string",
"quantity": 0,
"itemsLabelled": true,
"pendingQuantity": 0,
"rejectedQuantity": 0,
"detailedQuantity": 0,
"rejectionComments": "string",
"expiry": "2020-07-11T06:41:19.653Z",
"status": "string",
"unitPrice": 0,
"maxRetailPrice": 0,
"additionalCost": 0,
"batchCode": "string",
"discount": 0,
"discountPercentage": 0,
"manufacturingDate": "2020-07-11T06:41:19.653Z",
"expirable": true,
"shelfLife": 0,
"grnExpiryTolerance": 0
}
],
"customFieldValues": [
{
"fieldName": "string",
"fieldValue": {},
"valueType": "string",
"displayName": "string",
"required": true,
"possibleValues": [
"string"
]
}
]
},
"vendorCode": "string"
}Response Payload Details
| LEVEL | PARAMETER | TYPE | DESCRIPTION | NOTES |
|---|---|---|---|---|
| 1 | successful | true | Request success status | - |
| 2 | message | string | Response message | - |
| 3 | errors | list | List of errors (if any) | - |
| 3.1 | code | number | Error code | - |
| 3.2 | fieldName | string | Field with error | - |
| 3.3 | description | string | Error description | - |
| 3.4 | message | string | Error message | - |
| 3.5 | errorParams | object | Parameters with error | - |
| 3.5.1 | additionalProp1 | object | Parameter 1 with error | - |
| 3.5.2 | additionalProp2 | object | Parameter 2 with error | - |
| 3.5.3 | additionalProp3 | object | Parameter 3 with error | - |
| 4 | warnings | list | List of warnings (if any) | - |
| 4.1 | code | number | Warning code | - |
| 4.2 | message | string | Warning message | - |
| 4.3 | description | string | Warning description | - |
| 5 | inflowReceipt | object | Receipt details | - |
| 5.1 | code | string | Receipt code | |
| 5.2 | statusCode | string | Status code | |
| 5.3 | created | string | date-time | Eg.: 2020-07-11T06:39:57.490Z (UTC Format) |
| 5.4 | createdBy | string | - | - |
| 5.5 | vendorInvoiceNumber | string | Invoice no. | - |
| 5.6 | vendorInvoiceDate | string | date-time | Eg.: 2020-07-11T06:39:57.490Z (UTC Format) |
| 5.7 | purchaseOrder | object | Purchase order details | - |
| 5.7.1 | code | string | Code | |
| 5.7.2 | fromParty | string | From party code | - |
| 5.7.3 | vendorCode | string | Vendor code | - |
| 5.7.4 | vendorName | string | Vendor name | - |
| 5.7.5 | vendorAgreement | string | Vendor aggrement | - |
| 5.7.6 | statusCode | string | Status code | |
| 5.7.7 | created | string | date-time | Eg.: 2020-07-11T06:39:57.490Z (UTC Format) |
| 5.7.8 | approved | string | date-time | Eg.: 2020-07-11T06:39:57.490Z (UTC Format) |
| 5.7.9 | deliveryDate | string | date-time | Eg.: 2020-07-11T06:39:57.490Z (UTC Format) |
| 5.7.10 | expiryDate | string | date-time | Eg.: 2020-07-11T06:39:57.490Z (UTC Format) |
| 5.7.11 | purchaseOrderItems | list | Purchase order item details | - |
| 5.7.11.1 | id | integer | ID | - |
| 5.7.11.2 | itemSKU | string | Item SKU | - |
| 5.7.11.3 | itemTypeCustomFields | object | Item type custom fields | |
| 5.7.11.3.1 | additionalProp1 | object | Additional property | |
| 5.7.11.3.2 | additionalProp2 | object | Additional property | |
| 5.7.11.3.3 | additionalProp3 | object | Additional property | |
| 5.7.11.4 | itemTypeId | integer | Item type ID | |
| 5.7.11.5 | itemTypeImageUrl | string | Item type image URL | - |
| 5.7.11.6 | itemTypePageUrl | string | Item type page URL | - |
| 5.7.11.7 | itemTypeName | string | Item type name | - |
| 5.7.11.8 | vendorSkuCode | string | Vendor SKU code | - |
| 5.7.11.9 | color | string | Color description | - |
| 5.7.11.10 | brand | string | Brand of the item | Eg: Bombay Dyeing |
| 5.7.11.11 | size | string | Size | Format: LxBxH, Unit: mm, Eg: 60.00X40.00X2.00 |
| 5.7.11.12 | quantity | integer | Quantity | - |
| 5.7.11.13 | rejectedQuantity | integer | Rejected quantity | - |
| 5.7.11.14 | pendingQuantity | integer | Pending quantity | - |
| 5.7.11.15 | unitPrice | number | Unit price | - |
| 5.7.11.16 | maxRetailPrice | number | Max. retail price | - |
| 5.7.11.17 | discount | number | Discount amount | - |
| 5.7.11.18 | discountPercentage | number | Discount percentage | - |
| 5.7.11.19 | subtotal | number | Sub-total | - |
| 5.7.11.20 | total | number | Total amount | - |
| 5.7.11.21 | taxPercentage | number | Tax percentage | Default: 0 |
| 5.7.11.22 | tax | number | Tax | - |
| 5.7.11.23 | taxType | string | Tax type | - |
| 5.7.11.24 | logisticCharges | number | Logistics charges | - |
| 5.7.11.25 | expirable | boolean | true if expirable | - |
| 5.7.11.26 | shelfLife | integer | Duration for which item remains in good condition while storing | - |
| 5.7.11.27 | grnExpiryTolerance | integer | Expiry tolerance | - |
| 5.7.11.28 | scanIdentifier | string | Data to be matched during item scan | - |
| 5.7.12 | customFieldValues | list | Custom field details | - |
| 5.7.12.1 | fieldName | string | Custom field name | - |
| 5.7.12.2 | fieldValue | object | Custom field value | - |
| 5.7.12.3 | valueType | string | Value type | - |
| 5.7.12.4 | displayName | string | Name to be displayed | - |
| 5.7.12.5 | required | boolean | true if required | - |
| 5.7.12.6 | possibleValues | list | Possible values for custom field | - |
| 5.8 | totalReceivedAmount | number | Total amount received | - |
| 5.9 | totalRejectedAmount | number | Total rejected amount | - |
| 5.10 | totalQuantity | integer | Total quantity | - |
| 5.11 | totalRejectedQuantity | integer | Total rejected quantity | - |
| 5.12 | inflowReceiptItems | list | Receipt items list | - |
| 5.12.1 | id | integer | ID | - |
| 5.12.2 | purchaseOrderItemId | integer | Item ID | - |
| 5.12.3 | itemSKU | string | Item SKU | - |
| 5.12.4 | itemTypeName | string | Item type name | - |
| 5.12.5 | itemTypeImageUrl | string | Item type image URL | - |
| 5.12.6 | itemTypePageUrl | string | Item type page URL | - |
| 5.12.7 | vendorSkuCode | string | Vendor SKU code | - |
| 5.12.8 | quantity | integer | Quantity | - |
| 5.12.9 | itemsLabelled | boolean | true if items labelled | |
| 5.12.10 | pendingQuantity | integer | Pending quantity | - |
| 5.12.11 | rejectedQuantity | integer | Rejected quantity | - |
| 5.12.12 | detailedQuantity | integer | Detailed quantity | - |
| 5.12.13 | rejectionComments | string | Rejection comments | - |
| 5.12.14 | expiry | string | date-time | Eg.: 2020-07-11T06:39:57.490Z (UTC Format) |
| 5.12.15 | status | string | Status | |
| 5.12.16 | unitPrice | number | Unit price | - |
| 5.12.17 | maxRetailPrice | number | Max. retail price | - |
| 5.12.18 | additionalCost | number | Additional cost | - |
| 5.12.19 | batchCode | string | Inventory batch code | - |
| 5.12.20 | discount | number | Discount amount | - |
| 5.12.21 | discountPercentage | number | Discount percentage | - |
| 5.12.22 | manufacturingDate | string | date-time | Eg.: 2020-07-11T06:39:57.490Z (UTC Format) |
| 5.12.23 | expirable | boolean | true if expirable | - |
| 5.12.24 | shelfLife | integer | Duration for which item remains in good condition while storing | - |
| 5.12.25 | grnExpiryTolerance | integer | Expiry tolerance | - |
| 5.13 | customFieldValues | list | Custom field details | - |
| 5.13.1 | fieldName | string | Custom field name | - |
| 5.13.2 | fieldValue | object | Custom field value | - |
| 5.13.3 | valueType | string | Value type | - |
| 5.13.4 | displayName | string | Name to be displayed | - |
| 5.13.5 | required | boolean | true if required | - |
| 5.13.6 | possibleValues | list | Possible values for custom field | - |
| 6 | vendorCode | string | Vendor code | - |
Error Codes
Refer Response Codes section to know about specific errors codes.