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

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 Комплект товаров
        1.1.2.1.1.11 Datamatrix-код (маркированные товары)
        1.1.2.1.1.12 Тип акцизной продукции
      - 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 SapCar-параметр закодированный в GS1 Databar и EAN13+5
        1.1.2.1.4.3 Налог с продаж (НСП)
        1.1.2.1.4.4 Признак прослеживаемого и импортного товара
        1.1.2.1.4.5 Признак передачи ГТД
        1.1.2.1.4.6 ФФД 1.2 - Результат валидации марки (Результат проверки КМ в ФР)
        1.1.2.1.4.7 ERP ClientID из Siebel CRM
        1.1.2.1.4.8 Информация по комитенту (комиссионер)
        1.1.2.1.4.9 Информация о проверке КМ в Честном знаке
        1.1.2.1.4.10 Параметры обращения к CDN-площадкам
        1.1.2.1.4.11 Признак вскрытия кега
        1.1.2.1.4.12 Информация о проверке КМ в Локальном модуле Честный Знак
        1.1.2.1.4.13 Унифицированный контрольный знак (УКЗ)
        1.1.2.1.4.14 Наименование товара
  - 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.3.1.5 Ответы по ЕГАИС для экспорта чеков в ERP
  - 1.1.4 Список скидок <discounts>
    - 1.1.4.1 Метки рекламной акции <actionLabels>
  - 1.1.5 Список карт, примененных в чеке <discountCards>
  - 1.1.6 Подробная информация по картам, примененным в чеке <card>
  - 1.1.7 Ссылка на оригинальный чек продажи <original-purchase>
  - 1.1.8 Информация по транзакции списания бонусов в качестве скидки <bonus-discount>
  - 1.1.9 Список бонусных транзакций <bonuses>
    - 1.1.9.1 Метки рекламной акции <actionLabels>
    - 1.1.9.2 Попозиционные данные о списаниях/начислениях бонусов <bonusPosition>
  - 1.1.10 Алкогольные позиции с акцизными марками <exciseBottles>
  - 1.1.11 Выданные подарки <presents>
  - 1.1.12 Выданные купоны <coupons>
  - 1.1.13 Счетчики <counters>

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

Методы

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

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

URL

http://Любой_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 обратной связью

URL

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

WSDL

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

Поле	Тип данных	Описание	Обязательное
Принимаемые параметры
purchases	base64Binary	Аннулированные чеки в формате XML, закодированный в BASE64	Да
version	string	Версия xsd-схемы выдаваемых данных	Нет
Возвращаемые параметры
return	boolean	`True` в случае успешной обработки пакета	Да

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

Начиная с версии 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	Сумма скидки на чек	Нет
denyPrintToDocuments	Boolean	Запрет печати сопроводительных документов	Нет
clientType	Комплексный	Тип клиента: JURISTIC_PERSON - Юридическое лицо, к которому привязана карта юридического лица из категории неперсональных. PRIVATE - Физическое лицо, или юридическое лицо, к которому привязана карта юридического лица из категории персональных. Пример XML выгрузки чека юридического лица	Нет
client_guid	Long	Код клиента Данный атрибут не выгружается, если был экспорт чека с кассы напрямую в SetESB (без участия SetCentrum или SetRetail), через веб-сервисы на стороне SetRetail или файловый экспорт. Код клиента выгружается только для клиентов внутренних карт с типом INTERNAL Атрибут выгружается только при активном экспорте из Set Retail в ERP.	Нет
qrcode	String	Состав QR-кода чека отправленного в ОФД Начиная с версии веб-сервиса 1.14 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 Пример чека с номером фискального документа	Нет
factorynum	String	Заводской номер https://crystals.atlassian.net/browse/SRTS-836 https://crystals.atlassian.net/browse/SRTS-848 https://crystals.atlassian.net/browse/CR-8028 10.3.14.0 Пример экспорта	Нет
inn	String	ИНН https://crystals.atlassian.net/browse/SRTS-836 https://crystals.atlassian.net/browse/SRTS-848 https://crystals.atlassian.net/browse/CR-8028 10.3.14.0 Пример экспорта	Нет
kpp	String	КПП https://crystals.atlassian.net/browse/SRTS-836 https://crystals.atlassian.net/browse/SRTS-848 https://crystals.atlassian.net/browse/CR-8028 10.3.14.0 Пример экспорта	Нет
storno	Boolean	Признак чека, если он был хоть раз отложен (через функцию отложить чек) и восстановлен на кассе. Начиная с версии веб-сервиса 1.18 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.22 https://crystals.atlassian.net/browse/SRTS-1003 https://crystals.atlassian.net/browse/CR-8367 `POS` - клавиатурная; `TOUCH_2` - SetTouch; `SCO` - касса самообслуживания, CSI-K. example.xml	Нет
fiscalnum	String	Регистрационный номер фискального регистратора Версия веб-сервиса 1.23 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	Комплексный	Оплаты	Да
discounts	Комплексный	Список скидок, сработавших в этом чеке	Нет
discountCards	Комплексный	Список дисконтных карт, примененных при оплате этого чека	Нет
card	Комплексный	Список карт, использованных при оплате этой покупки. Фактически более детализированная версия содержимого элемента "discountCards"	Нет
original-purchase	Комплексный	Оригинальный чек продажи для возвратного чека (purchaseType)	Нет
bonus-discount	Комплексный	Информация по транзакции списания бонусов в качестве скидки	Нет
bonuses	Комплексный	Список бонусных транзакций, проведенных в этом чеке	Нет
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
counters	Комлексный	Счетчики https://crystals.atlassian.net/browse/LENTAL-14 https://crystals.atlassian.net/browse/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

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

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

10.3.23.0

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

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

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

Описание

CLIENT_COUNTERPARTY_CARD

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

value

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

Пример чека

Дополнительная информация по мягкому чеку 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"/>
        </positions>
        <payments>
            <payment typeClass="CashChangePaymentEntity" amount="3.69" description=""/>
            <payment typeClass="CashPaymentEntity" amount="50.0" description="Оплата наличными"/>
        </payments>
    </purchase>
</purchases>

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