[[tp7:Start|Начальная страница]] <- [[tp7:Web_сервисы|Web и Http-сервисы]] <- [[tp7:Модули:М_OnLine_ККМ|Модуль «OnLine работа с ККМ»]]
===== WEB-сервис синхронизации информации о суммах бонусов и накоплений на дисконтных картах =====
WEB-сервис «KKMTransfer» позволяет в режиме онлайн:
  * оперативно передавать в ТП7 данные о продажах, оформленных на кассах, что позволяет в ТП7 отражать информацию об актуальных остатках товаров в торговом зале;
  * информировать кассы о суммах накоплений и суммах бонусов по дисконтной карте при её считывании на кассе, чтобы касса могла корректно сделать списание бонуса и начисление бонуса на карту, а также рассчитать скидку;
  * информировать ТП7 о чеках, закрытых с дисконтной картой, что позволяет в ТП7 увеличить сумму накопления по карте и скорректировать сумму бонуса.

Функционал работает, если в ключе защиты прописан модуль «**Online работа с ККМ**» и установлен флаг у реквизита «**Online работа с ККМ**» (раздел «Администрирование» -> «Настройки учета» -> «Дополнительная функциональность»).

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

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

В ПО «Кассир 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/TP7/ws/KKMTransfer.1cws?wsdl** \\
указаны следующие реквизиты:
  * **101.102.5.7:8080** – IP-адрес компьютера, на котором опубликован WEB-сервер, и номер порта для обмена данными с WEB-сервисом. Для удаленного компьютера требуется статический IP-адрес;
  * **TP7** – имя публикации WEB-сервисов;
  * **ws** – признак того, что выполняется обращение к Web- сервису;
  * **KKMTransfer.1cws?wsdl** – имя WEB-сервиса для обмена данными по дисконтным картам и бонусам на картах между конфигурацией ТП7 и ПО «Кассир 5».

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

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

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

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

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

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

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

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

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