Credențiale în masă

Credențialele în masă îți permit să emiți insigne către sute sau mii de destinatari simultan, încărcând un fișier CSV. Procesul are patru pași, cu urmărirea progresului, pauză/reluare și gestionarea erorilor integrate.

Prezentare generală

Procesul de emitere în masă urmează patru pași:

1. Configurare — selectează insigna și opțiunile
2. Încărcare — pregătește și încarcă fișierul CSV
3. Procesare — urmărește progresul pe măsură ce se creează credențialele
4. Rezultate — verifică rezultatele și descarcă rapoartele

Pasul 1: Configurare

1. Deschide pagina Bulk Credentials din bara laterală (are propria rută, separată de pagina Credentials).
2. Selectează insigna pe care vrei să o emiți folosind selectorul de insigne.
3. Opțional, configurează:
   • Issued On — data folosită pentru toate credențialele (implicit, ziua de azi)
   • Expires — data de expirare opțională pentru toate credențialele
   • Send Email — dacă fiecare destinatar primește automat un e-mail după crearea credențialei sale
4. Apasă Next.

Pasul 2: Încărcarea fișierului CSV

Formatul CSV

Fișierul CSV trebuie să conțină o coloană name și o coloană email, cu un rând de antet. Numele antetelor nu țin cont de majuscule/minuscule, iar recipient_name / recipient_email sunt acceptate ca alias-uri pentru name / email.

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

Descărcarea șablonului

Apasă Download Template pentru a obține un fișier CSV gol, cu antetele corecte. Completează-l cu destinatarii tăi și încarcă-l.

Încărcare

1. Apasă Upload CSV sau trage și plasează fișierul.
2. Fișierul este validat înainte de începerea procesării.

Reguli de validare

Fiecare rând este validat imediat ce fișierul este analizat:

• Numele trebuie să aibă cel puțin 5 caractere
• E-mailul trebuie să fie o adresă de e-mail validă
• Rândurile goale sunt ignorate

Tabelul de previzualizare listează fiecare rând cu o bifă verde sau un motiv în roșu. Rândurile invalide nu blochează procesul — sunt pur și simplu omise, iar contorul arată câți destinatari valizi vor fi procesați (de ex. „18 destinatari valizi, 2 invalizi (vor fi omiși)"). Poți continua atâta timp cât cel puțin un rând este valid; nu trebuie să corectezi și să reîncarci mai întâi.

3. Apasă Next pentru a începe procesarea.

Pasul 3: Procesare

După începerea procesării, vezi o bară de progres și contoare în timp real:

• Bara de progres — procentul de rânduri procesate
• Created — câte credențiale au fost create
• Failed — câte rânduri au eșuat
• Remaining — câte rânduri mai sunt în coadă

Tabelele în timp real Created, Failed și Pending se completează sub bară pe măsură ce lotul rulează.

Pauză și reluare

• Apasă Pause pentru a opri temporar procesarea. Cât timp este în pauză, nu se creează credențiale noi.
• Apasă Resume pentru a continua de unde ai rămas.

Anulare

• Apasă Cancel pentru a opri complet procesarea. Credențialele deja create se păstrează.

Gestionarea erorilor

Când un rând eșuează dintr-un motiv specific rândului (de ex. o valoare invalidă respinsă de backend):

• Eroarea este înregistrată pentru acel rând
• Procesarea continuă automat cu rândul următor
• Rândurile eșuate sunt colectate pentru pasul de rezultate, iar textul erorii este afișat în tabelul de eșecuri de pe ecran

Rândurile limitate de rată (rate-limited) sunt reîncercate automat, cu o scurtă întârziere. O eroare de credite sau de cotă este diferită — în loc să sară mai departe, lotul intră în pauză, ca să nu consumi restul fișierului. Apare o notificare roșie „Insufficient credits"; suplimentează creditele sau fă upgrade, apoi apasă Resume pentru a continua de unde s-a oprit.

Recuperarea după reîncărcarea paginii

Dacă închizi din greșeală browserul sau reîncarci pagina în timpul procesării, sesiunea de credențiale în masă este recuperată la revenire. Progresul se reia de unde s-a oprit.

Pasul 4: Rezultate

După finalizarea procesării (sau după anulare), ecranul de rezultate afișează patru carduri-sumar:

• Total — numărul de destinatari din lot
• Created — numărul de credențiale create
• Failed — numărul de rânduri eșuate
• Skipped — destinatari neprocesați (de ex. rândurile rămase după o anulare)

Sub carduri, un tabel Created listează fiecare credențială nouă cu un link pentru vizualizare, iar un tabel Failed listează eșecurile cu textul erorii.

Descărcarea rapoartelor

• Download Results CSV — fiecare rând din lot, cu coloanele row, name, email, status, award_url (URL-ul credențialei este completat pentru rândurile create).
• Download Failures CSV — doar rândurile eșuate, cu coloanele name, email, error.

Reîncercarea eșecurilor

Dacă unele rânduri au eșuat, apasă Retry Failures. Aceasta pornește o nouă trecere doar peste destinatarii eșuați — nu trebuie să reîncarci un CSV. Este util după remedierea unei probleme temporare, cum ar fi suplimentarea creditelor după un lot pus în pauză.