Ukraine Address Integration - Company

Еталонний довідник адрес України

(Reference Directory of Ukrainian Addresses)

Компанія DM Solutions з 2012 року створює екосистему цифрових рішень, що об’єднує геодані різних країн Світу, які оновлюються щодня та готові до інтеграції у ваші бізнес-процеси.

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

Члени асоціації «IT Ukraine»

Члени Спілки Diia.City Union

Наші патенти:
Алгоритм DATABASE CLEANER — Свідоцтво №47456
ADDRESS BOOK UKRAINE — Свідоцтво №46082

Динаміка перейменування 2020-2025 рр в Україні

Зміни після проведення реформи

адміністративно - територіального устрою 2020 року

72,2% населених пунктів змінили своє підпорядкування району.

Наша онлайн-платформа www.Geodata.online надає доступ до поштових і фізичних адрес України за допомогою API і містить такі дані:

• Область        (актуальна назва і архів)
• Район        (актуальна назва і архів)
• Громада        (актуальна назва і архів)
• Населений пункт        (актуальна назва і архів)
• Назва вулиці        (актуальна назва і архів)
• Типів населеного пункту і вулиці        (актуальна назва і архів)
• Номер будинку
• Корпус / літера
• Актуальний індекс Укрпошти
• Міський телефонний код
• КАТОТТГ і архів КОАТУУ населених пунктів
• GPS координати населеного пункту і будинку
• Англійську транслітерацію
• Статус територій  на дату запита адреси*  

*Згідно наказу «Про затвердження Переліку територій, на яких ведуться (велися) бойові дії або тимчасово окупованих російською федерацією» від 28.02.2025 № 376

Переваги використання модуля “Еталонний довідник адрес України”

1. Можливість актуалізувати дані
2. Відсутність помилок у введенні даних
3. Єдиний стандартизований формат
4. Коректна робота з однаково написаними вулицями 
5. Доповнення адреси додатковими атрибутами
6. Відповідність офіційним поштовим стандартам
7. Швидке та зручне заповнення форм

Окрім власне інтеграційного шару з API Geodata.online, який дозволяє підключити адресний функціонал до будь‑якої моделі Odoo, ми подбали про те, щоб Вам не доводилося робити це вручну. Ми одразу вбудували адресні поля та логіку автодоповнення у всі ключові стандартні бізнес‑сутності, де адреси використовуються щодня.

Початок роботи

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

У період з  19 по 31 березня (включно) 2026 року буде нараховано 300 грн.

Розмір Бонусу може змінюватися.

Актуальна інформація щодо Наших цін,  тарифних планів та розміру Бонусу публікується на сайті www.geodata.online

Фінанси

В Особистому кабінеті в розділі Фінанси можна:

• Ознайомитись з балансом
• Згенерувати рахунок
• Поповнити рахунок онлайн
• Ознайомитись із статистикою оплат

На кожній сторінці кабінету можна отримати підтримку в онлайн-чаті.

Користування

Коли модуль встановлено та налаштовано, то на картці Контакта з’являється нова вкладка Інформація про адресу та для кожного нового контакту автоматично зазначається країна Україна.

Класичний спосіб введення адреси

Починаємо введення адреси в такій послідовності:

1. Країна (Україна)
2. Населений пункт
3. Вулиця і будинок

Підказки з’являтимуться автоматично, щойно ви введете три або більше символів (в Україні є кілька назв населених пунктів які складаються з двох літер, тому ці населені пункти можна знайти користуючись додатковим методом пошуку). Система звернеться до довідника і покаже відповідні варіанти, з яких можна обрати потрібний.

Після появи підказки ви можете обрати потрібний населений пункт.

Модуль автоматично заповнить поля «Місто» та «Область», а також покаже поля з інформацією про район і громаду.

Поруч з актуальною назвою населеного пункту в дужках відображається стара назва (до перейменування), якщо раніше відбувались перейменування.

Користувач може вводити як актуальну назву населеного пункта так і стару - модуль так само надасть відповіді правильні підказки.

Наступним кроком вводимо назву вулиці.

Після введення трьох або більше символів система запропонує список усіх вулиць, у назві яких містяться введені символи.

Якщо ви введете стару назву, у підказках автоматично з’явиться її актуальна, нова назва, а в дужках буде зазначена стара.

Наступний крок - це отримання номеру будинку по вибраній вулиці.

Для цього потрібно набрати цифру та отримати список із підказками по існуючим номерам будинків в довіднику.

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

Додатковий спосіб внесення адреси

Переходимо на вкладку: Інформація про адресу

В цьому полі допустиме введення адреси в різних комбінаціях:

1. Населений пункт, Вулиця і будинок
2. Район, Населений пункт, Вулиця і будинок
3. Область, Населений пункт, Вулиця і будинок
4. Область, Район, Населений пункт, Вулиця і будинок

Елементи адреси вносяться через пробіл.

Приклади комбінацій внесення:

1. Пошук по назві населеного пункту - формується підказка по співпадінням у всіх областях України.

Результат - отримаємо в підказці 8 населених пунктів.

2. Пошук по назві району та назві населеного пункту - формується підказка по співпадінням у відповідних районах України.

Результат - отримаємо в підказці 2 населених пункта.

3. Пошук по назві області та назві населеного пункту - формується підказка по співпадінням у відповідних районах України.

Результат - отримаємо в підказці 3 населених пункта.

4. Пошук по назві області, назві району та назві населеного пункту - формується підказка по співпадінням у відповідних районах України.

Результат - отримаємо в підказці 2 населених пункта.

Обираємо відповідну вулицю та номер будинку:
Після початку введення надаються підказки існуючих номерів будинків, які починаються із відповідних цифр.

Вкладка: Інформація про адресу

На цій вкладці надається корисна інформація по адресі що ввели.

Розділ Деталі адреси містить:

• КАТОТТГ - Актуальний державний код територіальної одиниці за новим класифікатором після реформи.
• КОАТУУ - Старий код адміністративно-територіального устрою, що використовувався до впровадження КАТОТТГ.
• Статус територій згідно наказу - Відображає  статус території на дату отримання (оновлення) адреси. (Згідно наказу «Про затвердження Переліку територій, на яких ведуться (велися) бойові дії або тимчасово окупованих російською федерацією» від 28.02.2025 № 376.
• Дата отримання (оновлення) адреси - поточна дата запиту

Розділ Повні адреси для документів:

• Готовий, автоматично сформований рядок для документів. Модуль складає адресу у форматі який визначений в налаштуваннях, придатному для офіційних документів.
• Транслітерація адреси (якщо ввімкнено в налаштуваннях). Автоматично створюється англомовна версія адреси відповідно до чинних правил української транслітерації. Формат зберігає структуру української адреси, але всі елементи подаються латиницею.

Розділ Повні адреси для листів:

• Готовий, автоматично сформований рядок адреси для поштових конвертів. Модуль складає адресу у форматі який визначається користувачем (адміністратором) в налаштуваннях, згідно правил.
• Транслітерація адреси (якщо ввімкнено в налаштуваннях). Автоматично створюється англомовна версія адреси відповідно до чинних правил української транслітерації. Формат зберігає структуру української адреси, але всі елементи подаються латиницею.

Зазначені розділи прискорюють перенесення адреси в інші форми та  шаблони простим натисканням кнопки.

Повна інформація про адресу

Для отримання повної інформації по адресі, а це більше 40 атрибутів, потрібно перейти на відповідну форму по посиланню (Рядок із написом адреси блока Деталі адреси).

Основна інформація на сторінці згрупована в інформаційні блоки:

• Адміністративний
• Координати
• Англійська транслітерація
• Метро
• Старі назви
• Додатково

Блок “Адміністративний”

Розділ “Адреса”

Розділ “Коди та статус”

Блок “Координати”

Розділ «Координати будівлі»

Ці координати відповідають фактичній точці будівлі

Розділ «Координати населеного пункту»

Ці координати відповідають центру населеного пункту

Блок “Англійська транслітерація”

Блок “Метро”

Блок “Старі назви”

Блок “Додаткова інформація”

Конфігурація

Перший крок - реєстрація

Після встановлення модуля відкрийте налаштування: меню GeoData.online, меню Облікові дані API.

Натисніть кнопку Новий та створіть новий API Credentials.

На вкладці API Configuration перейдіть за посиланням вказаним в п.1 опису How to get API credential. Зареєструватись в Особистому кабінеті.

Реєстрація в кабінеті Geodata.online.

Виберіть вкладку Зареєструйся та заповніть відповідні дані:

На вашу пошту буде надіслано лист для підтвердження реєстрації.

Після закінчення реєстрації поверніться в налаштування модуля на форму API Credentials та введіть, використані для реєстрації на платформі GeoData.online, логін та пароль для отримання токену.

Перевірте підключення натиснувши кнопку: Test Connection.

Оновіть список областей в довіднику Odoo кнопкою: Sync Ukraine States.

Модуль підключений до довідника і з ним можна працювати!

Додаткові налаштування

Вкладка Setting містить такі налаштування:

• отримання української транслітерації адрес (платна функція)
• визначення порядку та наявності елементів адреси для договорів
• визначення порядку та наявності елементів адреси для конвертів

Підтримка

Якщо у вас є питання - зв’яжіться із нами:
support@geodata.online

Офіційний сайт:

www.geodata.online