Note operative

Applicativo: TeamSystem Enterprise Power-I

Modulo: ACGE-X82 ACG Enterprise Kit Adempimenti

Versione: 1.1.0
Data di
28.10.2021
Aggiornamento:
Riferimento: Cumulativo C01

Titolo: Lettera di accompagnamento PTF KAE80C01

Classificazione: Guida Utente

INDICE

Contenuto della PTF .......................................................................................................................................... 2

Aggiornamento installazione server AS/400 ..................................................................................................... 2
Installazione tramite comando KAPYPTF ..................................................................................................... 2
Installazione senza utilizzo del KAPYPTF .................................................................................................... 3
Aggiornamento web application TS Enterprise Power-I .................................................................................. 11
Documentazione tecnica ................................................................................................................................. 11
IMPLEMENTAZIONI ........................................................................................................................................ 11

Lettera di accompagnamento PTF KAE80C01 1

 Note operative

CONTENUTO DELLA PTF

La presente PTF include i seguenti file:

• KAE80C01.zip contenente tutti gli oggetti del prodotto ACG Kit Adempimenti V1R1M0 parte AS/400.
Il cumulativo in oggetto include tutte le modifiche rilasciate dal primo rilascio del prodotto (PTF
KAE80000 del 05/05/2017) fino al 25/06/2021 (PTF KAE80021).

AGGIORNAMENTO INSTALLAZIONE SERVER AS/400

Prerequisito OS400: V5R3M0 e successivi

Prerequisiti minimi: Archivi di Base a livello GBP80426

Contabilità Aziendale a livello CA380090
Connettore TS Digital Invoice a livello HBP110031C

Effettuare il download del file KAE80C01.zip, scompattare tale file e scaricare la PTF sul server AS/400
secondo le modalità riportate nella pagina http://webedition.acginfo.it/how_ptf.html.

INSTALLAZIONE TRAMITE COMANDO KAPYPTF

1. Aprire una sessione di lavoro con utente "QPGMR" e sottomettere il comando:

CALL PGM(KAE80C01/PGMKAE01)

Verrà presentato l'elenco delle librerie dati nelle quali si desidera installare gli archivi del prodotto.

2. Immettere il codice di autorizzazione all'uso del prodotto ACGE-X82 con il comando:

KPWACQ CDPRO('ACGE-X82')

Se non si è ancora in possesso della password è comunque possibile procedere con l'installazione della ptf.
Verrà emesso un messaggio di avvertimento che ne segnalerà la mancanza.

3. Aprire una sessione di lavoro come QPGMR ed eseguire il comando:

KAPYPTF PTFNAME(KAE80C01) OBJLIB(libreria-oggetti)

specificando come "libreria-oggetti" o la libreria standard ACG_OBJV3 o la propria libreria delle PTF.

Per personalizzare il tipo di aggiornamenti da eseguire (libreria sorgenti, azioni, menu ecc.) immettere il
comando KAPYPTF, premere F4 ed indicare i parametri di dettaglio. Se si lascia il parametro PGMSRCLIB
impostato con il valore *DEFAULT il comando copia i sorgenti nella libreria ACGSKAE. Se non si vogliono
copiare i sorgenti indicare per tale parametro il valore *NO.

Lettera di accompagnamento PTF KAE80C01 2

 Note operative

INSTALLAZIONE SENZA UTILIZZO DEL KAPYPTF

Nel caso non si voglia utilizzare il comando eseguire invece tutti i passi che seguono:

• Spacchettamento
Per ottenere gli oggetti necessari, una volta scaricata la libreria KAE80C01 sul proprio sistema,
eseguire il comando:

CALL PGM(KAE80C01/DEPACK) PARM(KAE80C01)

• Allineamento file installazione

Per aggiornare il file e l'area dati di installazione degli oggetti e degli archivi del prodotto ACG
Enterprise Kit adempimenti ACGE-X82 eseguire il comando:

CALL PGM(KAE80C01/PGMKAE01)

Il programma presenta l'elenco delle librerie dati nelle quali si desidera installare gli archivi del
prodotto.

• File fisici e logici

1) Copiare i sorgenti dei file fisici:

GCDF300F GDDL300F XDFC300F KAE300F

GCDL300F GKPE300F XDFD300F
GDDF300F GPDF300F XDFH300F

nella libreria ACGFBASV3 eseguendo il comando:

CPYSRCF FROMFILE(KAE80C01/QDDSPF)
TOFILE(ACGFBASV3/QDDSPF)
FROMMBR(*ALL)
TOMBR(*FROMMBR) MBROPT(*REPLACE)

2) Copiare i sorgenti dei file logici:

GCDF301L GDDF303L GPDF300L XDFH302L

GCDF302L GDDF304L XDFC300L XDFH303L
GCDL301L GDDF305L XDFC301L XKAE301L
GCDL302L GDDF306L XDFD300L
GCDL303L GDDF307L XDFD301L
GCDL304L GDDL301L XDFD302L
GDDF301L GDDL302L XDFH300L
GDDF302L GKPE300L XDFH301L

nella libreria ACGFBASV3 eseguendo il comando:

CPYSRCF FROMFILE(KAE80C01/QDDSLF)
TOFILE(ACGFBASV3/QDDSLF)
FROMMBR(*ALL)
TOMBR(*FROMMBR) MBROPT(*REPLACE)

• Oggetti eseguibili

Lettera di accompagnamento PTF KAE80C01 3

 Note operative

In funzione del proprio ambiente, fare in modo che i seguenti oggetti di tipo *PGM:

GCKFDAT GRKF100 GRKL102

GCKLI01 GRKF102 GRKL103
GRKDFA01 GRKF103 GRKL104
GRKDFE01 GRKF103B GRKL105
GRKDFR01 GRKF104 GRKL202
GRKDF10 GRKF105 GRKL204
GRKDF10X GRKF106 GRKL205
GRKDF20 GRKF110 GRK10
GRKDF20S GRKF113 GRKL102
GRKDF30 GRKF113B
GRKDF30S GRKF202
GRKDF40 GRKF205
GRKDF40S GRKLDAT
GRKFCAL GRKLI01
GRKFDAT GRKL100
GRKFFLU GRKL101

Di tipo *FILE:
GKDFX0 GRKF103V
GKDFX1 GRKF104V
GKDF00 GRKF106V
GKDF01 GRKF110V
GKLI00 GRKF116V
GRKDF10V GRKLD00V
GRKDF20S GRKL100V
GRKDF20V GRKL101V
GRKDF30S GRKL102P
GRKDF30V GRKL103V
GRKDF40S GRKL104V
GRKDF40V GRKL202P
GRKFD00V GRKL204V
GRKFF00V GRK1000V
GRKF100V
GRKF102P

di tipo *PNLGRP:
HKAEDF20 HKAEDF40 HKAEGKDX HKAEGKPE
HKAEDF30 HKAEGKDF HKAEGKLI

di tipo *SRVPGM:
XMLKAE

di tipo *BNDDIR:
XMLKAE

siano utilizzati al posto dei corrispondenti oggetti standard ACG della libreria ACG_OBJV3.

• Messaggi

Aggiungere la definizione dei messaggi:

da GEN3250 a GEN3297
GEN3319
GEN3877

Lettera di accompagnamento PTF KAE80C01 4

 Note operative

GEN4225
GEN4226
MRGMSGF FROMMSGF(KAE80C01/ACGMSGPTF) TOMSGF(ACGGAA/ACGMSG)

• Messaggi multilingua:
Aggiungere la definizione dei messaggi:

da CA39021 a CA39034
da CA39109 a CA39132
da CA39144 a CA39148
da CA39260 a CA39364

MRGMSGF FROMMSGF(KAE80C01/NLSMSGPTF) TOMSGF(ACGGAA/NLSMSG)

• Tabelle comuni

Per ogni libreria-dati comune nella quale si usano le funzioni:

- aggiungere la definizione della tabella ed i relativi elementi:

TAB DL0Com. Liquid.IVA:Base
DL0 1Gestione dati GRKL101
DL0 2Stampa di provaGRKL102
DL0 3Generazione xmlGRKL103
DL0 4Gestione Comun.GRKL104
DL0 5Estrazione datiGRKL105

- aggiungere le definizioni della tabella ed i relativi elementi:

TAB DL1Com. Liquidaz. IVA:2018
DL1 2Stampa Comunic.GRKL202
DL1 4Gestione Comun.GRKL204
DL1 5Estrazione datiGRKL205

- aggiungere la definizione della tabella ed i relativi elementi:

TAB QVPCom. Liquid.IVA:QuadroVP
QVP 1Gestione dati I
QVP 4Cancellazione I

- aggiungere le definizioni della tabella ed i relativi elementi:

TAB DF0Com. Dati fatture:Base
DF0 1Gestione dati GRKF104
DF0 2Stampa dati GRKF102
DF0 3Generazione XMLGRKF103
DF0 4Gestione Comun.GRKF104
DF0 5Estrazione datiGRKF105

- aggiungere le definizioni della tabella ed i relativi elementi:

TAB/ DF2Com. Dati fatture:2019
DF2/ 5 Estrazione datiGRKF105

- aggiungere le definizioni della tabella ed i relativi elementi:

TAB TDFTipo documento Dati Fatt.
TDF/TD01 Fattura
TDF/TD04 Nota di credito

Lettera di accompagnamento PTF KAE80C01 5

 Note operative

TDF/TD05 Nota di debito

TDF/TD07 Fattura semplificata
TDF/TD08 Nota di credito semplificata
TDF/TD10 Fattura di acquisto intra BENI
TDF/TD11 Fattura di acquisto intra SERVIZI
TDF/TD12 Documento riepilogativo
- aggiungere le definizioni della tabella ed i relativi elementi:
TAB/ NOF Natura Operaz. Dati Fatt.
NOF/ N1 Escluse ex art.15
NOF/ N2 Non soggette
NOF/ N3 Non imponibili
NOF/ N4 Esenti
NOF/ N5 Regime del margine/IVA non esposta
NOF/ N6 Inversione contabile
NOF/ N7 IVA assolta in altro stato UE

eseguendo il comando:
CPYF FROMFILE(KAE80C01/ANTA2PTF) TOFILE(libreria-dati/ANTA200F)
MBROPT(*ADD) ERRLVL(*NOMAX)

• Tabelle aziendali

Per ogni libreria-dati aziendale nella quale si usano le funzioni, aggiungere l’elemento della tabella
DDP Dic.IVA telematica:dati:

DDP/MEAC >Metodo acconto

eseguendo il comando:
CPYF FROMFILE(KAE80C01/ASTA3PTF)
TOFILE(libreria-dati-aziendale/ASTA300F)
MBROPT(*ADD) ERRLVL(*NOMAX)

• Exit
Per ogni libreria-dati aziendale nella quale si devono usare le funzioni, aggiungere la definizione delle
exit:

GRKF501
GRKF502
GRKF503
GRKF504
GRKF505
GRKF506
GRKF507
eseguendo il comando:

CPYF FROMFILE(KAE80C01/AEXT2PTF) TOFILE(libreria-dati/AEXT200F)

MBROPT(*ADD) ERRLVL(*NOMAX)
FMTOPT(*MAP *DROP)

• Azioni

Per ogni libreria dati aziendale nella quale si usano le funzioni, aggiungere la definizione delle azioni:

GKLI Comunicazioni liquidazioni IVA

Lettera di accompagnamento PTF KAE80C01 6

 Note operative

GKLG Comunicazioni liquidazioni IVA di gruppo

GKGX Comunicazioni liquidazioni IVA - Generazione xml
GKPE Personalizzazione
GK10 Personalizzazione dati azienda
GKDF Comunicazioni dati delle fatture
GK30 Associazione Assoggettamento - Natura
Operazione
GK20 Associazione Causale - Tipo Documento
GDF2 Estraz. dati per Com.Dati Fatt: Emesse
GDF4 Estraz. dati per Com.Dati Fatt: Ricevute
GKDX Flussi xml dati delle fatture
GKFX Generazione flusso xml dati delle fatture
GK40 Estensione registri IVA

eseguendo il comando:

CPYF FROMFILE(KAE80C01/KFAZNPTF)
TOFILE(libreria-dati-aziendale/KFAZN10F)
MBROPT(*ADD) ERRLVL(*NOMAX)

• Menu

Per ogni libreria dati aziendale nella quale si usano le funzioni, aggiungere la definizione
dei nuovi menu:

1) aggiungere la definizione dei menu:

CKAE Kit Adempimenti

CKLI Comunicazioni liquidazioni IVA
CKDF Comunicazioni dati delle fatture

eseguendo il comando:

CPYF FROMFILE(KAE80C01/KFMNUPTF)
TOFILE(libreria-dati-aziendale/KFMNU10F)
MBROPT(*ADD) ERRLVL(*NOMAX)

eseguire la funzione di Gestione Ambiente "Manutenzione File Menu" (richiamabile dal menu
"Gestione Azioni e Menu") e modificare il menu:

Menu CA28 - Altre elaborazioni periodiche/annuali

aggiungendo il menu:

CKAE - Kit Adempimenti

Lettera di accompagnamento PTF KAE80C01 7

 Note operative

• Aiuto in linea

Per ogni PNLGRP eseguire i comandi:

RMVSCHIDXE SCHIDX(ACG_OBJV3/INDICEACG)
PNLGRP(xxxxxxx)

(ignorare l'eventuale messaggio: "Il gruppo di pannelli ... non esiste nell'indice di ricerca
INDICEACG")

ADDSCHIDXE SCHIDX(ACG_OBJV3/INDICEACG)
PNLGRP(libr.ogg./xxxxxxx)

(ignorare l'eventuale messaggio: "Il gruppo di pannelli non contiene sinonimi o parole di ricerca")

Nella “libr.ogg.” deve essere indicata la libreria oggetti nella quale sono stati posti i PNLGRP della ptf.

• Sorgenti dei programmi

I sorgenti non OCO (Object Code Only) dei file e programmi contenuti nella PTF sono contenuti nei
seguenti archivi sorgente:

QCLSRC
QDDSDS
QDDSSRC
QRPGSRC
QRPGLESRC
QUTISRC
QXMLKAE

e possono essere copiati nella libreria sorgenti standard ACGSKAE o in un'altra libreria eseguendo
per ogni file il comando:

CPYSRCF FROMFILE(KAE80C01/archivio-sorgente)
TOFILE(libreria-sorgenti/archivio-sorgente)
FROMMBR(*ALL)
TOMBR(*FROMMBR) MBROPT(*REPLACE)

Nota: tali membri sono necessari solo per la ricompilazione dei programmi corrispondenti. La
mancanza sul sistema della libreria ACGSKAE e la conseguente non effettuazione del comando non
pregiudicano il funzionamento dei programmi.

• Sorgenti dei programmi

I sorgenti dei template xml nuovi/modificati contenuti nel file QXMLKAE:
KDFANN17
KDFDTE17
KDFDTE19
KDFDTR17
KDFDTR19
KLIIVP17
KLIIVP18

possono essere copiati con il comando:

Lettera di accompagnamento PTF KAE80C01 8

 Note operative

CPYSRCF FROMFILE(KAE80C01/QXMLKAE)
TOFILE(ACG_OBJV3/QXMLKAE)
FROMMBR(*ALL)
TOMBR(*FROMMBR) MBROPT(*REPLACE)

ATTENZIONE: IL FILE QXMLKAE DEVE TROVARSI NELLA LISTA DI LIBRERIE QUANDO SI

RICHIEDE LA GENERAZIONE DEI FILE XML PREFERENZA - ACG_OBJV3

• Adeguamento librerie dati

Per ogni libreria dati aziendale già presente sul sistema prima della installazione della PTF, eseguire
da QPGMR il seguente comando:

KAE80C01/CVTK8C01 LIBRERIA(libreria-dati-aziendale)
LIBRERIC(libreria-dati-comune)
LIBRERIG(libreria-dati-gruppo)
LIBOBJ(ACG_OBJV3)
LIBFBAS(ACGFBASV3)

Tale comando esegue le seguenti operazioni:

1) crea gli archivi fisici:

GCDF300F
GCDL300F
GDDF300F
GDDL300F
GKPE300F
GPDF300F
XDFC300F
XDFD300F
XDFH300F
XKAE300F

2) crea gli archivi logici:

GCDF301L
GCDF302L
GCDL301L
GCDL302L
GCDL303L
GCDL304L
GDDF301L
GDDF302L
GDDF303L
GDDF304L
GDDF305L
GDDF306L
GDDF307L
GDDL301L
GDDL302L
GKPE300L
GPDF300L
XDFC300L
XDFC301L
XDFD300L

Lettera di accompagnamento PTF KAE80C01 9

 Note operative

XDFD301L
XDFD302L
XDFH300L
XDFH301L
XDFH302L
XDFH303L
XKAE301L

3) Crea le seguenti aree dati:

GDF2 - Controllo conflitti calcolo Dati Fatt.

GDF4 - Controllo conflitti calcolo Dati Fatt.

4) Modifica il menu:

CA28 - Altre elaborazioni periodiche/annuali

Aggiungendo il menu:
CKAE - Kit Adempimenti

5) Sposta in ACG_OBJV3 i seguenti oggetti:

di tipo *SRVPGM:
XMLKAE

di tipo *BNDDIR:
XMLKAE

Nota: Le modifiche ai menu sopra indicate si riferiscono ai menu standard distribuiti con i rilasci o
modificati da successive PTF.
Nei propri ambienti i menu possono risultare pertanto diversi; in questo caso le modifiche dovranno
essere in rapporto alla propria specifica situazione

Per modificare le impostazioni delle azioni/menu rispetto a quanto previsto al tool di adeguamento
eseguire la funzione di Gestione Ambiente ”Manutenzione File Menu" (richiamabile dal menu
"Gestione Azioni e Menu") e modificare i menu coinvolti.

Lettera di accompagnamento PTF KAE80C01 10

 Note operative

AGGIORNAMENTO WEB APPLICATION TS ENTERPRISE POWER-I

Livello compilazione Java: 1.6.0

Per l'aggiornamento delle funzioni dell'applicazione web far riferimento al paragrafo “Aggiornamento
applicazione web ACG Enterprise” del documento di installazione della PTF HBP110031C (o successive) del
Connettore TS Digital Invoice.

DOCUMENTAZIONE TECNICA

Questa PTF non prevede aggiornamenti della documentazione tecnica.

IMPLEMENTAZIONI

Per i contenuti applicativi fare riferimento alle lettere delle PTF singole fino alla PTF KAE80021.

Lettera di accompagnamento PTF KAE80C01 11