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

Публичный ресурс

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

Описание

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

Внимание

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

К оглавлению

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

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

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

Поле

Тип данных

Описание

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

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

dateOperDay

date

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

Да

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

return

base64Binary

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

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

Для полного просмотра бонусов и скидок используйте метод 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
URLhttp://IP-адрес_сервера:8090/SET-ERPIntegration/FiscalInfoExport
WSDLhttp://IP-адрес_сервера:8090/SET-ERPIntegration/FiscalInfoExport?wsdl

Поле

Тип данных

Описание

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

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

Year

integer

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

Нет

Mobth 

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

string

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

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

Day

integer

День

Нет

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

return

base64Binary

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

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

Для полного просмотра бонусов и скидок используйте метод 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
URLhttp://IP-адрес_сервера:8090/SET-ERPIntegration/FiscalInfoExport
WSDLhttp://IP-адрес_сервера:8090/SET-ERPIntegration/FiscalInfoExport?wsdl

Поле

Тип данных

Описание

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

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

fromDate

date

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

Нет

toDate

date

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

Нет

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

return

base64Binary

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

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

Для полного просмотра бонусов и скидок используйте метод 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
URLhttp://IP-адрес_сервера:8090/SET-ERPIntegration/FiscalInfoExport
WSDLhttp://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
URLhttp://IP-адрес_сервера:8090/SET-ERPIntegration/FiscalInfoExport
WSDLhttp://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
URLhttp://IP-адрес_сервера:8090/SET-ERPIntegration/FiscalInfoExport
WSDLhttp://IP-адрес_сервера:8090/SET-ERPIntegration/FiscalInfoExport?wsdl

Поле

Тип данных

Описание

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

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

dateOperDay

dateTime

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

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

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

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

Поле

Тип данных

Описание

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

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

dateOperDay

date

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

Да

shopNumber

integer

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

Нет

cashNumber

integer

Номер кассы

Нет

shiftNumber

integer

Номер смены

Нет

purchaseNumber

integer

Номер чека

Нет

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

return

base64Binary

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

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

Для полного просмотра бонусов и скидок используйте метод 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 – являются необязательными.

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

Кейсы

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

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

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

10.2.80.0

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

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

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

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

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

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

-

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

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

10.2.66.0

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

Поле

Тип данных

Описание

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

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

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>

--

Экспорт нов