«AmoCRM — интеграция с интернет-магазинами» от разработчика «Павел Шулаев»

Быстрый старт

1. Установка
   
2. Создание интеграции в amoCRM для сайта
   
3. Создание подключения к amoCRM
   
4. Подключение к интеграции амоСРМ
   
5. Создание и настройка профиля интеграции заказов
   
6. Создание и настройка профиля интеграции корзин
   
7. Создание и настройка профиля интеграции товаров
   

Полная документация по модулю


Установка на кастомизированный сайт

Работоспособность модуля гарантируется при установке на стандартный коробочный Битрикс версии 18 и выше.

При установке модуля на модифицированные сайты (сайты, логика работы которых отличается от коробочной логики 1С-Битрикс), может потребоваться дополнительная настройка и/или доработка. Такая услуга не входит в поддержку модуля и осуществляется на платной основе.


Требования

• тариф amoCRM с не истёкшей подпиской, либо демо-периодом
  
• «Главный модуль» Bitrix 18.0.2 и выше
  
• модуль «Интернет-магазин» 17.8.22 и выше;
  
• работа сайта на https;
  
• расширение php-curl;
  
• расширение php iconv;
  
• php 7.4.0 или выше.
  

— добавлена возможность создавать задачи в амоСРМ
— улучшена поддержка английского языка
— прочие мелкие правки— товары с амо теперь синхронизируются по идентификатору и цене. При изменении цены товара в магазине, в амо будет создан новый товар. — удалены устаревшие настройки "Тип цены для товаров в заказе, созданных из сделки" и "Тип цены для новых товаров в корзине". Для более стабильной работы обновляемым из амо товарам в корзине будет ставиться признак кастомной цены — добавлена поддержка кастомного поля амо "день рождения" — удалены некоторые методы, долгое время помеченные как устаревшие— добавлена передача остатков по складам для товаров
— добавлены дополнительные проверки безопасности
— прекращена поддержка php 7.4 и 8.0. Минимальная поддерживая версия 8.1
— добавлены дополнительные проверки при замене плейсхолдеров— в профиль интерации заказо добавлено новое поле «Состав заказа (со ссылками на товары)»
— добавлена возможноть выгружать только корзины авторизованных пользователей (с ФИО покупателя)
— добавлены дополнительные проверки безопасности
— улучшен перевод на английский язык— исправлены мелкие ошибки и неточности
— повышена стабильность работы модуля— восстановлен маппинг полей систем статистики для сделок
— исправлена неточность, из-за которой мог неправильно определяться домен заказа при определенных настройках сервера— добавлена обратная синхронизация кастомных полей сделок, контактов и компаний со свойствами заказа
— перегруппированы настройки профилей интеграции заказов и корзин
— исправлена ошибка "Argument 'EDIT_FORM_LABEL' is null or empty", иногда возникавшая при установке
— исправлена ошибка из-за которой в амо передавались не все поля— значительно дополнен перевод на английский язык
— исправлена ошибка, возникавшая при поиске дублей через api-фильтрации
— исправлены иногда возникающие ошибки при установке
— рефакторинг
— прочие улучшения и исправления— незначительные исправления— добавлен новый бесплатный метод для поиска дублей «Решение /ufee/amoapi». Выбрать метод можно в настройках модуля на вкладке «Дополнительные настройки» -> «Способ поиска дублей». Метод включен по умолчанию для новых установок. Для старых при необходимости надо переключить вручную. Больше никаких действий не требуется. Поиск дублей на основе api фильтрации также по прежнему работает
— восстановлена совместимость с обработчиками событий модуля, написанных до версии 2.3.1
— обновлены библиотеки связи с амоСРМ— добавлена возможность передачи обычный и пользовательский полей пользователя, который создал заказ
— настройки меток систем статистики вынесены на отдельную вкладку
— улучшена поддержка английского языка
— добавлена дополнительная проверка существования ответственного, создателя и обновившего при сохранении сущности
— прочие незначительные улучшения
— исправлены мелкие неточности— в профиль интеграции заказов добавлен фильтр по доменам сайта
— восстановлена обратная синхронизация товаров. Теперь она работает только если включена передача товаров из заказа в сделку, во избежание затираний состава заказа
— улучшена поддержка английского языка
— исправлено поочередное переключение ответственных, если в профиле интеграции их указано несколько.
— исправлена иногда возникающая ошибка "Class "Illuminate\Support\Collection" not found"
— исправлены прочие найденные ошибки и неточности
— рефакторинг— добавлена возможность отменять перезапись выбранных полей в амо при обновлении заказа в магазине
— настройка "Не создавать примечания, если они уже существуют" перенесена на страницу маппинга, туда же, где теперь настраивается возможность обновления полей
— исправлена ошибка, из-за которой могли не удаляться профили интеграции
— обработка изменений товаров в сделке временно отключена, т.к. в этом месте обнаружены ошибки, способные обнулить заказ на сайте
— рефакторинг— исправлен список возможных значений для кастомного поля типа "список"
— исправлено не всегда корректно отрабатывающее обновление статуса сделки в зависимости от флага заказа
— исправлена ошибка, при которой не осуществлялась синхронизация статусов сделок со статусами заказа, если в аккаунте амо были выключены товары
— исправлены прочие найденные ошибки— в административной части модуля добавлены новые системные настройки
— улучшена поддержка английского языка
— исправлена ошибка поиска дубликатов, которая возникала, если юзера, который обновил дубликат, уже нет в амо
— исправлена ошибка поиска дубликатов, которая возникала, если ответственного за дубликат уже нет в амо
— исправлена ошибка, когда у найденного дубля в амо были задвоены поля
— исправлена ошибка, визникавшая при поиске дубликатов
— исправлены прочие найденные ошибки и неточности— переработан внешний вид окна вставки плейсхолдеров
— улучшена поддержка сайтов в однобайтный кодировках
— исправлена ошибка поиска дубликатов, из-за которой при обновлении сущности на сайте мог смениться ответственный у связанных сущностей в амо
— исправлена ошибка, иногда возникавшая при установке— Исправлена ошибка совместимости в главным модулем версии 23.600.0 и выше
— Исправлена ошибка, возникавшая если создатель дубликата уже отсуствует в аккаунте амоСРМ
— Исправлена ошибка, из-за котрой мог не пробрасываться отвественный из дубликата
— исправлена ошибка, иногда возникавшая при установке
— улучшена поддержка английского языка
— исправлены мелки ошибки и неточности— добавлена настройка "Обновить ответственного пользователя дубля"
— добавлено назначение ответственного сделке из найденного дубля контакта/компании
— добавлена передача названия основного раздела для товаров
— исправлена ошибка, из-за которой при обновлении дублей, кастомные поля, которых не было в оригинале, затирались
— исправлена ошибка, возникавшая при поиске дублей сделок при активном фильтре по статусам
— исправлены найденные ошибки и неточности— Добавлен контроль дублей со стороны модуля (требуется подключение платного API фильтрации со стороны amoCRM)
— Добавлена передача разных типов цен у товаров
— Добавлена возможность указывать тип цены, с которой будут добавлены товары из амо в заказ/корзину
— Улучшена поддержка английского языка
— Исправлена ошибка, если в группу товара передавалось значение из множественного свойства
— Исправлена ошибка, из-за которой могли не выгружаться товары в амо при создании/обновлении товара в каталоге сайта
— Исправлена ошибка, иногда возникающая при установке— Добавлен расчет скидок при обновлении коризны из Амо
— при добавлении товара со скидкой (через заказ или корзину) будет создаваться новый товар в каталоге амо, а не обновляться существующий
— Удалён Highload-блок "AmoSale: Корзины", т.к. кго функционал был перенесен в Highload-блок "AmoSale: Связи"
— Улучшена поддержка английсткого языка
— Исправлены ошибки при установке
— Исправлены прочие найденные ошибки— Добавлена синхроизация товаров из сделки с забытой корзиной
— Исправлена ошибка, из-за которой мог зацикливаться экспорт забытых корзин
— Исправлена ошибка, из-за которой мог не ставиться правильный статус сделок при экспорте заказов
— Исправлены прочие найденные ошибки и неточности
— Улучшена поддержка английского языка— Добавлена интеграция с забытыми корзинами
— Добавлен список корзин профиля интеграции с возможностью полного или частичного экспорта в амоСРМ
— Переработаны настройки профилей заказов
— Возможность выгрузки всех заказов перенесена из настроек профиля интеграции в список заказов (добавлена галочка "для всех")
— Добавлена передача веса для заказа
— Удалена часть методов, давно помеченных как устаревшие
— Исправлены найденные ошибки
— Улучшена стабильность работы модуля— исправлена ошибка при создании профиля интеграции заказов
— исправлена ошибка при сохранении профилей интеграции
— исправлены ошибки при установке— исправлена ошибка совместимости в ядром Битрикс версии 23.300.100 и выше
— исправлены другие найденные ошибки
— обновлены зависимости— исправлена ошибка, из за которой при массовом экспорте заказов сделки создавались с одним и тем же названием (и могли дублироваться другие значения полей
— исправлены прочие найденные ошибки и несточности
— рефакторингПрофили интеграции были разделены на профили интеграции заказов и профили интеграции товаров (подробнее в документации на сайте https://rover-it.me/):
— Настройки синхронизации, экспорта и маппинг полей товаров перенесены в профили интеграции товаров.
— Прежние профили интеграции теперь отвечают только за заказы.
— После обновления на основе уже существующих профилей интеграции будут автоматически созданы профили интеграции товаров, никаких дополнительных действий не требуется.ТЕХНИЧЕСКОЕ ОБНОВЛЕНИЕ, необходимое для продолжения развития модуля. ЧИТАЙТЕ ОПИСАНИЕ.

После этого обновления у профилей интеграции останется привязка только к одному сайту:

Если у профиля на вкладке "Общие параметры" в разделе "Фильтр заказов" была привязка только к одному сайту, то с ним ничего не произойдёт.

Если была привязка к нескольким сайтам, то создадутся дубликаты профиля для каждого из этих сайтов

Если вообще не было привязки к сайтам, то создадутся дубликаты профиля для КАЖДОГО сайта ядра.

Поэтому, перед установкой этого обновления, во избежание появления большого количества дублей, РЕКОМЕНДУЕТСЯ у профилей интеграции оставить привязки только к необходимым сайтам.— добавлена поддержка пользовательских полей заказа (в основном, используются в СРМ)
— расширена структура левого меню
— небольшие изменения в структуре настроек профиля интеграции
— обновлены зависимости
— указание одного сайта при создании профиля интеграции сделано обязательным. Старые профили будут работать по прежнему, но при их обновлении также надо будет указать хотя бы один сайт.
— из настроек профиля интеграции убрана галочка "Контролировать дубли", т.к. эта возможность была отключена со стороны амоСРМ для сторонних интеграций
— исправлена ошибка, когда не обновлялся статус сделки при обновлении заказа, если обновление полей сделки было выключено.
— исправлены прочие найденные ошибки— исправлены найденные ошибки совместимости с php 8 и php 8.1— исправлены найденные ошибки совместимости с php 8 и php 8.1
— исправлены другие найденные ошибки
— рефакторинг— для лучшей совместимости добавлена возможность отключать дополнительные js-скрипты
— рефакторинг— добавлена возможность редактировать и удалять подключения в списке
— расширены права на доступ: добавлено чтение и редактирование только профилей интеграции и подключений
— исправлены найденные ошибки— добавлена возможность передавать поля и свойства торговых предложений в товары — в полях и свойствах элементов теперь передаются значения именно из элементов (а не из предложений, если товар был предложением). Таким образом можно, например, настроить передачу картинок в товар из предложения, а описания — из основного элемента.— добавлены новые события на создание сущностей amo со стороны сайта (см. документацию https://rover-it.me/knowledge/course/course3/chapter096/)
— добавлена поддержка кастомных полей типа "Файл" (можно прикрепить уже существующие в amoCRM файлы по uuid)
— при передаче полей "Картинка для анонса", "Детальная картинка" и свойств типа "файл" теперь передается ссылка на файл
— при передаче в кастомное поле типа "ссылка", в качестве значения теперь берется первая ссылка из переданного значения
— обновлена версия sdk связи с amocrm до 0.12.3
— исправлены найденные ошибки— добавлена синхронизация товаров амоСРМ -> магазин
— рефакторинг
— исправление мелких ошибок и неточностей— добавлено управление правами доступа к модулю
— исправлены ошибки, иногда возникающие при установке и удалении
— исправлены ошибки синхронизации флагов отгрузки
— исправлены прочие ошибки
— рефакторинг— Добавлена синхронизация по флагам и статусам первой отгрузки
— исправлена синхронизация по флагам заказа
— рефакторинг— исправлена ошибка при обработке кастомных полей
— исправлено обрезание состава заказа
— исправлены ошибки, иногда возникающие при установке— добавлена возможность поиска при добавлении полей в маппинге, а также в фильтре заказов и списке ответственных
— перегруппированы поля в маппинге: добавлены группы "Заказ", "Доставка", "Оплата". Удалены — "Дополнительные поля заказа" и "Поля заказа"
— в маппинг добавлено множество новых полей для доставки и оплаты
— добавлена поддержка поля "Адрес" амоСРМ
— расширены сообщения об ошибках
— обновлены значения по умолчанию при создании нового профиля
— в настройках профиля интеграции раздел "Фильтр заказов" перенесен на вкладку "Общие параметры"
— улучшена работа в кодировке windows-1251
— исправлены найденные ошибки
— рефакторинг— добавлена возможность удаления заказа при удалении соответствующей сделки
— исправлены счетчики событий в работе/новых/зависших/ошибочных
— версия sdk для связи с amoCRM повышена до 0.7.2— возможность добавлять собственные поля для передачи в амо. Подробнее в документации https://rover-it.me/knowledge/course/course3/lesson129/— добавлена передача скидочного купона и примененных скидок
— при создании нового профиля интеграции по умолчанию включены создание сделки и контакта, а также обработка создания/обновления заказа
— исправлена ошибка, из-за которой не передавались числовые метки систем статистики
— исправлена ошибка, из-за которой не экспортировались заказы, если в амо были отключены товары
— исправлена ошибка, из-за которой могла не срабатывать ручная обработка событий
— обновлён SDK для связи с AmoCRM— добавлены кастомные поля заказа: "источник заказа", "идентификатор отправления", "номер документа отгрузки", "дата документа отгрузки"
— в маппинг статусов добавлены флаги "оплачен", "отгружен", "отменен", "проблема с заказом", "внешний заказ"
— добавлены события beforeAddComplex и afterAddComplex, позволяющие модифицировать данные при добавлении сделки в режиме поиска дубликатов
— добавлены события beforeSaveAmoEntity и afterSaveAmoEntity, позволяющие модифицировать данные при добавлении/обновлении сущности, если режим поиска дубликатов отключен
— исправлено изменение бюджета сделки при прикреплении к ней товаров
— исправлены другие найденные мелкие ошибки и недочеты— добавлена поддержка покупателей и покупок. Покупатель привязывается к пользователю сайта, покупка — к заказу
— добавлено доп. поле заказа "имя покупателя", в котором передаётся имя пользователя Битрикс, оформившего заказ
— добавлена автоочистка таблицы событий
— количество повторных попыток обработки ошибочных событий ограничено тремя
— восстановлен интерфейс работы со списком заказов при новой установке
— исправлены прочие найденные ошибки— снято ограничение в 50 кастомных полей у сущности
— на страницу просмотра заказов профиля добавлены массовый экспорт и фильтр
— добавлено обновление товара в амо при обновлении цены в магазине
— добавлена возможность отключить обновление раздела при обновлении товара
— исправлена обработка цен, если там есть посторонние символы
— исправлена работа хлебных крошек в админке
— исправлены незначительные ошибки— добавлена ajax-выгрузка всех заказов и товаров, без агентов
— добавлена повторная обработка всех успешных/ошибочных событий через ajax, без агентов
— добавлены значения по-умолчанию для маппинга товаров
— рефакторинг— добавлен фильтр заказов по статусам. Теперь в амо можно создать сделку, когда заказ магазине достигнет определенного статуса
— добавлена форма для просмотра заказов профиля интеграции
— добавлена поддержка описания значений свойств (поле DESCRIPTION) для товаров амо
— исправлена возможность отключения товаров и visitor_uid для сделки
— оптимизирована работа при большом кол-ве свойств, добавляемых в название товара из торгового предложения
— исправлена ошибка при передаче значений множественных свойств в товары амо
— прочие незначительные доработки и правки— добавлена массовая выгрузка заказов
— в маппинг товаров добавлены свойства элементов типа строка, число, список и справочник
— добавлена синхронизация статусов при массовом изменении статусов сделок в амо
— оптимизирована обработка событий интернет-магазина и амо
— исправлена синхронизация свойства заказа типа "мультисписок" с кастомным полем амо такого же типа
— исправлена ошибка маппинга полей товаров, если каталогов больше одного
— исправлена ошибка, из-за которой не передавались товары без торговых предложений
— исправлена синхронизация по статусам заказ — сделка.— маппинг полей товаров каталога теперь применяется и для товаров из корзины
— метки статистки теперь добавляются только при создании нового заказа и больше не обновляются
— добавлены системные события beforeFindEventProfiles и afterFindEventProfiles позволяющие кастомизировать поиск подходящих профилей интеграции при обработке события
— добавлено новое поле в маппинг полей заказа: ссылка на заказ
— исправлены найденные ошибки в экспорте товаров из каталога
— восстановлены названия полей товаров в маппинге
— рефакторинг— добавлена корректная передача свойств заказа типа "Список" и "Файл"
— добавлено дополнительное поле "Город доставки". В нём передается только город, без страны и региона
— добавлено выставление меток статистки по умолчанию при создании профиля интеграции
— настройка "связанные сущности amoCRM" в профиле интеграции сделана необязательной. Если она не заполнена, будет выведено предупреждение
— настройки "Сайты" и "Типы плательщиков" сделаны не обязательными. Если они не выбраны, то профиль применяется ко всем сайтам или всем типам плательщиков соответственно
— исправлена выгрузка названий свойств товара
— исправлена передача меток статистики
— исправлено дублирование сделок при обновлении заказа
— исправлена синхронизация статусов сделок и заказов— добавлена синхронизация каталога магазина с товарами амоСРМ
— добавлен полный экспорт всего каталога в амоСРМ
— добавлены группы кастомных полей в профиле интеграции
— добавлена кнопка перезапуска агентов
— исправлено удаление тегов из текстовых полей
— исправлены ошибки и неточности при синхронизации по статусам
— исправлены прочие ошибки
— рефакторинг— добавлен поиск дублей.
— улучшена совместимость со старыми версиями Главного модуля
— в маппинг добавлены поля: стоимость без доставки, стоимость доставки, валюта, название платежной системы, название службы доставки
— добавлены значения по умолчанию для сделки в новом профиле интеграции: название, бюджет, состав заказа и комментарий пользователя
— поле "Список ответственных" в профиле сделано необязательным. Если оно не заполнено, ставится ответственный из амо по умолчанию
— исправлены ошибки— добавлена поддержка полей меток систем статистики в амо (tracking_data)
— добавлена возможность редактировать из админки список доступных меток систем статистики
— расширен доступный по-умолчанию список меток систем статистики
— добавлена возможность использовать плейсхолдеры для своих значений в маппнге полей
— переработано добавление профилей интеграции
— переработан интерфейс настроек профиля интеграции, настройки сгруппированы по действиям
— при создании заказа добавлена возможность добавления visitor_uid к сделке. Это позволяет отслеживать посетителя в автоворонках. https://www.amocrm.ru/developers/content/digital_pipeline/site_visit
— исправлена ошибка, из-за которой иногда могли дублироваться товары в сделке при обновлении заказа
— исправлены другие найденные ошибки
— обновлено SDK для связи с amoCRM— добавлена возможность передавать товары как сущности при создании и обновлении заказа
— передача названия местоположения вместо кода в свойстве заказа типа "Местоположение"
— исправления для сайтов в однобайтных кодировках (windows-1251 и т.п.)
— исправлены найденные ошибки