/
Веб-сервис экспорта отчетов по сторно (на стороне SetRetail10)

Публичный ресурс

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

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

Отбор по фильтру

Метод

getByFilter

URL

http://IP-адрес_сервера:8090/SET-ERPIntegration/StornoExportServiceBean

WSDL

http://IP-адрес_сервера:8090/SET-ERPIntegration/StornoExportServiceBean?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

base64Binary

Отчеты по сторно

Да

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

Пример запроса
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://service.storno.operday.ERPIntegration.crystals.ru/"> <soapenv:Header/> <soapenv:Body> <ser:getByFilter> <!--Optional:--> <filter> <!--Optional:--> <cash>3</cash> <!--Optional:--> <marking>45034</marking> <!--Optional:--> <operday>2021-07-06</operday> <!--Optional:--> <shift>44</shift> <!--Optional:--> <shop>234</shop> <!--Optional:--> <tabNo>21323</tabNo> <!--Optional:--> <type>STORNO</type> </filter> </ser:getByFilter> </soapenv:Body> </soapenv:Envelope>

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

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

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

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

set на сервере SetRetail10/SetCentrum:

Экспорт через веб-сервис
UPDATE public.sales_management_properties SET property_value='true' WHERE property_key = 'export.set10wsclient.storno.enabled';
Файловый экспорт
UPDATE public.sales_management_properties SET property_value='true' WHERE property_key = 'export.file.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 сторнирования).

export.file.storno.filename.prefix

storno

Префикс файлов для выгрузки отчетов по событиям изменения количества товара в чеках (aka сторнирования)

export.file.storno.filename.separator

-

Разделитель в имени файлов выгрузки событий изменения количества товара в чеках (aka сторнирования)

export.file.storno.filename.extension

xml

Расширение файлов выгрузки событий изменения количества товара в чеках (aka сторнирования)

export.file.storno.polling.interval.sec

60

Интервал выгрузки событий изменения количества товара в чеках (aka сторнирования), сек

export.file.storno.short.interval.sec

2

Короткий интервал для выгрузки событий изменения количества товара в чеках (aka сторнирования), сек

export.file.storno.catalog.size.records

100

Размер порции для выгрузки событий изменения количества товара в чеках (aka сторнирования)

export.file.storno.version

1.0

Версия выгрузки событий изменения количества товара в чеках (aka сторнирования)

storno.export.document.schema.version

1.0

Версия документа выгрузки отчетов по событиям изменения количества товара в чеках (aka сторнирования) через ws-service

export.file.storno.enabled

true

Флаг-признак: разрешена ли выгрузка событий изменения количества товара в чеках (aka сторнирования) в файл

export.set10wsclient.storno.enabled

true

Флаг-признак: разрешена ли выгрузка событий изменения количества товара в чеках (aka сторнирования) в веб-сервис на стороне ERP