Публичное пространство
Узбекистан ◾️ Выбор типа банковской карты с передачей в ОФД и печатью в чеке
https://crystals.atlassian.net/browse/SRTG-137
https://crystals.atlassian.net/browse/CR-14050
10.4.17.0
https://crystals.atlassian.net/browse/SRTG-197
https://crystals.atlassian.net/browse/CR-14282
10.4.18.0
Описание
В версии 10.4.17.0 добавлена передача типа банковской карты в ОФД в зависимости от выбранного типа оплаты для внешних банковских терминалов. В версии 10.4.18.0 для банковских терминалов Humo, Uzcard добавлена возможность ручного выбора кассиром типа банковской карты (физического или юридического лица). Также реализована печать информации о применении корпоративных карт и карт физических лиц в чеках.
Ценность
Соблюдение требований законодательства.
Логика работы
Для внешних банковских терминалов, до версии 10.4.18.0
Добавлена возможность настроить дополнительный процессинг для нового типа оплаты, для передачи корректного типа карты в зависимости от типа оплаты (процессинга).
Для оплат картой физического лица используются уже существующие процессинги:
HUMO (Внешний)
UZCARD (Внешний)
Для оплат картой юридического лица используются новые процессинги:
HUMO (Внешний) Корпоративная карта
UZCARD (Внешний) Корпоративная карта
Передача типа карты осуществляется по следующей логике:
При выборе типа оплаты с процессингом HUMO (Внешний) или UZCARD (Внешний), в фискализатор передается значение =2.
При выборе типа оплаты с процессингом HUMO (Внешний) Корпоративная карта или UZCARD (Внешний) Корпоративная карта, в фискализатор передается значение =1.
Под безналичными оплатами подразумеваются все оплаты, у которых в конфигурационных файлах оплаты указано:
paymentTypeFiscalNumFDD100 = 1
Или тип оплаты “ELECTRONIC” для плагинных типов оплат.
Для всех терминалов, начиная с версии 10.4.18.0
Для плагинов оплаты (Humo, Uzcard и их внешние версии) добавлено диалоговое окно с выбором типа банковской карты: Корпоративная (Юридическое лицо) или Личная (Физическое лицо).
Выбор типа карты запрашивается у пользователя при каждой инициализации оплаты.
Отображение диалогового окна регулируется настройкой в конфигурационном файле плагина оплаты.
Примеры работы
На сервере добавлены банковские процессинги:
UZCARD (внешний),
HUMO (внешний),
HUMO (Внешний) Корпоративная карта,
UZCARD (Внешний) Корпоративная карта.
На кассе активированы добавленные банки.
Оплата картой физического лица
Кассир добавляет товары в чек продажи.
Кассир выбирает тип оплаты с процессингом UZCARD (внешний) или HUMO (внешний).
Чек регистрируется, в фискализатор передается значение =2.
Оплата картой юридического лица (Корпоративная карта)
Кассир добавляет товары в чек продажи.
Кассир выбирает тип оплаты с процессингом HUMO (Внешний) Корпоративная карта или UZCARD (Внешний) Корпоративная карта.
Чек регистрируется, в фискализатор передается значение =1.
Выбор типа карты вручную
SetTouch
Кассир добавляет товары в чек продажи.
Кассир выбирает тип оплаты.
Кассир подтверждает сумму оплаты.
На кассе отображается окно с выбором карты физического лица или юридического лица. Кассир выбирает Личная.
Касса печатает чек. В ОФД отображается тип карты - Личный / Shaxsiy.
Клавиатурная касса
Кассир добавляет товары в чек продажи.
Кассир выбирает тип оплаты.
Кассир подтверждает сумму оплаты.
На кассе отображается окно с выбором карты физического лица или юридического лица. Кассир выбирает Корпоративная.
Касса печатает чек. В ОФД отображается тип карты - Корпоративный / Korporativ.
Настройка
На сервере перейдите в Кассовый модуль → Банки → добавьте процессинги.
Настройка окна выбора типа карты
Доступно начиная с версии 10.4.18.0
Что изменилось (SRTG-566)
Откройте на редактирование конфигурационный файл требуемого банка home/tc/storage/crystal-cash/config/plugins:
bank-arcom-config.xml,bank-uzcard-config.xml,bank-*_external-config.xml
Установите параметр
<property key="showCardTypeSelectDialog" value="true"/>→ сохраните изменения в файле → перезагрузите кассовый модуль.
Подтверждерние типа карты, которой был оплачен чек. Окно выбора типа карты
https://crystals.atlassian.net/browse/SRTG-566
https://crystals.atlassian.net/browse/CR-15594
10.4.26.0
Начиная с версии 10.4.26.0 при включённом параметре showCardTypeSelectDialog окно выбора типа карты расширено до 3 вариантов: Личная, Корпоративная, Социальная
Окно показывается для плагинов оплат Узбекистана:
АРКУС2 (Арком);
UzCard (Tenge Bank);
Humo (внешний и корпоративный);
Uzcard (внешний и корпоративный).
При отмене выбора типа карты происходит отмена выбранного способа оплаты и возврат на экран выбора способов оплаты.
Варианты кнопки отмены:
POS — «Отмена»;
TOUCH — «X»;
SCO V3 — «Вернуться назад».
Значения, передаваемые в чек/ФР/экспорт (card.type / cardType): Корпоративная=1, Личная=2, Социальная=3
“Корпоративная” -> значение
cardType=1“Личная” → значение
cardType=2“Социальная” -> значение
cardType=3
Примеры окна выбора карты:
Клавиатурная касса
SetTouch
SCOv3
Настройка печати типа карты в чеке продажи
Для печати типа карты в чеке продажи добавьте подстановку в секцию оплат <section id="payment">:
<section id="payment">
<list>
<line font="normal">
<text value="CardType" clip="true" width="0" filler="space" align="left"/>
<element value="card_type" width="0" filler="space" align="left"/>
</line>
<line>
<condition name="legalCardType">
<operand key="equal">
<varLogical>
<element value="card_type" width="0" align="left"/>
</varLogical>
<varLogical>
<numeral value="1"/>
</varLogical>
</operand>
</condition>
<text value="Corporate" width="0" clip="true"/>
</line>
<line>
<condition name="individualCardType">
<operand key="equal">
<varLogical>
<element value="card_type" width="0" align="left"/>
</varLogical>
<varLogical>
<numeral value="2"/>
</varLogical>
</operand>
</condition>
<text value="Individual" width="0" clip="true"/>
</line>Пример формы чека продажи .
Пример печати чека
Пример экспорта
Тип карты передается в плагинном свойстве оплаты card.type.
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<purchases count="1">
<purchase tabNumber="2" userName="Кассиров Кассир Кассирович" operationType="true" operDay="2025-07-28+03:00" shop="1456" cash="61" shift="1" number="1" saletime="2025-07-28T21:59:14.036+03:00" begintime="2025-07-28T19:59:59.736+03:00" amount="14.23" discountAmount="0.00" inn="7802781104">
<plugin-property key="externalSystemId" value="14560611753729151566"/>
<plugin-property key="PROMO_PRINT_DISABLED" value="true"/>
<plugin-property key="FN_DOC_NUM_IN_SHIFT" value="1"/>
<plugin-property key="FISCAL_DOC_ID" value="3"/>
<plugin-property key="CASHIER_NAME" value="Кассиров Кассир Кассирович"/>
<plugin-property key="UID_PURCHASE" value="bce38e05-ec30-4f22-933b-6d9a8e3af6b7"/>
<plugin-property key="KPP" value="780201001"/>
<plugin-property key="CASH_TIME_ZONE" value="+03:00"/>
<positions>
<position order="1" departNumber="1" goodsCode="00001" barCode="4600001000007" count="1.000" cost="14.23" nds="20.0" ndsSum="2.37" discountValue="0.00" costWithDiscount="14.23" amount="14.23" dateCommit="2025-07-28T19:59:59.785+03:00">
<plugin-property key="countryName" value="Бельгия"/>
<plugin-property key="ffdTag2108"/>
<plugin-property key="salesTax" value="0"/>
<plugin-property key="minimalPrice" value="-1"/>
</position>
</positions>
<payments>
<payment order="0" typeClass="BankCardPaymentEntity" amount="14.23" description="Оплата банковской картой">
<plugin-property key="card.hash"/>
<plugin-property key="cash.transaction.id" value="105005"/>
<plugin-property key="terminal.number"/>
<plugin-property key="code" value="bank"/>
<plugin-property key="cash.transaction.date" value="2025-07-28 21:59:12.990"/>
<plugin-property key="bank.id" value="UZCARD Корпоративная карта"/>
<plugin-property key="ref.number"/>
<plugin-property key="subclass" value="UZCARD Корпоративная карта"/>
<plugin-property key="card.type" value="1"/>
<plugin-property key="auth.code"/>
<plugin-property key="bank.type" value="UNKNOWN"/>
<plugin-property key="card.number"/>
</payment>
</payments>
</purchase>
</purchases>
Статьи по функциональности страны