Актуальная версия модуля (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 для получение консультации.