Conectează un asistent AI la e-socotim
Un asistent AI (Claude, ChatGPT, Cursor etc.) îți poate vedea firmele și emite facturi în numele tău. Conectarea se face prin OAuth: adaugi doar adresa serverului, iar tu decizi în e-socotim la ce firme are acces și ce are voie să facă.
Ce poate face asistentul
Acum asistentul are două unelte: să vadă firmele la care l-ai conectat și să creeze o factură, ciornă sau emisă. Facturile emise prin asistent nu se trimit în e-Factura automat: trimiterea rămâne în aplicație. În curând vor veni unelte și pentru citirea seriilor, a partenerilor și a produselor.
Înainte să începi
- 1
Ai nevoie de un cont e-socotim care este proprietar sau manager la firma pe care o conectezi. Un cont cu alt rol nu poate conecta asistenți.
- 2
Firma trebuie să aibă API-ul activat (același care permite cheile API, din Integrare API). Dacă nu e activat, firma apare în listă, dar nu o poți bifa.
Pași pentru conectare
- 1
În aplicație, deschide Integrare API și, la secțiunea Conectează un asistent AI (MCP), alege asistentul tău și metoda OAuth. Pagina îți arată pașii exacți pentru acel asistent, cu adresa serverului deja completată: https://<adresa-aplicației>/mcp/v1.
- 2
Adaugă serverul în asistent, fără cheie. Exemplu, în Claude Code: claude mcp add --transport http e-socotim https://<adresa-aplicației>/mcp/v1, apoi /mcp → Authenticate. În Claude (web, Desktop) sau Cowork: Customize → Connectors → Add custom connector, apoi Connect.
- 3
Se deschide în browser pagina e-socotim Ce firme și ce acces primește…?. Dacă nu ești autentificat, te autentifici întâi cu contul tău.
- 4
Bifează firmele la care are voie asistentul. Dacă ai mai multe, nu e bifată nicio firmă dinainte. Apar doar firmele în care ești proprietar sau manager; cele fără API activat sunt afișate gri, cu mențiunea „API-ul public nu este activat”, și nu pot fi bifate.
- 5
Alege nivelul de acces (vezi tabelul de mai jos) și apasă Permite. Cu Refuză asistentul nu primește nimic.
- 6
Ești trimis înapoi la asistent, care e conectat. Poți să-i ceri, de exemplu: „Ce firme am conectate?” sau „Emite o factură către clientul X pentru 100 lei, serie TUX”.
Notă — Numele aplicației de pe pagina de consimțământ este declarat de aplicație și nu e verificat de e-socotim. Sub titlu vezi adresa la care ești întors după decizie. Dacă nu ai pornit tu o conectare, apasă Refuză.
Cele patru niveluri de acces
Nivelurile se adaugă unul peste altul. Asistentul primește cel mult nivelul pe care îl cere el; tu poți alege unul mai mic.
| Nivel | Ce are voie asistentul |
|---|---|
| Citire | Doar să vadă datele firmelor bifate (serii, parteneri, produse, facturi). Nu modifică nimic. |
| Citire, creare și modificare | În plus, poate adăuga serii, parteneri și produse, poate modifica partenerii și produsele și poate crea sau modifica facturi ciornă. Nu emite facturi și nu șterge nimic. |
| Citire, creare, modificare și emitere | În plus, poate emite facturi. Facturile emise sunt definitive. |
| Acces complet | În plus, poate șterge serii, parteneri, produse și ciorne, poate trimite facturi în e-Factura (ANAF) și le poate trimite prin e-mail. |
Nu toate aceste acțiuni au unelte disponibile încă; la nivelul Citire, asistentul vede deocamdată doar lista firmelor, iar emiterea de facturi cere nivelul „emitere”. Nivelul ales rămâne valabil și când apar unelte noi în aceeași categorie.
Notă — Emitere înseamnă că factura primește număr și devine definitivă: nu mai poate fi modificată sau anulată de asistent, iar corectarea se face prin stornare, din aplicație. Alege nivelul de emitere doar dacă ai încredere în asistent și îi verifici facturile. Pentru a doar pregăti facturi, folosește Citire, creare și modificare: asistentul creează ciorne pe care le emiți tu.
Dacă ceva nu merge
| Ce vezi | Ce faci |
|---|---|
| Contul nu este proprietar sau manager la nicio firmă | Autentifică-te cu alt cont (Folosește alt cont) sau cere unui proprietar/manager să facă conectarea. |
| Firma e gri: „API-ul public nu este activat” | Activează API-ul pentru firmă (sau cere administratorului), apoi reia conectarea. |
| Cererea a expirat sau e invalidă | Cererea de consimțământ e valabilă 10 minute. Reia conectarea din asistent, ca să se genereze una nouă. |
| Asistentul spune că nu e autentificat sau că firma nu e permisă | Accesul se verifică la fiecare apel: dacă ai pierdut rolul de proprietar/manager sau API-ul a fost dezactivat, firma nu mai e accesibilă. Reia conectarea. |
| Asistentul nu poate emite factura | Probabil ai ales un nivel fără „emitere”. Reia conectarea și alege nivelul potrivit; o nouă decizie înlocuiește pe cea veche. |
| Pagina de consimțământ nu se deschide din asistent | Unele asistente (Gemini CLI, Codex) au nevoie de un browser pe același calculator. Verifică și că adresa serverului e exact cea din Integrare API. |
Dacă tot nu reușești, scrie-ne la support@e-socotim.ro, cu numele asistentului și ora încercării.