Интеграция INPAS с 1С Розница: от подключения до первой транзакции

Интеграция платежного терминала INPAS PayBox с конфигурацией 1С:Розница является критически важным этапом автоматизации торгового процесса. Корректная настройка связки позволяет исключить ручной ввод сумм, избежать кассовых разрывов и автоматически формировать документы возврата. Несмотря на стандартизацию протоколов обмена, процесс сопряжения часто вызывает затруднения у системных администраторов из-за различий в версиях драйверов и особенностях аппаратных портов.

В данной статье мы детально разберем архитектурные особенности взаимодействия кассового ядра 1С с внешним ПО INPAS Integration Wrapper. Вы узнаете, как настроить COM-соединение, какие параметры критичны для прохождения платежей и как диагностировать сбои на уровне операционной системы. Особое внимание будет уделено нюансам работы с современными моделями терминалов, поддерживающими бесконтактную оплату и операции с лояльностью.

Перед началом практических действий убедитесь, что у вас есть права администратора на рабочей станции кассира и установлен необходимый комплект драйверов. Неправильная инициализация порта на ранних этапах может привести к тому, что 1С будет видеть устройство, но не сможет передать команду на проведение оплаты. Мы рассмотрим как классическую схему через COM-порт, так и более современные методы эмуляции.

Подготовительный этап и проверка оборудования

Первым шагом является физическое подключение устройства к компьютеру или сетевой инфраструктуре магазина. В зависимости от модели INPAS, соединение может осуществляться через последовательный порт RS-232, USB-эмулятор COM-порта или Ethernet. Для стабильной работы в среде 1С:Розница настоятельно рекомендуется использовать выделенный COM-порт, даже если подключение идет через USB-адаптер.

Проверьте индикаторы на корпусе терминала. Зеленый сигнал готовности обычно свидетельствует об успешной загрузке прошивки и наличии связи с банком-эквайером. Если индикатор мигает красным или желтым, необходимо проверить целостность кабеля питания и телефонной линии (для моделей с GSM/GPRS модулем). Важно: IP-адрес терминала в сетевом режиме должен быть статическим и находиться в одной подсети с кассовым компьютером.

На уровне операционной системы Windows необходимо убедиться, что порт определен корректно. Откройте «Диспетчер устройств» и найдите раздел «Порты (COM и LPT)». Зайдите в свойства вашего адаптера, перейдите на вкладку «Параметры порта» и установите скорость обмена данными 9600 бит/с (или ту, что указана в паспорте устройства), 8 бит данных, без четности, 1 стоповый бит. Эти параметры должны строго совпадать с настройками, которые вы впоследствии укажете в 1С.

Установка и настройка внешнего обработчика INPAS

Для корректного обмена данными между 1С и терминалом требуется промежуточное программное обеспечение — драйвер или обработчик. В большинстве случаев используется компонент INPAS Integration Wrapper или специализированный драйвер, поставляемый компанией-интегратором. Установка производится на компьютер кассира под учетной записью с правами администратора.

После инсталляции ПО необходимо произвести первичную конфигурацию самого обработчика. Запустите утилиту настройки драйвера. Здесь вам потребуется указать тип подключения (COM или TCP/IP) и номер порта. Если вы используете сетевое подключение, введите IP-адрес терминала и порт сокета (стандартно 3000 или 5000). Также в этом окне часто требуется задать путь к лог-файлам для отладки.

Существует важный нюанс совместимости версий. Драйверы INPAS могут иметь разные версии API, и не все из них поддерживаются актуальными релизами 1С:Розница 2.x. Перед установкой сверьтесь с таблицей совместимости на сайте фирмы-разработчика конфигурации или в документации к драйверу. Использование устаревшей библиотеки .dll может привести к ошибке «Не найден объект» при попытке вызова метода оплаты.

⚠️ Внимание: При обновлении операционной системы Windows (например, переход с 10 на 11 версию) драйверы COM-портов могут сброситься на стандартные. Обязательно перепроверьте настройки скорости и стоп-битов после крупных обновлений ОС, иначе терминал перестанет отвечать на команды 1С.

Регистрация оборудования в интерфейсе 1С Розница

После того как программная часть установлена и протестирована отдельно от 1С, необходимо зарегистрировать терминал в самой конфигурации. Зайдите в раздел НСИ и Администрирование, затем выберите пункт Торговое оборудование. Нажмите кнопку «Создать» и выберите тип оборудования «Терминал сбора данных» или специализированный тип «Платежный терминал», если такой доступен в вашей версии.

В карточке оборудования заполните основные реквизиты. В поле «Наименование» укажите понятное имя, например, INPAS PayBox 01. В поле «Модель» выберите из списка соответствующую версию драйвера (например, INPAS PayBox COM). Критически важным параметром является поле «Порт». Здесь нужно выбрать тот самый COM-порт или сетевой адрес, который вы настроили на предыдущих этапах.

Далее перейдите на вкладку настроек подключения. Убедитесь, что галочка «Использовать» активна. В некоторых конфигурациях требуется указать таймаут ожидания ответа от терминала. Стандартное значение составляет 30000 миллисекунд. Увеличение этого параметра может помочь при нестабильном канале связи, но замедлит реакцию кассовой программы в случае сбоя.

Параметр настройки	Рекомендуемое значение	Описание влияния на работу
Скорость порта (Baud Rate)	9600	Несовпадение приведет к кракозябрам в логах и отсутствию реакции
Таймаут соединения	30 сек	Время ожидания ответа от банка при проведении транзакции
Режим эмуляции	Авто / COM	Определяет метод опроса устройства драйвером 1С
Печать чека	На терминале	Указывает, где печатать слип-чек (на самом INPAS или на фискальнике)

Настройка параметров проведения платежей и фискализация

Современные требования законодательства (54-ФЗ) диктуют жесткие правила фискализации платежей. При подключении INPAS к 1С:Розница необходимо настроить передачу данных о способе оплаты в фискальный накопитель. В настройках вида оплаты в справочнике Виды оплат создайте новый элемент, например, «Банковская карта», и привяжите его к зарегистрированному оборудованию.

Важно правильно настроить тип операции. Для классической продажи выбирается режим Оплата. Если ваш бизнес-процесс предполагает предварительную авторизацию (холдирование средств) с последующим подтверждением, необходимо активировать соответствующую опцию в настройках драйвера. Однако, для большинства розничных точек рекомендуется использовать режим прямой продажи (Sale) для упрощения документооборота.

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

Что такое холдирование средств?

Холдирование (блокировка) — это временная резервация суммы на карте клиента без фактического списания. Средства списываются только после подтверждения операции кассиром в 1С. Это полезно для интернет-магазинов или при предзаказах, но усложняет процесс возврата на обычной кассе.

Диагностика проблем и анализ логов

Даже при идеальной настройке могут возникать сбои связи. Первым признаком проблемы является сообщение 1С «Ошибка связи с оборудованием» или бесконечное вращение индикатора загрузки при попытке оплаты. В этом случае первоочередной задачей является локализация узла сбоя: проблема в кабеле, в драйвере, в самом терминале или в конфигурации 1С.

Для глубокой диагностики используйте журнал регистрации 1С и логи драйвера INPAS. Включите расширенное логирование в настройках торгового оборудования. Логи обычно сохраняются в папке C:\ProgramData\INPAS\Logs или в каталоге установки 1С. Ищите записи с метками Send (отправка команды) и Receive (получение ответа).

Если в логах видно, что команда уходит, но ответа нет (Timeout), проблема физическая (кабель, порт) или терминал «завис». Если команда уходит и приходит ответ с кодом ошибки (например, Error 05), значит, связь есть, но терминал отклоняет операцию (неверная сумма, отсутствие связи с банком, истекший срок действия карты). Коды ошибок расшифровываются в технической документации к конкретной модели.

⚠️ Внимание: Никогда не перезагружайте терминал INPAS кнопкой выключения во время транзакции. Это может привести к рассинхронизации статусов: деньги спишутся у клиента, а в 1С чек не пробьется. В таких случаях требуется ручная отмена операции через меню терминала или процедуру сверки итогов.

Особенности возврата и отмены операций

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

При оформлении возврата в 1С убедитесь, что в документе выбран правильный вид оплаты «Банковская карта». После нажатия кнопки «Провести и закрыть», система отправит команду на терминал. Клиент должен будет вставить карту и ввести ПИН-код. Терминал INPAS автоматически определит тип операции как Refund (возврат) и проведет зачисление.

В случае, если оригинальный чек утерян или не найден в базе, некоторые модели терминалов позволяют сделать «слепой» возврат (Manual Refund), введя номер исходной транзакции вручную. Однако такая операция требует повышенной осторожности и согласования с бухгалтерией, так как она не привязана автоматически к документу реализации в 1С и может создать расхождения в учете.

Часто задаваемые вопросы (FAQ)

Терминал пищит при подключении, но 1С его не видит. В чем причина?

Скорее всего, выбран неверный COM-порт в настройках 1С. Проверьте в Диспетчере устройств Windows, какой номер порта присвоен вашему USB-адаптеру. Также убедитесь, что порт не занят другим приложением (например, программой для весов или сканера).

Можно ли подключить несколько терминалов INPAS к одной кассе 1С?

Да, это возможно. Вам необходимо создать несколько записей в справочнике «Торговое оборудование», присвоив каждому терминалу уникальный порт (COM1, COM2 и т.д.) или IP-адрес. В документе продажи вы сможете выбирать, на какой именно терминал отправить платеж.

Что делать, если терминал выдает ошибку "Нет связи с хостом"?

Эта ошибка означает, что сам терминал не может соединиться с банком-эквайером. Проверьте наличие сим-карты (для GSM моделей), баланс счета, уровень сигнала или целостность интернет-кабеля (для Ethernet моделей). Проблема не в 1С, а в канале связи терминала с банком.

Как обновить прошивку терминала INPAS?

Обновление прошивки обычно выполняется через специальную утилиту от производителя, поставляемую с драйвером. Не пытайтесь обновлять терминал через интерфейс 1С. Перед обновлением обязательно сделайте резервную копию конфигурации терминала, если такая функция предусмотрена.

Почему при возврате терминал просит вставить карту, хотя оплата была наличными?

Вы выбрали неверный вид оплаты в документе возврата. Убедитесь, что в чеке продажи оплата была проведена именно через терминал INPAS. Если оригинальная оплата была наличными, возврат также должен оформляться как наличный, и терминал задействовать не нужно.