Публичный ресурс
Веб-сервисы экспорта (на стороне 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 | 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 сторнирования). |
© 1994-2024, ООО "Кристалл Сервис Интеграция".
Все права защищены.