The l10n_bg_config module in Odoo simplifies the setup of Bulgarian localization by automatically installing all necessary modules, such as l10n_bg, l10n_bg_reports_audit, and l10n_bg_report_theme. It ensures a quick and seamless configuration, making the system ready for compliance with Bulgarian accounting and legal standards.
auto_awesome What this module does
AI-generated from the code · Odoo 18.0This module installs and configures all Bulgarian localization modules in one place, and adds Bulgarian-specific fields and rules to invoices, partners and companies, such as local document numbers, UIC validation and protection of posted entries.
This is the configuration hub for Bulgarian accounting in Odoo. From the settings screen you can tick the Bulgarian modules you want (VAT reports, Intrastat, assets, report theme, city data, tax offices, multilanguage, etc.) and Odoo installs them for you. A "Manage Plugins" wizard lets you review and apply these plugins, and a "Preview setting as XML" screen shows the configuration file before it is applied.
On invoices (account.move) the module adds a Bulgarian document number, the date of the local document and the date of the deal. The document number is computed from the invoice reference or number, formatted to ten digits, and can be searched and tracked. A company flag "Use Bulgaria Accounting" is shown on the company and on records that belong to Bulgarian accounting; when it is off, Bulgarian fields and filters are hidden from forms, lists and searches.
On partners it adds Bulgarian identification types (BULSTAT, EGN, PNF, NRA number, CRA code, non-EU number, EU VAT), an API key and a crypt key. When you change a partner's Tax ID, the module validates it and fills the Bulgarian UIC automatically; it also blocks changing the Tax ID or the parent company when posted accounting entries already exist. Company representatives can be flagged, and a representative contact is linked to the company. Account tags gain a translatable description, and Bulgarian account codes are formatted with a mask.
Depends on
Models and fields (12)
- res.company · extends an existing modell10n_bg_key, l10n_bg_uic, l10n_bg_uic_type, is_l10n_bg_record (Bulgaria - Use Bulgaria Accounting), is_l10n_bg_tax_report (Bulgaria - Tax Report), l10n_bg_config_template (Config Template), is_l10n_bg_multilanguage (Bulgaria - Multilanguage), l10n_bg_departament_code (Departament code), l10n_bg_represent_contact_id (Representative), is_l10n_bg_tax_report_with_vat (Bulgaria - Tax Report with VAT)
- res.country · extends an existing modeltitle_format (Layout in Name views)
- res.partner · new modeltype, l10n_bg_key (Api Key), l10n_bg_uic (Unique identification code), l10n_bg_uic_type (Type of Bulgaria UID), l10n_bg_crypt_key (Crypt Key), l10n_bg_represent_contact_id (Representative)
- account.move · new modell10n_bg_date (Date of locale document), l10n_bg_name (Number of locale document), l10n_bg_deal_date (Date of deal), l10n_bg_name_value (Number of locale document (stored)), l10n_bg_document_number (Document Number (BG))
- account.account.tag · extends an existing modeldescription
- res.config.settings · extends an existing modell10n_bg_key, is_l10n_bg_record, module_l10n_bg_city (Upload Bulgaria city), module_l10n_bg_assets (Bulgaria - Assets), l10n_bg_config_template, is_l10n_bg_multilanguage, module_l10n_bg_intrastat (Bulgaria - Intrastat), module_l10n_bg_multilang (Switch on multilanguage support), module_partner_multilang (Partner transliterate names), module_l10n_bg_report_vat (Bulgaria - Tax Report export files (OCA)), module_l10n_bg_tax_offices (NRA Bulgaria, tax offices and departments), module_l10n_bg_vat_reports (Bulgaria - VAT Reports export files (EE)), module_l10n_bg_report_theme (Bulgaria - Report Theme), module_l10n_bg_reports_audit (Bulgaria - Accounting TAX Audit reports), module_l10n_bg_uic_id_number (Bulgarian multi register codes), is_l10n_bg_multilanguage_text (Multilanguage Settings), module_currency_rate_live_fix (Live Currency Rate Fix (EE)), module_l10n_bg_address_extended (Additional data in address), module_l10n_bg_intrastat_product (Bulgaria - Intrastat Product Declaration), module_currency_rate_update_bg_bnb (Download currency rates from Bulgaria National Bank (OCA))
- l10n.bg.config.mixin · new modelis_l10n_bg_record (Is Bulgaria Record)
- account.chart.template · extends an existing model
- account.plugins.wizard · new modelcompany_id, force_update, plugin_line_ids (Plugins)
- account.settings.xml.file · new modell10n_bg_config_file (Config xml File)
- account.plugins.wizard.line · new modelname, state, plugin_id (Plugin), wizard_id (Wizard), to_install (Install), to_uninstall (Uninstall)
- account.settings.preview.xml.file · new modell10n_bg_config_file (Config xml File), l10n_bg_config_file_preview (XML Preview)
Text generated by AI (DeepSeek) from reading the Odoo 18.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-03Confirmation status: 1 confirmed, 8 with no information of 9 versions.
Sources · Odoo 18.0
Confirmed on 2026-11-03 in branch 18.0 of OCA/l10n-bulgaria.
terminal Installation and usage
OCA documentation · Odoo 18.0Configuration
Source · Odoo 18.0- Installation:
- Go to Apps.
- Search for l10n_bg_config and install it.
- Post-Installation Configuration:
- Open Settings > Localization > Bulgarian Localization.
- Enable required modules and review settings.
- Error Troubleshooting:
- Check logs if any modules fail to install.
- Ensure all dependencies are present.
No verified information in OCA: Installation, Usage.
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.