代扣代缴完税凭证采集

接口描述

该接口用于同步采集采集企业电子发票服务平台（发票云）代扣代缴完税凭证。最多可采集填发日期在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

签名算法得到的签名

必需

示例值:

Content-Type

string

可选

默认值:

application/json

Body 参数application/json

object {0}

示例

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

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

object {0}

示例

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

🟢200任务转异步

接口描述#

错误码#

请求参数

示例代码

返回响应

接口描述

错误码