trackpod_create_order

Create ONE REAL unscheduled order in Track-POD (POST /Order): a delivery or a collection for a client at an address, ready to be planned into a route by a dispatcher. It does not create or optimise routes. Depending on the account's notification settings the customer may later receive SMS/e-mail updates about it. Confirm the details with the user first. Address and client are required; Track-POD geocodes the address unless you pass address_lat/address_lon.

destructive

Argument	Type	Description
cod	number	Cash-on-delivery amount to collect.
date	string	Order date, YYYY-MM-DD.
note	string	Note for the driver.
type	string	delivery (default) or collection.
depot	string	Depot address (else the account's default depot).
email	string	Customer e-mail.
goods	array	Goods lines (max 100).
phone	string	Customer contact phone.
client*	string	Client/customer name.
number*	string	The order number (your Order/Invoice/Job/Waybill number) — used later to look the order up, so no slash or backslash.
volume	number	Total volume.
weight	number	Total weight.
address*	string	Delivery (or pickup) address, e.g. '2 St Josephs Crescent, Liverpool L3 3JF'.
barcode	string	Barcode the driver scans.
pallets	number	Pallet count.
shipper	string	Shipper/supplier name.
order_id	string	Your accounting-system id for the order.
priority	string	Order priority.
address_lat	number	Address latitude (pass with address_lon to skip geocoding).
address_lon	number	Address longitude.
address_zone	string	Address zone.
contact_name	string	Customer contact name.
time_slot_to	string	Desired delivery/pickup window end, local 24-hour time HH:mm.
time_slot_from	string	Desired delivery/pickup window start, local 24-hour time HH:mm.
service_time_minutes	number	Service time at the stop, minutes.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "number",
    "client",
    "address"
  ],
  "properties": {
    "cod": {
      "type": "number",
      "minimum": 0,
      "description": "Cash-on-delivery amount to collect."
    },
    "date": {
      "type": "string",
      "description": "Order date, YYYY-MM-DD."
    },
    "note": {
      "type": "string",
      "maxLength": 500,
      "minLength": 1,
      "description": "Note for the driver."
    },
    "type": {
      "enum": [
        "delivery",
        "collection"
      ],
      "type": "string",
      "description": "delivery (default) or collection."
    },
    "depot": {
      "type": "string",
      "maxLength": 255,
      "minLength": 1,
      "description": "Depot address (else the account's default depot)."
    },
    "email": {
      "type": "string",
      "format": "email",
      "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
      "maxLength": 255,
      "description": "Customer e-mail."
    },
    "goods": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "name"
        ],
        "properties": {
          "cost": {
            "type": "number",
            "minimum": 0,
            "description": "Unit price."
          },
          "name": {
            "type": "string",
            "maxLength": 255,
            "minLength": 1,
            "description": "Item description."
          },
          "note": {
            "type": "string",
            "maxLength": 255,
            "minLength": 1,
            "description": "Line note."
          },
          "unit": {
            "type": "string",
            "maxLength": 50,
            "minLength": 1,
            "description": "Unit: pcs, pkg, kg, lbs …"
          },
          "goods_id": {
            "type": "string",
            "maxLength": 50,
            "minLength": 1,
            "description": "Goods id in your accounting system."
          },
          "quantity": {
            "type": "number",
            "minimum": 0,
            "description": "Quantity or weight."
          }
        }
      },
      "maxItems": 100,
      "description": "Goods lines (max 100)."
    },
    "phone": {
      "type": "string",
      "maxLength": 50,
      "minLength": 1,
      "description": "Customer contact phone."
    },
    "client": {
      "type": "string",
      "maxLength": 255,
      "minLength": 1,
      "description": "Client/customer name."
    },
    "number": {
      "type": "string",
      "maxLength": 50,
      "minLength": 1,
      "description": "The order number (your Order/Invoice/Job/Waybill number) — used later to look the order up, so no slash or backslash."
    },
    "volume": {
      "type": "number",
      "minimum": 0,
      "description": "Total volume."
    },
    "weight": {
      "type": "number",
      "minimum": 0,
      "description": "Total weight."
    },
    "address": {
      "type": "string",
      "maxLength": 255,
      "minLength": 1,
      "description": "Delivery (or pickup) address, e.g. '2 St Josephs Crescent, Liverpool L3 3JF'."
    },
    "barcode": {
      "type": "string",
      "maxLength": 128,
      "minLength": 1,
      "description": "Barcode the driver scans."
    },
    "pallets": {
      "type": "number",
      "minimum": 0,
      "description": "Pallet count."
    },
    "shipper": {
      "type": "string",
      "maxLength": 255,
      "minLength": 1,
      "description": "Shipper/supplier name."
    },
    "order_id": {
      "type": "string",
      "maxLength": 50,
      "minLength": 1,
      "description": "Your accounting-system id for the order."
    },
    "priority": {
      "enum": [
        "low",
        "normal",
        "high"
      ],
      "type": "string",
      "description": "Order priority."
    },
    "address_lat": {
      "type": "number",
      "maximum": 90,
      "minimum": -90,
      "description": "Address latitude (pass with address_lon to skip geocoding)."
    },
    "address_lon": {
      "type": "number",
      "maximum": 180,
      "minimum": -180,
      "description": "Address longitude."
    },
    "address_zone": {
      "type": "string",
      "maxLength": 100,
      "minLength": 1,
      "description": "Address zone."
    },
    "contact_name": {
      "type": "string",
      "maxLength": 255,
      "minLength": 1,
      "description": "Customer contact name."
    },
    "time_slot_to": {
      "type": "string",
      "description": "Desired delivery/pickup window end, local 24-hour time HH:mm."
    },
    "time_slot_from": {
      "type": "string",
      "description": "Desired delivery/pickup window start, local 24-hour time HH:mm."
    },
    "service_time_minutes": {
      "type": "number",
      "maximum": 1440,
      "minimum": 0,
      "description": "Service time at the stop, minutes."
    }
  }
}

trackpod_find_orders_by_number

List the last 25 orders that share one order number (re-deliveries, repeated jobs) — GET /Order/Number/{number}/List. Use it when an order number was reused and trackpod_get_order returns only one of them.

read-only

Argument	Type	Description
detail	string	summary (default): key fields per order. full: every field Track-POD returns (goods lines, custom fields, photo links).
number*	string	The order number.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "number"
  ],
  "properties": {
    "detail": {
      "enum": [
        "summary",
        "full"
      ],
      "type": "string",
      "description": "summary (default): key fields per order. full: every field Track-POD returns (goods lines, custom fields, photo links)."
    },
    "number": {
      "type": "string",
      "maxLength": 100,
      "minLength": 1,
      "description": "The order number."
    }
  }
}

trackpod_get_driver

Get one driver by Track-POD id (UUID) or by username (GET /Driver/Id/{id} or /Driver/Username/{username}). Pass exactly one.

read-only

Argument	Type	Description
username	string	The driver's username (login).
driver_id	string	The driver's Track-POD id (UUID, from trackpod_list_drivers).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "username": {
      "type": "string",
      "maxLength": 100,
      "minLength": 1,
      "description": "The driver's username (login)."
    },
    "driver_id": {
      "type": "string",
      "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
      "description": "The driver's Track-POD id (UUID, from trackpod_list_drivers)."
    }
  }
}

trackpod_get_order

Get one order with every field: client, address, time slot, goods lines, route, driver, delivery status, ETA, signature/photo links and tracking link. Pass exactly one of number, order_id or track_id (GET /Order/Number|Id|TrackId/{…}). A removed order answers with who removed it (HTTP 410).

read-only

Argument	Type	Description
number	string	The order number (Order/Invoice/Job/Waybill number), e.g. cv30001-2.
order_id	string	The order Id — the unique identifier from your accounting system that the order was created with.
track_id	string	The order TrackId (UUID) from a tracking link or a webhook.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "number": {
      "type": "string",
      "maxLength": 100,
      "minLength": 1,
      "description": "The order number (Order/Invoice/Job/Waybill number), e.g. cv30001-2."
    },
    "order_id": {
      "type": "string",
      "maxLength": 100,
      "minLength": 1,
      "description": "The order Id — the unique identifier from your accounting system that the order was created with."
    },
    "track_id": {
      "type": "string",
      "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
      "description": "The order TrackId (UUID) from a tracking link or a webhook."
    }
  }
}

trackpod_get_proof_of_delivery

Get the electronic proof of delivery (ePOD) of one order: status and status time/GPS, who signed, signature and photo links (valid 24 h), driver comment, reject reasons, delivered vs ordered goods quantities, cash collected, customer feedback and the PDF delivery-note link (ReportUrl, valid 1 h). Pass exactly one of number, order_id or track_id.

read-only

Argument	Type	Description
number	string	The order number (Order/Invoice/Job/Waybill number), e.g. cv30001-2.
order_id	string	The order Id — the unique identifier from your accounting system that the order was created with.
track_id	string	The order TrackId (UUID) from a tracking link or a webhook.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "number": {
      "type": "string",
      "maxLength": 100,
      "minLength": 1,
      "description": "The order number (Order/Invoice/Job/Waybill number), e.g. cv30001-2."
    },
    "order_id": {
      "type": "string",
      "maxLength": 100,
      "minLength": 1,
      "description": "The order Id — the unique identifier from your accounting system that the order was created with."
    },
    "track_id": {
      "type": "string",
      "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
      "description": "The order TrackId (UUID) from a tracking link or a webhook."
    }
  }
}

trackpod_get_route

Get one route with its status, driver, vehicle, timings, distance, cost, current GPS position and its orders. Pass exactly one of route_code or route_id (GET /Route/Code|Id/{…}).

read-only

Argument	Type	Description
route_id	string	The route Id from your accounting system.
route_code	string	The route code/number.
include_orders	string	summary (default): key fields of each order. none: counts only. full: every order field.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "route_id": {
      "type": "string",
      "maxLength": 100,
      "minLength": 1,
      "description": "The route Id from your accounting system."
    },
    "route_code": {
      "type": "string",
      "maxLength": 100,
      "minLength": 1,
      "description": "The route code/number."
    },
    "include_orders": {
      "enum": [
        "none",
        "summary",
        "full"
      ],
      "type": "string",
      "description": "summary (default): key fields of each order. none: counts only. full: every order field."
    }
  }
}

trackpod_get_route_track

Get the driver's recorded GPS track of a route (latitude, longitude, speed in m/s, time) — GET /Route/Track/Code|Id/{…}. Pass exactly one of route_code or route_id. Points are paged here (offset/limit, max 1000 per call).

read-only

Argument	Type	Description
limit	integer	Points per page (default 200, max 1000).
offset	integer	Items to skip (default 0). Use next_offset from the previous page.
route_id	string	The route Id from your accounting system.
route_code	string	The route code/number.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 1000,
      "minimum": 1,
      "description": "Points per page (default 200, max 1000)."
    },
    "offset": {
      "type": "integer",
      "maximum": 100000,
      "minimum": 0,
      "description": "Items to skip (default 0). Use next_offset from the previous page."
    },
    "route_id": {
      "type": "string",
      "maxLength": 100,
      "minLength": 1,
      "description": "The route Id from your accounting system."
    },
    "route_code": {
      "type": "string",
      "maxLength": 100,
      "minLength": 1,
      "description": "The route code/number."
    }
  }
}

trackpod_get_vehicle

Get one vehicle by its Track-POD id (an integer, from trackpod_list_vehicles) — GET /Vehicle/{id}.

read-only

Argument	Type	Description
vehicle_id*	integer	The vehicle's Track-POD id.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "vehicle_id"
  ],
  "properties": {
    "vehicle_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "The vehicle's Track-POD id.",
      "exclusiveMinimum": 0
    }
  }
}

trackpod_list_drivers

List the account's drivers: name, username, phone, vehicle, depot, zone, teams and active flag (GET /Driver). Paged here.

read-only

Argument	Type	Description
limit	integer	Items per page (default 25, max 100).
offset	integer	Items to skip (default 0). Use next_offset from the previous page.
search	string	Keep only drivers whose name, username, phone or vehicle contains this text.
active_only	boolean	Only active drivers (default false = all).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "Items per page (default 25, max 100)."
    },
    "offset": {
      "type": "integer",
      "maximum": 100000,
      "minimum": 0,
      "description": "Items to skip (default 0). Use next_offset from the previous page."
    },
    "search": {
      "type": "string",
      "maxLength": 100,
      "minLength": 1,
      "description": "Keep only drivers whose name, username, phone or vehicle contains this text."
    },
    "active_only": {
      "type": "boolean",
      "description": "Only active drivers (default false = all)."
    }
  }
}

trackpod_list_orders

List the orders of one day — by order date (GET /Order/Date/{date}) or by planned route date (GET /Order/Route/Date/{date}) — with optional filters on delivery status, driver and route number. Track-POD returns the whole day at once; this tool pages it (offset/limit) and reports the total. Times are the account's local times.

read-only

Argument	Type	Description
date*	string	The day, YYYY-MM-DD.
limit	integer	Items per page (default 25, max 100).
detail	string	summary (default): key fields per order. full: every field Track-POD returns (goods lines, custom fields, photo links).
driver	string	Keep only orders whose driver login or name contains this text.
offset	integer	Items to skip (default 0). Use next_offset from the previous page.
status	array	Keep only orders with these delivery statuses: no_status (not yet attempted / unassigned), in_progress (1), not_delivered_site_issue (2), delivered (3, also 'collected'), partially (4), not_delivered_order_issue (5).
date_type	string	order_date (default): orders whose order date is this day, scheduled or not. route_date: orders planned into routes of this day.

trackpod_list_orders_changed_since

List orders whose delivery status changed after a moment in the last 24 hours (GET /Order/Status/Date/{date-time}; Track-POD accepts no earlier time than UTC now − 1 day). Good for 'what was delivered / failed since this morning'. Paged here (offset/limit).

read-only

Argument	Type	Description
limit	integer	Items per page (default 25, max 100).
since	string	ISO 8601 date-time with a timezone, within the last 24 hours, e.g. 2026-10-08T06:00:00Z. Default: 23 h 59 min ago.
detail	string	summary (default): key fields per order. full: every field Track-POD returns (goods lines, custom fields, photo links).
offset	integer	Items to skip (default 0). Use next_offset from the previous page.
status	array	Keep only orders with these delivery statuses: no_status (not yet attempted / unassigned), in_progress (1), not_delivered_site_issue (2), delivered (3, also 'collected'), partially (4), not_delivered_order_issue (5).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "Items per page (default 25, max 100)."
    },
    "since": {
      "type": "string",
      "description": "ISO 8601 date-time with a timezone, within the last 24 hours, e.g. 2026-10-08T06:00:00Z. Default: 23 h 59 min ago."
    },
    "detail": {
      "enum": [
        "summary",
        "full"
      ],
      "type": "string",
      "description": "summary (default): key fields per order. full: every field Track-POD returns (goods lines, custom fields, photo links)."
    },
    "offset": {
      "type": "integer",
      "maximum": 100000,
      "minimum": 0,
      "description": "Items to skip (default 0). Use next_offset from the previous page."
    },
    "status": {
      "type": "array",
      "items": {
        "enum": [
          "no_status",
          "in_progress",
          "not_delivered_site_issue",
          "delivered",
          "partially",
          "not_delivered_order_issue"
        ],
        "type": "string"
      },
      "maxItems": 6,
      "minItems": 1,
      "description": "Keep only orders with these delivery statuses: no_status (not yet attempted / unassigned), in_progress (1), not_delivered_site_issue (2), delivered (3, also 'collected'), partially (4), not_delivered_order_issue (5)."
    }
  }
}

trackpod_list_reject_reasons

List the account's reasons for not delivering / not collecting: site, order, goods and scanning issues (GET /RejectReason).

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {}
}

trackpod_list_route_orders

List the orders on one route, in route order, by route code (GET /Order/Route/Code/{code}). Paged here (offset/limit).

read-only

Argument	Type	Description
limit	integer	Items per page (default 25, max 100).
detail	string	summary (default): key fields per order. full: every field Track-POD returns (goods lines, custom fields, photo links).
offset	integer	Items to skip (default 0). Use next_offset from the previous page.
status	array	Keep only orders with these delivery statuses: no_status (not yet attempted / unassigned), in_progress (1), not_delivered_site_issue (2), delivered (3, also 'collected'), partially (4), not_delivered_order_issue (5).
route_code*	string	The route code/number, e.g. R-1023.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "route_code"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "Items per page (default 25, max 100)."
    },
    "detail": {
      "enum": [
        "summary",
        "full"
      ],
      "type": "string",
      "description": "summary (default): key fields per order. full: every field Track-POD returns (goods lines, custom fields, photo links)."
    },
    "offset": {
      "type": "integer",
      "maximum": 100000,
      "minimum": 0,
      "description": "Items to skip (default 0). Use next_offset from the previous page."
    },
    "status": {
      "type": "array",
      "items": {
        "enum": [
          "no_status",
          "in_progress",
          "not_delivered_site_issue",
          "delivered",
          "partially",
          "not_delivered_order_issue"
        ],
        "type": "string"
      },
      "maxItems": 6,
      "minItems": 1,
      "description": "Keep only orders with these delivery statuses: no_status (not yet attempted / unassigned), in_progress (1), not_delivered_site_issue (2), delivered (3, also 'collected'), partially (4), not_delivered_order_issue (5)."
    },
    "route_code": {
      "type": "string",
      "maxLength": 100,
      "minLength": 1,
      "description": "The route code/number, e.g. R-1023."
    }
  }
}

trackpod_list_routes

List the routes of one day (GET /Route/Date/{date}): code, status (Draft, Ready, Loaded, InProgress, Closed), driver, vehicle, planned vs actual start/finish, distance, cost, current GPS position, and per-route order counts by status. Paged here (offset/limit).

read-only

Argument	Type	Description
date*	string	The route date, YYYY-MM-DD.
limit	integer	Items per page (default 25, max 100).
offset	integer	Items to skip (default 0). Use next_offset from the previous page.
status	array	Keep only routes with these statuses.
include_orders	string	none (default): order counts only. summary: key fields of each order. full: every order field (large).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "date"
  ],
  "properties": {
    "date": {
      "type": "string",
      "description": "The route date, YYYY-MM-DD."
    },
    "limit": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "Items per page (default 25, max 100)."
    },
    "offset": {
      "type": "integer",
      "maximum": 100000,
      "minimum": 0,
      "description": "Items to skip (default 0). Use next_offset from the previous page."
    },
    "status": {
      "type": "array",
      "items": {
        "enum": [
          "Draft",
          "Ready",
          "Loaded",
          "InProgress",
          "Closed"
        ],
        "type": "string"
      },
      "maxItems": 5,
      "minItems": 1,
      "description": "Keep only routes with these statuses."
    },
    "include_orders": {
      "enum": [
        "none",
        "summary",
        "full"
      ],
      "type": "string",
      "description": "none (default): order counts only. summary: key fields of each order. full: every order field (large)."
    }
  }
}

trackpod_list_vehicle_checks

Driver vehicle inspections (before/after route): checklist items with pass/fail, notes, photo links (valid 24 h), odometer and signature. date only: every check of that day (GET /VehicleCheck/Date/{date}); date + vehicle_number: that vehicle's checks of the day; vehicle_number only: that vehicle's last check (GET /VehicleCheck/{number}).

read-only

Argument	Type	Description
date	string	The day, YYYY-MM-DD.
limit	integer	Items per page (default 25, max 100).
offset	integer	Items to skip (default 0). Use next_offset from the previous page.
vehicle_number	string	The vehicle (plate) number.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "date": {
      "type": "string",
      "description": "The day, YYYY-MM-DD."
    },
    "limit": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "Items per page (default 25, max 100)."
    },
    "offset": {
      "type": "integer",
      "maximum": 100000,
      "minimum": 0,
      "description": "Items to skip (default 0). Use next_offset from the previous page."
    },
    "vehicle_number": {
      "type": "string",
      "maxLength": 30,
      "minLength": 1,
      "description": "The vehicle (plate) number."
    }
  }
}

trackpod_list_vehicles

List the account's vehicles: plate number, assigned driver, depot, capacity (weight/volume/pallets/size), limits, costs, type and carrier (GET /Vehicle, optional plate-number filter). Paged here.

read-only

Argument	Type	Description
limit	integer	Items per page (default 25, max 100).
number	string	Filter by vehicle (plate) number.
offset	integer	Items to skip (default 0). Use next_offset from the previous page.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "Items per page (default 25, max 100)."
    },
    "number": {
      "type": "string",
      "maxLength": 30,
      "minLength": 1,
      "description": "Filter by vehicle (plate) number."
    },
    "offset": {
      "type": "integer",
      "maximum": 100000,
      "minimum": 0,
      "description": "Items to skip (default 0). Use next_offset from the previous page."
    }
  }
}

Track-POD MCP by usefulapi

Try it

trackpod_create_order

Track-POD MCP by usefulapi

Try it

trackpod_create_order

Tools (16)