OdooWiki OCA HUB

Paraguay - Base Localization

l10n_py_base folder_open OCA/l10n-paraguay open_in_new
Localization License: LGPL-3

Base localization module for Paraguay. Provides geographic data (departments, cities, neighborhoods), RUC validation, and fiscal fields on partners.

auto_awesome What this module does

AI-generated from the code · Odoo 20.0

Adds Paraguayan localization basics to Odoo: departments, cities and neighborhoods (barrios) with SET codes, plus fiscal fields and RUC validation on contacts. Users can record RUC, taxpayer type and identity documents on partners.

This module prepares Odoo for Paraguay. It loads the 17 Paraguayan departments (states) with their SET codes, and adds a SET code to cities and a new "Barrio" (neighborhood) record with name, code, city, department, country and postal code.

A new menu "Barrios" appears under Contacts > Configuration > Localization, where users can list, create and search neighborhoods, grouping them by city or department.

On contacts, when the country is Paraguay, extra fiscal fields appear: RUC (with its check digit), taxpayer type (Contribuyente / No Contribuyente), fantasy name, economic activity, and identity document type and number for non-taxpayers. The RUC is validated and automatically formatted with its check digit; entering an identity document marks the contact as non-taxpayer, and entering a RUC marks it as taxpayer and clears the identity document fields.

Address handling is also localized: the address form shows neighborhood and city fields for Paraguay, and choosing a neighborhood fills in the city and postal code. Typing a postal code can find and fill the matching neighborhood, city and department. Changing city or department clears inconsistent neighborhood values. The country address format and the VAT label (shown as RUC) are also set for Paraguay.

Depends on

basebase_address_extendedcontacts

Menus it adds

Barrios
Models and fields (5)
  • res.city · extends an existing modell10n_py_code (Código SET)
  • res.company · extends an existing modelcountry_id
  • res.partner · extends an existing modelcountry_id, l10n_py_ruc (RUC), l10n_py_ruc_dv (DV), l10n_py_doc_type (Tipo de Documento de Identidad), l10n_py_city_code (Código Ciudad SET), l10n_py_doc_number (Número de Documento), l10n_py_fantasy_name (Nombre de Fantasía), l10n_py_taxpayer_type (Tipo de Contribuyente), l10n_py_department_code (Código Departamento SET), l10n_py_neighborhood_id (Barrio), l10n_py_neighborhood_name (Nombre del Barrio), l10n_py_activity_description (Actividad Económica)
  • res.country.state · extends an existing modell10n_py_code (Código SET)
  • l10n_py.neighborhood · new modelcode (Código), name (Nombre), city_id (Ciudad), zipcode (Código Postal), state_id (Departamento), country_id (País)

Text generated by AI (DeepSeek) from reading the Odoo 20.0 code on GitHub; it may contain mistakes, so check the code before deciding. The module is very large and only part of the code was read. View the code on GitHub

Availability by version

Reviewed: 2026-11-03
Confirmed (verified in repository and branch) Estimated (unverified) No information

Confirmation status: 4 confirmed, 5 with no information of 9 versions.

Sources · Odoo 16.0

Confirmed on 2026-11-03 in branch 16.0 of OCA/l10n-paraguay.

terminal Installation and usage

No verified information

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.

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.