Blu Coffee Distributors / VGC — bc17 Documentation
This is the user guide for Blu Coffee Distributors and the Villanueva Group of Companies (VGC) on Odoo 17: how to do the day-to-day work in Odoo as it is set up today, with screenshots from the live system.
What's in this guide
| Section | What it covers |
|---|---|
| What's New | Recent changes, newest first — start here if you used Odoo before |
| Contacts | Customers, their delivery and invoice addresses, and why addresses no longer show in pickers |
| Sales | Quotation to sales order, Send to Viber, SLA, Force Close, and the order-to-cash flow end to end |
| Inventory | Item requests, deliveries and their SLA, delivery accountability, trip tickets, receipt notifications, expiring stock, inventory counts and the inventory reports |
| Purchase | Purchase requisitions and the auto-RFQ from reordering rules |
| Accounting | Withholding tax and the S.I. per BIR RR 6-2026, foreign-currency bills, the books and ledgers, statements of account |
| Repairs | Repair orders from intake to invoice, client Viber notices and the survey, machine service history, the customer portal |
| Marketing | Viber and SMS campaigns through 8x8 |
| Manufacturing | The roastery repackaging plan — planned, not in use yet |
Getting help
- Search (top right, or press Ctrl/⌘ + K) finds any word on any page.
- Blu Help (the chat button, bottom right) answers questions from this guide. Use the full-screen button in its header for long answers.
- Screenshots come from a copy of the live system, so names and numbers on them are real examples. Your screen may differ slightly depending on your access rights.
Conventions
- Menu paths are written in bold with arrows, e.g. Inventory → Transfers → Trip Tickets.
- Dates are written MM/dd/yyyy.
- Amounts are in PHP unless noted.
For IT: the bc17 module
bc17 is a single Odoo 17 application module that bundles all VGC-specific business logic. Internally it is organized into sub-packages by domain:
| Sub-package | Purpose |
|---|---|
blu_base | Partner extensions (classification, region, schedules), user warehouse access, company config, iFrame wrapper for i-net reports |
blu_crm_sales | CRM lead extensions (brands, inquiry types), sale-order customizations (mode of payment, force close, validator groups) |
blu_account | Withholding tax, payment receipts, SI number tracking, foreign-currency rates |
blu_purchase | PO signatories, auto-RFQ from reordering rules, currency rate sync, i-net printing |
blu_stock | Delivery receipts, trip tickets, delivery accountability, purchase requisitions, item requests, compatible parts |
blu_repair | Repair orders, labor, technicians, service history |
blu_portal | Customer portal (machine registration, service requests) and the post-service survey |
blu_reports | Sales/purchase/inventory analytics and Excel exports |
blu_8x8 | 8x8 SMS/Viber integration |
blu_artin | Industrial machine log CSV parsing |
blu_ecomm | E-commerce warehouse rules |
blu_dashboard | Dashboard configuration |
frontend/ | React SPA for the customer portal |
Module source: bc17/ in the vgc17 repository. Docs source: blu-docs/ in the same repository — edit the Markdown under docs/ alongside the module change it describes, and deploy with ./scripts/deploy.sh from main.