1С:Предприятие

Интеграция 1С:Предприятие с Medusa

Документация
Двусторонний обмен каталогом, ценами, остатками и заказами между Medusa и 1С:Предприятие.
Read README in English ↗

Платный плагин для обмена данными между Medusa и ERP 1С:Предприятие по протоколу CommerceML. Бесплатная версия 1С:Предприятие Каталог только импортирует каталог и цены.

Плагин проходит закрытое бета-тестирование. Участники получают цену ниже релизной на первый год, разбор граничных случаев своей конфигурации 1С и чат с командой разработки. Чтобы присоединиться к тестированию, оставьте заявку.

Возможности плагина

• Каталог из 1С – товары, категории из групп классификатора, типы товаров и картинки.
• Предложения – варианты с SKU, опциями из характеристик и розничной ценой.
• Типы цен – каждый нерозничный тип цен 1С становится прайс-листом Medusa.
• Остатки по складам – склады 1С становятся складами Medusa, остатки ведутся по каждому из них.
• Заказы в обе стороны – заказы Medusa уходят в 1С, а заказы, созданные в 1С, приходят в Medusa.
• Выгрузка каталога в 1С – товары, созданные или изменённые в Medusa, уходят в 1С.
• Товары, пропавшие из 1С – после полной выгрузки каталога их можно снять с публикации или удалить.
• Большие каталоги – плагин протестирован на каталоге в 400 000 SKU и обрабатывает его пачками по 100 товаров.
• Хуки воркфлоу – ваш код правит то, что обмен пишет в Medusa и отправляет в 1С, без форка плагина.
• Модуль интеграций – все настройки плагина вы задаёте в Medusa Admin, без правок medusa-config и без повторного развёртывания.

💬 Поддержка и сообщество

Есть вопросы по плагину или идеи? Пишите в чат поддержки в Telegram, @gorgojs_chat.

Общайтесь с другими разработчиками Medusa в Telegram, @medusajs_chat.

Требования

• Medusa v2.17.2 или новее
• Node.js v20 или новее
• Модуль интеграций v0.1.4 или новее
• Токен доступа к реестру пакетов Gorgo

Установка

Пакеты @gorgo-store публикуются в реестре registry.gorgojs.com, а не в общем реестре npm. Токен доступа к нему вы получите после одобрения заявки на бету. Укажите менеджеру пакетов этот реестр для пакетов @gorgo-store и передайте ему токен. Yarn 2 и новее берёт настройки из .yarnrc.yml:

npm берёт их из .npmrc:

Токен оба файла берут из переменной окружения GORGO_TOKEN, так что в репозиторий проекта он не попадает. Задайте её везде, где ставятся зависимости, то есть на своей машине и в CI. Затем установите плагин вместе с Модулем интеграций:

Документация

Как зарегистрировать плагин в medusa-config.ts, применить миграции и настроить обмен в 1С, описано в разделе «Начало работы». Остальное, включая настройки в Medusa Admin и хуки воркфлоу, есть на сайте документации Gorgo.

Лицензия

Коммерческое программное обеспечение по подписке. Каждая версия, выпущенная за оплаченный период, остаётся у вас бессрочно, а подписка даёт право на новые версии. Условия описаны в лицензионном соглашении в файле LICENSE.ru.md этого пакета.