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 for automating business workflows that involve managing company records in the TANSS system, such as syncing company databases, updating company profiles, or extracting employee lists for reporting.
Practical examples:
- Automatically create a new company record in TANSS when a new client signs up.
- Retrieve detailed company information to enrich CRM data.
- Update company contact details based on external data sources.
- Delete obsolete company records from TANSS.
- Fetch all employees of a specific company for HR automation.
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 API access. |
| Unternehmens-ID (Company ID) | Numeric ID of the company; required for operations other than creation (get, update, delete, get employees). |
| Unternehmensfelder (Company Fields) | Collection of fields used when creating or updating a company, including: Name, Street, ZIP code, City, Country, Phone, Email, Website, Category 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, the response includes the newly created company's data.
- For getCompany, it returns the detailed company information.
- 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 output by this node.
Dependencies
- Requires an active TANSS API credential with a valid API token.
- The node expects the base URL of the TANSS API to be configured in the credentials.
- Network access to the TANSS API endpoint is necessary.
Troubleshooting
- Missing Credentials: If no API credentials are found, the node throws an error "Keine Anmeldedaten gefunden!" Ensure the API token credential is properly set up.
- 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." or "Keine Felder zum Aktualisieren angegeben." 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 include the operation name and the original error message, e.g., "Fehler beim Ausführen von getCompany:
". Check network connectivity, API token validity, and correct company IDs. - Company ID Required: Operations other than creation require a valid company ID. Using zero or invalid IDs may cause API errors.
Links and References
- TANSS API Documentation (not provided here, but users should refer to their official TANSS API docs for detailed API usage)
- n8n Documentation on Creating Custom Nodes: https://docs.n8n.io/integrations/creating-nodes/
- General REST API concepts: https://restfulapi.net/