代扣代缴完税凭证采集

接口描述

该接口用于同步采集采集企业电子发票服务平台（发票云）代扣代缴完税凭证。最多可采集填发日期在2017年01月01日至当前日期的所有未勾选代扣代缴完税凭证（包含所有抵扣未勾选代扣代缴完税凭证）和当前税款所属期的所有已勾选代扣代缴完税凭证（包含当期抵扣已勾选代扣代缴完税凭证），也可单采限定时间范围内（2017年01月01日至当前日期的任意时间段）的未勾选代扣代缴完税凭证和当前税款所属期的已勾选代扣代缴完税凭证。

📌

注意：目前仅支持分页采集，分页大小仅支持与税局页面分页一致的数据！

错误码

错误代码	错误消息	解决方案
600004	未开通权限，请联系管理员！	与运营沟通申请开通对应权限
505002	接口调用异常，请联系管理员!	请联系管理员
FprzNotSupportDq	暂不支持该地区进行发票云认证！
FprzParameterVerification	传入参数不能为空！传入的参数-企业纳税人识别号nsrsbh不能为空！不支持的勾选状态gxzt 错误的开票日期起止不支持的发票类型fplx 不支持的发票状态fpzt 传入的参数-采集类型cjlx不能为空不支持的采集类型cjlx 传入的参数-同步采集任务分页信息不能为空！传入的参数-同步采集任务分页大小只能为10/20/50/100！指定的采集类型与勾选状态不匹配，未勾选发票采集勾选状态不可为已勾选！指定的采集类型与勾选状态不匹配，当期已勾选发票采集勾选状态不可为未勾选！指定的采集类型与勾选状态不匹配，未勾选海关缴款书采集勾选状态不可为已勾选！指定的采集类型与勾选状态不匹配，当期已勾选海关缴款书采集勾选状态不可为未勾选！指定的采集类型与勾选状态不匹配，未勾选代扣代缴完税凭证采集勾选状态不可为已勾选！指定的采集类型与勾选状态不匹配，当期已勾选代扣代缴完税凭证采集勾选状态不可为未勾选！	请检查参数是否不为空请检查参数nsrsbh是否不为空请检查参数gxzt是否正确请检查开票日期起kprqq是否小于开票日期止kprqz 请检查参数fplx是否正确请检查参数fpzt是否正确请检查参数cjlx是否不为空请检查参数cjlx是否正确请检查分页信息是否为空请检查分页大小是否正确请检查采集类型cjlx与勾选状态gxzt是否匹配
FprzBusinessVerification	税款所属期为空，请先申请获取税款所属期！	请先申请获取税款所属期！
FprzExceededCallCountLimit	超过当天可申请次数，请次日发起申请！	请检查任务发起次数，保持合理频率！
FprzServerError	申请代扣代缴完税凭证采集操作发生异常，请联系管理员	认证服务出错，请联系管理员
FprzSyncToAsync	业务处理超时,本次请求已自动转为异步方式，可通过taskId查询异步结果	可以使用任务转异步返回的参数通过转异步请求结果查询接口查询任务转异步后执行结果。

请求参数

Header 参数

access_token

string

必需

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

示例值:

req_date

string

必需

当前时间转为的毫秒数

示例值:

req_sign

string

签名算法得到的签名

必需

示例值:

Body 参数application/json

nsrsbh

string

纳税人识别号

必需

cjlx

enum<string>

采集类型

必需

单次请求仅允许单个采集类型。例如：11（抵扣未勾选代扣代缴完税凭证）
11-抵扣未勾选代扣代缴完税凭证
12-当期抵扣已勾选代扣代缴完税凭证
13-当期不抵扣已勾选代扣代缴完税凭证
如同时传入gxzt，则指定的采集类型cjlx必须与勾选状态gxzt匹配，即未勾选代缴完税凭证采集gxzt必须等于0，已勾选代缴完税凭证采集gxzt必须等于1。

枚举值:

111213

示例值:

pageSize

enum<string>

分页大小

必需

对应税局分页大小，仅支持与税局一致的分页大小值。10、20、50、100

枚举值:

102050100

示例值:

100

pageNumber

string

当前页

必需

对应税局数据分页页码

gxzt

enum<string> | enum<null>

勾选状态

可选

不填默认采集未勾选和已勾选的发票，如填写只可填一个。0未勾选，1已勾选；

枚举值:

示例值:

tfrqq

string <yyyyMMdd> | null

填发日期起

可选

不填写默认为20170701

示例值:

20230701

tfrqz

string <yyyyMMdd> | null

填发日期止

可选

不填写默认为当前日期

示例值:

20230731

accountId

string | null

登录账户唯一标识

可选

多账号时必传

customReqId

string | null

用户标识ID

可选

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

示例

{
  "nsrsbh": "91**************2G",
  "gxzt": "1",
  "tfrqq": "20240101",
  "tfrqz": "20240620",
  "cjlx": "8",
  "pageSize": 100,
  "pageNumber": 1
}

返回响应

🟢200成功

application/json

Body

reqId

string

请求id

必需

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

code

string | null

错误码

必需

错误码

success

boolean

是否成功标记

必需

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

message

string | null

错误信息

必需

data

object | null

业务数据

可选

list

array [object {19}] | null

代扣代缴完税凭证列表

可选

enum<string>

任务状态

必需

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

枚举值:

code

string

错误码

必需

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

message

string

错误信息

必需

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

示例

{
  "reqId": "b97f370cdc5a49278afc62dbbbdebbdf",
  "code": "2000",
  "success": true,
  "message": null,
  "data": {
    "code": "FprzTaxLoginFailed",
    "customReqId": "10001999c0d2e83a4c20457699ffd9cd860b5475",
    "list": null,
    "message": "【登录身份为： 办税员】+【用户名或手机号为：13264424170】在电子税务局不存在，请检查【登录身份】或【用户名或手机号】是否维护正确！",
    "page": null,
    "zt": "2"
  }
}

🟢200任务转异步

代扣代缴完税凭证采集

接口描述#

错误码#

请求参数

返回响应

接口描述

错误码