4.1.01已开发票查询

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

FAQ

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

请求参数

Query 参数

access_token

string

必需

Body 参数application/json

requestId

string

时间戳

必需

businessSystemCode

string

必需

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

interfaceCode

enum<string>

接口编码

必需

枚举值:

INVOICE.QUERY

data

object

必需

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

serialNo

string

可选

单据编号，即外部流水号【长度：50】

<= 50 字符

sellerTaxpayerId

string

必需

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

<= 20 字符

invoiceDateS

string

可选

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

invoiceDateE

string

可选

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

invoiceCode

string

可选

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

<= 12 字符

invoiceNumberS

string

可选

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

invoiceNumberE

string

可选

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

invoiceStatus

enum<string>

发票状态

可选

枚举值:

0123467

invoiceType

enum<string>

发票种类

可选

枚举值:

02802600400702508xdp10xdp

pageNo

number

页码

必需

pageSize

number

分页大小，最大50

必需

示例

{
  "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
  }
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

data

array [object {49}]

返回内容，需要解密

必需

abolishReason

string

作废原因

必需

batch

string

可选

buyerAddressAndTel

string

必需

购买方地址和电话，GBK编码100字节，开专票时若未传入则用名称匹配系统维护的地址电话【长度：100】

buyerBankAndAccount

string

必需

购买方银行和银行账号，GBK编码100字节，开专票时若未传入则用名称匹配系统维护的银行账号【长度：100】

buyerName

string

必需

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

buyerProperty

number

必需

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

buyerRecipientMail

string

必需

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

buyerRecipientPhone

string

必需

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

buyerTaxpayerId

string

必需

购买方性质为非企业时可为空，为企业时若未传入则用名称匹配系统维护的税号【长度：20】

buyerType

number

开票来源

必需

canceler

string

作废人

可选

deduction

number

必需

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

deviceNo

string

必需

设备编号，不传的情况系统根据随机选择【长度：20】

drawer

string

必需

开票人【长度：10】

includeTaxAmount

number

价税合计

必需

includeTaxFlag

number

必需

含税价标识，0-不含税，1-含税【长度：1】

inventoryMark

string

必需

含税价标识，0-不含税，1-含税【长度：1】

invoiceCode

string

必需

发票代码【长度：12】

invoiceNum

string

发票号码

必需

invoiceFileUrl

string

必需

板式文件下载地址，数电票为ofd文件，航信百旺税盘开普通电票为PDF文件，开电子专票为ofd文件，ukey开电票为ofd文件

invoicePdfFileUrl

string

必需

数电pdf下载地址(发票云5.0.025版本返回)

invoiceXmlFileUrl

string

必需

数电xml下载地址(发票云5.0.025版本返回)

invoiceImageUrl

string

PDF图片预览地址

必需

invoiceDate

string

开票日期

必需

示例值:

2021-06-24

invoiceDetail

array [object {25}]

发票明细

必需

invoiceProperty

number

必需

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

invoiceType

enum<string>

必需

发票种类， 028：增值税电子专用发票 004：增值税纸质专用发票 026：增值税电子普通发票 007：增值税纸质普通发票【长度：4】

枚举值:

02802600400702508xdp10xdp

orderNo

string

发票流水号

必需

org

number

组织id

必需

originalInvoiceCode

string

可选

原蓝票代码，开红票必传【长度：12】

originalInvoiceNumber

string

可选

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

payee

string

可选

收款人【长度：10】

printFlag

string

打印标识

可选

redInfoBillNo

string

可选

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

remark

string

可选

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

reviewer

string

可选

复核人【长度：10】

sellerAddressAndTel

string

必需

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

sellerBankAndAccount

string

必需

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

sellerName

string

必需

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

sellerTaxpayerId

string

必需

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

serialNo

string

必需

单据编号【长度：50】

systemSource

string

业务系统来源

可选

taxedType

number

必需

征税方式，0：普通征税 1：减按计征 2：差额征税

terminalNo

string

可选

终端号，不传的情况系统随机选择【长度：50】

totalAmount

number

合计金额

必需

totalTaxAmount

number

合计税额

必需

checkCode

string

校验码

必需

skm

string

密码区

必需

invoiceStatus

enum<string>

必需

发票状态，0正常，3红冲，6作废

枚举值:

0123467

errorCode

string

响应码,0-成功

必需

success

boolean

响应状态

必需

message

string

错误描述

必需

示例

{
  "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