Comfac Erpnext Localization
Comfac ERPNext Localization
Comfac Philippine Localization (CPL) is a free, open-source Frappe/ERPNext application delivering statutory compliance, workforce management, retail operations, and sustainability tracking tailored specifically to Philippine legal, tax, and operational requirements.
Built by Ambibuzz Technologies LLP as part of the BetterGov.ph Civic Tech Initiative.
Overview
CPL is a CSR initiative under the BetterGov.ph civic tech program. Generic, high-value industry modules commissioned by paying clients are open-sourced into CPL so every Filipino business and institution can benefit.
Core principle: Zero modifications to ERPNext core. All customizations use Frappe's fixture, hooks, and JavaScript injection mechanisms — keeping the app upgrade-safe.
Current Module: Bureau of Internal Revenue (BIR)
A custom Frappe application that replicates and extends standard ERPNext financial reports to support BIR (Bureau of Internal Revenue) – Philippines style statutory reporting and presentation requirements.
Included Reports
- Balance Sheet BIR — BIR-compliant balance sheet with schedule grouping
- Balance Sheet Schedule BIR — Schedule-grouped variant (SCHED 1–23)
Documentation
| Document | Description |
|---|---|
| Architecture and Structure Comfac ERPN Loc | Technical architecture, directory structure, and component details |
| Project Requirements Document Comfac ERPN Loc | Complete PRD with phases, requirements, and acceptance criteria |
| Roadmap Comfac ERPN Loc | Development roadmap and strategic guidelines |
| Phloc Skill Guide Comfac ERPN Loc | Developer guide for building and deploying Frappe/ERPNext customizations |
Key Features
Phase 1 — Core Compliance Foundation
- BIR-Compliant Chart of Accounts
- Standard Financial Statements (Balance Sheet, Income Statement, Cash Flow, Equity)
- Books of Accounts (CAS/AC Ready)
- EOPT-Compliant Document Templates
- Standard Schedules (AR, AP, Inventory)
Phase 2 — HRIS & Basic Philippine Payroll
- Mobile-First Daily Time Record (DTR) PWA
- Statutory Contribution Computation (SSS, PhilHealth, Pag-IBIG)
- Tax Annualization Engine
- BIR Form 2316 Generation
Phase 3 — MSME Retail & Payment Gateway
- BIR-Ready POS with Device Locking
- E-Wallet Integration (GCash, Maya via PayMongo/Xendit)
- Z-Reading and X-Reading Reports
Phase 4 — Advanced Industry & LGU Capabilities
- LGU Statutory Reporting
- Advanced Payroll Rules (Piece-rate, Hazard pay, Shifting)
Phase 5 — Sustainability & Carbon Footprint
- Carbon Footprint Tracker (CFT) Module
- ISO 14064 Ready Auditing
External Integrations
| Integration | Type | Phase |
|---|---|---|
| Secada (Paperless-ngx PH localization) | Document Management / OCR | Cross-phase |
| Synx-Scheduler | Operations & workforce scheduling | Phase 2+ |
| PayMongo / Xendit | Payment aggregator APIs | Phase 3 |
| BIR eServices | Statutory form submission | Phase 1+ |
| PenPlotter devices | Historical books export | Phase 1 |
Architectural Principles
- Domain-Based Toggling — Industry-specific features as Frappe Domains
- MSME-First Design — Philippine defaults pre-configured, understandable by non-technical users
- No Core Modifications — All customizations via Frappe's extend mechanisms
- AI-Friendly Documentation — Structured Markdown for RAG compatibility
- EOPT Act as Billing Baseline — Sales Invoice primary, OR supplementary
Technology Stack
| Layer | Technology |
|---|---|
| Framework | Frappe v15 |
| ERP | ERPNext v15 |
| Language | Python >= 3.10 |
| Build | flit_core |
| Formatter | Black (99 chars), isort |
| License | MIT |
Repository
- GitHub: https://github.com/xunema/phlocalization
- Wiki: https://github.com/xunema/phlocalization/wiki