Agent SPV pentru Desktop

Aplicație gratuită care îți aduce toate mesajele SPV ANAF (notificări, decizii, somații, adeverințe) folosind certificatul de pe token-ul tău USB. Le salvează local și le sincronizează automat cu contul tău zuc.ro.

Cod sursă semnat Notarizat Apple Cheia nu părăsește token-ul

Ce ai nevoie

Token USB

Token cu certificat digital calificat înrolat în SPV (Alfasign, certSIGN, DigiSign, Trans Sped etc.).

Driver PKCS#11

Middleware-ul producătorului token-ului instalat (de regulă deja prezent dacă semnezi azi din browser).

Cont zuc.ro

O cheie API generată din Setări Facturi → API ca să publice mesajele în contul tău.

Cum o folosești

  1. 1

    Descarci și deschizi aplicația

    Pe Mac: dezarhivează ZIP-ul și deschide SPV Agent.app. Pe Windows: rulează direct .exe-ul (nu e nevoie de instalare).

  2. 2

    Apeși „Detectează token-uri" și introduci PIN-ul

    Aplicația găsește automat token-ul tău USB și certificatul. PIN-ul rămâne pe mașina ta (nu se trimite nicăieri).

  3. 3

    Lipești cheia API zuc.ro și CUI-urile

    Generezi cheia la Setări Facturi → API, o pui în câmpul corespunzător și scrii CUI-urile pentru care vrei să iei mesajele (unul pe linie).

  4. 4

    Pornește și uită de el

    Setezi „Auto la X min" pe 30 sau 60 și aplicația verifică SPV-ul în fundal. Mesajele apar în Mesaje SPV.

Securitate & confidențialitate

Cheia privată rămâne pe token

Toată semnătura TLS se face în interiorul token-ului USB. Aplicația nu exportă cheia, nu o trimite nicăieri.

Semnătură & notarizare Apple

Versiunea macOS e semnată cu un certificat Apple Developer ID (Docs Printing SRL) și notarizată de Apple — deschidere directă, fără warning de „developer unidentified".

Comunică doar cu ANAF și zuc.ro

Aplicația face exact două lucruri: cere mesaje de la ANAF (mutual-TLS) și le urcă în contul tău zuc.ro (HTTPS cu cheia API). Nimic altceva.

Fișierele rămân și local

PDF-urile/ZIP-urile SPV se salvează în folderul ales de tine pe disc — chiar dacă nu folosești sincronizarea cu zuc.ro, le ai oricum.

Întrebări frecvente

De ce am nevoie să ruleze local pe Mac/PC și nu pe server?

Pentru că SPV-ul general acceptă autentificare doar cu certificatul de pe token-ul USB, iar cheia privată nu părăsește token-ul. Server-ul nu poate avea token-ul fizic conectat — singura cale corectă e o aplicație locală care folosește token-ul tău.

Trebuie să introduc PIN-ul de fiecare dată?

Nu. Setezi „Auto la X minute" și aplicația ține sesiunea cu token-ul deschisă — PIN-ul se introduce o singură dată la pornire, apoi rulează în fundal.

Pot folosi același cont pentru mai multe firme?

Da. Scrii la „CIF-uri" pe linii separate toate CUI-urile pentru care certificatul tău e înrolat în SPV — aplicația le trage pe toate, iar mesajele apar la compania corespunzătoare în zuc.ro.

Pot sări peste sincronizarea cu zuc.ro?

Da — lași câmpul „API key" gol și aplicația doar descarcă fișierele local în folderul ales.

Linux?

Versiunea Linux nu e publicată încă; scrie-ne și o pregătim dacă e nevoie (sursa e cross-platform).