LEDGERS icon

LEDGERS

Interact with LEDGERS API

Overview

This node interacts with an HRMS (Human Resource Management System) API for India, specifically to retrieve employee information. The "Get Employee" operation allows users to fetch details about a specific employee by providing their unique GID (Global Identifier). This is useful in scenarios where workflows need to access or process employee data dynamically, such as automating HR processes, generating reports, or integrating employee info into other systems.

Practical examples:

  • Automatically retrieving employee details when onboarding or offboarding staff.
  • Fetching employee data to populate forms or documents.
  • Integrating employee information into payroll or attendance systems.

Properties

Name Meaning
GID The unique Global Identifier of the employee whose details you want to retrieve. This is a required string input.

Output

The node outputs JSON data containing the employee's details fetched from the HRMS API. The structure typically includes fields like employee name, ID, and other relevant attributes as returned by the API. The exact fields depend on the API response but generally represent comprehensive employee information.

No binary data output is indicated.

Dependencies

  • Requires an API key credential for authentication with the HRMS API.
  • Needs valid credentials including email, password, API key, and API URL configured in n8n.
  • The node performs an authenticated login request to obtain an API token before making further requests.
  • Uses HTTP requests to interact with the HRMS API endpoints.

Troubleshooting

  • Authentication failures: If the node returns errors related to authentication, verify that the API key, email, password, and API URL are correctly configured and valid.
  • Invalid or missing GID: Ensure the GID property is provided and corresponds to an existing employee in the system.
  • API response issues: If the API does not return expected data, check network connectivity and API service status.
  • Permission errors: Confirm that the API credentials have sufficient permissions to access employee data.

Common error messages:

  • "Authentication failed. Check your credentials." — Indicates invalid or expired credentials.
  • "Failed to login." — Could be due to incorrect login details or API endpoint issues.

Links and References

  • No direct external links provided in the source code.
  • For more information, consult the HRMS API documentation or the platform providing the API key credentials.

Discussion