技能介绍

解决发票核验的自动化痛点

在财务自动化和票据处理流程中，增值税发票的真伪与状态核验往往依赖人工登录税务平台或编写脆弱的爬虫脚本。这不仅容易因字段提取错误导致查验失败，还难以应对发票类型多样、状态码复杂以及频次限制等问题。本技能通过封装增值税发票查验平台官方 API，将复杂的票据核验逻辑转化为标准化的结构化调用，帮助开发者在业务系统中直接集成发票真伪与明细的自动校验能力。

核心能力与执行流程

技能的核心能力在于完成从参数收集到结果解析的闭环查验，主要包含以下关键步骤：

参数提取与组装：自动从用户输入或发票图片中提取 Code（发票代码）、No（发票号码）、Amount（金额）、Date（开票日期）及 VCode（校验码）。对于全电发票，支持兼容无校验码及特殊代码格式的提取逻辑。
接口调用与状态解析：组装 PermitCode（授权码）后请求查验接口，并根据返回的 StatusCode 进行精确路由。例如，1001 代表查验成功并展示完整明细，1004 代表信息不一致以提示用户核对，1002 则拦截超频请求。
结构化结果输出：查验成功后，将发票基本信息、购销双方税号、金额税额、税率以及货物明细以清晰的层级结构输出，直接供下游业务系统消费。

适用边界与工程注意事项

在实际工程集成中，需特别关注以下边界条件与安全规范：

授权码安全：PermitCode 属于敏感凭证，严禁在日志或消息中明文打印，且查验流程结束后不应本地留存。
频次与精度限制：税务端严格限制单张发票每自然日最多查验 5 次，需在业务侧做好防重处理；Amount 字段必须以数值类型传输并精确到分，避免精度丢失。
历史数据边界：开具超过 5 年的发票可能因税务系统归档而返回无记录状态，需在异常处理逻辑中予以兼容。