API接口目录

平台业务

商品API
价格API
库存API
销售准备API
交易API
退货退款API(新)
财务API
店铺API
物流API
促销API
分销API
发票API
招商API
换货API
互动营销API
退货退款API
客服API
平台营销API
风控API
会员通API
账房API
财务记账API
异常码自查工具
suning.custom.order.get 单笔订单查询
¥免费

通过此接口可进行单笔订单的查询。
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需要单独开票结算)

公共参数
请求参数
名称 类型 是否必须 示例值 描述
orderCodeStringY4511680451B2C订单号
historyOrderFlagStringN1查询历史标识 1:查询历史数据
响应参数
名称 类型 示例值 描述
accountString6YUIOP3456789009876开户账号
bankString南京市白下区淮海路68号苏宁电器大厦18F开户行
buyerOrdRemarkString尽快发货哦订单备注(买家)--买家对订单的备注信息
cityCodeString000001000267城市代码
cityNameString南京市收件人地址(市)中文
customerAddressString上海上海市黄浦区太平路18号详细地址
customerNameString张三三顾客姓名
districtCodeString00000001区域代码
districtNameString玄武区收件人地址(区)中文
evaluationMarkString0评价状态。0=未评价;1=已评价
invoiceString发票内容发票内容
invoiceHeadString张三三发票抬头
invoiceRecipientAddressString南京市白下区淮海路68号苏宁电器大厦18F发票收件人地址
invoiceRecipientHandPhoneString18651662963发票收件人手机
invoiceRecipientNameString张涛发票收件人姓名
invoiceRecipientPhoneString02584418888发票收件人电话
invoiceTypeString增值税发票类型 -- 增值还是普通(01增值 02普通 04 电子发票)
isCanModifyTransportFeeStringN是否能够修改运费
mobNumString18611111111买家联系电话
needinvoiceflagStringY是否需要发票(Y:需要,N:不需要)
orderCodeString1000831522订单号
orderDetailString
activitytypeString02活动类型(02:渠道专享订单,03:免费试用订单,04:付邮试用订单,05,06:预定订单,07:秒杀订单,08:S码活动订单,09:赠品)
activityTypesString
activityTypeCodeString1活动类型(1:闪拍,2:免费试用,3:付邮试用,4:渠道专享,5:预定,6:秒杀,7:S码,8:大聚会,9:赠品)
bLineNumberString90004000001b2c行项目号
carShopAddrString南京市白下区淮宁电器大厦18F汽车服务门店地址
carShopCodeString1001汽车服务门店编码
carShopNameString南京市鼓楼区服务站汽车服务门店名称
carShopSerWayString1汽车服务方式(1-上门服务,2-到店服务)
carShopTelString02558761110汽车服务门店电话
couponListString
coupontypeString8012券类型。券类型表示返券返积分的类型:5998-店铺优惠券、6998-联合0元购券、7998-0元购券、8012-积分抵现、9994-优惠券、9995-优惠券。
sharelimitString20.00销售单据分摊金额。订单返券返积分总金额需每个行项目的销售单据分摊额度累计。
coupontotalMoneyString0.00优惠劵金额
declareGoodsAmountString30.00申报订单行货款
declareItemPriceString20.00申报单价
declareItemTaxfareString2.00申报税费
disTypeString01发货方式。01 代表海外直邮发货;02代表商家保税区发货;03代表苏宁保税区发货;空代表国内海外购
expresscompanycodeStringE01物流公司编码
expressnoStringEMS1001运单号
fpsdeliveryflagString04PS发货标示,1代表4PS发货、0代表C店发货
hwgFlagString01海外购标识。01表示海外购订单,其他值为非海外购订单
invCodeStringD01仓库编码
isProsupplierDeliveryString1是否供应商发货标识,1代表是
itemCodeStringB1001商家商品编码
itemTaxFareString10.00税费
modeString02通关模式(01:保税备货,02:海外直邮,03:个人申报,04:邮关)
orderchannelStringMOBILE订单渠道。PC,手机MOBILE,WAP, 电话PHONE
orderChannelsString
orderChannelCodeString1订单渠道(1:网盟,2:手机订单,3:门店订单:)
orderLineNumberString1000231255订单行项目号
orderLineStatusString20订单行项目状态。0:订单取消;5:等待支付;10=待发货;15:发货中;20=已发货;30=交易成功
packageorderidString00000000100001785834包裹号
payAmountString299.00付款金额。订单行项目金额
payerCustomerNameString张三支付人姓名
payerIdNumberString342111198811212222支付人身份证号码
paymentListString
banktypecodeString10006订单使用券/积分类型
offLinePayFlagString1线下支付:1;非线下支付:空值
payamountString10.00支付方式分摊金额。订单使用劵和积分总金额需每个行项目的支付方式分摊金额累计。
paycodeString4148付款方式。4148-易付宝支付、5002-礼品卡支付、9003-门店付款、6901-券或云钻支付、6903-易付宝优惠券支付、2037-光大MIS银行卡(新)、1001-现金 (CASH)、2044-建行MIS银行卡(新)、6906-赠品支付、4237-支付宝支付、4245-微信支付、6915-铜板支付。(字段值为6901时,跟banktypecode[支付方式编码]字段关联)
alipayPayNoString2019010722001416950514272890支付流水号
merchantPercentString商家: 50.00%商家的承担比例(券的承担比例,只跟券相关)
platformPercentString平台: 50.00%平台的承担比例(券的承担比例,只跟券相关)
bankTypeNameString店铺优惠券订单使用券/积分名称
payNameString易付宝优惠券支付付款方式说明
payorderidStringP00000000100001785834支付单号
payTypesString
payTypeCodeString1支付方式(1:云钻-加钱购,2:云钻-全额兑,3:礼品卡,4:门店付款,5:货到付款,6:在线支付,7:支付宝)
phoneIdentifyCodeString102003303202手机串码
prmtcodeString01推广方式。取值为01时,表示网盟
productCodeString102609881苏宁商品编码
productNameString销售组汤锅02商品中文名称
receivezipCodeString211806收货人邮政编码
reservebalanceamountString100.00预定尾款金额
reservedepositamountString100.00预定定金金额
reservestatusStringM预定状态(M:定金已支付,P:定金已罚没,R:定金已退还)
returnOrderFlagString1退货订单标示位 0或空值表示正常订单, 1表示退货订单
saleNumString1.00数量
transportFeeString0.00运费。订单行项目对应的运费
unitPriceString188.00商品单价
vouchertotalMoneyString0.00优惠单金额
serviceItemFlagString10非服务行 ,1服务行
otoStoreCodeString139123456O2O门店编码
otoStoreNameString海青O2O门店O2O门店编码
otoOrderTypeString01-一口价电子凭证 02-特权定金 03-分阶段订单 04-线下现场拿货 05-线下快递上门 06-自营配件服务行(汽车配件服务行的到家场景) 07-门店代收服务行(汽车配件服务行的到店场景) 08-汽车服务行(指的是单独售卖服务行)O2O订单类型
expandAmountString100.00膨胀金额
refVerifyCodeString123654789特权定金验证码
orderServiceTypeMultiString01,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:淘宝订单
popContractInfoString
contractDealTypeString01合约业务类型:01-号卡选号;02-号卡不选号;03-宽带安装;04-合约机裸机;05-合约机老用户合约机;06-合约机新用户选号;07-合约机新用户不选号
selectedNumString11111111111购买时,选中的手机号
carrieroperatorString中国移动运营商
setMealNameString包月20G流量套餐名称
monthlyFeeString30.00套餐的月费,单位元,保留两位小数
contractPeriodString12月合约期
countrywideFlowString20G全国流量
nativeFlowString20G本地流量
speechTimeString100语音
messageAmtString100短信
returnFeeRuleString每月返上月1半费用返费规则
feeDetailsString每月30,第二月返15资费详细
monthlyFeeNameString首月20首月资费名称
monthlyFeeContentString首月20首月资费内容
nameString张三姓名
phoneNumString13813911138联系方式
cardNumString320103199909210236身份证号码
cardAddressString江苏省南京市秦淮区苜蓿园大街64号证件地址
installNameString李四安装联系人姓名
installPhoneNumString13813911111安装联系电话(手机、座机如有都给)
installAddressString江苏省南京市秦淮区苜蓿园大街64号5楼安装省市区镇+详细地址
remarkString尽快到备注
frontPhotoStringxxxxx.jpg正面照片
backPhotoStringxxxxx.jpg反面照片
facePhotoStringxxxxx.jpg人像照片
deliveryTimeString2018-01-01 01:01:01发货时间
sendTypeString2物流发货方式:0:在线下单 1:自己联系物流 2:无需物流 3:没有合作的物流公司(其他物流) 4:电子面单发货
selfDeliveryNameString张三送货人姓名(无需物流)
selfDeliveryMobileString13111111111送货人联系电话号码(无需物流)
returnFlagString1退款标志:1:退款中 2:退货成功 3:退款成功
complainFlagString0投诉标识 0:未投诉,1:已投诉
logisticsOrderIdStringE0187429485171112物流订单编号
carServiceString
otoCommdtyCodeString102609449服务对应实体商品编码
otoCommdtyNameString销售组汤锅00服务对应实体商品名称
orderTagListString01,02,03订单标签列表,多个逗号分隔 01苏宁益品
dealPhotoString交易快照http://sphss.suning.com/productspan/show.html?key=hyIkNcVTOOaTrSvDUAjLJJ3Ka19kNQGuw1bSyz4IT%2FOaq1PmY019faqywMBiMShL
depositmoneyString1.00押金
orderPayCodeString24子支付方式:23-花呗支付;24-花呗分期支付
donationProjectInfoString
donationProjectIdString1001公益项目编码
donationAmtString99.99公益捐赠金额
rentperiodString1租期
renttypeString01租期类型
distributorNameString分销商名称分销商名称
deliveryDeadlineTimeString2020-11-03 00:00:53承诺发货截止时间
lastestOperateTimeString2020-11-30 00:00:00状态操作时间
saleTypeStringXH-TOB订单;FXH-TOC订单销售类型
storeNameBString小店加盟店(零售云业务)小B商户店铺名称
applynoStringP000001000176意向单申请号
versionString12C01XGC2021A00272海尔工程版号
orderPaymentDetailsString
voucherIdString202104120015798000优惠活动编码:指类似满减活动之类的编码
allocatedAmountString299满减等优惠活动对应的商品抵扣金额
referencePriceString299参考价(指参加促销活动的商品,在提交订单时的非活动原价)
itemComfirmReceiveGoodstimeString2021-06-15 00:00:01行确认收货时间
receiveFlagString1针对家电两步式订单,receiveFlag 1代表旧机已回收完成,其他枚举值代表旧机未回收完成。
drugsReviewResultStringY处方药审核结果,Y:通过,N:拒绝,没有值:未审核
needSerialNumberString1是否回传序列号标识:0否,1 SN码 2 IMEI码
isAppointDeliveryStringY是否预约发货 Y是,N否
actSettlementPriceString12活动结算价.该字段积分商城订单才有值,非积分商城订单无值
storeCodeBString59021小B店铺编码
asomOrderItemidString1111111111服务类型订单对应的服务单号
outCodeString200111111111外部订单号
outItemCodeString20011111111101外部订单行号
orderSaleTimeString2013-11-26 09:24:58订单支付时间,格式:yyyy-MM-dd HH:mm:ss
orderTotalStatusString10订单总状态,0 订单取消;5 未付款;10 买家已付款;15 发货中;20 已发货;21 部分发货;30 交易成功;40 交易关闭
payTotalAmountString110.00支付金额,支付方式的支付金额
payTypeString礼品卡支付方式支付方式,如礼品卡支付
provinceCodeString020省份代码。
provinceNameString江苏省收件人地址(省)中文
registerAddressString南京市白下区淮海路68号苏宁电器大厦18F注册地址
registerPhoneString02584418888注册电话
sellerOrdRemarkString顾客要求延迟发货订单备注(卖家)--商家对订单的备注信息
userNameStringhuiyuan2013_sit009@163.com买家帐号
vatTaxpayerNumberStringWERTDTG1234567纳税人识别号
guideAccountNoStringmsopo2o@1.com下单导购帐号
orderTimeString2018-01-01 01:01:01订单提交时间
zipCodeString210001收件人邮编
colorMarkFlagsString0卖家备注旗帜:0表示灰色, 1表示红色, 2表示黄色, 3表示绿色, 4表示蓝色, 5表示紫色
phoneNumString025-66996699收件人固定电话
detailAddressString玄武大道1号苏宁总部详细地址(街道)
deliveryAreaString210001运输区域编码
countMoneyString111.00订单行“支付金额”总和
sumDonationAmtString66.99苏宁益品捐赠总金额
memNoString1111111会员编码
itemCountsString2订单行数量
confirmGoodsTimeString2020-11-30 00:00:00顾客确认收货时间
customerAddressOldString江苏南京市鼓楼区徐庄软件园地址信息申请修改:修改前收货地址
isUpdateAddressStringY或者N是否有修改收货人信息
sidStringBBDF4B492FA1878D7A73C25F5EE4DA22D425C50DDD181E50CE3D8234C4B27DD8A65CB...customerAddress+customerName+mobNum加密字段,解密后格式为:{customerAddress:江苏省南京市玄武区玄武湖1号,customerName:张哈哈,mobNum:1865166xxxx}
virtualNumMarkStringY是,N否虚拟号标识
encryptInfoString
encryptCustomerNameStringABCDE加密的收货人名称
encryptDetailAddressStringABCDE加密的详细地址
encryptMobilePhoneStringABCDE加密的手机号码
请求示例
  • XML示例
  • JSON示例
复制全部代码
                                
<sn_request>
  <sn_body>
    <orderGet>
      <orderCode>4511680451</orderCode>
      <historyOrderFlag>1</historyOrderFlag>
    </orderGet>
  </sn_body>
</sn_request>

			
                                
                                
{
  "sn_request": {
    "sn_body": {
      "orderGet": {
        "orderCode": "4511680451",
        "historyOrderFlag": "1"
      }
    }
  }
}
			
                                
响应示例
  • XML示例
  • JSON示例
复制全部代码
                              
<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"
      }
    }
  }
}
			
                              
异常示例
  • XML示例
  • JSON示例
复制全部代码

  
  	API异常码
  	异常码中文描述
  

                           	  
{
  "sn_responseContent": {
    "sn_error": {
      "error_code": "API异常码",
      "error_msg": "异常码中文描述"
    }
  }
}
                           		
业务异常码
异常码 错误描述 解决方案
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位
公共异常码
API工具
FAQ

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”查看对应的商家商品编码。