1. 发票查验
发票云(生态版)API文档
  • 错误处理 & 错误编码
  • 认证与安全[RPA/NS共用]
    • 内容安全
    • 认证
      POST
  • 订单[RPA/NS共用]
    • 对接指引
    • 创建订单
      POST
    • 关闭订单
      POST
    • 查询订单列表
      GET
  • 基础资料[RPA/NS共用]
    • 对接指引
    • 新增常用开票项
      POST
    • 删除常用开票项
      POST
    • 查询常用开票项列表
      GET
    • 新增常用不动产租赁明细
      POST
    • 删除常用不动产租赁明细
      POST
    • 查询常用不动产租赁明细列表
      GET
    • 新增电子税局账号
      POST
    • 删除电子税局账号
      POST
    • 查询电子税局账号列表
      GET
  • 开票[RPA/NS共用]
    • 对接指引
    • 开票[RPA/NS共用]
    • 查询电子税局账号状态
      GET
    • 二维码扫码登录电子税局账号
      POST
    • 验证码登录电子税局账号
      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增加返回查验次数黄潮鑫
2026-6-241、总局查验接口升级,增值税发票数据返回special_invoice_type、issue_type、total_verification_count查验次数、last_verification_time最后查验时间、issuer开票人、payee收款人、reviewer复核人、invoice_ciphertext发票密文、machine_code机器编码;2、数电增值税81/82/85/86 buyer_address_phone字段拼写错误修正;数电二手车 84/88seller_bank_name_account -> seller_bank_account ;数电二手车 84/88和二手车 15 auction_company_address_phone(单字段)auction_company_address +auction_company_phone(拆两个);黄潮鑫
2026-6-291、乐企仅invoiceType02、08返回零税率标识;2、乐企数电航空客票增加insurance_fee_invoice_no黄潮鑫
2026-6-291、发票密文即为乐企返回的tax_control_code税控码,删除冗余的invoice_ciphertext发票密文黄潮鑫
2026-9-241、财政票据F1查验次数total_verification_count类型由string改为integer;2、兼容乐企,数电机动车83/87的vat_tax_amount、price_without_tax改为非必填;3、兼容乐企,数电增值税81/82/85/86及通行费14的商品明细zero_tax_rate_flag改为非必填;4、兼容乐企,铁路电子客票51的payment_amount改为非必填;5、成功响应新增必填字段trace_id(链路追踪ID,用于跨系统追踪请求链路,问题排查时提供)黄潮鑫
本接口连接三个平台,其中税票的查验对接的是税务总局查验平台和乐企查验接口;财政票据的查验对接的是财政部查验平台,它们的功能和规则下:
税务总局查验平台(默认)乐企查验接口财政部查验平台
1、大部分当日开具发票当日可查验
(部分因同步延迟可能失败)
2、每张发票当日可查询 5 次
3、可查验最近 5 年内开具的发票
1、支持企业端系统发起各类发票查验
2、支持个税 APP【个人票夹】定向
推送的数电发票查验
3、系统根据申请实时反馈查验结果,若企业采用离线开票,可能会在开票日期48小时后方可查验
注:需申请乐企资质,开通开票能力和查验能力
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 '/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 '{
  "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
Bodyapplication/json

示例
{
    "request_id": "string",
    "trace_id": "string",
    "invoice_type": "01",
    "verification_data": {
        "invoice_number": "string",
        "invoice_code": "string",
        "paper_invoice_no": "string",
        "invoice_category_code": "st",
        "issue_date": "string",
        "invoice_status": "0",
        "special_element_type_code": "st",
        "is_blue_invoice": "Y",
        "original_blue_invoice_no": "string",
        "original_blue_paper_invoice_code": "string",
        "original_blue_paper_invoice_no": "string",
        "seller_tax_no": "string",
        "seller_name": "string",
        "buyer_tax_no": "string",
        "buyer_name": "string",
        "amount_excluding_tax": 0,
        "tax_amount": 0,
        "amount_including_tax": 0,
        "amount_in_words": "string",
        "deduction_amount": 0,
        "settlement_method_code": "st",
        "issuer": "string",
        "remark": "string",
        "item_count": 0,
        "vat_immediate_refund_code": "st",
        "export_tax_refund_type_code": "st",
        "reviewer": "string",
        "payee": "string",
        "seller_address_phone": "string",
        "seller_bank_account": "string",
        "buyer_address_phone": "string",
        "buyer_bank_account": "string",
        "seller_taxpayer_type_code": "1",
        "refined_oil_abnormal_flag": "9",
        "additional_elements": {},
        "construction_service_special_elements": {
            "land_value_tax_project_no": "string",
            "cross_city_flag": "Y"
        },
        "construction_service_detail_list": [
            {
                "sequence_no": 0,
                "construction_service_location": "string",
                "construction_project_name": "string",
                "amount": 0,
                "tax_rate": 0,
                "tax_amount": 0,
                "name": "string"
            }
        ],
        "freight_transport_service_detail_list": [
            {
                "sequence_no": 0,
                "transport_tool_type": "string",
                "transport_tool_plate_no": "string",
                "start_place": "string",
                "end_place": "string",
                "transport_goods": "string"
            }
        ],
        "real_estate_sales_detail_list": [
            {
                "sequence_no": 0,
                "property_certificate_no": "string",
                "real_estate_unit_code": "string",
                "online_contract_filing_no": "string",
                "real_estate_address": "string",
                "cross_city_flag": "Y",
                "land_value_tax_project_no": "string",
                "approved_tax_price": 0,
                "actual_turnover": 0
            }
        ],
        "real_estate_lease_detail_list": [
            {
                "sequence_no": 0,
                "property_certificate_no": "string",
                "real_estate_address": "string",
                "lease_start_date": "string",
                "lease_end_date": "string",
                "cross_city_flag": "Y"
            }
        ],
        "vehicle_vessel_tax_collection": {
            "insurance_policy_no": "string",
            "vehicle_plate_or_vessel_registration_no": "string",
            "tax_period": "string",
            "vehicle_identification_no": "string",
            "vehicle_vessel_tax_amount": 0,
            "late_fee": 0,
            "total_amount": 0
        },
        "toll_fee_detail_list": [
            {
                "sequence_no": 0,
                "vehicle_plate_no": "string",
                "vehicle_type_code": "strin",
                "vehicle_type_name": "string",
                "toll_start_date": "string",
                "toll_end_date": "string",
                "amount": 0,
                "tax_rate": 0,
                "tax_amount": 0,
                "name": "string"
            }
        ],
        "passenger_transport_service_detail_list": [
            {
                "sequence_no": 0,
                "passenger_name": "string",
                "passenger_id_type_code": "100",
                "passenger_id_no": "string",
                "travel_date": "string",
                "seat_class": "string",
                "transport_type_code": "s",
                "start_place": "string",
                "end_place": "string"
            }
        ],
        "medical_service_inpatient_elements": {
            "medical_business_serial_no": "string",
            "patient_name": "string",
            "patient_id_type_code": "100",
            "patient_id_no": "string",
            "medical_record_no": "string",
            "inpatient_no": "string",
            "inpatient_department": "string",
            "admission_date": "string",
            "discharge_date": "string",
            "prepaid_amount": 0,
            "supplementary_payment": 0,
            "refund_amount": 0,
            "medical_institution_type_code": "A",
            "other_medical_institution_type": "string",
            "health_insurance_type_code": "st",
            "other_health_insurance_type": "string",
            "health_insurance_no": "string",
            "gender_code": "s",
            "insurance_pooling_fund_payment": 0,
            "other_payment": 0,
            "personal_account_payment": 0,
            "personal_cash_payment": 0,
            "personal_payment": 0,
            "personal_self_payment": 0,
            "payer_name": "string",
            "custom_element_count": 0,
            "custom_elements_json": {},
            "payee_unit": "string"
        },
        "medical_service_inpatient_item_list": [
            {
                "inpatient_invoice_detail_no": 0,
                "amount": 0,
                "tax_rate": 0,
                "tax_amount": 0,
                "remark": "string",
                "name": "string"
            }
        ],
        "medical_service_inpatient_charge_list": [
            {
                "inpatient_charge_detail_no": 0,
                "inpatient_invoice_detail_no": 0,
                "charge_item_detail": "string",
                "quantity": "string",
                "unit": "string",
                "amount": 0,
                "tax_amount": 0,
                "tax_rate": 0,
                "medical_service_standard_code": "string",
                "remark": "string"
            }
        ],
        "medical_service_outpatient_elements": {
            "medical_business_serial_no": "string",
            "patient_name": "string",
            "patient_id_type_code": "100",
            "patient_id_no": "string",
            "outpatient_no": "string",
            "visit_date": "string",
            "medical_institution_type_code": "A",
            "other_medical_institution_type": "string",
            "health_insurance_type_code": "st",
            "other_health_insurance_type": "string",
            "health_insurance_no": "string",
            "gender_code": "s",
            "insurance_pooling_fund_payment": 0,
            "other_payment": 0,
            "personal_account_payment": 0,
            "personal_cash_payment": 0,
            "personal_payment": 0,
            "personal_self_payment": 0,
            "custom_element_count": 0,
            "custom_elements_json": {}
        },
        "medical_service_outpatient_item_list": [
            {
                "sequence_no": 0,
                "charge_item_detail": "string",
                "unit": "string",
                "quantity": "string",
                "amount": 0,
                "tax_rate": 0,
                "tax_amount": 0,
                "remark": "string",
                "medical_service_standard_code": "string",
                "name": "string"
            }
        ],
        "tractor_harvester_elements": {
            "engine_no": "string",
            "chassis_certificate_no": "string"
        },
        "used_vehicle_elements": {
            "used_vehicle_invoice_no": "string",
            "used_vehicle_paper_invoice_no": "string",
            "used_vehicle_paper_invoice_code": "string"
        },
        "items": [
            {
                "sequence_no": 0,
                "item_short_name": "string",
                "goods_or_service_name": "string",
                "tax_classification_code": "string",
                "unit": "string",
                "quantity": "string",
                "unit_price": "string",
                "tax_rate": 0,
                "zero_tax_rate_flag": "",
                "tax_amount": 0,
                "amount": 0,
                "deduction_amount": 0,
                "product_barcode": "string",
                "name": "string",
                "specification": "string"
            }
        ],
        "total_verification_count": 0,
        "last_verification_time": "string"
    }
}
修改于 2026-09-24 08:06:38
上一页
查询乐企申请结果
下一页
发票类型
Built with