eFactura

Secțiune: Finanțe & Contabilitate
URL: /admin/billing/efactura
Titlu pagină: eFactura — Configurare & Trimitere

Prezentare generală

eFactura este integrarea CRMConnect cu sistemul național de facturare electronică al ANAF (Agenția Națională de Administrare Fiscală) din România. Permite generarea XML UBL conform standardului e-Factura, trimiterea facturilor direct în SPV (Spațiul Privat Virtual) al ANAF, verificarea statusului de procesare și descărcarea arhivelor semnate.

Modulul este disponibil exclusiv pentru instanțele configurate cu țara implicită România și se integrează cu serviciul CRMConnect dedicat (einvoice.crmconnect.ro).

Valoare pentru business

Elimină procesul manual de export și upload al facturilor în portalul ANAF. Facturile emise din CRM ajung automat în SPV fără intervenție manuală, reduc riscul de penalități pentru nedepunere și creează un audit trail complet al schimburilor cu ANAF.

Cine îl folosește: Contabili, directori financiari, administratori de sistem
Beneficiu cheie: Conformitate automată cu obligația legală de e-Factura B2B/B2G fără a ieși din CRM
Metrici influențate: Rata de conformitate e-Factura, timp de procesare facturi, număr erori ANAF

Cazuri tipice de utilizare:

Trimiterea automată a facturilor în SPV la X zile după emitere
Verificarea statusului de validare ANAF pentru facturi individuale
Descărcarea PDF-ului semnat digital returnat de ANAF
Import automat al facturilor primite de la furnizori prin sistemul e-Factura
Gestionarea facturilor storno (credit notes) în sistemul e-Factura

Accesarea modulului

/admin/billing/efactura

Accesibil doar pentru utilizatori cu drepturi de admin. Modulul necesită configurarea prealabilă a CIF-ului companiei în setările CRM.

Warning

Token-ul OAuth ANAF expiră periodic și trebuie reînnoit. Când expiră, transmiterea automată a e-Facturilor se oprește silențios — facturile sunt generate dar nu sunt transmise la ANAF, fără nicio eroare vizibilă pe factură. Verificați lunar data de expirare a token-ului în acest modul și reînnoiți-l înainte să expire pentru a evita goluri de conformitate.

Note

eFactura este disponibilă doar când țara implicită a companiei este setată la România în Setări → Setări Generale, iar CIF-ul (codul fiscal) este corect configurat. ANAF respinge toate transmiterile cu CIF lipsă sau invalid.

Configurare — Conectare cu ANAF

Pasul 1 — Obținere token ANAF

Deschizi /admin/billing/efactura
CRM-ul afișează un link de autorizare către einvoice.crmconnect.ro
Transmiți link-ul persoanei care deține certificatul digital al companiei (reprezentant legal sau împuternicit)
Persoana se autentifică cu certificatul → autorizează accesul → tokenul se salvează automat în CRM
La reîncărcare, pagina afișează tokenul activ și data de expirare

Pasul 2 — Configurare setări

Setare	Descriere
Auto-import eFactura	Importă automat facturile primite de la furnizori din SPV (interval: 3–6 ore)
Auto-send eFactura	Trimite automat facturile emise în SPV după X zile de la creare (1–4 zile)

Multi-company

Dacă modulul Multi-Companies este activ, fiecare companie poate avea propriul token ANAF — selectezi compania din dropdown-ul din pagina de configurare.

Fluxul de trimitere a unei facturi

Trimitere manuală

Din lista de facturi sau din fișa facturii, apare butonul eFactura:

Acțiune	URL	Descriere
Generează XML	`billing/efactura/generate_xml/{id}`	Generează fișierul UBL XML conform standardului e-Factura; descarcă fișierul local fără a trimite la ANAF
Trimite la ANAF	`billing/efactura/send_invoice/{id}`	Generează XML și îl trimite direct în SPV; returnează numărul de înregistrare ANAF
Verifică status	`billing/efactura/invoice_status/{id}`	Interogează ANAF pentru statusul de procesare
Descarcă arhivă	`billing/efactura/download_archive/{id}`	Descarcă arhiva ZIP cu XML-ul semnat + PDF-ul returnat de ANAF

Trimitere automată

Dacă Auto-send eFactura = ON și zile = 3, CRM-ul trimite automat factura după 3 zile de la creare. Util pentru a da timp echipei să corecteze eventuale erori înainte de transmitere.

Statusuri posibile după trimitere

Status ANAF	Semnificație	Acțiune
În așteptare	Trimisă, ANAF nu a procesat încă	Verifică din nou în 24h
Validată (OK)	Acceptată de ANAF	Descarcă arhiva semnată
Eroare validare	XML respins de ANAF	Corectează factura, regenerează și retrimite
Duplicat	Factura a mai fost trimisă anterior	Verifică arhiva existentă

Facturi storno (Credit Notes)

Același flux complet există și pentru facturile storno:

Acțiune	URL
Trimite storno	`billing/efactura/send_credit_note/{id}`
Verifică status storno	`billing/efactura/credit_note_status/{id}`
Generează XML storno	`billing/efactura/generate_xml_credit_note/{id}`
Descarcă arhivă storno	`billing/efactura/download_archive_credit_note/{id}`

Import facturi de la furnizori

Unde: billing/efactura/get_invoices_from_einvoice

CRM-ul poate prelua automat (sau manual) facturile pe care furnizorii le-au trimis în SPV-ul companiei tale. Facturile importate pot fi reconciliate cu comenzile de achiziție.

Declanșare manuală: buton „Importă din eFactura" din pagina de configurare.
Declanșare automată: dacă Auto-import = ON, se execută la intervalul configurat (3–6 ore) via cron.

Sincronizare automată status (cron)

Funcția cron_sync_invoice_status este apelată periodic de cron-ul CRM și actualizează statusul tuturor facturilor trimise dar neprocesate (în așteptare). Nu necesită intervenție manuală.

Cerințe și limitări

Condiție	Detaliu
Țara implicită	Trebuie să fie România (cod 142) — altfel modulul nu e vizibil
CIF configurat	Câmpul `company_vat` din setări trebuie să conțină CIF-ul numeric (fără prefix RO)
Token ANAF valid	Tokenul expiră periodic — necesită reînnoire prin link-ul de regenerare
Format factură	Factura trebuie să aibă toate câmpurile obligatorii completate (client cu CIF, adresă, TVA)
Acces admin	Configurarea este restricționată la administratori; trimiterea urmează permisiunile de facturi

Permisiuni

Permisiune	Necesar pentru
Admin	Configurare token, setări auto-send/import
Invoices → View	Vizualizare status e-Factura pe factură
Invoices → Edit	Trimitere și regenerare XML
Credit Notes → View/Edit	Operațiuni e-Factura pe storno

Referințe

Invoices · Credit Notes · Billing · Etransport

← Înapoi la Finanțe & Contabilitate

Sursă: crm-connect-main/app/modules/billing/controllers/Efactura.php