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

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

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

Esempio file estratti

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 4 Numerico
CODICE ARTICOLO 20 Alfanumerico
DESCRIZIONE ART 36 Alfanumerico
DESCR. AGGIUNTIVA 36 Alfanumerico
UNITA’ DI MISURA 2 Alfanumerico
% ALIQUOTA IVA 3 Numerico
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 3 Numerico
DESCRIZIONE FAMIGLIA 26 Alfanumerico
SOTTOFAMIGLIA 3 Numerico
DESCRIZIONE SOTTOFAMIGLIA 26 Alfanumerico
GRUPPO 3 Numerico
DESCRIZIONE GRUPPO 26 Alfanumerico
SOTTOGRUPPO 3 Numerico
DESCRIZIONE SOTTOGRUPPO 26 Alfanumerico
PEZZI X CONFEZIONE 05.3 Numerico
PESO NETTO 04.3 Numerico
PESO LORDO 04.3 Numerico
UBICAZIONE 8 Alfanumerico
UM SECONDARIA 2 Alfanumerico
FATTORE DI CONVERS. UM2 04.5 Numerico
CODICE STATISTICO 1 3 Numerico
DESCRIZIONE COD. STATISTICO 1 25 Alfanumerico
CODICE STATISTICO 2 3 Numerico
DESCRIZIONE COD. STATISTICO 2 25 Alfanumerico
CODICE STATISTICO 3 3 Numerico
DESCRIZIONE COD. STATISTICO 3 25 Alfanumerico
CODICE STATISTICO 4 6 Alfanumerico
DESCRIZIONE COD. STATISTICO 4 25 Alfanumerico
CODICE STATISTICO 5 6 Alfanumerico
DESCRIZIONE COD. STATISTICO 5 25 Alfanumerico
MASSA NETTA 11.3 Numerico
BARCODE 20 Alfanumerico
DATA CREAZIONE 10 Data GG/MM/AAAA

ANCLI – Anagrafiche clienti:

Nome Campo Lunghezza max (interi.decimali) Tipo Carattere
DITTA 4 Numerico
CODICE CLIENTE 5 Numerico
RAGIONE SOCIALE 60 Alfanumerico
INDIRIZZO 60 Alfanumerico
CITTA 35 Alfanumerico
CAP 5 Numerico
PROVINCIA 2 Alfanumerico
TELEFONO 24 Alfanumerico
FAX 24 Alfanumerico
PARTITA IVA 11 Numerico
CODICE FISCALE 16 Alfanumerico
SALDO CONTABILE 13.02 Numerico
NOTE CLIENTI 500 Alfanumerico
CLIENTE BLOCCATO 1 Alfanumerico (S/N)
CODICE BLOCCO 25 Alfanumerico
DESCRIZIONE BLOCCO 30 Alfanumerico
CODICE DI PAGAMENTO 3 Numerico
CONDIZIONE DI PAGAMENTO 30 Alfanumerico
CODICE IBAN 50 Alfanumerico
EMAIL 70 Alfanumerico
CELLULARE 20 Alfanumerico
CATEGORIA 26 Alfanumerico
CODICE STATISTICO 1 3 Numerico
DESCR. CODICE STATISTICO 1 25 Alfanumerico
CODICE STATISTICO 2 3 Numerico
DESR. CODICE STATISTICO 2 25 Alfanumerico
CODICE STATISTICO 3 3 Numerico
DESR. CODICE STATISTICO 3 25 Alfanumerico
CODICE STATISTICO 4 6 Alfanumerico
DESR. CODICE STATISTICO 4 25 Alfanumerico
CODICE STATISTICO 5 6 Alfanumerico
DESR. CODICE STATISTICO 5 25 Alfanumerico
DATA CREAZIONE 10 Data GG/MM/AAAA
COD.DESTINAZIONE 3 Numerico
AGENTE 4 Numerico

ANFOR – Anagrafiche fornitori

Nome Campo Lunghezza max (interi.decimali) Tipo Carattere
DITTA 4 Numerico
CODICE FORNITORE 5 Numerico
RAGIONE SOCIALE 60 Alfanumerico
INDIRIZZO 60 Alfanumerico
CITTA 35 Alfanumerico
CAP 5 Numerico
PROVINCIA 2 Alfanumerico
TELEFONO 24 Alfanumerico
FAX 24 Alfanumerico
PARTITA IVA 11 Numerico
CODICE FISCALE 16 Alfanumerico
EMAIL 70 Alfanumerico
CELLULARE 20 Alfanumerico
CODICE DI PAGAMENTO 3 Numerico
CONDIZIONE DI PAGAMENTO 30 Alfanumerico

ANDST – Anagrafiche destinazioni clienti

Nome Campo Lunghezza max (interi.decimali) Tipo Carattere
DITTA 4 Numerico
CODICE UNIVOCO 15 Alfanumerico (DITTA#COD.CLIENTE#COD.DEST)
CODICE CLIENTE 5 Numerico
CODICE DESTINAZIONE 3 Numerico
RAGIONE SOCIALE 30 Alfanumerico
RAGIONE SOCIALE 2 30 Alfanumerico
INDIRIZZO 30 Alfanumerico
INDIRIZZO 2 30 Alfanumerico
LOCALITA’ 30 Alfanumerico
LOCALITA’ 2 30 Alfanumerico
TELEFONO 22 Alfanumerico
E MAIL 82 Alfanumerico
COD. UFFICIO(SDI) 7 Alfaumerico

AGECLI – Correlazione Cliente -> Agente/Capozona

Nome Campo Lunghezza max (interi.decimali) Tipo Carattere
DITTA 4 Numerico
CODICE CLIENTE 5 Numerico
AGENTE 4 Numerico
CAPOZONA 4 Numerico

MAGPRO – Giacenze articoli

Nome Campo Lunghezza max (interi.decimali) Tipo Carattere
DITTA 4 Numerico
CODICE ARTICOLO 20 Alfanumerico
DEPOSITO 3 Numerico
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 4 Numerico
COD IDENTIF. DOCUMENTO
(ditta, anno, sezionale. Numero, cod.cliente)
23 Alfanumerico
TIPO DOCUMENTO 1 Numerico
CODICE CLIENTE 5 Numerico
DATA DOCUMENTO 10 Data GG/MM/AAAA
NUMERO DOCUMENTO/SEZ 10 Alfanumerico 99999/999
TOTALE DOCUMENTO 10.2 Numerico
TOT IMPORTO MERCE LORDO 10.2 Numerico
DEPOSITO 3 Numerico
AGENTE 4 Numerico
CODICE PAGAMENTO 3 Numerico
NUM.VS ORDINE 14 Alfanumerico
DATA VS ORDINE 10 Data GG/MM/AAAA
RIF. VS ORD 37 Alfanumerico
NUM.CONFERMA ORDINE 10 Alfanumerico 99999
SEZ.CONFERMA ORDINE 3 Numerico
DATA CONFERMA ORDINE 10 Data GG/MM/AAAA
NUM.FATTURA 6 Numerico
DATA FATTURA 10 Data GG/MM/AAAA
COD.DESTINAZIONE MERCE 5 Numerico
PESO LORDO 07.3 Numerico
PESO NETTO 07.3 Numerico
NUM.COLLI 07.2 Numerico
Corpo    
NUMERO RIGA CORPO 4 Numerico
CODART 20 Alfanumerico
DESCRIZIONE ARTICOLO 36 Alfanumerico
DESCRIZIONE AGGIUNTIVA 36 Alfanumerico
U.M. 2 Alfanumerico
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 4 Numerico
COD IDENTIF. ORDINE
(ditta, anno, sezionale. Numero, cod.cliente)
23 Alfanumerico
CODICE CLIENTE 5 Numerico
DATA ORDINE 10 Data GG/MM/AAAA
NUMERO ORDINE/SEZ 10 Alfanumerico 99999/999
TOTALE ORDINE 10.2 Numerico
TOT IMPORTO MERCE LORDO 10.2 Numerico
STATO PRELIEVO 13 Alfanumerico
DEPOSITO 3 Numerico
DATA CONSEGNA 10 Data GG/MM/AAAA
AGENTE 4 Numerico
CODICE PAGAMENTO 3 Numerico
TIPO ORDINE (urgente/sospeso..) 15 Alfanumerico
STATO CONFERMA 14 Alfanumerico
STATO EVADIBILITA’ 13 Alfanumerico
COD.DESTINAZIONE MERCE 5 Numerico
PESO LORDO 07.3 Numerico
PESO NETTO 07.3 Numerico
NUM.COLLI 07.2 Numerico
Corpo
NUMERO RIGA CORPO 4 Numerico
CODART 20 Alfanumerico
DESCRIZIONE ARTICOLO 36 Alfanumerico
DESCRIZIONE AGGIUNTIVA 36 Alfanumerico
U.M. 2 Alfanumerico
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 4 Numerico
TIPO MOVIMENTO 15 Alfanumerico
PROGR. EFFETTO/NUM.RATA 2 Numerico
CODICE CLIENTE 5 Numerico
TIPO DOCUMENTO 24 Alfanumerico
DATA SCADENZA 10 Data GG/MM/AAAA
TIPO EFFETTO 17 Alfanumerico
DATA DOCUMENTO 10 Data GG/MM/AAAA
NUMERO DOCUMENTO/SEZ 9 Alfanumerico 999999/99
TOTALE DOCUMENTO 12.2 Numerico
IMPORTO EFFETTO 12.2 Numerico
STATO PAGAM. EFFETTO 23 Alfanumerico
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 4 Numerico
COD IDENTIF. ORDINE
(ditta, anno, sezionale. Numero, cod.fornitore)
23 Alfanumerico
CODICE FORNITORE 5 Numerico
DATA ORDINE 10 Data GG/MM/AAAA
NUMERO ORDINE/SEZ 10 Alfanumerico 99999/999
NUM. VS. ORDINE 14 Alfanumerico
DATA VS. ORDINE 10 Data GG/MM/AAAA
RIF. VS.ORDINE 37 Rif.Vs Ordine
TOTALE ORDINE 10.2 Numerico
TOT IMPORTO MERCE LORDO 10.2 Numerico
STATO PRELIEVO 13 Alfanumerico
DEPOSITO 3 Numerico
DATA CONSEGNA 10 Data GG/MM/AAAA
AGENTE 4 Numerico
CODICE PAGAMENTO 3 Numerico
TIPO ORDINE (urgente/sospeso..) 15 Alfanumerico
STATO CONFERMA 14 Alfanumerico
STATO EVADIBILITA’ 13 Alfanumerico
COD.DESTINAZIONE MERCE 5 Numerico
PESO LORDO 07.3 Numerico
PESO NETTO 07.3 Numerico
NUM.COLLI 07.2 Numerico
Corpo
NUMERO RIGA CORPO 4 Numerico
CODART 20 Alfanumerico
DESCRIZIONE ARTICOLO 36 Alfanumerico
DESCRIZIONE AGGIUNTIVA 36 Alfanumerico
U.M. 2 Alfanumerico
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 4 Numerico
CODICE CLIENTE 5 Numerico
ANNO CORRENTE 4 Numerico
MESE CORRENTE 2 Numerico
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 4 Numerico
RAGIONE_SOCIALE 60 Alfanumerico
INDIRIZZO 40 Alfanumerico
COMUNE 4 Alfanumerico
CAP 5 Numerico
LOCALITA' 35 Alfanumerico
PROVINCIA 2 Alfanumerico
RAGIONE_SOCIALE ANAG. 60 Alfanumerico
INDIRIZZO ANAG. 40 Alfanumerico
COMUNE ANAG. 4 Alfanumerico
CAP ANAG. 5 Numerico
LOCALITA' ANAG 35 Alfanumerico
PROVINCIA ANAG. 2 Alfanumerico
INDIRIZZO LEGAL 40 Alfanumerico
COMUNE LEGALE 4 Alfanumerico
CAP LEGALE 5 Numerico
LOCALITA' LEGALE 35 Alfanumerico
PROVINCIA LEGALE 2 Alfanumerico
TELEFONO 24 Alfanumerico
FAX 24 Alfanumerico
P.IVA 11 Numerico
COD.FISCALE 16 Alfanumerico
SESSO 1 Alfanumerico
ALIAS 40 Alfanumerico
DATA NASCITA 10 Data GG/MM/AAAA
COMUNE NASCITA 35 Alfanumerico
PROV. NASCITA 2 Alfanumerico
STATO ESTERO 2 Alfanumerico
NATURA GIURIDICA 40 Alfanumerico
COD.ATT.ISTAT 5 Alfanumerico
DESCR.ATTIVITA' 40 Alfanumerico
COD.ATT.STUD.SET 5 Numerico
SUB-ATT.STUD.SET 3 Numerico
DATA INIZ.ATTIVITA' 10 Data GG/MM/AAAA
DATA CESS.ATTIVITA' 10 Data GG/MM/AAAA
ATT.STAGIONALE 1 Alfanumerico
TIPO.CONTABIL. 1 Alfanumerico
LIBERO PROFESS. 1 Numerico (1-S/0-N)
ARTIGIANO 1 Alfanumerico
TIP.LIQ.IVA 1 Alfanumerico
GRUPPO CESP. 3 Numerico
SPECIE CESP. 3 Alfanumerico
DAT.CHIUS.BILANCIO 10 Data GG/MM/AAAA
COD.ATECOFIN 5 Alfanumerico
DT.ULT.FT.ACQ. 10 Data GG/MM/AAAA
DT.ULT.FT.VEN. 10 Data GG/MM/AAAA
DT.ULT.REGIST. 10 Data GG/MM/AAAA
DT.ULT.REGISTRO VEND. 10 Data GG/MM/AAAA
DT.ULT.REGISTRO ACQ. 10 Data GG/MM/AAAA
DT.ULT.REGISTRO CORR 10 Data GG/MM/AAAA
DAT.ST.LIQ.IVA 10 Data GG/MM/AAAA
DT.ST.GIORNALE 10 Data GG/MM/AAAA
COD.LEGALE RAPPR. 6 Numerico
CARICA RAPP.LEGALE 60 Alfanumerico
DT.ISCRIZ.R.I. 10 Data GG/MM/AAAA
ISCRIZ.REA 12 Alfanumerico
PROV.ISCR.RE 2 Alfanumerico
DT.ISCRIZ.REA 10 Data GG/MM/AAAA
ISCR.ALBO IMP 12 Alfanumerico
DT.ISCRIZ.ALBO IMP. 10 Data GG/MM/AAAA
ATECO 2007 6 Alfanumerico
DITTA DISABILITATA 1 Alfanumerico
DATA DISATTIV.DITTA 10 Data GG/MM/AAAA
DATA TERM.SOCIETA' 10 Data GG/MM/AAAA
RAG.SOCIALE LEG.RAPPR 60 Alfanumerico
INDIRIZZO LEG.RAPPR 40 Alfanumerico
CITTA LEG.RAPPR 35 Alfanumerico
CAP LEG.RAPPR 5 Numerico
PROV. LEG.RAPPR 2 Alfanumerico
COD.FISC. LEG.RAPPR 16 Alfanumerico

ANAGBAR – Barcode Articoli

Nome Campo Lunghezza max (interi.decimali) Tipo Carattere
DITTA 4 Numerico
CODICE UNIVOCO BARCODE (DITTA#CODART#BARCODE) 50 Alfanumerico
CODICE ARTICOLO 20 Alfanumerico
DESCRIZIONE ARTICOLO 36 Alfanumerico
BARCODE 20 Alfanumerico

 

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

Importazione Bolle

Configurazione PERASCII

image-1686929440296.png

Definizione campi del tracciato

image-1686929612369.pngimage-1686929656445.png

Importazione Ordini

Configurazione PERASCII

image-1686929766900.png

Definizione campi del tracciato

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

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

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

Una volta impostate le attività da schedulare va pianificata in Polyedro la relativa elaborazione dal menù Procedure Gestionali -> Amministrazione -> Pianifica programmi.

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

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

Tramite il tasto Dispositivi/Cartelle impostare il percorso dei file da importare

image-1686930263067.png

Mentre la ditta va selezionata accedendo al tasto Aziende.

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

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

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

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

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

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”:

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).