Actions5
Overview
This node manages companies within the TANSS API, allowing users to create, retrieve, update, and delete company records, as well as fetch employees associated with a company. It is useful in scenarios where automated integration with the TANSS system is needed for company data management, such as syncing company information from other systems, automating updates, or cleaning up outdated company entries.
Practical examples:
- Automatically creating new company records when onboarding clients.
- Retrieving detailed company information for reporting or processing.
- Updating company details based on changes in external databases.
- Deleting companies that are no longer active.
- Fetching employee lists of a specific company for HR workflows.
Properties
| Name | Meaning |
|---|---|
| Operation | The action to perform: "Unternehmen erstellen" (Create Company), "Unternehmen abrufen" (Get Company), "Unternehmen aktualisieren" (Update Company), "Unternehmen löschen" (Delete Company), "Mitarbeiter abrufen" (Get Employees) |
| API Token | API token obtained from TANSS authentication, required for all operations |
| Unternehmens-ID (Company ID) | Numeric ID of the company; required for get, update, delete, and get employees operations |
| Unternehmensfelder (Company Fields) | Collection of fields used when creating or updating a company, including: - Name (string): Company name - Straße (string): Street and house number - PLZ (string): Postal code - Stadt (string): City - Land (string): Country - Telefon (string): Phone number - E-Mail (string): Email address - Website (string): Website URL - Kategorie-ID (number): Company category ID - Typ-ID (number): Company 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, the response includes the newly created company's data.
- For getCompany, it returns the company's details.
- For updateCompany, it returns the updated company data.
- For deleteCompany, it returns confirmation of deletion.
- For getEmployees, it returns a list of employees associated with the specified company.
No binary data is produced by this node.
Dependencies
- Requires access to the TANSS API endpoint, configured via credentials containing the base URL and an API key token.
- The user must provide a valid API token from TANSS authentication for each operation.
- Network connectivity to the TANSS backend API is necessary.
Troubleshooting
- Missing Credentials: If no credentials are found, the node throws an error "Keine Anmeldedaten gefunden!" (No login data found!). Ensure the API credential is properly configured.
- Empty Fields for Create/Update: When creating or updating a company, if no fields are provided, the node throws errors like "Keine Felder für die Unternehmenserstellung angegeben." (No fields specified for company creation) or "Keine Felder zum Aktualisieren angegeben." (No fields specified for updating). Provide at least one field in the company fields collection.
- Invalid Operation: If an unsupported operation is selected, the node throws an error indicating the operation is not recognized.
- API Request Failures: Errors during API calls return messages like "Fehler beim Ausführen von [operation]: [error message]". Check the API token validity, network connection, and whether the company ID exists.
- Company ID Required: For operations requiring a company ID (get, update, delete, get employees), ensure a valid numeric ID is provided.
Links and References
- TANSS API documentation (not included here; refer to your TANSS API provider)
- n8n documentation on creating custom nodes and handling HTTP requests: https://docs.n8n.io/
- General REST API usage best practices