1 Описание

Описание

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

Внимание

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

К оглавлению

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

За заданный операционный день
Метод	getPurchasesByOperDay
URL	http://IP-адрес_сервера:8090/SET-ERPIntegration/FiscalInfoExport
WSDL	http://IP-адрес_сервера:8090/SET-ERPIntegration/FiscalInfoExport?wsdl

Поле	Тип данных	Описание	Обязательное
Принимаемые параметры
dateOperDay	date	Операционный день в формате YYYY-MM-DD	Да
Возвращаемые параметры
return	base64Binary	Чеки за операционный день
Возвращаемый результат не содержит полные данные по бонусам и скидкам. Для полного просмотра бонусов и скидок используйте метод getFullPurchasesByParams.

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

<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
URL	http://IP-адрес_сервера:8090/SET-ERPIntegration/FiscalInfoExport
WSDL	http://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	Чеки за операционный день
Возвращаемый результат не содержит полные данные по бонусам и скидкам. Для полного просмотра бонусов и скидок используйте метод getFullPurchasesByParams.

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

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

<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
URL	http://IP-адрес_сервера:8090/SET-ERPIntegration/FiscalInfoExport
WSDL	http://IP-адрес_сервера:8090/SET-ERPIntegration/FiscalInfoExport?wsdl

Поле	Тип данных	Описание	Обязательное
Принимаемые параметры
fromDate	date	Начало диапазона в формате YYYY-MM-DD	Нет
toDate	date	Конец диапазона в формате YYYY-MM-DD	Нет
Возвращаемые параметры
return	base64Binary	Чеки за операционный день
Возвращаемый результат не содержит полные данные по бонусам и скидкам. Для полного просмотра бонусов и скидок используйте метод getFullPurchasesByParams.

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

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

<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
URL	http://IP-адрес_сервера:8090/SET-ERPIntegration/FiscalInfoExport
WSDL	http://IP-адрес_сервера:8090/SET-ERPIntegration/FiscalInfoExport?wsdl

Поле	Тип данных	Описание	Обязательное
Принимаемые параметры
fromDate	date	Начало диапазона	Нет
toDate	date	Конец диапазона	Нет
goodsCode	string	Код товара	Нет
Возвращаемые параметры
return	base64Binary	Чеки за операционный день
Возвращаемый результат не содержит полные данные по бонусам и скидкам. Для полного просмотра бонусов и скидок используйте метод getFullPurchasesByParams.

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

<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. После выполнения скриптов включения, перезапустите службу сервера. https://crystals.atlassian.net/browse/CR-5382 https://crystals.atlassian.net/browse/SRTE-3562 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';`

Отложенные чеки за операционный день https://crystals.atlassian.net/browse/CR-5382 https://crystals.atlassian.net/browse/SRTE-3562 10.2.99.0
Метод	getReportDeferredByOperDay
URL	http://IP-адрес_сервера:8090/SET-ERPIntegration/FiscalInfoExport
WSDL	http://IP-адрес_сервера:8090/SET-ERPIntegration/FiscalInfoExport?wsdl

Поле	Тип данных	Описание	Обязательное
Принимаемые параметры
dateOperDay	dateTime	Операционный день в формате YYYY-MM-DD	Нет
Возвращаемые параметры
return	base64Binary	Чеки за операционный день
Возвращаемый результат не содержит полные данные по бонусам и скидкам. Для полного просмотра бонусов и скидок используйте метод getFullPurchasesByParams.

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

<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>

-

Отложенные чеки по заданным параметрам https://crystals.atlassian.net/browse/CR-5382 https://crystals.atlassian.net/browse/SRTE-3562 10.2.99.0
Метод	getReportDeferredByParams
URL	http://IP-адрес_сервера:8090/SET-ERPIntegration/FiscalInfoExport
WSDL	http://IP-адрес_сервера:8090/SET-ERPIntegration/FiscalInfoExport?wsdl

Поле	Тип данных	Описание	Обязательное
Принимаемые параметры
dateOperDay	dateTime	Операционный день в формате YYYY-MM-DD	Нет
shopNumber	Long	Номер магазина	Нет
cashNumber	Long	Номер кассы	Нет
shiftNumber	Long	Номер смены	Нет
cashierTabNo	String	Табельный номер кассира	Нет
Возвращаемые параметры
return	base64Binary	Чеки за операционный день
Возвращаемый результат не содержит полные данные по бонусам и скидкам. Для полного просмотра бонусов и скидок используйте метод getFullPurchasesByParams.

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

<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
URL	http://IP-адрес_сервера:8090/SET-ERPIntegration/FiscalInfoExport
WSDL	http://IP-адрес_сервера:8090/SET-ERPIntegration/FiscalInfoExport?wsdl

Поле	Тип данных	Описание	Обязательное
Принимаемые параметры
dateOperDay	date	Операционный день в формате YYYY-MM-DD	Да
shopNumber	integer	Номер магазина	Нет
cashNumber	integer	Номер кассы	Нет
shiftNumber	integer	Номер смены	Нет
purchaseNumber	integer	Номер чека	Нет
Возвращаемые параметры
return	base64Binary	Чеки по заданным параметрам
Возвращаемый результат не содержит полные данные по бонусам и скидкам. Для полного просмотра бонусов и скидок используйте метод getFullPurchasesByParams.

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

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

<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 – являются необязательными.

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

Кейсы

dateOperDay - в отчёт попадают все чеки всех магазинов за операционный день dateOperDay.
dateOperDay, shopNumber - в отчёт попадают все чеки за операционный день dateOperDay с магазина shopNumber.
dateOperDay, shopNumber, cashNumber - в отчёт попадают все чеки за операционный день dateOperDay с магазина shopNumber с кассы cashNumber.
dateOperDay, shopNumber, cashNumber, shiftNumber - в отчёт попадают все чеки смены shiftNumber за операционный день dateOperDay с магазина shopNumber с кассы cashNumber.
dateOperDay, shopNumber, cashNumber, shiftNumber, purchaseNumber - в отчёт попадает только один конкретный чек под номером purchaseNumber из сменыshiftNumber за операционный день dateOperDay с магазина shopNumber с кассы cashNumber.

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

https://crystals.atlassian.net/browse/SRTE-2613

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
URL	http://IP-адрес_сервера:8090/SET-ERPIntegration/FiscalInfoExport
WSDL	http://IP-адрес_сервера:8090/SET-ERPIntegration/FiscalInfoExport?wsdl
Комментарий	Выгружаются все новые чеки за указанный операционный день, либо удовлетворяющие заданным параметрам, если они указаны.
10.2.66.0 https://crystals.atlassian.net/browse/SRTE-2030

Поле	Тип данных	Описание	Обязательное
Принимаемые параметры
dateOperDay	date	Операционный день в формате YYYY-MM-DD	Да
shopNumber	integer	Номер магазина	Нет
cashNumber	integer	Номер кассы	Нет
shiftNumber	integer	Номер смены	Нет
purchaseNumber	integer	Номер чека	Нет
Возвращаемые параметры
return	base64Binary	Чеки по заданным параметрам
Возвращаемый результат не содержит полные данные по бонусам и скидкам. Для полного просмотра бонусов и скидок используйте метод getFullPurchasesByParams.

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

<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
URL	http://IP-адрес_сервера:8090/SET-ERPIntegration/FiscalInfoExport
WSDL	http://IP-адрес_сервера:8090/SET-ERPIntegration/FiscalInfoExport?wsdl

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

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

Поле	Тип данных	Описание	Обязательное
Принимаемые параметры
arrayOfParams	array	Массив параметров по следующему формату: `[OperDay (DateTime, REQUIRED), shop(Long), cash(Long), shift(Long), number(Long)]`	Да
Возвращаемые параметры
return	base64Binary	Чеки за операционный день
Возвращаемый результат не содержит полные данные по бонусам и скидкам. Для полного просмотра бонусов и скидок используйте метод getFullPurchasesByParams.

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

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

<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>

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

https://crystals.atlassian.net/browse/CORE-352

10.2.54.0

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

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

Для увеличения или уменьшения периода хранения скидок в днях можно скорректировать в конфигурационном файле сервера параметр erpi.loy.transaction.clean.days.interval:

Linux: /var/lib/jboss/standalone/configuration/modules/erp-integration/ERPIntegration.properties
Windows: {Папка SetRetail10}\standalone\configuration\modules\erp-integration\ERPIntegration.properties

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

Получение информации о чеках и расчетов скидок по ним
Метод	getFullPurchasesByParams
URL	http://IP-адрес_сервера:8090/SET-ERPIntegration/FiscalInfoExport
WSDL	http://IP-адрес_сервера:8090/SET-ERPIntegration/FiscalInfoExport?wsdl

Поле	Тип данных	Описание	Обязательное
Принимаемые параметры
dateOperDay	Date	Определяет дату, за которую из операционного дня следует выбрать чеки	Да
shopNumber	Long	Определяет номер магазина, чеки которого из операционного дня следует получить	Нет
cashNumber	Long	Определяет номер кассы, чеки которой из операционного дня следует получить	Нет
shiftNumber	Long	Определяет номер смены, чеки которой из операционного дня следует получить	Нет
purchaseNumber	Long	Определяет номер чека, который из опердня операционного дня получить	Нет
Возвращаемые параметры
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
URL	http://IP-адрес_сервера:8090/SET-ERPIntegration/FiscalInfoExport
WSDL	http://IP-адрес_сервера:8090/SET-ERPIntegration/FiscalInfoExport?wsdl

Индекс	Тип данных	Описание	Обязательное
Принимаемые параметры
0	Date	Дата, за которую из операционного дня требуется получить новые чеки	Да
1	Long	Номер магазина, от которого из операционного дня следует выбрать новые чеки	Нет
2	Long	Номер кассы, от которой из операционного дня следует выбрать новые чеки	Нет
3	Long	Номер смены, от которой из операционного дня следует выбрать новые чеки	Нет
4	Long	Номер чека, от которой из операционного дня следует выбрать новые чеки	Нет
Возвращаемые параметры
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

https://crystals.atlassian.net/browse/SRTE-3008

https://crystals.atlassian.net/browse/SRTE-2991

10.2.92.0

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

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

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

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

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

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

По заданным параметрам
Метод	getNonFiscalDocsByParams
URL	http://IP-адрес_сервера:8090/SET-ERPIntegration/FiscalInfoExport
WSDL	http://IP-адрес_сервера:8090/SET-ERPIntegration/FiscalInfoExport?wsdl

Поле	Тип данных	Описание	Обязательное

Поле	Тип данных	Описание	Обязательное
Принимаемые параметры
dateOperDay	date	Операционный день в формате YYYY-MM-DD	Да
shopNumber	integer	Номер магазина	Нет
cashNumber	integer	Номер кассы	Нет
shiftNumber	integer	Номер смены	Нет
purchaseNumber	integer	Номер нефискального документа	Нет
type	string	Тип нефискального документа. Поле может быть пустым, но обязательно должно присутствовать в структуре запроса	Да
status	string	Статус документа. Возможные значения: new – новые, не отправленные документы (помечает документ как отправленный) all – все/любые (не меняет статус документа)	Да
Возвращаемые параметры
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:getNonFiscalDocsByParams>
         <dateOperDay>2022-05-30</dateOperDay>
         <!--Optional:-->
         <shopNumber>1</shopNumber>
         <!--Optional:-->
         <cashNumber>1</cashNumber>
         <!--Optional:-->
         <shiftNumber>2</shiftNumber>
         <!--Optional:-->
         <purchaseNumber>1</purchaseNumber>
         <type>?</type>
         <status>all</status>
      </plug:getNonFiscalDocsByParams>
   </soapenv:Body>
</soapenv:Envelope>

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

https://crystals.atlassian.net/browse/SRTS-970

https://crystals.atlassian.net/browse/CR-8315

10.3.15.0

За заданный операционный день
Метод	getCancelledPurchasesByOperDay
URL	http://IP-адрес_сервера:8090/SET-ERPIntegration/FiscalInfoExport
WSDL	http://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:getCancelledPurchasesByOperDay>
         <dateOperDay>2022-08-22</dateOperDay>
      </plug:getCancelledPurchasesByOperDay>
   </soapenv:Body>
</soapenv:Envelope>

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

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

По заданным параметрам
Метод	getCancelledPurchasesByParams
URL	http://IP-адрес_сервера:8090/SET-ERPIntegration/FiscalInfoExport
WSDL	http://IP-адрес_сервера:8090/SET-ERPIntegration/FiscalInfoExport?wsdl

Поле	Тип данных	Описание	Обязательное

Поле	Тип данных	Описание	Обязательное
Принимаемые параметры
dateOperDay	date	Операционный день в формате YYYY-MM-DD	Да
shopNumber	integer	Номер магазина	Нет
cashNumber	integer	Номер кассы	Нет
shiftNumber	integer	Номер смены	Нет
cashierTabNo	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:getCancelledPurchasesByParams>
         <dateOperDay>2022-08-22</dateOperDay>
         <shopNumber>3245</shopNumber>
         <cashNumber>62</cashNumber>
         <shiftNumber>1</shiftNumber>
         <cashierTabNo>111</cashierTabNo>
      </plug:getCancelledPurchasesByParams>
   </soapenv:Body>
</soapenv:Envelope>

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

По периоду и категориям карт лояльности

По периоду и категориям карт лояльности
Метод	getPurchasesByPeriodAndCardTypes
URL	http://IP-адрес_сервера:8090/SET-ERPIntegration/FiscalInfoExport
WSDL	http://IP-адрес_сервера:8090/SET-ERPIntegration/FiscalInfoExport?wsdl
https://crystals.atlassian.net/browse/CR-12834 https://crystals.atlassian.net/browse/SRTS-3459 10.4.13.0

Для осуществления фильтрации чеков по параметру cardTypeGuids и для получения в выходном объекте чека информации о примененной в чеке лояльности необходимо изменение версии схемы xsd в настройке таблице sales_management_properties: export.file.purchases.version = “2.0”.

UPDATE public.sales_management_properties
SET property_value='2.0' 
WHERE property_key = 'export.file.purchases.version';

Пример запроса в файле

Поле	Тип данных	Описание	Обязательное

Поле	Тип данных	Описание	Обязательное
Принимаемые параметры
fromDate	date	Начало диапазона в формате YYYY-MM-DD	Нет
toDate	date	Конец диапазона в формате YYYY-MM-DD	Нет
cardTypeGuids	array	Список кодов категорий карт. Фильтрация чеков происходит по значению атрибута `card_type_guid` в XML экспорта чеков)	Да
Возвращаемые параметры
return	base64Binary	Чеки за период, в которых была применена карта лояльности с указанным в фильтре типом Описание формата выгрузки чеков

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

За заданный операционный день
Метод	getZReportsByOperDay
URL	http://IP-адрес_сервера:8090/SET-ERPIntegration/FiscalInfoExport
WSDL	http://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
URL	http://IP-адрес_сервера:8090/SET-ERPIntegration/FiscalInfoExport
WSDL	http://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
URL	http://IP-адрес_сервера:8090/SET-ERPIntegration/FiscalInfoExport
WSDL	http://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
URL	http://IP-адрес_сервера:8090/SET-ERPIntegration/FiscalInfoExport
WSDL	http://IP-адрес_сервера:8090/SET-ERPIntegration/FiscalInfoExport?wsdl

Поле	Тип данных	Описание	Обязательное
Принимаемые параметры
dateOperDay	date	Операционный день YYYY-MM-DD	Да
shopNumber	integer	Номер магазина	Нет
cashNumber	integer	Номер кассы	Нет
shiftNumber	integer	Номер смены	Нет
Возвращаемые параметры
return	base64Binary	Z-отчеты по заданным параметрам

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

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

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

Кейсы

dateOperDay - в отчёт попадают все смены всех магазинов за операционный день dateOperDay.
dateOperDay, shopNumber - в отчёт попадают все смены за операционный день dateOperDay с магазина shopNumber.
dateOperDay, shopNumber, cashNumber - в отчёт попадают все смены за операционный день dateOperDay с магазина shopNumber с кассы cashNumber.
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
URL	http://IP-адрес_сервера:8090/SET-ERPIntegration/FiscalInfoExport
WSDL	http://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
URL	http://IP-адрес_сервера:8090/SET-ERPIntegration/FiscalInfoExport
WSDL	http://IP-адрес_сервера:8090/SET-ERPIntegration/FiscalInfoExport?wsdl
Комментарий	Выгружаются все новые Z-отчеты за указанный операционный день, либо удовлетворяющие заданным параметрам, если они указаны.
10.2.66.0 https://crystals.atlassian.net/browse/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>

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

За заданный период
Метод	getLoyResultsByPeriod
URL	http://IP-адрес_сервера:8090/SET-ERPIntegration/FiscalInfoExport
WSDL	http://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
URL	http://IP-адрес_сервера:8090/SET-ERPIntegration/FiscalInfoExport
WSDL	http://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
URL	http://IP-адрес_сервера:8090/SET-ERPIntegration/FiscalInfoExport
WSDL	http://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
URL	http://IP-адрес_сервера:8090/SET-ERPIntegration/FiscalInfoExport
WSDL	http://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
URL	http://IP-адрес_сервера:8090/SET-ERPIntegration/FiscalInfoExport
WSDL	http://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
URL	http://IP-адрес_сервера:8090/SET-ERPIntegration/FiscalInfoExport
WSDL	http://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
URL	http://IP-адрес_сервера:8090/SET-ERPIntegration/FiscalInfoExport
WSDL	http://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 выгрузка таких данных не предусмотрена.

Причина отсутствия формирования данных на серверах SetRetail в отчет getSalesReportOperDay не попадают данные по открытому операционному дню:

При закрытии операционного дня и при включенной настройке need.send.salesReport.toERPI в базу данных сервера set_operday таблицу od_salesreports_dates попадает дата закрытого дня.
После этого по таймауту данные попадают в таблицу базу данных set таблицу ERPI_SalesReports.

За заданный операционный день
Метод	getSalesReportOperDay
URL	http://IP-адрес_сервера:8090/SET-ERPIntegration/FiscalInfoExport
WSDL	http://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
URL	http://IP-адрес_сервера:8090/SET-ERPIntegration/FiscalInfoExport
WSDL	http://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
URL	http://IP-адрес_сервера:8090/SET-ERPIntegration/SalesReportWithSeparatedTaxWS
WSDL	http://IP-адрес_сервера:8090/SET-ERPIntegration/SalesReportWithSeparatedTaxWS?wsdl
10.2.42.0 https://crystals.atlassian.net/browse/SRTE-1220

Поле	Тип данных	Описание	Обязательное
Принимаемые параметры
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

https://crystals.atlassian.net/browse/SRTE-736

За заданный операционный день
Метод	getCashierWorkTime
URL	http://IP-адрес_сервера:8090/SET-OperDay/ExporterWS
WSDL	http://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>

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

Описание

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

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

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

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

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

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

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

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

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

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

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

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

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

Кейсы

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

По периоду и категориям карт лояльности

По периоду и категориям карт лояльности

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

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

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

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

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

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

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

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

Кейсы

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

За период

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

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

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

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

За период

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

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

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

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

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

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

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

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

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

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