4.1.01已开发票查询

税控票或税控票+数电票共用时使用；纯数电票开票（比如直接开票-数电开票）请用4.1.04或4.1.03接口。

FAQ

序号	问	答
1	4.1.01已开发票查询，蓝票开票成功，它的发票明细的剩余可红冲不含税金额，剩余可红冲数量，剩余可红冲税额，可红冲不含税单价等4个字段都有值了吗？	是的，开完蓝票就会写这几个值
2	4.1.01已开发票查询，发票明细的detailId，是我们调用蓝字发票开具接口或红冲接口，发票明细billSourceId参数传的值吗？	不是，已开发票查询接口的billSourceId，对应开蓝票接口的billSourceId

请求参数

Header 参数

access_token

string

可选

默认值:

Body 参数application/json

requestId

string

时间戳

必需

时间戳（毫秒级）

businessSystemCode

string

业务系统编码

必需

发票云-系统管理-业务系统中存在的业务系统编码
对接业务系统来源编码，用于区分不同业务系统的回调接口

示例值:

FPY

interfaceCode

string

接口编码

必需

固定值：INVOICE.QUERY

示例值:

INVOICE.QUERY

data

object

数据体

必需

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

serialNo

string

外部流水号

可选

调用开票接口时传的serialno【长度：50】

<= 50 字符

sellerTaxpayerId

string

销售方纳税人识别号

必需

已开发票的销售方税号，必须是发票云-基础资料中已授权销项许可的税号

>= 15 字符<= 20 字符

示例值:

91440300XXXXXXXXXX

invoiceType

enum<string>

发票种类

可选

枚举值:

08xdp10xdp004007025026028

invoiceStatus

enum<string>

发票状态

可选

枚举值:

0123467

invoiceDateS

string <date>

开票日期起

可选

示例：YYYY-MM-DD
invoiceDateS有值，则invoiceDateE必填【长度：10】

<= 10 字符

invoiceDateE

string <date>

开票日期止

可选

示例：YYYY-MM-DD
invoiceDateE有值，则invoiceDateS必填【长度：10】

invoiceCode

string

发票代码

可选

税控发票需传，数电发票不传【长度：12】

<= 12 字符

invoiceNumberS

string

发票号码起

可选

如果仅查询一张发票，发票号码起、止传同一个发票号码
【税控发票长度：8，数电发票长度：20】

invoiceNumberE

string

发票号码止

可选

如果仅查询一张发票，发票号码起、止传同一个发票号码
【税控发票长度：8，数电发票长度：20】

pageNo

integer

页码

必需

示例值:

倍数:

pageSize

integer

分页大小

必需

每页返回发票数量，最大50

示例

请求参数示例（加密前）请求参数示例（data数据体base64加密后）

{
    "requestId": "1751546157921",
    "businessSystemCode": "FPY",
    "interfaceCode": "INVOICE.QUERY",
    "data": {
        "serialNo": "023115ad-0bc6-40d4-8169-15f8e8bd7529",
        "sellerTaxpayerId": "91440300XXXXXXXXXX",
        "invoiceType": "025",
        "invoiceStatus": "2",
        "invoiceDateS": "2026-01-11",
        "invoiceDateE": "2024-11-13",
        "invoiceCode": "30",
        "invoiceNumberS": "93",
        "invoiceNumberE": "6",
        "pageNo": 0,
        "pageSize": 68
    }
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

data

array [object {56}]

返回数据体

必需

请求成功返回内容，需要base64解密

account

string

电子税局账号

必需

buyerType

enum<number>

开票来源

必需

枚举值:

0123456789101112

systemSource

string

数据来源系统

可选

org

string

组织id

必需

serialNo

string

单据编号

必需

batch

string

开票批次号

必需

orderNo

string

发票流水号

必需

issueErrorMessage

string

开票失败原因

必需

invoiceType

enum<string>

发票种类

必需

枚举值:

08xdp10xdp004007025026028

invoiceProperty

enum<integer>

发票性质

必需

枚举值:

invoiceStatus

enum<string>

发票状态

必需

枚举值:

0123467

specialType

enum<string>

特殊票种

必需

枚举值:

00020607081118E01E03E04E05E06E07E09E12E14E18

taxedType

enum<string>

征税方式

必需

枚举值:

012

invoiceCode

string

发票代码

必需

invoiceNum

string

发票号码

必需

invoiceDate

string <date>

开票日期

必需

示例值:

2021-06-24

invoiceDetailDate

string <date-time>

开票日期时分秒

必需

totalAmount

number

不含税金额合计

必需

totalTaxAmount

number

税额合计

必需

includeTaxAmount

number

价税合计

必需

sellerName

string

销售方名称

必需

sellerTaxpayerId

string

销售方纳税人识别号

必需

<= 20 字符

sellerAddressAndTel

string

销售方地址和电话

必需

<= 100 字符

sellerBankAndAccount

string

销售方银行和银行账号

必需

<= 100 字符

buyerProperty

enum<integer>

购买方性质

必需

枚举值:

013

buyerName

string

购买方名称

必需

<= 100 字符

buyerTaxpayerId

string

购方税号

必需

<= 20 字符

buyerAddressAndTel

string

购买方地址和电话

必需

<= 100 字符

buyerBankAndAccount

string

购买方银行和银行账号

必需

<= 100 字符

buyerRecipientMail

string

电子发票交付邮箱

必需

<= 100 字符

buyerRecipientPhone

string

电子发票交付手机号

必需

<= 50 字符

drawer

string

开票人

必需

reviewer

string

复核人

可选

payee

string

收款人

必需

canceler

string

作废人

必需

remark

string

备注

可选

invoiceFileUrl

string

数电票版式文件下载地址

必需

数电票为OFD文件；航信百旺税盘开普通电票为PDF文件，开电子专票为OFD文件；ukey开电票为OFD文件。

invoicePdfFileUrl

string

数电票pdf下载地址

必需

适用版本：发票云5.0.025及以后版本

invoiceXmlFileUrl

string

数电票xml下载地址

必需

适用版本：发票云5.0.025及以后版本

invoiceImageUrl

string

发票预览图片下载地址

必需

originalInvoiceType

string

原发票种类

必需

查询红字发票所对应的原蓝票种类

originalInvoiceCode

string

原蓝票代码

可选

查询红字发票所对应的原蓝票代码

originalInvoiceNumber

string

原蓝票号码

可选

查询红字发票所对应的原蓝票号码

redInfoBillNo

string

红字信息表编号

可选

redReason

enum<string>

冲红原因

必需

枚举值:

1234

deduction

number

扣除额

必需

适用差额征税

<= 14

倍数:

abolishReason

string

作废原因

必需

coBuyerFlag

string

是否共同购买方

必需

不动产销售特殊票种适用

printFlag

enum<string>

打印标识

可选

枚举值:

012

inventoryMark

enum<string>

清单标志

必需

枚举值:

skm

string

密码区

必需

适用于税控发票

checkCode

string

校验码

必需

税控发票有，数电票无

deviceNo

string

设备编号

必需

适用于税控发票

terminalNo

string

终端编号

可选

适用于百望服务器开具的税控发票

includeTaxFlag

enum<string>

含税标识

必需

枚举值:

示例值:

invoiceDetail

array [object {25}]

发票明细

必需

errorCode

enum<string>

接口响应码

必需

枚举值:

status

boolean

接口响应状态

必需

success

boolean

是否成功

必需

示例

{"data":[{"abolishReason":"","batch":"BAIDU_TEST202203231626221942","billDate":1648023983000,"buyerAddressAndTel":"壹贰叁肆伍陆柒扒九十34567890","buyerBankAndAccount":"壹贰叁肆伍陆柒扒九十1234567890123","buyerName":"深圳市顺丰快运有限公司","buyerProperty":0,"buyerRecipientMail":"10086@Kingdee.com","buyerRecipientPhone":"","buyerTaxpayerId":"91440300MA5FNT4Y8U","buyerType":3,"canceler":"","deduction":0,"deviceNo":"016000003144","drawer":"开票人1","includeTaxAmount":1000,"includeTaxFlag":1,"inventoryMark":"0","invoiceCode":"816855313318","invoiceDate":"2022-03-23","invoiceDetail":[{"amount":884.96,"billSourceId":"202011130001202011130001","detailId":"1382643778770174976","detailRowNo":1,"goodsName":"*烟草制品*测试非卷烟-烟丝","includeTaxAmount":1000,"includeTaxPrice":"1000","lineProperty":0,"price":"884.9557522124","privilegeContent":"","privilegeFlag":0,"quantity":"1","revenueCode":"1030404000000000000","revenueName":"烟草制品","seq":0,"specification":"按克计算","taxAmount":115.04,"taxFlag":"","taxRate":"0.13","units":"克","zeroTaxRateFlag":""}],"invoiceFileUrl":"","invoiceImageUrl":"","invoiceNum":"82025510","invoiceProperty":0,"invoiceStatus":"0","invoiceType":"007","issueErrorMessage":"","orderNo":"a1d85874353143b18572837222d0f167","org":1108641842309628900,"originalInvoiceCode":"","originalInvoiceNumber":"","originalInvoiceType":"026","originalIssueTime":"20220101","payee":"","printFlag":"0","redInfoBillNo":"","redReason":"","remark":"测试备注","reviewer":"","sellerAddressAndTel":"中国银行123456789","sellerBankAndAccount":"深圳市福田区梅景123456789","sellerName":"金蝶软件（中国）有限公司","sellerTaxpayerId":"915003006188392540","serialNo":"34234FPY123456refe4","specialType":"","systemSource":"BAIDU_TEST","taxedType":0,"terminalNo":"","totalAmount":884.96,"totalTaxAmount":115.04}],"errorCode":"0","success":true}

FAQ#

请求参数

示例代码

返回响应

FAQ