Odoo Changelog — 2026-08-03

Monday, August 3, 2026

1 change · 19.0

Improvements(1)

Enhancements to existing features

[IMP] l10n_pa: fix chart of accounts and complete Panamanian taxes and validations

Core19.0l10n_paHigh impact

Updates the Panama localization so companies can use more accurate account classifications, current tax rates, withholding rules, and official validation data. This reduces setup errors and helps Panamanian businesses stay aligned with local reporting and tax requirements.

Original PR description

## Summary Fixes and completes the Panamanian localization (`l10n_pa`) so its chart of accounts and taxes comply with current Panamanian law. The previous module had classification bugs, an…

## Summary

Fixes and completes the Panamanian localization (`l10n_pa`) so its chart of accounts and taxes comply with current Panamanian law. The previous module had classification bugs, an inconsistent account code prefix, no special ITBMS rates or exemptions, no income tax (ISR) or withholding taxes, no RUC or postal-code validation, and a demo company with invalid data.

## Changes and rationale

### 1. Chart of accounts classification and codes
- **Fixed assets (161–165) and intangibles (171–174) now `asset_non_current`** instead of `asset_current`. Fixed assets and intangibles are non-current by nature (IFRS/NIC 16 and NIC 38).
- **Expense accounts 516/517/518 (taxes, bank charges, public utilities) now `expense`** instead of `off_balance`.
- Added accounts **112 (Internal Transfers)** and **113 (Cash on Hand)** so the `112.`/`113.` account code prefixes have a real target, and **233 (Withholdings Payable)** for the new withholding taxes.
- **`code_digits` fixed from `7` to `3`**: with 7 digits the chart loader padded every account code with trailing zeros (e.g. `121` → `1210000`), corrupting the whole chart.
- **Bank account prefix `111.` → `114.`** to match the actual "Cash and Banks" account present in the plan.
- Fixed typos in Spanish account names.

### 2. ITBMS special rates and exemptions
- Added the **10%** rate (alcoholic beverages and hotel services) and **15%** rate (tobacco and derivatives), plus a **0% exempt** tax for exports, basic basket and food, medicines, baby products, school supplies, textbooks, agricultural products, public utilities, medical services, laboratories and transport.
- Legal basis: **Ley 31 de 1998** (creates ITBMS) and **Ley 8 de 2010** (sets the general 7% rate; special 10%/15% rates per DGI).

### 3. ISR and withholding taxes
- **ISR_25 (25%)** corporate income tax (Código Fiscal, Art. 733) booked to account 232.
- **12.5% withholding** on interest, royalties and commissions on services paid to non-residents (Código Fiscal, Art. 733).
- **Dividends withholding 10%** (general), **5%** (foreign-source/exempt income, exports, free-zone users) and **20%** (bearer shares) per **Ley 52 de 2012**.
- **ITBMS 50% withholding** for retention agents / "Grandes Compradores" (annual local purchases ≥ B/.3,000,000), reported via Form 4331 (Decreto Ejecutivo N° 173 de 2021 and N° 84 de 2005).
- All withholdings booked to the new account 233.

### 4. RUC validation
- New `res.partner` constraint validating the Registro Único de Contribuyentes (RUC) format for Panamanian partners: juridical persons (Registro Público inscription number, e.g. `155066911-2-2019`) and natural persons (cédula, e.g. `8-741-2043`, including E/N/PE/PI/AV variants and NT). The check digit is left to DGI e-Tax 2.0.

### 5. Postal code validation (new official system)
- Vendored the **panama-postal** codec (MIT, kass507) under `l10n_pa/lib` and added a `zip` constraint for Panamanian partners using the official geolocated format (e.g. `AMAXG-FL434`).
- The official postal code system was launched on **May 7, 2026** by Correos Panamá/COTEL and INEC (platform `codigospostalespanama.gob.pa`).

### 6. Demo company and manifest
- Demo company now uses a valid RUC, a full official postal code, proper phone format and postal code, and **USD** as currency (Panama uses the US dollar as legal tender, Decreto Ley 14 de 1904 / Ley 84 de 1941); set after chart loading since the loader forces the fiscal-country currency.
- Module versioned `19.0.1.0.0`; description documents the taxes, the RUC rules, the postal code system and **Ley 526 de 2026** (economic substance for passive foreign-source income of multinational groups, effective FY 2027).

## Commits (11)

1. `902e82fd` [FIX] correct chart of accounts classification and codes
2. `394747e6` [IMP] add special ITBMS rates and exemptions
3. `71f2f0c7` [IMP] add ISR 25% and withholding taxes
4. `689f6765` [IMP] validate the RUC format of Panamanian partners
5. `944de78f` [IMP] version the module and fix demo company data
6. `e4b6bbdb` [IMP] add the 50% ITBMS withholding for large buyers
7. `dc35d83b` [IMP] complete dividend withholdings and exempt ITBMS details
8. `abc47c04` [IMP] document Law 526 of 2026 (economic substance) in the manifest
9. `94502040` [IMP] use the new official Panamanian postal codes
10. `24d54723` [IMP] add updates section to the module description
11. `01765bc2` [IMP] validate Panamanian postal codes with the panama-postal codec

## Notes

- Taxes, rates and exemptions verified against PwC Worldwide Tax Summaries (Panama) and the DGI website.
- Payroll (CSS, IES, Riesgos Profesionales, XIII month) and electronic invoicing are out of scope for this chart module.

#Panama#localization#taxes#accounting#compliance

## Summary Fixes and completes the Panamanian localization (`l10n_pa`) so its chart of accounts and taxes comply with current Panamanian law. The previous module had classification bugs, an inconsistent account code prefix, no special ITBMS rates or exemptions, no income tax (ISR) or withholding taxes, no RUC or postal-code validation, and a demo company with invalid data. ## Changes and rationale ### 1. Chart of accounts classification and codes - **Fixed assets (161–165) and intangibles (171–174) now `asset_non_current`** instead of `asset_current`. Fixed assets and intangibles are non-current by nature (IFRS/NIC 16 and NIC 38). - **Expense accounts 516/517/518 (taxes, bank charges, public utilities) now `expense`** instead of `off_balance`. - Added accounts **112 (Internal Transfers)** and **113 (Cash on Hand)** so the `112.`/`113.` account code prefixes have a real target, and **233 (Withholdings Payable)** for the new withholding taxes. - **`code_digits` fixed from `7` to `3`**: with 7 digits the chart loader padded every account code with trailing zeros (e.g. `121` → `1210000`), corrupting the whole chart. - **Bank account prefix `111.` → `114.`** to match the actual "Cash and Banks" account present in the plan. - Fixed typos in Spanish account names. ### 2. ITBMS special rates and exemptions - Added the **10%** rate (alcoholic beverages and hotel services) and **15%** rate (tobacco and derivatives), plus a **0% exempt** tax for exports, basic basket and food, medicines, baby products, school supplies, textbooks, agricultural products, public utilities, medical services, laboratories and transport. - Legal basis: **Ley 31 de 1998** (creates ITBMS) and **Ley 8 de 2010** (sets the general 7% rate; special 10%/15% rates per DGI). ### 3. ISR and withholding taxes - **ISR_25 (25%)** corporate income tax (Código Fiscal, Art. 733) booked to account 232. - **12.5% withholding** on interest, royalties and commissions on services paid to non-residents (Código Fiscal, Art. 733). - **Dividends withholding 10%** (general), **5%** (foreign-source/exempt income, exports, free-zone users) and **20%** (bearer shares) per **Ley 52 de 2012**. - **ITBMS 50% withholding** for retention agents / "Grandes Compradores" (annual local purchases ≥ B/.3,000,000), reported via Form 4331 (Decreto Ejecutivo N° 173 de 2021 and N° 84 de 2005). - All withholdings booked to the new account 233. ### 4. RUC validation - New `res.partner` constraint validating the Registro Único de Contribuyentes (RUC) format for Panamanian partners: juridical persons (Registro Público inscription number, e.g. `155066911-2-2019`) and natural persons (cédula, e.g. `8-741-2043`, including E/N/PE/PI/AV variants and NT). The check digit is left to DGI e-Tax 2.0. ### 5. Postal code validation (new official system) - Vendored the **panama-postal** codec (MIT, kass507) under `l10n_pa/lib` and added a `zip` constraint for Panamanian partners using the official geolocated format (e.g. `AMAXG-FL434`). - The official postal code system was launched on **May 7, 2026** by Correos Panamá/COTEL and INEC (platform `codigospostalespanama.gob.pa`). ### 6. Demo company and manifest - Demo company now uses a valid RUC, a full official postal code, proper phone format and postal code, and **USD** as currency (Panama uses the US dollar as legal tender, Decreto Ley 14 de 1904 / Ley 84 de 1941); set after chart loading since the loader forces the fiscal-country currency. - Module versioned `19.0.1.0.0`; description documents the taxes, the RUC rules, the postal code system and **Ley 526 de 2026** (economic substance for passive foreign-source income of multinational groups, effective FY 2027). ## Commits (11) 1. `902e82fd` [FIX] correct chart of accounts classification and codes 2. `394747e6` [IMP] add special ITBMS rates and exemptions 3. `71f2f0c7` [IMP] add ISR 25% and withholding taxes 4. `689f6765` [IMP] validate the RUC format of Panamanian partners 5. `944de78f` [IMP] version the module and fix demo company data 6. `e4b6bbdb` [IMP] add the 50% ITBMS withholding for large buyers 7. `dc35d83b` [IMP] complete dividend withholdings and exempt ITBMS details 8. `abc47c04` [IMP] document Law 526 of 2026 (economic substance) in the manifest 9. `94502040` [IMP] use the new official Panamanian postal codes 10. `24d54723` [IMP] add updates section to the module description 11. `01765bc2` [IMP] validate Panamanian postal codes with the panama-postal codec ## Notes - Taxes, rates and exemptions verified against PwC Worldwide Tax Summaries (Panama) and the DGI website. - Payroll (CSS, IES, Riesgos Profesionales, XIII month) and electronic invoicing are out of scope for this chart module.