Page tree
Skip to end of metadata
Go to start of metadata

Актуальная версия модуля (APIv2)


Уважаемый пользователь, при установке модуля интеграции IML вы получаете следующие возможности интеграции

  1. Выбрать способ доставки курьерская доставка «до двери», в пункт выдачи заказов или постаматы;
  2. Получить актуальный список актуальных ПВЗ и постаматов на карте с автоматически рассчитанной стоимостью доставки;
  3. Получить информацию о возможностях оплаты на точках ПВЗ;
  4. Передать заказ в личный кабинет IML;
  5. Получить и напечатать наклейку штрих-кодов для вашего заказа;
  6. Синхронизировать статусы доставки со статусами в панели администрирования;
  7. Указать необходимость комплектации вашего заказа при наличии договора “Фулфилмент”.

Если вам нужна помощь при установке или возникли проблемы с работой модуля, для получение поддержки пишите на 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 для получение консультации.




  • No labels