n8n-nodes-advbox

This is an n8n community node that provides integration with the ADVBOX legal management platform API. ADVBOX is a comprehensive legal practice management software that helps law firms manage cases, tasks, clients, and legal processes.

n8n is a fair-code licensed workflow automation platform.

Table of Contents

• Installation
• Credentials
• Operations
• Example Workflows
• Compatibility
• Resources
• Version History

Installation

Follow the installation guide in the n8n community nodes documentation.

Community Nodes (Recommended)

1. Go to Settings > Community Nodes in your n8n instance
2. Click Install
3. Enter n8n-nodes-advbox as the npm package name
4. Click Install

Manual Installation

# For npm
npm install n8n-nodes-advbox

# For yarn
yarn add n8n-nodes-advbox

# For pnpm
pnpm add n8n-nodes-advbox

Docker

For Docker-based n8n installations, add the package to your custom nodes:

docker run -it --rm \
  --name n8n \
  -p 5678:5678 \
  -v ~/.n8n:/home/node/.n8n \
  -e N8N_CUSTOM_EXTENSIONS="/home/node/.n8n/custom" \
  n8nio/n8n

Credentials

To use this node, you need to configure ADVBOX API credentials:

1. API Token: Your ADVBOX API authentication token
2. API URL: Your ADVBOX API endpoint (default: https://app.advbox.com.br/api/v1)
3. X-Agent (optional): Custom agent header for API requests

Getting Your API Token

1. Log into your ADVBOX account
2. Navigate to API settings in your account preferences
3. Generate or copy your API token
4. Use this token in the n8n ADVBOX credentials

Operations

Lawsuit Resource

Get All Lawsuits

• Description: Retrieve a list of lawsuits with optional filtering
• Parameters:
  • limit (optional): Maximum number of results to return
  • additionalFields (optional): Additional query parameters

Get Lawsuit by ID

• Description: Retrieve a specific lawsuit by its ID
• Parameters:
  • lawsuitId: The unique identifier of the lawsuit

Get Task History

• Description: Retrieve task history for a specific lawsuit
• Parameters:
  • lawsuitId: The unique identifier of the lawsuit
  • additionalFields (optional): Additional query parameters

Update Lawsuit

• Description: Update lawsuit information
• Parameters:
  • lawsuitId: The unique identifier of the lawsuit
  • updateFields: Object containing fields to update

Task Resource

Create Task

• Description: Create a new task in ADVBOX
• Parameters:
  • lawsuitId: Associated lawsuit ID
  • title: Task title
  • description: Task description
  • dueDate: Task due date
  • additionalFields (optional): Additional task parameters

Get Task by ID

• Description: Retrieve a specific task by its ID
• Parameters:
  • taskId: The unique identifier of the task

Get Tasks

• Description: Retrieve a list of tasks with optional filtering
• Parameters:
  • additionalFields (optional): Filtering and pagination options

Get Task History

• Description: Retrieve history for a specific task
• Parameters:
  • taskId: The unique identifier of the task

Movement Resource

Get Movement History

• Description: Retrieve movement history for a lawsuit
• Parameters:
  • lawsuitId: The unique identifier of the lawsuit
  • additionalFields (optional): Additional query parameters

Settings Resource

Get Settings

• Description: Retrieve system settings and configuration
• Returns: System configuration data including users and settings

Example Workflows

Basic Lawsuit Retrieval

{
  "nodes": [
    {
      "name": "Get Lawsuits",
      "type": "n8n-nodes-advbox.advbox",
      "parameters": {
        "resource": "lawsuit",
        "operation": "getAll",
        "limit": 10
      }
    }
  ]
}

Create Task and Get History

{
  "nodes": [
    {
      "name": "Create Task",
      "type": "n8n-nodes-advbox.advbox",
      "parameters": {
        "resource": "task",
        "operation": "create",
        "lawsuitId": "12345",
        "title": "Review Documents",
        "description": "Review case documents for next hearing"
      }
    },
    {
      "name": "Get Task History",
      "type": "n8n-nodes-advbox.advbox",
      "parameters": {
        "resource": "task",
        "operation": "getHistory",
        "taskId": "{{ $node['Create Task'].json.id }}"
      }
    }
  ]
}

Compatibility

• n8n version: 0.125.0 or higher
• Node.js: 14.x or higher
• ADVBOX API: v1

Resources

• ADVBOX Official Website
• n8n Community Nodes Documentation
• n8n Workflow Templates

Version History

0.3.90

• BREAKING: Removed runtime dependency on request-promise-native
• IMPROVEMENT: Migrated to n8n's built-in HTTP request helpers
• IMPROVEMENT: Enhanced error handling with proper TypeScript types
• IMPROVEMENT: Removed restricted globals (setTimeout) for n8n compliance
• IMPROVEMENT: Cleaned up package structure and removed backup files
• FIX: Fixed all ESLint violations for n8n community node standards

0.3.89

• FEATURE: Added comprehensive task management operations
• FEATURE: Added movement history tracking
• FEATURE: Added lawsuit update functionality
• IMPROVEMENT: Enhanced error handling and logging
• IMPROVEMENT: Added retry logic for API requests
• FIX: Corrected API endpoints for task operations

0.3.51

• FEATURE: Added Tasks resource with API integration
• IMPROVEMENT: Updated node icon to PNG format (logo-advbox.png)
• IMPROVEMENT: Enhanced error handling and logging

Support

For issues, feature requests, or questions:

1. Check the n8n community forum
2. Review ADVBOX API documentation
3. Create an issue in the project repository

License

MIT

Note: This is a community-maintained node and is not officially supported by ADVBOX or n8n. Use at your own discretion in production environments.