申请红字发票采集

接口描述

该接口用于发起企业电子发票服务平台（发票云）红字发票采集任务。

错误码

错误代码	错误消息	解决方案
600004	未开通权限，请联系管理员！	与运营沟通申请开通对应权限
505002	接口调用异常，请联系管理员!	请联系管理员
FprzNotSupportDq	暂不支持该地区进行发票云认证！
FprzParameterVerification	传入参数不能为空！传入的参数-企业纳税人识别号nsrsbh不能为空！不支持的勾选状态gxzt 错误的填发日期起止	请检查参数是否不为空请检查参数nsrsbh是否不为空请检查参数gxzt是否正确请检查填发日期起tfrqq是否小于填发日期止tfrqz
FprzBusinessVerification	税款所属期为空，请先申请获取税款所属期！	请先申请获取税款所属期！
FprzExceededCallCountLimit	超过当天可申请次数，请次日发起申请！	请检查任务发起次数，保持合理频率！
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

纳税人识别号

必需

kprqq

string <yyyyMMdd> | null

开票日期起

可选

示例值:

20230601

kprqz

string <yyyyMMdd> | null

开票日期止

可选

示例值:

20230731

accountId

string | null

登录账户唯一标识

可选

多账号时必传

customReqId

string | null

用户标识ID

可选

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

示例

{
  "nsrsbh": "52**************XJ",
  "kprqq": "20210901",
  "kprqz": "20230331"
}

返回响应

🟢200成功

application/json

Body

reqId

string

请求id

必需

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

code

string | null

错误码

必需

错误码

success

boolean

是否成功标记

必需

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

message

string | null

错误信息

必需

data

string | null

申请红字采集任务Id

可选

示例

{
  "code": "2000",
  "data": 468422340284480,
  "success": true,
  "reqId": "2bc23cbec88d41afb9176d431c0b1b96"
}

申请红字发票采集

接口描述#

错误码#

请求参数

返回响应

接口描述

错误码