Get Item Details
This REST API is used to fetch item details from Uniware. The user needs to send the skuCode for which the details are required.
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/catalog/itemType/get |
| Request Type: | POST |
| Level: | Tenant |
| Scheme: | HTTPS |
| Header (Content-Type): | application/json |
| Header (Authorization): | bearer {access-token}, Eg.: bearer b30f3aea-7978-49bb-9ea7-33eddfc80afa |
Request Payload
{
"skuCode": "string",
"cartonScanIdentifier": null,
"kitSku": false
}Request Payload Details
| PARAMETER | TYPE | DESCRIPTION | MANDATORY | NOTES |
|---|---|---|---|---|
| skuCode | string | SKU code of the item (as in Uniware) | Yes | Eg: BD_Floral_3 |
| cartonScanIdentifier | string | carton/roll-up SKU codes created against the SKU | No | - |
| kitSku | boolean | If true, then Kit SKU; If false, Simple SKU | No | - |
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"
}
],
"itemTypeDTO": {
"tat": 0,
"id": 0,
"skuCode": "string",
"categoryCode": "string",
"name": "string",
"description": "string",
"scanIdentifier": "string",
"length": 0,
"width": 0,
"height": 0,
"weight": 0,
"color": "string",
"size": "string",
"brand": "string",
"ean": "string",
"upc": "string",
"isbn": "string",
"maxRetailPrice": 0,
"basePrice": 0,
"batchGroupCode" : "string",
"costPrice": 0,
"taxTypeCode": "string",
"gstTaxTypeCode": "string",
"hsnCode": "string",
"imageUrl": "string",
"productPageUrl": "string",
"type": "SIMPLE",
"scanType" : "string",
"determineExpiryFrom": "MANUFACTURING_DATE",
"taxCalculationType" : "string",
"requiresCustomization": true,
"itemDetailFieldsText": "string",
"enabled": true,
"tags": [
"string"
],
"shelfLife": 0,
"expirable": true,
"customFieldValues": [
{
"fieldName": "string",
"fieldValue": {},
"valueType": "string",
"displayName": "string",
"required": true,
"possibleValues": [
"string"
]
}
],
"componentItemTypes": [
{
"itemTypeDTO": {
"id": 0,
"skuCode": "string",
"name": "string",
"imageUrl": "string",
"color": "string",
"size": "string"
},
"quantity": 0,
"price": 0,
"priceRatio": 0
}
],
"grnExpiryTolerance": "string",
"dispatchExpiryTolerance": "string",
"returnExpiryTolerance": "string",
"minOrderSize": 0,
"expiryDate": "string",
"skuType": "string",
"fragile": false,
"dangerousGood": false
}
}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 | itemTypeDTO | object | Item type details | - |
| 5.1 | tat | number | Turn-around-time | - |
| 5.2 | id | integer | ID | - |
| 5.3 | skuCode | string | SKU code of the item on the marketplace | Eg: BD_Floral_3 |
| 5.4 | categoryCode | string | Category code in Uniware, else pass ‘null’ | - |
| 5.5 | name | string | Name | - |
| 5.6 | description | string | Description | - |
| 5.7 | scanIdentifier | string | Data to be matched during item scan | - |
| 5.8 | length | integer | Length (in mm) | - |
| 5.9 | width | integer | Width in mm | - |
| 5.10 | height | integer | Height (in mm) | - |
| 5.11 | weight | integer | Weight in gm | - |
| 5.12 | color | string | Color description | - |
| 5.13 | size | string | Size | - |
| 5.14 | brand | string | Brand of the item | Eg: Bombay Dyeing |
| 5.15 | ean | string | EAN no. | - |
| 5.16 | upc | string | UPC code | - |
| 5.17 | isbn | string | ISBN no. | - |
| 5.18 | maxRetailPrice | number | Max. retail price | - |
| 5.19 | basePrice | number | Base price | - |
| 5.20 | batchGroupCode | string | Batch group code for the item | - |
| 5.21 | costPrice | number | Cost price | - |
| 5.22 | taxTypeCode | string | Tax type code | - |
| 5.23 | gstTaxTypeCode | string | GST tax code (as defined in Uniware) | - |
| 5.24 | hsnCode | string | 6 digit uniform code that classifies products worldwide | - |
| 5.25 | imageUrl | string | Image URL of the variant | - |
| 5.26 | productPageUrl | string | Item page URL | - |
| 5.27 | type | enum | Item type | Allowable: SIMPLE (Default), BUNDLE |
| 5.28 | scanType | string | Scan type | - |
| 5.29 | determineExpiryFrom | string | - | - |
| 5.30 | taxCalculationType | string | - | - |
| 5.31 | requiresCustomization | boolean | true if customization required | - |
| 5.32 | itemDetailFieldsText | string | Details of item | - |
| 5.33 | enabled | boolean | true if enabled | - |
| 5.34 | tags | list | Item tags for assisting search | - |
| 5.35 | shelfLife | integer | Duration for which item remains in good condition while storing | - |
| 5.36 | expirable | boolean | true if expirable | - |
| 5.37 | customFieldValues | list | Custom field details | - |
| 5.37.1 | fieldName | string | Custom field name | - |
| 5.37.2 | fieldValue | object | Custom field value | - |
| 5.37.3 | valueType | string | Value type | - |
| 5.37.4 | displayName | string | Name to be displayed | - |
| 5.37.5 | required | boolean | true if required | - |
| 5.37.6 | possibleValues | list | Possible values for custom field | - |
| 5.38 | componentItemTypes | list | - | |
| 5.38.1 | itemTypeDTO | object | Item type details | - |
| 5.38.1.1 | id | string | - | - |
| 5.38.1.1 | skuCode | string | SKU code of the item on the marketplace | Eg: BD_Floral_3 |
| 5.38.1.2 | name | string | Name | - |
| 5.38.1.3 | imageUrl | string | Category name | - |
| 5.38.1.4 | size | string | Item type image URL | - |
| 5.38.2 | quantity | integer | Quantity | - |
| 5.38.3 | price | number | Price | - |
| 5.38.4 | priceRatio | number | Price ratio | - |
| 5.39 | grnExpiryTolerance | string | - | - |
| 5.40 | dispatchExpiryTolerance | string | - | - |
| 5.41 | returnExpiryTolerance | string | - | - |
| 5.42 | minOrderSize | integer | - | - |
| 5.43 | expiryDate | string | - | - |
| 5.44 | skuType | string | - | - |
| 5.45 | fragile | boolean | - | - |
| 5.46 | dangerousGood | boolean | - | - |
Error Codes
Refer Response Codes section to know about specific errors codes.