Overview
This node manages devices (such as PCs, servers, peripherals, hardware components, and software services) via the TANSS API. It supports creating, retrieving, listing, updating, and deleting device records in the TANSS system. This is useful for IT asset management workflows where automated synchronization or updates of device inventories are needed.
Practical examples:
- Automatically add new computers or peripherals to the TANSS inventory when they are provisioned.
- Retrieve detailed information about a specific device by its ID.
- Update device details such as location, IP address, or description after maintenance.
- Remove decommissioned devices from the inventory.
Properties
| Name | Meaning |
|---|---|
| Gerätetyp | Type of device. Options: PC/Server, Peripherie (peripherals like printers, scanners), Komponenten (hardware components), Services (software services). |
| API Token | API token from TANSS authentication used for authorization in API requests. |
| Geräte-ID | Numeric ID of the device to retrieve, update, or delete. |
| Gerätefelder | Collection of device fields for creation or update, including: - Name - Beschreibung (description) - Seriennummer (serial number) - Inventarnummer (inventory number) - Hersteller-ID (manufacturer ID) - Unternehmen-ID (company ID) - Standort (location) - IP-Adresse (IP address) - MAC-Adresse (MAC address) - Betriebssystem-ID (operating system ID) |
Output
The node outputs an array of JSON objects representing the response from the TANSS API for each input item processed. The structure depends on the operation:
- For createDevice and updateDevice, the output JSON contains the created or updated device data as returned by the API.
- For getDevice, the output JSON contains the detailed data of the requested device.
- For listDevices, the output JSON contains a list/array of devices.
- For deleteDevice, the output JSON typically contains confirmation of deletion or status message.
No binary data output is produced by this node.
Dependencies
- Requires access to the TANSS API endpoint with a valid base URL configured in credentials.
- Requires an API token for authentication passed as a parameter.
- Needs n8n credentials configured with the TANSS API base URL and authentication details.
Troubleshooting
Error: Keine Anmeldedaten gefunden!
Means no credentials were found. Ensure that the TANSS API credentials are properly set up in n8n.Error: Keine Felder für die Geräteerstellung angegeben.
When creating a device, at least one device field must be provided. Make sure to fill in required device fields.Error: Keine Felder zum Aktualisieren angegeben.
When updating a device, at least one field to update must be specified.Error: Die Operation "XYZ" wird nicht erkannt.
Indicates an unsupported operation was selected. Verify the operation name is correct.API request errors (e.g., network issues, invalid token)
These will be reported with the messageFehler beim Ausführen von <operation>: <error message>. Check API token validity, network connectivity, and API endpoint correctness.
Links and References
- TANSS API documentation (not provided here; consult your TANSS API provider)
- n8n documentation on creating custom nodes and using HTTP Request helpers
- General REST API usage best practices