| 参数级别/参数名称 | 类型/关系 | 是否必须提交 | 参数含义及数值要求 |
|---|---|---|---|
| syOrderNoList | List<String> | N |
顺友流水号 客户订单号 注意:只能出现二者中的一个。 |
| customerNoList | List<String> | N |
{
"data": {
"syOrderNoList": [
"SY10000050059",
"SY10000050067"
]
}
}
| 参数级别/参数名称 | 类型/关系 | 是否必定返回 | 参数含义及数值要求 |
|---|---|---|---|
| ack | String | Y |
接口是否访问成功 SUCCESS:成功 FAILURE:失败 该字段仅用于判断服务接口是否正常响应,请勿用于判断包裹时否创建或预报成功。 |
| errorCode | String | Y | 当ack为FAILURE的时候,返回的错误代码 |
| errorMsg | String | Y | 当ack为FAILURE的时候,返回的错误信息 |
| packageList / | 一对多 | N | |
| packageList / status |
Integer | Y | 参照附录,6.0 包裹状态 |
| packageList / reviseWeight |
Double | N | 包裹称重(单位:kg) |
| packageList / reviseFreight |
Double | N | 包裹实际运费 |
| packageList / currencyCode |
String | N | 包裹运费币种(默认:CNY) |
| packageList / additionalFee |
String | N | 包裹额外费用 |
| packageList / additionalCurrencyCode |
String | N | 包裹额外费用币种(默认:CNY) |
| packageList / sortingTime |
Date | N |
包裹分拣时间 格式为:yyyy-MM-dd HH:mm:ss |
| packageList / shippedTime |
Date | N |
包裹发货时间 格式为:yyyy-MM-dd HH:mm:ss |
| packageList / ************ |
** | ** | 参照 4.01 创建并预报包裹 |
成功:
{
"ack": "success",
"data": {
"resultList": [{
"syOrderNo": "SY10000000001",
"companyCode": "KH00001",
"companyName": "深圳市顺友跨境物流股份有限公司",
"customerOrderNo": "001",
"shippingMethodCode": "SYBAM",
"shippingMethodCnName": "顺邮宝平邮",
"shippingMethodEnName": "Sunyou Packet Unregistered",
"trackingNumber": "SYBAB00000001",
"status": 4,
"statusSpecify": "已预报[等待入仓]",
"packageInsurance": 0,
"packageInsureAmount": 0,
"predictionWeight": 0.35,
"predictionFreight": 2.44,
"predictionVolumnWeight": 1.66,
"reviseWeight": 0,
"reviseFreight": 0,
"currencyCode": "CNY",
"recipientName": "losing",
"recipientCountryCode": "BR",
"recipientPostCode": "LS25 1AF",
"recipientState": "West Yorkshire",
"recipientCity": "Leeds",
"recipientStreet": "111 Main Street",
"recipientPhone": "138********",
"recipientEmail": "broughton@gmail.com",
"senderName": "Sunyou",
"senderPhone": "138********",
"senderPostCode": "518000",
"senderFullAddress": "Longhua New Dist, Shenzhen, Gd, China",
"packageLength": 33.3,
"packageWidth": 22.2,
"packageHeight": 11.2,
"insuranceFlag": 0,
"createTime": "2008-01-01 00:00:01",
"sortingTime": "2008-01-07 15:10:03",
"shippedTime": "2008-01-08 04:45:00",
"shortAddressCode": "TEST1234",
"additionalFee": 12.34,
"additionalCurrencyCode": "CNY",
"productList": [{
"declareEnName": "compute",
"declareCnName": "电脑",
"productSku": "CPT001",
"productPurpose": "工作",
"productMaterial": "金属",
"customCode": "6104320010",
"quantity": 1,
"declarePrice": 620.2,
"sellerName": "test",
"sellerCreditCode": "test",
"platformName": "test",
"exportDeclaredValue": "23",
"exportDeclaredCurrencyCode": "GBP",
"mPid":"",
"sPid":"",
"nsPid":"",
},
{
"declareEnName": "iphone6",
"declareCnName": "苹果6",
"productSku": "IPHONE6",
"productPurpose": "通讯",
"productMaterial": "金属",
"customCode": "6104320010",
"quantity": 1,
"declarePrice": 998.3,
"sellerName": "test",
"sellerCreditCode": "test",
"platformName": "test",
"exportDeclaredValue": "23",
"exportDeclaredCurrencyCode": "GBP",
"mPid":"",
"sPid":"",
"nsPid":"",
}
],
"packageAttributes": "000"
}]
}
}
失败:
{
"ack": "failure",
"errorMsg": "查询单号不能为空",
"errorCode": "S1005"
}