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

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

Owned by Парень Александр
Last updated: окт. 28, 2021
3 min read

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

За заданный операционный день

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

Поле

Тип данных

Описание

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

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

dateOperDay

date

Операционный день в формате YYYY-MM-DD

Нет

Возвращаемые параметры

return

base64Binary

Z-отчеты за операционный день


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

Пример запроса
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:plug="http://plugins.operday.ERPIntegration.crystals.ru/">
   <soapenv:Header/>
   <soapenv:Body>
      <plug:getZReportsByOperDay>
         <!--Optional:-->
         <dateOperDay>2019-05-28</dateOperDay>
      </plug:getZReportsByOperDay>
   </soapenv:Body>
</soapenv:Envelope>

-

За заданный операционный день c вводом параметров

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

Поле

Тип данных

Описание

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

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

Year

integer

Год

Нет

Mobth

 Параметр mobth для вызова установки значений месяца должен использоваться именно в таком написании. Его наименование не совпадает со словом месяц (month) на английском языке!

string

Месяц в текстовом формате:

  • JANUARY
  • FEBRUARY
  • MARCH
  • APRIL
  • MAY
  • JUNE
  • JULY
  • AUGUST
  • SEPTEMBER
  • OCTOBER
  • NOVEMBER
  • DECEMBER
Да

Day

integer

День месяца

Нет

Возвращаемые параметры

return

base64Binary

Z-отчеты за операционный день


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

Методы getZReportsByOperDay и getZReportsByOperDayData отличаются только способом передачи параметров.

Пример запроса
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:plug="http://plugins.operday.ERPIntegration.crystals.ru/">
   <soapenv:Header/>
   <soapenv:Body>
      <plug:getZReportsByOperDayData>
         <Year>2019</Year>
         <!--Optional:-->
         <Mobth>MAY</Mobth>
         <Day>28</Day>
      </plug:getZReportsByOperDayData>
   </soapenv:Body>
</soapenv:Envelope>

-

За заданный период

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

Поле

Тип данных

Описание

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

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

fromDate

date

Начало диапазона в формете YYYY-MM-DD

Нет

toDate

date

Конец диапазона формате YYYY-MM-DD

Нет

Возвращаемые параметры

return

base64Binary

Z-отчеты за операционный день


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

Пример запроса
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:plug="http://plugins.operday.ERPIntegration.crystals.ru/">
   <soapenv:Header/>
   <soapenv:Body>
      <plug:getZReportsByPeriod>
         <!--Optional:-->
         <fromDate>2018-12-01</fromDate>
         <!--Optional:-->
         <toDate>2019-05-13</toDate>
      </plug:getZReportsByPeriod>
   </soapenv:Body>
</soapenv:Envelope>

-

По заданным параметрам

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


Поле

Тип данных

Описание

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

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

dateOperDay

date

Операционный день YYYY-MM-DD

Да

shopNumber

integer

Номер магазина

Нет

cashNumber

integer

Номер кассы

Нет

shiftNumber

integer

Номер смены

Нет

Возвращаемые параметры

return

base64Binary

Z-отчеты по заданным параметрам


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

Параметры shopNumber, cashNumber, shiftNumber – являются необязательными.

В зависимости от полноты указания параметров, в ответе будет возвращаться соответствующее количество смен.

Кейсы

  1. dateOperDay - в отчёт попадают все смены всех магазинов за операционный день dateOperDay. 
  2. dateOperDay, shopNumber - в отчёт попадают все смены за операционный день dateOperDay с магазина shopNumber.
  3. dateOperDay, shopNumber, cashNumber - в отчёт попадают все смены за операционный день dateOperDay с магазина shopNumber с кассы cashNumber.
  4. dateOperDay, shopNumber, cashNumber, shiftNumber - в отчёт попадает смена shiftNumber за операционный день dateOperDay с магазина shopNumber с кассы cashNumber.
Пример запроса
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:plug="http://plugins.operday.ERPIntegration.crystals.ru/">
   <soapenv:Header/>
   <soapenv:Body>
      <plug:getZReportsByParams>
         <dateOperDay>2019-05-13</dateOperDay>
         <!--Optional:-->
         <shopNumber>3455</shopNumber>
         <!--Optional:-->
         <cashNumber>1</cashNumber>
         <!--Optional:-->
         <shiftNumber>16</shiftNumber>
      </plug:getZReportsByParams>
   </soapenv:Body>
</soapenv:Envelope>

-

Новые, не отправленные Z-отчеты

МетодgetNewZReportsByOperDay
URLhttp://IP-адрес_сервера:8090/SET-ERPIntegration/FiscalInfoExport
WSDLhttp://IP-адрес_сервера:8090/SET-ERPIntegration/FiscalInfoExport?wsdl
  • Выгружаются только новые Z-отчеты (те которые ещё не забирали).
  • Выгружаются все новые Z-отчеты за указанный операционный день, либо удовлетворяющие заданным параметрам, если они указаны.


Поле

Тип данных

Описание

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

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

arrayOfParams

array

Массив параметров по следующему формату:

[OperDay (DateTime, REQUIRED), shop(Long), cash(Long), shift(Long]

Да

Возвращаемые параметры

return

base64Binary

Z-отчеты за операционный день или по заданным параметрам


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

Пример запроса
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:plug="http://plugins.operday.ERPIntegration.crystals.ru/" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> 
	<soapenv:Header/> 
	<soapenv:Body> 
		<plug: getNewZReportsByOperDay > 
			<!---OperDay --> 
			<arrayOfParams xsi:type="xs:dateTime">2014-11-24T12:00:00.000</arrayOfParams> 
			<!---Shop number (optional) --> 
			<arrayOfParams xsi:type="xs:long">12345</arrayOfParams> 
			<!---Cash number (optional)--> 
			<arrayOfParams xsi:type="xs:long">1</arrayOfParams> 
			<!---Shift number (optional)--> <arrayOfParams xsi:type="xs:long">3</arrayOfParams> 
		</plug: getNewZReportsByOperDay > 
	</soapenv:Body> 
</soapenv:Envelope>

-

Выгрузка новых, не отправленных Z-отчётов за операционный день с вводом параметров

МетодgetNewZReportsByParams
URLhttp://IP-адрес_сервера:8090/SET-ERPIntegration/FiscalInfoExport
WSDLhttp://IP-адрес_сервера:8090/SET-ERPIntegration/FiscalInfoExport?wsdl
КомментарийВыгружаются все новые Z-отчеты за указанный операционный день, либо удовлетворяющие заданным параметрам, если они указаны.

10.2.66.0

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

Поле

Тип данных

Описание

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

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

dateOperDay

date

Операционный день

Да

shopNumber

integer

Номер магазина

Да

cashNumber

integer

Номер кассы

Да

shiftNumber

integer

Номер смены

Да

purchaseNumber

integer

Номер чека

Да

Возвращаемые параметры

return

base64Binary

Чеки по заданным параметрам


Пример запроса
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:plug="http://plugins.operday.ERPIntegration.crystals.ru/">
   <soapenv:Header/>
   <soapenv:Body>
      <plug:getNewZReportsByParams>
         <dateOperDay>2019-05013</dateOperDay>
         <!--Optional:-->
         <shopNumber>3328</shopNumber>
         <!--Optional:-->
         <cashNumber>3</cashNumber>
         <!--Optional:-->
         <shiftNumber>14</shiftNumber>
      </plug:getNewZReportsByParams>
   </soapenv:Body>
</soapenv:Envelope>

© 1994-2024, ООО "Кристалл Сервис Интеграция".
Все права защищены.

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