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 technicians, updating employee information, and fetching availability data. This node is useful in scenarios where you need to automate HR or workforce management tasks, synchronize employee records between systems, or dynamically update employee roles and statuses.
Practical examples:
- Automatically add new employees from an onboarding system into TANSS.
- Retrieve detailed information about a specific employee for reporting or validation.
- Update employee contact details or role after changes in your internal system.
- List all technicians to assign jobs or check their availability.
- Fetch availability data to schedule tasks or shifts efficiently.
Properties
| Name | Meaning |
|---|---|
| API Token | API token obtained from TANSS authentication, used to authorize requests. |
| Mitarbeiter-ID | The unique ID of the employee (used for getEmployee, updateEmployee, getAvailability). |
| Mitarbeiterfelder | Collection of employee fields to create or update: - Vorname (First name) - Nachname (Last name) - E-Mail (Email address) - Telefon (Phone number) - Abteilungs-ID (Department ID) - Rolle (Role): Administrator, Techniker, Benutzer, Manager - Aktiv (Active status, boolean) |
Output
The node outputs JSON data representing the response from the TANSS API for each operation:
- For createEmployee and updateEmployee, the output contains the created or updated employee object.
- For getEmployee, it returns the employee's detailed data.
- For getTechnicians, it returns a list of technician employee objects.
- For getAvailability, it returns availability information related to the specified employee.
No binary data is produced by this node.
Dependencies
- Requires an API token credential for authenticating with the TANSS API.
- The base URL for the TANSS API is provided via credentials configuration.
- Network access to the TANSS API endpoints is necessary.
Troubleshooting
- Missing Credentials Error: If no API token credential is found, the node throws "Keine Anmeldedaten gefunden!" Ensure that the API token is correctly configured in the node credentials.
- Empty Fields on 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." Always provide at least one field to modify.
- Unknown Operation: If an unsupported operation is selected, the node throws an error indicating the operation is not recognized.
- API Request Failures: Errors during API calls include the operation name and the original error message. Check network connectivity, API token validity, and endpoint correctness.
Links and References
- TANSS API Documentation (not provided here; consult your TANSS API provider)
- n8n Documentation on Creating Custom Nodes: https://docs.n8n.io/integrations/creating-nodes/