Kaip priskirti kelias korteles vienu metu?

Turinys

1. Būdai priskirti korteles „Sparados“

2. Kaip priskirti kelias korteles vienu metu?

3. PRISKIRTIS – kelių kortelių priskyrimo vienu metu procesas.

4. REDAGUOTI – kelių kortelių redagavimo procesas vienu metu

5. Naivus, paprastas (totalAmountType)

6. Kur galiu rasti savo paskyros ID ir vaizdo ID?

7. MCC kodai

8. Kur galiu pamatyti savo kortelių priskyrimų būseną?

9. Ką ataskaita pateikia priskyrus korteles?

10. Kortelių priskyrimo palyginimas naudojant API ir paketinį failą

„Sparados“ programoje vizitines korteles galima priskirti trimis būdais:

1. Užpildant kortelės priskyrimo formą (spustelėjus mygtuką „PRISKIRTI KORTELĘ“)

2. Priskiriant kortelę naudojant „Sparados“ API (nuoroda į dokumentaciją)

3. 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	Lauko pavadinimas
operation	tekstinis laukas	Operacijos tipas PRIVALOMAS assign – kortelės priskyrimas edit – kortelės duomenų redagavimas	assign	operation
approvalId	UUID	Nuomos ID NEPRIVALOMAS prie assign		approvalId
email	el. paštas	Darbuotojo el. pašto adresas PRIVALOMAS	[email protected]	email
phonePrefix	prefiksas	Darbuotojo telefono šalies kodas PRIVALOMAS	48	phonePrefix
phoneNumber	telefono numeris	Darbuotojo telefono numeris PRIVALOMAS	123456789	phoneNumber
totalAmount	skaitinis laukas	Sąskaitos likutis (su centais – atskirti tašku) PRIVALOMAS	2000.99	totalAmount
totalAmountType	tekstinis laukas	Tik redagavimui		totalAmountType
limitGeneral	suma:periodas	Periodo limitas (daily, weekly, monthly) visoms operacijoms PASIRINKTINIS	50:weekly	limitGeneral
limitEcommerce	suma:periodas	Periodo limitas internetinėms operacijoms PASIRINKTINIS	100:monthly	limitEcommerce
limitAtm	suma:periodas	Bankomato išėmimų limitas PASIRINKTINIS (pvz. 0:daily norint užblokuoti išėmimus)	50:daily	limitAtm
limitForeignTransaction	suma:periodas	Užsienio operacijų limitas PASIRINKTINIS	50:daily	limitForeignTransaction
startDate	data	Sąskaitos pradžios data (formatas: YYYY-MM-DD, YYYY.MM.DD, YYYY/MM/DD) PRIVALOMA (numatytai šiandien)	2025-01-01	startDate
endDate	data	Kortelės galiojimo pabaigos data (formatas toks pat) PRIVALOMA	2027-01-01	endDate
cardAliasId	UUID	Sąskaitos ID – rasite skiltyje SĄSKAITOS > sąskaitos detalės PRIVALOMAS	1ee5c171-393c-6140-b3d6-b9784a774ec2	cardAliasId
visualId	UUID	Kortelės grafikos ID – skiltis KORTELĖS → PRISKIRTI KORTELĘ PASIRINKTINIS	4b8a1286-4c79-475f-8932-4f3b29e7610e	visualId
cardName	tekstinis laukas	Kortelės pavadinimas PASIRINKTINIS (numatytai tuščias)	Lunch card Adam Kowalski	cardName
allowChangeRequests	taip/ne	Ar darbuotojas gali prašyti padidinti limitą PASIRINKTINIS (numatytai yes)	yes	allowChangeRequests
labels	skaitinis laukas	Dviejų skaitmenų etikečių kodai (atskirti separatoriumi) PASIRINKTINIAI – vėliau negalima pakeisti	`22	labels
mccList	skaitinis laukas	MCC kodai (keturių skaitmenų, atskirti ```) – pirkimai tik tam tikrose kategorijose PASIRINKTINIS		mccList
mccType	tekstinis laukas	blacklist – MCC kodų atmetimas whitelist – tik nurodyti MCC kodai PASIRINKTINIS (numatytai whitelist)	whitelist	mccType

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
email	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

*Pavyzdinis redagavimas:

Paprasta kortelė -> pakeičia kortelės likut:

1. Jūsų kortelėje yra 8 000,00 PLN / 13 776,80 PLN

2. Prie „Paprastos“ kortelės pridedate 14 000 PLN (+6 000 PLN)

3. Dabar turite 14 000 PLN / 19 776,80 PLN

„Naive“ -> papildo dabartinį likutį

1. Jūsų kortelėje yra 8 000,00 PLN / 13 776,80 PLN

2. Pridedate 14 000 PLN „Naive“

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

quick-reference-booklet-merchant.pdf

Atsisiųsti PDF • 1.15MB

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ę