电子税票号码作废

接口描述

该接口是同步接口。

如果入参传入电子税票号码，则作废用户传入的电子税票号码。

如果入参没有传电子税票号码，会查询可以作废的电子税票号码，若存在有且只有一个电子税票号码，那接口直接进行作废，若存在多个电子税票号码，那么直接返回多个电子税票号码。

若三方缴款报错返回“缴款状态未明，请作废电子税票号后重试”，可调用该接口通过作废电子税票号然后重新发起缴款的方式快速解决

错误码

错误代码	错误信息	解决方案
4003	没有找到对应的企业！
4002	aggOrgId请求参数不能为空！

请求参数

Header 参数

Content-Type

string

必需

示例值:

application/json

access_token

string

必需

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

示例值:

req_date

string

必需

当前时间转为的毫秒数

示例值:

req_sign

string

签名算法得到的签名

必需

示例值:

Body 参数application/json

aggOrgId

string

维护企业信息接口返回的 aggOrgId

必需

accountId

string

账号ID

必需

skssq

string

税款所属期

必需

税款所属期，格式：YYYYMM

dzsphm

string

电子税票号码

可选

电子税票号码

示例

{
    "aggOrgId": "535474925760832",
    "accountId": "4643350751792512",
    "skssq": "202412",
    "dzsphm": "132456"
}

返回响应

🟢200成功

application/json

Body

reqId

string

请求id

必需

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

code

string | null

错误码

必需

错误码

success

boolean

是否成功标记

必需

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

message

string | null

错误信息

必需

data

object (电子税票号码作废结果)

结果

可选

string

业务办理状态

必需

业务办理状态（1 成功 2 失败）

sbyy

string

失败原因

必需

失败原因

dzsphmlb

array[string]

电子税票号列表

必需

如果入参没有传电子税票号码，会查询可以作废的电子税票号码，若存在有且只有一个电子税票号，那接口直接进行作废，若存在多个电子税票号，那么直接返回多个电子税票号

示例

成功示例异常示例查询失败

{
    "code": "2000",
    "success": true,
    "reqId": "8afc14e4384a49b7b0e587224c746d06",
    "data": {
        "zt": "1",
        "sbyy": "",
        "dzsphmlb": [
            "12345678901234567890",
            "23456789012345678901"
        ]
    }
}

电子税票号码作废

接口描述#

错误码#

请求参数

返回响应

接口描述

错误码