Руководство пользователя

ПМСР для 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С.

  1. Скопируйте файлы ЧЕКККМ_ТСПИоТ.epf и ТСПИоТ_настройки.epf в папку на рабочем месте кассира.
  2. Установите драйвер ККТ 10-й версии и проверьте, что касса отвечает (тест связи в программе драйвера).
  3. Убедитесь, что ТС ПИоТ запущен и подключён к ККТ.
  4. В 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. Порядок работы

Обработка печати чеков работает с документами: Чек, Чек на оплату, Приходный кассовый ордер, Расходный кассовый ордер. Вид чека определяется документом: приход (продажа) или расход.

  1. Откройте ЧЕКККМ_ТСПИоТ.epf и выберите документ, по которому нужно пробить чек. В форме заполнятся таблица товаров, способы оплаты, организация и система налогообложения.
  2. Для позиций с признаком предмета расчёта «Товар, имеющий код маркировки» укажите код маркировки.
  3. Проверьте строки таблицы. Если в строке есть ошибка, программа выведет сообщение с номером строки и не пробьёт чек, пока ошибка не исправлена или признак не снят.
  4. Проверьте способы оплаты и суммы. Если чек нужно отправить покупателю в электронном виде, отметьте «Электронный чек» и укажите e-mail или телефон покупателя.
  5. Нажмите «Пробить чек». Программа подключится к кассе, выполнит вход кассира и проверит коды маркировки в ТС ПИоТ.
  6. Если продажа всех маркированных позиций разрешена, чек откроется, позиции будут зарегистрированы, чек закроется. Идентификатор проверки попадёт в отраслевой реквизит чека (тег 1265).

Если продажа запрещена или код не проверен, чек не пробивается: появится сообщение «Продажа маркированного товара запрещена или не проверена через ТС ПИоТ», причины для каждой строки выводятся в окне сообщений.

Операции возврата выполняются тем же порядком, но коды маркировки при возврате в ТС ПИоТ не проверяются.

Другие операции кассира

  • X-отчёт;
  • внесение и выемка наличных;
  • закрытие смены.

6. Сообщения и действия при ошибках

СообщениеПричина и действие
Не удалось подключиться к кассе. Порт занят, или касса выключенаПроверьте питание и подключение кассы, закройте другие программы, занимающие порт, проверьте адрес или COM-порт в данных организации
ТС ПИоТ: не удалось загрузить движок проверкиФайл обработки собран без модуля проверки или повреждён. Используйте поставляемый файл ЧЕКККМ_ТСПИоТ.epf
ТС ПИоТ: не заполнен Токен ПМСРОткройте ТСПИоТ_настройки.epf под этим же пользователем, заполните сведения о ПМСР и сохраните настройки
ТС ПИоТ, строка N: ошибка запросаТС ПИоТ недоступен. Проверьте, что он запущен, и адрес в настройках. Нажмите «Проверить связь»
Проверка не выполнена. Повторите через несколько секундВременный сбой ГИС МТ или ТС ПИоТ. Повторите пробитие. Если ошибка не уходит, проверьте ТС ПИоТ и драйвер ККТ
ПРОДАЖА ЗАПРЕЩЕНАКод не прошёл проверку допуска (например, выведен из оборота, не найден, истёк срок годности). Продажа этого кода невозможна, причина указана в сообщении
Аварийный режим ГИС МТ, продажа разрешена без проверкиГИС МТ работает в аварийном режиме, проверка не требуется. Чек пробивается без отраслевого реквизита
Код не проверен, продажа разрешена по настройкеПроверка не выполнена из-за сбоя, продажа разрешена параметром «Разрешать продажу». При необходимости смените параметр на «Запрещать продажу»

7. Поддержка

По вопросам установки, настройки и работы программы обращайтесь к разработчику:

ИП Грушкин Виталий Борисович, г. Барнаул
Телефон: +7 913 210 36 92
Почта: [email protected]

Для ускорения ответа приложите журнал запросов (каталог указан в настройках), текст сообщения из окна сообщений 1С и описание действий, после которых возникла ошибка.