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

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

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

К оглавлению

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

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

Метод

getPurchasesByOperDay

URL

http://IP-адрес_сервера:8090/SET-ERPIntegration/FiscalInfoExport

WSDL

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

Поле

Тип данных

Описание

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

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

dateOperDay

date

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

Да

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

return

base64Binary

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

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

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

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

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

 

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

Метод

getPurchasesByOperDayData

URL

http://IP-адрес_сервера:8090/SET-ERPIntegration/FiscalInfoExport

WSDL

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

Поле

Тип данных

Описание

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

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

Year

integer

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

Нет

Mobth 

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

string

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

  • JANUARY

  • FEBRUARY

  • MARCH

  • APRIL

  • MAY

  • JUNE

  • JULY

  • AUGUST

  • SEPTEMBER

  • OCTOBER

  • NOVEMBER

  • DECEMBER

Да

Day

integer

День

Нет

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

return

base64Binary

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

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

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

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

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

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

-

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

Метод

getPurchasesByPeriod

URL

http://IP-адрес_сервера:8090/SET-ERPIntegration/FiscalInfoExport

WSDL

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

Поле

Тип данных

Описание

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

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

fromDate

date

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

Нет

toDate

date

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

Нет

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

return

base64Binary

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

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

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

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

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

-

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

Метод

getPurchasesByPeriodAndProduct

URL

http://IP-адрес_сервера:8090/SET-ERPIntegration/FiscalInfoExport

WSDL

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

Поле

Тип данных

Описание

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

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

fromDate

date

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

Нет

toDate

date

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

Нет

goodsCode

string

Код товара

Нет

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

return

base64Binary

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

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

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

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

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

-

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

Для включения выполняются скрипты по базе данных

set сервера SetRetail10/SetCentrum.

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

https://crystals.atlassian.net/browse/CR-5382

https://crystals.atlassian.net/browse/SRTE-3562

10.2.99.0

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

UPDATE public.sales_management_properties SET property_value='1.18' WHERE property_key = 'export.set10wsclient.purchases.version';
UPDATE public.sales_management_properties SET property_value='true' WHERE property_key = 'export.set10wsclient.purchases.deferred.enabled';

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

UPDATE public.sales_management_properties SET property_value='1.9' WHERE property_key = 'export.file.purchases.version';
UPDATE public.sales_management_properties SET property_value='true' WHERE property_key = 'export.file.purchases.deferred.enabled';

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

https://crystals.atlassian.net/browse/CR-5382

https://crystals.atlassian.net/browse/SRTE-3562

10.2.99.0

Метод

getReportDeferredByOperDay

URL

http://IP-адрес_сервера:8090/SET-ERPIntegration/FiscalInfoExport

WSDL

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

Поле

Тип данных

Описание

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

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

dateOperDay

dateTime

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

Нет

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

return

base64Binary

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

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

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

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

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:plug="http://plugins.operday.ERPIntegration.crystals.ru/"> <soapenv:Header/> <soapenv:Body> <plug:getReportDeferredByOperDay> <!--Optional:--> <dateOperDay>2021-07-07</dateOperDay> </plug:getReportDeferredByOperDay> </soapenv:Body> </soapenv:Envelope>

-

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

https://crystals.atlassian.net/browse/CR-5382

https://crystals.atlassian.net/browse/SRTE-3562

10.2.99.0

Метод

getReportDeferredByParams

URL

http://IP-адрес_сервера:8090/SET-ERPIntegration/FiscalInfoExport

WSDL

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

Поле

Тип данных

Описание

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

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

dateOperDay

dateTime

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

Нет

shopNumber

Long

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

Нет

cashNumber

Long

Номер кассы

Нет

shiftNumber

Long

Номер смены

Нет

cashierTabNo

String

Табельный номер кассира

Нет

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

return

base64Binary

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

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

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

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

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:plug="http://plugins.operday.ERPIntegration.crystals.ru/"> <soapenv:Header/> <soapenv:Body> <plug:getReportDeferredByParams> <dateOperDay>?</dateOperDay> <!--Optional:--> <shopNumber>234</shopNumber> <!--Optional:--> <cashNumber>3</cashNumber> <!--Optional:--> <shiftNumber>9</shiftNumber> <!--Optional:--> <cashierTabNo>231</cashierTabNo> </plug:getReportDeferredByParams> </soapenv:Body> </soapenv:Envelope>

asdasdas

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

Метод

getPurchasesByParams

URL

http://IP-адрес_сервера:8090/SET-ERPIntegration/FiscalInfoExport

WSDL

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

Поле

Тип данных

Описание

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

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

dateOperDay

date

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

Да

shopNumber

integer

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

Нет

cashNumber

integer

Номер кассы

Нет

shiftNumber

integer

Номер смены

Нет

purchaseNumber

integer

Номер чека

Нет

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

return

base64Binary

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

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

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

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

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

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

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

Кейсы

  1. dateOperDay - в отчёт попадают все чеки всех магазинов за операционный день dateOperDay.

  2. dateOperDay, shopNumber - в отчёт попадают все чеки за операционный день dateOperDay с магазина shopNumber.

  3. dateOperDay, shopNumber, cashNumber - в отчёт попадают все чеки за операционный день dateOperDay с магазина shopNumber с кассы cashNumber.

  4. dateOperDay, shopNumber, cashNumber, shiftNumber - в отчёт попадают все чеки смены shiftNumber за операционный день dateOperDay с магазина shopNumber с кассы cashNumber.

  5. dateOperDay, shopNumber, cashNumber, shiftNumber, purchaseNumber - в отчёт попадает только один конкретный чек под номером purchaseNumber из сменыshiftNumber за операционный день dateOperDay с магазина shopNumber с кассы cashNumber.

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

https://crystals.atlassian.net/browse/SRTE-2613

10.2.80.0

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

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