Công cụ AI — Hoá đơn điện tử

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

Chi tiết hoá đơn điện tử

ĐọcScope: einvoice:read

einvoice_invoices_get

Chi tiết một hoá đơn điện tử: người mua, dòng hàng, thuế và trạng thái phát hành.

Tham số	Kiểu	Bắt buộc	Mô tả
`id`	string	có	Id hoá đơn (lấy từ einvoice_invoices_search)

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

curl -X POST https://api.nextx.vn/api/v1/ai/tools/einvoice/einvoice_invoices_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": "einvoice_invoices_get",
  "arguments": {
    "args": {
      "id": "0199a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"
    }
  }
}

Tìm hoá đơn điện tử

ĐọcScope: einvoice:read

einvoice_invoices_search

Danh sách hoá đơn điện tử có phân trang, lọc theo trạng thái (DRAFT, PENDING, ISSUED, ADJUSTED, CANCELLED, ERROR), khoảng ngày, từ khoá và nguồn.

Tham số	Kiểu	Bắt buộc	Mô tả
`status`	string	không	Trạng thái hoá đơn
`fromDate`	string	không	Từ ngày (yyyy-MM-dd)
`toDate`	string	không	Đến ngày (yyyy-MM-dd)
`keyword`	string	không	Số hoá đơn hoặc tên người mua
`source`	string	không	Nguồn: sales_order, gym_contract hoặc manual
`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/einvoice/einvoice_invoices_search/read \
  -H "X-Api-Key: $API_KEY" -H "Content-Type: application/json" \
  -d '{"status":"ISSUED","fromDate":"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": "einvoice_invoices_search",
  "arguments": {
    "args": {
      "status": "ISSUED",
      "fromDate": "2026-10-01"
    }
  }
}

Tổng hợp hoá đơn theo trạng thái

ĐọcScope: einvoice:read

einvoice_reports_summary

Số hoá đơn và tổng giá trị theo trạng thái trong một khoảng ngày; bỏ trống ngày thì lấy mọi thời gian.

Tham số	Kiểu	Bắt buộc	Mô tả
`fromDate`	string	không	Từ ngày (yyyy-MM-dd)
`toDate`	string	không	Đến ngày (yyyy-MM-dd)

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

curl -X POST https://api.nextx.vn/api/v1/ai/tools/einvoice/einvoice_reports_summary/read \
  -H "X-Api-Key: $API_KEY" -H "Content-Type: application/json" \
  -d '{"fromDate":"2026-10-01","toDate":"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": "einvoice_reports_summary",
  "arguments": {
    "args": {
      "fromDate": "2026-10-01",
      "toDate": "2026-10-27"
    }
  }
}

Ký hiệu hoá đơn

ĐọcScope: einvoice:read

einvoice_series_list

Các ký hiệu hoá đơn của doanh nghiệp, đang dùng và đã tắt, lọc theo nhà cung cấp hoá đơn.

Tham số	Kiểu	Bắt buộc	Mô tả
`providerCode`	string	không	Nhà cung cấp: Misa, Vnpt, Viettel, Fpt, Bkav hoặc WinInvoice

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

curl -X POST https://api.nextx.vn/api/v1/ai/tools/einvoice/einvoice_series_list/read \
  -H "X-Api-Key: $API_KEY" -H "Content-Type: application/json" \
  -d '{"providerCode":"Misa"}'

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": "einvoice_series_list",
  "arguments": {
    "args": {
      "providerCode": "Misa"
    }
  }
}

Tài khoản nhà cung cấp hoá đơn

ĐọcScope: einvoice:read

einvoice_settings_list

Các tài khoản nhà cung cấp hoá đơn điện tử đã kết nối: nhà cung cấp, chế độ thử, tự phát hành và thông tin bên bán. Không trả khoá hay mật khẩu.

Không có tham số.

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

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

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": "einvoice_settings_list",
  "arguments": {
    "args": {}
  }
}