订单信息单笔查询
名称 | 类型 | 是否必须 | 示例值 | 描述 |
---|---|---|---|---|
appMethod | String | Y | suning.custom.category.query | 方法名 |
appRequestTime | String | Y | 2012-04-25 20:23:30 | 时间戳,格式为yyyy-MM-dd HH:mm:ss,例如:2012-04-25 20:23:30。API服务端允许客户端请求时间误差为10分钟。 |
format | String | N | XML | 默认xml,可指定格式为xml,json |
appKey | String | Y | b0c332a133c102765f39de********** | 分配给应用的访问令牌 |
versionNo | String | Y | v1.2 | API的版本,目前为v1.2版本 |
signInfo | String | Y | 460d7ff15b073e463125b4********** | appSecret,appMethod ,appRequestTime, appKey, versionNo, 请求报文base64加密后的数据顺序MD5(32位小写),其中appSecret为appKey对应的密钥 |
access_token | String | N | a1c5c62b08df3a3cbf7efd********** | 采用OAuth授权方式为必填参数 |
名称 | 类型 | 是否必须 | 示例值 | 描述 |
---|---|---|---|---|
logisticOrderId | String | Y | LES00001 | 苏宁物流订单号 |
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
feedBackImformation | String | ||
announcedValue | String | 1000 | 订单声明价值 |
btcItemNumber | String | 2 | B2C行数 |
btcItemOrderId | String | 11235131513 | B2C订单行号 |
btcOrderId | String | 10001010235 | B2C订单号 |
businessType | String | C003 | 业务类型(C003-跨境的入库单、C004-跨境退仓单、C005-跨境销售订单、C006-跨境销售集货订单) |
cashOnDeliveryType | String | OMS0002 | 货到付款方式 |
cashOnDeliveryValue | String | 89.32 | 代收货款金额 |
expectDate | String | 2015-07-26 | 期望送货日期,格式:yyyy-MM-dd |
expectTime | String | 13:26:17 | 期望送货时间,格式:HH:mm:ss |
insuredValue | String | 0 | 保价标识(0:需要保价、1:不需要保价) |
logisticOrderId | String | LES00001 | 苏宁物流订单号 |
note | String | 轻拿轻放 | 备注 |
soCreatDate | String | 2015-07-25 | 订单创建日期,格式:yyyy-MM-dd |
soCreatTime | String | 13:26:17 | 订单创建时间,格式:HH:mm:ss |
taskOrderid | String | 100....0000 | 任务单号 |
valueUnit | String | 元 | 金额单位(元) |
feedBackOrderCustomers | String | ||
address | String | 苏宁大道1号 | 详细地址文本 |
city | String | 南京市 | 城市文本 |
country | String | CN | 国家代码 |
customerId | String | 10021120 | 客户编号 |
customerType | String | AG | 客户类型(AG-货主客户;WE-送达方客户,如铺货入库地点或销售发货顾客) |
district | String | 玄武区 | 区/县文本 |
String | chan@163.com | 电子邮箱 | |
fixedLineTelephone | String | 025-66996699 | 固定电话 |
itemNumber | String | 1 | 行序号 |
logisticsOrderId | String | LES00001 | 苏宁物流订单号 |
mobilePhone | String | 18600000000 | 手机号码 |
name | String | SN | 客户名称 |
province | String | 江苏省 | 省文本 |
zipCode | String | 210000 | 邮编 |
feedBackOrderItems | String | ||
commodityCode | String | 1002111542 | 苏宁商品编码 |
comValue | String | 100.00 | 商品净值 |
goodsCode | String | Sn00001 | 商品编码 |
goodsDescription | String | IPHONE 6 PLUS | 商品描述 |
goodsHeight | String | 10.0 | 商品高 |
goodsLength | String | 1 | 商品长 |
goodsNumber | String | 1 | 数量 |
goodsUnit | String | 件 | 数量单位(件) |
goodsVolume | String | 12 | 商品体积 |
goodsWeight | String | 200 | 商品重量 |
goodsWidth | String | 10.0 | 商品宽 |
itemNumber | String | 1 | 行序号 |
linearUnit | String | cm | 长度单位 |
location | String | D025 | 收发货地点编号 |
locationDescription | String | 苏宁总部二期 | 地点描述 |
logisticsExpressId | String | 115521021223 | 苏宁物流运单号 |
logisticsOrderId | String | LES00001 | 苏宁物流订单号 |
shcode | String | H110202115 | 海关商品代码 |
storage | String | A0001 | 库位 |
storageDescription | String | 小件装载区 | 库位描述 |
valueUnit | String | CNY | 净值单位 |
volumeUnit | String | cm³ | 体积单位 |
weightUnit | String | g | 重量单位 |
<sn_responseContent> <sn_body> <getLogisticsCrossbuyTask> <feedBackOrderCustomers> <customerType>AG</customerType> <fixedLineTelephone>025-66996699</fixedLineTelephone> <logisticsOrderId>LES00001</logisticsOrderId> <city>南京市</city> <country>CN</country> <customerId>10021120</customerId> <mobilePhone>18600000000</mobilePhone> <address>苏宁大道1号</address> <zipCode>210000</zipCode> <name>SN</name> <province>江苏省</province> <eMail>chan@163.com</eMail> <itemNumber>1</itemNumber> <district>玄武区</district> </feedBackOrderCustomers> <feedBackOrderItems> <storageDescription>小件装载区</storageDescription> <logisticsExpressId>115521021223</logisticsExpressId> <goodsVolume>12</goodsVolume> <goodsWidth>10.0</goodsWidth> <weightUnit>g</weightUnit> <shcode>H110202115</shcode> <locationDescription>苏宁总部二期</locationDescription> <location>D025</location> <goodsNumber>1</goodsNumber> <logisticsOrderId>LES00001</logisticsOrderId> <linearUnit>cm</linearUnit> <goodsCode>Sn00001</goodsCode> <goodsLength>1</goodsLength> <valueUnit>CNY</valueUnit> <volumeUnit>cm³</volumeUnit> <goodsDescription>IPHONE 6 PLUS</goodsDescription> <goodsHeight>10.0</goodsHeight> <itemNumber>1</itemNumber> <goodsWeight>200</goodsWeight> <goodsUnit>件</goodsUnit> <commodityCode>1002111542</commodityCode> <comValue>100.00</comValue> <storage>A0001</storage> </feedBackOrderItems> <feedBackImformation> <valueUnit>元</valueUnit> <logisticOrderId>LES00001</logisticOrderId> <btcOrderId>10001010235</btcOrderId> <btcItemNumber>2</btcItemNumber> <soCreatDate>2015-07-25</soCreatDate> <soCreatTime>13:26:17</soCreatTime> <expectTime>13:26:17</expectTime> <cashOnDeliveryValue>89.32</cashOnDeliveryValue> <insuredValue>0</insuredValue> <taskOrderid>100....0000</taskOrderid> <businessType>C003</businessType> <announcedValue>1000</announcedValue> <cashOnDeliveryType>OMS0002</cashOnDeliveryType> <note>轻拿轻放</note> <expectDate>2015-07-26</expectDate> <btcItemOrderId>11235131513</btcItemOrderId> </feedBackImformation> </getLogisticsCrossbuyTask> </sn_body> </sn_responseContent>
{ "sn_responseContent": { "sn_body": { "getLogisticsCrossbuyTask": { "feedBackOrderCustomers": [ { "customerId": "10021120", "customerType": "AG", "mobilePhone": "18600000000", "address": "苏宁大道1号", "name": "SN", "zipCode": "210000", "eMail": "chan@163.com", "province": "江苏省", "logisticsOrderId": "LES00001", "fixedLineTelephone": "025-66996699", "itemNumber": "1", "district": "玄武区", "country": "CN", "city": "南京市" } ], "feedBackImformation": { "btcOrderId": "10001010235", "soCreatDate": "2015-07-25", "expectTime": "13:26:17", "insuredValue": "0", "taskOrderid": "100....0000", "businessType": "C003", "cashOnDeliveryType": "OMS0002", "valueUnit": "元", "logisticOrderId": "LES00001", "btcItemNumber": "2", "soCreatTime": "13:26:17", "cashOnDeliveryValue": "89.32", "announcedValue": "1000", "note": "轻拿轻放", "btcItemOrderId": "11235131513", "expectDate": "2015-07-26" }, "feedBackOrderItems": [ { "storageDescription": "小件装载区", "logisticsExpressId": "115521021223", "goodsVolume": "12", "goodsWidth": "10.0", "weightUnit": "g", "shcode": "H110202115", "locationDescription": "苏宁总部二期", "location": "D025", "goodsNumber": "1", "logisticsOrderId": "LES00001", "linearUnit": "cm", "goodsCode": "Sn00001", "goodsLength": "1", "valueUnit": "CNY", "volumeUnit": "cm³", "goodsDescription": "IPHONE 6 PLUS", "itemNumber": "1", "goodsHeight": "10.0", "goodsWeight": "200", "goodsUnit": "件", "comValue": "100.00", "commodityCode": "1002111542", "storage": "A0001" } ] } } } }
异常码 | 错误描述 | 解决方案 |
---|---|---|
biz.logistics.getcrossbuytask.missing-parameter:* | 参数必填 | 请检查此参数的值,*号表示参数字段名 |
biz.handler.data-get:no-result | 查询没结果 | 请检查查询参数 |
isp.sys.service.unavailable.lsp | 服务不可用 | 请联系苏宁技术人员 |
异常码 | 错误描述 | 解决方案 |
---|---|---|
sys.check.user-permission:inexistence | 访问令牌不存在 | 更换访问令牌 |
sys.check.user-permission:overdue | 访问令牌已过期 | 请使用刷新令牌刷新 |
sys.check.api-permission:inexistence | Api方法不存在 | 请参考帮助中心 |
sys.check.api-permission:overdue | Api方法已过期 | 请参考帮助中心 |
sys.check.method-permission:authority | 无权操作此api | 确认是否有访问该方法权限 |
sys.auth.vendor-request:errory | 无权操作此供应商 | 请确认供应商编码是否正确 |
sys.controller.api-request:limit | Api请求受控 | 超过请求次数 |
sys.check.app-time:error | 请求参数错误api请求时间误差大 | 参考帮助中心 |
sys.check.request-params:error | 请求报文结构错误 | 参考帮助中心、日期格式等 |
sys.check.starttime-format:error | 请求开始时间错误 | 参考帮助中心、日期格式等 |
biz.handler.data-get:success | 业务数据查询成功 | 无 |
biz.handler.data-get:fail | 业务数据查询失败 | 检查请求条件 |
biz.handler.data-get:no-result | 业务数据结果为空 | 无 |
sys.check.pageno-format:error | pageNo格式错误,只允许1到99999之间的整数 | 检查pageNo输入是否有误 |
sys.check.pagesize-format:error | pageSize格式错误,只允许1到50之间的整数(订单相关是1到100) | 检查pageSize输入是否有误 |
sys.check.page-param:error | pageNo或者pageSize不在要求范围内,pageNo只允许1到99999之间的整数,pageSize只允许1到50之间的整数(订单相关是1到100) | 检查pageNo和pageSize输入是否有误 |
sys.check.miss-time:starttime | 不存在开始时间(节点) | 检查输入 |
sys.check.miss-time:endtime | 不存在结束时间(节点) | 检查输入 |
sys.check.starttime-value:null | 开始时间为空(值) | 检查输入 |
sys.check.endtime-value:null | 结束时间为空(值) | 检查输入 |
sys.check.starttime-format:error | 校验开始时间不合法,格式yyyy-MM-dd HH:mm:ss | 检查时间格式 |
sys.check.endtime-format:error | 校验结束时间不合法,格式yyyy-MM-dd HH:mm:ss | 检查时间格式 |
sys.check.query-time:error | 开始时间是否小于结束时间 | 检查开始和结束时间大小 |
sys.check.query-time:outofrange | 时间查询是否超出指定范围 | 检查时间范围 |
sys.check.app-sign:null | 签名信息为空 | 检查签名信息 |
sys.check.app-sign:error | 签名信息错误 | 检查签名信息 |
sys.check.missing-parameter:apiversion | API版本号未指定 | 检查API版本号 |
sys.check.missing-parameter:appRequestTime | 请求时间丢失 | 检查请求时间 |
sys.check.missing-nestElement:sn_body | 缺少sn_body节点 | 检查sn_body是否存在 |
sys.check.user-permission:inexistence | 用户key不存在 | 检查用户key是否存在 |
biz.handler.batch-handler:no-support | 非查询类API不支持批量操作 | 检查API类型 |
biz.handler.request-message:error | 查询类API输入多个业务节点 | 检查业务节点 |
sys.check.header-param:null | header参数为空 | 请检查header参数 |
sys.controller.api-access:limit | 访问限制 | 无 |
sys.controller.api-frequency:limit | 访问频率限制 | 无 |
sys.error.network:failure | 网络异常 | 无 |
sys.error.network-status:? | 响应失败 ?为状态码 | 无 |
sys.check.snunionid.length.is.not:48 | 混淆会员编码长度不是48位 | 使用转换器转换混淆会员编码规定要求混淆会员编码48位 |
Q:苏宁物流跨境购任务派发信息单笔查询接口如何使用?
A:通过此接口单笔查询苏宁物流跨境购任务派发信息