Частые ошибки Ozon Доставки в WooCommerce и как их исправить

1. Чек-лист готовности — WooCommerce → Ozon Доставка → Подключение. Красные и жёлтые строки с кнопкой «Перейти» ведут прямо к нужной настройке.
2. Журнал плагина — вкладка «Журнал и данные» и WooCommerce → Статус → Журналы, источник ozon-delivery-woo. Ключи и телефоны в журнале скрыты, поэтому скриншот журнала можно отправить разработчику.
3. Блок «Ozon Доставка» в заказе — причина ошибки передачи заказа пишется красным прямо там.
4. Почта для уведомлений — письма о проблемах с заказами, балансом и возвратами.

Это самый частый вопрос. Проверьте по порядку:

• Включён тестовый режим. Пока стоит галочка тестового режима, способ Ozon видят только администраторы и тестовые номера. Покупатели — нет. Снимите галочку после тестового заказа.
• Способ не добавлен в зону доставки или выключен в ней. Нажмите «Добавить в зону доставки» в плагине: способ «Ozon — пункт выдачи» добавится в первую зону, где есть Россия.
• Справочник пунктов ещё не загружен. Пока таблица пуста, способу нечего показывать. Посмотрите вкладку «Пункты выдачи».
• Не указаны ключи или метод доставки — см. строки чек-листа.
• Валюта магазина не рубль. Ozon принимает объявленную стоимость только в рублях, и при другой валюте способ скрыт.
• Страна доставки не Россия. Способ показывается только для российских адресов.
• Корзина дороже 500 000 ₽. Это максимум объявленной стоимости одного отправления.
• Закончился пробный период или лицензия. Способ Ozon скрывается, остальное оформление работает. На вкладке «Лицензия» и в баннере админки видно, что произошло.
• Ozon временно не отвечает. Покупатель видит сообщение «Не удалось связаться с Ozon…» и может повторить попытку или выбрать другой способ. Оформление заказа при этом не ломается.

Это не ошибка, а правило Ozon: расчёт стоимости требует телефон получателя. Пока номера нет, способ Ozon виден, пункт можно выбрать, но под способом — красная просьба «Укажите номер телефона…» с кнопкой «Указать телефон».

Что сделать: сделайте поле «Телефон» на оформлении обязательным — в классическом оформлении через Внешний вид → Настроить → WooCommerce → Оформление заказа, в блочном — в настройках блока «Оформление заказа». Если стоит редактор полей, проверьте, что он не скрыл телефон. Чек-лист покажет ошибку, если поле скрыто, и предупреждение, если оно необязательное.

Доставка Ozon работает только для покупателей с аккаунтом Ozon на номер из заказа. Покупателю нужно зарегистрироваться в приложении Ozon на этот номер или выбрать другой способ доставки. Если заказ уже оплачен и в блоке заказа «Ошибка передачи» с этой причиной — свяжитесь с покупателем; после регистрации нажмите «Передать в Ozon», а если номер был с ошибкой, исправьте его через «Изменить номер или пункт выдачи».

Если при проверке подключения Ozon отвечает HTTP 401 с текстом «API access disabled, please contact support», почти всегда это неверный Client Secret, а не отключённый доступ. Скопируйте Client ID и Client Secret из кабинета Ozon Доставки заново — целиком, без пробелов — и снова нажмите «Сохранить и проверить подключение».

Если ответ HTTP 403, у приложения не хватает прав или запрос пришёл не с адреса из белого списка IP. Проверьте права delivery-api.* и исходящий IP сервера. Подробно — в статье Ключи API.

Почти всегда — недостаточно средств на балансе кабинета Ozon. Плагин присылает письмо «отправление заказа №… не подтверждено». Пополните баланс, дождитесь зачисления и нажмите «Собрано» ещё раз. Подробно — в статье Баланс кабинета.

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

В чек-листе строка «Метод «…» в статусе «…» — заказы через него создать нельзя». Отправления создаются только через активный метод. Если метод заблокирован или отключён, выясните причину в кабинете или поддержке Ozon, при необходимости создайте новый метод и выберите его в плагине кнопкой «Выбрать метод из кабинета Ozon». Если статус «не проверен», нажмите «Проверить подключение».

Пока идёт повторная загрузка, покупатели видят прежний справочник — способ Ozon не пропадает.

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

Редакторы полей оформления заказа умеют скрывать поля и менять их обязательность — в том числе для полей, которые нужны плагинам доставки. Для Ozon обязательными должны остаться «Телефон» и «Страна». Если редактор делает обязательным поле «Адрес», а покупатель с Ozon его не заполняет, включите настройку «Поля адреса» на вкладке «Оформление и заказы»: плагин подставит адрес пункта в пустые поля «Адрес» и «Город». Заполненные покупателем поля он не меняет.

• Не указан ключ Яндекс.Карт и на странице нет карт от другого плагина — выбор работает списком. Это нормально.
• Ключ указан, но ограничен другим адресом — проверьте ограничение HTTP Referer в кабинете разработчика Яндекса.
• У покупателя блокировщик рекламы — карта может не загрузиться, список при этом работает.

Примерно один запрос к Ozon из 10–20 «зависает»: соединение есть, а ответа нет до таймаута. Повтор сразу проходит. Плагин ставит короткие таймауты и быстро повторяет такие запросы, поэтому редкие предупреждения «сетевая ошибка» в журнале нормальны. Если ошибок много подряд, проверьте исходящие запросы с хостинга и отправьте скриншот журнала разработчику — по действующей годовой лицензии ответ по почте в течение 2 рабочих дней.