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 want to automate company data management workflows, synchronize company records between systems, or retrieve employee lists for further processing.
Practical examples:
- Automatically create new companies in TANSS when a lead is converted in your CRM.
- Retrieve detailed company information to enrich customer profiles.
- Update company contact details based on external data sources.
- Delete obsolete company records as part of data cleanup.
- Fetch employees of a company to generate reports or trigger notifications.
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 unique identifier of the company. Required for get, update, delete, and get employees operations. |
| Unternehmensfelder (Company Fields) | Collection of fields for creating or updating a company: - Name (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 the response from the TANSS API for each input item processed. The structure depends on the operation:
- For getCompany, it returns the company details as received from the API.
- For createCompany and updateCompany, it returns the created or updated company data.
- For deleteCompany, it returns the API response confirming deletion.
- For getEmployees, it returns a list of employees associated with the specified company.
No binary data output is produced 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 Error: If no API credentials are found, the node will throw an error "Keine Anmeldedaten gefunden!" Ensure that the TANSS API credential is properly set up and connected.
- 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." Make sure to provide at least one field in the companyFields 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. 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 (Replace with actual link if available)
- n8n Documentation on Creating Custom Nodes
- General REST API usage best practices