n8n-nodes-everest-tms

This is an n8n community node that integrates Everest TMS with your n8n workflows, enabling seamless transport and logistics management automation with AI-powered assistance.

Everest TMS is a comprehensive transport management system platform, while n8n is a fair-code licensed workflow automation tool that allows you to connect various services.

Installation
Operations
Credentials
Compatibility
Usage
Resources
Version History

Installation

To install this community node, please follow the official n8n community node installation guide.

You can install it via npm:

npm install n8n-nodes-everest-tms

Or through the n8n interface by searching for n8n-nodes-everest-tms in the Community Nodes section.

Operations

This node supports comprehensive Everest TMS operations, also usable as tools, across multiple resources:

🚚 Missions

Create, Get, Update, Delete transport missions
Estimate mission costs and pricing
Accept missions (for agents)
Set Status and track mission progress
Cancel missions with automatic refunds
Get Multiple missions by references
Mark as Seen by agents
Advanced filtering by date ranges, statuses, clients, agents
Timezone support for Europe/Paris with automatic DST handling

👥 Clients & Agents

Complete CRUD operations for clients and agents
Manage client billing information and custom requirements
Update agent locations and availability in real-time
Filter by availability, status, and search criteria
Custom information fields for specialized requirements

🧾 Invoices & Billing

Create and manage invoices and estimates
Track payment status and dates
Associate missions with invoices
Generate billing documents
Support for VAT and tax calculations

🔔 Alerts & Notifications

Create platform alerts with different categories (success, warning, danger, info)
Filter alerts by status (read/unread) and search terms
Send SMS notifications to multiple phone numbers
Send Email notifications to multiple addresses
Send Push Notifications to specific agents
Use mission references with {MISSION_REF} placeholder

🤖 Walter AI Assistant

Send prompts to Walter AI for intelligent assistance
Get AI-powered responses with actionable commands
Send messages from Walter to users
Retrieve available commands that Walter can execute
Conversation history management
Command execution with parameters
Multi-user support with user_id parameter

👤 CRM Contacts

Manage CRM contacts and customer relationships
Create events and track interactions
Organize contacts by company and category
Points-based customer scoring system

🗺️ Route Optimization

Optimize delivery routes for multiple vehicles
Manage capacity constraints and time windows
Calculate optimal paths and costs
Support for different vehicle profiles (car, truck, bike, walk)
Advanced constraints (max distance, travel time, tasks)

🔗 Webhooks

Subscribe/Unsubscribe to real-time events
Support for all Everest webhook events:
- Mission events (created, updated, status changes, etc.)
- Client and agent events
- Invoice and billing events
- Platform configuration changes
- And many more...

ℹ️ Platform Information

Get platform details and configuration
Retrieve available services, statuses, and vehicle types
Check address coverage and availability
Get time slots for mission scheduling
Platform availabilities and working hours

Credentials

To authenticate, you need to configure Everest API credentials in n8n:

API Domain: Your Everest platform domain (e.g., your-platform.everst.io)
Bearer Token: Your API Bearer token obtained from your Everest platform

These credentials are configured in the n8n credentials section under everestApi.

How to get your Bearer Token

Log in to your Everest platform
Navigate to your API settings or developer section
Generate or copy your Bearer token
Use this token in the n8n credentials configuration

Compatibility

This node has been tested with:

n8n version 1.0.0+
Everest API version 1.156.1+

Usage

Basic Setup

Get Bearer Token: Obtain your Bearer token from your Everest platform
Install the Node: Add this community node to your n8n instance
Configure Credentials: Set up your Everest API credentials in n8n with your domain and Bearer token
Create Workflow: Add the Everest node to your workflow
Select Operations: Choose the desired resource and operation

Example Workflows

Create a Mission with Timezone Support

{
  "resource": "mission",
  "operation": "create",
  "service_id": 1,
  "address_start": "42 rue de la Paix, 75001 Paris",
  "address_end": "15 avenue des Champs-Élysées, 75008 Paris",
  "additionalFields": {
    "client_id": 123,
    "comment": "Urgent delivery",
    "weight": 5.5,
    "start_date": "2025-06-26 14:30"
  }
}

Create Platform Alert

{
  "resource": "alert",
  "operation": "create",
  "icon": "invoice",
  "category": "danger",
  "text": "Invoice awaiting payment",
  "created_for": "client:123",
  "additionalFields": {
    "url": "/client/invoices",
    "status": 0
  }
}

Interact with Walter AI Assistant

{
  "resource": "walter",
  "operation": "prompt",
  "question": "Show me today's missions with status 'pending'",
  "save_to_history": true
}

Send Walter Message with User ID

{
  "resource": "walter",
  "operation": "say",
  "message": "I found 5 urgent missions that need attention",
  "user_id": 123,
  "save_to_history": true,
  "commands": {
    "command": [{
      "command": "get_missions",
      "parameters": "status,urgent,date_start,2025-01-20"
    }]
  }
}

Send Multi-Channel Notifications

{
  "resource": "notification",
  "operation": "sendSms",
  "tels": "0600000000,0611111111",
  "text": "Your mission {MISSION_REF} has been updated",
  "mission_ref": "ABC123XXX"
}

Subscribe to Real-time Webhooks

{
  "resource": "webhook",
  "operation": "subscribe",
  "url": "https://my-site.com/webhook/everest",
  "event": "mission_created"
}

Advanced Mission Filtering

{
  "resource": "mission",
  "operation": "getMany",
  "options": {
    "limit": 100,
    "statuses": "pending,in-progress",
    "date_between_start": "2025-01-20 09:00",
    "date_between_end": "2025-01-20 18:00",
    "client": 123,
    "order_by": "start_date",
    "order_by_order": "ASC"
  }
}

Optimize Delivery Routes

{
  "resource": "route",
  "operation": "optimize",
  "shipments": [
    {
      "pickup": {
        "id": 1,
        "location": [2.3317, 48.8291],
        "service": 300
      },
      "delivery": {
        "id": 2,
        "location": [2.3928, 48.8522],
        "service": 300
      },
      "weight": 100,
      "volume": 0.25
    }
  ],
  "vehicles": [
    {
      "id": 1,
      "profile": "car",
      "start": [2.3969, 48.8666],
      "capacity": 10,
      "weight": 250,
      "volume": 1.3
    }
  ],
  "options": {
    "distribute_fairly": true,
    "split_per_day": true
  }
}

Key Features

🤖 AI Integration

Walter AI Assistant for intelligent automation
Natural language processing for mission queries
Command execution with parameter validation
Conversation history management
Multi-user support with user_id parameter for targeted interactions

🔔 Real-time Notifications

Multi-channel notifications (SMS, Email, Push)
Template support with mission reference placeholders
Bulk messaging capabilities
Platform alerts with categorization

📊 Advanced Filtering

Complex date range queries with timezone support
Multi-status filtering with comma-separated values
Search capabilities across multiple fields
Pagination support for large datasets

🛡️ Robust Error Handling

Comprehensive validation for all required fields
Graceful error recovery with continue-on-fail support
Detailed error messages for troubleshooting
Simplified authentication with direct Bearer token

🔐 Simplified Authentication

Direct Bearer token authentication
No repeated authentication calls
Secure token storage per credential
Improved performance with reduced API calls

Resources

License

This project is licensed under the GNU General Public License v3.0 - see the LICENSE file for details.