并档查询

接口描述

该接口是异步接口。
1.同一个人员（指姓名、证件类型、证件号码、国籍（地区）相同）通过人员信息采集之后，用这个人员申报的收入数据就会绑定在这个四要素下。当人员变更证件类型、证件号码或者变更姓名，重新采集人员后，由于人员四要素不同，税局会生成一个新的人，用这个人计算个税时，会累计不到变更前人员的往期数据。
2.如果需要合并人员四要素变更前和变更后的往期数据，需要先线下去大厅对需要合并的证件做并档处理；线下大厅并档完成后，需要在客户平台中使用并档信息获取接口，通过辅档案人员获取主档案人员的并档关系。
3. 如果在局端做完并档操作后，一定要调用并档查询后再调用其它接口。
4.如无人员并档情况，无需调用该接口

错误码

错误代码	错误信息	解决方案
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

bizNo

string

外部业务编号

可选

aggOrgId

string

企业ID

必需

accountId

string

账号ID

必需

传入accountId就免传登录信息

skssq

string

税款所属期

必需

yyyyMM

bdrys

array [object {3}]

需并档的人员

必需

参考并档人员对象，限制每次最多500个人

string

姓名

必需

zzlx

string

证件类型

必需

zzhm

string

证件号码

必需

示例

{
    "aggOrgId": "4539696148287232",
    "accountId": "4539696148287232",
    "skssq": "202412",
    "bdrys": [
        {
            "xm": "姓名",
            "zzlx": "证件类型",
            "zzhm": "证件号码"
        }
    ]
}

返回响应

🟢200成功

application/json

Body

reqId

string

请求id

必需

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

code

string | null

错误码

必需

错误码

success

boolean

是否成功标记

必需

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

message

string | null

错误信息

必需

data

object

任务信息

必需

taskId

string

任务ID

必需

示例

成功示例异常示例

{
    "code": "2000",
    "success": true,
    "reqId": "1065591abf904b3d92d2d747cc561ec8",
    "data": {
        "taskId": "1000000000000001004"
    }
}

接口描述#

错误码#

请求参数

返回响应

接口描述

错误码