Product Harmonized System Codes
This module contains the objects for Harmonised System Codes (H.S. codes). The full nomenclature is available from the World Customs Organisation \. These codes are usually required on the Proforma invoices that are attached to the packages that are shipped abroad.
This module also handles the local/national extensions to the H.S. codes. The import of the full nomenclature is not provided by this module; it should be provided by localization modules.
You will also be able to configure the country of origin of a product, which is often required on the proforma invoice for the customs.
This module should be usefull for all companies that export physical goods abroad. This module is also used by the Intrastat modules for the European Union, cf the intrastat_product module.
auto_awesome What this module does
AI-generated from the code · Odoo 19.0Lets you store Harmonized System (H.S.) customs codes and product countries of origin in Odoo, so products and product categories can carry the trade data needed for import/export paperwork.
This module adds a new reference list of H.S. codes and links it to your products and product categories.
- On each H.S. code you record a national/local code, a short description and a detailed description. The first six digits of the local code are automatically extracted into the H.S. code field, and spaces are removed from the code when you save it.
- Codes are unique per company, so the same local code cannot be entered twice for the same company. A company field is available when multi-company is enabled, and users only see codes belonging to their allowed companies (plus shared ones).
- On product categories you can set an H.S. code under an "Import/Export Properties" section. On products you can set an H.S. code and a Country of Origin; both fields are hidden for services. If a product has no code, Odoo can look it up on its category, and then up the category hierarchy.
- The H.S. code form shows buttons with counts of the product categories and products using that code, and opens filtered lists of them.
- In the product search filters you can group products by H.S. Code or by Country of Origin.
Only Settings administrators can create, edit or delete H.S. codes; other users can read them. The module itself does not import the full World Customs Organisation nomenclature — that is expected to come from localisation modules.
Depends on
Required by other modules
Models and fields (4)
- hs.code · new modelactive, hs_code (H.S. Code), company_id (Company), local_code, description, long_description (Detailed Description), product_tmpl_ids (Products), product_categ_ids (Product Categories), product_tmpl_count, product_categ_count
- product.product · extends an existing model
- product.category · extends an existing modelhs_code_id (H.S. Code)
- product.template · extends an existing modelhs_code_id (H.S. Code), origin_country_id (Country of Origin)
Text generated by AI (DeepSeek) from reading the Odoo 19.0 code on GitHub; it may contain mistakes, so check the code before deciding. View the code on GitHub
Availability by version
Reviewed: 2026-11-03Confirmation status: 8 confirmed, 1 with no information of 9 versions.
Sources · Odoo 19.0
Confirmed on 2026-11-03 in branch 19.0 of OCA/intrastat-extrastat.
terminal Installation and usage
OCA documentation · Odoo 19.0Installation
Source · Odoo 19.0This module is NOT compatible with the account_intrastat module from Odoo Enterprise.
Usage
Source · Odoo 19.0As this module only depends on the product module and that module doesn't provide any menu entry, this module lacks a menu entry for H.S. Codes. A menu entry for H.S. codes is provided by the module product_harmonized_system_stock.
Once the H.S. codes are created, you will be able to set the H.S. code on a product (under the Information tab) or on a product category. On the product form, you will also be able to set the Country of Origin of a product (for example, if the product is made in China, select China as Country of Origin).
No verified information in OCA: Configuration.
Installation instructions, the distribution package, dependencies and configuration steps are not shown because they have not yet been verified in the module documentation for any version.
Data imported from GitHub: this sheet reflects the latest catalog review, not a live lookup. Always check the module documentation and staging before installing in production.