khanhn/vhrms
1
0
Fork 0
forked from tant/vhrms
Code Pull requests Activity
Vietnam HRMS extension for Frappe HR. Adds Vietnam-specific payroll: Social Insurance (BHXH/BHYT/BHTN), Progressive PIT calculation, Tax Dependents (NPT), Regional Minimum Wages, OT rates per Labor Code 2019. Fully compliant with Vietnamese regulations.
126 commits 8 branches 1 tag 778 KiB
  • Python 93.8%
  • JavaScript 3.3%
  • HTML 2.9%
Find a file
Exact
tant 70dda95d65 Merge pull request 'feat(payroll): PC_AT default 730k + clean up Tax Deduction 2024' (#2) from khanhn/vhrms:feat/TETRA-1328-vhrms-phase1-seed-salary into main 
Reviewed-on: tant/vhrms#2
2026-04-20 19:29:31 +07:00
vhrms chore(payroll): bỏ Vietnam Tax Deduction 2024 — chỉ giữ mức NQ 110/2025 2026-04-20 19:11:49 +07:00
.editorconfig feat: Initialize App 2025-12-13 14:28:00 +00:00
.eslintrc feat: Initialize App 2025-12-13 14:28:00 +00:00
.gitignore chore: ignore .playwright-mcp/ 2026-04-19 08:40:33 +04:00
.pre-commit-config.yaml feat: Initialize App 2025-12-13 14:28:00 +00:00
CHANGELOG.md fix: correct all frappe.log_error() signatures for Frappe v16 (v0.3.2) 2026-04-02 21:45:50 +04:00
HUONG_DAN_SU_DUNG.md docs: update README + HUONG_DAN_SU_DUNG with COA, Payroll Settings, VAS accounts 2026-04-01 21:32:47 +04:00
license.txt feat: Initialize App 2025-12-13 14:28:00 +00:00
pyproject.toml Upgrade to Frappe v16 compatibility 2026-01-26 16:57:37 +07:00
README.md docs: update README + HUONG_DAN_SU_DUNG with COA, Payroll Settings, VAS accounts 2026-04-01 21:32:47 +04:00

README.md

VHRMS - Vietnam HRMS

Ứng dụng mở rộng cho Frappe HRMS, bổ sung tuân thủ quy định lao động Việt Nam.

Tính năng chính:

  • Hệ thống tài khoản kế toán theo Thông tư 200/2014/TT-BTC (243 tài khoản, 3 cấp)
  • Bảo hiểm xã hội (BHXH, BHYT, BHTN, Công đoàn) với tính trần tự động
  • Thuế TNCN lũy tiến 7 bậc, quản lý NPT (người phụ thuộc)
  • Lương tối thiểu vùng, mức lương cơ sở, giảm trừ gia cảnh
  • Tăng ca theo BLLĐ 2019 (Điều 98, 107) - auto-detect ngày lễ/cuối tuần/ca đêm
  • Hồ sơ nhân viên theo TT 06/2023/TT-BNV (80+ custom fields)
  • Quản lý nhà thầu theo Luật Đấu thầu 2023 & NĐ 214/2025
  • Báo cáo D02-TS, D03-TS, C70a-HD, PIT Monthly, NPT (Mẫu 20)
  • Ngày lễ Việt Nam (bao gồm lịch âm + T7/CN weekly off), gross-up calculation
  • Auto-configure Payroll Settings, Salary Component accounts theo VAS
  • REST API cho tích hợp hệ thống bên ngoài

Yêu cầu: Frappe v16, ERPNext v16, HRMS v16, Python 3.10+

Installation

cd $PATH_TO_YOUR_BENCH
bench get-app https://wedev.carp.vn/carptech/vhrms.git --branch develop
bench --site [site-name] install-app vhrms
bench --site [site-name] migrate

Xem HUONG_DAN_SU_DUNG.md để biết chi tiết cài đặt và sử dụng.

Contributing

This app uses pre-commit for code formatting and linting:

cd apps/vhrms
pre-commit install

Tools: ruff, eslint, prettier, pyupgrade

License

MIT