Штрих-М: Документация

WEB-сервис «KKMTransfer» позволяет в режиме онлайн:

• оперативно передавать в ТП 5 данные о продажах, оформленных на кассах, что позволяет в ТП 5 отражать информацию об актуальных остатках товаров в торговом зале;
• информировать кассы о суммах накоплений и суммах бонусов по дисконтной карте при её считывании на кассе, чтобы касса могла корректно сделать списание бонуса и начисление бонуса на карту, а также рассчитать скидку;
• информировать ТП 5 о чеках, закрытых с дисконтной картой, что позволяет в ТП 5 увеличить сумму накопления по карте и скорректировать сумму бонуса.

Для функционирования этого WEB-сервиса необходимо в конфигурации, помимо публикации WEB-сервисов, установить флаг у константы «Работа с Web-сервисом «Обмен с ККМ»» («Справочники» → «Константы» → закладка «Работа с оборудованием» → закладка «ККМ»).

Загрузка информации о продажах в товароучетной системе «Штрих-М Торговое предприятие 5.2» реализована с помощью регламентного задания «Оперативное снятие текущих продаж с ККМ».

Подключение кассы к WEB-сервису «KKMTransfer» осуществляется через позицию меню «WebDC» закладки «МодулиЛогики» (позиция «Настройка» меню «Супервизор» → закладка «МодулиЛогики» → позиция «WebDC»).

Поле «Описание WSDL» определяет адрес WEB-сервиса передачи данных по дисконтным картам. Составные части адреса следующие:

• «http:/ /» протокол передачи данных (обязательный реквизит»;
• IP-адрес компьютера на котором опубликован WEB-сервисы и, через двоеточие, порт для обмена данными. Номер порта определяется в файле конфигурации программы для работы с WEB-сервером. Например, в программе «Apache» - реквизит «Listen» в файле «httpd.conf» папки «conf»;
• через символ «/» задается имя файла с настройкой публикации WEB-сервиса;
• через символ «/» задается имя WEB-сервиса «/ws/KKMTransfer.1cws?wsdl, где «/ws» – признак того, что выполняется обращение к Web- сервису.

Например, в строке
http://101.102.5.7:8080/TP5/ws/KKMTransfer.1cws?wsdl
указаны следующие реквизиты:

• 101.102.5.7:8080 – IP-адрес компьютера, на котором опубликован WEB-сервер, и номер порта для обмена данными с WEB-сервисом. Для удаленного компьютера требуется статический IP-адрес;
• TP5 – имя файла с настройкой публикации WEB-сервисов (см. рисунок 1.1);
• ws – признак того, что выполняется обращение к Web- сервису;
• KKMTransfer.1cws?wsdl – имя WEB-сервиса для обмена данными по дисконтным картам и бонусам на картах между конфигурацией ТП 5 и ПО «Кассир 5».

В полях «Логин» и «Пароль» задаются имя и пароль пользователя ТП 5, которые определены в окне «Пользователь» конфигуратора. Когда кассовое ПО подключается к WEB-сервисам ТП 5, делается штатная авторизация средствами 1C по этому пользователю. Если авторизация прошла успешно, связь с WEB-сервисами устанавливается. Если авторизация не прошла, вернётся ошибка авторизации, и работа с WEB-сервисами на кассе будет не доступна. Этот механизм авторизации реализован для защиты от несанкционированного доступа. Логин и пароль пользователя должны содержать только буквы латинского алфавита, цифры и знаки препинания.

Если допущена ошибка в задании реквизитов WEB-сервиса, то при вводе на кассе номера дисконтной карты кассиру будет выведено сообщение о том, что WEB-сервис не подключён и работа с дисконтной картой не возможна.

Если реквизиты WEB-сервиса заданы правильно, но в ТП 5 WEB-сервис не опубликован, при регистрации дисконтной карты так же будет выдано сообщение об ошибке.

Если позицию меню «WebDC» закладки «МодулиЛогики» реквизиты WEB-сервиса не заданы, то работа с дисконтными картами на кассе осуществляется стандартным образом.

После закрытия чека на кассе информация о суммах бонусов и накоплений на дисконтных картах передается из кассового ПО в базу ТП 5 и становится доступной на всех кассах, работающих под управлением ПО «Штрих-М: Кассир 5», которое подключено к WEB-сервису «KKMTransfer».

Синхронизация информации о накоплениях и суммах бонусов на картах в кассе и учетной системе осуществляется в документе «Синхронизация накоплений по ДК для Псевдо-Онлайн» («Документы» → «Розничные продажи / ККМ»).