Требования окружения:
- PHP 8.1, 8.2 (PHPstan уровень 5. При разработке уровень 9)
- Bitrix24 последней актуальной версии (релиз модуля на версии 26.600.0)
- Агенты Битрикса работают на cron (https://docs.despi.ru/all-modules/agents/)
Первый запуск модуля
После установки модуля он появится в левой панели "Решения Despi" -> "МойСклад: Интеграция с Битрикс24"
При первом открытии модуля автоматически запускается мастер инициализации, который выполнит подготовку за вас тремя шагами:
1. Установка таблиц модуля в базе данных — создаются служебные таблицы.
2. Регистрация обработчиков событий Битрикс — модуль подписывается на события создания и обновления CRM сущностей.
Каждый шаг отображается в мастере, при ошибке шаг можно повторить — уже выполненные шаги пропускаются. По завершении мастер сам перебросит вас в настройки.
Если таблицы модуля уже были созданы ранее (например, после переустановки), мастер аккуратно пропустит первый шаг и завершит подписку на события — существующие данные не пострадают.
Сразу инициализации модуля вас встретит окно авторизации в МойСклад, там же будет инструкция какие данные нужно вводить для этого. После успешной авторизации откроются настройки модуля.
Начать настройку можно с раздела "Документация" там будут указаны конкретные шаги по настройке модуля.
Обмен между Битрикс24 и МойСклад
Модуль связывает Битрикс24 и МойСклад и обменивает данные между ними в обе стороны.
Менеджер работает в любой из систем, данные передаются в другую.
Что с чем обменивается
- Сделка ⇄ Заказ покупателя — продажи клиентам.
- Сделка ⇄ Заказ поставщику — закупки. Настраивается отдельно от продаж, можно включить только один из документов.
- Контакт или компания ⇄ Контрагент — физлицо, ИП и юрлицо настраиваются каждый по-своему.
- Товары сделки ⇄ Позиции заказа — количество, цена, скидка, ставка НДС, единица измерения.
- Стадия сделки ⇄ Статус документа — стадии и статусы связываются парами, поддерживаются несколько воронок.
- Ответственный и валюта — сотрудник Битрикс24 связывается с сотрудником МойСклад, валюта с валютой.
Направление обмена
Для каждого блока — и даже для каждой пары полей — выбирается своё направление: в обе стороны, только в МойСклад, только в Битрикс24 или не обменивать вовсе.
Так можно оставить источником истины ту систему, где данные ведутся на самом деле.
Что настраивается
- Поля. Поддерживаются стандартные и пользовательские поля сделки, контакта и компании, а также поля и дополнительные поля документов и контрагентов МойСклад. Какое поле с каким связать — решаете вы.
- Поиск существующих записей. Вы сами задаёте поля, по которым модуль ищет уже созданный заказ или контрагента (например, по ИНН). Благодаря этому не появляются дубли, а если Битрикс24 и МойСклад у вас уже как-то связаны, обмен подхватит текущую связку.
- Значения по умолчанию. Организацию, склад, владельца и другие поля можно не брать из CRM, а задать постоянным значением — при создании документа и/или при обновлении.
- Фильтры. В обмен попадает только то, что подходит под ваши условия: например, заказы с даты запуска интеграции — старый архив останется на месте.
- Справочники. Ответственные, валюты, единицы измерения, ставки НДС.
Товары в документах
По каждой позиции модуль ищет товар в каталоге второй системы по выбранному вами полю, а если не находит — создаёт его в указанном разделе каталога Битрикс24 или группе товаров МойСклад.
Заказ уезжает целиком с первого раза, номенклатуру не нужно готовить заранее.
Поддерживаются товары, услуги, комплекты и торговые предложения с характеристиками.
Как идёт обмен
Обмен работает через очередь. Сохранение сделки не заставляет менеджера ждать: модуль ставит задачу и отпускает форму.
Несколько правок подряд схлопываются в одну задачу — в МойСклад уедет итоговое состояние сделки.
При ошибке задача повторяется, а не теряется, и любую задачу можно открыть и запустить вручную.
Отдельная страница показывает состояние обмена целиком: очередь, вебхуки МойСклад,
готовность каждого документа и каждого типа контрагента, и подсказку, чего именно не хватает в настройках.
Что модуль не делает
- Не синхронизирует каталог целиком — остатки, цены каталога, картинки и свойства товаров. Товары обмениваются только в составе документов. Для каталога есть отдельное решение «МойСклад: Синхронизация товаров по API».
- Не переносит удаления. Удалённый в МойСклад заказ или контрагент остаётся в Битрикс24 — обмен не выносит данные из CRM.
- Скидка переносится только в процентах, фиксированная скидка в рублях в МойСклад не уходит.
Кому подойдёт
Компаниям, которые продают из Битрикс24, а склад, документы и учёт ведут в МойСклад, и хотят, чтобы сделки, клиенты и товарные строки не переносились между системами руками.
Закажите любой модуль у нас на сайте с бесплатной установкой и гарантией 14 дней
Мы работаем с физическими и юридическими лицами. И предоставляем сразу два варианта оплаты.
- Наличные. Вы подписываете товаросопроводительные документы, расплачиваетесь денежными средствами, получаете товар и чек.
- Безналичный расчет. Принимаем карты Visa и MasterCard. Доступен при курьерской доставке.
Ваш заказ можем доставить собственными ресурсами, при условии вашего нахождения в городе. Либо через 4 варианта доставки:
- Курьерская доставка. Курьерская доставка работает с 9:00 до 19:00. Когда товар поступит на склад, курьерская служба свяжется для уточнения деталей. Специалист предложит выбрать удобное время доставки и уточнит адрес.
- Самовывоз из магазина. Для получения заказа обратитесь к сотруднику в кассовой зоне и назовите номер.
- Сотрудничаем с постаматами. Срок хранения — 3 дня.
- Предоставляем почтовую доставку через почту России. Когда заказ придет в отделение, на ваш адрес придет извещение о посылке. Вскрывать коробку самостоятельно вы можете только после оплаты заказа.
Дополнительная вкладка для размещения информации о товарах, доставке или любого другого важного контента. Поможет вам ответить на интересующие покупателя вопросы и развеять его сомнения в покупке. Используйте её по своему усмотрению.
Вы можете убрать её или вернуть обратно, изменив одну галочку в настройках компонента. Очень удобно.
- Комментарии
- ВКонтакте