Описание

Данный вариант экспорта предполагает обмен данными на основе WEB-сервисов, предоставляемых SetRetail10, при которых активной стороной запроса является SetRetail10, то есть сервер SetRetail10 отправляет данные в ERP. Соответственно SetRetail10 является активной стороной обмена, которая отправляет данные.

Внимание:

Пакет данных, возвращаемый от SetRetail10 всегда преобразуется в BASE64.
Обмен происходит по порту 8090.
Для возможности отправки данных в ERP, на её стороне должен быть реализован веб-сервис по предоставленным WSDL-файлам ниже или из раздела Примеры XSD.

Логика взаимодействия

SetRetail10 будет подключаться к ERP по адресу размещения wsdl-файла и вызывать метод для передачи данных.
Выбор метода, к которому обращается SetRetail10 или SetCentrum, осуществляется при настройке выгрузки в ERP согласно протоколу выгрузки. (Внешние системы → Протокол Set Retail 10: выгрузка данных в веб-сервис на стороне ERP).
При использовании метода выгрузки без обратной связи SetRetail10 или SetCentrum ориентируются на HTTP-ответ сервера принимающей стороны
- 200 - данные (чеки, внесения, изъятия, Z-отчеты) приняты успешно
- 500 - данные (чеки, внесения, изъятия, Z-отчеты) не приняты, произошла внутренняя ошибка сервера).
Если при использовании метода выгрузки без обратной связи сервер принимающей стороны отправит любое содержимое кроме HTTP-ответа, то данный ответ будет интерпретирован как ошибка приёма данных от SetRetail.
Метод без TI не ждет ответа сервера по SOAP об успешной обработке сообщения. Ему достаточно по HTTP получить статус 200, это означает, что сообщение успешно отправлено и можно отправлять следующее.
Методы с TI синхронные и ждут именно ответа сервера об успешной обработке сообщения <return>true</return>. Если такой ответ не получен, тогда SetCentrum или SetRetail будет пытаться повторно отправить то же самое сообщение!

Методы веб-сервиса для экспорта чеков

Методы

processPurchases - без обратной связи

processPurchasesWithTI - c обратной связью

URL

http://Любой_IP-адрес_на стороне_ERP_сервера/Set10PurchasesService

WSDL

http://Любой_IP-адрес_на стороне_ERP_сервера/Set10PurchasesService.wsdl

Поле	Тип данных	Описание	Обязательное
Принимаемые параметры
purchases	base64Binary	Чеки в формате XML, закодированный в BASE64	Да
version	string	Версия xsd-схемы выдаваемых данных	Нет
Возвращаемые параметры
return	boolean	`True` в случае успешной обработки пакета	Да

Описание формата выгружаемых чеков

Методы веб-сервиса для экспорта аннулированных чеков

SRTS-970 - Получение подробных данных проблемы… СТАТУС

CR-8315 - Получение подробных данных проблемы… СТАТУС

10.3.15.0

Методы

processCancelledPurchases - без обратной связи

processCancelledPurchasesWithTI - c обратной связью

URL

http://Любой_IP-адрес_на стороне_ERP_сервера/Set10PurchasesService

WSDL

http://Любой_IP-адрес_на стороне_ERP_сервера/Set10PurchasesService.wsdl

Поле	Тип данных	Описание	Обязательное
Принимаемые параметры
purchases	base64Binary	Аннулированные чеки в формате XML, закодированный в BASE64	Да
version	string	Версия xsd-схемы выдаваемых данных	Нет
Возвращаемые параметры
return	boolean	`True` в случае успешной обработки пакета	Да

Описание формата выгружаемых чеков

Методы веб-сервиса для экспорта Z-отчетов

Метод

processZReports - без обратной связи

processZReportsWithTI - с обратной связью

URL

http://Любой_IP-адрес_на стороне_ERP_сервера/Set10ZReportsService

WSDL

http://Любой_IP-адрес_на стороне_ERP_сервера/Set10ZReportsService.wsdl

Поле	Тип данных	Описание	Обязательное
Принимаемые параметры
zreports	base64Binary	Список Z-отчетов в формате XML, закодированный в base64	Да
version	string	Версия xsd схемы выдаваемых данных	Нет
Возвращаемые параметры
return	boolean	`True` в случае успешной обработки пакета	Да

Описание формата выгружаемых Z-отчётов

Методы веб-сервиса для экспорта внесений

Метод

processIntroductions - без обратной связи

processIntroductionsWithTI - с обратной связью

URL

http://Любой_IP-адрес_на стороне_ERP_сервера/Set10IntroductionsService

WSDL

http://Любой_IP-адрес_на стороне_ERP_сервера/Set10IntroductionsService.wsdl

Поле	Тип данных	Описание	Обязательное
Принимаемые параметры
introduction	base64Binary	Список внесений в формате XML, закодированный в BASE64	Да
version	string	Версия xsd схемы выдаваемых данных	Нет
Возвращаемые параметры
return	boolean	`True` в случае успешной обработки пакета	Да

Описание формата выгрузки внесений

Методы веб-сервиса для экспорта изъятий

Метод

processWithdrawals - без обратной связи

processWithdrawalsWithTI - с обратной связью

URL

http://Любой_IP-адрес_на стороне_ERP_сервера/Set10WithdrawalsService

WSDL

http://Любой_IP-адрес_на стороне_ERP_сервера/Set10WithdrawalsService.wsdl

Поле	Тип данных	Описание	Обязательное
Принимаемые параметры
withdrawals	base64Binary	Список изъятий в формате XML, закодированный в base64	Да
version	string	Версия xsd схемы выдаваемых данных	Нет
Возвращаемые параметры
return	boolean	`True` в случае успешной обработки пакета	Да

Описание формата выгрузки изъятий

Методы веб-сервиса для экспорта отчёта по сумме и количеству чеков с магазина за сутки

Метод

processTurnovers - без обратной связи

processTurnoversWithTI - с обратной связью

URL

http://Любой_IP-адрес_на стороне_ERP_сервера/Set10TurnoversService

WSDL

http://Любой_IP-адрес_на стороне_ERP_сервера/Set10TurnoversService.wsdl

Поле	Тип данных	Описание	Обязательное
Принимаемые параметры
turnovers	base64Binary	Отчёт в формате XML, закодированный в base64	Да
version	string	Версия xsd схемы выдаваемых данных	Нет
Возвращаемые параметры
return	boolean	`True` в случае успешной обработки пакета	Да

Описание формата выгрузки отчёта по сумме и количеству чеков

Методы веб-сервиса для экспорта отчетов по сторно

Методы	getByFilter
URL	http://Любой_IP-адрес_на стороне_ERP_сервера/StornoExportServiceBean
WSDL	http://Любой_IP-адрес_на стороне_ERP_сервера/StornoExportServiceBeanService.wsdl

Поле	Тип данных	Описание	Обязательное
Принимаемые параметры
cash	Long	Номер кассы	Нет
marking	String	Код/Артикул товара	Нет
operday	DateTime	Дата операционного дня в формате YYYY-MM-DD	Нет
shift	long	Номер смены	Нет
shop	long	Номер магазина	Нет
tabNo	string	Табельный номер кассира	Нет
type	string	Тип события: STORNO (Сторно) - уменьшение количество позиций товара кассиром в чеке до “0”; CHANGE (Изменения) - уменьшение количества позиций товара кассиром (не до значения “0”); CANCEL (Отмена) - удаление позиции из подвала чека (товар не добавляется к чеку; применимо только для POS).	Нет
Возвращаемые параметры
return	boolean	`True` в случае успешной обработки пакета	Да

Описание формата выгружаемых отчетов по сторно

Включение и настройка экспорта отчета по сторно

После включения экспорта в выгрузку попадут только данные, которые будут сформированы после активации.

Включение отчета по сторно по умолчанию запрещает удаление последней (единственной) позиции в чеке, так как это приведет к удалению чека в БД и соответственно всех данных для отчета, что были привязаны к чеку.

1. Для включения экспорта выполните скрипт в базе данных set на сервере SetRetail10/SetCentrum:

UPDATE public.sales_management_properties
   SET property_value='true'
WHERE property_key = 'export.set10wsclient.storno.enabled';

2. Перезапустите службу сервера.

3. Проверьте что в шаблоне касс включен флажок для формирования отчетов по сторно в операционном дне. Без этой настройки отчеты по сторно формироваться не будут. После установки этой настройки перезагрузите кассы.

Кассовый модуль → Шаблоны касс → <Шаблон кассы> → Вкладка ПРОЦЕСС ТОРГОВЛИ → Работа с чеком → Вести учет и изменения количества и удаления позиций в чеках.

4. Также в базе данных set в таблице sales_management_properties установите дополнительные настройки по экспорту, если требуется.

property_key	property_value	description
storno.clean.time	06:35:00	Время старта чистильщика истории изменений или отмен (Storno) позиций чеков в течении дня
storno.clean.day.limit	999999999999	Ограничение глубины очистки истории изменений или отмен (Storno) позиций чеков в днях
export.set10wsclient.storno.polling.interval.sec	30	Период выгрузки событий изменения количества товара в чеках (aka сторнирования) в веб-сервис на стороне ERP, в секундах
export.set10wsclient.storno.version	1.0	Версия плагина выгрузки событий изменения количества товара в чеках (aka сторнирования) в веб-сервис на стороне ERP
export.set10wsclient.storno.short.interval	5	Период перевыгрузки событий изменения количества товара в чеках (aka сторнирования) в веб-сервис на стороне ERP (если данных больше, чем размер пачки), в секундах
export.set10wsclient.storno.polling.wsdl		URL для выгрузки событий изменения количества товара в чеках (aka сторнирования) в веб-сервис на стороне ERP
export.set10wsclient.storno.catalog.size.records	100	Размер пачки для выгрузки событий изменения количества товара в чеках (aka сторнирования) в веб-сервис на стороне ERP
export.set10wsclient.storno.auth.username		Имя пользователя для авторизации в веб-сервисе выгрузки событий изменения количества товара в чеках (aka сторнирования) на стороне ERP
export.set10wsclient.storno.auth.password		Пароль для авторизации в веб-сервисе выгрузки событий изменения количества товара в чеках (aka сторнирования) на стороне ERP
export.set10wsclient.storno.export.style	SAP	Способ выгрузки событий изменения количества товара в чеках (aka сторнирования) в веб-сервис на стороне ERP. (C1/SAP - с ответом/без ответа)
export.set10wsclient.storno.save.catalog.to.temp.dir	false	Сохранять ли выгруженные события изменения количества товара в чеках (aka сторнирования) в папку export.set10wsclient.storno.tmp.catalog.path
export.set10wsclient.storno.request.timeout	60	Таймаут завершения обработки запроса для выгрузки событий изменения количества товара в чеках (aka сторнирования) во внешнюю систему, в секундах
export.set10wsclient.storno.tmp.catalog.path	c:\\reports\\export\\set10wsclient\\storno	Папка для сохранения выгруженных событий изменения количества товара в чеках (aka сторнирования).

Интеграция

Веб-сервисы экспорта (на стороне ERP)

Описание

Логика взаимодействия

Методы веб-сервиса для экспорта чеков

Методы веб-сервиса для экспорта аннулированных чеков

Методы веб-сервиса для экспорта Z-отчетов

Методы веб-сервиса для экспорта внесений

Методы веб-сервиса для экспорта изъятий

Методы веб-сервиса для экспорта отчёта по сумме и количеству чеков с магазина за сутки

Методы веб-сервиса для экспорта отчетов по сторно

Включение и настройка экспорта отчета по сторно

Веб-сервисы экспорта (на стороне ERP)

Описание

Логика взаимодействия

Методы веб-сервиса для экспорта аннулированных чеков

[data-colorid=pyuf4cml06]{color:#808080} html[data-color-mode=dark] [data-colorid=pyuf4cml06]{color:#7f7f7f}[data-colorid=jxk6d6s196]{color:#808080} html[data-color-mode=dark] [data-colorid=jxk6d6s196]{color:#7f7f7f}Методы веб-сервиса для экспорта Z-отчетов

[data-colorid=qsxfynb7vf]{color:#808080} html[data-color-mode=dark] [data-colorid=qsxfynb7vf]{color:#7f7f7f}[data-colorid=hwkywjg5c3]{color:#808080} html[data-color-mode=dark] [data-colorid=hwkywjg5c3]{color:#7f7f7f}Методы веб-сервиса для экспорта внесений

[data-colorid=hlsfwaq2f7]{color:#808080} html[data-color-mode=dark] [data-colorid=hlsfwaq2f7]{color:#7f7f7f}[data-colorid=q5yb58ugwj]{color:#808080} html[data-color-mode=dark] [data-colorid=q5yb58ugwj]{color:#7f7f7f}Методы веб-сервиса для экспорта изъятий

Включение и настройка экспорта отчета по сторно

Методы веб-сервиса для экспорта Z-отчетов

Методы веб-сервиса для экспорта внесений

Методы веб-сервиса для экспорта изъятий