ЛадДля агентів ↗
Довідник/Дані/Нова пошта: населені пункти й точки доставки

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

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

Формат і доступ

Формати
JSON API, XML API
Спосіб отримання
POST до https://api.novaposhta.ua/v2.0/json/. Перевірено Address.getSettlements і Address.getWarehouses з Page=1, Limit=2.
Авторизація
Обидва пробні запити з порожнім apiKey повернули success=true. Для робочої інтеграції звірити вимоги методу; офіційна інструкція описує ключ бізнес-кабінету.
Охоплення
Перевірено населені пункти та точки обслуговування. Вулиці, будинки й повноту покриття окремо не перевірено.
Обмеження
Ліміти запитів і гарантований графік оновлення не встановлені. Проби не є навантажувальним тестом.
Повторне використання
API-доступ сам по собі не підтверджує право публікувати повну копію. Умови кешування й поширення треба погодити з документацією або договором.

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

Офіційне джерело ↗

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

Як часто оновлюється

У джерелі

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

Як перевіряти у своїй системі

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

Рекомендація щодо перевірки не є гарантією видавця або активним розкладом Ладу.

Як отримати дані

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

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

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

{
  "apiKey": "",
  "modelName": "Address",
  "calledMethod": "getSettlements",
  "methodProperties": {
    "Page": "1",
    "Limit": "2"
  }
}

Це приклад запиту для сервера. Сторінка його не виконує.

Як зберігати та пов’язувати

Ключі записів

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

Межі й типові помилки

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

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