Как назначить несколько карт одновременно?
- Igor Klimkowicz
- 27 авг.
- 5 мин. чтения
Обновлено: 9 дек.
Содержание
Способы назначения карт в «Sparados»
Как назначить несколько карт одновременно?
ПРИСВОЕНИЕ — процесс назначения нескольких карт одновременно.
РЕДАКТИРОВАНИЕ — процесс одновременного редактирования нескольких карт.
Наивный, простой (totalAmountType)
Где я могу найти свой ID аккаунта и ID изображения?
Коды MCC
Где я могу увидеть статус привязки своих карт?
Что показывает отчет после привязки карт?
Сравнение привязки карт с использованием API и пакетного файла
В приложении «Sparados» визитные карточки можно назначить тремя способами:
Заполнение формы назначения карты (нажав кнопку «ПРИСВОИТЬ КАРТУ»)
Назначение карты с помощью API «Sparados» (ссылка на документацию)
Использование пакетного файла для одновременного назначения нескольких карт
Назначение карт с помощью пакетного файла работает аналогично заполнению формы в первом варианте, но позволяет присвоить несколько карт одновременно.
В этом учебном материале вы узнаете, как это сделать:
Как назначить несколько карт одновременно?
Перейдите во вкладку КАРТЫ
Нажав кнопку «ПРИСВОИТЬ НЕСКОЛЬКО», вы перейдете на страницу присвоения нескольких карт. Здесь необходимо загрузить действительный .csv файл, содержащий всю информацию, необходимую для генерации карт. Вы можете использовать файл «example.csv», расположенный над основным полем, в качестве примера (данные в файле предоставлены только для информационных целей и должны быть изменены).
Для всех лимитов группы будут применяться те же правила, что и при присвоении одной карты. Любой лимит, присвоенный с превышением группового лимита, потребует подтверждения у группы, находящейся выше вашей.
Если информация в файле имеет неверный формат, система отобразит сообщение о неправильной строке или ячейке:
ASSIGN
Процесс одновременного присвоения нескольких карт
Что должно быть в правильном CSV-файле при присвоении карт?
Название поля | Формат | Описание | Пример |
operation | текстовое поле | Тип операции ОБЯЗАТЕЛЬНО assign – присвоение карты edit – редактирование данных карты | assign |
approvalId | UUID | ID утверждения НЕОБЯЗАТЕЛЬНО для assign | approvalId |
Электронная почта сотрудника ОБЯЗАТЕЛЬНО | |||
phonePrefix | префикс | Код страны телефона сотрудника ОБЯЗАТЕЛЬНО | 48 |
phoneNumber | номер телефона | Номер телефона сотрудника ОБЯЗАТЕЛЬНО | 123456789 |
totalAmount | числовое поле | Баланс счета (с копейками – через точку) ОБЯЗАТЕЛЬНО | 2000.99 |
totalAmountType | текстовое поле | Только для редактирования | totalAmountType |
limitGeneral | сумма:период | Лимит за период (daily, weekly, monthly) для всех операций НЕОБЯЗАТЕЛЬНО | 50:weekly |
limitEcommerce | сумма:период | Лимит за период для интернет-операций НЕОБЯЗАТЕЛЬНО | 100:monthly |
limitAtm | сумма:период | Лимит снятия в банкоматах НЕОБЯЗАТЕЛЬНО (например, 0:daily чтобы заблокировать снятие) | 50:daily |
limitForeignTransaction | сумма:период | Лимит операций за границей НЕОБЯЗАТЕЛЬНО | 50:daily |
startDate | дата | Дата начала действия счета (формат: YYYY-MM-DD, YYYY.MM.DD, YYYY/MM/DD) ОБЯЗАТЕЛЬНО (по умолчанию сегодня) | 2025-01-01 |
endDate | дата | Дата окончания действия карты (тот же формат) ОБЯЗАТЕЛЬНО | 2027-01-01 |
cardAliasId | UUID | ID счета – находится в разделе СЧЕТА > детали счета ОБЯЗАТЕЛЬНО | 1ee5c171-393c-6140-b3d6-b9784a774ec2 |
visualId | UUID | ID графики карты – раздел КАРТЫ → ПРИСВОИТЬ КАРТУ НЕОБЯЗАТЕЛЬНО | 4b8a1286-4c79-475f-8932-4f3b29e7610e |
cardName | текстовое поле | Название карты НЕОБЯЗАТЕЛЬНО (по умолчанию пусто) | Lunch card Adam Kowalski |
allowChangeRequests | да/нет | Может ли сотрудник запрашивать увеличение лимита НЕОБЯЗАТЕЛЬНО (по умолчанию yes) | yes |
labels | числовое поле | Двузначные коды меток (через разделитель) НЕОБЯЗАТЕЛЬНО – изменить потом нельзя | `22 |
mccList | числовое поле | MCC коды (четырёхзначные, через ```) – покупки только в указанных категориях НЕОБЯЗАТЕЛЬНО | |
mccType | текстовое поле | blacklist – отклонять MCC коды whitelist – только указанные MCC коды НЕОБЯЗАТЕЛЬНО (по умолчанию whitelist) | whitelist |
spendCategoryId | UUID | Если spendCategoryId указано, поля mccType и mccList игнорируются. | 4b8a1286-4c79-475f-8932-4f3b29e7610e |
EDIT
Процесс одновременного редактирования нескольких карт
Что должно быть в корректном CSV-файле при редактировании карт?
💡Совет: чтобы завершить редактирование лимитов карт в файле, вы можете использовать последнюю отчетность по импорту карт. В ней будет заполнен столбец «approvedID», который идентифицирует карту. Вам нужно лишь удалить два столбца — «status» и «statusCode» — и ввести новые лимиты карт.
Название поля | Формат | Описание | Пример |
operation | текстовое поле | Тип операции ОБЯЗАТЕЛЬНО: assign – когда карта должна быть назначена, edit – когда данные карты должны быть обновлены | edit |
approvalId | UUID | ID аренды – ОБЯЗАТЕЛЬНО (должен совпадать с назначенной картой) | 4b8a4286-4c79-475f-8932-4f3b29e7610e |
Электронная почта сотрудника – НЕОБЯЗАТЕЛЬНО при edit (можно изменить, если карта ещё не создана) | |||
phonePrefix | префикс | Код страны телефона – как выше | |
phoneNumber | номер телефона | Номер телефона сотрудника – как выше | |
totalAmount | числовое поле | Баланс счета (с точкой) – ОБЯЗАТЕЛЬНО | 300.99 |
totalAmountType* | текстовое поле | Тип счета – ОБЯЗАТЕЛЬНО: naive – добавляет средства, simple – изменяет баланс (по умолчанию) | naive |
limitGeneral | сумма:период | Общий лимит (daily, weekly, monthly) – НЕОБЯЗАТЕЛЬНО | 50:weekly |
limitEcommerce | сумма:период | Лимит интернет-платежей – НЕОБЯЗАТЕЛЬНО | 100:monthly |
limitAtm | сумма:период | Лимит снятия в банкомате (0:daily блокирует снятие) – НЕОБЯЗАТЕЛЬНО | 50:daily |
limitForeignTransaction | сумма:период | Лимит операций за границей – НЕОБЯЗАТЕЛЬНО | 50:daily |
startDate | дата | Дата начала (форматы: YYYY-MM-DD, YYYY.MM.DD, YYYY/MM/DD) – ОБЯЗАТЕЛЬНО (по умолчанию сегодня) | 2025-01-01 |
endDate | число:период / дата | Дата окончания (например 3:months или конкретная дата) – ОБЯЗАТЕЛЬНО | 3:months |
cardAliasId | UUID | ID счета – НЕОБЯЗАТЕЛЬНО при edit | |
visualId | UUID | ID графики карты – НЕОБЯЗАТЕЛЬНО (можно изменить) | 4b8a1286-4c79-475f-8932-4f3b29e7610e |
cardName | текстовое поле | Название карты – НЕОБЯЗАТЕЛЬНО (можно изменить) | Lunch card Adam Kowalski |
allowChangeRequests | да/нет | Возможность пользователю запрашивать увеличение лимита – НЕОБЯЗАТЕЛЬНО (по умолчанию yes) | yes |
labels | числовое поле | Коды меток (например 2235) – НЕОБЯЗАТЕЛЬНО, нельзя изменить позже | |
mccList* | числовое поле | MCC коды (разделенные ``` ) – НЕОБЯЗАТЕЛЬНО (можно изменить) | |
mccType | текстовое поле | blacklist – отклоняет MCC, whitelist – разрешает только выбранные MCC (по умолчанию) – НЕОБЯЗАТЕЛЬНО | whitelist |
spendCategoryId | UUID | Если spendCategoryId указано, поля mccType и mccList игнорируются. | 4b8a1286-4c79-475f-8932-4f3b29e7610e |
*Пример редактирования:
Простая карта -> изменяет баланс карты:
На вашей карте 8 000,00 PLN / 13 776,80 PLN
К простой карте вы добавляете 14 000 PLN (+6 000 PLN)
Теперь у вас 14 000 PLN / 19 776,80 PLN
«Naive» -> пополняет текущий баланс
На вашей карте 8 000,00 PLN / 13 776,80 PLN
Вы добавляете 14 000 PLN с типом «Naive»
Теперь у вас 22 000 PLN / 27 776,80 PLN
**Где найти ID счета и ID визуала?
Большинство полей вводятся легко, однако два столбца могут вызвать затруднения: ID счета и ID визуала.
ID счета:
СЧЕТА -> Выберите счет
Рядом с названием счета, в подробной информации о счете, есть кнопка для копирования ID счета.
ID изображения карты:
CADS -> ПРИСВОИТЬ КАРТУ
Прокрутите вниз. В разделе «Атрибуты карты» выберите изображение, которое хотите присвоить вашей новой карте. Появится кнопка для копирования ID изображения.
***Коды MCC
Правильно заполнив все поля, сохраните файл с расширением CSV (разделитель — запятая) (.csv) или CSV UTF-8 (разделитель — запятая) (.csv) и загрузите его в поле панели «перетащите файл или выберите». Вы должны увидеть сообщение о том, что обработка ваших карт начата
Где я могу увидеть статус присвоения моих карт?
Во вкладке ОТЧЕТЫ -> МАССОВОЕ ПРИСВОЕНИЕ КАРТ вы можете отслеживать статус присвоения карт и скачать отчет, когда они будут готовы. Также вы увидите дату, количество присвоенных карт и сколько из них было успешных или неудачных.
Скачав отчет, вы можете открыть его в таких программах, как «Excel» или «Numbers». В нем есть три дополнительных столбца:
Что содержится в отчёте?
Название поля | Описание | Пример |
status | В этом поле будет одно из двух значений (success, error), указывающее, была ли операция успешной | error |
statusCode | Код статуса (поможет идентифицировать ошибку) | 400 |
approvalId | Идентификационный номер присвоения | 1f058dff-44ed-6222-879e-2b9a199c3a1d |
Сравнение присвоения карт с использованием API и пакетного файла:
API
Преимущества:
✅ Возможность интеграции с вашими системами
✅ Полная автоматизация процесса управления картами
✅ Бесплатное использование API «Sparados» (документация API)
Недостатки:
❌Расходы на внедрение для клиента (примерно 20 000–40 000 PLN)
❌ Необходимо поддерживать сайт, подключенный к API
❌ Время внедрения: примерно 2–3 месяца
Пакетный файл
Преимущества:
✅ Возможность немедленного внедрения
✅ Отсутствие расходов на установку и обслуживание
Недостатки:
❌ Ручное создание файлов
❌ Ручная загрузка файлов на сайт
