所有文章

【重要提醒】26年8月个税算税接口更新通知

【重要提醒】26年1月个税算税接口更新通知

2024-11-26产品升级公告

最后更新于 2026/09/24 阅读数 625

薪酬

升级内容 1：对接薪福通，实现银企直连，一键发薪

业务场景&问题：

企业可在People系统上，直接办理银行付款操作，将工资发放到员工银行账户

解决方案：

1、在People系统内开通薪福通对接功能并配置字段映射关系

ps：非超管角色需要授权该页面权限

可从工资表结构中选择字段，配置映射关系

2、前往「薪酬-银企直联」页面发起支付

非超管用户需要授权该页面权限
支付数据生成逻辑
- 当工资单创建时，根据字段映射自动生成对应法人主体、对应发薪年月的支付数据
- 当工资单更新时，会更新未支付的数据，已支付的数据不会更新，保持与薪福通系统内数据一致
- 当工资单删除时，会删除未支付的数据，已支付的数据不会更新，保持与薪福通系统内数据一致
支持查看明细数据
点击发起支付，填写对应表单即可发起支付
发起成功后，可点击去付款，跳转到银行付款页面
- 同时若选择给资金用户发短信，短信也会收到付款页面的链接
- 状态说明

状态	说明	该状态下的可用操作
待发起	未发起支付	发起支付
发起中	发起后但未返回发起结果时	-
发起失败	发起失败	重新发起
待付款	发起成功未付款	去付款撤销
取消支付	用户在付款链接中点击取消支付按钮，取消支付后需要重新发起	重新发起
已预约支付	企业已付款，但未到预约时间，银行未把钱发放到员工账户	-
已支付	全部明细成功发放到员工账户	-
部分支付失败	部分明细发放到员工账户失败，可在明细页面查看失败的数据	重新发起（仅发起付款失败的数据）
全部支付失败	全部明细发放到员工账户失败	重新发起
已撤销	待付款时可撤销	重新发起

3、非招行基本户的企业如何使用？

客户需与招行签订代发协议，并开通一个招行内部户（可联系产品安排薪福通人员与客户沟通）
在付款时，钱款将从企业非招行基本户转入到企业招行内部户，再发放到员工账户

4、集团企业如何使用？

Moka People支持按照法人公司绑定薪福通，可实现：
- 一个Moka People租户对应一个薪福通租户（多协议），适用于集团统一采购薪福通
- 一个Moka People租户对应多个薪福通租户，适用于独立采购薪福通的子公司

	薪福通租户	付款协议
法人公司1	薪福通租户1	薪福通租户1-付款协议A
法人公司2	薪福通租户1	薪福通租户1-付款协议B
法人公司3	薪福通租户2	薪福通租户2-付款协议A

体验创新

升级内容 1：智能标签扩展多数据源

业务场景&问题：

丰富标签底层数据源，支持配置更多标签

解决方案：

增加可选数据源

可选数据源		数据源辅助定位	标签举例
员工档案-个人信息	可选字段类型：单行/多行文本、数字、日期、是非、选项字段（包含单选、多选），包含自定义字段	-	党员
员工档案-任职信息	自定义字段可选字段类型：单行/多行文本、数字、日期、是非、选项字段（包含单选、多选）预置字段也要涵盖，尤其是职位、职务、员工类型、职级、管理职级、司龄任职信息是包含：任职信息、试用期考核、离职信息、黑名单信息分组的	-	5年老员工
员工档案-履历信息	员工.学校	任意学历最高学历本科学历研究生学历博士学历	985
	员工.专业	任意专业最近专业	计算机专业
	员工.实习公司、员工.工作公司	任意公司最近公司	BAT：公司=百度、字节、腾讯
	可选字段类型：单行/多行文本、数字、日期、是非、选项字段（包含单选、多选），包含自定义字段	任意一段最近一段	管培生：毕业一年内且为校招
员工档案-招聘信息	可选字段类型：单行/多行文本、数字、日期、是非、选项字段（包含单选、多选），包含自定义字段	-	特招生
员工档案-其他信息	选择字段，单行/多行文本、数字、日期、是非、选项字段（包含单选、多选）	任意一段最近一段	高潜人员、核心骨干：人才盘点结果填报或导入后进行标记
绩效信息	之查询归档和导入的绩效结果，支持多轨的客户需要根据绩效方案的结果生成选项，满足多轨制客户诉求。如：员工.绩效结果员工.业绩结果员工.价值观结果	最近1次最近2次最近3次最近4次	连续2次绩优
其他	员工.角色	-	部门管理者：担任部门负责人
其他	员工.在职直线下级	人数角色员工类型	管福>20人

运算符说明

字段类型	运算符	匹配值
单行/多行文本	等于包含不包含	文本输入框
数字	等于大于大于等于小于小于等于介于(含边界)	数字输入框介于是用数字区间[ ]-[ ]
日期	早于或等于晚于或等于介于(含边界)	日期，年月日介于是用日期区间
是非	等于	是/否
选项字段（包含单选、多选）	包含不包含	选项，支持多选

组织人事

升级内容 1：部门层级可开启自动变更

业务场景&问题：

父级部门调整，子部门的部门层级都需要手动变更，操作成本高

解决方案：

部门层级自动化开启后，部门层级变更逻辑如下，子部门的部门层级变更也需要产生部门异动记录和操作记录（生效时间和操作时间与变更的部门信息一致）

场景	是否支持自动化	自动化逻辑	备注
部门导入（添加部门/变更部门）	否	-	导入时，部门层级V一下的成本不高，暂不支持，且除了初始化外频率不高
部门回写接口	否	-	接口需要手动指定部门层级
添加部门	是	根据上级部门进行部门层级的默认赋值联动上级部门有部门层级时，当前部门层级为上级部门的部门层级选项的下一个，若上级部门的部门层级已为最后的选项，则为空，上级部门层级为空，子部门无需变化。例如：上级部门的部门层级为【二级部门】，则添加部门时，部门层级默认赋值为【三级部门】
部门添加变更（修改上级部门或者当前部门的部门层级）	是	根据上级部门进行部门层级的默认赋值联动当前部门的部门层级，逻辑同上子部门的部门层级，按上述逻辑递归	子部门的部门层级会默认跟随父部门的部门层级变化
拖拽部门层级	是	根据上级部门进行部门层级的默认赋值联动当前部门的部门层级，逻辑同上子部门的部门层级，按上述逻辑递归	子部门的部门层级会默认跟随父部门的部门层级变化
组织架构批量调整（添加下级部门、变更部门信息、转移）	是	根据上级部门进行部门层级的默认赋值联动当前部门的部门层级，逻辑同上子部门的部门层级，按上述逻辑递归	子部门的部门层级会默认跟随父部门的部门层级变化

API

升级内容 1：编制查询接口

业务场景&问题：

客户有EHR系统，同时在使用People的招聘、绩效等业务，其中招聘需要进行招聘需求编制管控，EHR需要进行入转调离的编制控制，故需要在People完成编制信息维护，在招聘需求中校验以及EHR中校验

解决方案：

4.2 编制查询接口

【入参】

请求参数（以下内容是接口规范主要应用于鉴权，无需业务开发）：

字段	字段类型	是否必填	请求方式	说明
entCode	string	是	url中拼接param	租户编码
apiCode	string	是	url中拼接param	接口编码
sign	string	是	url中拼接param	电子签名
timestamp	long	是	url中拼接param	时间戳，单位：毫秒
nonce	string	是	url中拼接param	随机数

请求body（业务接口查询参数，需要开发）

字段	字段类型	是否必填	说明
headCountCycleDate	string	是	编制周期日期格式：YYYY-MM-DD 说明：会根据日期所属的编制周期进行查询
└department	Array	否	部门
└└departmentId	Long	否	部门ID
└└departmentNo	string	否	部门编码

【查询逻辑】

需要指定编制周期进行查询，根据入参返回对应周期的编制数据
部门可作为非必要参数，支持查询指定部门的编制情况，支持一次性查询多个部门，支持部门编码和ID，二者都有按ID查询
缺编数返回按比例计算后的结果，计划是100，允许有30%超编，则缺编返回130

【参与校验】

错误校验逻辑	错误编码	错误提示
headCountCycle是否存在	400	headCountCycle编制周期不存在
departmentId填写，判断部门是否存在	400	departmentId部门不存在
departmentId未填写，departmentNo填写，判断部门是否存在	400	departmentNo部门不存在

【出参】

字段名称	字段类型	描述	备注
code	string	返回结果的状态码
msg	string	返回结果的状态信息
data	Array	结果集
└headCountCycle	string	编制周期格式：YYYY（MM~MM）与页面展示一致
└headCountDetails	Array	编制详情
└departmentId	String	部门ID
└dutyId	String	职务ID
└positionId	String	职位ID
└employeeTypeId	string	员工类型ID
└officeAddressId	string	工作地点ID
└dutyLevelId	string	职级ID
└headCountPlan	string	计划编制数
└headCountMoka People系统l	string	在职占编数
└headCountVacancy	string	空缺编制数
└headCountProcessIn	string	在途调入数
└headCountProcessOut	string	在途调出数
└headCountLimitation	string	编制限制

升级内容 2：任职信息&履历信息查询支持数据权限过滤

业务场景&问题：

接口文档描述接口有数据权限，实际上没有

解决方案：

新增查询接口数据权限过滤逻辑，现有接口取消数据权限过滤的描述
新增的接口【员工任职信息接口（有数据权限）】、【个人履历数据接口（有数据权限）】

根据接口传入的username，查找username具备的权限，如果有超管，则返回全量数据，如果没有超管，则根据username具备的接口授权访问角色的数据范围进行返回

例如：username为zhangsan，其具备了【接口角色】，对应角色的数据范围并集（无需传入Function_id）

假勤

升级内容 1：假期账户支持适用范围配置

业务场景&问题：

对于存在员工不发假或者在其他系统使用假勤功能时，希望能控制不展示假期账户，目前仅能按整个租户控制。

解决方案：

【自助服务设置-个人功能权限-假期账户】中，可设置员工适用范围，默认为全体员工
- 若设置了适用范围，则仅适用范围内的员工可查看假期账户应用（仅移动端有）
- 注意：此处按租户进行配置，不会校验配置人的管理范围，以员工最新信息进行展示

可按任职信息（含离职信息，排除生效日期、事件类型、事件原因三个异动记录字段）、个人信息（排除家庭成员、排除附件类型字段）进行范围设置

2024-12-06产品升级公告

2024-11-12产品升级公告

评价这篇文档

有帮助

没帮助

未能解决您的问题？请联系

在线客服

本篇目录

薪酬

升级内容 1：对接薪福通，实现银企直连，一键发薪

业务场景&问题：

解决方案：

体验创新

升级内容 1：智能标签扩展多数据源

业务场景&问题：

解决方案：

组织人事

升级内容 1：部门层级可开启自动变更

业务场景&问题：

解决方案：

API

升级内容 1：编制查询接口

业务场景&问题：

解决方案：

4.2 编制查询接口

升级内容 2：任职信息&履历信息查询支持数据权限过滤

业务场景&问题：

解决方案：

假勤

升级内容 1：假期账户支持适用范围配置

业务场景&问题：

解决方案：