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

Ключ

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

К оглавлению

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

...

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

...

Поле

...

Тип данных

...

Описание

...

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

...

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

...

День

...

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

...

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 отличаются только способом передачи параметров.

-

...

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

...

Поле

...

Тип данных

...

Описание

...

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

...

fromDate

...

date

...

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

...

toDate

...

date

...

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

...

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

...

return

...

base64Binary

...

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

...

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

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

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

...

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

...

К оглавлению

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

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

Метод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:-->
         <toDate>2019<dateOperDay>2019-05-31<08</toDate>dateOperDay>
      </plug:getPurchasesByPeriod>getPurchasesByOperDay>
   </soapenv:Body>
</soapenv:Envelope>

...

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


За заданный

период по товару

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

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


Код товара

Поле

Тип данных

Описание

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

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

fromDateYear

date

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

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

Нет

toDate

date

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

Нет

goodsCode

string

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:getPurchasesByPeriodAndProduct>getPurchasesByOperDayData>
         <!--Optional:-->
         <fromDate>2019-05-01</fromDate><Year>2019</Year>
         <!--Optional:-->
         <toDate>2019-05-31</toDate><Mobth>MAY</Mobth>
         <!--Optional:-->
         <goodsCode>45033</goodsCode><Day>27</Day>
      </plug:getPurchasesByPeriodAndProduct>getPurchasesByOperDayData>
   </soapenv:Body>
</soapenv:Envelope>


Информация

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

-

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

Для включения выполняются скрипты по базе данных 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

Выгрузка для веб сервиса на стороне 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

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

Поле

Тип данных

Описание

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

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

dateOperDay

dateTime

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

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

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

Метод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.

...

Блок кода
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>getPurchasesByPeriodAndProduct>
         <!--Optional:-->
         <dateOperDay>2021<fromDate>2019-0705-07</dateOperDay>01</fromDate>
         </plug:getReportDeferredByOperDay>!--Optional:-->
    </     <toDate>2019-05-31</toDate>
         <!--Optional:-->
         <goodsCode>45033</goodsCode>
      </plug:getPurchasesByPeriodAndProduct>
   </soapenv:Body>
</soapenv:Envelope>

-

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

Устаревшая версия JiraserverSystem

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

Для включения выполняются скрипты по базе данных 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

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

Поле

Тип данных

Описание

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

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

dateOperDay

dateTime

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

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

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

return

base64Binary

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

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

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

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

...

languagexml

...

Выгрузка для веб сервиса на стороне 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


Поле

Тип данных

Описание

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

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

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>
         <!--Optional:-->
         <shiftNumber>9</shiftNumber>
         <!--Optional:-->
         <cashierTabNo>231</cashierTabNo><dateOperDay>2021-07-07</dateOperDay>
      </plug:getReportDeferredByParams>getReportDeferredByOperDay>
   </soapenv:Body>
</soapenv:Envelope>

asdasdas-

МетодgetPurchasesByParams
По

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

Устаревшая версия Jira

server

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

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

Возвращаемый

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

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

Блок кода
title
languagexmlПример запроса
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:plug="http://plugins.operday.ERPIntegration.crystals.ru/">
   <soapenv:Header/>
   <soapenv:Body>
      <plug:getPurchasesByParams>getReportDeferredByParams>
         <dateOperDay>2019-05-13<<dateOperDay>?</dateOperDay>
         <!--Optional:-->
         <shopNumber>3382<<shopNumber>234</shopNumber>
         <!--Optional:-->
         <cashNumber>1<<cashNumber>3</cashNumber>
         <!--Optional:-->
         <shiftNumber>1<<shiftNumber>9</shiftNumber>
         <!--Optional:-->
         <purchaseNumber>7<<cashierTabNo>231</purchaseNumber>cashierTabNo>
      </plug:getPurchasesByParams>getReportDeferredByParams>
   </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

Устаревшая версия 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


...

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/">
    <soap:Header/>
    <soap:Body> <m:getPurchasesByParams xmlns:mplug="http://plugins.operday.ERPIntegration.crystals.ru/">
   <soapenv:Header/>
<dateOperDay xmlns=""  <soapenv:Body>
      <plug:getPurchasesByParams>
         xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">2019-10-29T00:00:00</dateOperDay><dateOperDay>2019-05-13</dateOperDay>
         <!--Optional:-->
     <shopNumber xmlns=""   <shopNumber>3382</shopNumber>
         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=""
           <!--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

Устаревшая версия 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"
            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
КомментарийВыгружаются все новые чеки за указанный операционный день, либо удовлетворяющие заданным параметрам, если они указаны.

Статус
colourBlue
title10.2.66.0

Устаревшая версия Jira
serverSystem JIRA
columnskey,summary,type,created,updated,due,assignee,reporter,priority,status,resolution
serverIdbc8d3685-f9c0-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"> 
	<soapenv:Header/> 
	<soapenv:Body> 
		<plug:getNewPurchasesByOperDay> 
			<!---OperDay --> 
			<arrayOfParams  xsi:niltype="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>

-

...

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

...

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
WSDLhttp://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-2030


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>getFullPurchasesByParams>
         <dateOperDay>2019<dateOperDay>2018-0508-03<16</dateOperDay>
         <!--Optional:-->
         <shopNumber>3328<<shopNumber>6502</shopNumber>
         <!--Optional:-->
         <cashNumber>3<<cashNumber>1</cashNumber>
         <!--Optional:-->
         <shiftNumber>16</shiftNumber>
         <!--Optional:--><shiftNumber>1</shiftNumber>
         <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.

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

/FiscalInfoExport
WSDLhttp://IP-адрес_сервера:8090/SET-ERPIntegration/FiscalInfoExport?wsdl


Индекс

Тип данных

Описание

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

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

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 --> 
			getNewFullPurchasesByOperDay>
         <arrayOfParams xsi:type="xs:dateTime">2014>2018-1108-24T1216T12: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<>6502</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>

...

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

...


                <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

Устаревшая версия 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


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

Date

Дата, за которую из операционного дня требуется получить новые чекиdateОперационный день в формате YYYY-MM-DDДа
1shopNumberLongНомер магазина, от которого из операционного дня следует выбрать новые чекиintegerНомер магазинаНет
2cashNumberLongintegerНомер кассы, от которой из операционного дня следует выбрать новые чекиНет
3shiftNumberLongintegerНомер смены, от которой из операционного дня следует выбрать новые чекиНет
4purchaseNumberLongНомер чека, от которой из операционного дня следует выбрать новые чекиНетintegerНомер нефискального документаНет
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/"
        xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
   <soapenv:Header/>
   <soapenv:Body>
      <plug:getNewFullPurchasesByOperDay>
getNonFiscalDocsByParams>
         <dateOperDay>2022-05-30</dateOperDay>
        <arrayOfParams xsi:type="xs:dateTime">2018-08-16T12:00:00.000</arrayOfParams><!--Optional:-->
         <shopNumber>1</shopNumber>
       <arrayOfParams xsi:type="xs:long">6502</arrayOfParams> <!-- Номер магазина Optional:-->
         <cashNumber>1</cashNumber>
       <arrayOfParams xsi:type="xs:long">1</arrayOfParams> <!-- Номер кассы Optional:-->
         <shiftNumber>2</shiftNumber>
       <arrayOfParams xsi:type="xs:long">1</arrayOfParams> <!--Optional:-->
      Номер смены --> <purchaseNumber>1</purchaseNumber>
         <type>?</type>
     <arrayOfParams xsi:type="xs:long">2</arrayOfParams> <!-- Номер чека --><status>all</status>
       </plug:getNewFullPurchasesByOperDay>getNonFiscalDocsByParams>
   </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 - размер не ограничен.');

...


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

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

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


Поле

Тип данных

Описание

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

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

dateOperDay

date

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

Да

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

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:getCancelledPurchasesByOperDay>
         <dateOperDay>2022-08-22</dateOperDay>
      </plug:getCancelledPurchasesByOperDay>
   </soapenv:Body>
</soapenv:Envelope>

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


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

Метод

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


ПолеТип данныхОписаниеОбязательное
Принимаемые параметры
dateOperDaydateОперационный день в формате YYYY-MM-DDДа
shopNumberintegerНомер магазинаНет
cashNumberintegerНомер кассыНет
shiftNumberintegerНомер сменыНет
purchaseNumberintegerНомер нефискального документаНетtypestring

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

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

Да statusstring

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

  • new – новые, не отправленные документы (помечает документ как отправленный)
  • all – все/любые (не меняет статус документа)
Да 
cashierTabNointegerТабельный номер кассира, аннулировавшего чекНет
Возвращаемые параметры
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>
         <dateOperDay>2022-05-30</dateOperDay>
         <!--Optional:--/">
         <shopNumber>1</shopNumber><soapenv:Header/>
         <!--Optional:--><soapenv:Body>
      <plug:getCancelledPurchasesByParams>
  <cashNumber>1</cashNumber>          <!<dateOperDay>2022--Optional:-->08-22</dateOperDay>
         <shiftNumber>2<<shopNumber>3245</shiftNumber>shopNumber>
         <!--Optional:-->
         <purchaseNumber>1</purchaseNumber><cashNumber>62</cashNumber>
         <type>?<<shiftNumber>1</type>shiftNumber>
         <status>all<<cashierTabNo>111</status>cashierTabNo>
      </plug:getNonFiscalDocsByParams>getCancelledPurchasesByParams>
   </soapenv:Body>
</soapenv:Envelope>

...