Description

n8n-nodes-cigotracker

This is an n8n community node that allows you to interact with the CigoTracker API in your n8n workflows.

CigoTracker is a logistics and delivery management platform that helps businesses manage their delivery operations, routes, and field service teams.

n8n is a fair-code licensed workflow automation platform.

Installation

Follow the installation guide in the n8n community nodes documentation.

Operations

This node supports the following resources and operations:

Jobs

• Create – Create a new delivery/service job
• Get – Retrieve a specific job by ID
• Update – Update job details
• Delete – Delete a job
• Search – Search for jobs by date range
• Cancel – Cancel a job

Actions

• Create – Add actions to a job
• Get – Get a specific action
• Get All – Get all actions for a job
• Update – Update action details
• Delete – Delete an action

Itineraries

• Create – Create a new route/itinerary
• Get – Get itinerary by ID
• Get by Date – Get itineraries for a specific date
• Get by Operator – Get itineraries assigned to an operator
• Get by Vehicle – Get itineraries assigned to a vehicle
• Update – Update itinerary details
• Delete – Delete an itinerary
• Preview Route – Preview a potential route
• Add Job – Add a job to an itinerary
• Remove Job – Remove a job from an itinerary
• Update Job Position – Change job order in itinerary

Locations

• Get – Get a specific location
• Get All – Get all locations

Vehicles

• Get – Get a specific vehicle
• Get All – Get all vehicles

Operators

• Get – Get a specific operator
• Get All – Get all operators

Credentials

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

1. Log in to your CigoTracker account as an administrator
2. Navigate to Integrations → API settings
3. Enable API access to obtain your API Account ID and API Auth Key
4. In n8n, create new CigoTracker credentials with:
   • Environment: Production or Sandbox
   • API Account ID
   • API Auth Key

Usage Examples

Create a Job

{
  "resource": "job",
  "operation": "create",
  "skipStaging": true,
  "firstName": "John",
  "lastName": "Doe",
  "address": "123 Main St",
  "date": "2024-01-15",
  "additionalFields": {
    "email": "john.doe@example.com",
    "phone_number": "+1234567890",
    "time_frame": {
      "timeFrame": [{
        "start": "09:00",
        "end": "17:00"
      }]
    }
  }
}

Add Action to Job

{
  "resource": "action",
  "operation": "create",
  "jobId": "job_123",
  "type": "delivery",
  "additionalFields": {
    "name": "Deliver Package",
    "quantity": 1,
    "handle_time": 15
  }
}

Create Itinerary

{
  "resource": "itinerary",
  "operation": "create",
  "name": "Monday Route",
  "date": "2024-01-15",
  "additionalFields": {
    "vehicle_id": "vehicle_123",
    "operator_ids": "operator_1,operator_2",
    "jobs": "[\"job_123\", \"job_456\"]"
  }
}

Important Notes

• Jobs created with skip_staging: false (default) will need to be reviewed in the CigoTracker Import Tool before they can be routed
• Date format should be YYYY-MM-DD
• Time format should be HH:MM (24-hour format)
• Coordinates should be provided as "latitude,longitude"
• The API has a 30-day limit for date range searches
• Sub-users must provide branch_id and distribution_center_id when creating jobs

Resources

• CigoTracker API Documentation
• n8n Community Nodes Documentation

License

Apache 2.0