AI tools — E-invoice

5 tools. The latest schema is always in einvoice_tool_catalog once connected.

E-invoice details

ReadScope: einvoice:read

einvoice_invoices_get

Details of one e-invoice: buyer, line items, tax and issuance status.

Parameter	Type	Required	Description
`id`	string	yes	Invoice id (from einvoice_invoices_search)

Or call over REST with an 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"}'

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": "einvoice_invoices_get",
  "arguments": {
    "args": {
      "id": "0199a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"
    }
  }
}

Search e-invoices

ReadScope: einvoice:read

einvoice_invoices_search

Paginated e-invoice list, filtered by status (DRAFT, PENDING, ISSUED, ADJUSTED, CANCELLED, ERROR), date range, keyword and source.

Parameter	Type	Required	Description
`status`	string	no	Invoice status
`fromDate`	string	no	From date (yyyy-MM-dd)
`toDate`	string	no	To date (yyyy-MM-dd)
`keyword`	string	no	Invoice number or buyer name
`source`	string	no	Source: sales_order, gym_contract or manual
`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/einvoice/einvoice_invoices_search/read \
  -H "X-Api-Key: $API_KEY" -H "Content-Type: application/json" \
  -d '{"status":"ISSUED","fromDate":"2026-10-01"}'

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": "einvoice_invoices_search",
  "arguments": {
    "args": {
      "status": "ISSUED",
      "fromDate": "2026-10-01"
    }
  }
}

Invoice summary by status

ReadScope: einvoice:read

einvoice_reports_summary

Invoice count and total value by status for a date range; all time when dates are omitted.

Parameter	Type	Required	Description
`fromDate`	string	no	From date (yyyy-MM-dd)
`toDate`	string	no	To date (yyyy-MM-dd)

Or call over REST with an 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"}'

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": "einvoice_reports_summary",
  "arguments": {
    "args": {
      "fromDate": "2026-10-01",
      "toDate": "2026-10-27"
    }
  }
}

Invoice series

ReadScope: einvoice:read

einvoice_series_list

The company's invoice series, active and disabled, filtered by e-invoice provider.

Parameter	Type	Required	Description
`providerCode`	string	no	Provider: Misa, Vnpt, Viettel, Fpt, Bkav or WinInvoice

Or call over REST with an 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"}'

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

E-invoice provider accounts

ReadScope: einvoice:read

einvoice_settings_list

Connected e-invoice provider accounts: provider, test mode, auto-issue and seller info. Never returns keys or passwords.

No parameters.

Or call over REST with an 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 '{}'

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