Cuprins

16.01.2026

LISTARE

hMARFA V8.HE1 - Opţiune import e-facturi în hMARFA din SPV

1. Prezentare opţiune

Importul în hMARFA a facturilor trimise în SPV dintr-o altă bază de date hMARFA sau alte aplicații este util în situaţiile în care:

Se importă capul facturilor şi rândurile facturilor. Dacă clientul nu există în Firme, se adaugă. Se alege automat Lotul de intrare din care se face descărcarea. La import rândurile se pot transforma automat pentru evidenţă tip global-valorică. Există numeroase posibilităţi de parametrizare.

Pentru import trebuie stabilite reguli de corespondenţă între:

În Dicţionar import se pot defini multe tipuri de corespondenţe, dar cel mai simplu caz este dacă codificările coincid.

Despre ce codificări este vorba:

2. Ghid de definire corespondenţe între codificarea din cele 2 baze de date

Fiind la început de an 2026, recomandăm analiza codificărilor în baza de date din care se trimit facturile în SPV şi cât permite programul utilizat să se folosească codificări similtare cu hMARFA în care se va importa.

Traseul facturilor:

2a) Codificarea seriilor şi numerotarea facturilor

Recomandăm să aibă serii distincte:

Exemple:

Serie Regim spec. de la Nr.fac. de la Explicatii
AV A60001 A60001 Aviz
BON FA6001 B60001 Factura aditionala
FB 26B001 Factura emisa de beneficiar
FE 26E001 26E001 Facturi export, livrare UE
FF 260001 260001 Facturi interne
ZZ RAPZ60001 Z60001 Raport Z-BVINZ

Numărul de regim special din cadrul seriei poate să fie identic cu numărul de factură, sau să fie un număr de 12 caractere reprezentând numărul facturii în baza de date sursă.

Este important să existe o corelaţie cât mai exactă între numerotarea din sursă şi destinaţie. Numerele din sursă vor fi utilizate în XML, iar numerele din destinaţie în D394 şi SAF-T.

2b) Codificarea clienţilor

<cac:Party>
    <cac:PartyIdentification> 
        <cbc:ID>0015</cbc:ID>
    </cac:PartyIdentification>

2c) Codificarea articolelor

<cac:SellersItemIdentification>
    <cbc:ID>M-CAFEA-M      </cbc:ID>
</cac:SellersItemIdentification>

3. Funcţionarea importului

Importul e-Facturilor trimise execută preluarea automată a e-Facturilor emise în alte programe și încărcate în SPV, astfel încât acestea să poată fi gestionate din punct de vedere contabil în hMARFA.

Importul se poate realiza:

La importul capului facturii, sistemul preia din fișierul XML toate informațiile esențiale ale documentului: data emiterii, moneda, tipul facturii, datele partenerului, totalul facturii și total TVA conform configurării din Dicţionar import, meniurile CapF. Rândurile facturii se preiau conform meniurilor RandF.

3a) Identificarea clienţilor

În situația în care la import programul identifică o firmă care nu există încă în fișierul Firme din baza de date hMARFA, sistemul o adaugă automat.

La import, partenerul se identifică automat în următoarea ordine:

  1. după Cod client;
  2. dacă nu este găsit, după CIF;
  3. dacă CIF=0, după denumirea partenerului.

Dacă partenerul nu există în Firme, sistemul îl adaugă automat codul fiind stabilit astfel:

3b) Calculul numărului de factură (NrFac)

Pentru determinarea valorii număr factură, aplicația aplică următoarele reguli, în ordinea de mai jos:

  1. Nr.Fac este completat în Dictionar import - valoarea introdusă este utilizată ca punct de pornire, iar la import se incrementează automat pentru fiecare document nou.
  2. Nr.Fac nu este completat, dar există formulă de calcul - sistemul evaluează formula definită și utilizează rezultatul acestuia pentru completarea numărului facturii.
  3. Nr.Fac și formula de calcul nu sunt completate - numărul facturii este preluat din fișierul XML (e-Factura).

:!: Dacă lungimea numărului preluat depășește 6 caractere, factura nu este importată, fiind semnalată ca eroare în raportul de import.

3c) Calculul numărului de regim special (Nr.Reg.Spec)

Pentru Nr.Reg.Spec, sistemul aplică următoarele reguli:

Seria este obligatoriu completată pentru orice document importat.

  1. Nr.Reg.Spec este completat în Dictiona import - valoarea existentă este utilizată și incrementează automat la fiecare import.
  2. Nr.Reg.Spec nu este completat, dar există formulă de calcul - sistemul evaluează formula și stabilește automat numărul de regim special.
  3. Nr.Reg.Spec și formula de calcul nu sunt completate - se utilizează automat valoarea calculată pentru NrFac.

3d) Calcul curs de schimb

Dacă factura este în valută trebuie stabilit cursul de schimb, care de regulă nu figurează explicit în XML. Se poate calcula doar din raportul Total TVA în lei şi în valută care nu este exact. De aceea în mod prioritar se foloseşte cursul oficial BNR descărcat în Cursuri de schimb valabil în data facturii.

Deci este obligatoriu ca înainte de importul facturilor şa se descarce cursul BNR. Cursul de schimb este calculat şi din XML din raportul Total TVA în lei şi în valută şi este rotunjit implicit la 4 zecimale. Dacă în e-Moneda din Dictionar cursul este marcat cu (Zec=6), cazul HUF şi JPY, se rotunjeşte la 6 zecimale.

Cu cele două cursuri se recalculeaă Total TVA în lei din TVA în valută şi cursul utilizat va fi cel la care diferenţa calculată este mai mică faţă de valoarea TVA lei din XML. Valoarea totală TVA în lei din XML apare în text liber. Dacă TVA est 0, se utilizează cursul BNR.

3e) Completarea automată a articolelor noi

Dacă în XML apare un articol nou care nu există nici în Dicționar, nici în Nomenclator, acesta nu este creat automat — pentru a evita introducerea accidentală a codurilor eronate. Sistemul solicită intervenția operatorului, iar după stabilirea corespondentului, regula se salvează automat pentru utilizări viitoare.

3f) Rezultatul final al importului

La finalul procesului, sistemul generează automat un fișier log cu statusul fiecărei facturi (OK, A, M, ES, MSG), detalii despre tipul documentului, partener, articole și eventualele erori. Capul facturii și rândurile ei sunt importate complet doar dacă toate elementele au corespondent valid în hMARFA, garantând acuratețea și trasabilitatea datelor.

4. Configurare parametri

Este obligatorie configurarea inițială a parametrilor de automatizare și a corespondențelor. Se testează procesul cu câteva facturi reprezentative înainte de rularea automată în masă. Imprtul se poate repeta de ori câte ori.

4a) Capul facturii

Configurarea parametrilor pentru capul facturii se realizează în: Facturi/Ieșiri → Dicționar Import → Fereastra CapF – Parametri import/jurnal

Pe această fereastră se stabilesc corespondențele între tipurile de facturi din XML și documentele din hMARFA. Pentru fiecare combinație de parametri se poate defini un comportament distinct la import, în funcție de tipul facturii, sursa acesteia, moneda, codul clientului etc.

Câmpurile principale sunt:

CâmpDescriere
TipFacTipul facturii din XML (ex. 380 – factură obișnuită, 381 – storno, etc.)
SursăȚara clientului: RO / UE / EX-export
MonedăMoneda facturii: RON, *-orice valută. EUR, USD etc.
Cod clientCodul clientului din XML; dacă nu există, se caută după CUI, iar dacă CUI=0 (persoană fizică), după denumire
JurnalJurnalul hMARFA în care se va importa factura
Tip document (TDoc)Tipul documentului utilizat la import (ex. TFAC, TFAUS etc.)
ModelModelul documentului (H, B-model nou pentru listare text liber import, etc.)
Seria / Nr. Reg. Spec. / Nr. fac.Valorile implicite sau formulele utilizate pentru generarea numărului și seriei la import. : Dacă valoarea şi formula numărului de factură sau Nr,reg,spec este gol, se preia număr factură din XML.
Formula de calculPermite stabilirea automată a seriei, numărului și jurnalului pe baza unor reguli logice. Fereastra este modificabila doar dacă o lansăm cu $
OpTVAOperaţia TVA (ex. 1I*, 1Ix, 1Iz, 1Ld etc.) conform tipului de operațiune, dacă * atunci se calculează automat
ObservațiiDescriere liberă, ex. „Factură obișnuită”, „Factură externă UE”

Formule de calcul pentru Nr.Fac și Nr.Reg.Spec

Pentru completarea automată a câmpurilor Număr factură (Nr.Fac) și Număr regim special (Nr.Reg.Spec), aplicația permite definirea unor formule de calcul personalizate care utilizează câmpurile definite în structura E- Documente XML, disponibile în meniul: Tipuri → E-Documente XML → 06 Facturi FAC – cap.

Exemplu calcul număr factură:

h_DTOC(DataAppl,"aa") + RIGHT(man->NRFAC,4)

4b) Fereastra de modificare “Parametri/automatizari”

Parametrii pentru manipularea rândurilor facturii se definesc în fereastra de modificare: „Parametri automatizare”.

Aici se stabilește modul de comportare al sistemului la preluarea rândurilor din XML. Opțiuni principale:

După import, validarea facturii se face automat dacă este setată opțiunea „Validare D/N”, utilizând regulile definite pentru tipul de document.

4c) Dicționar import randuri

Meniul servește pentru stabilirea corespondenței dintre articolele din e-Factura trimisă și articolele din Nomenclatorul hMARFA.

Acces: Facturi/Ieșiri → Dicționar import → Fereastra RandF

Traducere

Permite traducerea automată a articolelor din XML în articolele din hMARFA.

La import, sistemul caută mai întâi o traducere specifică clientului în Dicționarul de import. În cazul în care codul client este gol, traducerea se aplică indiferent de client conform Dictionar import.

Dacă nu găsește o corespondență, verifică existența articolului în Nomenclator articole. În cazul în care articolul nu este găsit nici în Dicționar, nici în Nomenclator, acest lucru este semnalat în raportul de descărcare generat după lansarea importului.

În această situație, nu se importă niciun rând din e-Factura respectivă, urmând ca operatorul să intervină manual — prin funcția F10 – Import randuri factura — pentru a identifica și completa corespondențele.

Formule de calcul pentru Gestiune şi număr recepţie

Aceste formule pot utiliza un set de variabile predefinite.

Variabila Tip Explicatie Sursa
eff_tipXML caracter Tip procesare XML (380,384,751…) XML
eff_jurn caracter Cod jurnal contabil Calculat
eff_tdoc caracter Tip document Calculat
eff_model caracter Model document Calculat
eff_seria caracter Serie document Calculat
eff_nrregsp caracter Nr.Reg.Sp. Calculat
eff_nrfac caracter Numar factura Calculat
eff_opTVA logic Indicator operatie TVA Calculat
eff_moneda caracter Moneda documentului XML
eff_GLOVAL logic Indicator Global Valoric Calculat
eff_gest caracter Cod gestiune Calculat
eff_nrtran caracter Numar receptie Calculat
eff_valid logic Validare document Calculat
eff_errand logic Indicator eroare la nivel de rand Calculat
eff_hash_xml array Hash cu date extrase din XML XML
eff_cumulare logic Indicator cumulare randuri Calculat
eff_curs numeric Curs valutar Calculat
eff_client caracter Cod client Calculat

Exemplu calcul gestiune:

LEFT(eff_nrfac,2)

Exemplu calcul număr recepţie:

IIF(eff_nrfac="M1",h_DTOC(DataAppl, "aaM100"),IIF(eff_nrfac="M2",h_DTOC(DataAppl, "aaM200"),"MR")

4d) Meniul e-Parametri

Se poate lansa din:

5. Operare curentă

Importul facturilor trimise se efectuează în Facturi/Ieșiri → Import → Import e-Facturi trimise. În funcție de setările existente în e-Parametri, structura meniurilor poate diferi ușor, însă funcționalitatea rămâne aceeași.

Pași principali:

  1. Descărcare facturi din SPV (selectare perioadă)
  2. Despachetare ZIP-uri și analiză XML (în mod automat)
  3. Import cap + rânduri conform parametriilor din Dicţionar import
  4. Validare automată a facturilor la care s-a cerut
  5. Completarea manuală a rândurilor dacă nu au fost importate
  6. Revizuirea capului şi rândurilor de factură
  7. Vizualizări catalog factură, factură în XML şi PDF
  8. Ştergerea facturilor dintr-un pachet importat

5a) Descărcare ZIP e-Facturi din SPV

La lansarea operaţiei de descărcare, sistemul preia facturile din SPV pentru perioada selectată de regulă în catalogul DECL_OBL\aaaa\DOC_T\IMPORT. Calea acestui catalog este definită prin aliasul efct.

Pentru configurațiile cu mai multe baze de date unde este necesară separarea directoarelor de import, aliasul efct trebuie configurat astfel încât să includă parametrul cif după segmentul DOC_tip. Prin această setare, sistemul va înlocui dinamic variabila „cif” cu codul de identificare fiscală al fiecărei firme. ex: ..\DECL_obltstB\aaaa\DOC_tip\cif\nr_par\nr.XML

În această fază facturile sunt descărcate sub formă de ZIP,nu se creează încă documente în hMARFA. După finalizarea descărcării, aplicația generează un fișier log în format Excel, care conține facturile identificate în SPV pentru perioada selectată şi pentru care ID încărcare încă nu figurează în Facturi/Ieşiri. Ulterior din acestea nu vor fi importate cele care nu sunt în luna curentă hMARFA.

Intervalul de descărcat se referă la datele de încărcare a facturilor din baza de date sursă şi nu la data facturilor. Pentru a descărca facturile aferente lunii curente se indică data început a lunii, iar pentru data de sfârşit se alege data la care au fost încărcate ultimele facturi din luna curentă hMARFA. Dacă numărul de facturi este mare, este indicat ca să se descarce pe perioade mai scurte, câteva zile sau o săptămână.

Dacă în coloana Mesaj este o eroare, atunci copiem calea din coloana CaleZip. De exemplu D:/HAMOR/DECL_OBL/2026/DOC_T/IMPORT/idincarcare.ZIP. Deschideţi ZIP-ul şi din ZIP XML-ul care arată eroarea. Este posibil ca eroarea să fi fost rezolvată, iar factura corectă este într-un alt ZIP descărcat. Din păcate informaţiile din ZIP nu conţin informaţii ca să identificăm factura.

5b) Importul e-Facturilor descărcate

După finalizarea descărcării arhivelor ZIP din SPV, meniul este completat cu Import e-Facturi descărcate din SPV – de importat:nnn, unde nnn reprezintă numărul de facturi descărcate din SPV disponibile pentru import. În cazul descărcării rapide setată din e-Parametri, descărcarea şi importul se realizează în aceeaşi operaţie.

La import:

Facturile importate se vizualizează pe fereastra 13. e-Facturi importate, pe care prima coloană reprezintă un identificator de pachet care conține informații despre data importului și stația de lucru utilizată. Exemplu: S1/2026-01-14 20:53

În timpul procesului de import automat al facturilor descărcate din SPV, sistemul verifică existența corespondențelor pentru toate rândurile din factură. Dacă pentru cel puțin un rând nu este identificat un corespondent valid, importul rândurilor este întrerupt, deci niciun rând al facturii nu este importat. Factura este marcată în raportul de import. În această situație, utilizatorul va interveni manual pentru rezolvarea problemei. Se introduc rândurile facturii într-un fişier temporar cu F10/Import rânduri factură.

Utilizatorul poate:

În momentul în care un corespondent este stabilit și rândurile sunt salvate, regula de traducere este memorată automat în Dicționarul de import rânduri, regula urmând a fi utilizată la importurile viitoare.

5c) Operații disponibile în fereastra F10 – Import randuri factura

În fereastra de manipulare a rândurilor (F10), utilizatorul are la dispoziție mai multe operații, accesibile prin meniul F10, printre care:

Aceste funcții permit corectarea completă a facturii, astfel încât importul să poată fi finalizat fără erori.

Rândurile facturii la import sunt interpretate astfel:

În procesul de import al rândurilor, aplicația analizează fiecare poziție din fișierul XML și aplică regulile definite în fereastra 01 RandF – Traduceri. Din XML sunt preluate cantitățile, prețurile, unitățile de măsură și cotele de TVA, aceste informații fiind transpuse automat în structura internă a aplicației hMARFA.

Pentru fiecare rând importat, sistemul caută mai întâi o corespondență în Dicționarul de import rânduri. Dacă nu este identificată o traducere, aplicația verifică existența articolului în Nomenclatorul de articole. În situația în care articolul nu este găsit nici în dicționar, nici în nomenclator, nu se importă niciun rând al facturii, iar documentul este marcat corespunzător în raportul Excel generat la finalul procesului.

În aceste situații, operatorul poate interveni manual prin funcția F10 – Import randuri factura, disponibilă după selectarea facturii. La apelarea acestei funcții apare o fereastră pentru manipulării manuale a rândurilor unde sunt afișate articolele din e-Factura, împreună cu informațiile aferente acestora.

În fereastra de manipulare, utilizatorul poate modifica manual fiecare rând sau poate stabili corespondentul corect în nomenclatorul hMARFA.

Apăsarea tastei F10 în această fereastră deschide meniul Operații, care oferă următoarele funcționalități:

În plus, sunt disponibile și operații auxiliare:

După stabilirea corespondențelor și salvarea modificărilor, regulile definite sunt memorate automat în Dicționarul de import rânduri, fiind utilizate la importurile viitoare pentru articole identice.

5d) Vizualizare ultimul raport de descărcare şi import

Această opțiune permite afișarea ultimului fișier log generat în urma operației de descărcare a facturilor din SPV. Raportul conține lista completă a facturilor identificate în SPV pentru perioada selectată.

După lansarea procesului de import al facturilor descărcate din SPV, meniul import se extinde automat și pune la dispoziția utilizatorului opțiuni suplimentare pentru analiză, verificare și administrare.

Meniul Vizualizări permite accesul rapid la documentele și fișierele asociate facturilor importate. Prin intermediul acestuia, utilizatorul poate consulta:

Meniul Vizualizare ultimul raport de import permite afișarea celui mai recent fișier log generat în urma procesului de import al facturilor.

Raportul de import este furnizat în format Excel și conține informații detaliate privind rezultatul procesului, inclusiv:

Pentru fiecare factură sunt afișate detalii precum tipul documentului, numărul facturii, partenerul, valorile facturate, articolele importate și eventualele probleme identificate. Acest raport permite verificarea exactă a modului în care fiecare factură a fost procesată și identificarea rapidă a situațiilor care necesită intervenție manuală.

După descărcare și import, sistemul generează un fișier log în format Excel care oferă informații detaliate despre fiecare factură procesată:

5e) Stergere facturi și cataloage

Prin meniul Ștergere facturi și cataloage, utilizatorul poate elimina facturile importate, împreună cu toate fișierele și cataloagele asociate acestora. Operația se realizează pe baza unui identificator de import, care poate fi vizualizat în prima coloană din fereastra 13. e-Facturi importate, care conține informații despre data importului și stația de lucru utilizată. Exemplu: S1/2026-01-14 20:53

La ștergere sunt eliminate automat:

Această funcționalitate este utilă în special în faza de testare sau în situațiile în care importul trebuie reluat din cauza unor erori de configurare. De regulă numai ultimul pachet importat poate fi şters. Dacă se şterg pachete intermediare atunci la reluare numerotarea facturilor nu va mai fi bună decât dacâ se pot prelua numerele de facturi din XML şi numerele nu se generează prin incrementare.

5f) Verificare serii și numere de facturi

Funcția Verificare serii și numere de facturi este utilizată pentru analiza numerotării facturilor. Această verificare are rolul de a identifica eventuale necoerențe legate de serii, numere de factură sau numere de regim special.

La lansarea acestei opțiuni, aplicația analizează facturile și compară valorile propuse pentru serie și număr cu regulile și documentele existente în baza de date hMARFA.

Modul de verificare diferă în funcție de contextul din care este apelată funcția:

În urma verificării, utilizatorul poate identifica situații precum suprapuneri de numere, serii inexistente sau neconforme ori diferențe între numerotarea propusă și regulile interne. În cazul în care sunt identificate probleme, acestea pot fi corectate prin funcția Modificare serie și număr factură.

5g) Modificare serie și număr factură

Funcția este utilizată modificare serie și număr factură: