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

Экспорт чеков из SetRetail10 в ERP (веб-сервис на стороне SetRetail10)

ВЕРСИЯ ВЕБ-СЕРВИСА 1.13

К оглавлению

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

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

МетодgetPurchasesByOperDay
URLhttp://IP-адрес_сервера:8090/SET-ERPIntegration/FiscalInfoExport
WSDLhttp://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
URLhttp://IP-адрес_сервера:8090/SET-ERPIntegration/FiscalInfoExport
WSDLhttp://IP-адрес_сервера:8090/SET-ERPIntegration/FiscalInfoExport?wsdl

Поле

Тип данных

Описание

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

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

Year

integer

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

Нет

Mobth 

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

string

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

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

Day

integer

День

Нет

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

return

base64Binary

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

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

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

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

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

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

-

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

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

Поле

Тип данных

Описание

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

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

fromDate

date

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

Нет

toDate

date

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

Нет

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

return

base64Binary

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

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

Для полного просмотра бонусов и скидок используйте метод 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
URLhttp://IP-адрес_сервера:8090/SET-ERPIntegration/FiscalInfoExport
WSDLhttp://IP-адрес_сервера:8090/SET-ERPIntegration/FiscalInfoExport?wsdl

Поле

Тип данных

Описание

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

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

fromDate

date

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

Нет

toDate

date

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

Нет

goodsCode

string

Код товара

Нет

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

return

base64Binary

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

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

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

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

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

-

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

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

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

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

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

10.2.99.0

Выгрузка для веб сервиса на стороне ERP и SetRetail10
UPDATE public.sales_management_properties
   SET property_value='1.18'       
 WHERE property_key = 'export.set10wsclient.purchases.version';
UPDATE public.sales_management_properties
   SET property_value='true'       
 WHERE property_key = 'export.set10wsclient.purchases.deferred.enabled';
Файловый экспорт
UPDATE public.sales_management_properties
   SET property_value='1.9'       
 WHERE property_key = 'export.file.purchases.version';
UPDATE public.sales_management_properties
   SET property_value='true'       
 WHERE property_key = 'export.file.purchases.deferred.enabled';

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

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

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

10.2.99.0

МетодgetReportDeferredByOperDay
URLhttp://IP-адрес_сервера:8090/SET-ERPIntegration/FiscalInfoExport
WSDLhttp://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
URLhttp://IP-адрес_сервера:8090/SET-ERPIntegration/FiscalInfoExport
WSDLhttp://IP-адрес_сервера:8090/SET-ERPIntegration/FiscalInfoExport?wsdl

Поле

Тип данных

Описание

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

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

dateOperDay

dateTime

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

Нет
shopNumberLongНомер магазинаНет
cashNumberLongНомер кассыНет
shiftNumberLongНомер сменыНет
cashierTabNoStringТабельный номер кассираНет

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

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
URLhttp://IP-адрес_сервера:8090/SET-ERPIntegration/FiscalInfoExport
WSDLhttp://IP-адрес_сервера:8090/SET-ERPIntegration/FiscalInfoExport?wsdl

Поле

Тип данных

Описание

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

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

dateOperDay

date

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

Да

shopNumber

integer

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

Нет

cashNumber

integer

Номер кассы

Нет

shiftNumber

integer

Номер смены

Нет

purchaseNumber

integer

Номер чека

Нет

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

return

base64Binary

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

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

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

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

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

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

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

Кейсы

  1. dateOperDay - в отчёт попадают все чеки всех магазинов за операционный день dateOperDay.
  2. dateOperDayshopNumber - в отчёт попадают все чеки за операционный день dateOperDay с магазина shopNumber.
  3. dateOperDayshopNumbercashNumber - в отчёт попадают все чеки за операционный день dateOperDay с магазина shopNumber с кассы cashNumber.
  4. dateOperDayshopNumbercashNumbershiftNumber - в отчёт попадают все чеки смены shiftNumber за операционный день dateOperDay с магазина shopNumber с кассы cashNumber.
  5. dateOperDayshopNumbercashNumbershiftNumberpurchaseNumber - в отчёт попадает только один конкретный чек под номером purchaseNumber из сменыshiftNumber за операционный день dateOperDay с магазина shopNumber с кассы cashNumber.

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

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

10.2.80.0

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

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

Такой кейс упрощает интеграцию SetRetail10 и 1С. 

Пример: для загрузки чеков c отбором по дате, магазину, для кассе в 1С используется метод getPurchasesByParams, в котором возможно заполнить параметры dateOperDay, shopNumber, cashNumber, но параметры shiftNumber, purchaseNumber заполнять не требуется.

Пример SOAP-запроса:

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
    <soap:Header/>
    <soap:Body> <m:getPurchasesByParams xmlns:m="http://plugins.operday.ERPIntegration.crystals.ru/">
    <dateOperDay xmlns=""
            xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">2019-10-29T00:00:00</dateOperDay>
    <shopNumber xmlns=""
            xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">2</shopNumber>
    <cashNumber xmlns=""
            xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">1</cashNumber>
    <shiftNumber xmlns=""
            xmlns:xs="http://www.w3.org/2001/XMLSchema"
            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
            xsi:nil="true"/>
    <purchaseNumber xmlns=""
            xmlns:xs="http://www.w3.org/2001/XMLSchema"
            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
            xsi:nil="true"/>
</m:getPurchasesByParams></soap:Body>
</soap:Envelope>

-

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

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

10.2.66.0

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

Поле

Тип данных

Описание

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

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

dateOperDay

date

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

Да

shopNumber

integer

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

Нет

cashNumber

integer

Номер кассы

Нет

shiftNumber

integer

Номер смены

Нет

purchaseNumber

integer

Номер чека

Нет

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

return

base64Binary

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

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

Для полного просмотра бонусов и скидок используйте метод 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
URLhttp://IP-адрес_сервера:8090/SET-ERPIntegration/FiscalInfoExport
WSDLhttp://IP-адрес_сервера:8090/SET-ERPIntegration/FiscalInfoExport?wsdl

В отчёте выгружаются только новые чеки (те которые ещё не забирали).

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

Поле

Тип данных

Описание

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

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

arrayOfParams

array

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

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

Да

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

return

base64Binary

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

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

Для полного просмотра бонусов и скидок используйте метод 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
URLhttp://IP-адрес_сервера:8090/SET-ERPIntegration/FiscalInfoExport
WSDLhttp://IP-адрес_сервера:8090/SET-ERPIntegration/FiscalInfoExport?wsdl

Поле

Тип данных

Описание

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

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

dateOperDay

Date

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


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

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

return

base64Binary

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


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

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


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

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

Индекс

Тип данных

Описание

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

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

0

Date

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

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

return

base64Binary

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

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

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

Настройка ограничения размера пачки экспорта чеков для веб-сервиса на стороне 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
URLhttp://IP-адрес_сервера:8090/SET-ERPIntegration/FiscalInfoExport
WSDLhttp://IP-адрес_сервера:8090/SET-ERPIntegration/FiscalInfoExport?wsdl
ПолеТип данныхОписаниеОбязательное
Принимаемые параметры
dateOperDaydateОперационный день в формате YYYY-MM-DDДа
shopNumberintegerНомер магазинаНет
cashNumberintegerНомер кассыНет
shiftNumberintegerНомер сменыНет
purchaseNumberintegerНомер нефискального документаНет
typestring

Тип нефискального документа. 

Поле может быть пустым, но обязательно должно присутствовать в структуре запроса

Да 
statusstring

Статус документа. Возможные значения:

  • new – новые, не отправленные документы (помечает документ как отправленный)
  • all – все/любые (не меняет статус документа)
Да 
Возвращаемые параметры
returnbase64BinaryНефискальные документы по заданным параметрам

Описание формата выгрузки нефискальных документов

Пример запроса
<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
URLhttp://IP-адрес_сервера:8090/SET-ERPIntegration/FiscalInfoExport
WSDLhttp://IP-адрес_сервера:8090/SET-ERPIntegration/FiscalInfoExport?wsdl

Поле

Тип данных

Описание

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

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

dateOperDay

date

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

Да

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

return

base64Binary

Аннулированные чеки за операционный день

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

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


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

Метод

getCancelledPurchasesByParams
URLhttp://IP-адрес_сервера:8090/SET-ERPIntegration/FiscalInfoExport
WSDLhttp://IP-адрес_сервера:8090/SET-ERPIntegration/FiscalInfoExport?wsdl
ПолеТип данныхОписаниеОбязательное
Принимаемые параметры
dateOperDaydateОперационный день в формате YYYY-MM-DDДа
shopNumberintegerНомер магазинаНет
cashNumberintegerНомер кассыНет
shiftNumberintegerНомер сменыНет
cashierTabNointegerТабельный номер кассира, аннулировавшего чекНет
Возвращаемые параметры
returnbase64BinaryАннулированные чеки по заданным параметрам

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

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

Начиная с версии 10.2.97.0 типы данных Double изменены на Decimal.

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

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

Чеки <purchases>

purchases

Наименование элемента

Тип данных

Описание

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

purchase

Комплексный

Данные чека

Да

Наименование атрибута

Тип данных

Описание

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

count

Long

Количество передаваемых чеков, т.е. общее количество тегов purchase вложенных в общий тег purchases

Нет

Состав чека <purchase>

purchases/purchase

Наименование атрибута

Тип данных

Описание

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

tabNumber

String

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

Нет
returndayindayBooleanПризнак для чека возврата "День в день"Нет
usernameStringИмя кассираНет
operationTypeBoolean

Кассовая операция

  • True - продажа
  • False - возврат
Нет
cashOperationКомплексный

Кассовые операции для лотерей Столото

НАЧИНАЯ С ВЕРСИИ ВЕБ-СЕРВИСА 1.15

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

10.2.89.0

  • EXPENSE - Операция "Расход"
  • INCOME - Операция "Приход"

Пример выгрузки чека расхода

Нет

operDay

Date

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

Да

shop

Long

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

Да

cash

Long

Номер кассы

Да

shift

Long

Номер смены

Да
number

Long

Номер чекаДа
saletimeDateTimeДата/Время продажиНет

begintime

DateTime

Дата создания чека (добавления первого товара)

Нет

amount

Decimal

Сумма чека

Нет

discountAmount

Decimal

Сумма скидки на чек

Нет
innStringИНН юридического лица в сменеНет
qrcodeString

Состав QR-кода чека отправленного в ОФД

НАЧИНАЯ С ВЕРСИИ ВЕБ-СЕРВИСА 1.7

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

10.2.89.0

Пример XML выгрузки чека с QR-кодом

Нет
fiscalDocNumString

Номер фискального документа

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

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

10.2.93.0

Пример чека с номером фискального документа

Нет

storno


Boolean

Признак сторнирования (если чек был хотя бы один раз сторнирован)

НАЧИНАЯ С ВЕРСИИ ВЕБ-СЕРВИСА 1.9

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

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

10.2.99.0


Данный тип экспорта должен быть активирован. По умолчанию выключен.

  • true - чек сторнирован

Если чек не сторнировался, то данный атрибут не отображается.

Пример сторнированного чека

Нет

status


Комплексный

Статус чека

НАЧИНАЯ С ВЕРСИИ ВЕБ-СЕРВИСА 1.9

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

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

10.2.99.0


Данный тип экспорта должен быть активирован. По умолчанию выключен.

  • CANCELLEDЧек аннулирован
  • DEFERRED - Чек отложен
  • NONFISCAL - Нефискальный документ
  • REGISTEREDЧек зарегистрирован

Пример чека со статусом

Нет
cashTypeString

Тип кассы

Тип кассы не выгружается, если экспорт чека с кассы был напрямую в SetESB, без участия SetCentrum или SetRetail.

10.3.16.0

ВЕРСИЯ ВЕБ-СЕРВИСА 1.11

  • POS - клавиатурная;
  • TOUCH_2 - SetTouch;
  • SCO - касса самообслуживания, CSI-K.

example.xml

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

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

Нет
fiscalnumString

Регистрационный номер фискального регистратора

ВЕРСИЯ ВЕБ-СЕРВИСА 1.12

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

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

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

10.3.17.0

Пример экспорта чека

Нет

Наименование элемента

Тип данных

Описание

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

positions

Комплексный

Товарные позиции

Да

payments

Комплексный

Оплаты

Да

discountCards

Комплексный

Список дисконтных карт, примененных при оплате этого чека

Нет

card

Комплексный

Список карт, использованных при оплате этой покупки. Фактически более
детализированная версия содержимого элемента "discountCards"

Нет

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

Дополнительная информация по мягкому чеку

Также может выводиться Номер позиции заказаvalue="positionOrder=2"

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

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

10.2.94.0

Пример мягкого чека с дополнительной информацией
<?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

Признак фискализации чека без печати (отправка чека электронным способом).

Значение по умолчанию: false (не заполняется).

PROMO_PRINT_DISABLED

Признак того, что рекламные материалы не были распечатаны.

Значение по умолчанию: false (не заполняется).

FORCED_PRINT

Признак того, что чек был распечатан принудительно.

Значение по умолчанию: false (не заполняется).

CLIENT_REQUISITES_TYPE

Тип реквизитов клиента, на которые был отправлен чек (EMAIL, MOBILE_PHONE).

Не заполняется если реквизитов нет.

CUSTOMER_RECEIPT_REFUSE

Признак отказа от печати чека, полученный из карточки клиента в модуле CDP: Покупатели

Выгружается только при подключенном модуле CDP: Покупатели

Пример экспорта

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

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

10.3.30.0

CUSTOMER_PROMO_REFUSE

Признак отказа от печати купонов и промоматериалов, полученный из карточки клиента в модуле CDP: Покупатели

Выгружается только при подключенном модуле CDP: Покупатели

Пример экспорта

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

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

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

Значение типа нефискального документа

  • LEGAL_ENTITY_ORDER - заказ юридического лица
  • OPEN_UP_TARE - вскрытие тары
<?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

Сгенерированное значение уникального идентификатора чека.

Пример: 

key="UID_PURCHASE" value="11879bf1-de08-4f34-b7c7-698346134080"

Номер сессии кассира

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

  • type - значение всегда CounterpartyVO.
  • guid - GUID комитента
  • phone - телефон комитента
  • debitorTypeName - тип дебитора
  • ИНН - ИНН комитента.

Пример экспорта.

confluence.macros.advanced.include.unable-to-render Включенная страница не может быть найдена.

Номер УПД, УКД и дебитора

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

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

10.4.0.0

Наименование плагинного свойстваОписание
debitor-number

Номер дебитора

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

upd

Номер УПД (универсального передаточного документа)

Пример чека продажи

ukd

Номер УКД (универсального корректировочного документа)

Пример чека возврата

Запрос печати чеков

10.3.29.0

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

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

Наименование плагинного свойстваОписание
PRINT_DIALOG_ANSWER

Запрос печати чеков

value
  • true - чек был напечатан. Кассир нажал ДА.
  • false - чек не был напечатан. Кассир нажал НЕТ.

Пример экспорта

Передача QR-кода от NFD

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

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

10.4.0.0

Наименование плагинного свойстваОписание
fiscalbarcode

Значение QR-кода, полученное от программного фискализатора NFD (Республика Казахстан)

Товарные позиции <positions>

purchases/purchase/positions

Наименование элемента

Тип данных

Описание

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

position

String

Позиции чека

Да

Товарная позиция <position>

purchases/purchase/positions/position

Наименование атрибута

Тип данных

Описание

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

order

Long

Номер позиции

Да

departNumber

Long

Номер отдела

Да

goodsCode

String

Код товара

Начиная с версии 10.2.96.0, для отдельных типов банковских операций проставляется значение CASHOUT.

Да

barCode

String

ШК товара

Да

count

Decimal

Количество

Да

cost

Decimal

Цена за единицу

Да

nds

Decimal

Значение НДС

Да
ndsClassString

Наименование налога

Данный атрибут не выгружается, если чек был экспорт с кассы был напрямую в SetESB (без участия SetCentrum или SetRetail), через веб-сервисы на стороне SetRetail или файловый экспорт.

Да

ndsSum

Decimal

Сумма НДС

Да

discountValue

Decimal

Сумма скидки

Да

costWithDiscount

Decimal

Цена за единицу с учётом скидки

Да
amountDecimalСтоимость позицииДа
softCheckNumberStringНомер мягкого чекаНет

dateCommit

DateTime

Дата/время добавления позиции

Да

insertType

Integer

Способ добавления позиции

  • 0 - Сущность была проидентифицирована и добавлена в чек после сканирования ее ШК - SCANNER
  • 1 - Строка поиска для идентификации сущности была введена вручную - HAND
  • 2 - Товар найден из меню - MENU
  • 3 - Товар найден из справочника - DIRECTORY
  • 4 - Товар найден ручным вводом штрихкода - BARCODEBYHAND
  • 5 - Товар найден из справочника поиском по цене - DIRECTORYBYPRICE
  • 6 - Товар найден нажатием клавиатурной кнопки - KEY
  • 7 - Сущность была проидентифицирована по содержимому ее магнитной дорожки - MSR
  • 8 - Сущность была добавлена через FLMS - ADD_BY_FLMS
  • 9 - Добавлено через RFID считыватель ADD_BY_RFID
  • 10 - Товар был добавлен из сервиса заказов SetKit - ORDER
    • KIT-79 - Получение подробных данных проблемы… СТАТУС
    • 10.2.84.0
  • 11 - Сущность была добавлена с помощью SmartScalesSMART_SCALES 
    • SRTB-4321 - Получение подробных данных проблемы… СТАТУС
    • SRTB-4322 - Получение подробных данных проблемы… СТАТУС
    • 10.2.89.0
  • 12 - Маркированный товар был добавлен в чек при поднятии из аннулированного чека
    • SRTB-5773 - Получение подробных данных проблемы… СТАТУС
    • 10.3.14.0
Нет

Наименование элемента

Тип данных

Описание


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

key="productionDate" value ="2017-01-01"

Дата производства для позиции

value в формате yyyy-MM-dd HH:mm

Нет

plugin-property

String

key="count" value ="1.0"

Количество товара в позиции с указанной датой производства

value в формате double

Да для плагинного свойства верхнего уровня


Пример XML:
<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

Тип акцизной продукции

  • Алкогольная продукция: value=”alcohol” (база данных set, данные из таблицы erpi_purchase_ext_dat)

  • Сигаретная продукция: value=”tobacco” (база данных set, данные из таблицы erpi_positions в поле excise, значение типа товара = ProductCiggyEntity)

  • Обувь: value=“footwear” (база данных set, данные из таблицы erpi_positions в поле excise и значение типа товара = ProductPieceEntity).

Пример экспорта алкогольного товара
?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

Налог с продаж (НСП) 

Применяется в Киргизии

/wiki/spaces/SR10SUPPORT/pages/2420080878

Признак прослеживаемого и импортного товара

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

purchase.xml 


Информация о проверке КМ в Честном знаке

10.4.0.0

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

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


Наименование плагинного свойстваОписание
trueApiReqIdУникальный идентификатор запроса проверки кода маркировки в сервисе Честного знака
trueApiReqTimestampДата и время формирования запроса

Пример экспорта


Параметры обращения к CDN-площадкам

10.4.2.0

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

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


Наименование плагинного свойстваОписание
CDNAddress

Адрес CDN-площадки.

Выгружается всегда, когда включена и настроена интеграция с Честным знаком.

responseReceived

Наличие ответа, если не произошло отключения по таймауту.

Присутствует всегда, когда присутствует CDNAddress.

responseDelayMs

Задержка получения ответа в миллисекундах, измеренная  на стороне кассы.

Присутствует всегда, когда есть CDNAddress.

responseDescription

Текстовое описание результата выполнения запроса.

Присутствует только при наличии ответа (responseReceived = true)

Пример экспорта


Оплаты <payments>

purchases/purchase/payments

Наименование атрибута

Тип данных

Описание

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

payment

Комплексный

Список типов оплат

Да

Тип оплаты <payment>

purchases/purchase/payments/payment

Наименование атрибута

Тип данных

Описание

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

Порядковый номер оплаты в чеке

  • SRTS-1376 - Получение подробных данных проблемы… СТАТУС
  • CR-8969 - Получение подробных данных проблемы… СТАТУС
  • 10.3.21.0

Пример выгрузки чека

Да

typeClass

String

Тип оплаты:

  • CashPaymentEntity – наличные;
  • CashChangePaymentEntity – сдача;
  • BankCardPaymentEntity – безналичный;
  • GiftCardPaymentEntity – подарочная карта;
  • ConsumerCreditPaymentEntity – потребительский кредит
  • ExternalBankTerminalPaymentEntity — внешний банковский терминал
  • BonusCardPaymentEntity — оплата бонусами;
  • BonusSberbankPaymentEntity – Бонусная карта Сбербанка
  • CFTGiftCardPaymentEntity – Оплата по подарочной карте ЦФТ
  • ChildrenCardPaymentEntity – оплата Детской картой
  • BankQRPaymentEntity - оплата QR-кодом
  • BankBiometricsPaymentEntity – оплата по биометрии CSI-K.
    • SCOC-1203 - Получение подробных данных проблемы… СТАТУС
    • CR-10074 - Получение подробных данных проблемы… СТАТУС
    • 10.3.29.0
Да

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

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

Id QR-кода по которому была совершена оплата.

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

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

10.3.16.0

Пример XML

operation.id

Дополнительный идентификатор транзакции при оплате/возврате СБП Газпромбанк

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

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

10.3.16.0

Пример XML

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

Идентификатор терминала

Тип поставщика (Узбекистан)

Наименование плагинного свойства

Описание

uz-ffd-owner-type

Тип поставщика (Узбекистан)

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

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

10.4.1.0

Пример XML.

Список карт, примененных в чеке <discountCards>

purchases/purchase/discountCards/discountCard

Наименование элемента

Тип данных

Описание

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

discountCard

String

Номер карты

Нет

Подробная информация по картам, примененным в чеке <card>

purchases/purchase/card

Наименование атрибута

Тип данных

Описание

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

type

String

Тип карты:

  • BONUS – бонусная карта
  • COUPON_CARD – купон (без контроля повторного применения)
  • COUPON_PROCESSING – купон с однократным применением (возвратный купон)
  • COUPON_RECEIPT – купон с многократным применением
  • EXTERNAL – внешняя карта
  • EXTERNAL_COUPON - внешний купон (используется для плагинов внешних процессингов)
  • INTERNAL – внутренняя карта
  • PRESENT – подарочная карта
  • UNIQUE_COUPON – несерийный купон
  • UNKNOWN – другая карта
Нет

number

String

Номер карты

Да
guidStringGUID картыНет
addedByString

Способ добавления карты/купона

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

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

10.3.4.0

  • HAND (0) - Вводом вручную;
  • SCANNER (1) - Сканированием штрихкода;
  • MSR (2) - Прокатыванием через магнитный карт ридер;
  • PHONE (3) - Через мобильный телефон владельца;
  • ECARD (4) - Сканированием электронной карты;
  • ECOUPON (5) - Сканированием электронного купона.
Нет

Ссылка на  оригинальный чек продажи <original-purchase>

Заполняется только для чеков возврата: хранит ссылку на оригинальный чек продажи.

purchases/purchase/original-purchase

Наименование атрибута

Тип данных

Описание

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

tabNumber

String

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

Нет
returndayindayBooleanПризнак для чека возврата "День в день"Нет
usernameStringИмя кассираНет
operationTypeBooleanТип операцииНет

operDay

Date

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

Да

shop

Long

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

Да

cash

Long

Номер кассы

Да

shift

Long

Номер смены

Да
number

Long

Номер чекаДа
saletimeDateTimeДата/Время продажиНет

begintime

DateTime

Дата создания чека (добавления первого товара)

Нет

amount

Decimal

Сумма чека

Нет

discountAmount

Decimal

Сумма скидки на чек

Нет
innStringИНН юридического лица в сменеНет

Алкогольные позиции с акцизными марками <exciseBottles>

purchases/purchase/exciseBottles

Наименование атрибута

Тип данных

Описание

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

barcode

String

Штрих-код алкогольного товара

Нет

exciseBarcode

String

Штрих-код акцизной марки бутылки

Нет

setBarcode

String

Штрих-код промонабора, в составе которого была продана бутылка

Нет

volume

Double

Объем бутылки

Нет

price

Decimal

Цена бутылки

Нет

Список скидок <discount>

purchases/purchase/discount

Наименование атрибута

Тип данных

Описание

Обязательное
positionIdLongПорядковый номер позиции на которую распространяется данная скидка, если 0-то скидка на чекДа
goodCodeStringКод товара (из позиции) по которой было начислениеНет
amountDecimalСумма скидки (по позиции/чеку), в "рублях"Да
isDiscountPurchaseBooleanПризнак того что скидка распространяется на весь чекДа
AdvertActGUIDLongИдентификатор рекламной акцииДа
AdvertActExternalCodeStringВнешний код рекламной акцииНет
AdvertActDiscountTypeString

Тип скидки.

Также с точки зрения Set5

  • -1 - остальные скидки, не указанные в списке;
  • 5 - применение 3 цены из справочника;
  • 9 - процентная скидка на чек;
  • 10 - присутствует плагин условия: внутренняя карта + РА типа "скидка на товары", либо "фиксированная цена";
  • 16 - ручная скидка на позицию;
  • 20 - скидка по банковскому продукту;
    • SR-4644 - Получение подробных данных проблемы… СТАТУС
    • CR-5074 - Получение подробных данных проблемы… СТАТУС
    • 10.2.97.0
  • 30 - скидка по бонусам;
  • 31 - скидка на товары, где количество строк > 1;
  • 35 - применение 4 цены из справочника;
  • 38 - любая скидка на набор;
  • 65 - присутствует плагин условия по часам;
  • 66 - скидка на округление;
  • 99 - применение 2 цены из справочника;
  • 140 - скидка по купонингу;
  • 141 - скидка по позиционному купонингу;
  • 202 - применение 5 цены из справочника;
Нет
advertTypeString

Тип/характер применённой скидки

Возможные значения:

  • BONUS_AEROFLOT_CFT - применение бонусов по программе "Аэрофлот бонусы" ЦФТ
  • BONUS_CFT - применение бонусов как скидки "Спасибо от Сбербанка"
  • BONUS_CFT_SELF - применение бонусов как скидки ЦФТ
  • BONUS_CRM - применение бонусов как скидки (процессинг через внешнюю CRM)
  • BONUS_INFORMIX - применение бонусов как скидки Informix
  • BONUS_KOPILKA - применение бонусов Копилка
  • BONUS_LENTA - Бо