API接口目录

平台业务

商品API
价格API
库存API
销售准备API
交易API
退货退款API(新)
财务API
店铺API
物流API
促销API
分销API
发票API
招商API
换货API
互动营销API
退货退款API
客服API
平台营销API
风控API
会员通API
账房API
财务记账API
异常码自查工具
suning.custom.batchorder.query 批量获取采购订单(三个月内的订单)
¥免费

批量获取采购订单(三个月内的订单)

公共参数
请求参数
名称 类型 是否必须 示例值 描述
endTimeStringN2014-05-01 23:59:59查询结束时间
orderStatusStringN40采购订单头状态:10:待发货,20:已发货,30:采购成功 ,40退货中,50退货完成
pageNoStringY1页码
pageSizeStringY20每页条数
startTimeStringN2014-05-01 23:59:59查询开始时间
响应参数
名称 类型 示例值 描述
addressString街道具体地址收件人地址
bankAccountString工商银行开户行
bankAccountNumberString银行帐号银行帐号
cityNameString青岛市收件人地址(市)中文
cmmdtyBandStringcmmdtyBand品牌
cmmdtyCodeString123456789商品编码
cmmdtyNameString商品名称商品名称
customerNameString顾客姓名顾客姓名
distributourCodeString12555688分销商编码
districtNameString崂山区收件人地址(区)中文
dutyParagraphString11税号
invoiceHeaderString22发票抬头
invoiceTypeString01发票类型.01增值税发票
mobPhoneNumString124575424647买家联系电话
omsCreateTimeString2017-10-20 00:00:00订单支付时间
operateStyleString20订单状态。10-待发货;20-已发货;30-采购成功;40-退货中;50-关闭
orderRemarkString订单备注订单备注
phoneNumString0576-154546465买家联系电话(座机)
priceString12销售价
provinceNameString山东省收件人地址(省)中文
purchasePriceString采购供价采购供价
registeredAddressString注册地址注册地址
registeredPhoneString注册电话注册电话
saleQtyString1销售数量
sapProductCodeStringR098商品类目
sdcsCreateTimeString2014-12-12 23:56:53采购订单创建时间
sdcsOrderIdStringSDCS2043553325655SDCS的采购订单号
totalAmountString22销售额
consumerInvoiceString
invoiceHeadString公司发票抬头
needInvoiceFlagStringY是否需要发票,Y-是;N-否;
invoiceTypeString01发票类型,01-增值税发票; 02-普通发票; 03-纸质电子发票; 04-电子发票; 05-不需发票;
taxPayerNoString3423336税纳税人识别号
registerAddressString苏宁大道01号注册地址
registerPhoneNumString02503434344注册电话
accountBankString中国银行开户行
accountNumberString6225454246454565开户账号
invoiceConentString水电费发票内容
taxPayerNameString刘流增值税发票收件人姓名
taxPayerAddressString苏宁大道增值税发票收件人地址
taxPayerPhoneNumString02343346566增值税发票收件人电话
taxPayerMobileNumString123123242增值税发票收件人手机
payAmountString22.00应付金额
suppCmmdtyCodeString100000001供应商产品编码
suppRemarkString备注备注
请求示例
  • XML示例
  • JSON示例
复制全部代码
                                <sn_request>
  <sn_body>
    <queryBatchorder>
      <pageNo>1</pageNo>
      <orderStatus>40</orderStatus>
      <pageSize>20</pageSize>
      <startTime>2014-05-01 23:59:59</startTime>
      <endTime>2014-05-01 23:59:59</endTime>
    </queryBatchorder>
  </sn_body>
</sn_request>

                                
                                {
  "sn_request": {
    "sn_body": {
      "queryBatchorder": {
        "pageNo": "1",
        "orderStatus": "40",
        "pageSize": "20",
        "startTime": "2014-05-01 23:59:59",
        "endTime": "2014-05-01 23:59:59"
      }
    }
  }
}
                                
响应示例
  • 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>
    <queryBatchorder>
      <sapProductCode>R098</sapProductCode>
      <omsCreateTime>2017-10-20 00:00:00</omsCreateTime>
      <operateStyle>20</operateStyle>
      <cmmdtyCode>123456789</cmmdtyCode>
      <orderRemark>订单备注</orderRemark>
      <phoneNum>0576-154546465</phoneNum>
      <purchasePrice>采购供价</purchasePrice>
      <cmmdtyBand>cmmdtyBand</cmmdtyBand>
      <registeredAddress>注册地址</registeredAddress>
      <payAmount>22.00</payAmount>
      <cityName>青岛市</cityName>
      <price>12</price>
      <sdcsOrderId>SDCS2043553325655</sdcsOrderId>
      <invoiceType>01</invoiceType>
      <bankAccountNumber>银行帐号</bankAccountNumber>
      <bankAccount>工商银行</bankAccount>
      <dutyParagraph>11</dutyParagraph>
      <address>街道具体地址</address>
      <districtName>崂山区</districtName>
      <distributourCode>12555688</distributourCode>
      <suppCmmdtyCode>100000001</suppCmmdtyCode>
      <sdcsCreateTime>2014-12-12 23:56:53</sdcsCreateTime>
      <cmmdtyName>商品名称</cmmdtyName>
      <registeredPhone>注册电话</registeredPhone>
      <consumerInvoice>
        <taxPayerMobileNum>123123242</taxPayerMobileNum>
        <invoiceConent>水电费</invoiceConent>
        <needInvoiceFlag>Y</needInvoiceFlag>
        <taxPayerName>刘流</taxPayerName>
        <accountNumber>6225454246454565</accountNumber>
        <taxPayerPhoneNum>02343346566</taxPayerPhoneNum>
        <accountBank>中国银行</accountBank>
        <registerAddress>苏宁大道01号</registerAddress>
        <taxPayerAddress>苏宁大道</taxPayerAddress>
        <invoiceHead>公司</invoiceHead>
        <registerPhoneNum>02503434344</registerPhoneNum>
        <taxPayerNo>3423336</taxPayerNo>
        <invoiceType>01</invoiceType>
      </consumerInvoice>
      <customerName>顾客姓名</customerName>
      <mobPhoneNum>124575424647</mobPhoneNum>
      <invoiceHeader>22</invoiceHeader>
      <totalAmount>22</totalAmount>
      <suppRemark>备注</suppRemark>
      <provinceName>山东省</provinceName>
      <saleQty>1</saleQty>
    </queryBatchorder>
  </sn_body>
</sn_responseContent>

                              
                              {
  "sn_responseContent": {
    "sn_head": {
      "totalSize": "1",
      "pageTotal": "1",
      "pageNo": "1",
      "returnMessage": "biz.handler.data-get:success"
    },
    "sn_body": {
      "queryBatchorder": [
        {
          "sapProductCode": "R098",
          "omsCreateTime": "2017-10-20 00:00:00",
          "operateStyle": "20",
          "cmmdtyCode": "123456789",
          "orderRemark": "订单备注",
          "phoneNum": "0576-154546465",
          "purchasePrice": "采购供价",
          "cmmdtyBand": "cmmdtyBand",
          "registeredAddress": "注册地址",
          "payAmount": "22.00",
          "cityName": "青岛市",
          "price": "12",
          "sdcsOrderId": "SDCS2043553325655",
          "invoiceType": "01",
          "bankAccountNumber": "银行帐号",
          "bankAccount": "工商银行",
          "dutyParagraph": "11",
          "address": "街道具体地址",
          "districtName": "崂山区",
          "distributourCode": "12555688",
          "suppCmmdtyCode": "100000001",
          "sdcsCreateTime": "2014-12-12 23:56:53",
          "cmmdtyName": "商品名称",
          "registeredPhone": "注册电话",
          "consumerInvoice": [
            {
              "taxPayerMobileNum": "123123242",
              "invoiceConent": "水电费",
              "needInvoiceFlag": "Y",
              "taxPayerName": "刘流",
              "accountNumber": "6225454246454565",
              "taxPayerPhoneNum": "02343346566",
              "accountBank": "中国银行",
              "registerAddress": "苏宁大道01号",
              "taxPayerAddress": "苏宁大道",
              "invoiceHead": "公司",
              "registerPhoneNum": "02503434344",
              "taxPayerNo": "3423336",
              "invoiceType": "01"
            }
          ],
          "customerName": "顾客姓名",
          "mobPhoneNum": "124575424647",
          "invoiceHeader": "22",
          "totalAmount": "22",
          "suppRemark": "备注",
          "provinceName": "山东省",
          "saleQty": "1"
        }
      ]
    }
  }
}
                              
异常示例
  • XML示例
  • JSON示例
复制全部代码

  
  	API异常码
  	异常码中文描述
  

                           	  
{
  "sn_responseContent": {
    "sn_error": {
      "error_code": "API异常码",
      "error_msg": "异常码中文描述"
    }
  }
}
                           		
业务异常码
异常码 错误描述 解决方案
biz.custom.querybatchorder.missing-parameter:* 参数必填 请检查此参数的值,*号表示参数字段名
biz.custom.querybatchorder.format-error:* 参数格式错误 请检查此参数的值,*号表示参数字段名
biz.handler.data-get:no-result 查询没结果 请检查查询参数
isp.sys.service.unavailable.sdcs 服务不可用 请联系苏宁技术人员
公共异常码
API工具
FAQ