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

Экспорт отчетов по сторно из SetRetail10 в ERP (веб-сервис на стороне SetRetail10)

SRTE-3492 - Getting issue details... STATUS

CR-5381 - Getting issue details... STATUS

10.2.99.0

ВЕРСИЯ WEB-СЕРВИСА 1.1

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

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

МетодgetByFilter
URLhttp://IP-адрес_сервера:8090/SET-ERPIntegration/StornoExportServiceBean
WSDLhttp://IP-адрес_сервера:8090/SET-ERPIntegration/StornoExportServiceBean?wsdl

Поле

Тип данных

Описание

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

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

cash

Long

Номер кассы

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

type

string

Тип события:

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

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

Пример запроса
<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_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 сторнирования).
export.file.storno.filename.prefixstornoПрефикс файлов для выгрузки отчетов по событиям изменения количества товара в чеках (aka сторнирования)
export.file.storno.filename.separator-Разделитель в имени файлов выгрузки событий изменения количества товара в чеках (aka сторнирования)
export.file.storno.filename.extensionxmlРасширение файлов выгрузки событий изменения количества товара в чеках (aka сторнирования)
export.file.storno.polling.interval.sec60Интервал выгрузки событий изменения количества товара в чеках (aka сторнирования), сек
export.file.storno.short.interval.sec2Короткий интервал для выгрузки событий изменения количества товара в чеках (aka сторнирования), сек
export.file.storno.catalog.size.records100Размер порции для выгрузки событий изменения количества товара в чеках (aka сторнирования)
export.file.storno.version1.0Версия выгрузки событий изменения количества товара в чеках (aka сторнирования)
storno.export.document.schema.version1.0Версия документа выгрузки отчетов по событиям изменения количества товара в чеках (aka сторнирования) через ws-service
export.file.storno.enabledtrueФлаг-признак: разрешена ли выгрузка событий изменения количества товара в чеках (aka сторнирования) в файл
export.set10wsclient.storno.enabledtrueФлаг-признак: разрешена ли выгрузка событий изменения количества товара в чеках (aka сторнирования) в веб-сервис на стороне ERP

События отчета по сторно <storno-events/storno-event>

storno-events/storno-event

Наименование элемента

Тип данных

Описание

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

storno-events

stornoEventType

Каталог списка событий редактирования позиций в чеках

Да
Наименование элементаТип данныхОписаниеОбязательное
storno-eventКомплексныйСобытие редактирования позиции в чекеДа
Наименование атрибутаТип данныхОписаниеОбязательное
shopLongНомер магазинаНет
cashLongНомер кассыНет
shiftLongНомер сменыНет
receipt-numberLongНомер чекаНет
event-typeКомплексный

Тип события:

  • STORNO (Сторно) - уменьшение количество позиций товара кассиром в чеке до “0”
  • CHANGE (Изменения) - уменьшение количества позиций товара кассиром (не до значения “0”)
  • CANCEL (Отмена) - удаление позиции из подвала чека (товар не добавляется к чеку; применимо только для POS).
Нет
cashier-idStringТабельный номер кассира, оформляющего чекНет
cashier-nameStringФИО кассира, оформляющего чекНет
admin-idString

Табельный номер администратора, сделавшего отмену или изменение

Правила заполнения:

Если позицию удаляет не сам кассир, а администратор под своим логином\картой, то в отчёте:

  1. в поле "Кассир" (cashier-name) попадает фамилия кассира, оформляющего чек

  2. в поле "Табельный номер кассира" (cashier-id) попадает номер кассира, оформляющего чек

  3. в поле "Табельный номер администратора" (admin-id) попадает табельный номер администратора, удаливший позицию

Если позицию удаляет кассир, но при специальном положении ключа, то в отчете:

1. в поле "Кассир" (cashier-name) попадает имя кассира оформляющего чек,
2. в поле "Табельный номер кассира" (cashier-id) попадает номер кассира, оформляющего чек
3. в поле "Табельный номер администратора" (admin-id) попадает табельный номер кассира, оформляющего чек (и соответственно, удаливший позицию)

Нет
barcodeStringШтрих-код товараНет
markingStringКод/Артикул товараНет
good-nameStringНаименование товараНет
qnty-beforeDecimalКоличество товара, которое было в позиции до выполнения операции сторнированияНет
qnty-afterDecimalКоличество товара, которое стало в позиции после выполнения операции сторнирования. Для типа “сторно” и “отмена” = 0Нет
priceDecimalБазовая (Первая цена) цена на товар до момента расчёта скидокНет
delete-position-reason-idLong

Код причины удаления позиции

  • SRTS-852 - Getting issue details... STATUS
  • 10.3.15.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-2021, ООО "Кристалл Сервис Интеграция".
Все права защищены.

Политика обработки персональных данных