通过此接口可进行单笔订单的查询。
1、订单号可通过接口“suning.custom.order.query”、“suning.custom.historyorder.query”、“suning.custom.ordercode.query”获取;
2、返回省、市、区代码与中文名称,及中文详细地址,省、市、区代码与详细中文地址省、市、区对应;
3、商户商品编码可依据苏宁商品编码,通过接口“suning.custom.item.get”获取;
4、订单状态指当前订单总状态,10表示待发货、20表示已发货、21表示部分发货、30表示交易成功、40表示交易关闭五种状态,部分发货状态表示订单行项目状态有待发货、已发货两种状态;
5、订单行项目状态指订单明细状态,10表示待发货、20表示已发货、30表示交易成功三种状态;
6、实际收款=价格*数量+运费-优惠券金额,payAmount已经是实付款,该公式用于验证;
7、bankTypeCode(银行种类编码)和payCode(支付方式编码)可通过http://open.suning.com/ospos/apipage/toApiMethodDetailMenu.do?interCode=suning.custom.dicwhole.query(查询全部)和http://open.suning.com/ospos/apipage/toApiMethodDetailMenu.do?interCode=suning.custom.dicsingle.query(查询单个)获取。
8、回款金额不是payAmount(付款金额),是指消费者最终支付的金额。(举例:商品单价100元,优惠10元,付款金额90元,支付时平台券抵用1元、云钻抵用5元、支付方式为易付宝时随机减0.5元,共6.5元,消费者最终支付83.5元,则回款金额为83.5元,其他6.5需要单独开票结算)
名称 | 类型 | 是否必须 | 示例值 | 描述 |
---|---|---|---|---|
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授权方式为必填参数 |
名称 | 类型 | 是否必须 | 示例值 | 描述 |
---|---|---|---|---|
orderCode | String | Y | 4511680451 | B2C订单号 |
historyOrderFlag | String | N | 1 | 查询历史标识 1:查询历史数据 |
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
account | String | 6YUIOP3456789009876 | 开户账号 |
bank | String | 南京市白下区淮海路68号苏宁电器大厦18F | 开户行 |
buyerOrdRemark | String | 尽快发货哦 | 订单备注(买家)--买家对订单的备注信息 |
cityCode | String | 000001000267 | 城市代码 |
cityName | String | 南京市 | 收件人地址(市)中文 |
customerAddress | String | 上海上海市黄浦区太平路18号 | 详细地址 |
customerName | String | 张三三 | 顾客姓名 |
districtCode | String | 00000001 | 区域代码 |
districtName | String | 玄武区 | 收件人地址(区)中文 |
evaluationMark | String | 0 | 评价状态。0=未评价;1=已评价 |
invoice | String | 发票内容 | 发票内容 |
invoiceHead | String | 张三三 | 发票抬头 |
invoiceRecipientAddress | String | 南京市白下区淮海路68号苏宁电器大厦18F | 发票收件人地址 |
invoiceRecipientHandPhone | String | 18651662963 | 发票收件人手机 |
invoiceRecipientName | String | 张涛 | 发票收件人姓名 |
invoiceRecipientPhone | String | 02584418888 | 发票收件人电话 |
invoiceType | String | 增值税 | 发票类型 -- 增值还是普通(01增值 02普通 04 电子发票) |
isCanModifyTransportFee | String | N | 是否能够修改运费 |
mobNum | String | 18611111111 | 买家联系电话 |
needinvoiceflag | String | Y | 是否需要发票(Y:需要,N:不需要) |
orderCode | String | 1000831522 | 订单号 |
orderDetail | String | ||
activitytype | String | 02 | 活动类型(02:渠道专享订单,03:免费试用订单,04:付邮试用订单,05,06:预定订单,07:秒杀订单,08:S码活动订单,09:赠品) |
activityTypes | String | ||
activityTypeCode | String | 1 | 活动类型(1:闪拍,2:免费试用,3:付邮试用,4:渠道专享,5:预定,6:秒杀,7:S码,8:大聚会,9:赠品) |
bLineNumber | String | 90004000001 | b2c行项目号 |
carShopAddr | String | 南京市白下区淮宁电器大厦18F | 汽车服务门店地址 |
carShopCode | String | 1001 | 汽车服务门店编码 |
carShopName | String | 南京市鼓楼区服务站 | 汽车服务门店名称 |
carShopSerWay | String | 1 | 汽车服务方式(1-上门服务,2-到店服务) |
carShopTel | String | 02558761110 | 汽车服务门店电话 |
couponList | String | ||
coupontype | String | 8012 | 券类型。券类型表示返券返积分的类型:5998-店铺优惠券、6998-联合0元购券、7998-0元购券、8012-积分抵现、9994-优惠券、9995-优惠券。 |
sharelimit | String | 20.00 | 销售单据分摊金额。订单返券返积分总金额需每个行项目的销售单据分摊额度累计。 |
coupontotalMoney | String | 0.00 | 优惠劵金额 |
declareGoodsAmount | String | 30.00 | 申报订单行货款 |
declareItemPrice | String | 20.00 | 申报单价 |
declareItemTaxfare | String | 2.00 | 申报税费 |
disType | String | 01 | 发货方式。01 代表海外直邮发货;02代表商家保税区发货;03代表苏宁保税区发货;空代表国内海外购 |
expresscompanycode | String | E01 | 物流公司编码 |
expressno | String | EMS1001 | 运单号 |
fpsdeliveryflag | String | 0 | 4PS发货标示,1代表4PS发货、0代表C店发货 |
hwgFlag | String | 01 | 海外购标识。01表示海外购订单,其他值为非海外购订单 |
invCode | String | D01 | 仓库编码 |
isProsupplierDelivery | String | 1 | 是否供应商发货标识,1代表是 |
itemCode | String | B1001 | 商家商品编码 |
itemTaxFare | String | 10.00 | 税费 |
mode | String | 02 | 通关模式(01:保税备货,02:海外直邮,03:个人申报,04:邮关) |
orderchannel | String | MOBILE | 订单渠道。PC,手机MOBILE,WAP, 电话PHONE |
orderChannels | String | ||
orderChannelCode | String | 1 | 订单渠道(1:网盟,2:手机订单,3:门店订单:) |
orderLineNumber | String | 1000231255 | 订单行项目号 |
orderLineStatus | String | 20 | 订单行项目状态。0:订单取消;5:等待支付;10=待发货;15:发货中;20=已发货;30=交易成功 |
packageorderid | String | 00000000100001785834 | 包裹号 |
payAmount | String | 299.00 | 付款金额。订单行项目金额 |
payerCustomerName | String | 张三 | 支付人姓名 |
payerIdNumber | String | 342111198811212222 | 支付人身份证号码 |
paymentList | String | ||
banktypecode | String | 10006 | 订单使用券/积分类型 |
offLinePayFlag | String | 1 | 线下支付:1;非线下支付:空值 |
payamount | String | 10.00 | 支付方式分摊金额。订单使用劵和积分总金额需每个行项目的支付方式分摊金额累计。 |
paycode | String | 4148 | 付款方式。4148-易付宝支付、5002-礼品卡支付、9003-门店付款、6901-券或云钻支付、6903-易付宝优惠券支付、2037-光大MIS银行卡(新)、1001-现金 (CASH)、2044-建行MIS银行卡(新)、6906-赠品支付、4237-支付宝支付、4245-微信支付、6915-铜板支付。(字段值为6901时,跟banktypecode[支付方式编码]字段关联) |
alipayPayNo | String | 2019010722001416950514272890 | 支付流水号 |
merchantPercent | String | 商家: 50.00% | 商家的承担比例(券的承担比例,只跟券相关) |
platformPercent | String | 平台: 50.00% | 平台的承担比例(券的承担比例,只跟券相关) |
bankTypeName | String | 店铺优惠券 | 订单使用券/积分名称 |
payName | String | 易付宝优惠券支付 | 付款方式说明 |
payorderid | String | P00000000100001785834 | 支付单号 |
payTypes | String | ||
payTypeCode | String | 1 | 支付方式(1:云钻-加钱购,2:云钻-全额兑,3:礼品卡,4:门店付款,5:货到付款,6:在线支付,7:支付宝) |
phoneIdentifyCode | String | 102003303202 | 手机串码 |
prmtcode | String | 01 | 推广方式。取值为01时,表示网盟 |
productCode | String | 102609881 | 苏宁商品编码 |
productName | String | 销售组汤锅02 | 商品中文名称 |
receivezipCode | String | 211806 | 收货人邮政编码 |
reservebalanceamount | String | 100.00 | 预定尾款金额 |
reservedepositamount | String | 100.00 | 预定定金金额 |
reservestatus | String | M | 预定状态(M:定金已支付,P:定金已罚没,R:定金已退还) |
returnOrderFlag | String | 1 | 退货订单标示位 0或空值表示正常订单, 1表示退货订单 |
saleNum | String | 1.00 | 数量 |
transportFee | String | 0.00 | 运费。订单行项目对应的运费 |
unitPrice | String | 188.00 | 商品单价 |
vouchertotalMoney | String | 0.00 | 优惠单金额 |
serviceItemFlag | String | 1 | 0非服务行 ,1服务行 |
otoStoreCode | String | 139123456 | O2O门店编码 |
otoStoreName | String | 海青O2O门店 | O2O门店编码 |
otoOrderType | String | 01-一口价电子凭证 02-特权定金 03-分阶段订单 04-线下现场拿货 05-线下快递上门 06-自营配件服务行(汽车配件服务行的到家场景) 07-门店代收服务行(汽车配件服务行的到店场景) 08-汽车服务行(指的是单独售卖服务行) | O2O订单类型 |
expandAmount | String | 100.00 | 膨胀金额 |
refVerifyCode | String | 123654789 | 特权定金验证码 |
orderServiceTypeMulti | String | 01,02,03,04,05 | 组合的订单业务类型,多种业务类型使用逗号分隔 如:01,02,03,04,05 01:公益订单 02:虚拟卡直冲订单: 03:虚拟卡卡密订单 04:运营商合约机订单: 05:云仓4PS订单 06:自营配件服务行 07:单独售卖服务行 08:云POS整车销售 09:驴妈妈订单 10:小店乐拼购单独购买 11:小店乐拼购拼团 12:同城帮 13:租金行 14:押金行 15:云pos特权订单 16 云POS分阶段订单 17 汽车油电订单 18:五菱汽车一口价非贷款 19:五菱汽车一口价贷款 20:五菱汽车特权定金 21:五菱汽车分阶段订单 22:买券订单 23:达尔文小程序订单 24:海外购仓配订单 25:一件代发 C店批发 26:一件代发 小B(B2C) 27:一件代发 大B(S2B) 28:海外购预定订单 29:小店海外购订单 30:家乐福茅台订单 31:电子门票方特 32:处方药订单 37:新接口入驻订单 33:商家自配送 34:苏宁物流配送-同城配 35:苏宁物流配送-全网配 36:到店自提 38:一级平台 39:二级平台 40:菜场 41:蟹卡 42:易值买 43:天天配ERP打标 44:2B库配 45:2B中转配 46:2C库配 47:抖音 48:2b直配 49:预售 52:拼购供价 50:APP下载外部商户 51:恶意订单 53:内容号项目订单 54:SSL仓配订单 55:SSL订单自配送 56:易购POP上有货 57:拼购上有货 58:天猫订单 59:6801订单 60:大药房 61:家电两步式 62:3C一站式 63:3C两步式 64:虚拟充值三方核销订单 66:有货分销订单 67:百货O2O订单 68:卖家版延保标识 71:零售云限时购 72:零售云云仓 69:中信银行担保标识1 70:中信银行担保标识2 73:工业品SSL订单 74:零售云样机订单 75:零售云资金大B订单 76:天猫代销官旗订单 77:小家电两步式 78:家乐福供货平台订单 79:快手订单 80:积分商城订单 81:私享家 82:苏宁直播 83:小B云仓 84:以旧换新-先送新后收旧 85:以旧换新-随单回收 86:小B云仓仓配一体同仓 87:拼多多 88:百度小店 89:淘宝订单 |
popContractInfo | String | ||
contractDealType | String | 01 | 合约业务类型:01-号卡选号;02-号卡不选号;03-宽带安装;04-合约机裸机;05-合约机老用户合约机;06-合约机新用户选号;07-合约机新用户不选号 |
selectedNum | String | 11111111111 | 购买时,选中的手机号 |
carrieroperator | String | 中国移动 | 运营商 |
setMealName | String | 包月20G流量 | 套餐名称 |
monthlyFee | String | 30.00 | 套餐的月费,单位元,保留两位小数 |
contractPeriod | String | 12月 | 合约期 |
countrywideFlow | String | 20G | 全国流量 |
nativeFlow | String | 20G | 本地流量 |
speechTime | String | 100 | 语音 |
messageAmt | String | 100 | 短信 |
returnFeeRule | String | 每月返上月1半费用 | 返费规则 |
feeDetails | String | 每月30,第二月返15 | 资费详细 |
monthlyFeeName | String | 首月20 | 首月资费名称 |
monthlyFeeContent | String | 首月20 | 首月资费内容 |
name | String | 张三 | 姓名 |
phoneNum | String | 13813911138 | 联系方式 |
cardNum | String | 320103199909210236 | 身份证号码 |
cardAddress | String | 江苏省南京市秦淮区苜蓿园大街64号 | 证件地址 |
installName | String | 李四 | 安装联系人姓名 |
installPhoneNum | String | 13813911111 | 安装联系电话(手机、座机如有都给) |
installAddress | String | 江苏省南京市秦淮区苜蓿园大街64号5楼 | 安装省市区镇+详细地址 |
remark | String | 尽快到 | 备注 |
frontPhoto | String | xxxxx.jpg | 正面照片 |
backPhoto | String | xxxxx.jpg | 反面照片 |
facePhoto | String | xxxxx.jpg | 人像照片 |
deliveryTime | String | 2018-01-01 01:01:01 | 发货时间 |
sendType | String | 2 | 物流发货方式:0:在线下单 1:自己联系物流 2:无需物流 3:没有合作的物流公司(其他物流) 4:电子面单发货 |
selfDeliveryName | String | 张三 | 送货人姓名(无需物流) |
selfDeliveryMobile | String | 13111111111 | 送货人联系电话号码(无需物流) |
returnFlag | String | 1 | 退款标志:1:退款中 2:退货成功 3:退款成功 |
complainFlag | String | 0 | 投诉标识 0:未投诉,1:已投诉 |
logisticsOrderId | String | E0187429485171112 | 物流订单编号 |
carService | String | ||
otoCommdtyCode | String | 102609449 | 服务对应实体商品编码 |
otoCommdtyName | String | 销售组汤锅00 | 服务对应实体商品名称 |
orderTagList | String | 01,02,03 | 订单标签列表,多个逗号分隔 01苏宁益品 |
dealPhoto | String | 交易快照 | http://sphss.suning.com/productspan/show.html?key=hyIkNcVTOOaTrSvDUAjLJJ3Ka19kNQGuw1bSyz4IT%2FOaq1PmY019faqywMBiMShL |
depositmoney | String | 1.00 | 押金 |
orderPayCode | String | 24 | 子支付方式:23-花呗支付;24-花呗分期支付 |
donationProjectInfo | String | ||
donationProjectId | String | 1001 | 公益项目编码 |
donationAmt | String | 99.99 | 公益捐赠金额 |
rentperiod | String | 1 | 租期 |
renttype | String | 01 | 租期类型 |
distributorName | String | 分销商名称 | 分销商名称 |
deliveryDeadlineTime | String | 2020-11-03 00:00:53 | 承诺发货截止时间 |
lastestOperateTime | String | 2020-11-30 00:00:00 | 状态操作时间 |
saleType | String | XH-TOB订单;FXH-TOC订单 | 销售类型 |
storeNameB | String | 小店加盟店 | (零售云业务)小B商户店铺名称 |
applyno | String | P000001000176 | 意向单申请号 |
version | String | 12C01XGC2021A00272 | 海尔工程版号 |
orderPaymentDetails | String | ||
voucherId | String | 202104120015798000 | 优惠活动编码:指类似满减活动之类的编码 |
allocatedAmount | String | 299 | 满减等优惠活动对应的商品抵扣金额 |
referencePrice | String | 299 | 参考价(指参加促销活动的商品,在提交订单时的非活动原价) |
itemComfirmReceiveGoodstime | String | 2021-06-15 00:00:01 | 行确认收货时间 |
receiveFlag | String | 1 | 针对家电两步式订单,receiveFlag 1代表旧机已回收完成,其他枚举值代表旧机未回收完成。 |
drugsReviewResult | String | Y | 处方药审核结果,Y:通过,N:拒绝,没有值:未审核 |
needSerialNumber | String | 1 | 是否回传序列号标识:0否,1 SN码 2 IMEI码 |
isAppointDelivery | String | Y | 是否预约发货 Y是,N否 |
actSettlementPrice | String | 12 | 活动结算价.该字段积分商城订单才有值,非积分商城订单无值 |
storeCodeB | String | 59021 | 小B店铺编码 |
asomOrderItemid | String | 1111111111 | 服务类型订单对应的服务单号 |
outCode | String | 200111111111 | 外部订单号 |
outItemCode | String | 20011111111101 | 外部订单行号 |
orderSaleTime | String | 2013-11-26 09:24:58 | 订单支付时间,格式:yyyy-MM-dd HH:mm:ss |
orderTotalStatus | String | 10 | 订单总状态,0 订单取消;5 未付款;10 买家已付款;15 发货中;20 已发货;21 部分发货;30 交易成功;40 交易关闭 |
payTotalAmount | String | 110.00 | 支付金额,支付方式的支付金额 |
payType | String | 礼品卡支付方式 | 支付方式,如礼品卡支付 |
provinceCode | String | 020 | 省份代码。 |
provinceName | String | 江苏省 | 收件人地址(省)中文 |
registerAddress | String | 南京市白下区淮海路68号苏宁电器大厦18F | 注册地址 |
registerPhone | String | 02584418888 | 注册电话 |
sellerOrdRemark | String | 顾客要求延迟发货 | 订单备注(卖家)--商家对订单的备注信息 |
userName | String | huiyuan2013_sit009@163.com | 买家帐号 |
vatTaxpayerNumber | String | WERTDTG1234567 | 纳税人识别号 |
guideAccountNo | String | msopo2o@1.com | 下单导购帐号 |
orderTime | String | 2018-01-01 01:01:01 | 订单提交时间 |
zipCode | String | 210001 | 收件人邮编 |
colorMarkFlags | String | 0 | 卖家备注旗帜:0表示灰色, 1表示红色, 2表示黄色, 3表示绿色, 4表示蓝色, 5表示紫色 |
phoneNum | String | 025-66996699 | 收件人固定电话 |
detailAddress | String | 玄武大道1号苏宁总部 | 详细地址(街道) |
deliveryArea | String | 210001 | 运输区域编码 |
countMoney | String | 111.00 | 订单行“支付金额”总和 |
sumDonationAmt | String | 66.99 | 苏宁益品捐赠总金额 |
memNo | String | 1111111 | 会员编码 |
itemCounts | String | 2 | 订单行数量 |
confirmGoodsTime | String | 2020-11-30 00:00:00 | 顾客确认收货时间 |
customerAddressOld | String | 江苏南京市鼓楼区徐庄软件园 | 地址信息申请修改:修改前收货地址 |
isUpdateAddress | String | Y或者N | 是否有修改收货人信息 |
sid | String | BBDF4B492FA1878D7A73C25F5EE4DA22D425C50DDD181E50CE3D8234C4B27DD8A65CB... | customerAddress+customerName+mobNum加密字段,解密后格式为:{customerAddress:江苏省南京市玄武区玄武湖1号,customerName:张哈哈,mobNum:1865166xxxx} |
virtualNumMark | String | Y是,N否 | 虚拟号标识 |
encryptInfo | String | ||
encryptCustomerName | String | ABCDE | 加密的收货人名称 |
encryptDetailAddress | String | ABCDE | 加密的详细地址 |
encryptMobilePhone | String | ABCDE | 加密的手机号码 |
<sn_responseContent> <sn_body> <orderGet> <zipCode>210001</zipCode> <phoneNum>025-66996699</phoneNum> <itemCounts>2</itemCounts> <bank>南京市白下区淮海路68号苏宁电器大厦18F</bank> <orderTime>2018-01-01 01:01:01</orderTime> <payType>礼品卡支付方式</payType> <invoiceRecipientPhone>02584418888</invoiceRecipientPhone> <invoiceType>增值税</invoiceType> <invoiceRecipientHandPhone>18651662963</invoiceRecipientHandPhone> <customerAddress>上海上海市黄浦区太平路18号</customerAddress> <mobNum>18611111111</mobNum> <customerName>张三三</customerName> <invoiceRecipientAddress>南京市白下区淮海路68号苏宁电器大厦18F</invoiceRecipientAddress> <invoiceRecipientName>张涛</invoiceRecipientName> <isCanModifyTransportFee>N</isCanModifyTransportFee> <registerAddress>南京市白下区淮海路68号苏宁电器大厦18F</registerAddress> <customerAddressOld>江苏南京市鼓楼区徐庄软件园</customerAddressOld> <invoiceHead>张三三</invoiceHead> <sellerOrdRemark>顾客要求延迟发货</sellerOrdRemark> <provinceName>江苏省</provinceName> <countMoney>111.00</countMoney> <deliveryArea>210001</deliveryArea> <districtCode>00000001</districtCode> <registerPhone>02584418888</registerPhone> <cityCode>000001000267</cityCode> <needinvoiceflag>Y</needinvoiceflag> <orderTotalStatus>10</orderTotalStatus> <sumDonationAmt>66.99</sumDonationAmt> <virtualNumMark>Y是,N否</virtualNumMark> <isUpdateAddress>Y或者N</isUpdateAddress> <sid>BBDF4B492FA1878D7A73C25F5EE4DA22D425C50DDD181E50CE3D8234C4B27DD8A65CB...</sid> <encryptInfo> <encryptCustomerName>ABCDE</encryptCustomerName> <encryptMobilePhone>ABCDE</encryptMobilePhone> <encryptDetailAddress>ABCDE</encryptDetailAddress> </encryptInfo> <cityName>南京市</cityName> <orderSaleTime>2013-11-26 09:24:58</orderSaleTime> <memNo>1111111</memNo> <colorMarkFlags>0</colorMarkFlags> <districtName>玄武区</districtName> <guideAccountNo>msopo2o@1.com</guideAccountNo> <provinceCode>020</provinceCode> <payTotalAmount>110.00</payTotalAmount> <evaluationMark>0</evaluationMark> <userName>huiyuan2013_sit009@163.com</userName> <vatTaxpayerNumber>WERTDTG1234567</vatTaxpayerNumber> <detailAddress>玄武大道1号苏宁总部</detailAddress> <orderCode>1000831522</orderCode> <orderDetail> <carShopAddr>南京市白下区淮宁电器大厦18F</carShopAddr> <orderServiceTypeMulti>01,02,03,04,05</orderServiceTypeMulti> <otoOrderType>01-一口价电子凭证 02-特权定金 03-分阶段订单 04-线下现场拿货 05-线下快递上门 06-自营配件服务行(汽车配件服务行的到家场景) 07-门店代收服务行(汽车配件服务行的到店场景) 08-汽车服务行(指的是单独售卖服务行)</otoOrderType> <itemCode>B1001</itemCode> <carShopCode>1001</carShopCode> <prmtcode>01</prmtcode> <productName>销售组汤锅02</productName> <activityTypes> <activityTypeCode>1</activityTypeCode> </activityTypes> <donationProjectInfo> <donationAmt>99.99</donationAmt> <donationProjectId>1001</donationProjectId> </donationProjectInfo> <mode>02</mode> <asomOrderItemid>1111111111</asomOrderItemid> <orderPayCode>24</orderPayCode> <rentperiod>1</rentperiod> <returnFlag>1</returnFlag> <payAmount>299.00</payAmount> <carShopName>南京市鼓楼区服务站</carShopName> <dealPhoto>交易快照</dealPhoto> <isProsupplierDelivery>1</isProsupplierDelivery> <applyno>P000001000176</applyno> <declareItemPrice>20.00</declareItemPrice> <renttype>01</renttype> <itemComfirmReceiveGoodstime>2021-06-15 00:00:01</itemComfirmReceiveGoodstime> <orderTagList>01,02,03</orderTagList> <deliveryDeadlineTime>2020-11-03 00:00:53</deliveryDeadlineTime> <unitPrice>188.00</unitPrice> <hwgFlag>01</hwgFlag> <reservestatus>M</reservestatus> <payTypes> <payTypeCode>1</payTypeCode> </payTypes> <itemTaxFare>10.00</itemTaxFare> <needSerialNumber>1</needSerialNumber> <expressno>EMS1001</expressno> <outCode>200111111111</outCode> <otoStoreCode>139123456</otoStoreCode> <payerIdNumber>342111198811212222</payerIdNumber> <orderchannel>MOBILE</orderchannel> <saleNum>1.00</saleNum> <version>12C01XGC2021A00272</version> <outItemCode>20011111111101</outItemCode> <couponList> <coupontype>8012</coupontype> <sharelimit>20.00</sharelimit> </couponList> <fpsdeliveryflag>0</fpsdeliveryflag> <lastestOperateTime>2020-11-30 00:00:00</lastestOperateTime> <sendType>2</sendType> <reservebalanceamount>100.00</reservebalanceamount> <expandAmount>100.00</expandAmount> <invCode>D01</invCode> <refVerifyCode>123654789</refVerifyCode> <vouchertotalMoney>0.00</vouchertotalMoney> <selfDeliveryName>张三</selfDeliveryName> <drugsReviewResult>Y</drugsReviewResult> <deliveryTime>2018-01-01 01:01:01</deliveryTime> <transportFee>0.00</transportFee> <phoneIdentifyCode>102003303202</phoneIdentifyCode> <saleType>XH-TOB订单;FXH-TOC订单</saleType> <depositmoney>1.00</depositmoney> <otoStoreName>海青O2O门店</otoStoreName> <returnOrderFlag>1</returnOrderFlag> <carShopSerWay>1</carShopSerWay> <payorderid>P00000000100001785834</payorderid> <orderChannels> <orderChannelCode>1</orderChannelCode> </orderChannels> <storeNameB>小店加盟店</storeNameB> <declareItemTaxfare>2.00</declareItemTaxfare> <distributorName>分销商名称</distributorName> <referencePrice>299</referencePrice> <isAppointDelivery>Y</isAppointDelivery> <actSettlementPrice>12</actSettlementPrice> <packageorderid>00000000100001785834</packageorderid> <carService> <otoCommdtyCode>102609449</otoCommdtyCode> <otoCommdtyName>销售组汤锅00</otoCommdtyName> </carService> <carShopTel>02558761110</carShopTel> <complainFlag>0</complainFlag> <selfDeliveryMobile>13111111111</selfDeliveryMobile> <orderLineStatus>20</orderLineStatus> <bLineNumber>90004000001</bLineNumber> <logisticsOrderId>E0187429485171112</logisticsOrderId> <declareGoodsAmount>30.00</declareGoodsAmount> <payerCustomerName>张三</payerCustomerName> <activitytype>02</activitytype> <expresscompanycode>E01</expresscompanycode> <paymentList> <paycode>4148</paycode> <platformPercent>平台: 50.00%</platformPercent> <bankTypeName>店铺优惠券</bankTypeName> <banktypecode>10006</banktypecode> <alipayPayNo>2019010722001416950514272890</alipayPayNo> <merchantPercent>商家: 50.00%</merchantPercent> <offLinePayFlag>1</offLinePayFlag> <payName>易付宝优惠券支付</payName> <payamount>10.00</payamount> </paymentList> <disType>01</disType> <orderPaymentDetails> <allocatedAmount>299</allocatedAmount> <voucherId>202104120015798000</voucherId> </orderPaymentDetails> <storeCodeB>59021</storeCodeB> <productCode>102609881</productCode> <receiveFlag>1</receiveFlag> <serviceItemFlag>1</serviceItemFlag> <receivezipCode>211806</receivezipCode> <reservedepositamount>100.00</reservedepositamount> <orderLineNumber>1000231255</orderLineNumber> <popContractInfo> <cardAddress>江苏省南京市秦淮区苜蓿园大街64号</cardAddress> <facePhoto>xxxxx.jpg</facePhoto> <installName>李四</installName> <installPhoneNum>13813911111</installPhoneNum> <phoneNum>13813911138</phoneNum> <remark>尽快到</remark> <returnFeeRule>每月返上月1半费用</returnFeeRule> <selectedNum>11111111111</selectedNum> <contractDealType>01</contractDealType> <cardNum>320103199909210236</cardNum> <setMealName>包月20G流量</setMealName> <nativeFlow>20G</nativeFlow> <carrieroperator>中国移动</carrieroperator> <monthlyFee>30.00</monthlyFee> <frontPhoto>xxxxx.jpg</frontPhoto> <speechTime>100</speechTime> <installAddress>江苏省南京市秦淮区苜蓿园大街64号5楼</installAddress> <contractPeriod>12月</contractPeriod> <countrywideFlow>20G</countrywideFlow> <backPhoto>xxxxx.jpg</backPhoto> <feeDetails>每月30,第二月返15</feeDetails> <messageAmt>100</messageAmt> <name>张三</name> <monthlyFeeContent>首月20</monthlyFeeContent> <monthlyFeeName>首月20</monthlyFeeName> </popContractInfo> <coupontotalMoney>0.00</coupontotalMoney> </orderDetail> <confirmGoodsTime>2020-11-30 00:00:00</confirmGoodsTime> <invoice>发票内容</invoice> <buyerOrdRemark>尽快发货哦</buyerOrdRemark> <account>6YUIOP3456789009876</account> </orderGet> </sn_body> </sn_responseContent>
{ "sn_responseContent": { "sn_body": { "orderGet": { "zipCode": "210001", "phoneNum": "025-66996699", "itemCounts": "2", "bank": "南京市白下区淮海路68号苏宁电器大厦18F", "orderTime": "2018-01-01 01:01:01", "payType": "礼品卡支付方式", "invoiceRecipientPhone": "02584418888", "invoiceType": "增值税", "invoiceRecipientHandPhone": "18651662963", "customerAddress": "上海上海市黄浦区太平路18号", "mobNum": "18611111111", "customerName": "张三三", "invoiceRecipientAddress": "南京市白下区淮海路68号苏宁电器大厦18F", "invoiceRecipientName": "张涛", "isCanModifyTransportFee": "N", "registerAddress": "南京市白下区淮海路68号苏宁电器大厦18F", "customerAddressOld": "江苏南京市鼓楼区徐庄软件园", "invoiceHead": "张三三", "sellerOrdRemark": "顾客要求延迟发货", "provinceName": "江苏省", "countMoney": "111.00", "deliveryArea": "210001", "districtCode": "00000001", "registerPhone": "02584418888", "cityCode": "000001000267", "needinvoiceflag": "Y", "orderTotalStatus": "10", "sumDonationAmt": "66.99", "virtualNumMark": "Y是,N否", "isUpdateAddress": "Y或者N", "sid": "BBDF4B492FA1878D7A73C25F5EE4DA22D425C50DDD181E50CE3D8234C4B27DD8A65CB...", "encryptInfo": { "encryptCustomerName": "ABCDE", "encryptMobilePhone": "ABCDE", "encryptDetailAddress": "ABCDE" }, "cityName": "南京市", "orderSaleTime": "2013-11-26 09:24:58", "memNo": "1111111", "colorMarkFlags": "0", "districtName": "玄武区", "guideAccountNo": "msopo2o@1.com", "provinceCode": "020", "payTotalAmount": "110.00", "evaluationMark": "0", "userName": "huiyuan2013_sit009@163.com", "vatTaxpayerNumber": "WERTDTG1234567", "detailAddress": "玄武大道1号苏宁总部", "orderCode": "1000831522", "orderDetail": [ { "carShopAddr": "南京市白下区淮宁电器大厦18F", "orderServiceTypeMulti": "01,02,03,04,05", "otoOrderType": "01-一口价电子凭证 02-特权定金 03-分阶段订单 04-线下现场拿货 05-线下快递上门 06-自营配件服务行(汽车配件服务行的到家场景) 07-门店代收服务行(汽车配件服务行的到店场景) 08-汽车服务行(指的是单独售卖服务行)", "itemCode": "B1001", "carShopCode": "1001", "prmtcode": "01", "productName": "销售组汤锅02", "activityTypes": [ { "activityTypeCode": "1" } ], "donationProjectInfo": [ { "donationAmt": "99.99", "donationProjectId": "1001" } ], "mode": "02", "asomOrderItemid": "1111111111", "orderPayCode": "24", "rentperiod": "1", "returnFlag": "1", "payAmount": "299.00", "carShopName": "南京市鼓楼区服务站", "dealPhoto": "交易快照", "isProsupplierDelivery": "1", "applyno": "P000001000176", "declareItemPrice": "20.00", "renttype": "01", "itemComfirmReceiveGoodstime": "2021-06-15 00:00:01", "orderTagList": "01,02,03", "deliveryDeadlineTime": "2020-11-03 00:00:53", "unitPrice": "188.00", "hwgFlag": "01", "reservestatus": "M", "payTypes": [ { "payTypeCode": "1" } ], "itemTaxFare": "10.00", "needSerialNumber": "1", "expressno": "EMS1001", "outCode": "200111111111", "otoStoreCode": "139123456", "payerIdNumber": "342111198811212222", "orderchannel": "MOBILE", "saleNum": "1.00", "version": "12C01XGC2021A00272", "outItemCode": "20011111111101", "couponList": [ { "coupontype": "8012", "sharelimit": "20.00" } ], "fpsdeliveryflag": "0", "lastestOperateTime": "2020-11-30 00:00:00", "sendType": "2", "reservebalanceamount": "100.00", "expandAmount": "100.00", "invCode": "D01", "refVerifyCode": "123654789", "vouchertotalMoney": "0.00", "selfDeliveryName": "张三", "drugsReviewResult": "Y", "deliveryTime": "2018-01-01 01:01:01", "transportFee": "0.00", "phoneIdentifyCode": "102003303202", "saleType": "XH-TOB订单;FXH-TOC订单", "depositmoney": "1.00", "otoStoreName": "海青O2O门店", "returnOrderFlag": "1", "carShopSerWay": "1", "payorderid": "P00000000100001785834", "orderChannels": [ { "orderChannelCode": "1" } ], "storeNameB": "小店加盟店", "declareItemTaxfare": "2.00", "distributorName": "分销商名称", "referencePrice": "299", "isAppointDelivery": "Y", "actSettlementPrice": "12", "packageorderid": "00000000100001785834", "carService": [ { "otoCommdtyCode": "102609449", "otoCommdtyName": "销售组汤锅00" } ], "carShopTel": "02558761110", "complainFlag": "0", "selfDeliveryMobile": "13111111111", "orderLineStatus": "20", "bLineNumber": "90004000001", "logisticsOrderId": "E0187429485171112", "declareGoodsAmount": "30.00", "payerCustomerName": "张三", "activitytype": "02", "expresscompanycode": "E01", "paymentList": [ { "paycode": "4148", "platformPercent": "平台: 50.00%", "bankTypeName": "店铺优惠券", "banktypecode": "10006", "alipayPayNo": "2019010722001416950514272890", "merchantPercent": "商家: 50.00%", "offLinePayFlag": "1", "payName": "易付宝优惠券支付", "payamount": "10.00" } ], "disType": "01", "orderPaymentDetails": [ { "allocatedAmount": "299", "voucherId": "202104120015798000" } ], "storeCodeB": "59021", "productCode": "102609881", "receiveFlag": "1", "serviceItemFlag": "1", "receivezipCode": "211806", "reservedepositamount": "100.00", "orderLineNumber": "1000231255", "popContractInfo": [ { "cardAddress": "江苏省南京市秦淮区苜蓿园大街64号", "facePhoto": "xxxxx.jpg", "installName": "李四", "installPhoneNum": "13813911111", "phoneNum": "13813911138", "remark": "尽快到", "returnFeeRule": "每月返上月1半费用", "selectedNum": "11111111111", "contractDealType": "01", "cardNum": "320103199909210236", "setMealName": "包月20G流量", "nativeFlow": "20G", "carrieroperator": "中国移动", "monthlyFee": "30.00", "frontPhoto": "xxxxx.jpg", "speechTime": "100", "installAddress": "江苏省南京市秦淮区苜蓿园大街64号5楼", "contractPeriod": "12月", "countrywideFlow": "20G", "backPhoto": "xxxxx.jpg", "feeDetails": "每月30,第二月返15", "messageAmt": "100", "name": "张三", "monthlyFeeContent": "首月20", "monthlyFeeName": "首月20" } ], "coupontotalMoney": "0.00" } ], "confirmGoodsTime": "2020-11-30 00:00:00", "invoice": "发票内容", "buyerOrdRemark": "尽快发货哦", "account": "6YUIOP3456789009876" } } } }
异常码 | 错误描述 | 解决方案 |
---|---|---|
biz.custom.getorder.missing-parameter:* | 参数必填 | 请检查此参数的值,*号表示参数字段名 |
biz.handler.data-get:no-result | 查询没结果 | 请检查查询参数 |
isp.sys.service.unavailable.moms | 服务不可用 | 请联系苏宁技术人员 |
biz.custom.getorder.invalid-biz:100 | B2C订单号格式非法 | B2C订单号为空或长度超过30位 |
异常码 | 错误描述 | 解决方案 |
---|---|---|
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:一个订单可能包含多种商品,一种商品对应一个订单行项目。
Q:什么是订单总状态?
A:若订单存在多个订单行项目,则订单总状态为订单行项目状态的集合,有10待发货、20已发货、21部分发货、30交易成功、40交易关闭五种状态。
Q:什么是订单行项目状态?
A:订单行项目状态指订单明细状态,10表示待发货、20表示已发货、30表示交易成功、40表示交易关闭四种状态。
Q:订单中获取的城市代码如何查看对应的城市名称?
A:当前苏宁订单接口仅实现获取到城市代码,通过接口“suning.custom.city.query”查看对应的城市名称 。
Q:如何查看订单中商品的商家商品编码?
A:当前苏宁订单接口仅实现获取到苏宁商品编码,通过接口“suning.custom.item.get”查看对应的商家商品编码。