Рабочие места

> Сервер оборудования
Дата обновления: 20 октября 2026 г. Дата публикации: 20 октября 2026 г. Автор: Машковцев Тимур

Рабочее место — это набор оборудования одной кассы или места продавца: весы, сканер штрихкодов, принтер этикеток и эквайринговый терминал. Кассовое ПО занимает рабочее место и после этого работает с его оборудованием, не указывая каждое устройство отдельно. Перед созданием рабочего места добавьте нужные устройства в разделах «Весы», «Сканеры» и «Эквайринг».

Откройте раздел «Рабочие места» в боковом меню. В таблице отображаются все рабочие места, их оборудование и состояние.

Колонка	Описание
ID	Номер рабочего места. Кассовое ПО указывает его в запросах к Серверу оборудования.
Название	Название рабочего места.
ID устройства	Идентификатор кассы (клиента), которая заняла рабочее место.
Название устройства	Название кассы (клиента), которая заняла рабочее место.
Весы	Весы рабочего места.
Сканер	Сканер штрихкодов рабочего места.
Принтер	Принтер этикеток рабочего места.
Эквайринг	Эквайринговый терминал рабочего места.
X, Y	Смещение при печати этикеток.
Статус	«Свободно» — рабочее место никем не занято, «Занято» — к нему привязана касса.

Добавление рабочего места

Нажмите «Добавить», заполните параметры и нажмите «Добавить» в форме. Укажите хотя бы одно устройство: весы, сканер, принтер или эквайринговый терминал.

Параметр	Описание
Название	Название рабочего места, например «Касса 1». Обязательное поле.
ID устройства	Идентификатор кассы, занявшей рабочее место. Обычно заполняется автоматически, когда кассовое ПО занимает рабочее место. При добавлении оставьте поле пустым.
Название устройства	Название кассы, занявшей рабочее место. Заполняется вместе с полем «ID устройства».
Весы	Весы из раздела «Весы».
Сканер	Сканер из раздела «Сканеры».
Принтер	Принтер для печати этикеток. Выбирается из принтеров, установленных на компьютере с Сервером оборудования.
Эквайринговый терминал	Терминал из раздела «Эквайринг».
X (позиция по горизонтали)	Смещение этикетки по горизонтали при печати. По умолчанию — `0`. Подбирается, если этикетка печатается со сдвигом.
Y (позиция по вертикали)	Смещение этикетки по вертикали при печати. По умолчанию — `0`.

Если устройство переименовать в его разделе, новое название автоматически подставится во все рабочие места, где оно указано.

Как кассовое ПО использует рабочее место

Кассовое ПО получает список свободных рабочих мест (GET /api/v1/workspace/list/free) и занимает одно из них (PUT /api/v1/workspace/take), передавая номер рабочего места, свой идентификатор и название. Рабочее место получает статус «Занято». Занятое рабочее место другая касса занять не сможет.
Для получения штрихкодов и веса кассовое ПО подключается к событиям сканера (/api/v1/scanner/events) или весов (/api/v1/scale/events), передавая свой идентификатор (guid) и номер рабочего места (workspaceId). Сервер подключает кассу к сканеру или весам, указанным в рабочем месте. Активные подключения видны в разделе [[Подключения]].
Для печати этикетки кассовое ПО передаёт номер рабочего места (POST /api/v1/print/label), и этикетка печатается на принтере рабочего места со смещением X и Y. Если принтер не указан, возвращается ошибка «У данного рабочего места отсутствует принтер».
Эквайринговый терминал рабочего места кассовое ПО получает из списка рабочих мест и обращается к нему по названию.
По окончании работы кассовое ПО освобождает рабочее место (PUT /api/v1/workspace/detach).

К сканеру или весам одновременно может быть подключена только одна касса. Если касса с другим идентификатором попытается подключиться к уже занятому устройству, подключение будет отклонено. Повторное подключение кассы с тем же идентификатором заменяет её прежнее подключение.

Редактирование рабочего места

Нажмите на строку рабочего места в таблице, чтобы открыть форму редактирования. Измените параметры и нажмите «Сохранить».

Кнопка	Описание
Сбросить привязку	Освобождает рабочее место: очищает поля «ID устройства» и «Название устройства». Используйте, если касса не освободила место сама, например после сбоя. Кнопка доступна только для занятого рабочего места.
Удалить	Удаляет рабочее место после подтверждения.

Рабочие места хранятся в файле workspace/configuration.json в каталоге данных Сервера оборудования.