COGY51 - Import/Export Prima Nota per DocFinance

Funzione

Scaricamento (export) di anagrafiche clienti/fornitori e partite aperte verso DocFinance, e importazione (import) dei movimenti contabili generati da DocFinance nella prima nota del gestionale.

Menu

• Contabilita' > Prima Nota > Utility > Import/Export

Tabelle e file principali

Tabella/File	Descrizione	Accesso
COGPNCON	Piano dei conti / Prima nota	Lettura (scan)
COGGEANA	Anagrafica generale	Lettura
COGANAPP	Appoggi bancari anagrafica	Lettura
COGANCAP	Capitoli anagrafica	Lettura
NUTBANAS	Banche ABI/CAB	Lettura
COGAPPOG	Appoggi bancari	Lettura
COGCNF	Configurazioni	Lettura/Scrittura
COGWPNO	Working prima nota	Lettura/Scrittura
COGTABEL	Tabelle generali (tipo 65 per config)	Lettura
expcli	File export anagrafiche (binary seq)	Scrittura
expmov	File export movimenti (binary seq)	Scrittura
impmov	File import movimenti DocFinance (line seq)	Lettura
filelog	File di log (line seq)	Scrittura
cogtrans	File temporaneo di transito (indexed)	Lettura/Scrittura
filejdoc	File JSON documenti	Scrittura

Logica principale

1. Inizializzazione: legge configurazione da RNEWCONF (tipo 65 EUTA), determina tipo elaborazione dal parametro di lancio (I=Import, E=Export, T=Tutto).
2. Fase Import (importa-cnt): legge il file impmov riga per riga, interpreta i campi (azienda, numeratore, causale, importi dare/avere, banca, data), e registra i movimenti in prima nota tramite COGWPNO.
3. Fase Export (elabora):
4. Fase 0: scan di COGPNCON per estrarre le anagrafiche clienti/fornitori con i relativi dati bancari (ABI, CAB, IBAN, BIC) da COGANAPP/COGANCAP/NUTBANAS. Scrive il file expcli (record 764 byte).
5. Fase 1 (scan-bol): scan delle partite aperte/scadenze e generazione del file expmov (record 535 byte) con tipo pagamento, importo, data scadenza, riferimenti documento.
6. Copia file: utilizza COPIAF per copiare i file generati dal server alla cartella client configurata.
7. Notifica: se configurato, invio email tramite POSTA con il riepilogo dell'elaborazione.
8. Aggiornamento: memorizza la data ultima estrazione in COGCNF.

Copybook principali

• cogy51.wrk, cogy51.select, cogy51.fd - Working, select, file descriptor
• cogconta.cpy - Struttura conti
• l-copiaf.cpy, u-copiaf.cpy - Interfaccia COPIAF
• utilmymail.cpy, utilpost.cpy - Interfaccia invio email
• utilncnf.cpy - Lettura RNEWCONF
• utilgesdebug.cpy - Gestione debug/log
• wtipidoc.cpy - Tipi documento

Note

• Il formato dei file di interscambio e' quello proprietario DocFinance: record anagrafiche da 764 byte (exp-1-rec), record movimenti da 535 byte (exp-2-rec), record import da 400 byte (imp-1-rec).
• La configurazione risiede in RNEWCONF tipo 65 e comprende: path di invio, nomi file, codice azienda, flag invio FTP/mail, gestione centri di costo.
• Il tipo di elaborazione puo' essere forzato dal parametro di lancio (wo-parametro(1:1)): "I" = solo import, "E" = solo export, "T" = completa.
• Gestisce anche l'esportazione in formato JSON per documenti (aggiunta 27/04/2021).