Импорты статусов карт

Редактировал(а) Татьяна Брыкова 2024/02/09 09:49

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

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

В разделе системы "Карты лояльности" при нажатии на «Импорт» появляется окно с кнопками. Для массового изменения статусов карт используются кнопки: «Загрузить файл статусов карт» и «Скачать шаблон импорта статусов карт»

1707472153856-523.png

Рис. Кнопка для импорта карт

1705923342644-277.png

Рис. Кнопки импорта карт для смены статусов

По итогу скачивания шаблона импорта на локальный компьютер загружается файл в формате xls  - "Изменение статусов карт_Шаблон импорта".

Файл импорта имеет следующие атрибуты:

ЗаголовокОписание
Номер картыНомер карты, статус которой должен быть изменен
Старый статусТекущий статус карты
Новый статусЦелевой статус карты
Код причины изменения статусаИдентификатор причины изменения статуса карты, указанный в записи справочника причин изменения статуса карты
КомментарийКомментарий при изменении статуса
Номер телефонаНомер телефона участника, к которому привязана карта
Имя участникаИмя участника, к которому привязана карта
Дата рожденияДата рождения участника, к которому привязана карта

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

 bonuscard_status_curbonuscard_status_newсhange_bonuscardstatus_reasonidchange_bonuscardstatus_commentmobile_phonebonuscardcontact_namebonuscardcontact_birthday
7000001977094831ПроданаАктивная1Подарок+79853154488Дмитрий29.12.1983

В файле импорта нет указания на обязательные поля,  при обработке записей система производит проверку данных на соответствие в базе. В случае несоответствия и/или  отсутствия данных выдает Ошибки или производит соответствующие действия.

После заполнения файла по шаблону его импорт осуществляется по кнопке «Загрузить файл статусов карт». В раскрывающемся окне можно как выбрать файл из проводника компьютера, так и перетащить файл в центральное окно. Максимальный объем файла импорта составляет 32 Мб.

По кнопке «Импортировать файл» запускается процесс импорта данных, после чего сразу автоматически открывается запись импорта. В нижнем правом углу экрана интерфейса появляется сообщение «Импорт завершен», «Обновлено успешно».

 Выбор партнера на этапе импорта файла не является обязательным шагом.

1705923509898-725.png

Рис. Окно для импорта файла со статусами карт

В подразделе системы «Импорт статусов карт» находятся связанные представления «Детали импорта», «Импортированные строки» и «Ошибки импорта», в которых отображаются результаты импорта по всем строкам файла импорта. В каждом представлении предусмотрена возможность скачать данные по кнопке «Экспорт».

1705923801618-605.png

Рис. Раздел меню системы «Импорты статусов карты» со связанными представлениями

1705924005008-155.png

Рис. Результаты импорта

1705923846379-413.png

Рис. Поля файла результатов импорта статусов карт

В столбце «Исходная строка» содержатся исходные данные импорта - старый статус, новый статус, код причины изменения статуса, комментарий, номер телефона, имя участника, дата рождения.

Перечень ошибок  и действий в системе при обработке импорта:

1.  «Карта не найдена» - импортируемой карты нет в системе.

2.  «Изменение статус карты из текущего на целевой запрещено» - если статус карты меняется на не разрешенный статус карты в соответствии с настройками системы.

Старый статусНовый статусПравила обработки импорта
ЗавершенаНовая, Продана, Активная, ЗаблокированаВ строке результатов импорта указывается статус «Ошибка» с описанием «Изменение статус карты из текущего на целевой запрещено»

3. «На карте есть транзакции» - возникает, если на карте есть транзакции.

Старый статусНовый статусПравила обработки импорта
ПроданаНовая

Если на карте есть транзакции, то в строке результатов импорта указывается статус «Ошибка» с описанием «На карте есть транзакции». Если на карте нет транзакций, то:

  1. Проверяется наличие контакта. Если контакт есть, то в строке результатов импорта указывается статус «Ошибка» с описанием «Карта привязана к контакту». Если контакта нет, то:
    1. Статус меняется.
    2. Удаляется связь счетчиков с картой.
АктивнаяНовая

Если на карте есть транзакции, то в строке результатов импорта указывается статус «Ошибка» с описанием «На карте есть транзакции». Если нет, то:

  1. Отвязывается карта от контакта.
  2. Удаляется  связь счетчиков с картой и контактом.
ЗаблокированаНовая

Если на карте есть транзакции, то в строке результатов импорта указывается статус «Ошибка» с описанием «На карте есть транзакции». Если нет, то:

  1. Отвязывается карта от участника.
  2. Удаляется связь счетчиков с картой и контактом.

4. «Карта привязана к контакту» - возникает при трансформации карты со статусом Продана в Новую, если на карте есть контакт (см. п. 3)

5. «Не заполнены атрибуты» - возникает, если хотя бы один из атрибутов карты не заполнен.

Старый статусНовый статусПравила обработки импорта
НоваяАктивная

Если хотя бы один из атрибутов карты не заполнен, то в строке результатов импорта указывается статус «Ошибка» с описанием «Не заполнены атрибуты». Если все атрибуты заполнены, то:

  1. Проверить номер телефона: Если номер телефона не совпадает, то в строке результатов импорта указывается статус «Ошибка» с описанием «Номер телефона не совпадает». Если номер телефона совпадает, то:
    1. Меняется статус карты.
Продана Активная

Если хотя бы один из атрибутов файла не заполнен, то в строке результатов импорта указывается статус «Ошибка» с описанием «Не заполнены атрибуты». Если все атрибуты заполнены, то:

  1. Проверить номер телефона. Если номер телефона не совпадает, то в строке результатов импорта указывается статус «Ошибка» с описанием «Номер телефона не совпадает». Если номер телефона совпадает, то:
    1. Меняется статус карты.
ЗаблокированаАктивная

Если хотя бы один из атрибутов файла не заполнен, то в строке результатов импорта указывается статус «Ошибка» с описанием «Не заполнены атрибуты». Если все атрибуты заполнены, то:

  1. К контакту привязывается карта.

6. «Номер телефона не совпадает» - возникает при трансформации карты со статусом Новая (или Продана) в Активная, если номер телефона не совпадает.

7. «Карта не привязана к контакту» - возникает при трансформации карты со статусом Заблокирована в Продана, если карта не привязана к контакту.

Старый статусНовый статусПравила обработки импорта
ЗаблокированаПродана

Если карта не привязана к контакту, то в строке результатов импорта указывается статус «Ошибка» с описанием «Карта не привязана к контакту». Если карта привязана, то:

  1. Карта отвязывается от контакта.

8. «Код причины изменения статуса не указан» - если указание кода причины изменения статуса карты обязательно, но код отсутствует. Обязательность указания кода регулируется соответствующей партнерской настройкой: Actions.UICardOperations.SetChangeStatusReason.TurnOn

9. «Код причины изменения статуса не найден в справочнике» - если код указан, но система не нашла код причины изменения в справочнике.

10.  «Комментарий при изменении причины не указан» - если указание комментария обязательно, но комментарий отсутствует. Обязательность указания комментария регулируется соответствующей партнерской настройкой: Actions.UICardOperations.SaveComments.TurnOn

11.  «Невозможно привязать еще одну карту данного типа» - если лимит количества карт в рамках типа исчерпан.