4.1.03.数电票发票批量查询 - 发票云(旗舰版)API文档

请求参数

Query 参数

access_token

string

必需

{access_token}

Body 参数application/json

requestId

string

必需

当前13位毫秒级时间戳加3位随机数字(总共16位)

businessSystemCode

string

必需

对接业务系统来源编码，用于区分不同业务系统的回调接口

interfaceCode

enum<string>

必需

接口编码，固定值：ALLE.BATCH.QUERY

枚举值:

ALLE.BATCH.QUERY

data

object

必需

需要把data里面的object进行加密成字符串

serialNo

string

可选

开红、蓝票时传入的流水号【长度：20】

sellerTaxpayerId

string

必需

销售方纳税人识别号【长度：20】

invoiceDateS

string

可选

开票日期起【长度：10】，invoiceDateS有值，则invoiceDateE必填

invoiceDateE

string

可选

开票日期止【长度：10】，invoiceDateE有值，则invoiceDateS必填

invoiceStatus

string

可选

发票状态，0正常，3红冲

invoiceType

string

必需

发票种类，发票种类， 01-数字化电子专票，02-数字化电子普票

pageNo

number

页码

必需

pageSize

number

分页大小，最大50

必需

示例

{
  "requestId": "string",
  "businessSystemCode": "string",
  "interfaceCode": "ALLE.BATCH.QUERY",
  "data": {
    "serialNo": "string",
    "sellerTaxpayerId": "string",
    "invoiceDateS": "string",
    "invoiceDateE": "string",
    "invoiceStatus": "string",
    "invoiceType": "string",
    "pageNo": 0,
    "pageSize": 0
  }
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

success

boolean

必需

true或false

errorCode

string

"0"为成功

必需

message

string

错误描述

必需

data

array [object {45}]

返回内容，需要解密

必需

serialNo

string

必需

流水号【长度：20】

buyerTaxpayerId

string

购买方税号

必需

buyerName

string

必需

购买方名称，GBK编码100个字节【长度：100】

buyerBank

string

购买方银行

必需

buyerBankAccount

string

购买方银行账号

必需

buyerAddress

string

购买方地址

必需

buyerTel

string

购买方电话

必需

buyerProperty

number

必需

购买方性质，0-企业，1-个人【长度：1】

buyerRecipientMail

string

必需

电子发票交付邮箱【长度：100】

buyerRecipientPhone

string

必需

电子发票交付手机号，接收短信【长度：50】

deduction

number

必需

差额【长度：(14,2)】

drawer

string

必需

开票人【长度：10】

invoiceType

string

必需

发票种类， 01-数字化电子专票，02-数字化电子普票

includeTaxAmount

number

价税合计

必需

totalAmount

number

合计金额

必需

totalTaxAmount

number

合计税额

必需

invoiceNum

string

发票号码

必需

invoiceFileUrl

string

PDF文件URL

可选

xmlFileUrl

string

XML文件URL

必需

ofdFileUrl

string

OFD文件URL

必需

invoiceDate

string

开票日期

必需

invoiceProperty

number

必需

开票类型，0蓝票，1红票【长度：1】

originalInvoiceNumber

string

可选

原蓝票号码，开红票必传【长度：8】

redInfoBillNo

string

可选

红字信息表编号，数电票发票红冲必传【长度：16】

govRedConfirmBillUuid

string

必需

数电票红字确认单税局uuid（全电红票必填）

remark

string

可选

备注，GBK编码230字节【长度：230】

sellerName

string

必需

销售方名称，GBK编码100个字节，未传入时使用销售方纳税人识别号匹配系统维护的名称【长度：100】

sellerTaxpayerId

string

必需

销售方纳税人识别号【长度：20】

sellerAddress

string

销售方地址

可选

sellerTel

string

销售方电话

可选

sellerBank

string

销售方银行

可选

sellerBankAccount

string

销售方银行账号

可选

invoiceStatus

string

可选

发票状态，0正常,2开票中,3红冲,4开票失败

systemSource

string

业务系统来源

可选

agentUser

string

必需

（数电票）经办人名称

agentCardType

string

必需

（数电票）经办人证件类型

agentCardNo

string

必需

（数电票）经办人证件号码

agentCountry

string

必需

（数电票）经办人国籍(地区)

agentTaxNo

string

必需

（数电票）经办人自然人纳税人识别号

naturalPersonFlag

string

必需

自然人标识，Y-是，N-否；默认根据购方纳税人识别号取反，有值时为N，无值时为Y

vatTaxRefundType

enum<string>

必需

增值税即征即退类型，空：非增值税即征即退

枚举值:

010203040506070809101112

invoiceDetail

array [object {13}]

发票明细

可选

estateSaleInfo

object (不动产销售)

可选

不动产销售必填，发票云版本5.0.020支持

buildInfo

object (建筑服务)

可选

建筑服务必填，发票云版本5.0.017支持

estateLeaseInfo

object (不动产租赁)

可选

不动产租赁必填，发票云版本5.0.017支持

示例

{
  "errorCode": "0",
  "success": true,
  "errorMsg": "",
  "data": [
    {
      "serialNo": "",
      "buyerTaxpayerId": "91440300335187065E",
      "buyerName": "腾讯征信有限公司",
      "buyerBankAndAccount": "测试",
      "buyerAddressAndTel": "测试",
      "buyerProperty": 0,
      "buyerRecipientMail": "273082671@qq.com",
      "buyerRecipientPhone": "",
      "deduction": 0,
      "drawer": "朱俊",
      "invoiceType": "028",
      "includeTaxAmount": 222,
      "totalAmount": 203.67,
      "totalTaxAmount": 18.33,
      "invoiceNum": "33494489",
      "invoiceFileUrl": "",
      "xmlFileUrl": "",
      "ofdFileUrl": "",
      "invoiceDate": "2021-06-24",
      "invoiceProperty": 0,
      "originalInvoiceNumber": "",
      "redInfoBillNo": "",
      "govRedConfirmBillUuid": "",
      "remark": "",
      "sellerAddressAndTel": "南山区001",
      "sellerBankAndAccount": "工商银行001",
      "sellerName": "金蝶软件（中国）有限公司",
      "sellerTaxpayerId": "915003006188392540",
      "invoiceStatus": "",
      "systemSource": "",
      "agentUser": "",
      "agentCardType": "",
      "agentCardNo": "",
      "agentCountry": "",
      "agentTaxNo": "",
      "naturalPersonFlag": "",
      "invoiceDetail": [
        {
          "amount": 203.67,
          "taxAmount": 18.33,
          "billSourceId": "",
          "goodsName": "*谷物*谷子",
          "lineProperty": 0,
          "price": "",
          "privilegeType": 0,
          "quantity": "",
          "revenueCode": "1010101040000000000",
          "revenueName": "*谷物*",
          "specification": "",
          "taxRate": "0.09",
          "units": ""
        }
      ]
    }
  ]
}