首页
学习
活动
专区
圈层
工具
发布
社区首页 >专栏 >发票勾选认证-进项发票勾选认证-进项发票认证-发票认证API接口介绍

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

原创
作者头像
聚美智数
发布2026-08-04 17:17:59
发布2026-08-04 17:17:59
1760
举报

前言

发票认证是指企业在购进用于生产或销售的商品或原材料等时,如需要进行进项税抵扣,可将收到的增值税发票通过税局系统进行识别、确认、勾选认证。

发票认证支持免插盘、多税号、集中认证。支持定时获取企业进项发票信息和认证状态,进行批量勾选、统计和确认操作,从而完成发票认证过程。

API介绍

进项发票勾选任务

请求说明

名称

类型

必须

说明

nsrsbh

String

企业纳税人识别号

skssq

String

税款所属期,格式 yyyyMM,必填,退税勾选及撤销退税勾选时,传当前月份

gxlx

String

勾选类型,1:抵扣,2:退税,3:代办退税,4:不抵扣,5:逾期,6:撤销抵扣,7:撤销不抵扣,8:撤销逾期,9:勾选抵扣(出口转内销),10:勾选不抵扣(出口转内销),11:撤销抵扣(出口转内销),12:勾选类型代码撤销不抵扣(出口转内销),13:撤销退税

bdkyy

Integer

不抵扣原因 ,当gxlx=4时不为空,即勾选不抵扣时必填,1:用于非应税项目,2:用于免税项目,3:用于集体福利或者个人消费,4:非正常损失的,5:其他

bdkyyms

String

不抵扣原因描述, 当gxlx=4并且bdkyy=5时必填

list

String

勾选发票列表,数组的JSON字符串,例:[{“fpdm”: “3300222133”,”fphm”: “36762501”,”qdfphm”: “”,”zmbh”: “”}],详见勾选发票列表

勾选发票列表

名称

类型

必须

说明

fpdm

String

发票代码,增值税发票、全电纸质发票必填

fphm

Integer

发票号码,增值税发票、全电纸质发票必填

qdfphm

Integer

全电发票号码(20位),为全电电子发票时必填,全电纸质发票可为空

yxse

Integer

有效税额,不填默认税额

zmbh

Integer

出口转内销证明编号,出口转内销发票必填

返回样例

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

进项发票勾选结果查询

请求参数

名称

类型

必须

说明

nsrsbh

String

企业纳税人识别号

reqId

String

申请勾选 id,申请接口返回值

返回样例

代码语言:javascript
复制
{
  "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时必传
      }
    ]
  }
}

发票类型

类型

类型描述

01

增值税专用发票

03

机动车销售统一发票

04

增值税普通发票

08

增值税电子专用发票

10

增值税电子普通发票

17

海关缴款书

61

全电发票(航空运输电子客票行程单)

83

全电发票(铁路电子客票)

81

全电发票(增值税专用发票)

82

全电发票(增值税普通发票)

85

全电纸质发票(增值税专用发票)

86

全电纸质发票(增值税普通发票)

87

机动车销售电子统一发票

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

申请勾选的处理结果

类型

类型描述

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

撤销退税

原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。

如有侵权,请联系 cloudcommunity@tencent.com 删除。

目录
  • 前言
  • API介绍
    • 进项发票勾选任务
      • 请求说明
      • 返回样例
    • 进项发票勾选结果查询
      • 请求参数
      • 返回样例
    • 发票类型
    • 申请勾选的处理结果
    • 勾选类型
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档