Публичный ресурс
Экспорт чеков из SetRetail10 в ERP (веб-сервис на стороне ERP)
ВЕРСИЯ ВЕБ-СЕРВИСА 1.25
Методы веб-сервиса для экспорта чеков
| Методы | processPurchases - без обратной связи processPurchasesWithTI - c обратной связью |
| URL | http://Любой_IP-адрес_на стороне_ERP_сервера/Set10PurchasesService |
| WSDL | http://Любой_IP-адрес_на стороне_ERP_сервера/Set10PurchasesService.wsdl |
Поле | Тип данных | Описание | Обязательное |
Принимаемые параметры | |||
purchases | base64Binary | Чеки в формате XML, закодированный в BASE64 | Да |
version | string | Версия xsd-схемы выдаваемых данных | Нет |
Возвращаемые параметры | |||
return | boolean |
| Да |
Описание формата выгружаемых чеков
Методы веб-сервиса для экспорта аннулированных чеков
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 в случае успешной обработки пакета | Да |
Чеки <purchases>
purchases | |||
| |||
Наименование элемента | Тип данных | Описание | Обязательное |
purchase | Комплексный | Данные чека | Да |
Наименование атрибута | Тип данных | Описание | Обязательное |
count | Long | Количество передаваемых чеков, т.е. общее количество тегов purchase вложенных в общий тег | Нет |
Состав чека <purchase>
purchases/purchase | |||
| |||
Наименование атрибута | Тип данных | Описание | Обязательное |
tabNumber | String | Табельный номер кассира | Нет |
| returndayinday | Boolean | Признак для чека возврата "День в день" | Нет |
| username | String | Имя кассира | Нет |
| operationType | Boolean | Тип операции
| Нет |
| cashOperation | Комплексный | Кассовые операции для лотерей Столото НАЧИНАЯ С ВЕРСИИ ВЕБ-СЕРВИСА 1.15 SRTE-2953 - Получение подробных данных проблемы… СТАТУС 10.2.89.0
| Нет |
operDay | Date | Операционный день | Да |
shop | Long | Номер магазина | Да |
cash | Long | Номер кассы | Да |
shift | Long | Номер смены | Да |
| number | Long | Номер чека | Да |
| saletime | DateTime | Дата/Время продажи | Нет |
begintime | DateTime | Дата создания чека (добавления первого товара) | Нет |
amount | Decimal | Сумма чека | Нет |
discountAmount | Decimal | Сумма скидки на чек | Нет |
| denyPrintToDocuments | Boolean | Запрет печати сопроводительных документов | Нет |
| clientType | Комплексный | Тип клиента:
| Нет |
| client_guid | Long | Код клиента Данный атрибут не выгружается, если чек был экспорт с кассы был напрямую в SetESB (без участия SetCentrum или SetRetail), через веб-сервисы на стороне SetRetail или файловый экспорт. | Нет |
| qrcode | String | Состав QR-кода чека отправленного в ОФД НАЧИНАЯ С ВЕРСИИ ВЕБ-СЕРВИСА 1.14 SRTE-2915 - Получение подробных данных проблемы… СТАТУС 10.2.89.0 | Нет |
| fiscalDocNum | String | Номер фискального документа SRTE-3135 - Получение подробных данных проблемы… СТАТУС CR-4879 - Получение подробных данных проблемы… СТАТУС 10.2.93.0 | Нет |
| factorynum | String | Нет | |
| inn | String | ИНН SRTS-836 - Получение подробных данных проблемы… СТАТУС SRTS-848 - Получение подробных данных проблемы… СТАТУС CR-8028 - Получение подробных данных проблемы… СТАТУС 10.3.14.0 | Нет |
| kpp | String | КПП SRTS-836 - Получение подробных данных проблемы… СТАТУС SRTS-848 - Получение подробных данных проблемы… СТАТУС CR-8028 - Получение подробных данных проблемы… СТАТУС 10.3.14.0 | Нет |
storno | Boolean | Признак сторнирования (если чек был хотя бы один раз сторнирован) НАЧИНАЯ С ВЕРСИИ ВЕБ-СЕРВИСА 1.18 SRTE-3562 - Получение подробных данных проблемы… СТАТУС CR-5382 - Получение подробных данных проблемы… СТАТУС 10.2.99.0 Данный тип экспорта должен быть активирован. По умолчанию выключен.
Если чек не сторнировался, то данный атрибут не отображается. | Нет |
status | Комплексный | Статус чека НАЧИНАЯ С ВЕРСИИ ВЕБ-СЕРВИСА 1.9 SRTE-3562 - Получение подробных данных проблемы… СТАТУС CR-5382 - Получение подробных данных проблемы… СТАТУС 10.2.99.0 Данный тип экспорта должен быть активирован. По умолчанию выключен.
| Нет |
| cashType | String | Тип кассы Тип кассы не выгружается, если экспорт чека с кассы был напрямую в SetESB, без участия SetCentrum или SetRetail. 10.3.16.0 ВЕРСИЯ ВЕБ-СЕРВИСА 1.22 SRTS-1003 - Получение подробных данных проблемы… СТАТУС CR-8367 - Получение подробных данных проблемы… СТАТУС
| Нет |
| fiscalnum | String | Нет | |
Наименование элемента | Тип данных | Описание | Обязательное |
positions | Комплексный | Товарные позиции | Да |
payments | Комплексный | Оплаты | Да |
| discounts | Комплексный | Список скидок, сработавших в этом чеке | Нет |
discountCards | Комплексный | Список дисконтных карт, примененных при оплате этого чека | Нет |
card | Комплексный | Список карт, использованных при оплате этой покупки. Фактически более | Нет |
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>
Признак принадлежности к контрагенту
Выгрузка признака производится только при соединении с сервисом лояльности SLS.
| Наименование плагинного свойства | Описание |
|---|---|
| CLIENT_COUNTERPARTY_CARD | Признак “корпоративной покупки”, который покажет есть ли у клиента (физического лица), для которого зарегистрирован чек, привязка к контрагенту (юридическому лицу). |
| value | Значение признака в формате <номер карты юрлица клиента>:<номер дебитора> |
Дополнительная информация по мягкому чеку SetKit
SR-2709 - Получение подробных данных проблемы… СТАТУС
10.2.63.0
SetKit ◾️ Дополнительная информация о заказе в чеке
Наименование плагинного свойства | Описание |
sc.num.[ИДЕНТИФИКАТОР_МЯГКОГО_ЧЕКА] | Идентификатор мягкого чека |
| value |
<?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 | Признак фискализации чека без печати (отправка чека электронным способом). Значение по умолчанию: |
| PROMO_PRINT_DISABLED | Признак того, что рекламные материалы не были распечатаны. Значение по умолчанию: |
| FORCED_PRINT | Признак того, что чек был распечатан принудительно. Значение по умолчанию: |
| 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 | Сгенерированное значение уникального идентификатора чека. Пример:
|
Номер документа Пирит РБ
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 |
Запрос печати чеков
10.3.29.0
SR-6708 - Получение подробных данных проблемы… СТАТУС
CR-9689 - Получение подробных данных проблемы… СТАТУС
| Наименование плагинного свойства | Описание |
|---|---|
| PRINT_DIALOG_ANSWER | Запрос печати чеков |
| value |
|
Передача QR-кода от NFD
SRTZ-2991 - Получение подробных данных проблемы… СТАТУС
CR-10363 - Получение подробных данных проблемы… СТАТУС
10.4.0.0
| Наименование плагинного свойства | Описание |
|---|---|
| fiscalbarcode | Значение QR-кода, полученное от программного фискализатора NFD (Республика Казахстан)
|
Оплата чека одной транзакцией
SRTB-9140 - Получение подробных данных проблемы… СТАТУС
SRTZ-3861 - Получение подробных данных проблемы… СТАТУС
CR-12336 - Получение подробных данных проблемы… СТАТУС
10.4.13.0
| Наименование плагинного свойства | Описание |
|---|---|
| PRIMARY_PURCHASE_UID | UID_PURCHASE мастер-чека (UID чека, который был разделен) |
| FIRST_SPLIT_PURCHASE_NUMBER | Номер первого зарегистрированного чека |
| TOTAL_SUB_PURCHASES | Общее количество подчеков |
| SUB_PURCHASE_PART | Порядковый номер подчека |
Ответы ЕГАИС
| Наименование плагинного свойства | Описание |
| EGAIS_URL | HTTP-ссылка на покупку в системе ЕГАИС |
| EGAIS_SIGN | Подпись чека из системы ЕГАИС |
| EGAIS_CANCEL_SIGN | HTTP-ссылка на отмену покупки в системе ЕГАИС |
| EGAIS_CANCEL_URL | Подпись отмены чека из системы ЕГАИС |
| EGAIS_REQUEST | SOAP-запрос отправленный в ЕГАИС при продаже |
| EGAIS_RESPONSE | SOAP-ответ полученный от ЕГАИС при продаже |
| EGAIS_REQUEST_CANCEL | SOAP-запрос отправленный в ЕГАИС при аннулировании чека |
| EGAIS_RESPONSE_CANCEL | SOAP-ответ полученный от ЕГАИС при аннулировании чека |
| EGAIS_BEER_URL | HTTP-ссылка на покупку в системе ЕГАИС (пиво) |
| EGAIS_BEER_SIGN | Подпись чека из системы ЕГАИС (пиво) |
| EGAIS_BEER_CANCEL_SIGN | HTTP-ссылка на отмену покупки в системе ЕГАИС (пиво) |
| EGAIS_BEER_CANCEL_URL | Подпись отмены чека из системы ЕГАИС (пиво) |
| EGAIS_BEER_REQUEST | SOAP-запрос отправленный в ЕГАИС при продаже (пиво) |
| EGAIS_BEER_RESPONSE | SOAP-ответ полученный от ЕГАИС при продаже (пиво) |
| EGAIS_BEER_REQUEST_CANCEL | SOAP-запрос отправленный в ЕГАИС при аннулировании чека (пиво) |
| EGAIS_BEER_RESPONSE_CANCEL | SOAP-ответ полученный от ЕГАИС при аннулировании чека (пиво) |
Адрес магазина
10.4.17.0
SRTB-9543 - Получение подробных данных проблемы… СТАТУС
CR-13702 - Получение подробных данных проблемы… СТАТУС
| Наименование плагинного свойства | Описание |
|---|---|
| shopAddress | Адрес магазина, соответствующий коду магазина в параметре «purchases/purchase/shop» По умолчанию не выгружается. Для включения выгрузки воспользуйтесь статьей. |
Товарные позиции <positions>
purchases/purchase/positions | |||
| |||
Наименование элемента | Тип данных | Описание | Обязательное |
position | String | Позиции чека | Да |
Товарная позиция <position>
purchases/purchase/positions/position | |||
| |||
Наименование атрибута | Тип данных | Описание | Обязательное |
order | Long | Номер позиции | Да |
departNumber | Long | Номер отдела | Да |
goodsCode | String | Код товара Начиная с версии 10.2.96.0, для отдельных типов банковских операций проставляется значение
| Да |
barCode | String | ШК товара | Да |
count | Decimal | Количество | Да |
cost | Decimal | Цена за единицу | Да |
nds | Decimal | Значение НДС | Да |
| ndsClass | String | Наименование налога Данный атрибут не выгружается, если чек был экспорт с кассы был напрямую в SetESB (без участия SetCentrum или SetRetail), через веб-сервисы на стороне SetRetail или файловый экспорт. | Да |
ndsSum | Decimal | Сумма НДС | Да |
discountValue | Decimal | Сумма скидки | Да |
costWithDiscount | Decimal | Цена за единицу с учётом скидки | Да |
| amount | Decimal | Стоимость позиции | Да |
| softCheckNumber | String | Номер мягкого чека | Нет |
insertType | Integer | Способ добавления позиции
| Нет |
| dateCommit | DateTime | ||
Наименование элемента | Тип данных | Описание | |
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 |
Дата производства для позиции value в формате yyyy-MM-dd HH:mm | Нет |
plugin-property | String |
Количество товара в позиции с указанной датой производства value в формате double | Да для плагинного свойства верхнего уровня |
<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 | Тип акцизной продукции |
| |
?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 или нет.
|
<?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 | Налог с продаж (НСП) Применяется в Киргизии |
Признак прослеживаемого и импортного товара
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 |
Информация по комитенту (комиссионер)
10.3.22.0
SRTS-1492 - Получение подробных данных проблемы… СТАТУС
CR-9046 - Получение подробных данных проблемы… СТАТУС
| Наименование плагинного свойства | Описание |
|---|---|
| counterparty | Комиссионер |
| value | Данные по комиссионеру В формате JSON
|
Информация о проверке КМ в Честном знаке
10.4.0.0
SRTB-7949 - Получение подробных данных проблемы… СТАТУС
CR-6219 - Получение подробных данных проблемы… СТАТУС
| Наименование плагинного свойства | Описание |
|---|---|
| trueApiReqId | Уникальный идентификатор запроса проверки кода маркировки в сервисе Честного знака |
| trueApiReqTimestamp | Дата и время формирования запроса |
| trueApiValidationResponse | Полный ответ от сервиса Честный знак, в том числе коды ошибок из ответа, если они получены от ЧЗ, но при этом настройками разрешена продажа (например при недоступности сервиса Честного знака) Примеры значений
SRTB-8220 - Получение подробных данных проблемы… СТАТУС CR-11332 - Получение подробных данных проблемы… СТАТУС 10.4.4.0 |
| trueApiInst | Идентификатор экземпляра ИМ ЧЗ в формате UUID MARK-620 - Получение подробных данных проблемы… СТАТУС CR-12048 - Получение подробных данных проблемы… СТАТУС 10.4.12.0 |
| trueApiImDbVersion | Версия базы данных ИМ ЧЗ, на которой осуществлялась проверка. При наличии нескольких версий (если идет процесс синхронизации БД) указывается более старая версия, новая версия выгружается только после обновления всех БД на новую версию. MARK-620 - Получение подробных данных проблемы… СТАТУС CR-12048 - Получение подробных данных проблемы… СТАТУС 10.4.12.0 |
Пример экспорта онлайн-проверки
Параметры обращения к CDN-площадкам
10.4.2.0
SRTB-8095 - Получение подробных данных проблемы… СТАТУС
CR-11196 - Получение подробных данных проблемы… СТАТУС
| Наименование плагинного свойства | Описание |
|---|---|
| CDNAddress | Адрес CDN-площадки. Выгружается всегда, когда включена и настроена интеграция с Честным знаком. |
| responseReceived | Наличие ответа, если не произошло отключения по таймауту. Присутствует всегда, когда присутствует |
| responseDelayMs | Задержка получения ответа в миллисекундах, измеренная на стороне кассы. Присутствует всегда, когда есть |
| responseDescription | Текстовое описание результата выполнения запроса. Присутствует только при наличии ответа ( |
Признак вскрытия кега
10.4.4.0
SRTB-8370 - Получение подробных данных проблемы… СТАТУС
CR-11535 - Получение подробных данных проблемы… СТАТУС
| Наименование плагинного свойства | Описание |
|---|---|
| newBarrel | Признак вскрытия кега на кассе |
Информация о проверке КМ в Локальном модуле Честный Знак
10.4.6.0
SRTB-8566 - Получение подробных данных проблемы… СТАТУС
CR-12047 - Получение подробных данных проблемы… СТАТУС
| Наименование плагинного свойства | Описание |
|---|---|
| localTrueApiResponse | Результат проверки кода маркировки в Локальном модуле Честный Знак |
Унифицированный контрольный знак (УКЗ)
10.4.10.0
SRTB-8748 - Получение подробных данных проблемы… СТАТУС
CR-12031 - Получение подробных данных проблемы… СТАТУС
| Наименование плагинного свойства | Описание |
|---|---|
byFfdUkz | Унифицированный контрольный знак (УКЗ). Используется в Республике Беларусь. Подробнее в статье Беларусь ◾️ Маркировка |
Наименование товара
10.4.17.0
SRTB-9543 - Получение подробных данных проблемы… СТАТУС
CR-13702 - Получение подробных данных проблемы… СТАТУС
| Наименование плагинного свойства | Описание |
|---|---|
| goodName | Наименование товара, соответствующее коду товара в параметре «purchases/purchase/positions/positions/goodsCode» По умолчанию не выгружается. Для включения выгрузки воспользуйтесь статьей. |
Оплаты <payments>
purchases/purchase/payments | |||
| |||
Наименование атрибута | Тип данных | Описание | Обязательное |
payment | Комплексный | Список типов оплат | Да |
Тип оплаты <payment>
purchases/purchase/payments/payment | |||
| |||
Наименование атрибута | Тип данных | Описание | Обязательное |
| order | Long | Да | |
typeClass | String | Тип оплаты:
| Да |
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 Для включения экспорта текста банковского слипа выполните скрипт в базе данных сервера 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 | |
| operation.id | |
| department | Номер отдела при двухэтапной оплате через терминал Сбербанка. Подробнее в статье SetRetail10 ◾️ Двухэтапная оплата по отделам на банковском терминале Сбербанк SRTZ-3917 - Получение подробных данных проблемы… СТАТУС CR-13363 - Получение подробных данных проблемы… СТАТУС 10.4.14.0 |
<?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 | |
| order.id | Уникальный идентификатор заказа в системе партнёра |
| operation.id | Идентификатор операции |
| auth.code | Код авторизации Только для Сбербанка |
| qr.type | Тип QRC: динамический или кассовая ссылка |
| terminalNo |
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<purchases count="1">
<purchase returndayinday="true" tabNumber="09876" userName="Иванов Станислав Тарасович" operationType="false" operDay="2020-08-12+03:00" shop="234" cash="9" shift="1" number="5" saletime="2020-08-12T15:41:59.501+03:00" begintime="2020-08-12T15:41:53.081+03:00" amount="0.16" discountAmount="0.03" inn="7802781104">
<positions>
<position order="1" departNumber="581" goodsCode="45032" barCode="2300169" count="0.001" cost="189.7" nds="20.0" ndsSum="0.03" discountValue="0.03" costWithDiscount="160.0" amount="0.16" dateCommit="2020-08-12T15:41:53.090+03:00">
<plugin-property key="countryName" value="Россия"/>
</position>
</positions>
<payments>
<payment typeClass="BankQRPaymentEntity" amount="0.16" description="Оплата по QR-коду">
<plugin-property key="sberbank_qr.id.qr" value="20306"/>
<plugin-property key="terminal.number" value="21342923"/>
<plugin-property key="cash.transaction.id" value="105020"/>
<plugin-property key="cash.transaction.date" value="2020-08-12 15:42:02.000"/>
<plugin-property key="bank.id" value="QR Сбербанк"/>
<plugin-property key="ref.number" value="302602845102"/>
<plugin-property key="merchant.id" value="00000016"/>
<plugin-property key="order.id" value="2a6e1853f94b4fcfa8ca941eaf8b4a1a"/>
<plugin-property key="operation.id" value="3582a60bcc9b4b449b7928dea912f035"/>
<plugin-property key="auth.code" value="845102"/>
</payment>
</payments>
<original-purchase operDay="2020-08-12+03:00" shop="234" cash="9" shift="1" number="4" saletime="2020-08-12T15:41:07.364+03:00"/>
</purchase>
</purchases>
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<purchases count="1">
<purchase tabNumber="333" userName="Петрова Лидия Ивановна" operationType="true" operDay="2020-08-12+03:00" shop="234" cash="1" shift="2" number="12" saletime="2020-08-12T21:14:16.402+03:00" begintime="2020-08-12T21:13:37.725+03:00" amount="50.0" discountAmount="0.0" inn="7801111101">
<positions>
<position order="1" departNumber="583" goodsCode="45033" barCode="4607141310331" count="1.0" cost="50.0" nds="10.0" ndsSum="4.55" discountValue="0.0" costWithDiscount="50.0" amount="50.0" dateCommit="2020-08-12T21:13:37.732+03:00">
<plugin-property key="countryName" value="Россия"/>
</position>
</positions>
<payments>
<payment typeClass="BankQRPaymentEntity" amount="50.0" description="Оплата по QR-коду">
<plugin-property key="cash.transaction.id" value="110060"/>
<plugin-property key="cash.transaction.date" value="2020-08-12 21:13:45.432"/>
<plugin-property key="bank.id" value="Райффайзенбанк СБП"/>
<plugin-property key="merchant.id" value="MA0000002371"/>
<plugin-property key="order.id" value="6493ec4e-8f96-4d8b-a1a4-166dddef17e6"/>
<plugin-property key="operation.id" value="24430"/>
</payment>
</payments>
</purchase>
</purchases>
Внешний банковский терминал
Наименование плагинного свойства | Описание |
purchase.number | Номер чека терминала |
card.number | Последние 4 цифры номера карты |
auth.code | Код авторизации |
Потребительский кредит
Наименование плагинного свойства | Описание |
contract.bank | Название банка |
contract.bank.product | Название продукта банка |
consumer.name | Имя клиента |
contract.number | Номер договора |
Подарочная карта
Наименование плагинного свойства | Описание |
gift.card.number | Номер подарочной карты |
Подарочная карта ЦФТ
Наименование плагинного свойства | Описание |
amount | Сумма активации карты |
activationTransactionId | Внешний идентификатор |
activationDateTime | Дата и время выполнения транзакции |
clientIDType | Тип идентификатора карты в транзакции (clientIDType 2 – track2; 4 – barcode) |
clientID | Идентификатор карты в транзакции |
partnerID | Идентификатор партнера |
location | Идентификатор точки |
terminal | Идентификатор терминала |
Тип поставщика (Узбекистан)
Наименование плагинного свойства | Описание |
uz-ffd-owner-type |
Ответы по ЕГАИС для экспорта чеков в ERP
Наименование плагинного свойства | Описание |
uz-ffd-owner-type | Тип поставщика (Узбекистан) |
Список скидок <discounts>
purchases/purchase/discounts | |||
| |||
Наименование атрибута | Тип данных | Описание | Обязательное |
| positionId | Long | Порядковый номер позиции на которую распространяется данная скидка, если 0-то скидка на чек | Да |
| goodCode | String | Код товара (из позиции) по которой было начисление | Нет |
| amount | Decimal | Сумма скидки (по позиции/чеку), в "рублях" | Да |
| isDiscountPurchase | Boolean | Признак того что скидка распространяется на весь чек | Да |
| AdvertActGUID | Long | Идентификатор рекламной акции | Да |
| AdvertActExternalCode | String | SRTS-2304 - Получение подробных данных проблемы… СТАТУС CR-10684 - Получение подробных данных проблемы… СТАТУС 10.3.31.0
Если настройка "Заполнять AdvertActExternalCode при выгрузке чеков идентификаторами цен" включена, то в поле AdvertActExternalCode передаётся идентификатор цены. Для включения настройки выполните скрипт в базе данных сервера
Если настройка "Заполнять AdvertActExternalCode при выгрузке чеков идентификаторами цен" выключена, то в поле AdvertActExternalCode передаётся внешний код акции. Для выключения настройки выполните скрипт в базе данных сервера | Нет |
| advertType | String | Тип/характер применённой скидки Возможные значения:
| Да |
| AdvertActDiscountType | String | Тип скидки. Также с точки зрения Set5
| Нет |
| card-number | String | Номер карты (или купона), по которому сработала скидка на эту позицию | Нет |
| quantity | Decimal | Количество товара, на которое сработала скидка | Нет |
| externalActionId | String | Идентификатор акции внешней системы | Нет |
| Наименование элемента | Тип данных | Описание | Обязательное |
| actionLabels | Комплексный | Метки рекламной акции | Нет |
Метки рекламной акции <actionLabels>
purchases/purchase/discounts/discount/actionLabels/label | |||
| |||
Наименование элемента | Тип данных | Описание | Обязательное |
label | String | Наименование метки рекламной акции | Нет |
Список карт, примененных в чеке <discountCards>
purchases/purchase/discountCards/discountCard | |||
| |||
Наименование элемента | Тип данных | Описание | Обязательное |
discountCard | String | Номер карты | Нет |
Подробная информация по картам, примененным в чеке <card>
purchases/purchase/card | |||
| |||
Наименование атрибута | Тип данных | Описание | Обязательное |
type | String | Тип карты:
| Нет |
| card_type_guid | Long | Код категории карты | Нет |
number | String | Номер карты | Да |
| guid | String | GUID карты | Нет |
| addedBy | String | Способ добавления карты/купона SLS-1290 - Получение подробных данных проблемы… СТАТУС CR-5582 - Получение подробных данных проблемы… СТАТУС 10.3.4.0
| Нет |
Ссылка на оригинальный чек продажи <original-purchase>
Заполняется только для чеков возврата: хранит ссылку на оригинальный чек продажи.
purchases/purchase/original-purchase | |||
| |||
Наименование атрибута | Тип данных | Описание | Обязательное |
tabNumber | String | Табельный номер кассира | Нет |
| username | String | Имя кассира | Нет |
| operationType | Boolean | Тип операции
| Нет |
operDay | Date | Операционный день | Да |
shop | Long | Номер магазина | Да |
cash | Long | Номер кассы | Да |
shift | Long | Номер смены | Да |
| number | Long | Номер чека | Да |
| saletime | DateTime | Дата/Время продажи | Нет |
begintime | DateTime | Дата создания чека (добавления первого товара) | Нет |
amount | Decimal | Сумма чека | Нет |
discountAmount | Decimal | Сумма скидки на чек | Нет |
| denyPrintToDocuments | Boolean | Запрет печати сопроводительных документов | Нет |
| clientType | String | Тип клиента:
| Нет |
| client_guid | Long | Код клиента | Нет |
Информация по транзакции списания бонусов в качестве скидки <bonus-discount>
purchases/purchase/bonus-discount | |||
| |||
Наименование атрибута | Тип данных | Описание | Обязательное |
type | String | Тип бонусной системы, в настоящей версии поддерживается только одно значение - CRM | Нет |
transaction-id | String | Идентификатор транзакции, в рамках которой произошло списание бонусов | Нет |
Список бонусных транзакций <bonuses>
purchases/purchase/bonuses | |||
| |||
Наименование атрибута | Тип данных | Описание | Обязательное |
transactionId | String | Идентификатор транзакции | Нет |
| bonusesType | String | Тип бонусного процессинга Возможные значения:
| Да |
| chargeOnBonuses | Decimal | Сумма транзакции - начисление | Нет |
| writeOffBonuses | Decimal | Сумма транзакции - списание | Нет |
| cardNumber | String | Номер карты | Нет |
| cardGuid | String | Идентификатор карты | Нет |
| bonusaccountsid | Long | ID бонусного счета | Нет |
| AdvertActExternalCode | String | SRTS-2304 - Получение подробных данных проблемы… СТАТУС CR-10684 - Получение подробных данных проблемы… СТАТУС 10.3.31.0
Если настройка "Заполнять AdvertActExternalCode при выгрузке чеков идентификаторами цен" включена, то в поле AdvertActExternalCode передаётся идентификатор цены. Для включения настройки выполните скрипт в базе данных сервера
Если настройка "Заполнять AdvertActExternalCode при выгрузке чеков идентификаторами цен" выключена, то в поле AdvertActExternalCode передаётся внешний код акции. Для выключения настройки выполните скрипт в базе данных сервера | Нет |
| AdvertActDiscountType | String | Код типа акции | Нет |
| AdvertActGUID | Long | Guid акции | Нет |
| Наименование элемента | Тип данных | Описание | Обязательное |
| actionLabels | Комплексный | Метки рекламной акции | Нет |
| bonusPosition | Комплексный | Попозиционные данные о списаниях/начислениях бонусов | Нет |
Метки рекламной акции <actionLabels>
purchases/purchase/bonuses/actionLabels | |||
| |||
Наименование элемента | Тип данных | Описание | Обязательное |
label | String | Наименование метки рекламной акции | Нет |
Попозиционные данные о списаниях/начислениях бонусов <bonusPosition>
SR-3097 - Получение подробных данных проблемы… СТАТУС
10.2.70.0
purchases/purchase/bonuses/bonusPosition | |||
| |||
Наименование элемента | Тип данных | Описание | Обязательное |
positionId | Long | Код строки позиции | Да |
| goodCode | String | Артикул товара | Нет |
| amount | Decimal | Сумма | Да |
| quantity | Decimal | Количество | Нет |
<?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 | Название акции, в рамках которой был выдан подарок | Нет |
| externalcode | String | Внешний код акции, в рамках которой был выдан подарок | Нет |
| guid | String | GUID акции, в рамках которой был выдан подарок | Нет |
| issued | Integer | Общее количество подарков предлагаемых к выдаче | Нет |
| scanned | Integer | Общее количество просканированных подарков | Нет |
| Наименование элемента | Тип данных | Описание | Обязательное |
| present | Комплексный | Список подарков | Нет |
| actionLabels | Комплексный | Метки рекламной акции | Нет |
<?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 | Расчетное количество "подарков" по условию | Нет |
| condition | String | Идентификатор условия (уникален в рамках РА), по которому производилось начисление/расчет количества подарков. | Нет |
Метки рекламной акции <actionLabels>
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 | Статус купона
| Нет |
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&s=120.70&fn=00a81bdf-19eb-4037-914e-9e6cd4ea79b1&i=13&fp=0&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&s=109.70&fn=00a81bdf-19eb-4037-914e-9e6cd4ea79b1&i=9&fp=0&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-код рекламной акции | Нет |
| actionName | String | Наименование рекламной акции | Нет |
| externalCode | String | Внешний код рекламной акции | Нет |
© 1995-2025, ООО "Кристалл Сервис Интеграция".
Все права защищены.