Навигация

Импорт денежных сертификатов

С версии 2022.1 появилась возможность импортировать готовые денежные сертификаты, созданные вне системы Loymax.

Импорт денежных сертификатов включает следующие шаги:

Создание типа сертификата

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

Создание шаблона

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

Создание выпуска и заказа сертификатов

Необходимо создать выпуск и заказ сертификатов (не нажимая кнопку Выполнить).

Создание рублевого счета для юридического лица

Следует убедиться, что у юридического лица есть рублевый счет. Если рублевого счета у Партнера нет, необходимо добавить его средствами API.

Импорт сертификатов

Импорт денежных сертификатов осуществляется с помощью методов API для денежных сертификатов. Для этого необходимо подготовить CSV-файл с информацией о денежных сертификатах. Получить данные о количестве ошибок при осуществлении импорта возможно с помощью специального метода API.

Примечания:

  1. Рекомендуется импортировать не более 100 сертификатов в одной пачке.
  2. При возникновении ошибок во время импорта можно внести исправления в исходный файл и повторить процедуру импорта. Сертификаты, загрузка которых произошла без ошибок, будут пропущены при повторном запуске импорта.

Требования к файлу импорта

  • Сертификаты должны загружаться в Систему в файле формата CSV;
  • Идентификаторы сертификата, которые можно использовать при импорте: 
    • Уникальный номер, напечатанный на сертификате (Number);
    • Уникальный штрихкод, напечатанный на сертификате (Barcode);
    • Информация, зашитая в магнитную полосу (Strip1, Strip2, Strip3);
    • QR-код, напечатанный на сертификате (QRcode).
  • Возможные состояния импортируемых денежных сертификатов:
    • На выдачу (Prepared);
    • Активирован (Activated);
    • Погашен (Redeemed);
    • Аннулирован (Canceled);
    • Возвращен (Redunded);
    • Истек (Expired).
  • Баланс сертификата (Amount), т. е. сумма на счете сертификата, может быть любой в диапазоне 0..100000000, в том числе дробной (рубли и копейки).
  • Даты активации (ActivationDate) и истечения срока действия (ExpirationDate) сертификатов должны передаваться в формате YYYY-MM-DD.

Нельзя импортировать денежные сертификаты, находящиеся в состоянии, которое означает незавершенный процесс: В процессе выдачи (Activating) или В процессе возврата (Refunding).

Пример импортируемого CSV-файла с денежными сертификатами:

Number;BarCode;Strip2;Status;Amount;ActivationDate;ExpirationDate;RedemptionDate
7770002105606220001;7770002105606220001;7770002105606227847=26067229740000001;Activated;555;2022-11-25;2023-11-25;
7770002105606220002;7770002105606220002;7770002105606227848=26067229740000002;Activated;345;2022-11-25;2023-11-25;
7770002105606220003;7770002105606220003;7770002105606227849=26067229740000003;Activated;100;2022-10-25;2024-10-25;
7770002105606220004;7770002105606220004;7770002105606227850=26067229740000004;Prepared;1000;2022-10-25;2024-10-25;

Примечание: импортировать данные о погашенном сертификате (в состоянии Redeemed) можно только в случае, если сертификат является одноразовым или значение суммы сертификата (Amount) равно нулю.

Обновление информации о сертификатах

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

Также можно провести пакетную активацию денежных сертификатов, передавая файл с денежными сертификатами в состоянии Активирован. Таким образом можно единоразово выдать большое количество сертификатов.

Например, сертификат с номером 7770002105606220002 был погашен, следовательно необходимо передать обновленный статус (Redeemed) и дату гашения — RedemptionDate в формате YYYY-MM-DD. Сертификат с номером 7770002105606220004 был активирован, его состояние изменилось со значения На выдачу на значение Активирован, данные об изменении также должны быть переданы в файле импорта. Пример файла CSV для данных сертификатов представлен ниже:

Number;BarCode;Strip2;Status;Amount;ActivationDate;ExpirationDate;RedemptionDate
7770002105606220002;7770002105606220002;7770002105606227848=26067229740000002;Redeemed;0;2022-11-25;2023-11-25;2022-12-12
7770002105606220004;7770002105606220004;7770002105606227850=26067229740000004;Activated;1000;2022-10-25;2024-10-25

Примечание: при обновлении данных о сертификате можно передавать один любой идентификатор сертификата.

 

Создано 24/08/2022 04:26
Отредактировано 16/10/2023 00:16

Новости
Обновления
Облако тегов
Словарь
Наш блог
YouTube
Telegram