Cum functioneaza mapping-ul automat de coloane

La importul de date, SoftFactura analizează automat header-ul fișierului (prima linie cu numele coloanelor) și încearcă să potriveasca fiecare coloana cu câmpul corespunzător din sistem. Acest proces se numeste mapping și funcționează în trei etape.

Etapa 1: Normalizare header-uri

Înainte de potrivire, fiecare nume de coloana este normalizat:

Se converteste la litere mici.
Se elimină diacriticile (a, i, s, t devin a, i, s, t).
Se elimină caracterele non-alfanumerice (spatii, puncte, cratime).

Exemplu: „Nume Client" → numeclient, „Cod Fiscal" → codfiscal, „U.M." → um.

Etapa 2: Potrivire cu fingerprints

Fiecare platforma suportata (SmartBill, Oblio, Facturis, FGO) are definite fingerprints — seturi de coloane caracteristice:

Coloane obligatorii — trebuie să existe toate pentru ca detectarea să fie pozitiva.
Coloane optionale — cresc scorul de incredere dacă exista.
Pattern-uri de fișier — numele fișierului poate contribui la detectare (ex: fișierele de stocuri SmartBill, Oblio sau Facturis contin „stoc" în nume).

Scorul de incredere variaza între 0 și 1:

Peste 0.7 — detectare sigură, platforma și tipul de date sunt afișate automat.
0.5 - 0.7 — detectare probabila, ti se cere confirmare.
Sub 0.5 — detectare incerta, trebuie să specifici manual.

Etapa 3: Mapping individual al coloanelor

După identificarea platformei și a tipului de date, fiecare coloana din fișier este mapata la câmpul SoftFactura corespunzător. Sistemul încearcă mai multe variante de denumire:

Exemplu pentru câmpul „CUI": Se caută în ordine: CUI, CIF, Cod Fiscal, Cod fiscal, cod_fiscal, codfiscal.

Dacă o coloana nu poate fi mapata automat, rămâne nemapata și poți să o asociezi manual din dropdown.

Ajustare manuala

După detectarea automată, SoftFactura afișează un ecran de preview cu:

Fiecare coloana din fișier și câmpul SoftFactura la care este mapata.
Dropdown pe fiecare coloana pentru a schimba mapping-ul.
Opțiunea „Ignoră" pentru a exclude o coloana din import.

Modificările se fac înainte de a confirma importul — datele nu sunt procesate pana nu apesi Importă.

Dacă importi frecvent fișiere cu aceeași structura (de exemplu, export-uri lunare din aceeași platforma), mapping-ul este aplicat automat fără să fie nevoie de ajustari — structura este recunoscuta din prima.

Fallback: import generic

Dacă fișierul nu este recunoscut ca apartinand unei platforme suportate:

SoftFactura propune import generic CSV/Excel.
Ti se cere să specifici tipul de date (clienti, furnizori, produse).
Se afișează ecranul de mapping manual — alegi pentru fiecare coloana câmpul corespunzător.

Această metoda funcționează cu orice fișier CSV sau Excel, indiferent de sursa.

Tratarea valorilor speciale

Valori goale — sunt importate ca null (camp gol în SoftFactura).
Numere cu virgula — 1.234,56 și 1234.56 sunt ambele recunoscute.
Date calendaristice — se încearcă DD.MM.YYYY, DD/MM/YYYY, YYYY-MM-DD și format Excel serial.
CUI cu prefix RO — prefixul este eliminat automat, pastrand doar cifrele.