Публичный ресурс
Веб-сервисы экспорта (на стороне 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'; |
Поле | Тип данных | Описание | Обязательное |
Принимаемые параметры | |||
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>
-
Поле | Тип данных | Описание | Обязательное |
Принимаемые параметры | |||
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 |
Поле | Тип данных | Описание | Обязательное |
Принимаемые параметры | |||
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>
--
Экспорт нов |