Настройка плагина интеграции Яндекс.Доставки с Woocommerce

Верифицирован командой Яндекса

Введение #

Плагин Яндекс доставка для Woocommerce создан для автоматизации доставки заказов интернет-магазинов, работающих на базе WooCommerce. Он интегрирует ваш магазин с сервисом Яндекс.Доставка, предоставляя клиентам удобный выбор способов доставки, автоматическое создание заказов в Яндекс.Доставке и возможность отслеживания статусов прямо из административной панели.

Перейти на страницу плагина

Основные возможности плагина:

• Интеграция с API Яндекс.Доставки.
• Настройка различных методов доставки: до двери, до пункта выдачи заказов (ПВЗ).
• Поддержка виджета выбора ПВЗ на карте.
• Автоматическое создание заказов в системе Яндекс.Доставки.
• Гибкие параметры настроек для управления стоимостью доставки, включением бесплатной доставки и настройкой классов доставки.
• Печать этикеток штрих-кодов для отправки заказов.
• Управление заказами, включая отслеживание и отмену.

Требования для установки:

• WordPress: версия 5.9 и выше. (рекомендовано 6.7)
• WooCommerce: версия 5.6 и выше. (рекомендовано 9.4)
• PHP: версия 7.4 и выше.
• Активированный аккаунт Яндекс.Доставки:
  Для использования плагина ваш аккаунт в Яндекс.Доставке должен быть активирован, договор подписан, а баланс должен быть положительным.
  Если у вас ещё нет подключённого кабинета, то заполните анкету для подключения кабинета. После заполнения, с вами свяжется менеджер Яндекс доставки.

Кому подходит этот плагин:

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

Установка плагина #

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

Установка через админ-панель WordPress:

1. Зайдите в административную панель WordPress под учетной записью администратора.
2. Перейдите в раздел Плагины → Добавить новый.
3. Нажмите на кнопку Загрузить плагин.
4. Выберите загруженный архив с плагином (полученный по ссылке из личного кабинета или письма) и нажмите Установить.
5. После завершения установки нажмите Активировать плагин

Установка через FTP

1. Распакуйте архив с плагином на своём компьютере.
2. Подключитесь к серверу вашего сайта через FTP-клиент (например, FileZilla).
3. Загрузите распакованную папку с плагином в директорию /wp-content/plugins/ вашего сайта.
4. Перейдите в административную панель WordPress, откройте раздел Плагины и найдите плагин Яндекс.Доставка для Woocommerce.
5. Нажмите Активировать для включения плагина.

Активация лицензии

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

1. Перейдите в раздел Woodev → Лицензии в административной панели WordPress.
2. Введите лицензионный ключ, полученный по электронной почте или доступный в личном кабинете.
3. Укажите ваш лицензионный ключ и нажмите Сохранить изменения.
4. После успешной активации лицензии плагин будет готов к использованию.

Важно: Плагин не будет работать без активации лицензии. Убедитесь, что вы правильно ввели ключ и лицензия активирована.

Получение токена авторизации

Токен API используется для связи вашего интернет-магазина с системой Яндекс.Доставки.

1. Авторизуйтесь в личном кабинете Яндекс.Доставки
2. Перейдите в раздел Интеграция или Профиль.
3. Нажмите кнопку Получить токен.
4. Скопируйте токен для последующего ввода в настройки плагина.

Важные примечания

• Если у вас ещё нет подключённого кабинета, то заполните анкету для подключения.
• Если ваш аккаунт в Яндекс.Доставке ещё не активирован, подпишите договор в личном кабинете.
• Баланс аккаунта должен быть положительным, иначе создание заказов в Яндекс.Доставке будет невозможно.

Теперь вы можете приступить к настройке плагина и интеграции вашего интернет-магазина с Яндекс доставкой. В следующем разделе мы рассмотрим процесс конфигурации.

Основные настройки плагина #

После установки и активации плагина перейдите в раздел WooCommerce → Настройки → Интеграции → Яндекс.Доставка. На этой странице доступны следующие настройки:

Указание токена

В поле API-токен вставьте токен, полученный в личном кабинете Яндекс.Доставки.

Выбор режима работы

• Боевой контур: создаёт реальные заказы в системе Яндекс.Доставки. Выберите необходимый режим в настройках плагина.
• Тестовый контур: используется для проверки работы интеграции без создания реальных заказов. Не используйте тестовый контур без необходимости.

Добавление складов для отгрузки

Склад — это точка отгрузки куда приедет курьер для забора отправления в случае типа отправки «От двери».
Для добавления склада требуется его уникальный ID (ID станции), который можно запросить у вашего менеджера или в поддержке Яндекса. Добавляемый склад должен быть заранее создан в системе Яндекса на странице «Адреса». Если вы не планируете отправлять заказы «от двери», то добавлять склады не нужно.
При создании или редактировании склада откроется модальное окно в котором нужно заполнить следующие поля:

1. Название склада: обязательное поле. Укажите любое название которое будет понятно вам. Будет отображаться в писке складов в настройках метода доставки.
2. Адрес склада: обязательное поле. Укажите адрес вашего склада до номера дома. Т.е номер офиса/квартиры/помещения и т.д указывать здесь не нужно.
3. ID станции: обязательное поле. Это уникальный идентификатор вашего собственного склада. Его можно получить у вашего менеджера или в поддержке Яндекса.
4. Детали адреса: Тут можно указать дополнительную информацию адреса, такую как «Номер подъезда», «Номер квартиры или офиса», «Этаж» и «Домофон».
5. Контактные данные: Укажите такие контактные данные как «емайл», «Имя» и «номер телефона» контактного лица с котором может связаться курьер.
6. Время работы склада: Укажите диапазон времени работы склада.
7. Комментарий (как добраться): Дополнительная информация для курьера как добраться до вашего склада.

Указание параметров ГВХ товара

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

Параметры виджета карты ПВЗ

• Настройте отображения пунктов выдачи заказов. Вы можете выбрать значение «Карта с пунктами выдачи» (рекомендуется) или выпадающий список.
• Выберите какие типы пунктов выдачи вы хотите отображать на карте. Это могут быть «Пункты выдачи заказов» и/или «Постаматы». Данная опция не доступна для типа отображения выпадающим списком.
• Вы можете выбрать место(блок) где будет отображаться кнопка или выпадающий список. Доступны варианты отображения либо непосредственно под названием выбранного метода доставки или внизу всего списка методов доставки.
• Если вы хотите чтобы при выборе ПВЗ поля «Адрес» и «Почтовый индекс» автоматически заполнялись значениями выбранного ПВЗ/Постамата, то включите опцию «Заменять значения адреса и индекса»

Управление полями формы оформления заказа

В плагине есть возможность управлением поведением полей на странице оформления заказа.
Например, вы можете отключить такие поля как «Страна», «Регион» и «Почтовый индекс», так как в большинстве случаев они могут быть избыточными, а лишнее заполнение полей может раздражать покупателей.
Так же, вы можете настроить скрытие таких полей как «Адрес» и «Почтовый индекс» в случае если покупатель выбрал метод доставки «До ПВЗ», так как в этом случае данные поля не нужны и могут только сбивать с толку покупателей.

Параметры заказов

• Статусы заказа для экспорта — Если вы хотите чтобы заказы автоматически экспортировались в ЛК Яндекс доставки без необходимости ручной отправки, вы можете выбрать статусы при которых заказы будут автоматически экспортироваться.
• Статус доставленного заказа — Выберите статус который будет установлен заказу в случае когда заказ будет успешно доставлен и вручён покупателю.
• Статус отменённого заказа — Выберите статус который будет установлен заказу в случае когда заказ будет отменён либо покупателем либо в платформе Яндекс доставки.
• Интервал обновления статусов — Укажите интервал времени в минутах с которым плагин будет делать запросы к серверу Яндекс доставки для получения актуального состояния доставки заказа. Не рекомендуем использовать слишком маленькие и слишком большие значения интервала. Оптимально это 180 минут (3 часа).

Настройка подсказок DADATA

Вы можете использовать подсказки для таких полей как «Регион», «Населённый пункт» и «Адрес» с помощью сервиса DADATA. Для этого необходимо указать API-ключ и Секретный ключ от этого сервиса. Ключи вы можете получить в своём личном кабинете в разделе Профиль.
Для автоматического определения местоположения покупателя включите опцию «Автозаполнение адреса покупателя».
Опции подсказок работают только если на вашем сайте не используется наш плагин для интеграции со СДЭК, так как у этого плагина тоже есть эти опции и приоритет отдаётся именно ему.

Режим отладки

Для диагностики и устранения ошибок включите режим отладки. В этом режиме ведётся запись всех взаимодействий плагина с API Яндекс.Доставки.
Не используйте данный режим если не требуется отладка работы плагина, так как объём передаваемых данных может быть очень большим, что в свою очередь будет создавать лог файлы больших размеров и занимать место на вашем сервере.

Добавление и настройка метода доставки #

Методы доставки «Яндекс.Доставка» добавляются, также как и любой другой метод доставки в Woocommerce, на странице Woocommerce → Настройки → Доставка → Зоны доставки. Выберите нужную вам, заранее созданную, зону доставки и нажмите на кнопку «Добавить метод доставки«. В открывшемся модальном окне необходимо выбрать «Яндекс доставка — Доставка в другой день (Woodev)«.
Теперь можно перейти непосредственно к настройке самого метода доставки Яндекса.

Настройка метода доставки

После добавления метода доставки «Яндекс.Доставка» доступны следующие параметры:

Название метода

• Поле для указания названия метода доставки, которое будет отображаться покупателю на странице оформления заказа.
• Например: «Яндекс.Доставка – доставка до двери» или «Яндекс.Доставка – доставка до ПВЗ».

Тариф доставки

Выбор между двумя вариантами доставки:

• Доставка до двери – покупатель указывает полный адрес, и курьер Яндекс.Доставки доставит заказ по этому адресу.
• Доставка до ПВЗ – покупатель выбирает пункт выдачи заказов (ПВЗ) на карте или из списка доступных ПВЗ.

Опция позволяет адаптировать метод доставки под потребности интернет-магазина и предпочтения клиентов.

Тип отгрузки

Выбор способа передачи товара в Яндекс.Доставку:

• Привезу на ПВЗ – продавец самостоятельно доставляет товар в выбранный пункт приёма Яндекс.Доставки.
• Курьером с моего склада – курьер Яндекс.Доставки забирает товар с указанного склада продавца.

Ваш склад для отгрузки

• Опция отображается, если выбран тип отгрузки «Курьером с моего склада».
• Здесь необходимо выбрать склад из списка, который был ранее добавлен в основных настройках плагина в опции «Склады».

Пункт приёма Яндекса

• Опция отображается, если выбран тип отгрузки «Привезу на ПВЗ».
• Доступны два поля для выбора:
  • Город пункта приёма – выберите город, в котором находится пункт приёма.
  • Пункт выдачи заказов (ПВЗ) – после выбора города загружается список ПВЗ, доступных в этом регионе.

Минимальная стоимость заказа

• Устанавливает минимальную сумму заказа, при которой данный метод доставки будет доступен покупателям.
• Например, если указать значение 1000 рублей, метод доставки не появится для заказов с меньшей суммой.

Максимальная стоимость заказа

• Устанавливает максимальную сумму заказа, при которой метод доставки будет доступен.
• Например, значение 10000 рублей ограничит использование метода для заказов дороже указанной суммы.

Минимальная сумма доставки

• Позволяет установить минимальную стоимость доставки, которая будет отображаться покупателю.
• Полезно для задания нижнего порога стоимости доставки.

Максимальная сумма доставки

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

Бесплатная доставка

• Укажите сумму заказа, при которой доставка становится бесплатной для покупателя.
• Например, если указать 5000 рублей, доставка будет бесплатной для всех заказов от 5000 рублей.

Купон на бесплатную доставку

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

Описание метода

• Поле для текстового описания метода доставки, которое будет отображаться на странице оформления заказа.
• Например: «Курьер Яндекса привезёт ваш товар до двери в удобное время.»

Описание метода

• Выбор классов доставки WooCommerce, для которых данный метод будет доступен.
• По умолчанию выбрано «Любой класс доставки», что означает доступность метода для всех товаров.
• Изменять настройку рекомендуется только опытным пользователям, знакомым с принципами работы классов доставки WooCommerce.

Работа с заказами #

Плагин предоставляет отдельный раздел для управления заказами, созданными с использованием метода доставки Яндекс.Доставка. В этом разделе можно отслеживать статусы заказов, выполнять экспорт, обновлять информацию о статусе доставки, отменять заказы и печатать этикетки для отправлений.

Страница заказов Яндекс.Доставки

Все заказы, созданные с методом доставки Яндекс.Доставка, автоматически попадают на страницу WooCommerce → Заказы Я.Доставки.
Важное отличие: статусы заказов Яндекс.Доставки отображают состояние доставки, а не статусы заказов WooCommerce.

Статусы заказов Яндекс.Доставки

Заказам Яндекс.Доставки присваиваются следующие статусы:

• Новый — Статус по умолчанию для всех новых заказов.
• В процессе экспорта — Статус присваивается заказам, которые добавлены в очередь на экспорт в Личный Кабинет Яндекс.Доставки.
• Принят / Создан — Статус присваивается после успешного экспорта заказа в Личный Кабинет Яндекс.Доставки.
• Некорректный заказ — Статус указывает на ошибку при экспорте заказа.
• Доставлен — Финальный статус, указывающий на успешную доставку заказа получателю.
• Отменён — Статус присваивается заказу после успешной отмены.
• Возвращён — Указывает, что заказ был возвращен отправителю.

И другие промежуточные статусы, описывать которые не будем. Их много.

Доступные действия с заказами

Доступные действия зависят от текущего статуса заказа. Рассмотрим каждое действие подробнее:

Экспортировать

• Добавляет заказ в очередь на экспорт в Личный Кабинет Яндекс.Доставки.
• Экспорт выполняется в асинхронном режиме: после отправки запроса плагин получает только request_id, который используется для проверки статуса заказа позже.
• Доступно для заказов, которые ещё не были экспортированы или экспортировались с ошибкой (Некорректный заказ).

Отменить

• Отправляет запрос на отмену заказа в Яндекс.Доставку.
• Процесс аналогичен экспорту: выполняется асинхронно, после чего заказу присваивается статус Отменён.
• Доступно для заказов, успешно экспортированных, но ещё не переданных курьеру или не отгруженных в ПВЗ.

Обновить статус

• Отправляет запрос на обновление текущего состояния заказа.
• Ответ на запрос приходит сразу, и если статус заказа изменился, он обновляется на актуальный.
• Доступно для всех статусов, кроме конечных: Новый, Доставлен, Отменён, Возвращён.

Печать этикетки

• Скачивает PDF-файл с этикеткой для заказа.
• Этикетку необходимо распечатать и наклеить на отправляемый товар.
• Доступно для заказов, успешно экспортированных, но ещё не переданных курьеру или не отгруженных в ПВЗ.

Отправка уведомлений с трекинг-ссылкой

После успешного экспорта заказа плагин получает ссылку для отслеживания отправления. Эта ссылка автоматически отправляется покупателю в e-mail уведомлении.

Настройка уведомлений:

• Перейдите в WooCommerce → Настройки → Емэйлы → Яндекс.Доставка – Ссылка с трекингом заказа.
• Здесь можно включить или отключить отправку уведомлений (по умолчанию включено).

Редактирование уведомлений:

• Можно изменить тему и текст сообщения.
• В теле сообщения доступны следующие спецтеги:
  • {site_title} – название сайта.
  • {site_address} – адрес сайта.
  • {site_url} – URL сайта.
  • {order_number} – номер заказа.
  • {order_date} – дата создания заказа.
  • {status} – текущий статус доставки заказа.
  • {sharing_url} – ссылка для отслеживания заказа (заменяется на реальную ссылку).

Пример сообщения:

Ваш заказ №{order_number} от {order_date} передан в доставку. Отслеживайте статус по ссылке: {sharing_url}

Печать этикеток

Для отправки заказа необходимо распечатать этикетку со штрих-кодом:

• На странице WooCommerce → Заказы Я.Доставки выберите заказ.
• Выполните действие «Печать этикетки«
• PDF-файл с этикеткой будет загружен на устройство.
• Распечатайте файл и наклейте этикетку на отправляемый товар.