API接口目录

自营业务

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

当前系统日期前一天苏宁门店的样机商品信息,例如序列号、商品编码、实际库龄合同情况、出样情况等信息。

公共参数
请求参数
名称 类型 是否必须 示例值 描述
pageNoStringN1页码
pageSizeStringN10每页条数
vendorCdStringY10001369供应商编码
statisDateStringY2020-01-01统计日期,格式:yyyy-MM-dd
gdsCdStringN600575273苏宁商品编码
vendorGdsStringNWD90M4473JX/SC供应商商品编码
响应参数
名称 类型 示例值 描述
statisDateString20200101统计日期
vendorCdString10001369供应商编码
vendorNmString(冰洗)三星(中国)投资有限公司北京分公司供应商名称
areaCdString10018苏宁大区编码
areaNmString北京苏宁大区名称
cmpnyCdString1100苏宁公司编码
cmpnyNmString北京苏宁云商销售有限公司苏宁公司名称
placeCdStringD269苏宁地点编码
placeNmString苏宁北京昌平物流库苏宁地点名称
strCdString7161苏宁实货地点编码
strNmString北京顺义店苏宁实货地点名称
depotCdString0001苏宁库位编码
depotNmString常规机库苏宁库位名称
vendorGdsStringWD90M4473JX/SC供应商商品编码
gdsCdString600575273苏宁商品编码
gdsNmString三星洗衣机WD90M4473JX/SC(XQG90-90M4473JX)苏宁商品名称
fourGroupCdStringR0401005苏宁四级商品组编码
fourGroupDescString洗干一体机苏宁四级商品组名称
thirdGroupCdStringR0401005苏宁三级商品组编码
thirdGroupDescString洗干一体机苏宁三级商品组名称
secGroupCdStringR0401005苏宁二级商品组编码
secGroupDescString洗干一体机苏宁二级商品组名称
firstGroupCdStringR0401005苏宁一级商品组编码
firstGroupDescString洗干一体机苏宁一级商品组名称
brandCdString1659苏宁品牌编码
brandNmString三星(SAMSUNG)苏宁品牌名称
deptCdString00006品类编码
deptNmString冰洗品类名称
serialNumStringC043QC003E序列号
dayNumString73实际库龄
statusString非限制样机状态
isSNProtoString是否苏宁出样
qtyString1出样数量
bodyCodeString1机身码
amntString100样机金额
请求示例
  • XML示例
  • JSON示例
复制全部代码
                                <sn_request>
  <sn_body>
    <queryEdaosample>
      <vendorCd>10001369</vendorCd>
      <pageNo>1</pageNo>
      <pageSize>10</pageSize>
      <statisDate>2020-01-01</statisDate>
      <vendorGds>WD90M4473JX/SC</vendorGds>
      <gdsCd>600575273</gdsCd>
    </queryEdaosample>
  </sn_body>
</sn_request>

                                
                                {
  "sn_request": {
    "sn_body": {
      "queryEdaosample": {
        "vendorCd": "10001369",
        "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>
    <queryEdaosample>
      <placeCd>D269</placeCd>
      <fourGroupCd>R0401005</fourGroupCd>
      <vendorCd>10001369</vendorCd>
      <statisDate>20200101</statisDate>
      <vendorGds>WD90M4473JX/SC</vendorGds>
      <deptNm>冰洗</deptNm>
      <gdsNm>三星洗衣机WD90M4473JX/SC(XQG90-90M4473JX)</gdsNm>
      <fourGroupDesc>洗干一体机</fourGroupDesc>
      <depotCd>0001</depotCd>
      <brandNm>三星(SAMSUNG)</brandNm>
      <areaNm>北京</areaNm>
      <cmpnyNm>北京苏宁云商销售有限公司</cmpnyNm>
      <strNm>北京顺义店</strNm>
      <bodyCode>1</bodyCode>
      <amnt>100</amnt>
      <firstGroupDesc>洗干一体机</firstGroupDesc>
      <serialNum>C043QC003E</serialNum>
      <secGroupCd>R0401005</secGroupCd>
      <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>
      <isSNProto>否</isSNProto>
      <qty>1</qty>
      <strCd>7161</strCd>
      <dayNum>73</dayNum>
      <brandCd>1659</brandCd>
      <status>非限制</status>
    </queryEdaosample>
  </sn_body>
</sn_responseContent>

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

  
  	API异常码
  	异常码中文描述
  

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