订单信息提交
名称 | 类型 | 是否必须 | 示例值 | 描述 |
---|---|---|---|---|
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授权方式为必填参数 |
名称 | 类型 | 是否必须 | 示例值 | 描述 |
---|---|---|---|---|
platFormTrade | String | N | ||
memberNo | String | Y | 23456543 | 会员号 |
orderStatus | String | Y | 01 | 01-订单提交 |
orderType | String | Y | A001 | 普通订单 |
cartTwoNo | String | N | DLJA2018114812000000 | 购物车2号,是否促销为1时必填 |
orderId | String | Y | 123342312 | 订单号 |
totalNo | String | Y | 2 | 订单行总数 |
receiverProvince | String | Y | 江苏省 | 收货人所在省 |
payment | String | Y | 100.00 | 买家实付金额 |
receiverNationality | String | N | 中国 | 收货人所在国家 |
receiverCity | String | Y | 南京市 | 收货人所在城市 |
receiverCounty | String | Y | 江宁区 | 区 |
receiverStreet | String | N | 淳化街道 | 收货人所在街道 |
receiverAddress | String | Y | 修文路9号 | 收货人的详细地址 |
receiverZip | String | N | 210000 | 收货人所在地邮编 |
receiverMobile | String | Y | 12345678900 | 收货人手机号码 |
receiverPhone | String | N | 025-22222222 | 收货人固定电话号码 |
receiverName | String | Y | 张三 | 收货人姓名 |
invoiceTitleType | String | Y | 01 | 发票抬头类型 如:01 企业 02个人 |
invoiceType | String | Y | 01 | 发票类型,如:01增值税专用发票 、02 普通发票、04电子发票 |
invoiceTitle | String | Y | 个人消费 | 发票抬头 |
invoiceContent | String | N | 餐饮 | 发票内容 |
taxPayerNo | String | N | 21111 | 税号,当发票类型为增值税专用发票时,要求此字段必传! |
regPhone | String | N | 02584418888 | 注册电话,当发票类型为增值税专用发票时,要求此字段必传! |
regAddr | String | N | 举例:南京市白下区淮海路68号苏18F | 注册地址,当发票类型为增值税专用发票时,要求此字段必传! |
accntBank | String | N | 南京银行 | 开户银行,当发票类型为增值税专用发票时,要求此字段必传! |
bankAccntNum | String | N | 6YUIOP3456789009876 | 开户账号,当发票类型为增值税专用发票时,要求此字段必传! |
taxPayerAddr | String | N | 南京市白下区淮宁电器大厦18F | 发票收件人地址,当发票类型为增值税专用发票时,要求此字段必传! |
taxPayerName | String | N | 张三 | 发票收件人姓名,当发票类型为增值税专用发票时,要求此字段必传! |
taxPayerPhone | String | N | 02584418888 | 发票收件人电话,当发票类型为增值税专用发票时,要求此字段必传! |
taxMobilePhone | String | N | 02584418888 | 发票收件人手机,当发票类型为增值税专用发票时,要求此字段必传! |
isSupportPromotion | String | N | 0 | 是否支持促销(0:否;1:是) |
platFormOrder | String | N | ||
orderItemId | String | Y | 22222222222222 | 订单行号 |
orderItemStatus | String | N | 01 | 订单提交 |
skuId | String | Y | 1234 | 平台商品编码 |
outerSkuId | String | Y | 123456789 | 外部商品编码(苏宁商品编码) |
price | String | Y | 100.00 | 单价 |
saleNum | String | Y | 3 | 销售数量 |
pointAmount | String | N | 1.00 | 积分抵扣金额 |
postage | String | Y | 5.00 | 邮费 |
orderPayment | String | Y | 10.00 | 行实付金额 |
totalFee | String | Y | 12.00 | 行应付金额 |
promotionNum | String | N | 201419801004** | 活动编码。当商品为参加大聚惠活动商品时,此字段为必填! |
businessSign | String | N | 0 | 业务标识,默认传【0】,【是否支持促销】字段为【1:是】时,必填; 0:普通商品; 1:海外购; |
fullReductionInfo | String | N | ||
fullReductionType | String | N | 1 | 满减类型 |
bonusId | String | N | 2079097 | 奖励编码,有苏宁的满减时【必填】 |
fullReductionAmount | String | N | 2.00 | 满减金额 |
activityId | String | N | 1233434 | 活动ID |
provider | String | N | 01 | 优惠承担方 ,01:苏宁 02:平台.有满减活动时必填 |
couponInfo | String | N | ||
couponType | String | N | 01 | 券类型,01:苏宁券 02:平台券.有券时必填 |
couponAmount | String | N | 1.00 | 券金额 |
couponCode | String | N | 21212 | 券编码 |
selectedArrivalTime | String | N | 2018-08-01-2 | 预约时效标识为Y时必填 |
selectedInstallDate | String | N | 123 | 预约时效标识为Y,且商品需要安装时必填 格式[{"2018-08-19":["3","2","1"]}] |
giftCardList | String | N | ||
giftCardType | String | N | 01 | 礼品卡类型:01-平台承担 |
giftCardAmount | String | N | 10.00 | 礼品卡金额 |
giftCardCode | String | N | 1232332342 | 礼品卡编码 |
chanId | String | Y | 01 | 下单渠道(01:PC 02:APP 03:WAP) |
bespoke | String | N | Y | 传Y表示外平台接了预约时效功能,采用新下单流程; 传N或传空或没有本字段入参表示外平台未接预约时效功能,用旧下单流程 |
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
orderId | String | 122222222 | 平台订单号 |
orderItems | String | ||
orderItemId | String | 251225550008280499 | 订单行号 |
settlementValue | String | 12.00 | 结算数值 |
settlementType | String | 1 | 结算类型(1:结算价 2:平台使用费比例 3:推广服务费比例) |
arriveTime | String | 2018-04-11 15:00:00 | 送达时间 |
installTime | String | 2018-04-11 15:00:00 | 安装时间 |
<sn_request> <sn_body> <createOrder> <platFormTrade> <taxPayerAddr>南京市白下区淮宁电器大厦18F</taxPayerAddr> <invoiceTitleType>01</invoiceTitleType> <bankAccntNum>6YUIOP3456789009876</bankAccntNum> <chanId>01</chanId> <cartTwoNo>DLJA2018114812000000</cartTwoNo> <taxPayerNo>21111</taxPayerNo> <receiverAddress>修文路9号</receiverAddress> <receiverStreet>淳化街道</receiverStreet> <invoiceTitle>个人消费</invoiceTitle> <totalNo>2</totalNo> <receiverName>张三</receiverName> <taxPayerName>张三</taxPayerName> <orderId>123342312</orderId> <memberNo>23456543</memberNo> <bespoke>Y</bespoke> <receiverPhone>025-22222222</receiverPhone> <platFormOrder> <orderItemId>22222222222222</orderItemId> <fullReductionInfo> <fullReductionAmount>2.00</fullReductionAmount> <activityId>1233434</activityId> <fullReductionType>1</fullReductionType> <bonusId>2079097</bonusId> <provider>01</provider> </fullReductionInfo> <businessSign>0</businessSign> <saleNum>3</saleNum> <selectedInstallDate>123</selectedInstallDate> <postage>5.00</postage> <orderPayment>10.00</orderPayment> <totalFee>12.00</totalFee> <price>100.00</price> <pointAmount>1.00</pointAmount> <giftCardList> <giftCardAmount>10.00</giftCardAmount> <giftCardCode>1232332342</giftCardCode> <giftCardType>01</giftCardType> </giftCardList> <orderItemStatus>01</orderItemStatus> <outerSkuId>123456789</outerSkuId> <skuId>1234</skuId> <promotionNum>201419801004**</promotionNum> <couponInfo> <couponAmount>1.00</couponAmount> <couponType>01</couponType> <couponCode>21212</couponCode> </couponInfo> <selectedArrivalTime>2018-08-01-2</selectedArrivalTime> </platFormOrder> <payment>100.00</payment> <orderType>A001</orderType> <regPhone>02584418888</regPhone> <isSupportPromotion>0</isSupportPromotion> <receiverCounty>江宁区</receiverCounty> <invoiceType>01</invoiceType> <receiverMobile>12345678900</receiverMobile> <accntBank>南京银行</accntBank> <receiverProvince>江苏省</receiverProvince> <regAddr>举例:南京市白下区淮海路68号苏18F</regAddr> <receiverNationality>中国</receiverNationality> <orderStatus>01</orderStatus> <taxMobilePhone>02584418888</taxMobilePhone> <receiverCity>南京市</receiverCity> <taxPayerPhone>02584418888</taxPayerPhone> <receiverZip>210000</receiverZip> <invoiceContent>餐饮</invoiceContent> </platFormTrade> </createOrder> </sn_body> </sn_request>
{ "sn_request": { "sn_body": { "createOrder": { "platFormTrade": { "invoiceTitleType": "01", "taxPayerAddr": "南京市白下区淮宁电器大厦18F", "bankAccntNum": "6YUIOP3456789009876", "chanId": "01", "cartTwoNo": "DLJA2018114812000000", "taxPayerNo": "21111", "receiverStreet": "淳化街道", "receiverAddress": "修文路9号", "invoiceTitle": "个人消费", "totalNo": "2", "receiverName": "张三", "taxPayerName": "张三", "orderId": "123342312", "memberNo": "23456543", "bespoke": "Y", "receiverPhone": "025-22222222", "platFormOrder": [ { "orderItemId": "22222222222222", "fullReductionInfo": [ { "activityId": "1233434", "fullReductionAmount": "2.00", "bonusId": "2079097", "fullReductionType": "1", "provider": "01" } ], "businessSign": "0", "saleNum": "3", "selectedInstallDate": "123", "postage": "5.00", "orderPayment": "10.00", "totalFee": "12.00", "price": "100.00", "pointAmount": "1.00", "giftCardList": [ { "giftCardAmount": "10.00", "giftCardCode": "1232332342", "giftCardType": "01" } ], "outerSkuId": "123456789", "orderItemStatus": "01", "promotionNum": "201419801004**", "skuId": "1234", "selectedArrivalTime": "2018-08-01-2", "couponInfo": [ { "couponAmount": "1.00", "couponType": "01", "couponCode": "21212" } ] } ], "payment": "100.00", "orderType": "A001", "regPhone": "02584418888", "isSupportPromotion": "0", "receiverCounty": "江宁区", "invoiceType": "01", "receiverMobile": "12345678900", "receiverProvince": "江苏省", "accntBank": "南京银行", "receiverNationality": "中国", "regAddr": "举例:南京市白下区淮海路68号苏18F", "orderStatus": "01", "receiverCity": "南京市", "taxMobilePhone": "02584418888", "taxPayerPhone": "02584418888", "receiverZip": "210000", "invoiceContent": "餐饮" } } } } }
<sn_responseContent> <sn_body> <createOrder> <orderItems> <settlementType>1</settlementType> <settlementValue>12.00</settlementValue> <orderItemId>251225550008280499</orderItemId> <arriveTime>2018-04-11 15:00:00</arriveTime> <installTime>2018-04-11 15:00:00</installTime> </orderItems> <orderId>122222222</orderId> </createOrder> </sn_body> </sn_responseContent>
{ "sn_responseContent": { "sn_body": { "createOrder": { "orderItems": [ { "settlementType": "1", "arriveTime": "2018-04-11 15:00:00", "orderItemId": "251225550008280499", "settlementValue": "12.00", "installTime": "2018-04-11 15:00:00" } ], "orderId": "122222222" } } } }
异常码 | 错误描述 | 解决方案 |
---|---|---|
isp.sys.service.unavailable.pangu | 服务不可用 | 请联系苏宁技术人员 |
biz.online.createorder.length-overlong:* | 参数的值超过规定长度 | 请检查此参数的值,*号表示参数字段名 |
biz.online.createorder.enumeration-error:* | 参数的可选值错误 | 请检查此参数的值,*号表示参数字段名 |
biz.online.createorder.format-error:* | 参数格式错误 | 请检查此参数的值,*号表示参数字段名 |
biz.online.createorder.missing-parameter:* | 参数必填 | 请检查此参数的值,*号表示参数字段名 |
biz.online.createorder.invalid-biz:100 | SO_E0001:订单正在处理,不允许重复提交 | 请不要重复提交订单 |
biz.online.createorder.invalid-biz:104 | E9999:其他异常 | 请联系苏宁技术人员 |
biz.online.createorder.invalid-biz:105 | 该单含有非选品商品,商品编码为XX,不可销售 | 提交失败 |
biz.online.createorder.invalid-biz:106 | 地址信息解析报错 | 请重新检查地址信息后提交订单 |
biz.online.createorder.invalid-biz:107 | 该单存在不可售商品,商品编码为XX | 提交失败 |
biz.online.createorder.invalid-biz:108 | 该单存在不可配送的商品,商品编码为XX | 提交失败 |
biz.online.createorder.invalid-biz:109 | 库存不足 | 提交失败 |
biz.online.createorder.invalid-biz:110 | 活动过期 | 提交失败 |
biz.online.createorder.invalid-biz:111 | 活动数量不足 | 提交失败 |
biz.online.createorder.invalid-biz:112 | 活动资格校验失败 | 提交失败 |
biz.online.createorder.invalid-biz:113 | 订单行总金额与应付金额不一致 | 提交失败 |
biz.online.createorder.invalid-biz:114 | 未查询到平台配置信息 | 提交失败 |
biz.online.createorder.invalid-biz:115 | 调用接口发生异常或响应结果为空或异常 | 提交失败 |
biz.online.createorder.invalid-biz:116 | 商品价格不一致 | 提交失败 |
biz.online.createorder.invalid-biz:117 | 未知异常 | 提交失败 |
biz.online.createorder.invalid-biz:118 | 增票场景下手机号码和座机不能同时为空 | 提交失败 |
biz.online.createorder.invalid-biz:119 | 未找到原始校验行项目 | 提交失败 |
biz.online.createorder.invalid-biz:120 | 该平台不支持此支付方式 | 提交失败 |
biz.online.createorder.invalid-biz:121 | 订单已下发OMS | 提交失败 |
biz.online.createorder.invalid-biz:122 | 当前订单状态不允许提交订单 | 提交失败 |
biz.online.createorder.invalid-biz:123 | 活动ID不一致,请重新获取价格 | 提交失败 |
biz.online.createorder.invalid-biz:124 | 未支付运费 | 提交失败 |
biz.online.createorder.invalid-biz:125 | 运费计算错误 | 提交失败 |
biz.online.createorder.invalid-biz:126 | 当前价格类型不支持输出,限制下单 | 提交失败 |
biz.online.createorder.invalid-biz:127 | 超过单人限购数量,无法下单 | 提交失败 |
biz.online.createorder.invalid-biz:128 | 活动名额被占用,无法下单 | 提交失败 |
biz.online.createorder.invalid-biz:129 | 活动未开始或已结束,无法下单 | 提交失败 |
biz.online.createorder.invalid-biz:130 | 订单直降校验金额不一致 | 提交失败 |
biz.online.createorder.invalid-biz:131 | 优惠券数量不一致 | 提交失败 |
biz.online.createorder.invalid-biz:132 | 优惠券编码不一致 | 提交失败 |
biz.online.createorder.invalid-biz:133 | 优惠券金额不一致 | 提交失败 |
biz.online.createorder.invalid-biz:134 | 订单实付金额不一致 | 提交失败 |
biz.online.createorder.invalid-biz:135 | 奖励列表为空 | 提交失败 |
biz.online.createorder.invalid-biz:136 | 分摊明细列表为空 | 提交失败 |
biz.online.createorder.invalid-biz:137 | 该活动不存在 | 提交失败 |
biz.online.createorder.invalid-biz:138 | 查不到用券信息 | 提交失败 |
biz.online.createorder.invalid-biz:139 | 查不到用券详细信息 | 提交失败 |
biz.online.createorder.invalid-biz:140 | 购物车2号不存在 | 提交失败 |
biz.online.createorder.invalid-biz:141 | 活动不满足条件 | 提交失败 |
biz.online.createorder.invalid-biz:142 | 订单直降校验活动id不一致 | 提交失败 |
biz.online.createorder.invalid-biz:143 | 订单直降校验奖励id不一致 | 提交失败 |
biz.online.createorder.invalid-biz:144 | 订单直降校验金额不一致 | 提交失败 |
biz.online.createorder.invalid-biz:145 | 不支持苏宁促销活动 | 提交失败 |
biz.online.createorder.invalid-biz:146 | BusinessSign字段不能为空 | 提交失败 |
biz.online.createorder.invalid-biz:147 | XXX商品无对应主数据 | 提交失败 |
biz.online.createorder.invalid-biz:148 | 外平台预约配送时间有误,下单失败 | 提交失败 |
biz.online.createorder.invalid-biz:149 | 外平台预约安装时间有误,下单失败 | 提交失败 |
biz.online.createorder.invalid-biz:150 | {%s}接口已选送货时间校验失败 | 提交失败 |
biz.online.createorder.invalid-biz:151 | {%s}接口已选安装时间有误 | 下单失败 |
biz.online.createorder.invalid-biz:152 | 已选安装时间早于送达时间 | 下单失败 |
biz.online.createorder.invalid-biz:153 | 日期格式转换失败 | 下单失败 |
biz.online.createorder.invalid-biz:154 | PG未找到设备版本号,平台账号为XX | 下单失败 |
biz.online.createorder.invalid-biz:155 | %s不能为空 | 检查请求入参是否有值 |
异常码 | 错误描述 | 解决方案 |
---|---|---|
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位 |