Cum citește Contaro un fișier SAGA
Procesul tehnic prin care fișierul XLS exportat din SAGA devine o balanță validată în câteva secunde.
SAGA exportă balanța de verificare ca fișier .xls cu o structură standardizată: 35 de coloane care acoperă codul contului, denumirea, categoriile, sold inițial, rulaje, total și sold final — atât pentru analitice cât și pentru sintetice. Iată cum transformăm acest fișier în date utilizabile.
Cele 35 de coloane SAGA
| # | Coloană | Descriere |
|---|---|---|
| 1 | cont | Codul contului (de ex. 401 sau 401.00026) |
| 2 | denumire | Numele descriptiv |
| 3 | categorie | Tipul (BS = bilanțier, PNL = profit/pierdere) |
| 4 | tip | A (activ), P (pasiv), B (bifuncțional) |
| 5–18 | sume per-analitic | sold inițial, rulaje, totaluri, sold final |
| 19–32 | sume sintetice | aceleași, dar agregate pe contul sintetic |
| 33 | analitic | TRUE/FALSE — e cont analitic? |
| 34–35 | metadata | validat (din SAGA), linie (nr. linie XLS) |
Procesul de import
- Parsing: folosim SheetJS pentru a citi fișierul fără să mai trecem prin Excel sau LibreOffice.
- Upsert conturi: pentru fiecare rând, dacă contul nu există în baza noastră pentru compania selectată, îl creăm. Dacă există, actualizăm numele și metadata (tipul, clasa, categoria — derivate din primele caractere ale codului).
- Crearea înregistrărilor: pentru fiecare linie din balanță, salvăm un
balance_sheet_entrycu toate cele 28 de valori (14 analitice + 14 sintetice). - Calcul totaluri: total debit și total credit la nivel de balanță, calculate doar din conturile sintetice (ca să nu dubluăm).
- Rulare validări: imediat după salvare, motorul de validare rulează cele 11 reguli sistem + orice reguli custom adăugate de organizație și salvează rezultatele.
Tot procesul, pentru o balanță medie de 200–500 linii, durează sub 5 secunde.
De ce nu modificați direct fișierul SAGA?
Pentru că balanța din SAGA e sursa de adevăr pentru contabil. Noi doar o citim, o validăm și generăm raportul către client. Niciodată nu scriem înapoi nimic în SAGA.
Ce dacă SAGA-ul exportă într-un format diferit?
Versiunile recente de SAGA folosesc același format — testat de noi de la SAGA Soft 12.0 până la prezent. Dacă întâlnești o variație, scrie-ne la suport@contaro.ro cu un sample anonimizat și adăugăm suport.