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

自营业务

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

按日查询苏宁各店仓已入库促销品库位的商品的库存量

公共参数
请求参数
名称 类型 是否必须 示例值 描述
pageNoStringN1页码
pageSizeStringN10每页条数
vendorCdStringY10001361供应商编码
statisDateStringY2020-01-01统计日期 格式：yyyy-MM-dd
gdsCdStringN600575273苏宁商品编码
vendorGdsStringNWD90M4473JX/SC供应商商品编码
响应参数
名称 类型 示例值 描述
statisDateString20200101统计日期
vendorCdString10001361供应商编码
vendorNmString(冰洗)三星(中国)投资有限公司北京分公司供应商名称
areaCdString10018苏宁大区编码
areaNmString北京苏宁大区名称
cmpnyCdString1100苏宁公司编码
cmpnyNmString北京苏宁云商销售有限公司苏宁公司名称
placeCdStringD269苏宁地点编码
placeNmString苏宁北京昌平物流库苏宁地点名称
depotCdString0001苏宁库位编码
depotNmString常规机库苏宁库位名称
realPlaceCdString7161苏宁实货地点编码
realPlaceNmString北京顺义店苏宁实货地点名称
realPlaceTypeString中心仓实货地点类型：中心仓、门店
catologCdString10库位类型 10-常规，11-特价，12-包销，13-工程，14-临期库
vendorGdsStringWD90M4473JX/SC供应商商品编码
gdsCdString600575273苏宁商品编码
gdsNmString三星洗衣机WD90M4473JX/SC(XQG90-90M4473JX)苏宁商品名称
fourGroupCdStringR0401005苏宁四级商品组编码
fourGroupDescString洗干一体机苏宁四级商品组名称
thirdGroupCdStringR0401005苏宁三级商品组编码
thirdGroupDescString洗干一体机苏宁三级商品组名称
secGroupCdStringR0401005苏宁二级商品组编码
secGroupDescString洗干一体机苏宁二级商品组名称
firstGroupCdStringR0401005苏宁一级商品组编码
firstGroupDescString洗干一体机苏宁一级商品组名称
brandCdString1659苏宁品牌编码
brandNmString三星(SAMSUNG)苏宁品牌名称
deptCdString00006品类编码
deptNmString冰洗品类名称
atpAQtyString10全渠道可卖数
atpQtyString10ATP可卖数
actQtyString10实货可用数
actAmntString10实货库存金额
noneGetSaleString0销售已销未提
buyInQtyString0在途采购进
buyRfdQtyString0在途采购退
adjustRecvQtyString0在途调拨收
adjustSendQtyString0在途调拨发
frozenQtyString0冻结库存
qualityCheckQtyString0质检库存
请求示例
  • XML示例
  • JSON示例
复制全部代码 
                                <sn_request>
  <sn_body>
    <queryEdaogiftstock>
      <vendorCd>10001361</vendorCd>
      <pageNo>1</pageNo>
      <pageSize>10</pageSize>
      <statisDate>2020-01-01</statisDate>
      <vendorGds>WD90M4473JX/SC</vendorGds>
      <gdsCd>600575273</gdsCd>
    </queryEdaogiftstock>
  </sn_body>
</sn_request>

                                
                                {
  "sn_request": {
    "sn_body": {
      "queryEdaogiftstock": {
        "vendorCd": "10001361",
        "pageNo": "1",
        "pageSize": "10",
        "statisDate": "2020-01-01",
        "vendorGds": "WD90M4473JX/SC",
        "gdsCd": "600575273"
      }
    }
  }
}
响应示例
  • 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>
    <queryEdaogiftstock>
      <placeCd>D269</placeCd>
      <fourGroupCd>R0401005</fourGroupCd>
      <vendorCd>10001361</vendorCd>
      <atpQty>10</atpQty>
      <actAmnt>10</actAmnt>
      <statisDate>20200101</statisDate>
      <realPlaceCd>7161</realPlaceCd>
      <vendorGds>WD90M4473JX/SC</vendorGds>
      <deptNm>冰洗</deptNm>
      <gdsNm>三星洗衣机WD90M4473JX/SC(XQG90-90M4473JX)</gdsNm>
      <fourGroupDesc>洗干一体机</fourGroupDesc>
      <depotCd>0001</depotCd>
      <brandNm>三星(SAMSUNG)</brandNm>
      <areaNm>北京</areaNm>
      <cmpnyNm>北京苏宁云商销售有限公司</cmpnyNm>
      <qualityCheckQty>0</qualityCheckQty>
      <firstGroupDesc>洗干一体机</firstGroupDesc>
      <atpAQty>10</atpAQty>
      <catologCd>10</catologCd>
      <secGroupCd>R0401005</secGroupCd>
      <realPlaceNm>北京顺义店</realPlaceNm>
      <actQty>10</actQty>
      <buyRfdQty>0</buyRfdQty>
      <secGroupDesc>洗干一体机</secGroupDesc>
      <placeNm>苏宁北京昌平物流库</placeNm>
      <gdsCd>600575273</gdsCd>
      <thirdGroupDesc>洗干一体机</thirdGroupDesc>
      <vendorNm>(冰洗)三星(中国)投资有限公司北京分公司</vendorNm>
      <deptCd>00006</deptCd>
      <adjustSendQty>0</adjustSendQty>
      <thirdGroupCd>R0401005</thirdGroupCd>
      <adjustRecvQty>0</adjustRecvQty>
      <depotNm>常规机库</depotNm>
      <realPlaceType>中心仓</realPlaceType>
      <areaCd>10018</areaCd>
      <buyInQty>0</buyInQty>
      <cmpnyCd>1100</cmpnyCd>
      <firstGroupCd>R0401005</firstGroupCd>
      <frozenQty>0</frozenQty>
      <noneGetSale>0</noneGetSale>
      <brandCd>1659</brandCd>
    </queryEdaogiftstock>
  </sn_body>
</sn_responseContent>

                              
                              {
  "sn_responseContent": {
    "sn_head": {
      "totalSize": "1",
      "pageTotal": "1",
      "pageNo": "1",
      "returnMessage": "biz.handler.data-get:success"
    },
    "sn_body": {
      "queryEdaogiftstock": [
        {
          "placeCd": "D269",
          "fourGroupCd": "R0401005",
          "vendorCd": "10001361",
          "atpQty": "10",
          "actAmnt": "10",
          "statisDate": "20200101",
          "realPlaceCd": "7161",
          "vendorGds": "WD90M4473JX/SC",
          "deptNm": "冰洗",
          "gdsNm": "三星洗衣机WD90M4473JX/SC(XQG90-90M4473JX)",
          "fourGroupDesc": "洗干一体机",
          "depotCd": "0001",
          "brandNm": "三星(SAMSUNG)",
          "areaNm": "北京",
          "cmpnyNm": "北京苏宁云商销售有限公司",
          "qualityCheckQty": "0",
          "firstGroupDesc": "洗干一体机",
          "atpAQty": "10",
          "catologCd": "10",
          "secGroupCd": "R0401005",
          "realPlaceNm": "北京顺义店",
          "actQty": "10",
          "buyRfdQty": "0",
          "secGroupDesc": "洗干一体机",
          "placeNm": "苏宁北京昌平物流库",
          "gdsCd": "600575273",
          "thirdGroupDesc": "洗干一体机",
          "vendorNm": "(冰洗)三星(中国)投资有限公司北京分公司",
          "deptCd": "00006",
          "adjustSendQty": "0",
          "thirdGroupCd": "R0401005",
          "adjustRecvQty": "0",
          "depotNm": "常规机库",
          "realPlaceType": "中心仓",
          "areaCd": "10018",
          "buyInQty": "0",
          "cmpnyCd": "1100",
          "firstGroupCd": "R0401005",
          "frozenQty": "0",
          "noneGetSale": "0",
          "brandCd": "1659"
        }
      ]
    }
  }
}
异常示例
  • XML示例
  • JSON示例
复制全部代码 

  
  	API异常码
  	异常码中文描述
  

                           	  
{
  "sn_responseContent": {
    "sn_error": {
      "error_code": "API异常码",
      "error_msg": "异常码中文描述"
    }
  }
}
业务异常码
异常码 错误描述 解决方案
biz.selfmarket.queryedaogiftstock.missing-parameter:* 参数必填 请检查此参数的值,*号表示参数字段名
biz.selfmarket.queryedaogiftstock.format-error:* 参数格式错误 请检查此参数的值,*号表示参数字段名
biz.selfmarket.queryedaogiftstock.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.queryedaogiftstock.invalid-biz:112 查询日期必须在易道查询日期范围内 请输入易道订购周期内的日期
biz.selfmarket.queryedaogiftstock.invalid-biz:113 数据未按期下发 请联系数据运营团队
biz.handler.auth-validate:103 该账号无权调用此供应商数据 请用此供应商账号登陆商家工作台设置“我的店铺-申请集团合作”，或联系数据运营团队
公共异常码
API工具
API TOOLS 在线测试工具异常码查询工具SDK调用示例SDK下载
FAQ