Actions5
Overview
This node integrates with the TANSS API to manage company data. It supports creating, retrieving, updating, and deleting companies, as well as fetching employees associated with a company. This node is useful for automating business workflows that involve maintaining up-to-date company records or synchronizing company data between systems.
Practical examples:
- Automatically create new company entries in TANSS when a lead is qualified in a CRM.
- Retrieve company details to enrich customer profiles during onboarding.
- Update company information based on changes from external databases.
- Delete obsolete company records as part of data cleanup processes.
- Fetch employee lists for reporting or HR automation tasks.
Properties
| Name | Meaning |
|---|---|
| API Token | API token obtained from TANSS authentication, used to authorize requests. |
| Unternehmensfelder (Company Fields) | Collection of fields describing the company: - Name: Company 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: Company category ID (number) - Typ-ID: Company type ID (number) |
Note: The "Unternehmensfelder" property is used only for the operations "createCompany" and "updateCompany".
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 output 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 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 provided via credentials.
- Network access to the TANSS API endpoint is necessary.
Troubleshooting
- Missing Credentials Error: If no TANSS API credentials are found, the node throws an error "Keine Anmeldedaten gefunden!" Ensure that the API token credential is configured correctly in n8n.
- Empty Fields for 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 in the "Unternehmensfelder" collection.
- Invalid Operation: If an unsupported operation is selected, the node will throw 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, a valid company ID must be provided; otherwise, the API call will fail.
Links and References
- TANSS API Documentation (Replace with actual URL if available)
- n8n Documentation on Creating Custom Nodes
- General REST API best practices for error handling and authentication.