Files
solduri2roa/docs/plan_solduri2roa.md
Marius Mutu 15bb26ac15 Etapa 2: plan v3, rapoarte de cercetare si etalonul de regresie
Cercetare: ambele formate SAGA (VFP xls/xlsx si Firebird .FDB), cu dovezi
fisier:linie in docs/raport_sursa_saga_xlsx.md si raport_exporturi_saga_noua.md.

Plan v3 dupa review de strategie si arhitectura: contract intern + trei
cititoare, mapare in doua fisiere cu proprietari diferiti, lane-uri.

Etalon de regresie anonimizat in tests/golden/ (sume si structura neatinse,
zero IBAN si zero cod fiscal real). Tabela de corespondenta ramane ignorata.

Iesirile de productie ies din git (raman pe disc); .gitignore acopera si
copiile de baze de client si iesirile intermediare ale convertorului.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01EYeAtVxeS8m4oXekjX8Am2
2026-09-21 15:44:57 +03:00

71 lines
4.2 KiB
Markdown

# Plan: balante SAGA (PDF) -> xlsx de initializare ROA
Proiect: `D:\ROA\IMPORT2ROA\solduri2roa`
Obiectiv prioritar: doua fisiere xlsx gata de importat in ROACONT pentru FUNDATIA si MASTER, luna 12/2025.
Obiectiv secundar (pasul 2): program reutilizabil de conversie SAGA -> xlsx ROA.
Deciziile de mapare: `decizii_import.md`. Semantica formularului de import: `raport_form_init_balanta.md`.
## Etapa 1 - extragere fidela din PDF (lane `pdf-extract`)
`extract_balanta.py` (pdfplumber, pe coordonate) -> `balanta_FUNDATIA.csv`, `balanta_MASTERJOB.csv`
cu `cont;denumire;prec_d;prec_c;rulaj_d;rulaj_c;total_d;total_c;sold_d;sold_c;este_total`.
Poarta de trecere (nu se avanseaza cat timp pica):
- `total_d = prec_d + rulaj_d`, `total_c = prec_c + rulaj_c` pe fiecare cont
- `sold_d - sold_c = total_d - total_c` pe fiecare cont
- `SUM(sold_d) = SUM(sold_c)` pe conturile frunza
- suma analiticelor = parintele, pe fiecare nivel
Un esec = parser gresit, nu date gresite: se repara parserul, nu cifrele.
## Etapa 2 - semantica formularului (lane `form-init-balanta`)
Analiza `COMUN\ferestre\frm_initializare_facturi_balanta.sc2`: coloane obligatorii, validari
blocante, crearea partenerului dupa `cod_fiscal` (si daca respinge un "CUI" de forma `401.00027`),
regula `id_partd`/`id_partc`, lungimi `cont`/`acont`, rolul `CONFIG_CONT_IREG`.
Risc principal de oprit aici: o validare de CUI care refuza `401.00027`.
## Etapa 3 - conturile cu parteneri (lane `config-cont-ireg`)
`CONFIG_CONT_IREG` din Oracle local -> lista conturilor cu `CU_INREGISTRARI = 1`.
## Etapa 4 - maparea in structura ROA
Pentru fiecare firma, din CSV:
1. **Conturi fara parteneri**: se pastreaza doar frunzele. `cont` = primele max 4 caractere,
`acont` = restul cifrelor concatenate (max 4). Un rand `BALANTA` per frunza, cu
`totdeb = total_d`, `totcred = total_c`. Daca suma frunzelor difera de parinte -> analitic de
diferenta, raportat explicit.
2. **Conturi cu parteneri** (din etapa 3): un singur rand `BALANTA` pe sintetic (fara `acont`),
cu suma `total_d` / `total_c` a analiticelor, plus cate un rand `FACTURA` per analitic-partener:
`nume` = denumirea analiticului, `cod_fiscal` = `<cont>.<analitic>` din SAGA,
`numar` = analiticul, `sold` = soldul analiticului (cu semnul dat de natura contului),
`data` = 01.12.2025, `datascad` = 31.12.2025.
3. Toate randurile: `an = 2025`, `luna = 12`.
Iesire: `init_FUNDATIA_2025_12.xlsx`, `init_MASTER_2025_12.xlsx`, generate din sablonul
`init_facturi_balanta_note.xlsx` cu randurile de instructiuni sterse.
## Etapa 5 - verificare inainte de predare
- `SUM(totdeb) = SUM(totcred)` pe tot xlsx-ul
- pentru fiecare cont cu parteneri: `SUM(sold FACTURA) = soldul sintetic din balanta`
- fiecare cont din balanta apare exact o data (frunza) in xlsx; niciun cont pierdut
- `cont` <= 4 caractere, `acont` <= 4 caractere, fara dubluri `cont+acont`
Raport: `docs\verificare_<firma>.md`, cu totalurile din balanta alaturi de totalurile din xlsx.
## Etapa 5b - codurile fiscale reale ale partenerilor
Pasul e obligatoriu, nu optional: partenerii intra in xlsx cu cod fiscal provizoriu
(`<cont>.<analitic>` din SAGA) si trebuie corectati cu CUI-ul real.
1. Lista partenerilor fara CUI: `parteneri_de_cautat.md`.
2. Cautare pe demoanaf.ro (denumire -> CUI), rezultat in `parteneri_cui_gasite.md`.
3. Verificare TVA pe ANAF pentru fiecare CUI gasit (POST
`https://webservicesp.anaf.ro/api/PlatitorTvaRest/v9/tva`, campul `scpTVA`):
platitor de TVA -> cod fiscal cu prefix `RO`; neplatitor -> CUI fara prefix.
4. Scripturile de corectie, per schema: `sql/update_cod_fiscal_<SCHEMA>.sql` (neexecutate,
se ruleaza manual dupa import).
5. Partenerii negasiti raman cu codul provizoriu si se raporteaza explicit.
## Etapa 6 - git
`git init`, commit, push pe `gitea.romfast.ro:romfast/solduri2roa.git` (push-to-create).
Se comit: scripturile, `docs\`, CSV-urile si xlsx-urile generate. PDF-urile: da (sunt sursa, 30 KB).
## Pasul 2 (dupa import) - convertorul reutilizabil
Generalizarea etapelor 1 + 4 intr-un singur script cu parametri (firma, an, luna, sursa PDF sau
xlsx SAGA), cu regulile din `decizii_import.md` scoase intr-un fisier de configurare
(conturi cu parteneri, maparea analiticelor). Nu se porneste inainte ca cele doua importuri sa
fie validate in ROA.