Как интегрировать эквайринговый терминал Сбербанка Kozen P12 с конфигурацией 1С:УПП 1.3?

Программист 1С v8.3 (Обычные формы) Управленческий учет Торговля и дистрибуция
← На главную

Интеграция современного банковского оборудования с классическими конфигурациями на базе обычных форм, такими как 1С:Управление производственным предприятием (УПП), часто вызывает вопросы у технических специалистов. Особенно это касается новых Android-терминалов типа Kozen P12, которые пришли на смену привычным кнопочным моделям Verifone или PAX. В рамках данной статьи мы подробно разберем процесс сопряжения этого устройства с 1С, выясним причины возможных ошибок и проанализируем необходимые программные компоненты.

Шаг 1. Поиск и подготовка обработки обслуживания

Начнем с того, что 1С не взаимодействует с терминалом напрямую. Обмен данными происходит через промежуточное звено — обработку обслуживания (файл .epf) и банковскую динамическую библиотеку. Разберем, где взять актуальные файлы. В типовых поставках УПП нужные компоненты уже включены в состав шаблонов конфигурации.

Рассмотрим стандартный путь к каталогу шаблонов, где обычно располагаются файлы торгового оборудования:

C:\Users\ИмяПользователя\AppData\Roaming\1C\1c8\tmplts\1c\enterprise\1_3_XXX_X\TradeWareEpf

Здесь 1_3_XXX_X — это номер версии вашей конфигурации. Проанализируем содержимое этой папки. Нам необходим файл SberBankES_v2.epf (или более новая версия, если она присутствует). Эту обработку нужно будет подключить в 1С через меню Сервис — Торговое оборудование — Подключение и настройка торгового оборудования на закладке «Эквайринговые системы» — для настройки ККТ пригодится подключение ККТ АТОЛ и Штрих-М в 1С:УПП. В некоторых случаях, когда требуется поддержка более современных протоколов на архитектурах x64, может потребоваться специализированная обработка обслуживания «Эквайринговые терминалы Сбербанк 2.Х», которая корректно работает с новыми драйверами от 1С.

Шаг 2. Регистрация библиотек в операционной системе

Для того чтобы 1С могла «общаться» с банковским софтом, в системе должны быть зарегистрированы COM-объекты. Традиционно Сбербанк использует библиотеки SBRF.dll и SBRFCOM.dll. Выясним, как правильно их инициализировать.

Обычно банковские специалисты устанавливают ПО в корень диска С в папку sc552 или sbrf. Перейдем в этот каталог и выполним регистрацию компонентов от имени администратора. Для этого запустим командную строку (cmd) и введем следующие команды:


regsvr32 "C:\sc552\SBRF.dll"
regsvr32 "C:\sc552\SBRFCOM.dll"

Важный нюанс: если вы используете 64-битную операционную систему, а 1С работает в 32-битном режиме (что стандартно для УПП), убедитесь, что библиотеки регистрируются корректно. В некоторых случаях для работы с современными Android-терминалами, такими как Kozen P12, может потребоваться обновленная библиотека SberBankExchange.dll, которая лучше справляется с протоколами обмена смарт-терминалов.

Шаг 3. Специфика настройки терминала Kozen P12

Проанализируем особенности самой модели Kozen P12. Поскольку это устройство на базе Android, оно значительно отличается по логике работы от старых терминалов. Посмотрим на критические настройки, которые должны быть выполнены на стороне устройства и в конфигурационных файлах:

  1. Режим работы: Зайдите в сервисное меню терминала и убедитесь, что выбран «Интегрированный режим» или «Работа с ККМ». Если терминал находится в автономном режиме, 1С его не «увидит».
  2. Тип соединения: Kozen P12 может подключаться по USB (эмуляция сетевой карты RNDIS или COM-порта), Ethernet или Wi-Fi.
  3. Файл конфигурации pinpad.ini: Это «сердце» настроек драйвера Сбербанка. Откроем этот файл в папке с банковским ПО и проверрим ключевые параметры:

[Communications]
ComPort=10 (номер порта, если подключение через USB-COM)
; Если подключение по сети:
; IPAddress=192.168.1.50
; Port=8888

Если используется USB-подключение, обязательно проверим в диспетчере устройств Windows, какой именно порт назначился устройству. Для Kozen P12 часто требуются специфические драйверы CDC-ACM от производителя для корректной эмуляции порта.

Шаг 4. Настройка параметров в 1С:УПП

Теперь перейдем к настройке внутри программы. В форме настройки торгового оборудования выберем нашу обработку SberBankES_v2.epf и нажмем кнопку «Параметры». Рассмотрим основные поля для заполнения:

Выясним причину, по которой может возникнуть ошибка «Объект не найден». Это часто происходит, если 1С запущена без прав администратора при первом обращении к зарегистрированным DLL. Рекомендуем выполнить первый запуск и тест устройства под учетной записью с повышенными правами.

Шаг 5. Тестирование связи через sb_pilot

Прежде чем пытаться провести оплату из документа «Чек ККМ» или «Оплата от покупателя платежной картой», крайне важно проверить работоспособность связки «Компьютер — Терминал» вне рамок 1С. Для этого в ПО Сбербанка предусмотрена утилита sb_pilot.exe.

Рассмотрим алгоритм тестирования через командную строку:

  1. Откройте командную строку.
  2. Перейдите в папку с банковским ПО: cd C:\sc552.
  3. Запустите команду сверки итогов или оплаты на 1 рубль: sb_pilot.exe 1 100.

Если терминал ожидает прикладывания карты — значит, физический канал связи и настройки в pinpad.ini верны. Если же sb_pilot выдает ошибку, то проблему нужно искать в кабеле, портах или версии ПО UPOS (Pilot). Для Kozen P12 версия UPOS должна быть не ниже 31.xx.

Шаг 6. Печать чеков и слип-чеков

Разберем ситуацию с печатью чеков. У Kozen P12 есть встроенный принтер, но при работе с 1С:УПП правила диктуют печать фискального чека и банковского слипа на одном устройстве — фискальном регистраторе (ККТ). При настройке вывода данных на кассу важно учитывать требования законодательства, в чем поможет эмулятор ККТ ФФД 1.2 (удобнее через инструмент для работы онлайн-касс по ФФД 1.2), поддерживающий разрешительный режим и новые ставки НДС для обычных форм.

Проанализируем настройки печати в 1С:

Заключение

Подключение Kozen P12 к 1С:УПП 1.3 — задача вполне решаемая стандартными средствами. Главное — помнить, что 1С работает не с конкретным «железом», а с библиотеками Сбербанка. Помимо традиционного эквайринга, сегодня актуально внедрение современных способов оплаты, таких как обслуживание QR дисплеев и Система быстрых платежей для УПП 1.3, что позволяет сократить издержки на комиссии банков.

Если библиотеки зарегистрированы (regsvr32), файл pinpad.ini настроен на правильный порт или IP, а версия ПО Pilot актуальна, то интеграция пройдет успешно. Посмотрите внимательно на версию вашей конфигурации: если она очень старая, возможно, потребуется небольшая адаптация кода обработки обслуживания в части обработки ответа от терминала, но в большинстве случаев SberBankES_v2.epf справляется с задачей «из коробки».

← На главную