n8n-nodes-qf-agent

N8N community nodes for QuotationFactory Agent integration via Azure IoT Hub.

Overview

This package provides N8N nodes to integrate with QuotationFactory (Rhodium24) via their IoT Hub-based agent protocol. It consists of two parts:

1. N8N Nodes - Custom nodes for N8N workflows
2. Bridge Service - Node.js service that manages IoT Hub connections

Architecture

┌─────────────────────────────────────────────────────────┐
│                    N8N Instance                         │
├─────────────────────────────────────────────────────────┤
│  Workflow A          Workflow B          Workflow C     │
│  (Agent 123)         (Agent 456)         (Agent 789)    │
│      │                   │                   │          │
└──────┼───────────────────┼───────────────────┼──────────┘
       │                   │                   │
       ▼                   ▼                   ▼
┌─────────────────────────────────────────────────────────┐
│              QF Bridge Service (Node.js)                │
├─────────────────────────────────────────────────────────┤
│  Manages multiple IoT Hub connections per agent         │
│  Routes events to N8N webhooks                          │
│  Proxies commands from N8N to IoT Hub                   │
└─────────────────────────────────────────────────────────┘
       │                   │                   │
       ▼                   ▼                   ▼
   IoT Hub             IoT Hub             IoT Hub
  (Agent 123)         (Agent 456)         (Agent 789)

N8N Nodes

QF Agent Trigger

Webhook-based trigger that receives events from QuotationFactory:

• Download File - Triggered when QF sends a file to process
• Project Import - Triggered when a project needs to be imported
• Settings Update - Triggered when agent settings are updated

QF Agent Send Status

Send command status updates back to QuotationFactory:

• Received / Doing / Done / Failed

QF Agent Upload File

Upload files to QuotationFactory via Azure Blob Storage.

QF Agent Send Response

Send response messages to QuotationFactory:

• ExportToErpResponse
• RequestAddressBookSyncResponse
• RequestArticlesSyncResponse

Installation

1. Install Bridge Service

cd bridge-service
npm install
cp .env.example .env
# Edit .env with your QF API keys
npm run dev

2. Install N8N Nodes

npm install
npm run build
npm link
cd ~/.n8n/nodes
npm link @beltar/n8n-nodes-qf-agent

Configuration

Bridge Service (.env)

PORT=3000
QF_API_KEY_PRODUCTION=your-production-api-key
QF_API_KEY_UAT=your-uat-api-key
QF_API_KEY_DEVELOPMENT=your-development-api-key

N8N Credentials

• Agent ID - Your QuotationFactory agent UUID
• Environment - Production, UAT, or Development
• Bridge Service URL - URL where your bridge service runs

License

MIT