| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Inventory (stock)
• Invoicing (account) • Discuss (mail) |
| Community Apps Dependencies | Show |
| Lines of code | 988 |
| Technical Name |
nj_tax_report |
| License | AGPL-3 |
| Website | https://viziontools.com |
| Versions | 16.0 19.0 |
| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Inventory (stock)
• Invoicing (account) • Discuss (mail) |
| Community Apps Dependencies | Show |
| Lines of code | 988 |
| Technical Name |
nj_tax_report |
| License | AGPL-3 |
| Website | https://viziontools.com |
| Versions | 16.0 19.0 |
NJ Tobacco Tax Report
Generate the official State of New Jersey Tobacco Products Tax Return directly from your Odoo Invoicing module.
The NJ Tax Report (nj_tax_report) is a purpose-built Odoo accounting module
designed for licensed tobacco product distributors, wholesalers, and importers operating in
or importing into New Jersey.
1. Module Overview
By integrating directly with Odoo's Invoicing module, nj_tax_report pulls
transaction data automatically from vendor bills, customer invoices, import records, and
export transactions, then compiles everything into the officially formatted multi-sheet
Excel workbook required by the New Jersey Division of Taxation.
This module is purpose-built for NJ-registered tobacco distributors or importers who must file periodic Tobacco Products Tax Returns for tobacco products, liquid nicotine, moist snuff tobacco, and Roll-Your-Own (RYO) tobacco.
1.1 Who Needs This Module?
- ✔ New Jersey registered tobacco distributors and importers using Odoo
- ✔ Businesses filing for tobacco products such as cigarettes, cigars, and pipe tobacco
- ✔ Businesses reporting liquid nicotine and e-liquid products measured in fluid milliliters
- ✔ Businesses handling moist snuff tobacco measured in ounces
- ✔ Businesses selling or importing Roll-Your-Own tobacco products
- ✔ Accounting teams that need a faster and more reliable state filing workflow
1.2 Module Details
| Field | Details |
|---|---|
| Module Name | NJ Tax Report |
| Technical Name | nj_tax_report |
| Summary | New Jersey Tobacco Products Tax Return in Excel from posted Odoo bills and invoices. |
| Category | Accounting / Localizations / Reporting |
| Version | 16.0.1.0.0 |
| Supported Odoo Versions | Odoo 16, Odoo 18, and Odoo 19, with this package targeting Odoo 16. |
| Dependencies | account, stock, report_xlsx |
| License | OPL-1 |
2. Key Features
- ✓ Officially Formatted Report: Generates the exact layout required by the NJ Division of Taxation with all six schedules in one Excel workbook.
- ✓ Flexible Date Range: Select any custom Start Date and End Date through a simple wizard dialog for any reporting period.
- ✓ Excel (.xlsx) Export: Outputs the Main Return, Schedule A, Schedule I, Schedule B, Schedule C and C-2, and Schedule D.
- ✓ Native Odoo Integration: Accessible directly from Invoicing / Reporting / NJ Tax Report with no external reporting tools needed.
- ✓ Multi-Company Aware: Automatically uses your Odoo company name and New Jersey address details across multi-company environments.
- ✓ Accurate Tax Calculations: Follows the official return structure for all four NJ-regulated tobacco product categories and units.
- ✓ Odoo Ready: Built for the Odoo 16, 18, and 19 product line, with this package targeting the Odoo 16 edition.
- ✓ One-Click Generation: From menu to downloaded report in just a few clicks, without complex configuration or manual data entry.
3. Product Coverage - Four Tobacco Categories
Tobacco Products - Column A
Standard tobacco items excluding liquid nicotine, moist snuff, and Roll-Your-Own tobacco.
Liquid Nicotine - Column B
Tracked in fluid milliliters (mL) for liquid nicotine and e-liquid products.
Moist Snuff - Column C
Uses ounce-based measurement to align with the official NJ tobacco tax return structure.
Roll-Your-Own - Column D
Covers Roll-Your-Own tobacco products using the dedicated official return column.
4. Report Structure - All Six Schedules
| Sheet / Schedule | Purpose | Data Source |
|---|---|---|
| Sheet 1 - Main Return | Summary of all purchases, sales, taxable amounts, and total tax due. | Auto-calculated |
| Schedule A | Tobacco products purchased within New Jersey. | Vendor Bills |
| Schedule I | Tobacco products imported into New Jersey from outside the state. | Import Bills |
| Schedule B | Total sales during the reporting period. | Customer Invoices |
| Schedule C & C-2 | Non-taxable sales including e-liquid container sales. | Exempt Sales |
| Schedule D | Exports for products sold or shipped outside New Jersey. | Export Invoices |
5. How It Works - 3-Step Process
- Navigate to Invoicing / Reporting / NJ Tax Report. The menu appears when the company state is set to New Jersey, US.
- Select your reporting period with the Start Date and End Date fields in the wizard.
- Click Generate NJ Tax Report to download the officially formatted Excel workbook with all six schedules.
Setup Notes:
- Install the required apps:
account,stock, andreport_xlsx - Set the active company state to New Jersey, United States
- Mark relevant product categories with the tobacco flag used by the module
- Configure tax-unit values on liquid nicotine products where applicable
6. Screenshots - See It in Action
6.1 Module Installed in Odoo Apps
After installation, search for NJ tax in the Odoo Apps menu to locate nj_tax_report under the Accounting / Invoicing category.
6.2 Company Setup - New Jersey
The NJ Tax Report menu appears when your Odoo company state is set to New Jersey, US. The report uses this information to populate taxpayer details.
6.3 Reporting Menu - NJ Tax Report Entry
Once installed, a dedicated NJ Tax Report entry appears under Invoicing / Reporting alongside standard Odoo reports such as Invoice Analysis.
6.4 Report Generation Wizard - Date Range Selection
Clicking NJ Tax Report opens a clean wizard dialog where users enter the reporting period dates and generate the Excel file.
6.5 Main Report Sheet - Tobacco Products Tax Return
The primary Excel sheet mirrors the official NJ State form with taxpayer details, reporting period dates, product columns, purchases, sales, taxable sales, and total tax due.
Download Sample Report
Review the sample Excel output to see the official NJ Tobacco Products Tax Return layout, including the main return and supporting schedules.
Download Sample Excel Sheet7. Installation & Compatibility
| Item | Details |
|---|---|
| Supported Versions | Brochure coverage includes Odoo 16, Odoo 18, and Odoo 19. This package targets Odoo 16. |
| Edition Support | Odoo 16 Community and Enterprise. |
| Install Method | Install from Odoo Apps by searching for NJ tax or import the module ZIP. |
| Dependencies | account, stock, and report_xlsx. |
| Company Setup | Go to Settings / Companies, set the company state to New Jersey, US, and review tobacco category and liquid nicotine tax-unit setup. |
| Menu Location | Invoicing / Reporting / NJ Tax Report |
| Technical Name | nj_tax_report |
| Author | Vizion Tools |
| License | OPL-1 |
| Price | USD 37 |
8. Why Choose NJ Tax Report for Odoo?
Compliance Confidence
The output is designed to match the official NJ state filing format so teams can review the workbook with greater confidence.
Time Savings
Generate a full multi-schedule NJ tobacco tax workbook in under a minute instead of building it manually.
Zero Manual Data Entry
Purchases, sales, imports, exports, and non-taxable sales flow directly from Odoo invoicing data into the generated workbook.
Audit-Ready Documentation
The Excel workbook serves as a clear record that can be reviewed internally and retained as supporting documentation.
Future-Proof Investment
Replace fragile manual spreadsheets with an Odoo-native reporting workflow that can be reused every filing period.
Please log in to comment on this module