1. 发票查验
发票云（生态版）API文档
  • 错误处理 & 错误编码
  • 认证与安全[RPA/NS共用]
    • 内容安全
    • 认证
      POST
  • 订单[RPA/NS共用]
    • 对接指引
    • 创建订单
      POST
    • 关闭订单
      POST
    • 查询订单列表
      GET
  • 基础资料[RPA/NS共用]
    • 对接指引
    • 新增常用开票项
      POST
    • 删除常用开票项
      POST
    • 查询常用开票项列表
      GET
    • 新增常用不动产租赁明细
      POST
    • 删除常用不动产租赁明细
      POST
    • 查询常用不动产租赁明细列表
      GET
    • 新增电子税局账号
      POST
    • 删除电子税局账号
      POST
    • 查询电子税局账号列表
      GET
  • 开票[RPA/NS共用]
    • 对接指引
    • 查询电子税局账号状态
      GET
    • 登录电子税局账号
      POST
    • 获取电子税局扫脸认证二维码信息
      POST
    • 获取扫脸认证结果
      GET
    • 查询企业授信额度
      GET
    • 创建发票开具任务
      POST
    • 修改发票的开具任务
      PATCH
    • 查询发票的开具任务结果
      GET
  • 乐企联用[NS专用]
    • 创建乐企联用申请
    • 查询乐企联用申请结果
  • 发票查验
    • 发票查验
      POST
  • 数据模型
    • 开票数据结构
      • 订单
      • 电子税局账号
      • 企业对象
      • InvoiceLineItem
      • 不动产租赁明细
      • 税局城市编码
      • 电子税局登录角色
      • 扫脸认证二维码信息
      • 两位小数金额的字符串
      • 开票数据
      • 乐企联用申请
    • 公用代码
      • 医疗机构类型
      • 证件类型
      • 零税率标识
      • 发票状态标识
      • 是否蓝字发票
      • 开具类型（代开标识）
    • 查验数据结构
      • 发票状态
      • 发票类型
      • 数字化电子发票-增值税发票数据
      • 增值税发票数据
      • 增值税普通发票（卷式）数据
      • 增值税普通发票（通行费）数据
      • 机动车销售统一发票数据
      • 二手车销售统一发票数据
      • 航空运输客票电子行程单数据
      • 铁路电子客票数据
      • 数字化电子发票-机动车销售统一发票数据
      • 数字化电子发票-二手车销售统一发票数据
      • 财政票据数据
    • 响应数据结构
      • 错误响应
      • 分页信息
      • 批量新增的返回
      • 批量删除的返回
  1. 发票查验

发票查验

POST
/partners/v1/invoice-verifications

描述#

企业端业务系统通过本接口对开具、取得的各类发票发起查验申请，系统根据查验申请反馈查验结果。

更新说明#

更新时间内容修改人
2026-1-141、乐企命名歧义修正，全部税控发票（invoice_type：01、02、03、04、08、10、11、14、15）的商品明细items中product_code字段统一改用tax_classification_code；2、invoice_type=03机动车发票vehicle_price更改为 amount_excluding_tax，vat_tax_amount更改为tax_amount ；3、invoice_type：14、82 的商品明细items增加 zero_tax_rate_flag ；4、 invoice_type：04、10、14、82增加零税率标识反映总局查验平台的“免税”、“不征税”等零税率情况 ；黄潮鑫
2026-1-221、返回响应删除除了200以外的HTTP状态码说明，统一参考错误处理 & 错误编码黄潮鑫
2026-2-31、财政电子票据F1入参要加身份证号payer_tax_no和 缴款人名称payer_name两个字段才返回明细清单黄潮鑫
2026-2-51、财政电子票据F1有部分票据项目明细清单字段只有一部分，item_details內的字段改非必填黄潮鑫
2026-4-241、财政电子票据F1增加返回查验次数黄潮鑫
本接口连接三个平台，其中税票的查验对接的是税务总局查验平台和乐企查验接口；财政票据的查验对接的是财政部查验平台，它们的功能和规则下：
税务总局查验平台(默认)乐企查验接口财政部查验平台
1、大部分当日开具发票当日可查验
（部分因同步延迟可能失败）
2、每张发票当日可查询 5 次
3、可查验最近 5 年内开具的发票		1、支持企业端系统发起各类发票查验
2、支持个税 APP【个人票夹】定向
推送的数电发票查验
3、系统根据申请实时反馈查验结果
注：需申请乐企资质		1、可查验最近一年内开具的电子票据
2、每张票据当日可查询 5 次
3、目前不支持非税收入一般缴款书（电子）查验

必填字段一览表#

由于票的类型多且需传入接口的必填字段不一样，制作一览表以便于查阅：
发票类型税务总局查验平台乐企查验接口财政部查验平台备注
01增值税专用发票必填发票代码、发票号码、开票日期、金额（不含税金额）必填发票代码、发票号码、开票日期、金额（不含税金额）、税号
02货物运输业增值税专用发票必填发票代码、发票号码、开票日期、金额（不含税金额）、税号
03机动车销售统一发票必填发票代码、发票号码、开票日期、金额（不含税金额）必填发票代码、发票号码、开票日期、金额（不含税金额）、税号
04增值税普通发票必填发票代码、发票号码、开票日期、校验码后六位必填发票代码、发票号码、开票日期、校验码后六位、税号
08增值税电子专用发票必填发票代码、发票号码、开票日期、金额（不含税金额）必填发票代码、发票号码、开票日期、金额（不含税金额）、税号
10增值税电子普通发票必填发票代码、发票号码、开票日期、校验码后六位必填发票代码、发票号码、开票日期、校验码后六位、税号
11增值税普通发票（卷式）必填发票代码、发票号码、开票日期、校验码后六位必填发票代码、发票号码、开票日期、校验码后六位、税号
14增值税普通发票（通行费）必填发票代码、发票号码、开票日期、校验码后六位必填发票代码、发票号码、开票日期、校验码后六位、税号
15二手车销售统一发票必填发票代码、发票号码、开票日期、金额（车价合计）必填发票代码、发票号码、开票日期、金额（车价合计）、税号
81数电发票（增值税专用发票）必填发票号码（20位数电发票号码）、开票日期、金额（价税合计）必填发票号码（20位数电发票号码）、开票日期、金额（价税合计）、税号
82数电发票（普通发票）必填发票号码（20位数电发票号码）、开票日期、金额（价税合计）必填发票号码（20位数电发票号码）、开票日期、金额（价税合计）、税号包含数电发票（通行费发票），特定业务要素代码08
85数电纸质发票（增值税专用发票）必填发票代码 + 发票号码 + 开票日期 + 金额（不含税金额）必填发票代码、发票号码（纸质发票号码）、开票日期、金额（不含税金额）、税号
86数电纸质发票（普通发票）必填发票代码 + 发票号码 + 开票日期 + 校验码后六位必填发票代码、发票号码（纸质发票号码）、开票日期、校验码后六位、税号
51数电发票（铁路电子客票）必填发票号码（20位数电发票号码）、开票日期、金额（价税合计）必填发票号码（20位数电发票号码）、开票日期、金额（价税合计）、税号
61数电发票（航空运输客票电子行程单）必填发票号码（20位数电发票号码）、开票日期、金额（价税合计）必填发票号码（20位数电发票号码）、开票日期、金额（价税合计）、税号
83数电发票（机动车销售统一发票）必填发票号码（20位数电发票号码）、开票日期、金额（价税合计）必填发票号码（20位数电发票号码）、开票日期、金额（价税合计）、税号
84数电发票（二手车销售统一发票）必填发票号码（20位数电发票号码）、开票日期、金额（价税合计）必填发票号码（20位数电发票号码）、开票日期、金额（价税合计）、税号
87数电纸质发票（机动车销售统一发票）必填发票代码、发票号码（纸质发票号码）、开票日期、金额（不含税金额）必填发票代码、发票号码（纸质发票号码）、开票日期、金额（不含税金额）、税号
88数电纸质发票（二手车销售统一发票）必填发票代码、发票号码（纸质发票号码）、开票日期、金额（车价合计）必填发票代码、发票号码（纸质发票号码）、开票日期、金额（车价合计）、税号
F1财政电子票据必填发票代码、发票号码、开票日期、金额、校验码

请求参数

Header 参数

Body 参数application/json

示例
{
  "invoice_type": "81",
  "invoice_code": "5101*****111",
  "invoice_number": "00000001",
  "issue_date": "2025-01-01",
  "verification_code": "123456",
  "invoice_amount": 10000.0,
  "tax_no": "915100************"
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST '/partners/v1/invoice-verifications' \
--header 'Accept-Language;' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9' \
--header 'X-Request-Id: req_1701937730123_48210952' \
--header 'X-Encryption-Mode;' \
--header 'Content-Type: application/json' \
--data-raw '{
  "invoice_type": "81",
  "invoice_code": "5101*****111",
  "invoice_number": "00000001",
  "issue_date": "2025-01-01",
  "verification_code": "123456",
  "invoice_amount": 10000.0,
  "tax_no": "915100************"
}'

返回响应

🟢200成功
application/json
Body

示例
{
    "request_id": "请求ID",
    "invoice_type": "发票类型代码，81",
    "verification_data": {
        "invoice_code": "发票代码，数电票为空",
        "invoice_number": "发票号码，20位数字",
        "issue_date": "开票日期，yyyy-MM-dd",
        "invoice_status": "发票状态",
        "seller_name": "销方名称",
        "seller_tax_no": "销方税号",
        "buyer_name": "购方名称",
        "buyer_tax_no": "购方税号",
        "amount_excluding_tax": "不含税金额",
        "tax_amount": "税额",
        "amount_including_tax": "价税合计",
        "remark": "备注",
        "invoice_category_code": "发票种类代码，01=专票",
        "special_element_type_code": "特定要素代码，空=普通",
        "is_blue_invoice": "是否蓝字发票，Y/N",
        "seller_address_phone": "销方地址电话",
        "seller_bank_account": "销方开户行及账号",
        "buyer_address_phone": "购方地址电话",
        "buyer_bank_account": "购方开户行及账号",
        "amount_in_words": "价税合计（大写）",
        "issuer": "开票人",
        "reviewer": "复核人",
        "payee": "收款人",
        "item_count": "明细行数",
        "seller_taxpayer_type_code": "销方纳税人类型",
        "items": [
            {
                "sequence_no": "行号",
                "name": "项目名称（简称）",
                "goods_or_service_name": "货物或服务名称（全称，含税收分类简称）",
                "item_short_name": "税收分类简称",
                "specification": "规格型号",
                "unit": "单位",
                "quantity": "数量",
                "unit_price": "单价",
                "amount": "金额",
                "tax_rate": "税率",
                "tax_amount": "税额",
                "tax_classification_code": "税收分类编码",
                "zero_tax_rate_flag": "零税率标识"
            }
        ]
    }
}
修改于 2026-04-24 08:02:53
上一页
查询乐企联用申请结果
下一页
订单
Built with