钉钉对接打通金蝶云星空获取通讯录接口与员工新增接口

钉钉对接打通金蝶云星空获取通讯录接口与员工新增接口

对接源平台:钉钉

钉钉（DingTalk）是阿里巴巴集团专为中国企业打造的免费沟通和协同的多端平台，提供PC版，Web版和手机版，有考勤打卡、签到、审批、日志、公告、钉盘、钉邮等强大功能。

接入系统：金蝶云星空

金蝶K/3Cloud在总结百万家客户管理最佳实践的基础上，提供了标准的管理模式；通过标准的业务架构：多会计准则、多币别、多地点、多组织、多税制应用框架等，有效支持企业的运营管理；K/3Cloud提供了标准的业务建模：35种标准ERP领域模型、1046种模型元素、21243种模型元素属性组合，288个业务服务构件，让企业及伙伴可快速构建出行业化及个性化的应用。

数据集成方案配置

通过可视化界面的拖、拉、拽即可轻松快速构建数据集成流程，将钉钉、金蝶云星空之间接口数据联通，支持数据在线预览、数据集成流程全过程调试，Web界面追踪调试日志等功能。 平台兼具实时数据处理和数据集成分发功能，用户通过可视化的拖、拽即可完成数据处理逻辑，将数据加工处理后分发到下游业务系统或其他异构存储中。

钉钉接口明细

• 接口：topapi/v2/user/get
• 接口名称：获取通讯录
• 接口方法：POST

请求参数

字段名称类型描述 userid用户的useridstring language通讯录语言string dep_strategy部门集成策略IDstring

响应参数

字段名称类型描述 userid员工的useridstring unionid唯一标识string name员工名称string avatar头像string state_code国际电话区号string manager_userid员工的直属主管string mobile手机号码string hide_mobile是否号码隐藏stringtrue：隐藏 false：不隐藏 说明 隐藏手机号后，手机号在个人资料页隐藏，但仍可对其发DING、发起钉钉免费商务电话。 telephone分机号string job_number员工工号string title职位string email员工邮箱string work_place办公地点string remark备注string login_id专属帐号登录名string exclusive_account_type专属帐号类型string专属帐号类型： sso：企业自建专属帐号 dingtalk：钉钉自建专属帐号 dept_id_list所属部门ID列表array dept_id部门IDstring order员工在部门中的排序string extension扩展属性string hired_date入职时间string入职时间，Unix时间戳，单位毫秒。 active是否激活了钉钉string real_authed是否完成了实名认证string senior是否为企业的高管string admin是否为企业的管理员string boss是否为企业的老板string leader_in_dept员工在对应的部门中是否领导array leader_in_dept.dept_id部门string leader_in_dept.leader是否是领导string leader_in_dept.role_list角色列表array leader_in_dept.role_list.id角色IDstring leader_in_dept.role_list.name角色名称string leader_in_dept.role_list.group_name角色组名称string

金蝶云星空接口明细

• API：batchSave
• NAME：员工新增
• METHOD：POST

请求参数

接口字段字段名称预设值描述 FName名称{{name}} FNumber编码{{unionid}} FUseOrgId使用组织2.01 FCreateOrgId创建组织2.01 FMobile手机号 FStaffNumber员工编号{{userid}} FormId业务对象表单IdBD_Empinfo必须填写金蝶的表单ID如😛UR_PurchaseOrder Operation执行的操作BatchSave IsAutoSubmitAndAudit提交并审核true IsVerifyBaseDataField验证基础资料false是否验证所有的基础资料有效性，布尔类，默认false（非必录）

系统打通概况

通过轻易云集成平台系列产品线可以协助企业轻易快捷的构建基于微服务架构的新一代企业服务总线，传统基于SOA架构的ESB产品主要解决的数据集成和协议转换等基础功能，已完全不能满足基于微服务架构、混合云集成架构、跨组织、跨单位的总线解决方案。 而轻易云集成平台的每个产品线都是新一代的按照最新的互联网架构模式进行研发的产品线，能快速协助企业从传统的SOA架构转向微服务架构的服务总线解决方案。