4PS揽件订单下单接口
名称 | 类型 | 是否必须 | 示例值 | 描述 |
---|---|---|---|---|
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授权方式为必填参数 |
名称 | 类型 | 是否必须 | 示例值 | 描述 |
---|---|---|---|---|
expressCompCode | String | Y | SN2 | 快递公司编码 |
marketingProduct | String | Y | 10 | 营销产品 |
orderSource | String | Y | 201 | 订单来源 |
packageList | String | N | ||
agentAmount | String | N | 1253.33 | 代收货款金额 |
agentOption | String | N | 02 | 代收货款方式 |
carFlag | String | Y | 0 | 是否整车直达 |
dstributeAndInstall | String | Y | 0 | 是否送装一体 |
expressNo | String | N | 6258986525522 | 已有面单号 |
fullCarType | String | N | T180 | 整车车型 |
goodsQty | String | Y | 3 | 商品数量 |
insyredValue | String | N | 15000 | 保价金额 |
outOrderNum | String | N | 25845632555555 | 外部订单号 |
packageComment | String | N | 备注 | 备注 |
packageHeight | String | N | 64 | 包裹高(cm) |
packageLength | String | N | 22 | 包裹长(cm) |
packageName | String | Y | 手机 | 寄托物名称 |
packageNo | String | Y | 1 | 包裹序号 |
packageVolume | String | N | 3333333 | 包裹体积 |
packageWeight | String | Y | 3 | 重量(kg) |
packageWidth | String | N | 64 | 包裹宽(cm) |
packing | String | Y | 1 | 是否包装 |
pickupMode | String | Y | 01 | 取件方式 |
selfFeedingPoint | String | N | L025 | 自送点 |
serviceMode | String | Y | 01 | 送达方式 |
signReturn | String | Y | 1 | 签单返回 |
specialCarType | String | N | 空 | 专车直揽(默认为空) |
transportType | String | Y | 01 | 运输方式 |
receiverAddressDetail | String | Y | 仙女路 | 收件人详细地址 |
receiverCity | String | Y | 扬州市 | 收件人市 |
receiverCompany | String | N | 苏宁易购 | 收件人公司 |
receiverDistrict | String | Y | 江都区 | 收件人区/县 |
receiverMobile | String | N | 13802520698 | 收件人手机 |
receiverName | String | Y | 李四 | 收件人姓名 |
receiverProvince | String | Y | 江苏省 | 收件人省份 |
receiverTel | String | N | 025-66996699 | 收件人电话 |
receiverTown | String | N | 全区 | 收件人街道/乡镇 |
senderAddressDetail | String | Y | 文苑路南京财经大学 | 发件人详细地址 |
senderCity | String | Y | 南京市 | 发件人市 |
senderCompany | String | N | 苏宁云商有限公司 | 发件人公司 |
senderDistrict | String | Y | 栖霞区 | 发件人区/县 |
senderMobile | String | N | 13802356421 | 发件人手机 |
senderName | String | Y | 张山 | 发件人姓名 |
senderProvince | String | Y | 江苏省 | 发件人省(中文) |
senderTel | String | N | 025-66996699 | 发件人电话 |
senderTown | String | N | 全区 | 发件人街道/乡镇 |
uuid | String | Y | 2564EDSF1287RFDROPIG4567IUYT2594IJHG | UUID |
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
createTime | String | 2015-11-11 10:42:00 | 订单创建时间 |
innerOrderId | String | D201702041256 | 订单号 |
packageList | String | ||
errorInfo | String | 错误 | 错误描述 |
expressNo | String | 625896321 | 运单号 |
outOrderNum | String | 56325894123 | 外部订单号 |
packageNo | String | 01 | 包裹序号 |
routeInfo | String | 北京 | 路由信息 |
success | String | Y | 校验结果 |
uuid | String | 2564EDSF1287RFDROPIG4567IUYT2594IJHG | uuid |
<sn_request> <sn_body> <addExpressorder> <senderTown>全区</senderTown> <receiverDistrict>江都区</receiverDistrict> <senderCompany>苏宁云商有限公司</senderCompany> <senderProvince>江苏省</senderProvince> <orderSource>201</orderSource> <receiverAddressDetail>仙女路</receiverAddressDetail> <receiverTel>025-66996699</receiverTel> <receiverMobile>13802520698</receiverMobile> <receiverProvince>江苏省</receiverProvince> <packageList> <selfFeedingPoint>L025</selfFeedingPoint> <serviceMode>01</serviceMode> <packageNo>1</packageNo> <packageName>手机</packageName> <signReturn>1</signReturn> <pickupMode>01</pickupMode> <agentAmount>1253.33</agentAmount> <carFlag>0</carFlag> <specialCarType>空</specialCarType> <insyredValue>15000</insyredValue> <packageWeight>3</packageWeight> <fullCarType>T180</fullCarType> <packageLength>22</packageLength> <outOrderNum>25845632555555</outOrderNum> <goodsQty>3</goodsQty> <expressNo>6258986525522</expressNo> <packageHeight>64</packageHeight> <packing>1</packing> <packageVolume>3333333</packageVolume> <packageWidth>64</packageWidth> <transportType>01</transportType> <dstributeAndInstall>0</dstributeAndInstall> <packageComment>备注</packageComment> <agentOption>02</agentOption> </packageList> <senderTel>025-66996699</senderTel> <expressCompCode>SN2</expressCompCode> <receiverCompany>苏宁易购</receiverCompany> <receiverCity>扬州市</receiverCity> <senderName>张山</senderName> <marketingProduct>10</marketingProduct> <receiverTown>全区</receiverTown> <senderDistrict>栖霞区</senderDistrict> <senderCity>南京市</senderCity> <senderAddressDetail>文苑路南京财经大学</senderAddressDetail> <receiverName>李四</receiverName> <uuid>2564EDSF1287RFDROPIG4567IUYT2594IJHG</uuid> <senderMobile>13802356421</senderMobile> </addExpressorder> </sn_body> </sn_request>
{ "sn_request": { "sn_body": { "addExpressorder": { "senderTown": "全区", "receiverDistrict": "江都区", "senderCompany": "苏宁云商有限公司", "senderProvince": "江苏省", "orderSource": "201", "receiverAddressDetail": "仙女路", "receiverTel": "025-66996699", "receiverMobile": "13802520698", "receiverProvince": "江苏省", "packageList": [ { "selfFeedingPoint": "L025", "serviceMode": "01", "packageNo": "1", "packageName": "手机", "signReturn": "1", "pickupMode": "01", "agentAmount": "1253.33", "carFlag": "0", "specialCarType": "空", "insyredValue": "15000", "packageWeight": "3", "fullCarType": "T180", "packageLength": "22", "outOrderNum": "25845632555555", "goodsQty": "3", "packageHeight": "64", "expressNo": "6258986525522", "packing": "1", "packageVolume": "3333333", "packageWidth": "64", "packageComment": "备注", "dstributeAndInstall": "0", "transportType": "01", "agentOption": "02" } ], "senderTel": "025-66996699", "receiverCompany": "苏宁易购", "expressCompCode": "SN2", "receiverCity": "扬州市", "marketingProduct": "10", "senderName": "张山", "receiverTown": "全区", "senderDistrict": "栖霞区", "senderCity": "南京市", "senderAddressDetail": "文苑路南京财经大学", "receiverName": "李四", "senderMobile": "13802356421", "uuid": "2564EDSF1287RFDROPIG4567IUYT2594IJHG" } } } }
<sn_responseContent> <sn_body> <addExpressorder> <createTime>2015-11-11 10:42:00</createTime> <innerOrderId>D201702041256</innerOrderId> <packageList> <routeInfo>北京</routeInfo> <packageNo>01</packageNo> <errorInfo>错误</errorInfo> <outOrderNum>56325894123</outOrderNum> <expressNo>625896321</expressNo> <success>Y</success> </packageList> <uuid>2564EDSF1287RFDROPIG4567IUYT2594IJHG</uuid> </addExpressorder> </sn_body> </sn_responseContent>
{ "sn_responseContent": { "sn_body": { "addExpressorder": { "createTime": "2015-11-11 10:42:00", "innerOrderId": "D201702041256", "packageList": [ { "routeInfo": "北京", "errorInfo": "错误", "packageNo": "01", "outOrderNum": "56325894123", "expressNo": "625896321", "success": "Y" } ], "uuid": "2564EDSF1287RFDROPIG4567IUYT2594IJHG" } } } }
异常码 | 错误描述 | 解决方案 |
---|---|---|
biz.fourps.addexpressorder.missing-parameter:* | 参数必填 | 请检查此参数的值,*号表示参数字段名 |
biz.fourps.addexpressorder.format-error:* | 参数格式错误 | 请检查此参数的值,*号表示参数字段名 |
biz.fourps.addexpressorder.length-overlong:* | 参数的值超过规定长度 | 请检查此参数的值,*号表示参数字段名 |
biz.fourps.addexpressorder.enumeration-error:* | 参数的可选值错误 | 请检查此参数的值,*号表示参数字段名 |
isp.sys.service.unavailable.fpscs | 服务不可用 | 请联系苏宁技术人员 |
biz.fourps.addexpressorder.invalid-biz:100 | 请求uuid重复 | 请重新输入uuid |
biz.fourps.addexpressorder.invalid-biz:102 | 发件人省市区校验不通过 | 请输入正确的省市区 |
biz.fourps.addexpressorder.invalid-biz:106 | 收件人省、市、区校验不通过 | 请输入正确的省市区 |
biz.fourps.addexpressorder.invalid-biz:110 | 发件人手机、电话二者必填其一 | 请输入发件人手机或电话 |
biz.fourps.addexpressorder.invalid-biz:111 | 收件人手机、电话二者必填其一 | 请输入收件人手机或电话 |
biz.fourps.addexpressorder.invalid-biz:112 | 当“是否代收付款”为1时,“代收货款方式”必填 | 请选择代收货款方式 |
biz.fourps.addexpressorder.invalid-biz:113 | 当“提货方式”为02时,“是否外接外送”必为0 | 请重新选择“是否外接外送方式” |
biz.fourps.addexpressorder.invalid-biz:114 | 当“是否外接外送”为2时,“整车车型”必填 | 请填写整车车型 |
biz.fourps.addexpressorder.invalid-biz:115 | 当“提货方式”为02时,自送点必填 | 请填写自送点 |
biz.fourps.addexpressorder.invalid-biz:116 | 自送点无效 | 请填写正确的自送点 |
biz.fourps.addexpressorder.invalid-biz:117 | 包裹长宽高和体积只能填写一个 | 请重新填写 |
biz.fourps.addexpressorder.invalid-biz:118 | 当填写长宽高中任意一个时,另外两个必填 | 请重新填写长宽高 |
biz.fourps.addexpressorder.invalid-biz:119 | 单个包裹保价金额必须小于20000 | 请重新填写 |
biz.fourps.addexpressorder.invalid-biz:120 | 代收货款金额小于20000 | 请重新填写 |
biz.fourps.addexpressorder.invalid-biz:123 | 包裹序号必须在01-99之间 | 请重新填写 |
biz.fourps.addexpressorder.invalid-biz:124 | 包裹序号不能重复 | 请重新填写包裹序号 |
biz.fourps.addexpressorder.invalid-biz:125 | 行项目中“面单号”不能重复 | 请重新填写面单号或请求电子面单号 |
biz.fourps.addexpressorder.invalid-biz:126 | 您所订购的营销产品不支持您所选增值服务 | 请重新填写 |
biz.fourps.addexpressorder.invalid-biz:127 | 您未订购*增值服务 | 请重写填写 |
biz.fourps.addexpressorder.invalid-biz:129 | 专车直揽,自送点和整车车型必须为空 | 请重新填写 |
biz.fourps.addexpressorder.invalid-biz:130 | 整车直揽,整车车型必须有值且自送点必为空 | 请重新填写 |
异常码 | 错误描述 | 解决方案 |
---|---|---|
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位 |