Установка расширения в 1С

Последние изменения: 13.08.2025

В данной статье мы рассмотрим принцип установки расширения в 1С на примере типовых конфигураций: Розница 3.0, Управление нашей фирмой 3.0 и Управление торговлей 11.

Установка расширения в 1С: Розница

1. Необходимо войти в базу 1С под правами администратора, т.е. войти должен пользователь с полными правами.

84ae0e4acf1d9e874f1b3b6a421efd03.png

2. Для подключения расширения Samosale нажмите указанную кнопку со стрелочкой и выберите «Функции для технического специалиста»

0d5c315d73e2d518afec3699f67efc66.png

Если данного пункта меню нет, то необходимо перейти Настройки → Параметры и отметить чекбокс "Режим технического специалиста"

529f26a7f8fbe58ac12aa87edc7f37c0.jpg

3. В открывшейся форме раскрываем группу «Стандартные» и выбираем «Управление расширениями конфигурации»

49d74e4806a257dc39dbc9fb28a740f4.png

Также можно найти данный пункт, просто введя название в строку поиска на данной форме 

f5fb4722caa8c73cb5af15ef6538fe93.png

4. Далее мы увидим установленные расширения. Для добавления нового расширения необходимо нажать на кнопку "Добавить" и выбрать файл с нужным расширением 

628bb7b8053dcd95957ea1af515e9946.png

После выбора файл непосредственно перед добавлением в некоторых случаях может возникнуть окно со стандартным предупреждением безопасности. Разрешаем установку путем нажатия кнопки "Да"

b569e925ab42a2f4e422328be8bd070c.png


После подтверждения может потребоваться повторная установка расширения 

cff1f99cd516876add01743450a89c69.png

При добавлении расширения может возникнуть следующая типовая ошибка: 

65883c972fd2751b2ec43eb8f2ebb9ac.png

Данная ошибка означает, что возможность внесения изменений в базу заблокирована, т.к. есть активный пользователь. Просмотреть активных пользователей можно, перейдя Функции для технического специалиста → Стандартные → Активные пользователи 

18bbc9afc2a315c26ed8bc69f89deb01.png

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

fb663f89e5a4f49ee3fb96944ed8b4e0.png

5. После описанных выше действий нужно будет снова добавить расширение. При успешном добавлении появятся системные сообщения о создании новых таблиц данных и объектах (констант)

897f87e462407c205f3c72978b063584.png

6. Далее необходимо будет перезапустить 1С. Перед этим необходимо снять отметки в чекбоксах "Безопасный режим" и "Защита от опасных действий". Перезапуск необходим, что расширение применилось

c0cca7816731acd7a821062070c6d584.png

7. После перезапуска необходимо перейти в «Управление расширениями конфигурации» и проверить, что в чекбоксе "Использовать основные роли для всех пользователей" стоит галочка 

31f41678a23b59cdee1ac013cdd59c0f.png

8. Переходим Настройки → Сервис → Samosale (API ключ) и прописываем ваш токен пользователя личного кабинета Samosale. Это необходимо для связки двух систем

85e3dde4117ad113b736497c7e930b4b.jpg

9. Переходим Настройки → Сервис → Samosale (время ожидания подтверждения в минутах) и указываем необходимое количество минут (например, 3 или 5 минут). Данная опция отвечает за работу функционала "Давать списывать бонусы без подписки на мессенджер" в ЛК Samosale

2f7d6f9f9a506d6f5d8239e9c44a5ad3.jpg

10. Переходим Настройки → Сервис → Samosale: часовой пояс в формате +03:00 и указываем ваш часовой пояс UTC. Т.е. для Москвы +03:00, для Красноярска +07:00 и т.д

af8a5e589ac5f1e10e1f54d122c9afac.jpg

11. Переходим Настройки → Сервис → Синхронизация номенклатуры с Samosale

bb7c2a16873ef8bbe45f3024a47eece2.png

Если у вас 1000 или 2000 товарных позиций в списке номенклатуры, то можете нажать на кнопку "Отправить всю номенклатуры" и тем самым запустить синхронизацию. Если у вас более 10000 позиций, то процесс синхронизации товаров может занять продолжительное время и лучше это сделать позднее. Например, в конце вашего рабочего дня. Рекомендуем так поступить по той причине, что синхронизация блокирует работу 1С, и для продолжения работы вам потребуется открыть дополнительное окно 1С.

aa00ca76541e8995a10aa84a4f567a11.png




Для проверки работоспособности интеграции нужно перейти Продажи → Розничные продажи → Рабочее место кассира (РМК) и провести тестовую оплату с применением системы лояльности. 

a063f8aa0667ca09bf24b4037cb20a33.png

Подробно ознакомиться с принципом работы кассира при подключенной интеграции можно в наших статьях: Инструкция для кассира в 1С: Розница 2.3 и Инструкция для кассира в 1С:Предприятие Управление нашей фирмой (УНФ)


Установка расширения в 1С: Управление нашей фирмой

Процесс установки расширения полностью идентичен, описанному выше для 1С: Розница. Единственное отличие состоит в том, что для УНФ добавляется новая опция "Запретить скидки с использованием бонусов". При активации данной опции не удастся списать бонусные баллы на кассе, если в чеке уже применена ручная скидка.

ef7ce95fa701e745ff4cdda30117d1af.jpg



Установка расширения в 1С: Управление торговлей

Процесс добавления расширения также повторяет описанный порядок действий для Розницы, но появляется несколько дополнительных опций: 

– Использовать идентификатор номенклатуры (НСИ и администрирование → Сервис → Samosale: Использовать Идентификатор номенклатуры). При активации данной опции в Samosale передается не код номенклатуры, а уникальный идентификатор (UID). Эта настройка актуальна, когда у вас много торговых точек (магазинов), использующих один API-ключ, причём каждая точка имеет свою собственную номенклатуру. На разных торговых точках для одного и того же товара может использоваться одинаковый код номенклатуры и в чеке может передаваться некорректный товар. Чтобы этого избежать и было принято решение использовать Идентификатор номенклатуры (UID), т.к. он уникален в отличие от кода номенклатуры.

393db7904db5d1b08860b4b22d8958d5.jpg

– Префикс (НСИ и администрирование → Сервис → Samosale: Префикс). Эта настройка позволяет задать префикс для товаров вместо уникального идентификатора номенклатуры. Например, можно добавить общий префикс ко всем наименованиям товаров для упрощения управления ассортиментом в сети магазинов.

5d9f3de667b7d99cb67a12f381ec470e.jpg
678b88906dbdf2862c91c687dd23853f.png


– Полная выгрузка номенклатуры (НСИ и администрирование → Сервис → Samosale: Полная выгрузка номенклатуры). Данная настройка позволяет произвести полную перезапись всей существующей номенклатуры. Она полезна в ситуациях, когда сначала проводилось тестирование на отдельной базе, а затем расширением начали пользоваться в основной рабочей базе. Однако ранее созданная номенклатура мешает отправке нового списка товаров, потому что процесс синхронизации уже произошёл. В таком случае рекомендуется включить чекбокс "Перезаписывать номенклатуру", что обеспечит принудительное обновление всего списка товаров.

b56afa7ebdbedd2fab70acdd13ca5aa9.jpg


Если не нашли ответ на свой вопрос, задайте его нам в Telegram 😃

Помогла ли вам статья?