Исходный код вики Импорт денежных сертификатов
Последние авторы
| author | version | line-number | content |
|---|---|---|---|
| 1 | (% class="lead" %) | ||
| 2 | С версии 2022.1 появилась возможность импортировать готовые [[денежные сертификаты>>doc:Main.Using.Gift_certificates.WebHome]], созданные вне системы Loymax. | ||
| 3 | |||
| 4 | Импорт денежных сертификатов включает следующие шаги: | ||
| 5 | |||
| 6 | {{toc start="3"/}} | ||
| 7 | |||
| 8 | === Создание типа сертификата === | ||
| 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" %) | ||
| 29 | ((( | ||
| 30 | **Примечания:** | ||
| 31 | |||
| 32 | 1. Рекомендуется импортировать не более 100 сертификатов в одной пачке. | ||
| 33 | 1. При возникновении ошибок во время импорта можно внести исправления в исходный файл и повторить процедуру импорта. Сертификаты, загрузка которых произошла без ошибок, будут пропущены при повторном запуске импорта. | ||
| 34 | ))) | ||
| 35 | |||
| 36 | ==== Требования к файлу импорта ==== | ||
| 37 | |||
| 38 | * Сертификаты должны загружаться в Систему в файле формата CSV##;## | ||
| 39 | * [[Идентификаторы сертификата>>doc:Main.Using.Gift_certificates.WebHome||anchor="ids"]], которые можно использовать при импорте: | ||
| 40 | ** Уникальный номер, напечатанный на сертификате (Number); | ||
| 41 | ** Уникальный штрихкод, напечатанный на сертификате (Barcode); | ||
| 42 | ** Информация, зашитая в магнитную полосу (Strip1, Strip2, Strip3); | ||
| 43 | ** QR-код, напечатанный на сертификате (QRcode). | ||
| 44 | * Возможные [[состояния>>doc:Main.Using.Gift_certificates.WebHome||anchor="lifetime"]] импортируемых денежных сертификатов: | ||
| 45 | ** **На выдачу** (Prepared); | ||
| 46 | ** **Активирован** (Activated); | ||
| 47 | ** **Погашен** (Redeemed); | ||
| 48 | ** **Аннулирован **(Canceled); | ||
| 49 | ** **Возвращен **(Redunded); | ||
| 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 | {{code}} | ||
| 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; | ||
| 67 | |||
| 68 | {{/code}} | ||
| 69 | |||
| 70 | ((( | ||
| 71 | (% 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 | {{code}} | ||
| 88 | Number;BarCode;Strip2;Status;Amount;ActivationDate;ExpirationDate;RedemptionDate | ||
| 89 | 7770002105606220002;7770002105606220002;7770002105606227848=26067229740000002;Redeemed;0;2022-11-25;2023-11-25;2022-12-12 | ||
| 90 | 7770002105606220004;7770002105606220004;7770002105606227850=26067229740000004;Activated;1000;2022-10-25;2024-10-25 | ||
| 91 | {{/code}} | ||
| 92 | |||
| 93 | (% class="box infomessage" %) | ||
| 94 | ((( | ||
| 95 | **Примечание: **при обновлении данных о сертификате можно передавать один любой идентификатор сертификата. | ||
| 96 | ))) | ||
| 97 | |||
| 98 | |||
| 99 | ))) |