人员同步

  • 接口：/common/thirdparty/syn/users

  • Method：POST

  • 数据格式：JSON

  • 接口说明：同步人员信息到第三方平台

请求参数

字段 类型 释义 是否必填
platform String 渠道（url参数） Y
userSynBatchVo UserSynBatchVo 请求数据体（请求体） Y

UserSynBatchVo

字段 类型 释义 是否必填
userInfos List 人员数据 Y
config JSONObject 配置 N

UserSynBatchVo

字段 类型 释义 是否必填
userId Integer 用户ID N
companyId Integer 公司ID N
userName String 用户名 N
fullName String 用户的完整姓名 N
surName String 姓氏 N
givenName String 名字 N
baseCity Integer 基础城市ID N
supervisorId Integer 上级ID N
employeeNumber String 员工编号 NN
email String 电子邮件 N
gender String 性别 N
mobile String 手机号 N
nationality String 国籍 N
birthday Date 出生日期 N
inactiveDate Date 注销日期 N
enabledFlag String 启用标志 N
wechatqyName String 企业微信名 N
dingtalkName String 钉钉名 N
feishuName String 飞书名 N
resignationDate Date 离职日期 N
departmentId Integer 部门ID N
departmentName String 部门名称 N
departmentCode String 部门编码 N
costCenterId Integer 成本中心ID N
costCenterName String 成本中心名称 N
costCenterCode String 成本中心编码 N
branchId Integer 分公司ID N
branchName String 分公司名称 N
branchCode String 分公司编码 N
levelId String 职级ID N
levelName String 职级名称 N
levelCode String 职级编码 N
groupCode String 团队编码 N
groupName String 团队名称 N
departmentVo DepartmentSyn 部门对象（系统会根据departmentId/departmentCode补齐） N
costCenterVo DepartmentSyn 成本中心对象 N
branchVo DepartmentSyn 分公司对象 N
levelVo Level 职级对象 N
userBindingVo UserBinding 人员第三方绑定对象（存在历史绑定时系统值覆盖） N
supervisorVo UserSyn 上级人员对象 N
positionVos List 岗位对象列表 N
cardVos List 证件对象列表 N
baseCityVo BaseCityInfo 基础城市对象 N

DepartmentSyn

字段 类型 释义 是否必填
companyId Integer 公司ID N
id Integer ID N
language String 语言 N
createdBy Integer 创建人ID N
creationDate Date 创建时间 N
lastUpdatedBy Integer 最后更新人ID N
lastUpdateDate Date 最后更新时间 N
column1~column50 String 扩展字段 N
departmentId Integer 部门ID N
departmentName String 部门名称 N
departmentCode String 部门编码 N
supervisorId Integer 上级部门ID N
branchCompanyId Integer 所属分公司ID N
ownerId Integer 所有者ID N
type String 部门类型 N
enabledFlag String 启用标志 N
costCenterFlag String 成本中心标志 N
companyName String 公司名称 N
taxNumber String 税号 N
taxAddress String 税务地址 N
bankName String 开户行名称 N
accountNumber String 银行账号 N
phone String 电话 N
supervisorVo DepartmentSyn 上级部门对象 N
branchVo DepartmentSyn 所属分公司对象 N
ownerVo UserSyn 部门负责人对象 N
departmentBindingVo DepartmentBinding 部门第三方绑定对象 N
branchBindingVo BranchBinding 分公司第三方绑定对象 N

Level

字段 类型 释义 是否必填
companyId Integer 公司ID N
id Integer ID N
language String 语言 N
createdBy Integer 创建人ID N
creationDate Date 创建时间 N
lastUpdatedBy Integer 最后更新人ID N
lastUpdateDate Date 最后更新时间 N
levelId Integer 职级ID N
enabledFlag String 启用标志 N
level String 职级 N
description String 描述 N

UserBinding

字段 类型 释义 是否必填
companyId Integer 公司ID N
id Integer ID N
language String 语言 N
createdBy Integer 创建人ID N
creationDate Date 创建时间 N
lastUpdatedBy Integer 最后更新人ID N
lastUpdateDate Date 最后更新时间 N
platform String 第三方平台 N
userId Integer 用户ID N
bindId String 第三方绑定ID N
userNo String 第三方用户编号 N
accessToken String accessToken N
refreshToken String refreshToken N
expiresIn Date 过期时间 N
bindName String 第三方绑定名称 N
supervisorBindId String 上级第三方绑定ID N
supervisorUserNo String 上级第三方用户编号 N
corpId String 第三方企业ID N
role String 角色 N
mobile String 手机号 N
description String 描述 N
updateStatus int 更新状态 N
lastSuccessDate Date 上次同步成功时间 N
onJob String 在职状态（临时字段） N

UserSyn

字段 类型 释义 是否必填
companyId Integer 公司ID N
id Integer ID N
language String 语言 N
createdBy Integer 创建人ID N
creationDate Date 创建时间 N
lastUpdatedBy Integer 最后更新人ID N
lastUpdateDate Date 最后更新时间 N
column1~column50 String 扩展字段 N
userId Integer 用户ID N
userName String 用户名 N
fullName String 用户完整姓名 N
surName String 姓氏 N
givenName String 名字 N
emailAddress String 电子邮件 N
mobile String 手机号 N
countryCallingCode String 国际区号 N
description String 描述 N
wechat String 微信 N
qq String QQ N
inactiveDate Date 注销日期 N
userType Integer 用户类型 N
supervisorId Integer 上级ID N
gender String 性别 N
employeeNumber String 员工编号 N
baseCity Integer 基础城市ID N
birthday String 出生日期 N
nationality String 国籍 N
address String 地址 N
departmentId Integer 部门ID N
costCenterId Integer 成本中心ID N
branchId Integer 分公司ID N
positionId Integer 岗位ID N
timezone String 时区 N
levelId Integer 职级ID N
dateOfJoining Date 入职日期 N
resignationDate Date 离职日期 N
startWorkDate Date 开始工作日期 N
defaultLanguage String 默认语言 N
creditScore String 信用分 N
creditLevel String 信用等级 N
pointNalance String 积分余额 N
pointFrozen String 冻结积分 N
feishuName String 飞书名 N
wechatqyName String 企业微信名 N
dingtalkName String 钉钉名 N
dingtalkUnionid String 钉钉UnionId N
departmentVo DepartmentSyn 部门对象 N
costCenterVo DepartmentSyn 成本中心对象 N
branchVo DepartmentSyn 分公司对象 N
levelVo Level 职级对象 N
userBindingVo UserBinding 人员第三方绑定对象 N
supervisorVo UserSyn 上级人员对象 N
positionVos List 岗位对象列表 N
cardVos List 证件对象列表 N
baseCityVo BaseCityInfo 基础城市对象 N

Position

字段 类型 释义 是否必填
companyId Integer 公司ID N
id Integer ID N
language String 语言 N
createdBy Integer 创建人ID N
creationDate Date 创建时间 N
lastUpdatedBy Integer 最后更新人ID N
lastUpdateDate Date 最后更新时间 N
column1~column10 String 扩展字段 N
positionId Integer 岗位ID N
positionCode String 岗位编码 N
enabledFlag String 启用标志 N
positionName String 岗位名称 N

Card

字段 类型 释义 是否必填
companyId Integer 公司ID N
id Integer ID N
language String 语言 N
createdBy Integer 创建人ID N
creationDate Date 创建时间 N
lastUpdatedBy Integer 最后更新人ID N
lastUpdateDate Date 最后更新时间 N
userId Integer 用户ID N
cardId Integer 证件ID N
cardType Integer 证件类型 N
cardNo String 证件号码 N
timeLimit Long 有效期限 N
enabledFlag String 启用标志 N
primaryFlag String 主证件标志 N

BaseCityInfo

字段 类型 释义 是否必填
companyId Integer 公司ID N
id Integer ID N
language String 语言 N
createdBy Integer 创建人ID N
creationDate Date 创建时间 N
lastUpdatedBy Integer 最后更新人ID N
lastUpdateDate Date 最后更新时间 N
cityId Integer 城市ID N
cityName String 城市名称 N
englishName String 英文名称 N
country String 国家 N
enabledFlag String 启用标志 N
description String 描述 N
supervisorId Integer 上级ID N
cityRegion String 城市区域 N
cityClass String 城市类别 N
cityLevel Integer 城市等级 N
cityCode String 城市编码 N

DepartmentBinding

字段 类型 释义 是否必填
companyId Integer 公司ID N
id Integer ID N
language String 语言 N
createdBy Integer 创建人ID N
creationDate Date 创建时间 N
lastUpdatedBy Integer 最后更新人ID N
lastUpdateDate Date 最后更新时间 N
platform String 第三方平台 N
departmentId Integer 部门ID N
bindCode String 第三方绑定编码 N
description String 描述 N
enabledFlag String 启用标志 N
updateStatus int 更新状态 N
lastSuccessDate Date 上次同步成功时间 N

BranchBinding

字段 类型 释义 是否必填
companyId Integer 公司ID N
id Integer ID N
language String 语言 N
createdBy Integer 创建人ID N
creationDate Date 创建时间 N
lastUpdatedBy Integer 最后更新人ID N
lastUpdateDate Date 最后更新时间 N
platform String 第三方平台 N
branchId Integer 分公司ID N
bindCode String 第三方绑定编码 N
description String 描述 N
enabledFlag String 启用标志 N
updateStatus int 更新状态 N
code String 分公司编码 N 
/common/thirdparty/syn/users?platform=ctrip

{
    "userInfos": [
        {
            "userId": 111,
            "companyId": 123,
            "userName": "john_doe",
            "fullName": "John Doe",
            "surName": "Doe",
            "givenName": "John",
            "baseCity": 101,
            "supervisorId": 555,
            "employeeNumber": "E5678",
            "email": "john.doe@example.com",
            "gender": "Male",
            "mobile": "+1234567890",
            "nationality": "USA",
            "birthday": "1985-08-15",
            "inactiveDate": "2024-12-31",
            "enabledFlag": "Y",
            "wechatqyName": "john_doe_wechat",
            "dingtalkName": "john_doe_dingtalk",
            "feishuName": "john_doe_feishu",
            "resignationDate": "2025-01-01",
            "departmentId": 10,
            "departmentName": "Engineering",
            "departmentCode": "ENG001",
            "costCenterId": 500,
            "costCenterName": "R&D",
            "costCenterCode": "CC100",
            "branchId": 1,
            "branchName": "New York Branch",
            "branchCode": "NY001",
            "levelId": "L2",
            "levelName": "Senior Engineer",
            "levelCode": "SE2",
            "groupCode": "G1",
            "groupName": "Tech Team",
            "departmentVo": {
                "departmentId": 10,
                "departmentName": "Engineering",
                "departmentCode": "ENG001"
            },
            "costCenterVo": {
                "departmentId": 500,
                "departmentName": "R&D",
                "departmentCode": "CC100"
            },
            "branchVo": {
                "departmentId": 1,
                "departmentName": "New York Branch",
                "departmentCode": "NY001"
            },
            "levelVo": {
                "levelId": 2,
                "level": "L2",
                "description": "Senior Engineer"
            },
            "userBindingVo": {
                "userId": 111,
                "bindId": "third-user-111",
                "userNo": "E5678",
                "bindName": "John Doe"
            },
            "supervisorVo": {
                "userId": 555,
                "userName": "manager",
                "employeeNumber": "E1001"
            },
            "positionVos": [
                {
                    "positionId": 20,
                    "positionCode": "P020",
                    "positionName": "Engineer"
                }
            ],
            "cardVos": [
                {
                    "cardId": 300,
                    "cardType": 1,
                    "cardNo": "ID123456"
                }
            ],
            "baseCityVo": {
                "cityId": 101,
                "cityName": "New York",
                "cityCode": "NYC"
            }
        }
    ]
}

响应参数

字段名称 字段类型 字段描述
resCode String 状态码
resMsg String 描述

响应示例

{
    "resCode": 200000,
    "resMsg": "success"
}

results matching ""

    No results matching ""