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

Перейти к концу метаданных
Переход к началу метаданных

Вы просматриваете старую версию данной страницы. Смотрите текущую версию.

Сравнить с текущим просмотр истории страницы

« Предыдущий Версия 55 Следующий »

Описание

Данный вариант экспорта предполагает обмен данными на основе 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

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


Пример запроса
<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 

string

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

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

Day

integer

День

Нет

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

return

base64Binary

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


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

Пример запроса
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:plug="http://plugins.operday.ERPIntegration.crystals.ru/">
   <soapenv:Header/>
   <soapenv:Body>
      <plug: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

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


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

Пример запроса
<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

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


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

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

-

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

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

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


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

Пример запроса
<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

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


Пример запроса
<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

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


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

Пример запроса
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:plug="http://plugins.operday.ERPIntegration.crystals.ru/" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> 
	<soapenv:Header/> 
	<soapenv:Body> 
		<plug:getNewPurchasesByOperDay> 
			<!---OperDay --> 
			<arrayOfParams xsi:type="xs:dateTime">2014-11-24T12:00:00.000</arrayOfParams> 
			<!---Shop number (optional) --> 
			<arrayOfParams xsi:type="xs:long">12345</arrayOfParams> 
			<!---Cash number (optional)--> 
			<arrayOfParams xsi:type="xs:long">1</arrayOfParams> 
			<!---Shift number (optional)--> <arrayOfParams xsi:type="xs:long">3</arrayOfParams> 
			<!---Document number (optional)--> <arrayOfParams xsi:type="xs:long">2</arrayOfParams> 
		</plug:getNewPurchasesByOperDay> 
	</soapenv:Body> 
</soapenv:Envelope>

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

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

10.2.54.0

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

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

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

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

Поле

Тип данных

Описание

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

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

dateOperDay

Date

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


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

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

return

base64Binary

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


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

Пример запроса
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:plug="http://plugins.operday.ERPIntegration.crystals.ru/">
   <soapenv:Header/>
   <soapenv:Body>
      <plug:getFullPurchasesByParams>
         <dateOperDay>2018-08-16</dateOperDay>
         <shopNumber>6502</shopNumber>
         <cashNumber>1</cashNumber>
         <shiftNumber>1</shiftNumber>
         <purchaseNumber>2</purchaseNumber>
      </plug:getFullPurchasesByParams>
   </soapenv:Body>
</soapenv:Envelope>


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

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

Индекс

Тип данных

Описание

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

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

0

Date

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

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

return

base64Binary

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


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

  • Минимальный размер массива аргументов метода - 1 (потому что параметр "дата опердня" обязательный).
  • Если требуется пропустить, параметр "номер смены", тогда установите значение null, потому что за номером смены следует номер чека.
  • Если требуется номер чека, массиву допустимо быть длиной 4, потому что за параметром "номер чека" ничего не следует.
Пример запроса
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:plug="http://plugins.operday.ERPIntegration.crystals.ru/"
        xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
   <soapenv:Header/>
   <soapenv:Body>
      <plug:getNewFullPurchasesByOperDay>
         <arrayOfParams xsi:type="xs:dateTime">2018-08-16T12:00:00.000</arrayOfParams>
                <arrayOfParams xsi:type="xs:long">6502</arrayOfParams> <!-- Номер магазина -->
                <arrayOfParams xsi:type="xs:long">1</arrayOfParams> <!-- Номер кассы -->
                <arrayOfParams xsi:type="xs:long">1</arrayOfParams> <!-- Номер смены -->
                <arrayOfParams xsi:type="xs:long">2</arrayOfParams> <!-- Номер чека -->
      </plug:getNewFullPurchasesByOperDay>
   </soapenv:Body>
</soapenv:Envelope>

Выгрузка Z-отчетов

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

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

Поле

Тип данных

Описание

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

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

dateOperDay

date

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

Нет

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

return

base64Binary

Z-отчеты за операционный день


Подробнее: Описание формата выгрузки Z-отчётов 

Пример запроса
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:plug="http://plugins.operday.ERPIntegration.crystals.ru/">
   <soapenv:Header/>
   <soapenv:Body>
      <plug:getZReportsByOperDay>
         <!--Optional:-->
         <dateOperDay>2019-05-28</dateOperDay>
      </plug:getZReportsByOperDay>
   </soapenv:Body>
</soapenv:Envelope>

-

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

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

Поле

Тип данных

Описание

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

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

Year

integer

Год

Нет

Month

string

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

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

Day

integer

День месяца

Нет

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

return

base64Binary

Z-отчеты за операционный день


Подробнее: Описание формата выгрузки Z-отчётов

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

Пример запроса
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:plug="http://plugins.operday.ERPIntegration.crystals.ru/">
   <soapenv:Header/>
   <soapenv:Body>
      <plug:getZReportsByOperDayData>
         <Year>2019</Year>
         <!--Optional:-->
         <Mobth>MAY</Mobth>
         <Day>28</Day>
      </plug:getZReportsByOperDayData>
   </soapenv:Body>
</soapenv:Envelope>

-

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

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

Z-отчеты за операционный день


Подробнее: Описание формата выгрузки Z-отчётов

Пример запроса
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:plug="http://plugins.operday.ERPIntegration.crystals.ru/">
   <soapenv:Header/>
   <soapenv:Body>
      <plug:getZReportsByPeriod>
         <!--Optional:-->
         <fromDate>2018-12-01</fromDate>
         <!--Optional:-->
         <toDate>2019-05-13</toDate>
      </plug:getZReportsByPeriod>
   </soapenv:Body>
</soapenv:Envelope>

-

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

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


Поле

Тип данных

Описание

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

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

dateOperDay

date

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

Да

shopNumber

integer

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

Нет

cashNumber

integer

Номер кассы

Нет

shiftNumber

integer

Номер смены

Нет

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

return

base64Binary

Z-отчеты по заданным параметрам


Подробнее: Описание формата выгрузки Z-отчётов

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

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

Кейсы

  1. dateOperDay - в отчёт попадают все смены всех магазинов за операционный день dateOperDay
  2. dateOperDayshopNumber - в отчёт попадают все смены за операционный день dateOperDay с магазина shopNumber.
  3. dateOperDayshopNumbercashNumber - в отчёт попадают все смены за операционный день dateOperDay с магазина shopNumber с кассы cashNumber.
  4. dateOperDayshopNumbercashNumbershiftNumber - в отчёт попадает смена shiftNumber за операционный день dateOperDay с магазина shopNumber с кассы cashNumber.
Пример запроса
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:plug="http://plugins.operday.ERPIntegration.crystals.ru/">
   <soapenv:Header/>
   <soapenv:Body>
      <plug:getZReportsByParams>
         <dateOperDay>2019-05-13</dateOperDay>
         <!--Optional:-->
         <shopNumber>3455</shopNumber>
         <!--Optional:-->
         <cashNumber>1</cashNumber>
         <!--Optional:-->
         <shiftNumber>16</shiftNumber>
      </plug:getZReportsByParams>
   </soapenv:Body>
</soapenv:Envelope>

-

Новые, не отправленные Z-отчеты

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


Поле

Тип данных

Описание

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

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

arrayOfParams

array

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

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

Да

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

return

base64Binary

Z-отчеты за операционный день или по заданным параметрам


Подробнее: Описание формата выгрузки Z-отчётов

Пример запроса
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:plug="http://plugins.operday.ERPIntegration.crystals.ru/" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> 
	<soapenv:Header/> 
	<soapenv:Body> 
		<plug: getNewZReportsByOperDay > 
			<!---OperDay --> 
			<arrayOfParams xsi:type="xs:dateTime">2014-11-24T12:00:00.000</arrayOfParams> 
			<!---Shop number (optional) --> 
			<arrayOfParams xsi:type="xs:long">12345</arrayOfParams> 
			<!---Cash number (optional)--> 
			<arrayOfParams xsi:type="xs:long">1</arrayOfParams> 
			<!---Shift number (optional)--> <arrayOfParams xsi:type="xs:long">3</arrayOfParams> 
		</plug: getNewZReportsByOperDay > 
	</soapenv:Body> 
</soapenv:Envelope>

-

Выгрузка новых, не отправленных Z-отчётов за операционный день с вводом параметров

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

10.2.66.0

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

Поле

Тип данных

Описание

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

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

dateOperDay

date

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

Да

shopNumber

integer

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

Нет

cashNumber

integer

Номер кассы

Нет

shiftNumber

integer

Номер смены

Нет

purchaseNumber

integer

Номер чека

Нет

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

return

base64Binary

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


Пример запроса
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:plug="http://plugins.operday.ERPIntegration.crystals.ru/">
   <soapenv:Header/>
   <soapenv:Body>
      <plug:getNewZReportsByParams>
         <dateOperDay>2019-05013</dateOperDay>
         <!--Optional:-->
         <shopNumber>3328</shopNumber>
         <!--Optional:-->
         <cashNumber>3</cashNumber>
         <!--Optional:-->
         <shiftNumber>14</shiftNumber>
      </plug:getNewZReportsByParams>
   </soapenv:Body>
</soapenv:Envelope>

Выгрузка результатов расчета скидок

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

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

Отчет по скидкам за период


Подробнее: Описание формата выгрузки скидок

Пример запроса
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:plug="http://plugins.operday.ERPIntegration.crystals.ru/">
   <soapenv:Header/>
   <soapenv:Body>
      <plug:getLoyResultsByPeriod>
         <!--Optional:-->
         <fromDate>2019-05-13</fromDate>
         <!--Optional:-->
         <toDate>2019-06-13</toDate>
      </plug:getLoyResultsByPeriod>
   </soapenv:Body>
</soapenv:Envelope>

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

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

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

Поле

Тип данных

Описание

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

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

fromDate

date

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

Нет

toDate

date

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

Нет

goodsCode

string

Код товара

Нет

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

return

base64Binary

Отчет по скидкам за период


Подробнее: Описание формата выгрузки скидок

Пример запроса
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:plug="http://plugins.operday.ERPIntegration.crystals.ru/">
   <soapenv:Header/>
   <soapenv:Body>
      <plug:getLoyResultsByPeriodAndProduct>
         <!--Optional:-->
         <fromDate>2019-03-01</fromDate>
         <!--Optional:-->
         <toDate>2019-05-31</toDate>
         <!--Optional:-->
         <goodsCode>45035</goodsCode>
      </plug:getLoyResultsByPeriodAndProduct>
   </soapenv:Body>
</soapenv:Envelope>


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

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

Поле

Тип данных

Описание

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

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

fromDate

date

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

Нет

toDate

date

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

Нет

shopNumber

integer

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

Нет

cashNumber

integer

Номер кассы

Нет

shiftNumber

integer

Номер смены

Нет

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

return

base64Binary

Отчет по скидкам за период


Подробнее: Описание формата выгрузки скидок

Пример запроса
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:plug="http://plugins.operday.ERPIntegration.crystals.ru/">
   <soapenv:Header/>
   <soapenv:Body>
      <plug:getLoyResultsByPeriodAndShift>
         <!--Optional:-->
         <fromDate>2019-05-01</fromDate>
         <!--Optional:-->
         <toDate>2019-05-31</toDate>
         <!--Optional:-->
         <shopNumber>3328</shopNumber>
         <!--Optional:-->
         <cashNumber>1</cashNumber>
         <!--Optional:-->
         <shiftNumber>15</shiftNumber>
      </plug:getLoyResultsByPeriodAndShift>
   </soapenv:Body>
</soapenv:Envelope>

Выгрузка внесений

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

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

Поле

Тип данных

Описание

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

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

operday

date

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

Нет

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

return

base64Binary

Внесения за операционный день


Подробнее: Описание формата выгрузки внесений

Пример запроса
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:plug="http://plugins.operday.ERPIntegration.crystals.ru/">
   <soapenv:Header/>
   <soapenv:Body>
      <plug:getIntroductionsByOperday>
         <!--Optional:-->
         <operday>2019-06-03</operday>
      </plug:getIntroductionsByOperday>
   </soapenv:Body>
</soapenv:Envelope>

-

За период

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

Внесения за период


Подробнее: Описание формата выгрузки внесений

Пример запроса
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:plug="http://plugins.operday.ERPIntegration.crystals.ru/">
   <soapenv:Header/>
   <soapenv:Body>
      <plug:getIntroductionsByPeriod>
         <!--Optional:-->
         <fromDate>2019-06-01</fromDate>
         <!--Optional:-->
         <toDate>2019-06-13</toDate>
      </plug:getIntroductionsByPeriod>
   </soapenv:Body>
</soapenv:Envelope>

Выгрузка изъятий

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

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

Поле

Тип данных

Описание

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

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

operday

date

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

Нет

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

return

base64Binary

Изъятия за операционный день


Подробнее: Описание формата выгрузки внесений

Пример запроса
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:plug="http://plugins.operday.ERPIntegration.crystals.ru/">
   <soapenv:Header/>
   <soapenv:Body>
      <plug:getWithdrawalsByOperday>
         <!--Optional:-->
         <operday>2019-05-13</operday>
      </plug:getWithdrawalsByOperday>
   </soapenv:Body>
</soapenv:Envelope>

-

За период

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

Изъятия за период


Подробнее: Описание формата выгрузки внесений

Пример запроса
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:plug="http://plugins.operday.ERPIntegration.crystals.ru/">
   <soapenv:Header/>
   <soapenv:Body>
      <plug:getWithdrawalsByPeriod>
         <!--Optional:-->
         <fromDate>2019-05-01</fromDate>
         <!--Optional:-->
         <toDate>2019-05-30</toDate>
      </plug:getWithdrawalsByPeriod>
   </soapenv:Body>
</soapenv:Envelope>

Выгрузка отчета по продажам

Выгрузка отчета по продажам доступна только в SetRetail10, в SetCentrum10 выгрузка таких данных не предусмотрена.

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

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

Поле

Тип данных

Описание

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

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

dateOperDay

date

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

Нет

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

return

base64Binary

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


Подробнее: Описание формата выгрузки отчёта по продажам

Пример запроса
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:plug="http://plugins.operday.ERPIntegration.crystals.ru/">
   <soapenv:Header/>
   <soapenv:Body>
      <plug:getSalesReportOperDay>
         <!--Optional:-->
         <dateOperDay>2019-05-13</dateOperDay>
      </plug:getSalesReportOperDay>
   </soapenv:Body>
</soapenv:Envelope>

-

За заданный операционный день с разбивкой по налоговым ставкам

МетодgetSalesReportWithTax
URLhttp://IP-адрес_сервера:8090/SET-ERPIntegration/FiscalInfoExport
WSDLhttp://IP-адрес_сервера:8090/SET-ERPIntegration/FiscalInfoExport?wsdl
КомментарийВ данном методе добавен блок распределения сумм по типам отплат по налоговым ставкам

Поле

Тип данных

Описание

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

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

dateOperDay

date

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

Нет

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

return

base64Binary

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


Подробнее: Описание формата выгрузки отчёта по продажам с разбивкой по налогам

Пример запроса
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:plug="http://plugins.operday.ERPIntegration.crystals.ru/">
   <soapenv:Header/>
   <soapenv:Body>
      <plug:getSalesReportWithTax>
         <!--Optional:-->
         <dateOperDay>2019-05-13</dateOperDay>
      </plug:getSalesReportWithTax>
   </soapenv:Body>
</soapenv:Envelope>

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

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

10.2.42.0

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

Поле

Тип данных

Описание

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

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

dateOperDay

date

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

Нет

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

return

base64Binary

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


Пример запроса
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:sal="http://salesreportwithtax.plugins.operday.ERPIntegration.crystals.ru/">
   <soapenv:Header/>
   <soapenv:Body>
      <sal:getSalesReportWithSeparatedTax>
         <!--Optional:-->
         <dateOperDay>2019-03-10</dateOperDay>
      </sal:getSalesReportWithSeparatedTax>
   </soapenv:Body>
</soapenv:Envelope>

Отчет о времени работы кассиров

10.2.27.0

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

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

МетодgetCashierWorkTime
URLhttp://IP-адрес_сервера:8090/SET-OperDay/ExporterWS
WSDLhttp://IP-адрес_сервера:8090/SET-OperDay/ExporterWS

Поле

Тип данных

Описание

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

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

dateOperday

date

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

Да

shopNumber

Integer

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

Нет

cashNumber

Integer

Номер кассы

Нет

shiftNumber

integer

Номер смены

Нет

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

return

base64Binary

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


Подробнее: Описание формата выгрузки отчёта о времени работы кассиров 

Пример запроса
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:exp="http://export.operday.crystals.ru/">
   <soapenv:Header/>
   <soapenv:Body>
      <exp:getCashierWorkTime>
         <dateOperday>2019-05-15</dateOperday>
         <!--Optional:-->
         <shopNumber>3382</shopNumber>
         <!--Optional:-->
         <cashNumber>2</cashNumber>
         <!--Optional:-->
         <shiftNumber>8</shiftNumber>
      </exp:getCashierWorkTime>
   </soapenv:Body>
</soapenv:Envelope>

Информация по подарочным картам

10.2.59.0

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

По номеру подарочной карты

МетодgetPresentCardInformation
URLhttp://IP-адрес_сервера:8090/SET-Cards-PresentCards/SET/Cards/PresentCards/ProcessingManager
WSDLhttp://IP-адрес_сервера:8090/SET-Cards-PresentCards/SET/Cards/PresentCards/ProcessingManager?wsdl

Поле

Тип данных

Описание

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

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

cardNumber

String

Номер карты

Да

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

return

xml

Информация по подарочное карте


amountLongСумма подарочной карты
balanceLongОстаток суммы подарочной карты
cardNumberStringНомер подарочной карты
expirationDatedateTimeДата окончания действия
statuscardStatus

Статус подарочной карты:

  • Create
  • Active
  • Blocked
  • Inactive
  • Used
  • PreActive
  • PreUsed
  • PreDeactive
  • NeedReturn
  • NeedTakeAway

Пример запроса
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.processing.cards.crystals.ru/">
   <soapenv:Header/>
   <soapenv:Body>
      <ser:getPresentCardInformation>
         <!--Optional:-->
         <cardNumber>654987</cardNumber>
      </ser:getPresentCardInformation>
   </soapenv:Body>
</soapenv:Envelope>


По номеру магнитной полосы MSR подарочной карты

МетодgetPresentCardInformationByMSRNumber
URLhttp://IP-адрес_сервера:8090/SET-Cards-PresentCards/SET/Cards/PresentCards/ProcessingManager
WSDLhttp://IP-адрес_сервера:8090/SET-Cards-PresentCards/SET/Cards/PresentCards/ProcessingManager?wsdl

Поле

Тип данных

Описание

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

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

cardNumber

String

Номер карты

Да

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

return

xml

Информация по подарочное карте


amountLongСумма подарочной карты
balanceLongОстаток суммы подарочной карты
cardNumberStringНомер подарочной карты
expirationDatedateTimeДата окончания действия
statuscardStatus

Статус подарочной карты:

  • Create
  • Active
  • Blocked
  • Inactive
  • Used
  • PreActive
  • PreUsed
  • PreDeactive
  • NeedReturn
  • NeedTakeAway

Пример запроса
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.processing.cards.crystals.ru/">
   <soapenv:Header/>
   <soapenv:Body>
      <ser:getPresentCardInformationByMSRNumber>
         <!--Optional:-->
         <msrNumber>654987</msrNumber>
      </ser:getPresentCardInformationByMSRNumber>
   </soapenv:Body>
</soapenv:Envelope>


По фильтрам

МетодgetPresentCardsInfoByFilter
URLhttp://IP-адрес_сервера:8090/SET-Cards-PresentCards/SET/Cards/PresentCards/ProcessingManager
WSDLhttp://IP-адрес_сервера:8090/SET-Cards-PresentCards/SET/Cards/PresentCards/ProcessingManager?wsdl

Поле

Тип данных

Описание

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

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

cardNumber

String

Номер карты

Нет
endDateFromdateTimeДата окончания действия карты [от] в формате YYYY-MM-DDНет
endDateTodateTimeДата окончания действия карты [до] в формате YYYY-MM-DDНет
operationDateFromdateTimeДата операций по подарочной карте [от] в формате YYYY-MM-DDНет
operationDateTodateTimeДата операций по подарочной карте [до] в формате YYYY-MM-DDНет
paymentDatedateTimeДата оплаты подарочной картой в формате YYYY-MM-DDНет
saleDatedateTimeДата продажи подарочной картой в формате YYYY-MM-DDНет
startDateFromdateTimeДата начала действия карты [от] в формате YYYY-MM-DDНет
startDateTodateTimeДата начала действия карты [до] в формате YYYY-MM-DDНет
statuscardStatus

Статус подарочной карты:

  • Create
  • Active
  • Blocked
  • Inactive
  • Used
  • PreActive
  • PreUsed
  • PreDeactive
  • NeedReturn
  • NeedTakeAway
Нет

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

return

base64

Информация по подарочное карте


Пример запроса
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.processing.cards.crystals.ru/">
   <soapenv:Header/>
   <soapenv:Body>
      <ser:getPresentCardsInfoByFilter>
         <!--Optional:-->
         <filter>
            <!--Optional:-->
            <cardNumber>654987</cardNumber>
            <!--Optional:-->
            <endDateFrom>2019-01-30</endDateFrom>
            <!--Optional:-->
            <endDateTo>2019-06-30</endDateTo>
            <!--Optional:-->
            <operationDateFrom>2019-01-30</operationDateFrom>
            <!--Optional:-->
            <operationDateTo>2019-06-30</operationDateTo>
            <!--Optional:-->
            <paymentDate>2019-04-08</paymentDate>
            <!--Optional:-->
            <saleDate>2019-04-08</saleDate>
            <!--Optional:-->
            <startDateFrom>2019-04-08</startDateFrom>
            <!--Optional:-->
            <startDateTo>2019-04-08</startDateTo>
            <!--Optional:-->
            <status>Active</status>
         </filter>
      </ser:getPresentCardsInfoByFilter>
   </soapenv:Body>
</soapenv:Envelope>
  • Нет меток