getPackagesDetails(获取包裹详情)

接口说明

    用于查询包裹详情,单次最大查询包裹数量为100个 。

1.请求参数

参数级别/参数名称 类型/关系 是否必须提交 参数含义及数值要求
syOrderNoList List<String> N 顺友流水号
客户订单号
注意:只能出现二者中的一个。
customerNoList List<String> N

2.请求示例 复制代码

					
{
    "data": {
        "syOrderNoList": [
            "SY10000050059",
            "SY10000050067"
        ]
    }
}
					
				



3.返回参数

参数级别/参数名称 类型/关系 是否必定返回 参数含义及数值要求
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 创建并预报包裹

4.返回示例 复制代码

					
成功:
{
	"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"
}