Actions5
Overview
This node integrates with the TANSS API to manage company data and retrieve employees associated with a company. It supports operations such as creating, retrieving, updating, and deleting companies, as well as fetching employees of a specified company.
A common use case is automating company data management workflows, for example:
- Automatically creating new company records in TANSS when onboarding clients.
- Periodically syncing company details from TANSS into other systems.
- Retrieving employee lists for reporting or HR automation purposes.
Practical example: You could use this node to fetch all employees of a company by specifying the company ID and then process that list further in your workflow, such as sending notifications or generating reports.
Properties
| Name | Meaning |
|---|---|
| Operation | The action to perform. Options: "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, required for API access |
| Unternehmens-ID (Company ID) | Numeric ID of the company; required for operations except company creation |
| Unternehmensfelder (Company Fields) | Collection of fields used when creating or updating a company, including: - Name - Straße (Street) - PLZ (Zip Code) - Stadt (City) - Land (Country) - Telefon (Phone) - E-Mail (Email) - Website - Kategorie-ID (Category ID) - Typ-ID (Type ID) |
Output
The node outputs an array of JSON objects corresponding to the results of each input item processed. The structure depends on the operation:
- For createCompany, getCompany, updateCompany, and deleteCompany operations, the output JSON contains the response from the TANSS API related to the company resource.
- For getEmployees, the output JSON contains the list of employees retrieved from 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 uses the base URL provided by the credential to construct API requests.
- Network connectivity to the TANSS API endpoint is necessary.
Troubleshooting
- Missing Credentials Error: If no 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 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 company fields collection.
- Unrecognized 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, e.g., "Fehler beim Ausführen von getEmployees: ...". Check network connectivity, API token validity, and correct company IDs.
Links and References
- TANSS API Documentation (not provided here, but users should refer to their official TANSS API docs for detailed API usage)
- n8n Documentation on Creating Custom Nodes: https://docs.n8n.io/integrations/creating-nodes/