Convenzioni e gestione effetti¶

Panoramica¶

L'area convenzioni gestisce il ciclo di vita degli effetti finanziari legati a convenzioni bancarie con clienti. I clienti aderiscono a una tipologia di convenzione (Eurocap, Pomodoro facile, Latte facile, Conto Flex revolving, Conto Flex fisso) e il sistema genera effetti collegati ai documenti di vendita, li presenta in distinte bancarie e ne traccia pagamenti, respingimenti e fido residuo.

Programma	Righe	Funzione
NUT230	8.603	Gestione effetti convenzioni (principale)
NUT231	1.683	Verifica partite chiuse / allineamento NUTEFFET
NUT232	2.061	Creazione effetti di recupero
NUT234	752	Dettaglio pagamenti anticipati su effetto

Tipologie di convenzione¶

Cod.	Nome	Cond.pag.	Regola pagamento
E	Eurocap	E	Cliente paga in due rate semestrali. Il fido si cumula su effetti non ancora pagati per tutto il periodo
P	Pomodoro facile	P	Rata unica al 1/1 dell'anno: tutti gli effetti dal 1/1 al 31/12 dell'anno precedente
L	Latte facile	L	Regola specifica a scadenze variabili
Q	Conto Flex REVOLVING	Q	Ogni effetto pagabile 1 anno dopo l'emissione. Possibilita' di RID (SEPA)
Y	Conto Flex FISSO	Y	Tutti gli effetti del periodo pagabili in unica soluzione a scadenza convenzione

Il tipo convenzione e' legato alla condizione di pagamento del cliente (eff-tip). Il "cliente padre" e' il soggetto che effettivamente paga l'effetto, prelevato dall'anagrafica del cliente intestatario al momento della creazione.

Tabelle principali¶

NUTEFFET — Effetti da convenzioni¶

Archivio indicizzato, chiave primaria eff-tip + eff-riba (tipo convenzione + progressivo effetto).

Campo	Formato	Descrizione
eff-tip	x(01)	Tipo convenzione (E/P/L/Q/Y)
eff-riba	9(12)	Numero progressivo effetto
eff-fattura	x(13)	Riferimento fattura (tipo + anno + numero)
eff-polizza	x(13)	Redefines di eff-fattura per polizze
eff-datafat	9(08)	Data documento (YYYYMMDD)
eff-datapag	9(08)	Data pagamento
eff-data-comp	9(08)	Data competenza
eff-data-ins	9(08)	Data inserimento
eff-ana	x(06)	Anagrafico intestatario (tipo + codice)
eff-padre	x(06)	Cliente padre convenzione (tipo + codice)
eff-ban-ass	9(04)	Banca assuntrice
eff-dist	9(08)	Distinta (anno + numero)
eff-imp	9(12)v9(06)	Importo originale documento
eff-imp-eff	9(12)v9(06)	Importo effetto
eff-fattura-padre	x(13)	Chiave fattura padre
eff-mov-tip	x(01)	Tipo movimento (fattura/polizza)
eff-esito	x(01)	Esito (respinto/non pagato/vuoto)
eff-manuale	x(01)	Effetto manuale (S/N)
eff-val	x(01)	Validita' effetto (C = cancellato logicamente)
eff-partita-chiusa	x(01)	S = chiusa, E = escluso
eff-pagato-banca	x(01)	S = pagato dalla banca
eff-imp-pag-cli	9(12)v9(06)	Importo pagamento anticipato (obsoleto, ora su NUTEFFPC)
eff-data-pag-banca	9(08)	Data pagamento banca
eff-data-pag-cli	9(08)	Data pagamento anticipato (obsoleto, ora su NUTEFFPC)

NUTEFFPC — Pagamenti anticipati clienti¶

Archivio indicizzato, chiave primaria efpc-tip + efpc-riba + efpc-prog (tipo + numero effetto + progressivo pagamento).

Campo	Formato	Descrizione
efpc-tip	x(01)	Tipo convenzione
efpc-riba	9(12)	Numero effetto
efpc-prog	9(04)	Progressivo pagamento
efpc-data	9(08)	Data pagamento (YYYYMMDD)
efpc-importo	9(12)v9(06)	Importo pagato

NUT230 — Gestione effetti convenzioni¶

Identificazione¶

Programma: NUT230
Autore: Andrea Parmeggiani - Eurosystem2000
Area: Vendite / Convenzioni
Descrizione: Consultazione, correzione, presentazione e gestione degli effetti per ciascun tipo convenzione
Righe: 8.603
Menu: Vendite > Convenzioni > Gestione effetti

Funzionalita' principale¶

NUT230 e' il programma centrale della gestione effetti. Opera in due modalita':

Effetti da presentare — consultazione, modifica, cancellazione e creazione distinte
Effetti presentati — consultazione, respingimento, gestione pagamenti anticipati

Flusso operativo¶

1. Inizializzazione e selezione (apri, a1, a4)¶

L'utente seleziona:

Campo	Descrizione
Tipo convenzione	E/P/L/Q/Y
Ordinamento	Criterio di visualizzazione
Flag presentati/non presentati	Modalita' di lavoro
Data scadenza	Filtro temporale
Data fido	Riferimento per calcolo fido
Flag competenza/scadenza	Criterio data
Ricerca cliente padre/figlio	Filtro anagrafico opzionale

2. Estrazione effetti da presentare (b1-estrai-da-presentare)¶

Scansione sequenziale di NUTEFFET con filtro per tipo convenzione. Per ogni effetto estratto, popola la tabella interna t-effetti e calcola il fido scalare del cliente padre.

3. Estrazione effetti presentati (b2-estrai-presentati)¶

Estrae tutti gli effetti presentati dove la data presentazione distinta corrisponde alla data richiesta. Scansione per distinta e poi per effetti della distinta.

4. Ricalcolo fido (b3-ricalcola-fido)¶

Ricalcola il fido residuo per ciascun cliente padre. Il fido concesso e' letto dall'anagrafica del cliente padre (pagina Consorzi, riquadro Dati convenzione).

5. Griglia interattiva (a-grid, vis-tabella-disp)¶

La griglia presenta una riga per effetto con le seguenti informazioni principali:

Colonna	Descrizione
Codice/Nome	Cliente intestatario
N.Fattura	Riferimento documento
Scadenza	Data scadenza documento
Data comp.	Data competenza
Importo	Importo originale
Imp.effetto	Importo effetto da presentare
Fido cliente	Fido concesso
Fido residuo	Fido scalare dopo effetti precedenti
Banca/ABI/CAB	Banca assuntrice
Cl.padre	Cliente padre convenzione
Fatt.padre	Documento padre dell'effetto
N. distinta / Prog.	Riferimenti distinta (solo dopo presentazione)
Tipo movimento	Fattura/polizza
Cancellato?	Flag cancellazione logica
Esito	Respinto/Non pagato/vuoto
Part.chiusa?	Stato partita collegata
Pagato banca	Flag pagamento banca (con data)
Pagamento anticipato	Importo anticipi (Conto Flex)

Operazioni su effetti da presentare¶

Cancellazione effetto (a1-cancella)¶

Cancellazione logica dell'effetto selezionato dalla griglia.

Creazione distinte (c-crea-distinte)¶

Processo di presentazione:

a5-prepara-creazione — accettazione data distinta
c-inizia-creazione — loop sugli effetti selezionati
c-nuova-distinta — creazione nuova distinta quando necessario
c-eff-accorpati-loop — gestione effetti accorpati (note accredito "affogate" in effetti fattura)
Scrittura su NUTARIBA (archivio distinte)
Generazione XML se prevista (x-genera-xml)
Stampa distinte (stampa-distinte)

Ricalcolo data competenza (durante presentazione)¶

Per Conto Flex "Q":

Banca con RID: data fine mese rispetto alla data sistema
Banca senza RID, effetto pagato: data pagamento banca
Banca senza RID, effetto non pagato: data sistema

Operazioni su effetti presentati¶

Respingimento effetto (a2-respingi-effetto)¶

Condizioni:

L'effetto deve riferirsi a un documento padre (non nota accredito collegata)
L'esito deve essere vuoto (non gia' respinto/pagato)
Per Conto Flex: l'effetto non deve essere pagato dalla banca ne' avere pagamenti anticipati

Effetto:

Colonna esito diventa "Respinto" o "Non pagato" (in base al tipo convenzione)
Se la partita collegata era chiusa, viene riaperta

Pagamento anticipato (a6-seleziona-pag-anticipato)¶

Disponibile solo per convenzioni Conto Flex (Q e Y) su effetti presentati.

Flusso:

L'utente indica il totale "Pagamento anticipato" in testata
Per ciascun effetto interessato indica un importo nella colonna "Anticipo attuale"
Il programma controlla che la somma degli importi indicati sia uguale al totale e che l'importo su ogni effetto (sommato ai precedenti) non superi l'importo effetto
a6-aggiorna-pagamenti — aggiornamento tramite menu "File > Aggiorna pagamenti"
a6-inserisci-pagamento — inserimento record su NUTEFFPC per ciascun effetto con pagamento

Chiusura partite (a4-chiudi-partite)¶

Chiusura delle partite aperte collegate agli effetti presentati.

Programmi chiamati¶

Programma	Scopo
NUT231	Verifica partite chiuse / allineamento
NUT234	Dettaglio pagamenti anticipati su effetto
COGE43	Estratto conto
COGW12	Stampa documento Word
COGU97	Funzioni di utilita'
COGU10W	Formattazione/conversione importi
GRIDADMN	Gestione griglia
GESDATE	Gestione date
DIALOGS	Finestre di dialogo

NUT232 — Creazione effetti di recupero¶

Identificazione¶

Programma: NUT232
Autore: Andrea Parmeggiani - Eurosystem2000
Area: Vendite / Convenzioni
Descrizione: Analisi clienti e creazione automatica effetti su partite aperte senza convenzione
Righe: 2.061
Menu: Vendite > Convenzioni > Creazione effetti di recupero

Logica¶

Il programma analizza i clienti con una determinata convenzione. Per ciascun cliente:

Scorre i clienti con condizione pagamento corrispondente al tipo convenzione selezionato (analisi sui clienti figli)
Elabora le partite aperte senza convenzione
Verifica che il fido del cliente padre abbia capienza sufficiente
Se c'e' capienza, permette la creazione dell'effetto

Se non e' selezionato un cliente specifico, il programma scorre tutti i clienti.

NUT234 — Dettaglio pagamenti anticipati effetto¶

Identificazione¶

Programma: NUT234
Area: Vendite / Convenzioni (non a menu, chiamato da NUT230)
Descrizione: Visualizzazione di tutti i pagamenti anticipati clienti su un singolo effetto
Righe: 752

Logica¶

Finestra richiamata da NUT230 che mostra, per un effetto selezionato:

Testata: tipo effetto, numero effetto (sola lettura)
Griglia: elenco pagamenti da NUTEFFPC

Colonna	Descrizione
Data	Data pagamento (efpc-data)
Importo	Importo pagato (efpc-importo)

Il programma e' di sola visualizzazione. NUT230 passa i parametri via utilnut234.cpy.

NUT231 — Verifica partite chiuse¶

Identificazione¶

Programma: NUT231
Area: Vendite / Convenzioni (non a menu, chiamato da NUT230)
Descrizione: Verifica partite chiuse presenti in NUTEFFET e allineamento campo eff-val
Righe: 1.683

Logica¶

Scorre gli effetti in NUTEFFET
Se la partita collegata risulta chiusa, imposta eff-val = "C"
Per i clienti Eurocap verifica anche che le partite aperte abbiano un riferimento in NUTEFFET

Concetti chiave: calcolo fido¶

Il fido e' il meccanismo centrale delle convenzioni. Tre date governano i periodi di calcolo:

Data	Descrizione
Data inizio fido	Calcolata dalla data richiesta. Gli effetti con data competenza superiore a questa data vengono considerati
Data scarico fido	Calcolata dalla data richiesta. Gli effetti tra data inizio e data scarico dovrebbero teoricamente essere pagati dal cliente
Data fine fido	Calcolata dalla data richiesta. Tutti gli effetti tra data inizio e data fine compongono il fido utilizzato

Determinazione fido residuo cliente¶

Base di partenza: Fido concesso dall'anagrafica cliente padre (pagina Consorzi, riquadro Dati convenzione).

Regole di inclusione/esclusione degli effetti nel calcolo:

Condizione	Inclusione
Tipo convenzione diverso dall'elaborazione	Escluso
Effetto manuale	Sempre incluso
Effetto automatico non presentato	Escluso
Effetto cancellato logicamente	Escluso
Effetto respinto/non pagato	Escluso
Effetto con pagamento anticipato	Incluso al netto dell'importo pagato (solo se nel periodo)

Per Eurocap il fido si suddivide in due periodi semestrali:

Periodo 1 scala solo il "Fido residuo"
Periodo 2 scala sia il "Fido residuo" sia il "Fido attuale"

Stampe e documenti Word¶

NUT230 genera diverse stampe via COGW12 (integrazione Word).

Stampe disponibili (da Situazione clienti)¶

Tasto	Tipo	Modello Word
F5	Lettera singola a cliente	`convenzione-riepilogo-XX.doc` (standard) o `convenzione-riepilogo-frontespizio-XX.doc` (con indirizzo spedizione)
F9	Riepilogo per cliente	`convenzione-riepilogo-cliente-flex-XX.doc` (Flex revolving), `convenzione-riepilogo-cliente-flex-fisso-XX.doc` (Flex fisso), `convenzione-riepilogo-cliente-XX.doc` (altri)
F7	Riepilogo per banca	`convenzione-riepilogo-banca.doc`

Tag principali nei documenti¶

Documenti cliente (A, B, D):

Tag	Contenuto
DATASIS	Data di sistema
DATA-SCAD	Data scadenza elaborazione
CONVENZIONE	Descrizione convenzione
PERIODO-CONV	Periodo convenzione (es. "Primo semestre 2009")
PERIODO-MOV	Periodo movimenti (es. "dal 01/07/2009 al 30/06/2010")
MESE-ELAB	Mese di elaborazione (es. "LUGLIO 2016")
FIDO-CONCESSO	Importo fido concesso
DST-*	Indirizzo di corrispondenza (NOME, IND, CAP, LOCA, PROV)
ANA-*	Dati anagrafici (NOME, IND, CAP, LOCA, PROV, COD)
TAB-FATTURE	Tabella fatture da pagare
TAB-RIEPILOGO	Tabella riepilogo scadenze
TAB-FATTURE-Q	Riepilogo movimenti per Conto Flex revolving

Documento banca (C):

Tag	Contenuto
TIPO-CONV	Tipo convenzione (intestazione fissa)
DATA-INI / DATA-FIN	Periodo movimenti
COD-ABI-ASS / DES-ABI-ASS	Banca assuntrice (ABI)
COD-CAB-ASS / DES-CAB-ASS	Banca assuntrice (CAB)
COD-ABI-APP / DES-ABI-APP	Banca d'appoggio (ABI) — rottura
COD-CAB-APP / DES-CAB-APP	Banca d'appoggio (CAB) — rottura
TAB-RIGHE	Righe movimenti (cliente, c/c, importo, scadenza)
TOT-CAB	Totale effetti per CAB
TOT-ABI	Totale effetti per ABI (totale distinta)

Relazioni tra programmi¶

NUT230 (Gestione effetti)
 ├── NUT231  (Verifica partite chiuse)
 ├── NUT234  (Dettaglio pagamenti effetto)
 ├── COGE43  (Estratto conto)
 ├── COGW12  (Stampa Word)
 ├── COGU97  (Utilita')
 └── GRIDADMN (Gestione griglia)

NUT232 (Creazione effetti di recupero)
 └── opera su NUTEFFET / partite aperte