部门同步

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

  • Method：POST

  • 数据格式：JSON

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

请求参数

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

DepartmentSynBatchVo

字段 类型 释义 是否必填
departmentInfos List 部门数据 Y
config JSONObject 配置 N

DepartmentInfoSyn

字段 类型 释义 是否必填
departmentName String 部门名称 N
departmentCode String 部门编码 N
departmentId Integer 部门ID N
ownerEmployeeNumber String 主管员工编号 N
ownerId Integer 所有者ID N
type String 部门类型 N
enabledFlag String 启用标志（Y/N） N
supervisorVo DepartmentSyn 上级部门对象 N
branchVo DepartmentSyn 所属分公司对象 N
ownerVo UserSyn 部门负责人对象（系统会根据ownerId/ownerEmployeeNumber补齐） N
departmentBindingVo DepartmentBinding 部门第三方绑定对象（未传时系统会按departmentId补齐） N
branchBindingVo BranchBinding 分公司第三方绑定对象 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

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

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

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/departments?platform=ctrip

{
    "departmentInfos": [
        {
            "departmentName": "部门名称",
            "departmentCode": "部门编码",
            "ownerEmployeeNumber": "主管员工编号",
            "type": "部门类型",
            "enabledFlag": "部门类型",
            "supervisorVo": {
                "departmentId": 100,
                "departmentName": "上级部门名称",
                "departmentCode": "PARENT001"
            },
            "branchVo": {
                "departmentId": 200,
                "departmentName": "分公司名称",
                "departmentCode": "BRANCH001"
            },
            "ownerVo": {
                "userId": 300,
                "userName": "owner",
                "employeeNumber": "E300"
            },
            "departmentBindingVo": {
                "departmentId": 10,
                "bindCode": "third-dept-10",
                "enabledFlag": "Y"
            },
            "branchBindingVo": {
                "branchId": 200,
                "bindCode": "third-branch-200",
                "code": "BRANCH001"
            }
        }
    ]
}

响应参数

字段名称 字段类型 字段描述
resCode String 状态码
resMsg String 描述
data List 同步成功后的绑定信息

data

字段名称 字段类型 字段描述
bindCode String 同步成功后的第三方绑定code
companyId Integer 公司id
departmentId Integer 部门id
lastSuccessDate Date 上次同步成功时间
updateStatus Integer 是否更新成功

响应示例

{
    "data": [
        {
            "bindCode": "561224",
            "companyId": 22154,
            "departmentId": 124840,
            "lastSuccessDate": 1734675288571,
            "platform": "dianping",
            "updateStatus": 1
        }
    ],
    "resCode": 200000,
    "resMsg": "success"
}

results matching ""

    No results matching ""