Исходный код вики Импорт денежных сертификатов
Скрыть последних авторов
| author | version | line-number | content |
|---|---|---|---|
 |
5.1 | 1 | (% class="lead" %) |
| |
51.1 | 2 | Готовые [[денежные сертификаты>>doc:Main.Using.Gift_certificates.WebHome]], созданные вне системы Loymax, можно импортировать в Систему. |
| |
3.1 | 3 | |
| |
23.1 | 4 | Импорт денежных сертификатов включает следующие шаги: |
| |
6.2 | 5 | |
| |
19.6 | 6 | {{toc start="3"/}} |
| |
16.10 | 7 | |
| 8 | === Создание типа сертификата === | ||
| 9 | |||
| |
29.1 | 10 | Необходимо создать [[тип сертификата>>doc:Main.Using.Gift_certificates.Gift_certificates_MMP.Certificate_types.WebHome]] для дальнейшего выпуска и заказа сертификатов. Вид номинала и его значение могут быть любыми. |
| |
16.10 | 11 | |
| 12 | === Создание шаблона === | ||
| 13 | |||
| |
29.1 | 14 | Необходимо создать [[шаблон>>doc:Main.Using.Gift_certificates.Gift_certificates_MMP.Certificate_patterns.WebHome]] для дальнейшего выпуска и заказа сертификатов. |
| |
16.10 | 15 | |
| 16 | === Создание выпуска и заказа сертификатов === | ||
| 17 | |||
| 18 | Необходимо создать [[выпуск и заказ>>doc:Main.Using.Gift_certificates.Gift_certificates_MMP.Certificate_orders.WebHome]] сертификатов (не нажимая кнопку **Выполнить**). | ||
| 19 | |||
| 20 | === Создание рублевого счета для юридического лица === | ||
| 21 | |||
| |
58.2 | 22 | Следует убедиться, что у юридического лица есть рублевый счет. Если рублевого счета у Партнёра нет, необходимо добавить его [[средствами API>>doc:Main.Integration.Ways_to_use_API.System_Api_Methods.Methods_of_system_api.PartnerLegal.WebHome||anchor="001"]]. |
| |
16.10 | 23 | |
| |
33.1 | 24 | === Импорт сертификатов === |
| |
16.11 | 25 | |
| |
47.1 | 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"]]. |
| |
16.11 | 27 | |
| |
16.13 | 28 | (% class="box infomessage" %) |
| 29 | ((( | ||
 |
39.1 | 30 | **Примечания:** |
| 31 | |||
| 32 | 1. Рекомендуется импортировать не более 100 сертификатов в одной пачке. | ||
| 33 | 1. При возникновении ошибок во время импорта можно внести исправления в исходный файл и повторить процедуру импорта. Сертификаты, загрузка которых произошла без ошибок, будут пропущены при повторном запуске импорта. | ||
| |
49.1 | 34 | 1. Если при импорте не указать номер сертификата, то Система пометит файл как "Неверный формат загружаемого файла", т. к. номер сертификата является обязательным параметром. |
| |
16.13 | 35 | ))) |
| 36 | |||
| |
33.1 | 37 | ==== Требования к файлу импорта ==== |
| |
3.1 | 38 | |
| |
32.1 | 39 | * Сертификаты должны загружаться в Систему в файле формата CSV##;## |
| |
27.1 | 40 | * [[Идентификаторы сертификата>>doc:Main.Using.Gift_certificates.WebHome||anchor="ids"]], которые можно использовать при импорте: |
| |
50.1 | 41 | ** Уникальный номер, напечатанный на сертификате (Number) — **обязательный параметр**; |
| |
3.3 | 42 | ** Уникальный штрихкод, напечатанный на сертификате (Barcode); |
| 43 | ** Информация, зашитая в магнитную полосу (Strip1, Strip2, Strip3); | ||
| 44 | ** QR-код, напечатанный на сертификате (QRcode). | ||
| |
3.1 | 45 | * Возможные [[состояния>>doc:Main.Using.Gift_certificates.WebHome||anchor="lifetime"]] импортируемых денежных сертификатов: |
| |
3.3 | 46 | ** **На выдачу** (Prepared); |
| 47 | ** **Активирован** (Activated); | ||
| 48 | ** **Погашен** (Redeemed); | ||
| 49 | ** **Аннулирован **(Canceled); | ||
| 50 | ** **Истек **(Expired). | ||
| |
29.1 | 51 | * Баланс сертификата (Amount), т. е. сумма на счете сертификата, может быть любой в диапазоне 0..100000000, в том числе дробной (рубли и копейки). |
| |
32.1 | 52 | * Даты активации (ActivationDate) и истечения срока действия (ExpirationDate) сертификатов должны передаваться в формате **YYYY-MM-DD**. |
| |
3.1 | 53 | |
| |
33.1 | 54 | (% class="box warningmessage" %) |
| |
3.3 | 55 | ((( |
| |
58.3 | 56 | Нельзя импортировать денежные сертификаты, находящиеся в состоянии, которое означает незавершённый процесс: **В процессе активации** (Activating) или **В процессе возврата **(Refunding). |
| |
3.3 | 57 | ))) |
| |
3.1 | 58 | |
| |
38.1 | 59 | Пример импортируемого CSV-файла с денежными сертификатами: |
| |
3.3 | 60 | |
| 61 | {{code}} | ||
| |
44.1 | 62 | Number;BarCode;Strip2;Status;Amount;ActivationDate;ExpirationDate;RedemptionDate |
| |
45.1 | 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; | ||
| |
3.3 | 67 | |
| 68 | {{/code}} | ||
| 69 | |||
| |
12.3 | 70 | ((( |
| |
33.1 | 71 | (% class="box infomessage" %) |
| 72 | ((( | ||
| |
35.1 | 73 | **Примечание:** импортировать данные о погашенном сертификате (в состоянии Redeemed) можно только в случае, если сертификат является одноразовым или значение суммы сертификата (Amount) равно нулю. |
| |
12.3 | 74 | ))) |
| |
32.1 | 75 | |
| 76 | === Обновление информации о сертификатах === | ||
| 77 | |||
| |
38.1 | 78 | Если после импорта денежных сертификатов были внесены изменения, например сертификаты были проданы, погашены, аннулированы или др., необходимо загрузить CSV-файл с обновленными данными о сертификатах, состояние которых было изменено. |
| |
37.1 | 79 | |
| |
36.1 | 80 | (% class="box successmessage" %) |
| 81 | ((( | ||
| |
37.1 | 82 | Также можно провести **пакетную активацию денежных сертификатов**, передавая файл с денежными сертификатами в состоянии **Активирован**. Таким образом можно единоразово выдать большое количество сертификатов. |
| |
36.1 | 83 | ))) |
| 84 | |||
| |
32.1 | 85 | Например, сертификат с номером 7770002105606220002 был погашен, следовательно необходимо передать обновленный статус (Redeemed) и дату гашения — RedemptionDate в формате **YYYY-MM-DD**. Сертификат с номером 7770002105606220004 был активирован, его состояние изменилось со значения **На выдачу** на значение **Активирован**, данные об изменении также должны быть переданы в файле импорта. Пример файла CSV для данных сертификатов представлен ниже: |
| 86 | |||
| 87 | {{code}} | ||
| |
57.1 | 88 | Number;Status;Amount;ActivationDate;ExpirationDate;RedemptionDate |
| |
58.1 | 89 | 7770002105606220002;Redeemed;0;;;2022-12-12 |
| |
57.1 | 90 | 7770002105606220004;Activated;1000;2022-10-25;2024-10-25 |
| |
32.1 | 91 | {{/code}} |
| 92 | |||
| |
33.1 | 93 | (% class="box infomessage" %) |
| 94 | ((( | ||
| |
56.1 | 95 | **Примечание: **при обновлении данных о сертификате необходимо обязательно указывать его номер в качестве идентификатора. |
| |
33.1 | 96 | ))) |
| 97 | ))) |