Actions5
Overview
This node integrates with the TANSS API to manage employee data. It supports operations such as creating a new employee, retrieving employee details, listing all technicians, updating employee information, and fetching availability data for an employee. This node is useful in scenarios where you need to automate HR or workforce management tasks, synchronize employee records, or integrate employee availability into scheduling workflows.
Practical examples:
- Automatically create new employees in TANSS when onboarding staff.
- Retrieve detailed employee information for reporting or validation.
- List all technicians to assign jobs dynamically.
- Update employee contact or role information based on external changes.
- Fetch availability data to optimize resource allocation.
Properties
| Name | Meaning |
|---|---|
| API Token | API token from TANSS authentication used to authorize requests. |
| Mitarbeiter-ID | Employee ID; required for operations that target a specific employee (get, update, availability). Options: any valid employee numeric ID. |
Output
The node outputs JSON data corresponding to the response from the TANSS API for each executed operation. The structure depends on the operation:
- Mitarbeiter abrufen (getEmployee): JSON object with detailed employee data.
- Mitarbeiter erstellen (createEmployee): JSON object representing the newly created employee.
- Techniker auflisten (getTechnicians): JSON array of technician employee objects.
- Mitarbeiter aktualisieren (updateEmployee): JSON object with updated employee data.
- Verfügbarkeit abrufen (getAvailability): JSON object containing availability information for the specified employee.
No binary data output is produced by this node.
Dependencies
- Requires an API key credential for authenticating with the TANSS API.
- Needs the base URL of the TANSS API configured in the credentials.
- Uses HTTP requests to communicate with the TANSS backend endpoints.
Troubleshooting
- Missing Credentials: If no API credentials are provided, the node throws an error "Keine Anmeldedaten gefunden!" Ensure the API token credential is set up correctly.
- Empty Fields for Create/Update: When creating or updating an employee, if no fields are provided, the node throws errors like "Keine Felder für die Mitarbeitererstellung angegeben." or "Keine Felder zum Aktualisieren angegeben." Provide at least one field to proceed.
- Invalid Operation: If an unsupported operation is selected, the node will throw an error indicating the operation is not recognized.
- API Request Failures: Errors during API calls return messages prefixed with "Fehler beim Ausführen von [operation]:". Check network connectivity, API token validity, and endpoint correctness.
Links and References
- TANSS API Documentation (not provided here, but refer to official TANSS API docs for detailed endpoint info)
- n8n HTTP Request Node documentation for understanding request options and error handling.