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

Описание

Данный вариант экспорта предполагает обмен данными на основе WEB-сервисов, предоставляемых SetRetail10, при которых, активной стороной запроса является ERP, то есть ERP должна забирать данные из SetRetail10. Соответственно SetRetail10 является пассивной стороной обмена, у которой забирают данные.

Внимание

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

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

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

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

Поле

Тип данных

Описание

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

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

dateOperDay

date

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

Да

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

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:getPurchasesByOperDay>
         <!--Optional:-->
         <dateOperDay>2019-05-08</dateOperDay>
      </plug:getPurchasesByOperDay>
   </soapenv:Body>
</soapenv:Envelope>

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


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

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

Поле

Тип данных

Описание

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

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

Year

integer

Год в формате YYYY

Нет

Mobth 

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

string

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

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

Day

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:getPurchasesByOperDayData>
         <Year>2019</Year>
         <!--Optional:-->
         <Mobth>MAY</Mobth>
         <Day>27</Day>
      </plug:getPurchasesByOperDayData>
   </soapenv:Body>
</soapenv:Envelope>

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

-

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

МетодgetPurchasesByPeriod
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

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


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

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

-

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

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

Поле

Тип данных

Описание

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

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

fromDate

date

Начало диапазона

Нет

toDate

date

Конец диапазона

Нет

goodsCode

string

Код товара

Нет

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

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:getPurchasesByPeriodAndProduct>
         <!--Optional:-->
         <fromDate>2019-05-01</fromDate>
         <!--Optional:-->
         <toDate>2019-05-31</toDate>
         <!--Optional:-->
         <goodsCode>45033</goodsCode>
      </plug:getPurchasesByPeriodAndProduct>
   </soapenv:Body>
</soapenv:Envelope>

-

Экспорт информации по отложенным чекам (включение)

Для включения выполнются скрипты базе данных set сервера SetRetail10/SetCentrum.

После выполнения скриптов включения, перезапутсите службу сервера.

CR-5382 - Getting issue details... STATUS

SRTE-3562 - Getting issue details... STATUS

10.2.99.0

Выгрузка для веб сервиса на стороне ERP и SetRetail10
UPDATE public.sales_management_properties
   SET property_value='1.18'       
 WHERE property_key = 'export.set10wsclient.purchases.version';
UPDATE public.sales_management_properties
   SET property_value='true'       
 WHERE property_key = 'export.set10wsclient.purchases.deferred.enabled';
Файловый экспорт
UPDATE public.sales_management_properties
   SET property_value='1.9'       
 WHERE property_key = 'export.file.purchases.version';
UPDATE public.sales_management_properties
   SET property_value='true'       
 WHERE property_key = 'export.file.purchases.deferred.enabled';

Отложенные чеки за операционный день

CR-5382 - Getting issue details... STATUS

SRTE-3562 - Getting issue details... STATUS

10.2.99.0

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

Поле

Тип данных

Описание

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

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

dateOperDay

dateTime

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

Нет

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

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:getReportDeferredByOperDay>
         <!--Optional:-->
         <dateOperDay>2021-07-07</dateOperDay>
      </plug:getReportDeferredByOperDay>
   </soapenv:Body>
</soapenv:Envelope>

-

Отложенные чеки по заданным параметрам

CR-5382 - Getting issue details... STATUS

SRTE-3562 - Getting issue details... STATUS

10.2.99.0

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

Поле

Тип данных

Описание

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

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

dateOperDay

dateTime

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

Нет
shopNumberLongНомер магазинаНет
cashNumberLongНомекр кассыНет
shiftNumberLongНомер сменыНет
cashierTabNoStringТабельный номер кассираНет

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

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:getReportDeferredByParams>
         <dateOperDay>?</dateOperDay>
         <!--Optional:-->
         <shopNumber>234</shopNumber>
         <!--Optional:-->
         <cashNumber>3</cashNumber>
         <!--Optional:-->
         <shiftNumber>9</shiftNumber>
         <!--Optional:-->
         <cashierTabNo>231</cashierTabNo>
      </plug:getReportDeferredByParams>
   </soapenv:Body>
</soapenv:Envelope>

asdasdas

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

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

Поле

Тип данных

Описание

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

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

dateOperDay

date

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

Да

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:getPurchasesByParams>
         <dateOperDay>2019-05-13</dateOperDay>
         <!--Optional:-->
         <shopNumber>3382</shopNumber>
         <!--Optional:-->
         <cashNumber>1</cashNumber>
         <!--Optional:-->
         <shiftNumber>1</shiftNumber>
         <!--Optional:-->
         <purchaseNumber>7</purchaseNumber>
      </plug:getPurchasesByParams>
   </soapenv:Body>
</soapenv:Envelope>

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

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

Кейсы

  1. dateOperDay - в отчёт попадают все чеки всех магазинов за операционный день dateOperDay.
  2. dateOperDayshopNumber - в отчёт попадают все чеки за операционный день dateOperDay с магазина shopNumber.
  3. dateOperDayshopNumbercashNumber - в отчёт попадают все чеки за операционный день dateOperDay с магазина shopNumber с кассы cashNumber.
  4. dateOperDayshopNumbercashNumbershiftNumber - в отчёт попадают все чеки смены shiftNumber за операционный день dateOperDay с магазина shopNumber с кассы cashNumber.
  5. dateOperDayshopNumbercashNumbershiftNumberpurchaseNumber - в отчёт попадает только один конкретный чек под номером purchaseNumber из сменыshiftNumber за операционный день dateOperDay с магазина shopNumber с кассы cashNumber.

Обработка не заданных параметров для метода getPurchasesByParams

SRTE-2613 - Getting issue details... STATUS

10.2.80.0

При использовании метода getPurchasesByParams, параметры могут обрабатываться, как не заполненные, если в их настройках указано значение xsi:nil

При использовании метода getPurchasesByParams, значение xsi:nil в параметрах, обрабатывается как не заполненный параметр.

Такокй кейс упрощает интеграцию SetRetail10 и 1С. 

Пример: для загрузки чеков c отбором по дате, магазину, для кассе в 1С используется метод getPurchasesByParams, в котором возможно заполнить параметры dateOperDay, shopNumber, cashNumber, но параметры shiftNumber, purchaseNumber заполнять не требуется.

Пример SOAP-запроса:

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
    <soap:Header/>
    <soap:Body> <m:getPurchasesByParams xmlns:m="http://plugins.operday.ERPIntegration.crystals.ru/">
    <dateOperDay xmlns=""
            xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">2019-10-29T00:00:00</dateOperDay>
    <shopNumber xmlns=""
            xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">2</shopNumber>
    <cashNumber xmlns=""
            xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">1</cashNumber>
    <shiftNumber xmlns=""
            xmlns:xs="http://www.w3.org/2001/XMLSchema"
            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
            xsi:nil="true"/>
    <purchaseNumber xmlns=""
            xmlns:xs="http://www.w3.org/2001/XMLSchema"
            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
            xsi:nil="true"/>
</m:getPurchasesByParams></soap:Body>
</soap:Envelope>

-

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

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

10.2.66.0

SRTE-2030 - Getting issue details... STATUS

Поле

Тип данных

Описание

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

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

dateOperDay

date

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

Да

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:getNewPurchasesByParams>
         <dateOperDay>2019-05-03</dateOperDay>
         <!--Optional:-->
         <shopNumber>3328</shopNumber>
         <!--Optional:-->
         <cashNumber>3</cashNumber>
         <!--Optional:-->
         <shiftNumber>16</shiftNumber>
         <!--Optional:-->
         <purchaseNumber>?</purchaseNumber>
      </plug:getNewPurchasesByParams>
   </soapenv:Body>
</soapenv:Envelope>

--

Экспорт новых, не отправленных чеков

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

В отчёте выгружаются только новые чеки (те которые ещё не забирали).

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

Поле

Тип данных

Описание

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

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

arrayOfParams

array

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

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

Да

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

return

base64Binary

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


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

Пример запроса
<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:getNewPurchasesByOperDay> 
			<!---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> 
			<!---Document number (optional)--> <arrayOfParams xsi:type="xs:long">2</arrayOfParams> 
		</plug:getNewPurchasesByOperDay> 
	</soapenv:Body> 
</soapenv:Envelope>

Экземпляры чеков со скидками и бонусными операциями

CORE-352 - Getting issue details... STATUS

10.2.54.0

Чеки и скидки с кассы в загружаются в операционный день не одновременно. В случае, если для чека были скидки, но в операционный день они ещё не пришли, такой чек не будет возвращаться веб-сервисами, пока для чека не придут скидки.

фшщвшфш-ыывуывывфыв

Получения инорфмации о чеках и расчетов скидок по ним

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

Поле

Тип данных

Описание

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

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

dateOperDay

Date

Определяет дату, за которую из операционного дня следует выбрать чеки


Да
shopNumberLongОпределяет номер магазина, чеки которого из операционного дня следует получитьНет
cashNumberLongОпределяет номер кассы, чеки которой из операционного дня следует получитьНет
shiftNumberLongОпределяет номер смены, чеки которой из операционного дня следует получитьНет
purchaseNumberLongОпределяет номер чека, который из опердня операционного дня получитьНет

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

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:getFullPurchasesByParams>
         <dateOperDay>2018-08-16</dateOperDay>
         <shopNumber>6502</shopNumber>
         <cashNumber>1</cashNumber>
         <shiftNumber>1</shiftNumber>
         <purchaseNumber>2</purchaseNumber>
      </plug:getFullPurchasesByParams>
   </soapenv:Body>
</soapenv:Envelope>


Получение новых чеков, которые не отправлялись веб-сервисом

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

Индекс

Тип данных

Описание

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

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

0

Date

Дата, за которую из операционного дня требуется получить новые чекиДа
1LongНомер магазина, от которого из операционного дня следует выбрать новые чекиНет
2LongНомер кассы, от которой из операционного дня следует выбрать новые чекиНет
3LongНомер смены, от которой из операционного дня следует выбрать новые чекиНет
4LongНомер чека, от которой из операционного дня следует выбрать новые чекиНет

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

return

base64Binary

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


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

  • Минимальный размер массива аргументов метода - 1 (потому что параметр "дата опердня" обязательный).
  • Если требуется пропустить, параметр "номер смены", тогда установите значение null, потому что за номером смены следует номер чека.
  • Если требуется номер чека, массиву допустимо быть длиной 4, потому что за параметром "номер чека" ничего не следует.
Пример запроса
<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:getNewFullPurchasesByOperDay>
         <arrayOfParams xsi:type="xs:dateTime">2018-08-16T12:00:00.000</arrayOfParams>
                <arrayOfParams xsi:type="xs:long">6502</arrayOfParams> <!-- Номер магазина -->
                <arrayOfParams xsi:type="xs:long">1</arrayOfParams> <!-- Номер кассы -->
                <arrayOfParams xsi:type="xs:long">1</arrayOfParams> <!-- Номер смены -->
                <arrayOfParams xsi:type="xs:long">2</arrayOfParams> <!-- Номер чека -->
      </plug:getNewFullPurchasesByOperDay>
   </soapenv:Body>
</soapenv:Envelope>

Настройка ограничения размера пачки экспорта чеков для веб-сервиса на стороне SetRetail10

SRTE-3008 - Getting issue details... STATUS

SRTE-2991 - Getting issue details... STATUS

10.2.92.0

Только для методов:

  • getNewPurchses(...)
  • getNewFullPurchases(...)

0 - размер не ограничен

SELECT add_property('SET_ERP_INTEGRATION', 'export.websevice.new.purchases.batch.size', '0', 'Ограничение размера пачки "новых" чеков возвращаемой вебсервисом. 0 - размер не ограничен.');

Методы веб-сервиса для экспорта 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. dateOperDayshopNumber - в отчёт попадают все смены за операционный день dateOperDay с магазина shopNumber.
  3. dateOperDayshopNumbercashNumber - в отчёт попадают все смены за операционный день dateOperDay с магазина shopNumber с кассы cashNumber.
  4. dateOperDayshopNumbercashNumbershiftNumber - в отчёт попадает смена 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 - Getting issue details... STATUS

Поле

Тип данных

Описание

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

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

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>

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

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

МетодgetLoyResultsByPeriod
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

Отчет по скидкам за период


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

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


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

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

Поле

Тип данных

Описание

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

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

fromDate

date

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

Нет

toDate

date

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

Нет

goodsCode

string

Код товара

Нет

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

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:getLoyResultsByPeriodAndProduct>
         <!--Optional:-->
         <fromDate>2019-03-01</fromDate>
         <!--Optional:-->
         <toDate>2019-05-31</toDate>
         <!--Optional:-->
         <goodsCode>45035</goodsCode>
      </plug:getLoyResultsByPeriodAndProduct>
   </soapenv:Body>
</soapenv:Envelope>


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

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

Поле

Тип данных

Описание

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

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

fromDate

date

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

Нет

toDate

date

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

Нет

shopNumber

integer

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

Нет

cashNumber

integer

Номер кассы

Нет

shiftNumber

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:getLoyResultsByPeriodAndShift>
         <!--Optional:-->
         <fromDate>2019-05-01</fromDate>
         <!--Optional:-->
         <toDate>2019-05-31</toDate>
         <!--Optional:-->
         <shopNumber>3328</shopNumber>
         <!--Optional:-->
         <cashNumber>1</cashNumber>
         <!--Optional:-->
         <shiftNumber>15</shiftNumber>
      </plug:getLoyResultsByPeriodAndShift>
   </soapenv:Body>
</soapenv:Envelope>

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

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

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

Поле

Тип данных

Описание

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

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

operday

date

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

Нет

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

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:getIntroductionsByOperday>
         <!--Optional:-->
         <operday>2019-06-03</operday>
      </plug:getIntroductionsByOperday>
   </soapenv:Body>
</soapenv:Envelope>

-

За период

МетодgetIntroductionsByPeriod
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

Внесения за период


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

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

Методы веб-сервиса для экспорта изъятий

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

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

Поле

Тип данных

Описание

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

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

operday

date

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

Нет

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

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:getWithdrawalsByOperday>
         <!--Optional:-->
         <operday>2019-05-13</operday>
      </plug:getWithdrawalsByOperday>
   </soapenv:Body>
</soapenv:Envelope>

-

За период

МетодgetWithdrawalsByPeriod
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

Изъятия за период


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

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

Методы веб-сервиса для экспорта отчета по продажам (реализации) (на стороне SetRetail10)

Выгрузка отчета по продажам доступна только в SetRetail10, в SetCentrum10 выгрузка таких данных не предусмотрена.

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

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

Поле

Тип данных

Описание

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

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

dateOperDay

date

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

Нет

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

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:getSalesReportOperDay>
         <!--Optional:-->
         <dateOperDay>2019-05-13</dateOperDay>
      </plug:getSalesReportOperDay>
   </soapenv:Body>
</soapenv:Envelope>

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

Выгрузка отчета по продажам доступна только в SetRetail10, в SetCentrum10 выгрузка таких данных не предусмотрена.

За заданный операционный день с разбивкой по налоговым ставкам

МетодgetSalesReportWithTax
URLhttp://IP-адрес_сервера:8090/SET-ERPIntegration/FiscalInfoExport
WSDLhttp://IP-адрес_сервера:8090/SET-ERPIntegration/FiscalInfoExport?wsdl
КомментарийВ данном методе добавлен блок распределения сумм по типам отплат по налоговым ставкам

Поле

Тип данных

Описание

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

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

dateOperDay

date

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

Нет

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

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:getSalesReportWithTax>
         <!--Optional:-->
         <dateOperDay>2019-05-13</dateOperDay>
      </plug:getSalesReportWithTax>
   </soapenv:Body>
</soapenv:Envelope>

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

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

10.2.42.0

SRTE-1220 - Getting issue details... STATUS

Поле

Тип данных

Описание

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

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

dateOperDay

date

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

Нет

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

return

base64Binary

Отчет о продажах за операционный день


Описание формата выгрузки отчёта по продажам с разбивкой по налогам

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

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

10.2.27.0

SRTE-736 - Getting issue details... STATUS

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

МетодgetCashierWorkTime
URLhttp://IP-адрес_сервера:8090/SET-OperDay/ExporterWS
WSDLhttp://IP-адрес_сервера:8090/SET-OperDay/ExporterWS?wsdl

Поле

Тип данных

Описание

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

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

dateOperday

date

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

Да

shopNumber

Integer

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

Нет

cashNumber

Integer

Номер кассы

Нет

shiftNumber

integer

Номер смены

Нет

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

return

base64Binary

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


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

Пример запроса
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:exp="http://export.operday.crystals.ru/">
   <soapenv:Header/>
   <soapenv:Body>
      <exp:getCashierWorkTime>
         <dateOperday>2019-05-15</dateOperday>
         <!--Optional:-->
         <shopNumber>3382</shopNumber>
         <!--Optional:-->
         <cashNumber>2</cashNumber>
         <!--Optional:-->
         <shiftNumber>8</shiftNumber>
      </exp:getCashierWorkTime>
   </soapenv:Body>
</soapenv:Envelope>
Пример отчета по времени работы кассиров
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<worktimes>
    <worktime tabNumber="21323" userName="Иванова Мария Александровна" shopNumber="234" cashNumber="3" shiftNumber="44" logInDate="2021-07-06 15:42:18" logOffDate="2021-07-06 16:15:02"/>
    <worktime tabNumber="123123" userName="Иванова Ксения Ивановна" shopNumber="234" cashNumber="3" shiftNumber="44" logInDate="2021-07-06 17:03:17" logOffDate="2021-07-06 17:21:28"/>
    <worktime tabNumber="21323" userName="Иванова Мария Александровна" shopNumber="234" cashNumber="3" shiftNumber="44" logInDate="2021-07-06 17:26:37" logOffDate="2021-07-06 17:26:45"/>
    <worktime tabNumber="21323" userName="Иванова Мария Александровна" shopNumber="234" cashNumber="3" shiftNumber="44" logInDate="2021-07-06 17:29:31" logOffDate="2021-07-06 17:41:17"/>
</worktimes>

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

10.2.59.0

SR-2502 - Getting issue details... STATUS

По номеру подарочной карты

МетодgetPresentCardInformation
URLhttp://IP-адрес_сервера:8090/SET-Cards-PresentCards/SET/Cards/PresentCards/ProcessingManager
WSDLhttp://IP-адрес_сервера:8090/SET-Cards-PresentCards/SET/Cards/PresentCards/ProcessingManager?wsdl

Поле

Тип данных

Описание

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

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

cardNumber

String

Номер карты

Да

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

return

xml

Информация по подарочное карте


amountLongСумма подарочной карты
balanceLongОстаток суммы подарочной карты
cardNumberStringНомер подарочной карты
expirationDatedateTimeДата окончания действия
statuscardStatus

Статус подарочной карты:

В этом методе может быть статус карты Active, но, при этом у карты может быть просрочена дата окончания действия.

Проверяйте дату окончания отдельно.


  • Create
  • Active
  • Blocked
  • Inactive
  • Used
  • PreActive
  • PreUsed
  • PreDeactive
  • NeedReturn
  • NeedTakeAway

Описание формата данных

Пример запроса
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.processing.cards.crystals.ru/">
   <soapenv:Header/>
   <soapenv:Body>
      <ser:getPresentCardInformation>
         <!--Optional:-->
         <cardNumber>654987</cardNumber>
      </ser:getPresentCardInformation>
   </soapenv:Body>
</soapenv:Envelope>


По номеру магнитной полосы MSR подарочной карты

МетодgetPresentCardInformationByMSRNumber
URLhttp://IP-адрес_сервера:8090/SET-Cards-PresentCards/SET/Cards/PresentCards/ProcessingManager
WSDLhttp://IP-адрес_сервера:8090/SET-Cards-PresentCards/SET/Cards/PresentCards/ProcessingManager?wsdl

Поле

Тип данных

Описание

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

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

cardNumber

String

Номер карты

Да

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

return

xml

Информация по подарочное карте


amountLongСумма подарочной карты
balanceLongОстаток суммы подарочной карты
cardNumberStringНомер подарочной карты
expirationDatedateTimeДата окончания действия
statuscardStatus

Статус подарочной карты:

В этом методе может быть статус карты Active, но, при этом у карты может быть просрочена дата окончания действия.

Проверяйте дату окончания отдельно.

  • Create
  • Active
  • Blocked
  • Inactive
  • Used
  • PreActive
  • PreUsed
  • PreDeactive
  • NeedReturn
  • NeedTakeAway

Описание формата данных

Пример запроса
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.processing.cards.crystals.ru/">
   <soapenv:Header/>
   <soapenv:Body>
      <ser:getPresentCardInformationByMSRNumber>
         <!--Optional:-->
         <msrNumber>654987</msrNumber>
      </ser:getPresentCardInformationByMSRNumber>
   </soapenv:Body>
</soapenv:Envelope>


По фильтрам

МетодgetPresentCardsInfoByFilter
URLhttp://IP-адрес_сервера:8090/SET-Cards-PresentCards/SET/Cards/PresentCards/ProcessingManager
WSDLhttp://IP-адрес_сервера:8090/SET-Cards-PresentCards/SET/Cards/PresentCards/ProcessingManager?wsdl

Поле

Тип данных

Описание

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

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

cardNumber

String

Номер карты

Нет
endDateFromdateTimeДата окончания действия карты [от] в формате YYYY-MM-DDНет
endDateTodateTimeДата окончания действия карты [до] в формате YYYY-MM-DDНет
operationDateFromdateTimeДата операций по подарочной карте [от] в формате YYYY-MM-DDНет
operationDateTodateTimeДата операций по подарочной карте [до] в формате YYYY-MM-DDНет
paymentDatedateTimeДата оплаты подарочной картой в формате YYYY-MM-DDНет
saleDatedateTimeДата продажи подарочной картой в формате YYYY-MM-DDНет
startDateFromdateTimeДата начала действия карты [от] в формате YYYY-MM-DDНет
startDateTodateTimeДата начала действия карты [до] в формате YYYY-MM-DDНет
statuscardStatus

Статус подарочной карты:

  • Create
  • Active
  • Blocked
  • Inactive
  • Used
  • PreActive
  • PreUsed
  • PreDeactive
  • NeedReturn
  • NeedTakeAway
Нет

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

return

base64

Информация по подарочное карте


Описание формата данных

Пример запроса
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.processing.cards.crystals.ru/">
   <soapenv:Header/>
   <soapenv:Body>
      <ser:getPresentCardsInfoByFilter>
         <!--Optional:-->
         <filter>
            <!--Optional:-->
            <cardNumber>654987</cardNumber>
            <!--Optional:-->
            <endDateFrom>2019-01-30</endDateFrom>
            <!--Optional:-->
            <endDateTo>2019-06-30</endDateTo>
            <!--Optional:-->
            <operationDateFrom>2019-01-30</operationDateFrom>
            <!--Optional:-->
            <operationDateTo>2019-06-30</operationDateTo>
            <!--Optional:-->
            <paymentDate>2019-04-08</paymentDate>
            <!--Optional:-->
            <saleDate>2019-04-08</saleDate>
            <!--Optional:-->
            <startDateFrom>2019-04-08</startDateFrom>
            <!--Optional:-->
            <startDateTo>2019-04-08</startDateTo>
            <!--Optional:-->
            <status>Active</status>
         </filter>
      </ser:getPresentCardsInfoByFilter>
   </soapenv:Body>
</soapenv:Envelope>


По HEX-представлению

10.2.60.0

МетодgetCardInformationByNumberAsHex
URLhttp://IP-адрес_сервера:8090//SET-Cards/SET/Cards/ExternalSystemCardsProcessing
WSDLhttp://IP-адрес_сервера:8090//SET-Cards/SET/Cards/ExternalSystemCardsProcessing?wsdl

Поле

Тип данных

Описание

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

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

cardNumber

String

Номер карты

Нет

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

return

base64

Информация по подарочное карте


Работает как и метод getCardInformationByNumber, но дополнительно проверяет корректность записи номера в 16-ичной системы счисления.

Описание формата данных

В этом методе может быть статус карты Active, но, при этом у карты может быть просрочена дата окончания действия.

Проверяйте дату окончания отдельно.

Пример запроса
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:proc="http://processing.cards.crystals.ru/">
   <soapenv:Header/>
   <soapenv:Body>
      <proc:getCardInformationByNumberAsHex>
         <cardNumber>FFFFFFFE</cardNumber>
      </proc:getCardInformationByNumberAsHex>
   </soapenv:Body>
</soapenv:Envelope>

SRTE-2513 - Getting issue details... STATUS

10.2.78.0

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

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

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

Поле

Тип данных

Описание

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

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

dateOperDay

Date

Дата операционного дня в формате

YYYY-MM-DD

Может быть передана только одна дата.

Да
shopNumberString

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

Может быть передано несколько номеров магазинов.

Нет
goodsCodeString

Код (артикул товара)

Может быть передано несколько кодов товаров

Нет

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

return

xml

Информация о проданных товарах


salesxmlПродажи

shopIntegerМагазин
operationDayLongОстаток суммы подарочной карты
positionsxmlПозиции

markingOfTheGoodStringКод (артикул товара)
nameStringНаименование товара
countIntegerКоличество

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

По дате операционного дня

В ответе выводятся данные о продажах всех товаров по всем магазинам, подключённых к опрашиваемому SetCentrum.

Запрос
<dateOperDay>2019-11-26</dateOperDay>
Ответ
<sales shop="0123" operationDay="2019-11-26">
   <position markingOfTheGood="01" name="Пирог с вишней" count="10000"/>
   <position markingOfTheGood="02" name="Пирог с клубникой" count="6000"/>
</sales>
<sales shop="0321" operationDay="2019-11-26">
   <position markingOfTheGood="01" name="Пирог с вишней" count="6000"/>
</sales>
<sales shop="0451" operationDay="2019-11-26">
   <position markingOfTheGood="01" name="Пирог с вишней" count="6000"/>
</sales>


По дате операционного дня и номерам магазинов

В ответе выводятся данные о продажах всех товаров только в указанных магазинах.

Запрос
<dateOperDay>2019-11-26</dateOperDay>
<shopNumber>0123 0321</shopNumber>
Ответ
<sales shop="0123" operationDay="2019-11-26">
   <position markingOfTheGood="01" name="Пирог с вишней" count="10000"/>
   <position markingOfTheGood="02" name="Пирог с клубникой" count="6000"/>
</sales>
<sales shop="0321" operationDay="2019-11-26">
   <position markingOfTheGood="01" name="Пирог с вишней" count="6000"/>
</sales>


По дате операционного дня и кодам товаров

В ответе выводятся данных о продажах только указанных товаров во всех магазинах, подключённых к опрашиваемому SetCentrum.

Запрос
<dateOperDay>2019-11-26</dateOperDay>
<goodsCode>01 02</goodsCode>
Ответ
<sales shop="0123" operationDay="2019-11-26">
   <position markingOfTheGood="01" name="Пирог с вишней" count="10000"/>
   <position markingOfTheGood="02" name="Пирог с клубникой" count="6000"/>
</sales>
<sales shop="0321" operationDay="2019-11-26">
   <position markingOfTheGood="01" name="Пирог с вишней" count="6000"/>
</sales>
<sales shop="0451" operationDay="2019-11-26">
   <position markingOfTheGood="01" name="Пирог с вишней" count="6000"/>
</sales>


По дате операционного дня, кодам магазинов и кодам товаров

В ответе выводятся данных о продажах только указанных товаров только в указанных магазинах.

Запрос
<dateOperDay>2019-11-26</dateOperDay>
<shopNumber>0123 0321</shopNumber>
<goodsCode>01 02</goodsCode>
Ответ
<sales shop="0123" operationDay="2019-11-26">
   <position markingOfTheGood="01" name="Пирог с вишней" count="10000"/>
   <position markingOfTheGood="02" name="Пирог с клубникой" count="6000"/>
</sales>
<sales shop="0321" operationDay="2019-11-26">
   <position markingOfTheGood="01" name="Пирог с вишней" count="6000"/>
</sales>

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

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

Метод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