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

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

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

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

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

В ПО «Кассир 5» должен быть подключен (распакован zip-архив) модуль логики «WebDC». Подключение кассы к WEB-сервису «KKMTransfer» осуществляется через позицию меню «WebDC» закладки «LogicalModules» (позиция «Настройка» меню «Супервизор» → закладка «LogicalModules» → позиция «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-сервисов;
• ws – признак того, что выполняется обращение к Web- сервису;
• KKMTransfer.1cws?wsdl – имя WEB-сервиса для обмена данными по дисконтным картам и бонусам на картах между конфигурацией ТП 5 и ПО «Кассир 5».

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

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

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

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

В настройки Web-сервиса KKMTransfer есть возможность отключить работу с дисконтными или платежными картами.

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

Для работы с дисконтными картами у пользователя должны быть права («Настройка» → «Пользователи» → колонка «Права» → группа набора прав «Продажа»): «Разрешить применение ДК в открытом чеке» и «Ручной ввод дисконтной карты».

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

Работа с платёжными картами осуществляется аналогично.