ANAF

SPV: configurare OAuth pas cu pas pentru e-Factura

Ghid tehnic pentru conectarea CleverBill la Spațiul Privat Virtual prin OAuth 2.0.

E Echipa CleverBill 3 minuts de lectură

Pregătire

Ai nevoie de certificat digital calificat instalat în browser și drept de reprezentant pentru compania pe care o conectezi. Procesul durează aproximativ 5 minute.

Pașii

  1. Din Setări → Integrări → ANAF SPV, apeși „Conectează".
  2. Ești redirecționat către logincert.anaf.ro — selectezi certificatul companiei.
  3. Accepți scope-urile (read invoices, submit invoices, read UIT).
  4. Ești redirecționat înapoi în CleverBill cu un token stocat criptat (AES-256) în DB.

Refresh token

Access token-ul expiră la 10 minute, refresh token-ul la 90 de zile. Jobul RefreshSpvTokenJob rulează zilnic și reîmprospătează automat token-urile active. Înainte de expirare cu 7 zile, admin-ul primește notificare pentru reconectare.

Erori comune

  • „Certificat invalid" — verifică că este în cardul USB și browser-ul îl găsește.
  • „Nu sunteți reprezentant" — cere la ANAF să actualizeze lista reprezentanților legali.