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, used for authorizing requests |
| Unternehmens-ID (Company ID) | 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: - 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 item contains the raw JSON response from the TANSS API for the requested operation:
- For createCompany, the response includes the newly created company 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 base URL and API token.
- The node expects the API token to be provided as an input property.
- Network access to the TANSS API endpoint is necessary.
- No additional external libraries beyond n8n's standard HTTP request helper are used.
Troubleshooting
- Missing credentials error: If no TANSS API credentials are found, the node will throw an error "Keine Anmeldedaten gefunden!" Ensure that the API credential is configured correctly in n8n.
- 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 specify 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, e.g., "Fehler beim Ausführen von getCompany: ...". 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 URL if available)
- n8n HTTP Request Node documentation for understanding request options: https://docs.n8n.io/nodes/n8n-nodes-base.httpRequest/