В этом руководстве вы узнаете, как управлять настройками интеграции 1С:Предприятие.

Чтобы открыть страницу с настройками 1С:Предприятие:

1. Откройте Medusa Admin.
2. Перейдите в Настройки → Интеграции → 1С:Предприятие.

Откроется страница настроек 1С:Предприятие со статусом интеграции, секциями Настройки синхронизации и Правила обмена и двумя секциями самого плагина, Канал продаж и регион и Соответствие валют.

---

Канал продаж и регион обязательны. Пока они не сохранены, интеграция остаётся в статусе Не настроено или Не завершено, а плагин отвечает на запросы 1С отказом.

• Канал продаж – к нему плагин привязывает товары и склады из 1С. Этот же канал получают заказы, пришедшие из 1С.
• Регион – регион для заказа из 1С, если по валюте документа регион найти не удалось.

Чтобы выбрать канал продаж и регион:

1. Перейдите в Настройки → Интеграции → 1С:Предприятие.
2. В секции Канал продаж и регион выберите канал продаж.
3. Выберите регион.
4. Нажмите Сохранить.

---

Секция Настройки синхронизации содержит поле ID типа цены. Это Ид типа цен 1С, цены которого плагин записывает в варианты как розничные. Если поле пустое, розничным считается первый тип цен в offers.xml. Остальные типы цен становятся прайс-листами, подробнее об этом в разделе Включение прайс-листов из 1С ниже.

При выгрузке каталога в 1С плагин указывает у цен этот же Ид. Если поле пустое, в выгрузку уходит Ид 11111111-1111-1111-1111-111111111111.

Чтобы изменить настройки синхронизации:

1. Перейдите в Настройки → Интеграции → 1С:Предприятие.
2. В секции Настройки синхронизации нажмите на меню действий в заголовке секции.
3. Выберите Редактировать.
4. В открывшейся боковой панели укажите Ид розничного типа цен.
5. Нажмите Сохранить.

---

Секция Соответствие валют связывает название валюты, как его пишет 1С в файлах обмена, с валютой магазина Medusa. По этому соответствию плагин определяет валюту цен вариантов, прайс-листов и заказов из 1С, а по валюте заказа выбирает его регион.

Плагин сравнивает названия без учёта регистра и пробелов по краям. Если для валюты нет соответствия, плагин использует её название из 1С в нижнем регистре как код валюты Medusa. Поэтому USD из 1С становится usd и без настройки. Если не задано ни одного соответствия, плагин считает руб валютой rub.

Чтобы добавить соответствие:

1. Перейдите в Настройки → Интеграции → 1С:Предприятие.
2. В секции Соответствие валют нажмите Добавить.
3. В открывшейся боковой панели выберите валюту Medusa из валют магазина.
4. Введите название валюты, как его пишет 1С.
5. Нажмите Сохранить.

Чтобы изменить или удалить соответствие, откройте меню действий в его строке и выберите Редактировать или Удалить.

---

Секция Правила обмена содержит три поля:

• Префикс номера заказа – строка, которую плагин добавляет перед номером заказа Medusa при выгрузке в 1С. С префиксом WEB- заказ 1042 уходит в 1С под номером WEB-1042.
• Действие для товаров, пропавших из полной выгрузки каталога – что плагин делает с ранее импортированным товаром, которого больше нет в полной выгрузке каталога. Можно выбрать Ничего не делать (по умолчанию), Деактивировать (в черновик) или Удалить.
• Обновлять ярлык при переименовании товара в 1С – пересчитывать ли ярлык существующего товара, когда в 1С поменялось его название. По умолчанию выключено.

Плагин сохраняет в заказе номер, под которым тот ушёл в 1С. Когда 1С присылает заказ обратно, плагин находит его по Ид или по этому номеру и не создаёт повторно. Поэтому смена префикса не затрагивает уже выгруженные заказы.

Действие срабатывает только после полной выгрузки каталога. Если 1С прислала только изменения, плагин не считает отсутствующие в них товары пропавшими.

Ярлык (handle) задаёт адрес страницы товара на витрине. Новый товар получает ярлык из названия и части Ид 1С, как описано в разделе Сопоставление записей. Пока настройка выключена, плагин не меняет ярлык существующего товара, и ссылки на товар продолжают работать. Если её включить, при переименовании товара в 1С плагин построит ярлык заново из нового названия, а старая ссылка на товар перестанет открываться.

Чтобы изменить правила обмена:

1. Перейдите в Настройки → Интеграции → 1С:Предприятие.
2. В секции Правила обмена нажмите на меню действий в заголовке секции.
3. Выберите Редактировать.
4. В открывшейся боковой панели задайте префикс, действие для пропавших товаров и обновление ярлыка.
5. Нажмите Сохранить.

---

Проверка соединения у этого плагина не обращается к 1С, потому что обмен запускает сама 1С. Вместо этого она проверяет, что канал продаж и регион выбраны, а их ID начинаются с sc_ и reg_.

Чтобы проверить настройки:

1. Перейдите в Настройки → Интеграции → 1С:Предприятие.
2. Откройте меню действий у названия интеграции.
3. Выберите Проверить соединение.

Результат проверки появится в уведомлении.

---

Каждый тип цен 1С, кроме розничного, плагин переносит в Medusa как прайс-лист. Новый прайс-лист он создаёт черновиком с типом Распродажа, названием типа цен и описанием 1C price type: <название>. Цены в нём плагин обновляет при каждом обмене. Название, статус, тип и правила существующего прайс-листа плагин не меняет, поэтому ваши правки в нём сохраняются.

Чтобы цены прайс-листа увидели покупатели:

1. Откройте Medusa Admin и перейдите в Прайс-листы.
2. Откройте прайс-лист с названием типа цен 1С.
3. В секции Конфигурация нажмите на меню действий, выберите Редактировать, укажите в поле Доступность для клиентов группы покупателей и нажмите Сохранить.
4. В заголовке прайс-листа нажмите на меню действий и выберите Редактировать.
5. Смените Статус на Активный и нажмите Сохранить.

Укажите группы покупателей до того, как включить прайс-лист. Иначе в промежутке между этими шагами он будет действовать для всех покупателей.

Чтобы прайс-лист получал группу и статус автоматически, используйте хук setPriceLists, как в примере Оптовая цена для группы покупателей.

---