查询批量报送算税人员结果

接口说明

查询 declareTaxEmp 异步任务的执行结果。任务未完成时返回错误提示需稍后重试。

接口信息

项目	说明
URL	`/open/api/v1/tax/declareTaxEmp/result`
Method	POST
Content-Type	application/json
权限标识	hades:tax:declareTaxEmp

请求参数

参数名	类型	必填	说明
corpId	String	是	企业ID
taskId	String	是	任务ID（由报送接口返回的 data 值）

请求示例

{
  "corpId": "corpid",
  "taskId": "taskid"
}

返回参数

外层

参数名	类型	说明
success	Boolean	是否成功
data	Object	结果对象
errorCode	String	错误码（成功时不返回该字段）
errorMsg	String	错误信息（成功时不返回该字段）
rid	String	链路追踪ID

data

参数名	类型	说明
submitCount	Integer	提交报送人数
successCount	Integer	报送成功人数
successList	Array	报送成功人员列表
failCount	Integer	报送失败人数
failList	Array	报送失败人员列表

successList

参数名	类型	说明
empId	String	员工ID
name	String	员工花名（显示名）
idName	String	证件姓名（法定名）
taxGroupName	String	扣缴义务人名称
taxMonth	String	报税月份

failList

参数名	类型	说明
empId	String	员工ID
name	String	员工花名
idName	String	证件姓名
taxGroupName	String	扣缴义务人名称
taxMonth	String	报税月份
failReason	String	失败原因

返回示例

成功

{
  "data": {
    "submitCount": 100,
    "successCount": 95,
    "successList": [
      {
        "empId": "E001",
        "name": "张三",
        "idName": "张三",
        "taxGroupName": "北京分公司",
        "taxMonth": "2025-01"
      }
    ],
    "failCount": 5,
    "failList": [
      {
        "empId": "E002",
        "name": "李四",
        "idName": "李四",
        "taxGroupName": "北京分公司",
        "taxMonth": "2025-01",
        "failReason": "报送失败"
      }
    ]
  },
  "rid": "d2c50cb111d54253a23c97a9b7b86aaa",
  "success": true
}

失败 - 任务不存在

{
  "errorCode": "501",
  "errorMsg": "任务不存在",
  "rid": "d2c50cb111d54253a23c97a9b7b86aaa",
  "success": false
}

失败 - 任务处理中

{
  "errorCode": "502",
  "errorMsg": "任务处理中，请稍后重试",
  "rid": "d2c50cb111d54253a23c97a9b7b86aaa",
  "success": false
}

失败 - 结果已过期

{
  "errorCode": "502",
  "errorMsg": "结果已过期，请重新生成",
  "rid": "d2c50cb111d54253a23c97a9b7b86aaa",
  "success": false
}

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Header 参数

Body 参数application/json必填

示例

  {                                                                                                                                                                    
    "corpId": "ding4c7c311a701851ac35c2f4657eb6378f",                                                                                                                  
    "taskId": "task_e2d04d8d50d044b38877ab20988c9dba"                                                                                                                           
  }

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

application/json

Bodyapplication/json

示例

{"error":"invalid_token","error_description":"Not authorized.","error_uri":"https://tools.ietf.org/html/rfc6750#section-3.1","message":"Full authentication is required to access this resource"}

查询批量报送算税人员结果

接口说明#

接口信息#

请求参数#

请求示例#

返回参数#

外层#

data#

successList#

failList#

返回示例#

请求参数

请求示例代码

返回响应

接口说明

接口信息

请求参数

请求示例

返回参数

外层

data

successList

failList

返回示例