投资者列表查询

接口描述

同步接口
场景说明: 该接口用于个税的投资者信息查询,支持查询验证状态，以及基础信息、任职受雇从业信息、联系方式、投资信息等

如无需获取企业人员列表信息，无需调研该接口。

错误码

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

必需

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

accountId

string

账号ID

必需

账号ID

pageNo

string

页码

必需

页码

pageSize

string

数量

必需

数量

示例

{
  "aggOrgId": "453968287232",
  "accountId": "45396287232",
  "pageNo": "1",
  "pageSize": "10"
}

返回响应

🟢200成功

application/json

Body

reqId

string

请求id

必需

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

code

string | null

错误码

必需

错误码

success

boolean

是否成功标记

必需

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

message

string | null

错误信息

必需

data

array [object {55}]

可选

string

姓名

必需

zzlx

string

证件类型

必需

zzhm

string

证件号码

必需

qtzzlx

string

其他证件类型

可选

qtzzhm

string

其他证件号码

可选

bmbh

string

部门编号

可选

rybscl

string

人员报送策略

可选

默认逻辑“是”，仅当信息变化时才会报送信息到税局

若企业想要支持人员信息不变化的情况下，也能重新发起报送，覆盖局端信息，可修改传参为“否”

string

工号

可选

skssq

string

所属期

可选

格式YYYYMM年月

lxdh

string

电话号码

必需

11位中国大陆手机号码

nsrzt

string

人员状态

必需

默认为正常，可选择正常/非正常

sfgy

string

任职受雇类型

必需

可选择雇员、保险营销员、证券经纪人、其他、实习学生（全日制学历教育）

rzndjyqk

string

入职年度就业情形

可选

当雇员、保险营销员、证券经纪人时可选择：当年首次入职学生、当年首次入职其他人员。其他情况下填写默认为空

rzsgrq

string

受雇日期

可选

格式:YYYY-MM-DD,不能大于当前时间任职受雇类型选择:雇员、保险营销员、证券经纪人、实习学生（全日制学历教育）时必录

string

性别

必需

男/女，可通过身份证号码中的第17位数字用于区分性别，奇数表示男性，偶数表示女性‌

csny

string

出生日期

必需

YYYY-MM-DD 需要和身份证上保持一致

string

国籍

必需

见国籍字典

rydq

string

人员地区

必需

境内/境外

lzrq

string

离职日期

可选

格式：YYYY-MM-DD,不能大于当前时间，离职日期不能大于入职日期
人员状态非正常时必填
注：清空离职时间传入空字符串，不能是null

grgbze

string

个人投资总额

可选

当为股东投资者时必填，投资额大于0

grgbbl

string

个人投资比例

可选

投资额填写时必填，范围为0~100，不包含0

sfcj

string

是否残疾

可选

默认为否，可选择是/否

sfls

string

是否烈属

可选

默认为否，可选择是/否

sfgl

string

是否孤老

可选

默认为否，可选择是/否

sfzdw

string

是否扣除减除费用

可选

默认为是，可选择是/否，传null或者空值都会默认为是，当填了否后, 如果后续还需要保持否的状态还需传否，不填则会默认为是

cjzjlx

string

残疾证件类型

可选

当【是否残疾】为“是”时，必填
可填项：
“残疾证”
“残疾军人证”
“伤残人民警察证”
“残疾消防救援人员证”
“伤残预备役人员、伤残民兵民工证”
“因公伤残人员证”

cjzh

string

残疾证号

可选

当为残疾时必填

lszh

string

烈属证号

可选

当为烈属时必填

dzyx

string

邮箱

可选

string

学历

可选

默认为空，
大学本科以下
大学本科
研究生

string

职务

可选

1是高层；3是普通

khyh

string

开户银行

可选

见银行字典

khyhsfmz

string

开户银行省份

可选

见开户银行省份字典

yhzh

string

银行账号

可选

如果khyh，khyhsfmz,yhzh 有一项选择填写了那么其他两项也需要填写

lxdz_sheng

string

居住省份

可选

中文，例如浙江省

lxdz_shi

string

居住城市

可选

中文，例如杭州市

lxdz_qx

string

居住区县

可选

中文，例如滨江区

lxdz_jd

string

居住街道

可选

中文，浦沿街道

lxdz

string

居住详细地址

可选

hjszd_sheng

string

户籍省份

可选

中文，例如浙江省

hjszd_shi

string

户籍城市

可选

中文，例如杭州市

hjszd_qx

string

户籍区县

可选

中文，例如滨江区

hjszd_jd

string

户籍街道

可选

中文，浦沿街道

hjszd_xxdz

string

户籍详细地址

可选

string

备注

可选

csd

string

出生地

可选

外籍人员必填，填写出生地国家（地区），见国籍字典

sssx

string

涉税事由

可选

外籍人员必填，多个时用逗号分割;
任职受雇
提供临时劳务
转让财产
从事投资和经营活动
其他

scrjsj

string

首次入境时间

可选

证件类型为港澳居民来往内地通行证、港澳居民居住证、台湾居民来往大陆通行证、台湾居民居住证、外国护照、外国人永久居留身份证、外国人来华工作许可证A、外国人来华工作许可证B、外国人来华工作许可证C时，且任职受雇类型选择雇员时必填，格式YYYY-MM-DD

yjljsj

string

预计离境时间

可选

wjrlxdz_sheng

string

联系地省份

可选

wjrlxdz_shi

string

联系地城市

可选

wjrlxdz_qx

string

联系地区县

可选

wjrlxdz_jd

string

联系地街道

可选

wjrlxdz_xxdz

string

联系地详细地址

可选

xmzw

string

中文名

可选

证件类型为外国护照、外国人永久居留身份证、外国人工作许可证（A类）、外国人工作许可证（B类）、外国人工作许可证（C类）时不可填写，其他证件类型可填写。如果有填写必须为中文。

示例

成功示例异常示例

{
  "code": "2000",
  "success": true,
  "reqId": "1065591abf904b3d92d2d747cc561ec8",
  "data": [
    {
      "xm": "姓名",
      "zzlx": "证件类型",
      "zzhm": "证件号码",
      "qtzzlx": "其他证件类型",
      "qtzzhm": "其他证件号码",
      "bmbh": "部门编号",
      "rybscl": "人员报送策略",
      "gh": "工号",
      "skssq": "所属期",
      "lxdh": "电话号码",
      "nsrzt": "人员状态",
      "sfgy": "任职受雇类型",
      "rzndjyqk": "入职年度就业情形",
      "rzsgrq": "受雇日期",
      "xb": "性别",
      "csny": "出生日期",
      "gj": "国籍",
      "rydq": "人员地区",
      "lzrq": "离职日期",
      "grgbze": "1",
      "grgbbl": "2",
      "sfcj": "是否残疾",
      "sfls": "是否烈属",
      "sfgl": "是否孤老",
      "sfzdw": "是否扣除减除费用",
      "cjzjlx": "残疾证件类型",
      "cjzh": "残疾证号",
      "lszh": "烈属证号",
      "dzyx": "邮箱",
      "xl": "学历",
      "zw": "职务",
      "khyh": "开户银行",
      "khyhsfmz": "开户银行省份",
      "yhzh": "银行账号",
      "lxdz_sheng": "居住省份",
      "lxdz_shi": "居住城市",
      "lxdz_qx": "居住区县",
      "lxdz_jd": "居住街道",
      "lxdz": "居住详细地址",
      "hjszd_sheng": "户籍省份",
      "hjszd_shi": "户籍城市",
      "hjszd_qx": "户籍区县",
      "hjszd_jd": "户籍街道",
      "hjszd_xxdz": "户籍详细地址",
      "bz": "备注",
      "csd": "出生地",
      "sssx": "涉税事由",
      "scrjsj": "首次入境时间",
      "yjljsj": "预计离境时间",
      "wjrlxdz_sheng": "联系地省份",
      "wjrlxdz_shi": "联系地城市",
      "wjrlxdz_qx": "联系地区县",
      "wjrlxdz_jd": "联系地街道",
      "wjrlxdz_xxdz": "联系地详细地址",
      "xmzw": "中文名"
    }
  ]
}

接口描述#

错误码#

请求参数

返回响应

接口描述

错误码