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

Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 102 Next »

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

К оглавлению

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

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

Метод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 - Getting issue details... STATUS

SRTE-3562 - Getting issue details... STATUS

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 - Getting issue details... STATUS

SRTE-3562 - Getting issue details... STATUS

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 - Getting issue details... STATUS

SRTE-3562 - Getting issue details... STATUS

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 - Getting issue details... STATUS

10.2.80.0

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

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

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

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

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

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

-

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

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

10.2.66.0

SRTE-2030 - Getting issue details... STATUS

Поле

Тип данных

Описание

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

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

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 - Getting issue details... STATUS

10.2.54.0

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

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

Для увеличения или уменьшения периода хранения скидок в днях можно скорректировать в конфигурационном файле сервера параметр erpi.loy.transaction.clean.days.interval:

  • Linux: /var/lib/jboss/standalone/configuration/modules/erp-integration/ERPIntegration.properties
  • Windows: {Папка SetRetail10}\standalone\configuration\modules\erp-integration\ERPIntegration.properties

фшщвшфш-ыывуывывфыв

Получение информации о чеках и расчетов скидок по ним

МетодgetFullPurchasesByParams
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 - Getting issue details... STATUS

SRTE-2991 - Getting issue details... STATUS

10.2.92.0

Только для методов:

  • getNewPurchses(...)
  • getNewFullPurchases(...)

0 - размер не ограничен

SELECT add_property('SET_ERP_INTEGRATION', 'export.websevice.new.purchases.batch.size', '0', 'Ограничение размера пачки "новых" чеков возвращаемой вебсервисом. 0 - размер не ограничен.');

Методы веб-сервиса для экспорта нефискальных документов

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

Метод

getNonFiscalDocsByParams
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 - Getting issue details... STATUS

CR-8315 - Getting issue details... STATUS

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 - Getting issue details... STATUS

CR-3319 - Getting issue details... STATUS

Чеки <purchases>

purchases

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

Тип данных

Описание

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

purchase

Комплексный

Данные чека

Да

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

Тип данных

Описание

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

count

Long

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

Нет

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

purchases/purchase

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

Тип данных

Описание

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

tabNumber

String

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

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

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

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

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

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

SRTE-2953 - Getting issue details... STATUS

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 - Getting issue details... STATUS

10.2.89.0

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

Нет
fiscalDocNumString

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

SRTE-3135 - Getting issue details... STATUS

CR-4879 - Getting issue details... STATUS

10.2.93.0

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

Нет

storno


Boolean

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

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

SRTE-3562 - Getting issue details... STATUS

CR-5382 - Getting issue details... STATUS

10.2.99.0


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

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

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

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

Нет

status


Комплексный

Статус чека

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

SRTE-3562 - Getting issue details... STATUS

CR-5382 - Getting issue details... STATUS

10.2.99.0


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

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

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

Нет

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

Тип данных

Описание

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

positions

Комплексный

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

Да

payments

Комплексный

Оплаты

Да

discountCards

Комплексный

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

Нет

card

Комплексный

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

Нет

original-purchase

Комплексный

Оригинальный чек продажи для возвратного чека (purchaseType)

Нет

exciseBottles

Комплексный

Бутылки с акцизными марками

Нет
presentsКомплексныйВыданные подаркиНет
couponsКомплексный

Выданные купоны

SLS-1290 - Getting issue details... STATUS

SLS-1295 - Getting issue details... STATUS

CR-5582 - Getting issue details... STATUS

10.3.4.0

Нет
discountКомплексныйСписок скидок, сработавших в этом чекеНет
discountCardКомплексныйСписок дисконтных карт, примененных при оплате этого чекаНет
bonusesКомплексныйСписок бонусных транзакций, проведенных в этом чекеНет
plugin-propertyКомплексныйСписок "плагинных" (расширенных, не базовых) свойств этого чека.
Может отсутствовать.
Нет

Плагинные свойства чека <plugin-property>

purchases/purchase/plugin-property

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

Тип данных

Описание

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

key

String

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

Да

value

String

Значение плагинного свойства

Нет

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

SR-2709 - Getting issue details... STATUS

10.2.63.0

SetKit ◾️ Дополнительная информация о заказе в чеке

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

Описание

sc.num.[ИДЕНТИФИКАТОР_МЯГКОГО_ЧЕКА]

Идентификатор мягкого чека

value

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

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

KIT-122 - Getting issue details... STATUS

CR-4908 - Getting issue details... STATUS

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 - Getting issue details... STATUS

10.2.99.0

SR-5018 - Getting issue details... STATUS

10.3.3.0

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

PRINT_DISABLED

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

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

PROMO_PRINT_DISABLED

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

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

FORCED_PRINT

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

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

CLIENT_REQUISITES_TYPE

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

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

<purchases count="1">
    <purchase tabNumber="1" userName="Администраторов Администратор Администраторович" operationType="true" operDay="2019-06-24+03:00" shop="1782" cash="61" shift="1" number="2" saletime="2019-06-24T14:44:00.924+03:00" begintime="2019-06-24T14:43:29.727+03:00" amount="845.34" discountAmount="1268.04" inn="7802781104">
       <plugin-property key="PROMO_PRINT_DISABLED" value="true"/> 
       <plugin-property key="PRINT_DISABLED" value="true"/> 
       <plugin-property key="CLIENT_REQUISITES_TYPE" value="EMAIL"/>
          <positions>
            <position order="1" departNumber="351" goodsCode="45633" barCode="4607141313337" count="1.0" cost="28.8" nds="10.0" ndsSum="2.62" discountValue="0.0" costWithDiscount="28.8" amount="28.8" dateCommit="2020-07-27T15:11:02.463+03:00">
                <plugin-property key="countryName" value="Россия"/>
            </position>
        </positions>
        <payments>
            <payment typeClass="CashPaymentEntity" amount="90.0" description="Оплата наличными"/>
            <payment typeClass="CashChangePaymentEntity" amount="61.2" description=""/>
        </payments>
        <card type="EXTERNAL_COUPON" number="12620003"/>
    </purchase>
 </purchases>

Данные отложенного чека

SRTB-5270 - Getting issue details... STATUS

CR-5382 - Getting issue details... STATUS

10.3.1.0

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

Описание

PURCHASE_DEFERRED

Признак отложенного чека

value

Содержание отложенного чека в формате JSON

Пример чека

Уникальный идентификатор экземпляра чека

SRTB-4485 - Getting issue details... STATUS

CR-2350 - Getting issue details... STATUS

10.2.91.0

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

Описание

UID_PURCHASE

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

value

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

Пример: 

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

Номер документа Пирит РБ

SRTZ-1091 - Getting issue details... STATUS

CR-5567 - Getting issue details... STATUS

10.3.2.0

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

Сквозной номер чека продажи / чека возврата / чека аннулирования от ФР Пирит РБ

Применяется в Республике Беларусь

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<purchases count="1">
    <purchase tabNumber="1" returndayinday="false" userName="Администраторов Администратор Администраторович" operationType="false" cashOperation="INCOME" operDay="2021-08-23+03:00" shop="2170" cash="60" shift="1" number="6" saletime="2021-08-24T00:36:03.555+03:00" begintime="2021-08-24T00:35:56.445+03:00" amount="10000.55" discountAmount="0.00" inn="7802781104" qrcode="t=20210824T0036&s=10000.55&fn=a0e1a01b-732b-41d1-b0f4-02f12e816163&i=6&fp=0&n=2" fiscalDocNum="6;6" status="REGISTERED">
        <plugin-property key="externalSystemId" value="21700601629754558486"/>
        <plugin-property key="FISCAL_DOC_ID" value="6"/>
        <plugin-property key="EXCISE_VALIDATION_REQUEST" value="{"id":5,"version":1,"shop":2170,"cash":60,"operationType":1,"checkNumber":"1.6","cancel":false,"creationDate":1629754556445,"productType":1,"data":[{"barcode":"33106180226082","item":"230106","productType":6,"mark":"0133106180226082216Уаw835qtKI0191XP7О92b5TЯЭЖxщNEKИYDiq2Е9TВ3NmUIRUтsЙЮwcT709ЙюбVpк"}]}"/>
        <plugin-property key="EXCISE_VALIDATION_TYPE" value="SetMarkCentrum"/>
        <positions>
            <position order="1" departNumber="1" goodsCode="230106" barCode="33106180226082" count="1.000" cost="10000.55" nds="20.0" ndsSum="1666.76" discountValue="0.00" costWithDiscount="10000.55" amount="10000.55" dateCommit="2021-08-24T00:35:56.460+03:00" insertType="0">
                <plugin-property key="rccw" value="276"/>
                <plugin-property key="countryName" value="Германия"/>
                <plugin-property key="markValidationResult" value="{"fiscalResult":{"input":{},"tag2106":15,"tag2005":15,"tag2105":0,"tag2109":1},"status":"VALID"}"/>
                <plugin-property key="gtdNumber" value="1234567"/>
                <plugin-property key="excise-token" value="0133106180226082216Уаw835qtKI01"/>
                <plugin-property key="marktype" value="TYRES"/>
            </position>
        </positions>
        <payments>
            <payment typeClass="CashPaymentEntity" amount="10000.55" description="Оплата наличными"/>
        </payments>
    </purchase>
</purchases>

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

purchases/purchase/positions

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

Тип данных

Описание

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

position

String

Позиции чека

Да

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

purchases/purchase/positions/position

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

Тип данных

Описание

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

order

Long

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

Да

departNumber

Long

Номер отдела

Да

goodsCode

String

Код товара

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

Да

barCode

String

ШК товара

Да

count

Decimal

Количество

Да

cost

Decimal

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

Да

nds

Decimal

Значение НДС

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

ndsSum

Decimal

Сумма НДС

Да

discountValue

Decimal

Сумма скидки

Да

costWithDiscount

Decimal

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

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

dateCommit

DateTime

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

Да

insertType

Integer

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

  • 0 - Сущность была проидентифицирована и добавлена в чек после сканирования ее ШК - SCANNER('S')
  • 1 - Строка поиска для идентификации сущности была введена вручную - HAND('H')
  • 2 - Товар найден из меню - MENU('M')
  • 3 - Товар найден из справочника - DIRECTORY('D')
  • 4 - Товар найден ручным вводом штрихкода - BARCODEBYHAND('B’)
  • 5 - Товар найден из справочника поиском по цене - DIRECTORYBYPRICE('P')
  • 6 - Товар найден нажатием клавиатурной кнопки - KEY('K')
  • 7 - Сущность была проидентифицирована по содержимому ее магнитной дорожки - MSR('R')
  • 8 - Сущность была добавлена через FLMS - ADD_BY_FLMS(‘F’)
  • 9 - Добавлено через RFID считыватель ADD_BY_RFID(‘l’)
  • 10 - Товар был добавлен из сервиса заказов SetKit - ORDER (‘O’)
    • KIT-79 - Getting issue details... STATUS
    • 10.2.84.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 - Getting issue details... STATUS

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 - Getting issue details... STATUS

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

Описание

beforeManualPrice

Цена товара перед изменением

Причина изменения цены товара

10.2.70.0

SRTB-3193 - Getting issue details... STATUS

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

Описание

changePriceReason

Код причины изменения товара

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<purchases count="1">
    <purchase tabNumber="2" userName="Петрова Лидия Борисовна" operationType="true" operDay="2019-08-01+03:00" shop="3382" cash="1" shift="39" number="3" saletime="2019-08-01T18:22:00.842+03:00" begintime="2019-08-01T18:21:47.862+03:00" amount="15.0" discountAmount="0.0" inn="123456789000">
        <positions>
            <position order="1" departNumber="583" goodsCode="45034" barCode="4810167000258" count="1.0" cost="15.0" nds="20.0" ndsSum="2.5" discountValue="0.0" costWithDiscount="15.0" amount="15.0" dateCommit="2019-08-01T18:21:47.908+03:00">
                <plugin-property key="seller" value="102"/>
                <plugin-property key="beforeManualPrice" value="18.00"/>
                <plugin-property key="countryName" value="Россия"/>
                <plugin-property key="changePriceReason" value="1"/>
            </position>
        </positions>
        <payments>
            <payment typeClass="CashChangePaymentEntity" amount="5.0" description=""/>
            <payment typeClass="CashPaymentEntity" amount="20.0" description="Оплата наличными"/>
        </payments>
    </purchase>
</purchases>
Комплект товаров

10.2.75.0

SRTE-2338 - Getting issue details... STATUS

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

Описание

kitBarcode

Штрих-код комплекта товаров

  • Комплект, как отдельная позиция, в таблице позиций чека - не сохраняется.

  • Товары, входящие в комплект, сохраняются в таблице позиций чека как самостоятельные товары, но с обязательным сохранением ссылки на комплект.

  • Самостоятельные товары, совпадающие с товарами входящими в комплект, не группируются и сохраняются отдельными позициями.

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<purchases count="1">
    <purchase tabNumber="2123123123" userName="Иванов Иван Иванович" operationType="true" operDay="2019-11-06+03:00" shop="3382" cash="1" shift="59" number="4" saletime="2019-11-07T11:34:03.130+03:00" begintime="2019-11-07T11:33:51.348+03:00" amount="603.6" discountAmount="0.0" inn="123456789000">
        <positions>
            <position order="3" departNumber="583" goodsCode="45034" barCode="4810167000258" count="1.0" cost="18.0" nds="20.0" ndsSum="3.0" discountValue="0.0" costWithDiscount="18.0" amount="18.0" dateCommit="2019-11-07T11:33:54.821+03:00">
                <plugin-property key="kitBarcode" value="111111"/>
                <plugin-property key="countryName" value="Россия"/>
            </position>
            <position order="1" departNumber="583" goodsCode="45033" barCode="4607141310331" count="2.0" cost="40.8" nds="10.0" ndsSum="7.42" discountValue="0.0" costWithDiscount="40.8" amount="81.6" dateCommit="2019-11-07T11:33:51.459+03:00">
                <plugin-property key="kitBarcode" value="111111"/>
                <plugin-property key="countryName" value="Россия"/>
            </position>
            <position order="2" departNumber="582" goodsCode="45035" barCode="4607145132038" count="3.0" cost="168.0" nds="20.0" ndsSum="84.0" discountValue="0.0" costWithDiscount="168.0" amount="504.0" dateCommit="2019-11-07T11:33:54.696+03:00">
                <plugin-property key="kitBarcode" value="111111"/>
                <plugin-property key="countryName" value="Россия"/>
            </position>
        </positions>
        <payments>
            <payment typeClass="CashChangePaymentEntity" amount="96.4" description=""/>
            <payment typeClass="CashPaymentEntity" amount="700.0" description="Оплата наличными"/>
        </payments>
    </purchase>
</purchases>
Datamatrix-код (маркированные товары)

10.2.86.0

SRTE-2734 - Getting issue details... STATUS

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

Описание

excise-token

Datamatrix-код

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

10.2.86.0

SRTE-2734 - Getting issue details... STATUS

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

Описание

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 - Getting issue details... STATUS

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

Описание

social

Продукт социальный

socialPayPossibleПродукт можно оплатить социальной картой
mptProductCode

Код продукта или группы установленный МинПромТоргом

Код продукта или группы соответствии с классификатором МЕГАР

mptProductName

Наименование продукта или группы установленное МинПромТоргом

Наименование продукта или группы в соответствии с классификатором МЕГАР

mptMeasureCode

Код единицы измерения установленный МинПромТоргом

Код единицы измерения в соответствии с классификатором МЕГАР

mptQuantity

Количество в ед.измерения установленных МинПромТоргом

Количество в единице измерения установленныез в соответствии с классификатором МЕГАР

Признак передачи кода товара в ОФД для СИЗ (Средства индивидуальной защиты)

10.2.86.0

SRTB-4261 - Getting issue details... STATUS

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

Описание

ofdCodeШтрих-код товара для передачи в ОФД
ofdCodeMandatoryПризнак передачи кода товара в ОФД
Пример чека с проданным товаром СИЗ
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<purchases count="1">
    <purchase tabNumber="1" userName="Иванов Иван Иванович" operationType="true" operDay="2020-07-27+03:00" shop="3382" cash="1" shift="82" number="3" saletime="2020-07-27T15:11:08.186+03:00" begintime="2020-07-27T15:11:02.388+03:00" amount="28.8" discountAmount="0.0" inn="7802781104">
        <positions>
            <position order="1" departNumber="351" goodsCode="45633" barCode="4607141313337" count="1.0" cost="28.8" nds="10.0" ndsSum="2.62" discountValue="0.0" costWithDiscount="28.8" amount="28.8" dateCommit="2020-07-27T15:11:02.463+03:00">
                <plugin-property key="ofdCode" value="4607141313337"/>
                <plugin-property key="ofdCodeMandatory" value="true"/>
                <plugin-property key="countryName" value="Россия"/>
            </position>
        </positions>
        <payments>
            <payment typeClass="CashPaymentEntity" amount="90.0" description="Оплата наличными"/>
            <payment typeClass="CashChangePaymentEntity" amount="61.2" description=""/>
        </payments>
    </purchase>
</purchases>
Налог с продаж (НСП)

10.2.98.0

SR-4735 - Getting issue details... STATUS

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

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

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

Киргизия ◾️ Налог с продаж (НСП)

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

SRTB-5063 - Getting issue details... STATUS

CR-5651 - Getting issue details... STATUS

10.2.99.0

Наименование плагинного свойстваОписание
traceableПризнак к товару, подлежащему прослеживаемости РНПТ (регистрационный номер партии товара)
declared

Признак к товару, импортированному или экспортированному (ДТ, ранее ГТД)

ДТ - декларация на товар.

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<purchases count="1">
	<purchase tabNumber="1" userName="Администраторов Администратор Администраторович" operationType="true" cashOperation="INCOME" operDay="2021-05-17+03:00" shop="2240" cash="61" shift="1" number="4" saletime="2021-05-17T13:32:15.868+03:00" begintime="2021-05-17T13:31:55.870+03:00" amount="601.00" discountAmount="0.00" inn="7802781104" fiscalDocNum="4;4">
		<plugin-property key="externalSystemId" value="22400611621247532159"/>
		<plugin-property key="UID_PURCHASE" value="c200e05d-b0ab-4994-be09-5513756e7431"/>
		<positions>
			<position order="2" departNumber="1" goodsCode="25555555558" barCode="25555555558" count="1.000" cost="300.50" nds="20.0" ndsSum="50.08" discountValue="0.00" costWithDiscount="300.50" amount="300.50" dateCommit="2021-05-17T13:32:10.148+03:00" insertType="1">
				<plugin-property key="traceable" value="true"/>
			</position>
			<position order="1" departNumber="1" goodsCode="87777771" barCode="87777771" count="1.000" cost="300.50" nds="20.0" ndsSum="50.08" discountValue="0.00" costWithDiscount="300.50" amount="300.50" dateCommit="2021-05-17T13:31:55.876+03:00" insertType="1">
				<plugin-property key="declared" value="true"/>
			</position>
		</positions>
		<payments>
			<payment typeClass="CashPaymentEntity" amount="601.0" description="Оплата наличными"/>
		</payments>
	</purchase>
</purchases>
Признак передачи ГТД

10.3.2.0

SRTB-5394 - Getting issue details... STATUS

SRTB-5203 - Getting issue details... STATUS

Наименование плагинного свойстваОписание
rccwКод из общероссийского классификатора стран мира/Код страны происхождения

gtdNumber

Номер Таможенной Декларации

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<purchases count="1">
    <purchase tabNumber="1" returndayinday="false" userName="Администраторов Администратор Администраторович" operationType="false" cashOperation="INCOME" operDay="2021-08-23+03:00" shop="2170" cash="60" shift="1" number="6" saletime="2021-08-24T00:36:03.555+03:00" begintime="2021-08-24T00:35:56.445+03:00" amount="10000.55" discountAmount="0.00" inn="7802781104" qrcode="t=20210824T0036&s=10000.55&fn=a0e1a01b-732b-41d1-b0f4-02f12e816163&i=6&fp=0&n=2" fiscalDocNum="6;6" status="REGISTERED">
        <plugin-property key="externalSystemId" value="21700601629754558486"/>
        <plugin-property key="FISCAL_DOC_ID" value="6"/>
        <plugin-property key="EXCISE_VALIDATION_REQUEST" value="{"id":5,"version":1,"shop":2170,"cash":60,"operationType":1,"checkNumber":"1.6","cancel":false,"creationDate":1629754556445,"productType":1,"data":[{"barcode":"33106180226082","item":"230106","productType":6,"mark":"0133106180226082216Уаw835qtKI0191XP7О92b5TЯЭЖxщNEKИYDiq2Е9TВ3NmUIRUтsЙЮwcT709ЙюбVpк"}]}"/>
        <plugin-property key="EXCISE_VALIDATION_TYPE" value="SetMarkCentrum"/>
        <positions>
            <position order="1" departNumber="1" goodsCode="230106" barCode="33106180226082" count="1.000" cost="10000.55" nds="20.0" ndsSum="1666.76" discountValue="0.00" costWithDiscount="10000.55" amount="10000.55" dateCommit="2021-08-24T00:35:56.460+03:00" insertType="0">
                <plugin-property key="rccw" value="276"/>
                <plugin-property key="countryName" value="Германия"/>
                <plugin-property key="markValidationResult" value="{"fiscalResult":{"input":{},"tag2106":15,"tag2005":15,"tag2105":0,"tag2109":1},"status":"VALID"}"/>
                <plugin-property key="gtdNumber" value="1234567"/>
                <plugin-property key="excise-token" value="0133106180226082216Уаw835qtKI01"/>
                <plugin-property key="marktype" value="TYRES"/>
            </position>
        </positions>
        <payments>
            <payment typeClass="CashPaymentEntity" amount="10000.55" description="Оплата наличными"/>
        </payments>
    </purchase>
</purchases>
ФФД 1.2 - Результат валидации марки (Результат проверки КМ в ФР)

10.2.99.0

SRTB-754 - Getting issue details... STATUS

CR-5247 - Getting issue details... STATUS

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

Результат валидации марки (Результат проверки КМ в ФР)

Пример: 

<plugin-property key="markValidationResult" value="{
	"fiscalResult":{"input":{},
	"tag2106":15,
	"tag2005":15,
	"tag2105":0,
	"tag2109":1},
	"status":"VALID"
}"/>
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<purchases count="1">
    <purchase tabNumber="1" returndayinday="false" userName="Администраторов Администратор Администраторович" operationType="false" cashOperation="INCOME" operDay="2021-08-23+03:00" shop="2170" cash="60" shift="1" number="6" saletime="2021-08-24T00:36:03.555+03:00" begintime="2021-08-24T00:35:56.445+03:00" amount="10000.55" discountAmount="0.00" inn="7802781104" qrcode="t=20210824T0036&s=10000.55&fn=a0e1a01b-732b-41d1-b0f4-02f12e816163&i=6&fp=0&n=2" fiscalDocNum="6;6" status="REGISTERED">
        <plugin-property key="externalSystemId" value="21700601629754558486"/>
        <plugin-property key="FISCAL_DOC_ID" value="6"/>
        <plugin-property key="EXCISE_VALIDATION_REQUEST" value="{"id":5,"version":1,"shop":2170,"cash":60,"operationType":1,"checkNumber":"1.6","cancel":false,"creationDate":1629754556445,"productType":1,"data":[{"barcode":"33106180226082","item":"230106","productType":6,"mark":"0133106180226082216Уаw835qtKI0191XP7О92b5TЯЭЖxщNEKИYDiq2Е9TВ3NmUIRUтsЙЮwcT709ЙюбVpк"}]}"/>
        <plugin-property key="EXCISE_VALIDATION_TYPE" value="SetMarkCentrum"/>
        <positions>
            <position order="1" departNumber="1" goodsCode="230106" barCode="33106180226082" count="1.000" cost="10000.55" nds="20.0" ndsSum="1666.76" discountValue="0.00" costWithDiscount="10000.55" amount="10000.55" dateCommit="2021-08-24T00:35:56.460+03:00" insertType="0">
                <plugin-property key="rccw" value="276"/>
                <plugin-property key="countryName" value="Германия"/>
                <plugin-property key="markValidationResult" value="{"fiscalResult":{"input":{},"tag2106":15,"tag2005":15,"tag2105":0,"tag2109":1},"status":"VALID"}"/>
                <plugin-property key="gtdNumber" value="1234567"/>
                <plugin-property key="excise-token" value="0133106180226082216Уаw835qtKI01"/>
                <plugin-property key="marktype" value="TYRES"/>
            </position>
        </positions>
        <payments>
            <payment typeClass="CashPaymentEntity" amount="10000.55" description="Оплата наличными"/>
        </payments>
    </purchase>
</purchases>

Оплаты <payments>

purchases/purchase/payments

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

Тип данных

Описание

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

payment

Комплексный

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

Да

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

purchases/purchase/payments/payment

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

Тип данных

Описание

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

typeClass

String

Тип оплаты:

  • CashPaymentEntity – наличные;
  • CashChangePaymentEntity – сдача;
  • BankCardPaymentEntity – безналичный;
  • GiftCardPaymentEntity – подарочная карта;
  • ConsumerCreditPaymentEntity – потребительский кредит
  • ExternalBankTerminalPaymentEntity — внешний банковский терминал
  • BonusCardPaymentEntity — оплата бонусами;
  • BonusSberbankPaymentEntity – Бонусная карта Сбербанка
  • CFTGiftCardPaymentEntity — Оплата по подарочной карте ЦФТ
  • ChildrenCardPaymentEntity – оплата Детской картой
Да

amount

Decimal

сумма

Да

description

String

описание

Да

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

Тип данных

Описание

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

plugin-property

Комплексный

Плагинные свойства оплаты

Да
Плагинные свойства оплаты <plugin-property>

purchases/purchase/payments/payment/plugin-property

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

Тип данных

Описание

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

key

String

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

Да

value

String

Значение плагинного свойства

Нет
Банковская карта

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

Описание

cash.transaction.id

Номер транзакции

terminal.numberНомер терминала
cash.transaction.dateДата и время выполнения транзакции
bank.slip

Полный текст банковского слипа в формате BASE64

SRTE-3404 - Getting issue details... STATUS

CR-5316 - Getting issue details... STATUS

10.2.97.0

Для включения экспорта текста банковского слипа выполните скрипт в базе данных сервера set → перезапустите службу сервера приложений JBOSS_SVC.

UPDATE public.sales_management_properties
   SET property_value='true', 
WHERE property_key='need.send.bankslip.toERPI';

Пример экспорта текста банковского слипа.

bank.idНазвание банка/процессинга
card.typeТип карты
auth.codeКод авторизации
bank.typeТип банка-эмитента (для программы «Спасибо от Сбербанка»)
card.numberНомер карты (маскированный)

card.hash

Хэш-код карты (для программы «Спасибо от Сбербанка»)

ref.number

SRTE-2121 - Getting issue details... STATUS

10.2.70.0

RRN (Reference Retrieval Number) номер транзакции оплаты

cashout.amount

CR-3746 - Getting issue details... STATUS

10.2.96.0

Сумма выдачи наличных

Подробнее в SetRetail10 ◾️ Mastercard ◾️ Выдача наличных на кассе.

loyalty.program.codeКод банковской программы лояльности
card.number.hashХэш-код номера карты
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<purchases count="1">
    <purchase tabNumber="1" userName="Администраторов Администратор Администраторович" operationType="true" operDay="2019-06-24+03:00" shop="1782" cash="61" shift="1" number="2" saletime="2019-06-24T14:44:00.924+03:00" begintime="2019-06-24T14:43:29.727+03:00" amount="845.34" discountAmount="1268.04" inn="7802781104">
        <plugin-property key="externalSystemId" value="17820611561376626271"/>
        <positions>
            <position order="2" departNumber="1" goodsCode="03001" barCode="4903001000009" count="3.0" cost="404.23" nds="20.0" ndsSum="80.85" discountValue="727.62" costWithDiscount="161.69" amount="485.07" dateCommit="2019-06-24T14:43:32.504+03:00">
                <plugin-property key="countryName" value="Япония"/>
            </position>
            <position order="1" departNumber="1" goodsCode="02003" barCode="8402003000001" count="3.0" cost="300.23" nds="20.0" ndsSum="60.05" discountValue="540.42" costWithDiscount="120.09" amount="360.27" dateCommit="2019-06-24T14:43:29.745+03:00">
                <plugin-property key="countryName" value="Испания"/>
            </position>
        </positions>
        <payments>
            <payment typeClass="BankCardPaymentEntity" amount="345.34" description="Оплата по банковской карте">
                <plugin-property key="card.hash" value="null"/>
                <plugin-property key="cash.transaction.id" value="105010"/>
                <plugin-property key="terminal.number" value="10000001"/>
                <plugin-property key="cash.transaction.date" value="2019-06-24 14:43:59.860"/>
                <plugin-property key="bank.id" value="Сбербанк"/>
                <plugin-property key="ref.number" value="961275736427"/>
                <plugin-property key="card.type" value="VISA"/>
                <plugin-property key="auth.code" value="255202"/>
                <plugin-property key="bank.type" value="UNKNOWN"/>
                <plugin-property key="card.number" value="************7438"/>
            </payment>
            <payment typeClass="CashPaymentEntity" amount="500.0" description="Оплата наличными"/>
        </payments>
        <discountCards>
            <discountCard>12620003</discountCard>
        </discountCards>
        <card type="INTERNAL" number="12620003"/>
    </purchase>
</purchases>
Оплата QR-кодом

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

Описание

sberbank_qr.id.qr

Уникальный идентификатор QR-кода, выданный СБП или Сбербанком при его генерации

Максимальная длина = 20

Только для Сбербанка

terminal.number

Номер терминала

Только для Сбербанка

cash.transaction.idИдентификатор операции платежа
cash.transaction.dateДата и время выполнения транзакции
bank.idНазвание банка/процессинга
ref.number

SRTE-2121 - Getting issue details... STATUS

10.2.70.0

RRN (Reference Retrieval Number) номер транзакции оплаты

Только для Сбербанка

merchant.idУникальный идентификатор партнёра, выданный СБП или Сбербанком
order.idУникальный идентификатор заказа в системе партнёра
operation.idИдентификатор операции
auth.code

Код авторизации

Только для Сбербанка

Пример чека с данными по транзакции Сбербанк
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<purchases count="1">
    <purchase returndayinday="true" tabNumber="09876" userName="Иванов Станислав Тарасович" operationType="false" operDay="2020-08-12+03:00" shop="234" cash="9" shift="1" number="5" saletime="2020-08-12T15:41:59.501+03:00" begintime="2020-08-12T15:41:53.081+03:00" amount="0.16" discountAmount="0.03" inn="7802781104">
        <positions>
            <position order="1" departNumber="581" goodsCode="45032" barCode="2300169" count="0.001" cost="189.7" nds="20.0" ndsSum="0.03" discountValue="0.03" costWithDiscount="160.0" amount="0.16" dateCommit="2020-08-12T15:41:53.090+03:00">
                <plugin-property key="countryName" value="Россия"/>
            </position>
        </positions>
        <payments>
            <payment typeClass="BankQRPaymentEntity" amount="0.16" description="Оплата по QR-коду">
                <plugin-property key="sberbank_qr.id.qr" value="20306"/>
                <plugin-property key="terminal.number" value="21342923"/>
                <plugin-property key="cash.transaction.id" value="105020"/>
                <plugin-property key="cash.transaction.date" value="2020-08-12 15:42:02.000"/>
                <plugin-property key="bank.id" value="QR Сбербанк"/>
                <plugin-property key="ref.number" value="302602845102"/>
                <plugin-property key="merchant.id" value="00000016"/>
                <plugin-property key="order.id" value="2a6e1853f94b4fcfa8ca941eaf8b4a1a"/>
                <plugin-property key="operation.id" value="3582a60bcc9b4b449b7928dea912f035"/>
                <plugin-property key="auth.code" value="845102"/>
            </payment>
        </payments>
        <original-purchase operDay="2020-08-12+03:00" shop="234" cash="9" shift="1" number="4" saletime="2020-08-12T15:41:07.364+03:00"/>
    </purchase>
</purchases>


Пример чека с данными по транзакции Райффайзен СБП
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<purchases count="1">
    <purchase tabNumber="333" userName="Петрова Лидия Ивановна" operationType="true" operDay="2020-08-12+03:00" shop="234" cash="1" shift="2" number="12" saletime="2020-08-12T21:14:16.402+03:00" begintime="2020-08-12T21:13:37.725+03:00" amount="50.0" discountAmount="0.0" inn="7801111101">
        <positions>
            <position order="1" departNumber="583" goodsCode="45033" barCode="4607141310331" count="1.0" cost="50.0" nds="10.0" ndsSum="4.55" discountValue="0.0" costWithDiscount="50.0" amount="50.0" dateCommit="2020-08-12T21:13:37.732+03:00">
                <plugin-property key="countryName" value="Россия"/>
            </position>
        </positions>
        <payments>
            <payment typeClass="BankQRPaymentEntity" amount="50.0" description="Оплата по QR-коду">
                <plugin-property key="cash.transaction.id" value="110060"/>
                <plugin-property key="cash.transaction.date" value="2020-08-12 21:13:45.432"/>
                <plugin-property key="bank.id" value="Райффайзенбанк СБП"/>
                <plugin-property key="merchant.id" value="MA0000002371"/>
                <plugin-property key="order.id" value="6493ec4e-8f96-4d8b-a1a4-166dddef17e6"/>
                <plugin-property key="operation.id" value="24430"/>
            </payment>
        </payments>
    </purchase>
</purchases>
Внешний банковский терминал

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

Описание

purchase.number

Номер чека терминала

card.number

Последние 4 цифры номера карты

auth.code

Код авторизации

Потребительский кредит

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

Описание

contract.bank

Название банка

contract.bank.product

Название продукта банка

consumer.name

Имя клиента

contract.number

Номер договора

Подарочная карта

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

Описание

gift.card.number

Номер подарочной карты

Подарочная карта ЦФТ

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

Описание

amount

Сумма активации карты

activationTransactionId

Внешний идентификатор

activationDateTime

Дата и время выполнения транзакции

clientIDType

Тип идентификатора карты в транзакции (clientIDType 2 – track2; 4 – barcode)

clientID

Идентификатор карты в транзакции

partnerID

Идентификатор партнера

location

Идентификатор точки

terminal

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

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

purchases/purchase/discountCards/discountCard

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

Тип данных

Описание

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

discountCard

String

Номер карты

Нет

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

purchases/purchase/card

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

Тип данных

Описание

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

type

String

Тип карты:

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

number

String

Номер карты

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

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

SLS-1290 - Getting issue details... STATUS

CR-5582 - Getting issue details... STATUS

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 - Getting issue details... STATUS
    • CR-5074 - Getting issue details... STATUS
    • 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 - Бонусы Лента
  • BONUS_LOYMAX - применение бонусов LoyMax
  • BONUS_PT - применение бонусов как скидки Plas Tek
  • BONUS_SIEBEL - применение бонусов Siebel CRM
  • BONUS_SR10 - применение бонусов как скидки SetRetail10
  • DEFAULT - неопределено
  • DISCOUNT - обычная скидка: сумма, проценты
  • DISCOUNT_CARD - скидка по дисконтной карте
  • DISCOUNT_GOODS - скидка на товары
  • FIX_PRICE - фиксированная цена
  • FZ54_CORRECTING - коррекция после отработки проверок ФЗ-54
  • GIFT - выдача подарка
  • SECOND_PRICE - цена из справочника (2, 3, 4, 5)
  • SET_GOODS - товарный набор
  • TOKENS_LENTA - электронные фишки
  • TOKENS_SR10 - фишки SetRetail10
  • VKUSOMANIA - вкусомания (Азбука вкуса)
Да
quantityDecimalКоличество товара, на которое сработала скидкаНет
card-numberStringНомер карты (или купона), по которому сработала скидка на эту позициюНет
transactionIdStringИдентификатор транзакции списания бонусов (если скидка была бонусной CFT или Spasibo)Нет
externalActionIdStringИдентификатор акции внешней системыНет

Список дисконтных карт <discountCard>

purchases/purchase/discountCard

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

Тип данных

Описание

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

discountCard

String

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

Нет

Список бонусных транзакций <bonuses>

purchases/purchase/bonuses

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

Тип данных

Описание

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

chargeOnBonuses

Комплексный

Список бонусных транзакций начисления, проведенных в этом чеке

Нет
writeOffBonusesКомплексныйСписок бонусных транзакций списания, проведенных в этом чекеНет

Транзакции начисления <chargeOnBonuses>

purchases/purchase/bonuses/chargeOnBonuses

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

Тип данных

ОписаниеОбязательное
transactionIdStringИдентификатор транзакцииДа
bonusesTypeString

Тип бонусного процессинга

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

  • BONUS_AEROFLOT_CFT - Бонусы по программе "Аэрофлот бонусы" ЦФТ
  • BONUS_CFT - Бонусы CFT, но не "Спасибо от Сбербанка"
  • BONUS_INFORMIX - Бонусы Informix ЛЕНТА
  • BONUS_KOPILKA - Бонусы Копилка
  • BONUS_LOYMAX - Бонусы Loymax
  • BONUS_ROSBANK - Бонусы ко-брендинга Росбанк-ОКЕЙ
  • BONUS_SIEBEL - Бонусы Siebel
  • BONUS_SR10 - Бонусы SetRetail10
  • CFT - Бонусы CFT "Спасибо от Сбербанка"
  • CRM - Бонусы CRM
  • PT - Бонусы Plas Tek
  • SET_API - Бонусы плагинов SetAPI
  • TOKEN_SIEBEL - Марки Siebel
  • TOKENS_LENTA - Фишки ЛЕНТА
    • SR-3733 - Getting issue details... STATUS
    • 10.2.84.0
  • TOKENS_SET_API - Фишки плагинов SetAPI
  • TOKENS_SET5 - Марки SetRetail5
  • TOKENS_SR10 - Фишки, марки SetRetail10
Да
amountDecimalСумма транзакцииДа
cardNumberStringНомер картыДа
bonusaccountsidLongID бонусного счетаНет
AdvertActExternalCodeStringВнешний код АкцииНет
AdvertActDiscountTypeStringКод типа акцииНет
AdvertActGUIDLongGUID акцииНет

Транзакции списания <writeOffBonuses>

purchases/purchase/bonuses/writeOffBonuses

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

Тип данных

ОписаниеОбязательное
transactionIdStringИдентификатор транзакцииДа
bonusesTypeStringТип бонусного процессингаДа
amountDecimalСумма транзакцииДа
cardNumberStringНомер картыДа
bonusaccountsidLongID бонусного счетаНет
AdvertActExternalCodeStringВнешний код АкцииНет
AdvertActDiscountTypeStringКод типа акцииНет
AdvertActGUIDLongGUID акцииНет

Плагинные свойства чека <plugin-property>

purchases/purchase/plugin-property

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

Тип данных

Описание

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

key

String

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

Да

value

String

Значение плагинного свойства

Нет

Выданные подарки <presents>

purchases/purchase/presents

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

Тип данных

Описание

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

actionname

String

Название акции, в рамках которой был выдан подарок

Нет
externalcodeStringВнешний код акции, в рамках которой был выдан подарокНет
guidStringGUID акции, в рамках которой был выдан подарокНет
issuedIntegerОбщее количество выданных подарковНет
scannedIntegerОбщее количество просканированных подарковНет
Наименование элементаТип данныхОписаниеОбязательное
presentКомлексныйСписок подарковНет
actionLabelsКомплексныйМетки рекламной акцииНет
Пример отображения количества отсканированных подарков в XML
<?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

Расчетное количество "подарков" по условию

Нет
conditionStringИдентификатор условия (уникален в рамках РА), по которому производилось начисление/расчет количества подарков.Нет

Метки рекламаной акции <actionLables>

purchases/purchase/bonuses/actionLabels

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

Тип данных

Описание

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

label

String

Наименование метки рекламной акции

Нет

Выданные купоны <coupons>

https://crystals.atlassian.net/browse/SLS-1290

https://crystals.atlassian.net/browse/SLS-1295

CR-5582 - Getting issue details... STATUS

10.3.4.0

Включение экспорта:

Информация по управлению версиями веб-сервисов.

Модуль

Название параметра

Номер версии

SET_ERP_INTEGRATION

export.file.loyalty.version

1.6

SET_ERP_INTEGRATION

export.file.purchases.version

1.10

SET_ERP_INTEGRATION

export.set10wsclient.purchases.version

1.19

SET_ERP_INTEGRATION

fiscal.info.export.purchase.discount.document.schema.version

1.6

SET_ERP_INTEGRATION

fiscal.info.export.discounts.document.schema.version

1.6

/purchases/purchase/coupons/coupon

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

Тип данных

Описание

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

coupons

Комплексный

Выданные купоны

Нет

coupon

Комплексный

Выданный купон

Да

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

Тип данных

Описание

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

number

String

Номер купона

Нет

status

String

Статус купона

  • Issued - выдан

Нет

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&amp;s=120.70&amp;fn=00a81bdf-19eb-4037-914e-9e6cd4ea79b1&amp;i=13&amp;fp=0&amp;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&amp;s=109.70&amp;fn=00a81bdf-19eb-4037-914e-9e6cd4ea79b1&amp;i=9&amp;fp=0&amp;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>

  • No labels