Project at a glance
Four Caribbean island entities (each with its own payroll law, currency, fiscal rules and eCommerce site) unified on one Odoo 16 Enterprise platform with a shared core and per-island customization packages.
- Client
- Jo Ann's
- Industry
- Retail & eCommerce
- Platform
- Odoo 16 Enterprise
- Duration
- 24+ months, ongoing
- Location
- Aruba, Bahamas, Curaçao, St. Maarten
- Services
- Odoo Implementation, Odoo Customization, Odoo Development, Odoo Integration, Odoo Support, Odoo Supply Chain, Odoo Finance & Accounting, Odoo Sales & CRM, Odoo Human Resources
The challenge
Jo Ann's runs multi-brand store chains across four islands, each a separate legal entity with its own labour law, fiscal regulation (including Curaçao's mandatory POS blackbox), currency and web presence. They needed one ERP for retail, wholesale, inventory, payroll and accounting without flattening those differences: plus POS commissions, partner credit limits, barcode tracking and warehouse-level security.
- 01
Multi-region operations across four island entities
- 02
Local payroll and labour-law requirements per island
- 03
Curaçao fiscal compliance (Blackbox)
- 04
Multi-currency accounting
- 05
Complex POS workflows: commissions, wholesale pricing, returns
- 06
Warehouse restrictions, credit limits and barcode tracking
- 07
A separate website and eCommerce site per island
Working through a similar challenge? Talk to an Odoo expert
The solution
We implemented Odoo 16 Enterprise with a modular architecture: a shared core (joanns_common) for Sales, Purchase, POS, Stock, Accounting and HR, with island-specific overlays (custom_haiggo, custom_nassau, custom_waheguru, custom_satnam). On top: localized payroll engines for each jurisdiction, hardware and software Curaçao blackbox integration, an extended POS (user commissions, wholesale pricing, full-order returns, live stock display, terms signing and pay), multi-currency journal tools, direct receipt printing, and a website per island.
How we built it
- Implemented Odoo 16 Enterprise across multi-region retail store branches and wholesale operations.
- Developed shared core modules (joanns_common) for Sales, Purchase, POS, Stock, Accounting, and HR.
- Configured island-specific customization packages (custom_haiggo, custom_nassau, custom_satnam, custom_waheguru).
- Customized Point of Sale (POS) with user sales commissions, wholesale pricing, refund workflows, and real-time product stock display.
- Integrated hardware and software fiscal blackbox modules (pos_blackbox_curacao, hw_blackbox_curacao) for Curacao tax compliance.
- Developed island-localized payroll engines tailored to regional labor laws for Aruba, Bahamas, Curacao, and St. Maarten.
- Built island-specific website and eCommerce portals (joanns_aruba_website, joanns_bahamas_website, joanns_curacao_website, joanns_satnam_website).
- Implemented partner credit limit management and customer credit checks.
- Configured warehouse access restrictions and location-based security rules.
- Developed barcode increment tracking and advanced serial/lot tracking for product management.
- Integrated terms signing and payment workflows (satnam_hspl_sign_terms, satnam_hspl_pos_sign_and_pay).
- Created custom financial reports (hspl_account_report) and journal currency conversion tools.
2 more implementation steps
- Implemented direct report and receipt printing capabilities (hspl_report_direct_print).
- Configured HR birthday reminders, recruitment tracking, contact request management, and expense workflows.
Key capabilities
Multi-region ERP
One Odoo 16 Enterprise instance with a shared core (joanns_common) and an overlay package per island entity.
POS customisation
User sales commissions, wholesale pricing, full-order returns, refunds and real-time stock display at the counter.
Localised payroll
Payroll engines tailored to the labour rules of Aruba, Bahamas, Curaçao and St. Maarten.
Fiscal integration
Curaçao Blackbox fiscal hardware and software modules wired into POS for compliant receipts.
Inventory control
Barcode increment tracking, serial/lot tracking and warehouse access restrictions.
Regional eCommerce
A dedicated website and store per island on the same backend.
Architecture
One instance, several regional realities: everything shared lives in the core, everything local lives in the island overlay.
Aruba overlay
Haiggo: website, payroll
Bahamas overlay
Nassau: website, payroll
Curaçao overlay
Waheguru: website, payroll, Blackbox POS, receipts
St. Maarten overlay
Satnam: website, payroll, POS terms & sign-and-pay
Shared core. Joanns_common
Sales · Purchase · POS · Stock · Accounting · HR · commissions · credit limits · reports
Odoo 16 Enterprise
Multi-company, multi-currency, fiscal positions
Hardware and services
Blackbox fiscal devices · POS printers and direct print · barcode scanners · payment gateways · SMTP
Planning a similar architecture? Discuss your technical requirements
Integrations
- Curaçao blackbox fiscal device
- POS printers & direct print
- Barcode scanners
- Per-island web portals
- Multi-currency payment gateways
Custom development
POS
- User commission tracking
- Wholesale pricing
- Full-order return and refunds
- Product quantity display
- Direct receipt printing
- Terms signing and sign-and-pay (St. Maarten)
- Receipt customisation (Curaçao)
Inventory
- Barcode increment tracking
- Serial and lot tracking
- Warehouse access restrictions
- Packages
Finance
- Journal currency conversion
- Custom account reports
- Partner credit limits
- Expenses
HR
- Localised payroll per island
- Attendance
- Recruitment
- Birthday reminders
Regional
- Island websites and eCommerce
- Curaçao Blackbox POS and hardware modules
- Security and role controls
Technical details: 37 custom modules
- Joanns Base
- Joanns POS
- Joanns POS User Commission
- Joanns POS Wholesale
- Joanns POS Product Qty Display
- POS Return Full Order
- Joanns POS Refund
- Joanns Sale
- Joanns Purchase
- Joanns Stock
- Joanns Account
- Joanns Commission
- Joanns Partner Credit Limit
- Joanns Journal Change Currency
- Joanns Warehouse Restriction
- Joanns Package
- Joanns Product
- Joanns Expense
- Joanns Contact Request
- Joanns Recruitment
- Joanns HR Payroll
- Joanns Attendance
- Barcode Increment Tracked
- Account Report
- Report Direct Print
- HR Birthday Reminder
- Joanns Security
- Joanns Many2one Advance
- Execute Python Code
- Curacao Blackbox POS
- Curacao Blackbox Hardware
- Aruba Website & Payroll
- Bahamas Website & Payroll
- Satnam Website & Payroll
- Curacao Website & Payroll
- Satnam POS Extensions & Terms Sign
- Waheguru POS Receipt Customization
What changed
- Four island entities on a single Odoo 16 Enterprise platform
- 100% fiscal compliance in Curaçao via POS blackbox hardware and software integration
- Island-specific payroll automated across four labour jurisdictions
- POS user commissions tracked automatically
- Multi-currency accounting with automated journal conversions and custom reports
- Continuous enhancements and production support under a 24+ month partnership
Have a business process that doesn’t fit standard Odoo?
Discuss your requirementWhat made this project different
- Multi-island Odoo 16 Enterprise architecture customized for Caribbean retail and wholesale chains.
- Hybrid core and multi-tenant structure (joanns_common paired with island-specific packages).
- Hardware and software fiscal device integration (Curacao Blackbox integration).
- Localized payroll automation modules covering four distinct island jurisdictions.
- Advanced POS extension suite: user commission tracking, wholesale pricing, full order return, and real-time stock display.
- Digital signature integration for customer terms and payment authorization at checkout.
- Direct printing integration for fast counter sales and receipt generation.
Technology
- Odoo
- Odoo 16 Enterprise
- Backend
- Python · PostgreSQL
- Frontend
- JavaScript / OWL · XML / QWeb · HTML / CSS
- Infrastructure
- Docker
- Integrations
- POS Blackbox middleware · Fiscal hardware · Barcode devices · Payment gateways · SMTP
Team
The expertise on the project, not personal profiles.
- Odoo Solution Architect
- Odoo Technical Lead
- Senior Odoo Backend Developers
- Odoo POS Developers
- Functional Consultant
- QA Engineer
- Project Manager
Questions
What Odoo version does Jo Ann's use?
Odoo 16 Enterprise, as one multi-company instance covering the Aruba, Bahamas, Curaçao and St. Maarten entities.
Why did Jo Ann's need custom Odoo development?
Because each island has different payroll law, fiscal rules, POS practices and websites. Standard multi-company Odoo shares data. It doesn't ship a Curaçao fiscal Blackbox integration, four payroll engines or POS commission and wholesale rules. Those became custom modules: a shared core plus an overlay per island.
How was Curaçao fiscal compliance handled?
With custom POS and hardware modules (pos_blackbox_curacao, hw_blackbox_curacao) that integrate the fiscal Blackbox device and software into Odoo POS, so every receipt in Curaçao is fiscally compliant.
Did the solution support multiple currencies?
Yes. Multi-currency accounting is native to Odoo. We added journal currency-conversion tools and custom financial reports so finance works across island currencies without manual conversion.
What POS customisations were developed?
User sales commission tracking, wholesale pricing, full-order returns and refunds, real-time product quantity display, direct receipt printing, and, per island, terms signing with sign-and-pay and receipt customisation.
What did Heliconia build for Jo Ann's?
Four Caribbean island entities (each with its own payroll law, currency, fiscal rules and eCommerce site) unified on one Odoo 16 Enterprise platform with a shared core and per-island customization packages.
Which Odoo version and edition does Jo Ann's use?
Odoo 16 Enterprise, the Enterprise edition, version 16.
Which systems were integrated for Jo Ann's?
Curaçao blackbox fiscal device, POS printers & direct print, Barcode scanners, Per-island web portals, Multi-currency payment gateways.



