= Модуль автоматической кассы (режим POS-терминала) = 

== Терминология ==

Терминал сканирования - касса или иной программный комплекс на базе 1С для сканирования товаров и формирования заказа.
Процессинговый сервер — сервер на базе ПО 1С. Предназначен для приема отчетной информации от расчетного терминала.

== Конфигурация модуля ==

Конфигурация модуля выполняется в меню POS-терминал режима конфигурирования.
Доступны следующие параметры:
 * Использовать модуль POS - активирует работу модуля.
 * Заголовок - наименование иконки (при использовании нескольких модулей)
 * ID терминала - строка идентификации термина на процессинговом сервере.
 * Терминал сканирования->требовать и проверять логин и пароль - активирует авторизацию терминала сканирования по логину и паролю.
 * Процессинговый сервер->url сервера - url сервера для взаимодействию по протоколу SOAP вида https://<servername>/ , без пути или параметров запроса.
 * Процессинговый сервер->Использовать логин и пароль - активирует авторизацию на процессинговом сервере по указанным логину и паролю.

== Программирование и настройка терминала сканирования ==

Терминал сканирования осуществляет взаимодействие с расчетным терминалом, инициируя и контролируя процесс оплаты.
Взаимодействие осуществляется посредством протокола SOAP с использованием стандартных средств 1C.

Используются следующие операции:

'''Pay — инициирует процесс оплаты. Аргументы:
 * уникальный номер операции (строка)
 * сумма к оплате в копейках (целое число)
 * реестр заказа, список из элементов: артикул (id), наименование (name), количество (count), цена (price). (структура Реестр заказа)

Возвращаемое значение:

'''Результат операции: 0 - операция принята к исполнению, -1 — неверные параметры, -2 терминал занят другой операцией, -3 - сессия с таким номером операции уже существует

Уникальный номер операции должен генерироваться для каждой платежной сессии.
Расчетный терминал учитывает уникальность операций на предмет повторного запуска сессии в течении суток, возвращая для дубликатов ответ -3 - сессия с таким номером операции уже существует.

Paypoll - опрос состояния платежа

Аргументы:
 * уникальный номер операции (строка)
Возвращаемое значение:
 * Статус операции/результат платежа (целое число). Статусы:  -1 — неверные параметры, -4 - сессия не найдена, 0 - успешно оплачена, 1 - в процессе оплаты, 2 - отменена


''' Пример кода

{{{
&НаСервере
Функция ЗапросPay ()
	// Указывается ip-адрес терминала
	Определения = Новый WSОпределения ("http://192.168.1.102:8080/?wsdl", "stamp", "stampsoft");
	
	Прокси = Новый WSПрокси (Определения, "http://www.stampsoft.ru/pos", "pos", "pos");
	Прокси.Пользователь = "stamp";
	Прокси.Пароль = "stampsoft";
	
	СтрокаТип = Прокси.ФабрикаXDTO.Пакеты.Получить ("http://www.w3.org/2001/XMLSchema").Получить("string");
	ЦелоеТип = Прокси.ФабрикаXDTO.Пакеты.Получить ("http://www.w3.org/2001/XMLSchema").Получить("int");

	// Метка времени в качестве уникального номера операции
	УникальныйНомерОперации = Прокси.ФабрикаXDTO.Создать(СтрокаТип, ТекущаяДата ());
	Сумма = Прокси.ФабрикаXDTO.Создать(ЦелоеТип, 1000); // 1000 коп
	
	// Строка заказа из реестра заказа
	СтрокаЗаказаТип = Прокси.ФабрикаXDTO.Пакеты.Получить ("http://www.stampsoft.ru/pos").Получить("orderitem");
	
	СтрокаЗаказа0 = Прокси.ФабрикаXDTO.Создать(СтрокаЗаказаТип);
	СтрокаЗаказа0.id = "id0";
	СтрокаЗаказа0.name = "name0";
	СтрокаЗаказа0.count = 1;
	СтрокаЗаказа0.cost = 100;
	
	
	СтрокаЗаказа1 = Прокси.ФабрикаXDTO.Создать(СтрокаЗаказаТип);
	СтрокаЗаказа1.id = "id1";
	СтрокаЗаказа1.name = "name1";
	СтрокаЗаказа1.count = 2;
	СтрокаЗаказа1.cost = 200;

	// Заказ (реестр)
	ЗаказТип = Прокси.ФабрикаXDTO.Пакеты.Получить ("http://www.stampsoft.ru/pos").Получить("order");

	Заказ = Прокси.ФабрикаXDTO.Создать(ЗаказТип);
	Заказ.orderitem.Добавить (СтрокаЗаказа0);
	Заказ.orderitem.Добавить (СтрокаЗаказа1);
	
	Значение = Прокси.Pay (УникальныйНомерОперации, Сумма, Заказ);
	Возврат Значение
КонецФункции
	
&НаСервере
Функция ЗапросPayPoll ()
	Определения = Новый WSОпределения ("http://192.168.1.102:8080/?wsdl", "stamp", "stampsoft");
	
	Прокси = Новый WSПрокси (Определения, "http://www.stampsoft.ru/pos", "pos", "pos");
	Прокси.Пользователь = "stamp";
	Прокси.Пароль = "stampsoft";
	ТипПараметра = Прокси.ФабрикаXDTO.Пакеты.Получить ("http://www.w3.org/2001/XMLSchema").Получить("string");

	Параметр = Прокси.ФабрикаXDTO.Создать(ТипПараметра, "uid0");
	
	Значение = Прокси.PayPoll (Параметр);
	Возврат Значение
КонецФункции
}}}


== Программирование и настройка процессингового сервера ==

Расчетный терминал взаимодействует с процессинговым сервером 1С по протоколу SOAP, задействуя встроенный механизм веб-сервисов 1С.

Для настройки веб-сервиса:
 * Установите веб-сервер (apache2 или IIS), руководствуясь документацией веб-сервера и 1С.
 * Импортируйте пакет XDTO пакет pos.xsd (прикреплён к статье): в конфигурации Общие->XDTO-пакеты->(правой кнопкой)Импорт XML-схемы->укажите файл pos.xsd. Полученный объект (ПакетXDTO1) переименуйте в pos.
 * Добавьте веб-сервис зщы: в конфигурации Общие->Web-сервисы->->(правой кнопкой)добавить. Переименуйте веб-сервис в pos. 
 * Во вкладке Прочее веб-сервиса stamp выберите дополнительные пакеты XDTO: установите галочку напротив http://www.stampsoft.ru/pos
 * Во вкладке операции веб-сервиса добавьте указанные ниже операции и параметры к каждой операции. В параметрах каждой операции укажите имя метода такое же, как и имя операции. В параметрах каждой операции также укажите тип возвращаемого значения. Стандартные типы выбраются из пакета http://www.w3.org/2001/XMLSchema (boolean, string, int), остальные - из пакета http://www.stampsoft.ru/pos (order)

'''Операции Register 

(Имя - Register, имя операции - Register). Операция регистрации платежа. Тип возвращаемого значения: boolean. 
Параметры: 
 * terminal_id (string) - номер расчетного терминала (из конфигурации)
 * uid (string) - уникальный номер сессии/платежа
 * amount (int) - сумма к оплате, запрошенная терминалом сканирования
 * pay_amount (int) - принятая сумма к оплате
 * charge_amount (int) - сумма сдачи
 * rest_amount(int) - сумма невыданной сдачи
 * pay_type (int) - тип платежа (0 - наличные, 1 - карты)
 * order (order из http://www.stampsoft.ru/pos) - заказ
 * time (int) - время операции (unixtime)