top of page

Как назначить несколько карт одновременно?

Содержание

  1. Способы назначения карт в «Sparados»

  2. Как назначить несколько карт одновременно?

  3. ПРИСВОЕНИЕ — процесс назначения нескольких карт одновременно.

  4. РЕДАКТИРОВАНИЕ — процесс одновременного редактирования нескольких карт.

  5. Наивный, простой (totalAmountType)

  6. Где я могу найти свой ID аккаунта и ID изображения?

  7. Коды MCC

  8. Где я могу увидеть статус привязки своих карт?

  9. Что показывает отчет после привязки карт?

  10. Сравнение привязки карт с использованием API и пакетного файла


В приложении «Sparados» визитные карточки можно назначить тремя способами:

  1. Заполнение формы назначения карты (нажав кнопку «ПРИСВОИТЬ КАРТУ»)

  2. Назначение карты с помощью API «Sparados» (ссылка на документацию)

  3. Использование пакетного файла для одновременного назначения нескольких карт


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

В этом учебном материале вы узнаете, как это сделать:


Как назначить несколько карт одновременно?

Перейдите во вкладку КАРТЫ


Przyciski funkcyjne - przypisz wiele

Нажав кнопку «ПРИСВОИТЬ НЕСКОЛЬКО», вы перейдете на страницу присвоения нескольких карт. Здесь необходимо загрузить действительный .csv файл, содержащий всю информацию, необходимую для генерации карт. Вы можете использовать файл «example.csv», расположенный над основным полем, в качестве примера (данные в файле предоставлены только для информационных целей и должны быть изменены).


Miejsce na plik csv

Для всех лимитов группы будут применяться те же правила, что и при присвоении одной карты. Любой лимит, присвоенный с превышением группового лимита, потребует подтверждения у группы, находящейся выше вашей.


Если информация в файле имеет неверный формат, система отобразит сообщение о неправильной строке или ячейке:

Błędny plik csv

ASSIGN

Процесс одновременного присвоения нескольких карт

Что должно быть в правильном CSV-файле при присвоении карт?

Название поля

Формат

Описание

Пример

Название поля

operation

текстовое поле

Тип операции ОБЯЗАТЕЛЬНО assign – присвоение карты edit – редактирование данных карты

assign

operation

approvalId

UUID

ID утверждения НЕОБЯЗАТЕЛЬНО для assign

approvalId

approvalId

email

email

Электронная почта сотрудника ОБЯЗАТЕЛЬНО

email

phonePrefix

префикс

Код страны телефона сотрудника ОБЯЗАТЕЛЬНО

48

phonePrefix

phoneNumber

номер телефона

Номер телефона сотрудника ОБЯЗАТЕЛЬНО

123456789

phoneNumber

totalAmount

числовое поле

Баланс счета (с копейками – через точку) ОБЯЗАТЕЛЬНО

2000.99

totalAmount

totalAmountType

текстовое поле

Только для редактирования

totalAmountType

totalAmountType

limitGeneral

сумма:период

Лимит за период (daily, weekly, monthly) для всех операций НЕОБЯЗАТЕЛЬНО

50:weekly

limitGeneral

limitEcommerce

сумма:период

Лимит за период для интернет-операций НЕОБЯЗАТЕЛЬНО

100:monthly

limitEcommerce

limitAtm

сумма:период

Лимит снятия в банкоматах НЕОБЯЗАТЕЛЬНО (например, 0:daily чтобы заблокировать снятие)

50:daily

limitAtm

limitForeignTransaction

сумма:период

Лимит операций за границей НЕОБЯЗАТЕЛЬНО

50:daily

limitForeignTransaction

startDate

дата

Дата начала действия счета (формат: YYYY-MM-DD, YYYY.MM.DD, YYYY/MM/DD) ОБЯЗАТЕЛЬНО (по умолчанию сегодня)

2025-01-01

startDate

endDate

дата

Дата окончания действия карты (тот же формат) ОБЯЗАТЕЛЬНО

2027-01-01

endDate

cardAliasId

UUID

ID счета – находится в разделе СЧЕТА > детали счета ОБЯЗАТЕЛЬНО

1ee5c171-393c-6140-b3d6-b9784a774ec2

cardAliasId

visualId

UUID

ID графики карты – раздел КАРТЫ → ПРИСВОИТЬ КАРТУ НЕОБЯЗАТЕЛЬНО

4b8a1286-4c79-475f-8932-4f3b29e7610e

visualId

cardName

текстовое поле

Название карты НЕОБЯЗАТЕЛЬНО (по умолчанию пусто)

Lunch card Adam Kowalski

cardName

allowChangeRequests

да/нет

Может ли сотрудник запрашивать увеличение лимита НЕОБЯЗАТЕЛЬНО (по умолчанию yes)

yes

allowChangeRequests

labels

числовое поле

Двузначные коды меток (через разделитель) НЕОБЯЗАТЕЛЬНО – изменить потом нельзя

`22

labels

mccList

числовое поле

MCC коды (четырёхзначные, через ```) – покупки только в указанных категориях НЕОБЯЗАТЕЛЬНО


mccList

mccType

текстовое поле

blacklist – отклонять MCC коды whitelist – только указанные MCC коды НЕОБЯЗАТЕЛЬНО (по умолчанию whitelist)

whitelist

mccType

EDIT

Процесс одновременного редактирования нескольких карт

Что должно быть в корректном CSV-файле при редактировании карт?


💡Совет: чтобы завершить редактирование лимитов карт в файле, вы можете использовать последнюю отчетность по импорту карт. В ней будет заполнен столбец «approvedID», который идентифицирует карту. Вам нужно лишь удалить два столбца — «status» и «statusCode» — и ввести новые лимиты карт.

Название поля

Формат

Описание

Пример

operation

текстовое поле

Тип операции ОБЯЗАТЕЛЬНО: assign – когда карта должна быть назначена, edit – когда данные карты должны быть обновлены

edit

approvalId

UUID

ID аренды – ОБЯЗАТЕЛЬНО (должен совпадать с назначенной картой)

4b8a4286-4c79-475f-8932-4f3b29e7610e

email

email

Электронная почта сотрудника – НЕОБЯЗАТЕЛЬНО при 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

*Пример редактирования:

Простая карта -> изменяет баланс карты:

На вашей карте 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 счета.


Detale konta

ID изображения карты:

CADS -> ПРИСВОИТЬ КАРТУ


Прокрутите вниз. В разделе «Атрибуты карты» выберите изображение, которое хотите присвоить вашей новой карте. Появится кнопка для копирования ID изображения.


Wzór karty

***Коды MCC


Правильно заполнив все поля, сохраните файл с расширением CSV (разделитель — запятая) (.csv) или CSV UTF-8 (разделитель — запятая) (.csv) и загрузите его в поле панели «перетащите файл или выберите». Вы должны увидеть сообщение о том, что обработка ваших карт начата


Rozpoczęto przetwarzanie powiadomienie


Где я могу увидеть статус присвоения моих карт?

Во вкладке ОТЧЕТЫ -> МАССОВОЕ ПРИСВОЕНИЕ КАРТ вы можете отслеживать статус присвоения карт и скачать отчет, когда они будут готовы. Также вы увидите дату, количество присвоенных карт и сколько из них было успешных или неудачных.


Twoje raporty

Скачав отчет, вы можете открыть его в таких программах, как «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 месяца


Пакетный файл

Преимущества:


✅ Возможность немедленного внедрения

✅ Отсутствие расходов на установку и обслуживание


Недостатки:


❌ Ручное создание файлов

❌ Ручная загрузка файлов на сайт

 
 

Узнайте, как мы можем помочь вашей компании.

SPARADOS – Оптимальное решение

bottom of page