Описание

Поскольку SAP ERP не имеет возможности получать и обрабатывать чеки, совместно с передачей кодов DataMatrix маркированной продукции в экспорте чеков реализована выгрузка консолидированного отчета о проданных/возвращенных марках.

Правила формирования отчета

В отчет попадают все DataMatrix из чеков по всем товарам, пришедших на сервер SetCentrum за календарный день с 00:00:00 до 23:59:59.
Отчет выгружается в формате xml по web-сервису с сервера SetESB (микросервисы) в SAP один раз в сутки.
1. Например в 01:00, посылает GET-запрос в наш веб-сервис на стороне SetCentrum с указанием в аргументе запроса даты, за которую хочет забрать данные (если запрос в 01:00, то дата предыдущего дня).
2. Веб-сервис на стороне SetCentrum делает выборку по БД по дате сохранения чека и упаковывает результат в xml, и отдает в ответ на запрос.
Если на кассе была совершена продажа 01.01.2020, но из-за отсутствия связи чек на SetCentrum дошел только 03.01.2020, то данный DataMatrix должен выгружается в отчете за 03.01.2020 с датой продажи 01.01.2020.
Если чеки будут перевыгружаться с касс, то дубли исключаются. Внутри отчета указывается точное время продажи на кассе, по которому дубль можно идентифицировать в SAP, как дубль, а не нарушение.
Если в SAP требуется забрать отчет за более ранние даты, то в запросе от него, может быть указана любая дата в промежутке времени хранения чеков в БД сервера SetCentrum (2 месяца).
Если в запросе указана дата ранее 2 месяцев, то веб-сервис на стороне SetRetail10 вернет ошибку.
Не рекомендуется злоупотреблять вызовами веб-сервиса во избежание рисков ухудшить работу системы.
1. Рекомендуется один раз в сутки за прошедшую дату.
2. За редким исключением потери данных, когда можно вызвать вручную.

Веб-сервис для экспорта отчета DataMatrix

C обратной связью
Метод	get-datamatrix-events
URL	http://XXX.XXX.XXX.XXX:8090/SET-OperDay-Excise-Exporter/ExciseTokensUsageReaderBean
WSDL	http://XXX.XXX.XXX.XXX:8090/SET-OperDay-Excise-Exporter/ExciseTokensUsageReaderBean?wsdl

Поле		Тип данных	Описание	Обязательное
Принимаемые параметры
day		Date	Операционный день в формате YYYY-DD-MM	Да
Возвращаемые параметры
return		DataMartixSale	Данные по продажам DataMatix, в случае успешной обработки пакета
	data-matrix	String	Состав штрих-кода типа DataMatix
	marking	String	Код товара (артикул)
	sale-time	DateTime	Дата продажи позиции
	shop	Integer	Номер магазина
	sale	Boolean	Тип продажи: TRUE - продажа FALSE - возврат
	barcode	String	Штрих-код товара https://crystals.atlassian.net/browse/CR-4446 https://crystals.atlassian.net/browse/SRTE-3117 10.2.92.0

Пример запроса

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:exc="http://excise.exporter.operday.crystals.ru/">
   <soapenv:Header/>
   <soapenv:Body>
      <exc:get-datamatrix-events>
         <!--Optional:-->
         <day>2020-11-11</day>
      </exc:get-datamatrix-events>
   </soapenv:Body>
</soapenv:Envelope>

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

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
   <soap:Body>
      <ns2:get-datamatrix-eventsResponse xmlns:ns2="http://excise.exporter.operday.crystals.ru/">
         <return>
            <token data-matrix="00000046210654X:4SFyS0P9P97b7" marking="00002" sale-time="2020-11-11T20:58:50.228" shop="1370" sale="true" barcode="4600002000006"/>
            <token data-matrix="00000046210654X:4SFy20P9P27b9" marking="00001" sale-time="2020-11-11T20:58:50.228" shop="1370" sale="true" barcode="4600001000007"/>
         </return>
      </ns2:get-datamatrix-eventsResponse>
   </soap:Body>
</soap:Envelope>

Пример в SOAP UI

Экспорт отчета о реализованных товарах с данными DataMatrix по маркированной продукции

Описание

Правила формирования отчета

Веб-сервис для экспорта отчета DataMatrix

C обратной связью

Пример запроса

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