Публичный ресурс
Экспорт чеков из SetRetail10 в ERP (веб-сервис на стороне SetRetail10)
ВЕРСИЯ ВЕБ-СЕРВИСА 1.13
Методы веб-сервиса для экспорта чеков
За заданный операционный день | |
| Метод | 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'; |
Отложенные чеки за операционный деньCR-5382 - Получение подробных данных проблемы… СТАТУС 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>
-
Отложенные чеки по заданным параметрамCR-5382 - Получение подробных данных проблемы… СТАТУС 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 – являются необязательными.
В зависимости от полноты указания параметров, в ответе будет возвращаться соответствующее количество чеков.
Кейсы
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-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 |
| URL | http://IP-адрес_сервера:8090/SET-ERPIntegration/FiscalInfoExport |
| WSDL | http://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 | Чеки по заданным параметрам | |
Возвращаемый результат не содержит полные данные по бонусам и скидкам. Для полного просмотра бонусов и скидок используйте метод 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-352 - Получение подробных данных проблемы… СТАТУС
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-3008 - Получение подробных данных проблемы… СТАТУС
SRTE-2991 - Получение подробных данных проблемы… СТАТУС
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-970 - Получение подробных данных проблемы… СТАТУС
CR-8315 - Получение подробных данных проблемы… СТАТУС
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 | Кассовая операция
| Нет |
| cashOperation | Комплексный | Кассовые операции для лотерей Столото НАЧИНАЯ С ВЕРСИИ ВЕБ-СЕРВИСА 1.15 SRTE-2953 - Получение подробных данных проблемы… СТАТУС 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-2915 - Получение подробных данных проблемы… СТАТУС 10.2.89.0 | Нет |
| fiscalDocNum | String | Нет | |
storno | Boolean | Признак сторнирования (если чек был хотя бы один раз сторнирован) НАЧИНАЯ С ВЕРСИИ ВЕБ-СЕРВИСА 1.9 SRTE-3562 - Получение подробных данных проблемы… СТАТУС CR-5382 - Получение подробных данных проблемы… СТАТУС 10.2.99.0 Данный тип экспорта должен быть активирован. По умолчанию выключен.
Если чек не сторнировался, то данный атрибут не отображается. | Нет |
status | Комплексный | Статус чека НАЧИНАЯ С ВЕРСИИ ВЕБ-СЕРВИСА 1.9 SRTE-3562 - Получение подробных данных проблемы… СТАТУС CR-5382 - Получение подробных данных проблемы… СТАТУС 10.2.99.0 Данный тип экспорта должен быть активирован. По умолчанию выключен.
| Нет |
| cashType | String | Тип кассы Тип кассы не выгружается, если экспорт чека с кассы был напрямую в SetESB, без участия SetCentrum или SetRetail. 10.3.16.0 ВЕРСИЯ ВЕБ-СЕРВИСА 1.11
SRTS-1003 - Получение подробных данных проблемы… СТАТУС CR-8367 - Получение подробных данных проблемы… СТАТУС | Нет |
| fiscalnum | String | Нет | |
Наименование элемента | Тип данных | Описание | Обязательное |
positions | Комплексный | Товарные позиции | Да |
payments | Комплексный | Оплаты | Да |
discountCards | Комплексный | Список дисконтных карт, примененных при оплате этого чека | Нет |
card | Комплексный | Список карт, использованных при оплате этой покупки. Фактически более | Нет |
original-purchase | Комплексный | Оригинальный чек продажи для возвратного чека (purchaseType) | Нет |
exciseBottles | Комплексный | Бутылки с акцизными марками | Нет |
| presents | Комплексный | Выданные подарки | Нет |
| coupons | Комплексный | Выданные купоны SLS-1290 - Получение подробных данных проблемы… СТАТУС SLS-1295 - Получение подробных данных проблемы… СТАТУС CR-5582 - Получение подробных данных проблемы… СТАТУС 10.3.4.0 | Нет |
| discount | Комплексный | Список скидок, сработавших в этом чеке | Нет |
| discountCard | Комплексный | Список дисконтных карт, примененных при оплате этого чека | Нет |
| bonuses | Комплексный | Список бонусных транзакций, проведенных в этом чеке | Нет |
| plugin-property | Комплексный | Список "плагинных" (расширенных, не базовых) свойств этого чека. Может отсутствовать. | Нет |
Плагинные свойства чека <plugin-property>
purchases/purchase/plugin-property | |||
| |||
Наименование атрибута | Тип данных | Описание | Обязательное |
key | String | Наименование плагинного свойства | Да |
value | String | Значение плагинного свойства | Нет |
Дополнительная информация по мягкому чеку SetKit
SR-2709 - Получение подробных данных проблемы… СТАТУС
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-4874 - Получение подробных данных проблемы… СТАТУС
10.2.99.0
SR-5018 - Получение подробных данных проблемы… СТАТУС
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-5270 - Получение подробных данных проблемы… СТАТУС
CR-5382 - Получение подробных данных проблемы… СТАТУС
10.3.1.0
Наименование плагинного свойства | Описание |
PURCHASE_DEFERRED | Признак отложенного чека |
| value | Содержание отложенного чека в формате JSON |
Нефискальный документ
ТОЛЬКО ДЛЯ WEB-СЕРВИСА НА СТОРОНЕ SETRETAIL
SRTE-2318 - Получение подробных данных проблемы… СТАТУС
10.2.78.0
SRTB-5584 - Получение подробных данных проблемы… СТАТУС
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-4485 - Получение подробных данных проблемы… СТАТУС
CR-2350 - Получение подробных данных проблемы… СТАТУС
10.2.91.0
Наименование плагинного свойства | Описание |
UID_PURCHASE | Признак уникального идентификатора чека |
| value | Сгенерированное значение уникального идентификатора чека. Пример:
|
Номер сессии кассира
SRTB-6438 - Получение подробных данных проблемы… СТАТУС
CR-8903 - Получение подробных данных проблемы… СТАТУС
10.2.20.0
Функциональность для клиентов CSI.
По включению уточняйте у менеджера.
Наименование плагинного свойства | Описание |
SESSION_ID | Номер сессии кассира |
| value | Сгенерированное значение сессии кассира. |
Место установки кассы
SRTB-6547 - Получение подробных данных проблемы… СТАТУС
CR-8689 - Получение подробных данных проблемы… СТАТУС
10.3.21.0
SetRetail10 ◾️ Выбор места установки кассы
| Наименование плагинного свойства | Описание |
|---|---|
| CASH_PLACE | Место установки кассы |
| value | Код места установки кассы |
Часовая зона
SRTB-7296 - Получение подробных данных проблемы… СТАТУС
CR-9434 - Получение подробных данных проблемы… СТАТУС
10.3.27.0
| Наименование плагинного свойства | Описание |
|---|---|
| CASH_TIME_ZONE | Часовой пояс нахождения кассы |
| value | Часовая зона в формате. Например: +03:00 |
Номер документа Пирит РБ
SRTZ-1091 - Получение подробных данных проблемы… СТАТУС
CR-5567 - Получение подробных данных проблемы… СТАТУС
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>
Информация по комитенту (комиссионер)
10.3.22.0
SRTS-1492 - Получение подробных данных проблемы… СТАТУС
CR-9046 - Получение подробных данных проблемы… СТАТУС
| Наименование плагинного свойства | Описание |
|---|---|
| counterparty | Комиссионер |
| value | Данные по комиссионеру В формате JSON
|
Запрос печати чеков
10.3.29.0
SR-6708 - Получение подробных данных проблемы… СТАТУС
CR-9689 - Получение подробных данных проблемы… СТАТУС
| Наименование плагинного свойства | Описание |
|---|---|
| PRINT_DIALOG_ANSWER | Запрос печати чеков |
| value |
|
Товарные позиции <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 | Наименование налога Данный атрибут не выгружается, если чек был экспорт с кассы был напрямую в SetESB (без участия SetCentrum или SetRetail), через веб-сервисы на стороне SetRetail или файловый экспорт. | Да |
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 | Идентификатор терминала |
Ветеринарный контроль
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-2018 - Получение подробных данных проблемы… СТАТУС
Наименование плагинного свойства | Описание |
beforeManualPrice | Цена товара перед изменением |
Причина изменения цены товара
10.2.70.0
SRTB-3193 - Получение подробных данных проблемы… СТАТУС
Наименование плагинного свойства | Описание |
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>
Причина аннулирования чека
SRTS-851 - Получение подробных данных проблемы… СТАТУС
10.3.15.0
Наименование плагинного свойства | Описание |
cancelPurchaseReason | Код причины аннулирования чека |
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<purchases count="1">
<purchase tabNumber="111" userName="Иванова Мария Ивановна" operationType="true" cashOperation="INCOME" operDay="2022-08-22+03:00" shop="3245" cash="62" shift="1" number="2" saletime="2022-08-22T16:51:56.341+03:00" begintime="2022-08-22T16:51:51.628+03:00" amount="911.23" discountAmount="0.00" inn="7802781104" fiscalDocNum="1;2" status="CANCELLED">
<plugin-property key="FISCAL_DOC_ID" value="1"/>
<plugin-property key="UID_PURCHASE" value="c7368fd0-9211-42de-87f5-844fb3ff0737"/>
<plugin-property key="KPP" value="780201001"/>
<positions>
<position order="1" departNumber="1" goodsCode="07000" barCode="3007000000006" count="1.000" cost="100.00" nds="20.0" ndsSum="0.00" discountValue="0.00" costWithDiscount="100.00" amount="100.00" dateCommit="2022-08-22T16:51:51.656+03:00" insertType="3">
<plugin-property key="cancelPurchaseReason" value="4"/>
<plugin-property key="countryName" value="Франция"/>
</position>
</positions>
<payments/>
</purchase>
</purchases>
Комплект товаров
10.2.75.0
SRTE-2338 - Получение подробных данных проблемы… СТАТУС
Наименование плагинного свойства | Описание |
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-2734 - Получение подробных данных проблемы… СТАТУС
Наименование плагинного свойства | Описание |
excise-token | Datamatrix-код |
Тип акцизной продукции
10.2.86.0
SRTE-2734 - Получение подробных данных проблемы… СТАТУС
Наименование плагинного свойства | Описание |
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-4203 - Получение подробных данных проблемы… СТАТУС
Наименование плагинного свойства | Описание |
social | Продукт социальный |
| socialPayPossible | Продукт можно оплатить социальной картой |
| mptProductCode | Код продукта или группы установленный МинПромТоргом Код продукта или группы соответствии с классификатором МЕГАР |
| mptProductName | Наименование продукта или группы установленное МинПромТоргом Наименование продукта или группы в соответствии с классификатором МЕГАР |
| mptMeasureCode | Код единицы измерения установленный МинПромТоргом Код единицы измерения в соответствии с классификатором МЕГАР |
| mptQuantity | Количество в ед.измерения установленных МинПромТоргом Количество в единице измерения установленныез в соответствии с классификатором МЕГАР |
Признак передачи кода товара в ОФД для СИЗ (Средства индивидуальной защиты)
10.2.86.0
SRTB-4261 - Получение подробных данных проблемы… СТАТУС
Наименование плагинного свойства | Описание |
| 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-4735 - Получение подробных данных проблемы… СТАТУС
| Наименование плагинного свойства | Описание |
|---|---|
| salesTaxSum | Налог с продаж (НСП) Применяется в Киргизии |
Признак прослеживаемого и импортного товара
SRTB-5063 - Получение подробных данных проблемы… СТАТУС
CR-5651 - Получение подробных данных проблемы… СТАТУС
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-5394 - Получение подробных данных проблемы… СТАТУС
SRTB-5203 - Получение подробных данных проблемы… СТАТУС
| Наименование плагинного свойства | Описание |
|---|---|
| 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-754 - Получение подробных данных проблемы… СТАТУС
CR-5247 - Получение подробных данных проблемы… СТАТУС
| Наименование плагинного свойства | Описание |
|---|---|
| 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-5348 - Получение подробных данных проблемы… СТАТУС
CR-6702 - Получение подробных данных проблемы… СТАТУС
| Наименование плагинного свойства | Описание |
|---|---|
| SIEBEL_CLIENT_ID | Идентификатор клиента в Siebel CRM |
Оплаты <payments>
purchases/purchase/payments | |||
| |||
Наименование атрибута | Тип данных | Описание | Обязательное |
payment | Комплексный | Список типов оплат | Да |
Тип оплаты <payment>
purchases/purchase/payments/payment | |||
| |||
Наименование атрибута | Тип данных | Описание | Обязательное |
| order | Long | Да | |
typeClass | String | Тип оплаты:
| Да |
amount | Decimal | сумма | Да |
description | String | Описание При экспорте чеков через SetESB, поле Descripion может быть не заполнено (заполнятся только для стандартных типов оплат, для плагинных заполнение не требуется). | Да |
Наименование элемента | Тип данных | Описание | Обязательное |
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-3404 - Получение подробных данных проблемы… СТАТУС CR-5316 - Получение подробных данных проблемы… СТАТУС 10.2.97.0 Для включения экспорта текста банковского слипа выполните скрипт в базе данных сервера 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 | SRTE-2121 - Получение подробных данных проблемы… СТАТУС 10.2.70.0 RRN (Reference Retrieval Number) номер транзакции оплаты |
| cashout.amount | CR-3746 - Получение подробных данных проблемы… СТАТУС 10.2.96.0 Сумма выдачи наличных Подробнее в SetRetail10 ◾️ Mastercard ◾️ Выдача наличных на кассе. |
| loyalty.program.code | Код банковской программы лояльности |
| card.number.hash | Хэш-код номера карты |
| qrc.id | |
| operation.id | Дополнительный идентификатор транзакции при оплате/возврате СБП Газпромбанк SRTZ-1945 - Получение подробных данных проблемы… СТАТУС CR-8180 - Получение подробных данных проблемы… СТАТУС 10.3.16.0 |
<?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-кодом
Наименование плагинного свойства | Описание |
sberbank_qr.id.qr | Id выдаваемый Сбербанком (не СБП), определяющий устройство, на котором был создан заказ на оплату. Заполняется при оплатах SberQR или Сбербанк СБП через API (без терминалов). Также хранится в конфигурационном файле на кассе /home/tc/storage/crystal-cash/config/plugins/bank-sberbank_qr-config.xml в параметре idQR. Максимальная длина = 20 Только для Сбербанка |
| terminal.number | Номер терминала Только для Сбербанка |
| cash.transaction.id | Идентификатор операции платежа |
| cash.transaction.date | Дата и время выполнения транзакции |
| bank.id | Название банка/процессинга |
| ref.number | SRTE-2121 - Получение подробных данных проблемы… СТАТУС 10.2.70.0 RRN (Reference Retrieval Number) номер транзакции оплаты Только для Сбербанка |
| merchant.id | Уникальный идентификатор партнёра, выданный СБП или Сбербанком |
| sberbank.payment.type | Дополнительные идентификаторы при оплате через банковский процессинг Сбербанк SRTZ-2020 - Получение подробных данных проблемы… СТАТУС CR-8474 - Получение подробных данных проблемы… СТАТУС CR-8687 - Получение подробных данных проблемы… СТАТУС 10.3.18.0 |
| order.id | Уникальный идентификатор заказа в системе партнёра |
| operation.id | Идентификатор операции |
| auth.code | Код авторизации Только для Сбербанка |
| qr.type | Тип QRC: динамический или кассовая ссылка |
<?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-1290 - Получение подробных данных проблемы… СТАТУС CR-5582 - Получение подробных данных проблемы… СТАТУС 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 | Идентификатор условия (уникален в рамках РА), по которому производилось начисление/расчет количества подарков. | Нет |
Метки рекламной акции <actionLabels>
Метки рекламной акции не выгружаются при экспорте чеков с касс в ERP через SetESB
purchases/purchase/bonuses/actionLabels | |||
| |||
Наименование элемента | Тип данных | Описание | Обязательное |
label | String | Наименование метки рекламной акции | Нет |
Выданные купоны <coupons>
https://crystals.atlassian.net/browse/SLS-1295
CR-5582 - Получение подробных данных проблемы… СТАТУС
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>
© 1994-2021, ООО "Кристалл Сервис Интеграция".
Все права защищены.