Настройка плагина Яндекс Доставки для WooCommerce (версия 2)
Если вы обновляетесь с прошлой версии плагина, сначала прочитайте статью о переходе на новую версию Яндекс Доставки. Она рассказывает, что проверить до и после обновления.
Настройка плагина Яндекс Доставки занимает около получаса, если токен из кабинета Яндекса уже у вас. Плагин «Яндекс Доставка для WooCommerce» показывает покупателям два способа доставки: курьером до двери и в пункт выдачи заказов (ПВЗ). Но цену и срок считает сама Яндекс Доставка. Затем заказ уходит ей прямо из админки WordPress.
Плагин работает только с боевым аккаунтом Яндекс Доставки. Кроме того, тестового режима в нём нет. Без действующей лицензии плагин работает с ограниченными возможностями: способ доставки не показывается покупателю, а выгрузка и отмена заявок и получение документов у перевозчика недоступны. Просмотр заказов и обновление их статусов продолжают работать. Ключ лежит в вашем личном кабинете на woodev.ru.
Эта статья ведёт от установки до первого заказа, так что открывать другие инструкции для запуска не нужно. Общие возможности всех плагинов доставки Woodev описаны в отдельной статье, и мы ссылаемся на неё там, где нужны подробности: возможности плагинов доставки Woodev.
Что нужно до начала #
Требования к сайту #
- WordPress — версия 6.4 или новее.
- WooCommerce — версия 8.5.1 или новее. Плагин проверяли с последними версиями WooCommerce.
- PHP — версия 7.4 или новее.
Если версия ниже, WordPress предупредит об этом в админке. Тогда сначала обновите сайт, а потом возвращайтесь к статье.
Плагин заявляет совместимость с новым хранилищем заказов WooCommerce (HPOS). Поэтому включать или отключать его для работы плагина не нужно.
Что нужно в Яндекс Доставке #
Вам понадобится личный кабинет в Яндекс Доставке и токен авторизации из него. Договор и баланс аккаунта плагин не проверяет. Но вопросы по ним лучше решить с менеджером Яндекса до первого заказа.
Если вы будете отправлять заказы со своего склада, спросите у менеджера Яндекса код склада. Мы расскажем, куда его вписать, в разделе про отправителя.
Установка плагина и лицензия #
После покупки архив и лицензионный ключ придут на почту, которую вы указали при заказе. Кроме того, их можно взять в личном кабинете.
- Откройте в админке WordPress «Плагины → Добавить новый» и нажмите «Загрузить плагин».
- Выберите архив с плагином, нажмите «Установить», а затем «Активировать плагин».
- Затем откройте «Woodev → Лицензии», вставьте ключ и сохраните изменения.
Если вы никогда не ставили плагины вручную, пошаговая инструкция с картинками лежит в статье «Как установить плагин на WordPress».
Подключение к Яндекс Доставке #
Настройки плагина лежат на странице «Woodev → Настройки», на вкладке Яндекс Доставки. Подключение занимает там отдельный раздел, «Подключение».
Где взять токен #
- Войдите в личный кабинет Яндекс Доставки.
- Затем откройте вкладку «Интеграция».
- Нажмите «Получить токен» и скопируйте его.
- В настройках плагина вставьте токен в поле «Токен авторизации».
- Нажмите «Сохранить изменения».
Токен нужен именно боевой. Тестовых токенов и тестового режима плагин не поддерживает.
Как проверить подключение #
Чтобы убедиться, что токен рабочий, нажмите «Проверить подключение». Кнопка проверяет токен, который сейчас стоит в поле, даже если вы его ещё не сохранили. Результат появится рядом с кнопкой.
- «Подключение установлено: токен принят.» — всё в порядке, можно идти дальше.
- «Укажите токен авторизации.» — поле пустое. Чтобы исправить это, вставьте токен и повторите проверку.
- «Не удалось проверить токен: Яндекс Доставка не ответила. Попробуйте позже.» — проблема на стороне связи или самой службы. Если связь вернулась, нажмите кнопку ещё раз.
Токен проверяется и при сохранении настроек. Если Яндекс отклонил токен, плагин не сохранит настройки и покажет ошибку у поля. Но если Яндекс просто не ответил, настройки сохранятся с предупреждением: вернитесь и проверьте подключение позже. Пока токена нет, в админке висит уведомление «Укажите токен Яндекс Доставки».
Общие настройки Яндекс Доставки #
Эти настройки лежат в том же разделе «Подключение» и действуют на все способы доставки Яндекса сразу.
Что настроить в разделе «Подключение» #
- «Интервал обновления статусов заказов (минуты)» — как часто плагин спрашивает у Яндекса новые статусы. Если вы ничего не меняли, стоит 180 минут. Значение 0 выключает проверку по расписанию, тогда статусы обновляются только вручную.
- «Допустимый рост цены» — на сколько тариф при выгрузке может вырасти по сравнению с ценой на оформлении. Можно указать рубли или проценты, по умолчанию стоит 10%. Если рост больше, автоматическая выгрузка остановится, а в заказе появится заметка с новой суммой. Тогда вы сами решите, принимать ли её. Только значение 0 запрещает любой рост.
- «Ставка НДС» — ставка, которую плагин передаёт Яндексу для каждого товара. По умолчанию выбрано «Без НДС». Если в настройках остался вариант, которого нет в списке, плагин покажет его как недопустимое и не выгрузит заказ, пока вы его не замените.
- «Типы пунктов» — какие точки видит покупатель: «Пункты выдачи заказов», «Постаматы» или оба типа сразу. Кроме того, настройка общая для всех способов с пунктами. Если список пуст, плагин считает, что нужны оба типа.
Остальное, что есть на вкладке плагина, одинаково для всех плагинов доставки Woodev. Например, это подсказки адресов, вес и габариты по умолчанию, упаковка, форма заказа и карта. Подсказки адресов работают через сервис DaData, о них мы рассказываем в статье об общих настройках доставки.
Способы доставки в зонах #
Как добавить способ в зону #
Яндекс Доставка добавляется стандартными средствами WooCommerce, как и любой другой способ доставки WooCommerce. Подробно зоны описаны в статье «Как настроить зоны доставки WooCommerce». Если коротко, порядок такой.
- Откройте «WooCommerce → Настройки → Доставка».
- Выберите зону, в которой хотите предлагать Яндекс Доставку, или создайте новую.
- Нажмите «Добавить способ доставки».
- Выберите «Яндекс Доставка — курьер» или «Яндекс Доставка — пункт выдачи». Если нужны оба, добавьте их по очереди.
- Нажмите на название добавленного способа, чтобы открыть его настройки.
Способа «Экспресс» в этой версии нет. Если вы использовали его раньше, подробности в статье о переходе на новую версию.
Чем отличаются курьер и пункт выдачи #
- «Яндекс Доставка — курьер» привозит заказ покупателю до двери. Только Яндекс назначает стоимость. Оплату при получении этот способ не поддерживает, поэтому с такой оплатой он пропадает из списка.
- «Яндекс Доставка — пункт выдачи» доставляет заказ в пункт выдачи или постамат Яндекса либо партнёра, службы 5Post. Оплата при получении возможна, если выбранный пункт её принимает.
Поскольку многие настройки у способов общие, мы разбираем их по очереди. Отдельно отмечаем то, что есть только у пунктов выдачи.
Как вы отправляете заказы #
Поле «Как вы отправляете заказы» отвечает, откуда заказ попадёт к Яндексу. От него зависит, какие поля показаны ниже.
- «Привезу сам в пункт» — вариант по умолчанию. Вы сами отвозите посылки в пункт приёма Яндекса. Тогда выберите «Город пункта приёма», а затем «Пункт приёма» из списка.
- «С моего склада» — курьер Яндекса забирает посылки у вас. Тогда впишите «Код склада», который вам дал менеджер Яндекса, и нажмите «Проверить».
Проверка склада только читает данные у Яндекса и ничего не создаёт. Если всё хорошо, плагин ответит «Склад найден.». Если Яндекс не принял токен, вы увидите «Яндекс не принял токен. Проверьте его в настройках плагина.».
Дата доставки #
Поле «Дата доставки» решает, показывать ли покупателю срок. Если вы ничего не меняли, выбрано «Не показывать». Если выбрать «Показывать», появится поле «Как показывать».
- «Списком» — покупатель сам выбирает интервал из списка. Выбор сохранится в заказе и уйдёт Яндексу.
- «От – до» — покупатель видит, за сколько примерно придёт заказ.
- «Крайнюю дату» — покупатель видит последнюю дату доставки, и именно она уходит в выгрузку.
Сети пунктов (только пункт выдачи) #
В способе с пунктами выдачи есть поле «Сети пунктов». В нём вы выбираете, пункты каких сетей увидит покупатель: «Яндекс», 5Post или обе. Если вы ничего не меняли, включены обе. Пока покупатель не выбрал пункт, он видит самую низкую цену среди включённых сетей.
Страховка и услуги #
Яндекс страхует посылку и берёт за это примерно 0,6 % от объявленной стоимости. Поле страховки управляет только тем, показывать ли эту сумму покупателю. Если выбрать «Нет», покупатель увидит цену без страховки. Однако Яндекс всё равно застрахует отправление при выгрузке, и эту сумму заплатит магазин.
У способа с пунктами выдачи есть и бесплатные услуги: примерка, частичный выкуп и доставка без вскрытия. Однако они не меняют цену доставки. Плагин передаст выбранные услуги Яндексу при выгрузке. Но примерку и частичный выкуп поддерживают не все пункты, поэтому плагин откажет в выборе пункта, где выбранной услуги нет.
Цена: наценка, бесплатная доставка, округление #
Цену доставки считает Яндекс. Однако вы можете её поправить.
- «Наценка» — сумма в рублях или процент, который плагин добавит к цене доставки. Например, «100» или «10%».
- «База процента наценки» — от чего считать процент: от «Стоимость заказа» (по умолчанию) или от стоимости доставки. Поле важно, только если наценка задана в процентах.
- «Бесплатная доставка от» — если сумма заказа больше этого значения, способ становится бесплатным. Если поле пустое, порога нет.
- «Разрешить использование купонов на бесплатную доставку» — флажок. Он есть, только если в WooCommerce включены купоны. Если купон применили, способ становится бесплатным.
- «Округление цены» — по умолчанию «Не округлять». Например, можно округлять вверх, вниз или к ближайшему значению.
- «Шаг округления цены» — до чего округлять: по умолчанию «До десятков». Есть также сотни и целые рубли.
Ограничения по сумме заказа #
Два поля прячут способ, когда заказ слишком дешёвый или слишком дорогой. Например, это удобно, если мелкие заказы вам невыгодно отправлять Яндексом.
- «Минимальная сумма заказа» — если сумма меньше, способ не появится.
- «Максимальная сумма заказа» — если сумма больше, способ тоже не появится.
Остальные поля способа, например «Заголовок» и «Описание», знакомы вам по другим способам доставки WooCommerce. Их описывает статья об общих настройках доставки.
Что увидит покупатель #
Код плагина поддерживает классическую форму оформления заказа, блочные корзина и оформление заказа — частично (экспериментально). Поэтому после настройки обязательно сделайте пробный заказ именно на вашей форме.
Как выглядит выбор доставки #
Покупатель вводит адрес, а плагин ищет населённый пункт в Яндексе и считает цену. Если выбрать «пункт выдачи», появится кнопка выбора точки на карте. Как работает карта, мы рассказываем в статье «Как покупатель оформляет заказ». Без выбранного пункта оформить такой заказ нельзя.
Если вы включили показ даты доставки, покупатель увидит срок или список интервалов. Плагин сохранит выбранный интервал вместе с заказом.
Почему способ не показался #
Если способ не появился, это не поломка. Чаще всего у Яндекса есть причина, и плагин её знает. Чтобы увидеть причину, включите «Логирование» на вкладке плагина и откройте оформление заказа под своей учётной записью. Подсказку «Скрыт: …» увидит только менеджер магазина. Подробнее об этом в статье о возможностях плагинов доставки.
Заказы Яндекс Доставки #
Заказы с доставкой Яндекса лежат на странице «WooCommerce → Заказы доставки», вместе с заказами других плагинов Woodev. Список, фильтры и массовые действия описаны в статье «Заказы доставки: список, выгрузка, документы и статусы». Здесь мы рассказываем только то, что относится к Яндексу.
Выгрузка, отмена, статусы и документы описаны по коду плагина. Вживую со всеми этими действиями мы их пока не проверяли. Поэтому первые заказы лучше проверить вручную.
Выгрузка заказа #
Чтобы передать заказ Яндексу, нажмите «Экспорт» в строке заказа. Можно включить и автоматическую выгрузку по статусам в разделе «Выгрузка заказов» на вкладке плагина. Если Яндекс при выгрузке запросит больше, чем «Допустимый рост цены», заказ не уйдёт сам. Тогда в нём появится заметка с новой суммой, а вы сможете выгрузить заказ вручную.
Выгрузка с интервалом #
Для заказа, который ещё не выгрузили, есть отдельное действие «Выгрузить с интервалом». В окне поле «Интервал доставки» покажет список от Яндекса. Список берётся в часовом поясе магазина. Но запрос только читает данные: пока вы не подтвердите выгрузку, заказ у Яндекса не создаётся.
Если Яндекс не предлагает интервалов, плагин напишет «Сейчас Яндекс Доставка не предлагает интервалов для этого заказа. Попробуйте позже.». Если запрос не прошёл совсем, вы увидите «Не удалось получить интервалы у Яндекс Доставки. Попробуйте ещё раз.».
Документы, отмена и статусы #
Этикетки и другие документы плагин запрашивает у Яндекса после выгрузки. Отмена заказа в магазине отменяет и заявку у Яндекса, как это описано в общей статье.
Статусы Яндекса плагин приводит к общему списку статусов доставки Woodev. Например, «В пути», «К выдаче» или «Доставлено». Обновляются они по расписанию, которое вы задали в «Интервале обновления статусов». Ссылка для отслеживания приходит покупателю в письме. Какие письма уходят и как их менять, написано в статье «Письма покупателю о статусе доставки».
Частые вопросы #
Плагин Яндекс Доставка #
Где взять токен и можно ли сначала проверить плагин в тестовом режиме?
Токен выдаёт личный кабинет Яндекс Доставки. Откройте вкладку «Интеграция», нажмите «Получить токен» и вставьте его в настройках WooDev, в разделе «Подключение», в поле «Токен авторизации». Тестового режима в плагине нет, он работает только с рабочим токеном. Если у вас остались тестовые настройки от версии 1, при переносе они переводятся на рабочий режим, а общедоступный тестовый токен плагин не принимает.
Плагин пишет, что токен не принят. Что делать?
Нажмите «Проверить подключение» рядом с полем токена и прочитайте ответ. Сообщение «Подключение установлено: токен принят» означает, что с токеном всё в порядке. Если Яндекс отклонил токен, плагин не даст сохранить настройки, и тогда нужно взять токен в личном кабинете заново. Если Яндекс просто не ответил, плагин сохранит настройки и предупредит об этом, поэтому повторите проверку чуть позже.
Чем отличается «Привезу сам в пункт» от «С моего склада» и что такое код склада?
В первом случае вы сами привозите заказы в выбранный пункт приёма Яндекса, поэтому вам нужно указать город и сам пункт. Во втором случае курьер Яндекса забирает заказы с вашего склада, и тогда нужен код склада. Этот код выдаёт ваш менеджер в Яндекс Доставке, а в плагине рядом с полем есть кнопка «Проверить». Она отвечает «Склад найден», если Яндекс знает такой код.
Способ «пункт выдачи» не появился у покупателя. Почему?
Покупатель причину не видит, её показывают вам. Откройте журнал WooCommerce и найдите записи с источником yandex-delivery. Кроме того, при расчёте доставки администратору WooCommerce показывается подсказка. Причиной могут быть недоступные пункты в городе покупателя или сети, которые вы отключили в настройке «Сети пунктов». Ещё у подходящих точек может не быть оплаты при получении. Способ также скрывают ограничения посылки по размеру и весу, например для постамата. Проверьте размеры и вес товаров и список включённых типов пунктов в общих настройках плагина.
В городе нет пунктов выдачи
Причин три, и плагин называет нужную.
- В городе нет пунктов выдачи Яндекс Доставки.
- Пункты есть, но ни один не входит в сети, которые вы включили в способе.
- Пункты есть, но ни один не принимает оплату при получении.
Тогда проверьте поле «Сети пунктов» и способ оплаты заказа.
Постамат не показывается
Посылка может не подходить по размеру или весу. Так бывает, потому что плагин не покажет пункты, в которые упакованные посылки не поместятся. Проверьте вес и габариты в карточках товаров.
Яндекс не находит населённый пункт или адрес покупателя. Это ошибка плагина?
Нет, расчёт строится на данных Яндекса. Если Яндекс не смог сопоставить населённый пункт, в журнале или в подсказке администратора появится сообщение «Яндекс Доставка не нашла населённый пункт покупателя». Для курьера оно звучит так, «Яндекс не смог найти адрес покупателя на карте». Попросите покупателя проверить, как он написал адрес. Если ошибка повторяется для одного и того же города, пришлите нам город и пример адреса. Записи ищите в журнале WooCommerce с источником yandex-delivery.
Можно ли принимать оплату при получении при доставке курьером?
Нет, курьерская доставка Яндекса не работает с оплатой при получении, поэтому способ скрывается, когда покупатель выбирает такую оплату. Пункт выдачи оплату при получении поддерживает, если выбранная точка её принимает.
Как убрать 5Post и оставить только пункты Яндекса?
Откройте настройки способа «Яндекс Доставка — пункт выдачи» в нужной зоне доставки и снимите отметку 5Post в поле «Сети пунктов». Тогда покупатель увидит только точки сети Яндекса. Пока он не выбрал точку, цена в корзине равна самой низкой среди включённых сетей, поэтому после выбора пункта она может отличаться.
Я выбрал страховку «Нет», но Яндекс всё равно её списывает. Почему?
«Нет» убирает страховку только из цены, которую видит покупатель. Яндекс всё равно страхует отправление при выгрузке заказа, примерно на 0,6% от объявленной стоимости, и эту сумму платит магазин. Если вы не хотите платить за страховку сами, оставьте её включённой в цене.
Заказ не выгрузился автоматически и в нём есть заметка о новой цене. Что это значит?
Стоимость в Яндексе выросла больше, чем разрешает настройка «Допустимый рост цены». По умолчанию она равна 10%, а значение 0 запрещает любой рост. Плагин ничего не отправил и записал в заметке новую сумму. Если она вас устраивает, выгрузите заказ вручную из карточки заказа.
Если что-то пошло не так #
Если вы не нашли ответ в статье, напишите нам из личного кабинета. Приложите версию плагина, текст ошибки и скриншот. Если проблема с заказом, включите логирование на вкладке плагина, и мы посмотрим журнал WooCommerce, источник yandex-delivery.