Актуальная версия модуля (APIv2)
Уважаемый пользователь, при установке модуля интеграции IML вы получаете следующие возможности интеграции
- Выбрать способ доставки курьерская доставка «до двери», в пункт выдачи заказов или постаматы;
- Получить актуальный список актуальных ПВЗ и постаматов на карте с автоматически рассчитанной стоимостью доставки;
- Получить информацию о возможностях оплаты на точках ПВЗ;
- Передать заказ в личный кабинет IML;
- Получить и напечатать наклейку штрих-кодов для вашего заказа;
- Синхронизировать статусы доставки со статусами в панели администрирования;
- Указать необходимость комплектации вашего заказа при наличии договора “Фулфилмент”.
Если вам нужна помощь при установке или возникли проблемы с работой модуля, для получение поддержки пишите на cms@iml.ru в письме опишите проблему, укажите ваш УНК и подготовьте доступы к админ панели вашего сайта.
Компания предлагает своим клиентам полный спектр логистических услуг, включая экспресс-доставку и супер-экспресс, клиентский возврат, примерку и частичный выкуп для получателей, хранение и фулфилмент, кросс-докинг, и многое другое. Более 11 лет на рынке.
Внимательно прочтите инструкцию по установке приложения.
Есть два варианта подключения интеграции:
-- Вы хотите обновить существующую интеграцию. Начните настройку с этого раздела
-- Вы выполняете подключение впервые: Начните настройку с этого раздела
Настройка интеграции InSales - IML
- Устанавливаем приложение IML в разделе “Приложения”
Активный чекбокс “Тестовый режим” служит для формирования заказов далее не идущих в работу сервиса доставки
При заполнении информации на каждой странице - нажимайте "Сохранить"
- После установки приложения начните настройку Ваших учетных данных: Ваш УНК и Пароль от Личного кабинета IML
Далее перейдите в “Настройки” и заполните следующие поля:
- Склад отправления - выбрать свой город, поле «Город отправления» заполняется автоматически исходя из выбранного склада.
- Дополнительный вес упаковки, (в гр) – функция прибавит вес упаковки (может измениться стоимость доставки)
- Добавочная стоимость Курьер – какую сумму (в руб.) добавить к стоимости доставки курьером
- Добавочная стоимость Самовывоз – какую сумму (в руб.) добавить к стоимости доставки при доставке заказ до ПВЗ
- Прибавить к сроку доставки дней на комплектацию – сколько дней необходимо на сборку заказа / посылки до момента передачи в службу доставки
- Время соединения по умолчанию, сек – минимум 300, если возникают ошибки или очень долго ожидание – можно увеличить данный интервал, изменять его нужно только в случае нестабильной или ошибочной работы
- НДС – в случае работы с НДС выбрать свой процент НДС
- Заполните дополнительные услуги отметив чекбоксы. Доп услуги прибавляются по тарифам IML
- Далее нужно настроить размеры и вес посылки по умолчанию, если данные параметры не заданы у товаров в магазине. Данную настройку необходимо или оставить по умолчанию или заполнить своими размерами (в мм.) и весом товара (в гр.).
- Для подключения доставки v2 необходимо нажать на кнопку Подключить карту insales "Доставка в точки самовывоза" в настройках. При нажатии карты подключатся автоматически.
- Далее перейдите в настройки доставки в админ панели. Перейдите в тип доставки "Доставка в точки самовывоза" и отметьте чекбокс ниже на скриншоте. ПВЗ будут "подтягиваться" как в инструкции InSales
Типы доставки связанные с самовывозом IML можно отключить и не отображать при оформлении заказа
- (Опционально) Для совместимости с версией модуля APIv1 с точками ПВЗ нужно получить API ключ Яндекс Карты (кликнув по ссылке, выполнив инструкции Яндекса) и вставить в соответствующее поле.
- Сохраняем настройки нажатием кнопки “Сохранить”
- Настройте статусы своего магазина согласно статусам модуля IML. Статусы заказа обновляются один раз в час.
- Сохраните настройки
При ошибках расчета стоимости товаров – необходимо сбросить кеш расчетов, для этого необходимо переходим в приложение (Приложения > Установленные > IML) и нажимаем кнопку «Сбросить кеш калькулятора».
Если необходимо изменить учетные данные (данные входя в ЛК iml) переходим в приложение (Приложения > Установленные > IML) > Учетные данные.
После ввода новых данных необходимо сбросить кеш калькулятора и проверить заполненные данные (настройки) приложения.
После чего необходимо активировать доставки.
Переходим (Настройки > Доставки) там будет два новых способа «Доставка IML самовывоз» и «Доставка IML курьер».
Системные настройки не меняем, подключаем только платежные системы, которые работают с выбранной доставкой «Привязка к способам оплаты», и настраиваем привязку к регионам, если это необходимо «Привязка к регионам и городам».
Если все настроено верно, в оформление заказа появятся новые пункты доставки
Работа с заказами в Бэк-Офисе InSales
Создайте новый заказ и выберите “Доставка”
Откроется список доступных интеграций
Выберите нужные
Выберите ПВЗ/Постамат (обращайте внимание на название пунктов ПВЗ или Постамат) на карте если используете Услугу С24 или С24КО
Внимание. При выборе конкретной точки не всегда отобразится стоимость доставки в заказе (это нормально, иногда API долго отвечает)
Далее заказ сохранится и вы перейдете к его управлению указав необходимые параметры (в том числе рассчитается и присвоится корректная стоимость)
При оформлении заказа используйте пространство “IML” в правой части вашего экрана.
Если изменить статус оплаты на “оплачен” то из поля Наложенный платеж исчезнет стоимость наложенного платежа и будет равно 0.
Проверьте все поля и отправляйте заказ.
При удачном оформлении вы сможете распечатать вашу этикетку заказу и в поле комментарий появится комментарий со штрих кодом заказа
Авторизуйтесь со своими данными УНК/Пароль
Переход откроет вашу этикетку заказа
Далее следите за статусами заказа - они обновляются автоматически при смене на стороне IML
Для модификации стоимости доставки на ПВЗ при использовании с модулем APIv2 - зайдите в раздел "Настройки → Доставки → Доставка в точки самовывоза" Задайте необходимую величину стоимости доставки
Для разработчиков
Для модификации данных стоимости доставки (например курьерской) используются JS функции обработчика, если они заданы.
<? /** * Изменение минимальных сроков доставки * * @param string type - Тип, может принимать значения self – Список ПВЗ, courier – доставка курьером * @param object filter - фильтр запроса отправляемый insales * @param int minDays - минимальное количество дней полученное от iml * * @return int Минимальный срок доставки */ function imlUpdateDeliveryDate(type, filter, minDays) { return (minDays + 20); } /** * Изменение цены и сроков для списка выбора ПВЗ * * @param object data - объект с данными для построения точек ПВЗ * @param object filter - фильтр запроса отправляемый insales * * @return object */ function imlUpdateDeliverySelfInit(data, filter) { for (pointId in data.points) { data.points[pointId]['best_tariff']['days'] += 40; data.points[pointId]['best_tariff']['deliveryCost'] = 500; data.points[pointId]['deliveryCost'] = 500; } data['providers']['iml']['best_tariff']['days'] = 10; data['providers']['iml']['best_tariff']['deliveryCost'] = 700; data['providers']['iml']['tariffs']['deliveryCost'] = 700; return data; } ?>
Для точки (ПВЗ)
data\points\point\best_tariff\days - Минимальный срок доставки
data\points\point\best_tariff\deliveryCost - Цена доставки (должно быть одинаково с data\points\point\deliveryCost)
Для списка (при выборе ПВЗ цена и сроки от)
data\providers\iml\best_tariff\days - Минимальный срок доставки
providers\iml\best_tariff\deliveryCost - Цена доставки (должно быть одинаково с data\providers\iml\tariffs\deliveryCost)
filter - фильтр запроса отправляемый insales
<? /** * Изменение начальных настроек цены, это первичный расчет * для ПВЗ когда пункт еще не выбран, т.е. показывается * самая малая цена и цена для курьерской доставки. * * @param object data - объект с начально отображаемой ценой */ function imlCalculationFirstPriceRequest(data, filter) { data.delivery_price = 1200; return data; } ?> data : { "delivery_price" : 356, "type" : "self" self для ПВЗ, courier для курьерской доставки }
filter - фильтр запроса отправляемый insales
{ city: "Ульяновск" Город country: "RU" insales_id: 223003 location: { Расшифровка местоположения address: "" area: null area_type: null autodetected: null city: "Ульяновск" city_type: "г" country: "RU" flat: "" house: "" is_kladr: true kladr_code: "7300000100000" last_level: "Ульяновск" last_level_type: "г" latitude: null locality: "Ульяновск" locality_type: "г" longitude: null region_zip: "432000" result: "г Ульяновск, Ульяновская обл." settlement: null settlement_type: null state: "Ульяновская" state_type: "обл" street: "" street_type: null zip: null } price: 12600 Стоимость заказа region: "обл Ульяновская" Регион weight: "0.5" Вес заказа zip: 0 }
Пример:
- Установить цену доставки для ПВЗ Волгограда 200р
- Установить цену доставки для ПВЗ Волгограда 150р если заказ больше 2000р
function imlCalculationFirstPriceRequest(data, filter) { if(filter.city == "Волгоград" && data.type == "self") data.delivery_price = filter.price >= 2000 ? 150 : 200; return data; } function imlUpdateDeliverySelfInit(data, filter) { if(filter.city == "Волгоград") { var delivery_price = filter.price >= 2000 ? 150 : 200; for (pointId in data.points) { data.points[pointId]['best_tariff']['deliveryCost'] = delivery_price; data.points[pointId]['deliveryCost'] = delivery_price; } data['providers']['iml']['best_tariff']['deliveryCost'] = delivery_price; data['providers']['iml']['tariffs']['deliveryCost'] = delivery_price; } return data; }
Код должен располагаться до вызова
<script type="text/javascript" src="//insales.iml.ru/checkoutWidget/widget.js?insales_id=223003"></script>
для этого лучше всего разместить код в службе доставки "Доставка IML самовывоз" (Настройки - Доставка - Доставка IML самовывоз) в поле Javascript до подключения библиотеки.
Если вам нужна помощь при установке или возникли проблемы с работой модуля, пишите на cms@iml.ru для получение консультации.