Как подключить «Яндекс Доставку» к интернет-магазину

«Яндекс Доставка» помогает интернет-магазинам отправлять заказы через партнёрские службы доставки: Boxberry, СДЭК и другие. После подключения покупатели смогут выбрать удобный способ получения товара при оформлении заказа, а вы — автоматически создавать отправления в личном кабинете «Яндекс Доставки».

---

Если вы ранее использовали Boxberry

Если ваш магазин уже работал с сервисом Boxberry, переход на «Яндекс Доставку» выполняется так:

1. Обновите плагин в приложении для установки плагинов. После обновления его название изменится на «Яндекс Доставка (Boxberry)».
2. Очистите кеш в приложении «Настройки».
3. В личном кабинете Boxberry перейдите в личный кабинет «Яндекс Доставки» — следуйте инструкции, которая доступна в вашем кабинете Boxberry.
4. В разделе «Интеграция» нажмите кнопку «Получить токен».
5. Скопируйте токен и сохраните его в настройках способа доставки вашего магазина.
6. Снова откройте настройки способа доставки, выберите пункт приёма посылок и сохраните настройки повторно.

Рекомендуется использовать с версией интернет-магазина 8.5.0 или выше. С более ранними версиями плагин может работать некорректно.

---

1. Регистрация в сервисе доставки

Зарегистрируйтесь на сайте «Яндекс Доставки». После регистрации вы получите API-токен — это специальный код для подключения вашего магазина к системе.

В личном кабинете заполните информацию о магазине в разделе Мой профиль → Информация о магазине.

На вкладке Услуги выберите тарифы на выдачу посылок и оповещение. Эти настройки будут использоваться при создании черновиков отправлений в личном кабинете.

Обратите внимание: настройки услуг влияют только на предварительное заполнение формы в личном кабинете «Яндекс Доставки». На расчёт стоимости доставки в интернет-магазине они не влияют. Однако выбранные дополнительные услуги будут автоматически добавляться в отправления, создаваемые на основе заказов магазина.

Эти значения применяются только на следующий день после сохранения.

Сохраните настройки услуг.

На вкладке Адреса забора добавьте адреса, по которым служба доставки будет забирать заказы (если это предусмотрено вашим договором со службой доставки).

Откройте раздел Инфоцентр → Интеграция → Методы API и скопируйте API токен.

---

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

В своём аккаунте Webasyst откройте приложение «Инсталлер» (оно нужно для установки плагинов). Найдите плагин «Яндекс Доставка» (Boxberry) с помощью поиска и установите его.

Часто задаваемые вопросы и ответы для пользователей «Яндекс Доставки».

---

3. Добавление способа доставки

Перейдите в раздел «Настройки → Доставка» в вашем магазине.

В меню «Добавить способ доставки» выберите плагин «Яндекс Доставка» (Boxberry).

Отключение на время настройки

Снимите флажок «Включено». Это предотвратит появление не до конца настроенного способа доставки на витрине магазина. Флажок нужно будет включить после завершения настройки (описано ниже).

Ввод токена

В поле «Токен» вставьте токен, скопированный в аккаунте «Яндекс Доставки» (Boxberry).

Нажмите кнопку сохранения настроек.

Повторный вход в настройки

Нажмите кнопку «Настройки» рядом с добавленным способом доставки, чтобы открыть его настройки повторно.

---

Настройка способа доставки

Основные настройки

• Включено. Включите этот флажок, чтобы способ доставки стал доступен покупателям на витрине магазина.
• Название способа доставки. Укажите название, которое покупатели увидят при оформлении заказа.
• URL логотипа. Укажите ссылку на логотип (если нужно), который будет показан покупателям.
• Описание. Добавьте описание, которое увидят покупатели при оформлении заказа.

Налоги

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

Дополнительные параметры

• Дополнительное время на комплектацию. Укажите время в часах, которое нужно сотрудникам для подготовки заказа к выдаче. Это время учитывается при расчёте срока готовности заказа в корзине. Например, чтобы покупатель мог получить заказ на следующий день, укажите 24 часа.
• Предлагать доставку типам покупателей. Выберите, кому будет доступен этот способ: только физическим лицам, только юридическим лицам или всем покупателям.

Как настроить доставку через «Яндекс Доставку» или Boxberry в магазине

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

Основные настройки

• Название службы — укажите, как этот способ доставки будет называться в корзине при оформлении заказа. Покупатели увидят это название.
• Адрес API — чтобы проверить работу подключения в тестовом режиме, запросите тестовый адрес и токен у поддержки «Яндекс Доставки» или Boxberry.
• Город приёма посылок — начните вводить название города, откуда вы будете отправлять заказы. Выберите свой город или ближайший к вам.
• Пункт приёма посылок — выберите пункт приёма службы доставки для выбранного города. Вы будете привозить заказы в этот пункт, а покупатели увидят стоимость доставки от него.
• Габариты и вес по умолчанию — укажите стандартные размеры и вес посылки. Эти значения используются для расчёта стоимости доставки, если в заказе не указаны конкретные размеры товаров. Если оставить поля пустыми, рассчитать стоимость и сроки доставки не получится. Слишком большие значения могут сделать доставку недоступной для некоторых покупателей — у каждого пункта выдачи есть ограничения по размерам отправлений.

Ограничения доставки

• Город — укажите города, в которые будет доступна доставка через «Яндекс Доставку» или Boxberry. Оставьте поле пустым, чтобы доставка была доступна покупателям из любых городов.
• Максимальные габариты и вес — задайте ограничения. Если заказ превысит эти значения, доставка через службу предложена не будет. Размеры заказа определяются автоматически, если у вас установлен специальный плагин. Без плагина используются значения по умолчанию из настроек.

Стоимость доставки

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

Способы доставки

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

Сохранение настроек

Нажмите кнопку «Сохранить», чтобы применить изменения.

Готово! Ваш магазин подключён к сервису доставки. Теперь покупатели смогут выбрать удобный способ получения заказа:

• доставка курьером;
• самовывоз из пункта выдачи.

Дополнительные возможности

Как работает автоматическая синхронизация данных о заказе

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

Важно: функция работает только при указанном полном номере телефона покупателя. Поддерживаются только российские номера.

---

Как добавить информацию о пункте выдачи в уведомление

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

{if !empty($shipping_plugin) && $shipping_plugin instanceof boxberryShipping}
    {$point_data = $shipping_plugin->getPointInfo($order)}
    {if !empty($point_data)}
        {* Код с использованием данных пункта выдачи *}
    {/if}
{/if}

Вместо комментария в фигурных скобках добавьте код для вывода информации о пункте выдачи. Доступные поля массива $point_data:

• name — название пункта выдачи
• phone — телефон
• address — адрес
• max_volume — максимальный объём посылки
• max_weight — максимальный вес посылки
• only_prepaid_orders — выдача только предоплаченных заказов
• schedule — часы работы
• delivery_period — срок доставки из Москвы
• metro — ближайшая станция метро
• courier_delivery — доступность курьерской доставки
• acquiring — оплата банковскими картами

Пример

{if !empty($shipping_plugin) && $shipping_plugin instanceof boxberryShipping}
    {$point_data = $shipping_plugin->getPointInfo($order)}
    {if !empty($point_data)}
        {if $point_data.acquiring}
            В пункте выдачи заказ можно оплатить банковской картой.
        {/if}
    {/if}
{/if}

---

Как рассчитывается срок доставки до пункта выдачи

Срок доставки рассчитывается с учётом:

• расписания работы вашего магазина;
• значения поля «Дополнительное время на комплектацию» в настройках доставки.

Если полученная дата выпадает на нерабочий день пункта выдачи, она переносится на ближайший рабочий день. Эта информация поступает от сервиса доставки.

---

Почему стоимость доставки может отличаться

Если стоимость доставки при оформлении заказа отличается от результата калькулятора в личном кабинете «Яндекс Доставки» (Boxberry), проверьте следующее:

Причина расхождения

При использовании калькулятора убедитесь, что выбраны те же дополнительные услуги, которые указаны в вашем договоре с «Яндекс Доставкой» (Boxberry).

Плагин запрашивает стоимость через технический интерфейс. При расчёте может применяться набор стандартных дополнительных услуг. Уточните этот набор для вашего договора через службу поддержки «Яндекс Доставки» (Boxberry).