Отслеживание доставки

Инструкция к модулю Отслеживание доставки

Модуль получает сведения о посылках через API сервиса gdeposylka.ru. По трек-номеру и выбранной службе доставки он показывает последние этапы пути, а для завершённых или неактивных отправлений может автоматически менять статусы отгрузки и заказа.

Что делает модуль

• добавляет проверку отправления в карточку отгрузки и в карточку заказа;
• показывает до трёх последних статусов отслеживания с датой и временем;
• сохраняет введённый трек-номер в отгрузке после успешного запроса;
• переводит доставленную либо больше не активную отгрузку в выбранный итоговый статус;
• при необходимости меняет статус заказа, но только когда все его отгрузки достигли итогового статуса;
• обновляет статусы вручную для всех подходящих отгрузок или по расписанию cron.

Где находится модуль

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

Настройка

1. API ключ от сервиса gdeposylka.ru. Получите ключ в сервисе gdeposylka.ru и укажите его в этом поле. Без действующего ключа модуль не отправляет запросы на отслеживание.
2. Заблокировать поле с номером отслеживания. Включите параметр, если сотрудники не должны изменять трек-номер из блока модуля в карточке заказа или отгрузки. Проверка уже сохранённого номера при этом остаётся доступной.
3. Конечный статус отгрузки. Выберите статус, который модуль присвоит отгрузке, когда сервис сообщит о доставке или о прекращении активности отслеживания. Если оставить значение по умолчанию, используется стандартный статус отгрузки Отправлено.
4. Статус заказа, при конечном статусе всех отгрузок. Выберите итоговый статус заказа либо оставьте Не менять. Выбранный статус применяется только после того, как каждая отгрузка этого заказа получит конечный статус.
5. Пароль для Cron. Задайте непредсказуемое значение: оно используется для защиты запуска по расписанию и должно совпадать с параметром в команде cron.
6. Изменения за последние n дней. Укажите период в днях, чтобы cron и массовое обновление проверяли только отгрузки, созданные за этот период. Пустое значение означает проверку всех отгрузок, чей статус ещё не равен конечному.

Проверка одной отправки

1. Убедитесь, что у отгрузки выбрана служба доставки и есть корректный трек-номер.
2. Откройте карточку заказа или карточку отгрузки. В блоке модуля укажите номер отслеживания, если поле не заблокировано, и нажмите Найти.
3. Проверьте результат: модуль выводит до трёх последних контрольных точек со статусом, датой и временем. При успешной проверке введённый номер сохраняется в отгрузке.
4. Если сервис вернул состояние «ожидание», повторите проверку через 3–5 минут. При неверном номере выводится соответствующее сообщение.

Для проверки поддерживаются службы, для которых модуль передаёт идентификатор в API: Почта России, СДЭК и Boxberry. Для другой или невыбранной службы модуль покажет сообщение, что служба доставки не поддерживается.

Массовое обновление и cron

Чтобы выполнить обновление вручную, откройте список Отгрузки, выберите Обновить все статусы отгрузок и подтвердите действие. Модуль обрабатывает только отгрузки с трек-номером и поддерживаемой службой доставки, которые ещё не имеют конечного статуса.

Для автоматического запуска используйте готовую команду из блока Cron на странице настроек. Скопируйте её в планировщик сервера без изменения параметров --dispatch и --pass. Если задан период в днях, команда автоматически включает параметр --days. По умолчанию шаблон команды рассчитан на запуск каждый день в 09:55; при необходимости скорректируйте расписание в crontab, не меняя саму команду.

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

Как проверить работу

1. Настройте API-ключ и выберите конечный статус отгрузки.
2. Создайте или используйте отгрузку с поддерживаемой службой доставки и действующим трек-номером.
3. Выполните поиск в карточке заказа или отгрузки и убедитесь, что отображаются контрольные точки.
4. Для отправления, которое сервис считает доставленным или неактивным, запустите массовое обновление либо дождитесь cron.
5. Проверьте новый статус отгрузки. Если задан статус заказа, убедитесь, что он меняется только после завершения всех отгрузок заказа.

Если результат не получен

• Проверьте API-ключ и доступность API gdeposylka.ru.
• Сверьте трек-номер и выбранную службу доставки в отгрузке.
• Если сервис ещё не подготовил данные по новой посылке, повторите запрос через 3–5 минут.
• Для cron проверьте пароль в настройках и в команде, а также журнал выполнения планировщика.