Подключение модуля "Агрегатор Яндекс.Доставка"

Последние изменения: 16.07.2021

Модуль "Агрегатор Яндекс.Доставка" позволяет:

  • Рассчитывать стоимость доставки в RetailCRM;

  • Оформлять и отменять заявку на доставку из RetailCRM;

  • Отображать в RetailCRM актуальные статусы доставки заказа;

  • Получать трек-номер по заказу из Яндекс.Доставки в RetailCRM;

  • Печатать ярлыки отправления для заказа из RetailCRM.

В настоящее время Агрегатор Яндекс.Доставка поддерживает работу служб доставки Стриж, Boxberry, MaxiPost, PickPoint, ПЭК, СДЭК, Почта России.

Для подключения модуля "Агрегатор Яндекс.Доставка" необходимо подключить аккаунт RetailCRM в систему retailcrm.services, добавить аккаунт доставки и API-ключ, настроить синхронизацию в retailcrm.services, сделать необходимые настройки в RetailCRM. Вся настройка занимает не более 30 минут.

Последовательность действий описана ниже:

Проверка настроек API ключа

Перейдите в раздел Настройки → Интеграции → Ключи доступа API:

9ec43bbfb919bb20c4fe5ee436723a43.png

Выберите ключ, который использовали для авторизации в retailcrm.services, и проверьте настройки:

  1. Тип доступа. Если загрузка данных будет осуществляться в несколько магазинов, то необходимо выбрать тип доступа "Для всех магазинов".

  2. В блоке "Разрешенные методы API" проставьте все галки для методов групп: 

Заказы

  • /api/orders/

  • api/orders/statuses

  • /api/orders/{externalId}

  • /api/orders/{externalId}/edit

  • /api/orders/packs/history

  • /api/orders/packs/{id}

  • /api/orders/packs

  • /api/orders/packs/{id}/edit

  • /api/orders/packs/create

  • /api/orders/packs/{id}/delete

Справочники

  • /api/reference/delivery-services

  • /api/reference/delivery-services/{code}/edit

  • /api/reference/delivery-types

  • /api/reference/delivery-types/{code}/edit

  • /api/reference/status-groups

  • /api/reference/statuses

  • /api/reference/stores

Доставки

  • /api/delivery/generic/setting/{code}

  • /api/delivery/generic/setting/{code}/edit

  • /api/delivery/generic/{code}/tracking

  • /api/delivery/shipments

  • /api/delivery/shipments/{id}

  • /api/delivery/shipments/create

  • /api/delivery/shipments/{id}/edit

Интеграция

  • /api/integration-modules/{code}

  • /api/integration-modules/{code}/edit

Добавление аккаунта Агрегатор Яндекс.Доставка

  1. Перейдите в раздел "Мои аккаунты"

  2. В блоке "Мои аккаунты Агрегатор Яндекс.Доставка" нажмите кнопку "Новый аккаунт".

    1cdbc0c269fced6a292a07ee213d4b53.png

    Важно! Вы должны быть авторизованы в аккаунте Яндекс, где заключен договор с доставкой.

  3. На странице авторизации токена нажмите "Разрешить доступ приложению retailcrm.services". Аккаунт успешно добавлен.

Настройка синхронизации

  1. Перейдите в раздел синхронизаций модуля и нажмите кнопку "Создать новую синхронизацию":

    bd9a7fb717c3de5dbe5c9f18efacd82e.png ca2a76e5d188a25bbc8b94335623486d.png
  2. На странице создания синхронизации заполните необходимые настройки и нажмите кнопку "Сохранить":

RetailCRM.Services_________________RetailCRM___________________2020-02-13_11-25-01.jpg

    3. Укажите идентификатор магазина в Агрегатор Яндекс.Доставке Перейдите в личный кабинет доставки в раздел "Настройки → Магазины"

5123115883058fbaa4c73b8fed24bf2f.png

Важно! Идентификатор склада изменяется при внесении любых изменений в настройки склада в ЛК Агрегатор Яндекс.Доставки.

В этом случае нужно заменить идентификатор склада в синхронизации retailcrm.services на актуальный.

4. Проставьте соответствие складов: необходимо указать, какой склад RetailCRM соответствует складу Агрегатор Яндекс.Доставки. 

Перейдите в раздел RetailCRM "Магазин → Склады → Выберите нужный склад" и скопируйте символьный код склада.

c1e35a40e9b4bdb8728b4b1df1c5e10d.png

На вкладке "адрес" сразу укажите адрес склада, так как адрес склада должен быть обязательно указан, чтобы выгрузить заказ в Агрегатор Яндекс.Доставку.

Перейдите в личный кабинет доставки в раздел "Настройки → Склады" и скопируйте идентификатор склада 

8b75c7a54d22020ef85c135331d391ff.png


5. Укажите способ скачивания бланков при массовой печати: 

51ebd7a2ed142a02f8bcd8acd9a4f742.png
  • ZIP архив - каждый бланк будет скачан отдельным архивом;

  • PDF файл - все бланки по заказам будут находиться в одном файле. 

6. Выберите способ вывода стоимости при расчете тарифов в RetailCRM:

c3e8a06e81eba71494346174c424af1d.png
  • Стоимость доставки для магазина - тарифы будут выводиться как себестоимость доставки для магазина;

  • Стоимость доставки для покупателя - тарифы будут выводиться с учетом правил из личного кабинета Агрегатор Яндекс.Доставка. При выбранной опции стоимость расчета тарифа всегда будет 0 при отсутствии наложенного платежа (Агрегатор Яндекс.Доставка отдельно не поддерживает оплату за доставку);

  • Тариф службы доставки - тарифы будут рассчитываться без доп.услуг службы доставки.

7. Процентная наценка (от величины наложенного платежа) позволяет задать наценку к стандартной стоимости доставки. При добавлении наценки тарифы в заказе в RetailCRM будут увеличены на размер наценки: калькулятор вернёт стоимость доставки, увеличенную на сумму, рассчитанную как стоимость_доставки+наложка_за_товары* процент из поля. В поля вводятся только цифры. 

7ebb9b042d45709358d644f7373459c8.png

8. Также Вы можете настроить способ группировки тарифов в зависимости от стоимости:

6f241f91a6601f1546504e83ba3d2560.png


Синхронизация настроена!

Настройка интеграции Агрегатора Яндекс.Доставки в RetailCRM

1. Переходим в маркетплейс RetailCRM вашего аккаунта в модуль "Агрегатор Яндекс.Доставка".

2. Переходим к основным настройкам на вкладке "Доставка". Здесь нужно выбрать необходимые настройки на вкладках "Основные", "Способы оплат",  "Склады", "Статусы". Каждую вкладку рассмотрим подробнее ниже. 

Вкладка "Основные":

e10689fc3816cc7f19d084df777a1084.png

   Поле "Стоимость доставки" позволяет выбрать два варианта:

e83f9aa5f378efb44b9717e83fabd498.png


  • Первый «Рассчитывается автоматически службой доставки» — в данном случае стоимость будет передаваться автоматически в систему из Агрегатора Яндекс.Доставки при выборе соответствующей доставки и сохранении заказа. Используйте данную опцию.

  • Второй «Задается вручную» — в таком случае стоимость доставки необходимо будет указывать вручную.

  Нулевая объявленная стоимость по умолчанию — устанавливает в заказе по умолчанию нулевую объявленную стоимость.

088c3fa5eba9cfaeb651a8c004b0e9a4.png

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

Дата последнего обновления статусов доставки — поле показывает последнее обновление статусов доставки. Если статусы не обновлялись, или произошла какая-либо ошибка при попытке обновиться, то в поле отобразится соответствующая ошибка. Обновление статусов происходит 1 раз в 3ч.  

c8f3c8df68f4c841e12c866e91ee6d7a.png

3. На вкладке "Способы оплаты" выберите необходимые способы оплаты и проставьте галку для способа оплаты, который является наложенным платежом:

1bcf0014ee73ed1be2e9ee866b7e7614.png

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

4. Вкладка  "Склады" не заполняется. Соответствие складов было указано в настройках синхронизации retailcrm.services.

5. На вкладке  "Статусы" можно задать соответствие статусов заказа RetailCRM статусам Агрегатор Яндекс.Доставки. В случае, если задано соответствие статусов, то при изменении статуса отправления в службе доставки изменится статус заказа RetailCRM. Это будет отображено в истории заказа, функция полезна для автоматизации обработки заказа. Логика настройки статусов описана на примере модуля "Почта России" в статье.
6. Теперь необходимо создать новый способ доставки в справочниках "Типы доставки" и добавить интеграционную доставку:

6071b4a5e33833f680f211c297516d14.png

Введите название способа доставки, символьный код и выберите значение выпадающего поля "Интегрировать с"  ранее активированный модуль Яндекс.Доставки.

fc77dba653df3bc51dbd00db43b927bd.png

В поле "Ставка НДС" выбирается из выпадающего списка налог на добавленную стоимость для типа доставки, где производится настройка.

Стоимость доставки оставьте "ноль". Стоимость доставки рассчитывается службой доставки, эта опция уже указана ранее в настройках интеграционного модуля. Настройка условий на стоимость доставки подробно описана в документации RetailCRM. Настройка интеграции с модулем "Яндекс.Доставка" завершена!

Настройка интеграции в личном кабинете Агрегатор Яндекс.Доставки

1. По умолчанию заказ подтверждается в ЛК Агрегатор Яндекс.Доставки со способом отгрузки "Курьер". Для смены способа отгрузки перейдите в Настройки → Общие. Для нужных типов доставки укажите в колонке "Способ отгрузки" → Самопривоз. 

c85eb206b0d57b16e0785d5f6a7d6ed6.png

2. По умолчанию в Агрегатор Яндекс.Доставке стоимость доставки включена в заказ клиента. Чтобы доставка для клиента была бесплатной, перейдите в Настройки → Общие. Нажмите на кнопку "Настройка" в нужном разделе "Способ доставки" и снимите галку с поля "Тариф службы доставки". 

05479b644678b9f9760f8dca665dff91.png
27afca8d93bdfebfc04bd2a13f8fa69e.png

Перед началом работы

Важно! Если на сайте используется модуль "Агрегатор Яндекс.Доставка" для расчета стоимости заказов в корзине, и необходимо, чтобы в RetailCRM передавалась информация по выбранному тарифу при оформлении заказа, нужно делать доработку интеграционного модуля для RetailCRM для вашей CMS (блок модули для CMS).

Интеграционный модуль после доработки позволяет передать тариф в заказ RetailCRM, при этом тариф не будет отображен в явном виде. Нужно нажать кнопку "Выбрать тариф" и выбранный тариф пользователем будет подсвечен зеленым в списке тарифов.

2a5a09b20fe658512ea971fd419bfae0.jpg

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

Ответы на частозадаваемые вопросы по работе с модулем Агрегатор Яндекс.Доставка вы найдете в разделе Частозадаваемые вопросы.

 

Помогла ли вам статья?