API接口目录

自营业务

退厂API
厂送API
厂送退换货API
品牌串码API
采购订单API
供应商收发货API
售后服务API
供应商财务API
主数据API
自营合同API
自营商品API
自营财务API
采购计划API
收发货API
订单API
易道报表API
不良品API
自营促销API
异常码自查工具
suning.selfmarket.saleorder.get 单笔获取销售订单
¥免费

通过此接口可单笔获取销售订单

公共参数
请求参数
名称 类型 是否必须 示例值 描述
orderItemIdStringY00000208117601订单行号
supplierCodeStringY10001373供应商编码
响应参数
名称 类型 示例值 描述
activityTypesString
activityNameString闪拍活动类型名称
activityTypeString08活动类型(01: 满减 02:赠品 03:返券 04:渠道专享订单 05:免费试用订单 06:付邮试用订单 07:预定订单 08:秒杀订单 09:S码活动订单 10:大聚惠订单 11:名品特卖订单 12:闪拍订单 13:纸质球票订单 14:电子球票订单 20:预售 21:大聚惠-促销价 22:套餐)
applicantString01发起方:01-商户;02-平台
addressString南京市江宁区经济开发平安路8号顾客送货地址。市、县/区、镇/街道、详细地址
cityNameString南京市收件人地址(市)中文
couponTotalMoneyString20.00优惠券总金额
customerNameString张三顾客姓名
detailAddressString苏宁大道1号详细地址
distChannelString50分销渠道
districtNameString雨花台区收件人地址(区)中文
hopeArrivalTimeString20130101090325交货时间
invoiceConentString食品、日用品、办公用品发票内容
invoiceHeadString江苏苏宁易购电子商务有限公司发票抬头
invoiceTypeString01-增值税发票 02-普通发票发票类型
memberOrgNameString江苏苏宁软件技术有限公司会员单位名称
mobilePhoneString13957582227移动电话
needInvoiceFlagStringY/N是否需要发票
orderIdString111111B2C订单号
orderItemIdString00000208117601订单行号
payAmountString20.00应付金额
payItemsString
bankTypeCodeString9031银行种类编码
bankTypeNameString储值卡(券)银行种类名称
parentPayCodeString50支付方式上级编码
payAmountString20.00支付方式分摊金额
payCodeString5002支付方式编码
alipayPayNoString00120485973301外部支付流水号
payIdString00120485973301支付单号
applicantString01发起方:01-商户;02-平台
platformStringA平台来源。苏宁:A ,天猫:B, 抖音:C, 拼多多:D ,快手:E, 淘特:F ,视频号:G ,百度小店:BD, 小红书:H,
posIdString11111POS单号
priceString50.20销售价。最后交易价
prmtBillTotalAmtString25.00优惠单总金额
productCodeString101030069商品编码
productNameString保健品王商品名称
provinceNameString江苏省收件人地址(省)中文
remarkString顾客的销售订单备注订单备注
remarkcolorflagString1:红色,2:黄色,3:绿色,4:蓝色,5:紫色;商家备注旗帜
saleOrgString5016销售组织
saleQtyString20销售数量
saleTimeString2013-11-29 23:06:10订单销售日期时间。年月日小时分钟
shipConditionString01装运条件
statusString20订单状态。订单待发货10、订单不能满足20、订单延迟发货30、厂家已发货40、厂家确认顾客已收货45、顾客已收货50、单证已寄票60、顾客已收票70
supplierCmmdtyCodeString123123123商家商品编码
supplierCodeString10001373供应商编码
supplierremarkString轻拿轻放商家备注内容
taxIfSendStringY/N发票是否需要邮寄
taxPayerAddressString北京市顺义区全境顺鑫朗郡小区北京市顺义区杨镇顺鑫朗郡小区4号楼1单元402室增值税发票收件人地址
taxPayerMobileNumString18551601553增值税发票收件人手机
taxPayerNameString张小书增值税发票收件人姓名
taxPayerPhoneNumString043262731056增值税发票收件人电话
telephoneString13957582227电话
totalAmountString2400.00行项目销售额
transportFeeString5.00运费
zipCodeString210000邮政编码
townNameString鼓楼街道镇街道
wareCodeStringZ01供应商填写的仓库编码
returnorderflagString1退货标识 0:非退货; 1:退货
returnStatusString80退货状态
exchangeGoodsFlagString1换货标识:无换货(0),换货中(1),换货完成(2)
expressInfosString
deliverytypeString1发货方式
expressnoString00101316800801物流单号
expressCompanyCodeStringD01快递公司编码
expresscompanyNameString德邦快递公司名称
deliAmountString1发货数量, 仅在多运单下有效, 非多运单取saleqty.
activeTimeString2022-01-07生效时间
disableTimeString2022-01-17失效时间
isGiftString0是否赠品标识 1--是0--否
receiptDateString2018-01-01 10:00:00确认收货时间
isShowPriceString1是否展示价格,0-不展示,1-展示
distributorNameStringxxx分销商名称
factoryIWDFlagString1苏宁仓配:1-是 0-否
pickDateString2020-11-18 12:00:00承诺发货日期
purchasePriceString12采购价
isOtherDeliveryString1其他商家发货标识0否1是
sidStringBBDF4B492FA1878D7A73C25F5EE4DA22D425C50DDD181E50CE3D8234C4B27DD8A65CB...address+customerName+detailAddress+telephone加密字段,解密后格式为:{address:南京市江宁区经济开发平安路8号,customerName:张哈哈,detailAddress:江苏省南京市玄武区玄武湖1号,telephone:66996699}
userNameString123123@163.com买家帐号
serialNumFlagString1是否需要回传序列号 1是
serialNumString969670000000000序列号
hwgPackageOrderIdString4863317887330092865合并订单号
hwgPayOrderIdString18741998合并支付单号
hwgPayerNameString张三支付人姓名
hwgPayerDocumentTypeString01支付人证件类型,默认01
hwgPayerDocumentNumberString110110200001010002支付人证件号码
hwgDistTypeString03发货方式,01直邮 02商家自有保税区 03苏宁保税区
hwgCustomsModeString01通关模式:01保税仓 02海外直邮 03个人申报 04邮关
hwgRtotalAmountString82.78行成交总价
hwgRpayAmountString88.0行支付金额
hwgRpayTaxAmountString1行支付税款
hwgRfreightString2行支付运费
hwgRcouponTotalMoneyString3行优惠金额
hwgCountryCodeString中国产销国
hwgStatusString1事件状态:抖音海外购事件当前状态,同步成功后状态更新,同步失败不更新
virtualNumMarkStringY是,N否虚拟号标识
referencePriceString1供应商维护的销售价
cscPriceString1直降、大聚惠的购物车结算价格
voucherListString
voucherIdString1优惠单号
allocatedAmountString1分摊金额
hwgDeclareFlagString未申报,申报成功申报状态
hwgMergePayNoString111111合并支付单号(申报后)
hwgOrderTotalAmountString1合单维度:订单总金额
hwgTotalCountString1合单维度:总件数
hwgPayAmountString1合单维度:支付金额
hwgPayTaxAmountString1合单维度:支付税款
hwgFreightString1合单维度:支付运费
hwgCouponTotalMoneyString1合单维度:优惠金额
oldChangeNewFlagString10-以旧换新家电两步式订单且旧机已回收完成,1代表以旧换新家电两步式订单且旧机未回收完成。为空表示非以旧换新家电两步式订单
outCodeString200111111111外部订单号
outItemCodeString20011111111101外部订单行号
请求示例
  • XML示例
  • JSON示例
复制全部代码
                                
<sn_request>
  <sn_body>
    <getSaleOrder>
      <orderItemId>00000208117601</orderItemId>
      <supplierCode>10001373</supplierCode>
    </getSaleOrder>
  </sn_body>
</sn_request>

			
                                
                                
{
  "sn_request": {
    "sn_body": {
      "getSaleOrder": {
        "orderItemId": "00000208117601",
        "supplierCode": "10001373"
      }
    }
  }
}
			
                                
响应示例
  • XML示例
  • JSON示例
复制全部代码
                              
<sn_responseContent>
  <sn_body>
    <getSaleOrder>
      <zipCode>210000</zipCode>
      <distChannel>50</distChannel>
      <hwgPayerDocumentNumber>110110200001010002</hwgPayerDocumentNumber>
      <orderId>111111</orderId>
      <voucherList>
        <allocatedAmount>1</allocatedAmount>
        <voucherId>1</voucherId>
      </voucherList>
      <hwgStatus>1</hwgStatus>
      <returnStatus>80</returnStatus>
      <hwgCouponTotalMoney>1</hwgCouponTotalMoney>
      <pickDate>2020-11-18 12:00:00</pickDate>
      <hwgRtotalAmount>82.78</hwgRtotalAmount>
      <factoryIWDFlag>1</factoryIWDFlag>
      <purchasePrice>12</purchasePrice>
      <payItems>
        <payAmount>20.00</payAmount>
        <bankTypeCode>9031</bankTypeCode>
        <bankTypeName>储值卡(券)</bankTypeName>
        <alipayPayNo>00120485973301</alipayPayNo>
        <payId>00120485973301</payId>
        <payCode>5002</payCode>
        <parentPayCode>50</parentPayCode>
        <applicant>01</applicant>
      </payItems>
      <productName>保健品王</productName>
      <saleOrg>5016</saleOrg>
      <hwgTotalCount>1</hwgTotalCount>
      <activityTypes>
        <activityName>闪拍</activityName>
        <activityType>08</activityType>
        <applicant>01</applicant>
      </activityTypes>
      <hwgFreight>1</hwgFreight>
      <hwgCountryCode>中国</hwgCountryCode>
      <payAmount>20.00</payAmount>
      <price>50.20</price>
      <invoiceType>01-增值税发票 02-普通发票</invoiceType>
      <hopeArrivalTime>20130101090325</hopeArrivalTime>
      <hwgPayerDocumentType>01</hwgPayerDocumentType>
      <cscPrice>1</cscPrice>
      <memberOrgName>江苏苏宁软件技术有限公司</memberOrgName>
      <taxPayerMobileNum>18551601553</taxPayerMobileNum>
      <supplierCmmdtyCode>123123123</supplierCmmdtyCode>
      <townName>鼓楼街道</townName>
      <exchangeGoodsFlag>1</exchangeGoodsFlag>
      <needInvoiceFlag>Y/N</needInvoiceFlag>
      <serialNum>969670000000000</serialNum>
      <outCode>200111111111</outCode>
      <activeTime>2022-01-07</activeTime>
      <receiptDate>2018-01-01 10:00:00</receiptDate>
      <telephone>13957582227</telephone>
      <wareCode>Z01</wareCode>
      <customerName>张三</customerName>
      <prmtBillTotalAmt>25.00</prmtBillTotalAmt>
      <shipCondition>01</shipCondition>
      <outItemCode>20011111111101</outItemCode>
      <totalAmount>2400.00</totalAmount>
      <supplierremark>轻拿轻放</supplierremark>
      <invoiceHead>江苏苏宁易购电子商务有限公司</invoiceHead>
      <isShowPrice>1</isShowPrice>
      <mobilePhone>13957582227</mobilePhone>
      <hwgMergePayNo>111111</hwgMergePayNo>
      <serialNumFlag>1</serialNumFlag>
      <provinceName>江苏省</provinceName>
      <remarkcolorflag>1:红色,2:黄色,3:绿色,4:蓝色,5:紫色;</remarkcolorflag>
      <hwgDeclareFlag>未申报,申报成功</hwgDeclareFlag>
      <status>20</status>
      <invoiceConent>食品、日用品、办公用品</invoiceConent>
      <isOtherDelivery>1</isOtherDelivery>
      <hwgDistType>03</hwgDistType>
      <transportFee>5.00</transportFee>
      <taxIfSend>Y/N</taxIfSend>
      <remark>顾客的销售订单备注</remark>
      <taxPayerName>张小书</taxPayerName>
      <hwgRpayAmount>88.0</hwgRpayAmount>
      <supplierCode>10001373</supplierCode>
      <virtualNumMark>Y是,N否</virtualNumMark>
      <platform>A</platform>
      <taxPayerPhoneNum>043262731056</taxPayerPhoneNum>
      <sid>BBDF4B492FA1878D7A73C25F5EE4DA22D425C50DDD181E50CE3D8234C4B27DD8A65CB...</sid>
      <hwgRfreight>2</hwgRfreight>
      <distributorName>xxx</distributorName>
      <posId>11111</posId>
      <saleTime>2013-11-29 23:06:10</saleTime>
      <referencePrice>1</referencePrice>
      <cityName>南京市</cityName>
      <hwgPayTaxAmount>1</hwgPayTaxAmount>
      <returnorderflag>1</returnorderflag>
      <isGift>0</isGift>
      <oldChangeNewFlag>1</oldChangeNewFlag>
      <address>南京市江宁区经济开发平安路8号</address>
      <districtName>雨花台区</districtName>
      <hwgPayAmount>1</hwgPayAmount>
      <orderItemId>00000208117601</orderItemId>
      <hwgOrderTotalAmount>1</hwgOrderTotalAmount>
      <hwgRcouponTotalMoney>3</hwgRcouponTotalMoney>
      <expressInfos>
        <expressno>00101316800801</expressno>
        <expresscompanyName>德邦</expresscompanyName>
        <expressCompanyCode>D01</expressCompanyCode>
        <deliAmount>1</deliAmount>
        <deliverytype>1</deliverytype>
      </expressInfos>
      <hwgRpayTaxAmount>1</hwgRpayTaxAmount>
      <userName>123123@163.com</userName>
      <couponTotalMoney>20.00</couponTotalMoney>
      <taxPayerAddress>北京市顺义区全境顺鑫朗郡小区北京市顺义区杨镇顺鑫朗郡小区4号楼1单元402室</taxPayerAddress>
      <productCode>101030069</productCode>
      <hwgPackageOrderId>4863317887330092865</hwgPackageOrderId>
      <hwgCustomsMode>01</hwgCustomsMode>
      <detailAddress>苏宁大道1号</detailAddress>
      <hwgPayerName>张三</hwgPayerName>
      <saleQty>20</saleQty>
      <hwgPayOrderId>18741998</hwgPayOrderId>
      <disableTime>2022-01-17</disableTime>
    </getSaleOrder>
  </sn_body>
</sn_responseContent>

			
                              
                              
{
  "sn_responseContent": {
    "sn_body": {
      "getSaleOrder": [
        {
          "zipCode": "210000",
          "distChannel": "50",
          "hwgPayerDocumentNumber": "110110200001010002",
          "orderId": "111111",
          "voucherList": [
            {
              "allocatedAmount": "1",
              "voucherId": "1"
            }
          ],
          "hwgStatus": "1",
          "returnStatus": "80",
          "hwgCouponTotalMoney": "1",
          "pickDate": "2020-11-18 12:00:00",
          "hwgRtotalAmount": "82.78",
          "factoryIWDFlag": "1",
          "purchasePrice": "12",
          "payItems": [
            {
              "payAmount": "20.00",
              "bankTypeCode": "9031",
              "bankTypeName": "储值卡(券)",
              "alipayPayNo": "00120485973301",
              "payId": "00120485973301",
              "payCode": "5002",
              "parentPayCode": "50",
              "applicant": "01"
            }
          ],
          "productName": "保健品王",
          "saleOrg": "5016",
          "hwgTotalCount": "1",
          "activityTypes": [
            {
              "activityName": "闪拍",
              "activityType": "08",
              "applicant": "01"
            }
          ],
          "hwgFreight": "1",
          "hwgCountryCode": "中国",
          "payAmount": "20.00",
          "price": "50.20",
          "invoiceType": "01-增值税发票 02-普通发票",
          "hopeArrivalTime": "20130101090325",
          "hwgPayerDocumentType": "01",
          "cscPrice": "1",
          "memberOrgName": "江苏苏宁软件技术有限公司",
          "taxPayerMobileNum": "18551601553",
          "supplierCmmdtyCode": "123123123",
          "townName": "鼓楼街道",
          "exchangeGoodsFlag": "1",
          "needInvoiceFlag": "Y/N",
          "serialNum": "969670000000000",
          "outCode": "200111111111",
          "activeTime": "2022-01-07",
          "receiptDate": "2018-01-01 10:00:00",
          "telephone": "13957582227",
          "wareCode": "Z01",
          "customerName": "张三",
          "prmtBillTotalAmt": "25.00",
          "shipCondition": "01",
          "outItemCode": "20011111111101",
          "totalAmount": "2400.00",
          "supplierremark": "轻拿轻放",
          "invoiceHead": "江苏苏宁易购电子商务有限公司",
          "isShowPrice": "1",
          "mobilePhone": "13957582227",
          "hwgMergePayNo": "111111",
          "serialNumFlag": "1",
          "provinceName": "江苏省",
          "remarkcolorflag": "1:红色,2:黄色,3:绿色,4:蓝色,5:紫色;",
          "hwgDeclareFlag": "未申报,申报成功",
          "status": "20",
          "invoiceConent": "食品、日用品、办公用品",
          "isOtherDelivery": "1",
          "hwgDistType": "03",
          "transportFee": "5.00",
          "taxIfSend": "Y/N",
          "remark": "顾客的销售订单备注",
          "taxPayerName": "张小书",
          "hwgRpayAmount": "88.0",
          "supplierCode": "10001373",
          "virtualNumMark": "Y是,N否",
          "platform": "A",
          "taxPayerPhoneNum": "043262731056",
          "sid": "BBDF4B492FA1878D7A73C25F5EE4DA22D425C50DDD181E50CE3D8234C4B27DD8A65CB...",
          "hwgRfreight": "2",
          "distributorName": "xxx",
          "posId": "11111",
          "saleTime": "2013-11-29 23:06:10",
          "referencePrice": "1",
          "cityName": "南京市",
          "hwgPayTaxAmount": "1",
          "returnorderflag": "1",
          "isGift": "0",
          "oldChangeNewFlag": "1",
          "address": "南京市江宁区经济开发平安路8号",
          "districtName": "雨花台区",
          "hwgPayAmount": "1",
          "orderItemId": "00000208117601",
          "hwgOrderTotalAmount": "1",
          "hwgRcouponTotalMoney": "3",
          "expressInfos": [
            {
              "expressno": "00101316800801",
              "expresscompanyName": "德邦",
              "expressCompanyCode": "D01",
              "deliAmount": "1",
              "deliverytype": "1"
            }
          ],
          "hwgRpayTaxAmount": "1",
          "userName": "123123@163.com",
          "couponTotalMoney": "20.00",
          "taxPayerAddress": "北京市顺义区全境顺鑫朗郡小区北京市顺义区杨镇顺鑫朗郡小区4号楼1单元402室",
          "productCode": "101030069",
          "hwgPackageOrderId": "4863317887330092865",
          "hwgCustomsMode": "01",
          "detailAddress": "苏宁大道1号",
          "hwgPayerName": "张三",
          "saleQty": "20",
          "hwgPayOrderId": "18741998",
          "disableTime": "2022-01-17"
        }
      ]
    }
  }
}
			
                              
异常示例
  • XML示例
  • JSON示例
复制全部代码

  
  	API异常码
  	异常码中文描述
  

                           	  
{
  "sn_responseContent": {
    "sn_error": {
      "error_code": "API异常码",
      "error_msg": "异常码中文描述"
    }
  }
}
                           		
业务异常码
异常码 错误描述 解决方案
biz.selfmarket.getsaleorder.missing-parameter:* 参数必填 请检查此参数的值,*号表示参数字段名
biz.handler.data-get:no-result 查询没结果 请检查查询参数
isp.sys.service.unavailable.somp 服务不可用 请联系苏宁技术人员
biz.selfmarket.getsaleorder.invalid-biz:100 供应商编码不合法 请输入供应商编码
biz.selfmarket.getsaleorder.invalid-biz:101 OMS订单行号不能为空 请输入OMS订单行号
biz.selfmarket.getsaleorder.invalid-biz:102 OMS订单行号不合法 请输入14位数字
公共异常码
API工具
FAQ

Q:单笔获取销售订单接口如何使用?

A:通过此接口可单笔获取销售订单