roafacturare/docs/cercetare/proforma_copiere_puncte_intrare.md

# Cercetare — proforma, copiere document, puncte de intrare comanda/contract

Investigatie read-only, 09.08.2026. Nicio modificare de cod. Vezi si `docs\plan_13_unificare_formular_facturare.md`
si `docs\handoff_13_formular_unificat.md` (sesiune paralela, activa la data cercetarii — nu s-a atins
`COMUN\clase\ofacturare_comun.vc2` si nici `COMUN\programe\ofacturare_editare.prg`, marcate acolo ca "in lucru").

## 1. Proforma

**Concluzie.** Proforma nu e un tip de document separat (`poDate.tip` ramane 1-52, ca la orice
factura), ci un **atribut de numerotare/serie** (`poDate.nIdTipDoc = 23`, fata de `5` = FACTURA).
Se seteaza dintr-un combo "Tip document" (FACTURA/PROFORMA/BON FISCAL) aflat direct pe formularul
de antet unificat `frm_date_factura` — **acelasi formular** folosit si pentru facturi normale, fara
formular separat. Combo-ul e vizibil doar cand `frm_date_factura` e instantiat, adica doar pentru
tipuri de "factura" (nu si pentru avize, care merg pe `frm_date_aviz`, fara acest combo).
Nu exista un buton/meniu dedicat "Proforma noua": utilizatorul apeleaza fluxul normal de facturare
(`factureaza(tnTip)`) si comuta manual pe PROFORMA in antet.

**Dovezi:**
- `COMUN\programe\ofacturare_comun.prg:593-599` — setter-ul care leaga `nIdTipDoc` de `eProforma`:
  `This.eProforma = IIF(m.tnIdTipDoc = This.nIdTipDocProforma, 1, 0)` (`nIdTipDocProforma = 23`,
  `COMUN\programe\ofacturare_comun.prg:104`).
- `COMUN\clase\ofacturare.vc2:9396-9403` — `frm_date_factura.do_schimba_tipdoc`:
  `lcTipDoc = UPPER(this.ct_clb_fdoc._combobox1.Value)` → mapare FACTURA/PROFORMA/BON FISCAL/AVIZ
  la `nIdTipDoc`.
- `COMUN\clase\ofacturare.vc2:8745-8754` — combo-ul: `RowSource = "FACTURA,PROFORMA,BON FISCAL"`,
  `Value = FACTURA` (implicit). Owner confirmat cu `vfp_symbols.ps1 -Where`:
  `frm_date_factura  [class]  ofacturare.vc2:8482-9869`.
- `COMUN\clase\ofacturare.vc2:9415,9427-9428` — la schimbarea tipului: `initializeaza_setari_document(-102)`
  pentru proforma, `poGeneratorNumere.dezaloca_numar(...)` + `creeaza_cursor_serii(poDate.nIdTipDoc)` —
  **serie/numar propriu**, realocat la comutare.
- `COMUN\programe\ofacturare.prg:81-196` — `factureaza(tnTip, toFactura)`: la creare, `poDate.nIdTipDoc`
  se seteaza explicit la `5` (FACTURA) sau `6` (AVIZ) dupa `tnTip` (`:187-196`); PROFORMA (23) nu
  apare niciodata aici — se ajunge la ea **doar** din interactiunea cu combo-ul din antet.
- **Fara note contabile pe proforma**: `COMUN\programe\ofacturare.prg:1960,1996,2052,2063,2103` —
  blocurile de scriere/actualizare nota contabila si atasamente sunt garzduite cu
  `poDate.eProforma = 0`.
- **Continut specific de raport**: `COMUN\programe\ofacturare.prg:1119` (`Case poDate.eProforma = 1`)
  ramifica pe un SQL de antet propriu (parteneri/adresa facturare) pentru listare; `:1638-1643`
  (`Case ... And poDate.eProforma = 1` → `lcRaport = [PROFORMA]`) alege formularul `.fr2` dedicat
  (`COMUN\Rapoarte\proforma.fr2`, `proforma_orig.fr2`, `proforma_val.fr2`).
- **Transformare in factura = copiere**: tooltip explicit,
  `COMUN\clase\ofacturare_comun.vc2:1409`: *"Copiere (CTRL+K) * Se foloseste si pentru generarea
  unei facturi din proforma prin copiere"*. Mecanismul: la copiere (`completeaza_setari_document`,
  vezi §2) linia care ar propaga `nIdTipDoc` de la documentul sursa e **comentata**
  (`COMUN\programe\ofacturare_comun.prg:370`: `*.nIdTipDoc = toDateAnterior.nIdTipDoc`), deci noul
  document porneste implicit la `nIdTipDoc=5` (FACTURA) indiferent ca sursa era proforma — functioneaza,
  dar prin omisiune, nu printr-o ramura dedicata "proforma → factura".
- **Relistare proforma**: cale separata de `factureaza`, in gridul de facturi:
  `COMUN\clase\ofacturare_comun.vc2:7230-7264` (`PROCEDURE do_listare`, alt context decat
  `frm_facturi.do_listare`) — filtreaza `crsFacturi` dupa `id_proforma=`, forteaza
  `poDate.eProforma = 1` si `poDate.nRelistare = 1` (`:7258-7260`).
- Referinta tipuri: `COMUN\docs\tipuri_documente_facturare.md` — confirma ca `TIP` (1-52) e ortogonal
  fata de proforma; niciun rand din tabel nu e "proforma" ca atare.

**Ce e specific proformei, confirmat cu dovada:**
1. Serie/numar propriu (`nIdTipDoc=23`, realocare la comutare din combo).
2. Fara scriere de nota contabila / atasamente (gate `eProforma=0` in `ofacturare.prg`).
3. Raport de listare propriu (`.fr2` dedicate).
4. "Transformare in factura" = copiere obisnuita, care scapa tipul de document proforma pentru ca
   linia de propagare e comentata (efect secundar, nu design explicit).

**Nu am putut confirma cu dovada** (vezi "Necunoscute ramase"): daca descarcarea de gestiune e
efectiv sarita pentru proforma la nivel de Oracle (`PACK_FACTURARE`, sursa nu e in cache text local).

## 2. Copierea documentului

**Concluzie.** Traseul e `frm_facturi.But_copiaza1.Click` → `do_copiaza` (degradeaza tipul) →
`copiere_factura` → `factureaza(tip_degradat, toFactura)` → `frm_date_factura` cu antetul
pre-completat din `completeaza_setari_document(toFactura, .T.)`. Se aloca **intotdeauna** numar nou
(alocarea de serie ruleaza neconditionat in `factureaza`, indiferent de `llCopiere`). Campurile de
antet raman editabile (nimic din traseu seteaza `Enabled=.F.` pe controale de antet la copiere);
singurul efect vizibil e relabelarea campului "Altele" in "Nr. factura" cand tipul degradat e
1/5/10/48/49 sau 48/49 sub `gnScadereStoc=0`.

**Dovezi:**
- `COMUN\clase\ofacturare_comun.vc2:3628-3713` — `do_copiaza`: degradeaza tipul (tabelul deja
  cunoscut, ex. `T2/T3/T4/T8/... → T1`, `:3696-3710`), apoi `DO copiere_factura WITH loFactura IN
  oproceduri_facturare.prg` (`:3710`).
  **Bug observat, nu cerut de investigat**: ramura `CASE INLIST(loFactura.tip,T21,T24,T26,T30,...)`
  (`:3702-3703`) scrie `lnTip = T22` in loc de `loFactura.tip = T22` — variabila gresita, degradarea
  nu se aplica efectiv pe aceasta ramura (avize catre clienti din comanda/contract/retur etc.).
- `COMUN\programe\oproceduri_facturare.prg:150-153` — `copiere_factura`: `factureaza(toFactura.Tip,
  toFactura)`.
- `COMUN\programe\ofacturare.prg:111` — `llCopiere = (Type('toFactura') = 'O')`;
  `:203-206` — `If m.llCopiere: poDate.completeaza_setari_document(m.toFactura, .T.)`.
- `COMUN\programe\ofacturare_comun.prg:362-412` — `completeaza_setari_document(toDateAnterior,
  tlFactura)`: ramura `tlFactura=.T.` (copiere) seteaza `.lCopiere=.T.` si precompleteaza
  lucrare/sectie/agent/delegat/masina/`listaid = toDateAnterior.id_vanzare`/`descriere`
  (serie+numar sursa)/client (`:368-390`); **nu** propaga `nIdTipDoc`, `id_responsabil`,
  `id_venchelt` (comentate, `:370,373,377`).
- **Numar nou, mereu**: `COMUN\programe\ofacturare.prg:208,211` — `poGeneratorNumere.ResetNumere()`
  + `poDate.rezultat_serii = poGeneratorNumere.creeaza_cursor_serii(poDate.nIdTipDoc)` ruleaza in
  bucla principala a lui `factureaza`, inainte de a deschide formularul, **neconditionat de
  `llCopiere`**. Functia: `COMUN\programe\oserii_numere.prg:128-177` (`Function
  creeaza_cursor_serii`).
- **Relabel antet la copiere**: `COMUN\clase\ofacturare.vc2:9622-9628,9652-9658` —
  `IF m.llCopiere: .ct_clb_altele.do_schimba_explicatia([Nr. factura])` (altfel campul e eliminat
  din formular pentru acele tipuri).
- **Reutilizabil vs specific degradarii**: reutilizabil = `copiere_factura`/`factureaza(tip,
  toFactura)`/`completeaza_setari_document` (mecanismul general de copiere, indiferent de tip);
  strict legat de degradare = tabelul `#DEFINE T.../DO CASE` din `do_copiaza` (`:3629-3708`) — acolo
  se decide explicit "ce tip devine ce tip la copiere", nimic din asta nu se refoloseste in afara
  acestei metode.

## 3. Punctele de intrare "factura din comanda" / "factura din contract"

**Concluzie.** Ambele exista deja, **cu precompletare reala**, dar pe cai diferite:
- **Contract**: azi precompletarea vine **din ROACONTRACTE** (produs separat), nu din ROAFACTURARE.
  Butonul "Factura" de pe gridul de contracte populeaza globalul `goContract` din randul selectat si
  cheama acelasi `factureaza(2/6/52)` din COMUN.
- **Comanda**: exista deja un buton de facturare **direct in ROAFACTURARE**, pe tab-ul Comenzi
  (`Page5.Ct_comenzi1`), care populeaza `goComanda` din randul de grid selectat inainte de a chema
  `factureaza(3)` — deci raspunsul la "exista deja un buton?" e **da**, nu ipotetic.
- Exista si o cale **generica, nepre-completata**, in meniul principal al ROAFACTURARE
  (`Clase\ofundal_facturare.vc2`, tab Page2): pentru contract nu atinge `goContract`; pentru comanda
  **reseteaza explicit** `goComanda = ''` inainte de apel — utilizatorul alege manual din formular.

**Semnatura `factureaza`:**
```
COMUN\programe\ofacturare.prg:81-82
Procedure factureaza
	Lparameters tnTip, toFactura
```
`tnTip` = tipul de business (1-52, tabelul din `tipuri_documente_facturare.md`); `toFactura` = obiect
opational, folosit azi **doar** pentru copiere factura/aviz (nu pentru contract/comanda). Nu exista
parametru dedicat pentru "contract precompletat" sau "comanda precompletata" — canalul e globalul
`goContract`/`goComanda`, citit in `oDateFactura.Init`.

**Dovezi — mecanismul comun (globale citite la creare `poDate`):**
- `COMUN\programe\ofacturare_comun.prg:261-297` — `Init`, ramura
  `If INLIST(m.tnTip, 2, 6, 52) And Type('goContract') <> 'U'` → `.id_client = goContract.id_part`,
  `.listaid = goContract.id_ctr`, `.descriere = goContract.contract`, plus interogare
  `fact_vcontracte` pentru scadenta (`:274-296`).
- `COMUN\programe\ofacturare_comun.prg:301-328` — ramura
  `If tnTip = 3 And Type('goComanda') = 'O'` → `.id_client = goComanda.id_part`,
  `.listaid = goComanda.id_comanda`, `.descriere = goComanda.nr_comanda`, plus interogare sectie
  (`:312-323`).

**Dovezi — contract, din ROACONTRACTE:**
- `D:\ROA\ROACONTRACTE\Clase\ferestre_contracte.vc2:1605` — `grid_contracte.AfterRowColChange`:
  `SCATTER NAME goContract MEMO` la fiecare schimbare de rand selectat.
- `D:\ROA\ROACONTRACTE\Clase\ferestre_contracte.vc2:1538-1549` — `but_factura.Click`: meniu
  "Factura lei;Invoice;Factura fiscala in valuta" → `DO facturare_contracte WITH 'FACTURA LEI'/...
  IN oproceduri_facturare.prg` (copia locala din `ROACONTRACTE\COMUN`, acelasi cod ca in
  ROAFACTURARE).
- `COMUN\programe\oproceduri_facturare.prg:118-136` — `facturare_contracte(tcTip)` →
  `factureaza(2)` / `factureaza(6)` / `factureaza(52)`.
- **Cale generica, fara precompletare**, in ROAFACTURARE insusi:
  `Clase\ofundal_facturare.vc2:886-897` (`Page2.Cw2.do_actiune`) — acelasi meniu, aceeasi
  `facturare_contracte`, dar **nu** atinge `goContract` inainte — daca globalul nu a fost populat
  in sesiune (`Type('goContract') = 'U'`), ramura de precompletare din `Init` nu se activeaza si
  userul alege contractul manual din `frm_date_factura.do_cauta_contract`
  (`COMUN\clase\ofacturare.vc2:9067-9115`, deja cunoscut din context).

**Dovezi — comanda, buton deja existent in ROAFACTURARE:**
- `COMUN\clase\ocomenzi.vc2:1580-1596` — `ct_comenzi.do_factura`:
  `SELECT crsComenzi` → `SCATTER NAME goComanda MEMO` → `DO facturare_comenzi IN
  oproceduri_facturare.prg` → `this.do_cauta()`.
- `COMUN\clase\ocomenzi.vc2:932-937` — butonul: `ADD OBJECT 'But_factura1' AS but_factura`, clasa
  de baza `COMUN\clase\cmd_butoane.vc2:96-107` (`DEFINE CLASS but_factura ... caction = do_factura`,
  `ToolTipText = "Factura"`, `Picture = factura1.bmp`).
  Vizibilitate conditionata de starea comenzii: `COMUN\clase\ocomenzi.vc2:2199-2203`
  (`grid_comenzi...`) — `this.Parent.but_factura1.Visible = (goComanda.facturat = 0)` (ascuns daca
  deja facturata).
- **Montare in ROAFACTURARE**: `Clase\ofundal_facturare.vc2:604` — `ADD OBJECT 'Page5.Ct_comenzi1'
  AS ct_comenzi`; `Ferestre\fundal.sc2:206` — `Page5.Ct_comenzi1.But_factura1.Name = "But_factura1"`
  confirma montarea concreta pe formular (nu doar in clasa sursa).
- `COMUN\programe\oproceduri_facturare.prg:138-141` — `facturare_comenzi` → `factureaza(3)`.
- **Cale generica, fara precompletare**: `Clase\ofundal_facturare.vc2:899-902`
  (`Page2.Cw3.do_actiune`): `goComanda = ''` apoi `DO facturare_comenzi ...` — reseteaza explicit
  globalul inainte de apel, deci userul alege comanda manual in formular.

**Concluzie combinata pentru "gazda naturala"**: pentru comanda, gazda exista deja
(`COMUN\clase\ocomenzi.vc2`, buton `But_factura1`, montat in `Clase\ofundal_facturare.vc2` Page5).
Pentru contract, gazda echivalenta **nu exista in ROAFACTURARE** — traieste azi doar in
`ROACONTRACTE\Clase\ferestre_contracte.vc2`; daca s-ar dori acelasi tipar in ROAFACTURARE, ar trebui
fie o pagina de contracte proprie (subiectul planului `docs\plan_10_integrare_contracte.md`, azi
"propunere, neinceput", cu decizie go/no-go in asteptare), fie un buton similar montat direct pe o
lista de contracte inexistenta azi in acest produs.

## Necunoscute ramase

1. **Descarcare de gestiune pe proforma**: n-am putut confirma/infirma daca `PACK_FACTURARE`
   (server-side Oracle) sare efectiv descarcarea de stoc pentru documente cu `nIdTipDoc=23`. Sursa
   pachetului nu e in cache text local (`COMUN\docs\PACK_FACTURARE.pck` nu exista; doar
   `PACK_CONTAFIN.pck`, `PACK_UPDATE.pck` etc.). Comentariul din `ofacturare.prg:52` ("daca este
   proforma, pun toate articolele negestionabile, ca sa nu mai arate stocul") sugereaza ca partea
   VFP trateaza stocul doar vizual, nu ca dovada asupra scrierii server-side.
2. **Campuri de antet blocate la copiere**: am confirmat ca traseul de copiere nu seteaza explicit
   `Enabled=.F.` pe controale de antet (nimic gasit in `frm_date_factura` pentru `llCopiere`), dar
   nu am verificat exhaustiv fiecare control individual — doar relabelarea campului "Altele".
   Tratati ca "probabil toate editabile", nu ca fapt verificat camp-cu-camp.
3. **Bug-ul din `do_copiaza` (`:3702-3703`, `lnTip` in loc de `loFactura.tip`)** e raportat ca
   dovada gasita in timpul cercetarii, nu ca urmare a unei cereri explicite de audit — nu a fost
   verificat efectul lui in productie (date de test).
4. **ROACONTRACTE nu are cod la fel de detaliat verificat ca ROAFACTURARE**: desi are cache text
   (203 fisiere `.vc2/.sc2`, contrar notei mai vechi din `plan_10_integrare_contracte.md` care spunea
   ca nu exista), nu am facut o trecere completa a formularului de contracte — doar traseul minim
   pentru `but_factura.Click`.