Публичный ресурс
Веб-сервисы экспорта (на стороне 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.
Метод без 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 |
| Да |
Описание формата выгружаемых чеков
Методы веб-сервиса для экспорта аннулированных чеков
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 |
| Да |
Методы веб-сервиса для экспорта внесений
| Метод | processIntroductions - без обратной связи processIntroductionsWithTI - с обратной связью |
| URL | http://Любой_IP-адрес_на стороне_ERP_сервера/Set10IntroductionsService |
| WSDL | http://Любой_IP-адрес_на стороне_ERP_сервера/Set10IntroductionsService.wsdl |
Поле | Тип данных | Описание | Обязательное |
Принимаемые параметры | |||
introduction | base64Binary | Список внесений в формате XML, закодированный в BASE64 | Да |
version | string | Версия xsd схемы выдаваемых данных | Нет |
Возвращаемые параметры | |||
return | boolean |
| Да |
Методы веб-сервиса для экспорта изъятий
Метод | processWithdrawals - без обратной связи processWithdrawalsWithTI - с обратной связью |
URL | http://Любой_IP-адрес_на стороне_ERP_сервера/Set10WithdrawalsService |
WSDL | http://Любой_IP-адрес_на стороне_ERP_сервера/Set10WithdrawalsService.wsdl |
Поле | Тип данных | Описание | Обязательное |
Принимаемые параметры | |||
withdrawals | base64Binary | Список изъятий в формате XML, закодированный в base64 | Да |
version | string | Версия xsd схемы выдаваемых данных | Нет |
Возвращаемые параметры | |||
return | boolean |
| Да |
Методы веб-сервиса для экспорта отчёта по сумме и количеству чеков с магазина за сутки
Метод | processTurnovers - без обратной связи processTurnoversWithTI - с обратной связью |
URL | http://Любой_IP-адрес_на стороне_ERP_сервера/Set10TurnoversService |
WSDL | http://Любой_IP-адрес_на стороне_ERP_сервера/Set10TurnoversService.wsdl |
Поле | Тип данных | Описание | Обязательное |
Принимаемые параметры | |||
turnovers | base64Binary | Отчёт в формате XML, закодированный в base64 | Да |
version | string | Версия xsd схемы выдаваемых данных | Нет |
Возвращаемые параметры | |||
return | boolean |
| Да |
Описание формата выгрузки отчёта по сумме и количеству чеков
Методы веб-сервиса для экспорта отчетов по сторно
Методы | 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 | Тип события:
| Нет |
Возвращаемые параметры | |||
return | boolean |
| Да |
Описание формата выгружаемых отчетов по сторно
Включение и настройка экспорта отчета по сторно
После включения экспорта в выгрузку попадут только данные, которые будут сформированы после активации.
Включение отчета по сторно по умолчанию запрещает удаление последней (единственной) позиции в чеке, так как это приведет к удалению чека в БД и соответственно всех данных для отчета, что были привязаны к чеку.
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 сторнирования). |