Jak przypisać wiele kart naraz?
- Igor Klimkowicz
- 31 sty
- 5 minut(y) czytania
Zaktualizowano: 29 lip
Spis treści
Istnieją trzy sposoby przypisania kart służbowych w serwisie Sparados:
Wypełnienie formularza do przypisania karty (po kliknięciu przycisku PRZYPISZ KARTĘ)
Przypisanie karty za pomocą Sparados API (link do dokumentacji)
Wykorzystanie pliku wsadowego do przypisywania wielu kart na raz
Przypisywanie kart z pliku wsadowego działa podobnie jak wypełnianie formularza z opcji 1. ale pozwoli Ci na przypisywanie wielu kart jednocześnie
W tym tutorialu dowiesz się jak to zrobić:
Jak przypisać wiele kart na raz?
Wejdź w zakładkę KARTY
Po kliknięciu przycisku PRZYPISZ WIELE Zostaniesz przeniesiony na stronę przypisywania wielu kart. W tym miejscu potrzebujesz załączyć poprawny plik .csv, który będzie zawierał wszystkie informacje potrzebne by wygenerować karty. Możesz wzorować się na przykładowym pliku "example.csv" zamieszczonym nad polem głównym (Dane umieszczone w pliku są przykładowe i należy je zmienić)
Wszystkie limity grupowe będą podlegać tym samym zasadom, jak podczas przypisywania tylko jednej karty. Limit nadany, po przekroczeniu limitu twojej grupy będzie musiał uzyskać zgodę od grupy wyżej.
W przypadku, gdy informacje w pliku są w niepoprawnym formacie system wyświetli komunikat o nieprawidłowości konkretnego wiersza lub komórki:
ASSIGN
Proces przypisania wielu kart na raz
Co powinien zawierać prawidłowy plik csv podczas przypisywania kart?
Nazwa pola | Format | Opis | Przykład |
operation | pole tekstowe | Typ operacji WYMAGANY | assign - gdy karta ma być przypisana edit - gdy dane na karcie mają zostać zaktualizowane |
approvalId | UUID | ID wypożyczenia PRZY OPERACJI ASSIGN NIE JEST WYMAGANY | |
Adres email pracownika WYMAGANY | |||
phonePrefix | prefix | Numer kierunkowy telefonu pracownika WYMAGANY | 48 |
phoneNumber | numer telefonu | Numer telefonu pracownika WYMAGANY | 123456789 |
totalAmount | pole liczbowe | Saldo rachunku (Przy sumach z groszami oddzielić kropką) WYMAGANE | 2000.99 |
totalAmountType | pole tekstowe | TYLKO DLA EDYCJI | |
limitGeneral | kwota:okres | Okresowy limit dla wszystkich rodzajów transakcji wraz z okresem (daily, weekly, monthly) OPCJONALNY (Domyślnie bez limitu) | 50:weekly |
limitEcommerce | kwota:okres | Okresowy limit dla internetowych płatności OPCJONALNY (Domyślnie bez limitu) | 100:monthly |
limitAtm | kwota:okres | Okresowy limit wypłat z bankomatu (Jeżeli chcesz uniemożliwić wypłatę z bankomatu wpisz 0:daily) OPCJONALNY (Domyślnie bez limitu) | 50:daily |
limitForeignTransaction | kwota:okres | Okresowy limit transakcji zagranicznych OPCJONALNY (Domyślnie bez limitu) | 50:daily |
startDate | Data | Data rozpoczęcia rachunku w formacie YYYY-MM-DD lub YYYY.MM.DD lub YYYY/MM/DD WYMAGANA (Domyślnie data dzisiejsza) | 2025-01-01 |
endDate | Data | Data odpisania karty w formacie YYYY-MM-DD lub YYYY.MM.DD lub YYYY/MM/DD WYMAGANA | 2027-01-01 |
cardAliasId | UUID | ID rachunku (znajdziesz go w detalach rachunku w zakładce KONTA) WYMAGANY | 1ee5c171-393c-6140-b3d6-b9784a774ec2 |
visualId | UUID | ID grafiki karty (znajdziesz go na wzorze karty w zakładce KARTY -> PRZYPISZ KARTĘ) OPCJONALNY | 4b8a1286-4c79-475f-8932-4f3b29e7610e |
cardName | pole tekstowe | Nazwa karty OPCJONALNA (Domyślnie pusty) | Lunch card Adam Kowalski |
allowChangeRequests | yes/no | Możliwość prośby o zwiększenie limitu z poziomu posiadacza karty OPCJONALNA (Domyślnie yes) | yes |
labels | pole liczbowe | dwucyfrowe kody etykiety oddzielone separatorem OPCJONALNE - BRAK MOŻLIWOŚCI ZMIANY | 22 | 35 |
mccList | pole liczbowe | Czterocyfrowe kody kategorii merchanta oddzielone separatorem "|" umożliwiające zakupy tylko w konkretnej kategorii OPCJONALNE | 5819|1911 |
mccType | pole tekstowe | blacklist (wyklucza podane kody MCC) whitelist (ograniczna płatności tylko do danych kodów MCC) OPCJONALNE (Domyślnie whitelist) | whitelist |
EDIT
proces edycji wielu kart na raz
Co powinien zawierać prawidłowy plik csv podczas edytowania kart?
💡Wskazówka: Możesz wykorzystać najnowszy raport z importu kart do uzupełnienia pliku do edycji limitów kartowych, znajdziesz w nim uzupełnioną kolumnę approvalid, która identyfikuje daną kartę. Należy jedynie usunąć dwie kolumny - status i statusCode - oraz wprowadzić nowe limity kartowe.
Nazwa | Format | Opis | Przykład |
operation | pole tekstowe | Typ operacji WYMAGANY | assign - gdy karta ma być przypisana edit - gdy dane na karcie mają zostać zaktualizowane |
approvalId | UUID | ID wypożyczenia WYMAGANY -ZGODNY Z PRZYPISANYM DO KARTY | 4b8a4286-4c79-475f-8932-4f3b29e7610e |
Adres email pracownika PRZY OPERACJI EDIT NIE JEST WYMAGANY - MOŻLIWOŚĆ ZMIANY GDY KARTA NIE JEST WYGENEROWANA | |||
phonePrefix | prefix | Numer kierunkowy telefonu pracownika PRZY OPERACJI EDIT NIE JEST WYMAGANY - MOŻLIWOŚĆ ZMIANY GDY KARTA NIE JEST WYGENEROWANA | |
phoneNumber | numer telefonu | Numer telefonu pracownika PRZY OPERACJI EDIT NIE JEST WYMAGANY - MOŻLIWOŚĆ ZMIANY GDY KARTA NIE JEST WYGENEROWANA | |
totalAmount | pole liczbowe | Saldo rachunku (Przy sumach z groszami oddzielić kropką) WYMAGANE | 300.99 |
totalAmountType* | pole tekstowe | Typ rachunku naive - dodaje środki do salda simple - zmienia aktualne saldo na nowe WYMAGANE (Domyślnie Simple) | naive |
limitGeneral | kwota:okres | Okresowy limit dla wszystkich rodzajów transakcji wraz z okresem (daily, weekly, monthly) OPCJONALNY (Domyślnie bez limitu) - MOŻLIWOŚĆ ZMIANY | 50:weekly |
limitEcommerce | kwota:okres | Okresowy limit dla internetowych płatności OPCJONALNY (Domyślnie bez limitu) - MOŻLIWOŚĆ ZMIANY | 100:monthly |
limitAtm | kwota:okres | Okresowy limit wypłat z bankomatu (Jeżeli chcesz uniemożliwić wypłatę z bankomatu wpisz 0:daily) OPCJONALNY (Domyślnie bez limitu) - MOŻLIWOŚĆ ZMIANY | 50:daily |
limitForeignTransaction | kwota:okres | Okresowy limit transakcji zagranicznych OPCJONALNY (Domyślnie bez limitu) - MOŻLIWOŚĆ ZMIANY | 50:daily |
startDate | Data | Data rozpoczęcia rachunku w formacie YYYY-MM-DD lub YYYY.MM.DD lub YYYY/MM/DD WYMAGANA (Domyślnie aktualna data) | 2025-01-01 |
endDate | liczba:okres | Data wygasania rachunku w formacie liczba:okres lub YYYY-MM-DD lub YYYY.MM.DD lub YYYY/MM/DD WYMAGANA | 3:months |
cardAliasId** | UUID | ID rachunku PRZY OPERACJI EDIT NIE JEST WYMAGANY | |
visualId** | UUID | ID grafiki karty (znajdziesz go na wzorze karty w zakładce KARTY -> PRZYPISZ KARTĘ) OPCJONALNY - MOŻLIWOŚĆ ZMIANY | 4b8a1286-4c79-475f-8932-4f3b29e7610e |
cardName | pole tekstowe | Nazwa karty OPCJONALNA - MOŻLIWOŚĆ ZMIANY | Lunch card Adam Kowalski |
allowChangeRequests | yes/no | Możliwość prośby o zwiększenie limitu OPCJONALNA (Domyślnie yes) - MOŻLIWOŚĆ ZMIANY | yes |
labels | pole liczbowe | Czterocyfrowy kod etykiety oddzielony separatorem "|" OPCJONALNY - BRAK MOŻLIWOŚCI ZMIANY | 22 | 35 |
mccList*** | pole liczbowe | Czterocyfrowy kod kategorii merchanta umożliwiający zakupy tylko w konkretnej kategorii OPCJONALNY - MOŻLIWOŚĆ ZMIANY | 5819|1911 |
mccType | pole tekstowe | blacklist (wyklucza podane kody MCC)whitelist (ograniczna płatności tylko do danych kodów MCC) OPCJONALNE (Domyślnie whitelist) | whitelist |
*Przykład edycji:
Simple -> zmienia saldo karty
Masz na karcie 8,000.00 PLN / 13,776.80 PLN
Dodajesz 14 000 PLN Simple (+6000 PLN)
Teraz masz 14 000/19 776.80
Naive -> dodaje środki do aktualnego salda
Masz na karcie 8,000.00 PLN / 13,776.80 PLN
Dodajesz 14 000 PLN Naive
Teraz masz 22 000 PLN/ 27,776.80 PLN
**Gdzie znaleźć ID rachunku i ID grafiki?
Większość pól nie powinna stanowić trudności, jednak dwie kolumny mogą okazać się trudniejsze do zidentyfikowania. Są to ID rachunku oraz ID grafiki
ID rachunku:
KONTA -> Wybierz konto
Przy nazwie twojego konta, w detalach konta, znajduje się przycisk do kopiowania ID rachunku
ID grafiki karty:
KARTY -> PRZYPISZ KARTĘ
Zjedź na dół. W sekcji Atrybuty karty wybierz grafikę, którą chcesz nadać swojej nowej karcie. Pojawi się na niej przycisk do kopiowania ID grafiki
***Kody MCC
Jeżeli wypełniłeś wszystkie pola w poprawnym formacie zapisz swój plik z rozszerzeniem CSV (rozdzielany przecinkami) (*.csv) lub CSV UTF-8 (rozdzielany przecinkami) (*.csv) wstaw go w pole z chmurką "upuść plik lub przeglądaj" na panelu. Powinieneś zobaczyć komunikat o rozpoczęciu przetwarzania twoich kart.
Gdzie zobaczyć status przypisywania kart?
W zakładce RAPORTY -> ZBIORCZE PRZYPISANIE KART możesz śledzić status przypisywania kart oraz pobrać ich raport, kiedy będzie gotowy. Zobaczysz tam również datę, informacje o liczbie przypisanych kart oraz ile z nich się powiodło, a ile się nie udało.
Po pobraniu raportu, możesz go otworzyć w programach typu Excel, czy Numbers. Posiada on trzy dodatkowe kolumny:
Co zawiera raport?
Nazwa pola | Opis | Przykład |
status | W tym polu pojawi się jeden z dwóch komunikatów (success, error), świadczący o pomyślności przebiegu operacji | error |
statusCode | Kod statusu (pozwoli ci zidentyfikować błąd) | 400 |
approvalid | numer identyfikacyjny przypisania | 1f058dff-44ed-6222-879e-2b9a199c3a1d |
Porównanie przypisywania kart za pomocą API oraz pliku batch:
API
Zalety:
✅ Możliwość integracji z własnymi systemami
✅ Pełna automatyzacja procesu zarządzania kartami
✅ Darmowe korzystanie z API Sparados (dokumentacja API)
Wady:
❌ Koszt wdrożenia po stronie klienta (około 20 - 40 tys. zł)
❌ Konieczność utrzymania serwisu połączonego z API
❌ Czas wdrożenia: około 2 - 3 miesiące
Plik Batch
Zalety:
✅ Możliwość natychmiastowego wdrożenia
✅ Brak kosztów wdrożeniowych i utrzymaniowych
Wady:
❌ Manualna praca przy tworzeniu pliku
❌ Ręczne wrzucanie pliku na serwis
Jeżeli chciałbyś się dowiedzieć więcej o kodach MCC lub przypisywaniu pojedynczych kart zapoznaj się z poradnikami:
