Касса «Экспертиза учета»: настройка и работа в 1С
Решение готовится к проверке функциональной совместимости с ТС ПИоТ в «Честном знаке» и к пилотному запуску.
Касса работает с 1С:Управление нашей фирмой (УНФ) через расширение с HTTP-сервисом «Шлюз касс Экспертиза». Обмен идёт по HTTPS:
| Направление | Что передаётся | Когда |
|---|---|---|
| 1С → касса | Товары и характеристики: наименование, штрихкоды, цена по виду цен, ставка НДС, единица измерения, вид маркировки, данные комитента | При запуске кассы и по кнопке «Товары из 1С» |
| Касса → 1С | Пробитые чеки продажи и возврата: состав, оплаты, коды маркировки, номер смены и чека | Сразу после чека. Без связи — из очереди кассы каждые 5 минут |
Инструкция для того, кто ведёт базу 1С. Настройка самой кассы — в «Инструкции администратора».
1. Что понадобится
- База 1С:УНФ на платформе 8.3 и веб-сервер (IIS или Apache) для публикации по HTTPS.
- Файл расширения
Томилов_v12.4.cfeили новее. Его выдаёт «Экспертиза учета». - Права администратора в базе и доступ к Конфигуратору для публикации.
2. Установка расширения
- Сделайте резервную копию базы.
- Откройте список расширений: раздел «Настройки» → «Печатные формы, отчеты и обработки» → «Расширения». Если раздела нет, откройте «Функции для технического специалиста» → «Стандартные» → «Управление расширениями конфигурации».
- Если расширение «Томилов» уже есть, выделите его и выберите «Ещё → Обновить из файла». Если нет, нажмите «Добавить из файла». Укажите
Томилов_v12.4.cfe. - У расширения снимите флажок «Безопасный режим». Приём чеков работает в привилегированном режиме, а в безопасном режиме он запрещён.
- Перезапустите 1С у всех пользователей.
При обновлении расширения данные регистра «Бонусы чеков Экспертиза» сохраняются.
3. Публикация HTTP-сервиса
- Запустите Конфигуратор от имени администратора Windows и выберите «Администрирование → Публикация на веб-сервере».
- Укажите имя публикации, например
unf, и веб-сервер. - На вкладке «HTTP сервисы» включите «Публиковать HTTP сервисы расширений по умолчанию» или отметьте сервис «Шлюз касс Экспертиза».
- Настройте на веб-сервере HTTPS. Адрес публикации должен открываться с касс.
Проверка: откройте в браузере https://<сервер>/<публикация>/hs/ekspertiza/ping и войдите под пользователем касс (раздел 4). Ответ начинается так:
{"ok": true, "service": "ekspertiza", "version": "2", "stores": [...], "priceTypes": [...]}
Этот же ответ нужен для настройки кассы (раздел 5).
4. Пользователь для касс
Кассы обращаются к 1С под отдельным пользователем. Интерактивно под ним не работают.
- «Настройки» → «Пользователи и права» → «Профили групп доступа» → «Создать». Назовите профиль «Пользователь касс Экспертиза» и отметьте роли:
- «Шлюз касс Экспертиза (пользователь касс)»;
- «Чтение сервер лояльности».
- «Группы доступа» → «Создать»: группа с этим профилем.
-
«Пользователи» → «Создать»:
- полное имя «Касса»;
- вход по аутентификации 1С:Предприятия;
- имя для входа, например
kassa; - надёжный пароль.
Включите пользователя в группу доступа из пункта 2.
-
Имя и пароль передайте администратору кассы: это настройки
onec.loginиonec.password.
Обработчики сервиса сами включают привилегированный режим, поэтому других прав пользователю касс не нужно.
5. Склад и вид цен кассы
Каждая касса работает с одним складом магазина и одним видом цен.
- Склад. Склад магазина из справочника «Структурные единицы». С этим складом сохраняются чеки кассы.
- Вид цен. Обычно розничный вид цен магазина. Цены на кассу берутся из регистра «Цены номенклатуры» по этому виду цен, последние актуальные на момент загрузки. Цена характеристики важнее цены номенклатуры без характеристики.
-
GUID склада и вида цен возьмите из ответа
…/hs/ekspertiza/ping:stores— склады, у каждого указан его розничный вид цен (priceType);priceTypes— все виды цен.
Их заносят в настройки кассы
onec.storeиonec.priceType.
Товар без цены приходит на кассу с ценой 0. Продать такой товар касса не даст и попросит проверить цену в 1С. После изменения цен нажмите на кассе «Товары из 1С».
6. Карточки номенклатуры
На кассу выгружается номенклатура с типом «Запас», «Услуга» или «Работа». Группы и помеченные на удаление элементы не выгружаются. Каждая характеристика становится отдельным товаром кассы с наименованием «Номенклатура, характеристика», например «Масло моторное 5W-30, 4 л».
Проверьте в карточках:
- Штрихкоды. По штрихкоду касса находит товар, в том числе по GTIN из кода маркировки. Штрихкод нужен у каждого товара, а при учёте по характеристикам — у каждой характеристики.
- Ставка НДС. Передаётся в чек. Если ставка не указана, касса пробьёт «Без НДС».
- Маркировка. У маркированного товара «Вид маркировки» отличается от «Не маркируется», и заполнен вид продукции ИС. Тогда касса требует сканировать код маркировки и проверяет его через ТС ПИоТ. Вид продукции определяет группу товара на кассе:
| Вид продукции ИС в 1С | На кассе |
|---|---|
| Моторные масла | Моторные масла |
| Шины и автопокрышки | Шины |
| Автозапчасти и комплектующие транспортных средств | Автозапчасти |
| Обувная продукция | Обувь |
| Духи и туалетная вода, парфюмерия и косметика | Парфюмерия |
| Товары лёгкой промышленности и одежда | Лёгкая промышленность |
| Остальные маркируемые виды | Иная маркированная продукция |
Проверка кода одинакова для всех групп.
- Продажа частями. В 1С отдельно не настраивается. Касса предлагает продать часть упаковки, когда «Честный знак» сообщает, что в упаковке несколько единиц.
- Товары комитентов. Касса считает товар комиссионным, если в карточке заполнены «Поставщик» и «Производитель», у них одинаковый ИНН и это не ИНН вашей организации. Агентские данные в чеке берутся из карточки комитента:
- ИНН;
- полное наименование (если не заполнено — краткое);
- телефоны из контактной информации. Телефон поставщика входит в обязательные агентские данные чека, заполните его.
После правки карточек нажмите на кассе «Товары из 1С».
7. Чеки кассы в 1С
Каждый пробитый чек касса отправляет в 1С. Чеки хранятся в регистре сведений «Бонусы чеков Экспертиза». Это журнал всех принятых чеков кассы, не только чеков с бонусами. Открыть его можно через «Функции для технического специалиста» → «Регистры сведений» → «Бонусы чеков Экспертиза».
Если команды «Функции для технического специалиста» нет, включите её: «Настройки» → «Общие настройки» (или меню «Вид» → «Параметры») → «Отображать команду "Функции для технического специалиста"».
| Поле | Что в нём |
|---|---|
| UUID чека кассы | Уникальный номер чека. Повторная отправка того же чека ничего не меняет |
| Тип чека | SELL — продажа, PAYBACK — возврат |
| Дата чека, Номер чека, Номер смены | Как на чеке кассы |
| Склад магазина | Склад из настроек кассы |
| Сумма чека | Сумма по строкам |
| UUID чека продажи | Для возврата по чеку — какой чек продажи возвращён |
| Дисконтная карта, Списано / Начислено баллов, Оплачено бонусами | Бонусы чека, если были |
| Ошибка | Что не удалось при обработке бонусов (например, не найдена карта) |
| Отчет о розничных продажах | Отчёт, в который вошёл чек |
| Данные чека (JSON) | Полный состав чека: строки, коды маркировки, оплаты, кассир |
На кассе то же видно в журнале «Чеки»: у отправленного чека стоит отметка «в 1С ✓».
Ошибки приёма чеков записываются в журнал регистрации с событием «Шлюз Экспертиза».
8. Бонусы
Если в чеке есть бонусы, 1С при приёме чека резервирует списание и начисление баллов на сервере лояльности. Сами бонусы проводит отчёт о розничных продажах, после этого резерв снимается. При возврате бонусы чека продажи сторнируются пропорционально сумме возврата.
9. Что пока не автоматизировано
- Отчёт о розничных продажах по чекам кассы «Экспертиза». Чеки уже лежат в 1С целиком, со складом, сменой, составом и оплатами. Отчёт по ним собирается автоматически в следующей версии. До этого оформляйте отчёт о розничных продажах по смене в 1С обычным порядком, сверяя с журналом чеков.
- Списание и начисление бонусов на кассе «Экспертиза». 1С бонусы принимает, на кассе их ввод появится в следующей версии.
10. Если что-то не работает
| Признак | Что проверить |
|---|---|
…/hs/ekspertiza/ping не открывается |
Публикация на веб-сервере, HTTPS, сервис «Шлюз касс Экспертиза» отмечен для публикации |
| Ответ 401 | Имя и пароль пользователя касс |
| Ответ 403 или ошибка прав | Профиль пользователя касс: обе роли из раздела 4 |
| Ошибка про безопасный режим или привилегированный режим | У расширения снят флажок «Безопасный режим» |
| На кассе нет товара | Тип номенклатуры, пометка удаления, штрихкод у товара или характеристики |
| Цена на кассе 0 | Цена по виду цен из onec.priceType для этого товара или характеристики |
| Маркированный товар продаётся без кода | «Вид маркировки» и вид продукции ИС в карточке |
| Нет агентских данных в чеке | Поставщик и производитель с одинаковым ИНН комитента, телефон у комитента |
| Чек не дошёл до 1С | Журнал «Чеки» на кассе, журнал регистрации 1С (событие «Шлюз Экспертиза»), поле «Ошибка» в регистре |