Get Shipping Package Details
This REST API is used to fetch shipping package details such as order items, billing address, etc. from Uniware using shipping package code.
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/oms/shippingPackage/getShippingPackageDetails |
| 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
{
"shippingPackageCode": "string"
}Request Payload Details
| PARAMETER | TYPE | DESCRIPTION | MANDATORY | NOTES |
|---|---|---|---|---|
| shippingPackageCode | string | Shipping package 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"
}
],
"shippingPackageDetailDTO": {
"code": "string",
"saleOrderCode": "string",
"statusCode": "string",
"shippingManifestCode": "string",
"saleOrderDetails": {
"code": "string",
"displayOrderCode": "string",
"channel": "string",
"source": "CUSTOM",
"displayOrderDateTime": "1694029127000",
"status": "string",
"created": "1694029206000",
"updated": "1694029211000",
"fulfillmentTat": 1694202006000,
"notificationEmail": "string",
"notificationMobile": "string",
"customerGSTIN": null,
"channelProcessingTime": 1694029206000,
"cod": true,
"priority": 0,
"currencyCode": "string",
"customerCode": "string",
"billingAddress": {
"id": "string",
"name": "string",
"addressLine1": "string",
"addressLine2": "string",
"city": "string",
"state": "string",
"country": "string",
"pincode": "string",
"phone": "string",
"email": "string"
},
"addresses": [
{
"id": "string",
"name": "string",
"addressLine1": "string",
"addressLine2": "string",
"city": "string",
"state": "string",
"country": "string",
"pincode": "string",
"phone": "string",
"email": "string"
}
],
"customFieldValues": [
{
"fieldName": "string",
"fieldValue": {},
"valueType": "string",
"displayName": "string",
"required": true,
"possibleValues": [
"string"
]
}
]
},
"saleOrderItems": [
{
"id": 1380972,
"shippingPackageCode": "DSKS00002",
"shippingPackageStatus": "PACKED",
"facilityCode": "Shiv",
"facilityName": "Shiv",
"alternateFacilityCode": null,
"reversePickupCode": null,
"shippingAddressId": 7143,
"packetNumber": 1,
"combinationIdentifier": null,
"combinationDescription": null,
"type": "NORMAL",
"item": null,
"shippingMethodCode": "STD",
"itemName": "Test2",
"itemSku": "TESTB",
"sellerSkuCode": "TESTB",
"channelProductId": "TESTB",
"imageUrl": null,
"statusCode": "FULFILLABLE",
"code": "TESTB-0",
"shelfCode": null,
"totalPrice": 999.00,
"sellingPrice": 999.00,
"shippingCharges": 0.00,
"shippingMethodCharges": 0.00,
"cashOnDeliveryCharges": 0.00,
"prepaidAmount": 0.00,
"voucherCode": null,
"voucherValue": 0.00,
"storeCredit": 0.00,
"discount": 0.00,
"giftWrap": null,
"giftWrapCharges": 0.00,
"taxPercentage": null,
"giftMessage": null,
"cancellable": true,
"editAddress": false,
"reversePickable": false,
"packetConfigurable": false,
"created": 1694029206000,
"updated": 1694029302000,
"onHold": false,
"saleOrderItemAlternateId": null,
"cancellationReason": null,
"cancelledBySeller": null,
"pageUrl": null,
"color": null,
"brand": null,
"size": null,
"replacementSaleOrderCode": null,
"bundleSkuCode": null,
"customFieldValues": null,
"itemDetailFieldDTOList": [
],
"hsnCode": "",
"totalIntegratedGst": 0,
"integratedGstPercentage": 0,
"totalUnionTerritoryGst": 0,
"unionTerritoryGstPercentage": 0,
"totalStateGst": 0,
"stateGstPercentage": 0,
"totalCentralGst": 0,
"centralGstPercentage": 0,
"maxRetailPrice": 999.00,
"sellingPriceWithoutTaxesAndDiscount": 0,
"batchDTO": null,
"shippingChargeTaxPercentage": 0,
"tcs": 0,
"ucBatchCode": null,
"channelMrp": null,
"channelExpiryDate": null,
"channelVendorBatchNumber": null,
"channelMfd": null,
"countryOfOrigin": null,
"expectedDeliveryDate": null,
"itemDetailFields": {
"itemSealId": "124"
},
"channelSaleOrderItemCode": "TESTB-0",
"effectiveTolerance": null
},
{
"id": 1380973,
"shippingPackageCode": "DSKS00002",
"shippingPackageStatus": "PACKED",
"facilityCode": "Shiv",
"facilityName": "Shiv",
"alternateFacilityCode": null,
"reversePickupCode": null,
"shippingAddressId": 7143,
"packetNumber": 1,
"combinationIdentifier": null,
"combinationDescription": null,
"type": "NORMAL",
"item": null,
"shippingMethodCode": "STD",
"itemName": "Test2",
"itemSku": "TESTB",
"sellerSkuCode": "TESTB",
"channelProductId": "TESTB",
"imageUrl": null,
"statusCode": "FULFILLABLE",
"code": "TESTB-1",
"shelfCode": null,
"totalPrice": 999.00,
"sellingPrice": 999.00,
"shippingCharges": 0.00,
"shippingMethodCharges": 0.00,
"cashOnDeliveryCharges": 0.00,
"prepaidAmount": 0.00,
"voucherCode": null,
"voucherValue": 0.00,
"storeCredit": 0.00,
"discount": 0.00,
"giftWrap": null,
"giftWrapCharges": 0.00,
"taxPercentage": null,
"giftMessage": null,
"cancellable": true,
"editAddress": false,
"reversePickable": false,
"packetConfigurable": false,
"created": 1694029206000,
"updated": 1694029302000,
"onHold": false,
"saleOrderItemAlternateId": null,
"cancellationReason": null,
"cancelledBySeller": null,
"pageUrl": null,
"color": null,
"brand": null,
"size": null,
"replacementSaleOrderCode": null,
"bundleSkuCode": null,
"customFieldValues": null,
"itemDetailFieldDTOList": [
],
"hsnCode": "",
"totalIntegratedGst": 0,
"integratedGstPercentage": 0,
"totalUnionTerritoryGst": 0,
"unionTerritoryGstPercentage": 0,
"totalStateGst": 0,
"stateGstPercentage": 0,
"totalCentralGst": 0,
"centralGstPercentage": 0,
"maxRetailPrice": 999.00,
"sellingPriceWithoutTaxesAndDiscount": 0,
"batchDTO": null,
"shippingChargeTaxPercentage": 0,
"tcs": 0,
"ucBatchCode": null,
"channelMrp": null,
"channelExpiryDate": null,
"channelVendorBatchNumber": null,
"channelMfd": null,
"countryOfOrigin": null,
"expectedDeliveryDate": null,
"itemDetailFields": {
"itemSealId": "125",
"SerialNumber": "2dd2d2",
"Imei": "2dd2d2"
},
"itemDetailsKey": "itemSealId,SerialNumber,Imei",
"channelSaleOrderItemCode": "TESTB-1",
"effectiveTolerance": null
}
],
"actualWeight": 3.000,
"boxWidth": 0,
"boxHeight": 0,
"boxLength": 0,
"collectableAmount": 2997.00,
"collectedAmount": null,
"shippingProvider": null,
"trackingNumber": null,
"ewbNo": null,
"ewbDate": null,
"ewbValidTill": null,
}
}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 | shippingPackageDetailDTO | object | Shipping package details | - |
| 5.1 | code | string | Shipping package code | - |
| 5.2 | saleOrderCode | string | Sale order code | - |
| 5.3 | statusCode | string | Shipping package status code | - |
| 5.4 | shippingManifestCode | string | Shipping manifest code | - |
| 5.5 | saleOrderDetails | object | Sale order details | - |
| 5.5.1 | code | string | Sale order code | - |
| 5.5.2 | displayOrderCode | string | Order code to be displayed | - |
| 5.5.3 | channel | string | - | - |
| 5.5.4 | displayOrderDateTime | date | Order date | - |
| 5.5.5 | status | string | Sale order status | - |
| 5.5.6 | created | date | Creation date | - |
| 5.5.7 | updated | date | Updation date | - |
| 5.5.8 | notificationEmail | string | Email for notifications | - |
| 5.5.9 | notificationMobile | string | Mobile for notifications | - |
| 5.5.10 | cod | boolean | true if COD | - |
| 5.5.11 | priority | integer | Order fullfillment priority | - |
| 5.5.12 | currencyCode | string | Currency codes (3 digit) | - |
| 5.5.13 | customerCode | string | Customer code | - |
| 5.5.14 | billingAddress | object | Billing address information | - |
| 5.5.14.1 | id | string | Billing address ID | - |
| 5.5.14.2 | name | string | Name of buyer | - |
| 5.5.14.3 | addressLine1 | string | Precise address | - |
| 5.5.14.4 | addressLine2 | string | Additional address information | - |
| 5.5.14.5 | city | string | City name | Eg: Surat |
| 5.5.14.6 | state | string | State name | Eg: Gujrat |
| 5.5.14.7 | country | string | Country name | - |
| 5.5.14.8 | pincode | string | Area pincode (min. 6 digits) | Eg: 395006 |
| 5.5.14.9 | phone | string | Contact no. | - |
| 5.5.14.10 | string | Email ID | case insensitive | |
| 5.5.15 | addresses | object | Address information | - |
| 5.5.15.1 | id | string | Address ID | - |
| 5.5.15.2 | name | string | Name | - |
| 5.5.15.3 | addressLine1 | string | Precise address | - |
| 5.5.15.4 | addressLine2 | string | Additional address information | - |
| 5.5.15.5 | city | string | City name | Eg: Surat |
| 5.5.15.6 | state | string | State name | Eg: Gujrat |
| 5.5.15.7 | country | string | Country name | - |
| 5.5.15.8 | pincode | string | Area pincode (min. 6 digits) | Eg: 395006 |
| 5.5.15.9 | phone | string | Contact no. | - |
| 5.5.15.10 | string | Email ID | case insensitive | |
| 5.5.16 | customFieldValues | list | Custom field details | - |
| 5.5.16.1 | fieldName | string | Field with error | - |
| 5.5.16.2 | fieldValue | list | Custom field value | - |
| 5.5.16.3 | valueType | string | Value type | - |
| 5.5.16.4 | displayName | string | Name to be displayed | - |
| 5.5.16.5 | required | boolean | true if required | - |
| 5.5.16.6 | possibleValues | list | Allowable values | - |
| 5.5.17 | source | string | channel source code | - |
| 5.5.18 | fulfillmentTat | date | fulfillment Tat | e.g. 1694202006000 |
| 5.5.19 | customerGSTIN | string | customerGSTIN | - |
| 5.5.20 | channelProcessingTime | date | fulfillment Tat | e.g. 1694029206000 |
| 5.6 | saleOrderItems | list | Details of items in sale order | - |
| 5.6.1 | saleOrderItemId | integer | Sale order item ID | - |
| 5.6.2 | code | string | Sale order item code | - |
| 5.6.3 | itemSku | string | Item SKU | - |
| 5.6.4 | itemName | string | Item name | - |
| 5.6.5 | itemTypeImageUrl | string | - | - |
| 5.6.6 | itemTypePageUrl | string | - | - |
| 5.6.7 | shelfCode | string | Shelf code for item | - |
| 5.6.8 | onHold | boolean | true if onHold | - |
| 5.6.9 | saleOrderItemCode | string | Sale order item code | - |
| 5.6.10 | statusCode | string | Sale order item status code | - |
| 5.6.11 | itemCode | string | Item code | - |
| 5.6.12 | requiresCustomization | boolean | true if customization required | - |
| 5.6.13 | giftWrap | boolean | true for gift wrap | - |
| 5.6.14 | giftMessage | string | Message on gift | - |
| 5.6.15 | customFieldValues | list | Custom field details | - |
| 5.6.15.1 | fieldName | string | Field with error | - |
| 5.6.15.2 | fieldValue | list | Custom field value | - |
| 5.6.15.3 | valueType | string | Value type | - |
| 5.6.15.4 | displayName | string | Name to be displayed | - |
| 5.6.15.5 | required | boolean | true if required | - |
| 5.6.15.6 | possibleValues | list | Allowable values | - |
| 5.6.15.6 | actualWeight | Float | actualWeight e.g. 3.000 | - |
| 5.6.16 | itemDetailFields | List | - | - |
| 5.6.16.1 | itemSealId | string | item Seal Id | - |
| 5.6.16.2 | SerialNumber | string | SerialNumber | - |
| 5.6.16.3 | Imei | string | Imei | - |
| 5.6.17 | itemDetailsKey | string | comma seperated nudge e.g. itemSealId,SerialNumber,Imei | - |
| 5.7 | boxWidth | integer | boxWidth values | - |
| 5.8 | boxHeight | integer | boxHeight values | - |
| 5.9 | boxLength | integer | boxLength values | - |
| 5.10 | collectableAmount | float | collectableAmount values | - |
| 5.11 | collectedAmount | float | collectedAmount values | - |
| 5.12 | shippingProvider | string | shippingProvider | - |
| 5.13 | trackingNumber | string | trackingNumber | - |
| 5.14 | ewbNo | string | ewbNo | - |
| 5.15 | ewbDate | Date | ewbDate | - |
| 5.16 | ewbValidTill | Date | ewbValidTill | - |
Error Codes
Refer Response Codes section to know about specific errors codes.