进项发票勾选

接口描述

该接口用于同步企业电子发票服务平台（发票云）进项发票勾选。目前支持抵扣勾选、撤销抵扣勾选、不抵扣勾选、撤销不抵扣勾选、退税勾选、撤销退税勾选。

错误码

错误代码	错误消息	解决方案
600004	未开通权限，请联系管理员！	与运营沟通申请开通对应权限
505002	接口调用异常，请联系管理员!	请联系管理员
FprzNotSupportDq	暂不支持该地区进行发票云认证！
50008	参数不能为空	请检查入参是否不为空
50001	传入参数不能为空！	请检查入参是否不为空
50002	传入的参数-企业纳税人识别号nsrsbh不能为空！	请检查入参里的纳税人识别号nsrsbh是否为空
50003	传入的参数-税款所属期skssq不能为空！	请检查入参里的skssq是否为空
50004	传入的参数-勾选类型gxlx不能为空！	请检查入参里的gxlx是否为空
50005	传入参数中的list数据不能为空	请检查入参里的list是否为空
50006	参数list中，发票代码fpdm、发票号码fphm、全电发票号码qdfphm不能同时为空	请检查入参里的发票代码fpdm、发票号码fphm、全电发票号码qdfphm是否都为空
FprzNsrsbhIsNull	纳税人识别号为空	请检查入参里的纳税人识别号nsrsbh是否为空
FprzNsrsbhNotExist	纳税人识别号不存在	请检查入参里的纳税人识别号nsrsbh是否正确
FprzSbxxIsNull	企业申报信息为空	请先获取税款所属期
FprzSkssqIsAtypism	税款所属期不一致	请重新获取税款所属期确认后重新勾选
5000	通过发票代码or缴款书号码or转内销编号无法识别发票类型，请确认数据真实有效！	请检查发票信息是否正确
FprzUnsupportFplx	目前暂不支持发票类型为" +发票类型值 + 发票代码为fpdm 发票号码为fphm的发票勾选！	请确认当前发票类型是否支持勾选认证
50009	增值税专用发票申请认证失败，请联系管理员!	请联系管理员
50009	全电专用发票申请认证失败，请联系管理员!	请联系管理员
50009	机动车销售统一发票申请认证失败，请联系管理员!	请联系管理员
50009	出口转内销发票申请认证失败，请联系管理员!	请联系管理员
8600	当前发票勾选操作发生异常，请联系管理员	请联系管理员
4100	当前勾选类型不支持	请检查入参中的gxlx勾选类型是否在支持的范围内
50013	当前请求参数中不抵扣原因不能为空！	不抵扣勾选需要选择不抵扣原因
50014	不支持当前请求参数中的不抵扣原因！	请检查选择的不抵扣原因是否在支持的范围内
50015	当不抵扣原因选择-其他时，不抵扣原因描述不能为空！	请检查不抵扣原因描述是否不为空
8600	当前发票勾选操作发生异常，请联系管理员	请联系管理员
FprzSyncToAsync	业务处理超时,本次请求已自动转为异步方式，可通过taskId查询异步结果	可以使用任务转异步返回的参数通过转异步请求结果查询接口查询任务转异步后执行结果。

请求参数

Header 参数

access_token

string

必需

通过调用access_token接口返回的access_token值

示例值:

req_date

string

必需

当前时间转为的毫秒数

示例值:

req_sign

string

签名算法得到的签名

必需

示例值:

Body 参数application/json

nsrsbh

string

企业纳税人识别号

必需

skssq

string <yyyyMM>

税款所属期

必需

退税勾选及撤销退税勾选时，传当前月份

示例值:

202307

gxlx

enum<string>

勾选类型

必需

1-抵扣；2-退税；4-不抵扣；6-撤销抵扣；7-撤销不抵扣；13-撤销退税；

枚举值:

1246713

示例值:

bdkyy

enum<integer> | enum<null>

不抵扣原因

可选

当gxlx=4时不为空，即勾选不抵扣时必填

枚举值:

12345

示例值:

bdkyyms

string | null

不抵扣原因描述

可选

当gxlx=4并且bdkyy=5时必填

list

array [object {5}]

勾选发票列表

必需

fpdm、fphm、qdfphm不可同时为空。

fpdm

string | null

发票代码

可选

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

fphm

string | null

发票代码

可选

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

qdfphm

string | null

全电发票号码

可选

为数电发票（20位）时必填

yxse

integer | null

有效税额

可选

不填默认为税额

zmbh

string | null

出口转内销证明编号

可选

出口转内销发票勾选时必填

accountId

string | null

登录账户唯一标识

可选

多账号时必传

customReqId

string | null

用户标识ID

可选

传入的请求ID，用于标识一次调用，传入前先保存，需保证唯一性。生成规则：AppKey+去掉横杠的UUID，示例：100019953790cccf01c45ce1b744e14ec46384eb

示例

{
  "nsrsbh": "91**************2G",
  "skssq": "202405",
  "gxlx": "1",
  "list": [
    {
      "fpdm": "11******30",
      "fphm": "03****46",
      "qdfphm": "",
      "yxse": 26.89,
      "zmbh": ""
    }
  ]
}

返回响应

🟢200成功

application/json

Body

reqId

string

请求id

必需

由服务器端生成的唯一标识，对应每次请求。排查接口异常时，可提供该字段方便定位

code

string | null

错误码

必需

错误码

success

boolean

是否成功标记

必需

接口是否成功（是否发生业务异常）

message

string | null

错误信息

必需

data

object | null

业务数据

可选

list

array [object {22}] | null

发票列表

可选

enum<string>

任务状态

必需

2-申请处理失败；3-申请处理完成；

枚举值:

示例值:

code

string

错误码

必需

当任务状态zt=2时返回对应错误码

message

string

错误信息

必需

当任务状态zt=2时返回对应错误信息

示例

{
  "reqId": "aa9220ac0bc042f287d1f5ade7b6d513",
  "code": "2000",
  "success": true,
  "message": null,
  "data": {
    "code": null,
    "customReqId": "10001999fdcecadc3a75440f969494ecb03c38d5",
    "list": [
      {
        "bdkyy": "",
        "bdkyyms": "",
        "cljg": "1",
        "code": null,
        "fpdm": "",
        "fphm": "",
        "fplx": "81",
        "fpzt": null,
        "gfsbh": "91***************4Y",
        "glzt": "0",
        "gxlx": "1",
        "gxsj": "2024-10-22 15:49:06",
        "gxzt": "1",
        "hzsdbz": false,
        "je": 296.23,
        "kprq": "2024-06-19 13:21:42",
        "message": null,
        "ncpfpbz": false,
        "qdfphm": "24****************47",
        "se": 17.77,
        "skssq": "202409",
        "yskssq": null,
        "yxse": 17.77,
        "zmbh": null,
        "zt": "3"
      }
    ],
    "message": null,
    "zt": "3"
  }
}

🟢200任务转异步

接口描述#

错误码#

请求参数

返回响应

接口描述

错误码