Объекты доступа — руководство пользователя
«Объекты доступа» — центральный справочник всех RFID-карт и чипов компании. Именно тип карты и её привязки (к сотруднику, автомобилю, складу, контрагенту) определяют, что происходит, когда эта карта предъявляется на узле выдачи топлива: обычная выдача сотруднику, заправка конкретного автомобиля, приход от поставщика, перемещение между ёмкостями или коммерческая продажа контрагенту. Здесь же настраивается финансовый контроль — лимитная/безлимитная карта, суточный лимит, а для коммерческой продажи — общий лимит на группу карт одного контрагента.
Раздел находится в «Администратор» → «Объекты доступа». Просмотр и большинство действий доступны ролям Администратор и Продвинутый пользователь; отдельный «Журнал операций по картам» (раздел 8) — только им.
1. Список карт#
Полная таблица всех RFID-объектов компании с фильтром по номеру карты и переключателем «показывать заблокированные».
| № | Колонка | Описание |
|---|---|---|
| 1 | Тип | Одно из 7 значений — определяет роль карты в системе, подробно в разделе 2. |
| 2 | Статус | Красный крестик — лимитная карта (тип лимита задан явно); зелёная галочка — безлимитная. Отдельная блокировка (в замок/раздел 6) — это другое состояние, не путать со статусом лимита. |
| 3 | Баланс | Текущий остаток топлива, накопленный на карте — то, что реально может списаться при выдаче. Пополняется программно (см. руководство по API) или документом начисления. |
| 4 | Лимит | Суточный лимит в литрах — верхняя граница выдачи за одни сутки, независимо от баланса. |
| 5 | Период | Единица, для которой считается суточный лимит (в текущей версии — «Day», сутки). |
| 6 | Остаток | Сколько из суточного лимита ещё не использовано сегодня. |
| 7 | Контрагент | Если задан — карта относится к внешнему покупателю/поставщику; при включённом групповом контроле (раздел 4.3) лимит по факту берётся не с этой карты, а из общего баланса контрагента. |
2. Типы карт — назначение каждого#
Тип задаётся при создании карты и виден в колонке «Тип» и в форме редактирования. Он не просто подпись — от него зависит, как система обработает операцию выдачи на узле.
| № | Тип | Назначение |
|---|---|---|
| 1 | Сотрудник | Обычная карта работника — идентифицирует, кто получил топливо. Базовый, самый частый тип. |
| 2 | Автомобиль | Карта закреплена за конкретной машиной (см. «Список API серверов компании», раздел 8) — заправка сразу фиксируется и на сотруднике, и на автомобиле («двойная идентификация», раздел 3). |
| 3 | Емкость | Карта самой ёмкости/резервуара. Предъявляется как вторая карта при переливе топлива между ёмкостями — операция уходит не как обычная выдача, а как документ перемещения между складами (запись в «Движение топлива по складу»), и, если это приёмная сторона, попадает в журнал прихода в бак. |
| 4 | Поставщик | Карта поставщика топлива. Операция с такой картой (или на узле, изначально настроенном как приёмный) заносится не как расход, а как поступление — приход топлива, а не выдача. |
| 5 | Контрагент | Карта, выданная внешнему покупателю для коммерческой продажи топлива. См. раздел 4.3 про общий (групповой) лимит на все карты одного контрагента. |
| 6 | Оператор | Карта оператора/заправщика. На сегодняшний момент это чисто информационная роль — отдельной логики расчёта под неё не заложено, тип используется только для учёта, кто именно из персонала обслуживал узел. |
| 7 | Емкость приёмка | Тот же смысл, что «Емкость» (пункт 3), но с обратным направлением: используется, когда именно эта ёмкость — принимающая сторона перелива, а не отдающая. |
3. Двойная идентификация#
На узле выдачи можно предъявить не одну, а две карты подряд — основную и вторую. Вторая карта не обязательна, но именно она определяет, во что превратится операция:
- вторая карта типа Автомобиль — обычная выдача с фиксацией автомобиля-получателя;
- вторая карта типа Емкость/Емкость приёмка — операция становится документом перемещения топлива между складами, а не продажей/выдачей сотруднику;
- вторая карта типа Поставщик — операция фиксируется как поступление.
Если вторая карта не предъявлена — всё определяется типом первой (основной) карты и/или типом самого узла: узел, заранее настроенный как «приёмный», сам превращает операцию в поступление, даже если предъявлена обычная карта сотрудника.
4. Лимиты и баланс#
4.1. Лимитная / безлимитная карта#
В форме редактирования (раздел 5) и в инлайн-редактировании строки можно переключить карту между двумя режимами: безлимитная (тратит без ограничения сверху, кроме собственного баланса) и лимитная (дополнительно ограничена суточным лимитом из раздела 4.2).
4.2. Баланс и суточный лимит#
Это два независимых ограничения:
| Баланс | Общий накопленный остаток на карте. Пополняется начислением (документом или через API — см. «Памятка разработчику 1С», раздел «Начислить топливо на баланс»/«Сторнирование»). Если баланс исчерпан — выдача не пройдёт, независимо от суточного лимита. |
|---|---|
| Суточный лимит | Верхняя граница выдачи за одни сутки, даже если баланса ещё много. Обнуляется и снова доступен на следующие сутки. Настраивается отдельно от баланса — можно иметь большой баланс, но маленький суточный лимит (например, чтобы сотрудник не выбрал сразу весь месячный остаток за один день). |
4.3. Общий лимит на группу карт контрагента (коммерческая продажа)#
Для случая, когда компания продаёт топливо внешнему покупателю (контрагенту) сразу по нескольким картам и хочет ограничивать не каждую карту отдельно, а суммарно на всех картах контрагента вместе — например, «этому покупателю можно выдать не больше 5000 л всего, по любой из выданных ему карт».
Это отдельный, продвинутый режим — он не включён по умолчанию и нигде не переключается в самом интерфейсе «Объекты доступа»: включение делается на уровне настроек компании (не через UI этого раздела) и должно быть согласовано отдельно. Пока режим не включён, поле «Контрагент» у карты — просто метка/группировка для отчётности, а лимит и баланс каждой карты считаются независимо друг от друга, как обычно.
Когда режим включён: у карты, предъявленной с заполненным «Контрагент», система на узле подставляет вместо собственного лимита карты — текущий общий остаток этого контрагента. После каждой выдачи общий остаток контрагента уменьшается, и это сразу отражается на лимите всех остальных карт того же контрагента — то есть карты действительно делят один пул, а не просто сгруппированы визуально.
Сам баланс контрагента (сколько ему начислено, выдано и сколько осталось) виден в «Сервисные функции → Контрагенты» — при выборе контрагента справа открывается его собственный журнал операций (колонки: Дата, Имя (карты), Имя узла, RFID, Начислено, Выдано, Баланс) — фактически отдельный лицевой счёт, не привязанный к какой-то одной карте. Начислять на этот счёт (пополнять его) можно так же, как и обычной карте.
5. Привязки карты#
Клик по карандашу открывает форму редактирования: блок «Основное» (имя, RFID, тип, ПИН, суточный лимит, дата выдачи/срок действия) и блок «Привязки» — пять полей, которые можно заполнить независимо друг от друга и не только для «своего» типа карты (поле «Автомобиль», например, доступно даже если тип карты не «Автомобиль»):
| Поле | Что даёт привязка |
|---|---|
| Сотрудник | Владелец карты; можно сразу создать нового сотрудника с ФИО из имени карты, если его ещё нет в справочнике. |
| Автомобиль | Заправка автоматически учитывается по конкретной машине; можно сразу создать автомобиль с названием и RFID из карты. |
| Хранилище | Складская привязка — на каком складе физически находится узел/ёмкость, за которой закреплена эта карта. |
| Контрагент | См. раздел 4.3 — участие в общем лимите (если он включён) и попадание в отчётность по контрагенту. |
| Подразделение | Организационная принадлежность карты внутри компании. |
6. Добавление карт#
6.1. По одной#
Пустая строка внизу таблицы — заполните имя, RFID, тип и нажмите «+».
6.2. Списком (несколько карт за раз)#
Кнопка «Добавить карты списком» открывает окно с построчным форматом:
Формат строки: rfid, name, pin, mode, type_rfid, product — только rfid обязателен, остальные поля можно не указывать.
| Поле | Значения |
|---|---|
| mode | 0 — установленная на компанию (по умолчанию), 1 — безлимитная, 2 — лимитная (баланс 0, топливо сразу не выдаст, пока не пополнить), 3 — сразу заблокированная |
| type_rfid | 1–7, см. раздел 2 (по умолчанию 1 — Сотрудник) |
| product | 0 — текущий выбранный продукт, 1 — дизель, 2 — бензин АИ 95, 9 — вода |
После загрузки под текстовым полем появляется построчный отчёт (успех/ошибка по каждой строке); успешно обработанные строки убираются из поля, чтобы можно было исправить и повторно отправить только ошибочные.
Если карт много и нужно сразу привязать их к сотрудникам/автомобилям по Excel-файлу (а не построчным текстом) — для этого есть отдельный документ «Журнал регистрации карт», подробно описанный в руководстве «Регистрация карт».
7. Блокировка, разблокировка и удаление#
| Действие | Как | Особенности |
|---|---|---|
| Заблокировать / разблокировать | Значок замка в строке карты | Срабатывает сразу, без окна подтверждения. |
| Удалить | Значок корзины | Появляется только у уже заблокированной карты — удалить активную карту нельзя, сначала заблокируйте её. Перед удалением — окно подтверждения с номером карты. |
8. Журнал операций по картам#
Полная история изменений по всем картам компании: кто, когда и что поменял — создание, удаление, блокировка/разблокировка, переименование, смена типа лимита, суточного лимита, ПИН-кода, подразделения, срока действия, привязок (сотрудник/автомобиль/склад/контрагент), начисление и аннулирование начислений.
Фильтры: период (по общему выбору дат в шапке), тип действия (кнопки-вкладки), канал, инициатор (конкретный пользователь), а также свободный текстовый поиск по номеру карты, имени, пользователю или значению.
В журнал попадают действия, сделанные и через веб-интерфейс, и через программный API (раздел 9) — это один и тот же код на сервере. Но не все методы сейчас фиксируются: пакетное добавление карт списком (раздел 6.2), пара специальных «API»-вариантов методов добавления/переименования и групповая привязка объектов к RFID в журнал не попадают — там изменения в списке карт увидите, но отдельной записи «кто это сделал» не будет.
Раздел виден в меню пользователям с ролью Пользователь, но открыть его целиком могут только Администратор и Продвинутый пользователь — если пункт меню есть, а при открытии появляется ошибка доступа, значит роль недостаточна именно для этого журнала.
9. Программный доступ (API)#
Всё, что описано выше, можно делать и без интерфейса — напрямую через REST API (добавление, удаление, блокировка, начисление/списание баланса, суточный лимит, привязка сотрудника/автомобиля). Полное описание методов с примерами запросов — в руководстве «Памятка разработчику 1С: интеграция с EXZOTRON API».
10. Права доступа#
| Действие | Кто может |
|---|---|
| Просмотр списка карт | Администратор, Продвинутый пользователь |
| Добавление / редактирование / блокировка / удаление | Администратор, Продвинутый пользователь |
| Журнал операций по картам | Администратор, Продвинутый пользователь (пункт меню виден и Пользователю, но без доступа к данным) |