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 create new employees in TANSS when onboarding staff from another system.
- Retrieve detailed employee information for reporting or validation purposes.
- Update employee roles or contact details based on changes in your internal database.
- List all technicians to assign jobs or schedule tasks.
- Check employee availability before planning shifts or appointments.
Properties
| Name | Meaning |
|---|---|
| API Token | API token obtained from TANSS authentication, used to authorize requests |
| Mitarbeiter-ID | Employee ID; required for operations that target a specific employee (get, update, availability) |
| Mitarbeiterfelder | Collection of employee fields to set or update, including: - 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): true/false |
Output
The node outputs JSON data representing the response from the TANSS API for each executed operation. The structure depends on the operation:
- For createEmployee and updateEmployee, the output contains the created or updated employee object with their details.
- For getEmployee, it returns the employee's full 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 output is produced by this node.
Dependencies
- Requires an active TANSS API credential with a valid API token.
- The node expects the base URL of the TANSS API to be configured in the credentials.
- Network access to the TANSS API endpoint is necessary.
Troubleshooting
- Missing Credentials Error: If no API credentials are found, the node throws "Keine Anmeldedaten gefunden!" Ensure the API token credential is properly configured.
- Empty Fields Error: 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 create or update.
- Unknown Operation Error: 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. Verify network connectivity, API token validity, and correct employee IDs.
Links and References
- TANSS API Documentation (not provided here, but recommended to consult for detailed API specs)
- n8n Documentation on Creating Custom Nodes: https://docs.n8n.io/integrations/creating-nodes/