# Почта России

Почтовые отправления — заказы, тарифы, трекинг, нормализация адресов, поиск ОПС

## Сценарии

### Тариф до оформления
Агент посчитает стоимость и срок доставки по индексу, весу и габаритам ещё до того, как отправление будет оформлено.

### Нормализация адресов
Агент приведёт адреса из заказов к почтовому формату, разложит их на индекс и элементы и покажет строки, которые Почта не распознала.

### Отправления в пути
Агент соберёт трекинг по отправлениям и пришлёт сводку: что в пути, что вручено и что застряло на сортировке.

### Куда сдавать партию
Агент найдёт отделения по индексу или адресу и подскажет ОПС, куда удобнее сдавать очередную партию отправлений.

## Как подключить

### Заведите кабинет отправителя на otpravka.pochta.ru
Регистрация на otpravka.pochta.ru отправляет заявку на доступ и подписание договора — она обрабатывается до 3 рабочих дней. Пока заявка не подтверждена, ключей в кабинете не будет.

### Скопируйте токен приложения в «Настройки» → «API»
Откройте otpravka.pochta.ru/settings#/api-settings — «Настройки» → «API». Поле «API токен» и есть токен приложения; тот же токен приходит письмом при регистрации. Рядом кнопка сформировать новый — старый после этого использовать нельзя.

### Запишите логин и пароль от самого кабинета
Помимо токена нужен логин и пароль учётной записи otpravka.pochta.ru. Логин — телефон в формате +7XXXXXXXXXX или e-mail, но с e-mail авторизация проходит не всегда: надёжнее телефон. Пароль — тот, которым вы входите в кабинет.

## Частые вопросы

### Как подключить Почта России?
Тремя значениями из кабинета otpravka.pochta.ru: токен приложения из «Настройки» → «API», а также логин и пароль самой учётной записи. Логин надёжнее указывать телефоном в формате +7XXXXXXXXXX. Ключи появляются после подтверждения заявки и договора.

### Что агент видит в кабинете?
Заказы и отправления кабинета otpravka.pochta.ru, расчёт тарифов, статусы трекинга, результаты нормализации адресов и справочник отделений связи.

### Пишет ли агент в Почту России?
По умолчанию агент считает, ищет и отчитывается в чате. Действия, меняющие данные кабинета, он согласует с вами и делает только в пределах прав вашей учётной записи.

### Что с правами и лимитами?
Токен и логин дают ровно те права, что есть у учётной записи otpravka.pochta.ru. Запросы идут не чаще 5 в секунду, поэтому крупные выгрузки агент собирает частями.

[Открыть Почта России](https://otpravka.pochta.ru)