Как организовать работу с ККТ Атол через веб-сервер из 1С 7.7?

В процессе автоматизации торговых точек часто возникает необходимость вынести управление кассой за пределы основного рабочего места. Использование штатного драйвера 1С не всегда удобно, если касса физически расположена на другом устройстве или используется в составе распределенной POS-системы. Разберем, как реализовать обмен с ККТ Атол через их веб-сервер, используя возможности 1С 7.7.

Понимание принципа работы веб-сервера Атол

Веб-сервер Атол — это программный компонент, который «слушает» HTTP-запросы и транслирует их в команды драйвера ККТ. Вся коммуникация строится на обмене данными в формате JSON. Для 1С 7.7 это означает, что нам не нужно подключать внешнюю компоненту напрямую к 1С; достаточно отправить сформированный JSON-пакет по сетевому адресу, где установлен драйвер.

Подготовка оборудования и требования к ПО

Прежде чем приступать к написанию кода, необходимо убедиться, что оборудование готово к работе в современном режиме:

1. Версия прошивки ККТ: Для работы с маркированным товаром и поддержкой ФФД 1.2 версия прошивки кассы должна быть не ниже 5.8.17.
2. Версия драйвера: Установите актуальный «Драйвер ККТ» от Атол, который включает в себя последние обновления веб-сервера.
3. Документация: Обязательно изучите документ «Схемы интеграции для поддержки работы ККТ с ФФД 1.2». В нем подробно описана структура JSON, необходимая для формирования тегов маркировки.

Техническая реализация в 1С 7.7

Поскольку в 1С 7.7 нет встроенных средств для работы с JSON, мы воспользуемся системными объектами Windows через OLE. Для отправки запросов лучше всего подходит WinHttp.WinHttpRequest.5.1.

Пример отправки команды на печать чека

Рассмотрим общий подход к формированию запроса. Процесс состоит из двух этапов: формирование JSON-строки и отправка её методом POST.

// Пример формирования базового объекта для запроса
HTTP = СоздатьОбъект("WinHttp.WinHttpRequest.5.1");
URL = "http://127.0.0.1:16000/api/v2/printDocument"; // Порт по умолчанию
ТелоЗапроса = "{ ""type"": ""sell"", ""items"": [...] }"; // Здесь должна быть структура JSON

HTTP.Open("POST", URL, 0);
HTTP.SetRequestHeader("Content-Type", "application/json");
HTTP.Send(ТелоЗапроса);

Ответ = HTTP.ResponseText;

Обратите внимание: при работе с маркированным товаром в JSON-структуре обязательно должны присутствовать теги:

• 1162 — Код товара (маркировка).
• 1163 — Результат проверки кода маркировки.
• 2106 — Отраслевой реквизит предмета расчета.

Важные рекомендации по эксплуатации

Чтобы система работала стабильно, учитывайте следующие советы:

• Обработка ошибок: Веб-сервер возвращает ответ в формате JSON, даже если произошла ошибка. Обязательно парсите этот ответ в 1С, чтобы выводить оператору понятные сообщения (например, «Нет связи с ККТ» или «Закончилась лента»).
• Безопасность: Веб-сервер Атол не имеет встроенной системы защиты от несанкционированного доступа. Используйте его только внутри доверенной локальной сети или через VPN-туннели.
• Парсинг JSON: Избегайте ручного формирования JSON через сложную конкатенацию строк. Если структура чека становится объемной, лучше использовать сторонние библиотеки или внешние компоненты для работы с JSON, чтобы избежать проблем с кодировкой и спецсимволами.
• Масштабируемость: Данная архитектура позволяет настроить централизованный узел печати, к которому могут обращаться разные мобильные или стационарные рабочие места. Это избавляет от необходимости пробрасывать порты для каждого компьютера отдельно.

Соблюдение этих простых правил и внимательное изучение технической документации Атол позволит вам реализовать надежное и современное решение для фискализации даже в такой классической среде, как 1С 7.7.