| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Discuss (mail)
• Invoicing (account) • Sales (sale_management) • CRM (crm) • Calendar (calendar) • Contacts (contacts) |
| Lines of code | 6064 |
| Technical Name |
BOQ_Invoice |
| License | OPL-1 |
| Website | https://nawah.qa |
| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Discuss (mail)
• Invoicing (account) • Sales (sale_management) • CRM (crm) • Calendar (calendar) • Contacts (contacts) |
| Lines of code | 6064 |
| Technical Name |
BOQ_Invoice |
| License | OPL-1 |
| Website | https://nawah.qa |
Odoo 19 BOQ progress billing
Invoicing using BOQ
A practical bridge between project progress and accounting invoices for construction, engineering, contracting, and project-based work.
Keep project teams focused on completed work and keep accountants in Odoo's native invoicing flow.
01
Create BOQ
From confirmed sales orders
02
Claim Progress
By percentage and amount
03
Approve
With controlled access rights
04
Invoice
Using standard Odoo invoices
Key highlights
Everything needed for progress invoicing
Built around the real billing documents contractors prepare every month.
BOQ line progress
Track original quantity, original price, current progress, previous progress, cumulative progress, and invoice amount for each BOQ line.
Main contract and variations
Link existing sales orders or create new variation orders, then calculate the revised subcontract price across the full project.
Deduction split preview
Preview advance payment, retention, and penalties before posting invoices, with automatic or manual allocation across orders.
Retention release
Release retained amounts from approved BOQ invoices and keep the release linked to generated invoices.
Professional reporting
Generate detailed BOQ PDF reports and Excel exports for client, consultant, management, or audit review.
Revision protection
Use approval states, revision numbering, payment checks, and access controls to reduce accidental changes after invoicing.
Sales order integration
Create BOQ invoices directly from Sales
The module adds a dedicated BOQ area on the sales order. Your team can manage variation orders, project contacts, retention balances, and the BOQ invoice action from the same project order.
- Main contract and variation order tracking
- Project totals for original and revised values
- Owner, consultant, and contractor details
- Smart buttons for BOQ invoices and retention releases
Complete workflow
From progress claim to posted invoice
Project and invoicing team
- Create a BOQ invoice from a confirmed sales order.
- Enter current progress for each BOQ line.
- Add advance payment, retention, or penalty deductions.
- Review deduction allocation before approval.
- Submit the BOQ for review.
Accounting team
- Review the submitted BOQ totals and deductions.
- Approve the BOQ when the claim is correct.
- Let the module create and post standard Odoo invoices.
- Continue with payments and reconciliation in Odoo.
- Trace invoices back to the BOQ and sales order.
| Stage | What happens | Business benefit |
|---|---|---|
| Draft | Prepare BOQ progress, totals, and deductions. | Project team can work before accounting approval. |
| Submitted | BOQ is ready for manager review. | Clear approval checkpoint before invoice creation. |
| Approved | Odoo invoices are created and posted. | Accounting receives standard invoices with traceability. |
| Cancelled or revised | Protected reset, cancellation, and revision controls. | Reduces risk around paid or locked invoices. |
Amount breakdown
Transparent totals for customer claims
Show how each payable amount is calculated from contract value, variations, previous progress, and deductions.
| Original subcontract value | Main contract before variations |
| Variation order value | Additions or deductions from linked variations |
| Revised subcontract price | Current contract amount after variations |
| Cumulative progress | Total work claimed up to this BOQ |
| Previous progress | Amount already invoiced in older BOQs |
| Amount due | Current receivable after deductions |
Product screenshots
See the main screens before you buy
Deduction split preview
Confirm how deductions will be distributed across the project before approving the BOQ.
Client-ready PDF report
Print a detailed BOQ invoice report with project, line, deduction, and amount due details.
Excel export
Export BOQ information to Excel for consultants, customers, and internal review.
Smart buttons and navigation
Move quickly between BOQs, invoices, sales orders, variations, and retention releases.
BOQ list view
Track BOQ invoices by customer, sales order, sequence, amount, and status.
Configuration settings
Configure deduction products and notification behavior from Odoo settings.
Who should use it
Best fit for project billing teams
Construction
Contractors managing progress claims, retention, and variations.
MEP contractors
Electrical, mechanical, plumbing, HVAC, and technical scopes.
Engineering projects
Progress billing for civil, consulting, and implementation work.
Project manufacturing
Staged invoicing for custom manufacturing and installation.
Access rights
Separate preparation, approval, and administration with BOQ access groups under Accounting access rights.
| Role | Allowed work |
|---|---|
| User | Create, submit, print, export, and release retention. |
| Manager | Approve or reject BOQs and manage draft records. |
| Administrator | Configure settings, templates, reset, and advanced actions. |
Technical information
| Odoo version | 19.0 |
| Odoo dependencies | Sales, Invoicing, Discuss |
| Python dependency | xlsxwriter |
| License | OPL-1 |
| Availability | Odoo Online, Odoo.sh, and On Premise |
FAQ
Common pre-purchase questions
Does it replace Odoo invoices?
No. The module adds a BOQ preparation and approval layer, then creates standard Odoo customer invoices after approval.
Can it handle variation orders?
Yes. Variation sales orders can be linked to the main contract and included in revised project totals and deduction allocation.
Does it support retention?
Yes. The module supports retention deductions during BOQ invoicing and a separate retention release workflow.
Is Excel export included?
Yes. BOQ invoice data can be exported to Excel. The Python package xlsxwriter must be available on the Odoo server.
Ready to improve BOQ billing?
Install from this Odoo Apps page
After installation, confirm a sales order, open the BOQ Inv Options tab, and create your first BOQ invoice.
Need help after purchase?
Contact SupportOdoo Proprietary License v1.0 This software and associated files (the "Software") may only be used (executed, modified, executed after modifications) if you have purchased a valid license from the authors, typically via Odoo Apps, or if you have received a written agreement from the authors of the Software (see the COPYRIGHT file). You may develop Odoo modules that use the Software as a library (typically by depending on it, importing it and using its resources), but without copying any source code or material from the Software. You may distribute those modules under the license of your choice, provided that this license is compatible with the terms of the Odoo Proprietary License (For example: LGPL, MIT, or proprietary licenses similar to this one). It is forbidden to publish, distribute, sublicense, or sell copies of the Software or modified copies of the Software. The above copyright notice and this permission notice must be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
Please log in to comment on this module