Skip to main content
Acest ghid descrie strict instalarea extensiei de Google Chrome iSpv ANAF Connector. Extensia este necesară pentru ca aplicația iSpv.ro să poată comunica în mod securizat cu serviciile ANAF.
Instrucțiunile funcționează pentru Google Chrome și pentru browsere compatibile (Chromium, Brave, Microsoft Edge — pașii sunt similari: secțiunea „Extensions” și butonul „Load unpacked”).

Cerințe

  • Un browser bazat pe Chromium (Google Chrome recomandat)
  • Arhiva extensiei iSpv ANAF Connector (.zip) sau un folder cu fișierele extensiei

Pașii pe scurt

  1. Descarcă arhiva .zip a extensiei iSpv ANAF Connector.
  2. Dezarhivează într-un folder local.
  3. Deschide Chrome și mergi la chrome://extensions/.
  4. Activează „Developer mode”.
  5. Click pe „Load unpacked” și selectează folderul dezarhivat al extensiei iSpv ANAF Connector.
  6. Verifică faptul că extensia „iSpv ANAF Connector” apare în listă și este activă.

Pașii detaliați

1) Descarcă și dezarhivează

  • Descarcă fișierul .zip care conține extensia iSpv ANAF Connector (din contul tău iSpv.ro sau conform instrucțiunilor primite de la iSpv).
  • Dezarhivează într-o locație ușor de găsit (ex.: Desktop sau Documents).
Folderul rezultat trebuie să conțină fișierul manifest.json la rădăcină, plus restul fișierelor (iconuri, scripturi, pagini HTML, etc.).

2) Deschide managerul de extensii

  • În Chrome, introdu în bara de adrese: chrome://extensions/
  • Alternativ: Meniu (⋮) > More Tools > Extensions

3) Activează modul de dezvoltator

  • În colțul din dreapta sus al paginii Extensions, activează „Developer mode” (comutatorul trebuie să fie ON).

4) Încarcă folderul extensiei

  • Apasă butonul „Load unpacked”.
  • Alege folderul pe care l-ai dezarhivat la Pasul 1 (cel care conține manifest.json).
  • După selectare, extensia „iSpv ANAF Connector” ar trebui să apară în listă.

5) Verifică instalarea

  • Extensia apare acum în listă cu un card propriu (nume: „iSpv ANAF Connector”, versiune, ID).
  • Asigură-te că comutatorul de lângă extensie este activ (ON).
  • Fixează extensia în toolbar: click pe pictograma „Puzzle” din dreapta sus > pin pentru „iSpv ANAF Connector”.

Actualizarea extensiei (după modificări)

Dacă faci modificări în fișierele extensiei (de ex. în timpul dezvoltării):
  • Revino la chrome://extensions/.
  • Asigură-te că „Developer mode” este activ.
  • Apasă butonul „Reload” (icon săgeată rotită) pe cardul extensiei pentru a reîncărca versiunea din folder.

Depanare (Troubleshooting)

Dacă apare eroarea „Manifest file is missing or unreadable” sau „Could not load manifest”, verifică faptul că:
  • Ai selectat folderul corect (nu folderul părinte). Folderul selectat trebuie să aibă manifest.json la rădăcină.
  • Fișierul manifest.json este valid JSON și respectă schema Manifest V3.
Probleme comune:
  • „Load unpacked” nu apare: asigură-te că „Developer mode” este activ (comutatorul din dreapta sus).
  • Permisiuni: la instalare, Chrome poate afișa permisiuni pentru domenii asociate ANAF și iSpv.ro. Revizuiește și acceptă pentru a permite comunicarea.
  • Fișiere lipsă: asigură-te că toate fișierele declarate în manifest (ex.: service_worker, action.default_popup, icons) există la calea corectă.
  • Erori la runtime: deschide DevTools pe pagina relevantă sau pe Service Worker-ul extensiei (butonul „Service worker” > „Inspect views”).

Dezinstalare / Dezactivare

  • Mergi la chrome://extensions/.
  • Dezactivează comutatorul pentru a opri temporar extensia, sau apasă „Remove” pentru a o dezinstala.

Întrebări frecvente (FAQ)

  • De unde descarc extensia? Din contul tău iSpv.ro sau conform instrucțiunilor primite de la echipa iSpv.
  • Pot încărca direct un .zip? Nu, pentru încărcare locală trebuie întâi să dezarhivezi și să selectezi folderul (Load unpacked).
  • Pot folosi același folder pe mai multe calculatoare? Da, dacă copiezi folderul dezarhivat și repeți pașii pe fiecare calculator.
  • Funcționează pe Edge/Brave? Da, pașii sunt similari (secțiunea de extensii + „Load unpacked”).