API Set10 ◾️ Начисление бонусов из плагинов лояльности

Начиная с кассы версии 10.2.53.0, Set API версии 0.0.23, плагины лояльности могут уведомлять кассу о начислениях на карту бонусных баллов. Уведомление может выполняться либо при расчете скидок, либо перед фискализацией. Делается это путём создания транзакции начисления бонусных баллов. Если расчет скидок был отменен, плагин получает об этом уведомление и может зашедулить операцию отмены начисления бонусов. Предпочтительнее начислять бонусы перед фискализацией, так меньше возни с отменой начисления и повторным расчетом скидок.

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

В опердне уведомление о начислении бонусов на карту будет выглядеть так (рисунок 1). В качестве рекламной акции, согласно которой были начислены или списаны бонусы, всегда берётся имя рекламной акции, которая привела к срабатыванию расчета скидок в плагине лояльности.

Для того, чтобы бонусные операции по карте доходили и отображались в опердне, касса и сервер, к которому она подключена, должны иметь версию не ниже 10.2.53.0.

При экспорте в ERP эта информация отображается так (код 1):

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<purchases count="1">
    <purchase shop="6502" operationType="true" cash="1" shift="2" saletime="2018-07-30T12:39:12.316" transactionTime="2018-07-30T12:39:07.853" number="2" discountValueTotal="3.71" writeOffBonuses="3.0" chargeOnBonuses="33.0">
        <discount positionId="1" goodCode="00001" amount="0.71" isDiscountPurchase="false" AdvertActGUID="14337" AdvertActExternalCode="SR10_14337" AdvertActDiscountType="-1" advertType="DISCOUNT" quantity="1.0" externalActionId="plugin-discount"/>
        <discount positionId="1" goodCode="00001" amount="3.0" isDiscountPurchase="false" AdvertActGUID="14337" AdvertActExternalCode="SR10_14337" AdvertActDiscountType="-1" advertType="DISCOUNT" quantity="1.0" card-number="780000000005" transactionId="123-456-789" externalActionId="bonus-discount"/>
        <discountCard>780000000005</discountCard>
        <bonuses>
            <chargeOnBonuses transactionId="978-789-546" bonusesType="BONUS_SR10" amount="13.0" cardNumber="780000000005"/>
            <chargeOnBonuses transactionId="123456-8789" bonusesType="BONUS_SR10" amount="10.0" cardNumber="780000000005"/>
            <chargeOnBonuses transactionId="123456-8789" bonusesType="BONUS_SR10" amount="10.0" cardNumber="780000000005"/>
            <writeOffBonuses transactionId="123-456-789" bonusesType="BONUS_SR10" amount="3.0" cardNumber="780000000005"/>
        </bonuses>
    </purchase>
</purchases>

Код 1 - выгрузка информации о скидках и бонусных операциях по чеку. Начислено суммарно 33 бонуса, списано как скидку - 3 бонуса, все операции по карте "780000000005"

Код 1 получен вызовом метода getLoyResultsByPeriod веб-сервиса http://server-ip:8090/SET-ERPIntegration/FiscalInfoExport, версия экспорта 1.3 в параметре "fiscal.info.export.discounts.document.schema.version" БД set сервера, таблице sales_management_properties.