在当前医疗、教育、行政事业等非税收入场景日益数字化的背景下，财政票据、医疗电子发票的真实性核验已成为企事业单位、医保机构、审计部门及财务系统的关键需求。财政票据查验API支持非税收入统一票据、医疗电子发票等财政类票据的真伪查验，对接权威数据源，实现实时、合规的真伪验证。
一、财政票据/医疗发票查验接口对财务管理的核心优势
确保票据真实有效，防范虚假报销
通过官方数据源实时核验发票代码、号码、金额、开票日期、校验码等关键字段，有效识别伪造、篡改或重复使用的财政票据，降低企业财务风险。
满足医保与审计合规要求
医疗机构、保险公司、企事业单位在处理员工医疗报销时，需确保票据来源合法、未被冲红、未重复使用。该接口返回“入账标识”“冲红状态”等字段，助力合规审计。
提升财务自动化水平
可与OCR识别接口联动：先识别票据内容，再自动调用查验接口验证真伪，实现“识别+验真”一体化流程，减少人工干预。
覆盖全国多地区财政票据查验
支持北京、山西、广东、四川等全国多数省市的财政医疗票据，并针对部分地区（如海南、陕西）强制要求传入交款人姓名与身份证后六位，适配地方政策差异。
支持批量查验与明细获取
通过 enableDetail=1 参数可获取医疗票据的项目明细（如药品、检查费用等），便于费用归集与成本分析。
二、开发者视角：产品参数与集成方式
1. 接口基本信息
接口地址：
POST https://XXX.com/verapi/verFinancial.do
票据类型标识：
typeId = 3017（固定值，代表财政票据验真）
2. 必填请求参数
参数名类型必填说明
keyString是用户OCR Key
secretString是用户OCR Secret
invoiceCodeString是发票代码（财政票据代码）
invoiceNumberString是发票号码
billingDateString是开票日期，格式 YYYY-MM-DD
amountTaxString是票面金额（含税合计）
checkCodeString是校验码（通常为6~20位数字/字母）
typeIdInteger是固定值 3017
3. 条件性必填参数（依地区而定）
payer（交款人姓名）：北京、山西、辽宁、安徽、广东等16个地区必传
idNumber（身份证后六位）：山西、湖北、海南、四川等8个地区必传
4.错误状态码示例
-30001：发票信息不一致（如金额不符）
-30002：所查发票不存在
-30003：当日查验次数超限（每张票每日最多5次）
-30021：超过一年的票据无法查验