KiotViet MCP by usefulapi

WRITE: create a new customer in the shop (name required; code is generated by KiotViet if omitted). Always check with the user first, and look the customer up by phone before creating a duplicate. POST /customers.

WRITE: create a sales order (an order, not an invoice: no invoice is made and no payment is recorded) with lines of existing products in a branch, for an existing customer or none. Always confirm the products, quantities and prices with the user first. POST /orders.

One product category by id (name, parent, children). GET /categories/{id}.

One customer by id: contact data, debt, total invoiced, reward points, groups. GET /customers/{id}.

One customer by customer code. GET /customers/code/{code}.

One invoice by id with its lines, payments and delivery. GET /invoices/{id}.

One invoice by invoice code (for example HD000123). GET /invoices/code/{code}.

One sales order by id with its lines, payments and delivery. GET /orders/{id}.

One sales order by order code (for example DH000123). GET /orders/code/{code}.

The product prices of one price book (product id, code, price), paged. GET /pricebooks/{id}.

One product by id: code, barcode, name, category, base price, units, attributes, images, stock per branch and price books. GET /products/{id}.

One product by its product code (SKU). GET /products/code/{code}.

One goods receipt (nhap hang) by id with its lines. GET /purchaseorders/{id}.

One customer return by id with its lines. GET /returns/{id}.

One supplier by id. GET /suppliers/{id}.

List the shop's branches (id, name, code, phone, address). Use the ids to filter other tools. GET /branches.

List cash-book entries (receipts and payments: code, branch, method, partner, amount, date, status). Filter by branch, direction or date range. GET /cashflow.

List product categories (id, name, parent, whether it has children). Set hierarchical to get the category tree. GET /categories.

List customers (code, name, phone, email, address, debt, total invoiced, reward points, groups). Contains personal data of the shop's customers. Filter by code, name, phone, group or last change. GET /customers.

List sales invoices (code, date, branch, customer, total, amount paid, status, lines). Filter by branch, customer, status, order, purchase-date range or last change. GET /invoices.

List sales orders (code, date, branch, customer, total, status, lines, delivery). Filter by branch, customer, status, creation date (from) or last change (from/to). GET /orders.

List price books (bang gia: name, active flag, validity dates, branches, customer groups). GET /pricebooks.

List products (code, barcode, name, category, base price, units, attributes). Optionally include stock per branch (include_inventory) and price-book prices. Filter by name, category, branch, active flag or last change. GET /products.

List goods receipts from suppliers (nhap hang: code, date, branch, supplier, total, lines). Filter by branch, status or purchase-date range. GET /purchaseorders.

List customer returns (code, date, branch, customer, invoice, return total, lines). GET /returns.

Stock on hand and reserved quantity per product and branch. Filter by branch or last change. GET /productOnHands.

List orders placed with suppliers (dat hang nhap: code, date, branch, supplier, status, lines, amount paid). Filter by branch, status, supplier or product text. GET /ordersuppliers.

List suppliers (code, name, phone, email, address, debt, total invoiced). Filter by code, name, phone or last change. GET /suppliers.

List the shop's staff users (id, username, name, phone, email). GET /users.