МойСклад: Гибкий обмен заказами по API

Модуль связывает интернет-магазин на 1С-Битрикс и МойСклад в одну базу заказов. Покупатель оформляет заказ на сайте — в МойСкладе появляется заказ покупателя: с контрагентом, корзиной, ценами и скидками, доставкой, оплатой и нужными свойствами. Менеджер меняет статус, состав или комментарий в МойСкладе — изменение возвращается в заказ на сайте. Обмен идёт напрямую по JSON API 1.2, без файлов выгрузки и стандартного обмена.

Почти каждый кусок обмена настраивается отдельно: какие поля уходят, в какую сторону передаётся свойство, как ищется контрагент, когда создаётся отгрузка, какие статусы не трогать. Поэтому модуль подстраивается под уже сложившиеся процессы магазина, а не наоборот.

Что синхронизируется

• Заказы — создание и обновление в обе стороны, включая импорт заказов, созданных в МойСкладе.

• Статусы — по таблице соответствий, с флагом отмены заказа и защитой завершённых заказов от повторной смены статуса.

• Корзина — состав, количество, цены и скидки позиций, модификации, раскрытие комплектов, стоимость доставки.

• Контрагенты — поиск существующих и создание новых: физлица по телефону или email, юрлица и ИП по ИНН.

• Оплаты — входящие платежи и приходные ордера.

• Отгрузки — документы отгрузок, их статусы, склад, НДС и трек-номера.

• Свойства заказа — дополнительные поля с направлением обмена для каждого свойства.

• Способы доставки и оплаты, канал продаж, ответственный менеджер, комментарии менеджера и покупателя.

Как это выглядит в работе

Покупатель оформляет заказ на сайте. Модуль ставит агента выгрузки, и тот по расписанию отправляет заказ в МойСклад: находит или создаёт контрагента, собирает корзину, проставляет организацию, склад и статус. Если нужно, выгрузку можно отложить до определённого статуса или настроить моментальную — сразу после оформления.

В обратную сторону работают веб-хуки: МойСклад сам сообщает сайту об изменении заказа, платежа, приходного ордера или отгрузки. Обрабатывать их можно сразу, через очередь или в смешанном режиме — очередь спасает сайт при массовом редактировании заказов в МойСкладе.

Ключевые возможности

• Гибкий поиск контрагентов. Правила поиска задаются отдельно для каждого типа плательщика, поэтому повторный покупатель находится, а не дублируется. При создании — теги, группы, формат телефона, запись свойств заказа в поля контрагента.

• Два режима оплат. «По сумме» — состояние оплаты определяется суммой документов; «полное соответствие» — каждый документ оплаты дублируется между системами. Платёжные системы, организация, счёт и статус документа сопоставляются в настройках.

• Два режима отгрузок. Отгрузка создаётся при достижении статуса или полностью дублируется. Стоимость доставки уходит полем отгрузки или отдельной позицией-услугой.

• Резервы. Резерв при создании заказа, перерезервирование при изменении корзины, снятие резерва по статусу и при отмене.

• Свойства любого типа. Строка, число, флажок, дата, перечисление, файл, местоположение — для каждого свойства своё направление: на сайт, в МойСклад или в обе стороны.

• Импорт заказов из МойСклад. Заказ создаётся на сайте по веб-хуку создания или по флажку в заказе МойСклад; есть разовый импорт заказов за период.

• Профили обмена. Несколько профилей — для разных аккаунтов МойСклад или разных сайтов многосайтовой конфигурации.

• Фильтры и исключения. Обмен по сайту, блокировка конкретного заказа полем-флагом, порог по ID — старые заказы не трогаются.

• Диагностика. Лог операций с фильтрами по заказу и типу события, режим отладки, уведомления об ошибках на почту и в админке.

• Для разработчиков. События модуля для заказов, контрагентов, корзины, веб-хуков и настроек — доработки без потери обновлений.

Требования

• 1С-Битрикс: Управление сайтом с модулем «Интернет-магазин».

• PHP 8.

• Платный тариф МойСклад — на бесплатном нет веб-хуков.

• Доступ к JSON API 1.2: токен или логин и пароль администратора МойСклад.

• Агенты на cron и доступный снаружи адрес веб-хука на сайте.

Что модуль не делает

• Не работает на бесплатном тарифе МойСклад: без веб-хуков изменения из МойСклад на сайт не придут.

• Не гарантирует совпадение суммы корзины до копейки при скидках: МойСклад считает скидку в процентах, Битрикс хранит конечную цену. Опция пересчёта помогает, но 100% совпадения не обещает.

• Не угадывает соответствия статусов: если статус МойСклад не сопоставлен, его нужно добавить в соответствия или в игнорируемые, иначе сайт может вернуть прежний статус.

• Не работает в паре со стандартным обменом заказами Битрикс и МойСклад — стандартный обмен нужно отключить.