Card – Карты

Свойство

Тип данных

Описание

Примечания
idcard

varchar(100)

Идентификационный номер карты

Обязательно для заполнения
idcardgroup

int(11)

Идентификационный номер группы карт 


idclient

varchar(100)

Идентификационный номер клиента 


number

varchar(200)

Номер карты 


validitydatebeg

date

Дата начала действия карты 


validitydateend

date

Дата окончания действия карты 


cardSumdecimal(20,2)Сумма на карте 
blockedint(11)Признак блокировки 
lastKnownBonusBalancedecimal(15,2)Баланс бонусов по последнему запросу (последнее использование карты)
lastKnownBonusBalanceDatedatetimeДата последнего запроса баланса бонусов (последнее использование карты)
multiplicatordecimal(15,2)Мультипликатор карты
multiplicatorbegdatetimeДата начала действия мультипликатора
multiplicatorenddatetimeДата окончания действия мультипликатора
multiplicatorcurrentdecimal(15,2)Текущий мультипликатор (по умолчанию)
discountpercentdecimal(5,2)Процент скидки
purchasesint(11)Количество покупок
pincodevarchar(100)Пин-код
cardstatusint(11)

Статус карты:

  • 0 – EARN_ONLY (анонимная, доступно только начисление),
  • 1 – EARN_PAY (активная, доступно начисление и списание),
  • 2 – NO_OPERATION (заблокирована, выполнение любых операций запрещено),
  • 3 – PAY_ONLY (новый статус, возможна только оплата).

statusvarchar(255)Зарезервировано для будущего использованияДанное поле находится только в БД кассового сервера
accountNumbervarchar(255)Номер счета, на который будут производиться начисленияДанное поле находится только в БД кассового сервера
shopcodevarchar(255)Код магазина
optionsint(11)

Опции карты (битовая маска):

  • 1 – запрещен возврат бонусных баллов.

CardChanged – История изменений записей карт

Таблица CardChanged используется только в БД All кассового сервера.

СвойствоТип данныхОписаниеПримечания
idint(11)Идентификатор операции изменения картыОбязательно для заполнения
userNamevarchar(100)Имя пользователя, выполнившего изменение
applicationvarchar(100)

Контрагент, через которого выполнена операция:

  • Yuki – операция выполнена через утилиту администрирования,
  • CS-REST-API – операция выполнена через rest-запрос или систему лояльности LM,
  • null – операция выполнена неавторизованным пользователем или через загрузку справочников.

operationvarchar(100)Выполняемая операция
date

datetime

Дата и время изменения

Остальные поля аналогичны полям таблицы Card. В истории изменений для каждого внесенного изменения сохраняются предыдущие (OLD) данные о карте и вновь заданные (NEW), чтобы при необходимости иметь возможность восстановления данных.

Additionalcard – Дополнительные карты

Таблица Additionalcard используется только в БД All кассового сервера.

СвойствоТип данныхОписаниеПримечания
additionalnumbervarchar(200)Номер дополнительной картыОбязательно для заполнения
idcardgroupbigint(20)Идентификационный номер группы дополнительных картОбязательно для заполнения
cardnumbervarchar(200)Номер основной карты
idclientvarchar(200)Идентификационный номер клиента
isactivetinyint(4)

Признак активности карты:

  • 0 или NULL – неактивна,
  • 1 – активна.

Cardgroupsearchplace – Место поиска карты

Таблица Cardgroupsearchplace используется только в БД All кассового сервера.
СвойствоТип данныхОписаниеПримечания
idcardgroupint(20)Идентификационный номер группы дополнительных картОбязательно для заполнения
searchplacevarchar(100)

Место поиска. Может принимать значения:

  • MAIN_CARD – поиск будет производиться в таблице cardTemp,
  • ADDITIONAL_CARD – поиск будет производиться по номеру дополнительной карты и коду группы карт в таблице additionalcardTemp.
Обязательно для заполнения
namevarchar(100)Наименование записи.Используется для описания метода поиска. Например, "Поиск по дополнительным картам".
extendedparamsmediumtextJSON-строка, содержащая поля для настройки верификации CardsMobileУстарело

Cardgroup – Группы карт

Свойство

Тип данных

Описание

Примечания
idcardgroup

int(11)

Идентификационный номер группы карт

Обязательно для заполнения
name

varchar(200)

Наименование группы карт


text

varchar(200)

Текст – описание группы карты


cardmode

int(11)

Тип карты:

  • 0 – Дисконтная,
  • 1 – Артикс Бонус,
  • 5 – Карта Террасофт,
  • 6 – Социальная карта,
  • 7 – RS.Loyalty,
  • 8 – CardLab,
  • 9 – Золотая корона,
  • 10 – EPS,
  • 11 – Loymax,
  • 12 – ABMLoyalty,
  • 17 – UDS,
  • 18 – Plazius,
  • 19 – Manzana2019,
  • 20 – KilBil,
  • 21 – Единая Карта Петербуржца,
  • 23 – Manzana Loyalty Online,
  • 24 – Mindbox.

prefixbeg

varchar(200)

Начало диапазона префикса номеров карт


prefixend

varchar(200)

Конец диапазона префикса номеров карт


lenbegint(11)Начало диапазона длин номеров карт
lenendint(11)Конец диапазона длин номеров карт
regexpatternvarchar(200)

Маска номеров карт (регулярное выражение)


inputmaskint(11)

Способ ввода карт из группы (битовая маска):

  • 0 – не определено,
  • 1 – вручную,
  • 2 – сканер штрих-кода,
  • 4 – ридер карт,
  • 8 – банковский терминал,
  • 16 – получение данных удаленно с сервера.

regexrulevarchar(200)Правило преобразования номера карты (регулярное выражение)
valutcodeint(11)Код валюты (устанавливается для бонусных карт, зарезервировано для будущего использования)
discounttypeint(11)

Тип скидки:

  • 0 – процентная,
  • 1 – абсолютная,
  • 2 – индексная.

discountvaluedecimal(5,2)Значение скидки
bonususecaseint(11)

Способ применения бонусов:

  • 0 – скидка,
  • 1 – оплата.

(зарезервировано для будущего использования)


showinfoint(11)

Показывать информацию по карте после ввода:

  • 0 – нет,
  • 1 – да.

notaddemptycardint(11)

Не добавлять в чек карты из данной группы карт, если они не найдены в БД:

  • 0 – нет,
  • 1 – да.

additionalregistrationint(11)

Запрашивать дополнительную регистрацию карты. По умолчанию NULL.

  • 0 или NULL – нет,
  • другое значение – да.

patternvarchar(200)Зарезервировано для будущего использованияДанное поле находится только в БД кассового сервера
printinfoint(11)

Печать квитанции с информацией о бонусах

  • 0 – не печатать,
  • 1 – печатать.

searchruleint(11)

Правило поиска карт:

  • 0 или NULL – поиск карт происходит по номеру карты,
  • 1 - поиск карт по номеру телефона,
  • 3 - поиск карт по хэшу номера карты.

userawdataint(11)

Правило обработки номера карты перед отправкой на сервер:

  • 0 или NULL – номер карты преобразуется перед отправкой на сервер в соответствии с правилом преобразования,
  • 1 – номер карты отправляется на сервер без преобразования.

optionsint(11)

Правило поиска онлайн-карты:

  • 0 или NULL – карта будет получена с удаленного сервера,
  • 1 – поиск карты будет выполнен в БД кассы.

Verification – Типы верификации

Свойство
Тип данных
Описание
Примечания
idverificationint(11)Код верификацииОбязательно для заполнения
typevarchar(255)

Тип верификации:

  • AUTO – автоматическая верификация,
  • NONE – без верификации,
  • SMS – верификация по смс,
  • TELEGRAM – верификация через telegram,
  • PUSH – верификация по сообщениям из мобильного приложения,
  • CARDSMOBILE – верификация через сервис CardsMobile,
  • REST – верификация через внешний сервис.

Обязательно для заполнения.

Можно указать несколько типов верификации через запятую

namevarchar(255)Описание типа верификации. Используется в списке типов верификации, которые предлагаются кассируОбязательно для заполнения
attributeint(11)

Признак верификации:

  • 0 или null – безусловная,
  • 1 – отложенная,
  • 2 – автоверификация.

Cardgroupverification – Список верификации для способа ввода

Свойство
Тип данных
Описание
Примечания
idcardgroupint(11)Идентификационный номер группы картОбязательно для заполнения.
idverificationint(11)Код верификацииОбязательно для заполнения.
inputsourceint(11)

Способ ввода карт:

  • 0 – не определено,
  • 1 – вручную,
  • 2 – сканер штрих-кода,
  • 4 – ридер карт,
  • 8 – банковский терминал,
  • 16 – получение данных с сервера.

Обязательно для заполнения.

Правило использования битовых масок не может быть применено.

Для каждого способа ввода карт создается отдельная запись

extraverificationtinyint(1)

Флаг дополнительной верификации:

  • 0 – основная верификация,
  • 1 – дополнительная.

Personaloffer – Индивидуальные предложения по карте

Таблица Personaloffer используется только в БД кассового сервера.

Свойство

Тип данных

Описание

Примечания

idclientvarchar(255)Идентификационный номер клиентаОбязательно для заполнения
namevarchar(255)Название индивидуального предложенияОбязательно для заполнения
contentvarchar(255)

Содержимое индивидуального предложения


startdatedatetimeДата начала действия индивидуального предложения
enddatedatetimeДата окончания действия индивидуального предложения

Certificate – Сертификаты

Свойство

Тип данных

Описание

Примечания

codevarchar(100)Код группы сертификатовОбязательно для заполнения
rangefromdecimal(20,0)Начальный номер периода
rangetodecimal(20,0)Конечный номер периода
namevarchar(100)Название (отображается как наименование типа оплаты)
sumdecimal(20,2)Номинал
inputmaskint(11)Маска ввода
fullyspendint(11)Полное/частичное списание
skiplastsymbolint(11)Пропускать последний символ в номере сертификата при вводе со сканера штрих-кодов
tmccodevarchar(30)Код товара при добавлении в чек
minsumdecimal(13,2)Минимальная сумма для продажи сертификата
maxsumdecimal(13,2)Максимальная сумма для продажи сертификата
multiplesumdecimal(13,2)Кратность суммы для продажи сертификата
deptcodeint(11)Отдел
vatcodeint(11)Налог
paymentobjectint(11)Признак предмета расчета
regexpatternvarchar(50)Регулярное выражение номеров группы сертификатов
discountcampaigntextСрок жизни сертификата
  • No labels