国内通用票据
国内发票验真
根据票种及对应查验要素,对单张国内发票执行验真。
兼容规则
- 请求体保持扁平结构,不使用批量数组或嵌套
verify_params。 type_key可省略;省略时固定按vat_electronic_invoice_new处理。fpNumber和fpDate是所有票种的公共要素,其余字段根据type_key条件必需。- 所有代码、号码、日期、金额和校验码均建议使用 JSON 字符串,避免前导零或数值精度丢失。
- 不应通过字段组合推断票种;非默认票种必须显式传入
type_key。
票种要素矩阵
| type_key | 票种 | 必需字段 |
|---|---|---|
vat_special_invoice | 增值税专用发票 | fpCode, fpNumber, fpDate, fpNoTaxAmount |
vat_electronic_special_invoice | 增值税电子专用发票 | fpCode, fpNumber, fpDate, fpNoTaxAmount |
vat_common_invoice | 增值税普通发票 | fpCode, fpNumber, fpDate, fpCRC |
vat_electronic_invoice | 增值税电子普通发票 | fpCode, fpNumber, fpDate, fpCRC |
vat_roll_invoice | 增值税发票卷票 | fpCode, fpNumber, fpDate, fpCRC |
vat_electronic_special_invoice_new | 电子发票增值税专用发票 | fpNumber, fpDate, fpAmount |
vat_electronic_invoice_new | 电子发票普通发票 | fpNumber, fpDate, fpAmount |
motor_vehicle_sale_invoice | 机动车销售统一发票 | fpCode, fpNumber, fpDate, fpNoTaxAmount |
used_car_purchase_invoice | 二手车销售统一发票 | fpCode, fpNumber, fpDate, fpAmount |
electronic_air_transport | 电子发票航空运输电子客票行程单 | fpNumber, fpDate, fpAmount |
electronic_train_ticket | 电子发票铁路电子客票 | fpNumber, fpDate, fpAmount |
结果判断
HTTP 200 且 code=success 表示请求已被接口正常处理,不等同于发票验真成功。
调用方必须读取 data.result.fpVerification 判断验真结果。
条件要素缺失、下游查验失败等情况仍可能返回 HTTP 200,并在
fpVerification 和 fpVerificationMsg 中给出业务结果。
计费元数据
attempt_verify_page_count 表示要素完整并尝试调用查验服务的票据数;本接口为单张验真,值为 0 或 1。
actual_consume_page_count 表示命中计费状态的票据数,值为 0 或 1;
实际积分消耗仍可能被功能包覆盖。
POST
授权
ADP OpenAPI 密钥。
路径参数
租户名称。该路径参数必须显式提供。
请求体
application/json
单张发票验真要素。所有示例仅用于说明请求结构,请替换为真实票面值。
- 兼容模式:省略 type_key
- 增值税专用发票
- 增值税电子专用发票
- 增值税普通发票
- 增值税电子普通发票
- 增值税发票卷票
- 电子发票增值税专用发票
- 电子发票普通发票
- 机动车销售统一发票
- 二手车销售统一发票
- 电子发票航空运输电子客票行程单
- 电子发票铁路电子客票
按发票票种选择请求模型。选择 type_key 后,接口文档仅展示该票种需要的查验字段;既有调用可选择兼容模式并省略 type_key。