Подключение магазина InSales к ILFF
Смотрите также: Виджет доставки для корзины · API ILFF · Все модули для CMS
Модуль связывает ваш магазин на InSales с сервисом ILFF:
- в оформлении заказа появляются наши способы доставки с ценой и картой пунктов выдачи;
- в карточке товара и корзине показывается стоимость доставки;
- заказы сами попадают в ILFF, а трек‑номер и статус возвращаются в магазин;
- остатки, вес и габариты товаров передаются из ILFF в магазин;
- отмена заказа в магазине отменяет заявку в ILFF.
Подключение занимает 10–15 минут и не требует правок в шаблоне сайта. Понадобятся доступ к админке InSales и к личному кабинету ILFF.
Шаг 1. Ключ API в InSales
- В админке InSales откройте Расширения → Разработчикам и создайте ключ доступа. API доступен не на всех тарифах InSales: если раздела нет, уточните тариф в поддержке InSales.
- Дайте ключу полный доступ: модулю нужны заказы, товары, способы доставки, статусы заказов, дополнительные поля и скрипты витрины.
- Сохраните два значения ключа: Идентификатор и Пароль. Никому их не пересылайте, они вводятся только в личном кабинете.
Шаг 2. Подключение в личном кабинете ILFF
Личный кабинет → вкладка Интеграции → раскройте блок Интернет‑магазин. Первой строкой блока идёт ссылка на эту инструкцию, над полем платформы показаны уже подключённые магазины.
- Адрес магазина — технический адрес вида
магазин.myinsales.ru. Свой домен не подходит. - Идентификатор ключа API и Пароль ключа API — из шага 1.
- Когда забирать заказ — с какого статуса заказ уходит в ILFF:
- Утверждён (по умолчанию и рекомендуем): заказ уходит, когда вы его подтвердили;
- Новый: сразу после оформления покупателем;
- Оплачен: оплаченный или утверждённый;
- Свой статус магазина: ниже появится список статусов вашего магазина, выберите нужный. Этот вариант доступен после первого подключения: подключите магазин с другим вариантом, затем вернитесь и выберите свой статус.
- Флажки:
- Выгружать остатки — в магазин уходят свободные остатки: остаток на складе ILFF за вычетом резерва и заказов, ещё не загруженных в ILFF;
- Выгружать вес и габариты — вес и размеры товаров из ILFF записываются в магазин, только по товарам, где они у нас заполнены;
- Передавать вес и габариты заказа — после сборки и доупаковки в заказ магазина пишутся фактические вес, габариты и число мест;
- Заказ с несвязанным товаром ждёт привязки — заказ с товаром, который ещё не связан с вашим товаром в ILFF, не загружается, пока вы его не свяжете (шаг 3). Без флажка такой товар создаётся в ILFF новой номенклатурой. Рекомендуем оставить флажок включённым.
- Нажмите Подключить. Кабинет проверит ключ, в заголовке блока появится «подключён», и магазин настроится сам:
- создаст способы доставки «Доставка до двери ILFF» и «Пункты выдачи ILFF»;
- добавит в заказ поля для трек‑номера, веса и габаритов;
- установит на витрину блок стоимости доставки в карточке товара и корзине.
Поля ключа после подключения остаются пустыми, так и задумано: сохранённый ключ не показывается. Чтобы поменять только настройки, оставьте их пустыми и нажмите «Подключить».
- Раскройте группу Способы оплаты при получении и отметьте способы, которые покупатель оплачивает при получении. Список читается из магазина, кнопка Обновить из магазина перечитывает его. Что это даёт, описано в шаге 4. Изменения сохраняются кнопкой «Подключить».
- Раскройте группу Статусы в магазине и проверьте, какие статусы ILFF передаются в магазин. Таблица заполняется при подключении, менять её необязательно:
| Статус ILFF | Статус в магазине |
|---|---|
| Передан в КС | Отгружен |
| Доставлен клиенту, Выдан, Частичная выдача | Доставлен |
| Отменен, Аннулирован | Отменен |
| Возврат принят, Полный отказ | Возврат |
Остальные статусы в магазин не передаются. Можно добавить строку или выбрать другой статус магазина, в том числе свой: кнопка «Обновить из магазина» добавит свои статусы в выбор.
Шаг 3. Привязка товаров
Кнопка Товары магазина в том же блоке показывает все варианты товаров магазина и их связь с вашими товарами в ILFF. Связь подбирается сначала по штрихкоду, затем по артикулу:
| Статус | Что делать |
|---|---|
| Связан | Ничего, связь сохранена |
| Подобран | Проверьте и подтвердите |
| Несколько совпадений | Выберите нужный товар вручную |
| Не найден | Выберите товар вручную или заполните штрихкод/артикул в магазине |
Чтобы снять связь, очистите товар в строке. У размеров одной модели артикул часто общий, поэтому заполняйте в магазине штрихкоды.
Если заказ ждёт привязки, вверху вкладки Интеграции появляется плашка с числом таких заказов, а в блоке «Интернет‑магазин» — таблица с заказами и товарами. После привязки заказы загружаются сами.
Шаг 4. Настройки магазина InSales
- Способы доставки. Отключите или удалите способы доставки магазина с фиксированной ценой (например, «Курьером» по умолчанию). Иначе покупатель увидит их рядом с нашими, со своей ценой.
- Способы оплаты и наложенный платёж. При оформлении покупатель видит цену доставки без комиссии за наложенный платёж: на этом шаге InSales не сообщает нам способ оплаты. В заявку наложка попадает только у способов, отмеченных в личном кабинете как оплата при получении, и только если заказ не оплачен. У остальных способов наложка равна 0, комиссии нет, даже если онлайн‑оплата ещё не пришла. Пока не отмечен ни один способ, наложка определяется по статусу оплаты заказа: неоплаченный заказ с онлайн‑оплатой получит наложку, поэтому блок покажет предупреждение. Чтобы покупатель оплачивал комиссию сам, задайте наценку в настройках способа оплаты в InSales.
- Скрытие товаров не в наличии. Если в настройках InSales включено «скрывать товары не в наличии», товары с нулевым остатком на складе ILFF пропадут с витрины после выгрузки остатков. Проверьте эту настройку до включения флажка «Выгружать остатки».
- Списание остатков. InSales списывает остаток при создании заказа. Затем остаток магазина выравнивается по фактическому остатку ILFF при следующей выгрузке.
- Демо‑товары. InSales сам убирает в архив товары с пометкой «[Пример]», когда вы создаёте первый свой товар.
- Пробный заказ. Оформите на сайте заказ и убедитесь, что способы доставки ILFF видны при оформлении и заказ пришёл в ILFF.
Что видит покупатель
- Доставка до двери ILFF — курьер и Почта России «Курьер онлайн».
- Пункты выдачи ILFF — пункты и постаматы СДЭК, 5Post и отделения Почты России на одной карте, с подписью «служба · тип: адрес».
- Цена и срок считаются по весу и габаритам корзины и адресу покупателя.
Как дальше работает обмен
- Заказы: ILFF регулярно забирает заказы в выбранном статусе. До начала сборки изменения заказа в магазине применяются к заявке. После начала сборки изменения не применяются: плашка и таблица в кабинете покажут такой заказ, свяжитесь с менеджером.
- Отмена: заказ, отменённый в магазине до начала сборки, отменяет заявку в ILFF. Если заявка уже в работе, она не отменяется сама: решение принимает менеджер.
- Трек‑номер и статус: трек записывается в заказ магазина, когда появляется у нас. Статус уходит при смене статуса заявки, если он есть в таблице «Статусы в магазине». И то и другое передаётся по расписанию, а не мгновенно.
- Остатки, вес и габариты: уходят в магазин по расписанию, если включены флажки.
Если что‑то не работает
| Сообщение или симптом | Причина и решение |
|---|---|
| «Магазин не принял ключ API» | Неверный идентификатор или пароль, либо ключ удалён. Создайте новый ключ и подключите заново |
| «Магазин не отвечает, проверьте адрес» | Указан свой домен или опечатка. Нужен адрес магазин.myinsales.ru |
| «Этот магазин уже подключён к другому клиенту» | Обратитесь к менеджеру |
| В оформлении нет наших способов доставки | Нажмите «Подключить» ещё раз: способы создадутся заново |
| Заказ не пришёл в ILFF | Проверьте статус заказа в магазине и блок «ждут привязки». Заказ должен быть оформлен на сайте с доставкой ILFF: заказ без неё, в том числе созданный через API магазина, не загрузится |
| «Выберите статус магазина» | Выбран «Свой статус магазина», но статус не указан. Выберите его в списке ниже или другой вариант |
| Статус не меняется в магазине | Статуса ILFF нет в таблице «Статусы в магазине», либо заявка ещё не дошла до него |
| Неоплаченный заказ с онлайн‑оплатой получил наложку | Не отмечены способы оплаты при получении (шаг 2, пункт 6) |
| Товары пропали с витрины | Включено «скрывать товары не в наличии», а остаток в ILFF нулевой (шаг 4) |
По остальным вопросам обращайтесь к вашему менеджеру ILFF.