top of page

Jak przypisać wiele kart naraz?

Zaktualizowano: 29 lip


Istnieją trzy sposoby przypisania kart służbowych w serwisie Sparados:

  1. Wypełnienie formularza do przypisania karty (po kliknięciu przycisku PRZYPISZ KARTĘ)

  2. Przypisanie karty za pomocą Sparados API (link do dokumentacji)

  3. 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


Przyciski funkcyjne - przypisz wiele

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ć)


Miejsce na plik csv

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:

Błędny plik csv

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


email

email

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

email

email

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


  1. Masz na karcie 8,000.00 PLN / 13,776.80 PLN

  2. Dodajesz 14 000 PLN Simple (+6000 PLN)

  3. Teraz masz 14 000/19 776.80


Naive -> dodaje środki do aktualnego salda


  1. Masz na karcie 8,000.00 PLN / 13,776.80 PLN

  2. Dodajesz 14 000 PLN Naive

  3. 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


Detale konta

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


Wzór karty

***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.


Rozpoczęto przetwarzanie powiadomienie


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.


Twoje raporty

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:

Dowiedz się, jak możemy pomóc Twojej firmie.

SPARADOS - OPTYMALNE ROZWIĄZANIE

bottom of page