Инструкция по эксплуатациимодуля "IML доставка"для CMS

Opencart 3.0

Возможности

Модуль добавляет 4 метода доставки (Курьерская доставка IML с кассовым обслуживанием, Предоплаченная курьерская доставка IML, Доставки IML до ПВЗ с кассовым обслуживанием, Предоплаченная доставка IML до ПВЗ) в CMS Opencart для расчета стоимости доставки на странице заказа(checkout).

Если у созданного заказа в CMS Opencart выбран один из 4 методов доставки, то данный заказ можно отправить в IML API и контролировать его доставку.

Модуль позволяет проверять статусы заказов в IML API.

Модуль позволяет получить этикетки со штрих-кодами для грузовых мест.

Модуль может работать в Opencart с формой заказа по-умолчанию. Также модуль работает в Opencart с формой заказа, измененной модулем Simple (упрощенная форма заказа на AJAX).

Системные требования для Opencart с формойзаказа по-умолчанию

PHP 7.0 и выше

CMS Opencart 3.0 (тестировалось с "Русская сборка Opencart" версии 3.0. Источник -

http://opencart-russia.ru/ )

Системные требования для Opencart с формойзаказа от модуля Simple

1

PHP 7.1 и выше

CMS Opencart 3.0 (тестировалось с "Русская сборка Opencart" версии 3.0. Источник -

http://opencart-russia.ru/ )

Установка

1. необходимо зайти по ссылке http://opencart.iml.ru и скачать модуль интеграции для Opencart

2. Заходим в админку сайта. Слева в меню пункт "Модули\Расширения", под ним пункт "Установка расширений", кликаем на последний.

3. Кликаем на кнопку "Загрузить" и выбираем файл с модулем imldelivery.ocmod.zip

После загрузки прогресс-бар процесс должен стать зеленым

2

Если прогресс-бар красный и написано об ошибке - просьба прислать информацию об этом через форму обратной связи на http://opencart.iml.ru

4. Если ошибок в установке не было, необходимо обновить модификаторы. Заходим в "Модули\Расширения" \"Модификаторы". Нажимаем кнопку "Обновить"

5. После обновления модификаторов нужно активировать модуль. Заходим в "Модули\Расширения" \ "Доставка" , кликаем на кнопку с плюсом напротив модуля "IML доставка модуль". Модуль должен активироваться и вместо кнопки с плюсом, появится красная кнопка с минусом.

Настройка

Страница настроек модуля доступна через пункты меню "Модули\Расширения" \ "Доставка" \ "IML доставка модуль" при нажатии следующей кнопки:

3

Заходим на страницу настроек и видим несколько вкладок.

Вкладка "Авторизация"

Логин - логин, выданный вам для взаимодействия с IML API

Пароль - пароль, выданный вам для взаимодействия с IML API

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

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

Вкладка "Расчет"

Расчет цен - стоимость доставки можно считать с помощью IML API (опция - "СерверIML") или же указать фиксированную стоимость доставки (опция - "Таблица"). При фиксированной стоимости доставки для каждого метода доставки можно указать сумму доставки, как внизу на картинке:

4

Если выбрана опция "Сервер IML", то указывать суммы для этих методов доставки не нужно.

В модуле существует 2 способа задания расчета требуемого количества грузовых мест назаказ.

Фиксированная упаковка - когда администратор определяет параметры единственного грузового места, которые будут указываться в каждом заказе, отосланном в IML API. Здесь необходимо указать габариты грузового места и его вес. Данное грузовое место будет использоваться при расчете стоимости доставки на странице заказа для пользователя. Администратор при отправке заказа в IML API всегда может отредактировать количество грузовых мест.

5

Каждый товар в своей упаковке (1 товар - 1 место) - каждому грузовому месту будетсоответствовать 1 экземпляр товара из корзины. Если в корзине заказывается 3 экземпляра одного товара, то в заказе IML API будет 3 грузовых места. Здесь необходимо указать габариты товара в упаковке и его вес по-умолчанию.

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

Включить комплектацию заказа - включить комплектацию заказа при отправке заказа в IML API, если вы заключили договор с IML на услугу "фулфилмент"

Подключать javascript-файл Яндекс.Карт - если на сайте уже подключены Яндекс.Карты скриптом https://api-maps.yandex.ru/2.1/?lang=ru_RU , то стоит выключить эту опцию, т.к. повторное подключение Яндекс.Карт может нарушить работу сайта.

Ключ Яндекс.Карт - для отображения виджета с выбором ПВЗ доставки используются

Яндекс.Карты. Количество запросов к ним ограничено, если не использовать бесплатный

ключ. Рекомендуется получить ключ через сервисы Яндекс и указать его в этом поле.

Вкладка "Методы доставки"

На вкладке указано 4 метода доставки (Курьерская доставка IML с кассовым обслуживанием, Предоплаченная курьерская доставка IML, Доставки IML до ПВЗ с кассовым обслуживанием, Предоплаченная доставка IML до ПВЗ).

6

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

Отображать доставку при неответе API - если API IML вовремя не отвечает или отвечает с ошибкой, опция заставлять отображать сумму из поля Стоимость при неответе API для каждого из методов доставки.

Отображать дату доставки - API IML помимо стоимости доставки возвращает еще и дату доставки в указанный пользователем населенный пункт. Эта опция позволяет скрывать дату доставки.

Доставка в пункты выдачи - для 2-х методов доставки на ПВЗ можно исключить доставку на пункты выдачи заказов или на постаматы.

Вкладка "Коррекция"

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

Изменить стоимость доставки - если стоимость доставки получена с помощью IML API, то ее можно скорректировать дополнительными наценками или уценками. Например, если нужно добавить 100 руб к стоимости доставки, то у настройки будет следующий вид:

Если нужно прибавить 20 % к стоимости доставки:

Если нужно сделать скидку на доставку в размере 50 %:

7

Если будет пустое значение или 0 у этой настройки - стоимость доставки не будет изменяться.

Округление стоимости доставки (после изменения) - после преобразования стоимостидоставки посредством метода, заданного в поле Изменить стоимость доставки, полученнуюсумму можно округлить с помощью указанного в этом поле алгоритма.

Вкладка "Заказ"

Тестовый режим - создание заказа на доставку в тестовом режиме. Данный режим позволяет рассчитать стоимость доставки, но созданные заказы на доставку НЕ БУДУТ обрабатываться IML API.

Включать в заказ оценочную стоимость - включить в расчет стоимости доставки оценочную стоимость всех товаров заказа.

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

НДС по-умолчанию для товаров - созданный заказ будет включать в себя товары с указанной ставкой. Эта ставка передается в ОФД (тег ФФД 1199).

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

Вкладка "Системные"

Статус модуля - признак, что модуль включен.

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

8

Формирование заказа пользователем

Пользователь добавляет товары в корзину и переходит в корзину. Начинает оформление заказа. При оформлении заказа он вписывает адрес доставки. Например:

После нажатия на кнопку "Продолжить" происходит выполнение запросов к IML API и коррекция полученных результатов. Пример полученных результатов расчета:

9

Если пользователь выбирает метод доставки до ПВЗ, то он может кликнуть на ссылку "выбрать ПВЗ". Отобразиться виджет с картой ПВЗ города, ранее указанного покупателем.

Пользователь кликает на один из пунктов выдачи и нажимает кнопку "Выбрать"

10

Виджет с картой закрывается и адрес выбранного ПВЗ отображается под методом доставки.

11

Далее следует обычная процедура оформления заказа покупателем.

Отправка заказа в IML API администратором сайта

В админке сайта необходимо перейти в раздел "IML Заказы"

Отобразиться список заказов с IML-доставкой.

12

Кликаем на кнопку с грузовичком и попадаем в форму заказа на доставку через IML.

Заявку перед отправкой можно редактировать. При изменении типа услуги надоставку до ПВЗ появится строка с полем "Адрес ПВЗ получения". Если выбрана доставка

13

курьером, то появится поле "Город получения". Адрес доставки курьером - это поле "Адрес"в категории "Получатель". При изменении региона отправления, региона получения,оценочной стоимости доставки и других параметров, рекомендуется нажать кнопку"Рассчитать стоимость доставки". После нажатия на основе параметров заявки будетвычислена стоимость доставки и дата доставки. Существенное влияние на стоимостьдоставки оказывают параметры грузовых мест, услуга комплектации заказа, доп. услуги привыдаче заказа.

Грузовые места можно добавлять до 9 штук. Необходимо задать габариты каждогогрузового места.

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

14

В нижней части заявки появятся 2 кнопки: "Печать штрих-кода" и "Проверить статус".

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

При нажатии на вторую кнопку произойдет запрос статуса данного заказа в IML API. После перезагрузки страницы будет обновлено поле "IML статус".

15