Actions5
Overview
This node integrates with the TANSS API to manage company data. It supports operations such as creating a new company, retrieving company details, updating existing company information, deleting a company, and fetching employees of a company. This node is useful in scenarios where you need to automate company data management within workflows, for example:
- Automatically adding new companies from form submissions.
- Synchronizing company updates from other systems.
- Cleaning up or archiving company records.
- Retrieving employee lists for reporting or further processing.
Properties
| Name | Meaning |
|---|---|
| API Token | API token obtained from TANSS authentication, used to authorize requests. |
| Unternehmens-ID | The unique identifier of the company to retrieve, update, delete, or get employees for. |
| Unternehmensfelder | A 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) |
The Operation property (not listed here but implied) determines which action is performed:
- Unternehmen erstellen (createCompany)
- Unternehmen abrufen (getCompany)
- Unternehmen aktualisieren (updateCompany)
- Unternehmen löschen (deleteCompany)
- Mitarbeiter abrufen (getEmployees)
Output
The node outputs an array of JSON objects corresponding to the results of each input item processed. Each output item contains the raw JSON response from the TANSS API for the requested operation:
- For create, get, update, and delete operations, the output JSON reflects the company data or confirmation returned by the API.
- For the "getEmployees" operation, the output JSON contains the list of employees associated with the specified company.
No binary data 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 configured in the credentials.
- The node uses HTTP requests with JSON payloads and expects JSON responses.
Troubleshooting
- Missing Credentials: If no API token credential is found, the node throws an error "Keine Anmeldedaten gefunden!" Ensure that valid API authentication credentials are configured.
- Empty Fields on 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, a valid company ID must be provided; otherwise, the API call will fail.
Links and References
- TANSS API Documentation (not provided here, but users should refer to official TANSS API docs for detailed endpoint info)
- n8n HTTP Request Node documentation for understanding request options and error handling.