Actions5
Overview
This node manages companies within the TANSS API, allowing users to create, retrieve, update, delete companies, and fetch employees of a company. It is useful in scenarios where you need to automate company data management or integrate company-related workflows with the TANSS system.
For example:
- Automatically creating new company records when onboarding clients.
- Retrieving company details for reporting or synchronization.
- Updating company information based on external changes.
- Deleting obsolete company entries.
- Listing employees associated with a specific company.
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 from TANSS authentication used to authorize requests. |
| Unternehmens-ID (Company ID) | The numeric ID of the company; required for get, update, delete operations and fetching employees. |
| Unternehmensfelder (Company Fields) | Collection of fields for creating or updating a company, including: Name, Street, ZIP code, City, Country, Phone, Email, Website, Category ID, Type ID. |
Output
The node outputs JSON data corresponding to the response from the TANSS API for each operation:
- For createCompany, it returns the created company data.
- For getCompany, it returns the company details.
- For updateCompany, it returns the updated company data.
- For deleteCompany, it returns confirmation of deletion.
- For getEmployees, it returns a list of employees belonging to the specified company.
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 obtained from the node credentials configuration.
- Network access to the TANSS API endpoints 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 Fields for Create/Update: When creating or updating a company, if no fields are provided, the node throws errors indicating missing fields. Provide at least one field in the companyFields collection.
- 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 include the operation name and the original error message. Check network connectivity, API token validity, and endpoint availability.
Links and References
- TANSS API Documentation (Replace with actual link if available)
- n8n Documentation on Creating Custom Nodes