Description
n8n-nodes-qualitor
This is an n8n community node. It lets you use Qualitor SOAP API in your n8n workflows.
Qualitor is a Brazilian service management platform that provides ITSM (IT Service Management) solutions for businesses. This node allows you to integrate with Qualitor's SOAP webservices to manage tickets, services, and general operations.
n8n is a fair-code licensed workflow automation platform.
Table of Contents
Installation
Follow the installation guide in the n8n community nodes documentation.
Manual Installation
-
Install the package in your n8n installation:
npm install n8n-nodes-qualitor -
Restart your n8n instance to load the new node.
Operations
The Qualitor node supports three main service types:
General Services (wsgeneral.wsdl)
- Access to general Qualitor operations
- Used for system-wide functions and configurations
Ticket Services (wsticket.wsdl)
- Ticket creation, retrieval, and updates
- Ticket status management
- Ticket field operations
Service Management (wsservice.wsdl)
- Service catalog operations
- Service request management
- Service configuration
Available Operations
For each service type, you can specify any operation name (e.g., getTicket, createTicket, updateTicket) and provide the required fields as key-value pairs.
Credentials
To use this node, you need to configure the Qualitor API credentials:
Required Fields
- Qualitor Base URL: The base URL of your Qualitor instance (e.g.,
https://qualitor.example.com/qualitor) - Company ID: The ID of the company to which the user belongs (numeric value)
- Username: Your Qualitor username for authentication
- Password: Your Qualitor password for authentication
Setting up Credentials
- In n8n, go to Credentials → Create New
- Search for "Qualitor API" and select it
- Fill in all required fields
- Test the connection to ensure it works
- Save the credentials
Compatibility
- n8n version: 1.0.0 or higher
- Node.js version: 20.15 or higher
- Qualitor API: Compatible with Qualitor SOAP webservices
Usage
Basic Example: Get Ticket Information
- Add the Qualitor node to your workflow
- Select your Qualitor API credentials
- Choose the service: "Ticket" (
wsticket.wsdl) - Set the operation:
getTicket - Add fields:
- Field Name:
cdchamado - Field Value:
123456(your ticket ID)
- Field Name:
- Enable "Parse Response" to get JSON output
Example: Create a New Ticket
- Add the Qualitor node to your workflow
- Select your Qualitor API credentials
- Choose the service: "Ticket" (
wsticket.wsdl) - Set the operation:
createTicket - Add required fields for ticket creation:
titulo: "Issue title"descricao: "Issue description"prioridade: "2"- And other required fields according to your Qualitor configuration
Configuration Options
- Parse Response: When enabled, the node will parse the SOAP XML response into JSON format for easier processing in subsequent nodes. When disabled, returns raw XML.
- Fields: Add multiple key-value pairs to send as parameters to the SOAP operation.
Features
- ✅ Support for all three Qualitor SOAP services (General, Ticket, Service)
- ✅ Flexible operation specification
- ✅ Dynamic field configuration
- ✅ XML to JSON response parsing
- ✅ Raw XML response option
- ✅ Secure credential management
- ✅ TypeScript implementation
Resources
Development
If you want to contribute to this node or modify it for your needs:
# Clone the repository
git clone https://github.com/juniorfontenele/n8n-qualitor.git
# Install dependencies
npm install
# Build the project
npm run build
# Run linting
npm run lint
# Auto-fix linting issues
npm run lintfix
License
Author
Junior Fontenele
- Email: n8n@juniorfontenele.com.br
- GitHub: @juniorfontenele
Support
If you encounter any issues or have questions:
- Check the Qualitor documentation
- Review the n8n community nodes documentation
- Open an issue on the GitHub repository
