申请确认签名

POST

https://api.qixiangyun.com/v2/invoice/rz/sqtjqr

发票认证数字证书认证

接口描述

该接口用于申请企业综合服务平台（综服）确认签名。

💡

注意：仅在申报期内、企业未申报时可调用此接口

错误码

错误代码	错误消息	说明
FprzYwlxIsNull	申请标识不能为空	按照文档说明传入对应的申请标识
FprzSbxxIsNull	企业申报信息为空	没有获取到企业当前的申报信息
FprzSqtjqrSjIsInvalid	当前税款所属期所在月不允许申请统计确认	例如，当前所属期为202108，那么只能在9月申请
FprzYwlxIsInvalid	无效的申请标识	按照说明传入对应的申请标识
FprzQrmmTjsjIsNull	申请确认时，抵扣统计确认密码、统计时间不能为空
FprzYjsqtjqr	已经申请统计确认，处理中	等待之前的申请处理完成

请求参数

Header 参数

access_token

string

必需

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

示例值:

req_date

string

必需

当前时间转为的毫秒数

示例值:

req_sign

string

签名算法得到的签名

必需

示例值:

Content-Type

string

可选

默认值:

application/json

Body 参数application/json

nsrsbh

string

企业纳税人识别号

必需

ywlx

string

申请标识

必需

1-申请统计； 2-撤销统计；3-申请确认；
注意：已确认状态撤销统计会回到未统计状态

qrmm

string

确认密码

必需

抵扣统计确认密码，申请确认时不为空

tjsj

string

统计时间

必需

格式 yyyyMMddHHmmss，申请确认时不为空，从申请统计结果获取

customReqId

string

用户标识ID

必需

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

示例

{
  "nsrsbh": "91****************90",
  "ywlx": "3",
  "qrmm": 123,
  "tjsj": "20230305000000"
}

返回响应

🟢200成功

application/json

Body

reqId

string

请求id

必需

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

code

string | null

错误码

必需

错误码

success

boolean

是否成功标记

必需

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

message

string | null

错误信息

必需

data

业务数据

可选

Any of

Zhfwpt-获取发票统计确认申请结果

null

nsrsbh

string

纳税人识别号

必需

skssq

string <yyyyMM>

税款所属期

必需

示例值:

202307

jgzt

enum<string>

统计确认结果状态

必需

0-未统计；1-已统计未确认；2-已确认；3-已撤销未统计；4-已统计未确认（未设置确认密码或确认密码不正确）；

枚举值:

01234

示例值:

ywlx

enum<string>

申请标识

必需

1-申请统计；2-撤销统计；3-申请确认；7-退税确认(退税)；

枚举值:

1237

示例值:

cljg

enum<string> | enum<null>

申请处理结果

可选

1-申请成功；2-已申请统计；3-已统计完成；4-已申请确认；5-已确认完成；6-税号不存在；7-不符合申请生成抵扣统计报表条件；8-未申请统计；9-统计结果或统计时间不符；10-其他异常；11-已申请撤销统计；12-已撤销统计；13-当期未锁定请撤销统计重新申请；14-确认密码为空；15-申请认证月份不匹配；16-申请确认月份不符；17-不符合提交确认申报条件；18-不符合取消确认的条件(不是已确认状态)；19-未统计，不需撤消；20-密码不正确；21-不符合统计日期范围（每月一号到申报前）；

枚举值:

123456789101112131415161718192021

示例值:

tjsj

string <yyyyMMddHHmmss>

统计时间

必需

示例值:

20230714150000

time

string <yyyy-MM-dd HH:mm:ss>

必需

示例值:

2023-07-13 15:00:00

string

申请Id

必需

jglx

enum<string> | enum<null>

机构类型

可选

01 总机构，02分机构 03 机构本身

枚举值:

010203

示例值:

enum<string>

统计确认任务状态

必需

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

枚举值:

123

示例值:

tjxx

array [object {9}] | null

统计信息

可选

fpxx

array [object {15}] | null

发票信息列表

可选

申请接口传入需要明细时会返回，非海关缴款书发票字段

cyfpxx

array [object {15}] | null

差异发票信息列表

可选

通过其他途径（例如增值税综合服务平台）勾选的发票信息，也就是总的发票信息和通过接口勾选的发票信息的差异列表，结构同发票信息列表

jxdkhz

array [object {4}] | null

增值税申报进项抵扣汇总

可选

ncptjxx

array [object {5}]

农产品加计扣除勾选统计结果

必需

tsqrjgzt

enum<string>

退税确认结果状态

必需

2-退税确认成功；5-无需要确认的发票；

枚举值:

示例值:

tszt

enum<string>

退税任务状态

必需

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

枚举值:

123

示例值:

tstjxx

array [object {3}] | null

出口退税勾选统计结果

可选

tsfpxx

array [object {12}] | null

退税发票信息

可选

示例

成功示例未到统计确认日期无法统计确认示例

{
    "reqId": "56245bcf995b405081b1f4e74be8a533",
    "code": "2000",
    "success": true,
    "message": null,
    "data": 459948965835072
}

申请撤销发票统计/确认签名

获取发票统计、确认签名和撤销申请结果

申请确认签名

接口描述#

错误码#

请求参数

返回响应

接口描述

错误码