API接口目录

自营业务

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

供应商通过该接口查询已经收货入库的待开票数据,用来进行开票对账

公共参数
请求参数
名称 类型 是否必须 示例值 描述
pageNoStringN1页码
pageSizeStringN10每页条数
supplierCodeStringY10004781供应商编码
receivedStartDateStringN2020-10-01收货日期开始日期
receivedEndDateStringN2020-10-31收货日期结束日期
orderCodeStringN4584821341采购订单号
vendorrefNoStringN4565646588供应商发货单号
响应参数
名称 类型 示例值 描述
pageSizeString100每页条数
pageNoString1页码
supplierCodeString10140342供应商编码
totalRecordsString10总条数
orderCodeString1017256266采购订单号
orderItemString0004采购订单行号
receivedCodeString10014602798入库单号
receivedItemString0040入库单行号
vendorrefNoString202003018J1Q发货单
coCodeString5406苏宁公司
productCodeString000000010097470617商品编码
productNameString新希望(雪兰) 纸塑杯 活润大麦.蓝莓.桑葚 160g商品名称
rcptQtyString4.00数量
supplyCodeString4.25供价
discountString0.14扣点
taxRateString0.13税率
taxAmountString1.88税额
totalAmountString16.32总金额
storeCodeString8J1Q地点
orderTypeStringNB采购订单类型
receivedDateString2020-10-07收货日期
请求示例
  • XML示例
  • JSON示例
复制全部代码
                                <sn_request>
  <sn_body>
    <queryPurchaseorderreceived>
      <receivedEndDate>2020-10-31</receivedEndDate>
      <pageNo>1</pageNo>
      <pageSize>10</pageSize>
      <receivedStartDate>2020-10-01</receivedStartDate>
      <orderCode>4584821341</orderCode>
      <supplierCode>10004781</supplierCode>
      <vendorrefNo>4565646588</vendorrefNo>
    </queryPurchaseorderreceived>
  </sn_body>
</sn_request>

                                
                                {
  "sn_request": {
    "sn_body": {
      "queryPurchaseorderreceived": {
        "receivedEndDate": "2020-10-31",
        "pageNo": "1",
        "pageSize": "10",
        "receivedStartDate": "2020-10-01",
        "orderCode": "4584821341",
        "supplierCode": "10004781",
        "vendorrefNo": "4565646588"
      }
    }
  }
}
                                
响应示例
  • 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>
    <queryPurchaseorderreceived>
      <orderType>NB</orderType>
      <receivedItem>0040</receivedItem>
      <totalRecords>10</totalRecords>
      <orderItem>0004</orderItem>
      <discount>0.14</discount>
      <pageSize>100</pageSize>
      <supplyCode>4.25</supplyCode>
      <supplierCode>10140342</supplierCode>
      <productName>新希望(雪兰) 纸塑杯 活润大麦.蓝莓.桑葚 160g</productName>
      <taxRate>0.13</taxRate>
      <totalAmount>16.32</totalAmount>
      <productCode>000000010097470617</productCode>
      <coCode>5406</coCode>
      <pageNo>1</pageNo>
      <rcptQty>4.00</rcptQty>
      <orderCode>1017256266</orderCode>
      <receivedCode>10014602798</receivedCode>
      <taxAmount>1.88</taxAmount>
      <receivedDate>2020-10-07</receivedDate>
      <storeCode>8J1Q</storeCode>
      <vendorrefNo>202003018J1Q</vendorrefNo>
    </queryPurchaseorderreceived>
  </sn_body>
</sn_responseContent>

                              
                              {
  "sn_responseContent": {
    "sn_head": {
      "totalSize": "1",
      "pageTotal": "1",
      "pageNo": "1",
      "returnMessage": "biz.handler.data-get:success"
    },
    "sn_body": {
      "queryPurchaseorderreceived": [
        {
          "orderType": "NB",
          "receivedItem": "0040",
          "totalRecords": "10",
          "orderItem": "0004",
          "discount": "0.14",
          "pageSize": "100",
          "supplyCode": "4.25",
          "supplierCode": "10140342",
          "productName": "新希望(雪兰) 纸塑杯 活润大麦.蓝莓.桑葚 160g",
          "taxRate": "0.13",
          "totalAmount": "16.32",
          "productCode": "000000010097470617",
          "coCode": "5406",
          "pageNo": "1",
          "rcptQty": "4.00",
          "orderCode": "1017256266",
          "receivedCode": "10014602798",
          "taxAmount": "1.88",
          "receivedDate": "2020-10-07",
          "storeCode": "8J1Q",
          "vendorrefNo": "202003018J1Q"
        }
      ]
    }
  }
}
                              
异常示例
  • XML示例
  • JSON示例
复制全部代码

  
  	API异常码
  	异常码中文描述
  

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