Робота з даними

Чи потрібні всі записи

Для компактних класифікаторів зберігайте повну версію як основу. У робочому інтерфейсі показуйте добірку, потрібну організації. Так можна додати новий код без повторного збирання джерела та перевірити старі документи.

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

Кількість записів сама по собі не є причиною звужувати довідник. Важливі умови доступу, обсяг, частота змін і можливість перевірити повноту. Повний імпорт не потребує окремої вікістатті для кожного коду: стаття пояснює поняття, таблиця містить записи.

Як підчистити під себе

Можна прибрати зайві пробіли, уніфікувати формат, додати зрозумілі назви й синоніми, приховати непотрібні записи та зібрати свої групи. Зберігайте три окремі шари.

Оригінал видавця. Незмінний файл, URL, дата отримання та контрольна сума.
Нормалізований довідник. Коди, офіційні назви, ієрархія, версія та посилання на рядок джерела. Перетворення мають бути відтворюваними.
Власний профіль. Коротка назва, пошукові синоніми, обране, приховані записи, внутрішній ID і нотатка. Він посилається на офіційний запис, а не замінює його.

Приклад

Офіційна назва території: «Київ». У формі організації можна показувати «м. Київ» і знаходити запис за «Kyiv». Код КАТОТТГ та назва джерела зберігаються. Зміна нашої назви не створює нової офіційної території.

Прихований запис залишається доступним для старих документів. Помічену помилку джерела записуйте окремою приміткою з підставою; офіційний текст зберігайте. Внутрішній рахунок або посада мають власний ID та явну відповідність зовнішньому довіднику.

Що робити після оновлення джерела

Порівняйте стару й нову версії. Власні назви та нотатки залишаються. Якщо офіційний код зник, змінив назву, батьківський запис або зміст, позначте відповідність для перегляду. Поділ чи об’єднання кодів потребує явного рішення; автоматично переносити старий вибір не слід.

Для повторного поширення та комерційного використання окремо перевірте умови конкретного набору. Відкритий перегляд не означає однакових умов для всіх матеріалів сайту.

Приклад власного профілю · JSON ↓

Це приклад структури для майбутньої системи. Редактор профілів, збереження користувацьких змін і автоматичне злиття в Ладі ще не реалізовані.

Як часто перевіряти оновлення

Нижче наведено пропозицію для власної системи. Графік видавця та стан перевірки описані в кожному паспорті.

Плани рахунків і професії: Щотижнева перевірка публікацій та додаткова звірка перед впровадженням змін. Нові редакції з’являються за актами, а не за щотижневим розкладом.
КВЕД: Щомісячна перевірка за стабільної редакції; під час переходу на іншу класифікацію частоту збільшити. Стару й нову системи кодів зберігати паралельно.
КАТОТТГ: Щотижнева перевірка публікацій. Дати перейменування, реорганізації та отримання файла зберігати окремо, коли вони встановлені.
Курси: Отримувати значення на потрібну дату при валютній операції; для системи з щоденними операціями перевіряти щодня. Дату курсу й одиницю звіряти з відповіддю та документацією.
Реєстровий статус: Перевіряти перед залежною операцією. Строк кешування залежить від наслідків застарілого статусу та лімітів сервісу.
Форми звітності та реквізити: Додатково звіряти перед підготовкою звіту або платежу, навіть якщо планова перевірка вже була.

Перевірка джерела може завершитися висновком «змін немає». Завантаження нової редакції, її перевірка та початок застосування є окремими подіями. Для історичної операції обирають застосовну версію на її дату.

Перехід КВЕД уже треба враховувати

Наказ Держстату № 191 від 28.10.2025 передбачає введення NACE 2.1-UA з 01.01.2027. План переходу містить застосування у статистичній діяльності з 2027 року й наступні заходи у 2028 році. Це підстава готувати версії та відповідності, а не автоматично змінювати всі реєстраційні дані підприємств.

Наказ Держстату № 191 ↗ · Пояснення етапів переходу ↗

Де брати бухгалтерські рахунки

Спочатку визначте вид суб’єкта та застосовну систему обліку. Потім оберіть нормативний план і його інструкцію. Робочий план організації зберігайте як окрему версію з посиланнями на нормативну основу.

План рахунків підприємств і організацій →Спрощений План рахунків →План рахунків державного сектору →План рахунків банків України →

Порядок перевірки актуальності

На офіційній сторінці звірте орган, номер акта, статус і редакцію на потрібну дату.
Перевірте зміни та перехідні положення. Дата наказу, початок дії та дата отримання файла можуть різнитися.
Витягніть коди й назви, звірте їх з інструкцією. Збережіть клас, рахунок, субрахунок і примітки.
Зіставте нормативні коди з робочим планом. Додані організацією рахунки позначте як внутрішні.

Три різні значення «рахунків»

Бухгалтерський рахунок групує записи. Банківський рахунок використовується для коштів та операцій. Бюджетні платіжні реквізити визначають, куди сплачувати конкретний платіж.

Розібрати слово «рахунок» · Рахунки для сплати податків

Які дані зберігати окремо

Класифікатори: коди, назви, ієрархія, редакція. Наприклад, КАТОТТГ або професії.
Показники на дату: значення, одиниця, період і методологія. Наприклад, курс або ІСЦ.
Реєстрові відомості: суб’єкт, статус, дати подій та час перевірки.
Форми й правила: редакція, застосовність, структура документа та змістові перевірки.
Внутрішні довідники: підрозділи, штат, номенклатура, аналітика. Їх визначає організація; зовнішні коди додають через окремі відповідності.

Як тягнути дані

Публічний API

Зберігайте параметри запиту, відповідь і час отримання. Перевіряйте статус, схему та дату даних. Для сторінкових відповідей зберігайте курсор і обробляйте повторні записи.

API з токеном

Визначте потрібний реєстр і повноваження. Токен тримайте на сервері. Повторні запити та кеш мають ураховувати ліміти видавця. Деталі є в паспорті реєстрів ДПС.

Файл XLSX, CSV, XML або ZIP

Зберігайте оригінал перед перетворенням. Перевіряйте кодування, початкові нулі, структуру колонок і дату всередині документа. Для ZIP окремо перевіряйте склад і розмір розпакованих файлів.

Вебсторінка або PDF

Спочатку шукайте офіційний файл чи документований API. Якщо потрібне витягування таблиць із тексту, зберігайте джерело кожного рядка та передбачте перевірку після зміни верстки.

Каталог відкритих даних

Метадані показують, де лежать файли. Успішний запит опису набору не доводить доступності або свіжості його ресурсів. Приклад CKAN →

Як оновлювати без втрати історії

Розрізняйте графік видавця, фактичну дату публікації та власний графік перевірки. У паспорті джерела вони описані окремо.

Отримати нову копію та перевірити формат.
Порівняти контрольну суму, кількість записів і ключі.
Показати додані, змінені та вилучені записи. Не видаляти історію лише через відсутність запису в новому файлі.
Для нормативних змін визначити дату застосування та залежні правила.
Після перевірки опублікувати нову версію; попередню залишити доступною.

Якщо джерело недоступне, зберігайте останню успішну копію з її датою та станом. Помилку отримання не перетворюйте на порожній довідник.

Мінімальний паспорт імпорту

Джерело: Видавець, URL, ID набору або ресурсу, умови використання.
Версія: Редакція, дата публікації та дати застосування, якщо встановлені.
Отримання: Час запиту, параметри, HTTP-результат, контрольна сума оригіналу.
Запис: Стабільний ключ, офіційна назва, батьківський код, посилання на джерело.
Перетворення: Версія імпортера, правила очищення та результат перевірок.
Відповідність: Внутрішній ID системи, зовнішній код, період і підстава зіставлення.

Редакційний синонім зі словника не підміняє офіційну назву. Виправлення користувача зберігайте окремо від первісних даних видавця.

Що вже доступне

У Ладі є паспорти джерел, два збережені набори з пошуком і завантаженням, оригінальні файли та контрольні суми. Каталог доступний людям і агентам з однаковими позначками стану.

Набори зі збереженими даними →Каталог у JSON →Паспорт збережених копій →

Автоматичний збір, історичні зміни всіх довідників і підключення до приватних облікових систем ще не реалізовані. Рекомендовані інтервали в картках не запускають оновлення.

Дані для обліку та майбутньої ERP