Как отредактировать даты активации и сгорания баллов

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

Импорт выполняется в разделе Данные → Импорт. Нажмите «Новый импорт» для перехода к настройкам:

import-page.png

Шаг 1. Выберите действие с данными

  1. Выберите тип импорта — «Лояльность → Балльные счета».
  2. Выберите действие — «Редактировать баллы».

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

balance-edit-type.png

Шаг 2. Подготовьте и загрузите файл

  1. Определите, какие поля нужно загрузить. Обязателен идентификатор изменения баланса, остальные поля передаются, только если соответствующую дату нужно изменить.

    Поле

    Обязательно

    Описание

    Идентификатор изменений баланса

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

    Дата и время начала действия баллов по UTC

    Новая дата активации баллов в формате UTC. Передавайте, только если нужно изменить значение

    Дата и время сгорания баллов по UTC

    Новая дата сгорания баллов в формате UTC. Передавайте, только если нужно изменить значение. Чтобы стереть дату сгорания, передайте значение %CLEAR%

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

    • Формат — .csv или .txt.
    • Рекомендуемая кодировка — UTF-8.
    • Проверьте, что значения соответствуют допустимым форматам.
    balance-edit-example.png
    Файл изменит дату активации баллов на 19 августа и дату сгорания на 31 августа
  3. Загрузите файл для импорта и нажмите «Продолжить»:

    balance-edit-upload.png

Как редактирование дат влияет на баллы

Правильно выбранные даты позволяют разблокировать, заблокировать или аннулировать начисление:

  • Чтобы активировать заблокированные баллы, укажите дату начала действия в прошлом. Дата активации будет приведена к текущему времени.
  • Чтобы заблокировать активированные баллы, передайте дату начала действия в будущем — баллы снова станут недоступны до указанной даты. Доступно, только если баллы еще не начали тратить.
  • Чтобы обнулить начисление, в том числе еще заблокированное, проставьте дату сгорания в прошлом. Дата списания будет приведена к текущему времени. Доступно, только если баллы еще не начали тратить.
  • Чтобы стереть дату сгорания, передайте для нее значение %CLEAR%.

Ограничения редактирования

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

Шаг 3. Сопоставьте поля файла

Система автоматически сопоставляет колонки файла с полями в Mindbox. При необходимости скорректируйте сопоставление:

  1. В колонке «Импорт» отметьте галочками поля, которые нужно загрузить. Колонки без галочки будут пропущены.
  2. В колонке «Поле Mindbox» сопоставьте каждую колонку файла с полями проекта. Необязательные поля без сопоставления будут пропущены.
  3. Нажмите «Продолжить»:

balance-edit-fields.png

Шаг 4. Проверьте и запустите импорт

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

Если все верно — нажмите «Запустить импорт». При необходимости укажите комментарий импорта.

balance-edit-check.png

Как отслеживать импорт

После запуска импорт появится в списке на странице «Импорт». По каждой задаче отображаются:

  • дата запуска,
  • тип импорта,
  • исходный файл с комментарием,
  • прогресс загрузки,
  • количество импортированных строк и ошибок,
  • кто запустил.

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

balance-edit-imports-list.png

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

После успешного завершения задачи в записях начисления баллов обновятся даты активации и/или сгорания. Изменения видны в личной карточке клиента на вкладке «Баллы»:

Снимок экрана 2025-02-19 в 14.37.34