Версия веб-сервиса 1.13

1 Чеки <purchases>
- 1.1 Состав чека <purchase>
  - 1.1.1 Плагинные свойства чека <plugin-property>
  - 1.1.2 Товарные позиции <positions>
    - 1.1.2.1 Товарная позиция <position>
      - 1.1.2.1.1 Плагинные свойства товара <plugin-property>
        1.1.2.1.1.1 Подарочная карта
        1.1.2.1.1.2 Дисконтная карта
        1.1.2.1.1.3 Подарочная карта ЦФТ
        1.1.2.1.1.4 Ветеринарный контроль
        1.1.2.1.1.5 Продавцы
        1.1.2.1.1.6 Признак ручного изменения цены товара
        1.1.2.1.1.7 Причина изменения цены товара
        1.1.2.1.1.8 Причина аннулирования чека
        1.1.2.1.1.9 Комплект товаров
        1.1.2.1.1.10 Datamatrix-код (маркированные товары)
        1.1.2.1.1.11 Тип акцизной продукции
      - 1.1.2.1.2 Пример экспорта алкогольного товара
      - 1.1.2.1.3 Пример экспорта данных чека с продажей обуви
        1.1.2.1.3.1 Товары социальной значимости (Мегар)
        1.1.2.1.3.2 Признак передачи кода товара в ОФД для СИЗ (Средства индивидуальной защиты)
      - 1.1.2.1.4 Пример чека с проданным товаром СИЗ
        1.1.2.1.4.1 Налог с продаж (НСП)
        1.1.2.1.4.2 Признак прослеживаемого и импортного товара
        1.1.2.1.4.3 Признак передачи ГТД
        1.1.2.1.4.4 ФФД 1.2 - Результат валидации марки (Результат проверки КМ в ФР)
        1.1.2.1.4.5 ERP ClientID из Siebel CRM
        1.1.2.1.4.6 Информация о проверке КМ в Честном знаке
        1.1.2.1.4.7 Параметры обращения к CDN-площадкам
        1.1.2.1.4.8 Признак вскрытия кега
        1.1.2.1.4.9 Информация о проверке КМ в Локальном модуле Честный Знак
        1.1.2.1.4.10 Унифицированный контрольный знак (УКЗ)
        1.1.2.1.4.11 Наименование товара
  - 1.1.3 Оплаты <payments>
    - 1.1.3.1 Тип оплаты <payment>
      - 1.1.3.1.1 Плагинные свойства оплаты <plugin-property>
        1.1.3.1.1.1 Банковская карта
        1.1.3.1.1.2 Оплата QR-кодом
      - 1.1.3.1.2 Пример значения
      - 1.1.3.1.3 Пример чека с данными по транзакции Сбербанк
      - 1.1.3.1.4 Пример чека с данными по транзакции Райффайзен СБП
        1.1.3.1.4.1 Внешний банковский терминал
        1.1.3.1.4.2 Потребительский кредит
        1.1.3.1.4.3 Подарочная карта
        1.1.3.1.4.4 Подарочная карта ЦФТ
        1.1.3.1.4.5 Тип поставщика (Узбекистан)
  - 1.1.4 Список карт, примененных в чеке <discountCards>
  - 1.1.5 Подробная информация по картам, примененным в чеке <card>
  - 1.1.6 Ссылка на оригинальный чек продажи <original-purchase>
  - 1.1.7 Алкогольные позиции с акцизными марками <exciseBottles>
  - 1.1.8 Список скидок <discount>
  - 1.1.9 Список дисконтных карт <discountCard>
  - 1.1.10 Список бонусных транзакций <bonuses>
    - 1.1.10.1 Транзакции начисления <chargeOnBonuses>
    - 1.1.10.2 Транзакции списания <writeOffBonuses>
  - 1.1.11 Плагинные свойства чека <plugin-property>
  - 1.1.12 Выданные подарки <presents>
  - 1.1.13 Выданные купоны <coupons>

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

https://crystals.atlassian.net/browse/SRTS-6

https://crystals.atlassian.net/browse/CR-3319

Чеки `<purchases>`

purchases

Наименование элемента	Тип данных	Описание	Обязательное
purchase	Комплексный	Данные чека	Да
Наименование атрибута	Тип данных	Описание	Обязательное
count	Long	Количество передаваемых чеков, т.е. общее количество тегов purchase вложенных в общий тег `purchases`	Нет

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

purchases/purchase

Наименование атрибута	Тип данных	Описание	Обязательное
tabNumber	String	Табельный номер кассира	Нет
returndayinday	Boolean	Признак для чека возврата "День в день"	Нет
username	String	Имя кассира	Нет
operationType	Boolean	Кассовая операция True - продажа False - возврат	Нет
cashOperation	Комплексный	Кассовые операции для лотерей Столото Начиная с версии веб-сервиса 1.15 https://crystals.atlassian.net/browse/SRTE-2953 10.2.89.0 EXPENSE - Операция "Расход" INCOME - Операция "Приход" Пример выгрузки чека расхода	Нет
operDay	Date	Операционный день	Да
shop	Long	Номер магазина	Да
cash	Long	Номер кассы	Да
shift	Long	Номер смены	Да
number	Long	Номер чека	Да
saletime	DateTime	Дата/Время продажи	Нет
begintime	DateTime	Дата создания чека (добавления первого товара)	Нет
amount	Decimal	Сумма чека	Нет
discountAmount	Decimal	Сумма скидки на чек	Нет
inn	String	ИНН юридического лица в смене	Нет
qrcode	String	Состав QR-кода чека отправленного в ОФД Начиная с версии веб-сервиса 1.7 https://crystals.atlassian.net/browse/SRTE-2915 10.2.89.0 Пример XML выгрузки чека с QR-кодом	Нет
fiscalDocNum	String	Номер фискального документа https://crystals.atlassian.net/browse/SRTE-3135 https://crystals.atlassian.net/browse/CR-4879 10.2.93.0 Пример чека с номером фискального документа	Нет
storno	Boolean	Признак чека, если он был хоть раз отложен (через функцию отложить чек) и восстановлен на кассе. Начиная с версии веб-сервиса 1.9 https://crystals.atlassian.net/browse/SRTE-3562 https://crystals.atlassian.net/browse/CR-5382 10.2.99.0 Данный тип экспорта должен быть активирован. По умолчанию выключен. true - чек сторнирован Если чек не сторнировался, то данный атрибут не отображается. Пример сторнированного чека	Нет
status	Комплексный	Статус чека Начиная с версии веб-сервиса 1.9 https://crystals.atlassian.net/browse/SRTE-3562 https://crystals.atlassian.net/browse/CR-5382 10.2.99.0 Данный тип экспорта должен быть активирован. По умолчанию выключен. CANCELLED - Чек аннулирован DEFERRED - Чек отложен NONFISCAL - Нефискальный документ REGISTERED - Чек зарегистрирован Пример чека со статусом	Нет
cashType	String	Тип кассы Тип кассы не выгружается, если экспорт чека с кассы был напрямую в SetESB, без участия SetCentrum или SetRetail. 10.3.16.0 Версия веб-сервиса 1.11 `POS` - клавиатурная; `TOUCH_2` - SetTouch; `SCO` - касса самообслуживания, CSI-K. example.xml https://crystals.atlassian.net/browse/SRTS-1003 https://crystals.atlassian.net/browse/CR-8367	Нет
fiscalnum	String	Регистрационный номер фискального регистратора Версия веб-сервиса 1.12 https://crystals.atlassian.net/browse/SRTS-1103 https://crystals.atlassian.net/browse/SRTS-1104 https://crystals.atlassian.net/browse/CR-8476 10.3.17.0 Пример экспорта чека	Нет
Наименование элемента	Тип данных	Описание	Обязательное
positions	Комплексный	Товарные позиции	Да
payments	Комплексный	Оплаты	Да
discountCards	Комплексный	Список дисконтных карт, примененных при оплате этого чека	Нет
card	Комплексный	Список карт, использованных при оплате этой покупки. Фактически более детализированная версия содержимого элемента "discountCards"	Нет
original-purchase	Комплексный	Оригинальный чек продажи для возвратного чека (purchaseType)	Нет
exciseBottles	Комплексный	Бутылки с акцизными марками	Нет
presents	Комплексный	Выданные подарки	Нет
coupons	Комплексный	Выданные купоны https://crystals.atlassian.net/browse/SLS-1290 https://crystals.atlassian.net/browse/SLS-1295 https://crystals.atlassian.net/browse/CR-5582 10.3.4.0	Нет
discount	Комплексный	Список скидок, сработавших в этом чеке	Нет
discountCard	Комплексный	Список дисконтных карт, примененных при оплате этого чека	Нет
bonuses	Комплексный	Список бонусных транзакций, проведенных в этом чеке	Нет
plugin-property	Комплексный	Список "плагинных" (расширенных, не базовых) свойств этого чека. Может отсутствовать.	Нет

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

purchases/purchase/plugin-property

Наименование атрибута	Тип данных	Описание	Обязательное
key	String	Наименование плагинного свойства	Да
value	String	Значение плагинного свойства	Нет

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

https://crystals.atlassian.net/browse/SR-2709

10.2.63.0

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

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

Описание

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

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

value

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

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

https://crystals.atlassian.net/browse/KIT-122

https://crystals.atlassian.net/browse/CR-4908

10.2.94.0

Пример мягкого чека с дополнительной информацией

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<purchases count="1">
    <purchase tabNumber="5" userName="Admin Admin " operationType="true" operDay="2019-03-05+03:00" shop="3174" cash="1" shift="14" number="6" saletime="2019-03-06T10:56:44.933+03:00" begintime="2019-03-06T10:56:38.862+03:00" amount="46.31" discountAmount="0.0" inn="7802781104">
        <plugin-property key="sc.num.88384132" value="Дополнительное сообщение"/>
        <positions>
            <position order="1" departNumber="1" goodsCode="1" barCode="5050582541748" count="4.5" cost="10.29" nds="20.0" ndsSum="7.72" discountValue="0.0" costWithDiscount="10.29" amount="46.31" softCheckNumber="88384132" dateCommit="2019-03-06T10:56:38.887+03:00"/>
        </positions>
        <payments>
            <payment typeClass="CashChangePaymentEntity" amount="3.69" description=""/>
            <payment typeClass="CashPaymentEntity" amount="50.0" description="Оплата наличными"/>
        </payments>
    </purchase>
</purchases>

Пример мягкого чека с дополнительной информации о номере позиции в заказе

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<purchases count="1">
    <purchase tabNumber="1" userName="Администраторов Администратор Администраторович" operationType="true" cashOperation="INCOME" operDay="2021-01-12+03:00" shop="1361" cash="61" shift="1" number="13" saletime="2021-01-13T14:30:04.017+03:00" begintime="2021-01-13T14:29:58.445+03:00" amount="300.0" discountAmount="0.0" inn="7802781104" fiscalDocNum="9;13">
        <plugin-property key="externalSystemId" value="13610611610537400465"/>
        <plugin-property key="sc.num.SK43401740245235" value="order information"/>
        <plugin-property key="UID_PURCHASE" value="290c1f79-9d4a-4f6b-8f87-c9c575397d87"/>
        <positions>
            <position order="1" departNumber="1" goodsCode="00045" barCode="4600045000001" count="1.0" cost="100.0" nds="20.0" ndsSum="16.67" discountValue="0.0" costWithDiscount="100.0" amount="100.0" softCheckNumber="SK43401740245235" dateCommit="2021-01-13T14:29:58.463+03:00" insertType="10">
                <plugin-property key="sc.num.SK43401740245235" value="positionOrder=1"/>
                <plugin-property key="countryName" value="Бельгия"/>
            </position>
            <position order="2" departNumber="1" goodsCode="00046" barCode="4600046000000" count="1.0" cost="200.0" nds="20.0" ndsSum="33.33" discountValue="0.0" costWithDiscount="200.0" amount="200.0" softCheckNumber="SK43401740245235" dateCommit="2021-01-13T14:29:58.494+03:00" insertType="10">
                <plugin-property key="sc.num.SK43401740245235" value="positionOrder=2"/>
                <plugin-property key="countryName" value="Бельгия"/>
            </position>
        </positions>
        <payments>
            <payment typeClass="CashPaymentEntity" amount="300.0" description="Оплата наличными"/>
        </payments>
    </purchase>
</purchases>

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

https://crystals.atlassian.net/browse/SR-4874

10.2.99.0

https://crystals.atlassian.net/browse/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: Покупатели Пример экспорта https://crystals.atlassian.net/browse/SR-6664 https://crystals.atlassian.net/browse/CR-10277 10.3.30.0
CUSTOMER_PROMO_REFUSE	Признак отказа от печати купонов и промоматериалов, полученный из карточки клиента в модуле CDP: Покупатели Выгружается только при подключенном модуле CDP: Покупатели Пример экспорта https://crystals.atlassian.net/browse/SR-6664 https://crystals.atlassian.net/browse/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>

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

https://crystals.atlassian.net/browse/SRTB-5270

https://crystals.atlassian.net/browse/CR-5382

10.3.1.0

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

Описание

PURCHASE_DEFERRED

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

value

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

Пример чека

Нефискальный документ

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

https://crystals.atlassian.net/browse/SRTE-2318

10.2.78.0

https://crystals.atlassian.net/browse/SRTB-5584

10.3.7.0

Наименование плагинного свойства	Описание
NON_FISCAL_DOCUMENT_TYPE	Тип нефискального документа
value	Значение типа нефискального документа LEGAL_ENTITY_ORDER - заказ юридического лица OPEN_UP_TARE - вскрытие тары
NON_FISCAL_DOCUMENT_NUMBER	Номер документа-основания нефискального документа. Выгрузка настраивается отдельно для каждого типа нефискального документа, подробнее в статье SetRetail10 ◾️ Ввод номера нефискального документа. https://crystals.atlassian.net/browse/SRTB-9728 https://crystals.atlassian.net/browse/CR-13898 10.4.18.0

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<purchases count="1">
    <purchase tabNumber="99999" userName="Иванов Пётр " operationType="true" cashOperation="INCOME" operDay="2022-06-02+03:00" shop="42" cash="1" shift="72" number="2" saletime="2022-06-02T14:35:10.578+03:00" begintime="2022-06-02T14:34:26.279+03:00" amount="255.00" discountAmount="0.00" inn="7802781104" status="NONFISCAL">
        <plugin-property key="NON_FISCAL_DOCUMENT_TYPE" value="OPEN_UP_TARE"/>
        <plugin-property key="FISCAL_DOC_ID" value="0"/>
        <plugin-property key="KPP" value="780201001"/>
		<plugin-property key="NON_FISCAL_DOCUMENT_NUMBER" value="22354"/>
        <positions>
            <position order="1" departNumber="582" goodsCode="45036" barCode="4607145132030" count="1.000" cost="255.00" nds="20.0" ndsSum="0.00" discountValue="0.00" costWithDiscount="255.00" amount="255.00" dateCommit="2022-06-02T14:35:07.771+03:00" insertType="1">
                <plugin-property key="countryName" value="Россия"/>
            </position>
        </positions>
        <payments/>
        <exciseBottles>
            <bottle barcode="4607145132030" exciseBarcode="507100000000010118001D5CCFC794963898C1B13E41231CKY42T7UDIJJY2AWLHS7HPGINLMY7PQPDNJALVS42WNCHYRCO257SPCSCF4ASM37BZNTLIASYRVGFUTCXDXDJPML5MMVLEEHZWPWJVI" volume="1.0" price="255.00"/>
        </exciseBottles>
    </purchase>
</purchases>

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

https://crystals.atlassian.net/browse/SRTB-4485

https://crystals.atlassian.net/browse/CR-2350

10.2.91.0

Наименование плагинного свойства	Описание
UID_PURCHASE	Признак уникального идентификатора чека

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

Чеки <purchases>

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

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