Delivery Management

Detrack

Learn how to use Detrack with Composio

Overview

SLUG: DETRACK

Description

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

Authentication Details

generic_api_key
stringRequired

Connecting to Detrack

Create an auth config

Use the dashboard to create an auth config for the Detrack toolkit. This allows you to connect multiple Detrack accounts to Composio for agents to use.

1

Select App

Navigate to the Detrack toolkit page and click “Setup Integration”.

2

Configure Auth Config Settings

Select among the supported auth schemes of and configure them here.

3

Create and Get auth config ID

Click “Create Integration”. After creation, copy the displayed ID starting with ac_. This is your auth config ID. This is not a sensitive ID — you can save it in environment variables or a database. This ID will be used to create connections to the toolkit for a given user.

Connect Your Account

Using API Key

1from composio import Composio
2
3# Replace these with your actual values
4detrack_auth_config_id = "ac_YOUR_DETRACK_CONFIG_ID" # Auth config ID created above
5user_id = "0000-0000-0000"  # UUID from database/app
6
7composio = Composio()
8
9def authenticate_toolkit(user_id: str, auth_config_id: str):
10    # Replace this with a method to retrieve an API key from the user.
11    # Or supply your own.
12    user_api_key = input("[!] Enter API key")
13
14    connection_request = composio.connected_accounts.initiate(
15        user_id=user_id,
16        auth_config_id=auth_config_id,
17        config={"auth_scheme": "API_KEY", "val": user_api_key}
18    )
19
20    # API Key authentication is immediate - no redirect needed
21    print(f"Successfully connected Detrack for user {user_id}")
22    print(f"Connection status: {connection_request.status}")
23    
24    return connection_request.id
25
26
27connection_id = authenticate_toolkit(user_id, detrack_auth_config_id)
28
29# You can verify the connection using:
30connected_account = composio.connected_accounts.get(connection_id)
31print(f"Connected account: {connected_account}")

Tools

Executing tools

To prototype you can execute some tools to see the responses and working on the Detrack toolkit’s playground

Python
1from composio import Composio
2from openai import OpenAI
3import json
4
5openai = OpenAI()
6composio = Composio()
7
8# User ID must be a valid UUID format
9user_id = "0000-0000-0000"  # Replace with actual user UUID from your database
10
11tools = composio.tools.get(user_id=user_id, toolkits=["DETRACK"])
12
13print("[!] Tools:")
14print(json.dumps(tools))
15
16def invoke_llm(task = "What can you do?"):
17    completion = openai.chat.completions.create(
18        model="gpt-4o",
19        messages=[
20            {
21                "role": "user",
22                "content": task,  # Your task here!
23            },
24        ],
25        tools=tools,
26    )
27
28    # Handle Result from tool call
29    result = composio.provider.handle_tool_calls(user_id=user_id, response=completion)
30    print(f"[!] Completion: {completion}")
31    print(f"[!] Tool call result: {result}")
32
33invoke_llm()

Tool List

Tool Name: Add Collection

Description

Tool to add a new collection in detrack. use after gathering all necessary collection details.

Action Parameters

driver_name
string
from_address
stringRequired
from_email
from_name
stringRequired
from_postal_code
string
from_tel
string
items
array
job_date
Required
remarks
string
scheduled_collection_time
tracking_number
stringRequired
vehicle_type
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Delete All Collections

Description

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

Action Parameters

date
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Delete All Deliveries

Description

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

Action Parameters

date
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Delete Delivery

Description

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).

Action Parameters

items
arrayRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Edit Delivery

Description

Tool to edit specific deliveries by date and d.o. number. use after confirming delivery identifiers to update their details (max 100 per call).

Action Parameters

items
arrayRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: List Jobs

Description

Tool to list all jobs with optional filters and pagination. use when you need to retrieve jobs by date, status, country, or other criteria.

Action Parameters

country
string
date
string
do_number
string
page
integer
per_page
integer
status
string
tracking_number
string
type
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: View All Collections

Description

Tool to view all collection jobs in detrack. use when you need to retrieve every collection job currently stored.

Action Parameters

date
Required

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: View All Deliveries

Description

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

Action Parameters

date
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: View All Vehicles

Description

Tool to view all vehicles in the account. use when you need a complete list of your fleet with optional pagination.

Action Parameters

page
integer
per_page
integer

Action Response

data
objectRequired
error
string
successful
booleanRequired