Сколько стоит?

Подсказки входят в дневной лимит тарифа: на бесплатном плане это 10 000 запросов в сутки на все подсказки вместе.

Можно ли искать по городу, если покупатель не помнит индекс?

Да, отделения города приходят вместе с индексами. Отдельное поле для индекса не нужно.

Подойдёт ли для расчёта доставки?

Для выбора отделения и подстановки верного индекса — да. Координаты и график работы берут у службы доставки.

Как быстро подключить?

Ключ выдаётся в личном кабинете, подсказки вешаются на поле индекса в существующей форме доставки.

справочник

Почтовые
отделения

Отделения Почты России: поиск по почтовому индексу или названию отделения, населённый пункт и регион.

Документация →

40K+

отделений

~3мс

ответ

Почта

России

POST

↵ enter

200 OKapplication/json, 7ms

{
  "query": "101000, г. Москва",
  "suggestions": [
    {
      "value": "101000, г. Москва",
      "code": "101000",
      "name": "Москва",
      "region": "г. Москва",
      "address": "г. Москва"
    }
  ]
}

Форма с подсказками: Почтовое отделение для отправления

Сценарий: Почтовое отделение для отправления →

что вы получаете

Возможности почтовые отделения

Индекс

Почтовый индекс отделения.

Населённый пункт

Населённый пункт и регион отделения связи.

Поиск

По индексу или названию.

Поля ответа 5

Наши методы отдают структурированный JSON: каждая сущность — отдельным объектом.

/v1/suggest/postal_office

Переходите с DaData — те же подсказки работают по привычным адресам в их формате. Менять код не нужно: другими будут только базовый адрес и заголовок авторизации.

/suggestions/api/4_1/rs/suggest/postal_unit

Готовое значениеКодНазваниеРегионАдрес

Источник: Почта России, справочник ОПС — официальный справочник Почты России.

о сервисе

Что такое справочник почтовых отделений

Отделения почтовой связи — больше 41 тысячи по всей России. Закрывает поле индекса в форме доставки: покупатель вводит шесть цифр или название города и выбирает своё отделение из списка. В заказ уходят индекс, отделение и регион. Запрос «101000» приводит к отделению в Москве, а поиск по названию города показывает его отделения вместе с индексами. Индекс перестаёт быть тем, что покупатель вспоминает наизусть.

Как подключить справочник почтовых отделений

Одно поле формы закрывает оба сценария ввода: и индекс, и название города ищутся одинаково, поэтому спрашивать покупателя, знает ли он индекс, не нужно. Выбранное отделение подставляется в форму строкой с индексом и городом, а сами значения уходят в заказ. Подсказки вешаются на существующее поле доставки — переделывать форму не придётся.

Что важно знать про справочник почтовых отделений

Справочник доводит адрес до населённого пункта: индекс, отделение, регион и город. Он подходит, чтобы выбрать отделение и подставить верный индекс в форму или адресный блок. Для расчёта маршрута или проверки, открыто ли отделение сейчас, понадобятся данные службы доставки.

тарификация

Подсказки

Подсказки входят в дневной лимит тарифа и доступны на всех планах, включая бесплатный.

в подпискепо дневному лимиту

Все тарифы и цены →

сценарии

Где это полезно

пример заполнения и API

Почтовое отделение для отправления

Почтовое отделение по индексу или названию: подсказки заполняют индекс, регион и адрес отделения Почты России. Пример формы отправления и код API.

Посмотреть пример

Все сценарии API

вопросы

Частые вопросы про справочник почтовых отделений

Сколько стоит?: Подсказки входят в дневной лимит тарифа: на бесплатном плане это 10 000 запросов в сутки на все подсказки вместе.
Можно ли искать по городу, если покупатель не помнит индекс?: Да, отделения города приходят вместе с индексами. Отдельное поле для индекса не нужно.
Подойдёт ли для расчёта доставки?: Для выбора отделения и подстановки верного индекса — да. Координаты и график работы берут у службы доставки.
Как быстро подключить?: Ключ выдаётся в личном кабинете, подсказки вешаются на поле индекса в существующей форме доставки.

по теме