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

(% class="lead" %)

Готовые [[денежные сертификаты>>doc:Main.Using.Gift_certificates.WebHome]], созданные вне системы Loymax, можно импортировать в Систему.

3

4

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

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

9

10

Необходимо создать [[тип сертификата>>doc:Main.Using.Gift_certificates.Gift_certificates_MMP.Certificate_types.WebHome]] для дальнейшего выпуска и заказа сертификатов. Вид номинала и его значение могут быть любыми.

11

12

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

13

14

Необходимо создать [[шаблон>>doc:Main.Using.Gift_certificates.Gift_certificates_MMP.Certificate_patterns.WebHome]] для дальнейшего выпуска и заказа сертификатов.

15

16

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

17

18

Необходимо создать [[выпуск и заказ>>doc:Main.Using.Gift_certificates.Gift_certificates_MMP.Certificate_orders.WebHome]] сертификатов (не нажимая кнопку **Выполнить**).

19

20

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

21

22

Следует убедиться, что у юридического лица есть рублевый счет. Если рублевого счета у Партнера нет, необходимо добавить его [[средствами API>>doc:Main.Integration.Ways_to_use_API.System_Api_Methods.Methods_of_system_api.PartnerLegal.WebHome||anchor="001"]].

23

24

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

25

26

Импорт денежных сертификатов осуществляется с помощью [[методов API>>doc:Main.Integration.Ways_to_use_API.Gift_certificates_API.API_use_cases.WebHome||anchor="H41843C43F43E44044243443543D43543643D44B44544143544044243844443843A43044243E432"]] для денежных сертификатов. Для этого необходимо подготовить CSV-файл с информацией о денежных сертификатах. Получить данные о количестве ошибок при осуществлении импорта возможно с помощью специального [[метода API>>doc:Main.Integration.Ways_to_use_API.Gift_certificates_API.API_use_cases.WebHome||anchor="H41243E43743244043044943043544243843D44443E44043C43044643844E43E43143E44843843143A4304452C43243E43743D43843A44843844543F44043843F43043A43544243D43E43C43E43143D43E43243B43543D43843843443543D43543643D44B44544143544044243844443843A43044243E432"]].

27

28

(% class="box infomessage" %)

(((

**Примечания:**

1. Рекомендуется импортировать не более 100 сертификатов в одной пачке.

33

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

34

1. Если при импорте не указать номер сертификата, то Система пометит файл как "Неверный формат загружаемого файла", т. к. номер сертификата является обязательным параметром.

35

)))

36

37

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

38

39

* Сертификаты должны загружаться в Систему в файле формата CSV##;##

40

* [[Идентификаторы сертификата>>doc:Main.Using.Gift_certificates.WebHome||anchor="ids"]], которые можно использовать при импорте:

41

** Уникальный номер, напечатанный на сертификате (Number) — **обязательный параметр**;

42

** Уникальный штрихкод, напечатанный на сертификате (Barcode);

43

** Информация, зашитая в магнитную полосу (Strip1, Strip2, Strip3);

44

** QR-код, напечатанный на сертификате (QRcode).

45

* Возможные [[состояния>>doc:Main.Using.Gift_certificates.WebHome||anchor="lifetime"]] импортируемых денежных сертификатов:

46

** **На выдачу** (Prepared);

47

** **Активирован** (Activated);

48

** **Погашен** (Redeemed);

49

** **Аннулирован **(Canceled);

50

** **Истек **(Expired).

51

* Баланс сертификата (Amount), т. е. сумма на счете сертификата, может быть любой в диапазоне 0..100000000, в том числе дробной (рубли и копейки).

52

* Даты активации (ActivationDate) и истечения срока действия (ExpirationDate) сертификатов должны передаваться в формате **YYYY-MM-DD**.

53

54

(% class="box warningmessage" %)

55

(((

56

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

57

)))

58

59

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

60

61

62

Number;BarCode;Strip2;Status;Amount;ActivationDate;ExpirationDate;RedemptionDate

63

7770002105606220001;7770002105606220001;7770002105606227847=26067229740000001;Activated;555;2022-11-25;2023-11-25;

64

7770002105606220002;7770002105606220002;7770002105606227848=26067229740000002;Activated;345;2022-11-25;2023-11-25;

65

7770002105606220003;7770002105606220003;7770002105606227849=26067229740000003;Activated;100;2022-10-25;2024-10-25;

66

7770002105606220004;7770002105606220004;7770002105606227850=26067229740000004;Prepared;1000;2022-10-25;2024-10-25;

(((

(% class="box infomessage" %)

72

(((

73

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

74

)))

75

76

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

77

78

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

79

80

(% class="box successmessage" %)

81

(((

82

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

83

)))

84

85

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

86

87

88

Number;Status;Amount;ActivationDate;ExpirationDate;RedemptionDate

89

7770002105606220002;Redeemed;0;2022-11-25;2023-11-25;2022-12-12

90

7770002105606220004;Activated;1000;2022-10-25;2024-10-25

91

92

93

(% class="box infomessage" %)