sync SVN r17994: tipuri de documente facturare (semnificatia VANZARI.TIP)

docs/tipuri_documente_facturare.md

@@ -0,0 +1,118 @@
+# Tipurile de document din facturare (`VANZARI.TIP`) si seturile de contare (`ID_SET`)
+
+Referinta pentru toata suita ROA: `PACK_FACTURARE` e in `COMUN`, iar `VANZARI.TIP` e citit de
+view-urile `FACT_VFACTURI` / `FACT_VFACTURI2`, de gridul principal de listare si de retiparire.
+
+**Surse** (nu presupuneri):
+
+- perechile `(lnIdSet, tnTip)` — comentariul din antetul `PACK_FACTURARE` (`:80-125` in exportul
+  `all_source`), singurul loc care le documenteaza impreuna;
+- eticheta afisata — `CASE a.tip` din coloana `EXPLICATIE` a celor doua view-uri, citit din sursa
+  live de pe `MARIUSM_AUTO` (06.08.2026);
+- restul — cod, marcat ca atare.
+
+`ID_SET` e setul de formule contabile (`XSETS.ID_SET`, ajunge in `ACT.ID_SET`), pus in variabila de
+pachet `pack_facturare.nid_set` din `initializeaza_date_factura` (`:1864`). **Regula generala: setul
+"cu scadere din gestiune" e cel de baza + 10.**
+
+## Facturi
+
+| `ID_SET` | cu scadere | `TIP` | Document | `EXPLICATIE` afisat |
+|---|---|---|---|---|
+| 25000 | 25010 | 1 | pe baza de lista de preturi | `POLITICA PRETURI` |
+| 25001 | 25011 | 2 | pe baza de contracte | `CONTRACT` |
+| 25002 | 25012 | 3 | pe baza de comenzi | `COMANDA` |
+| 25003 | 25013 | 4 | pe baza de avize | `FACT. DIN AVIZ` |
+| 25004 | 25014 | 5 | lista de preturi in valuta | `POLITICA PRETURI - INVOICE` |
+| 25005 | 25015 | 6 | contract in valuta | `CONTRACT - VALUTA` |
+| 25006 | — | 7 | credit note | `CREDIT NOTE` |
+| 25007 | 25017 | 8 | retur factura in lei | `RETUR FACTURA IN LEI` |
+| 25008 | 25018 | 9 | retur factura in valuta | `RETUR INVOICE` |
+| 25009 | 25019 | 10 | factura fiscala in valuta | `POLITICA PRETURI - FACTURA VALUTA` |
+| 25042 | 25052 | 43 | bon fiscal (ROARETAIL, colectate de la magazine) | `BONURI FISCALE MAGAZINE` |
+| 25043 | — | 44 | factura hotel | `HOTEL` |
+| 25044 | 25054 | 45 | factura restaurant | `RESTAURANT` |
+| 25045 | 25055 | **46** | **nota de plata restaurant** | **nicio ramura** |
+| 25047 | 25057 | 48 | factura marfa custodie **cu** descarcare K | `FACT. CUSTODIE CU DESCARCARE PE BAZA DE K` |
+| 25048 | 25058 | 49 | factura marfa custodie **fara** descarcare K | `FACT. CUSTODIE FARA DESCARCARE PE BAZA DE K` |
+| 25051 | 25061 | 52 | pe baza de contract, factura fiscala in valuta | `CONTRACT - FACTURA VALUTA` |
+| 50100 | 25060 | 51 | factura ROAACNPRO | `COMERCIAL-FACTURARE` |
+
+## Avize de expeditie
+
+| `ID_SET` | cu scadere | `TIP` | Document | `EXPLICATIE` afisat |
+|---|---|---|---|---|
+| 25020 | 25030 | 21 | catre clienti, **din comanda** | `AVIZ PE BAZA DE COMANDA` |
+| 25021 | 25031 | 22 | catre clienti, din lista de preturi | `AVIZ DIN POLITICA DE PRETURI` |
+| 25022 | 25032 | 23 | transfer catre subunitati, din lista | `TRANSFER` |
+| 25023 | 25033 | 24 | aviz de retur | `AVIZ DE RETUR` |
+| 25024 | 25034 | 25 | transfer catre subunitati, **din comanda** | `TRANSFER PE BAZA DE COMANDA` |
+| 25025 | 25035 | 26 | catre clienti, din contract | `AVIZ PE BAZA DE CONTRACT` |
+| 25026 | 25036 | 27 | transfer catre subunitati, **pe baza de lucrare** | `TRANSFER PE BAZA DE LUCRARE` |
+| 25027 | 25037 | 28 | catre clienti debitori, **din comanda** | `CLIENTI DEBITORI - COMANDA` |
+| 25028 | 25038 | 29 | catre clienti debitori, din lista | `CLIENTI DEBITORI - POLITICA PRETURI` |
+| 25029 | 25039 | 30 | transfer catre subunitati, pe baza de NIR | `AVIZ PE BAZA DE NIR` |
+| 25040 | 25050 | 41 | retur transfer catre subunitati, lista de pret | `RETUR TRANSFER` |
+| 25041 | 25051 | 42 | catre clienti **custodie, din comanda** | `CLIENTI IN CUSTODIE - COMANDA` |
+| 25046 | 25056 | **47** | catre clienti **custodie, din comanda, pentru descarcare cu K** | `CLIENTI IN CUSTODIE - COMANDA (K)` |
+| 25049 | 25059 | 50 | *in lucru* — retur de la clienti custodie | nicio ramura |
+
+## Tipuri negative
+
+Nu apar in comentariul din pachet; luate din `CASE`-ul `EXPLICATIE`. Vin din alte produse sau din
+fluxuri valorice.
+
+| `TIP` | `EXPLICATIE` afisat | Observatii |
+|---|---|---|
+| -1 | `MATERII PRIME SI MATERIALE` | |
+| -2 | `PRODUSE` | |
+| -3 | `MARFURI LA PRET DE ACHIZITIE` | |
+| -4 | `MARFURI LA PRET DE VANZARE` | |
+| -6 | `RETUR TRANSFER DIN GESTIUNE VALORICA` | ROAGEST; `ID_SET` 236/240/241/242 |
+| -7 | `AVIZ DE RETUR - VALORIC` | |
+| -8 | `FACTURA DE RETUR - VALORICA` | |
+| -9 | `PROTOCOL CU TVA - AVIZ EXPEDITIE` | |
+| -10 | `SPONSORIZARE - AVIZ EXPEDITIE` | |
+| -11 | `MARFURI LA PRET DE ACHIZITIE *` | |
+| -12 | `DEVIZE AUTO` | **ROAAUTO**, `factureaza_deviz` din `oproceduri_devize.prg` |
+| -13 | `RETUR MARFA IN CUSTODIE` | |
+
+## Seturile de tipuri folosite in cod (unde conteaza incadrarea)
+
+| Set | Unde | Ce face |
+|---|---|---|
+| `{3, 21, 28, 42, 47}` | `initializeaza_date_factura` (`:1888-1894`) | populeaza `pack_facturare.nid_comanda` din `clistaid` |
+| `+ {27}` | `scrie_avize_lucrare:5859` | suprascrie `nid_comanda` prin cursor pe `COMENZI` legat de `ID_LUCRARE` |
+| `{3, 21, 27, 28, 42, 46}` | `ALTELE` in ambele view-uri | afiseaza **comanda** (`nr_comanda/data`) |
+| `{4, 24, 8, 9}` | `ALTELE` in ambele view-uri | afiseaza **avizul** |
+| `{23, 25, 27, 30, 41, -6}` | `CLIENT` in ambele view-uri | afiseaza gestiunea, nu partenerul |
+| `{23, 25, 27, 30, 41}` si `-6` | `scrie_in_vanzari` (disc `:13530-13540`) | `lnIdGestiune` explicit, nu `min()` din detalii |
+
+## Capcane confirmate
+
+1. **`46` vs `47` in `ALTELE`.** Lista din view contine `46` (nota de plata restaurant, document
+   care n-are comanda) si **nu contine** `47` (aviz custodie din comanda, care are). Pachetul
+   populeaza `nid_comanda` pentru `47`, nu pentru `46`. `CASE`-ul `EXPLICATIE` din acelasi view are
+   ramura pentru `47` si **nu** are pentru `46` — deci cele doua `CASE`-uri din acelasi view se
+   contrazic pe aceste doua cifre. Decizia lui Marius (06.08.2026): **se adauga `47`, `46` ramane
+   asa cum a fost scris.**
+2. **Efect vizibil pe `46`, azi**: ramura fiind luata fara ca documentul sa aiba comanda,
+   `f.nr_comanda || '/' || to_char(f.data_comanda, ...)` da un **`/`** singur in coloana "Altele",
+   nu gol. Nu s-a observat pe date pentru ca niciun client verificat nu foloseste modulul de
+   restaurant (0 documente `tip=46` si pe `MARIUSM_AUTO`, si pe `VENDING`).
+3. **`ID_SET` 25051 apare de doua ori** in comentariul din pachet: ca set "cu scadere" pentru
+   `tip=42` si ca set de baza pentru `tip=52`. Coliziune in documentatie, neverificata pe
+   `XSETS` — de lamurit inainte de a te baza pe ea.
+4. **`tip=51`**: comentariul spune "factura ROAACNPRO", eticheta afisata e `COMERCIAL-FACTURARE`.
+   Acelasi lucru, doua denumiri; eticheta din view e cea confirmata de constantele VFP curente
+   (`ofacturare_comun.vc2:3654,3657`).
+5. **`tip=50`** e marcat "in lucru" in comentariu si n-are ramura de eticheta — de tratat ca
+   neterminat, nu ca tip valid.
+6. **Comentariul nu e cod.** E singura documentare a perechilor `(ID_SET, TIP)`, dar poate fi ramas
+   in urma. Inainte de a te baza pe o linie din el pentru o modificare, confirm-o pe cod
+   (`initializeaza_date_factura`, `CASE`-urile din view-uri) sau pe `XSETS`.
+
+## Legaturi
+
+- `scripturi-migrare-db.md` — sursa de referinta pentru DDL e `MARIUSM_AUTO`, nu o schema de client.
+- `conventie_null_vfp.md` — `TIP_INCASARE` si celelalte coloane `0` vs `NULL` din view-uri.