Нова пошта: населені пункти й точки доставки

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

kind

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

links

• label

  Документація розробника

  url

  https://developers.novaposhta.ua/documentation

formats

• JSON API
• XML API

auth

Обидва пробні запити з порожнім apiKey повернули success=true. Для робочої інтеграції звірити вимоги методу; офіційна інструкція описує ключ бізнес-кабінету.

providerUpdates

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

refreshAdvice

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

verification

2026-09-16 отримано по 2 записи. API повідомив totalCount=26770 для населених пунктів і 54530 для точок. Це заявлені числа, не перевірена повнота. Сторінка детальної документації повернула 403.

extract

• Запитати потрібний метод і сторінку; перевірити success, errors, data та info.totalCount.
• Для повного отримання опрацювати пагінацію, дублікати й зміни під час завантаження. Масове копіювання спочатку звірити з умовами сервісу.
• Зберігати тип точки, Ref, CityRef і SettlementRef окремо. Графік та активність мають дату перевірки.

conceptIds

• contractor
• document

relatedIds

• katottg
• ukrposhta-addresses
• edra
• osm

id

nova-poshta

name

Нова пошта: населені пункти й точки доставки

group

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

summary

Довідники перевізника для вибору місця доставки. Два методи перевірено живими запитами; повної копії в Ладі немає.

publisher

Нова пошта

sourceUrl

https://novaposhta.ua/en/for-business/cooperation/integration/

access

POST до https://api.novaposhta.ua/v2.0/json/. Перевірено Address.getSettlements і Address.getWarehouses з Page=1, Limit=2.

keys

• Провайдер + модель + Ref
• CityRef і SettlementRef є різними полями; не вважати їх КАТОТТГ

pitfalls

• Перелік точок доставки не є переліком усіх будинків України.
• Однакові назви населених пунктів не доводять відповідності; потрібні регіон та перевірка.
• WarehouseStatus, DenyToSelect, тип і обмеження точки впливають на можливість доставки.

coverage

Перевірено населені пункти та точки обслуговування. Вулиці, будинки й повноту покриття окремо не перевірено.

reuse

API-доступ сам по собі не підтверджує право публікувати повну копію. Умови кешування й поширення треба погодити з документацією або договором.

limits

Ліміти запитів і гарантований графік оновлення не встановлені. Проби не є навантажувальним тестом.

example

method

POST

url

https://api.novaposhta.ua/v2.0/json/

body

apiKey

modelName

Address

calledMethod

getSettlements

methodProperties

Page

1

Limit

2

note

Саме цей запит без ключа перевірено. Для інших методів режим доступу може відрізнятися. Результати перевірки: /data/access-checks.json.