Пункты выдачи и постаматы Ozon в оформлении заказа WooCommerce: справочник, карта и список

В Ozon Delivery API нет метода «пункты рядом с адресом» и нет виджета карты. Метод списка пунктов отдаёт только номера — без адресов и координат — и не фильтрует их по городу. Подробности по каждому пункту приходится запрашивать отдельно, пачками до 100 штук. В документации Ozon прямо сказано: отфильтровать пункты по местоположению и показать их списком или на карте магазин должен сам. Как сделать такой выбор пункта на любом сайте, не только на WooCommerce, — в статье Виджет пунктов выдачи Ozon: есть ли готовый.

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

Первая загрузка начинается сразу после выбора метода доставки в настройках и занимает 5–15 минут. Пока открыта вкладка «Пункты выдачи», загрузка идёт быстрее; если закрыть страницу, она продолжится в фоне, но медленнее. Прогресс виден на вкладке и в чек-листе готовности.

Дальше справочник обновляется сам, раз в сутки ночью, между 00:20 и 02:20 по UTC (03:20–05:20 по Москве). Минута запуска зависит от адреса сайта, чтобы разные магазины не обращались к Ozon одновременно. Обновление идёт небольшими шагами через планировщик задач WooCommerce (Action Scheduler), состояние сохраняется после каждого шага.

Обновление инкрементальное:

• плагин проходит весь список пунктов, но подробности запрашивает только для новых пунктов и для тех, которые не проверялись больше 7 дней;
• пункты, которых больше нет в списке Ozon, удаляются только после того, как проход завершился полностью: сбой посередине не «обнулит» справочник;
• пока идёт обновление, покупатели видят прежний справочник.

В справочник попадают только работающие пункты, в которые доставляет ваш метод доставки.

Адреса Ozon приходят в разных форматах: с индексом и без, «обл. Томская», «Вологодская» без слова «область», «дер.», «городской посёлок». Город плагин выделяет из адреса по правилам, которые проверены на 600 реальных адресах пунктов. График Ozon отдаёт как список дат примерно на три недели вперёд, причём отсутствующая дата означает выходной; плагин сжимает его в понятную недельную строку.

Способ доставки на оформлении заказа называется «Ozon — пункт выдачи» (название можно поменять в настройках зоны доставки WooCommerce). Пока пункт не выбран, под ним видна подсказка для города покупателя: сколько там пунктов Ozon, примерный срок и примерная цена с пометкой, что точная цена появится после выбора пункта.

По кнопке «Выбрать пункт выдачи» открывается окно:

• Поиск адреса. Покупатель вводит улицу или адрес; с ключом DaData появляются подсказки.
• «Рядом со мной». Браузер спрашивает разрешение на геолокацию, и список строится от текущего местоположения.
• Список ближайших пунктов — тип пункта, адрес, расстояние, график работы и кнопка «Выбрать».
• Карточка пункта — номер пункта, режим работы, срок хранения заказа, примерочные, расстояние и кнопка «Заберу отсюда».
• Карта с пинами цвета Ozon; когда пунктов в области слишком много, они собираются в кластеры.
• На телефоне окно разделено на вкладки «Список» и «Карта», чтобы не листать одно поверх другого.

Ближайшие пункты из таблицы находятся за 3–4 миллисекунды — это замер на справочнике из 88 тысяч пунктов, поэтому окно открывается без задержек. После выбора под способом доставки появляется адрес пункта и кнопка «Изменить пункт».

Карта строится на Яндекс.Картах из того же справочника. Ключ Яндекс.Карт необязателен:

• Без карты выбор работает списком. Так же будет, если карта не загрузилась — например, из-за блокировщика рекламы. Покупатель всё равно может найти и выбрать пункт.
• Ключ берётся в кабинете разработчика Яндекса (сервис «JavaScript API и HTTP Геокодер») и вводится на вкладке «Оформление и заказы». Ключ виден в коде страницы, поэтому ограничьте его адресом своего сайта (HTTP Referer) в кабинете Яндекса.
• Карта грузится лениво — только на странице оформления заказа и только когда покупатель открыл выбор пункта. На остальные страницы сайта она не влияет.
• Если Яндекс.Карты уже загружает другой плагин доставки или тема, плагин Ozon использует их и вторую копию не грузит. Свою копию он загружает в отдельное пространство имён, чтобы не мешать чужим картам.
• Геокодер и подсказки Яндекса плагин не вызывает: пункты берутся из своей таблицы, а адрес покупателя ищется через DaData. Условия бесплатного тарифа смотрите на странице тарифов Яндекса; логотип и копирайт Яндекса на карте закрывать нельзя.

Для подсказок адреса нужен публичный API-ключ DaData — 40 символов. Бесплатно DaData даёт до 10 000 подсказок в сутки; секретный ключ не нужен и не вводится. Важно понимать разделение ролей: DaData не знает пунктов Ozon. Она находит только адрес покупателя и его координаты, а ближайшие пункты плагин считает сам по своему справочнику.

Без ключа DaData поиск тоже работает — по городу и улице в справочнике пунктов. Этого достаточно, если покупатели обычно ищут пункт по названию улицы.

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

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

• «Посылка не подходит для этого пункта выдачи по весу, размеру или стоимости. Выберите другой пункт.»
• «Этот пункт выдачи сейчас не работает. Выберите другой пункт.»
• «В этот пункт выдачи доставка недоступна. Выберите другой пункт.»

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

• Вкладка «Пункты выдачи»: сколько пунктов в справочнике, когда он обновлялся, идёт ли загрузка и чем закончилась последняя.
• Чек-лист готовности: строка «Справочник пунктов выдачи» с числом пунктов и датой обновления; если последнее обновление не удалось, там будет причина.
• Если справочник не загрузился, проверьте исходящие запросы и работу cron — см. Требования к сайту и Частые ошибки.

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