Описание

Данный вариант экспорта предполагает обмен данными на основе 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. После выполнения скриптов включения, перезапустите службу сервера. CR-5382 - Получение подробных данных проблемы… СТАТУС 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';

Отложенные чеки за операционный день CR-5382 - Получение подробных данных проблемы… СТАТУС 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>

-

Отложенные чеки по заданным параметрам CR-5382 - Получение подробных данных проблемы… СТАТУС 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

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

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

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

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

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>

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

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

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>

Методы веб-сервиса для экспорта 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 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 выгрузка таких данных не предусмотрена.

За заданный операционный день
Метод	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 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

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>

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

10.2.59.0

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

По номеру подарочной карты
Метод	getPresentCardInformation
URL	http://IP-адрес_сервера:8090/SET-Cards-PresentCards/SET/Cards/PresentCards/ProcessingManager
WSDL	http://IP-адрес_сервера:8090/SET-Cards-PresentCards/SET/Cards/PresentCards/ProcessingManager?wsdl

Поле	Тип данных	Описание	Обязательное
Принимаемые параметры
cardNumber	String	Номер карты	Да
Возвращаемые параметры
return	xml	Информация по подарочное карте
amount	Long	Сумма подарочной карты
balance	Long	Остаток суммы подарочной карты
cardNumber	String	Номер подарочной карты
expirationDate	dateTime	Дата окончания действия
status	cardStatus	Статус подарочной карты: В этом методе может быть статус карты 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>7810001</cardNumber>
      </ser:getPresentCardInformation>
   </soapenv:Body>
</soapenv:Envelope>

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

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
   <soap:Body>
      <ns2:getPresentCardInformationResponse xmlns:ns2="http://services.processing.cards.crystals.ru/">
         <return>
            <activationDate>2023-11-30T12:42:52.064+03:00</activationDate>
            <amount>400000</amount>
            <balance>400000</balance>
            <cardNumber>7810001</cardNumber>
            <maxAmount>500000</maxAmount>
            <multiplicity>100</multiplicity>
            <status>Active</status>
         </return>
      </ns2:getPresentCardInformationResponse>
   </soap:Body>
</soap:Envelope>

По номеру магнитной полосы MSR подарочной карты
Метод	getPresentCardInformationByMSRNumber
URL	http://IP-адрес_сервера:8090/SET-Cards-PresentCards/SET/Cards/PresentCards/ProcessingManager
WSDL	http://IP-адрес_сервера:8090/SET-Cards-PresentCards/SET/Cards/PresentCards/ProcessingManager?wsdl

Поле	Тип данных	Описание	Обязательное
Принимаемые параметры
cardNumber	String	Номер карты	Да
Возвращаемые параметры
return	xml	Информация по подарочное карте
amount	Long	Сумма подарочной карты
balance	Long	Остаток суммы подарочной карты
cardNumber	String	Номер подарочной карты
expirationDate	dateTime	Дата окончания действия
status	cardStatus	Статус подарочной карты: В этом методе может быть статус карты 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>7810001</msrNumber>
      </ser:getPresentCardInformationByMSRNumber>
   </soapenv:Body>
</soapenv:Envelope>

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

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
   <soap:Body>
      <ns2:getPresentCardInformationByMSRNumberResponse xmlns:ns2="http://services.processing.cards.crystals.ru/">
         <return>
            <activationDate>2023-11-30T12:42:52.064+03:00</activationDate>
            <amount>400000</amount>
            <balance>400000</balance>
            <cardNumber>7810001</cardNumber>
            <maxAmount>500000</maxAmount>
            <multiplicity>100</multiplicity>
            <status>Active</status>
         </return>
      </ns2:getPresentCardInformationByMSRNumberResponse>
   </soap:Body>
</soap:Envelope>

По фильтрам
Метод	getPresentCardsInfoByFilter
URL	http://IP-адрес_сервера:8090/SET-Cards-PresentCards/SET/Cards/PresentCards/ProcessingManager
WSDL	http://IP-адрес_сервера:8090/SET-Cards-PresentCards/SET/Cards/PresentCards/ProcessingManager?wsdl

Поле	Тип данных	Описание	Обязательное
Принимаемые параметры
cardNumber	String	Номер карты	Нет
endDateFrom	dateTime	Дата окончания действия карты [от] в формате YYYY-MM-DD	Нет
endDateTo	dateTime	Дата окончания действия карты [до] в формате YYYY-MM-DD	Нет
operationDateFrom	dateTime	Дата операций по подарочной карте [от] в формате YYYY-MM-DD	Нет
operationDateTo	dateTime	Дата операций по подарочной карте [до] в формате YYYY-MM-DD	Нет
paymentDate	dateTime	Дата оплаты подарочной картой в формате YYYY-MM-DD	Нет
saleDate	dateTime	Дата продажи подарочной картой в формате YYYY-MM-DD	Нет
startDateFrom	dateTime	Дата начала действия карты [от] в формате YYYY-MM-DD	Нет
startDateTo	dateTime	Дата начала действия карты [до] в формате YYYY-MM-DD	Нет
status	cardStatus	Статус подарочной карты: Create Active Blocked Inactive Used PreActive PreUsed PreDeactive NeedReturn NeedTakeAway	Нет
Возвращаемые параметры
return	xml	Информация по подарочное карте
amount	Long	Сумма подарочной карты
balance	Long	Остаток суммы подарочной карты
cardNumber	String	Номер подарочной карты
expirationDate	dateTime	Дата окончания действия
status	cardStatus	Статус подарочной карты: В этом методе может быть статус карты 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:getPresentCardsInfoByFilter>
         <!--Optional:-->
         <filter>
            <!--Optional:-->
            <cardNumber>7810001</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>

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

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
   <soap:Body>
      <ns2:getPresentCardInformationByMSRNumberResponse xmlns:ns2="http://services.processing.cards.crystals.ru/">
         <return>
            <activationDate>2023-11-30T12:42:52.064+03:00</activationDate>
            <amount>400000</amount>
            <balance>400000</balance>
            <cardNumber>7810001</cardNumber>
            <maxAmount>500000</maxAmount>
            <multiplicity>100</multiplicity>
            <status>Active</status>
         </return>
      </ns2:getPresentCardInformationByMSRNumberResponse>
   </soap:Body>
</soap:Envelope>

Методы веб-сервиса для экспорта отчета по проданным товарам
- За заданный операционный день
- Примеры запросов

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

10.2.78.0

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

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

Поле				Тип данных	Описание	Обязательное
Принимаемые параметры
dateOperDay				Date	Дата операционного дня в формате YYYY-MM-DD Может быть передана только одна дата.	Да
shopNumber				String	Номер магазина Может быть передано несколько номеров магазинов.	Нет
goodsCode				String	Код (артикул товара) Может быть передано несколько кодов товаров	Нет
Возвращаемые параметры
return				xml	Информация о проданных товарах
	sales			xml	Продажи
		shop		Integer	Магазин
		operationDay		Long	Остаток суммы подарочной карты
		positions		xml	Позиции
			markingOfTheGood	String	Код (артикул товара)
			name	String	Наименование товара
			count	Integer	Количество

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

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

В ответе выводятся данные о продажах всех товаров по всем магазинам, подключённых к опрашиваемому 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
URL	http://IP-адрес_сервера:8090/SET-ERPIntegration/StornoExportServiceBean
WSDL	http://IP-адрес_сервера:8090/SET-ERPIntegration/StornoExportServiceBean?wsdl

Поле	Тип данных	Описание	Обязательное
Принимаемые параметры
cash	Long	Номер кассы	Нет
marking	String	Код/Артикул товара	Нет
operday	DateTime	Дата операционного дня в формате YYYY-MM-DD	Нет
shift	long	Номер смены	Нет
shop	long	Номер магазина	Нет
tabNo	string	Табельный номер кассира	Нет
type	string	Тип события: STORNO (Сторно) - уменьшение количество позиций товара кассиром в чеке до “0”; CHANGE (Изменения) - уменьшение количества позиций товара кассиром (не до значения “0”); CANCEL (Отмена) - удаление позиции из подвала чека (товар не добавляется к чеку; применимо только для POS).	Нет
Возвращаемые параметры
return	base64Binary	Отчеты по сторно	Да

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

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

<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_key	property_value	description
storno.clean.time	06:35:00	Время старта чистильщика истории изменений или отмен (Storno) позиций чеков в течении дня
storno.clean.day.limit	999999999999	Ограничение глубины очистки истории изменений или отмен (Storno) позиций чеков в днях
export.set10wsclient.storno.polling.interval.sec	30	Период выгрузки событий изменения количества товара в чеках (aka сторнирования) в веб-сервис на стороне ERP, в секундах
export.set10wsclient.storno.version	1.0	Версия плагина выгрузки событий изменения количества товара в чеках (aka сторнирования) в веб-сервис на стороне ERP
export.set10wsclient.storno.short.interval	5	Период перевыгрузки событий изменения количества товара в чеках (aka сторнирования) в веб-сервис на стороне ERP (если данных больше, чем размер пачки), в секундах
export.set10wsclient.storno.polling.wsdl		URL для выгрузки событий изменения количества товара в чеках (aka сторнирования) в веб-сервис на стороне ERP
export.set10wsclient.storno.catalog.size.records	100	Размер пачки для выгрузки событий изменения количества товара в чеках (aka сторнирования) в веб-сервис на стороне ERP
export.set10wsclient.storno.auth.username		Имя пользователя для авторизации в веб-сервисе выгрузки событий изменения количества товара в чеках (aka сторнирования) на стороне ERP
export.set10wsclient.storno.auth.password		Пароль для авторизации в веб-сервисе выгрузки событий изменения количества товара в чеках (aka сторнирования) на стороне ERP
export.set10wsclient.storno.export.style	SAP	Способ выгрузки событий изменения количества товара в чеках (aka сторнирования) в веб-сервис на стороне ERP. (C1/SAP - с ответом/без ответа)
export.set10wsclient.storno.save.catalog.to.temp.dir	false	Сохранять ли выгруженные события изменения количества товара в чеках (aka сторнирования) в папку export.set10wsclient.storno.tmp.catalog.path
export.set10wsclient.storno.request.timeout	60	таймаут завершения обработки запроса для выгрузки событий изменения количества товара в чеках (aka сторнирования) во внешнюю систему, в секундах
export.set10wsclient.storno.tmp.catalog.path	c:\\reports\\export\\set10wsclient\\storno	Папка для сохранения выгруженных событий изменения количества товара в чеках (aka сторнирования).
export.file.storno.filename.prefix	storno	Префикс файлов для выгрузки отчетов по событиям изменения количества товара в чеках (aka сторнирования)
export.file.storno.filename.separator	-	Разделитель в имени файлов выгрузки событий изменения количества товара в чеках (aka сторнирования)
export.file.storno.filename.extension	xml	Расширение файлов выгрузки событий изменения количества товара в чеках (aka сторнирования)
export.file.storno.polling.interval.sec	60	Интервал выгрузки событий изменения количества товара в чеках (aka сторнирования), сек
export.file.storno.short.interval.sec	2	Короткий интервал для выгрузки событий изменения количества товара в чеках (aka сторнирования), сек
export.file.storno.catalog.size.records	100	Размер порции для выгрузки событий изменения количества товара в чеках (aka сторнирования)
export.file.storno.version	1.0	Версия выгрузки событий изменения количества товара в чеках (aka сторнирования)
storno.export.document.schema.version	1.0	Версия документа выгрузки отчетов по событиям изменения количества товара в чеках (aka сторнирования) через ws-service
export.file.storno.enabled	true	Флаг-признак: разрешена ли выгрузка событий изменения количества товара в чеках (aka сторнирования) в файл
export.set10wsclient.storno.enabled	true	Флаг-признак: разрешена ли выгрузка событий изменения количества товара в чеках (aka сторнирования) в веб-сервис на стороне ERP

Описание

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

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

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

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

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

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

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

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

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

Кейсы

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Кейсы

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

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

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

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

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

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

За период

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

За период

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

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

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

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

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

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

По фильтрам

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

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

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

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

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

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

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

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

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