Публичный ресурс
Экспорт отчетов по сторно из SetRetail10 в ERP (веб-сервис на стороне SetRetail10)
- Парень Александр
- Любовь Чистова
SRTE-3492 - Получение подробных данных проблемы… СТАТУС
CR-5381 - Получение подробных данных проблемы… СТАТУС
10.2.99.0
ВЕРСИЯ WEB-СЕРВИСА 1.1
Методы веб-сервиса для экспорта отчетов по сторно
Отбор по фильтру | |
| Метод | 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 | Тип события:
| Нет |
| Возвращаемые параметры | |||
| 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 |
События отчета по сторно <storno-events/storno-event>
storno-events/storno-event | |||
| |||
Наименование элемента | Тип данных | Описание | Обязательное |
storno-events | stornoEventType | Каталог списка событий редактирования позиций в чеках | Да |
| Наименование элемента | Тип данных | Описание | Обязательное |
| storno-event | Комплексный | Событие редактирования позиции в чеке | Да |
| Наименование атрибута | Тип данных | Описание | Обязательное |
| shop | Long | Номер магазина | Нет |
| cash | Long | Номер кассы | Нет |
| shift | Long | Номер смены | Нет |
| receipt-number | Long | Номер чека | Нет |
| event-type | Комплексный | Тип события:
| Нет |
| cashier-id | String | Табельный номер кассира, оформляющего чек | Нет |
| cashier-name | String | ФИО кассира, оформляющего чек | Нет |
| admin-id | String | Табельный номер администратора, сделавшего отмену или изменение Правила заполнения: Если позицию удаляет не сам кассир, а администратор под своим логином\картой, то в отчёте:
Если позицию удаляет кассир, но при специальном положении ключа, то в отчете: | Нет |
| barcode | String | Штрих-код товара | Нет |
| marking | String | Код/Артикул товара | Нет |
| good-name | String | Наименование товара | Нет |
| qnty-before | Decimal | Количество товара, которое было в позиции до выполнения операции сторнирования | Нет |
| qnty-after | Decimal | Количество товара, которое стало в позиции после выполнения операции сторнирования. Для типа “сторно” и “отмена” = 0 | Нет |
| price | Decimal | Базовая (Первая цена) цена на товар до момента расчёта скидок | Нет |
| delete-position-reason-id | Long | Код причины удаления позиции
| Нет |
| excise-token | String | Информация о марке SRTB-6910 - Получение подробных данных проблемы… СТАТУС CR-9086 - Получение подробных данных проблемы… СТАТУС 10.3.25.0 | Нет |
| mark | String | Информация об акцизной марке SRTB-6910 - Получение подробных данных проблемы… СТАТУС CR-9086 - Получение подробных данных проблемы… СТАТУС 10.3.25.0 | Нет |
<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <storno-events> <storno-event shop="234" cash="3" shift="44" receipt-number="7" event-time="2021-07-06T17:31:11.654+03:00" event-type="STORNO" cashier-id="21323" cashier-name="Иванова Мария Александровна" admin-id="21323" barcode="2300169" marking="45032" good-name="Грудка КУРИНАЯ" qnty-before="1.000" price="149.70" delete-position-reason-id="1"/> </storno-events>
© 1994-2024, ООО "Кристалл Сервис Интеграция".
Все права защищены.