批量人员信息登记采集接口

接口描述

该接口用于个税人员信息登记采集，主要用于采集：人员基础信息、任职受雇从业信息、联系方式、投资信息等
同步接口

错误码

错误代码	错误信息	解决方案
PARAMETER_ERROR	没有找到对应的企业！
PARAMETER_ERROR	企业Id(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

必需

nsrsbh

string

企业纳税人识别号

必需

kjywrid

integer

扣缴义务人主键ID

可选

ryjcxx

array [object {56}]

List集合对象

必需

以下为数组中数据字段

string

工号

可选

string

姓名

必需

zjlx

string

证件类型

必需

zjhm

string

证件号码

必需

string

国籍地区

必需

string

性别

必需

string

学历代码

可选

（0-研究生 1-大学本科 2-大学本科以下）

csny

string

出生年月

可选

（格式yyyy-MM-dd）

ryzt

string

人员状态

必需

（1、正常 0、非正常）

rylx

string

人员类型

必需

（1、境外人员 0、境内人员）

sfcj

string

是否残疾

可选

（1、是 0不是）

sfls

string

是否烈属

可选

（1、是 0不是）

sfgl

string

是否孤老

可选

（1、是 0不是

cjzh

string

残疾证号

可选

（是否残疾是1 时残疾证号必须为32位）

lszh

string

烈属证号

可选

（是否烈属是1 时烈属证号必须填）

csgj

string

出生国家

可选

zwm

string

中文姓名

可选

lxdz

string

联系地址

可选

lhsj

string

来华时间

可选

（条件必填：证件类型不是身份证时必填）

lxdh

string

联系电话

必需

dzyx

string

电子邮箱

可选

rzqx

string

任职期限

可选

qtzjlx

string

其他证件类型

可选

qtzjhm

string

其他证件号码

可选

ljsj

string

离境时间

可选

（条件必填：证件类型不是身份证时必填）

ljdz

string

离境地址

可选

jnzw

string

境内职务

可选

jwzf

string

境外职务

可选

sssy

string

涉税事由

可选

（默认涉税事由是任职受雇，目前默认无需填写）

zfd

string

支付地址

可选

（境外的）

yzbm

string

邮政编码

可选

rzsglx

string

任职受雇类型

必需

rzsgrq

string

任职受雇日期

必需

lzrq

string

离职日期

可选

（人员状态为非正常时必传）

kcjcfybz

string

扣除减除费用标志

可选

（扣除5000，生产经营的扣除,0 不扣除 1 默认扣除）

rzndjyqx

string

任职年度就业情形

可选

string

职务

可选

jcjjdSheng

string

经常居住地省

可选

jcjjdShi

string

经常居住地市

可选

jcjjdQx

string

经常居住地区县

可选

jcjjdJd

string

经常居住地街道

可选

jcjjdXxdz

string

经常居住地详细地址

可选

lxdzSheng

string

联系地址省

可选

lxdzShi

string

联系地址地市

可选

lxdzQx

string

联系地址区县

可选

lxdzJd

string

联系地址街道

可选

lxdzXxdz

string

联系地址详细地址

可选

hjdzSheng

string

户籍地址省

可选

hjdzShi

string

户籍地址地市

可选

hjdzQx

string

户籍地址区县

可选

hjdzJd

string

户籍地址街道

可选

hjdzXxdz

string

户籍地址详细地址

可选

khyh

string

开户银行

可选

khhsf

string

开户行省份

可选

grtzbl

string

个人投资比例

可选

（0到1） (精度范围：4位。例子：0.3413,录入其中一个时，其他的必录)

grtze

string

个人投资额

可选

个人投资金额（元） (精度范围：2位。支持最大16位整数加2位小数。例子：22.34,录入其中一个时，其他的必录)

示例

{
"aggOrgId":40167xxxxx104,
"nsrsbh":"91440xxxxxxxx0",//纳税人识别号
"kjywrid":"1",//扣缴义务人ID
    "ryjcxx":[ //人员基础信息
        {
            "gh":"3", //工号
            "lxdh":"1301xxxxx0",//联系电话
            "gj":"156",//国籍代码
            "xm":"xx",//人员姓名
            "zjlx":"201",//证件类型
            "csny":"", //出生年月
            "rylx":"1",//人员类型
            "xb":"",//性别
            "zjhm":"4307xxxx36514",//证件号码
            "rzsglx":"3",//任职受雇类型
            "rzsgrq":"2024-01-01"//任职受雇日期
        },
        {
            "gh":"4",
            "lhsj":"2020-01-01",//来华时间
            "lxdh":"13923381730",
            "gj":"344",
            "zjlx":"210",
            "rylx":"1",
            "ljsj":"2022-01-01",
            "xb":"1",
            "zjhm":"Hxxx146",
            "rzsgrq":"2021-01-01",
            "xm":"柯xx",
            "csny":"1966-01-13",
            "csgj":"344",//出生国家
            "rzsglx":"0"
        },
        {
            "gh":"1",
            "lxdh":"13018xxxx30",
            "gj":"156",
            "xm":"周X",
            "zjlx":"201",
            "rylx":"1",
            "zjhm":"4306ssss8446",
            "rzsglx":"0",
            "rzsgrq":"2021-01-01"
        }
    ]
}

返回响应

🟢200成功

application/json

Body

reqId

string

请求id

必需

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

code

string | null

错误码

必需

错误码

success

boolean

是否成功标记

必需

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

message

string | null

错误信息

必需

data

object | null

数据

可选

code

string | null

错误码

可选

success

string | null

是否成功

可选

message

string

错误信息

可选

data

object

数据

可选

示例

成功示例异常示例

{
  "reqId": "9112a59b37d948ad8bd671e9db10b107",
  "code": "2000",
  "success": true,
  "message": null,
  "data": {
    "code": "SUCCESS",
    "data": {
      "sumNum": 2,
      "succeedNum": 1,
      "failNum": 1,
      "detail": [
        {
          "msg": "更新成功，没有需要更新的值！",
          "hb": "1"
        },
        {
          "msg": "第2行：身份证的校验位不正确<br>",
          "hb": "2"
        }
      ]
    },
    "success": true,
    "message": "成功!"
  }
}

批量人员信息登记采集接口

接口描述#

错误码#

请求参数

返回响应

接口描述

错误码