Расширенные атрибуты для чека и позиции
Расширенные атрибуты чека или позиции – это параметры, которые передаются в чеке, принимаются системой и их значения анализируются системой. В чеке может быть неограниченное количество расширенных атрибутов, причём они могут относиться и к чеку в целом, и к отдельной позиции чека.
Рис. Расширенные атрибуты чека в карточке чека
Рис. Расширенные атрибуты позиции чека в карточке позиции чека
Чековые и позиционные атрибуты анализируются системой отдельно. В чеке передаются внешние идентификаторы расширенных атрибутов и их значения. В системе хранятся определения расширенных атрибутов и границы диапазона допустимых значений. Когда регистрируется чек с расширенным атрибутом, то по внешнему идентификатору находится сам расширенный атрибут; если значение, переданное в чеке, выходит за допустимые значения, то система возвращает на POS-терминал ответ, в котором указывается, что такой чек с данным значением не может быть зарегистрирован в системе. Следует иметь в виду, что если значение хотя бы одного расширенного атрибута в чеке или в позиции чека выходит за допустимые пределы, то весь чек целиком не может быть зарегистрирован в системе.
По расширенным атрибутам чека и позиций может быть организована фильтрация через наборы чеков и позиций соответственно. В этих наборах есть дополнительные разделы, в которых указаны диапазоны для значений расширенных атрибутов. Если значения расширенных атрибутов, переданных в чеке, укладываются в диапазоны фильтра по расширенным атрибутам, то чек проходит фильтрацию и к нему может быть применено правило.
Важно! В системе атрибуты чека и позиции чека хранятся отдельно. Нельзя один и тот же атрибут использовать как для чека в целом, так и для отдельной позиции.
Допустимо использовать в чеке один и тот же атрибут, но с разными значениями. Например, можно для разных позиций использовать один и тот же атрибут с разными значениями. Таким образом можно организовать применимость позиционного правила к разным позициям чека: в зависимости от значения атрибута правило будет или не будет применяться к конкретным позициям.
Определения РА
Карточка Определения расширенного атрибута содержит следующую информацию:
| Поле | Описание | Обязательное поле | Редактирование |
| Активно | Бинарное поле, означающее, будет ли использоваться запись данного определения атрибута при регистрируемых событиях в системе (обрабатываться процессингом). | Да | Поле доступно для редактирования, заполняется вручную |
| Ответственный | Пользователь, ответственный за создание и ведение данной записи. | Да | Поле доступно для редактирования. Заполняется из справочника пользователей. |
| Подразделение | Подразделение, к которому относится данная запись. | Да | Поле доступно для редактирования. Заполняется из справочника подразделений. |
| Общие сведения | |||
| Ключ | Название (ключ) расширенного атрибута. | Да | Поле доступно для редактирования, заполняется вручную |
| Внешний идентификатор | Код интеграции с внешними системами. | Да | Поле доступно для редактирования, заполняется вручную |
| Тип атрибута | Параметр, который определяет какой это расширенный атрибут. Возможные значения:
Значение по умолчанию: Строка. | Да | Поле доступно для редактирования, заполняется вручную |
| Применим к | Возможные значения:
Значение по умолчанию: Чек. | Да | Поле доступно для редактирования, заполняется вручную |
| Показывать в ответах | Признак, задающий возможность вывода данного расширенного атрибута в ответах запросов (на данный момент - запрос баланса). Возможные значения:
| Да | Поле доступно для редактирования, заполняется вручную |
| Тип отображения | Тип отображения. Возможные значения:
| Нет | Поле доступно для редактирования, заполняется вручную |
| Описание | Подробное описание расширенного атрибута. | Нет | Поле доступно для редактирования, заполняется вручную |
| Отношения | |||
| Фильтры по чекам | |||
| Включено в фильтры по чекам (атрибут 1) | Представление, в котором показаны фильтры по чекам, в которых используется данный атрибут как первая категория фильтрации. | ||
| Включено в фильтры по чекам (атрибут 2) | Представление, в котором показаны фильтры по чекам, в которых используется данный атрибут как вторая категория фильтрации. | ||
| Фильтры по позициям | |||
| Включено в фильтры по позициям (атрибут 1) | Представление, в котором показаны фильтры по позициям, в которых используется данный атрибут как первая категория фильтрации. | ||
| Включено в фильтры по позициям (атрибут 2) | Представление, в котором показаны фильтры по позициям, в которых используется данный атрибут как вторая категория фильтрации. | ||
| Наборы расширенных атрибутов магазина | Представление, в котором показаны наборы расширенных атрибутов магазина, в которых используется данный атрибут. | ||
| Наборы расширенных атрибутов контакта | Представление, в котором показаны наборы расширенных атрибутов контакта, в которых используется данный атрибут. | ||
| Наборы расширенных атрибутов карты | Представление, в котором показаны наборы расширенных атрибутов карты, в которых используется данный атрибут. | ||
| Наборы расширенных атрибутов мастер-счёта | Представление, в котором показаны наборы расширенных атрибутов мастер-счёта, в которых используется данный атрибут. | ||
Внешний вид карточки Определения расширенного атрибута:
Рис. Карточка Определения расширенных атрибутов
Фильтрация по чековым расширенным атрибутам задаётся в фильтрах по чекам. Фильтрация по позиционным расширенным атрибутам задаётся в фильтрах по позициям чеков. И в фильтре по чекам, и в фильтре по позициям чеков можно одновременно использовать фильтрацию по двум расширенным атрибутам. То есть если в чеке значения данных расширенных атрибутов таковы, что оба они укладываются в указанные диапазоны, то такой чек или позиция подпадёт под условия фильтрации и связанное с наборами правило будет применено к чеку или позиции, если наборы включаемые. Для исключаемых, соответственно, наоборот.
Рис. Секция Расширенные атрибуты чека в карточке Фильтр по чекам
Рис. Секция Расширенные атрибуты позиции чека в карточке Фильтр по позициям чеков
Идентификация расширенных атрибутов осуществляется по внешнему идентификатору, который указывается в определении расширенного атрибута. Соответственно, внешний идентификатор чекового атрибута должен быть передан в теле чека, а внешний идентификатор позиционного атрибута должен быть передан в теле позиции чека.