Публичный ресурс
Экспорт чеков из 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'; |
Поле | Тип данных | Описание | Обязательное |
Принимаемые параметры | |||
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-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 |
Поле | Тип данных | Описание | Обязательное |
Принимаемые параметры | |||
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>
Метод веб-сервиса для экспорта чеков по периоду и категориям карт лояльности
Для осуществления фильтрации чеков по параметру cardTypeGuids
и для получения в выходном объекте чека информации о примененной в чеке лояльности необходимо изменение версии схемы xsd в настройке таблице sales_management_properties: export.file.purchases.version
= “2.0”.
UPDATE public.sales_management_properties SET property_value='2.0' WHERE property_key = 'export.file.purchases.version';
Поле | Тип данных | Описание | Обязательное |
---|---|---|---|
Принимаемые параметры | |||
fromDate | date | Начало диапазона в формате YYYY-MM-DD | Нет |
toDate | date | Конец диапазона в формате YYYY-MM-DD | Нет |
cardTypeGuids | array | Список кодов категорий карт. Фильтрация чеков происходит по значению атрибута | Да |
Возвращаемые параметры | |||
return | base64Binary | Чеки за период, в которых была применена карта лояльности с указанным в фильтре типом Описание формата выгрузки чеков |
Чеки <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
| Нет |
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
<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
|
Номер УПД, УКД и дебитора
- SRTS-1889Получение подробных данных проблемы… СТАТУС
- CR-9569Получение подробных данных проблемы… СТАТУС
10.4.0.0
Наименование плагинного свойства | Описание |
---|---|
debitor-number | Номер дебитора Выгрузка свойства доступна только с помощью веб-сервисов. Файловый экспорт не поддерживается. |
upd | Номер УПД (универсального передаточного документа) |
ukd | Номер УКД (универсального корректировочного документа) |
Запрос печати чеков
10.3.29.0
- SR-6708Получение подробных данных проблемы… СТАТУС
- CR-9689Получение подробных данных проблемы… СТАТУС
Наименование плагинного свойства | Описание |
---|---|
PRINT_DIALOG_ANSWER | Запрос печати чеков |
value |
|
Передача QR-кода от NFD
- SRTZ-2991Получение подробных данных проблемы… СТАТУС
- CR-10363Получение подробных данных проблемы… СТАТУС
10.4.0.0
Наименование плагинного свойства | Описание |
---|---|
fiscalbarcode | Значение QR-кода, полученное от программного фискализатора NFD (Республика Казахстан) |
Оплата чека одной транзакцией
- SRTB-9140Получение подробных данных проблемы… СТАТУС
- SRTZ-3861Получение подробных данных проблемы… СТАТУС
- CR-12336Получение подробных данных проблемы… СТАТУС
10.4.13.0
Наименование плагинного свойства | Описание |
---|---|
PRIMARY_PURCHASE_UID | UID_PURCHASE мастер-чека (UID чека, который был разделен) |
FIRST_SPLIT_PURCHASE_NUMBER | Номер первого зарегистрированного чека |
TOTAL_SUB_PURCHASES | Общее количество подчеков |
SUB_PURCHASE_PART | Порядковый номер подчека |
Товарные позиции <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 | Идентификатор терминала |
Ветеринарный контроль
- SRTE-961Получение подробных данных проблемы… СТАТУС
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 |
Информация о проверке КМ в Честном знаке
10.4.0.0
- SRTB-7949Получение подробных данных проблемы… СТАТУС
- CR-6219Получение подробных данных проблемы… СТАТУС
Наименование плагинного свойства | Описание |
---|---|
trueApiReqId | Уникальный идентификатор запроса проверки кода маркировки в сервисе Честного знака |
trueApiReqTimestamp | Дата и время формирования запроса |
trueApiValidationResponse | Полный ответ от сервиса Честный знак, в том числе коды ошибок из ответа, если они получены от ЧЗ, но при этом настройками разрешена продажа (например при недоступности сервиса Честного знака) Примеры значений
- SRTB-8220Получение подробных данных проблемы… СТАТУС - CR-11332Получение подробных данных проблемы… СТАТУС 10.4.4.0 |
trueApiInst | Идентификатор экземпляра ИМ ЧЗ в формате UUID - MARK-620Получение подробных данных проблемы… СТАТУС - CR-12048Получение подробных данных проблемы… СТАТУС 10.4.12.0 |
trueApiImDbVersion | Версия базы данных ИМ ЧЗ, на которой осуществлялась проверка. При наличии нескольких версий (если идет процесс синхронизации БД) указывается более старая версия, новая версия выгружается только после обновления всех БД на новую версию. - MARK-620Получение подробных данных проблемы… СТАТУС - CR-12048Получение подробных данных проблемы… СТАТУС 10.4.12.0 |
Пример экспорта онлайн-проверки
Параметры обращения к CDN-площадкам
10.4.2.0
- SRTB-8095Получение подробных данных проблемы… СТАТУС
- CR-11196Получение подробных данных проблемы… СТАТУС
Наименование плагинного свойства | Описание |
---|---|
CDNAddress | Адрес CDN-площадки. Выгружается всегда, когда включена и настроена интеграция с Честным знаком. |
responseReceived | Наличие ответа, если не произошло отключения по таймауту. Присутствует всегда, когда присутствует |
responseDelayMs | Задержка получения ответа в миллисекундах, измеренная на стороне кассы. Присутствует всегда, когда есть |
responseDescription | Текстовое описание результата выполнения запроса. Присутствует только при наличии ответа ( |
Признак вскрытия кега
10.4.4.0
- SRTB-8370Получение подробных данных проблемы… СТАТУС
- CR-11535Получение подробных данных проблемы… СТАТУС
Наименование плагинного свойства | Описание |
---|---|
newBarrel | Признак вскрытия кега на кассе |
Информация о проверке КМ в Локальном модуле Честный Знак
10.4.6.0
- SRTB-8566Получение подробных данных проблемы… СТАТУС
- CR-12047Получение подробных данных проблемы… СТАТУС
Наименование плагинного свойства | Описание |
---|---|
localTrueApiResponse | Результат проверки кода маркировки в Локальном модуле Честный Знак |
Унифицированный контрольный знак (УКЗ)
10.4.10.0
- SRTB-8748Получение подробных данных проблемы… СТАТУС
- CR-12031Получение подробных данных проблемы… СТАТУС
Наименование плагинного свойства | Описание |
---|---|
byFfdUkz | Унифицированный контрольный знак (УКЗ). Используется в Республике Беларусь. Подробнее в статье Беларусь ◾️ Маркировка |
Оплаты <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 Для включения экспорта текста банковского слипа выполните скрипт в базе данных сервера 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-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-кодом
<?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 | Идентификатор терминала |
Тип поставщика (Узбекистан)
Наименование плагинного свойства | Описание |
uz-ffd-owner-type |
Список карт, примененных в чеке <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>
- SRTS-3397Получение подробных данных проблемы… СТАТУС
- CR-12689Получение подробных данных проблемы… СТАТУС
10.4.12.0
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>
purchases/purchase/bonuses/actionLabels | |||
Наименование элемента | Тип данных | Описание | Обязательное |
label | String | Наименование метки рекламной акции | Нет |
Выданные купоны <coupons>
https://crystals.atlassian.net/browse/SLS-1290
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-2024, ООО "Кристалл Сервис Интеграция".
Все права защищены.