OdooWiki OCA HUB

ISO 3166

base_iso3166 folder_open OCA/community-data-files open_in_new
Localization License: AGPL-3

This module adds some data specified by ISO 3166, specifically:

  • ISO 3166-1 alpha-3 (3-char) codes in countries
  • ISO 3166-1 numeric codes in countries
  • ISO 3166-3 formerly used codes in countries

Check for more info.

auto_awesome What this module does

AI-generated from the code · Odoo 19.0

Adds the official ISO 3166 country codes to Odoo countries: the 3-letter code and the numeric code, shown on the country form and list. The values are filled in automatically from the existing 2-letter country code.

This module enriches the country data already present in Odoo with two extra official codes, so you no longer have to look them up elsewhere.

  • On each country you now see a "Country Code (3-letter)" (ISO 3166-1 alpha-3, e.g. the three-letter abbreviation) and a "Country Code (numeric)" (ISO 3166-1 numeric).
  • Both fields appear on the country form and in the country list, right after the existing 2-letter code.

These two codes are not typed by hand: they are calculated automatically from the country's existing 2-letter code. Whenever that 2-letter code is set or changed, Odoo looks the country up in the official ISO reference data and fills in the 3-letter and numeric codes. If no match is found, both fields stay empty.

The lookup also covers formerly used country codes, so countries that no longer exist under their old 2-letter code can still be resolved.

The module only touches the country model (res.country) and its existing form and list views; it does not add new menus or screens. It requires the external Python library pycountry to be installed on the server, which provides the official ISO data used for the calculation.

Depends on

base

Required by other modules

account_invoice_import_facturaeedi_voxeledi_voxel_ocal10n_es_facturaepms_l10n_es
Models and fields (1)
  • res.country · extends an existing modelcode_alpha3 (Country Code (3-letter)), code_numeric (Country Code (numeric))

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-03
Confirmed (verified in repository and branch) Estimated (unverified) No information

Confirmation status: 8 confirmed, 1 with no information of 9 versions.

Sources · Odoo 18.0

Confirmed on 2026-11-03 in branch 18.0 of OCA/community-data-files.

terminal Installation and usage

OCA documentation · Odoo 19.0

Installation

Source · Odoo 19.0

This module requires the Python library pycountry \>= 0.19 installed in the system. It works also with pycountry \>= 16.11.8

Usage

Source · Odoo 19.0

This module serves as a base for other modules that need ISO 3166 country data.

No verified information in OCA: Configuration.

info

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.