Skip to main content

Case study · Retail & eCommerce

Multi-Island Odoo ERP for Jo Ann's Retail and Wholesale Operations

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.

  • Odoo 16 Enterprise
  • Implementation + POS customization + multi-company
  • Aruba, Bahamas, Curaçao, St. Maarten
  • 24+ months, ongoing
Jo Ann's: Multi-island retail and wholesale on Odoo 16 Enterprise, with fiscal-compliant POS
Regional entities
4
Months of engagement
24+
Custom modules
37

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.

  1. 01

    Multi-region operations across four island entities

  2. 02

    Local payroll and labour-law requirements per island

  3. 03

    Curaçao fiscal compliance (Blackbox)

  4. 04

    Multi-currency accounting

  5. 05

    Complex POS workflows: commissions, wholesale pricing, returns

  6. 06

    Warehouse restrictions, credit limits and barcode tracking

  7. 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 requirement

What 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.

Next step

Have a Similar Project in Mind?

Tell us what you are trying to build, improve or integrate. We'll help you evaluate the right Odoo, software and architecture approach, and show you the project closest to yours.