Home Banking — Pagamenti e distinte bancarie¶

Area funzionale: Contabilita' / Home Banking Programmi documentati: 6 | Righe totali analizzate: 22.064

Indice¶

Anagrafiche
Ciclo pagamento
Flusso integrato
Formati di uscita
File principali
Tabella riepilogativa

1. Anagrafiche¶

NUT020 — Gestione banche assuntrici¶

File: /programmi/eurocoge/cbl/nut020.cbl (3.168 righe)

Anagrafica banche assuntrici dell'azienda. Gestisce coordinate IBAN, conti contabili (transitorio, bonifici, FAD), parametri distinte (giorni SBF, commissioni, spese), BIC/SWIFT, numero rapporto, configurazione Docfinance.

Dati principali:

Campo	Descrizione
ban-cod	Codice banca (4 cifre)
ban-des	Descrizione (50 caratteri)
ban-mas-tra/con-tra/sco-tra	Conto transitorio
ban-mas-con/con-con/sco-con	Conto contabile banca
ban-mas-bon/con-bon/sco-bon	Conto bonifici
ban-mas-fad/con-fad/sco-fad	Conto FAD
ban-iban-st/cin-e/cin-it/abi/cab/ccorr	Coordinate IBAN complete
ban-bic	Codice BIC/SWIFT (11 caratteri)
ban-gg-sp/gg-fp	Giorni SBF primo/fin piano
ban-com-sp	Commissioni
ban-spese	Spese
ban-rid-cto-flex	Flag RID conto flessibile
ban-rbn	Codice RBN
ban-banca-docfinance	Codice Docfinance

Operazioni: F6 = aggancia conti (NUT022), registrazione saldo banca su COGTABEL tipo "N1".

File: NUTBANAS (ban-), COGPNCON (pco-), COGTABEL (euta-). CALL: NUT022, COGE65 (piano conti), COGE04, COGV04, COGU03W, RNEWCONF.

NUT021 — Gestione altri soggetti¶

File: /programmi/eurocoge/cbl/nut021.cbl (2.307 righe)

Anagrafica soggetti che non sono clienti ne' fornitori ma hanno posizione contabile (dipendenti, collaboratori, enti, professionisti). Utilizzati nel ciclo HB quando il tipo soggetto e' "A".

Dati principali:

Campo	Descrizione
als-cod	Codice soggetto (5 cifre)
als-des	Ragione sociale (40 caratteri)
als-ind/loca/prov/cap	Indirizzo completo
als-piva	Partita IVA
als-cofi	Codice fiscale
als-email	Email
als-mas/con/sco	Conto contabile
als-iban-st/cin-e/cin-it/abi/cab/ccorr	Coordinate IBAN
als-swift	Codice SWIFT (16 caratteri)

Validazione: P.IVA tramite COGE05 (verifica validita' e unicita'). Ricerca CAP/localita' con F12 (WIN161).

File: NUTALTRI (als-), COGGEANA (ana-), COGPNCON (pco-), COGTABEL (euta-). CALL: WIN161, WIN193, COGF09, COGE04, COGE05, COGU03W.

2. Ciclo pagamento¶

COGB30 — Scadenzario¶

File: /programmi/eurocoge/cbl/cogb30.cbl (5.590 righe)

Scadenzario fornitori/clienti per home banking. Visualizza, seleziona e gestisce le partite aperte per la generazione di distinte di pagamento.

Parametri selezione: Tipo soggetto (F=Fornitori, C=Clienti, A=Altri), tipo pagamento (B=Bonifici, F=FAD, R=Ricevute bancarie, D=Rimesse dirette), date da/a, ordinamento per agenzia.

Logica: 1. Scansione COGPARTI filtrando per tipo, esclude par-fl-chiu = 'C' 2. Per ogni partita aperta: - Calcolo saldo da COGMOVPA (dare/avere) - Se configurato (az-ges-ip = "S"), legge prima nota provvisoria (CAPPNOPR) - Legge prima nota anno precedente/corrente (COGPNONC via CAPGENER) - Controlla fattura correlata (COGFATTU) - Verifica anticipazioni, cauzioni, ritenute, sospesi (COGS51) - Calcolo saldo netto → WRITE COGTRANS (record temporaneo) 3. Griglia: codice, ragione sociale, partita, tipo pagamento, importo, valuta, fattura, flag (A=Anticipi, C=Cauzioni, R=Ritenute, S=Sospesi)

Import JDOC: Supporta importazione da file CSV/Excel (F5 import), parsando barcode, data, numero doc, data valuta, registro IVA, codice fornitore, totale.

Operazioni:

Tasto	Funzione
Invio	Seleziona/deseleziona partita
S-F5	Seleziona tutte
F5	Riepilogo scadenze per fasce (scaduto, mese corrente, 1/2/3 mesi, oltre)
S-F7	Giro conto

File: COGPARTI (par-), COGMOVPA (mov-), COGTRANS (trs-), HOMEBA (hom-), NUTBANAS (ban-), NUTALTRI (als-), COGGEANA (ana-), COGPNCON (pco-), COGFATTU (fat-), COGAPPOG (app-), COGRITAC (rit-), COGANAPP (anp-), COGANCAP (anc-), COGFATT2 (fat2-), CAPPNOPR (pnp-), CAPGENER (gen-), COGTABEL (euta-). CALL: COGU10W, COGB40, COGB41, COGR20, COGF28, COGS51, COGS54, COGS65W, COGU06, GRIDADMN, WIN062, DIALOGS, OPENFILE, RNEWCONF, ESTRXLS, COPIAF.

COGB31 — Gestione archivio Home Banking¶

File: /programmi/eurocoge/cbl/cogb31.cbl (1.757 righe)

Gestione delle partite selezionate per il pagamento. Permette la scelta del tipo pagamento, data valuta distinta, e modifica importi/detrazioni. Riepilogo per banca (ABI) con totali.

Logica: 1. Accept tipo pagamento: B=Bonifici, F=FAD, R=Ricevute bancarie 2. Accept data valuta distinta 3. Apertura archivio HOMEBA con nome basato sul tipo (bonifici.arc, assegni.arc, riba.arc) 4. Griglia partite con modifica importi e detrazioni 5. Riepilogo per ABI (fino a 20 banche) con importo/importo pagato

File: HOMEBA (hom-), COGGEANA (ana-), COGAPPOG (app-), NUTBANAS (ban-), NUTALTRI (als-), COGTABEL (euta-). CALL: GRIDADMN, COGS54.

COGB32 — Creazione distinta e archivio¶

File: /programmi/eurocoge/cbl/cogb32.cbl (5.737 righe)

Crea distinte di pagamento in doppio formato: CBI tradizionale (record 120 byte) e XML SEPA (CBIPaymentRequest.00.04.01). Gestisce bonifici e FAD. Al termine chiama COGB33 per chiusura contabile.

Parametri: Tipo pagamento (B/F), banca assuntrice, tipo estrazione (T=tutti / solo ABI uguale), data distinta.

Logica: 1. Lettura HOMEBA, selezione partite per la distinta 2. Per ogni partita: calcolo netto = hom-impo - hom-rita - hom-anti - hom-nac 3. Recupero dati anagrafici (COGGEANA/NUTALTRI) e coordinate bancarie (COGAPPOG/COGANCAP) 4. Copia in HOMEBA3 (ordinato per valuta) 5. Generazione file CBI tradizionale (HOME01, 120 byte + CR + LF) 6. Generazione file XML SEPA 7. Stampa distinta cartacea 8. Generazione PDF/Email/CRM (se configurato) 9. CALL COGB33 per chiusura contabile

Formato CBI tradizionale (record 120 byte):

Record	Contenuto
HR	Header: codice mittente, ABI destinatario, data creazione
10	Disposizione: progressivo, data esecuzione, causale, importo, ABI/CAB
16	IBAN ordinante (solo bonifici)
17	IBAN beneficiario (solo bonifici)
20	Ordinante: ragione sociale, CF/P.IVA
30	Beneficiario: ragione sociale, CF/P.IVA
40	Indirizzo: via, CAP, comune, banca
50/60	Descrizione: fino a 15 righe causale da 30 caratteri
70	Chiusura disposizione
EF	End of File: totale importo, numero record, numero disposizioni

Formula record: Bonifici = (n * 7) + 2 + rek_50_60; FAD = (n * 5) + 2 + rek_50_60.

Formato XML SEPA (CBIPaymentRequest.00.04.01):

Root: CBIPaymentRequest con namespace urn:CBI:xsd:CBIPaymentRequest.00.04.01
GrpHdr: MsgId, CreDtTm (ISO), NbOfTxs, CtrlSum, InitgPty con CUC
PmtInf: PmtMtd (TRF bonifici / CHK assegni), BtchBookg=false
PmtTpInf/SvcLvl/Cd = "SEPA"
File salvato come bonifici-DDMMAAAA-HHMMSS.xml

Configurazione (RNEWCONF):

Parametro	Descrizione
homeb-codice-mitt	Codice mittente CBI
homeb-cfisc-piva	CF/P.IVA per tracciato
homeb-caus-bonifico	Causale CBI bonifico
homeb-caus-assegno	Causale CBI assegno
homeb-caus-iso-bonifico	Causale ISO per XML
homeb-mittente-codice-cuc	Codice CUC per XML SEPA
homeb-to-for/cli/altri/nac	Tipo operazione per contabilizzazione

File: HOMEBA (hom-), HOMEBA2 (hom2-), HOMEBA3 (hom3-), HOMEBADE (homde-), HOME01 (rek01), COGGEANA (ana-), COGAPPOG (app-), COGANCAP (anc-), COGDESTI (dst-), NUTBANAS (ban-), NUTALTRI (als-), NUTTABEL (nuta-), COGTABEL (euta-), CRMATTIV (crm-). CALL: COGB33, GRIDADMN, COPIAF, WORDMDL, COGS54, GESSTR, COGPA3, POSTA, CRMS07, SVIEW, RNEWCONF, COGU03W, COGU06.

COGB33 — Chiusura partite (pagamento)¶

File: /programmi/eurocoge/cbl/cogb33.cbl (3.505 righe)

Chiusura contabile delle partite aperte dopo il pagamento HB. Genera movimenti di prima nota (COGPNONC) e aggiorna partite (COGPARTI/COGMOVPA). Gestisce compensazioni da note accredito e ritenute d'acconto. Richiamabile da COGB32 (automatico) o standalone (linkage utilcogb33.cpy).

Tipi operazione (da COGTABEL tipo 65 + configurazione):

tm-top-f: T.O. movimenti fornitore
tm-top-c: T.O. movimenti clienti
tm-top-a: T.O. movimenti altri soggetti
tm-top-nac: T.O. chiusura note accredito

Logica per ogni record HOMEBA (hom-sos <> spaces/C, hom-ban <> 0):

Chiusura fattura standard:
Se (hom-impo - hom-rita - hom-anti - hom-nac) > 0 e hom-segno = "A"
Se ritenuta > 0: scrive COGRITAC
WRITE COGPNONC: DARE conto fornitore, importo netto
Descrizione: "S.DO anno/tipo/partita/prog CP: mastro/conto/sco_banca"
WRITE COGMOVPA (progressivo registrazione = 5)
Compensazione con N.Accredito:
Se hom-nac > 0: WRITE COGPNONC con importo = hom-nac, T.O. = tm-top-nac
Aggiorna HOMEBA: hom-sos = "C" (chiuso)
Chiusura Note Accredito:
Se hom-segno = "D": COGPNONC con segno invertito
Contropartita Banca:
Conto da ban-mas-bon/con-bon/sco-bon (bonifici) o ban-mas-fad/con-fad/sco-fad (FAD)
Se tm-cfg-cp-banca = "I": usa NUTCONTI con indice configurato
Importo = differenza dare-avere accumulata
Se configurato: record spese bancarie
File JDOC: Per ogni partita fornitore chiusa (dare = avere), genera file .exp per archiviazione documentale

File: HOMEBA (hom-), HOMEBA2 (hom2-), COGPARTI (par-), COGMOVPA (mov-), COGPNONC (pno-), COGPNCON (pco-), COGGEANA (ana-), COGFATTU (fat-), COGFATT2 (fat2-), COGRITAC (rit-), NUTBANAS (ban-), NUTALTRI (als-), NUTCONTI (cban-), COGTABEL (euta-), FILEJDOC (jdoc-). CALL: COGD99, COGS99W, COGS54, DIALOGS, RNEWCONF, FESTA, WIN009, COPIAF.

3. Flusso integrato¶

ANAGRAFICHE:
├── NUT020 (banche assuntrici → NUTBANAS)
│   └── Coordinate IBAN, conti contabili, commissioni, CUC
└── NUT021 (altri soggetti → NUTALTRI)
    └── Dati anagrafici, IBAN, conto contabile

SCADENZARIO:
└── COGB30 (scadenzario → COGTRANS)
    ├── Legge COGPARTI + COGMOVPA (partite aperte)
    ├── Verifica anticipi, cauzioni, ritenute, sospesi
    ├── Import opzionale da file JDOC (CSV/XLS)
    └── → WRITE HOMEBA (partite selezionate)

GESTIONE ARCHIVIO:
└── COGB31 (gestione archivio HB)
    ├── Scelta tipo: B=Bonifici, F=FAD, R=RIBA
    ├── Data valuta, modifica importi/detrazioni
    └── Riepilogo per ABI

CREAZIONE DISTINTA:
└── COGB32 (creazione distinta)
    ├── → WRITE HOME01 (file CBI tradizionale, 120 byte)
    ├── → WRITE XML SEPA (CBIPaymentRequest.00.04.01)
    ├── → WRITE HOMEBA2 + HOMEBA3
    ├── Stampa distinta + PDF/Email/CRM
    └── → CALL COGB33 (chiusura automatica)

CHIUSURA CONTABILE:
└── COGB33 (chiusura partite)
    ├── → WRITE COGPNONC (prima nota: chiusura fornitore + contropartita banca)
    ├── → WRITE COGMOVPA (registrazione pagamento)
    ├── → UPDATE COGPARTI (chiusura partita)
    ├── → WRITE COGRITAC (se ritenute d'acconto)
    └── → WRITE FILEJDOC (archiviazione documentale)

4. Formati di uscita¶

CBI tradizionale¶

File: HOME01, record a posizione da 120 byte + CR + LF (binary sequential). Struttura: HR → (10 + 16 + 17 + 20 + 30 + 40 + 50/60 + 70) per ogni disposizione → EF. Record 16/17 (IBAN) solo per bonifici.

XML SEPA¶

Standard: CBIPaymentRequest.00.04.01. Namespace: urn:CBI:xsd:CBIPaymentRequest.00.04.01. PmtMtd: TRF (bonifici) o CHK (assegni circolari). SvcLvl: SEPA. File: bonifici-DDMMAAAA-HHMMSS.xml o assegni-DDMMAAAA-HHMMSS.xml.

5. File principali¶

File	Prefisso	Descrizione
HOMEBA	hom-	Archivio partite selezionate per pagamento HB
HOMEBA2	hom2-	Archivio partite con descrizioni estese (500 fatture + 15 righe desc.)
HOMEBA3	hom3-	Archivio partite ordinato per valuta
HOMEBADE	homde-	Archivio descrizioni
HOME01	rek01	File output CBI tradizionale (120 byte + CR + LF)
NUTBANAS	ban-	Anagrafica banche assuntrici
NUTALTRI	als-	Anagrafica altri soggetti
NUTCONTI	cban-	Conti per banca (indice configurabile)

Matrice utilizzo file per programma:

File	NUT020	NUT021	COGB30	COGB31	COGB32	COGB33
NUTBANAS	R/W/D	-	R	R	R	R
NUTALTRI	-	R/W/D	R	R	R	R
HOMEBA	-	-	W	R/W	R	R/W
HOMEBA2	-	-	-	-	W	R
HOMEBA3	-	-	-	-	W	-
HOME01	-	-	-	-	W	-
COGPARTI	-	-	R	-	-	R/W
COGMOVPA	-	-	R	-	-	W
COGPNONC	-	-	R	-	-	W
COGGEANA	-	R	R	R	R	R
COGPNCON	R	R	R	-	-	R
COGAPPOG	-	-	R	R	R	-
COGANCAP	-	-	R	-	R	-

6. Tabella riepilogativa¶

#	Programma	Righe	Tipo	Funzione
1	NUT020	3.168	Anagrafica	Banche assuntrici
2	NUT021	2.307	Anagrafica	Altri soggetti
3	COGB30	5.590	Operativo	Scadenzario fornitori/clienti
4	COGB31	1.757	Operativo	Gestione archivio HB
5	COGB32	5.737	Batch	Creazione distinta (CBI + XML SEPA)
6	COGB33	3.505	Batch	Chiusura partite (pagamento)
	TOTALE	22.064