Работа с карточками

Каждая карточка характеризуется 3 параметрами: серийный код, логин и пароль. Логин и пароль карты должны быть введены пользователем для её активации как DialUP/VoIP аккаунт, либо указаны при пополнении картой баланса через Web интерфейс, либо IVR-систему.

Серийный код и логин - числа до 2000000000, пароль - строка длиной до 32 символов латинского алфавита, либо цифр. При создании карт, предназначенных для активации посредством IVR, либо иным способом, не позволяющим вводить буквы, рекомендуется делать цифровые пароли.

Серийный номер карты используется для всех операций по управлению картой; для удобства его рекомендуется делать равным логину при первом выпуске карт. В дальнейшем по мере повторного выпуска карт с теми же логинами образовывать добавлением к логину слева цифр 1, 2, 3. Карты следует выпускать сериями с возрастающими на единицу логинами и паролями.

Файл для загрузки карт должен выглядеть подобным образом:

serial1<табулятор>login1<табулятор>pswd1
serial2<табулятор>login2<табулятор>pswd2

Например:

10001 1  545454
10002 2  545dd4

Вы можете использовать стандартный генератор карт, доступный на сайте, либо реализовать свой. Стандартный генератор позволяет сохранять карты в указанном выше формате.

Жизненный цикл карты включает в себя несколько состояний:

  • Заблокирована - только что загруженная в базу карта, не назначенная дилеру и не поступившая в продажу, она не может быть активирована;

  • Активна - карта передана дилеру и может быть активирована либо для создания договора и логина DialUP/VoiceIP, либо для оплаты услуг;

  • Договор - карта была использована для автоматического создания договора и DialUP/VoiceIP логина в нем;

  • Баланс - карта была использована для пополнения баланса.

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

При активации карты для создания договора и логина логин и пароль карты преобразуется в логин и пароль модуля DialUP, либо модуля VoiceIP. Использовать данный логин для новый карты повторно можно только после того, как логины в модуле DialUP/VoiceIP будут освобождены и договоры удалены. Для проверки свободных логинов во всех модулях интегрирующихся с модулем карт есть вкладка Свободные логины.

Перед выпуском очередной серии карт следует проверить во всех модулях, где возможна активация карт данного типа в качестве логина, незанятость логинов карт. В противном случае при авторизации RADIUS-сервер будет находить старый логин и писать ошибку пароля карты. Галочка Исключить карточки исключает помимо логинов модуля логины карт из подключённого карточного модуля.

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

Свободные логины

Для загрузки карточек используется первая вкладка модуля Загрузка карточек.

Загрузка карточек

При загрузке карт указываются следующие параметры:

  • Путь к файлу карт - выбирается файл с данными карт, разделёнными табуляторами, каждая карта на новой строке (см. формат выше), при необходимости можно загрузить только часть строк из файла;

  • Шаблон договора - по этому шаблону будет создан договор при активации карты для создания договора и логина;

  • Сумма - номинал карты;

  • Тип платежа - такого типа платёж будет занесён в созданный договор; тип платежа должен быть создан в справочнике типов платежа с галочкой нередактируемый. Сумма платежа равна номиналу карточки;

  • Услуга пополенения баланса - баланс договора может быть пополнен этой карточкой только, если у договора есть в разрешённых данная услуга. Нужно это затем, чтобы возможно было создать карточки, которыми можно будет только создать договор, но не пополнять баланс;

  • Услуга активации - фильтр по услугам активации можно указывать в конфигурации NASов модуля VoiceIP, либо DialUP. Так, например, можно создать карты, активируемые только на VoiceIP NASах, и универсальные карты, активируемые везде. Реализуется заведением 2х услуг и прописыванием их двоих на VoiceIP NASах и только услуги универсальной карты на всех других;

  • Период - в течении данного периода карта должна быть активирована;

  • Серия - название серии карт; серия используется для более удобного управления загруженными картами в дальнейшем.

Серии следует именовать подобным образом - "Универсальные 200 ки от 24.06.07 1000 штук" - для простой идентификации группы карт в дальнейшем. Если при загрузке какие-то данные были указаны неверно, вы можете редактировать карты, используя вкладку Серии. Также возможно удаление ошибочно загруженной серии.

Обязательно указывайте серию для загружаемых карт.
Серии

При изменении серии изменяются свойства всех карт, входящих в неё. Обратите внимание на столбец Свободно - это количество свободных карт, оставшихся в серии.

Для распределения карточек по дилерам и просмотра текущего состояния базы карточек воспользуйтесь вкладкой Менеджер карт.

Менеджер карт

Текстовая область в верхней области фильтра - для поиска карты. Введите туда номер карты, будет отображён дилер, получивший эту карту, и её статус.

Кроме ввода одиночных номеров возможен ввод конструкций вида "N+K" (вывести карту с номером N и ещё K карт после неё). Таким образом можно выбирать диапазоны карт по серийным номерам. При пустых фильтрах система выводит все карты в постраничном режиме.

С 4.0 версии в таблице карт отображается номер договора, для создания или пополнения которого была использована карта. Двойной клик по строке открывает договор.

Набор флажков сверху позволяет выбирать нужные типы карточек. Для выбора карт, отданных какому-либо дилеру, выберите этого дилера в списке слева. Кнопка Сброс возвращает все фильтры в исходное состояние и убирает выделение со списка дилеров.

Чтобы отдать карточки дилеру на реализацию, выберите дилера в списке слева и нажмите Передать дилеру.

Передать дилеру

При передаче карт можно указать как количество карт выдаваемое из каждой серии (отображаются только не пустые серии), так и перечислить серийные номера карточек. При перечислении можно использовать следующие конструкции, разделённые точкой с запятой:

  • n1 - одиночный номер карты;

  • n3-n4 - серийные номера от n3 до n4 включительно;

  • n5+k - серийный номер n5 и k карт после него.

При осуществлении передачи карт дилеру или возврата карт формируется Проводка, список проводок доступен на отдельной вкладке.

Проводки карт

В таблице возможна установка фильтров по типу проводки (выдача/возврат) и по дилеру. Колонка Стоимость формируется с вычетом скидки, указанной в свойствах дилера. При просмотре проводки формируются Акт передачи/возврата и Заявка на выдачу/возврат карт.

Внешний вид документов задаётся шаблоном card_action_pdf.xsl. Исходный XML документ выводится в лог server.log при установке его в режим DEBUG.

В XML документ передаётся название и дата договора с дилером, которые должны быть указаны в свойствах дилера следующим образом:

Формат названия и даты
Проводки карт

Каждую проводку можно откатить до того момента пока какая-либо карта, участвующая в проводке, не изменила свой статус (не была активирована для выдачи, либо не была передана другому дилеру для проводок возврата).

Для возврата карт от дилера в Менеджере карт выберите дилера и нажмите Забрать у дилера. При этом можно указывать только серийные номера по тем же правилам, что и при передаче карт.

Менеджер карт