Gestione Veicoli — Ciclo commerciale Bercar¶
Area funzionale: Magazzino / Gestione Veicoli (Bercar) Programmi documentati: 21 | Righe totali analizzate: ~33.400
Indice¶
- Anagrafica e contratti
- Ciclo commerciale (proposte e ordini)
- Fatturazione
- Comunicazioni ACI
- Utility di controllo
- Flusso integrato
- File principali
- Tabella riepilogativa
1. Anagrafica e contratti¶
COGX15 — Anagrafica veicoli (scheda auto)¶
File: /programmi/eurocoge/cbl/cogx15.cbl (3.601 righe)
Programma di gestione dell'anagrafica veicoli. Consente inserimento, modifica e visualizzazione dei dati tecnici e commerciali: targa, marca, modello, colore, telaio, KW, data immatricolazione, km, valori commerciali (Eurotax). Interfaccia multi-pagina. I veicoli sono modellati come "merci" nell'ERP tramite il ponte cogracmt (targa → codice merce).
Logica: 1. Accept/ricerca veicolo per targa o codice merce 2. Lettura da bcveicol (anagrafica) e cogracmt (ponte targa-merce) 3. Visualizzazione multi-pagina dei dati 4. Inserimento/modifica dati tecnici e commerciali 5. Salvataggio su bcveicol 6. Gestione collegamento targa-merce su cogracmt
File: bcveicol (bca-), cogracmt (rtm-), COGMERCI (mer-), COGGEANA (ana-), COGTABEL (euta-). CALL: COGS65W, COGU10W, GRIDADMN.
COGX18 — Contratti di vendita veicolo¶
File: /programmi/eurocoge/cbl/cogx18.cbl (2.888 righe)
Gestione dei contratti di vendita veicolo: inserimento dati contrattuali (acquirente, prezzo, condizioni, leasing, permuta), stampa contratto con layout professionale. Gestisce descrizioni lunghe tramite file LOD.
Logica: 1. Accept/ricerca veicolo 2. Lettura dati veicolo da bcveicol e movimenti da bcmovim 3. Accept dati contrattuali: acquirente, prezzo, leasing, permuta 4. Lettura/scrittura descrizioni lunghe LOD 5. Scrittura/aggiornamento record su bccontra 6. Stampa contratto tramite COGS54 e PUTLOGO
File: bccontra (bcc-), bcmovim (bcm-), bcveicol (bca-), cogracmt (rtm-), COGGEANA (ana-), COGTABEL (euta-), lodtmdes, lodtrdes. CALL: COGS54, COGS65W, COGU10W, COGV75, COGZDEW, PUTLOGO.
COGX24 — Cruscotto vetture assegnate/disponibili¶
File: /programmi/eurocoge/cbl/cogx24.cbl (3.062 righe)
Cruscotto centrale di visualizzazione e gestione delle vetture nel ciclo commerciale. Opera in due modalita': "A" (assegnate a clienti) e "V" (disponibili in stock). Griglia con dati vettura (modello, colore, targa, telaio, immatricolazione, valori commerciali). Punto di accesso per tutte le operazioni sulle vetture.
Logica: 1. Ricezione parametro tipo (A/V) 2. Caricamento vetture da bcvettur filtrate per tipo 3. Griglia paginata con ordinamento configurabile 4. F3 = modifica dettaglio (→ COGX25 per assegnate, COGX29 per disponibili) 5. Ctrl+A = inserimento nuova vettura 6. Ctrl+E = eliminazione 7. Invio = selezione/deselezione per operazioni batch 8. F7 = scheda auto (COGX15) o stampa contratto (COGX18) 9. F8 = genera proposta (COGX26) 10. F9 = stampa elenco (COGS54) 11. S-F7 = genera assegnata da disponibile
File: bcvettur (bvt-), bcveicol (bca-), cogracmt (rtm-), COGTABEL (euta-), COGGEANA (ana-). CALL: COGX25, COGX29, COGX15, COGX18, COGX26, COGS54, GRIDADMN, COGU10W.
COGX25 — Dettaglio vettura assegnata¶
File: /programmi/eurocoge/cbl/cogx25.cbl (1.956 righe)
Gestione dettaglio di una singola vettura assegnata (tipo "A"). Accept multi-pagina: marca, modello, colore, targa, telaio, km, immatricolazione, leasing, valori commerciali (eurotax, accettazione, spese, danni, deprezzamento, riscatto, sconto, netto, prezzo calcolato/finale con IVA). Opera su bcvettur.
File: bcvettur (bvt-), bcveicol (bca-), cogracmt (rtm-), COGTABEL (euta-), COGGEANA (ana-). CALL: nessuna significativa (modulo terminale, chiamato da COGX24).
COGX29 — Dettaglio vettura disponibile¶
File: /programmi/eurocoge/cbl/cogx29.cbl (1.286 righe)
Gestione dettaglio di una singola vettura disponibile (tipo "V"). Analogo a COGX25 ma per vetture in stock. Dati: tipo IVA, valori commerciali, immatricolazione, km. Opera su bcvettur con tipo "V".
File: bcvettur (bvt-), bcveicol (bca-), cogracmt (rtm-), COGTABEL (euta-). CALL: nessuna significativa (modulo terminale, chiamato da COGX24).
2. Ciclo commerciale (proposte e ordini)¶
COGX33 — Assegnazione vettura venduta (ORCHESTRATORE)¶
File: /programmi/eurocoge/cbl/cogx33.cbl (867 righe)
Orchestratore del flusso commerciale veicoli. Gestisce il processo completo dalla selezione della vettura alla generazione di proposta e ordine. L'operatore seleziona una vettura (per matricola o targa), indica cliente e data. Il programma orchestra: (a) creazione proposta tramite COGX26, (b) generazione ordine tramite COGX30, (c) stampa proposta (COGX27) e ordine (COGX31).
Logica: 1. Accept matricola o targa veicolo 2. F8 = richiamo COGX24 per selezione visuale 3. Validazione: esistenza vettura su bcvettur, controllo stato amministrativo 4. Accept cliente (COGS65W) e data; se cod. 99999, COGX35 per dati provvisori 5. Conferma operazione 6. CALL COGX26 "I": crea proposta commerciale 7. Se proposta OK, CALL COGX30 "I": crea ordine da proposta 8. Dialogo finale: Esc (esci), F8 (stampa proposta → COGX27), F9 (stampa ordine → COGX31)
File: bcvettur (bvt-), COGGEANA (ana-), COGTABEL (euta-). CALL: COGX24, COGX26, COGX27, COGX30, COGX31, COGX35, COGS65W, DIALOGS.
COGX26 — Gestione proposte commerciali¶
File: /programmi/eurocoge/cbl/cogx26.cbl (4.758 righe)
Programma piu' complesso dell'area: gestisce l'intero ciclo delle proposte commerciali. Inserimento proposta (selezione vetture e cliente), modifica, stampa, trasformazione in ordine. Supporta clienti codificati e non codificati (provvisori, codice 99999). Griglia con 5 colonne di valore (danni, deprezzamento, riscatto, prezzo finale, jolly).
Logica: 1. Dialogo iniziale: F5 (nuova proposta) o F9 (visualizza/modifica) 2. Inserimento: accept anno, data, cliente; se 99999 → COGX35 3. Selezione vetture dalla lista assegnate (COGX24 in modalita' selezione) 4. Griglia con 5 colonne valore configurabili 5. Modifica: ricerca proposta per anno/numero tramite F9 (COGX28) 6. Stampa proposta tramite COGX27 7. Salvataggio su bctespro (testata) e bcrigpro (righe)
File: bctespro (btp-), bcrigpro (brp-), bcvettur (bvt-), COGTABEL (euta-), COGGEANA (ana-). CALL: COGX24, COGX27, COGX28, COGX35, DIALOGS, COGS65W, GRIDADMN.
COGX27 — Stampa proposte commerciali¶
File: /programmi/eurocoge/cbl/cogx27.cbl (1.336 righe)
Stampa/ristampa delle proposte commerciali. Layout professionale con emulazione laser (HPLJ3): intestazione cliente, elenco vetture con valori, totali per colonna. PUTLOGO per logotipo aziendale.
Logica: 1. Ricezione parametri (anno, numero proposta) o accept interattivo 2. Lettura testata da bctespro, determinazione colonne attive 3. Lettura righe da bcrigpro 4. Per ogni riga: dati vettura da bcvettur 5. Composizione pagina con posizionamento assoluto 6. Totali per colonna, output tramite COGS54
File: bctespro (btp-), bcrigpro (brp-), bcvettur (bvt-), COGGEANA (ana-), COGTABEL (euta-). CALL: COGS54, PUTLOGO, COGU10.
COGX28 — Ricerca proposte per cliente/targa¶
File: /programmi/eurocoge/cbl/cogx28.cbl (910 righe)
Ricerca avanzata delle proposte commerciali per cliente o targa veicolo. Griglia dei risultati con selezione. Richiamato da COGX26 e COGX30.
Logica: 1. Accept parametri: cliente e/o targa 2. Scansione bctespro e bcrigpro 3. Filtro per corrispondenza 4. Griglia risultati (anno, numero, cliente, targa) 5. Ritorno anno e numero proposta selezionata
File: bctespro (btp-), bcrigpro (brp-), bcvettur (bvt-), COGGEANA (ana-). CALL: nessuna significativa (modulo terminale).
COGX30 — Generazione ordini da proposte¶
File: /programmi/eurocoge/cbl/cogx30.cbl (2.106 righe)
Trasforma una proposta confermata in ordine di vendita. Legge la proposta, permette selezione vetture da ordinare, genera ordine collegato e aggiorna stato proposta. Supporta creazione diretta da COGX33.
Logica: 1. Accept anno e numero proposta (o ricezione da COGX33) 2. Lettura proposta da bctespro/bcrigpro 3. Griglia con vetture e valori 4. Selezione vetture da includere nell'ordine 5. Accept anno/data ordine 6. Generazione testata e righe ordine su bctespro 7. Aggiornamento proposta con riferimento ordine 8. Stampa ordine tramite COGX31
File: bctespro (btp-), bcrigpro (brp-), bcvettur (bvt-), COGTABEL (euta-), COGGEANA (ana-). CALL: COGX28, COGX31, DIALOGS, GRIDADMN.
COGX31 — Stampa ordini di vendita¶
File: /programmi/eurocoge/cbl/cogx31.cbl (1.365 righe)
Stampa/ristampa degli ordini di vendita veicoli. Struttura analoga a COGX27: layout laser professionale con PUTLOGO e COGS54.
File: bctespro (btp-), bcrigpro (brp-), bcvettur (bvt-), COGGEANA (ana-), COGTABEL (euta-). CALL: COGS54, PUTLOGO, COGU10.
COGX35 — Dati cliente provvisorio¶
File: /programmi/eurocoge/cbl/cogx35.cbl (563 righe)
Inserimento/modifica dati di un cliente non codificato (provvisorio, codice 99999). Campi: ragione sociale, indirizzo, CAP, citta', provincia, telefono, fax. Validazione provincia tramite COGF09. Richiamato da COGX26 e COGX33.
File: COGTABEL (euta-). CALL: COGF09.
3. Fatturazione¶
COGX19 — Selezione veicoli da fatturare¶
File: /programmi/eurocoge/cbl/cogx19.cbl (2.334 righe)
Griglia di selezione dei veicoli pronti per la fatturazione. Filtra per targa, marca, modello, merce, cliente. Visualizzazione dati contrattuali. F6 per stampa contratto (COGX18) e F3 per avvio fatturazione (COGX20).
Logica: 1. Costruzione griglia, inizializzazione filtri 2. Accept filtri: targa, marca, modello, merce, cliente, flag "gia' fatturato" 3. Caricamento da bcmovim/bcveicol/bccontra 4. Selezione/deselezione veicoli con Invio 5. F6 → COGX18 (stampa contratto) 6. F3 → COGX20 (fatturazione) 7. Aggiornamento dati contrattuali
File: bcmovim (bcm-), bcveicol (bca-), bccontra (bcc-), cogracmt (rtm-), COGTABEL (euta-), COGGEANA (ana-). CALL: COGS56, COGX18, COGX20, COGS25, COGS65W, COGU10W, GRIDADMN.
COGX20 — Motore fatturazione veicoli¶
File: /programmi/eurocoge/cbl/cogx20.cbl (1.187 righe)
Fatturazione effettiva dei veicoli. Riceve dati da COGX19, genera fatture di vendita tramite il motore standard COGV61. Gestisce acconti, condizioni di pagamento, aggiornamento bcmovim con riferimenti fattura.
Logica: 1. Ricezione parametri: cliente, data, divisa, ritenuta 2. Lettura veicoli selezionati dal file transito 3. Raggruppamento per cliente/divisa 4. CALL COGV61 per generazione fattura 5. Gestione acconti e condizioni (COGP41) 6. Aggiornamento bcmovim con riferimenti fattura 7. Dialogo ristampa/nuova fattura
File: bcmovim (bcm-), bccontra (bcc-), COGGEANA (ana-), cogragfa, cogrifbo, cogrresi. CALL: COGV61, COGU21, COGF26, COGP41, DIALOGS, COGS65W, RNEWCONF.
4. Comunicazioni ACI¶
COGX21 — Stampa ACI veicoli acquisiti per rivendita¶
File: /programmi/eurocoge/cbl/cogx21.cbl (1.482 righe)
Comunicazione obbligatoria ACI "Elenco Veicoli Ricevuti per la Rivendita". Per anno e quadrimestre, estrae entrate veicoli, incrocia con anagrafica per targa/telaio/KW, produce stampa ufficiale e file per trasmissione ACI.
Logica: 1. Accept: anno, quadrimestre (1=gen-apr, 2=mag-ago, 3=set-dic) 2. Calcolo date range 3. Scansione bcmovim per entrate nel periodo 4. Incrocio con bcveicol per dati anagrafici 5. Calcolo importo versamento 6. Accept parametri stampa: prezzo unitario, C/C, quietanza, date 7. Generazione stampa cartacea e file per dischetto
File: bcmovim (bcm-), bcveicol (bca-), cogracmt (rtm-), COGGEANA (ana-), COGTABEL (euta-). CALL: COGS54, PUTLOGO, COGX23.
COGX22 — Stampa ACI veicoli venduti o radiati¶
File: /programmi/eurocoge/cbl/cogx22.cbl (1.284 righe)
Comunicazione ACI "Elenco Veicoli Venduti o Radiati". Analogo a COGX21 ma per uscite (vendite/radiazioni). Incrocia con bccontra per dati acquirente.
File: bcmovim (bcm-), bcveicol (bca-), bccontra (bcc-), cogracmt (rtm-), COGGEANA (ana-), COGCNDCF (cnd-), COGTABEL (euta-). CALL: COGS54, PUTLOGO, COGX23.
COGX23 — Configurazione ACI per Bercar¶
File: /programmi/eurocoge/cbl/cogx23.cbl (542 righe)
Parametri per comunicazioni ACI: conto corrente postale, intestatario, provincia, comune, codice fiscale. Richiamato da COGX21/COGX22 tramite F1.
File: COGTABEL (euta-). CALL: nessuna significativa (modulo terminale).
5. Utility di controllo¶
BERCAR01 — Controllo/caricamento movimenti magazzino¶
File: /programmi/eurocoge/cbl/bercar01.cbl (1.220 righe)
Controllo e caricamento movimenti magazzino veicoli. Scansiona bcmovim, verifica correttezza dati entrata/uscita (causali, registri, date, fornitori), aggiorna anagrafica bcveicol, verifica coerenza ponte cogracmt. Segnala anomalie in griglia.
Logica: 1. Scansione sequenziale bcmovim 2. Per ogni movimento: lettura bcveicol per merce collegata 3. Entrata senza uscita: aggiornamento anagrafica vettura 4. Controllo entrata: causale, registro, data, fornitore 5. Controllo uscita: causale, acquirente, date 6. Ricerca targa tramite cogracmt 7. Inserimento anomalie in griglia
File: bcmovim (bcm-), bcveicol (bca-), cogracmt (rtm-), COGTABEL (euta-), COGGEANA (ana-). CALL: COGS25, COGU12, COGR26, COGR17, GRIDADMN.
BERCAR02 — Controllo coerenza flag fatture su movimenti¶
File: /programmi/eurocoge/cbl/bercar02.cbl (218 righe)
Utility di diagnostica: verifica coerenza tra flag fatturazione e riferimenti fattura in bcmovim. Conta errori per provvigioni e fatture vendita.
File: bcmovim (bcm-). CALL: nessuna significativa (utility autonoma).
BERCAR03 — Controllo collegamento fatture-movimenti¶
File: /programmi/eurocoge/cbl/bercar03.cbl (258 righe)
Utility: verifica collegamento tra fatture (cogfattu) e movimenti veicoli (bcmovim). Per ogni fattura, cerca nel file movimenti un record corrispondente su 4 campi (fat_ent, nac_ent, fat_pro, fat_ven). Segnala fatture scollegate.
File: COGFATTU (fat-), bcmovim (bcm-). CALL: nessuna significativa (utility autonoma).
BERCAR04 — Patch singolo movimento¶
File: /programmi/eurocoge/cbl/bercar04.cbl (163 righe)
Utility one-shot per correzione manuale: scrive dati fattura specifica su un record bcmovim con chiave fissa. Programma di manutenzione, non per uso corrente.
File: bcmovim (bcm-). CALL: nessuna significativa (patch manuale).
6. Flusso integrato¶
CICLO COMMERCIALE (ORCHESTRATO DA COGX33):
└── COGX33 (orchestratore: vettura → proposta → ordine)
├── COGX24 (cruscotto vetture assegnate/disponibili)
│ ├── COGX25 (dettaglio vettura assegnata, tipo "A")
│ └── COGX29 (dettaglio vettura disponibile, tipo "V")
├── COGX26 (gestione proposte commerciali)
│ ├── COGX28 (ricerca proposte per cliente/targa)
│ └── COGX27 (stampa proposta)
├── COGX30 (generazione ordini da proposte)
│ └── COGX31 (stampa ordine)
└── COGX35 (dati cliente provvisorio cod. 99999)
ANAGRAFICA E CONTRATTI:
├── COGX15 (scheda auto — anagrafica veicoli)
│ └── bcveicol ← ponte cogracmt → COGMERCI
└── COGX18 (contratti vendita veicolo)
└── bccontra + descrizioni LOD
FATTURAZIONE:
└── COGX19 (selezione veicoli da fatturare)
├── COGX18 (F6: stampa contratto)
└── COGX20 (F3: motore fatturazione)
└── COGV61 (fatturazione standard ERP)
COMUNICAZIONI ACI (quadrimestrali):
├── COGX21 (ACI veicoli acquisiti per rivendita)
├── COGX22 (ACI veicoli venduti/radiati)
└── COGX23 (configurazione parametri ACI)
UTILITY DI CONTROLLO:
├── BERCAR01 (controllo/caricamento movimenti)
├── BERCAR02 (controllo coerenza flag fatture)
├── BERCAR03 (controllo collegamento fatture-movimenti)
└── BERCAR04 (patch singolo movimento)
Note architetturali:
- COGX33 e' l'orchestratore del flusso commerciale: chiama COGX26 (proposta) → COGX30 (ordine) in sequenza
- COGX24 e' il cruscotto centrale: biforcazione tra COGX25 (assegnate) e COGX29 (disponibili)
- bcvettur e' il cuore del ciclo commerciale: ogni vettura ha tipo "A" (assegnata) o "V" (disponibile)
- Il ponte cogracmt collega targa (dato "umano") a codice merce (dato gestionale)
- BERCAR01-04 sono utility di manutenzione, non parte del flusso operativo
7. File principali¶
| File | Prefisso | Descrizione |
|---|---|---|
| bcveicol | bca- | Anagrafica veicoli (targa, marca, modello, telaio, KW) |
| bcvettur | bvt- | Vetture ciclo commerciale (tipo A=assegnate, V=disponibili) |
| bcmovim | bcm- | Movimenti di magazzino veicoli (entrate/uscite) |
| bccontra | bcc- | Contratti di vendita veicolo |
| bctespro | btp- | Testate proposte e ordini |
| bcrigpro | brp- | Righe proposte e ordini (dettaglio vetture) |
| cogracmt | rtm- | Ponte targa-merce (collegamento targa → codice merce) |
8. Tabella riepilogativa¶
| # | Programma | Righe | Tipo | Funzione |
|---|---|---|---|---|
| 1 | COGX15 | 3.601 | Gestione | Anagrafica veicoli (scheda auto) |
| 2 | COGX18 | 2.888 | Gestione/Stampa | Contratti di vendita veicolo |
| 3 | COGX24 | 3.062 | Cruscotto | Vetture assegnate/disponibili |
| 4 | COGX25 | 1.956 | Dettaglio | Dettaglio vettura assegnata |
| 5 | COGX29 | 1.286 | Dettaglio | Dettaglio vettura disponibile |
| 6 | COGX33 | 867 | Orchestratore | Assegnazione vettura venduta (flusso completo) |
| 7 | COGX26 | 4.758 | Gestione | Proposte commerciali (CRUD + stampa) |
| 8 | COGX27 | 1.336 | Stampa | Stampa proposte commerciali |
| 9 | COGX28 | 910 | Ricerca | Ricerca proposte per cliente/targa |
| 10 | COGX30 | 2.106 | Elaborazione | Generazione ordini da proposte |
| 11 | COGX31 | 1.365 | Stampa | Stampa ordini di vendita |
| 12 | COGX35 | 563 | Input | Dati cliente provvisorio (cod. 99999) |
| 13 | COGX19 | 2.334 | Selezione | Veicoli da fatturare |
| 14 | COGX20 | 1.187 | Elaborazione | Motore fatturazione veicoli |
| 15 | COGX21 | 1.482 | Report | Comunicazione ACI veicoli acquisiti |
| 16 | COGX22 | 1.284 | Report | Comunicazione ACI veicoli venduti/radiati |
| 17 | COGX23 | 542 | Configurazione | Parametri ACI per Bercar |
| 18 | BERCAR01 | 1.220 | Controllo | Controllo/caricamento movimenti magazzino |
| 19 | BERCAR02 | 218 | Utility | Controllo coerenza flag fatture |
| 20 | BERCAR03 | 258 | Utility | Controllo collegamento fatture-movimenti |
| 21 | BERCAR04 | 163 | Utility | Patch singolo movimento |
| TOTALE | ~33.400 |