Адресний довідник України — Geodata.online

Автозаповнення, нормалізація, геокодування та зберігання українських адрес для Odoo 19 (Community). Самодостатній модуль — без зовнішніх залежностей.

Що це

Ядро інтеграції з API Geodata.online: вводьте місто → вулицю → будинок із підказок, а модуль сам нормалізує адресу, підтягує офіційні коди (КАТОТТГ/КОАТУУ), координати та формує готові адреси для документів і листів українською й англійською (транслітерація).

Автозаповнення адрес

Власний OWL-віджет: підказки міста, вулиці й будинку прямо в адресному блоці (без майстра), із debounce, мінімальною довжиною запиту та дедуплікацією — зайвих (платних) запитів до API не робиться. Пошук працює лише для України.

Документи та листи

Готові повні адреси для договорів і листів — українською та англійською (транслітерація). Налаштовувані шаблони формату; район і громада заповнюються автоматично з вибору адреси.

Можливості

Нормалізація та коди. Зберігання канонічної адреси з кодами КАТОТТГ/КОАТУУ, статусом території, координатами та повним набором полів (UA + EN).

Історичні (старі) назви. За потреби — стара назва міста/вулиці/району/громади в дужках поряд із чинною; пошук і звірка прозоро ігнорують «(стару назву)». Для населеного пункту стара назва показується лише коли це справжнє перейменування, а не старе адміністративне підпорядкування.

Формати для документів і конвертів. Налаштовувані шаблони з готовим типовим набором: сегменти — через кому; поточна й стара назва, що йдуть поряд, об’єднуються в один сегмент «поточне (стара)». EN-версія повністю транслітерована, включно зі старими назвами й типами.

Геокодер. Провайдер геокодування для base_geolocalize — без побічного створення записів.

Health-моніторинг. Щоденна перевірка (плюс кнопка «Перевірити зараз»): доступність сервера, авторизація, баланс рахунку та наявність облікових даних. Проблеми потрапляють у журнал і спливають менеджерам.

Мультикомпанія. Облікові дані — глобальні або окремі на компанію; адреси, журнал запитів і сповіщення ізольовані за компаніями.

Безпека. Логін/пароль і токен — лише для адміністратора; токен у параметрах (sudo), у журналі запитів заголовок Authorization замаскований. Автозаповнення доступне будь-якому внутрішньому користувачу через sudo-сервіс.

Інтеграції (бриджі)

Уся логіка — в одному міксині, тож підтримка нових моделей тонка:

• Контакти (res.partner) — з вкладкою «Інформація про адресу»
• CRM — ліди/нагоди (crm.lead)
• Компанії (res.company)
• Кадри — приватна адреса працівника (hr.employee)
• Банки (res.bank)
• Обіди — постачальник обідів (lunch.supplier)

Налаштування

Адміністрування → Geodata.online → API Credentials → введіть логін/пароль акаунта geodata.online → Test Connection; оновіть області довідника кнопкою Sync Ukraine States.

Вимоги

Odoo 19.0 Community · Python 3.10+ · PostgreSQL · Python-пакет requests · дійсний акаунт на geodata.online.

© DM Solutions · geodata.online