TANSS MitarbeiterInstall

Overview

This node integrates with the TANSS API to manage employee data and retrieve availability information. It supports multiple operations such as creating employees, fetching employee details, listing technicians, updating employee records, and specifically retrieving availability data for an employee.

The "Verfügbarkeit abrufen" (Get Availability) operation fetches availability data for a specified employee by their ID. This is useful in scenarios where you need to check when an employee is available, for example, to schedule tasks or appointments efficiently.

Practical examples:

• Automatically checking technician availability before assigning a service call.
• Integrating employee availability into a calendar or scheduling system.
• Fetching up-to-date availability status for workforce management dashboards.

Properties

Note: The "Mitarbeiter-ID" property is shown only for operations that require it, including "Verfügbarkeit abrufen".

Output

The node outputs JSON data returned from the TANSS API corresponding to the requested operation. For the "Verfügbarkeit abrufen" operation, the output JSON contains the availability information of the specified employee.

The exact structure depends on the TANSS API response but typically includes fields related to dates, times, and availability status.

No binary data output is produced by this node.

Example output snippet (conceptual):

{
  "employeeId": 123,
  "availability": [
    {
      "date": "2024-06-01",
      "available": true,
      "timeSlots": ["08:00-12:00", "13:00-17:00"]
    },
    ...
  ]
}

Dependencies

• Requires an active TANSS API credential with a valid base URL and API token.
• The node expects the API token to be provided as an input property.
• Network access to the TANSS backend API endpoint is necessary.
• No additional external libraries beyond n8n core dependencies are required.

Troubleshooting

• Missing Credentials: If no TANSS API credentials are found, the node throws an error "Keine Anmeldedaten gefunden!" (No login data found!). Ensure credentials are configured correctly in n8n.
• Empty Fields for Create/Update: When creating or updating an employee, if no fields are provided, the node throws errors indicating missing data. Always provide at least one field to create or update.
• Invalid Operation: If an unsupported operation is selected, the node will throw an error stating the operation is not recognized.
• API Request Failures: Errors during API calls include the operation name and the original error message. Common causes include invalid API tokens, incorrect employee IDs, or network issues.
• Employee ID Required: For operations like "Verfügbarkeit abrufen", ensure a valid employee ID is provided; otherwise, the API may return errors or empty results.

Links and References

• TANSS API Documentation (Replace with actual URL if available)
• n8n Documentation on Creating Custom Nodes
• General REST API usage in n8n: HTTP Request Node