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

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

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

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

Методы

processPurchases без обратной связи

processPurchasesWithTI - c обратной связью

URLhttp://Любой_IP-адрес_на стороне_ERP_сервера/Set10PurchasesService
WSDL

http://Любой_IP-адрес_на стороне_ERP_сервера/Set10PurchasesService.wsdl

Поле

Тип данных

Описание

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

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

purchases

base64Binary

Чеки в формате XML, закодированный в BASE64

Да

version

string

Версия xsd-схемы выдаваемых данных

Нет

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

return

boolean

True в случае успешной обработки пакета

Да

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

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

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

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

10.3.15.0

Методы

processCancelledPurchases без обратной связи

processCancelledPurchasesWithTI - c обратной связью

URLhttp://Любой_IP-адрес_на стороне_ERP_сервера/Set10PurchasesService
WSDLhttp://Любой_IP-адрес_на стороне_ERP_сервера/Set10PurchasesService.wsdl
ПолеТип данныхОписаниеОбязательное
Принимаемые параметры
purchasesbase64BinaryАннулированные чеки в формате XML, закодированный в BASE64Да
versionstringВерсия xsd-схемы выдаваемых данныхНет
Возвращаемые параметры
returnbooleanTrue в случае успешной обработки пакетаДа

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

Начиная с версии 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

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

Нет
denyPrintToDocumentsBooleanЗапрет печати сопроводительных документовНет
clientTypeКомплексный

Тип клиента:

  • JURISTIC_PERSON  - Юридическое лицо, к которому привязана карта юридического лица из категории неперсональных.
  • PRIVATE - Физическое лицо, или юридическое лицо, к которому привязана карта юридического лица из категории персональных.

Пример XML выгрузки чека юридического лица

Нет
client_guidLong

Код клиента

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

Нет
qrcodeString

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

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

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

10.2.89.0

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

Нет
fiscalDocNumString

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

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

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

10.2.93.0

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

Нет
factorynumString

Заводской номер

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

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

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

10.3.14.0

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

Нет
innString

ИНН

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

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

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

10.3.14.0

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

Нет
kppString

КПП

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

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

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

10.3.14.0

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

Нет

storno


Boolean

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

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

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

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

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

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

example.xml

Нет
fiscalnumString

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

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

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

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

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

10.3.17.0

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

Нет

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

Тип данных

Описание

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

positions

Комплексный

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

Да

payments

Комплексный

Оплаты

Да
discountsКомплексныйСписок скидок, сработавших в этом чекеНет

discountCards

Комплексный

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

Нет

card

Комплексный

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

Нет

original-purchase

Комплексный

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

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

exciseBottles

Комплексный

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


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

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

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

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

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

10.3.4.0


countersКомлексный

Счетчики

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

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

10.3.29.0

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

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

purchases/purchase/plugin-property

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

Тип данных

Описание

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

key

String

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

Да

value

String

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

Нет

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

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

Описание

upd

Номер УПД

debitor-numberНомер дебитора
<purchases count="2">
    <purchase tabNumber="23123" userName="Тестов Иван Иванович" operationType="true" operDay="2017-06-20+03:00" shop="3249" cash="1" shift="41" number="14" saletime="2017-06-21T13:09:21.853+03:00" begintime="2017-06-21T13:09:11.161+03:00" amount="17.0" discountAmount="0.0" denyPrintToDocuments="false" clientType="PRIVATE" client_guid="1462">
        <plugin-property key="upd" value="3249000000000022"/>
        <plugin-property key="debitor-number" value="21023801283"/>
        <positions>
            <position order="1" departNumber="583" goodsCode="45034" barCode="4810167000258" count="1.0" cost="17.0" nds="-1.0" ndsSum="0.0" discountValue="0.0" costWithDiscount="17.0" amount="17.0"/>
        </positions>
        <payments>
            <payment typeClass="CashPaymentEntity" amount="18.0" description="Оплата наличными"/>
            <payment typeClass="CashChangePaymentEntity" amount="1.0" description=""/>
        </payments>
        <discountCards>
            <discountCard>987654</discountCard>
        </discountCards>
        <card type="INTERNAL" card_type_guid="1286" number="987654"/>
        <bonus-discount/>
    </purchase>

Номер УКД

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

SetRetail10 ◾️ Печать УКД при возврате товара от юридических лиц

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

Описание

ukd

Номер УКД

<purchases count="2">
    <purchase tabNumber="1" userName="Cashier_2_last_name Cashier_2_first_name Cashier_2_middle_name" operationType="false" cashOperation="INCOME" operDay="2022-02-08+03:00" shop="2121" cash="2" shift="395" number="2" saletime="2022-02-08T22:35:45.831+03:00" begintime="2022-02-08T22:35:45.831+03:00" amount="81803.23" discountAmount="0.00" denyPrintToDocuments="false" clientType="PRIVATE" fiscalDocNum="test; refund1644348945829" status="REGISTERED">
        <plugin-property key="FISCAL_DOC_ID" value="0"/>
        <plugin-property key="upd" value="2121000000000087"/>
        <plugin-property key="ukd" value="2121000000000036"/>
        <positions>
            <position order="1" departNumber="0" goodsCode="00687" barCode="4600687000001" count="2.000" cost="103.41" nds="20.0" ndsSum="165.45" discountValue="0.00" costWithDiscount="413.64" amount="827.28" dateCommit="2022-02-08T22:35:45.831+03:00"/>            
        </positions>
        <payments>
            <payment typeClass="CashPaymentEntity" amount="827.28" description="Оплата наличными"/>
        </payments>
        <discountCards/>
        <original-purchase operDay="2022-02-08+03:00" shop="2121" cash="2" shift="395" number="1" saletime="2022-02-08T22:34:47.169+03:00"/>
        <bonus-discount/>
    </purchase>
</purchases>

Признак принадлежности к контрагенту

ТОЛЬКО ДЛЯ WEB-СЕРВИСА НА СТОРОНЕ ERP
SR-6143 - Получение подробных данных проблемы… СТАТУС
CR-8276 - Получение подробных данных проблемы… СТАТУС
10.3.23.0

 Выгрузка признака производится только при соединении с сервисом лояльности SLS.

Наименование плагинного свойстваОписание
CLIENT_COUNTERPARTY_CARDПризнак “корпоративной покупки”, который покажет есть ли у клиента (физического лица), для которого зарегистрирован чек, привязка к контрагенту (юридическому лицу).
value

Значение признака в формате <номер карты юрлица клиента>:<номер дебитора>

Пример чека

Дополнительная информация по мягкому чеку 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"/>
        </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>

Идентификатор покупки сервиса Scan&Go и SelfScan

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

10.2.84.0

ТОЛЬКО ДЛЯ WEB-СЕРВИСА НА СТОРОНЕ ERP

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

Описание

tripNumber

Наименование плагинного свойства сервиса Scan&Go и SelfScan

valueИдентификатор покупки
<purchase tabNumber="123456789" userName="Покупатель SCO SCO" operationType="true" operDay="2020-05-27+03:00" shop="5014" cash="6" shift="119" number="1" saletime="2020-05-27T10:57:05.208+03:00" begintime="2020-05-27T10:55:43.773+03:00" amount="1174.94" discountAmount="0.0" denyPrintToDocuments="false" clientType="PRIVATE">
    <plugin-property key="tripNumber" value="97098"/>
    <positions>
        <position order="1" departNumber="1" goodsCode="119839_ST" barCode="2000119839001" count="1.0" cost="119.99" nds="20.0" ndsSum="20.0" discountValue="0.0" costWithDiscount="119.99" amount="119.99" insertType="8"/>
        <position order="2" departNumber="1" goodsCode="164808_ST" barCode="2000164808007" count="1.0" cost="15.0" nds="20.0" ndsSum="2.5" discountValue="0.0" costWithDiscount="15.0" amount="15.0" insertType="8"/>
        <position order="3" departNumber="1" goodsCode="228390_ST" barCode="4680000233736" count="1.0" cost="20.0" nds="20.0" ndsSum="3.33" discountValue="0.0" costWithDiscount="20.0" amount="20.0" insertType="8"/>
        <position order="4" departNumber="1" goodsCode="93301370_ST" barCode="289367" count="3.0" cost="139.99" nds="20.0" ndsSum="70.0" discountValue="0.0" costWithDiscount="139.99" amount="419.97" insertType="8"/>
        <position order="5" departNumber="1" goodsCode="456124_ST" barCode="4607939176170" count="1.0" cost="299.99" nds="20.0" ndsSum="50.0" discountValue="0.0" costWithDiscount="299.99" amount="299.99" insertType="8"/>
        <position order="6" departNumber="1" goodsCode="456132_ST" barCode="4607939176668" count="1.0" cost="299.99" nds="20.0" ndsSum="50.0" discountValue="0.0" costWithDiscount="299.99" amount="299.99" insertType="8"/>
    </positions>
    <payments>
        <payment typeClass="BankCardPaymentEntity" amount="1174.94" description="Оплата по банковской карте">
            <plugin-property key="card.hash" value="7F1B2511546D3B9C9424E83094D50F356642BD2B"/>
            <plugin-property key="cash.transaction.id" value="695005"/>
            <plugin-property key="terminal.number" value="00489975"/>
            <plugin-property key="cash.transaction.date" value="2020-05-27 10:57:00.193"/>
            <plugin-property key="bank.id" value="Сбербанк"/>
            <plugin-property key="ref.number" value="159056616818"/>
            <plugin-property key="card.type" value="MIR Credit"/>
            <plugin-property key="auth.code" value="31Y583"/>
            <plugin-property key="bank.type" value="SBERBANK"/>
            <plugin-property key="card.number" value="************5100"/>
        </payment>
    </payments>
    <discounts/>
    <discountCards>
        <discountCard>2020023021217</discountCard>
    </discountCards>
    <card number="2020023021217" guid="2020023021217"/>
    <bonus-discount/>
    <presents actionname="Фишка_По сумме чека" externalcode="SR10_1240497" guid="4257135" issued="6" scanned="0">
        <present amount="6" condition=""/>
    </presents>
    <presents actionname="Фишка_по количеству товаров" externalcode="SR10_1240516" guid="4256956" issued="8" scanned="0">
        <present amount="8" condition=""/>
    </presents>
</purchase>

Передача информации о печати, электронной отправке и принудительной печати в составе чека

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

Пример чека

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

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

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

10.2.91.0

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

Описание

UID_PURCHASE

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

value

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

Пример: 

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

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

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

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

10.3.2.0

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

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

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

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

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

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

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


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

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

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Номер мягкого чекаНет

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 - Товар добавлен с помощью умных весов (SmartScales) SMART_SCALES
    • SRTB-5773 - Получение подробных данных проблемы… СТАТУС
    • 10.3.14.0
Нет
dateCommitDateTime

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

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

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

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

Продавец

keyКод продавца
<?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" >
                <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" >
                <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

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

valueЗначение цены товара перед изменением
Причина изменения цены товара

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" >
                <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>
Страна производитель

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

Описание

countryName

Наименование страны производителя

Комплект товаров

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" >
                <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" >
                <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" >
                <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.75.0

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

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

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

Описание

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

Признак акцизной марки, проданной в офлайн-режиме

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

10.2.88.0

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

Описание

offlineSale

Определяет была ли продажа с использованием акцизной марки в офлайн-режиме без SetMark или нет.

  • true
  • false
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<purchases count="1">
    <purchase tabNumber="1" userName="Администраторов Администратор Администраторович" operationType="true" operDay="2020-08-06+03:00" shop="7201" cash="1" shift="1" number="17" saletime="2020-08-06T13:55:09.641+03:00" begintime="2020-08-06T13:52:45.568+03:00" amount="99.0" discountAmount="0.0" inn="7802781104">
        <plugin-property key="EXCISE_VALIDATION_REQUEST" value="{"id":60,"version":1,"shop":7201,"cash":1,"operationType":0,"checkNumber":"1.17","cancel":false,"creationDate":1596711165568,"productType":1,"data":[{"barcode":"1414191020188","item":"141419102018","productType":2,"mark":"014141910201881000001AA-j5555"}]}"/>
        <plugin-property key="EXCISE_VALIDATION_TYPE" value="SetMark"/>
        <positions>
            <position order="1" departNumber="1" goodsCode="141419102018" barCode="1414191020188" count="1.0" cost="99.0" nds="20.0" ndsSum="16.5" discountValue="0.0" costWithDiscount="99.0" amount="99.0" >
                <plugin-property key="offlineSale" value="true"/>
                <plugin-property key="excise-token" value="014141910201881000001AA-j5555"/>
                <plugin-property key="marktype" value="tobacco"/>
            </position>
        </positions>
        <payments>
            <payment typeClass="CashPaymentEntity" amount="99.0" description="Оплата наличными"/>
        </payments>
    </purchase>
</purchases>
SapCar-параметр закодированный в GS1 Databar и EAN13+5

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

10.2.89.0

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

Описание

databar

SapCar-параметр закодированный в GS1 Databar и EAN13+5

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<purchases count="1">
    <purchase tabNumber="1" userName="Администраторов Администратор Администраторович" operationType="true" operDay="2020-08-06+03:00" shop="7201" cash="1" shift="1" number="17" saletime="2020-08-06T13:55:09.641+03:00" begintime="2020-08-06T13:52:45.568+03:00" amount="40.23" discountAmount="35.23" inn="7802781104">
             <position order="1" departNumber="1" goodsCode="00003" barCode="2410032" count="2.056" cost="40.23" nds="20.0" ndsSum="0.83" discountValue="35.23" costWithDiscount="5.0" amount="5.0" insertType="1" >
                <plugin-property key="offlineSale" value="true"/>
				<plugin-property key="databar" value="(01)02410032020569(10)570926110282(7003)2004101111"/>
            </position>
        </positions>
        <payments>
            <payment typeClass="CashPaymentEntity" amount="40.23" 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

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

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

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

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

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

Комиссионер

value

Данные по комиссионеру

В формате JSON

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

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


Оплаты <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" denyPrintToDocuments="false" clientType="PRIVATE" client_guid="1981162">
        <plugin-property key="externalSystemId" value="17820611561376626271"/>
        <plugin-property key="upd" value="1782000000000001"/>
        <plugin-property key="debitor-number" value="1245648726"/>
        <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" insertType="1">
                <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" insertType="1">
                <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>
        <discounts>
            <discount positionId="2" goodCode="03001" amount="485.08" isDiscountPurchase="false" AdvertActGUID="54799" AdvertActExternalCode="SR10_54799" advertType="DISCOUNT" AdvertActDiscountType="9" card-number="12620003" quantity="3.0"/>
            <discount positionId="2" goodCode="03001" amount="242.54" isDiscountPurchase="false" AdvertActGUID="-861439014" AdvertActExternalCode="EXT_01" advertType="DISCOUNT" card-number="12620003" quantity="3.0"/>
            <discount positionId="2" goodCode="03001" amount="0.0" isDiscountPurchase="false" AdvertActGUID="-1673510823" AdvertActExternalCode="EXT_02" advertType="DEFAULT" AdvertActDiscountType="-1" quantity="3.0"/>
            <discount positionId="1" goodCode="02003" amount="360.28" isDiscountPurchase="false" AdvertActGUID="54799" AdvertActExternalCode="SR10_54799" advertType="DISCOUNT" AdvertActDiscountType="9" card-number="12620003" quantity="3.0"/>
            <discount positionId="1" goodCode="02003" amount="180.14" isDiscountPurchase="false" AdvertActGUID="-861439014" AdvertActExternalCode="EXT_03" advertType="DISCOUNT" card-number="12620003" quantity="3.0"/>
            <discount positionId="1" goodCode="02003" amount="0.0" isDiscountPurchase="false" AdvertActGUID="-1673510823" AdvertActExternalCode="EXT_05" advertType="DEFAULT" AdvertActDiscountType="-1" quantity="3.0"/>
        </discounts>
        <discountCards>
            <discountCard>12620003</discountCard>
        </discountCards>
        <card type="INTERNAL" card_type_guid="12621262" number="12620003"/>
        <bonus-discount/>
    </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

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

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

purchases/purchase/discounts

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

Тип данных

Описание

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

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

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

10.3.31.0


  • Идентификатор цены (по умолчанию)

Если настройка "Заполнять AdvertActExternalCode при выгрузке чеков идентификаторами цен" включена, то в поле AdvertActExternalCode передаётся идентификатор цены.

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

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

  • Внешний код кассовой акции

Если настройка "Заполнять AdvertActExternalCode при выгрузке чеков идентификаторами цен" выключена, то в поле AdvertActExternalCode передаётся внешний код акции.

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

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

Нет
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 - Вкусомания (Азбука вкуса)
Да
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 цены из справочника;
Нет
card-numberStringНомер карты (или купона), по которому сработала скидка на эту позициюНет
quantityDecimalКоличество товара, на которое сработала скидкаНет
externalActionIdStringИдентификатор акции внешней системыНет
Наименование элементаТип данныхОписаниеОбязательное
actionLabelsКомплексный

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

Нет

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

Метки рекламной акции не выгружаются при экспорте чеков с касс в ERP через SetESB

purchases/purchase/discounts/discount/actionLabels/label

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

Тип данных

Описание

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

label

String

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

Нет

Список карт, примененных в чеке <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 – другая карта
Нет
card_type_guidLongКод категории картыНет

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

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

Нет
usernameStringИмя кассираНет
operationTypeBoolean

Тип операции

  • EXPENSE - операция расхода
  • INCOME - операция прихода
Нет

operDay

Date

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

Да

shop

Long

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

Да

cash

Long

Номер кассы

Да

shift

Long

Номер смены

Да
number

Long

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

begintime

DateTime

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

Нет

amount

Decimal

Сумма чека

Нет

discountAmount

Decimal

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

Нет
denyPrintToDocumentsBooleanЗапрет печати сопроводительных документовНет
clientTypeString

Тип клиента:

  • JURISTIC_PERSON  - Юридическое лицо, к которому привязана карта юридического лица из категории неперсональных.
  • PRIVATE - Физическое лицо, или юридическое лицо, к которому привязана карта юридического лица из категории персональных.

Пример XML выгрузки чека юридического лица

Нет
client_guidLongКод клиентаНет

Информация по транзакции списания бонусов в качестве скидки <bonus-discount>

purchases/purchase/bonus-discount

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

Тип данных

Описание

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

type

String

Тип бонусной системы, в настоящей версии поддерживается только одно значение - CRM

Нет

transaction-id

String

Идентификатор транзакции, в рамках которой произошло списание бонусов

Нет

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

purchases/purchase/bonuses

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

Тип данных

Описание

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

transactionId

String

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

Нет
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 - Получение подробных данных проблемы… СТАТУС
    • 10.2.84.0
  • TOKENS_SET_API - Фишки плагинов SetAPI
  • TOKENS_SET5 - Марки SetRetail5
  • TOKENS_SR10 - Фишки, марки SetRetail10
Да
chargeOnBonusesDecimalСумма транзакции - начислениеНет
writeOffBonusesDecimalСумма транзакции - списаниеНет
cardNumberStringНомер картыНет
cardGuidStringИдентификатор картыНет
bonusaccountsidLongID бонусного счетаНет
AdvertActExternalCodeString

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

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

10.3.31.0


  • Идентификатор цены (по умолчанию)

Если настройка "Заполнять AdvertActExternalCode при выгрузке чеков идентификаторами цен" включена, то в поле AdvertActExternalCode передаётся идентификатор цены.

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

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

  • Внешний код кассовой акции

Если настройка "Заполнять AdvertActExternalCode при выгрузке чеков идентификаторами цен" выключена, то в поле AdvertActExternalCode передаётся внешний код акции.

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

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

Нет
AdvertActDiscountTypeStringКод типа акцииНет
AdvertActGUIDLongGuid акцииНет
Наименование элементаТип данныхОписаниеОбязательное
actionLabelsКомплексныйМетки рекламной акцииНет
bonusPositionКомплексныйПопозиционные данные о списаниях/начислениях бонусовНет

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

Метки рекламной акции не выгружаются при экспорте чеков с касс в ERP через SetESB

purchases/purchase/bonuses/actionLabels

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

Тип данных

Описание

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

label

String

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

Нет

Попозиционные данные о списаниях/начислениях бонусов <bonusPosition>

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

10.2.70.0

purchases/purchase/bonuses/bonusPosition

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

Тип данных

Описание

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

positionId

Long

Код строки позиции

Да
goodCodeStringАртикул товараНет
amountDecimalСуммаДа
quantityDecimalКоличествоНет
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<purchases count="2">
    <purchase tabNumber="1" userName="Администраторов Администратор Администраторович" operationType="true" operDay="2019-07-05+03:00" shop="594" cash="1" shift="1" number="3" saletime="2019-07-05T15:38:14.736+03:00" begintime="2019-07-05T11:40:55.320+03:00" amount="45.33" discountAmount="75.36" denyPrintToDocuments="false" clientType="PRIVATE" client_guid="110769">
        <positions>
            <position order="1" departNumber="1" goodsCode="00002" barCode="4600002000006" count="1.0" cost="27.23" nds="20.0" ndsSum="1.71" discountValue="17.0" costWithDiscount="10.23" amount="10.23" insertType="1">
                <plugin-property key="countryName" value="Россия"/>
            </position>
            <position order="2" departNumber="1" goodsCode="00003" barCode="4600003000005" count="1.0" cost="40.23" nds="20.0" ndsSum="2.52" discountValue="25.12" costWithDiscount="15.11" amount="15.11" insertType="1">
                <plugin-property key="countryName" value="Россия"/>
            </position>
            <position order="3" departNumber="1" goodsCode="00004" barCode="4600004000004" count="1.0" cost="53.23" nds="20.0" ndsSum="3.33" discountValue="33.24" costWithDiscount="19.99" amount="19.99" insertType="1">
                <plugin-property key="countryName" value="Россия"/>
            </position>
        </positions>
        <payments>
            <payment typeClass="CashPaymentEntity" amount="46.0" description="Оплата наличными"/>
            <payment typeClass="CashChangePaymentEntity" amount="0.67" description=""/>
        </payments>
        <discounts>
            <discount positionId="3" goodCode="00004" amount="26.62" isDiscountPurchase="false" AdvertActGUID="-1538204597" AdvertActExternalCode="ERPI_SR-1177: Скидка по мобильному телефону" advertType="DISCOUNT" card-number="9905100100001" quantity="1.0"/>
            <discount positionId="2" goodCode="00003" amount="20.12" isDiscountPurchase="false" AdvertActGUID="-1538204597" AdvertActExternalCode="ERPI_SR-1177: Скидка по мобильному телефону" advertType="DISCOUNT" card-number="9905100100001" quantity="1.0"/>
            <discount positionId="1" goodCode="00002" amount="13.62" isDiscountPurchase="false" AdvertActGUID="-1538204597" AdvertActExternalCode="ERPI_SR-1177: Скидка по мобильному телефону" advertType="DISCOUNT" card-number="9905100100001" quantity="1.0"/>
            <discount positionId="3" goodCode="00004" amount="6.62" isDiscountPurchase="true" AdvertActGUID="-833406141" AdvertActExternalCode="ERPI_SR-1177: Списание бонусных баллов с карты" advertType="BONUS_SR10" card-number="9905100100001" quantity="1.0"/>
            <discount positionId="2" goodCode="00003" amount="5.0" isDiscountPurchase="true" AdvertActGUID="-833406141" AdvertActExternalCode="ERPI_SR-1177: Списание бонусных баллов с карты" advertType="BONUS_SR10" card-number="9905100100001" quantity="1.0"/>
            <discount positionId="1" goodCode="00002" amount="3.38" isDiscountPurchase="true" AdvertActGUID="-833406141" AdvertActExternalCode="ERPI_SR-1177: Списание бонусных баллов с карты" advertType="BONUS_SR10" card-number="9905100100001" quantity="1.0"/>
        </discounts>
        <discountCards>
            <discountCard>9905100100001</discountCard>
        </discountCards>
        <card type="INTERNAL" card_type_guid="708423" number="9905100100001"/>
        <bonus-discount/>
        <bonuses>
            <bonus bonusesType="BONUS_SR10" writeOffBonuses="15.0" cardNumber="9905100100001" bonusaccountsid="36836" AdvertActExternalCode="ERPI_SR-1177: Списание бонусных баллов с карты" AdvertActGUID="-833406141">
				<bonusPosition positionId="3" goodCode="00004" amount="6.62" quantity="1.0"/>
				<bonusPosition positionId="2" goodCode="00003" amount="5.0" quantity="1.0"/>
				<bonusPosition positionId="1" goodCode="00002" amount="3.38" quantity="1.0"/>
			</bonus>
            <bonus bonusesType="BONUS_SR10" chargeOnBonuses="100.0" cardNumber="9905100100001" bonusaccountsid="36836" AdvertActExternalCode="SR10_39283" AdvertActDiscountType="-1" AdvertActGUID="39283">
				<bonusPosition positionId="3" goodCode="00004" amount="44.13" quantity="1.0"/>
				<bonusPosition positionId="2" goodCode="00003" amount="33.34" quantity="1.0"/>
				<bonusPosition positionId="1" goodCode="00002" amount="22.53" quantity="1.0"/>
			</bonus>
        </bonuses>
    </purchase>
</purchases>

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

purchases/purchase/exciseBottles

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

Тип данных

Описание

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

barcode

String

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

Нет

exciseBarcode

String

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

Нет

setBarcode

String

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

Нет

volume

Double

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

Нет

price

Decimal

Цена бутылки

Нет

Выданные подарки <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Идентификатор условия (уникален в рамках РА), по которому производилось начисление/расчет количества подарков.Нет

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

Метки рекламной акции не выгружаются при экспорте чеков с касс в ERP через SetESB

purchases/purchase/bonuses/actionLabels

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

Тип данных

Описание

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

label

String

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

Нет

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

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

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

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

10.3.4.0

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

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

Модуль

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

Номер версии

SET_ERP_INTEGRATION

export.file.loyalty.version

1.6

SET_ERP_INTEGRATION

export.file.purchases.version

1.10

SET_ERP_INTEGRATION

export.set10wsclient.purchases.version

1.19

SET_ERP_INTEGRATION

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

1.6

SET_ERP_INTEGRATION

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

1.6

/purchases/purchase/coupons/coupon

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

Тип данных

Описание

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

coupons

Комплексный

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

Нет

coupon

Комплексный

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

Да

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

Тип данных

Описание

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

number

String

Номер купона

Нет

status

String

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

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

Счетчики <counters>

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

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

10.3.29.0

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

purchases/purchase/counters

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

Тип данных

Описание

Обязательное
counterКомплексныйСчетчикНет
Наименование атрибутаТип данныхОписаниеОбязательное

actionGuid

String

GUID-код рекламной акции

Нет
actionNameStringНаименование рекламной акцииНет
externalCodeStringВнешний код рекламной акцииНет

© 1994-2024, ООО "Кристалл Сервис Интеграция".
Все права защищены.

Политика обработки персональных данных