/

Диагностика доставки

СТАТЬЯ 21

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

Откройте Top Man Digital → Ozon Доставка для общего состояния и Журнал обмена для запросов к Ozon. Сверяйте время записи с попыткой расчёта: старый отказ не объясняет новую попытку автоматически.

Проверка состояния модуля Ozon Доставки
Общее состояние помогает выбрать направление проверки. Конкретный ответ API ищите в журнале.

Стоимость не рассчитывается

Проверьте по порядку:

  1. Активны ли служба и выбранный профиль, сохранены ли ключи и метод.
  2. Подтверждён ли конкретный ПВЗ или полный адрес курьера. Набранного текста недостаточно.
  3. Есть ли корректный телефон покупателя или резервный телефон магазина.
  4. Заполнены ли вес, размеры и стоимость товаров; подходит ли выбранный пункт этой посылке.
  5. Был ли пересчёт формы после подтверждения назначения.
  6. Что вернул order/checkout и нет ли рядом записи delivery/calculate с причиной отказа.

Если контрольный тариф в мастере проходит, а на сайте цены нет, это ещё не доказывает ошибку шаблона. Сравните телефон, посылку и назначение в обоих сценариях. Для самописной формы дополнительно проверьте передачу служебных свойств и запуск её AJAX-пересчёта.

Ноль или слово «бесплатно» при сообщении об ошибке не следует считать реальным бесплатным тарифом. Отдельно проверьте порог бесплатной доставки и результат расчёта.

ПВЗ не найден или список пуст

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

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

Карта не загрузилась

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

Курьер не принимает адрес

Выберите вариант с домом из подсказок, проверьте геокодер и точный отказ Ozon. Для отказа курьера не требуется заново загружать все ПВЗ. Проверьте другой полный адрес отдельно, но не делайте вывод о всём городе по одной попытке.

Статусы не меняются

Проверьте трек-номер, автоматическое обновление трекинга, последнее выполнение агента и правила на вкладке «Статусы». Затем выполните разовое обновление в заказе. Состояние Ozon «доставлено» не обязано менять статус заказа, если соответствие не задано.

Заказ помечен проблемным

Прочитайте конкретный текст проблемы в заказе. Разные метки требуют разных действий. Модуль снимает служебную метку «транспортная заявка не обновлена», которую могло вызвать его собственное обновление трекинга. Другие проблемы заказа не удаляются автоматически.

Что передать поддержке

Подготовьте домен, версии модуля и PHP, время попытки, город и адрес ПВЗ, номер заказа при его наличии, ожидаемый и фактический результат. Из журнала приложите метод, HTTP-код, код ошибки, ответ и trace ID относящегося к попытке запроса.

Client Secret, токены, пароли, телефоны и адреса реальных покупателей не публикуйте в открытом сообщении. При необходимости передайте доступ отдельным согласованным защищённым способом. Для начала разбора часто достаточно обезличенного журнала и воспроизводимых шагов.

Ошибка API и её trace ID в журнале обмена
Для разбора нужен ответ конкретного запроса, а не только сообщение «цена не рассчитана».