游乐游手机版
首页/AI教程/文章详情

进项发票勾选认证API接口介绍与发票认证流程

时间:2026-08-15 15:00
发票认证可实现免插盘、多税号集中操作,通过API接口定时抓取进项发票信息并批量勾选、统计、确认。接口包含勾选任务与结果查询,需传入纳税人识别号、税款所属期、勾选类型等参数,返回任务号及每张发票的处理状态与结果。

前言

发片认证,简单来说,就是企业在采购货物或原材料后,如需将增值税发片上的进项税额用于抵扣,就需要把收到的发片录入税务系统,完成识别、确认、勾选等流程。这个完整操作过程,就是通常所说的发片认证,也可理解为进项发片认证或进项发片勾选认证。

发片勾选认证-发片认证-进项发片勾选认证-进项发片认证API接口介绍

如今,这一认证流程已经支持免插盘、多税号管理和集中批量处理。通俗地说,就是可以定时抓取企业名下的进项发片信息及认证状态,再统一完成批量勾选、汇总统计和确认操作,从而高效完成发片勾选认证工作。

API介绍

下面结合具体接口说明,看看如何通过 API 将进项发片认证流程真正落地。

进项发片勾选任务

请求说明

先来看调用该接口时需要传入哪些请求参数。

名称类型必须说明
nsrsbhString企业纳税人识别号
skssqString税款所属期,格式 yyyyMM,必填。退税勾选及撤销退税勾选时,传当前月份
gxlxString勾选类型,1:抵扣,2:退税,3:代办退税,4:不抵扣,5:逾期,6:撤销抵扣,7:撤销不抵扣,8:撤销逾期,9:勾选抵扣(出口转内销),10:勾选不抵扣(出口转内销),11:撤销抵扣(出口转内销),12:勾选类型代码撤销不抵扣(出口转内销),13:撤销退税
bdkyyInteger不抵扣原因,当gxlx=4时不能为空,即勾选不抵扣时必须填写,1:用于非应税项目,2:用于免税项目,3:用于集体福利或者个人消费,4:非正常损失的,5:其他
bdkyymsString不抵扣原因描述,当gxlx=4并且bdkyy=5时必填
listString勾选发片列表,数组的JSON字符串,例:[{"fpdm": "3300222133","fphm": "36762501","qdfphm": "","zmbh": ""}],详见勾选发片列表

勾选发片列表

在 list 参数中,每一条发片记录的字段格式如下:

名称类型必须说明
fpdmString发片代码,增值税发片、全电纸质发片必填
fphmInteger发片号码,增值税发片、全电纸质发片必填
qdfphmInteger全电发片号码(20位),为全电电子发片时必填,全电纸质发片可为空
yxseInteger有效税额,不填则默认使用税额
zmbhInteger出口转内销证明编号,出口转内销发片必填

返回样例

当接口调用成功后,会返回一个任务号,便于后续继续查询勾选结果。以下是返回示例:

{
  "code": 200,//返回码,详见返回码说明
  "msg": "成功",//返回码对应描述
  "taskNo": "329903325198037812330158",//本次请求号
  "data": {
     "reqId": "509099847312345"//申请勾选 id,用于查询结果接口
  }
}

进项发片勾选结果查询

提交发片勾选任务后,如果想确认是否处理成功,就需要通过该查询接口获取最终结果。

请求参数

名称类型必须说明
nsrsbhString企业纳税人识别号
reqIdString申请勾选 id,申请接口返回值

返回样例

查询结果中会返回每张发片的具体处理状态和详细信息,示例如下:

{
  "msg": "成功",//返回码对应描述
  "code": 200,//返回码,详见返回码说明
  "taskNo": "724137130167701427733365",//本次请求号
  "data": {
     "list": [{
        "fphm": "36762500",//发片号码
        "qdfphm": "", //全电发片号码
        "kprq": "", // 开票日期,格式 yyyyMMdd
        "zmbh": "",//出口转内销证明编号
        "gfsbh": "91330110MA2CC1X505",//购买方纳税人识别号
        "fpdm": "3300222130",//发片代码
        "code": "FprzBusinessVerification",//
        "fplx": "01",//发片类型,具体见字段说明
        "cljg": "2",//申请勾选的处理结果,具体见字段说明
        "message": "无此票",//查询结果描述
        "zt": "2",//状态,1:申请处理中,2:申请处理失败,3:申请处理完成
        "gxsj": "", // 勾选时间,格式 yyyyMMdd
        "gxzt": "0",//勾选状态,0未勾选 1已勾选
        "gxlx": "", // 勾选类型,具体见字段说明
        "je": 113.0, // 金额
        "se": 13.0, // 税额
        "yxse": 13.0, // 有效税额
        "skssq": "", // 税款所属期,格式 yyyyMM
        "yskssq": "", // 原税款所属期,格式 yyyyMM,针对历史已认证当期变异常的发片该字段有值,值为历史认证的所属期
        "bdkyy": "",//不抵扣原因,1 用于非应税项目 2 用于免税项目 3 用于集体福利或者个人消费 4 非正常损失的 5 其他; 当gxlx=4时不为空
        "bdkyyms": ""//不抵扣原因描述,1、2、3、4 字典描述 5 其他-自定义描述;当gxlx=4并且bdkyy=5时必传
     }]
  }
}

发片类型

下面整理接口中常见的发片类型代码,方便在对接进项发片认证 API 时进行字段对照。

类型类型描述
01增值税专用发片
03机动车销售统一发片
04增值税普通发片
08增值税电子专用发片
10增值税电子普通发片
17海关缴款书
61全电发片(航空运输电子客票行程单)
83全电发片(铁路电子客票)
81全电发片(增值税专用发片)
82全电发片(增值税普通发片)
85全电纸质发片(增值税专用发片)
86全电纸质发片(增值税普通发片)
87机动车销售电子统一发片

注:24、30、80 为出口转内销发片类型,61、81、82、83、85、86 为全电发片类型。

申请勾选的处理结果

在查询结果中,cljg 字段用于表示该张发片的处理结果,具体含义如下:

类型类型描述
1成功
2无此票
3该票异常无法认证
4该票已经认证
5不在可勾选范围内,可勾选[2017-01-01 至 当前税款所属期]的发片
6该票已经申请认证
7申请认证月份已过期
8其它异常
9认证类型错误
10该票不可勾选为逾期
11有效税额异常(有效税额大于实际税额)
12当期已锁定
13该缴款书已申请核查
14税额为零不可勾选
15该票未到期
16红票不能抵扣
17发片未勾选(确认)
18取消操作不匹配
19不抵扣原因为空或异常
20该票未抵扣,无法撤销抵扣

勾选类型

最后,汇总所有发片勾选类型及对应代码,便于接口开发和业务配置时快速查阅:

类型类型描述
1抵扣
2退税
3代办退税
4不抵扣
5逾期
6撤销抵扣
7撤销不抵扣
8撤销逾期
9勾选抵扣(出口转内销)
10勾选不抵扣(出口转内销)
11撤销抵扣(出口转内销)
12勾选类型代码撤销不抵扣(出口转内销)
13撤销退税
来源:https://developer.aliyun.com/article/1752272
上一篇WorkBuddy汇总表格使用技巧与常见踩坑总结 下一篇SLS查询结果不完整怎么办?索引时间与字段排查指南
本站内容用于信息整理与展示,如有侵权或内容问题请及时联系处理。

相关推荐

补充同频道和同主题内容,方便继续浏览更多相关内容。

同类最新

继续查看同栏目最近更新的文章。

更多
CAD零基础入门教程:坐标输入、图层管理与基础绘图命令
AI教程 · 2026-09-01

CAD零基础入门教程:坐标输入、图层管理与基础绘图命令

本文面向CAD零基础学习者,系统讲解坐标输入、图层管理与基础绘图命令的核心用法。通过分步实操与常见问题排查,帮助新手建立精确绘图习惯,掌握规范出图的基础能力。

CAD从入门到项目交付:绘图、标注、图块与实战工作流
AI教程 · 2026-09-01

CAD从入门到项目交付:绘图、标注、图块与实战工作流

掌握CAD的核心在于建立“画得准、标得清、复用快、交付稳”的工作流。本文提供从环境设置、高频命令组合、标注规范、图块标准化到项目分阶段交付的完整路径,帮助初学者避免常见返工陷阱,独立完成可检查、可复用、可打印的工程图纸。

Claude Code 登录指南:个人、Teams 与企业账号区分与授权步骤
AI教程 · 2026-09-01

Claude Code 登录指南:个人、Teams 与企业账号区分与授权步骤

本文详细解析 Claude Code 登录前的账号类型区分方法,涵盖个人订阅、Teams 席位与企业 Enterprise 席位的授权路径差异。提供终端登录命令、环境变量排查及常见异常处理步骤,帮助用户快速完成正确授权并避免登录路径混淆。

Claude Code 文件修改前的权限模式配置与命令审批指南
AI教程 · 2026-09-01

Claude Code 文件修改前的权限模式配置与命令审批指南

本文详细介绍Claude Code在修改文件前的权限模式配置方法,包括defaultMode可选值、permissions allow与deny规则设置、多层级配置文件管理以及 status验证技巧,帮助开发者安全高效地使用AI编程助手。

Claude Code接入VS Code后先测扩展和终端命令
AI教程 · 2026-09-01

Claude Code接入VS Code后先测扩展和终端命令

在VS Code中接入Claude Code后,建议优先验证扩展面板与集成终端两条入口。本文提供标准检查顺序、关键命令与常见故障排查路径,帮助你快速确认环境就绪,避免后续开发受阻。