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

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

Owned by Парень Александр
Last updated: сент. 05, 2023
2 min read

SRTE-3492 - Получение подробных данных проблемы… СТАТУС

CR-5381 - Получение подробных данных проблемы… СТАТУС

10.2.99.0

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

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

Методы

getByFilter 

URLhttp://Любой_IP-адрес_на стороне_ERP_сервера/StornoExportServiceBean
WSDL

http://Любой_IP-адрес_на стороне_ERP_сервера/StornoExportServiceBeanService.wsdl

Поле

Тип данных

Описание

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

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

cash

Long

Номер кассы

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

type

string

Тип события:

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

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

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

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

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

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_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 сторнирования).

События отчета по сторно <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 - Получение подробных данных проблемы… СТАТУС
  • 10.3.15.0
Нет
excise-tokenString

Информация о марке

SRTB-6910 - Получение подробных данных проблемы… СТАТУС

CR-9086 - Получение подробных данных проблемы… СТАТУС

10.3.25.0

Пример импорта

Нет
markString

Информация об акцизной марке

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, ООО "Кристалл Сервис Интеграция".
Все права защищены.

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