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

自营业务

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

根据条件查询采购订单信息

公共参数
请求参数
名称 类型 是否必须 示例值 描述
endDateStringN2014-04-14 订单创建结束日期。查询交易创建结束时间。格式：yyyy-MM-dd。时间范围为近30天内
orderCodeStringN4500075418采购订单编码
orderStatusStringN10订单状态。采购订单的状态。10-新订单，20-已阅，40-修改待阅 ，50-取消。该字段不输入的话默认获取10、40、50状态的订单。
orderTypeStringNNB 订单类型。采购订单类型。NB：标准采购订单，ZNB1：特价机采购订单，ZNB2：包销定制机采购订单，ZNB3：样机采购订单，ZNB4：工程机采购订单，ZNB5：赠品机采购订单，ZZO：行政用外部采购订单，ZCS1：材料采购订单，ZCS2：配件采购订单，ZCS3：零星采购订单，ZCS5：售后低值易耗品采购订单，ZCSS：配件/材料采购订单，ZZR：工程物资采购订单，ZCSR：材料/配件退货订单
startDateStringN2014-04-01订单创建开始日期。查询交易创建开始时间。格式：yyyy-MM-dd
pageNoStringN1页码。取值范围:大于零的整数;默认值为1，即返回第一页数据。最大值为99999。
pageSizeStringN10每页条数。取值范围:大于零的整数;最大值：50。默认值：10。
响应参数
名称 类型 示例值 描述
orderDetailString
currencyUnitStringCNY货币单位
deliveryDateString2014-04-28订单有效期。采购订单行项目的最晚交货日期
discountRateString0.17折扣率。
eanString6945213504706EAN码。商品的EAN码
itemNoString10采购平台订单行号。订单行项目号
itemStatusString10订单行状态
orderQtyString50订单数量。采购的商品数量
snString1212121212序列号。样机的序列号，样机采购订单专用
snProductCodeString120009121苏宁商品编码
storeCodeStringDE11地址。苏宁门店库，送货地址以此为准
subTotalString500.50合计金额。行项目的合计金额
supplierConfirmStringX确认标识。null :不需要确认 X:需要确认
supplierProductCodeString124521供应商商品编码
unitString件计量单位。
unitPriceString40.50含税单价。精确到小数点
purchaseItemCodeString1或10prs采购订单行号
orderHeadString
coCodeString5006苏宁公司代码。
orderCodeString4500075418采购平台订单编号
orderCreateDateString2014-04-12订单创建日期
orderStatusString10 订单状态。采购订单的状态。10-新订单，20-已阅，40-修改待阅 ，50-取消
orderTypeStringNB订单类型。采购订单类型
prePurchaseNoString12000012预采购订单号
purchaseCodeStringprs采购订单号prs采购订单号
supplierCodeString70057356商户编码
请求示例
  • XML示例
  • JSON示例
复制全部代码 
                                
<sn_request>
  <sn_body>
    <purchaseOrder>
      <orderType>NB</orderType>
      <endDate>2014-04-14</endDate>
      <pageNo>1</pageNo>
      <orderStatus>10</orderStatus>
      <pageSize>10</pageSize>
      <orderCode>4500075418</orderCode>
      <startDate>2014-04-01</startDate>
    </purchaseOrder>
  </sn_body>
</sn_request>

			
                                
                                
{
  "sn_request": {
    "sn_body": {
      "purchaseOrder": {
        "orderType": "NB",
        "endDate": "2014-04-14",
        "pageNo": "1",
        "orderStatus": "10",
        "pageSize": "10",
        "orderCode": "4500075418",
        "startDate": "2014-04-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>
    <purchaseOrder>
      <orderDetail>
        <unitPrice>40.50</unitPrice>
        <discountRate>0.17</discountRate>
        <itemNo>10</itemNo>
        <snProductCode>120009121</snProductCode>
        <subTotal>500.50</subTotal>
        <unit>件</unit>
        <ean>6945213504706</ean>
        <itemStatus>10</itemStatus>
        <supplierConfirm>X</supplierConfirm>
        <supplierProductCode>124521</supplierProductCode>
        <orderQty>50</orderQty>
        <sn>1212121212</sn>
        <purchaseItemCode>1或10</purchaseItemCode>
        <deliveryDate>2014-04-28</deliveryDate>
        <currencyUnit>CNY</currencyUnit>
        <storeCode>DE11</storeCode>
      </orderDetail>
      <orderHead>
        <orderType>NB</orderType>
        <orderCreateDate>2014-04-12</orderCreateDate>
        <purchaseCode>prs采购订单号</purchaseCode>
        <prePurchaseNo>12000012</prePurchaseNo>
        <coCode>5006</coCode>
        <orderStatus>10</orderStatus>
        <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": [
            {
              "unitPrice": "40.50",
              "discountRate": "0.17",
              "itemNo": "10",
              "snProductCode": "120009121",
              "subTotal": "500.50",
              "unit": "件",
              "ean": "6945213504706",
              "itemStatus": "10",
              "supplierConfirm": "X",
              "supplierProductCode": "124521",
              "orderQty": "50",
              "sn": "1212121212",
              "purchaseItemCode": "1或10",
              "deliveryDate": "2014-04-28",
              "currencyUnit": "CNY",
              "storeCode": "DE11"
            }
          ],
          "orderHead": {
            "orderType": "NB",
            "orderCreateDate": "2014-04-12",
            "purchaseCode": "prs采购订单号",
            "prePurchaseNo": "12000012",
            "coCode": "5006",
            "orderStatus": "10",
            "orderCode": "4500075418",
            "supplierCode": "70057356"
          }
        }
      ]
    }
  }
}
异常示例
  • XML示例
  • JSON示例
复制全部代码 

  
  	API异常码
  	异常码中文描述
  

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