Hromadné poverenia

Hromadné poverenia vám umožňujú vydať odznaky stovkám alebo tisícom príjemcov naraz nahraním CSV súboru. Proces má štyri kroky so vstavaným sledovaním priebehu, pozastavením/pokračovaním a riešením chýb.

Prehľad

Proces hromadných poverení sleduje štyri kroky:

1. Konfigurácia — vyberte odznak a možnosti
2. Nahranie — pripravte a nahrajte svoj CSV súbor
3. Spracovanie — sledujte priebeh, ako sa poverenia vytvárajú
4. Výsledky — preskúmajte výsledky a stiahnite správy

Krok 1: Konfigurácia

1. Otvorte v bočnom paneli stránku Bulk Credentials (má vlastnú trasu, oddelenú od stránky Credentials).
2. Pomocou výberu odznakov zvoľte odznak, ktorý chcete vydať.
3. Voliteľne nastavte:
   • Issued On — dátum použitý pre všetky poverenia (predvolene dnešný)
   • Expires — voliteľný dátum platnosti pre všetky poverenia
   • Send Email — či sa každému príjemcovi po vytvorení jeho poverenia automaticky odošle e-mail
4. Kliknite na Next.

Krok 2: Nahranie CSV

Formát CSV

CSV súbor musí obsahovať stĺpec name a stĺpec email s riadkom hlavičky. Názvy hlavičiek nerozlišujú veľké a malé písmená a recipient_name / recipient_email sa akceptujú ako aliasy pre name / email.

name,email
Jane Smith,jane@example.com
John Doe,john@example.com
Maria Garcia,maria@example.com

Stiahnutie šablóny

Kliknutím na Download Template získate prázdny CSV súbor so správnymi hlavičkami. Vyplňte ho svojimi príjemcami a nahrajte.

Nahranie

1. Kliknite na Upload CSV alebo súbor presuňte myšou.
2. Pred začatím spracovania sa súbor overí.

Pravidlá validácie

Každý riadok sa overí hneď po spracovaní súboru:

• Meno musí mať aspoň 5 znakov
• E-mail musí byť platná e-mailová adresa
• Prázdne riadky sa preskočia

Tabuľka náhľadu uvádza každý riadok so zelenou fajkou alebo červeným dôvodom. Neplatné riadky nie sú prekážkou — jednoducho sa preskočia a počítadlo ukazuje, koľko platných príjemcov sa spracuje (napr. „18 platných príjemcov, 2 neplatní (budú preskočení)"). Pokračovať môžete, ak je platný aspoň jeden riadok; nemusíte najprv opravovať a znova nahrávať.

3. Kliknutím na Next spustíte spracovanie.

Krok 3: Spracovanie

Po spustení spracovania uvidíte ukazovateľ priebehu a počítadlá v reálnom čase:

• Ukazovateľ priebehu — percento spracovaných riadkov
• Created — koľko poverení bolo vytvorených
• Failed — koľko riadkov zlyhalo
• Remaining — koľko riadkov je ešte vo fronte

Tabuľky Created, Failed a Pending sa počas spracovania dávky plnia v reálnom čase pod ukazovateľom.

Pozastavenie a pokračovanie

• Kliknutím na Pause spracovanie dočasne zastavíte. Počas pozastavenia sa nevytvárajú nové poverenia.
• Kliknutím na Resume budete pokračovať tam, kde ste skončili.

Zrušenie

• Kliknutím na Cancel spracovanie úplne zastavíte. Už vytvorené poverenia sa zachovajú.

Spracovanie chýb

Keď riadok zlyhá z dôvodu špecifického pre daný riadok (napr. neplatná hodnota, ktorú backend odmietne):

• Chyba sa zaznamená pri tomto riadku
• Spracovanie automaticky pokračuje ďalším riadkom
• Zlyhané riadky sa zhromaždia pre krok výsledkov a text chyby sa zobrazí v tabuľke zlyhaní na obrazovke

Riadky obmedzené limitom požiadaviek sa automaticky opakujú s krátkym odstupom. Chyba kreditov alebo kvóty je iná — namiesto preskočenia dávka pozastaví, aby ste zbytočne nespotrebovali zvyšok súboru. Zobrazí sa červené oznámenie „Insufficient credits"; dobite kredity alebo prejdite na vyšší plán, potom kliknite na Resume a pokračujte tam, kde sa spracovanie zastavilo.

Obnovenie po obnovení stránky

Ak počas spracovania omylom zatvoríte prehliadač alebo obnovíte stránku, relácia hromadných poverení sa pri návrate obnoví. Priebeh pokračuje tam, kde sa zastavil.

Krok 4: Výsledky

Po dokončení spracovania (alebo zrušení) zobrazí obrazovka výsledkov štyri súhrnné karty:

• Total — počet príjemcov v dávke
• Created — počet vytvorených poverení
• Failed — počet zlyhaných riadkov
• Skipped — nespracovaní príjemcovia (napr. zostávajúce riadky po zrušení)

Pod kartami tabuľka Created uvádza každé nové poverenie s odkazom na jeho zobrazenie a tabuľka Failed uvádza zlyhania s textom chyby.

Stiahnutie správ

• Download Results CSV — každý riadok dávky so stĺpcami row, name, email, status, award_url (URL poverenia je vyplnená pri vytvorených riadkoch).
• Download Failures CSV — iba zlyhané riadky so stĺpcami name, email, error.

Opakovanie zlyhaní

Ak niektoré riadky zlyhali, kliknite na Retry Failures. Spustí sa nový prechod iba cez zlyhaných príjemcov — CSV nemusíte nahrávať znova. Hodí sa po odstránení prechodného problému, napríklad po dobití kreditov po pozastavenej dávke.