Перейти до основного контенту
База знань · виробничий облік USD41,42 ПДВ20% МЗП8 000

Odoo

Модуль

l10n_ua — українська локалізація

Базовий модуль адаптації Odoo до України: план рахунків, ПДВ-ставки, валюта, дати. Що в коробці є, а чого немає.

Шлях у меню
Налаштування → Компанії → Локалізація: Україна
Технічна модель
account.chart.template (l10n_ua), account.tax, res.country.state
Редакція
2026-05-28

Що це і навіщо

l10n_ua — це офіційний модуль Odoo для України. Стандартний, безкоштовний, входить в основу. Активуєш його при створенні компанії — отримуєш український план рахунків, базові податки, валюту UAH. Це необхідний мінімум, без якого з Odoo в українському бізнесі не почнеш.

Важливо одразу зрозуміти: l10n_ua — це скелет, а не повноцінне рішення. План рахунків там є, але без типових проводок. ПДВ-ставки є, але без зв’язку з ЄРПН. Декларації немає, ПН немає, касової книги немає. Тому реально для українського підприємства треба або купити Oblik-ERP (комерційний пакет поверх l10n_ua), або писати свої модулі поверх.

Як це працює

При активації l10n_ua Odoo робить три речі:

  1. Завантажує account.chart.template для України. Це шаблон плану рахунків. На його основі під час створення компанії розгортається account.account — реальний робочий план. Структура — за наказом Міністерства фінансів № 291 (для виробничих, торговельних, надавачів послуг).
  2. Створює account.tax для типових ставок. 20%, 7%, 0%, без ПДВ. Це базові tax records, до яких потім прив’язуються продукти і fiscal positions.
  3. Прописує дрібниці. UAH як валюта компанії за замовчуванням, формат дат, шаблон ІПН/ЄДРПОУ.
# Подивитись завантажений шаблон
chart = self.env.ref('l10n_ua.l10n_ua_chart_template_uah')
# Які податки створено
taxes = self.env['account.tax'].search([
    ('country_id.code', '=', 'UA'),
])
for t in taxes:
    print(t.name, t.amount, t.type_tax_use)

Шлях у меню: Settings → Companies → Localization → Ukraine. Після активації — Accounting → Configuration → Chart of Accounts (план рахунків) і Accounting → Configuration → Taxes (ставки).

У контексті українського обліку

Що l10n_ua дає з коробки:

  • План рахунків (1-9 класи, основні синтетичні).
  • Базові податки 20%/7%/0%/без ПДВ.
  • UAH як валюта.

Чого немає і що треба будувати:

  • Журнальна структура. Стандарт пропонує sale/purchase/cash/bank/misc. Для UA треба ще: «Каса», «Розрахунки у валюті», «ПДВ-зобов’язання», «ПДВ-кредит», «Закриття місяця» — щоб звіти читалися.
  • Друковані форми. Жодної української первинки немає. Видаткова, ТТН, акт, ПН, ПКО/ВКО, авансовий звіт — все або через Oblik-ERP, або власні QWeb-шаблони.
  • Декларації. ПДВ, прибуток, об’єднана звітність ЄСВ/ПДФО — нічого не йде з коробки. Тільки англомовний tax report зі стандартного модуля account_reports.
  • ЄРПН-інтеграція. Нуль. Реєстрація ПН, статус-моніторинг РК — це власна розробка або сторонні модулі (M.E.Doc-bridge, Сота, FreDoc).
  • СЕА-облік. Жодних балансів реєстраційних лімітів.
  • МШП. Облік малоцінних швидкозношуваних з картками експлуатації — нема.

Як ми робимо (defense-контекст)

ТОВ «УкрПром-Тех» побудувала свій облік ось як:

  1. Основа — l10n_ua. План рахунків, ставки.
  2. Поверх — Oblik-ERP (комерційний). Дає 80% потрібного: друковані форми, касова книга, авансові звіти, ЗЕД, базовий ПДВ-облік, заробітна плата.
  3. Свої модулі — defense-специфіка. Трасабіліті за серійними номерами, інтеграція з Прозоро.МО для тендерів, контроль ВТП/ЕUC для експорту, конфігураційне керування виробами, кастомні звіти за контрактами А-XXXX, спецформи М-11 з defense-смугою.

Тобто l10n_ua для нас — це не «рішення», а «опора, на якій тримається все решта». Решта стека лягає поверх.

Типові граблі

  • «Активував l10n_ua, чому декларації нема?» Бо її там і не задумано. Ставиш модуль l10n_ua_vat_report (від Oblik або власний) — отримуєш декларацію.
  • Подвійне завантаження плану рахунків. Якщо створив компанію без локалізації, а потім ставиш l10n_ua — план не накотиться. Або починай з чистої компанії, або накатуй вручну через CSV.
  • Lock date немає. Стандарт не виставляє. Перший же бухгалтер запостить проводку у січень 2025 — і твоя річна декларація полетіла. Виставляй вручну після кожного періоду.
  • Тільки UAH. Якщо тобі треба експорт у USD/EUR — додавай валюти через Accounting → Configuration → Currencies і вмикай currency_provider='nbu' для автоматичного підтягування курсу.
  • План рахунків забитий до межі. Шаблон дає кілька сотень рахунків, з яких реально працюють 50-80. Решта плутає бухгалтера. Не бійся вимикати непотрібні (active=False).
  • l10n_ual10n_ua_accounting. У різних версіях іноді бувають два модулі: один з планом, інший з податками. Перевір, чи активовано обидва, якщо чогось не вистачає.

Дотичне

Де цей модуль зустрічається4