Интеграция DostavkaGuru и RetailCRM

Интеграция DostavkaGuru позволяет:

  • Рассчитывать предварительную стоимость доставки
  • Оформлять заявку на доставку
  • Отображать в системе актуальные статусы доставок и задавать соответствия статуса доставки статусу заказа

Пожалуйста, ознакомьтесь с информацией и тарифами на доставку:

Как настроить интеграцию со службой доставки DostavkaGuru

Чтобы настроить интеграцию со службой доставки DostavkaGuru, необходимо:

  • В системе перейти по пути Администрирование -> Интеграция -> Ключи доступа к API

image-001-01.png

  • Создать API-ключ

image-001-02.png

  • Разрешить ключу методы API для разделов:
    • /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
    • /api/reference/delivery-types
    • /api/orders
    • /api/orders/{externalId}
    • /api/orders/{externalId}/edit

- Получить ID и токен (ключ) для API DostavkaGuru по электронной почте: info@dostavka.guru, отправив заявку на получение ЛК в службе доставки.

- Перейти на страницу подключения, нажав на кнопку «Подключить» во всплывающем окне подключения доставки в системе.

- После нажатия открываются настройки интеграции, где необходимо ввести следующие параметры:

  • адрес RetailCRM
  • ранее созданный в RetailCRM API-ключ
  • Ваш ID для DostavkaGuru (не путайте с логином в Ваш ЛК)
  • Ваш ключ API (токен) для DostavkaGuru

Обратите внимание: адрес CRM указывается без последнего знака / после ru!

- После того, как все данные заполнены, необходимо нажать на кнопку «Активировать»

- Если Вы захотите отключить свой аккаунт RetailCRM от интеграционного модуля - нажмите кнопку «Отключить».

- Если Вы хотите активровать интеграционный модуль в другом аккаунте RetailCRM, но сейчас находитесь в аккаунте - нажмите «Сменить аккаунт».

Настройка интеграции с DostavkaGuru

После сохранения активируется модуль интеграции с доставкой DostavkaGuru.

Основные

В поле «Стоимость доставки» необходимо указать, кто задает стоимость доставки: магазин или служба доставки. Если «Задается вручную», то информация о стоимости доставки от DostavkaGuru будет отображаться только в поле «Себестоимость», а если «Рассчитывается автоматически службой доставки», то данные подтянутся и в «Себестоимость» и в «Стоимость».

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

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

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

Способы оплаты

На второй вкладке простая настройка доступных способов оплаты для типа доставки

В этой вкладке необходимо выбрать те типы оплаты, которые будут использоваться при работе с доставкой DostavkaGuru.

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

Склады

В этой вкладке отображается, у каких складов не заполнены регион и город (должны быть заполнены для использования в доставке).

Статусы

В этой вкладке можно настроить соответствие статусов DostavkaGuru и системы.

Значения по умолчанию

Заполняется автоматически при включении интеграции.

Создание типа доставки DostavkaGuru:

Для того, чтобы в заказе можно было пользоваться службой доставки DostavkaGuru, надо сначала создать тип доставки DostavkaGuru. Зайдите в раздел Администрирование -> Справочники -> Типы доставок и нажмите на кнопку «Добавить».

image-008-01.png

Обязательно укажите необходимую интеграцию!

image-008-02.png

Далее необходимо настроить только что созданный тип доставки:

  • Название - здесь необходимо записать название доставки, в заказах укажется именно это название. Его вы можете указать на свое усмотрение.
  • Символьный код - латинское обозначение данного типа доставки, необходимо для обработки системой и является обязательным.
  • Интегрировать с - самое важное поле, здесь мы указываем что этот тип доставки будет относиться к интеграции с DostavkaGuru. Данное поле задается 1 раз и после сохранения больше не редактируется.
  • Активность - данный чекбокс отвечает за использование этого типа доставки в заказах. Если галочка не установлена, то данная доставка не отобразится в заказе.
  • По умолчанию в системе - если установить этот чекбокс, то при создании нового заказа в системе, данный тип доставки будет устанавливаться автоматически.
  • Описание - поле для указания общей информации по данному типу доставки, оно же отобразится в общем реестре типов доставок (на уровень выше).
  • Важно: После сохранения типа доставки, поле "Интегрировать с" перестает быть доступным для редактирования и поменять его нельзя. Если данная доставка вами больше не используется, вы можете ее деактивировать, сняв галочку в поле "Активность".

Работа с типом доставки DostavkaGuru в карточке заказа

Рассмотрим заказ, в котором выбран тип доставки DostavkaGuru.

Все обязательные поля можно видеть на скриншоте.

На скриншоте указан тестовый склад для Санкт-Петербурга, из-за того, что служба доставки может забрать заказы только из Москвы или Санкт-Петербурга.

Следует отметить, что поле квартира необходимо заполнять. Для частного дома на одну семью следует указывать квартиру номер 1.

Обратите внимение: поле «Не отправлять данные в службу доставки» позволяет не передавать данные в службу доставки, если она уже выбрана. Если поставить галочку в это поле, все обязательные поля при оформлении доставки становятся необязательными. Данный функционал полезен в тех случаях, когда товары в заказе сначала изготавливаются или комплектуются и только после этого заказ передается в службу доставки. Тогда необходимо убрать галочку из поля «Не отправлять данные в службу доставки» и заполнить необходимые параметры для DostavkaGuru.

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

Затем выберите способ доставки.

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

На 19.06.2019 ограничения следующие:

  • Нестандартная - обычная посылка
  • Нестандартная, негабаритная - сумма трех сторон отправления превышает 120 см или одна из сторон превышает 60 см или вес превышает 10 кг
  • 1 класс - Предельная масса - 2.5 кг. Минимальный размер - 110 х 190 мм. Максимальный размер - не более 36 см в одном из трех измерений, сумма трех измерений не должна превышать 70 см. Сумма объявленной ценности для посылки 1-го класса не должна превышать 100000 руб. Сумма наложенного платежа не должна превышать сумму объявленной ценности почтового отправления.

После выбора способа доставки (например ПВЗ) в карточке заказа появится дополнительная информация по пункту выдачи.

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

Обратите внимание на некоторые дополнительные ограничения службы доставки:

  • по умолчанию объявленная стоимость равна сумме товаров (если не включена опция «Нулевая объявленная стоимость по умолчанию»)
  • дата доставки заказа в RetailCRM будет обновляться из службы доставки при обновлении статуса заказа
  • на данный момент заказ можно отправить в службу доставки только один раз, дальнейше его изменение возможно через техническую поддержку службы доставки
  • Документация DOSTAVKA GURU

Забор товаров

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

Создается он в разделе “Склады”

Требуется нажать на кнопку “создать отгрузку” и заполнить все поля, выбрав заказы, которые необходимо отгрузить.

Информация будет передана в службу доставки.

Обратите внимание, заявка на отгрузку будет отражена в списке заказов.
В службе доставки забор товара регламентирован договором и настраивается по расписанию в ЛК доставки.