Публичный ресурс
Веб-сервисы экспорта (на стороне SetRetail10)
Описание
Данный вариант экспорта предполагает обмен данными на основе 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 Параметр | string | Месяц в текстовом формате:
| Да |
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>
-
Экспорт информации по отложенным чекам (включение) | |
| Выгрузка для веб сервиса на стороне 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 | Массив параметров по следующему формату:
| Да |
Возвращаемые параметры | |||
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 | Статус документа. Возможные значения:
| Да |
| Возвращаемые параметры | |||
| 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>
Метод веб-сервиса для экспорта чеков по периоду и категориям карт лояльности
По периоду и категориям карт лояльности | |
|---|---|
Метод | getPurchasesByPeriodAndCardTypes |
| URL | http://IP-адрес_сервера:8090/SET-ERPIntegration/FiscalInfoExport |
| WSDL | http://IP-адрес_сервера:8090/SET-ERPIntegration/FiscalInfoExport?wsdl |
CR-12834 - Получение подробных данных проблемы… СТАТУС 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 | Список кодов категорий карт. Фильтрация чеков происходит по значению атрибута | Да |
| Возвращаемые параметры | |||
| 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 Параметр | string | Месяц в текстовом формате:
| Да |
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 | Массив параметров по следующему формату:
| Да |
Возвращаемые параметры | |||
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 выгрузка таких данных не предусмотрена.
Причина отсутствия формирования данных на серверах 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 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 | Информация по подарочной карте | |
| activationDate | DateTime | Дата активации карты | |
| amount | Long | Сумма подарочной карты | |
| balance | Long | Остаток суммы подарочной карты | |
| cardNumber | String | Номер подарочной карты | |
| expirationDate | DateTime | Дата окончания действия. Параметр не возвращается, если карта бессрочная | |
| maxAmount | Long | Максимальная сумма произвольного номинала | |
| multiplicity | Long | Кратность для суммы произвольного номинала | |
| pinCode | String | Пин-код | |
| status | CardStatus | Статус подарочной карты: В этом методе может быть статус карты Active, но, при этом у карты может быть просрочена дата окончания действия. Проверяйте дату окончания отдельно.
| |
<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 |
Поле | Тип данных | Описание | Обязательное |
Принимаемые параметры | |||
msrNumber | String | Номер карты с магнитной дорожки | Да |
Возвращаемые параметры | |||
return | XML | Информация по подарочной карте | |
| activationDate | DateTime | Дата активации карты | |
| amount | Long | Сумма подарочной карты | |
| balance | Long | Остаток суммы подарочной карты | |
| cardNumber | String | Номер подарочной карты | |
| expirationDate | DateTime | Дата окончания действия. Параметр не возвращается, если карта бессрочная | |
| maxAmount | Long | Максимальная сумма произвольного номинала | |
| multiplicity | Long | Кратность для суммы произвольного номинала | |
| pinCode | String | Пин-код | |
| status | CardStatus | Статус подарочной карты: В этом методе может быть статус карты Active, но, при этом у карты может быть просрочена дата окончания действия. Проверяйте дату окончания отдельно.
| |
<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 | Статус подарочной карты:
| Нет |
Возвращаемые параметры | |||
result | base64Binary | Информация по подарочным картам в формате XML, закодированного в Base64. | |
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.processing.cards.crystals.ru/">
<soapenv:Header/>
<soapenv:Body>
<ser:getPresentCardsInfoByFilter>
<filter>
<startDateFrom>2025-10-10</startDateFrom>
<startDateTo>2025-10-18</startDateTo>
<status>Blocked</status>
</filter>
</ser:getPresentCardsInfoByFilter>
</soapenv:Body>
</soapenv:Envelope>
Результатом метода является закодированный XML-документ, содержащий массив карт. Все карты соответствуют заданному в запросе фильтру.
Если какой-либо элемент не заполнен, то в теге присутствуют атрибуты: xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:nil="true"
<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <presentCards xmlns="http://crystals.ru/cards/presentcards/report"> <presentCard> <cardNumber>50005121001</cardNumber> <amount>500000</amount> <balance>500000</balance> <status>Blocked</status> <startDate>2025-10-17T18:43:07.348+03:00</startDate> <endDate>2026-10-17T23:59:59.999+03:00</endDate> <replacedCardNumber/> <actions> <action type="Create" date="2025-10-17T18:43:07.348+03:00" login="manager" source="SERVER"/> <action type="Blocked" date="2025-10-17T18:43:07.349+03:00" login="manager" source="SERVER"/> </actions> <blockingCause>Данная карта была заблокирована по причине утраты ее владельцем</blockingCause> <prolongationCause xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:nil="true"/> </presentCard> <presentCard> <cardNumber>50005121002</cardNumber> <amount>500000</amount> <balance>500000</balance> <status>Blocked</status> <startDate>2025-10-17T18:43:07.354+03:00</startDate> <endDate>2026-10-17T23:59:59.999+03:00</endDate> <replacedCardNumber/> <actions> <action type="Create" date="2025-10-17T18:43:07.355+03:00" login="manager" source="SERVER"/> <action type="Blocked" date="2025-10-17T18:43:07.355+03:00" login="manager" source="SERVER"/> </actions> <blockingCause>Данная карта была заблокирована по причине утраты ее владельцем</blockingCause> <prolongationCause xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:nil="true"/> </presentCard> </presentCards>
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 | Тип события:
| Нет |
| Возвращаемые параметры | |||
| 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 |
© 1995-2025, ООО "Кристалл Сервис Интеграция".
Все права защищены.





