Как подключить эквайринговый терминал Ingenico iPP320 с ПО Arcus 2 к 1С:Управление торговлей 10.3?

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

При автоматизации рабочего места кассира часто возникает задача интеграции пин-пада Ingenico iPP320, работающего под управлением программного обеспечения Arcus 2, с конфигурацией «1С:Управление торговлей 10.3». Банковские специалисты на этапе установки нередко ограничиваются проверкой связи через собственную сервисную утилиту и эмуляцией COM-порта, оставляя настройку со стороны 1С специалистам предприятия.

Разберем причины возникающих сложностей и проанализируем практические способы подключения данного оборудования к УТ 10.3.

Почему терминал Arcus 2 отсутствует в типовом списке оборудования УТ 10.3

Выясним причину, по которой типовая конфигурация УТ 10.3 не содержит встроенного драйвера для Arcus 2. Конфигурация «1С:Управление торговлей 10.3» построена на классической архитектуре торгового оборудования на обычных формах. Большинство современных сертифицированных драйверов эквайринга от разработчиков процессингового ПО создаются под Библиотеку подключаемого оборудования (БПО), которая используется в управляемых конфигурациях (УТ 11, Розница 2 и 3, ERP).

Для взаимодействия УТ 10.3 с ПО Arcus 2 требуется внешняя обработка обслуживания, поддерживающая протокол Arcus 2 CAP или прямое взаимодействие с компонентами поставки банка.

Способ 1: Прямая интеграция через COM-библиотеку ArcCom.dll

Рассмотрим наиболее надежный программный способ интеграции без покупки сторонних модулей. В рабочем каталоге установленного банковского клиента (по умолчанию это C:\Arcus2 или C:\Arccus2) поставляется библиотека ArcCom.dll.

Разберем по шагам порядок подключения через COM-объект:

  1. Регистрация библиотеки в операционной системе: откроем командную строку от имени администратора и выполним регистрацию компоненты: regsvr32 "C:\Arcus2\ArcCom.dll"
  2. Инициализация объекта в коде 1С: создадим внешнюю обработку обслуживания эквайринга или модифицируем типовую, подключив COM-объект.
  3. Вызов банковских операций: проанализируем пример кода для инициализации объекта и передачи суммы оплаты:
    
    Попытка
        ОбъектДрайвера = Новый COMОбъект("ArcCom.ArcCom");
    Исключение
        Сообщить("Не удалось инициализировать COM-объект ArcCom: " + ОписаниеОшибки());
        Возврат;
    КонецПопытки;
    
    // Настройка параметров подключения к терминалу
    ОбъектДрайвера.Port = НомерComПорта; // Например, 3 для COM3
    ОбъектДрайвера.Speed = 115200;
    
    // Выполнение финансовой транзакции
    СуммаКопейки = СуммаДокумента * 100;
    Результат = ОбъектДрайвера.Pay(СуммаКопейки);
    
    Если Результат = 0 Тогда
        ТекстСлипЧека = ОбъектДрайвера.Cheque;
        КодАвторизации = ОбъектДрайвера.AuthCode;
        НомерСсылки = ОбъектДрайвера.RRN;
        // Печать слип-чека и сохранение данных в документе
    Иначе
        Сообщить("Ошибка проведения оплаты. Код ошибки: " + Строка(Результат));
    КонецЕсли;
    

Способ 2: Интеграция через командную строку (файловый обмен)

Если регистрация COM-компоненты вызывает конфликты разрядности или блокируется политиками безопасности, рассмотрим вариант взаимодействия через утилиту командной строки из каталога Arcus2 (например, rcp.exe или cashreg.exe).

Посмотрим на схему работы этого механизма:

  1. Обработка 1С формирует текстовый командный файл с кодом операции и суммой платежа.
  2. Вызывается исполняемый файл через метод ЗапуститьПриложение() с флагом ожидания завершения:
    
    КомандаЗапуска = "C:\Arcus2\rcp.exe /o1 /s" + Формат(СуммаДокумента * 100, "ЧГ=0");
    ЗапуститьПриложение(КомандаЗапуска, "C:\Arcus2", Истина);
    
  3. После завершения процесса 1С считывает сформированный терминалом файл ответа (содержащий статус операции, код авторизации и сформированный слип-чек) и выводит его на печать.

Способ 3: Использование готового модуля или запрос во вторую линию поддержки банка

Проанализируем варианты получения готовой внешней обработки:

  1. Запрос во вторую линию поддержки эквайринга банка: большинство банков, работающих на процессинге Arcus 2, имеют внутренние архивы готовых обработок обслуживания эквайринговых терминалов (в формате .epf) для обычных форм платформы 1С:Предприятие 8.2 и 8.3. Персональный менеджер или инженер второй линии техподдержки банка может предоставить готовую обработку.
  2. Приобретение специализированного модуля: для взаимодействия УТ 10.3 и Arcus 2 компанией-разработчиком предлагается готовый модуль «Обработка Эквайринга ARCOM-Arcus2» (АС1), который встраивается в стандартный справочник «Обработки обслуживания ТО».

Важные технические требования и нюансы настройки

При настройке рабочего места кассира обязательно учтем следующие ограничения:

  1. Разрядность клиента 1С: библиотека ArcCom.dll является 32-разрядной. Для корректной работы COM-соединения клиентское приложение 1С:Предприятие на рабочем месте должно быть разрядности x86 (32 бит).
  2. Права доступа к каталогу Arcus: терминал непрерывно формирует лог-файлы и временные файлы чеков. Пользователю операционной системы, под которым выполняется вход в 1С, необходимо предоставить полные права (чтение, запись, изменение) на рабочий каталог C:\Arcus2.
  3. Фиксация номера виртуального COM-порта: в «Диспетчере устройств» Windows для устройства Ingenico iPP320 закрепим постоянный номер COM-порта. При переключении терминала в другие USB-порты системного блока номер порта не должен изменяться, иначе связь будет потеряна.
← На главную