在医疗报销、医保审核、财务审计等场景中，财政医疗票据（如非税收入统一票据、医疗收费票据）的真实性核验至关重要。为此，翔云推出财政类票据的财政票据核验接口，支持全国范围内的医疗发票、非税收入票据等财政票据的真伪查验。本文将全面解析该接口的技术原理、适用票据类型、关键参数、返回结构及集成方法，为开发者和企业提供高效、合规的财政票据核验方案。

一、什么是财政医疗票据？

财政医疗票据是由财政部门统一监制、医疗机构开具的合法收费凭证，常见类型包括：

医疗门诊收费票据

医疗住院收费票据

非税收入统一票据（医疗类）

行政事业性收费票据

二、财政票据核验接口技术原理

1. 接口基本信息

接口地址：https://XXX.com/verapi/verFinancial.do

请求方式：POST

数据格式：multipart/form-data

认证方式：通过 key（API密钥）和 secret（密钥）进行身份鉴权

业务类型标识：typeId = 3017（固定值，表示财政票据验真）

2. 核心必填参数

参数名类型必填说明

keyString是用户分配的OCR API Key

secretString是对应的Secret密钥

typeIdInteger是固定值 3017

invoiceCodeString是票据代码（通常8~10位）

invoiceNumberString是票据号码（通常8~10位）

billingDateString是开票日期，格式 YYYY-MM-DD

amountTaxString是票面金额（保留两位小数）

checkCodeString是校验码（通常位于票据右上角）

3. 地区性必传参数（按省份要求）

部分省市对财政票据查验有额外信息要求：

参数说明必传地区

payer交款人姓名北京、山西、辽宁、大连、吉林、宁波、安徽、福建、山东、广东、海南、四川、贵州、西藏、陕西、新疆

idNumber交款人身份证号后六位山西、辽宁、湖北、海南、重庆、四川、陕西、新疆

⚠️ 若未按地区要求传参，接口将返回 -30017（传入参数不正确）错误。

三、接口返回结果详解

查验成功后，接口返回完整的结构化票据信息，包括：

基础信息

invoiceType：发票类型（如“财政医疗票据”）

title：票据标题

salesName：收款单位（医院名称）

purchaserName：交款人（患者姓名）

administrativeDivisionName：所属行政区（如“北京市”）

金额与状态

amountTax：金额合计（数字）

amountTaxCN：金额大写（如“壹佰贰拾叁元整”）

entryTag：入账标识（0=未入账，1=已入账）

printTag：打印标识（0=未打印，1=已打印）

redTag：冲红标识（0=正常，1=已冲红）

明细信息（可选）

若请求时设置 enableDetail=1，将返回 invoiceDetails 字段，包含：

项目名称、数量、单价、金额

自负金额、分类自负金额（适用于医保结算）

规格型号、备注等

其他字段

financeSeal：财政部门印章信息

fileUrl：票据文件下载链接（如有）

checkNum：当日查验次数

结语

财政医疗票据的真伪核验是医疗、财务、审计等领域不可或缺的一环。翔云API通过标准化、高可用的财政票据核验接口，打通了与全国财政电子票据系统的数据通道，为企业和开发者提供了安全、高效、合规的自动化查验能力。