AI tools — DMS

10 tools. The latest schema is always in dms_tool_catalog once connected.

Distribution product catalog

ReadScope: dms:read

dms_catalog_products_search

Distribution product catalog: code, name, unit, price; paginated.

Parameter	Type	Required	Description
`page`	integer	no	Page, starting at 1
`pageSize`	integer	no	Rows per page, max 50

Or call over REST with an API key

curl -X POST https://api.nextx.vn/api/v1/ai/tools/dms/dms_catalog_products_search/read \
  -H "X-Api-Key: $API_KEY" -H "Content-Type: application/json" \
  -d '{"pageSize":20}'

MCP call example (for AI assistants)

AI assistants send this call themselves when you ask in plain words; you only need it when debugging an MCP connection.

{
  "name": "dms_catalog_products_search",
  "arguments": {
    "args": {
      "pageSize": 20
    }
  }
}

Outlet visit check-ins

ReadScope: dms:read

dms_checkins_search

Outlet visit check-ins by employee and date range, within the caller's visible scope.

Parameter	Type	Required	Description
`employeeId`	string	no	Employee id
`dateFrom`	string	no	From date (yyyy-MM-dd)
`dateTo`	string	no	To date (yyyy-MM-dd)
`page`	integer	no	Page, starting at 1
`pageSize`	integer	no	Rows per page, max 50

Or call over REST with an API key

curl -X POST https://api.nextx.vn/api/v1/ai/tools/dms/dms_checkins_search/read \
  -H "X-Api-Key: $API_KEY" -H "Content-Type: application/json" \
  -d '{"dateFrom":"2026-10-27","dateTo":"2026-10-27"}'

MCP call example (for AI assistants)

AI assistants send this call themselves when you ask in plain words; you only need it when debugging an MCP connection.

{
  "name": "dms_checkins_search",
  "arguments": {
    "args": {
      "dateFrom": "2026-10-27",
      "dateTo": "2026-10-27"
    }
  }
}

Daily route plan details

ReadScope: dms:read

dms_daily_plans_get

Details of one daily route plan: stops and the status of each stop.

Parameter	Type	Required	Description
`id`	string	yes	Plan id (from dms_daily_plans_search)

Or call over REST with an API key

curl -X POST https://api.nextx.vn/api/v1/ai/tools/dms/dms_daily_plans_get/read \
  -H "X-Api-Key: $API_KEY" -H "Content-Type: application/json" \
  -d '{"id":"0199a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"}'

MCP call example (for AI assistants)

AI assistants send this call themselves when you ask in plain words; you only need it when debugging an MCP connection.

{
  "name": "dms_daily_plans_get",
  "arguments": {
    "args": {
      "id": "0199a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"
    }
  }
}

Daily route plans

ReadScope: dms:read

dms_daily_plans_search

Daily route plans by date, employee and status, within the caller's visible scope.

Parameter	Type	Required	Description
`planDate`	string	no	Plan date (yyyy-MM-dd)
`employeeId`	string	no	Employee id
`status`	string	no	Plan status
`page`	integer	no	Page, starting at 1
`pageSize`	integer	no	Rows per page, max 50

Or call over REST with an API key

curl -X POST https://api.nextx.vn/api/v1/ai/tools/dms/dms_daily_plans_search/read \
  -H "X-Api-Key: $API_KEY" -H "Content-Type: application/json" \
  -d '{"planDate":"2026-10-27"}'

MCP call example (for AI assistants)

AI assistants send this call themselves when you ask in plain words; you only need it when debugging an MCP connection.

{
  "name": "dms_daily_plans_search",
  "arguments": {
    "args": {
      "planDate": "2026-10-27"
    }
  }
}

Search distribution orders

ReadScope: dms:read

dms_orders_search

Distribution orders by outlet, status, date range or keyword, within the caller's visible scope.

Parameter	Type	Required	Description
`q`	string	no	Order code or customer name
`outletId`	string	no	Outlet id
`status`	string	no	Order status
`dateFrom`	string	no	From date (yyyy-MM-dd)
`dateTo`	string	no	To date (yyyy-MM-dd)
`page`	integer	no	Page, starting at 1
`pageSize`	integer	no	Rows per page, max 50

Or call over REST with an API key

curl -X POST https://api.nextx.vn/api/v1/ai/tools/dms/dms_orders_search/read \
  -H "X-Api-Key: $API_KEY" -H "Content-Type: application/json" \
  -d '{"dateFrom":"2026-10-01","dateTo":"2026-10-27"}'

MCP call example (for AI assistants)

AI assistants send this call themselves when you ask in plain words; you only need it when debugging an MCP connection.

{
  "name": "dms_orders_search",
  "arguments": {
    "args": {
      "dateFrom": "2026-10-01",
      "dateTo": "2026-10-27"
    }
  }
}

Search outlets

ReadScope: dms:read

dms_outlets_search

Search outlets by name, code or phone: address, channel, status, route and assigned employee.

Parameter	Type	Required	Description
`q`	string	no	Outlet name, code or phone
`status`	string	no	Outlet status
`routeId`	string	no	Route id (from dms_routes_search)
`page`	integer	no	Page, starting at 1
`pageSize`	integer	no	Rows per page, max 50

Or call over REST with an API key

curl -X POST https://api.nextx.vn/api/v1/ai/tools/dms/dms_outlets_search/read \
  -H "X-Api-Key: $API_KEY" -H "Content-Type: application/json" \
  -d '{"q":"Tạp hoá"}'

MCP call example (for AI assistants)

AI assistants send this call themselves when you ask in plain words; you only need it when debugging an MCP connection.

{
  "name": "dms_outlets_search",
  "arguments": {
    "args": {
      "q": "Tạp hoá"
    }
  }
}

Sales routes

ReadScope: dms:read

dms_routes_search

List sales routes: name, code, run days, outlet count and employee; filter by status, employee, keyword.

Parameter	Type	Required	Description
`q`	string	no	Route name or code
`status`	string	no	Route status
`employeeId`	string	no	Employee id
`page`	integer	no	Page, starting at 1
`pageSize`	integer	no	Rows per page, max 50

Or call over REST with an API key

curl -X POST https://api.nextx.vn/api/v1/ai/tools/dms/dms_routes_search/read \
  -H "X-Api-Key: $API_KEY" -H "Content-Type: application/json" \
  -d '{"q":"Tuyến Quận 1"}'

MCP call example (for AI assistants)

AI assistants send this call themselves when you ask in plain words; you only need it when debugging an MCP connection.

{
  "name": "dms_routes_search",
  "arguments": {
    "args": {
      "q": "Tuyến Quận 1"
    }
  }
}

On-van stock by SKU

ReadScope: dms:read

dms_van_inventory_get

Current on-van stock for the given SKUs across unclosed shifts: loaded, sold, returned, adjusted and remaining, with van, date and shift status.

Parameter	Type	Required	Description
`productSkus`	string[]	yes	List of SKUs

Or call over REST with an API key

curl -X POST https://api.nextx.vn/api/v1/ai/tools/dms/dms_van_inventory_get/read \
  -H "X-Api-Key: $API_KEY" -H "Content-Type: application/json" \
  -d '{"productSkus":["SP001","SP002"]}'

MCP call example (for AI assistants)

AI assistants send this call themselves when you ask in plain words; you only need it when debugging an MCP connection.

{
  "name": "dms_van_inventory_get",
  "arguments": {
    "args": {
      "productSkus": [
        "SP001",
        "SP002"
      ]
    }
  }
}

Low on-van stock

ReadScope: dms:read

dms_van_inventory_low_stock

SKUs on vans (unclosed shifts) with stock at or below a threshold, lowest first.

Parameter	Type	Required	Description
`threshold`	integer	yes	Stock threshold

Or call over REST with an API key

curl -X POST https://api.nextx.vn/api/v1/ai/tools/dms/dms_van_inventory_low_stock/read \
  -H "X-Api-Key: $API_KEY" -H "Content-Type: application/json" \
  -d '{"threshold":10}'

MCP call example (for AI assistants)

AI assistants send this call themselves when you ask in plain words; you only need it when debugging an MCP connection.

{
  "name": "dms_van_inventory_low_stock",
  "arguments": {
    "args": {
      "threshold": 10
    }
  }
}

Van loading history

ReadScope: dms:read

dms_van_load_history

Van loading slip history by date range: slip code, created time, driver, status, line count and lines issued differently from the request; paginated with total.

Parameter	Type	Required	Description
`dateFrom`	string	no	From date (YYYY-MM-DD)
`dateTo`	string	no	To date (YYYY-MM-DD)
`status`	string	no	Slip status
`page`	integer	no	Page, starting at 1
`pageSize`	integer	no	Rows per page, max 50

Or call over REST with an API key

curl -X POST https://api.nextx.vn/api/v1/ai/tools/dms/dms_van_load_history/read \
  -H "X-Api-Key: $API_KEY" -H "Content-Type: application/json" \
  -d '{"dateFrom":"2026-10-20","dateTo":"2026-10-27"}'

MCP call example (for AI assistants)

AI assistants send this call themselves when you ask in plain words; you only need it when debugging an MCP connection.

{
  "name": "dms_van_load_history",
  "arguments": {
    "args": {
      "dateFrom": "2026-10-20",
      "dateTo": "2026-10-27"
    }
  }
}