API接口目录

自营业务

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

根据供应商编码查询采购订单信息,供应商编码必输,支持单个供应商

公共参数
请求参数
名称 类型 是否必须 示例值 描述
pageNoStringN1页码
pageSizeStringN10每页条数
endDateStringN2017-11-10 11:01:00订单创建结束日期。查询交易创建结束时间。格式:yyyy-MM-dd 或 yyyy-MM-dd hh:mm:ss。时间范围为近30天内
orderCodeStringN4500075418采购订单编码
orderStatusStringN10采购订单的状态。10-待确认及已确认订单 ,50-取消。该字段不输入的话默认获取所有状态的订单。
orderTypeStringNNB订单类型。采购订单类型。NB:标准采购订单,ZNB1:特价机采购订单,ZNB2:包销定制机采购订单,ZNB3:样机采购订单,ZNB4:工程机采购订单,ZNB5:赠品机采购订单,ZZO:行政用外部采购订单,ZCS1:材料采购订单,ZCS2:配件采购订单,ZCS3:零星采购订单,ZCS5:售后低值易耗品采购订单,ZCSS:配件,材料采购订单,ZZR:工程物资采购订单,ZCSR:材料,配件退货订单
startDateStringN2014-04-01 10:00:00订单创建开始日期。查询交易创建开始时间。格式:yyyy-MM-dd或yyyy-MM-dd hh:mm:ss
supplierCodeStringY10170001单个供应商编码
响应参数
名称 类型 示例值 描述
orderHeadString
coCodeString5006苏宁公司代码。
orderCodeString4500075418采购订单号
orderCreateDateString2014-04-12订单创建日期
orderStatusString10采购订单的状态。10-待确认订单, 30-已确认、40-(待确认+确认+部分收货) 、41-(待确认+部分收货)、42-(确认+部分收货)、50-取消
orderTypeStringNB订单类型。采购订单类型
prePurchaseNoString12000012预采购订单号
purchaseCodeStringprs采购订单号prs采购订单号
supplierCodeString70057356商户编码
planAutomaticPoStringY计划转采
rebateFlagStringY付款类型:Y-返利;A-授信;B-退换货;C-预付;D-账期
createBusinessTypeString149订单业务类型
orderDetailString
currencyUnitStringCNY货币单位
oadocCodeStringCJJ201612190872640合同框架号
deliveryDateString2014-04-28订单有效期。采购订单行项目的最晚交货日期
discountRateString0.17折扣率。
eanString6945213504706 EAN码。商品的EAN码
itemNoString10采购订单行号
itemStatusString10订单行状态
orderQtyString50订单数量。采购的商品数量
snString1212121212 序列号。样机的序列号,样机采购订单专用
snProductCodeString120009121苏宁商品编码
storeCodeStringDE11 地址。苏宁门店库,送货地址以此为准
subTotalString500.50合计金额。行项目的合计金额
supplierConfirmStringX 确认标识。null :不需要确认 X:需要确认
supplierProductCodeString124521供应商商品编码
unitString 计量单位。
unitPriceString40.50含税单价。精确到小数点
purchaseItemCodeString1或10prs采购订单行号
productNameString空调商品名称
plantNameString南京中心仓地址名称
secondCateNameString卫浴电器二级类目名称
pkgUnitNameString采购单位
orderBoxQtyString2订货箱数
boxRuleInfoString12瓶/箱箱规信息
externalEanCodeStringEN1000075418商品条形码
coreProductLabelStringXX:表示核心单品
advOrderFlagString1:预付款订单 ;空:非预付款订单预付款标识
bindFlagString绑定状态:0未绑定 1已绑定0
请求示例
  • XML示例
  • JSON示例
复制全部代码
                                <sn_request>
  <sn_body>
    <purchaseOrder>
      <orderType>NB</orderType>
      <endDate>2017-11-10 11:01:00</endDate>
      <pageNo>1</pageNo>
      <orderStatus>10</orderStatus>
      <pageSize>10</pageSize>
      <orderCode>4500075418</orderCode>
      <supplierCode>10170001</supplierCode>
      <startDate>2014-04-01 10:00:00</startDate>
    </purchaseOrder>
  </sn_body>
</sn_request>

                                
                                {
  "sn_request": {
    "sn_body": {
      "purchaseOrder": {
        "orderType": "NB",
        "endDate": "2017-11-10 11:01:00",
        "pageNo": "1",
        "orderStatus": "10",
        "pageSize": "10",
        "orderCode": "4500075418",
        "supplierCode": "10170001",
        "startDate": "2014-04-01 10:00:00"
      }
    }
  }
}
                                
响应示例
  • 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>
    <purchaseOrder>
      <orderDetail>
        <discountRate>0.17</discountRate>
        <secondCateName>卫浴电器</secondCateName>
        <externalEanCode>EN1000075418</externalEanCode>
        <itemNo>10</itemNo>
        <snProductCode>120009121</snProductCode>
        <subTotal>500.50</subTotal>
        <productName>空调</productName>
        <ean>6945213504706</ean>
        <itemStatus>10</itemStatus>
        <supplierConfirm>X</supplierConfirm>
        <oadocCode>CJJ201612190872640</oadocCode>
        <orderQty>50</orderQty>
        <purchaseItemCode>1或10</purchaseItemCode>
        <sn>1212121212</sn>
        <deliveryDate>2014-04-28</deliveryDate>
        <currencyUnit>CNY</currencyUnit>
        <unitPrice>40.50</unitPrice>
        <bindFlag>绑定状态:0未绑定 1已绑定</bindFlag>
        <unit>件</unit>
        <advOrderFlag>1:预付款订单 ;空:非预付款订单</advOrderFlag>
        <orderBoxQty>2</orderBoxQty>
        <coreProductLabel>X</coreProductLabel>
        <pkgUnitName>箱</pkgUnitName>
        <supplierProductCode>124521</supplierProductCode>
        <boxRuleInfo>12瓶/箱</boxRuleInfo>
        <plantName>南京中心仓</plantName>
        <storeCode>DE11</storeCode>
      </orderDetail>
      <orderHead>
        <orderType>NB</orderType>
        <orderCreateDate>2014-04-12</orderCreateDate>
        <purchaseCode>prs采购订单号</purchaseCode>
        <planAutomaticPo>Y</planAutomaticPo>
        <prePurchaseNo>12000012</prePurchaseNo>
        <createBusinessType>149</createBusinessType>
        <coCode>5006</coCode>
        <orderStatus>10</orderStatus>
        <rebateFlag>Y</rebateFlag>
        <orderCode>4500075418</orderCode>
        <supplierCode>70057356</supplierCode>
      </orderHead>
    </purchaseOrder>
  </sn_body>
</sn_responseContent>

                              
                              {
  "sn_responseContent": {
    "sn_head": {
      "totalSize": "1",
      "pageTotal": "1",
      "pageNo": "1",
      "returnMessage": "biz.handler.data-get:success"
    },
    "sn_body": {
      "purchaseOrder": [
        {
          "orderDetail": [
            {
              "discountRate": "0.17",
              "secondCateName": "卫浴电器",
              "externalEanCode": "EN1000075418",
              "itemNo": "10",
              "snProductCode": "120009121",
              "subTotal": "500.50",
              "productName": "空调",
              "ean": "6945213504706",
              "itemStatus": "10",
              "supplierConfirm": "X",
              "oadocCode": "CJJ201612190872640",
              "orderQty": "50",
              "purchaseItemCode": "1或10",
              "sn": "1212121212",
              "deliveryDate": "2014-04-28",
              "currencyUnit": "CNY",
              "unitPrice": "40.50",
              "bindFlag": "绑定状态:0未绑定 1已绑定",
              "unit": "件",
              "advOrderFlag": "1:预付款订单 ;空:非预付款订单",
              "orderBoxQty": "2",
              "coreProductLabel": "X",
              "pkgUnitName": "箱",
              "supplierProductCode": "124521",
              "boxRuleInfo": "12瓶/箱",
              "plantName": "南京中心仓",
              "storeCode": "DE11"
            }
          ],
          "orderHead": {
            "orderType": "NB",
            "orderCreateDate": "2014-04-12",
            "purchaseCode": "prs采购订单号",
            "planAutomaticPo": "Y",
            "prePurchaseNo": "12000012",
            "createBusinessType": "149",
            "coCode": "5006",
            "orderStatus": "10",
            "rebateFlag": "Y",
            "orderCode": "4500075418",
            "supplierCode": "70057356"
          }
        }
      ]
    }
  }
}
                              
异常示例
  • XML示例
  • JSON示例
复制全部代码

  
  	API异常码
  	异常码中文描述
  

                           	  
{
  "sn_responseContent": {
    "sn_error": {
      "error_code": "API异常码",
      "error_msg": "异常码中文描述"
    }
  }
}
                           		
业务异常码
异常码 错误描述 解决方案
biz.selfmarket.querypurchaseordersupplier.missing-parameter:* 参数必填 请检查此参数的值,*号表示参数字段名
biz.handler.data-get:no-result 查询没结果 请检查查询参数
isp.sys.service.unavailable.scpc 服务不可用 请联系苏宁技术人员
biz.selfmarket.querypurchaseordersupplier.invalid-biz:100 日期跨度超过限制(30天) 请输入正确参数
biz.selfmarket.querypurchaseordersupplier.invalid-biz:101 日期传输有误,开始日期和截止日期只传了一个或开始日期大于等于截止日期 请输入正确参数
biz.selfmarket.querypurchaseordersupplier.invalid-biz:102 订单状态无效。请检查传输的订单状态字段,目前只接收10、20、40、50几种状态。 请输入正确参数
biz.selfmarket.querypurchaseordersupplier.invalid-biz:103 商家编码非法(供应商编码不能为空且长度不能超过8位,多个编码以英文逗号分隔,不能超过10个) 请输入正确参数
biz.selfmarket.querypurchaseordersupplier.invalid-biz:104 开始时间格式不正确 请输入正确参数
biz.selfmarket.querypurchaseordersupplier.invalid-biz:105 结束时间格式不正确 请输入正确参数
公共异常码
API工具
FAQ