🏗️ Contracting Workflows
In Saudi Arabia, contracting and construction represent over 20% of the SME market. These businesses operate on project-based accounting, requiring specialized workflows to manage cash flows, milestones, and subcontractor relationships.
1. Bill of Quantities (BOQ) Management
A project begins with a Bill of Quantities (BOQ), detailing all labor, equipment, and materials.
[Estimate/Tender BOQ] ──> [Project Budget BOQ] ──> [Task & Purchase Control]
└──> [Actual Cost Tracking]
Happy Path Steps
- BOQ Import: The project engineer uploads the client-approved BOQ (typically from Excel/PDF).
- Budget Mapping: The system parses items, links them to ERPNext cost centers/tasks, and establishes budget controls.
- Procurement Guardrails: Material purchases and subcontractor agreements are validated against BOQ item lines. If a purchase order exceeds the BOQ rate or quantity, it triggers a step-up approval request to the Managing Director.
- Actuals vs. Commitments: Real-time dashboards compare BOQ estimate rates with actual costs (materials received, labor logged, sub-contracts billed).
2. Progress Billing (Milestone Invoicing)
Contracting businesses bill based on progress certificates rather than simple delivery of goods.
Happy Path Steps
- Work Valuation: The project manager records the percentage of work completed for each BOQ item.
- Joint Measurement Certificate (JMC): The client's engineer inspects the site and issues a certified completion percentage.
- Progress Invoice Draft: The accountant generates a draft sales invoice in BayanCore. The system automatically pulls the certified completion percentage, calculates the gross amount, and prompts ZATCA clearance.
- VAT Posting: VAT (15%) is applied only to the certified, invoiced portion, complying with Saudi VAT rules for continuous supply of services.
3. Retention Management
Clients in Saudi Arabia typically retain 5% to 10% of each progress invoice value as a guarantee against defects. This retention is held until the warranty period expires.
Gross Progress Billing (SAR 100,000)
├── VAT 15% (SAR 15,000)
├── Retention 10% (SAR 10,000 withheld)
└── Net Cash Receivable (SAR 105,000)
Happy Path Steps
- Retention Rule Configuration: When creating a contract, the project accountant sets a retention rate (e.g., 10%).
- Automatic Withholding: On each progress invoice, the system isolates the retention amount and posts it to a Retention Receivable asset account, while the net amount is posted to Accounts Receivable.
- Retention Aging Alerts: The system tracks the retention release dates (e.g., 365 days post-handover) and alerts the collections team to request the retention payout.
4. Work in Progress (WIP) & Revenue Recognition
Contracting projects span months or years, requiring accurate cost capitalization and revenue matching.
- WIP Accounting: Unbilled material costs, subcontractor advances, and direct labor are held in a WIP Asset Account on the balance sheet.
- Revenue Recognition (Percentage of Completion Method):
Recognized Revenue = Total Contract Value × (Actual Costs Incurred ÷ Estimated Total Costs) - Reconciliation: Monthly journal entries auto-transfer matching costs from WIP to the cost-of-goods-sold (COGS) expense account as revenue is recognized, ensuring compliant financial statements.