Модули для интернет-магазинов

Подключение магазина InSales к ILFF

Смотрите также: Виджет доставки для корзины · API ILFF · Все модули для CMS

Модуль связывает ваш магазин на InSales с сервисом ILFF:

  • в оформлении заказа появляются наши способы доставки с ценой и картой пунктов выдачи;
  • в карточке товара и корзине показывается стоимость доставки;
  • заказы сами попадают в ILFF, а трек‑номер и статус возвращаются в магазин;
  • остатки, вес и габариты товаров передаются из ILFF в магазин;
  • отмена заказа в магазине отменяет заявку в ILFF.

Подключение занимает 10–15 минут и не требует правок в шаблоне сайта. Понадобятся доступ к админке InSales и к личному кабинету ILFF.

Шаг 1. Ключ API в InSales

  1. В админке InSales откройте Расширения → Разработчикам и создайте ключ доступа. API доступен не на всех тарифах InSales: если раздела нет, уточните тариф в поддержке InSales.
  2. Дайте ключу полный доступ: модулю нужны заказы, товары, способы доставки, статусы заказов, дополнительные поля и скрипты витрины.
  3. Сохраните два значения ключа: Идентификатор и Пароль. Никому их не пересылайте, они вводятся только в личном кабинете.

Шаг 2. Подключение в личном кабинете ILFF

Личный кабинет → вкладка Интеграции → раскройте блок Интернет‑магазин. Первой строкой блока идёт ссылка на эту инструкцию, над полем платформы показаны уже подключённые магазины.

  1. Адрес магазина — технический адрес вида магазин.myinsales.ru. Свой домен не подходит.
  2. Идентификатор ключа API и Пароль ключа API — из шага 1.
  3. Когда забирать заказ — с какого статуса заказ уходит в ILFF:
    • Утверждён (по умолчанию и рекомендуем): заказ уходит, когда вы его подтвердили;
    • Новый: сразу после оформления покупателем;
    • Оплачен: оплаченный или утверждённый;
    • Свой статус магазина: ниже появится список статусов вашего магазина, выберите нужный. Этот вариант доступен после первого подключения: подключите магазин с другим вариантом, затем вернитесь и выберите свой статус.
  4. Флажки:
    • Выгружать остатки — в магазин уходят свободные остатки: остаток на складе ILFF за вычетом резерва и заказов, ещё не загруженных в ILFF;
    • Выгружать вес и габариты — вес и размеры товаров из ILFF записываются в магазин, только по товарам, где они у нас заполнены;
    • Передавать вес и габариты заказа — после сборки и доупаковки в заказ магазина пишутся фактические вес, габариты и число мест;
    • Заказ с несвязанным товаром ждёт привязки — заказ с товаром, который ещё не связан с вашим товаром в ILFF, не загружается, пока вы его не свяжете (шаг 3). Без флажка такой товар создаётся в ILFF новой номенклатурой. Рекомендуем оставить флажок включённым.
  5. Нажмите Подключить. Кабинет проверит ключ, в заголовке блока появится «подключён», и магазин настроится сам:
    • создаст способы доставки «Доставка до двери ILFF» и «Пункты выдачи ILFF»;
    • добавит в заказ поля для трек‑номера, веса и габаритов;
    • установит на витрину блок стоимости доставки в карточке товара и корзине.

Поля ключа после подключения остаются пустыми, так и задумано: сохранённый ключ не показывается. Чтобы поменять только настройки, оставьте их пустыми и нажмите «Подключить».

  1. Раскройте группу Способы оплаты при получении и отметьте способы, которые покупатель оплачивает при получении. Список читается из магазина, кнопка Обновить из магазина перечитывает его. Что это даёт, описано в шаге 4. Изменения сохраняются кнопкой «Подключить».
  2. Раскройте группу Статусы в магазине и проверьте, какие статусы ILFF передаются в магазин. Таблица заполняется при подключении, менять её необязательно:
Статус ILFFСтатус в магазине
Передан в КСОтгружен
Доставлен клиенту, Выдан, Частичная выдачаДоставлен
Отменен, АннулированОтменен
Возврат принят, Полный отказВозврат

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

Шаг 3. Привязка товаров

Кнопка Товары магазина в том же блоке показывает все варианты товаров магазина и их связь с вашими товарами в ILFF. Связь подбирается сначала по штрихкоду, затем по артикулу:

СтатусЧто делать
СвязанНичего, связь сохранена
ПодобранПроверьте и подтвердите
Несколько совпаденийВыберите нужный товар вручную
Не найденВыберите товар вручную или заполните штрихкод/артикул в магазине

Чтобы снять связь, очистите товар в строке. У размеров одной модели артикул часто общий, поэтому заполняйте в магазине штрихкоды.

Если заказ ждёт привязки, вверху вкладки Интеграции появляется плашка с числом таких заказов, а в блоке «Интернет‑магазин» — таблица с заказами и товарами. После привязки заказы загружаются сами.

Шаг 4. Настройки магазина InSales

  1. Способы доставки. Отключите или удалите способы доставки магазина с фиксированной ценой (например, «Курьером» по умолчанию). Иначе покупатель увидит их рядом с нашими, со своей ценой.
  2. Способы оплаты и наложенный платёж. При оформлении покупатель видит цену доставки без комиссии за наложенный платёж: на этом шаге InSales не сообщает нам способ оплаты. В заявку наложка попадает только у способов, отмеченных в личном кабинете как оплата при получении, и только если заказ не оплачен. У остальных способов наложка равна 0, комиссии нет, даже если онлайн‑оплата ещё не пришла. Пока не отмечен ни один способ, наложка определяется по статусу оплаты заказа: неоплаченный заказ с онлайн‑оплатой получит наложку, поэтому блок покажет предупреждение. Чтобы покупатель оплачивал комиссию сам, задайте наценку в настройках способа оплаты в InSales.
  3. Скрытие товаров не в наличии. Если в настройках InSales включено «скрывать товары не в наличии», товары с нулевым остатком на складе ILFF пропадут с витрины после выгрузки остатков. Проверьте эту настройку до включения флажка «Выгружать остатки».
  4. Списание остатков. InSales списывает остаток при создании заказа. Затем остаток магазина выравнивается по фактическому остатку ILFF при следующей выгрузке.
  5. Демо‑товары. InSales сам убирает в архив товары с пометкой «[Пример]», когда вы создаёте первый свой товар.
  6. Пробный заказ. Оформите на сайте заказ и убедитесь, что способы доставки ILFF видны при оформлении и заказ пришёл в ILFF.

Что видит покупатель

  • Доставка до двери ILFF — курьер и Почта России «Курьер онлайн».
  • Пункты выдачи ILFF — пункты и постаматы СДЭК, 5Post и отделения Почты России на одной карте, с подписью «служба · тип: адрес».
  • Цена и срок считаются по весу и габаритам корзины и адресу покупателя.

Как дальше работает обмен

  • Заказы: ILFF регулярно забирает заказы в выбранном статусе. До начала сборки изменения заказа в магазине применяются к заявке. После начала сборки изменения не применяются: плашка и таблица в кабинете покажут такой заказ, свяжитесь с менеджером.
  • Отмена: заказ, отменённый в магазине до начала сборки, отменяет заявку в ILFF. Если заявка уже в работе, она не отменяется сама: решение принимает менеджер.
  • Трек‑номер и статус: трек записывается в заказ магазина, когда появляется у нас. Статус уходит при смене статуса заявки, если он есть в таблице «Статусы в магазине». И то и другое передаётся по расписанию, а не мгновенно.
  • Остатки, вес и габариты: уходят в магазин по расписанию, если включены флажки.

Если что‑то не работает

Сообщение или симптомПричина и решение
«Магазин не принял ключ API»Неверный идентификатор или пароль, либо ключ удалён. Создайте новый ключ и подключите заново
«Магазин не отвечает, проверьте адрес»Указан свой домен или опечатка. Нужен адрес магазин.myinsales.ru
«Этот магазин уже подключён к другому клиенту»Обратитесь к менеджеру
В оформлении нет наших способов доставкиНажмите «Подключить» ещё раз: способы создадутся заново
Заказ не пришёл в ILFFПроверьте статус заказа в магазине и блок «ждут привязки». Заказ должен быть оформлен на сайте с доставкой ILFF: заказ без неё, в том числе созданный через API магазина, не загрузится
«Выберите статус магазина»Выбран «Свой статус магазина», но статус не указан. Выберите его в списке ниже или другой вариант
Статус не меняется в магазинеСтатуса ILFF нет в таблице «Статусы в магазине», либо заявка ещё не дошла до него
Неоплаченный заказ с онлайн‑оплатой получил наложкуНе отмечены способы оплаты при получении (шаг 2, пункт 6)
Товары пропали с витриныВключено «скрывать товары не в наличии», а остаток в ILFF нулевой (шаг 4)

По остальным вопросам обращайтесь к вашему менеджеру ILFF.

WeChat

QR-код WeChat

Отсканируйте QR-код в WeChat · 用微信扫码添加

Перезвоним за пару минут

В рабочее время позвоним сразу, в другое время перезвоним утром. Пн–пт с 11:00 до 20:00.