...
| HTTP Verb | URL |
|---|---|
| Post | /services/shipper/handover |
RequestElements
Field (API) | Mandatory | Length | Details |
batchNo | O | 80 | Batch number |
handoverTime | O | Time format: YYYY-MM-DD'T'HH:MM:SSZ | |
consignor | O | 80 | Sender information |
consignee | O | 80 | Recipient information |
driver | O | 80 | Driver information |
plateNbr | O | 80 | License plate number |
remark | O | Double | Remark information |
bags |
M
Array
bagNo | M | Big Bag No | |
serviceCode | M | Service Code | |
facility | O | ||
destCountry | M | Bag destination country | |
sortCode | O | Bag sortCode | |
battery | O | Bag has battery | |
totalWeight | M | Bag total weight | |
parcels | |||
trackingNo | M | Tracking No. |
Response content
ResponseElements
...
5) Bag No.
Error Code & Message
| code | message |
|---|---|
| 950002 | Parameter is null. |
| 951002 | The parameter bags is required. |
| 951003 | The parameter bags exceeds max limit 300. |
| 951003 | Create Message error. |
| 951007 | Bag {bagNo} parameter serviceCode is missing. |
| 951000 | The parameter bagNo is missing. |
| 951006 | The parameter bagNo {bagNo} exceeds max length 80 characters. |
| 951020 | The parameter bagNo {bagNo} already existed. |
| 951023 | The parameter bagNo {bagNo} repeat. |
| 951009 | Bag {bagNo} parameter destCountry is missing. |
| 951013 | Bag {bagNo} parameter parcels is required. |
| 950003 | Exceeds the limit of 2000 orders. |
| 100062 | Bag {bagNo} parcel {parcelId} is no permission. |
| 951024 | Bag {bagNo} parcel {parcelId} already bagged. |
| 951021 | Bag {bagNo} parcel {parcelId} |
| referenceNo { |
| referenceNo} is repeat. | |
| 951025 | Bag {bagNo} parcel {parcelId} |
| serviceCode {serviceCode} is different from bag serviceCode {bagServiceCode}. | |
| 951026 | Bag {bagNo} parcel {parcelId} serviceOption {serviceOption} is different from bag serviceOption {bagServiceOption}. |
Request parameters
1. Create large package and new order at the same time
...
| 代码块 | ||||||||
|---|---|---|---|---|---|---|---|---|
| ||||||||
{
"bags": [
{
"bagNo": "ZXHX108227020201102001-001",
"battery": false,
"destCountry": "AU",
"facility": "CAN",
"parcels": [
{
"trackingNo": "JDQ002447301000931502"
}
],
"serviceCode": "UBI.ASP.CN2AU.AUPOST",
"totalWeight": 0.064
}
],
"batchNo": "ZXYD1016617",
"handoverTime": 1597039375903"2020-08-10T11:45:22+08:00"
}
|
3. Large packages are associated with new orders and existing orders
...
| 代码块 | ||||||||
|---|---|---|---|---|---|---|---|---|
| ||||||||
{
"status": "Success",
"errors": null,
"data": [
{
"status": "Success",
"errors": [],
"bagNo": "2017110200120201102001-001",
"orderResults": [
{
"status": "Success",
"errors": null,
"orderId": null,
"referenceNo": "TESTBDAU15303483645716",
"trackingNo": null,
"connoteId": null
}
]
},
{
"status": "Success",
"errors": [],
"bagNo": "20171102001-002",
"orderResults": [
{
"status": "Success",
"errors": null,
"orderId": null,
"referenceNo": "TESTBDAU15303483645717",
"trackingNo": null,
"connoteId": null
}
]
}
]
}
|
...