Actions5
Overview
This node integrates with the TANSS API to manage company data. It supports creating, retrieving, updating, and deleting companies, as well as fetching employees of a specific company. This node is useful for automating business workflows that involve maintaining up-to-date company records or synchronizing company information between TANSS and other systems.
Practical examples include:
- Automatically creating new company entries in TANSS when onboarding clients.
- Updating company details such as address or contact information based on external data sources.
- Retrieving company information for reporting or validation purposes.
- Deleting obsolete company records.
- Listing employees associated with a company for HR or administrative tasks.
Properties
| Name | Meaning |
|---|---|
| Operation | The action to perform: createCompany, getCompany, updateCompany, deleteCompany, getEmployees |
| API Token | API token from TANSS authentication used to authorize requests |
| Unternehmens-ID (companyId) | ID of the company to retrieve, update, delete, or fetch employees for (required for all operations except create) |
| Unternehmensfelder (companyFields) | Collection of fields describing company details; used when creating or updating a company. Includes: - Name - Straße (Street and house number) - PLZ (Postal code) - Stadt (City) - Land (Country) - Telefon (Phone number) - E-Mail (Email address) - Website (Website URL) - Kategorie-ID (Category ID) - Typ-ID (Type ID) |
Output
The node outputs an array of JSON objects corresponding to each input item processed. Each output JSON contains the response from the TANSS API for the requested operation:
- For createCompany and updateCompany, the output includes the created or updated company data.
- For getCompany, the output contains the retrieved company details.
- For deleteCompany, the output reflects the deletion result or confirmation.
- For getEmployees, the output lists employees associated with the specified company.
No binary data is produced by this node.
Dependencies
- Requires an active TANSS API endpoint URL and a valid API token credential configured in n8n.
- The node uses HTTP requests to communicate with the TANSS backend API.
- The API token must be provided as an input property for each execution.
Troubleshooting
- Missing Credentials Error: If no API token credential is found, the node throws an error "Keine Anmeldedaten gefunden!" Ensure the API token is correctly set and passed.
- Empty Fields for Create/Update: When creating or updating a company, if no company fields are provided, the node throws errors like "Keine Felder für die Unternehmenserstellung angegeben." or "Keine Felder zum Aktualisieren angegeben." Always provide at least one field to create or update.
- Invalid Operation: If an unsupported operation is selected, the node throws an error indicating the operation is not recognized.
- API Request Failures: Errors during HTTP requests return messages prefixed with "Fehler beim Ausführen von [operation]:". Check network connectivity, API token validity, and correct company IDs.
- Company ID Required: For operations other than creation, ensure a valid company ID is provided; otherwise, the API call will fail.
Links and References
- TANSS API Documentation (not provided here, but users should refer to their official TANSS API docs for detailed endpoint info)
- n8n HTTP Request Node documentation for understanding request options and error handling: https://docs.n8n.io/nodes/n8n-nodes-base.httpRequest/