Укрпошта: адресний класифікатор та індекси

Пояснення й структура

kind

Зовнішній довідник

links

• label

  Адресний класифікатор v3.21, 14.05.2026

  url

  https://dev.ukrposhta.ua/uploads/address-classifier-v3.21-14052026-ukr.pdf

• label

  Пошук відділень та індексів, 11.02.2026

  url

  https://dev.ukrposhta.ua/uploads/Search-offices-and-indexes-v3-11022026.pdf

formats

• GET API
• JSON
• XML

auth

Bearer у заголовку Authorization; документація передбачає отримання в додатку до договору. Для JSON потрібен Accept: application/json.

providerUpdates

За змінами у видавця; гарантований інтервал у цій перевірці не встановлено.

refreshAdvice

Пропозиція: інтерактивний пошук із кешем; звірка індексу перед відправленням.

verification

Переглянуто документацію v3.21. Запитів із токеном не виконували.

extract

• Зберегти джерело, версію, умови використання та дату отримання.
• Зіставляти із внутрішніми записами через окремі відповідності.

conceptIds

• contractor
• document

relatedIds

• nova-poshta
• katottg
• edra

id

ukrposhta-addresses

name

Укрпошта: адресний класифікатор та індекси

group

Адреси й доставка

summary

Пошук адресних компонентів і поштового індексу для доставки.

publisher

АТ «Укрпошта»

sourceUrl

https://dev.ukrposhta.ua/documentation

access

address-classifier-ws на www.ukrposhta.ua. Документація описує пошук області, району, населеного пункту, вулиці, номера будинку та індексу.

keys

• REGION_ID, DISTRICT_ID, CITY_ID, STREET_ID у просторі Укрпошти
• POSTCODE зберігати текстом; КАТОТТГ у відповіді звіряти з офіційним набором

pitfalls

• Поштовий індекс не є унікальним ID будинку.
• Порожня відповідь може бути наслідком обмеження навантаження або відсутності параметрів.

coverage

Поштове обслуговування адрес; повноту всіх адрес України не перевірено.

limits

Документація орієнтує на інтерактивний пошук, кешування й повторні запити із затримкою. Масове вивантаження не тестувалося.