Actions5
Overview
The "TANSS Mitarbeiter" node manages employee data through the TANSS API. It supports creating, retrieving, updating employees, listing technicians, and fetching availability information. This node is useful for automating HR workflows, synchronizing employee records, or integrating employee management into broader business processes.
For example, you can use this node to:
- Automatically add new employees to the TANSS system when they join your company.
- Retrieve detailed employee information for reporting or verification.
- Update employee details such as role or contact info.
- List all technicians for dispatch or scheduling purposes.
- Check an employee's availability for planning tasks or appointments.
Properties
| Name | Meaning |
|---|---|
| API Token | API token from TANSS authentication used to authorize requests. |
| Mitarbeiterfelder (Employee Fields) | Collection of employee attributes to set when creating or updating an employee: - 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): Whether the employee is active |
| Mitarbeiter-ID (Employee ID) | Numeric ID of the employee; required for operations that target a specific employee (retrieval, update, availability). |
| Operation | The action to perform: - Mitarbeiter erstellen (Create Employee) - Mitarbeiter abrufen (Get Employee) - Techniker auflisten (List Technicians) - Mitarbeiter aktualisieren (Update Employee) - Verfügbarkeit abrufen (Get Availability) |
Output
The node outputs JSON data corresponding to the response from the TANSS API for each operation:
- Create Employee: Returns the created employee object with assigned IDs and fields.
- Get Employee: Returns detailed information about the specified employee.
- List Technicians: Returns an array of technician employee objects.
- Update Employee: Returns the updated employee object reflecting changes.
- Get Availability: Returns availability data related to the specified employee.
No binary data output 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 obtained from the node credentials.
- Network access to the TANSS API endpoint is necessary.
Troubleshooting
- Missing Credentials: If no API token credential is provided, the node throws an error "Keine Anmeldedaten gefunden!" (No login data found!). Ensure the API token is configured correctly.
- Empty Fields on Create/Update: When creating or updating an employee, if no employee fields are provided, the node throws an error indicating missing fields. Always specify at least one field to create or update.
- Invalid Operation: If an unsupported operation is selected, the node throws an error stating 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 input parameters.
Links and References
- TANSS API Documentation (Replace with actual URL if available)
- n8n Documentation on Creating Custom Nodes