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 HR or company management workflows where you need to synchronize company records or employee lists from the TANSS system into other tools or databases. For example, you could automatically update your internal CRM when company details change or regularly fetch employee data for payroll processing.
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 ID of the company whose data or employees are being accessed or modified |
Note: The "Unternehmens-ID" property is shown only for operations that require specifying a company (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 information, etc.
No binary data output is produced by this node.
Dependencies
- Requires an active TANSS API credential containing:
- Base URL of the TANSS API
- An API token for authentication (provided as input)
- The node uses HTTP requests to communicate with the TANSS backend API endpoints.
- No additional external dependencies beyond standard n8n HTTP request helpers.
Troubleshooting
- Missing Credentials: If no TANSS API credentials are configured or found, the node will throw an error "Keine Anmeldedaten gefunden!" (No login data found!). Ensure the API credential is properly set up in n8n.
- Empty Required Fields: For create or update operations, if no company fields are provided, the node throws errors indicating missing data. Always provide necessary fields when creating or updating.
- Invalid Operation: If an unsupported operation is selected, the node throws an error stating the operation is not recognized.
- API Request Failures: Errors during HTTP requests (e.g., network issues, invalid tokens, wrong company IDs) result in messages like "Fehler beim Ausführen von [operation]: [error message]". Verify API token validity, company ID correctness, and network connectivity.
- Company ID Requirement: Operations like "Mitarbeiter abrufen" require a valid company ID; omitting or providing zero may cause API errors.
Links and References
- TANSS API Documentation (not included in source, check official TANSS developer resources)
- n8n HTTP Request Node documentation for understanding request options: https://docs.n8n.io/nodes/n8n-nodes-base.httpRequest/