Lark Attendance icon

Lark Attendance

Lark Attendance Management

Actions22

Overview

The "Obtain Correction Record" operation in the Attendance Correction resource of the Lark Attendance node allows users to retrieve attendance correction records for specified employees within a given time range. This is useful for HR or administrative staff who need to audit, verify, or process attendance adjustments made by employees.

Typical use cases include:

  • Fetching attendance correction data for payroll processing.
  • Auditing employee attendance changes over a specific period.
  • Integrating attendance corrections into internal reporting systems.

For example, an HR system could use this node to pull all attendance correction records for a set of employees between two dates to reconcile attendance logs with payroll.

Properties

Name Meaning
Authentication Method of authentication to access the API: either "Tenant Token" or "OAuth2".
Employee Type Specifies the type of employee ID used in the request and response (e.g., employee number, email).
Check Time From Start datetime string to filter correction records from this point in time.
Check Time To End datetime string to filter correction records up to this point in time.
User Ids List of employee IDs to fetch correction records for. Multiple values can be added.
Custom Body JSON object allowing full customization of the request body instead of using individual parameters.
Use Custom Body Boolean flag indicating whether to send the custom JSON body instead of the standard parameters.

Output

The node outputs JSON data containing the attendance correction records matching the query criteria. The structure typically includes fields such as user ID, correction times, reasons, and statuses. The exact schema depends on the API response but generally provides detailed information about each correction record retrieved.

No binary data output is involved in this operation.

Dependencies

  • Requires valid authentication credentials, either a Tenant Token or OAuth2 token, configured in n8n.
  • Connects to the Lark Suite Open APIs endpoint at https://open.larksuite.com/open-apis.
  • Proper permissions must be granted to the API credentials to access attendance correction data.

Troubleshooting

  • Empty results: Ensure that the date range (Check Time From and Check Time To) and user IDs are correctly specified and that there are existing correction records in that range.
  • Authentication errors: Verify that the provided API credentials are valid and have the necessary scopes/permissions.
  • Invalid date format: The Check Time From and Check Time To should be in the correct datetime string format expected by the API.
  • Custom Body usage: When using the custom body option, ensure the JSON is well-formed and matches the API's expected schema; otherwise, the request may fail.

Links and References

Discussion