代扣代缴凭证勾选

接口描述

该接口用于发起企业电子发票服务平台（发票云）代扣代缴完税凭证勾选任务。

错误码

错误代码	错误消息	解决方案
600004	未开通权限，请联系管理员！	与运营沟通申请开通对应权限
505002	接口调用异常，请联系管理员!	请联系管理员
FprzNotSupportDq	暂不支持该地区进行发票云认证！
50008	参数不能为空	请检查入参是否不为空
50001	传入参数不能为空！	请检查入参是否不为空
50002	传入的参数-企业纳税人识别号nsrsbh不能为空！	请检查入参里的纳税人识别号nsrsbh是否为空
50003	传入的参数-税款所属期skssq不能为空！	请检查入参里的skssq是否为空
50004	传入的参数-勾选类型gxlx不能为空！	请检查入参里的gxlx是否为空
50005	传入参数中的list数据不能为空	请检查入参里的list是否为空
50006	参数list中，凭证号码（代扣代缴完税凭证）pzhm不能为空	请检查入参里的凭证号码（代扣代缴完税凭证）pzhm是否为空
FprzNsrsbhIsNull	纳税人识别号为空	请检查入参里的纳税人识别号nsrsbh是否为空
FprzNsrsbhNotExist	纳税人识别号不存在	请检查入参里的纳税人识别号nsrsbh是否正确
FprzSbxxIsNull	企业申报信息为空	请先获取税款所属期
FprzSkssqIsAtypism	税款所属期不一致	请重新获取税款所属期确认后重新勾选
5000	通过发票代码or缴款书号码or转内销编号无法识别发票类型，请确认数据真实有效！	请检查发票信息是否正确
FprzUnsupportFplx	目前暂不支持发票类型为" +发票类型值 + 发票代码为fpdm 发票号码为fphm的发票勾选！	请确认当前发票类型是否支持勾选认证
4100	当前勾选类型不支持	请检查入参中的gxlx勾选类型是否在支持的范围内
50013	当前请求参数中不抵扣原因不能为空！	不抵扣勾选需要选择不抵扣原因
50014	不支持当前请求参数中的不抵扣原因！	请检查选择的不抵扣原因是否在支持的范围内
50015	当不抵扣原因选择-其他时，不抵扣原因描述不能为空！	请检查不抵扣原因描述是否不为空
FprzServerError	申请代扣代缴完税凭证勾选操作发生异常，请联系管理员	认证服务出错，请联系管理员

请求参数

Header 参数

access_token

string

必需

示例值:

req_date

string

必需

示例值:

req_sign

string

必需

待签名字符串 = HTTPMethod + "" + Content-Md5 + "" + req_date + "" + access_token + "" + AppSecret

示例值:

Content-Type

string

可选

默认值:

application/json

Body 参数application/json

nsrsbh

string

企业纳税人识别号

必需

skssq

string <yyyyMM>

税款所属期

必需

gxlx

enum<string>

勾选类型

必需

1-抵扣；6-撤销抵扣；4-不抵扣；7-撤销不抵扣；

枚举值:

1647

示例值:

bdkyy

enum<integer> | enum<null>

不抵扣原因

可选

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

枚举值:

12345

示例值:

bdkyyms

string | null

不抵扣原因描述

可选

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

list

array [object {3}]

勾选代扣代缴完税凭证列表

必需

pzhm、bkjnsrsbh不可为空。

pzhm

string | null

凭证号码（代扣代缴完税凭证）

可选

tfrq

string <yyyyMMdd>

填发日期

必需

示例值:

20220711

bkjnsrsbh

string

被扣缴义务人识别号

必需

accountId

string | null

登录账户唯一标识

可选

多账号时必传

customReqId

string | null

用户标识ID

可选

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

示例

{
  "nsrsbh": "91330000255072786B",
  "skssq": "202211",
  "gxlx": "1",
  "list": [
    {
      "pzhm": "33************23",
      "tfrq": "2024-06-20",
      "bkjnsrsbh": "F3**********14"
    }
  ]
}

返回响应

🟢200成功

application/json

Body

reqId

string

请求id

必需

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

code

string | null

错误码

必需

错误码

success

boolean

是否成功标记

必需

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

message

string | null

错误信息

必需

data

string | null

业务数据

可选

{
    "reqId": "38263d26450f498cb19c51c5c0d53bb0",
    "code": "2000",
    "success": true,
    "message": null,
    "data": 475320326432832
}

代扣代缴凭证勾选

接口描述#

错误码#

请求参数

返回响应

接口描述

错误码