Считайте тарифы и сроки Почты России до оформления отправки

Агент работает с кабинетом otpravka.pochta.ru через его API: считает стоимость и срок по индексу, весу и габаритам, читает заказы и отправления, поднимает статусы трекинга, прогоняет адреса через нормализацию и ищет отделения связи по индексу или адресу. Начинает он с настроек кабинета — так проверяется само подключение и становится видно, с какими параметрами отправителя предстоит считать.

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

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

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