Подключение amoCRM к ILFF
Смотрите также: Виджет доставки для корзины · API ILFF · Все модули для CMS
Обмен работает через приватную интеграцию amoCRM и долгосрочный токен. Публично публиковать интеграцию не нужно.
Что делает ILFF:
- забирает сделки выбранного этапа и создаёт или обновляет заявки на доставку;
- записывает в сделку статус, трек-номер и ссылку отслеживания, при настройке меняет этап и добавляет примечание;
- отменяет заявку при переходе сделки в Закрыто и не реализовано, если сборка ещё не началась;
- синхронизирует товары и связывает их с номенклатурой ILFF по артикулу, затем по штрихкоду.
В текущей версии остатки в amoCRM не выгружаются.
Пункт личного кабинета ILFF для подключения называется amoCRM. Он появится после включения этой платформы в вашем аккаунте.
Шаг 1. Приватная интеграция
- Войдите в amoCRM с правами администратора.
- Откройте Настройки → Интеграции → Создать интеграцию и создайте приватную интеграцию.
- Выдайте ей право Доступ к данным аккаунта. Оно нужно для чтения сделок, контактов и товаров, а также для записи состояния заказов и создания полей ILFF.
Важно: для приватных интеграций amoCRM не оказывает техническую поддержку по ошибкам системы. При подключении потребуется заявление об отказе от такой поддержки. Консультации и помощь с вопросами оплаты остаются доступны.
Шаг 2. Долгосрочный токен
- Откройте созданную интеграцию и перейдите на вкладку Ключи (Keys and scopes).
- Нажмите Сгенерировать токен и выберите срок действия. Рекомендуемый срок — 1 год.
- Сразу сохраните токен в защищённом хранилище: позже amoCRM не покажет его повторно. Не пересылайте токен в открытом виде и не храните его в документах.
Автоматического продления у долгосрочного токена нет. Когда срок закончится, создайте новый токен в этой интеграции и замените старый в разделе amoCRM личного кабинета ILFF.
Шаг 3. Подключение и этап сделок
- Узнайте полный адрес своего аккаунта:
https://<поддомен>.amocrm.ru. - В личном кабинете ILFF откройте amoCRM и укажите адрес аккаунта и долгосрочный токен.
- Выберите воронку или конкретный этап, из которого ILFF должен забирать сделки. Если ничего не выбрано, используется первый рабочий этап основной воронки. Если выбрана воронка без этапа — её первый рабочий этап.
- Этап Неразобранное для обмена не подходит. Выберите этап, на котором сделка уже содержит данные, необходимые для доставки.
При подключении ILFF сам создаст недостающие поля сделки:
- Трек ILFF;
- Ссылка отслеживания ILFF;
- Статус ILFF.
Создавать эти поля вручную не нужно.
Шаг 4. Товары
- В настройках amoCRM откройте Списки и включите каталог Товары.
- Заполните в карточках товаров артикул и цену. Для связи по штрихкоду ILFF найдёт существующее поле Штрихкод, ШК или Barcode либо создаст поле Штрихкод автоматически.
- Добавляйте в сделки позиции из каталога Товары и указывайте целое количество.
ILFF сначала ищет соответствие по артикулу, затем по штрихкоду. Если однозначно связать товар не удалось, он останется в списке для ручной привязки в личном кабинете.
Как оформить сделку для ILFF
- Заполните главный контакт, имя получателя и телефон.
- Укажите адрес в поле контакта типа Адрес. Город обязателен. Вместо него можно использовать текстовое поле Адрес. Поле может быть заполнено в сделке или в её главном контакте.
- Добавьте товарные позиции из каталога и проверьте их количество.
- Укажите бюджет сделки. Он становится суммой заказа и наложенным платежом. Цены строк рассчитываются по ценам из карточек товаров.
- Переведите сделку в выбранный для ILFF этап.
Если адрес или товары не заполнены либо товар не связан с номенклатурой, заявка не создаётся. Сделка появится в списке ожидающих данных с причиной.
Статусы и отмена
ILFF записывает состояние заявки в поля Статус ILFF, Трек ILFF и Ссылка отслеживания ILFF. При реальном изменении состояния добавляется примечание к сделке; этап меняется, если такое соответствие настроено.
Чтобы отменить заказ, переведите сделку в этап Закрыто и не реализовано до начала сборки. Удаление сделки также отменяет связанную заявку. Если сборка уже началась, согласуйте отмену с ILFF.
Если что-то не работает
- Токен истёк или отозван — создайте новый долгосрочный токен и замените его в разделе amoCRM личного кабинета ILFF.
- Не созданы поля ILFF — проверьте право Доступ к данным аккаунта и права администратора у пользователя, который создавал интеграцию, затем повторите подключение.
- Сделка не пришла — проверьте этап, главный контакт, адрес с городом и товарные позиции, а также список ожидающих данных в личном кабинете.
- Товар не связан — проверьте артикул и штрихкод в карточке товара или свяжите его вручную в личном кабинете.
- Не найден каталог товаров — включите каталог Товары в Списках amoCRM и повторите подключение.