退出
热词搜索：
API接口目录

自营业务

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

按日统计销售赠品行订单，各店仓、各渠道需发放的赠品数量

公共参数
请求参数
名称 类型 是否必须 示例值 描述
pageNoStringN1页码
pageSizeStringN10每页条数
vendorCdStringY10001369供应商编码
statisStartDateStringY2020-01-01查询开始日期 格式：yyyy-MM-dd
statisEndDateStringY2020-01-01查询结束日期 格式：yyyy-MM-dd
gdsCdStringN600575273苏宁商品编码
vendorGdsStringNWD90M4473JX/SC供应商商品编码
响应参数
名称 类型 示例值 描述
statisDateString20200101销售日期
vendorCdString10001369供应商编码
vendorNmString(冰洗)三星(中国)投资有限公司北京分公司供应商名称
areaCdString10018销售大区编码
areaNmString北京销售大区名称
cmpnyCdString1100销售公司编码
cmpnyNmString北京苏宁云商销售有限公司销售公司名称
strCdString7161销售门店编码
strNmString北京顺义店销售门店名称
strTypeString常规店门店类型
placeCdStringD269发货地点编码
placeNmString苏宁北京昌平物流库发货地点名称
depotCdString0001发货库位编码
depotNmString常规机库发货库位名称
vendorGdsStringWD90M4473JX/SC供应商商品编码
gdsCdString600575273苏宁商品编码
gdsNmString三星洗衣机WD90M4473JX/SC(XQG90-90M4473JX)苏宁商品名称
fourGroupCdStringR0401005苏宁四级商品组编码
fourGroupDescString洗干一体机苏宁四级商品组名称
thirdGroupCdStringR0401005苏宁三级商品组编码
thirdGroupDescString洗干一体机苏宁三级商品组名称
secGroupCdStringR0401005苏宁二级商品组编码
secGroupDescString洗干一体机苏宁二级商品组名称
firstGroupCdStringR0401005苏宁一级商品组编码
firstGroupDescString洗干一体机苏宁一级商品组名称
brandCdString1659苏宁品牌编码
brandNmString三星(SAMSUNG)苏宁品牌名称
deptCdString00006品类编码
deptNmString冰洗品类名称
rfdNumString1退货件数
revAmntString1000退货金额
payNumString1成交件数
fwdAmntString1000成交金额
totalNumString1销售数量
saleAmntString1000销售金额
chnlCdString线上销售渠道：线上、线下
orderSourceString零售云业务渠道：零售云、B2B等
请求示例
  • XML示例
  • JSON示例
复制全部代码 
                                <sn_request>
  <sn_body>
    <queryEdaogiftsale>
      <vendorCd>10001369</vendorCd>
      <pageNo>1</pageNo>
      <pageSize>10</pageSize>
      <vendorGds>WD90M4473JX/SC</vendorGds>
      <statisEndDate>2020-01-01</statisEndDate>
      <gdsCd>600575273</gdsCd>
      <statisStartDate>2020-01-01</statisStartDate>
    </queryEdaogiftsale>
  </sn_body>
</sn_request>

                                
                                {
  "sn_request": {
    "sn_body": {
      "queryEdaogiftsale": {
        "vendorCd": "10001369",
        "pageNo": "1",
        "pageSize": "10",
        "vendorGds": "WD90M4473JX/SC",
        "statisEndDate": "2020-01-01",
        "gdsCd": "600575273",
        "statisStartDate": "2020-01-01"
      }
    }
  }
}
响应示例
  • XML示例
  • JSON示例
复制全部代码 
                              <sn_responseContent>
  <sn_head>
    <totalSize>1</totalSize>
    <pageTotal>1</pageTotal>
    <pageNo>1</pageNo>
    <returnMessage>biz.handler.data-get:success</returnMessage>
  </sn_head>
  <sn_body>
    <queryEdaogiftsale>
      <placeCd>D269</placeCd>
      <fourGroupCd>R0401005</fourGroupCd>
      <vendorCd>10001369</vendorCd>
      <saleAmnt>1000</saleAmnt>
      <strType>常规店</strType>
      <revAmnt>1000</revAmnt>
      <statisDate>20200101</statisDate>
      <vendorGds>WD90M4473JX/SC</vendorGds>
      <deptNm>冰洗</deptNm>
      <gdsNm>三星洗衣机WD90M4473JX/SC(XQG90-90M4473JX)</gdsNm>
      <fourGroupDesc>洗干一体机</fourGroupDesc>
      <depotCd>0001</depotCd>
      <brandNm>三星(SAMSUNG)</brandNm>
      <payNum>1</payNum>
      <areaNm>北京</areaNm>
      <cmpnyNm>北京苏宁云商销售有限公司</cmpnyNm>
      <strNm>北京顺义店</strNm>
      <firstGroupDesc>洗干一体机</firstGroupDesc>
      <orderSource>零售云</orderSource>
      <rfdNum>1</rfdNum>
      <secGroupCd>R0401005</secGroupCd>
      <fwdAmnt>1000</fwdAmnt>
      <secGroupDesc>洗干一体机</secGroupDesc>
      <placeNm>苏宁北京昌平物流库</placeNm>
      <gdsCd>600575273</gdsCd>
      <thirdGroupDesc>洗干一体机</thirdGroupDesc>
      <vendorNm>(冰洗)三星(中国)投资有限公司北京分公司</vendorNm>
      <deptCd>00006</deptCd>
      <thirdGroupCd>R0401005</thirdGroupCd>
      <depotNm>常规机库</depotNm>
      <areaCd>10018</areaCd>
      <cmpnyCd>1100</cmpnyCd>
      <firstGroupCd>R0401005</firstGroupCd>
      <totalNum>1</totalNum>
      <chnlCd>线上</chnlCd>
      <strCd>7161</strCd>
      <brandCd>1659</brandCd>
    </queryEdaogiftsale>
  </sn_body>
</sn_responseContent>

                              
                              {
  "sn_responseContent": {
    "sn_head": {
      "totalSize": "1",
      "pageTotal": "1",
      "pageNo": "1",
      "returnMessage": "biz.handler.data-get:success"
    },
    "sn_body": {
      "queryEdaogiftsale": [
        {
          "placeCd": "D269",
          "fourGroupCd": "R0401005",
          "vendorCd": "10001369",
          "saleAmnt": "1000",
          "strType": "常规店",
          "revAmnt": "1000",
          "statisDate": "20200101",
          "vendorGds": "WD90M4473JX/SC",
          "deptNm": "冰洗",
          "gdsNm": "三星洗衣机WD90M4473JX/SC(XQG90-90M4473JX)",
          "fourGroupDesc": "洗干一体机",
          "depotCd": "0001",
          "brandNm": "三星(SAMSUNG)",
          "payNum": "1",
          "areaNm": "北京",
          "cmpnyNm": "北京苏宁云商销售有限公司",
          "strNm": "北京顺义店",
          "firstGroupDesc": "洗干一体机",
          "orderSource": "零售云",
          "rfdNum": "1",
          "secGroupCd": "R0401005",
          "fwdAmnt": "1000",
          "secGroupDesc": "洗干一体机",
          "placeNm": "苏宁北京昌平物流库",
          "gdsCd": "600575273",
          "thirdGroupDesc": "洗干一体机",
          "vendorNm": "(冰洗)三星(中国)投资有限公司北京分公司",
          "deptCd": "00006",
          "thirdGroupCd": "R0401005",
          "depotNm": "常规机库",
          "areaCd": "10018",
          "cmpnyCd": "1100",
          "firstGroupCd": "R0401005",
          "totalNum": "1",
          "chnlCd": "线上",
          "strCd": "7161",
          "brandCd": "1659"
        }
      ]
    }
  }
}
异常示例
  • XML示例
  • JSON示例
复制全部代码 

  
  	API异常码
  	异常码中文描述
  

                           	  
{
  "sn_responseContent": {
    "sn_error": {
      "error_code": "API异常码",
      "error_msg": "异常码中文描述"
    }
  }
}
业务异常码
异常码 错误描述 解决方案
biz.selfmarket.queryedaogiftsale.missing-parameter:* 参数必填 请检查此参数的值,*号表示参数字段名
biz.selfmarket.queryedaogiftsale.format-error:* 参数格式错误 请检查此参数的值,*号表示参数字段名
biz.selfmarket.queryedaogiftsale.length-overlong:* 参数的值超过规定长度 请检查此参数的值,*号表示参数字段名
biz.handler.data-get:no-result 查询没结果 请检查查询参数
isp.sys.service.unavailable.sdas 服务不可用 请联系苏宁技术人员
biz.handler.auth-validate:100 输入的供应商无接口访问权限 请联系数据运营团队开通接口权限
biz.handler.auth-validate:101 输入的供应商无易道访问权限 请联系数据运营团队或自行订购易道
biz.selfmarket.queryedaogiftsale.invalid-biz:114 查询日期必须在易道查询日期范围内 请输入易道订购周期内的日期
biz.selfmarket.queryedaogiftsale.invalid-biz:115 数据未按期下发 请联系数据运营团队
biz.selfmarket.queryedaogiftsale.invalid-biz:112 开始日期大于等于截止日期 请输入正确的查询日期
biz.selfmarket.queryedaogiftsale.invalid-biz:113 日期跨度超过限制(16天) 请输入正确的查询日期
biz.handler.auth-validate:103 该账号无权调用此供应商数据 请用此供应商账号登陆商家工作台设置“我的店铺-申请集团合作”，或联系数据运营团队
公共异常码
API工具
API TOOLS 在线测试工具异常码查询工具SDK调用示例SDK下载
FAQ