Description
| Carrier use large bags for forecasting. |
Path
| HTTP Verb | URL |
|---|---|
| Post | /services/integration/carrier/despatchBags |
Request field
| 1 | Field (API) | Data Type | Length | Mandatory | Details | |||||||
| 2 | despatchedTime | Date | 40 | O | Current time | |||||||
| 3 | operatingAccount | String | O | Operator account in eTower | ||||||||
| 4 | bags | List | M | Bag information | ||||||||
| 5 | bagNo | String | 80 | M | Bag number | |||||||
| 6 | extendData | Object | O | Extended attributes | ||||||||
| 7 | sortCode | String | 32 | O | Sort code | |||||||
| 8 | parcels | List | M | Parcel information | ||||||||
| 9 | barcode | String | 40 | M | Tracking number | |||||||
| 10 | receivedTime | Date | 24 | O | Receiving time
| |||||||
| 11 | scannedTime | Date | 24 | O | Weighing time
| |||||||
| 12 | weight | Double | 80 | M | Actual weight(kilogram) | |||||||
Response content
a) status：Succeeded/Failed
b) code：
300010 | BagNo couldn’t be blank |
300011 | BagNo already existed |
300063 | Parcels for different districts could be put into same bag |
130004 | Bag weight beyond 40kg |
950008 | Barcode couldn’t be blank |
300015 | Barcode couldn’t be blank |
300016 | Do not exist shipment relate to barcode requested |
300013 | Barcode reused |
300012 | Shipment has been put into bag |
300017 | Shipments with different service couldn’t be put into same bag |
Request messag
Request
{
"despatchedTime": "2017-01-06T12:08:08+0800",
"operatingAccount": "Pickup_test@qq.com",
"bags": [
{
"bagNo": "2612_BPO_LAX_LAX_ST029",
"extendData": {
"sortCode": "M1A1"
},
"parcels": [
{
"barcode": "RR824564604VU",
"receivedTime": "2017-01-05T12:08:08+0800",
"scannedTime": "2017-01-05T15:08:08+0800",
"weight": 2.8
},
{
"barcode": "RR824564649VU",
"receivedTime": "2017-01-05T12:08:08+0800",
"scannedTime": "2017-01-05T15:08:08+0800",
"weight": 1.2
}
]
},
{
"bagNo": "2512_BPO_LAX_LAX_ST030",
"parcels": [
{
"barcode": "RR824564621VU",
"receivedTime": "2017-01-05T12:08:08+0800",
"scannedTime": "2017-01-05T15:08:08+0800",
"weight": 2.8
},
{
"barcode": "RR824564618VU",
"receivedTime": "2017-01-05T12:08:08+0800",
"scannedTime": "2017-01-05T15:08:08+0800",
"weight": 1.2
},
{
"barcode": "RR824564635VU",
"receivedTime": "2017-01-05T12:08:08+0800",
"scannedTime": "2017-01-05T15:08:08+0800",
"weight": 1.2
}
]
}
]
}
Response message
Response
[
{
"status": "Succeeded",
"code": 0,
"bagId": "sZoOP9h9D5noRU0JVdS_Hg",
"bagNo": "2612_BPO_LAX_LAX_ST029"
},
{
"status": "Succeeded",
"code": 0,
"bagId": "euy7ZrJ2Z4n9Syrdwf7udg",
"bagNo": "2512_BPO_LAX_LAX_ST030"
}
]