Установка в 1С

Терминал работает с 1С через расширение EAMForge_TSD и его HTTP-сервис, опубликованный на веб-сервере (Apache или IIS). Всё это ставит Windows-мастер — вручную в Конфигураторе ничего делать не нужно.

Для МоегоСклада установка на стороне клиента не нужна — см. МойСклад.

Коротко: пять шагов

1. Подготовка — резервная копия базы, нужная функциональность в 1С (ниже).
2. Мастер — скачать архив с download.html, запустить install.cmd от администратора, «Установить и опубликовать» (ниже).
3. Терминал — «Подключение к 1С» → QR с рабочего стола, вход admin / 1234, новый пароль.
4. Люди — завести кладовщиков обработкой «Пользователи ТСД» (пользователи и роли).
5. Настройки — вид цены, слепая инвентаризация, отгрузка без документа (настройки расширения).

Документации в архиве нет — только ссылки (файл Документация.txt): инструкции живут здесь и всегда соответствуют текущей версии.

Перед установкой

Под пользователем 1С с полными правами:

1. Сделайте резервную копию базы. Расширение меняет конфигурацию — это обратимо, но копия нужна всё равно.
2. Включите функциональность, которую будете использовать: Главное → Функциональность (в некоторых конфигурациях «НСИ и администрирование → Настройка → Функциональность»), вкладка «Запасы» / «Склад». Для комплектации — флажок «Комплектация номенклатуры»: без него документа комплектации нет, и плитки на терминале не будет.
3. Для комплектации заведите спецификации наборов: карточка товара-набора → «Спецификации». Набор без спецификации на терминале не показывается.

БухгалтерияУправление торговлей

Дополнительно ничего не нужно: складской учёт в Бухгалтерии включён всегда.

• Проверьте настройки складов: «использовать ордерную схему при поступлении / при отгрузке». От них зависит, какой документ создаёт терминал — см. что умеет ваша база.
• Для серий — настроенный учёт серий по виду номенклатуры и складу.

Мастер установки

1. Скачайте EAMForge-1C-Setup.zip с tsd.eamforge.com/download.html и распакуйте на компьютере с 1С.
2. Запустите install.cmd от имени администратора.
3. Выберите базу — файловую (File=) или серверную (Srvr=/Ref=).
4. Публикация — «Создать новую» (почему — ниже).
5. Проверьте адрес сервиса. Для доступа из интернета укажите домен с HTTPS.
6. «1. Установить и опубликовать» — мастер ставит расширение, публикует сервис, заводит служебного пользователя, открывает порт в брандмауэре.
7. «2. Показать QR» — мастер проверит связь и положит QR на рабочий стол.
8. На терминале до входа: «Подключение к 1С» → отсканировать QR.
9. Войти admin / 1234 — приложение сразу потребует задать постоянный пароль.

Веб-сервер мастер выбирает сам: если на машине уже есть IIS — предлагает его, иначе ставит Apache. То, что уже установлено, не переустанавливается.

Проверка на самом сервере

http://localhost:ПОРТ/ИМЯ_ПУБЛИКАЦИИ/hs/eamtsd/v1/health — ответ с "success":true значит, что 1С и веб-сервер работают. Если при этом терминал не подключается — дело в адресе в приложении, сети или брандмауэре.

Обновление расширения

Новая версия ставится тем же мастером поверх старой:

1. Скачайте свежий архив с download.html.
2. install.cmd от администратора → та же база → та же публикация (мастер сам предложит созданную раньше) → «Установить и опубликовать».
3. На терминале: «Настройки → Совместимость с 1С» → «Проверить» — должно быть ✅.

Пользователи ТСД, пароли, привязки меток и настройки при обновлении сохраняются — теряются они только при удалении расширения (ниже).

Порядок — сначала 1С, потом терминалы: новое расширение со старым приложением работает, а наоборот часть функций будет недоступна. Подробно — версии и совместимость.

Серверная база применяет расширение не сразу

Если после обновления терминал ещё видит старую версию или 1С отвечает «роль не найдена», подождите пару минут или перезапустите рабочие процессы сервера 1С.

Отдельная публикация для терминалов

Логин и пароль в файле публикации (Usr=/Pwd= в default.vrd) 1С применяет к любому подключению по этому адресу: сотрудник, открывший его в браузере, попадёт в базу под служебным пользователем без пароля. Поэтому:

• мастер создаёт для терминалов свою публикацию с закрытым входом для людей — веб-клиент и тонкий клиент выключены, работает только HTTP-сервис;
• в публикации, через которую работают сотрудники, Usr=/Pwd= быть не должно. Мастер проверяет это и предупреждает, но чужую публикацию не правит.

Существующую публикацию выбирайте, только если через неё в базу никто не заходит. При повторном запуске мастер сам предложит ту, что создал раньше.

Где должна лежать файловая база

Вне C:\Users — например C:\1CBase или D:\Bases. База из «Документов» или с рабочего стола через веб-сервер не открывается: запрос висит до таймаута. Это не ошибка прав — помогает только перенос. Мастер предупреждает об этом при выборе базы. Серверной базы это не касается.

Разрядность Apache

Модуль 1С загружается внутрь процесса Apache, поэтому Apache и платформа 1С должны быть одной разрядности. Мастер определяет разрядность 1С сам и ставит подходящий Apache. Если Apache уже стоит и разрядность не совпадает — мастер скажет об этом и публиковать не станет.

Базовая версия 1С

Базовая версия допускает один сеанс — это ограничение самой 1С:

• терминал в базе один — работает всё, включая создание документов;
• в 1С параллельно кто-то работает — чтение работает (вход, склады, товары, сканирование), а запись документа не проходит: «Базовая версия не поддерживает одновременную работу нескольких пользователей». Операция остаётся в очереди на терминале и не теряется.

Договоритесь о порядке (бухгалтер закрывает 1С на время отправки) или переходите на ПРОФ.

Служебный пользователь 1С

Веб-сервер входит в базу под служебным пользователем — мастер заводит его сам: tsd, случайный пароль из 20 знаков (живёт только в default.vrd), скрыт из списка выбора, роли ПолныеПрава и EAMTsd_Роль. Права можно сузить после установки.

Нужен элемент справочника «Пользователи»

В конфигурациях на БСП запись любого документа требует, чтобы служебный пользователь был в справочнике «Пользователи». Иначе чтение работает, а первая же приёмка падает с «Не удалось установить параметр сеанса ТекущийПользователь». Мастер заводит элемент сам. Заводите вручную — создавайте пользователя в режиме «Предприятие» (Администрирование → Настройки пользователей и прав → Пользователи).

Два разных пользователя — не перепутайте

	Пользователь 1С («tsd»)	Пользователь ТСД («admin»)
Кто им пользуется	веб-сервер — входит в базу 1С	кладовщик — входит в приложение
Где заведён	Администрирование → Пользователи 1С	обработка «Пользователи ТСД»
Пароль	случайный, в default.vrd	задаёт сотрудник; первый вход admin / 1234
Виден человеку	нет	да, вводится на экране входа

Служебный пользователь 1С на терминале не используется никогда.

Безопасный режим расширения и фото

Фото с терминала прикрепляются к документу штатными «Присоединёнными файлами». В безопасном режиме расширения 1С этого не разрешает («Нарушение прав доступа!»), а 1С включает безопасный режим сама при добавлении расширения.

• Мастер снимает его автоматически и перезапускает веб-сервер.
• Ставили расширение вручную — снимите флажок: Конфигуратор → Конфигурация → Расширения конфигурации → EAMForge_TSD → «Безопасный режим», затем перезапустите веб-сервер.

Пока флажок стоит, всё остальное работает, но фото остаются на терминале с причиной в истории.

Удаление расширения

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

Перед удалением: обработка «Пользователи ТСД» → «Выгрузить пользователей в файл». После повторной установки — «Загрузить пользователей из файла» (добавляются только недостающие). Файл содержит хеши паролей — храните его как чувствительный.

Режим EPF — без веб-сервера

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

1. Проверьте, что включён складской учёт (есть остатки в разрезе складов).
2. Выгрузите мастер-данные в eam_master_data.json (склады, номенклатура со штрихкодами, единицы, остатки, пользователи).
3. На терминале: Настройки → «Мастер-данные (1С)» → «Импортировать файл».
4. Выполненные операции терминал складывает в файлы — их загружает в 1С внешняя обработка .epf.

Демо-вход в режиме EPF: admin / 1234.

Доступ из интернета (HTTPS)

Если терминалы ходят в 1С через интернет, соединение должно быть защищённым. Домен, проброс порта, бесплатный сертификат и перевод терминалов — tsd.eamforge.com/https.html. Самоподписанный сертификат приложение не примет, подойдёт Let's Encrypt.

Терминалы только в Wi-Fi склада — сертификат не нужен, достаточно постоянного адреса сервера в локальной сети.

Если не работает

Мастер разбирает ответ сервиса сам и пишет причину в окно. Коротко:

Ответ health	Причина
404	сервис расширения не опубликован, неверное имя публикации; на серверной базе — расширение ещё не применено (подождите, F7 в Конфигураторе или перезапуск rphost)
401	в default.vrd нет Usr=/Pwd=, они неверны или пользователь отключён
403	служебному пользователю не выдана роль EAMTsd_Роль или не хватает прав на данные
500	чаще всего 1С заблокировала вход после ошибок пароля — «вход заблокирован до ЧЧ:ММ»
висит	файловая база лежит в C:\Users\… — перенесите её
localhost работает, по IP нет	брандмауэр, привязка сайта, сеть