# Detrack

Detrack is a delivery management software that offers real-time vehicle tracking, electronic proof of delivery, and automated customer notifications.

- **Category:** internet of things
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 19
- **Triggers:** 0
- **Slug:** `DETRACK`
- **Version:** 20260312_00

## Tools

### Add Collection

**Slug:** `DETRACK_ADD_COLLECTION`

Add a new collection job in Detrack. A collection is a pickup job where items are collected from a location. The Delivery Order (do) number must be unique per date. Include the country name in the address for better geocoding.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `do` | string | Yes | Delivery Order number - must be unique per date. This serves as the tracking identifier. |
| `date` | string | Yes | Date of the collection job in YYYY-MM-DD format |
| `zone` | string | No | Zone or region classification for the collection |
| `items` | array | No | List of items to collect. Each item requires sku, desc, and qty. |
| `phone` | string | No | Phone number of the collection contact |
| `address` | string | Yes | Full address of the collection location. Include country name for better geocoding accuracy. |
| `assign_to` | string | No | Vehicle name or identifier to assign this collection to |
| `notify_url` | string | No | Webhook URL to receive collection status updates |
| `collect_from` | string | No | Name of the sender or company to collect from |
| `instructions` | string | No | Special instructions for the driver |
| `notify_email` | string | No | Email address to send collection status notifications |
| `collection_time` | string | No | Time window for collection (e.g., '09:00 AM - 12:00 PM' or '14:00') |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Bulk Create Depots

**Slug:** `DETRACK_CREATE_BULK_DEPOTS`

Tool to create multiple depot locations in one request. Use when you need to create several depots at once. Each depot requires at least a name and an address that can be geocoded. Include country name in addresses for accurate geocoding.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | array | Yes | List of depot data objects to create. Each depot requires at least a name and address. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Depot

**Slug:** `DETRACK_CREATE_DEPOT`

Create a new depot in Detrack. A depot serves as a starting/ending point for delivery routes. Requires at least a name and an address that can be geocoded. The address should be complete and include the country name for accurate geocoding.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Depot data containing name, address, and optional fields. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete All Collections

**Slug:** `DETRACK_DELETE_ALL_COLLECTIONS`

Tool to delete all collections in the account. Use when you need to purge every collection for a specific date after confirmation.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `date` | string | Yes | The collection date in YYYY-MM-DD format, e.g., '2014-02-28'. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete All Deliveries

**Slug:** `DETRACK_DELETE_ALL_DELIVERIES`

Tool to delete all deliveries for a specific date. Use when you need to purge deliveries in bulk before scheduling new ones.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `date` | string | Yes | The delivery date to delete all deliveries for. Format: YYYY-MM-DD. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Delivery

**Slug:** `DETRACK_DELETE_DELIVERY`

Tool to delete one or more deliveries by date and D.O. number. Use after confirming delivery entries to avoid accidental data loss (max 100 items per call).

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `items` | array | Yes | List of deliveries to delete; must contain between 1 and 100 items |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Bulk Delete Depots

**Slug:** `DETRACK_DELETE_DEPOTS_BULK`

Tool to delete multiple depots in a single request. Use when you need to remove depots that are no longer needed.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | array | Yes | List of depots to delete; each depot identified by its name |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Job by Query

**Slug:** `DETRACK_DELETE_JOB_BY_QUERY`

Tool to delete a job by DO number using query parameters. Use when you need to delete a specific job by its DO number. Returns success status indicating whether the job was found and deleted.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `date` | string | No | Optional date filter in YYYY-MM-DD format to narrow down the job lookup. |
| `type` | string ("Delivery" | "Collection") | No | Job type enumeration for delivery or collection jobs. |
| `do_number` | string | Yes | Delivery Order (DO) number to identify the job to delete. Must be unique. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Edit Delivery

**Slug:** `DETRACK_EDIT_DELIVERY`

Edit one or more existing deliveries by date and D.O. number. Use this tool to update delivery details such as address, recipient, phone, instructions, or vehicle assignment. The delivery must already exist in Detrack (identified by date + D.O. number combination). Limitations: - Maximum 100 deliveries per request - Date and D.O. must match an existing delivery

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `items` | array | Yes | List of delivery records to update (1 to 100 items) |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Job by DO and Date

**Slug:** `DETRACK_GET_JOB_BY_DO_AND_DATE`

Tool to retrieve a specific job by its DO (Delivery Order) number and date. Use when you need to fetch detailed information about a specific delivery or collection job. Returns comprehensive job details including status, tracking, items, and proof of delivery information.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `date` | string | Yes | Date of the job in YYYY-MM-DD format. This must match the scheduled date of the job. |
| `type` | string ("Delivery" | "Collection") | No | Job type enum for filtering jobs. |
| `do_number` | string | Yes | Delivery Order (DO) number to retrieve. This is the unique identifier for the job on the specified date. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Job By Query

**Slug:** `DETRACK_GET_JOB_BY_QUERY`

Tool to retrieve a single job by DO number using query parameters. Use when you need to fetch detailed information about a specific delivery or collection job.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `date` | string | No | Date filter in YYYY-MM-DD format. Use to narrow search if DO number is not unique. |
| `type` | string ("Delivery" | "Collection") | No | Job type enum for Detrack. |
| `do_number` | string | Yes | Delivery Order (DO) number to retrieve the job. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Depots

**Slug:** `DETRACK_LIST_DEPOTS`

Tool to list all depot locations with pagination. Use when you need to retrieve depot information including addresses and coordinates. Supports pagination to handle large numbers of depots.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number for pagination. Defaults to 1. |
| `limit` | integer | No | Number of records per page. Defaults to 20. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Jobs V2

**Slug:** `DETRACK_LIST_JOBS_V2`

Tool to list jobs with pagination and filtering using Detrack API v2. Use when you need to retrieve jobs with filters by date, type, assign_to, status, DO number, or search query. Supports sorting and pagination for efficient data retrieval.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `date` | string | No | Filter jobs by date in YYYY-MM-DD format. |
| `page` | integer | No | Page number for pagination. Defaults to 1. |
| `sort` | string | No | Attribute to be sorted. Add minus (-) prefix for descending order (e.g., '-date' for descending date, 'date' for ascending). |
| `type` | string ("Delivery" | "Collection") | No | Enum for job type filter. |
| `limit` | integer | No | Number of records per page. Maximum 100. Defaults to 20. |
| `query` | string | No | Search query to filter jobs by DO number, address, delivery to, notify email, assign to, tracking number, or zone. |
| `status` | string | No | Filter jobs by status. Use comma to separate multiple statuses (e.g., 'Completed,In Progress'). |
| `assign_to` | string | No | Filter jobs by the vehicle/driver assigned to the job. |
| `do_number` | string | No | Filter jobs by Delivery Order (DO) number. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Search

**Slug:** `DETRACK_SEARCH`

Tool to search for deliveries, collections, or vehicles. Use after defining search criteria to retrieve matching jobs.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `q` | object | Yes | Query object containing search criteria. Supported keys: 'date' (YYYY-MM-DD format), 'do' (delivery order number), 'type' ('delivery' or 'collection'), 'status' (e.g., 'In Progress', 'Completed'), 'tracking_status' (e.g., 'info_recv', 'on_vehicle'), 'address', 'name', 'zone'. |
| `page` | integer | No | Page number for pagination (1-based). Defaults to 1. |
| `limit` | integer | No | Number of jobs to return per page. |
| `order` | string ("ASC" | "DESC") | No | Sorting order: ASC (ascending) or DESC (descending). |
| `offset` | integer | No | Number of jobs to skip (for pagination). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Search Jobs

**Slug:** `DETRACK_SEARCH_JOBS`

Search jobs with advanced filters including date range, DO number, statuses, groups, vehicles, zones, and more. Use this to find specific jobs across multiple criteria using the v2 search API.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `type` | string | No | Filter jobs by type: 'delivery' or 'collection'. |
| `query` | string | No | General search query string to search across job fields like DO number, address, customer name, etc. |
| `status` | string | No | Filter jobs by status. Common values include 'completed', 'failed', 'in_progress', 'pending'. |
| `date_to` | string | No | End date for date range filter in YYYY-MM-DD format. Returns jobs scheduled up to this date. |
| `assign_to` | string | No | Filter jobs by assigned driver name or ID. |
| `date_from` | string | No | Start date for date range filter in YYYY-MM-DD format. Returns jobs scheduled from this date onwards. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Depots Bulk

**Slug:** `DETRACK_UPDATE_DEPOTS_BULK`

Update multiple depot locations in a single request. Use this to modify depot details such as address, contact information, or coordinates. Each depot is identified by its name or ID. This is more efficient than updating depots individually when you need to update multiple depots at once.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | array | Yes | List of depot records to update. Each depot must have at least a name. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### View All Collections

**Slug:** `DETRACK_VIEW_ALL_COLLECTIONS`

View all collection jobs scheduled for a specific date in Detrack. Returns collection details including delivery order number, pickup address, status, tracking link, and items. Use this to retrieve all collections for a particular day by providing a date in YYYY-MM-DD format.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `date` | string | Yes | The collection date to view all collections for. Format: YYYY-MM-DD (e.g., '2026-01-27'). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### View All Deliveries

**Slug:** `DETRACK_VIEW_ALL_DELIVERIES`

Tool to view all deliveries for a specific date. Use when you need to retrieve all delivery jobs on a given date.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `date` | string | Yes | The delivery date to view all deliveries for. Format: YYYY-MM-DD. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### View All Vehicles

**Slug:** `DETRACK_VIEW_ALL_VEHICLES`

Retrieve all vehicles registered in your Detrack account. Returns complete fleet information including real-time location, speed, connection status, and vehicle details. Use this to get an overview of your entire fleet or check which vehicles are currently active.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |
