# Connettore Readytec Teamsystem Azienda - vtenext # Introduzione Note operative per configurazione connettore TeamSystem Azienda-CRM (v. 1.0) E’ stato sviluppato in TeamSystem Azienda, un connettore per estrarre massivamente - secondo un file di configurazione da personalizzare per cliente - i file da inviare al CRM. L’utilizzo di tale connettore è soggetto a licenza, che dovrà essere richiesta prima dell’installazione al rivenditore di riferimento, e indicata nel file di configurazione. [![image-1686921568947.png](https://usermanual.vtenext.com/uploads/images/gallery/2023-06/scaled-1680-/image-1686921568947.png)](https://usermanual.vtenext.com/uploads/images/gallery/2023-06/image-1686921568947.png) [![image-1686921639932.png](https://usermanual.vtenext.com/uploads/images/gallery/2023-06/scaled-1680-/image-1686921639932.png)](https://usermanual.vtenext.com/uploads/images/gallery/2023-06/image-1686921639932.png) # Connettore readytec teamsystem azienda - vtenext Il programma EXPCRM21, da copiare nella cartella \\gamma\\obj\\, elabora gli archivi e genera dei file distinti per anagrafica o documenti secondo le regole indicate nei file EXPCRM\*.INI presenti nella cartella CONTA degli archivi dell’applicativo. **Struttura dei file INI e parametri configurabili** Si tratta di semplici file di testo visualizzabili e modificabili con un qualsiasi editor. Il connettore è stato ideato per la gestione multi-aziendale, fino ad un massimo di 10 Aziende. **Gestione Multi-Azienda:** L’attivazione di tale gestione è automatica in presenza di un file .INI “padre” dove vengono elencate le ditte da gestire. Il file ini deve **obbligatoriamente** chiamarsi EXPCRMDT.INI ed al suo interno avere almeno una ditta gestita. **La mancanza di questo file INI presuppone la gestione del connettore Mono-Azienda. Es. file ini per multi azienda EXPCRMDT.INI (gestione ditta 15 e 222)**. [![image-1686923616932.png](https://usermanual.vtenext.com/uploads/images/gallery/2023-06/scaled-1680-/image-1686923616932.png)](https://usermanual.vtenext.com/uploads/images/gallery/2023-06/image-1686923616932.png) *Es. file ini per multi azienda EXPCRMDT.INI (gestione ditta 15 e 222)* Oltre a questo, dovranno esistere i file di configurazione (.INI) uno per ogni azienda, contenenti i parametri di estrazione degli archivi, con l’indicazione del codice ditta nel nome del file stesso. Es. per la ditta 15 il file si dovrà chiamare EXPCRM21\_0015.INI, per la ditta 222 sarà EXPCRM21\_0222.INI e così via per tutte le ditte. **NOTA: Il codice ditta è numerico di 4 caratteri per cui nel nome del file INI è necessario indicare anche gli 0(zeri) non significativi.** **Gestione Mono-Azienda:** L’unico file di configurazione che dovrà essere presente è EXPCRM21.INI dove saranno indicati tutti i parametri per l’estrazione degli archivi TeamSystem Azienda dell’unica ditta attiva. In entrambi i casi, gestione Mono o Multi Azienda, i file EXPCRM21\*.INI devono rispecchiare alcune regole di configurazione. Possono essere composti da illimitate righe dove in ogni riga viene indicato come primo dato il tipo di informazione (fisso da legenda), e il secondo dato riguarda il valore o i valori come limiti di selezione. Il primo parametro deve partire tassativamente dalla colonna 1, mentre il secondo dalla colonna 31. Al momento i parametri gestiti sono: **LICENZA** Codice Licenza Connettore rilasciato dal rivenditore (7 caratteri alfanumerici) **PATH** per indicare il percorso della cartella dove estrarre i file. Es:E:\\dataimp\\ Nel caso di gestione Multi-Azienda è consigliato gestire sotto cartelle differenti per ditta. N.B.: Non vengono lette le unità come mappature di rete, se si presenta la necessità di generare file su un percorso di rete è consigliabile appoggiarsi prima in una cartella locale e successivamente gestire un batch pianificato che ne fa la copia sul percorso desiderato. **DELIMITA** Codice delimitatore da utilizzare come separatore di colonne nel file generato. Es. ; , | (da evitare i caratteri ‘ e “ in quanto indicatori per caratteri stringhe) E’ stata inserita anche la possibilità di utilizzare il carattere “tabulazione” da indicare mediante la stringa TAB, verrà poi gestito dalla procedura con il rispettivo carattere secondo la tabella ASCII. Esempio DELIMITA TAB **DITTA** Indicare il codice ditta da elaborare **FILE-EXP** Questo parametro va ripetuto per ogni file che si desidera estrarre. Va indicato il file da estrarre e, separato da carattere “,” il nome fisico del file da generare. Es: ANMAG,CRM\_articoli.csv. Nel caso di gestione Multi-Azienda e non venga indicato il nome del file csv da generare, verrà creato il <nome file>\_<cod.ditta>.csv per tenerli distinti. I nomi dei file estraibili sono: ANMAG (anagrafiche articoli) ANCLI (anagrafiche clienti) ANFOR (anagrafiche fornitori) ANDST (anagrafiche destinazioni clienti) MAGPRO (progressivi con giacenze in tempo reale di magazzino) AGECLI (correlazione cliente -> cod.agente e capozona) viene estratto sempre se estratte le anagrafiche clienti, se viene indicato il nome successivamente alla “,” genera il file con quel nome, altrimenti impone fisso CRM\_agecli.csv da programma. MOVORD (ordini clienti) MOVBOL (documenti clienti) Se non vengono specificati i tipi documento da esportare tramite il parametri TIPO-BOLLA, estrae solamente i Documenti di Trasporto. MOVEFF (scadenziario clienti degli ultimi due esercizi contabili) MOVORD-FOR (ordini fornitori) MOVSTAT (dati statistici fatturato, ordinato e preventivato degli ultimi due mesi rapportati allo stesso periodo dell’anno precedente) ANDITTE (anagrafiche ditte per Studi) ANAGBAR (Barcode articoli) **TIPO-BOLLA** Tipo Documenti da esportare, controllato solamente se attiva l’estrazione dei documenti di MOVBOL. Sono stati previsti 5 tipi documento da estrarre, per esempio; 1. Documento di trasporto 2. Fattura accompagnatoria 3. Fattura immediata 4. Nota di credito 5. ecc… I parametri sono numerici, composti di due caratteri, dove è possibile omettere lo zero iniziale, ma vanno separati dal carattere “,” quale delimitatore. Tale carattere va in ogni caso indicato anche a fine riga. Es:1,2,3,4, **DEP-ANMAG** Nel caso venga richiesta l’estrazione dei progressivi di magazzino si possono indicare i limiti dei depositi da estrarre. Indicando solo un codice verrà estratto il dato per tale deposito, in alternativa è possibile indicare un limite minimo e massimo separato da “,”. Es: 0,1 **STAT1-ANMAG** Indicano i limiti di selezione per il primo codice statistico su anagrafica articoli. La stessa logica vale per tutti i 5 codici statistici. (STAT2-ANMAG…ecc) Es: 1,998 oppure solo 25 per estrarre solo gli articoli con cod. stat1 = 25. Parametro controllato solo in fase di estrazione anagrafiche articoli (ANMAG) **STAT1-ANCF** Indicano i limiti di selezione per i codici statistici su anagrafiche clienti. Vale la stessa logica utilizzata per i codici statistici di magazzino. Parametro controllato solo in fase di estrazione anagrafiche clienti (ANCLI) **STATO-EFF** Stato degli effetti da esportare, controllato solamente se attiva l’estrazione degli effetti MOVEFF. Sono stati previsti 4 filtri per lo stato dell’effetto; \* – Estrazione di tutti gli effetti clienti presenti in archivio C – Effetti Chiusi A – Effetti Aperti P – Effetti Presentati I – Effetti Insoluti Verranno controllati solamente i parametri contenuti nella lista precedentemente stilata (caratteri maiuscoli) e vengono accettati al massimo 4 filtri. Se uno dei filtri è “\*” tutti gli altri verranno inibiti. I filtri vanno separati dal carattere “,” quale delimitatore. Es: C,I, per estrarre gli effetti Chiusi e Insoluti. **TIPO-STAT** Dati statisti da esportare \*- Tutti F – Fatturato O – Ordinato P – Preventivato Verranno controllati solamente i parametri contenuti nella lista precedentemente stilata (caratteri maiuscoli) e vengono accettati al massimo 4 filtri. Se uno dei filtri è “\*” tutti gli altri verranno inibiti. I filtri vanno separati dal carattere “,” quale delimitatore. Es: F,O, per estrarre il fatturato e l’ordinato. Esempio di file EXPCRM21.INI o EXPCRM21\_<cod.ditta>.INI [![image-1686926064291.png](https://usermanual.vtenext.com/uploads/images/gallery/2023-06/scaled-1680-/image-1686926064291.png)](https://usermanual.vtenext.com/uploads/images/gallery/2023-06/image-1686926064291.png) Esempio file estratti [![image-1686926091009.png](https://usermanual.vtenext.com/uploads/images/gallery/2023-06/scaled-1680-/image-1686926091009.png)](https://usermanual.vtenext.com/uploads/images/gallery/2023-06/image-1686926091009.png) **L’esecuzione del connettore va schedulata secondo le regole di ATTSCHED negli orari desiderati (come indicato a pagina 13). Per testare la procedura prima di pianificarne l’esecuzione è possibile eseguirla dal comando EVRUN con switch blank.** **TRACCIATI EXPORT PER FILE** Ogni singolo file estratto ha una definizione di campi ben precisa, con ordine e dimensione impostata dalla procedura. Sono stati formattati i campi alfanumerici omettendo gli spazi non significativi e sostituiti eventuali caratteri “;” con un carattere blank prima di ogni scrittura per evitare problemi con il delimitatore. Di seguito i tracciati per ogni file estratto: **ANMAG – Articoli di magazzino:**
**Nome Campo ****Lunghezza max (interi.decimali) ****Tipo Carattere **
DITTA 4Numerico
CODICE ARTICOLO 20Alfanumerico
DESCRIZIONE ART 36Alfanumerico
DESCR. AGGIUNTIVA 36Alfanumerico
UNITA’ DI MISURA 2Alfanumerico
% ALIQUOTA IVA 3Numerico
PREZZO (1…8) 10.6 Numerico
SCONTO 1 (1…8) 03.2 Numerico
SCONTO 2 (1…8) 03.2 Numerico
SCONTO A IMPORTO (1…8) 09.6 Numerico
COSTO ULTIMO ACQUISTO 10.2 Numerico
FAMIGLIA 3Numerico
DESCRIZIONE FAMIGLIA 26Alfanumerico
SOTTOFAMIGLIA 3Numerico
DESCRIZIONE SOTTOFAMIGLIA 26Alfanumerico
GRUPPO 3Numerico
DESCRIZIONE GRUPPO 26Alfanumerico
SOTTOGRUPPO 3Numerico
DESCRIZIONE SOTTOGRUPPO 26Alfanumerico
PEZZI X CONFEZIONE 05.3 Numerico
PESO NETTO 04.3 Numerico
PESO LORDO 04.3 Numerico
UBICAZIONE 8Alfanumerico
UM SECONDARIA 2Alfanumerico
FATTORE DI CONVERS. UM2 04.5 Numerico
CODICE STATISTICO 1 3Numerico
DESCRIZIONE COD. STATISTICO 1 25Alfanumerico
CODICE STATISTICO 2 3Numerico
DESCRIZIONE COD. STATISTICO 2 25Alfanumerico
CODICE STATISTICO 3 3Numerico
DESCRIZIONE COD. STATISTICO 3 25Alfanumerico
CODICE STATISTICO 4 6Alfanumerico
DESCRIZIONE COD. STATISTICO 4 25Alfanumerico
CODICE STATISTICO 5 6Alfanumerico
DESCRIZIONE COD. STATISTICO 5 25Alfanumerico
MASSA NETTA 11.3 Numerico
BARCODE 20Alfanumerico
DATA CREAZIONE 10Data GG/MM/AAAA
**ANCLI – Anagrafiche clienti:**
**Nome Campo ****Lunghezza max (interi.decimali) ****Tipo Carattere **
DITTA 4Numerico
CODICE CLIENTE 5Numerico
RAGIONE SOCIALE 60Alfanumerico
INDIRIZZO 60Alfanumerico
CITTA 35Alfanumerico
CAP 5Numerico
PROVINCIA 2Alfanumerico
TELEFONO 24Alfanumerico
FAX 24Alfanumerico
PARTITA IVA 11Numerico
CODICE FISCALE 16Alfanumerico
SALDO CONTABILE 13.02 Numerico
NOTE CLIENTI 500Alfanumerico
CLIENTE BLOCCATO 1Alfanumerico (S/N)
CODICE BLOCCO 25Alfanumerico
DESCRIZIONE BLOCCO 30Alfanumerico
CODICE DI PAGAMENTO 3Numerico
CONDIZIONE DI PAGAMENTO 30Alfanumerico
CODICE IBAN 50Alfanumerico
EMAIL 70Alfanumerico
CELLULARE 20Alfanumerico
CATEGORIA 26Alfanumerico
CODICE STATISTICO 1 3Numerico
DESCR. CODICE STATISTICO 1 25Alfanumerico
CODICE STATISTICO 2 3Numerico
DESR. CODICE STATISTICO 2 25Alfanumerico
CODICE STATISTICO 3 3Numerico
DESR. CODICE STATISTICO 3 25Alfanumerico
CODICE STATISTICO 4 6Alfanumerico
DESR. CODICE STATISTICO 4 25Alfanumerico
CODICE STATISTICO 5 6Alfanumerico
DESR. CODICE STATISTICO 5 25Alfanumerico
DATA CREAZIONE 10Data GG/MM/AAAA
COD.DESTINAZIONE 3Numerico
AGENTE 4Numerico
**ANFOR – Anagrafiche fornitori**
**Nome Campo ****Lunghezza max (interi.decimali) ****Tipo Carattere **
DITTA 4Numerico
CODICE FORNITORE 5Numerico
RAGIONE SOCIALE 60Alfanumerico
INDIRIZZO 60Alfanumerico
CITTA 35Alfanumerico
CAP 5Numerico
PROVINCIA 2Alfanumerico
TELEFONO 24Alfanumerico
FAX 24Alfanumerico
PARTITA IVA 11Numerico
CODICE FISCALE 16Alfanumerico
EMAIL 70Alfanumerico
CELLULARE 20Alfanumerico
CODICE DI PAGAMENTO 3Numerico
CONDIZIONE DI PAGAMENTO 30Alfanumerico
**ANDST – Anagrafiche destinazioni clienti**
**Nome Campo ****Lunghezza max (interi.decimali) ****Tipo Carattere **
DITTA 4Numerico
CODICE UNIVOCO 15Alfanumerico (DITTA#COD.CLIENTE#COD.DEST)
CODICE CLIENTE 5Numerico
CODICE DESTINAZIONE 3Numerico
RAGIONE SOCIALE 30Alfanumerico
RAGIONE SOCIALE 2 30Alfanumerico
INDIRIZZO 30Alfanumerico
INDIRIZZO 2 30Alfanumerico
LOCALITA’ 30Alfanumerico
LOCALITA’ 2 30Alfanumerico
TELEFONO 22Alfanumerico
E MAIL 82Alfanumerico
COD. UFFICIO(SDI) 7Alfaumerico
**AGECLI – Correlazione Cliente -> Agente/Capozona**
**Nome Campo ****Lunghezza max (interi.decimali) ****Tipo Carattere **
DITTA 4Numerico
CODICE CLIENTE 5Numerico
AGENTE 4Numerico
CAPOZONA 4Numerico
**MAGPRO – Giacenze articoli**
**Nome Campo ****Lunghezza max (interi.decimali) ****Tipo Carattere **
DITTA 4Numerico
CODICE ARTICOLO 20Alfanumerico
DEPOSITO 3Numerico
GIACENZA ATTUALE 11.03 Numerico
IMPEGNATO CLIENTI 11.03 Numerico
ORDINATO A FORNITORI 11.03 Numerico
La generazione dei file relativi ai documenti di trasporto e ordini seguono la logica Testa/Corpo. Non viene gestito un tipo record, ma per ogni documento/ordine viene creata una prima riga (Testa) con i dati del documento e riga 0, poi di seguito tanti record per quanti sono gli articoli (Corpo). **MOVBOL – Bolle clienti emesse**
**Nome Campo ****Lunghezza max (interi.decimali) ****Tipo Carattere **
**Testa**** **** **
DITTA 4Numerico
COD IDENTIF. DOCUMENTO (ditta, anno, sezionale. Numero, cod.cliente) 23Alfanumerico
TIPO DOCUMENTO 1Numerico
CODICE CLIENTE 5Numerico
DATA DOCUMENTO 10Data GG/MM/AAAA
NUMERO DOCUMENTO/SEZ 10Alfanumerico 99999/999
TOTALE DOCUMENTO 10.2 Numerico
TOT IMPORTO MERCE LORDO 10.2 Numerico
DEPOSITO 3Numerico
AGENTE 4Numerico
CODICE PAGAMENTO 3Numerico
NUM.VS ORDINE 14Alfanumerico
DATA VS ORDINE 10Data GG/MM/AAAA
RIF. VS ORD 37Alfanumerico
NUM.CONFERMA ORDINE 10Alfanumerico 99999
SEZ.CONFERMA ORDINE 3Numerico
DATA CONFERMA ORDINE 10Data GG/MM/AAAA
NUM.FATTURA 6Numerico
DATA FATTURA 10Data GG/MM/AAAA
COD.DESTINAZIONE MERCE 5Numerico
PESO LORDO 07.3 Numerico
PESO NETTO 07.3 Numerico
NUM.COLLI 07.2 Numerico
**Corpo **
NUMERO RIGA CORPO 4Numerico
CODART 20Alfanumerico
DESCRIZIONE ARTICOLO 36Alfanumerico
DESCRIZIONE AGGIUNTIVA 36Alfanumerico
U.M. 2Alfanumerico
QUANTITA’ 08.3 Numerico
SCONTO 03.2 Numerico
PREZZO 10.6 Numerico
IMPORTO 11.2 Numerico
**MOVORD – Ordini**
**Nome Campo ****Lunghezza max (interi.decimali)****Tipo Carattere **
**Testa**
DITTA 4Numerico
COD IDENTIF. ORDINE (ditta, anno, sezionale. Numero, cod.cliente) 23Alfanumerico
CODICE CLIENTE 5Numerico
DATA ORDINE 10Data GG/MM/AAAA
NUMERO ORDINE/SEZ 10Alfanumerico 99999/999
TOTALE ORDINE 10.2 Numerico
TOT IMPORTO MERCE LORDO 10.2 Numerico
STATO PRELIEVO 13Alfanumerico
DEPOSITO 3Numerico
DATA CONSEGNA 10Data GG/MM/AAAA
AGENTE 4Numerico
CODICE PAGAMENTO 3Numerico
TIPO ORDINE (urgente/sospeso..) 15Alfanumerico
STATO CONFERMA 14Alfanumerico
STATO EVADIBILITA’ 13Alfanumerico
COD.DESTINAZIONE MERCE 5Numerico
PESO LORDO 07.3 Numerico
PESO NETTO 07.3 Numerico
NUM.COLLI 07.2 Numerico
**Corpo **
NUMERO RIGA CORPO 4Numerico
CODART 20Alfanumerico
DESCRIZIONE ARTICOLO 36Alfanumerico
DESCRIZIONE AGGIUNTIVA 36Alfanumerico
U.M. 2Alfanumerico
QUANTITA’ 08.3 Numerico
SCONTO 03.2 Numerico
PREZZO 10.6 Numerico
QUANTITA’ CONSEGNATA 9.3 Numerico
**MOVEFF – Situazione effetti clienti**
**Nome Campo ****Lunghezza max (interi.decimali) ****Tipo Carattere **
DITTA 4Numerico
TIPO MOVIMENTO 15Alfanumerico
PROGR. EFFETTO/NUM.RATA 2Numerico
CODICE CLIENTE 5Numerico
TIPO DOCUMENTO 24Alfanumerico
DATA SCADENZA 10Data GG/MM/AAAA
TIPO EFFETTO 17Alfanumerico
DATA DOCUMENTO 10Data GG/MM/AAAA
NUMERO DOCUMENTO/SEZ 9Alfanumerico 999999/99
TOTALE DOCUMENTO 12.2 Numerico
IMPORTO EFFETTO 12.2 Numerico
STATO PAGAM. EFFETTO 23Alfanumerico
IMPORTO PAGATO 12.2 Numerico
IMPORTO INSOLUTO 12.2 Numerico
**MOVORD-FOR – Ordini a Fornitore**
**Nome Campo ****Lunghezza max (interi.decimali) ****Tipo Carattere **
**Testa **
DITTA 4Numerico
COD IDENTIF. ORDINE (ditta, anno, sezionale. Numero, cod.fornitore) 23Alfanumerico
CODICE FORNITORE 5Numerico
DATA ORDINE 10Data GG/MM/AAAA
NUMERO ORDINE/SEZ 10Alfanumerico 99999/999
NUM. VS. ORDINE 14Alfanumerico
DATA VS. ORDINE 10Data GG/MM/AAAA
RIF. VS.ORDINE 37Rif.Vs Ordine
TOTALE ORDINE 10.2 Numerico
TOT IMPORTO MERCE LORDO 10.2 Numerico
STATO PRELIEVO 13Alfanumerico
DEPOSITO 3Numerico
DATA CONSEGNA 10Data GG/MM/AAAA
AGENTE 4Numerico
CODICE PAGAMENTO 3Numerico
TIPO ORDINE (urgente/sospeso..) 15Alfanumerico
STATO CONFERMA 14Alfanumerico
STATO EVADIBILITA’ 13Alfanumerico
COD.DESTINAZIONE MERCE 5Numerico
PESO LORDO 07.3 Numerico
PESO NETTO 07.3 Numerico
NUM.COLLI 07.2 Numerico
**Corpo **
NUMERO RIGA CORPO 4Numerico
CODART 20Alfanumerico
DESCRIZIONE ARTICOLO 36Alfanumerico
DESCRIZIONE AGGIUNTIVA 36Alfanumerico
U.M. 2Alfanumerico
QUANTITA’ 08.3 Numerico
SCONTO 03.2 Numerico
PREZZO 10.6 Numerico
QUANTITA’ CONSEGNATA 9.3 Numerico
**MOVSTAT – Dati statistici**
**Nome Campo ****Lunghezza max (interi.decimali) ****Tipo Carattere **
DITTA 4Numerico
CODICE CLIENTE 5Numerico
ANNO CORRENTE 4Numerico
MESE CORRENTE 2Numerico
PREVENTIVI AC/MP 12.2 Numerico
PREVENTIVI AP/MP 12.2 Numerico
DELTA PREV.MESE PRECEDENTE 12.2 Numerico
PREVENTIVI AC/MC 12.2 Numerico
PREVENTIVI AP/MC 12.2 Numerico
DELTA PREV.MESE CORRENTE 12.2 Numerico
ORDINI AC/MP 12.2 Numerico
ORDINI AP/MP 12.2 Numerico
DELTA ORD.MESE PRECEDENTE 12.2 Numerico
ORDINI AC/MC 12.2 Numerico
ORDINI AP/MC 12.2 Numerico
DELTA ORD.MESE CORRENTE 12.2 Numerico
FATTURATO AC/MP 12.2 Numerico
FATTURATO AP/MP 12.2 Numerico
DELTA VEND.MESE PRECEDENTE 12.2 Numerico
FATTURATO AC/MC 12.2 Numerico
FATTURATO AP/MC 12.2 Numerico
DELTA VEND.MESE CORRENTE 12.2 Numerico
**ANDITTE – Anagrafiche ditte**
**Nome Campo ****Lunghezza max (interi.decimali) ****Tipo Carattere **
DITTA 4Numerico
RAGIONE\_SOCIALE 60Alfanumerico
INDIRIZZO 40Alfanumerico
COMUNE 4Alfanumerico
CAP 5Numerico
LOCALITA' 35Alfanumerico
PROVINCIA 2Alfanumerico
RAGIONE\_SOCIALE ANAG. 60Alfanumerico
INDIRIZZO ANAG. 40Alfanumerico
COMUNE ANAG. 4Alfanumerico
CAP ANAG. 5Numerico
LOCALITA' ANAG 35Alfanumerico
PROVINCIA ANAG. 2Alfanumerico
INDIRIZZO LEGAL 40Alfanumerico
COMUNE LEGALE 4Alfanumerico
CAP LEGALE 5Numerico
LOCALITA' LEGALE 35Alfanumerico
PROVINCIA LEGALE 2Alfanumerico
TELEFONO 24Alfanumerico
FAX 24Alfanumerico
P.IVA 11Numerico
COD.FISCALE 16Alfanumerico
SESSO 1Alfanumerico
ALIAS 40Alfanumerico
DATA NASCITA 10Data GG/MM/AAAA
COMUNE NASCITA 35Alfanumerico
PROV. NASCITA 2Alfanumerico
STATO ESTERO 2Alfanumerico
NATURA GIURIDICA 40Alfanumerico
COD.ATT.ISTAT 5Alfanumerico
DESCR.ATTIVITA' 40Alfanumerico
COD.ATT.STUD.SET 5Numerico
SUB-ATT.STUD.SET 3Numerico
DATA INIZ.ATTIVITA' 10Data GG/MM/AAAA
DATA CESS.ATTIVITA' 10Data GG/MM/AAAA
ATT.STAGIONALE 1Alfanumerico
TIPO.CONTABIL. 1Alfanumerico
LIBERO PROFESS. 1Numerico (1-S/0-N)
ARTIGIANO 1Alfanumerico
TIP.LIQ.IVA 1Alfanumerico
GRUPPO CESP. 3Numerico
SPECIE CESP. 3Alfanumerico
DAT.CHIUS.BILANCIO 10Data GG/MM/AAAA
COD.ATECOFIN 5Alfanumerico
DT.ULT.FT.ACQ. 10Data GG/MM/AAAA
DT.ULT.FT.VEN. 10Data GG/MM/AAAA
DT.ULT.REGIST. 10Data GG/MM/AAAA
DT.ULT.REGISTRO VEND. 10Data GG/MM/AAAA
DT.ULT.REGISTRO ACQ. 10Data GG/MM/AAAA
DT.ULT.REGISTRO CORR 10Data GG/MM/AAAA
DAT.ST.LIQ.IVA 10Data GG/MM/AAAA
DT.ST.GIORNALE 10Data GG/MM/AAAA
COD.LEGALE RAPPR. 6Numerico
CARICA RAPP.LEGALE 60Alfanumerico
DT.ISCRIZ.R.I. 10Data GG/MM/AAAA
ISCRIZ.REA 12Alfanumerico
PROV.ISCR.RE 2Alfanumerico
DT.ISCRIZ.REA 10Data GG/MM/AAAA
ISCR.ALBO IMP 12Alfanumerico
DT.ISCRIZ.ALBO IMP. 10Data GG/MM/AAAA
ATECO 2007 6Alfanumerico
DITTA DISABILITATA 1Alfanumerico
DATA DISATTIV.DITTA 10Data GG/MM/AAAA
DATA TERM.SOCIETA' 10Data GG/MM/AAAA
RAG.SOCIALE LEG.RAPPR 60Alfanumerico
INDIRIZZO LEG.RAPPR 40Alfanumerico
CITTA LEG.RAPPR 35Alfanumerico
CAP LEG.RAPPR 5Numerico
PROV. LEG.RAPPR 2Alfanumerico
COD.FISC. LEG.RAPPR 16Alfanumerico
**ANAGBAR – Barcode Articoli**
**Nome Campo ****Lunghezza max (interi.decimali) ****Tipo Carattere **
DITTA 4Numerico
CODICE UNIVOCO BARCODE (DITTA#CODART#BARCODE) 50Alfanumerico
CODICE ARTICOLO 20Alfanumerico
DESCRIZIONE ARTICOLO 36Alfanumerico
BARCODE 20Alfanumerico
# Importazione documenti da crm a Teamsystem Azienda Il connettore prevede solamente dal lato TeamSystem Azienda l’estrazione dei file csv sopra descritti. Una volta elaborate le estrazioni dal CRM è necessario provvedere all’importazione schedulata per i documenti di trasporto emessi e gli ordini inseriti tramite i due tracciati di PERASCII. **Per poter utilizzare le procedure di import/export dati è necessario aver caricato su Polyedro la licenza relativa con codice 3158.** [![image-1686929345285.png](https://usermanual.vtenext.com/uploads/images/gallery/2023-06/scaled-1680-/image-1686929345285.png)](https://usermanual.vtenext.com/uploads/images/gallery/2023-06/image-1686929345285.png) # Importazione Bolle **Configurazione PERASCII** [![image-1686929440296.png](https://usermanual.vtenext.com/uploads/images/gallery/2023-06/scaled-1680-/image-1686929440296.png)](https://usermanual.vtenext.com/uploads/images/gallery/2023-06/image-1686929440296.png) **Definizione campi del tracciato** [![image-1686929612369.png](https://usermanual.vtenext.com/uploads/images/gallery/2023-06/scaled-1680-/image-1686929612369.png)](https://usermanual.vtenext.com/uploads/images/gallery/2023-06/image-1686929612369.png)[![image-1686929656445.png](https://usermanual.vtenext.com/uploads/images/gallery/2023-06/scaled-1680-/image-1686929656445.png)](https://usermanual.vtenext.com/uploads/images/gallery/2023-06/image-1686929656445.png) # Importazione Ordini **Configurazione PERASCII** [![image-1686929766900.png](https://usermanual.vtenext.com/uploads/images/gallery/2023-06/scaled-1680-/image-1686929766900.png)](https://usermanual.vtenext.com/uploads/images/gallery/2023-06/image-1686929766900.png) **Definizione campi del tracciato** [![image-1686929849116.png](https://usermanual.vtenext.com/uploads/images/gallery/2023-06/scaled-1680-/image-1686929849116.png)](https://usermanual.vtenext.com/uploads/images/gallery/2023-06/image-1686929849116.png) # Configurazione e schedulazione avvio connettore di estrazione Teamsystem Azienda-crm e importazione E’ possibile tramite lo schedulatore del Polyedro, generare e pianificare le attività di import/export in modo automatico e continuativo. **Configurazione estrazione dati massivi da EXPCRM21** Per prima cosa è necessario configurare tramite il comando ESTSCHED, la selezione personalizzata dove viene indicato il nome del programma da eseguire. [![image-1686929981976.png](https://usermanual.vtenext.com/uploads/images/gallery/2023-06/scaled-1680-/image-1686929981976.png)](https://usermanual.vtenext.com/uploads/images/gallery/2023-06/image-1686929981976.png) Successivamente in ATTSCHED – Gestione attività da schedulare, va generata una nuova attività (1) con la relativa azione da eseguire (2) 1\. Indicare l’orario di avvio ed eventuale ripetitività [![image-1686930019292.png](https://usermanual.vtenext.com/uploads/images/gallery/2023-06/scaled-1680-/image-1686930019292.png)](https://usermanual.vtenext.com/uploads/images/gallery/2023-06/image-1686930019292.png) 2\. In riferimento all’attività si possono generare diverse azioni ognuna delle quali richiama la selezione precedentemente generata con ESTSCHED. Associare l’attività da eseguire tramite il tasto “Elenco Funzioni”. [![image-1686930063725.png](https://usermanual.vtenext.com/uploads/images/gallery/2023-06/scaled-1680-/image-1686930063725.png)](https://usermanual.vtenext.com/uploads/images/gallery/2023-06/image-1686930063725.png) Una volta impostate le attività da schedulare va pianificata in Polyedro la relativa elaborazione dal menù Procedure Gestionali -> Amministrazione -> Pianifica programmi. [![image-1686930096846.png](https://usermanual.vtenext.com/uploads/images/gallery/2023-06/scaled-1680-/image-1686930096846.png)](https://usermanual.vtenext.com/uploads/images/gallery/2023-06/image-1686930096846.png) Selezionare il contesto all’interno dell’ambiente dove è stata generata la schedulazione, il Nome Programma FSCHEDULA, il tipo di ripetizione e la data di inizio attività. Indicare eventuali destinatari mail se si vuole ricevere l’esito dell’elaborazione, dopo aver selezionato il flag relativo. Con il tasto Pianifica Attività viene generato sul portale la pianificazione dell’elaborazione. [![image-1686930150497.png](https://usermanual.vtenext.com/uploads/images/gallery/2023-06/scaled-1680-/image-1686930150497.png)](https://usermanual.vtenext.com/uploads/images/gallery/2023-06/image-1686930150497.png) [![image-1686930165785.png](https://usermanual.vtenext.com/uploads/images/gallery/2023-06/scaled-1680-/image-1686930165785.png)](https://usermanual.vtenext.com/uploads/images/gallery/2023-06/image-1686930165785.png) **Configurazione importazione ordini e bolle da CRM** La stessa procedura di configurazione va seguita per la schedulazione dei programmi di importazione da CRM. L’unica differenza in fase di settaggio delle operazioni, riguarda l’obbligatorietà di indicazione della ditta da elaborare e della cartella del server dalla quale importare i dati. [![image-1686930244629.png](https://usermanual.vtenext.com/uploads/images/gallery/2023-06/scaled-1680-/image-1686930244629.png)](https://usermanual.vtenext.com/uploads/images/gallery/2023-06/image-1686930244629.png) Tramite il tasto Dispositivi/Cartelle impostare il percorso dei file da importare [![image-1686930263067.png](https://usermanual.vtenext.com/uploads/images/gallery/2023-06/scaled-1680-/image-1686930263067.png)](https://usermanual.vtenext.com/uploads/images/gallery/2023-06/image-1686930263067.png) Mentre la ditta va selezionata accedendo al tasto Aziende. [![image-1686930280864.png](https://usermanual.vtenext.com/uploads/images/gallery/2023-06/scaled-1680-/image-1686930280864.png)](https://usermanual.vtenext.com/uploads/images/gallery/2023-06/image-1686930280864.png) Vanno poi generate le azioni di importazione sia per le bolle che per gli ordini dopo aver memorizzato le selezioni in IMPASCII relative ai tracciati precedentemente settati. [![image-1686930310762.png](https://usermanual.vtenext.com/uploads/images/gallery/2023-06/scaled-1680-/image-1686930310762.png)](https://usermanual.vtenext.com/uploads/images/gallery/2023-06/image-1686930310762.png) [![image-1686930322445.png](https://usermanual.vtenext.com/uploads/images/gallery/2023-06/scaled-1680-/image-1686930322445.png)](https://usermanual.vtenext.com/uploads/images/gallery/2023-06/image-1686930322445.png) # Installazione bundle modulo extension vtenext e attivazione schedulazione script esportazione da crm Il file archivio in formato zip ReadytecCRMAppCron.zip contiene il “bundle”, ovvero pacchetto di installazione di un modulo in vtenext che permette di 1. Registrare i campi personalizzati per indicare quali ordini di vendita (SalesOrder) sono da esportare e quali sono stati effettivamente esportati verso l’ERP TeamSystem Azienda di TeamSystem 2. Registrare nello schedulatore di vtenext (ovvero la tabella vte\_cronjobs, nel database del crm) al fine di rendere automatica l’esecuzione dello script contenuto nel bundle che produce il tracciato ascii compatibile con l’importatore (IMPASCII) dell’ERP TeamSystem Azienda precedentemente installato. Per procedere con l’installazione, andare con utente amministratore nelle impostazioni di vtenext e selezionare la voce “Gestore Moduli”. Nella scheda “Moduli Personalizzati” cliccare sul pulsante “Importa nuovo modulo”. [![image-1686923145419.png](https://usermanual.vtenext.com/uploads/images/gallery/2023-06/scaled-1680-/image-1686923145419.png)](https://usermanual.vtenext.com/uploads/images/gallery/2023-06/image-1686923145419.png) Tramite il pulsante per scegliere il file, caricare il file zip contenuto nel pacchetto software oggetto di questa guida denominato “ReadytecCRMAppCron.zip”. [![image-1686923176293.png](https://usermanual.vtenext.com/uploads/images/gallery/2023-06/scaled-1680-/image-1686923176293.png)](https://usermanual.vtenext.com/uploads/images/gallery/2023-06/image-1686923176293.png) Se il file non è corrotto comparirà la maschera seguente che indica che il bundle è pronto per l’installazione; nota bene: la versione minima di vtenext è la 20.04. [![image-1686923207440.png](https://usermanual.vtenext.com/uploads/images/gallery/2023-06/scaled-1680-/image-1686923207440.png)](https://usermanual.vtenext.com/uploads/images/gallery/2023-06/image-1686923207440.png) Avviando l’importazione si riceverà una sequenza di messaggi a video che mostrano la corretta installazione dei campi personalizzati e delle loro traduzioni: tali campi sono necessari per la corretta esecuzione dello script php che viene creato e salvato dal bundle nella apposita cartella contenente gli script “cron” (ovvero passibili di schedulazione da parte di vtenext). [![image-1686923244534.png](https://usermanual.vtenext.com/uploads/images/gallery/2023-06/scaled-1680-/image-1686923244534.png)](https://usermanual.vtenext.com/uploads/images/gallery/2023-06/image-1686923244534.png) L’immagine qui sopra evidenzia che se l’installazinoe del pacchetto zip in vtenext è andata a buon fine avremo un nuovo pannello denominato “Readytec CRM App” nel modulo “ordini di vendita” (SalesOrder) contentente, fra eventuali altri campi personalizzati, i due “checkbox”: - Esportare in ERP - Esportato in ERP **N.B.:** l’installazione del bundle registra la procedura di estrazione dal modulo ma non la attiva: per farlo è necessario manualmente dal database (almeno nella versione attuale 21.xy di vtenext) impostare il campo “active” in corrispondenza con il “cronjob” denominato “ReadytecCRMApp”. Sempre da tale tabella è possibile cambiare il periodo di ricorrenza dell’esecuzione in minuti ed altri parametri per i quali fare riferimento alla documentazione standard dei cron job (procedure pianificate) del crm. # Impostazione del trasferimento dei tracciati generati dal connettore teamsystem azienda verso il crm vtenext e dal crm verso l’erp Il software gestionale TeamSystem Azienda (già noto da anni come Gamma Plus o Gamma Evolution) è un ERP di lungo corso realizzato in COBOL non open-source. Per questo motivo è stato possibile realizzare un connettore di estrazione dati nativo nel linguaggio dell’ERP che genera tracciati subito pronti per esser importati con la tecnologia “Data Importer” standard in vtenext (versione minima 20.04). Viceversa, la “business logic” dell’ERP non ammette la scrittura nativa negli archivi COBOL per quanto riguarda l’importazione di bolle (ddt/rapportini/voucher/buoni di lavoro/ecc.) e/o ordini di vendita. Dunque, per fare ciò il connettore prevede dei tracciati di importazione in TeamSystem Azienda già pronti e preconfigurati per accettare i file ascii csv generati dallo script php installabile seguendo la guida descritta nel capitolo precedente. Lo scambio di file può avvenire generalmente tramite tre paradigmi: 1. Se l’ambiente linux server del crm vtenext è nella stessa infrastruttura LAN o WLAN del gestionale TeamSystema Azienda ed anche quest’ultimo è installato su piattaforma linux, sarà sufficiente impostare nel file ini (di configurazione del connettore COBOL descritto nel primo capitolo) il percorso di un volume di rete montato (o un link simbolico) coincidente con la cartella “dataimporter” di vtenext 2. Se i server CRM e ERP sono in LAN o WLAN ma il gestionale ERP è installato in ambiente Windows è suggerito ricorrere ad intervento sistemistico per permettere la condivisione di una cartella fra i due software: obiettivo finale rimane comunque per vtenext trovare i file ascii generati dal connettore readytec nella propria cartella “dataimproter” (nella root dell’installazione vtenext) e dall’altra parte, impostare la cartella di prelievo dei file impostati con il comando PERASCII di TeamSystem Azienda da importare tramite i tracciati importati (bolseq\_crm\_in e/o ordseq\_crm\_in) Se i server sono su ambiente cloud o comunque in infrastrutture remote, si suggerisce l’utilizzo di software quali WinSCP per lo scambio dei tracciati, o di comandi linux quali “mget” per importare i tracciati e “curl” con l’opzione -T per esportare da ERP a CRM (supponendo di avere un ftp server sul server linux del vtenext).