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



# Вступление

В данном курсе мы расскажем как быстро и удобно организовать полноценный обмен между облачной ERP-системой [МойСклад](https://www.moysklad.ru/) и сайтом на CMS [1С-Битрикс](https://www.1c-bitrix.ru/).

Студия [«Априкс»](https://aprix.ru/) представляет модуль расширенной интеграции интернет-магазина на платформе 1С-Битрикс с облачной ERP-системой "МойСклад". Имея значительный опыт интеграции, мы собрали основные требования и пожелания клиентов и реализовали их в представленном здесь решении.

С помощью модуля можно решать **ключевые бизнес-задачи** и гибко настраивать синхронизацию между сайтом на 1С-Битрикс и системой МойСклад в соответствии с вашими потребностями:

* быстрая передача больших объёмов номенклатуры: товаров, модификаций, услуг и комплектов;
* выгрузка структуры групп товаров в разделы каталога на сайте с сохранением иерархии;
* оперативная синхронизация остатков, включая обработку оприходований и списаний в МойСклад;
* гибкая синхронизация заказов в обе стороны (с сайта в МойСклад и обратно) с учётом полей, доставок, статусов и состава заказа;
* синхронизация контрагентов в МойСклад и пользователей на сайте с возможностью гибкой настройки;
* синхронизация отгрузок и оплат в обе стороны;
* передача отдельных типов скидок на товары из МойСклад на сайт;
* возможность настройки синхронизации одного аккаунта МойСклад с несколькими сайтами.


В МойСклад уже предусмотрены встроенные инструменты для синхронизации товаров с сайтом. Один из таких инструментов основан на протоколе CommerceML 2.0.

Однако данный способ выгрузки имеет ряд ограничений, которые могут повлиять на бизнес-процессы. Например, через CommerceML передаётся ограниченный набор данных — в основном это наименование, наличие и цена.

Модуль **"МойСклад: расширенная интеграция"** предоставляет значительно более широкие возможности по сравнению со штатной синхронизацией МойСклад.

Для наглядного сравнения доступна отдельная [страница](https://doc.aprix.ru/books/moisklad-rassirennaia-integraciia/page/otlicie-ot-bazovogo-obmena). с таблицей, в которой представлены основные отличия и функциональные возможности обоих решений

<b>Спасибо за интерес к нашим решениям!</b>

# Шаги быстрой настройки

<b>Быстрый старт обмена между Вашим сайтом и системой складского учета "МойСклад"</b>

-  Для начала нужно что бы у Вас был установлена на сайте одна из редакций 1С Битрикс "Управление сайтом". Если этого не сделано, то можно ознакомиться и [инструкцией](https://aprix.ru/doc/ms-bus/FAQ/installing_and_configuring_1C-Bitrix/);
- Сделать первичную настройку сайта при установке согласно [инструкции](https://aprix.ru/doc/ms-bus/FAQ/installing_and_configuring_1C-Bitrix/Initial_site_setup/);
- Перевести выполнение агентов на [крон](https://aprix.ru/doc/ms-bus/basic_setup/first_steps/configuringthe_launch_of_agents_from_cron/);
- Установить модуль "МойСклад: Расширенная интеграция" следуя [инструкции](https://aprix.ru/doc/ms-bus/basic_setup/).
-----
<b>Настроить модуль:</b>
- Авторизироваться и сделать обязательные [настройки](https://aprix.ru/doc/ms-bus/basic_setup/first_steps/mandatory_settings/);
- Настроить синхронизацию [товаров](https://aprix.ru/doc/ms-bus/basic_setup/synchronization_of_goods/);
- Внести нужные настройки по синхронизации [заказов](https://aprix.ru/doc/ms-bus/basic_setup/synchronization_of_orders_and_contractors/);
- Настроить синхронизацию [контрагентов](https://aprix.ru/doc/ms-bus/basic_setup/synchronization_of_orders_and_contractors/Synchronization_of_contractors/).
-----
<b>За потребности можно настроить следующие функции:</b>

- Синхронизация [оплат](https://aprix.ru/doc/ms-bus/basic_setup/synchronization_of_orders_and_contractors/paid/);
- Синхронизация [отгрузок](https://aprix.ru/doc/ms-bus/basic_setup/synchronization_of_orders_and_contractors/Synchronization_of_shipments/);
- Синхронизация [скидок](https://aprix.ru/doc/ms-bus/basic_setup/synchronization_of_discounts/).

# Технические требования

- Редакция «1С-Битрикс: Управление сайтом» (БУС): "Малый Бизнес", "Бизнес" и выше
- Минимальная версия php 8.0+
- Минимальная версия 1С-Битрикс 25.0+

# Как настроить модуль: шаги и рекомендации

#### Подготовка к работе

1. Убедитесь, что на сайте установлена одна из редакций 1С-Битрикс «Управление сайтом». Если система ещё не установлена, ознакомьтесь с [инструкцией](https://doc.aprix.ru/books/moisklad-rassirennaia-integraciia/page/ustanovka-i-nastroika-1s-bitriks-nastroika-xostinga-beget);
2. Выполните первичную настройку сайта после установки в соответствии с [инструкцией](https://doc.aprix.ru/books/moisklad-rassirennaia-integraciia/page/ustanovka-i-nastroika-1s-bitriks-pervicnaia-nastroika-saita-na-1s-bitriks-cerez-beget);
3. Установите модуль «МойСклад: Расширенная интеграция», следуя [инструкции](https://doc.aprix.ru/books/moisklad-rassirennaia-integraciia/page/1-ustanovka-modulia-iz1s-bitriks-marketpleis);
4. Определите способ запуска основных процессов синхронизации: через агенты (не рекомендуется), с использованием cron или через отдельный скрипт cron. Подробности приведены в [инструкции](https://doc.aprix.ru/books/moisklad-rassirennaia-integraciia/page/mexanizmy-zapuska-sinxronizacii-i-ix-nastroiki);

#### Основная настройка модуля
1. Выполните авторизацию в модуле и задайте обязательные [настройки](https://doc.aprix.ru/books/moisklad-rassirennaia-integraciia/page/pervye-sagi-obiazatelnye-nastroiki);
2. Настройте синхронизацию [товаров](https://doc.aprix.ru/books/moisklad-rassirennaia-integraciia/page/sinxronizaciia-tovarov-osnovnye-nastroiki);
3. Настройте синхронизацию [заказов](https://doc.aprix.ru/books/moisklad-rassirennaia-integraciia/page/osnovnye-nastroiki);
4. Настройте синхронизацию [контрагентов](https://doc.aprix.ru/books/moisklad-rassirennaia-integraciia/page/sinxronizaciia-kontragentov).
#### Дополнительные настройки

1. Настройте синхронизацию [оплат](https://doc.aprix.ru/books/moisklad-rassirennaia-integraciia/page/sinxronizaciia-oplat);
2. Настройте синхронизацию [отгрузок](https://doc.aprix.ru/books/moisklad-rassirennaia-integraciia/page/sinxronizaciia-otgruzok);
3. Настройте синхронизацию [скидок](https://doc.aprix.ru/books/moisklad-rassirennaia-integraciia/page/nastroika-sinxronizacii).