- 起业云开放平台 API
- 快速开始
- 产品订购
- 登录业务（新）
- 发票业务
- 申报业务
- 企业税申报
- 个税申报
- 社保费申报
- 数据业务
自然人并档服务
POST
/app-api/v2/iit/mergedEmployeeArchives/query
接口描述#
1.同一个人员（指姓名、证件类型、证件号码、国籍（地区）相同）通过人员信息采集之后，用这个人员申报的收入数据就会绑定在这个四要素下。当人员变更证件类型、证件号码或者变更姓名，重新采集人员后，由于人员四要素不同，税局会生成一个新的人，用这个人计算个税时，会累计不到变更前人员的往期数据。
2.如果需要合并人员四要素变更前和变更后的往期数据，需要先线下去大厅对需要合并的证件做并档处理；线下大厅并档完成后，需要在客户平台中使用并档信息获取接口，通过辅档案人员获取主档案人员的并档关系。
3. 如果在局端做完并档操作后，一定要调用并档查询后再调用其它接口。
4.如无人员并档情况，无需调用该接口
错误码#
| 错误代码 | 错误信息 | 解决方案 |
|---|---|---|
| 4003 | 没有找到对应的企业！ | |
| 4002 | aggOrgId请求参数不能为空！ |
请求参数
Header 参数
Body 参数application/json
示例
{
"aggOrgId": "4539696148287232",
"accountId": "4539696148287232",
"skssq": "202412",
"bdrys": [
{
"xm": "姓名",
"zzlx": "证件类型",
"zzhm": "证件号码"
}
]
}请求示例代码
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location '/app-api/v2/iit/mergedEmployeeArchives/query' \
--header 'access-key;' \
--header 'secret-key;' \
--header 'Content-Type: application/json' \
--data '{
"aggOrgId": "4539696148287232",
"accountId": "4539696148287232",
"skssq": "202412",
"bdrys": [
{
"xm": "姓名",
"zzlx": "证件类型",
"zzhm": "证件号码"
}
]
}'返回响应
🟢200
application/json
Bodyapplication/json
示例
{
"code": "4002",
"success": false,
"message": "aggOrgId请求参数不能为空！",
"reqId": "c1543b641ff9488ab1f39a13fb198c6a"
}修改于 2026-09-16 07:18:30