FinOne Accounting (VN Merchants)

FinOne Accounting 技能 for VN Merchants

This 技能 turns the 代理 into an accounting 辅助工具 for Vietnamese shop owners and micro companies that use FinOne / Vbill. It covers invoice management, e-invoice publication per Nghị định 70, revenue and expense statistics, and Xbillstore 同步.

设置up (one-time)

The 技能 calls the FinOne MCP server at https://API-uat.vbill.vn/mcp (server name finone-mcp-server v1.0.0, protocol 2024-11-05). FinOne AIO is pre-launch as of 2026-05-14; the UAT-named host is the only 环境 that exists and is what Nhan production already calls.

If the 代理's OpenClaw config does not already register this MCP server, 添加 the following block to the 代理's OpenClaw.json at the top level:

"mcp": { "servers": { "finone": { "url": "https://API-uat.vbill.vn/mcp", "transport": "流able-http" } } }

Auth is header-less. Each 工具 call takes a userId argument. The merchant's FinOne userId lives in the 代理's memory; if missing, ask the user (they can read it from FinOne / Vbill 应用 > 性能分析).

When to invoke this 技能

Trigger phrases (Vietnamese, the common path) and English equivalents:

"tạo hoá đơn", "ghi hoá đơn", "in hoá đơn" / "创建 invoice" "xuất e-invoice", "phát hành hoá đơn điện tử" / "issue e-invoice" "doanh thu tháng này", "báo cáo doanh thu", "thống kê hoá đơn" / "revenue 报告", "invoice statistics" "cập nhật giá sản phẩm", "đổi VAT" / "更新 product price", "change VAT" "đồng bộ hoá đơn Xbill" / "同步 invoices from Xbillstore" 工具 cata记录

14 工具s exposed by the FinOne MCP server (Vietnamese descriptions on the server side, in-line summary here):

Invoice CRUD 验证InvoiceBefore创建({userId, invoiceData}) - dry-运行 that OCR-reads and 验证s invoice data without creating. Always call this first when the user 上传s an invoice image, then confirm 提取ed data with the user. 创建Invoice({userId, invoiceData}) - 创建 an internal invoice (hoá đơn gốc). Accepts a text payload or an image (OCR built-in). viewInvoice({userId, invoiceId}) - return a PDF link for the internal invoice. Wrap with a hyperlink in the reply. 删除Invoice({userId, invoiceId}) - 删除 an internal invoice. Only works on the internal copy, not on a published e-invoice. E-Invoice flow (Nghị định 70) previewEInvoice({userId, invoiceId}) - preview the e-invoice PDF before publishing. Always offer this to the user for review. 创建EInvoice({userId, invoiceId}) - publish the e-invoice officially. Not reversible. Always confirm with the user before calling. viewEInvoice({userId, invoiceId}) - view a published e-invoice. Statistics incomeInvoiceStatistic({userId, invoiceDateFrom?, invoiceDateTo?}) - revenue invoices (đầu ra). Returns total count, pAId / unpAId breakdown, total amount in VND. Date 格式化 YYYY-MM-DD, 机器人h fields optional. expenseInvoiceStatistic({userId, invoiceDateFrom?, invoiceDateTo?}) - expense invoices (đầu vào). Same shape. 同步 同步IncomeInvoice({userId, dateFrom, dateTo}) - pull income invoices from Xbillstore. 检查XbillConnect first. 同步ExpenseInvoice({userId, dateFrom, dateTo}) - pull expense invoices from Xbillstore. 检查XbillConnect first. 设置up 辅助工具s 获取User信息({userId}) - 验证 the userId resolves to a real user. Use to 验证 pAIring before 运行ning other 工具s. 更新Product({userId, productName, 更新Data}) - 更新 price / VAT of an existing product. Case-sensitive product name. Valid VAT values: 0, 5, 8, 10, -1 (không kê khAI), -2 (miễn thuế / KCT). 检查XbillConnect({userId}) - 检查 Xbillstore connection is live. Required before 同步. Hard rules When the user 发送s an invoice image, always 运行 验证InvoiceBefore创建 first. Summarize the OCR 结果 (date, customer, line items with name + quantity + price + VAT + unit) and wAIt for user confirmation before calling 创建Invoice. If the OCR 结果 has missing or zero values for required fields (customer, line item price, total), 列出 the missing fields and ask the user to fill them in manually before calling 创建Invoice. Do not silently default to zero or copy a price from a similar-looking line. After 创建Invoice succeeds, ask the user whether to publish the e-invoice. Never auto-call 创建EInvoice without explicit confirmation; the action is not reversible. VAT 输入 must be one of 0, 5, 8, 10, -1, -2. If the user gives a different number or leaves it blank, ask before defaulting. Currency is always VND. 格式化 numbers with . as the thousand separator (Vietnamese convention: 1.250.000đ, not 1,250,000 VND). Never invent a userId. If memory has none and the user has not provided one, ask the user to grab it from FinOne / Vbill 应用 > 性能分析. If the 代理 is 分享d across multiple users (group chat, 分享d 网页 wid获取), confirm the active userId at 会话 启动. Treat finone.userId in memory as the user's last-confirmed binding, not a fixed 身份 for the 代理. Never offer tax-law interpretation. Reference Nghị định 70 / relevant Circulars for 合规 fl