资源工坊

导入假勤审批记录 ​

用于将三方系统（如企业自有OA）审批结果数据回写到轻打卡应用中，进行假勤数据的同步。避免在三方审批系统中请假后，轻打卡应用中无请假信息而导致考勤异常的问题

请求说明 ​

请求地址配置域名+/o/woa/api/v1/attendance/developer/approval_records/import
请求方法POST
签名方式wps-4
支持应用类型企业自建应用、第三方企业应用
权限要求管理假勤审批记录(kso.attendance_approval_record.write)

请求头 ​

Header名称是否必填说明
Content-Type是目前固定为："application/json"
Wps-Docs-Date是取当前时间, 示例: Wed, 23 Jan 2013 06:43:08 GMT
Wps-Docs-Authorization是计算方法参考签名说明
Authorization是access_token(企业授权获取的token)

请求地址示例 ​

http
[POST] 配置域名+/o/woa/api/v1/attendance/developer/approval_records/import

请求体（Body） ​

名称类型说明
user_idstring发起者ID
approval_sourcestring审批来源，由使用方自定义，审批ID+审批来源标识一条数据
approval_idstring审批ID，同一个审批来源，使用方需要保证审批ID唯一
approval_typestring审批类型，leave：请假
start_timestring开始时间。支持以下格式：2024-04-08、2024-04-08 AM、2024-04-08 PM、2024-04-08 12:43
end_timestring结束时间。支持以下格式：2024-04-08、2024-04-08 AM、2024-04-08 PM、2024-04-08 12:43
duration_unitstring时长单位，day：天，half_day：半天，hour：小时
calculation_methodstring时间计算方式，natural：按自然日计算，workday：按工作日计算
approval_sub_typestring审批子类型，当 approval_type=leave 时，必传。annual：年假，personal：事假，sick：病假，maternity：产假，paternity：陪产假，wedding：婚假，bereavement：丧假，lactation：哺乳假，compensatory：调休假
redirect_urlstring审批单跳转地址。例如：https://www.kimxz.com/

请求体示例 ​

json
{
  "approval_id": "102347193",
  "approval_source": "custom",
  "approval_sub_type": "annual",
  "approval_type": "leave",
  "calculation_method": "workday",
  "duration_unit": "hour",
  "start_time": "2024-04-10",
  "end_time": "2024-04-11",
  "redirect_url": "https://www.kimxz.com/",
  "user_id": "123"
}

响应体 ​

名称类型说明
resultinteger状态码，非 0 表示失败，参照《状态码说明》
dataobject数据
 ∟ durationstring总时长，该字段的单位与传参的一致
 ∟ detailsarray详细信息
  ∟ durationstring每天的总时长，该字段的单位与传参的一致
  ∟ datestring日期，格式：2024-04-08

响应体示例 ​

json
{
  "data": {
    "details": [
      {
        "date": "2024-04-10",
        "duration": "6.48"
      }
    ],
    "duration": "6.48"
  },
  "result": 0
}