Kaip priskirti kelias korteles vienu metu?
- Igor Klimkowicz
- 08-18
- 5 min. skaitymo
Atnaujinta: 12-09
„Sparados“ programoje vizitines korteles galima priskirti trimis būdais:
Užpildant kortelės priskyrimo formą (spustelėjus mygtuką „PRISKIRTI KORTELĘ“)
Priskiriant kortelę naudojant „Sparados“ API (nuoroda į dokumentaciją)
Naudojant paketinį failą, norint vienu metu priskirti kelias korteles
Kortelių priskyrimas iš paketinio failo veikia panašiai kaip pildant formą 1 parinktyje, tačiau tai leidžia vienu metu priskirti kelias korteles.
Šioje mokomojoje medžiagoje sužinosite, kaip tai padaryti:
Kaip priskirti kelias korteles vienu metu?
Eikite į skirtuką KORTELĖS
Paspaudus mygtuką „PRISKIRTI KELIS“, būsite nukreipti į kelių kortelių priskyrimo puslapį. Čia turėsite pridėti galiojantį .csv failą, kuriame yra visa informacija, reikalinga kortelėms sugeneruoti. Galite naudoti failą „example.csv“, esantį virš pagrindinio lauko, kaip nuorodą (faile pateikti duomenys skirti tik informaciniams tikslams ir turėtų būti pakeisti).
Visiems grupės limitams bus taikomos tos pačios taisyklės, kaip ir priskiriant tik vieną kortelę. Bet kokiam limitui, priskirtam viršijus grupės limitą, reikės patvirtinti virš jūsų esančią grupę.
Jei faile esanti informacija yra neteisingo formato, sistema parodys pranešimą apie konkrečios eilutės ar langelio neteisingumą:
ASSIGN
Kelių kortelių priskyrimo vienu metu procesas
Kas turėtų būti tinkamame CSV faile, priskiriant korteles?
Lauko pavadinimas | Formatas | Aprašymas | Pavyzdys |
operation | tekstinis laukas | Operacijos tipas PRIVALOMAS assign – kortelės priskyrimas edit – kortelės duomenų redagavimas | assign |
approvalId | UUID | Nuomos ID NEPRIVALOMAS prie assign | |
el. paštas | Darbuotojo el. pašto adresas PRIVALOMAS | ||
phonePrefix | prefiksas | Darbuotojo telefono šalies kodas PRIVALOMAS | 48 |
phoneNumber | telefono numeris | Darbuotojo telefono numeris PRIVALOMAS | 123456789 |
totalAmount | skaitinis laukas | Sąskaitos likutis (su centais – atskirti tašku) PRIVALOMAS | 2000.99 |
totalAmountType | tekstinis laukas | Tik redagavimui | |
limitGeneral | suma:periodas | Periodo limitas (daily, weekly, monthly) visoms operacijoms PASIRINKTINIS | 50:weekly |
limitEcommerce | suma:periodas | Periodo limitas internetinėms operacijoms PASIRINKTINIS | 100:monthly |
limitAtm | suma:periodas | Bankomato išėmimų limitas PASIRINKTINIS (pvz. 0:daily norint užblokuoti išėmimus) | 50:daily |
limitForeignTransaction | suma:periodas | Užsienio operacijų limitas PASIRINKTINIS | 50:daily |
startDate | data | Sąskaitos pradžios data (formatas: YYYY-MM-DD, YYYY.MM.DD, YYYY/MM/DD) PRIVALOMA (numatytai šiandien) | 2025-01-01 |
endDate | data | Kortelės galiojimo pabaigos data (formatas toks pat) PRIVALOMA | 2027-01-01 |
cardAliasId | UUID | Sąskaitos ID – rasite skiltyje SĄSKAITOS > sąskaitos detalės PRIVALOMAS | 1ee5c171-393c-6140-b3d6-b9784a774ec2 |
visualId | UUID | Kortelės grafikos ID – skiltis KORTELĖS → PRISKIRTI KORTELĘ PASIRINKTINIS | 4b8a1286-4c79-475f-8932-4f3b29e7610e |
cardName | tekstinis laukas | Kortelės pavadinimas PASIRINKTINIS (numatytai tuščias) | Lunch card Adam Kowalski |
allowChangeRequests | taip/ne | Ar darbuotojas gali prašyti padidinti limitą PASIRINKTINIS (numatytai yes) | yes |
labels | skaitinis laukas | Dviejų skaitmenų etikečių kodai (atskirti separatoriumi) PASIRINKTINIAI – vėliau negalima pakeisti | `22 |
mccList | skaitinis laukas | MCC kodai (keturių skaitmenų, atskirti ```) – pirkimai tik tam tikrose kategorijose PASIRINKTINIS | |
mccType | tekstinis laukas | blacklist – MCC kodų atmetimas whitelist – tik nurodyti MCC kodai PASIRINKTINIS (numatytai whitelist) | whitelist |
spendCategoryId | UUID | Jei spendCategoryId yra nurodytas, mccType ir mccList yra ignoruojami. | 4b8a1286-4c79-475f-8932-4f3b29e7610e |
EDIT
kelių kortelių redagavimo procesas vienu metu
Kas turėtų būti tinkamame CSV faile redaguojant korteles?
💡Patarimas: norėdami užbaigti kortelių limitų redagavimo failą, galite naudoti naujausią kortelių importavimo ataskaitą. Jame bus užpildytas stulpelis „approvedID“, kuris identifikuoja kortelę. Jums tereikia pašalinti du stulpelius – „status“ ir „statusCode“ – ir įvesti naujus kortelių limitus.
Lauko pavadinimas | Formatas | Aprašymas | Pavyzdys |
operation | tekstinis laukas | Operacijos tipas PRIVALOMAS: assign – kai kortelė turi būti priskirta edit – kai kortelės duomenys turi būti atnaujinti | edit |
approvalId | UUID | Nuomos ID – PRIVALOMAS (turi sutapti su priskirtu kortelei) | 4b8a4286-4c79-475f-8932-4f3b29e7610e |
el. paštas | Darbuotojo el. pašto adresas – PRIE EDIT NEPRIVALOMAS (galima keisti, jei kortelė dar nesugeneruota) | ||
phonePrefix | prefiksas | Telefono šalies kodas – kaip aukščiau | |
phoneNumber | telefono numeris | Darbuotojo telefono numeris – kaip aukščiau | |
totalAmount | skaitinis laukas | Sąskaitos likutis (atskirtas tašku) – PRIVALOMAS | 300.99 |
totalAmountType* | tekstinis laukas | Sąskaitos tipas – PRIVALOMAS: naive – prideda lėšų simple – keičia balansą (numatytai) | naive |
limitGeneral | suma:periodas | Bendras limitas (daily, weekly, monthly) – PASIRINKTINIS | 50:weekly |
limitEcommerce | suma:periodas | Internetinių mokėjimų limitas – PASIRINKTINIS | 100:monthly |
limitAtm | suma:periodas | Bankomato limitas (jei 0:daily, blokuoja išėmimus) – PASIRINKTINIS | 50:daily |
limitForeignTransaction | suma:periodas | Užsienio operacijų limitas – PASIRINKTINIS | 50:daily |
startDate | data | Pradžios data (formatas: YYYY-MM-DD, YYYY.MM.DD, YYYY/MM/DD) – PRIVALOMA (numatytai šiandien) | 2025-01-01 |
endDate | skaičius:periodas / data | Galiojimo pabaiga (pvz. 3:months arba konkreti data) – PRIVALOMA | 3:months |
cardAliasId | UUID | Sąskaitos ID – NEPRIVALOMAS PRIE EDIT | |
visualId | UUID | Kortelės grafikos ID – PASIRINKTINIS (galima pakeisti) | 4b8a1286-4c79-475f-8932-4f3b29e7610e |
cardName | tekstinis laukas | Kortelės pavadinimas – PASIRINKTINIS (galima pakeisti) | Lunch card Adam Kowalski |
allowChangeRequests | taip/ne | Galimybė vartotojui prašyti padidinti limitą – PASIRINKTINIS (numatytai yes) | yes |
labels | skaitinis laukas | Etikečių kodai (pvz. 2235) – PASIRINKTINIAI, negalima keisti vėliau | |
mccList* | skaitinis laukas | MCC kodai (atskirti ```) – PASIRINKTINIS (galima keisti) | |
mccType | tekstinis laukas | blacklist – atmeta MCC whitelist – leidžia tik pasirinktus MCC (numatytai) – PASIRINKTINIS | whitelist |
spendCategoryId | UUID | Jei spendCategoryId yra nurodytas, mccType ir mccList yra ignoruojami. | 4b8a4286-4c79-475f-8932-4f3b29e7610e |
*Pavyzdinis redagavimas:
Paprasta kortelė -> pakeičia kortelės likut:
Jūsų kortelėje yra 8 000,00 PLN / 13 776,80 PLN
Prie „Paprastos“ kortelės pridedate 14 000 PLN (+6 000 PLN)
Dabar turite 14 000 PLN / 19 776,80 PLN
„Naive“ -> papildo dabartinį likutį
Jūsų kortelėje yra 8 000,00 PLN / 13 776,80 PLN
Pridedate 14 000 PLN „Naive“
Dabar turite 22 000 PLN / 27 776,80 PLN
**Kur rasti sąskaitos ID ir vaizdo ID?**
Dauguma laukų turėtų būti lengvai įvedami, tačiau du stulpelius gali būti sunkiau atpažinti: sąskaitos ID ir vaizdo ID
Paskyros ID:
PASKYROS -> Pasirinkite paskyrą
Šalia paskyros pavadinimo, paskyros išsamioje informacijoje, yra mygtukas, skirtas nukopijuoti paskyros ID.
Kortelės vaizdo ID:
CADS -> PRISKIRTI KORTELĘ
Slinkite žemyn. Skiltyje „Kortelės atributai“ pasirinkite vaizdą, kurį norite priskirti savo naujajai kortelei. Atsiras mygtukas vaizdo ID kopijavimui.
***MCC kodai
Teisingai užpildę visus laukus, išsaugokite failą su CSV (kableliais atskirtų skaičių) (*.csv) arba CSV UTF-8 (kableliais atskirtų skaičių) (*.csv) plėtiniu ir įterpkite jį į skydelio laukelį „įmesti failą arba naršyti“. Turėtumėte pamatyti pranešimą, kad jūsų kortelių apdorojimas pradėtas.
Kur galiu pamatyti savo kortelių priskyrimų būseną?
Skirtuke ATASKAITOS -> DIDMENINIS KORTELIŲ PRISKYRIMAS galite stebėti kortelių priskyrimų būseną ir atsisiųsti ataskaitą, kai jie bus paruošti. Taip pat matysite datą, priskirtų kortelių skaičių ir kiek jų buvo sėkmingų arba nesėkmingų.
Atsisiuntę ataskaitą, galite ją atidaryti tokiose programose kaip „Excel“ arba „Numbers“. Joje yra trys papildomi stulpeliai:
Kas yra ataskaitoje?
Lauko pavadinimas | Aprašymas | Pavyzdys |
status | Šiame lauke bus viena iš dviejų reikšmių (success, error), nurodanti ar operacija pavyko | error |
statusCode | Statuso kodas (padės identifikuoti klaidą) | 400 |
approvalId | Priskyrimo identifikacinis numeris | 1f058dff-44ed-6222-879e-2b9a199c3a1d |
Kortelių priskyrimo palyginimas naudojant API ir paketinį failą:
API
Privalumai:
✅ Galimybė integruoti su savo sistemomis
✅ Visiškas kortelių valdymo proceso automatizavimas
✅ Nemokamas „Sparados“ API naudojimas (API dokumentacija)
Trūkumai:
❌ Įdiegimo išlaidos klientui (apytiksliai 20 000–40 000 PLN)
❌ Reikalinga palaikyti prie API prijungtą svetainę
❌ Įdiegimo laikas: apytiksliai 2–3 mėnesiai
Paketinis failas
Privalumai:
✅ Galimybė nedelsiant įdiegti
✅ Jokių įdiegimo ar priežiūros išlaidų
Trūkumai:
❌ Rankinis failų kūrimas
❌ Rankinis failų įkėlimas į svetainę
