API · MCP · bộ ca kiểm mở

Lương, thuế TNCN, BHXH Việt Nam đúng luật theo ngày, cho phần mềm và AI agent

Gửi con số, nhận lương gross/net, thuế TNCN, bảo hiểm bắt buộc, kèm từng bước tính và văn bản căn cứ.

Không cần khoá: 30 lượt/phút và 1.000 lượt/ngày mỗi IP.

Gọi

curl -s https://api.maxmin.vn/v1/luong/gross-net \
  -H 'content-type: application/json' \
  -d '{"gross":30000000,"ngay_ap_dung":"2026-09-27","vung":"I"}'

Trả về (rút gọn)

{
  "ngay_ap_dung": "2026-09-27",
  "gross": 30000000,
  "bh_nld": 3150000,
  "thu_nhap_tinh_thue": 11350000,
  "thue_tncn": 635000,
  "bac": 2,
  "net": 26215000,
  "giai_trinh": [ ... ],
  "phien_ban_luat": "..."
}

Có gì

12 đường APIgross-net, net-gross, bảo hiểm, thuế TNCN, quyết toán năm, lương tối thiểu, tham số, nhật ký thay đổi, ca kiểm Máy chủ MCPStreamable HTTP tại mcp.maxmin.vn, dùng với Claude, Cursor, VS Code và client MCP khác 426 ca kiểmMở theo CC BY 4.0: đầu vào, kết quả mong đợi và lý do của từng ca Nhật ký thay đổiMáy đọc được, theo ngày hiệu lực, gồm cả mức đã ban hành cho ngày sau

Dành cho ai

Phần mềm HR, kế toán

Đo bộ máy tính lương của bạn bằng bộ ca kiểm công khai, theo nhật ký thay đổi thay vì đọc lại từng nghị định.

Payroll và EOR quốc tế

API tiếng Anh cho Việt Nam: biểu thuế 5 bậc và giảm trừ 2026, lương tối thiểu vùng, mức trần, có ngày hiệu lực.

Người dựng AI agent

Máy chủ MCP để agent gọi, không đoán số thuế từ trí nhớ.

Không nhận dữ liệu định danh

API chỉ nhận con số (lương, số người phụ thuộc, vùng, ngày). Không nhận tên, CCCD, mã số thuế.

Mỗi con số có căn cứ

35 tham số, mỗi mức có ngày hiệu lực và điều khoản văn bản (54 văn bản). 16 tham số đang gắn can_ra_soat (chưa đối chiếu nguyên văn bản gốc) và được liệt kê trong mọi kết quả dùng tới chúng.

Căn cứ tra lần gần nhất: 27/09/2026

Bắt đầu trong một phút

Gọi API không cần khoá từ sân thử hoặc curl.
Thêm máy chủ MCP vào agent: claude mcp add --transport http maxmin https://mcp.maxmin.vn/mcp
Cần hạn mức cao hơn? Đăng ký khoá miễn phí. Đăng ký