Actions8
Overview
This node integrates with the TANSS API to manage ticket operations. It allows users to create, update, delete, search, and retrieve tickets as well as add comments and merge tickets within the TANSS system. This is useful for automating support workflows, managing customer service tickets, or integrating ticket data into broader automation processes.
For the "Ticket erstellen" (Create Ticket) operation specifically, the node creates a new ticket in the TANSS system using detailed input fields such as company ID, title, content, assigned employee, status, deadlines, and various other ticket attributes. This operation is beneficial when you want to automatically generate support tickets from external triggers like form submissions, emails, or monitoring alerts.
Practical Example
- Automatically create a support ticket when a customer submits a request via a web form.
- Generate internal project tickets based on scheduled maintenance tasks.
- Create repair tickets triggered by IoT device alerts.
Properties
| Name | Meaning |
|---|---|
| API Token | The API token obtained from TANSS authentication, used to authorize requests. |
| Create Ticket Fields | A collection of fields defining the ticket details to be created: |
| - Company ID | Numeric ID of the company related to the ticket. |
| - Remitter ID | Numeric ID of the remitter (person who sends the ticket). |
| - Title | Title or subject of the ticket. |
| - Content | Detailed description or content of the ticket. |
| - External Ticket ID | An external identifier for the ticket, if applicable. |
| - Assigned to Employee ID | Numeric ID of the employee assigned to the ticket. |
| - Assigned to Department ID | Numeric ID of the department assigned to the ticket. |
| - Status ID | Numeric ID representing the ticket's status. |
| - Type ID | Numeric ID representing the type/category of the ticket. |
| - Link Type ID | Numeric ID for linking this ticket to another entity type. |
| - Link ID | Numeric ID for linking this ticket to a specific entity. |
| - Deadline Date (Timestamp) | Timestamp indicating the deadline for the ticket. |
| - Project | Boolean flag indicating if the ticket is part of a project. |
| - Project ID | Numeric ID of the project if applicable. |
| - Repair | Boolean flag indicating if the ticket is related to a repair. |
| - Due Date (Timestamp) | Timestamp indicating the due date for the ticket. |
| - Attention | Option indicating attention level: No, Yes, Resubmission, Mail. |
| - Order By ID | Numeric ID for ordering purposes. |
| - Installation Fee | Option indicating installation fee status: No, Yes, No Project Installation Fee. |
| - Installation Fee Drive Mode | Option for drive mode related to installation fee: None, Drive Included, Drive Excluded. |
| - Installation Fee Amount | Numeric amount for the installation fee. |
| - Separate Billing | Boolean flag indicating if billing should be separate. |
| - Service Cap Amount | Numeric cap amount for services. |
| - Relationship Link Type ID | Numeric ID for relationship link type. |
| - Relationship Link ID | Numeric ID for relationship link. |
| - Resubmission Date (Timestamp) | Timestamp for resubmission date. |
| - Estimated Minutes | Numeric estimate of minutes required. |
| - Local Ticket Admin Flag | Option indicating local admin role: None, Local Admin, Technician. |
| - Local Ticket Admin Employee ID | Numeric ID of the local ticket admin employee. |
| - Phase ID | Numeric ID representing the phase of the ticket. |
| - Resubmission Text | Text describing resubmission details. |
| - Order Number | String order number associated with the ticket. |
| - Reminder (Timestamp) | Timestamp for reminder notification. |
| - Clearance Mode | Option for clearance behavior: Default, Don't Clear Supports, May Clear Supports. |
| - Sub Tickets | JSON array of objects to assign sub-tickets immediately if creating a project. |
| - Tags | JSON array of tag assignment objects to assign tags to the ticket. |
Output
The node outputs an array of JSON objects corresponding to the results of the executed operation. For the "Ticket erstellen" operation, the output JSON contains the newly created ticket's data as returned by the TANSS API. This typically includes ticket identifiers, status, timestamps, and all submitted fields confirmed by the API.
No binary data output is produced 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 configured in the node credentials.
- Network connectivity to the TANSS backend API is necessary.
Troubleshooting
- Missing Credentials: If no API token or credentials are provided, the node will throw an error "No credentials returned!" Ensure that valid API authentication tokens are configured.
- Empty Ticket Fields: When creating a ticket, if no fields are specified, the node throws "Keine Felder für die Ticket-Erstellung angegeben." Make sure to provide at least one field in the "Create Ticket Fields" collection.
- Invalid Operation: If an unsupported operation is selected, the node throws an error indicating the operation is not recognized.
- API Request Failures: Errors during HTTP requests to the TANSS API will be reported with messages like "Fehler beim Ausführen von [operation]: [error message]". Check network connectivity, API token validity, and correct field values.
- Date Fields: Timestamp fields must be provided as numbers representing Unix timestamps. Incorrect formats may cause API errors.
Links and References
- TANSS API Documentation (not provided here; consult your TANSS API provider)
- n8n Documentation: Creating Custom Nodes
- General REST API usage in n8n: HTTP Request Node