发票云(旗舰版)API文档
4.1.01已开发票查询
POST/kapi/app/sim/openApi税控票或税控票+数电票共用时使用；纯数电票开票（比如直接开票-数电开票）请用4.1.04或4.1.03接口。
FAQ
| 序号 | 问 | 答 |
|---|---|---|
| 1 | 4.1.01已开发票查询，蓝票开票成功，它的发票明细的剩余可红冲不含税金额，剩余可红冲数量，剩余可红冲税额，可红冲不含税单价等4个字段都有值了吗？ | 是的，开完蓝票就会写这几个值 |
| 2 | 4.1.01已开发票查询，发票明细的detailId，是我们调用蓝字发票开具接口或红冲接口，发票明细billSourceId参数传的值吗？ | 不是，已开发票查询接口的billSourceId，对应开蓝票接口的billSourceId |
请求参数
对接业务系统来源编码，用于区分不同业务系统的回调接口
需要把data里面的object加密成base64字符串
单据编号，即外部流水号【长度：50】
销售方纳税人识别号【长度：20】
开票日期起【长度：10】，invoiceDateS有值，则invoiceDateE必填
开票日期止【长度：10】，invoiceDateE有值，则invoiceDateS必填
发票代码【长度：12，税控发票需传输，数电发票不传】
发票号码起【税控发票长度：8，数电发票长度：20】，如果仅查询一张发票，发票号码起、止传同一个发票号码
发票号码止【税控发票长度：8，数电发票长度：20】，如果仅查询一张发票，发票号码起、止传同一个发票号码
{
"requestId": "string",
"businessSystemCode": "string",
"interfaceCode": " INVOICE.QUERY",
"data": {
"serialNo": "string",
"sellerTaxpayerId": "string",
"invoiceDateS": "string",
"invoiceDateE": "string",
"invoiceCode": "string",
"invoiceNumberS": "string",
"invoiceNumberE": "string",
"invoiceStatus": "0",
"invoiceType": "028",
"pageNo": 0,
"pageSize": 0
}
}示例代码
返回响应
购买方地址和电话，GBK编码100字节，开专票时若未传入则用名称匹配系统维护的地址电话【长度：100】
购买方银行和银行账号，GBK编码100字节，开专票时若未传入则用名称匹配系统维护的银行账号【长度：100】
购买方名称，GBK编码100个字节【长度：100】
购买方性质，0-企业，1-个人【长度：1】
电子发票交付邮箱【长度：100】
电子发票交付手机号，接收短信【长度：50】
购买方性质为非企业时可为空，为企业时若未传入则用名称匹配系统维护的税号【长度：20】
差额【长度：(14,2)】
设备编号，不传的情况系统根据随机选择【长度：20】
开票人【长度：10】
含税价标识，0-不含税，1-含税【长度：1】
含税价标识，0-不含税，1-含税【长度：1】
发票代码【长度：12】
板式文件下载地址，数电票为ofd文件，航信百旺税盘开普通电票为PDF文件，开电子专票为ofd文件，ukey开电票为ofd文件
数电pdf下载地址(发票云5.0.025版本返回)
数电xml下载地址(发票云5.0.025版本返回)
开票类型，0蓝票，1红票【长度：1】
发票种类， 028：增值税电子专用发票 004：增值税纸质专用发票 026：增值税电子普通发票 007：增值税纸质普通发票【长度：4】
原蓝票代码，开红票必传【长度：12】
原蓝票号码，开红票必传【长度：8】
收款人【长度：10】
红字信息表编号，专用发票红冲必传【长度：16】
备注，GBK编码230字节【长度：230】
复核人【长度：10】
销售方地址和电话，GBK编码100个字节，未传入时使用销售方纳税人识别号匹配系统维护的地址电话【长度：100】
销售方银行和银行账号，GBK编码100个字节，未传入时使用销售方纳税人识别号匹配系统维护的银行账号【长度：100】
销售方名称，GBK编码100个字节，未传入时使用销售方纳税人识别号匹配系统维护的名称【长度：100】
销售方纳税人识别号【长度：20】
单据编号【长度：50】
征税方式，0：普通征税 1：减按计征 2：差额征税
终端号，不传的情况系统随机选择【长度：50】
发票状态，0正常，3红冲，6作废
{
"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
}