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ć:
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:
Plik powinien zawierać:
Nazwa pola | Format | Opis | Przykład |
operation | pole tekstowe | Typ operacji WYMAGANY | assign - gdy karta ma być przypisana |
approvalId | UUID | ID wypożyczenia Przy operacji assign nie jest wymagany | 4b8a4286-4c79-475f-8932-4f3b29e7610e |
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 |
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 | 2025-01-01 |
endDate | Data | Data wygasania rachunku 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 OPCJONALNA (Domyślnie yes) | yes |
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
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.
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:
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 |
message | Numer identyfikacyjny rachunku w przypadku success lub opis błędu w przypadku error | Item not found for "/management/card_aliases/027512d8-faaf-42f2-88e6-80fb7c53dcf". |
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
