Перейти к содержанию

Обновление статусов ЭН Новой Почты

Когда экспресс-накладная создана, она начинает жить своей жизнью: приехала в отделение, ждёт получателя, получена, вернулась. Эта служба обходит ваши накладные, спрашивает у Новой Почты, что с ними произошло, и записывает свежий статус в документ.

Где искать: Модули → Новая Почта → Обслуживание → Обновление статусов ЭН Новой Почты

Меню: Модули → Новая Почта → Обслуживание → Обновление статусов ЭН Новой Почты.

Разбор на примере

Окно службы обновления статусов

Настраивать нечего: в окне только две кнопки — Выполнить и По расписанию. Служба сама знает, какие накладные проверять.

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

Дальше номера идут пачками по сотне. Для каждого ответа служба сравнивает новый код статуса с сохранённым, и если он изменился — обновляет строку статуса в документе и статус в шапке: в ТТН — поле «Статус экспресс накладной», в отгрузке — статус её самой новой накладной (именно его показывает список отгрузок).

Удобнее всего поставить службу на расписание — например, каждые несколько часов. Тогда менеджер видит актуальное состояние прямо в списке отгрузок, не заходя на сайт Новой Почты.

Откуда берутся данные

  • Служба проверяет только те накладные, номера которых есть в документах. Накладная, созданная вручную на сайте Новой Почты и не записанная в документ, для неё не существует.
  • Ключ кабинета здесь не нужен: статус запрашивается у публичного сервиса отслеживания по номеру накладной. Поэтому статусы обновляются даже тогда, когда ключ просрочен, — а вот создать новую накладную без действующего ключа не выйдет.
  • Список «конечных» состояний зашит в системе: в него входят получение (наличными и безналично), удаление накладной, ненайденный номер, отказ получателя и прекращение хранения.

Типичные ситуации

  • Статус не обновляется. Чаще всего накладная уже в конечном состоянии — служба её намеренно пропускает. Второй вариант: в документе нет строки с номером накладной, потому что ЭН создавали не из системы.
  • Статус в списке отгрузок пуст. Колонки «Новая Почта» и «Статус по НП» появляются, только когда в НП Настройке стоит флажок «Доступна Новая Почта».
  • Накладных очень много. Служба спрашивает сервис пачками по сто номеров, так что большой объём — это просто более долгий прогон, а не ошибка.
  • Прогон завершился ошибкой. Если сервис Новой Почты не отвечает минуту (или запрос одной пачки длится дольше 5 минут), служба останавливается с ошибкой — и ни один статус этого прогона не записывается, даже из пачек, успевших ответить: всё откатывается вместе. Следующий прогон проверит те же накладные заново.
  • Предупреждение «Новая Почта не вернула статусы накладных: …». Сервис ответил отказом (ключ, лимит): после двоеточия — его текст. Статусы пачек, на которые он ответил, записаны; остальные проверит следующий прогон.

Рядом