Công cụ AI — Bán hàng

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

Tìm khách mua

ĐọcScope: sales:read

sales_customers_search

Tìm khách mua theo tên, mã khách hoặc số điện thoại, kèm số đơn, doanh thu (đã trừ trả hàng), công nợ, lần mua gần nhất và người phụ trách.

Tham số	Kiểu	Bắt buộc	Mô tả
`q`	string	không	Tên, mã khách hoặc số điện thoại
`status`	string	không	Trạng thái khá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/sales/sales_customers_search/read \
  -H "X-Api-Key: $API_KEY" -H "Content-Type: application/json" \
  -d '{"q":"0901234567"}'

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": "sales_customers_search",
  "arguments": {
    "args": {
      "q": "0901234567"
    }
  }
}

Đơn hàng theo danh sách id

ĐọcScope: sales:read

sales_orders_get

Thông tin tóm tắt của các đơn hàng theo danh sách id: mã đơn, loại, trạng thái, khách, tổng tiền, đã thu, còn nợ, ngày đặt.

Tham số	Kiểu	Bắt buộc	Mô tả
`orderIds`	string[]	có	Danh sách id đơn hàng (tối đa 100)

Hoặc gọi REST bằng API key

curl -X POST https://api.nextx.vn/api/v1/ai/tools/sales/sales_orders_get/read \
  -H "X-Api-Key: $API_KEY" -H "Content-Type: application/json" \
  -d '{"orderIds":["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": "sales_orders_get",
  "arguments": {
    "args": {
      "orderIds": [
        "0199a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"
      ]
    }
  }
}

Tìm đơn hàng

ĐọcScope: sales:read

sales_orders_search

Tìm đơn hàng theo mã đơn, tên khách hoặc tên sản phẩm, lọc theo loại đơn, trạng thái, khoảng ngày và đơn còn nợ; trả tổng số khớp kèm một trang kết quả.

Tham số	Kiểu	Bắt buộc	Mô tả
`q`	string	không	Mã đơn, tên khách hoặc tên sản phẩm
`status`	string	không	Trạng thái đơn, nhiều trạng thái cách nhau bằng dấu phẩy
`orderType`	string	không	Loại đơn, vd SALES_ORDER, PRE_ORDER
`dateFrom`	string	không	Ngày đặt từ (YYYY-MM-DD)
`dateTo`	string	không	Ngày đặt đến (YYYY-MM-DD)
`hasDebt`	boolean	không	true = chỉ đơn còn 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/sales/sales_orders_search/read \
  -H "X-Api-Key: $API_KEY" -H "Content-Type: application/json" \
  -d '{"hasDebt":true,"dateFrom":"2026-10-01"}'

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": "sales_orders_search",
  "arguments": {
    "args": {
      "hasDebt": true,
      "dateFrom": "2026-10-01"
    }
  }
}

Tìm sản phẩm và tồn kho

ĐọcScope: sales:read

sales_products_search

Tìm sản phẩm theo tên, mã hàng hoặc mã vạch, lọc theo trạng thái và khoảng tồn kho; mỗi dòng có giá bán, tồn hiện tại và định mức tồn tối thiểu.

Tham số	Kiểu	Bắt buộc	Mô tả
`q`	string	không	Tên, mã hàng hoặc mã vạch
`status`	string	không	ACTIVE hoặc INACTIVE
`stockFrom`	number	không	Tồn kho từ (>=)
`stockTo`	number	không	Tồn kho đến (<=); đặt 0 để lấy hàng đã hế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/sales/sales_products_search/read \
  -H "X-Api-Key: $API_KEY" -H "Content-Type: application/json" \
  -d '{"stockTo":0}'

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": "sales_products_search",
  "arguments": {
    "args": {
      "stockTo": 0
    }
  }
}

Tồn kho theo chi nhánh

ĐọcScope: sales:read

sales_products_stock

Tồn kho của một sản phẩm tách theo từng chi nhánh.

Tham số	Kiểu	Bắt buộc	Mô tả
`productId`	string	có	Id sản phẩm (lấy từ sales_products_search)

Hoặc gọi REST bằng API key

curl -X POST https://api.nextx.vn/api/v1/ai/tools/sales/sales_products_stock/read \
  -H "X-Api-Key: $API_KEY" -H "Content-Type: application/json" \
  -d '{"productId":"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": "sales_products_stock",
  "arguments": {
    "args": {
      "productId": "0199a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"
    }
  }
}