Подключение магазина на AdvantShop к ILFF
Смотрите также: Виджет доставки для корзины · API ILFF · Все модули для CMS
Магазин на AdvantShop (Альфа-Селлер Профи) подключается к ILFF без модуля на сайте: обмен ведёт ILFF через Management API магазина.
- заказы со способом доставки ILFF сами приходят в ILFF;
- трек-номер и статус заказа возвращаются в магазин, в комментарии к статусу — служба доставки и ссылка отслеживания;
- свободные остатки ILFF передаются в модификации товаров магазина;
- отмена заказа в магазине отменяет заявку в ILFF, если заявка ещё не в работе.
Цену доставки в корзине и выбор пункта выдачи ILFF в AdvantShop сейчас не показывает: стоимость доставки ILFF вы задаёте сами в способе доставки магазина (фиксированная или по зонам). Отправку ILFF подбирает по адресу покупателя.
Нужны:
- права администратора магазина и доступ к личному кабинету ILFF;
- AdvantShop с разделом Management API (Настройки → API, вкладка «API ключи»).
Подключение занимает 10 минут.
Шаг 1. Способ доставки ILFF в магазине
- В админке магазина откройте Настройки → Доставка и добавьте способ доставки, например «Доставка ILFF». Тип — фиксированная стоимость или по зонам, цену укажите свою.
- В названии способа должно быть «ILFF» — по нему ILFF узнаёт свои заказы. Переименовывать способ без «ILFF» нельзя: заказы перестанут приходить.
- Можно вместо названия указать номер (id) способа: он виден в адресе страницы способа, например
…/shippingmethods/edit/7. Если способов ILFF несколько (например, курьер и самовывоз), нужны номера всех.
Шаг 2. Ключ Management API
- Откройте Настройки → API, вкладка API ключи, нажмите Создать ключ.
- Название — например «ILFF», тип — Management API, доступ — к заказам и товарам (или полное управление), срок — бессрочный.
- Скопируйте ключ: он показывается целиком только при создании.
Шаг 3. Подключение в личном кабинете ILFF
Личный кабинет → вкладка Интеграции → раскройте блок Интернет-магазин.
- Платформа — выберите AdvantShop.
- Адрес магазина — адрес сайта или админки, например
shop.ruилиs10.alslr.su/123456-abcd. - Id способа доставки ILFF — оставьте пустым, тогда берутся заказы со способом доставки, в названии которого есть «ILFF». Или укажите номер способа из шага 1 (несколько — через запятую).
- Ключ Management API — ключ из шага 2.
- Флажок Выгружать остатки — передавать свободные остатки ILFF в модификации товаров.
- Флажок Заказ с несвязанным товаром ждёт привязки: если он включён, заказ с товаром, который ещё не связан с вашим товаром в ILFF, не принимается, пока вы его не свяжете (шаг 4). Рекомендуем оставить включённым.
- Нажмите Подключить. Кабинет проверит ключ в магазине и сохранит подключение. Чтобы только изменить настройки, поле ключа можно оставить пустым.
Шаг 4. Связь товаров
Товары магазина ILFF читает сам раз в сутки и связывает модификации с вашими товарами в ILFF по штрихкоду, затем по артикулу модификации. Модификации без пары — в личном кабинете, кнопка Товары магазина в блоке «Интернет-магазин»: выберите для каждой ваш товар и нажмите Привязать.
Как идёт обмен
| Что | Когда |
|---|---|
| Заказы со способом доставки ILFF | каждые несколько минут: новые и изменённые с прошлой загрузки |
| Изменение заказа до сборки | заявка обновляется; после сборки изменения видны в личном кабинете («изменён после сборки») |
| Отмена в магазине (статус с признаком отмены) | заявка отменяется, если ещё не в работе; иначе — свяжитесь с менеджером ILFF |
| Трек-номер | как только служба выдала трек |
| Статус в магазине | передан в службу доставки → «Отправлен», выдан → завершающий статус, отмена, отказ и возврат → статус отмены |
| Остатки | после изменения свободного остатка, только по связанным модификациям |
Статусы магазина ILFF выбирает по справочнику статусов: «Отправлен» — по названию, завершающий и отмены — по признакам статуса. Выполненные в магазине заказы ILFF больше не меняет.
Если что-то не работает
| Сообщение | Что сделать |
|---|---|
| «Магазин не принял ключ API» | Ключ должен быть типа Management API и активен. Создайте новый ключ и подключите заново |
| «У ключа API нет доступа к заказам» | Откройте ключ в магазине и выдайте доступ к заказам и товарам |
| Заказ не пришёл в ILFF | Проверьте, что у заказа выбран способ доставки ILFF (с «ILFF» в названии или с указанным номером), и блок «Интернет-магазин» в кабинете (заказы, ждущие привязки товаров) |
| Остаток в магазине не меняется | Проверьте флажок «Выгружать остатки» и связь модификации с товаром ILFF («Товары магазина») |