ПМСР для 1С:УТ 10.3, Альфа-Авто 5.0 и 1С:КА 1
Работа с ТС ПИоТ при печати чеков на ККТ АТОЛ. Версия программы 1.0.0. Разработчик: ИП Грушкин Виталий Борисович.
1. Назначение
ПМСР (программное обеспечение, работающее с ТС ПИоТ при продаже маркированных товаров) встраивается в учётную систему на базе 1С:УТ 10.3, Альфа-Авто 5.0 или 1С:КА 1 и расширяет предварительный просмотр и печать кассовых чеков:
- перед открытием чека продажи проверяет коды маркировки через ТС ПИоТ;
- разрешает или запрещает продажу по результату проверки;
- передаёт в чек идентификатор проверки (тег 1265);
- после ответа ТС ПИоТ проверяет код в фискальном накопителе ККТ и регистрирует позицию в чеке.
Программа поставляется в виде двух внешних обработок 1С:
ЧЕКККМ_ТСПИоТ.epf— печать чеков и операции кассира; содержит встроенный движок проверки ТС ПИоТ;ТСПИоТ_настройки.epf— нужна только для сохранения настроек подключения и запуска стенда проверки сценариев.
2. Требования
| Компонент | Требование |
|---|---|
| Учётная система | 1С:Предприятие 8.3, конфигурации 1С:УТ 10.3, Альфа-Авто 5.0, 1С:КА 1 |
| Операционная система | Windows, на рабочем месте кассира |
| Касса | ККТ АТОЛ с поддержкой маркировки; на компьютере установлен драйвер ККТ 10-й версии (компонента AddIn.Fptr10), касса подключена по COM-порту или по сети (IP-адрес и порт) |
| ТС ПИоТ | Запущен и доступен с компьютера кассира; по умолчанию адрес https://localhost:51401 (профиль «ЕСМ») |
| Данные кассы в базе | В справочнике «Организации» заполнены ИНН и реквизиты подключения кассы: КомПортККМ (COM-порт или IP-адрес кассы), АпиПортККМ (порт при подключении по сети), КассирККМ (кассир, ИНН кассира в псевдониме) |
3. Установка
Важно: обработка подключается квалифицированным специалистом 1С, потому что в конфигурацию вносятся определённые доработки, в том числе добавляются недостающие поля (см. раздел 2). Подключить её может ваш специалист 1С либо наш программист.
Сами обработки запускаются как внешние файлы и не заменяют конфигурацию 1С.
- Скопируйте файлы
ЧЕКККМ_ТСПИоТ.epfиТСПИоТ_настройки.epfв папку на рабочем месте кассира. - Установите драйвер ККТ 10-й версии и проверьте, что касса отвечает (тест связи в программе драйвера).
- Убедитесь, что ТС ПИоТ запущен и подключён к ККТ.
- В 1С:Предприятии откройте файл
ТСПИоТ_настройки.epf(меню «Файл» → «Открыть») и выполните настройку по разделу 4.
4. Настройка подключения к ТС ПИоТ
Настройки хранятся отдельно для каждого пользователя 1С. Выполняйте настройку под тем пользователем, который будет работать на кассе.
В окне «Настройки подключения к ТС ПИоТ» доступны разделы:
| Раздел / параметр | Назначение |
|---|---|
| Адрес ТС ПИоТ | Адрес сервиса. По умолчанию https://localhost:51401 (профиль «ЕСМ») |
| Версия API | Версия протокола обмена. Рекомендуется v2 |
| Таймаут запроса, мс | Сколько ждать ответа ТС ПИоТ |
| При недоступности ГИС МТ / техсбое ТС ПИоТ | «Разрешать продажу» или «Запрещать продажу» — действие, если проверка не выполнена из-за сбоя |
| Сведения о ПМСР (client_info) | Наименование и версия ПМСР, идентификатор (id) и токен (token). Подробнее: «Токен и идентификатор ПМСР» ниже |
| ФИО кассира (user_name) | Имя кассира, передаваемое в запросах |
| Касса | Номер ФН и ИНН организации |
| Каталог журнала запросов | Куда писать журнал обмена. По умолчанию — временный каталог системы |
Кнопки окна:
- Установить профиль ЕСМ — заполняет параметры для рабочего подключения к ТС ПИоТ;
- Проверить связь — проверяет доступность ТС ПИоТ, результат выводится в поле «Результат проверки связи»;
- Сохранить настройки — сохраняет значения;
- Открыть АРМ кассира и Открыть стенд ПФС — рабочее место кассира и стенд проверки сценариев.
Для тестирования предусмотрены профили «Песочница» и «Эмулятор»: они задают адрес тестового ТС ПИоТ и тестовые значения client_info.
Порядок настройки: нажмите «Установить профиль ЕСМ» (или задайте параметры вручную), внесите сведения о ПМСР, нажмите «Сохранить настройки», затем «Проверить связь». Если токен ПМСР не заполнен, продажа маркированного товара будет запрещена с соответствующим сообщением.
Токен и идентификатор ПМСР
В профиле «ЕСМ» токен ПМСР подставляется программой автоматически, вводить его не нужно. Идентификатор ПМСР вносится в настройки после того, как оператор выдаст его по итогам проверки в Реестре интеграторов. Для тестирования предусмотрены профили «Песочница» и «Эмулятор» с демонстрационными значениями client_info.
Стенд проверки сценариев
Стенд запускается кнопкой «Стенд ПФС» в АРМ кассира (также из окна настроек кнопкой «Открыть стенд ПФС»). Он автоматически проверяет 21 сценарий из программы проверки функциональной совместимости и формирует протокол прогона. Сценарии 5.15–5.20 (дубль кода в чеке, повторная продажа, офлайн-режим) проверяются вручную.
5. Порядок работы
Обработка печати чеков работает с документами: Чек, Чек на оплату, Приходный кассовый ордер, Расходный кассовый ордер. Вид чека определяется документом: приход (продажа) или расход.
- Откройте
ЧЕКККМ_ТСПИоТ.epfи выберите документ, по которому нужно пробить чек. В форме заполнятся таблица товаров, способы оплаты, организация и система налогообложения. - Для позиций с признаком предмета расчёта «Товар, имеющий код маркировки» укажите код маркировки.
- Проверьте строки таблицы. Если в строке есть ошибка, программа выведет сообщение с номером строки и не пробьёт чек, пока ошибка не исправлена или признак не снят.
- Проверьте способы оплаты и суммы. Если чек нужно отправить покупателю в электронном виде, отметьте «Электронный чек» и укажите e-mail или телефон покупателя.
- Нажмите «Пробить чек». Программа подключится к кассе, выполнит вход кассира и проверит коды маркировки в ТС ПИоТ.
- Если продажа всех маркированных позиций разрешена, чек откроется, позиции будут зарегистрированы, чек закроется. Идентификатор проверки попадёт в отраслевой реквизит чека (тег 1265).
Если продажа запрещена или код не проверен, чек не пробивается: появится сообщение «Продажа маркированного товара запрещена или не проверена через ТС ПИоТ», причины для каждой строки выводятся в окне сообщений.
Операции возврата выполняются тем же порядком, но коды маркировки при возврате в ТС ПИоТ не проверяются.
Другие операции кассира
- X-отчёт;
- внесение и выемка наличных;
- закрытие смены.
6. Сообщения и действия при ошибках
| Сообщение | Причина и действие |
|---|---|
| Не удалось подключиться к кассе. Порт занят, или касса выключена | Проверьте питание и подключение кассы, закройте другие программы, занимающие порт, проверьте адрес или COM-порт в данных организации |
| ТС ПИоТ: не удалось загрузить движок проверки | Файл обработки собран без модуля проверки или повреждён. Используйте поставляемый файл ЧЕКККМ_ТСПИоТ.epf |
| ТС ПИоТ: не заполнен Токен ПМСР | Откройте ТСПИоТ_настройки.epf под этим же пользователем, заполните сведения о ПМСР и сохраните настройки |
| ТС ПИоТ, строка N: ошибка запроса | ТС ПИоТ недоступен. Проверьте, что он запущен, и адрес в настройках. Нажмите «Проверить связь» |
| Проверка не выполнена. Повторите через несколько секунд | Временный сбой ГИС МТ или ТС ПИоТ. Повторите пробитие. Если ошибка не уходит, проверьте ТС ПИоТ и драйвер ККТ |
| ПРОДАЖА ЗАПРЕЩЕНА | Код не прошёл проверку допуска (например, выведен из оборота, не найден, истёк срок годности). Продажа этого кода невозможна, причина указана в сообщении |
| Аварийный режим ГИС МТ, продажа разрешена без проверки | ГИС МТ работает в аварийном режиме, проверка не требуется. Чек пробивается без отраслевого реквизита |
| Код не проверен, продажа разрешена по настройке | Проверка не выполнена из-за сбоя, продажа разрешена параметром «Разрешать продажу». При необходимости смените параметр на «Запрещать продажу» |
7. Поддержка
По вопросам установки, настройки и работы программы обращайтесь к разработчику:
ИП Грушкин Виталий Борисович, г. Барнаул
Телефон: +7 913 210 36 92
Почта: [email protected]
Для ускорения ответа приложите журнал запросов (каталог указан в настройках), текст сообщения из окна сообщений 1С и описание действий, после которых возникла ошибка.