🇺🇦 Повідомлення про прийняття на роботу
XML-генератор за Постановою КМУ № 413 для Odoo 19
Формує XML-файл повідомлення про прийняття працівника на роботу до Державної податкової служби України. Дві форми (J3001005 для юридичних осіб та F3001005 для ФОПів) — обирається автоматично. Один файл на одного працівника або один файл на групу, кадровик вирішує сам.
Навіщо це
За статтею 24 Кодексу законів про працю України кожне прийняття працівника на роботу має бути повідомлене до ДПС до того, як працівник приступив до роботи. Інакше — штрафи, навіть якщо все інше оформлено правильно.
Стандартний шлях — заповнити форму в МЕДОК або в Електронному кабінеті ДПС. Це означає переписувати реквізити з картки працівника в чужий інтерфейс, вручну. Цей модуль робить XML прямо з Odoo, із заповнених даних компанії та працівника, за одним натисканням. Залишається підписати ЕЦП у вашому звичному каналі та надіслати.
Файл відповідає схемі ДПС: кодування windows-1251, ім'я за стандартом Наказу Міндоходів № 729, поточна версія схеми 5 (Постанова КМУ № 184 від 21.02.2025).
Як це працює
Сценарій 1 — один працівник
На картці працівника з'являється кнопка «Сформувати XML Повідомлення». Натискаєте — відкривається діалог із пропозицією перевірити тип повідомлення (H01 — первинне, H02 — скасування), дату подання та звітний місяць. Натискаєте «Сформувати XML» — файл прикріплюється до картки працівника, в історії з'являється запис.
Сценарій 2 — група працівників
У списку працівників вибираєте кількох (галочки в лівій колонці), у меню Дії обираєте «Сформувати Повідомлення (413)». Той самий діалог відкривається з уже заповненим списком — один файл буде сформовано на всю групу, по рядку на людину. Зручно, коли в той самий день оформлено кілька прийнять.
Що далі
Файл прикріплено до картки — завантажуєте його з Odoo,
відкриваєте у МЕДОК або в Електронному кабінеті ДПС
(cabinet.tax.gov.ua), підписуєте КЕП,
надсилаєте. Або імпортуєте в інший канал, який вам
звичний — формат стандартний, його приймають усі.
Перед першим використанням
Модуль перевіряє наявність обов'язкових даних перед генерацією. Якщо чогось бракує — покаже перелік, файл не сформує. Це безпечніше, ніж відправити неповний звіт і чекати відмови від ДПС.
На компанії (вкладка «Українська реєстрація»)
- ЄДРПОУ або РНОКПП (для ФОП)
- ПІБ керівника та його РНОКПП
- Коди регіону, району та ДПІ-отримувача
На картці працівника
- РНОКПП — 10 цифр або 2 літери + 6 цифр
- ПІБ у форматі «Прізвище Ім'я По-батькові»
- Тип трудового договору (основний, сумісництво, гіг-контракт, ЦПД)
- Дата початку контракту
- Для основного та сумісництва — номер і дата наказу про прийом
⚠️ Формат ПІБ — важливо
Для українських звітів ПІБ записується у форматі «Прізвище Ім'я По-батькові», де прізвище стоїть першим. Це український стандарт офіційних документів — кадрові накази, особові картки, реєстраційні документи всі дотримуються цього порядку.
Модуль розкладає legal_name картки
працівника на три частини за пробілами і вважає,
що порядок саме такий: перше слово — прізвище,
друге — ім'я, третє — по батькові.
Правильно: «Сірко Іван Петрович».
Неправильно: «Іван Сірко Петрович» — піде
в ДПС із полями прізвище та ім'я,
переставленими місцями.
За цифрами
- 2 форми ДПС — J3001005 та F3001005, перемикання автоматичне
- 1 XML-файл на групу — один наказ, одне повідомлення, що б не казали
- 43 символи у назві файлу — рівно за стандартом Наказу Міндоходів № 729
- windows-1251 — те, чого хоче ДПС
- 4 категорії трудових відносин — основний трудовий, сумісництво, гіг, ЦПД
- 2 секунди — типовий час від натискання кнопки до готового файлу
- 0 ручного переписування реквізитів з Odoo в МЕДОК
Що модуль не робить
Модуль формує XML-файл. Подача до ДПС, підписання КЕП, отримання квитанцій — поза його межами. Чому: інтеграція з API ДПС вимагає окремої сертифікації і робить модуль крихким (зміни на стороні ДПС ламають модуль). Натомість файл з модуля можна завантажити у будь-який звичний канал — МЕДОК, Електронний кабінет ДПС, IT-компанії-посередники — всі вони приймають стандартний XML.
✅ Самодостатній. Працює на Community
Модуль не потребує Odoo Enterprise. Працює
однаково на Community і Enterprise редакціях.
Жодних прихованих залежностей від платних модулів
Odoo — лише два модулі моєї української
локалізації, обидва вільні (LGPL-3):
l10n_ua_registration та
l10n_ua_hr_employee.
Купуєте — отримуєте все необхідне для генерації повідомлення-413. Жодних доточок, жодних обмежень «у Pro-версії можна більше».
Підтримка та оновлення
- Канал: електронна пошта
olga@golodaeva.org.ua - Час реакції: best effort, зазвичай 2–3 робочих дні
- Що входить: виправлення помилок та адаптація під зміни форми ДПС — протягом усього терміну активної розробки модуля (поки Odoo 19 є поточним LTS)
- Окремо: налаштування під специфіку клієнта та допомога з інсталяцією — за окремою домовленістю
Коли ДПС випустить нову версію форми, я публікую оновлення модуля з відповідним bump'ом схеми. МЕДОК і Електронний кабінет ДПС зазвичай ще кілька місяців приймають попередню версію — так що оновлення рідко буває терміновим.
Сумісність
- Версія Odoo: 19.0
- Редакції: Community та Enterprise — обидві
- Залежності:
l10n_ua_registration,l10n_ua_hr_employee - Ліцензія: OPL-1
Окрема гілка 18.0 підтримується для Odoo 18.
Slava Ukraini · Героям слава
🇬🇧 English
Generates the XML notification of a new hire to the Ukrainian State Tax Service (Постанова КМУ № 413 of 17.06.2015, schema version 5). Two forms — J3001005 for legal entities, F3001005 for sole proprietors — selected automatically from the company flag.
Two ways to generate: a button on the employee form for a single hire, or an action on the employee list view for a batch. The wizard validates required data first, then renders the XML in windows-1251 encoding, names it per the DPS naming standard (Order № 729 of 29.11.2013), and attaches it to each included employee. Submission to the tax service is manual through the Electronic Office of the DPS, MEDOC, or any other accepted channel.
Self-contained and works on Odoo Community. No Enterprise edition required, no hidden dependencies. Bug fixes and adaptation to schema changes are included in support for as long as the module is in active development.
| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Employees (hr)
• Skills Management (hr_skills) • Discuss (mail) |
| Community Apps Dependencies | Show |
| Lines of code | 1933 |
| Technical Name |
l10n_ua_hr_employment_notification |
| License | OPL-1 |
| Website | https://golodaeva.org.ua |
Odoo Proprietary License v1.0 This software and associated files (the "Software") may only be used (executed, modified, executed after modifications) if you have purchased a valid license from the authors, typically via Odoo Apps, or if you have received a written agreement from the authors of the Software (see the COPYRIGHT file). You may develop Odoo modules that use the Software as a library (typically by depending on it, importing it and using its resources), but without copying any source code or material from the Software. You may distribute those modules under the license of your choice, provided that this license is compatible with the terms of the Odoo Proprietary License (For example: LGPL, MIT, or proprietary licenses similar to this one). It is forbidden to publish, distribute, sublicense, or sell copies of the Software or modified copies of the Software. The above copyright notice and this permission notice must be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
Please log in to comment on this module