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 information 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 data processing.
- Update company information based on changes from other integrated applications.
- Delete obsolete company records as part of data cleanup routines.
- Fetch employee lists for reporting or further processing.
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: ID of the company category - Typ-ID: ID of the company type |
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 data of the specified company.
- 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 output is produced by this node.
Dependencies
- Requires an active TANSS API account and a valid API token for authentication.
- The node expects credentials configured in n8n containing the base URL of the TANSS API and the API token.
- Network access to the TANSS API endpoint is necessary.
Troubleshooting
- Missing Credentials Error: If no credentials are found, the node throws an error indicating missing login data. Ensure the API token credential is properly set up in n8n.
- Empty Fields for Create/Update: When creating or updating a company, if no company fields are provided, the node will throw an error. Always provide at least one field to create or update.
- Invalid Operation: If an unsupported operation is selected, the node will report an unrecognized operation error.
- API Request Failures: Errors returned from the TANSS API (e.g., invalid token, network issues) will be surfaced with the message "Fehler beim Ausführen von [operation]: [error message]". Verify API token validity and network connectivity.
- Company ID Required: For operations other than creation, a valid company ID must be provided; otherwise, the request will fail.
Links and References
- TANSS API Documentation (please refer to your TANSS API provider's official documentation for detailed API usage)
- n8n Documentation: Creating Custom Nodes
- General REST API concepts: REST API Tutorial