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 associated with a company.
Typical use cases include automating company data management workflows, synchronizing company records between systems, or maintaining up-to-date company information in TANSS from other sources.
For example, you could use this node to update company contact details automatically when changes occur in your CRM, or to retrieve employee lists for reporting purposes.
Properties
| Name | Meaning |
|---|---|
| API Token | API token obtained from TANSS authentication, required for all operations. |
| Unternehmens-ID | The unique identifier of the company to operate on (required for get, update, delete, and get employees operations). |
| Unternehmensfelder | A collection of fields representing company attributes used when creating or updating a company. Includes: - 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) - Typ-ID (Company type ID) |
Output
The node outputs an array of JSON objects corresponding to the results of each operation executed. The structure depends on the operation:
- Create Company: Returns the created company's data as received from the TANSS API.
- Get Company: Returns detailed information about the specified company.
- Update Company: Returns the updated company data.
- Delete Company: Returns confirmation or status of the deletion.
- Get Employees: 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: If no API token credential is found, the node will throw an error "Keine Anmeldedaten gefunden!" (No login data found!). Ensure that the API token credential is properly set up.
- Empty Fields for Create/Update: When creating or updating a company, if no company fields are provided, the node throws errors indicating missing fields. Always provide at least one field to create or update.
- Invalid Operation: If an unsupported operation is selected, the node throws an error stating the operation is not recognized.
- API Request Failures: Errors during API calls return messages like "Fehler beim Ausführen von [operation]: [error message]". Check network connectivity, API token validity, and correct company IDs.
- Company ID Required: For operations requiring a company ID (get, update, delete, get employees), ensure a valid numeric ID is provided; otherwise, the API call will fail.
Links and References
- TANSS API Documentation (not provided here, but users should refer to official TANSS API docs for detailed API usage)
- n8n Documentation on Creating Custom Nodes: https://docs.n8n.io/integrations/creating-nodes/