Overview
This node integrates with the TANSS API to manage PC records. It supports creating, updating, retrieving by ID, and deleting PCs or servers within the TANSS system. This is useful for IT asset management workflows where automated synchronization or manipulation of PC inventory data is required.
Typical use cases include:
- Automatically adding new PC entries when provisioning hardware.
- Updating PC details such as location, assigned employee, or hardware specs.
- Fetching PC information for reporting or validation.
- Removing PC records when decommissioned.
For example, you could create a workflow that adds a new PC record after receiving purchase details, or update existing PC info based on maintenance logs.
Properties
| Name | Meaning |
|---|---|
| API Token | The API token used to authenticate requests to the TANSS API. |
| PC Data | A collection of fields describing the PC to create or update. Fields include: Inventory Number, Active status, Company ID, Name, Service Technician ID, Employee ID, Date (timestamp), Location, Manufacturer ID, Model, Serial Number, OS ID, Software, Remark, Show Remark (boolean), Mainboard Manufacturer ID, Mainboard Manufacturer Revision, Mainboard Serial Number, BIOS, BIOS Release, CPU Manufacturer ID, CPU Type ID, CPU Frequency, CPU Number, Mouse Serial Number, Keyboard Serial Number, Server (boolean), Internal Remark, Billing Number, Article Number, Manufacturer Number, Host ID, Purchase Price, Selling Price, Ownage Type (Own, Foreign, Own Rent, Foreign Rent), Storage ID, TeamViewer ID, TeamViewer Password, AnyDesk ID, AnyDesk Password, Reserved RAM, Reserved Hard Disk, Reserved CPU, Description. |
| PC ID | The numeric identifier of the PC or server (used for get, update, delete operations). |
| Operation | The action to perform: "Get PC by ID", "Update PC", "Create PC", or "Delete PC". |
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 Create PC: The output JSON contains the newly created PC's details as returned by the API.
- For Get PC by ID: The output JSON contains the fetched PC's details.
- For Update PC: The output JSON contains the updated PC's details.
- For Delete PC: The output JSON typically contains confirmation of deletion or an empty object.
No binary data is output by this node.
Dependencies
- Requires access to the TANSS API endpoint.
- Requires an API token credential for authenticating requests.
- The base URL for the TANSS API is obtained from the configured credentials.
- The node uses HTTP methods GET, POST, PUT, DELETE to interact with the API.
Troubleshooting
No credentials returned!
This error occurs if the API token credential is missing or not properly configured. Ensure the API token is set in the node credentials.No data provided for creating/updating the PC.
When performing create or update operations, the PC Data collection must contain at least one field. Provide valid PC data to avoid this error.Failed to execute [operation]: [error message]
Indicates an HTTP request failure. Common causes include invalid API token, incorrect PC ID, network issues, or API endpoint errors. Verify credentials, input parameters, and network connectivity.The operation "[operation]" is not recognized.
This should not occur under normal usage since operations are predefined. If it does, check that the operation parameter is correctly set.
Links and References
- TANSS API documentation (not provided here; consult your TANSS API provider for official docs)
- n8n HTTP Request Helper: https://docs.n8n.io/integrations/builtin/core-nodes/n8n-nodes-base.httpRequest/