通用集成方案 | Moka用户中心

所有文章

通用集成方案

最后更新于 2023/07/10 阅读数 125

1 假勤管理

1.1 业务描述

假勤接口主要支持：考勤、打卡、请休假等相关业务场景 API 接口的能力支持，以下为部分业务场景的集成示例，供参考，具体参数请结合线上 API 文档进行开发工作

1.2 前置信息确认

确认 Moka People 与第三方系统唯一标识字段，目前支持：0:员工 id 1 :员工邮箱（公司邮箱）2 :员工编号 3 :钉钉侧员工 id 4 :飞书侧员工 id （user_id）5 :微信侧员工 id（明文）

1.3 具体场景实现

1 单人/多人打卡

a.场景说明

基于第三方的打卡、刷卡设备，将打卡、刷卡数据同步到 Moka People 系统的考勤记录中

b.业务流程图

c.接口调用

A.请求示例

curl --location --request POST 'https://api.mokahr.com/api-platform/hcm/oapi/v2/absence/clock/batchAdd?apiCode=35a93d6823dd8dfb49b207df3854be96&amp;entCode=6d671d5bb2fe56bfa24dd2589482e8e3&amp;nonce=iwy4bl1w&amp;timestamp=1654938519251&amp;sign=RDs7aKHpPgoiKkNZ4rpLU7dl2Az9W%2F8JfZJx%2FVb4HyOQPF7ACjrVYeMEcphBuLUv811Z9L6Ct51g6zT59mtE%2B54DZxDvrVsdI8Q8mvNQxBTWEGKvmeRjX9nvAmdPRrLStAuZ%2BVTZHHJpAygBaHslLy5AVCBN7uDdS6%2B8%2Fi0Vt%2F0%3D' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic BASE64(apiKey)' \
--data-raw '[
    {
        "uniqueIdentifierType": 0,
        "employeeUniqueIdentifier": "108893111",
        "checkTime": 1663071001  //秒
    },
    {
        "uniqueIdentifierType": 1,
        "employeeUniqueIdentifier": "moka1172944222",
        "checkTime": 1663071042
    }
]'

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

json5

B.参数说明

详见： https://people.mokahr.com/docs/api/view/v1.html#-65

C.注意事项

1.请求方式：POST
2.请求频率：1 次/秒/企业, 60 次/分钟/企业
3.此接口不会覆盖打卡数据，如果时间重复了会过滤
4.每个员工可传入多条打卡记录，系统考勤计算会自动处理

1
2
3
4

plaintext

2 添加/修改/撤销出差记录

d.场景说明

此业务场景为将第三方的审批通过的出差数据同步到 Moka People 系统的出差记录中，不会在 People 中生成审批单信息

e.业务流程图

f.接口调用

A.请求示例

curl --location --request POST 'https://api.mokahr.com/api-platform/hcm/oapi/v2/absence/business/thirdPartTripAdd?apiCode=35a93d6823dd8dfb49b207df3854be96&amp;entCode=6d671d5bb2fe56bfa24dd2589482e8e3&amp;nonce=iwy4bl1w&amp;timestamp=1654938519251&amp;sign=RDs7aKHpPgoiKkNZ4rpLU7dl2Az9W%2F8JfZJx%2FVb4HyOQPF7ACjrVYeMEcphBuLUv811Z9L6Ct51g6zT59mtE%2B54DZxDvrVsdI8Q8mvNQxBTWEGKvmeRjX9nvAmdPRrLStAuZ%2BVTZHHJpAygBaHslLy5AVCBN7uDdS6%2B8%2Fi0Vt%2F0%3D' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic BASE64(apiKey)' \
--data-raw '{
    "thirdPartApplyId": "LXGtest-sta-02-test000085",
    "uniqueIdentifierType": 0,
    "employeeUniqueIdentifier": "75710974",
    "tripReason": "2 集成环境出差数据回写测试",
    "startDate": 1662017202000,
    "endDate": 1662031602000,
    "departureCityName": "杭州市",
    "destinationCityName": "绵阳市",
    "associates": [
        75710975,
        75710976
    ],
    "recordForAssociates": 1,
    "others": "{\"DF_fcd086216a254cea824647ee946cac78\":\"test\"}",
    "startDateType": "PM",
    "endDateType": "PM",
    "hotelReserved": 1,
    "transportType": "火车",
    "costDepartmentInfo": {
        "departmentIdType": 3,
        "departmentId": "od-5999a269d60c2326cf974d1957a7386b"
    },
    "tripType": 2
}'

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28

json5

B.参数说明

详见： https://people.mokahr.com/docs/api/view/v1.html#-94

C.注意事项

1.请求方式：POST
2.请求频率：1 次/秒/企业, 60 次/分钟/企业

1
2

plaintext

分贝通

Moka考勤机配置管理

评价这篇文档

有帮助

没帮助

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

在线客服

本篇目录