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

Описание

Данный вариант экспорта предполагает обмен данными на основе 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.

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

Методы

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

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

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

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

Поле

Тип данных

Описание

Обязательное

Принимаемые параметры

purchases

base64Binary

Чеки в формате XML, закодированный в BASE64

Да

version

string

Версия xsd-схемы выдаваемых данных

Нет

Возвращаемые параметры

return

boolean

True в случае успешной обработки пакета

Да

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

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

Метод

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

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

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

Поле

Тип данных

Описание

Обязательное

Принимаемые параметры

zreports

base64Binary

Список Z-отчетов в формате XML, закодированный в base64

Да

version

string

Версия xsd схемы выдаваемых данных

Нет

Возвращаемые параметры

return

boolean

True в случае успешной обработки пакета

Да

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

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

Метод

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

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

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

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

Поле

Тип данных

Описание

Обязательное

Принимаемые параметры

introduction

base64Binary

Список внесений в формате XML, закодированный в BASE64

Да

version

string

Версия xsd схемы выдаваемых данных

Нет

Возвращаемые параметры

return

boolean

True в случае успешной обработки пакета

Да

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

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

Метод

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

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

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

Поле

Тип данных

Описание

Обязательное

Принимаемые параметры

withdrawals

base64Binary

Список изъятий в формате XML, закодированный в base64

Да

version

string

Версия xsd схемы выдаваемых данных

Нет

Возвращаемые параметры

return

boolean

True в случае успешной обработки пакета

Да

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

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

Метод

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

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

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

Поле

Тип данных

Описание

Обязательное

Принимаемые параметры

turnovers

base64Binary

Отчёт в формате XML, закодированный в base64

Да

version

string

Версия xsd схемы выдаваемых данных

Нет

Возвращаемые параметры

return

boolean

True в случае успешной обработки пакета

Да

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

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

Методы

getByFilter 

URLhttp://Любой_IP-адрес_на стороне_ERP_сервера/StornoExportServiceBean
WSDL

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

Поле

Тип данных

Описание

Обязательное

Принимаемые параметры

cash

Long

Номер кассы

Нет
markingStringКод/Артикул товараНет
operdayDateTimeДата операционного дня в формате YYYY-MM-DDНет
shiftlongНомер сменыНет
shoplongНомер магазинаНет
tabNostringТабельный номер кассираНет

type

string

Тип события:

  • STORNO (Сторно) - уменьшение количество позиций товара кассиром в чеке до “0”;
  • CHANGE (Изменения) - уменьшение количества позиций товара кассиром (не до значения “0”);
  • CANCEL (Отмена) - удаление позиции из подвала чека (товар не добавляется к чеку; применимо только для POS).
Нет
Возвращаемые параметры
returnbooleanTrue в случае успешной обработки пакетаДа

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

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

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

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_keyproperty_valuedescription
storno.clean.time06:35:00Время старта чистильщика истории изменений или отмен (Storno) позиций чеков в течении дня
storno.clean.day.limit999999999999Ограничение глубины очистки истории изменений или отмен (Storno) позиций чеков в днях
export.set10wsclient.storno.polling.interval.sec30Период выгрузки событий изменения количества товара в чеках (aka сторнирования) в веб-сервис на стороне ERP, в секундах
export.set10wsclient.storno.version1.0Версия плагина выгрузки событий изменения количества товара в чеках (aka сторнирования) в веб-сервис на стороне ERP
export.set10wsclient.storno.short.interval5Период перевыгрузки событий изменения количества товара в чеках (aka сторнирования) в веб-сервис на стороне ERP (если данных больше, чем размер пачки), в секундах
export.set10wsclient.storno.polling.wsdl
URL для выгрузки событий изменения количества товара в чеках (aka сторнирования) в веб-сервис на стороне ERP
export.set10wsclient.storno.catalog.size.records100Размер пачки для выгрузки событий изменения количества товара в чеках (aka сторнирования) в веб-сервис на стороне ERP
export.set10wsclient.storno.auth.username
Имя пользователя для авторизации в веб-сервисе выгрузки событий изменения количества товара в чеках (aka сторнирования) на стороне ERP
export.set10wsclient.storno.auth.password
Пароль для авторизации в веб-сервисе выгрузки событий изменения количества товара в чеках (aka сторнирования) на стороне ERP
export.set10wsclient.storno.export.styleSAPСпособ выгрузки событий изменения количества товара в чеках (aka сторнирования) в веб-сервис на стороне ERP. (C1/SAP - с ответом/без ответа)
export.set10wsclient.storno.save.catalog.to.temp.dirfalseСохранять ли выгруженные события изменения количества товара в чеках (aka сторнирования) в папку export.set10wsclient.storno.tmp.catalog.path
export.set10wsclient.storno.request.timeout60Таймаут завершения обработки запроса для выгрузки событий изменения количества товара в чеках (aka сторнирования) во внешнюю систему, в секундах
export.set10wsclient.storno.tmp.catalog.pathc:\\reports\\export\\set10wsclient\\stornoПапка для сохранения выгруженных событий изменения количества товара в чеках (aka сторнирования).