Подключение Shop-Script к «Яндекс.Доставке»

Инструкция для пользователей старого личного кабинета на сайте «Яндекс.Доставки»

Для подключения Shop-Script к сервису «Яндекс.Доставка» установите и настройте плагин «Яндекс.Доставка», как описано в этой статье.

Плагин поддерживает только ту версию API, которая используется в старом личном кабинете «Яндекс.Доставки».


Сервис разрешает подключение только для магазинов, которые размещаются на «Яндекс.Маркете» не меньше 6 месяцев.
Подключение может быть ограничено отдельными географическими регионами. Подробнее об этом написано в справочном разделе «Яндекс.Доставки».

1. Установите плагин

В бекенде Вебасиста перейдите в приложение «Инсталлер». В секции «Плагины → Расчет стоимости доставки» найдите плагин «Яндекс.Доставка». Щелкните по кнопке «Установить».

2. Добавьте способ доставки в Shop-Script

Перейдите в бекенд Shop-Script, откройте раздел «Настройки → Доставка». В верхнем правом углу в выпадающем меню «Добавить способ доставки» выберите плагин «Яндекс.Доставка».

Отредактируйте стандартное название и описание способа доставки так, как они должны быть видны во время оформления заказа.

Заполните настройки:

  • Показывать карту выбора ПВЗ. Выберите, кому показывать онлайн-карту для выбора пунктов выдачи заказов (ПВЗ): всем, кроме пользователей мобильных устройств, или никому. Если карта не показывается, ПВЗ можно выбрать из простого списка.
  • Город магазина
  • Размеры отправления. Укажите фиксированные размеры упаковки, настройте собственный набор размеров для разных значений веса или выберите использование размеров, рассчитанных специальным плагином. От настроенных размеров зависит выбор способов доставки, который будет доступен покупателям.
  • Оценочная стоимость. Укажите фиксированную стоимость в рублях или долю от суммы заказа в процентах, либо сумму или разность этих значений. Оценочная стоимость выплачивается магазину, если служба доставки потеряет или повредит груз. Если оценочную стоимость не заполнить, то магазин вправе потребовать от «Яндекс.Доставки» половину либо двойную стоимость заказа в зависимости от ситуации.
  • Настройки интеграции. Выберите, какие действия плагин должен автоматически выполнять в кабинете «Яндекс.Доставки»: создавать и обновлять черновики заказов, создавать отгрузки, отменять отгрузки.
  • Способ отгрузки. Выберите, должна ли служба доставки забирать заказы с вашего склада либо вы будете самостоятельно отвозить заказы в службу доставки.
  • Передавать заказы через единый склад. Включите этот флажок, если вы хотите, чтобы ваши заказы сначала собирались на едином складе «Яндекс.Доставки» и только потом распределялись по отдельным службам доставки. Выключите его, если хотите, чтобы заказы сразу попадали в отдельные службы доставки.
  • Передача ставок НДС. Если ваша организация работает по ОСН, выберите вариант «Передавать ставки НДС по каждой позиции». Ставка НДС может быть равна 0%, 10% или 18%. В настройках налогов в приложении выберите, чтобы НДС был включен в цену товара. Если вы работаете по другой системе налогообложения, выберите «НДС не облагается». Настройка позволяет адаптировать работу плагина к требованиям закона РФ №54-ФЗ.

С помощью настроек «Способ отгрузки» и «Передавать заказы через единый склад» выберите подходящий для вас вариант работы с «Яндекс.Доставкой»:

  1. «Яндекс.Доставка» забирает заказ с вашего склада на свой общий склад и оттуда передает его службе доставки, которую выбрал покупатель во время оформления заказа.
  2. Вы отвозите заказ на общий склад «Яндекс.Доставки». Оттуда он передается службе доставки, выбранной покупателем.
  3. Выбранная покупателем служба доставки самостоятельно забирает заказ с вашего склада и отвозит его покупателю.
  4. Вы отвозите заказ в службу доставки, выбранную покупателем, и она отвозит его покупателю.

3. Зарегистрируйтесь в сервисе

Создайте личный кабинет на сайте «Яндекс.Доставки».

Посмотрите видеоуроки об использовании этого сервиса.

В своем кабинете перейдите в раздел «Настройки → Интеграция → API» и щелкните по ссылке «получить».

Во всплывающей области скопируйте содержимое первого текстового поля и вставьте его в поле «method_keys» в настройках способа доставки в бекенде Shop-Script.

Во втором текстовом поле найдите фрагмент вида

"client": {
    "id": 12345
},

Скопируйте числовое значение параметра id и вставьте его в поле «client_id» в настройках способа доставки магазина. В этом примере: 12345.

Найдите фрагмент вида

"senders": [
    {
        "id": 98765,
        "name": "Мой интернет-магазин"
    }
],

Скопируйте числовое значение параметра id и вставьте его в поле «sender_id» в настройках способа доставки. В этом примере: 98765.

Найдите фрагмент вида

"warehouses": [
    {
        "id": 12345,
        "name": "Основной склад"
    }
],


Скопируйте числовое значение параметра id и вставьте его в поле «warehouse_id» в настройках способа доставки. В этом примере: 12345.

Сохраните настройки способа доставки.

4. Настройте личный кабинет на сайте «Яндекс.Доставки»

Посмотрите видеоролик о том, как настроить доставку в личном кабинете.

Готово!

Ваш магазин подключен к сервису «Яндекс.Доставка». Теперь покупатели могут выбирать пункт выдачи заказа на карте.

Как работает плагин «Яндекс.Доставка»

Плагин умеет:

  • рассчитывать стоимость доставки по адресу покупателя;
  • предлагать выбор пунктов выдачи заказа на карте во время оформления заказа;
  • создавать и обновлять черновики заказов в кабинете «Яндекс.Доставки»;
  • создавать отгрузки для заказов в кабинете «Яндекс.Доставки»;
  • отменять заказы, удаленные в бекенде магазина.

Создание и обновление черновиков заказов, создание и отмена отгрузки доступны в Shop-Script не ниже версии 7.2.9.

Порядок работы

  1. Покупатель оформляет заказ в интернет-магазине. При выборе способа доставки «Яндекс.Доставкой» ему предлагаются службы доставки в зависимости от города покупателя, веса заказа и размеров упаковки, указанных в настройках плагина.
  2. Когда покупатель подтверждает оформление заказа, плагин создает черновик заказа в «Яндекс.Доставке».
  3. Если вы редактируйте заказ в магазине, плагин обновит этот черновик. Черновик можно изменить и вручную в кабинете «Яндекс.Доставки», но последующее редактирование заказа в магазине перезапишет эти изменения. Поэтому вручную черновик лучше не редактировать черновик, а изменять свойства заказа только в бекенде Вебасиста.
  4. Выполните действие «Отправлен» с заказом в магазине — плагин превратит черновик в подтвержденный заказ, готовый к отправке.

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

    После этого редактируйте заказ только в кабинете «Яндекс.Доставки», потому что изменения в подтвержденном заказе, сделанные в бекенде магазина, не передаются в «Яндекс.Доставку».
  5. Войдите в кабинет «Яндекс.Доставки» и вручную оформляйте заявки на забор или самопривоз для подтвержденных заказов. Несколько заказов можно объединять в одну заявку. Там же печатайте ярлыки для заказов.
  6. Отвезите заказы на склад службы доставки или готовьте заказы для забора службой доставки с вашего склада.
  7. Вместо отправки заказа вы можете отменить его в магазине — плагин переведет подтвержденный заказ в «Яндекс.Доставке» в список «Отмены», а черновик оставит без изменений. Черновик можно изменить и вручную перенести в архив.

Передача скидки в «Яндекс.Доставку»

Стоимость товаров передается в «Яндекс.Доставку» с учетом скидки. Размер скидки распределяется по всем товарам в заказе. Отдельной записи «Скидка» в передаваемом заказе не будет — это требование закона 54-ФЗ.

Доставка службой DPD

Для службы DPD доступна доставка только курьером. Пункты самовывоза служба DPD не предоставляет через API «Яндекс.Доставки».

Логирование запросов и ответов к серверу «Яндекс.Доставки»

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

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

15 комментариев

  • +1
    Руслан Гумеров Руслан Гумеров 3 июня 2019 12:31 #

    Здравствуйте! 

    Размеры отправления рассчитываются отдельным плагином, каким?

  • +1
    Alex Bakhvalov Alex Bakhvalov 6 июня 2019 11:55 #

    Добрый день, нам очень нужно убрать пункт: Желаемые дата и время доставки из плагина Яндекс. Доставка, но нигде не видим настройки этой. Как это сделать? Спасибо

    • +1

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

      Если вам нужно более срочное решение, обратитесь за квалифицированной помощью к партнёрам Webasyst.

      • +1
        Alex Bakhvalov Alex Bakhvalov 6 июня 2019 15:27 #

        Михаил, спасибо, очень ждем. А нормально, что квалифицированные разработчики будут ковырять плагин, который сделал Webasyst, а потом выйдет обновление и все изменения будут уничтожены?

      • +1

        Как передавать номер дома в Яндекс доставка??? Не нашёл как это сделать

      • +1

        В личном кабинете и на странице заказа пишет: Заказ с таким order_id не найден , хотя идентификатор вставляю с яндекса. В чем причина?

      • +2
        Vladislav Vladislav 12 ноября 2019 20:12 #

        Попали в группу тестирования новой Яндекс.Доставки. Как говорят в Яндексе перезагрузка Яндекс.Доставки.

        Выложен новый полностью переработанный API Яндекс.Доставки

        Стало гораздо удобней и быстрей.

        Михаил, когда ожидать обновления интеграции со стороны webasyst?

      • +2
        Юрий Ким Юрий Ким 12 февраля 2020 14:26 #

        У Яндекс.Доставки новый личный кабинет.

        Можете выложить инструкцию для настройки интеграции в новом ЛК?

      • +1
        Vladimir Vladimir 10 марта 2020 17:02 #

        В Яндексе сообщаю, что поддержка старой версии прекратится в ближайшие месяцы. Когда планируется поддержка новой версии Яндекс Доставки?

      • +1
        knfilterru@gmail.com knfilterru@gmail.com 7 мая 2020 02:45 #

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

        "Добрый день!

        По вопросу модуля Shop-Script для работы с новой версией Яндекс.Доставки необходимо обратиться непосредственно к разработчику модуля.
        Регистрация новых пользователей доступна только через новый Личный Кабинет (https://partner.market.yandex.ru/delivery/register) и подключиться к старому кабинету невозможно.
        Связано это с тем, что Доставка более полугода живет с двумя кабинетами и поддерживать оба - не оптимально. Поэтому мы планируем закрытие старого кабинета Яндекс.Доставки и сейчас рассчитываем сроки и этапы, когда и как сможем постепенно отказаться от него.
        Благодарим за обращение!"

        С нетерпением ждём плагина для нового лк Яндекс Доставки!

        Добавить комментарий

        Чтобы добавить комментарий, зарегистрируйтесь или войдите