Overview
The node "Cloodo HRM" integrates with the Cloodo HRM system via its API, allowing users to interact with employee and leave data. Specifically, the Employee - GET MANY operation retrieves multiple employee records from the system. This is useful for scenarios such as listing employees in a dashboard, exporting employee data, or syncing employee information with other systems.
For example, you might use this node to:
- Fetch all active employees for reporting.
- Search employees by name or other criteria.
- Retrieve employees hired within a specific date range.
- Sort employee lists ascending or descending by a certain field.
Properties
| Name | Meaning |
|---|---|
| Page (cursor) | The pagination cursor or page token to fetch a specific page of employee results. |
| Additional Fields | A collection of optional filters and parameters: |
| - Search | Text string to search employees by keyword (e.g., name or ID). |
| - Sort | Sorting order of results; options are "desc" (descending) or "asc" (ascending). |
| - Status | Filter employees by status; options are "active" or "deactive". |
| - From Date | Start date filter to retrieve employees from this date onward (format depends on API). |
| - To Date | End date filter to retrieve employees up to this date (format depends on API). |
Output
The node outputs JSON data representing the list of employees retrieved from the Cloodo HRM API. Each item in the output corresponds to an employee record containing fields as defined by the API response (such as employee ID, name, status, hire date, etc.).
No binary data output is indicated for this operation.
Dependencies
- Requires an API key credential for authenticating with the Cloodo HRM API.
- The base URL for API requests is
https://erp-amz.cloodo.com/v4. - Proper configuration of the API credential in n8n is necessary to authorize requests.
Troubleshooting
- Empty results: Ensure that the pagination cursor (
Page) and filters are set correctly. If no employees match the filters, the result will be empty. - Authentication errors: Verify that the API key credential is valid and has sufficient permissions.
- Invalid date formats: The
From DateandTo Datefields must conform to the expected date format of the API; otherwise, the request may fail or return no data. - Rate limiting or API errors: If the API returns errors due to rate limits or server issues, retry after some time or check API status.
Links and References
- Cloodo HRM API Documentation (Assumed based on base URL, verify actual docs)
- n8n documentation on HTTP Request Node for understanding API integrations.