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.

Unicommerce Website

Copyright © 2022 Unicommerce eSolutions Pvt. Ltd.