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

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

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

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

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

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

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

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

справочник

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

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

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

40K+

отделений

~3мс

ответ

Почта

России

POST

↵ enter

200 OKapplication/json · 7ms

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

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

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

Индекс

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

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

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

Поиск

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

Поля ответа 5

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

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

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

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

о сервисе

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

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

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

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

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

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

тарификация

Подсказки

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

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

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

сценарии

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

// delivery

Доставка

Подбор отделения по индексу.

// forms

Формы

Автозаполнение индекса и адреса.

// data

Справочники

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

вопросы

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

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

по теме