TANSS Mitarbeiter icon

TANSS Mitarbeiter

Verwaltet Mitarbeiter in der TANSS API
Join our community

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 want to automate HR or workforce management tasks, synchronize employee records between systems, or retrieve real-time availability of staff members.

Practical examples:

  • Automatically create new employees in TANSS when onboarding staff from another system.
  • Retrieve detailed information about a specific employee by their ID.
  • List all technicians to assign jobs or schedule tasks.
  • Update employee contact details or roles based on changes in your internal database.
  • Check an employee’s availability before scheduling appointments or shifts.

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).
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)
Mitarbeiterfelder (Employee Fields) Collection of fields for 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): Boolean indicating if the employee is active

Output

The node outputs an array of JSON objects corresponding to each input item processed. Each output item contains the raw JSON response from the TANSS API for the requested operation:

  • For "Mitarbeiter abrufen" (getEmployee), the output JSON contains detailed employee data.
  • For "Techniker auflisten" (getTechnicians), it returns a list of technician employee records.
  • For "Mitarbeiter erstellen" (createEmployee) and "Mitarbeiter aktualisieren" (updateEmployee), it returns the created or updated employee data.
  • For "Verfügbarkeit abrufen" (getAvailability), it returns availability information for the specified employee.

No binary data is produced by this node.

Dependencies

  • Requires access to the TANSS API endpoint, configured via credentials containing the base URL and an API key.
  • The user must provide a valid API token for each request, obtained through TANSS authentication.
  • Network connectivity to the TANSS backend API is necessary.

Troubleshooting

  • Missing Credentials: If no credentials are found, the node throws an error "Keine Anmeldedaten gefunden!" Ensure that the TANSS API credentials are properly configured in n8n.
  • 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." Make sure to specify at least one field in the Mitarbeiterfelder collection.
  • Invalid 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 return messages like "Fehler beim Ausführen von [Operation]: [Error message]". Verify the API token validity, network connection, and that the employee ID exists for targeted operations.
  • Employee ID Required: Operations like getEmployee, updateEmployee, and getAvailability require a valid Mitarbeiter-ID. Omitting or providing an invalid ID will cause errors.

Links and References

Discussion