Actions5
Overview
This node integrates with the TANSS API to manage company data and retrieve employees associated with a company. It supports operations such as creating, retrieving, updating, and deleting companies, as well as fetching employees of a specified company.
A common use case is automating company data management workflows where you need to synchronize or update company information in TANSS or extract employee lists for further processing or reporting. For example, you could automatically create new companies from a CRM system or regularly fetch employee data for HR analytics.
Specifically, the "Mitarbeiter abrufen" (Retrieve Employees) operation fetches all employees linked to a given company ID.
Properties
| Name | Meaning |
|---|---|
| API Token | API token obtained from TANSS authentication, used to authorize requests |
| Unternehmens-ID (Company ID) | Numeric identifier of the company; required for operations that target a specific company such as retrieving employees |
Note: The "Unternehmens-ID" property is shown only for certain operations including "Mitarbeiter abrufen".
Output
The node outputs an array of JSON objects, each representing the response from the TANSS API for the requested operation.
For the "Mitarbeiter abrufen" operation, the output JSON contains the list of employees associated with the specified company. The exact structure depends on the TANSS API response but typically includes employee details such as names, roles, contact info, etc.
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 taken from the node credentials configuration.
- Network access to the TANSS API endpoint is necessary.
Troubleshooting
- Missing Credentials: If no API token credential is found, the node throws an error "Keine Anmeldedaten gefunden!" (No login data found!). Ensure the API token credential is configured correctly.
- Empty Required Fields: For operations like creating or updating a company, if no fields are provided, the node throws errors indicating missing data. Make sure to provide all required input fields.
- 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 HTTP requests to the TANSS API will be reported with the message "Fehler beim Ausführen von [operation]: [error message]". Check network connectivity, API token validity, and correct company IDs.
- Company ID Requirement: Operations like "Mitarbeiter abrufen" require a valid company ID. Providing zero or invalid IDs may cause API errors.
Links and References
- TANSS API Documentation (not included in source code; consult your TANSS API provider for official docs)
- n8n Documentation on creating custom nodes: https://docs.n8n.io/integrations/creating-nodes/