Сравнение версий

Ключ

  • Эта строка добавлена.
  • Эта строка удалена.
  • Изменено форматирование.

К оглавлению

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

...

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

...

Поле

...

Тип данных

...

Описание

...

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

...

dateOperDay

...

date

...

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

...

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

...

return

...

base64Binary

...

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

...

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

Для полного просмотра бонусов и скидок используйте метод getFullPurchasesByParams.

Блок кода
languagexml
titleПример запроса
<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 вводом параметров

...

Поле

...

Тип данных

...

Описание

...

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

...

Year

...

integer

...

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

...

Mobth 

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

...

string

...

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

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

...

Day

...

integer

...

День

...

К оглавлению

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

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

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


Поле

Тип данных

Описание

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

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

dateOperDay

date

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

Да

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

return

base64Binary

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

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

Для полного просмотра бонусов и скидок используйте метод getFullPurchasesByParams.


Блок кода
languagexml
titleПример запроса
<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 

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

string

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

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

Day

integer

День

Нет

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

return

base64Binary

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

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

Для полного просмотра бонусов и скидок используйте метод getFullPurchasesByParams.

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

Блок кода
languagexml
titleПример запроса
<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.

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

Блок кода
languagexml
titleПример запроса
<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.

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

Блок кода
languagexmltitleПример запроса
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:plug="http://plugins.operday.ERPIntegration.crystals.ru/">
   <soapenv:Header/>
   <soapenv:Body>
      <plug:getPurchasesByOperDayData>:getPurchasesByPeriodAndProduct>
         <!--Optional:-->
         <Year>2019</Year><fromDate>2019-05-01</fromDate>
         <!--Optional:-->
         <Mobth>MAY</Mobth><toDate>2019-05-31</toDate>
         <!--Optional:-->
         <Day>27<<goodsCode>45033</Day>goodsCode>
      </plug:getPurchasesByOperDayData>getPurchasesByPeriodAndProduct>
   </soapenv:Body>
</soapenv:Envelope>
Информация

Методы getPurchasesByOperDay и getPurchasesByOperDayData отличаются только способом передачи параметров.

-

...

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

...

Поле

...

Тип данных

...

Описание

...

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

...

fromDate

...

date

...

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

...

toDate

...

date

...

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

...

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

...

return

...

base64Binary

...

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

...

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

Для полного просмотра бонусов и скидок используйте метод getFullPurchasesByParams.

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

Блок кода
languagexml
titleПример запроса
<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>

-

...

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

...

-

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

Для включения выполняются скрипты по базе данных Image Addedset сервера SetRetail10/SetCentrum.

После выполнения скриптов включения, перезапустите службу сервера.

Устаревшая версия Jira
serverSystem JIRA
columnskey,summary,type,created,updated,due,assignee,reporter,priority,status,resolution
serverIdbc8d3685-f9c0-329d-9054-b12aabbcb834
keyCR-5382

Устаревшая версия Jira
serverSystem JIRA
columnskey,summary,type,created,updated,due,assignee,reporter,priority,status,resolution
serverIdbc8d3685-f9c0-329d-9054-b12aabbcb834
keySRTE-3562

Статус
colourBlue
title10.2.99.0

Выгрузка для веб сервиса на стороне ERP и SetRetail10


Блок кода
languagesql
UPDATE public.sales_management_properties
   SET property_value='1.18'       
 WHERE property_key = 'export.set10wsclient.purchases.version';


Блок кода
languagesql
UPDATE public.sales_management_properties
   SET property_value='true'       
 WHERE property_key = 'export.set10wsclient.purchases.deferred.enabled';


Файловый экспорт


Блок кода
languagesql
UPDATE public.sales_management_properties
   SET property_value='1.9'       
 WHERE property_key = 'export.file.purchases.version';


Блок кода
languagesql
UPDATE public.sales_management_properties
   SET property_value='true'       
 WHERE property_key = 'export.file.purchases.deferred.enabled';



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

Устаревшая версия Jira
serverSystem JIRA
columnskey,summary,type,created,updated,due,assignee,reporter,priority,status,resolution
serverIdbc8d3685-f9c0-329d-9054-b12aabbcb834
keyCR-5382

Устаревшая версия Jira
serverSystem JIRA
columnskey,summary,type,created,updated,due,assignee,reporter,priority,status,resolution
serverIdbc8d3685-f9c0-329d-9054-b12aabbcb834
keySRTE-3562

Статус
colourBlue
title10.2.99.0

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

...

Поле

Тип данных

Описание

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

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

fromDatedateOperDay

date

Начало диапазона

Нет

toDate

date

Конец диапазона

Нет

goodsCode

string

Код товара

dateTime

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

Нет

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

return

base64Binary

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

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

Для полного просмотра бонусов и скидок используйте метод getFullPurchasesByParams.

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

Блок кода
languagexml
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:plug="http://plugins.operday.ERPIntegration.crystals.ru/">
   <soapenv:Header/>
   <soapenv:Body>
      <plug:getPurchasesByPeriodAndProduct>getReportDeferredByOperDay>
         <!--Optional:-->
         <fromDate>2019-05-01</fromDate>
         <!--Optional:-->
         <toDate>2019-05-31</toDate>
         <!--Optional:-->
         <goodsCode>45033</goodsCode>
      </plug:getPurchasesByPeriodAndProduct>
   </soapenv:Body>
</soapenv:Envelope>

-

...

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

...

Для включения выполнются скрипты базе данных Image Removedset сервера SetRetail10/SetCentrum.

После выполнения скриптов включения, перезапутсите службу сервера.

Устаревшая версия Jira
serverSystem JIRA
columnskey,summary,type,created,updated,due,assignee,reporter,priority,status,resolution
serverIdbc8d3685-f9c0-329d-9054-b12aabbcb834
keyCR-5382

Устаревшая версия Jira
serverSystem JIRA
columnskey,summary,type,created,updated,due,assignee,reporter,priority,status,resolution
serverIdbc8d3685-f9c0-329d-9054-b12aabbcb834
keySRTE-3562

Статус
colourBlue
title10.2.99.0

...

languagesql

...


         <dateOperDay>2021-07-07</dateOperDay>
      </plug:getReportDeferredByOperDay>
   </soapenv:Body>
</soapenv:Envelope>

-

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

Устаревшая версия Jira
serverSystem JIRA
columnskey,summary,type,created,updated,due,assignee,reporter,priority,status,resolution
serverIdbc8d3685-f9c0-329d-9054-b12aabbcb834
keyCR-5382

Устаревшая версия Jira
serverSystem JIRA
columnskey,summary,type,created,updated,due,assignee,reporter,priority,status,resolution
serverIdbc8d3685-f9c0-329d-9054-b12aabbcb834
keySRTE-3562

Статус
colourBlue
title10.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.

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

Блок кода
languagexml
<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>
         

...

languagesql

...

<!--Optional:-->
         <cashNumber>3</cashNumber>
    

...

 

...

    <!--Optional:-->
    

...

 

...

 

...

 

...

languagesql

...

 

...

 <shiftNumber>9</shiftNumber>
  

...

 

...

      <!--Optional:-->
  

...

 

...

 

...

 

...

languagesql

...

 

...

   <cashierTabNo>231</cashierTabNo>
  

...

 

...

   </plug:getReportDeferredByParams>
   

...

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

Устаревшая версия Jira
serverSystem JIRA
columnskey,summary,type,created,updated,due,assignee,reporter,priority,status,resolution
serverIdbc8d3685-f9c0-329d-9054-b12aabbcb834
keyCR-5382

Устаревшая версия Jira
serverSystem JIRA
columnskey,summary,type,created,updated,due,assignee,reporter,priority,status,resolution
serverIdbc8d3685-f9c0-329d-9054-b12aabbcb834
keySRTE-3562

Статус
colourBlue
title10.2.99.0

...

Поле

...

Тип данных

...

Описание

...

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

...

dateOperDay

...

dateTime

...

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

...

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

...

return

...

base64Binary

...

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

...

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

Для полного просмотра бонусов и скидок используйте метод getFullPurchasesByParams.

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

Блок кода
languagexml
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:plug="http://plugins.operday.ERPIntegration.crystals.ru/">
   <soapenv:Header/>
   <soapenv:Body>
      <plug:getReportDeferredByOperDay></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.

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

Блок кода
languagexml
titleПример запроса
<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:-->
         <dateOperDay>2021-07-07</dateOperDay><purchaseNumber>7</purchaseNumber>
      </plug:getReportDeferredByOperDay>getPurchasesByParams>
   </soapenv:Body>
</soapenv:Envelope>

-

...

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

Устаревшая версия Jira
serverSystem JIRA
columnskey,summary,type,created,updated,due,assignee,reporter,priority,status,resolution
serverIdbc8d3685-f9c0-329d-9054-b12aabbcb834
keyCR-5382

Устаревшая версия Jira
serverSystem JIRA
columnskey,summary,type,created,updated,due,assignee,reporter,priority,status,resolution
serverIdbc8d3685-f9c0-329d-9054-b12aabbcb834
keySRTE-3562

Статус
colourBlue
title10.2.99.0

...

Поле

...

Тип данных

...

Описание

...

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

...

dateOperDay

...

dateTime

...

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

...

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

...

return

...

base64Binary

...

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

...

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

Для полного просмотра бонусов и скидок используйте метод getFullPurchasesByParams.

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

Блок кода
languagexml
<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

...

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

...

Поле

...

Тип данных

...

Описание

...

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

...

dateOperDay

...

date

...

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

...

shopNumber

...

integer

...

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

...

cashNumber

...

integer

...

Номер кассы

...

shiftNumber

...

integer

...

Номер смены

...

purchaseNumber

...

integer

...

Номер чека

...

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

...

return

...

base64Binary

...

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

...

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

Для полного просмотра бонусов и скидок используйте метод getFullPurchasesByParams.

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

Блок кода
languagexml
titleПример запроса
<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>: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

Устаревшая версия Jira
serverSystem JIRA
columnskey,summary,type,created,updated,due,assignee,reporter,priority,status,resolution
serverIdbc8d3685-f9c0-329d-9054-b12aabbcb834
keySRTE-2613

Статус
colourBlue
title10.2.80.0

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

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

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

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

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

Блок кода
languagexml
<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"
         <!--Optional:-->   xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
      <shopNumber>3382</shopNumber>          <!--Optional:--xsi:nil="true"/>
    <purchaseNumber xmlns=""
   <cashNumber>1</cashNumber>          <!--Optional:-->xmlns:xs="http://www.w3.org/2001/XMLSchema"
         <shiftNumber>1</shiftNumber>          <!--Optional:-->xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         <purchaseNumber>7</purchaseNumber>      xsi:nil="true"/>
</plug:getPurchasesByParams>
   </soapenvm:getPurchasesByParams></soap:Body>
</soapenvsoap:Envelope>
Информация

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

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

Кейсы

...


-

...

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

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

Статус
colourBlue
title10.2.66.0

Устаревшая версия Jira
serverSystem JIRA
columnskey,summary,type,created,updated,due,assignee,reporter,priority,status,resolution
serverIdbc8d3685-f9c0

...

Статус
colourBlue
title10.2.80.0

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

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

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

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

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

...

languagexml

...

-329d-9054-b12aabbcb834
keySRTE-2030


Поле

Тип данных

Описание

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

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

dateOperDay

date

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

Да

shopNumber

integer

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

Нет

cashNumber

integer

Номер кассы

Нет

shiftNumber

integer

Номер смены

Нет

purchaseNumber

integer

Номер чека

Нет

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

return

base64Binary

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

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

Для полного просмотра бонусов и скидок используйте метод getFullPurchasesByParams.


Блок кода
languagexml
titleПример запроса
<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
URLhttp://IP-адрес_сервера:8090/SET-ERPIntegration/FiscalInfoExport
WSDLhttp://IP-адрес_сервера:8090/SET-ERPIntegration/FiscalInfoExport?wsdl


Информация

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

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


Поле

Тип данных

Описание

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

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

arrayOfParams

array

Массив параметров по следующему формату:

[OperDay (DateTime, REQUIRED), shop(Long), cash(Long), shift(Long), number(Long)]

Да

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

return

base64Binary

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

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

Для полного просмотра бонусов и скидок используйте метод getFullPurchasesByParams.

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

Блок кода
languagexml
titleПример запроса
<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">1</cashNumber>> 
	<soapenv:Header/> 
	<soapenv:Body> <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>

-

...

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

...


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

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

Устаревшая версия Jira
serverSystem JIRA
columnskey,summary,type,created,updated,due,assignee,reporter,priority,status,resolution
serverIdbc8d3685-f9c0-329d-9054-b12aabbcb834
keyCORE-352

Статус
colourBlue
title10.2.54.0

Примечание

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

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

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

Якорь
getfullpurchase
getfullpurchase

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

Устаревшая версия JiraserverSystem JIRAcolumnskey,summary,type,created,updated,due,assignee,reporter,priority,status,resolutionserverIdbc8d3685-f9c0-329d-9054-b12aabbcb834keySRTE-2030SET-ERPIntegration/FiscalInfoExportWSDLhttp://IP-адрес_сервера:8090/SET-ERPIntegration/FiscalInfoExport?wsdl


integerНомер магазинаintegerНомер кассыintegerНомер сменыintegerНомер чека

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

Для полного просмотра бонусов и скидок используйте метод getFullPurchasesByParams.

Поле

Тип данных

Описание

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

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

dateOperDay

date

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

Определяет дату, за которую из операционного дня следует выбрать чеки


Да
shopNumberLongОпределяет номер магазина, чеки которого из операционного дня следует получитьНет
cashNumberLongОпределяет номер кассы, чеки которой из операционного дня следует получитьНет
shiftNumberLongОпределяет номер смены, чеки которой из операционного дня следует получитьНет
purchaseNumberLongОпределяет номер чека, который из опердня операционного дня получитьНет

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

return

base64Binary

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


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

Блок кода
languagexml
titleПример запроса
<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:--><soapenv:Header/>
   <soapenv:Body>
      <shopNumber>3328</shopNumber><plug:getFullPurchasesByParams>
         <!<dateOperDay>2018--Optional:-->08-16</dateOperDay>
         <cashNumber>3<<shopNumber>6502</cashNumber>shopNumber>
         <!--Optional:--><cashNumber>1</cashNumber>
         <shiftNumber>16<<shiftNumber>1</shiftNumber>
         <!--Optional:-->
         <purchaseNumber>?<<purchaseNumber>2</purchaseNumber>
      </plug:getNewPurchasesByParams>getFullPurchasesByParams>
   </soapenv:Body>
</soapenv:Envelope>

--


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

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

МетодgetNewPurchasesByOperDaygetNewFullPurchasesByOperDay
URLhttp://IP-адрес_сервера:8090/SET-ERPIntegration/FiscalInfoExport
WSDLhttp://IP-адрес_сервера:8090/SET-ERPIntegration/FiscalInfoExport?wsdl
Информация

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

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

...

Поле

...

Тип данных

...

Описание

...

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

...

arrayOfParams

...

array

...

Массив параметров по следующему формату:

[OperDay (DateTime, REQUIRED), shop(Long), cash(Long), shift(Long), number(Long)]

...

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

...

return

...

base64Binary

...

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

...

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

Для полного просмотра бонусов и скидок используйте метод getFullPurchasesByParams.

...


Индекс

Тип данных

Описание

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

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

0

Date

Дата, за которую из операционного дня требуется получить новые чекиДа
1LongНомер магазина, от которого из операционного дня следует выбрать новые чекиНет
2LongНомер кассы, от которой из операционного дня следует выбрать новые чекиНет
3LongНомер смены, от которой из операционного дня следует выбрать новые чекиНет
4LongНомер чека, от которой из операционного дня следует выбрать новые чекиНет

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

return

base64Binary

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

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

Информация
  • Минимальный размер массива аргументов метода - 1 (потому что параметр "дата опердня" обязательный).
  • Если требуется пропустить, параметр "номер смены", тогда установите значение null, потому что за номером смены следует номер чека.
  • Если требуется номер чека, массиву допустимо быть длиной 4, потому что за параметром "номер чека" ничего не следует.


Блок кода
languagexml
titleПример запроса
<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) --> 
			<plug:getNewFullPurchasesByOperDay>
         <arrayOfParams xsi:type="xs:long">12345</arrayOfParams> 
			<!---Cash number (optional)--> 
			dateTime">2018-08-16T12:00:00.000</arrayOfParams>
                <arrayOfParams xsi:type="xs:long">1<>6502</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>

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

Устаревшая версия Jira
serverSystem JIRA
columnskey,summary,type,created,updated,due,assignee,reporter,priority,status,resolution
serverIdbc8d3685-f9c0-329d-9054-b12aabbcb834
keyCORE-352

Статус
colourBlue
title10.2.54.0

Примечание

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

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

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

...

Поле

...

Тип данных

...

Описание

...

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

...

dateOperDay

...

Date

...

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

...

return

...

base64Binary

...

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

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

Блок кода
languagexml
titleПример запроса
<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>

...

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

...

>1</arrayOfParams> <!-- Номер кассы -->
                <arrayOfParams xsi:type="xs:long">1</arrayOfParams> <!-- Номер смены -->
                <arrayOfParams xsi:type="xs:long">2</arrayOfParams> <!-- Номер чека -->
      </plug:getNewFullPurchasesByOperDay>
   </soapenv:Body>
</soapenv:Envelope>

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

Устаревшая версия Jira
serverSystem JIRA
columnskey,summary,type,created,updated,due,assignee,reporter,priority,status,resolution
serverIdbc8d3685-f9c0-329d-9054-b12aabbcb834
keySRTE-3008

Устаревшая версия Jira
serverSystem JIRA
columnskey,summary,type,created,updated,due,assignee,reporter,priority,status,resolution
serverIdbc8d3685-f9c0-329d-9054-b12aabbcb834
keySRTE-2991

Статус
colourBlue
title10.2.92.0

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

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

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

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

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

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

Метод

getNonFiscalDocsByParams
URLhttp://IP-адрес_сервера:8090/SET-ERPIntegration/FiscalInfoExport
WSDLhttp://IP-адрес_сервера:8090/SET-ERPIntegration/FiscalInfoExport?wsdl
Индекс


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

Date

Дата, за которую из операционного дня требуется получить новые чеки
dateОперационный день в формате YYYY-MM-DDДа
1
shopNumber
Long
integerНомер магазина
, от которого из операционного дня следует выбрать новые чеки
Нет
2
cashNumber
Long
integerНомер кассы
, от которой из операционного дня следует выбрать новые чеки
Нет
3
shiftNumber
Long
integerНомер смены
, от которой из операционного дня следует выбрать новые чеки
Нет
4LongНомер чека, от которой из операционного дня следует выбрать новые чекиНет

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

return

base64Binary

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

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

Информация
  • Минимальный размер массива аргументов метода - 1 (потому что параметр "дата опердня" обязательный).
  • Если требуется пропустить, параметр "номер смены", тогда установите значение null, потому что за номером смены следует номер чека.
  • Если требуется номер чека, массиву допустимо быть длиной 4, потому что за параметром "номер чека" ничего не следует.

...

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

...

purchaseNumberintegerНомер нефискального документаНет
typestring

Тип нефискального документа. 

Поле может быть пустым, но обязательно должно присутствовать в структуре запроса

Да 
statusstring

Статус документа. Возможные значения:

  • new – новые, не отправленные документы (помечает документ как отправленный)
  • all – все/любые (не меняет статус документа)
Да 
Возвращаемые параметры
returnbase64BinaryНефискальные документы по заданным параметрам

Описание формата выгрузки нефискальных документов

Блок кода
languagexml
titleПример запроса
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:plug="http://plugins.operday.ERPIntegration.crystals.ru/">
   <soapenv:Header/>
   <soapenv:Body>
      <plug:getNonFiscalDocsByParams>
     <arrayOfParams xsi:type="xs:long">1</arrayOfParams> <!-- Номер кассы <dateOperDay>2022-05->30</dateOperDay>
                <arrayOfParams xsi:type="xs:long">1</arrayOfParams> <!-- Номер смены Optional:-->
         <shopNumber>1</shopNumber>
       <arrayOfParams xsi:type="xs:long">2</arrayOfParams> <!-- Номер чека Optional:-->
      </plug:getNewFullPurchasesByOperDay>    </soapenv:Body>
</soapenv:Envelope>

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

Устаревшая версия Jira
serverSystem JIRA
columnskey,summary,type,created,updated,due,assignee,reporter,priority,status,resolution
serverIdbc8d3685-f9c0-329d-9054-b12aabbcb834
keySRTE-3008

Устаревшая версия Jira
serverSystem JIRA
columnskey,summary,type,created,updated,due,assignee,reporter,priority,status,resolution
serverIdbc8d3685-f9c0-329d-9054-b12aabbcb834
keySRTE-2991

Статус
colourBlue
title10.2.92.0

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

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

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

Блок кода
languagesql
SELECT add_property('SET_ERP_INTEGRATION', 'export.websevice.new.purchases.batch.size', '0', 'Ограничение размера пачки "новых" чеков возвращаемой вебсервисом. 0 - размер не ограничен.');<cashNumber>1</cashNumber>
         <!--Optional:-->
         <shiftNumber>2</shiftNumber>
         <!--Optional:-->
         <purchaseNumber>1</purchaseNumber>
         <type>?</type>
         <status>all</status>
      </plug:getNonFiscalDocsByParams>
   </soapenv:Body>
</soapenv:Envelope>