ВЕРСИЯ ВЕБ-СЕРВИСА 1.10
Методы веб-сервиса для экспорта чеков
За заданный операционный день | |
Метод | 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 Параметр | string | Месяц в текстовом формате:
| Да |
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>
-
Экспорт информации по отложенным чекам (включение) | |
Выгрузка для веб сервиса на стороне 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'; |
Поле | Тип данных | Описание | Обязательное |
Принимаемые параметры | |||
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>
-
Поле | Тип данных | Описание | Обязательное |
Принимаемые параметры | |||
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
– являются необязательными.
В зависимости от полноты указания параметров, в ответе будет возвращаться соответствующее количество чеков.
Кейсы
dateOperDay
- в отчёт попадают все чеки всех магазинов за операционный деньdateOperDay
.dateOperDay
,shopNumber
- в отчёт попадают все чеки за операционный деньdateOperDay
с магазинаshopNumber
.dateOperDay
,shopNumber
,cashNumber
- в отчёт попадают все чеки за операционный деньdateOperDay
с магазина shopNumber с кассыcashNumber
.dateOperDay
,shopNumber
,cashNumber
,shiftNumber
- в отчёт попадают все чеки смены shiftNumber за операционный деньdateOperDay
с магазина shopNumber с кассыcashNumber
.dateOperDay
,shopNumber
,cashNumber
,shiftNumber
,purchaseNumber
- в отчёт попадает только один конкретный чек под номеромpurchaseNumber
из сменыshiftNumber за операционный деньdateOperDay
с магазина shopNumber с кассыcashNumber
.
Обработка не заданных параметров для метода getPurchasesByParams
- SRTE-2613Getting issue details... STATUS
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 |
URL | http://IP-адрес_сервера:8090/SET-ERPIntegration/FiscalInfoExport |
WSDL | http://IP-адрес_сервера:8090/SET-ERPIntegration/FiscalInfoExport?wsdl |
Комментарий | Выгружаются все новые чеки за указанный операционный день, либо удовлетворяющие заданным параметрам, если они указаны. |
10.2.66.0 |
Поле | Тип данных | Описание | Обязательное |
Принимаемые параметры | |||
dateOperDay | date | Операционный день в формате YYYY-MM-DD | Да |
shopNumber | integer | Номер магазина | Нет |
cashNumber | integer | Номер кассы | Нет |
shiftNumber | integer | Номер смены | Нет |
purchaseNumber | integer | Номер чека | Нет |
Возвращаемые параметры | |||
return | base64Binary | Чеки по заданным параметрам | |
Возвращаемый результат не содержит полные данные по бонусам и скидкам. Для полного просмотра бонусов и скидок используйте метод getFullPurchasesByParams. |
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:plug="http://plugins.operday.ERPIntegration.crystals.ru/"> <soapenv:Header/> <soapenv:Body> <plug:getNewPurchasesByParams> <dateOperDay>2019-05-03</dateOperDay> <!--Optional:--> <shopNumber>3328</shopNumber> <!--Optional:--> <cashNumber>3</cashNumber> <!--Optional:--> <shiftNumber>16</shiftNumber> <!--Optional:--> <purchaseNumber>?</purchaseNumber> </plug:getNewPurchasesByParams> </soapenv:Body> </soapenv:Envelope>
--
Экспорт новых, не отправленных чеков | |
Метод | getNewPurchasesByOperDay |
URL | http://IP-адрес_сервера:8090/SET-ERPIntegration/FiscalInfoExport |
WSDL | http://IP-адрес_сервера:8090/SET-ERPIntegration/FiscalInfoExport?wsdl |
В отчёте выгружаются только новые чеки (те которые ещё не забирали).
Выгружаются все новые чеки за указанный операционный день, либо удовлетворяющие заданным параметрам, если они указаны.
Поле | Тип данных | Описание | Обязательное |
Принимаемые параметры | |||
arrayOfParams | array | Массив параметров по следующему формату:
| Да |
Возвращаемые параметры | |||
return | base64Binary | Чеки за операционный день | |
Возвращаемый результат не содержит полные данные по бонусам и скидкам. Для полного просмотра бонусов и скидок используйте метод getFullPurchasesByParams. |
Описание формата выгрузки чеков
<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-352Getting issue details... STATUS
10.2.54.0
Чеки и скидки с кассы в загружаются в операционный день не одновременно. В случае, если для чека были скидки, но в операционный день они ещё не пришли, такой чек не будет возвращаться веб-сервисами, пока для чека не придут скидки.
По умолчанию у скидок установлен срок хранения 29 дней, и по истечении указанного срока чеки, в которых были применены какие-либо рекламные акции, также не будут возвращаться веб-сервисом.
Для увеличения или уменьшения периода хранения скидок в днях можно скорректировать в конфигурационном файле сервера параметр erpi.loy.transaction.clean.days.interval
:
- Linux: /var/lib/jboss/standalone/configuration/modules/erp-integration/ERPIntegration.properties
- Windows: {Папка SetRetail10}\standalone\configuration\modules\erp-integration\ERPIntegration.properties
фшщвшфш-ыывуывывфыв
Получение информации о чеках и расчетов скидок по ним
| |
Метод | getFullPurchasesByParams |
URL | http://IP-адрес_сервера:8090/SET-ERPIntegration/FiscalInfoExport |
WSDL | http://IP-адрес_сервера:8090/SET-ERPIntegration/FiscalInfoExport?wsdl |
Поле | Тип данных | Описание | Обязательное |
Принимаемые параметры | |||
dateOperDay | Date | Определяет дату, за которую из операционного дня следует выбрать чеки | Да |
shopNumber | Long | Определяет номер магазина, чеки которого из операционного дня следует получить | Нет |
cashNumber | Long | Определяет номер кассы, чеки которой из операционного дня следует получить | Нет |
shiftNumber | Long | Определяет номер смены, чеки которой из операционного дня следует получить | Нет |
purchaseNumber | Long | Определяет номер чека, который из опердня операционного дня получить | Нет |
Возвращаемые параметры | |||
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 |
URL | http://IP-адрес_сервера:8090/SET-ERPIntegration/FiscalInfoExport |
WSDL | http://IP-адрес_сервера:8090/SET-ERPIntegration/FiscalInfoExport?wsdl |
Индекс | Тип данных | Описание | Обязательное |
Принимаемые параметры | |||
0 | Date | Дата, за которую из операционного дня требуется получить новые чеки | Да |
1 | Long | Номер магазина, от которого из операционного дня следует выбрать новые чеки | Нет |
2 | Long | Номер кассы, от которой из операционного дня следует выбрать новые чеки | Нет |
3 | Long | Номер смены, от которой из операционного дня следует выбрать новые чеки | Нет |
4 | Long | Номер чека, от которой из операционного дня следует выбрать новые чеки | Нет |
Возвращаемые параметры | |||
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>
Настройка ограничения размера пачки экспорта чеков для веб-сервиса на стороне SetRetail10
- SRTE-3008Getting issue details... STATUS
- SRTE-2991Getting issue details... STATUS
10.2.92.0
Только для методов:
getNewPurchses(...)
getNewFullPurchases(...)
0 - размер не ограничен
SELECT add_property('SET_ERP_INTEGRATION', 'export.websevice.new.purchases.batch.size', '0', 'Ограничение размера пачки "новых" чеков возвращаемой вебсервисом. 0 - размер не ограничен.');
Методы веб-сервиса для экспорта нефискальных документов
По заданным параметрам | |
---|---|
Метод | getNonFiscalDocsByParams |
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 | Номер нефискального документа | Нет |
type | string | Тип нефискального документа. Поле может быть пустым, но обязательно должно присутствовать в структуре запроса | Да |
status | 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:getNonFiscalDocsByParams> <dateOperDay>2022-05-30</dateOperDay> <!--Optional:--> <shopNumber>1</shopNumber> <!--Optional:--> <cashNumber>1</cashNumber> <!--Optional:--> <shiftNumber>2</shiftNumber> <!--Optional:--> <purchaseNumber>1</purchaseNumber> <type>?</type> <status>all</status> </plug:getNonFiscalDocsByParams> </soapenv:Body> </soapenv:Envelope>
Методы веб-сервиса для экспорта аннулированных чеков
- SRTS-970Getting issue details... STATUS
- CR-8315Getting issue details... STATUS
10.3.15.0
За заданный операционный день | |
Метод | getCancelledPurchasesByOperDay |
URL | http://IP-адрес_сервера:8090/SET-ERPIntegration/FiscalInfoExport |
WSDL | http://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:getCancelledPurchasesByOperDay> <dateOperDay>2022-08-22</dateOperDay> </plug:getCancelledPurchasesByOperDay> </soapenv:Body> </soapenv:Envelope>
Описание формата выгрузки чеков
По заданным параметрам | |
---|---|
Метод | getCancelledPurchasesByParams |
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 | Номер смены | Нет |
cashierTabNo | 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:getCancelledPurchasesByParams> <dateOperDay>2022-08-22</dateOperDay> <shopNumber>3245</shopNumber> <cashNumber>62</cashNumber> <shiftNumber>1</shiftNumber> <cashierTabNo>111</cashierTabNo> </plug:getCancelledPurchasesByParams> </soapenv:Body> </soapenv:Envelope>
Чеки <purchases>
purchases | |||
Наименование элемента | Тип данных | Описание | Обязательное |
purchase | Комплексный | Данные чека | Да |
Наименование атрибута | Тип данных | Описание | Обязательное |
count | Long | Количество передаваемых чеков, т.е. общее количество тегов purchase вложенных в общий тег | Нет |
Состав чека <purchase>
purchases/purchase | |||
Наименование атрибута | Тип данных | Описание | Обязательное |
tabNumber | String | Табельный номер кассира | Нет |
returndayinday | Boolean | Признак для чека возврата "День в день" | Нет |
username | String | Имя кассира | Нет |
operationType | Boolean | Кассовая операция
| Нет |
сashOperationType | Комплексный | Кассовые операции для лотерей Столото НАЧИНАЯ С ВЕРСИИ ВЕБ-СЕРВИСА 1.15 - SRTE-2953Getting issue details... STATUS 10.2.89.0
| Нет |
operDay | Date | Операционный день | Да |
shop | Long | Номер магазина | Да |
cash | Long | Номер кассы | Да |
shift | Long | Номер смены | Да |
number | Long | Номер чека | Да |
saletime | DateTime | Дата/Время продажи | Нет |
begintime | DateTime | Дата создания чека (добавления первого товара) | Нет |
amount | Decimal | Сумма чека | Нет |
discountAmount | Decimal | Сумма скидки на чек | Нет |
inn | String | ИНН юридического лица в смене | Нет |
qrcode | String | Состав QR-кода чека отправленного в ОФД НАЧИНАЯ С ВЕРСИИ ВЕБ-СЕРВИСА 1.7 - SRTE-2915Getting issue details... STATUS 10.2.89.0 | Нет |
fiscalDocNum | String | Нет | |
storno | Boolean | Признак сторнирования (если чек был хотя бы один раз сторнирован) НАЧИНАЯ С ВЕРСИИ ВЕБ-СЕРВИСА 1.9 - SRTE-3562Getting issue details... STATUS - CR-5382Getting issue details... STATUS 10.2.99.0 Данный тип экспорта должен быть активирован. По умолчанию выключен.
Если чек не сторнировался, то данный атрибут не отображается. | Нет |
status | Комплексный | Статус чека НАЧИНАЯ С ВЕРСИИ ВЕБ-СЕРВИСА 1.9 - SRTE-3562Getting issue details... STATUS - CR-5382Getting issue details... STATUS 10.2.99.0 Данный тип экспорта должен быть активирован. По умолчанию выключен.
| Нет |
Наименование элемента | Тип данных | Описание | Обязательное |
positions | Комплексный | Товарные позиции | Да |
payments | Комплексный | Оплаты | Да |
discountCards | Комплексный | Список дисконтных карт, примененных при оплате этого чека | Нет |
card | Комплексный | Список карт, использованных при оплате этой покупки. Фактически более | Нет |
original-purchase | Комплексный | Оригинальный чек продажи для возвратного чека (purchaseType) | Нет |
exciseBottles | Комплексный | Бутылки с акцизными марками | Нет |
presents | Комплексный | Выданные подарки | Нет |
coupons | Комплексный | Выданные купоны - SLS-1290Getting issue details... STATUS - SLS-1295Getting issue details... STATUS - CR-5582Getting issue details... STATUS 10.3.4.0 | Нет |
discount | Комплексный | Список скидок, сработавших в этом чеке | Нет |
discountCard | Комплексный | Список дисконтных карт, примененных при оплате этого чека | Нет |
bonuses | Комплексный | Список бонусных транзакций, проведенных в этом чеке | Нет |
plugin-property | Комплексный | Список "плагинных" (расширенных, не базовых) свойств этого чека. Может отсутствовать. | Нет |
Плагинные свойства чека <plugin-property>
purchases/purchase/plugin-property | |||
Наименование атрибута | Тип данных | Описание | Обязательное |
key | String | Наименование плагинного свойства | Да |
value | String | Значение плагинного свойства | Нет |
Дополнительная информация по мягкому чеку SetKit
- SR-2709Getting issue details... STATUS
10.2.63.0
SetKit ◾️ Дополнительная информация о заказе в чеке
Наименование плагинного свойства | Описание |
sc.num.[ИДЕНТИФИКАТОР_МЯГКОГО_ЧЕКА] | Идентификатор мягкого чека |
value |
<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <purchases count="1"> <purchase tabNumber="5" userName="Admin Admin " operationType="true" operDay="2019-03-05+03:00" shop="3174" cash="1" shift="14" number="6" saletime="2019-03-06T10:56:44.933+03:00" begintime="2019-03-06T10:56:38.862+03:00" amount="46.31" discountAmount="0.0" inn="7802781104"> <plugin-property key="sc.num.88384132" value="Дополнительное сообщение"/> <positions> <position order="1" departNumber="1" goodsCode="1" barCode="5050582541748" count="4.5" cost="10.29" nds="20.0" ndsSum="7.72" discountValue="0.0" costWithDiscount="10.29" amount="46.31" softCheckNumber="88384132" dateCommit="2019-03-06T10:56:38.887+03:00"/> </positions> <payments> <payment typeClass="CashChangePaymentEntity" amount="3.69" description=""/> <payment typeClass="CashPaymentEntity" amount="50.0" description="Оплата наличными"/> </payments> </purchase> </purchases>
<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <purchases count="1"> <purchase tabNumber="1" userName="Администраторов Администратор Администраторович" operationType="true" cashOperation="INCOME" operDay="2021-01-12+03:00" shop="1361" cash="61" shift="1" number="13" saletime="2021-01-13T14:30:04.017+03:00" begintime="2021-01-13T14:29:58.445+03:00" amount="300.0" discountAmount="0.0" inn="7802781104" fiscalDocNum="9;13"> <plugin-property key="externalSystemId" value="13610611610537400465"/> <plugin-property key="sc.num.SK43401740245235" value="order information"/> <plugin-property key="UID_PURCHASE" value="290c1f79-9d4a-4f6b-8f87-c9c575397d87"/> <positions> <position order="1" departNumber="1" goodsCode="00045" barCode="4600045000001" count="1.0" cost="100.0" nds="20.0" ndsSum="16.67" discountValue="0.0" costWithDiscount="100.0" amount="100.0" softCheckNumber="SK43401740245235" dateCommit="2021-01-13T14:29:58.463+03:00" insertType="10"> <plugin-property key="sc.num.SK43401740245235" value="positionOrder=1"/> <plugin-property key="countryName" value="Бельгия"/> </position> <position order="2" departNumber="1" goodsCode="00046" barCode="4600046000000" count="1.0" cost="200.0" nds="20.0" ndsSum="33.33" discountValue="0.0" costWithDiscount="200.0" amount="200.0" softCheckNumber="SK43401740245235" dateCommit="2021-01-13T14:29:58.494+03:00" insertType="10"> <plugin-property key="sc.num.SK43401740245235" value="positionOrder=2"/> <plugin-property key="countryName" value="Бельгия"/> </position> </positions> <payments> <payment typeClass="CashPaymentEntity" amount="300.0" description="Оплата наличными"/> </payments> </purchase> </purchases>
Передача информации о печати, электронной отправке и принудительной печати в составе чека
- SR-4874Getting issue details... STATUS
10.2.99.0
- SR-5018Getting issue details... STATUS
10.3.3.0
Наименование плагинного свойства | Описание |
---|---|
PRINT_DISABLED | Признак фискализации чека без печати (отправка чека электронным способом). Значение по умолчанию: |
PROMO_PRINT_DISABLED | Признак того, что рекламные материалы не были распечатаны. Значение по умолчанию: |
FORCED_PRINT | Признак того, что чек был распечатан принудительно. Значение по умолчанию: |
CLIENT_REQUISITES_TYPE | Тип реквизитов клиента, на которые был отправлен чек (EMAIL, MOBILE_PHONE). Не заполняется если реквизитов нет. |
<purchases count="1"> <purchase tabNumber="1" userName="Администраторов Администратор Администраторович" operationType="true" operDay="2019-06-24+03:00" shop="1782" cash="61" shift="1" number="2" saletime="2019-06-24T14:44:00.924+03:00" begintime="2019-06-24T14:43:29.727+03:00" amount="845.34" discountAmount="1268.04" inn="7802781104"> <plugin-property key="PROMO_PRINT_DISABLED" value="true"/> <plugin-property key="PRINT_DISABLED" value="true"/> <plugin-property key="CLIENT_REQUISITES_TYPE" value="EMAIL"/> <positions> <position order="1" departNumber="351" goodsCode="45633" barCode="4607141313337" count="1.0" cost="28.8" nds="10.0" ndsSum="2.62" discountValue="0.0" costWithDiscount="28.8" amount="28.8" dateCommit="2020-07-27T15:11:02.463+03:00"> <plugin-property key="countryName" value="Россия"/> </position> </positions> <payments> <payment typeClass="CashPaymentEntity" amount="90.0" description="Оплата наличными"/> <payment typeClass="CashChangePaymentEntity" amount="61.2" description=""/> </payments> <card type="EXTERNAL_COUPON" number="12620003"/> </purchase> </purchases>
Данные отложенного чека
- SRTB-5270Getting issue details... STATUS
- CR-5382Getting issue details... STATUS
10.3.1.0
Наименование плагинного свойства | Описание |
PURCHASE_DEFERRED | Признак отложенного чека |
value | Содержание отложенного чека в формате JSON |
Нефискальный документ
ТОЛЬКО ДЛЯ WEB-СЕРВИСА НА СТОРОНЕ SETRETAIL
- SRTE-2318Getting issue details... STATUS
10.2.78.0
- SRTB-5584Getting issue details... STATUS
10.3.7.0
Наименование плагинного свойства | Описание |
NON_FISCAL_DOCUMENT_TYPE | Тип нефискального документа |
value | Значение типа нефискального документа
|
<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <purchases count="1"> <purchase tabNumber="99999" userName="Иванов Пётр " operationType="true" cashOperation="INCOME" operDay="2022-06-02+03:00" shop="42" cash="1" shift="72" number="2" saletime="2022-06-02T14:35:10.578+03:00" begintime="2022-06-02T14:34:26.279+03:00" amount="255.00" discountAmount="0.00" inn="7802781104" status="NONFISCAL"> <plugin-property key="NON_FISCAL_DOCUMENT_TYPE" value="OPEN_UP_TARE"/> <plugin-property key="FISCAL_DOC_ID" value="0"/> <plugin-property key="KPP" value="780201001"/> <positions> <position order="1" departNumber="582" goodsCode="45036" barCode="4607145132030" count="1.000" cost="255.00" nds="20.0" ndsSum="0.00" discountValue="0.00" costWithDiscount="255.00" amount="255.00" dateCommit="2022-06-02T14:35:07.771+03:00" insertType="1"> <plugin-property key="countryName" value="Россия"/> </position> </positions> <payments/> <exciseBottles> <bottle barcode="4607145132030" exciseBarcode="507100000000010118001D5CCFC794963898C1B13E41231CKY42T7UDIJJY2AWLHS7HPGINLMY7PQPDNJALVS42WNCHYRCO257SPCSCF4ASM37BZNTLIASYRVGFUTCXDXDJPML5MMVLEEHZWPWJVI" volume="1.0" price="255.00"/> </exciseBottles> </purchase> </purchases>
Уникальный идентификатор экземпляра чека
- SRTB-4485Getting issue details... STATUS
- CR-2350Getting issue details... STATUS
10.2.91.0
Наименование плагинного свойства | Описание |
UID_PURCHASE | Признак уникального идентификатора чека |
value | Сгенерированное значение уникального идентификатора чека. Пример:
|
Номер документа Пирит РБ
- SRTZ-1091Getting issue details... STATUS
- CR-5567Getting issue details... STATUS
10.3.2.0
Наименование плагинного свойства | Описание |
---|---|
FISCAL_DOC_ID | Сквозной номер чека продажи / чека возврата / чека аннулирования от ФР Пирит РБ Применяется в Республике Беларусь |
<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <purchases count="1"> <purchase tabNumber="1" returndayinday="false" userName="Администраторов Администратор Администраторович" operationType="false" cashOperation="INCOME" operDay="2021-08-23+03:00" shop="2170" cash="60" shift="1" number="6" saletime="2021-08-24T00:36:03.555+03:00" begintime="2021-08-24T00:35:56.445+03:00" amount="10000.55" discountAmount="0.00" inn="7802781104" qrcode="t=20210824T0036&s=10000.55&fn=a0e1a01b-732b-41d1-b0f4-02f12e816163&i=6&fp=0&n=2" fiscalDocNum="6;6" status="REGISTERED"> <plugin-property key="externalSystemId" value="21700601629754558486"/> <plugin-property key="FISCAL_DOC_ID" value="6"/> <plugin-property key="EXCISE_VALIDATION_REQUEST" value="{"id":5,"version":1,"shop":2170,"cash":60,"operationType":1,"checkNumber":"1.6","cancel":false,"creationDate":1629754556445,"productType":1,"data":[{"barcode":"33106180226082","item":"230106","productType":6,"mark":"0133106180226082216Уаw835qtKI0191XP7О92b5TЯЭЖxщNEKИYDiq2Е9TВ3NmUIRUтsЙЮwcT709ЙюбVpк"}]}"/> <plugin-property key="EXCISE_VALIDATION_TYPE" value="SetMarkCentrum"/> <positions> <position order="1" departNumber="1" goodsCode="230106" barCode="33106180226082" count="1.000" cost="10000.55" nds="20.0" ndsSum="1666.76" discountValue="0.00" costWithDiscount="10000.55" amount="10000.55" dateCommit="2021-08-24T00:35:56.460+03:00" insertType="0"> <plugin-property key="rccw" value="276"/> <plugin-property key="countryName" value="Германия"/> <plugin-property key="markValidationResult" value="{"fiscalResult":{"input":{},"tag2106":15,"tag2005":15,"tag2105":0,"tag2109":1},"status":"VALID"}"/> <plugin-property key="gtdNumber" value="1234567"/> <plugin-property key="excise-token" value="0133106180226082216Уаw835qtKI01"/> <plugin-property key="marktype" value="TYRES"/> </position> </positions> <payments> <payment typeClass="CashPaymentEntity" amount="10000.55" description="Оплата наличными"/> </payments> </purchase> </purchases>
Товарные позиции <positions>
purchases/purchase/positions | |||
Наименование элемента | Тип данных | Описание | Обязательное |
position | String | Позиции чека | Да |
Товарная позиция <position>
purchases/purchase/positions/position | |||
Наименование атрибута | Тип данных | Описание | Обязательное |
order | Long | Номер позиции | Да |
departNumber | Long | Номер отдела | Да |
goodsCode | String | Код товара Начиная с версии 10.2.96.0, для отдельных типов банковских операций проставляется значение
| Да |
barCode | String | ШК товара | Да |
count | Decimal | Количество | Да |
cost | Decimal | Цена за единицу | Да |
nds | Decimal | Значение НДС | Да |
ndsClass | String | Наименование налога | Да |
ndsSum | Decimal | Сумма НДС | Да |
discountValue | Decimal | Сумма скидки | Да |
costWithDiscount | Decimal | Цена за единицу с учётом скидки | Да |
amount | Decimal | Стоимость позиции | Да |
softCheckNumber | String | Номер мягкого чека | Нет |
dateCommit | DateTime | Дата/время добавления позиции | Да |
insertType | Integer | Способ добавления позиции
| Нет |
Наименование элемента | Тип данных | Описание | |
plugin-property | Комплексный | Плагинные свойства товара | Нет |
Плагинные свойства товара <plugin-property>
purchases/purchase/positions/position/plugin-property | |||
Наименование атрибута | Тип данных | Описание | Обязательное |
key | String | Наименование плагинного свойства | Да |
value | String | Значение плагинного свойства | Нет |
Подарочная карта
Наименование плагинного свойства | Описание |
gift.card.number | Номер подарочной карты |
Дисконтная карта
Наименование плагинного свойства | Описание |
---|---|
card.number | Номер дисконтной карты |
Подарочная карта ЦФТ
Наименование плагинного свойства | Описание |
transactionAmount | Сумма гашения карты |
activationTransactionId | Внешний идентификатор |
activationDateTime | Дата и время выполнения транзакции |
clientIDType | Тип идентификатора карты в транзакции (clientIDType 2 – track2; 4 – barcode) |
clientID | Идентификатор карты в транзакции |
partnerID | Идентификатор партнера |
location | Идентификатор точки |
terminal | Идентификатор терминала |
Ветеринарный контроль
- SRTE-961Getting issue details... STATUS
10.2.35.0
positions/position/plugin-property/plugin-property | |||
Наименование атрибута | Тип данных | Описание | Обязательное |
plugin-property | String |
Дата производства для позиции value в формате yyyy-MM-dd HH:mm | Нет |
plugin-property | String |
Количество товара в позиции с указанной датой производства value в формате double | Да для плагинного свойства верхнего уровня |
<plugin-property key="productionDate" value ="2017-01-01" > <plugin-property key="count" value ="1.0" / > </plugin-property>
Продавцы
Наименование плагинного свойства | Описание |
seller | Код продавца |
<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <purchases count="1"> <purchase tabNumber="11" userName="Иванов1 ИванTest1 Иванович" operationType="true" operDay="2019-02-28+03:00" shop="3382" cash="1" shift="25" number="5" saletime="2019-02-28T13:29:48.715+03:00" begintime="2019-02-28T13:29:33.350+03:00" amount="64.8" discountAmount="0.0" inn="781234567890"> <positions> <position order="1" departNumber="583" goodsCode="45034" barCode="4810167000258" count="2.0" cost="18.0" nds="20.0" ndsSum="6.0" discountValue="0.0" costWithDiscount="18.0" amount="36.0" dateCommit="2019-02-28T13:29:37.222+03:00"> <plugin-property key="seller" value="102"/> </position> <position order="2" departNumber="583" goodsCode="45033" barCode="4607141310331" count="1.0" cost="28.8" nds="10.0" ndsSum="2.62" discountValue="0.0" costWithDiscount="28.8" amount="28.8" dateCommit="2019-02-28T13:29:41.926+03:00"> <plugin-property key="seller" value="345"/> </position> </positions> <payments> <payment typeClass="CashPaymentEntity" amount="65.0" description="Оплата наличными"/> <payment typeClass="CashChangePaymentEntity" amount="0.2" description=""/> </payments> </purchase> </purchases>
Признак ручного изменения цены товара
10.2.66.0
- SRTE-2018Getting issue details... STATUS
Наименование плагинного свойства | Описание |
beforeManualPrice | Цена товара перед изменением |
Причина изменения цены товара
10.2.70.0
- SRTB-3193Getting issue details... STATUS
Наименование плагинного свойства | Описание |
changePriceReason | Код причины изменения товара |
<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <purchases count="1"> <purchase tabNumber="2" userName="Петрова Лидия Борисовна" operationType="true" operDay="2019-08-01+03:00" shop="3382" cash="1" shift="39" number="3" saletime="2019-08-01T18:22:00.842+03:00" begintime="2019-08-01T18:21:47.862+03:00" amount="15.0" discountAmount="0.0" inn="123456789000"> <positions> <position order="1" departNumber="583" goodsCode="45034" barCode="4810167000258" count="1.0" cost="15.0" nds="20.0" ndsSum="2.5" discountValue="0.0" costWithDiscount="15.0" amount="15.0" dateCommit="2019-08-01T18:21:47.908+03:00"> <plugin-property key="seller" value="102"/> <plugin-property key="beforeManualPrice" value="18.00"/> <plugin-property key="countryName" value="Россия"/> <plugin-property key="changePriceReason" value="1"/> </position> </positions> <payments> <payment typeClass="CashChangePaymentEntity" amount="5.0" description=""/> <payment typeClass="CashPaymentEntity" amount="20.0" description="Оплата наличными"/> </payments> </purchase> </purchases>
Комплект товаров
10.2.75.0
- SRTE-2338Getting issue details... STATUS
Наименование плагинного свойства | Описание |
kitBarcode | Штрих-код комплекта товаров |
Комплект, как отдельная позиция, в таблице позиций чека - не сохраняется.
Товары, входящие в комплект, сохраняются в таблице позиций чека как самостоятельные товары, но с обязательным сохранением ссылки на комплект.
Самостоятельные товары, совпадающие с товарами входящими в комплект, не группируются и сохраняются отдельными позициями.
<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <purchases count="1"> <purchase tabNumber="2123123123" userName="Иванов Иван Иванович" operationType="true" operDay="2019-11-06+03:00" shop="3382" cash="1" shift="59" number="4" saletime="2019-11-07T11:34:03.130+03:00" begintime="2019-11-07T11:33:51.348+03:00" amount="603.6" discountAmount="0.0" inn="123456789000"> <positions> <position order="3" departNumber="583" goodsCode="45034" barCode="4810167000258" count="1.0" cost="18.0" nds="20.0" ndsSum="3.0" discountValue="0.0" costWithDiscount="18.0" amount="18.0" dateCommit="2019-11-07T11:33:54.821+03:00"> <plugin-property key="kitBarcode" value="111111"/> <plugin-property key="countryName" value="Россия"/> </position> <position order="1" departNumber="583" goodsCode="45033" barCode="4607141310331" count="2.0" cost="40.8" nds="10.0" ndsSum="7.42" discountValue="0.0" costWithDiscount="40.8" amount="81.6" dateCommit="2019-11-07T11:33:51.459+03:00"> <plugin-property key="kitBarcode" value="111111"/> <plugin-property key="countryName" value="Россия"/> </position> <position order="2" departNumber="582" goodsCode="45035" barCode="4607145132038" count="3.0" cost="168.0" nds="20.0" ndsSum="84.0" discountValue="0.0" costWithDiscount="168.0" amount="504.0" dateCommit="2019-11-07T11:33:54.696+03:00"> <plugin-property key="kitBarcode" value="111111"/> <plugin-property key="countryName" value="Россия"/> </position> </positions> <payments> <payment typeClass="CashChangePaymentEntity" amount="96.4" description=""/> <payment typeClass="CashPaymentEntity" amount="700.0" description="Оплата наличными"/> </payments> </purchase> </purchases>
Datamatrix-код (маркированные товары)
10.2.86.0
- SRTE-2734Getting issue details... STATUS
Наименование плагинного свойства | Описание |
excise-token | Datamatrix-код |
Тип акцизной продукции
10.2.86.0
- SRTE-2734Getting issue details... STATUS
Наименование плагинного свойства | Описание |
marktype | Тип акцизной продукции |
|
?xml version="1.0" encoding="UTF-8" standalone="yes"?> <purchases count="1"> <purchase tabNumber="28793" userName="Магомедова Марем Магашариповна" operationType="true" operDay="2019-08-13+03:00" shop="17007" cash="2" shift="106" number="204" saletime="2019-08-13T19:11:53.822+03:00" begintime="2019-08-13T19:11:28.123+03:00" amount="160.8" discountAmount="0.0" denyPrintToDocuments="false" clientType="PRIVATE"> <positions> <position order="1" departNumber="1" goodsCode="1913002" barCode="4602073082011" count="1.0" cost="16.6" nds="20.0" ndsSum="2.77" discountValue="0.0" costWithDiscount="16.6" amount="16.6" insertType="0"/> <position order="2" departNumber="1" goodsCode="1913001" barCode="4602073083575" count="1.0" cost="16.6" nds="20.0" ndsSum="2.77" discountValue="0.0" costWithDiscount="16.6" amount="16.6" insertType="0"/> <position order="3" departNumber="1" goodsCode="1913000" barCode="4602073082028" count="1.0" cost="16.6" nds="20.0" ndsSum="2.77" discountValue="0.0" costWithDiscount="16.6" amount="16.6" insertType="0"/> <position order="4" departNumber="1" goodsCode="2100093" barCode="46129185" count="1.0" cost="111.0" nds="20.0" ndsSum="18.5" discountValue="0.0" costWithDiscount="111.0" amount="111.0" insertType="0"> <plugin-property key="excise-token" value="000000461291855qUx5yJAB680Dqe"/> <plugin-property key="marktype" value="alcohol"/> </position> </positions> <payments> <payment typeClass="CashChangePaymentEntity" amount="839.2" description=""/> <payment typeClass="CashPaymentEntity" amount="1000.0" description="Оплата наличными"/> </payments> <discountCards/> <bonus-discount/> </purchase> </purchases>
<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <purchases count="1"> <purchase tabNumber="1" userName="Иванов Иван Иванович" operationType="true" operDay="2020-07-24+03:00" shop="3382" cash="1" shift="81" number="6" saletime="2020-07-24T17:27:00.726+03:00" begintime="2020-07-24T17:26:54.855+03:00" amount="2800.8" discountAmount="0.0" inn="7802781104"> <positions> <position order="1" departNumber="583" goodsCode="45099" barCode="4650075190159" count="1.0" cost="2800.8" nds="10.0" ndsSum="254.62" discountValue="0.0" costWithDiscount="2800.8" amount="2800.8" dateCommit="2020-07-24T17:26:54.862+03:00" insertType="1"> <plugin-property key="countryName" value="Россия"/> <plugin-property key="excise-token" value="01046500751901592109470cde93154240640191ffd092JgVQ/q9XiEi7/Nbqz9po4N/aiw8cG7op8LPwU03vLPbn+G0dZNRQQu6cDqlCYQWPtBxY+3cqJgd2caC1VuStIg=="/> <plugin-property key="marktype" value="footwear"/> </position> </positions> <payments> <payment typeClass="CashPaymentEntity" amount="2900.0" description="Оплата наличными"/> <payment typeClass="CashChangePaymentEntity" amount="99.2" description=""/> </payments> </purchase> </purchases>
Товары социальной значимости (Мегар)
10.2.84.0
- SRTB-4203Getting issue details... STATUS
Наименование плагинного свойства | Описание |
social | Продукт социальный |
socialPayPossible | Продукт можно оплатить социальной картой |
mptProductCode | Код продукта или группы установленный МинПромТоргом Код продукта или группы соответствии с классификатором МЕГАР |
mptProductName | Наименование продукта или группы установленное МинПромТоргом Наименование продукта или группы в соответствии с классификатором МЕГАР |
mptMeasureCode | Код единицы измерения установленный МинПромТоргом Код единицы измерения в соответствии с классификатором МЕГАР |
mptQuantity | Количество в ед.измерения установленных МинПромТоргом Количество в единице измерения установленныез в соответствии с классификатором МЕГАР |
Признак передачи кода товара в ОФД для СИЗ (Средства индивидуальной защиты)
10.2.86.0
- SRTB-4261Getting issue details... STATUS
Наименование плагинного свойства | Описание |
ofdCode | Штрих-код товара для передачи в ОФД |
ofdCodeMandatory | Признак передачи кода товара в ОФД |
<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <purchases count="1"> <purchase tabNumber="1" userName="Иванов Иван Иванович" operationType="true" operDay="2020-07-27+03:00" shop="3382" cash="1" shift="82" number="3" saletime="2020-07-27T15:11:08.186+03:00" begintime="2020-07-27T15:11:02.388+03:00" amount="28.8" discountAmount="0.0" inn="7802781104"> <positions> <position order="1" departNumber="351" goodsCode="45633" barCode="4607141313337" count="1.0" cost="28.8" nds="10.0" ndsSum="2.62" discountValue="0.0" costWithDiscount="28.8" amount="28.8" dateCommit="2020-07-27T15:11:02.463+03:00"> <plugin-property key="ofdCode" value="4607141313337"/> <plugin-property key="ofdCodeMandatory" value="true"/> <plugin-property key="countryName" value="Россия"/> </position> </positions> <payments> <payment typeClass="CashPaymentEntity" amount="90.0" description="Оплата наличными"/> <payment typeClass="CashChangePaymentEntity" amount="61.2" description=""/> </payments> </purchase> </purchases>
Налог с продаж (НСП)
10.2.98.0
- SR-4735Getting issue details... STATUS
Наименование плагинного свойства | Описание |
---|---|
salesTaxSum | Налог с продаж (НСП) Применяется в Киргизии |
Признак прослеживаемого и импортного товара
- SRTB-5063Getting issue details... STATUS
- CR-5651Getting issue details... STATUS
10.2.99.0
Наименование плагинного свойства | Описание |
---|---|
traceable | Признак к товару, подлежащему прослеживаемости РНПТ (регистрационный номер партии товара) |
declared | Признак к товару, импортированному или экспортированному (ДТ, ранее ГТД) ДТ - декларация на товар. |
<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <purchases count="1"> <purchase tabNumber="1" userName="Администраторов Администратор Администраторович" operationType="true" cashOperation="INCOME" operDay="2021-05-17+03:00" shop="2240" cash="61" shift="1" number="4" saletime="2021-05-17T13:32:15.868+03:00" begintime="2021-05-17T13:31:55.870+03:00" amount="601.00" discountAmount="0.00" inn="7802781104" fiscalDocNum="4;4"> <plugin-property key="externalSystemId" value="22400611621247532159"/> <plugin-property key="UID_PURCHASE" value="c200e05d-b0ab-4994-be09-5513756e7431"/> <positions> <position order="2" departNumber="1" goodsCode="25555555558" barCode="25555555558" count="1.000" cost="300.50" nds="20.0" ndsSum="50.08" discountValue="0.00" costWithDiscount="300.50" amount="300.50" dateCommit="2021-05-17T13:32:10.148+03:00" insertType="1"> <plugin-property key="traceable" value="true"/> </position> <position order="1" departNumber="1" goodsCode="87777771" barCode="87777771" count="1.000" cost="300.50" nds="20.0" ndsSum="50.08" discountValue="0.00" costWithDiscount="300.50" amount="300.50" dateCommit="2021-05-17T13:31:55.876+03:00" insertType="1"> <plugin-property key="declared" value="true"/> </position> </positions> <payments> <payment typeClass="CashPaymentEntity" amount="601.0" description="Оплата наличными"/> </payments> </purchase> </purchases>
Признак передачи ГТД
10.3.2.0
- SRTB-5394Getting issue details... STATUS
- SRTB-5203Getting issue details... STATUS
Наименование плагинного свойства | Описание |
---|---|
rccw | Код из общероссийского классификатора стран мира/Код страны происхождения |
gtdNumber | Номер Таможенной Декларации |
<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <purchases count="1"> <purchase tabNumber="1" returndayinday="false" userName="Администраторов Администратор Администраторович" operationType="false" cashOperation="INCOME" operDay="2021-08-23+03:00" shop="2170" cash="60" shift="1" number="6" saletime="2021-08-24T00:36:03.555+03:00" begintime="2021-08-24T00:35:56.445+03:00" amount="10000.55" discountAmount="0.00" inn="7802781104" qrcode="t=20210824T0036&s=10000.55&fn=a0e1a01b-732b-41d1-b0f4-02f12e816163&i=6&fp=0&n=2" fiscalDocNum="6;6" status="REGISTERED"> <plugin-property key="externalSystemId" value="21700601629754558486"/> <plugin-property key="FISCAL_DOC_ID" value="6"/> <plugin-property key="EXCISE_VALIDATION_REQUEST" value="{"id":5,"version":1,"shop":2170,"cash":60,"operationType":1,"checkNumber":"1.6","cancel":false,"creationDate":1629754556445,"productType":1,"data":[{"barcode":"33106180226082","item":"230106","productType":6,"mark":"0133106180226082216Уаw835qtKI0191XP7О92b5TЯЭЖxщNEKИYDiq2Е9TВ3NmUIRUтsЙЮwcT709ЙюбVpк"}]}"/> <plugin-property key="EXCISE_VALIDATION_TYPE" value="SetMarkCentrum"/> <positions> <position order="1" departNumber="1" goodsCode="230106" barCode="33106180226082" count="1.000" cost="10000.55" nds="20.0" ndsSum="1666.76" discountValue="0.00" costWithDiscount="10000.55" amount="10000.55" dateCommit="2021-08-24T00:35:56.460+03:00" insertType="0"> <plugin-property key="rccw" value="276"/> <plugin-property key="countryName" value="Германия"/> <plugin-property key="markValidationResult" value="{"fiscalResult":{"input":{},"tag2106":15,"tag2005":15,"tag2105":0,"tag2109":1},"status":"VALID"}"/> <plugin-property key="gtdNumber" value="1234567"/> <plugin-property key="excise-token" value="0133106180226082216Уаw835qtKI01"/> <plugin-property key="marktype" value="TYRES"/> </position> </positions> <payments> <payment typeClass="CashPaymentEntity" amount="10000.55" description="Оплата наличными"/> </payments> </purchase> </purchases>
ФФД 1.2 - Результат валидации марки (Результат проверки КМ в ФР)
10.2.99.0
- SRTB-754Getting issue details... STATUS
- CR-5247Getting issue details... STATUS
Наименование плагинного свойства | Описание |
---|---|
markValidationResult | Результат валидации марки (Результат проверки КМ в ФР) Пример: <plugin-property key="markValidationResult" value="{ "fiscalResult":{"input":{}, "tag2106":15, "tag2005":15, "tag2105":0, "tag2109":1}, "status":"VALID" }"/> |
<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <purchases count="1"> <purchase tabNumber="1" returndayinday="false" userName="Администраторов Администратор Администраторович" operationType="false" cashOperation="INCOME" operDay="2021-08-23+03:00" shop="2170" cash="60" shift="1" number="6" saletime="2021-08-24T00:36:03.555+03:00" begintime="2021-08-24T00:35:56.445+03:00" amount="10000.55" discountAmount="0.00" inn="7802781104" qrcode="t=20210824T0036&s=10000.55&fn=a0e1a01b-732b-41d1-b0f4-02f12e816163&i=6&fp=0&n=2" fiscalDocNum="6;6" status="REGISTERED"> <plugin-property key="externalSystemId" value="21700601629754558486"/> <plugin-property key="FISCAL_DOC_ID" value="6"/> <plugin-property key="EXCISE_VALIDATION_REQUEST" value="{"id":5,"version":1,"shop":2170,"cash":60,"operationType":1,"checkNumber":"1.6","cancel":false,"creationDate":1629754556445,"productType":1,"data":[{"barcode":"33106180226082","item":"230106","productType":6,"mark":"0133106180226082216Уаw835qtKI0191XP7О92b5TЯЭЖxщNEKИYDiq2Е9TВ3NmUIRUтsЙЮwcT709ЙюбVpк"}]}"/> <plugin-property key="EXCISE_VALIDATION_TYPE" value="SetMarkCentrum"/> <positions> <position order="1" departNumber="1" goodsCode="230106" barCode="33106180226082" count="1.000" cost="10000.55" nds="20.0" ndsSum="1666.76" discountValue="0.00" costWithDiscount="10000.55" amount="10000.55" dateCommit="2021-08-24T00:35:56.460+03:00" insertType="0"> <plugin-property key="rccw" value="276"/> <plugin-property key="countryName" value="Германия"/> <plugin-property key="markValidationResult" value="{"fiscalResult":{"input":{},"tag2106":15,"tag2005":15,"tag2105":0,"tag2109":1},"status":"VALID"}"/> <plugin-property key="gtdNumber" value="1234567"/> <plugin-property key="excise-token" value="0133106180226082216Уаw835qtKI01"/> <plugin-property key="marktype" value="TYRES"/> </position> </positions> <payments> <payment typeClass="CashPaymentEntity" amount="10000.55" description="Оплата наличными"/> </payments> </purchase> </purchases>
ERP ClientID из Siebel CRM
10.3.12.0
- SR-5348Getting issue details... STATUS
- CR-6702Getting issue details... STATUS
Наименование плагинного свойства | Описание |
---|---|
SIEBEL_CLIENT_ID | Идентификатор клиента в Siebel CRM |
Оплаты <payments>
purchases/purchase/payments | |||
Наименование атрибута | Тип данных | Описание | Обязательное |
payment | Комплексный | Список типов оплат | Да |
Тип оплаты <payment>
purchases/purchase/payments/payment | |||
Наименование атрибута | Тип данных | Описание | Обязательное |
typeClass | String | Тип оплаты:
| Да |
amount | Decimal | сумма | Да |
description | String | описание | Да |
Наименование элемента | Тип данных | Описание | Обязательное |
plugin-property | Комплексный | Плагинные свойства оплаты | Да |
Плагинные свойства оплаты <plugin-property>
purchases/purchase/payments/payment/plugin-property | |||
Наименование атрибута | Тип данных | Описание | Обязательное |
key | String | Наименование плагинного свойства | Да |
value | String | Значение плагинного свойства | Нет |
Банковская карта
Наименование плагинного свойства | Описание |
cash.transaction.id | Номер транзакции |
terminal.number | Номер терминала |
cash.transaction.date | Дата и время выполнения транзакции |
bank.slip | Полный текст банковского слипа в формате BASE64 - SRTE-3404Getting issue details... STATUS - CR-5316Getting issue details... STATUS 10.2.97.0 Для включения экспорта текста банковского слипа выполните скрипт в базе данных сервера set → перезапустите службу сервера приложений JBOSS_SVC. UPDATE public.sales_management_properties SET property_value='true', WHERE property_key='need.send.bankslip.toERPI'; Пример экспорта текста банковского слипа. |
bank.id | Название банка/процессинга |
card.type | Тип карты |
auth.code | Код авторизации |
bank.type | Тип банка-эмитента (для программы «Спасибо от Сбербанка») |
card.number | Номер карты (маскированный) |
card.hash | Хэш-код карты (для программы «Спасибо от Сбербанка») |
ref.number | |
cashout.amount | - CR-3746Getting issue details... STATUS 10.2.96.0 Сумма выдачи наличных Подробнее в SetRetail10 ◾️ Mastercard ◾️ Выдача наличных на кассе. |
loyalty.program.code | Код банковской программы лояльности |
card.number.hash | Хэш-код номера карты |
<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <purchases count="1"> <purchase tabNumber="1" userName="Администраторов Администратор Администраторович" operationType="true" operDay="2019-06-24+03:00" shop="1782" cash="61" shift="1" number="2" saletime="2019-06-24T14:44:00.924+03:00" begintime="2019-06-24T14:43:29.727+03:00" amount="845.34" discountAmount="1268.04" inn="7802781104"> <plugin-property key="externalSystemId" value="17820611561376626271"/> <positions> <position order="2" departNumber="1" goodsCode="03001" barCode="4903001000009" count="3.0" cost="404.23" nds="20.0" ndsSum="80.85" discountValue="727.62" costWithDiscount="161.69" amount="485.07" dateCommit="2019-06-24T14:43:32.504+03:00"> <plugin-property key="countryName" value="Япония"/> </position> <position order="1" departNumber="1" goodsCode="02003" barCode="8402003000001" count="3.0" cost="300.23" nds="20.0" ndsSum="60.05" discountValue="540.42" costWithDiscount="120.09" amount="360.27" dateCommit="2019-06-24T14:43:29.745+03:00"> <plugin-property key="countryName" value="Испания"/> </position> </positions> <payments> <payment typeClass="BankCardPaymentEntity" amount="345.34" description="Оплата по банковской карте"> <plugin-property key="card.hash" value="null"/> <plugin-property key="cash.transaction.id" value="105010"/> <plugin-property key="terminal.number" value="10000001"/> <plugin-property key="cash.transaction.date" value="2019-06-24 14:43:59.860"/> <plugin-property key="bank.id" value="Сбербанк"/> <plugin-property key="ref.number" value="961275736427"/> <plugin-property key="card.type" value="VISA"/> <plugin-property key="auth.code" value="255202"/> <plugin-property key="bank.type" value="UNKNOWN"/> <plugin-property key="card.number" value="************7438"/> </payment> <payment typeClass="CashPaymentEntity" amount="500.0" description="Оплата наличными"/> </payments> <discountCards> <discountCard>12620003</discountCard> </discountCards> <card type="INTERNAL" number="12620003"/> </purchase> </purchases>
Оплата QR-кодом
<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <purchases count="1"> <purchase returndayinday="true" tabNumber="09876" userName="Иванов Станислав Тарасович" operationType="false" operDay="2020-08-12+03:00" shop="234" cash="9" shift="1" number="5" saletime="2020-08-12T15:41:59.501+03:00" begintime="2020-08-12T15:41:53.081+03:00" amount="0.16" discountAmount="0.03" inn="7802781104"> <positions> <position order="1" departNumber="581" goodsCode="45032" barCode="2300169" count="0.001" cost="189.7" nds="20.0" ndsSum="0.03" discountValue="0.03" costWithDiscount="160.0" amount="0.16" dateCommit="2020-08-12T15:41:53.090+03:00"> <plugin-property key="countryName" value="Россия"/> </position> </positions> <payments> <payment typeClass="BankQRPaymentEntity" amount="0.16" description="Оплата по QR-коду"> <plugin-property key="sberbank_qr.id.qr" value="20306"/> <plugin-property key="terminal.number" value="21342923"/> <plugin-property key="cash.transaction.id" value="105020"/> <plugin-property key="cash.transaction.date" value="2020-08-12 15:42:02.000"/> <plugin-property key="bank.id" value="QR Сбербанк"/> <plugin-property key="ref.number" value="302602845102"/> <plugin-property key="merchant.id" value="00000016"/> <plugin-property key="order.id" value="2a6e1853f94b4fcfa8ca941eaf8b4a1a"/> <plugin-property key="operation.id" value="3582a60bcc9b4b449b7928dea912f035"/> <plugin-property key="auth.code" value="845102"/> </payment> </payments> <original-purchase operDay="2020-08-12+03:00" shop="234" cash="9" shift="1" number="4" saletime="2020-08-12T15:41:07.364+03:00"/> </purchase> </purchases>
<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <purchases count="1"> <purchase tabNumber="333" userName="Петрова Лидия Ивановна" operationType="true" operDay="2020-08-12+03:00" shop="234" cash="1" shift="2" number="12" saletime="2020-08-12T21:14:16.402+03:00" begintime="2020-08-12T21:13:37.725+03:00" amount="50.0" discountAmount="0.0" inn="7801111101"> <positions> <position order="1" departNumber="583" goodsCode="45033" barCode="4607141310331" count="1.0" cost="50.0" nds="10.0" ndsSum="4.55" discountValue="0.0" costWithDiscount="50.0" amount="50.0" dateCommit="2020-08-12T21:13:37.732+03:00"> <plugin-property key="countryName" value="Россия"/> </position> </positions> <payments> <payment typeClass="BankQRPaymentEntity" amount="50.0" description="Оплата по QR-коду"> <plugin-property key="cash.transaction.id" value="110060"/> <plugin-property key="cash.transaction.date" value="2020-08-12 21:13:45.432"/> <plugin-property key="bank.id" value="Райффайзенбанк СБП"/> <plugin-property key="merchant.id" value="MA0000002371"/> <plugin-property key="order.id" value="6493ec4e-8f96-4d8b-a1a4-166dddef17e6"/> <plugin-property key="operation.id" value="24430"/> </payment> </payments> </purchase> </purchases>
Внешний банковский терминал
Наименование плагинного свойства | Описание |
purchase.number | Номер чека терминала |
card.number | Последние 4 цифры номера карты |
auth.code | Код авторизации |
Потребительский кредит
Наименование плагинного свойства | Описание |
contract.bank | Название банка |
contract.bank.product | Название продукта банка |
consumer.name | Имя клиента |
contract.number | Номер договора |
Подарочная карта
Наименование плагинного свойства | Описание |
gift.card.number | Номер подарочной карты |
Подарочная карта ЦФТ
Наименование плагинного свойства | Описание |
amount | Сумма активации карты |
activationTransactionId | Внешний идентификатор |
activationDateTime | Дата и время выполнения транзакции |
clientIDType | Тип идентификатора карты в транзакции (clientIDType 2 – track2; 4 – barcode) |
clientID | Идентификатор карты в транзакции |
partnerID | Идентификатор партнера |
location | Идентификатор точки |
terminal | Идентификатор терминала |
Список карт, примененных в чеке <discountCards>
purchases/purchase/discountCards/discountCard | |||
Наименование элемента | Тип данных | Описание | Обязательное |
discountCard | String | Номер карты | Нет |
Подробная информация по картам, примененным в чеке <card>
purchases/purchase/card | |||
Наименование аттрибута | Тип данных | Описание | Обязательное |
type | String | Тип карты:
| Нет |
number | String | Номер карты | Да |
guid | String | GUID карты | Нет |
addedBy | String | Способ добавления карты/купона - SLS-1290Getting issue details... STATUS - CR-5582Getting issue details... STATUS 10.3.4.0
| Нет |
Ссылка на оригинальный чек продажи <original-purchase>
Заполняется только для чеков возврата: хранит ссылку на оригинальный чек продажи.
purchases/purchase/original-purchase | |||
Наименование атрибута | Тип данных | Описание | Обязательное |
tabNumber | String | Табельный номер кассира | Нет |
returndayinday | Boolean | Признак для чека возврата "День в день" | Нет |
username | String | Имя кассира | Нет |
operationType | Boolean | Тип операции | Нет |
operDay | Date | Операционный день | Да |
shop | Long | Номер магазина | Да |
cash | Long | Номер кассы | Да |
shift | Long | Номер смены | Да |
number | Long | Номер чека | Да |
saletime | DateTime | Дата/Время продажи | Нет |
begintime | DateTime | Дата создания чека (добавления первого товара) | Нет |
amount | Decimal | Сумма чека | Нет |
discountAmount | Decimal | Сумма скидки на чек | Нет |
inn | String | ИНН юридического лица в смене | Нет |
Алкогольные позиции с акцизными марками <exciseBottles>
purchases/purchase/exciseBottles | |||
Наименование атрибута | Тип данных | Описание | Обязательное |
barcode | String | Штрих-код алкогольного товара | Нет |
exciseBarcode | String | Штрих-код акцизной марки бутылки | Нет |
setBarcode | String | Штрих-код промонабора, в составе которого была продана бутылка | Нет |
volume | Double | Объем бутылки | Нет |
price | Decimal | Цена бутылки | Нет |
Список скидок <discount>
purchases/purchase/discount | |||
Наименование аттрибута | Тип данных | Описание | Обязательное |
positionId | Long | Порядковый номер позиции на которую распространяется данная скидка, если 0-то скидка на чек | Да |
goodCode | String | Код товара (из позиции) по которой было начисление | Нет |
amount | Decimal | Сумма скидки (по позиции/чеку), в "рублях" | Да |
isDiscountPurchase | Boolean | Признак того что скидка распространяется на весь чек | Да |
AdvertActGUID | Long | Идентификатор рекламной акции | Да |
AdvertActExternalCode | String | Внешний код рекламной акции | Нет |
AdvertActDiscountType | String | Тип скидки. Также с точки зрения Set5
| Нет |
advertType | String | Тип/характер применённой скидки Возможные значения:
| Да |
quantity | Decimal | Количество товара, на которое сработала скидка | Нет |
card-number | String | Номер карты (или купона), по которому сработала скидка на эту позицию | Нет |
transactionId | String | Идентификатор транзакции списания бонусов (если скидка была бонусной CFT или Spasibo) | Нет |
externalActionId | String | Идентификатор акции внешней системы | Нет |
Список дисконтных карт <discountCard>
purchases/purchase/discountCard | |||
Наименование элемента | Тип данных | Описание | Обязательное |
discountCard | String | Список дисконтных карт, примененных при оплате этого чека | Нет |
Список бонусных транзакций <bonuses>
purchases/purchase/bonuses | |||
Наименование элемента | Тип данных | Описание | Обязательное |
chargeOnBonuses | Комплексный | Список бонусных транзакций начисления, проведенных в этом чеке | Нет |
writeOffBonuses | Комплексный | Список бонусных транзакций списания, проведенных в этом чеке | Нет |
Транзакции начисления <chargeOnBonuses>
purchases/purchase/bonuses/chargeOnBonuses | |||
Наименование элемента | Тип данных | Описание | Обязательное |
transactionId | String | Идентификатор транзакции | Да |
bonusesType | String | Тип бонусного процессинга Возможные значения:
| Да |
amount | Decimal | Сумма транзакции | Да |
cardNumber | String | Номер карты | Да |
bonusaccountsid | Long | ID бонусного счета | Нет |
AdvertActExternalCode | String | Внешний код Акции | Нет |
AdvertActDiscountType | String | Код типа акции | Нет |
AdvertActGUID | Long | GUID акции | Нет |
Транзакции списания <writeOffBonuses>
purchases/purchase/bonuses/writeOffBonuses | |||
Наименование элемента | Тип данных | Описание | Обязательное |
transactionId | String | Идентификатор транзакции | Да |
bonusesType | String | Тип бонусного процессинга | Да |
amount | Decimal | Сумма транзакции | Да |
cardNumber | String | Номер карты | Да |
bonusaccountsid | Long | ID бонусного счета | Нет |
AdvertActExternalCode | String | Внешний код Акции | Нет |
AdvertActDiscountType | String | Код типа акции | Нет |
AdvertActGUID | Long | GUID акции | Нет |
Плагинные свойства чека <plugin-property>
purchases/purchase/plugin-property | |||
Наименование атрибута | Тип данных | Описание | Обязательное |
key | String | Наименование плагинного свойства | Да |
value | String | Значение плагинного свойства | Нет |
Выданные подарки <presents>
purchases/purchase/presents | |||
Наименование аттрибута | Тип данных | Описание | Обязательное |
actionname | String | Название акции, в рамках которой был выдан подарок | Нет |
externalcode | String | Внешний код акции, в рамках которой был выдан подарок | Нет |
guid | String | GUID акции, в рамках которой был выдан подарок | Нет |
issued | Integer | Общее количество выданных подарков | Нет |
scanned | Integer | Общее количество просканированных подарков | Нет |
Наименование элемента | Тип данных | Описание | Обязательное |
present | Комлексный | Список подарков | Нет |
actionLabels | Комплексный | Метки рекламной акции | Нет |
<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <purchases count="1"> <purchase tabNumber="11" userName="Иванов1 ИванTest1 Иванович" operationType="true" operDay="2018-08-13+03:00" shop="3382" cash="1" shift="1" number="11" saletime="2018-08-14T12:55:27.927+03:00" begintime="2018-08-14T12:55:11.346+03:00" amount="66.5" discountAmount="3.5" denyPrintToDocuments="false" clientType="PRIVATE"> <positions> <position order="1" departNumber="583" goodsCode="45034" barCode="4810167000258" count="7.0" cost="10.0" nds="18.0" ndsSum="10.14" discountValue="3.5" costWithDiscount="9.5" amount="66.5" insertType="1"/> </positions> <payments> <payment typeClass="CashPaymentEntity" amount="80.0" description="Оплата наличными"/> <payment typeClass="CashChangePaymentEntity" amount="13.5" description=""/> </payments> <discounts> <discount positionId="1" goodCode="45034" amount="3.5" isDiscountPurchase="false" AdvertActGUID="2601" AdvertActExternalCode="SR10_2448" advertType="DISCOUNT" AdvertActDiscountType="9" card-number="" quantity="7.0"/> </discounts> <discountCards/> <bonus-discount/> <presents actionname="Выдать подарок" externalcode="SR10_2448" guid="2601" issued="7" scanned="7"> <present amount="7" condition=""/> </presents> </purchase> </purchases>
Список подарков <present>
purchases/purchase/presents/present | |||
Наименование аттрибута | Тип данных | Описание | Обязательное |
amount | Integer | Расчетное количество "подарков" по условию | Нет |
condition | String | Идентификатор условия (уникален в рамках РА), по которому производилось начисление/расчет количества подарков. | Нет |
Метки рекламаной акции <actionLables>
purchases/purchase/bonuses/actionLabels | |||
Наименование элемента | Тип данных | Описание | Обязательное |
label | String | Наименование метки рекламной акции | Нет |
Выданные купоны <coupons>
https://crystals.atlassian.net/browse/SLS-1290
https://crystals.atlassian.net/browse/SLS-1295
- CR-5582Getting issue details... STATUS
10.3.4.0
Включение экспорта:
Информация по управлению версиями веб-сервисов.
Модуль | Название параметра | Номер версии |
---|---|---|
SET_ERP_INTEGRATION | export.file.loyalty.version | 1.6 |
SET_ERP_INTEGRATION | export.file.purchases.version | 1.10 |
SET_ERP_INTEGRATION | export.set10wsclient.purchases.version | 1.19 |
SET_ERP_INTEGRATION | fiscal.info.export.purchase.discount.document.schema.version | 1.6 |
SET_ERP_INTEGRATION | fiscal.info.export.discounts.document.schema.version | 1.6 |
/purchases/purchase/coupons/coupon | |||
---|---|---|---|
Наименование элемента | Тип данных | Описание | Обязательное |
coupons | Комплексный | Выданные купоны | Нет |
coupon | Комплексный | Выданный купон | Да |
Наименования атрибута | Тип данных | Описание | Обязательное |
number | String | Номер купона | Нет |
status | String | Статус купона
| Нет |
typeGuid | Long | Id категории | Нет |
typeName | String | Название категории | Нет |
startDate | DateTime | Дата выдачи | Нет |
finishate | DateTime | Срок окончания | Нет |
Пример экспорта чека:
<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <purchases count="1"> <purchase tabNumber="1" userName="Администраторов Администратор Администраторович" operationType="true" cashOperation="INCOME" operDay="2021-10-05+03:00" shop="1331" cash="1" shift="2" number="9" saletime="2021-10-06T00:52:59.497+03:00" begintime="2021-10-06T00:52:53.916+03:00" amount="120.70" discountAmount="0.00" inn="7802781104" clientGuid="1" qrcode="t=20211006T0052&s=120.70&fn=00a81bdf-19eb-4037-914e-9e6cd4ea79b1&i=13&fp=0&n=1" fiscalDocNum="13;9" status="REGISTERED"> <plugin-property key="FISCAL_DOC_ID" value="13"/> <plugin-property key="UID_PURCHASE" value="697091fc-c3ef-41e0-95b6-5ae3bf500b86"/> <positions> <position order="1" departNumber="1" goodsCode="00919" barCode="4600919000007" count="1.000" cost="120.70" nds="20.0" ndsSum="20.12" discountValue="0.00" costWithDiscount="120.70" amount="120.70" dateCommit="2021-10-06T00:52:55.886+03:00" insertType="1"> <plugin-property key="countryName" value="Россия"/> </position> </positions> <payments> <payment typeClass="CashPaymentEntity" amount="130.00" description="Оплата наличными"/> <payment typeClass="CashChangePaymentEntity" amount="9.30" description=""/> </payments> <discountCards> <discountCard>22020000</discountCard> </discountCards> <card type="INTERNAL" number="22020000" addedBy="HAND"/> <coupons> <coupon number="320001003013610170311" status="Issued" typeGuid="100" typeName="xxssww" startDate="2021-10-06T00:00:54.233+03:00" finishDate="2021-12-12T00:00:54.233+03:00"/> </coupons> <bonuses/> </purchase> </purchases>
Пример экспорта карты в addedBy
с типом ECOUPON
:
<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <purchases count="1"> <purchase tabNumber="1" userName="Администраторов Администратор Администраторович" operationType="true" cashOperation="INCOME" operDay="2021-10-05+03:00" shop="1331" cash="1" shift="2" number="5" saletime="2021-10-05T17:53:02.949+03:00" begintime="2021-10-05T17:52:51.698+03:00" amount="109.70" discountAmount="11.00" inn="7802781104" clientGuid="1" qrcode="t=20211005T1753&s=109.70&fn=00a81bdf-19eb-4037-914e-9e6cd4ea79b1&i=9&fp=0&n=1" fiscalDocNum="9;5" status="REGISTERED"> <plugin-property key="FISCAL_DOC_ID" value="9"/> <plugin-property key="UID_PURCHASE" value="51cf0060-9edd-4c67-9c5f-5615f8aab4a1"/> <positions> <position order="1" departNumber="1" goodsCode="00919" barCode="4600919000007" count="1.000" cost="120.70" nds="20.0" ndsSum="18.28" discountValue="11.00" costWithDiscount="109.70" amount="109.70" dateCommit="2021-10-05T17:52:54.861+03:00" insertType="1"> <plugin-property key="countryName" value="Россия"/> </position> </positions> <payments> <payment typeClass="CashPaymentEntity" amount="110.00" description="Оплата наличными"/> <payment typeClass="CashChangePaymentEntity" amount="0.30" description=""/> </payments> <discountCards> <discountCard>22020000</discountCard> <discountCard>320009002000000000001</discountCard> <discountCard>320009002000000000002</discountCard> </discountCards> <card type="INTERNAL" number="22020000" addedBy="HAND"/> <card type="COUPON_CARD" number="320009002000000000001" addedBy="ECOUPON"/> <card type="COUPON_CARD" number="320009002000000000002" addedBy="ECOUPON"/> </purchase> </purchases>