Công cụ AI — DMS

10 công cụ. Schema luôn mới nhất ở dms_tool_catalog khi đã kết nối.

Danh mục sản phẩm phân phối

ĐọcScope: dms:read

dms_catalog_products_search

Danh mục sản phẩm bán qua kênh phân phối: mã, tên, đơn vị, giá; có phân trang.

Tham số	Kiểu	Bắt buộc	Mô tả
`page`	integer	không	Trang, bắt đầu từ 1
`pageSize`	integer	không	Số dòng mỗi trang, tối đa 50

Hoặc gọi REST bằng 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}'

Ví dụ gọi qua MCP (dành cho trợ lý AI)

Trợ lý AI tự gửi lệnh này khi bạn hỏi bằng lời; bạn chỉ cần xem khi tự gỡ lỗi kết nối MCP.

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

Lượt viếng thăm điểm bán

ĐọcScope: dms:read

dms_checkins_search

Lượt check-in viếng thăm điểm bán theo nhân viên và khoảng ngày, trong phạm vi người dùng được xem.

Tham số	Kiểu	Bắt buộc	Mô tả
`employeeId`	string	không	Id nhân viên
`dateFrom`	string	không	Từ ngày (yyyy-MM-dd)
`dateTo`	string	không	Đến ngày (yyyy-MM-dd)
`page`	integer	không	Trang, bắt đầu từ 1
`pageSize`	integer	không	Số dòng mỗi trang, tối đa 50

Hoặc gọi REST bằng 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"}'

Ví dụ gọi qua MCP (dành cho trợ lý AI)

Trợ lý AI tự gửi lệnh này khi bạn hỏi bằng lời; bạn chỉ cần xem khi tự gỡ lỗi kết nối MCP.

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

Chi tiết kế hoạch đi tuyến

ĐọcScope: dms:read

dms_daily_plans_get

Chi tiết một kế hoạch đi tuyến trong ngày: các điểm dừng và trạng thái từng điểm.

Tham số	Kiểu	Bắt buộc	Mô tả
`id`	string	có	Id kế hoạch (lấy từ dms_daily_plans_search)

Hoặc gọi REST bằng 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"}'

Ví dụ gọi qua MCP (dành cho trợ lý AI)

Trợ lý AI tự gửi lệnh này khi bạn hỏi bằng lời; bạn chỉ cần xem khi tự gỡ lỗi kết nối MCP.

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

Kế hoạch đi tuyến theo ngày

ĐọcScope: dms:read

dms_daily_plans_search

Kế hoạch đi tuyến theo ngày, nhân viên và trạng thái, trong phạm vi người dùng được xem.

Tham số	Kiểu	Bắt buộc	Mô tả
`planDate`	string	không	Ngày kế hoạch (yyyy-MM-dd)
`employeeId`	string	không	Id nhân viên
`status`	string	không	Trạng thái kế hoạch
`page`	integer	không	Trang, bắt đầu từ 1
`pageSize`	integer	không	Số dòng mỗi trang, tối đa 50

Hoặc gọi REST bằng 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"}'

Ví dụ gọi qua MCP (dành cho trợ lý AI)

Trợ lý AI tự gửi lệnh này khi bạn hỏi bằng lời; bạn chỉ cần xem khi tự gỡ lỗi kết nối MCP.

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

Tìm đơn phân phối

ĐọcScope: dms:read

dms_orders_search

Đơn hàng kênh phân phối theo điểm bán, trạng thái, khoảng ngày hoặc từ khoá, trong phạm vi người dùng được xem.

Tham số	Kiểu	Bắt buộc	Mô tả
`q`	string	không	Mã đơn hoặc tên khách
`outletId`	string	không	Id điểm bán
`status`	string	không	Trạng thái đơn
`dateFrom`	string	không	Từ ngày (yyyy-MM-dd)
`dateTo`	string	không	Đến ngày (yyyy-MM-dd)
`page`	integer	không	Trang, bắt đầu từ 1
`pageSize`	integer	không	Số dòng mỗi trang, tối đa 50

Hoặc gọi REST bằng 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"}'

Ví dụ gọi qua MCP (dành cho trợ lý AI)

Trợ lý AI tự gửi lệnh này khi bạn hỏi bằng lời; bạn chỉ cần xem khi tự gỡ lỗi kết nối MCP.

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

Tìm điểm bán

ĐọcScope: dms:read

dms_outlets_search

Tìm điểm bán theo tên, mã hoặc số điện thoại: địa chỉ, kênh, trạng thái, tuyến và nhân viên phụ trách.

Tham số	Kiểu	Bắt buộc	Mô tả
`q`	string	không	Tên, mã hoặc số điện thoại điểm bán
`status`	string	không	Trạng thái điểm bán
`routeId`	string	không	Id tuyến (lấy từ dms_routes_search)
`page`	integer	không	Trang, bắt đầu từ 1
`pageSize`	integer	không	Số dòng mỗi trang, tối đa 50

Hoặc gọi REST bằng 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á"}'

Ví dụ gọi qua MCP (dành cho trợ lý AI)

Trợ lý AI tự gửi lệnh này khi bạn hỏi bằng lời; bạn chỉ cần xem khi tự gỡ lỗi kết nối MCP.

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

Tuyến bán hàng

ĐọcScope: dms:read

dms_routes_search

Danh sách tuyến bán hàng: tên, mã, ngày chạy, số điểm và nhân viên; lọc theo trạng thái, nhân viên, từ khoá.

Tham số	Kiểu	Bắt buộc	Mô tả
`q`	string	không	Tên hoặc mã tuyến
`status`	string	không	Trạng thái tuyến
`employeeId`	string	không	Id nhân viên
`page`	integer	không	Trang, bắt đầu từ 1
`pageSize`	integer	không	Số dòng mỗi trang, tối đa 50

Hoặc gọi REST bằng 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"}'

Ví dụ gọi qua MCP (dành cho trợ lý AI)

Trợ lý AI tự gửi lệnh này khi bạn hỏi bằng lời; bạn chỉ cần xem khi tự gỡ lỗi kết nối MCP.

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

Tồn trên xe theo mã hàng

ĐọcScope: dms:read

dms_van_inventory_get

Tồn hiện tại trên xe của các mã hàng ở những ca chưa chốt: đã nhập lên xe, đã bán, đã trả về, đã điều chỉnh, tồn còn lại, kèm xe, ngày và trạng thái ca.

Tham số	Kiểu	Bắt buộc	Mô tả
`productSkus`	string[]	có	Danh sách mã hàng (SKU)

Hoặc gọi REST bằng 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"]}'

Ví dụ gọi qua MCP (dành cho trợ lý AI)

Trợ lý AI tự gửi lệnh này khi bạn hỏi bằng lời; bạn chỉ cần xem khi tự gỡ lỗi kết nối MCP.

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

Hàng trên xe sắp hết

ĐọcScope: dms:read

dms_van_inventory_low_stock

Mã hàng trên xe (ca chưa chốt) có tồn nhỏ hơn hoặc bằng một ngưỡng, ít nhất xếp trước.

Tham số	Kiểu	Bắt buộc	Mô tả
`threshold`	integer	có	Ngưỡng tồn

Hoặc gọi REST bằng 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}'

Ví dụ gọi qua MCP (dành cho trợ lý AI)

Trợ lý AI tự gửi lệnh này khi bạn hỏi bằng lời; bạn chỉ cần xem khi tự gỡ lỗi kết nối MCP.

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

Lịch sử phiếu lấy hàng lên xe

ĐọcScope: dms:read

dms_van_load_history

Lịch sử phiếu lấy hàng lên xe theo khoảng ngày: mã phiếu, thời điểm lập, tài xế, trạng thái, số dòng hàng và số dòng xuất lệch so với yêu cầu; có phân trang và tổng số.

Tham số	Kiểu	Bắt buộc	Mô tả
`dateFrom`	string	không	Từ ngày (YYYY-MM-DD)
`dateTo`	string	không	Đến ngày (YYYY-MM-DD)
`status`	string	không	Trạng thái phiếu
`page`	integer	không	Trang, bắt đầu từ 1
`pageSize`	integer	không	Số dòng mỗi trang, tối đa 50

Hoặc gọi REST bằng 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"}'

Ví dụ gọi qua MCP (dành cho trợ lý AI)

Trợ lý AI tự gửi lệnh này khi bạn hỏi bằng lời; bạn chỉ cần xem khi tự gỡ lỗi kết nối MCP.

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