eFactura

Section: Finance & Accounting
URL: /admin/billing/efactura
Page title: eFactura — Configurare & Trimitere

Overview

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).

Business value

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.

Typical use cases:

Accessing this module

/admin/billing/efactura

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

Setup — Conectare cu ANAF

Pas 1 — Obținere token ANAF

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

Pas 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.

Trigger manual: buton „Importă din eFactura" din pagina de configurare.
Trigger 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 Finance & Accounting


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