Интеграция по API с сервисом МойСклад

Внимательно прочитайте инструкцию и делайте всё по шагам.

Перед импортом заготовьте бекап данных на сервере, на всякий непредвиденный случай. Плюс в МС сделайте выгрузки в CSV файлы, тоже на всякий случай.
Контроль остатков в RS для работы модуля должен быть выключен, т.к. контроль остатков будет в МС.
Т.е. ведущая база товаров и остатков это МойСклад.
Модуль полноценно работает только с оплаченными аккаунтами.
Если Вы уже используете импорт из МС стандартными средствами, то Вам необходимо его отключить заранее.
Для работы модуля необходимо, чтобы был настроен cron на сервере по инструкции RS.


1. Установите модуль.
2. Перейдите в МС в Товары -> Товары и услуги и создайте там корневую папку Категории ИМ. Создайте в ней же категории Доставки ИМ и Сторонние налоги. В ней будут храниться услуги доставки.
3. Создайте папку в корне "Каталог товаров" и перенесите туда Ваши корневые категории товаров кроме "Категорий ИМ".
4. Если используется бонусная программа и она активна, то в настройках МС перейдите в скидки и создайте бонусную программу, если она ещё не создана.
5. Зайдите в настройки МС в валюты. Зайдите поочерёдно в каждую валюту. Т.к. в МС нет экспорта валют по API, то при открытии валюты в адресной строке нужно скопировать значение параметра id и вставить его в поле "Внешний идентификатор из Мой склад" в нужной валюте на стороне RS.
6. Перейдите в настройки данного модуля через Веб-сайт->Настройка модуля->Интеграция по API с моим складом.
7. На вкладке "Основные" укажите логин и пароль от Вашего аккаунта МС и сохраните и потом перезагрузите эту страницу.
8. Нажмите справа синхронизировать доп. поля в МойСклад
9 На стороне МС зайдите в заказы покупателей в настройках этой страницы добавьте два справочника Способы оплаты и Способы доставки в дополнительный полях (шестерёнка) и укажите там ссылки на Способы оплаты и отдельно на способ доставки уже ранее созданный. Пример Они покажутся когда Вы выберите тип справочник и там будет доступен вариант с выпадающими вариантами. На стороне МС зайдите в Товары -> Товары и услуги в настройках этой страницы добавьте справочник Бренды в дополнительный полях (шестерёнка) и укажите там ссылку на Бренды уже ранее созданный. Если они не видны, то просто обновите страницу. В настройках модуля на стороне RS проверьте, чтобы были указаны все справочники, на вкладке Обработка заказов пользователя и Доп. поля.
10. После этого заполните все данные в настройках, которые остались и читайте подсказки к полям наводясь на значки вопроса.
11. После чего нажмите сохранить.
12. В МС невозможно обычным способом синхронизировать типы цен. Поэтому необходимо в RS зайти в Товары->Справочник цен. Открыть цены и сопоставить в поле "Тип цены из МойСклад". Если в МС у Вас больше цен, не считая оптовой и минимальной, то необходимо на стороне RS, создать сначала цену и потом привязать её к той которая в МС. Также если вы хотите получать цены оптовые из МС. То нужно зайти в настройки модуля Магазин и в поле "Закупочная цена товаров" указать её. Также не забудьте в настройках модуля Каталог товаров указать зачеркнутую цену в поле "Старая(зачеркнутая) цена".
13. После установки всех необходимых Вам данных, необходимо запустить импорт. Для этого в настройках модуля справа, нужно последовательно запустить импорты один за другим:
14.1 Синхронизировать склады в МойСклад
14.2 Синхронизировать единицы измерения в МойСклад
14.3 Синхронизировать доставки в МойСклад
14.4 Синхронизировать налоги в RS
15.Теперь синхронизируем основные сущности. Необходимо дожидаться обновляя страницу статусы синхронизации. Например раз в 5 минут, чтобы статус стоял Готово. Для этого в настройках модуля справа, нужно последовательно запустить импорты, дожидаясь окончания:
15.1 Выгрузить пользователей системы в МойСклад (дождаться окончания на вкладке Статусы синхронизации)
15.2 Выгрузить категории системы в МойСклад (дождаться окончания на вкладке Статусы синхронизации)
15.3 Выгрузить товары системы в МойСклад (дождаться окончания на вкладке Статусы синхронизации)
15.4 Выгрузить остатки по товарам системы из МойСклад (дождаться окончания на вкладке Статусы синхронизации)
15.5 Остальные пункты не нужны для импорта, они для отладки.

ВАЖНО!!! Никогда не запускайте синхронизацию всю сразу, делайте всё последовательно, дожидайтесь окончания и только после этого переходите к следующему пункту. Иначе лишитесь своей нормальной рабочей базы.

16. Теперь необходимо создать Веб-хуки, перейдя на вкладку Веб-хуки и нажать "Создать Веб-хуки". Через 5 минут они будут созданы. Необходимо дождаться.
17. Теперь необходимо сопоставить статусы заказов. Для этого переходим в Магазин -> Заказы. Слева открываем все статусы и сопоставляем статус из RS в МС в поле "Статус из МойСклад". Статусы можно добавлять как на одной стороне так и на другой, главное просто сопоставлять.
18. После синхронизации будет один корневой элемент "Каталог товаров", который Вы создавали, поэтому в блоке вывода категорий поправьте вывод указав в качестве корневой именной эту категорию.

Напишите на E-mail a_zakusilo@mail.ru, а лучше всего в telegram 8 962 867 84 30