GESTIONE NUOVO CLIENTE PER ZIPPY EVOLUTION

Transcript

1 GESTIONE NUOVO CLIENTE PER ZIPPY EVOLUTION 1. GESTIONE CLIENTE NUOVO E MODIFICA DI CLIENTE ESISTENTE Tramite questa procedura si vuole andare a gestire la modifica di un cliente esistente e l inserimento di un nuovo cliente secondo una configurazione dei dati da compilare. Questa procedura sarà differente da quella esistente che continuerà comunque a coesistere nel sistema e che verrà differenziata tramite l invio di un file XML di configurazione. Il gestionale dovrà inviare una tantum un file XML che indicherà al sistema come gestire i campi dell anagrafica del cliente: NUMERO_DESTINAZIONI: deve contenere il numero di destinazioni richieste in fase di inserimento nuovo cliente. Se 0 non vengono richieste destinazioni. INTESTAZIONE: deve contenere SI se la definizione della colonna riguarda un intestazione; deve contenere NO se la definizione della colonna riguarda una destinazione. OBBLIGATORIA: valori SI/NO. Viene presa in considerazione solo nel caso di una destinazione e indica al sistema se la compilazione deve essere obbligatoria o meno. DEFINIZIONE OBBLIGATORIO: deve contenere SI se si vuole rendere obbligatorio il campo; deve contenere NO se non si vuole rendere obbligatorio il campo CODICE: nome del campo; deve contenere un valore univoco; non può contenere caratteri vuoti; può contenere lettere, numeri e underscore _ ; questo valore può essere relativo al nome di un campo dell anagrafica cliente oppure no; ad esempio si vogliono andare a gestire dei campi custom in aggiunta allo standard Zippy e che sono solo di intervista per implementare le informazioni da inserire nell anagrafica del gestionale. Più avanti si andrà a descrivere i nomi dei campi dell anagrafica del cliente di ZippyEvolution. TIPO: tipologia di campo e relativo valore: a NUMERICO: verranno effettuati i controlli per un campo numerico b DECIMALE:verranno effettuati tutti controlli e formattazioni per un campo decimale (numero decimali fissi a 2) Pagina n.1

2 c TESTO: può contenere qualsiasi carattere alfanumerico d CHECK: può contenere valori true o false e DATA: verranno effettuati i controlli per un campo data f PARTITAIVA: verranno effettuati i controlli per un valore valido come partita iva g CODICEFISCALE: verranno effettuati i controlli per un valore valido come codice fiscale VINCOLI: se il valore contenuto in questo campo deve fare riferimento ad uno racchiusi in un insieme di valori possibili. a VALORE: valore da ritornare b DESCRIZIONE: descrizione da visualizzare DEFAULT: eventuale valore di default da assegnare NASCOSTO: deve contenere SI se si vuole nascondere la richiesta di compilazione del campo. Ad esempio per il tipo di pagamento non vado a richiedere all agente la compilazione e metto il valore di DEFAULT del codice di pagamento e NASCOSTO a SI. OBBLIGATORIOSEVUOTO: deve contenere il nome del campo dipendente dall obbligatorietà di valorizzazione o meno di questo campo. Ad esempio di vuole che venga compilato o la PARTITA IVA o il CODICE FISCALE; nella definizione del campo PARTITA IVA in questo attributo metto il nome del campo del CODICE FISCALE e viceversa. UNIVOCO: deve contenere SI se si vuole che il valore di questo campo sia univoco all interno della lista delle anagrafiche. Ad esempio non voglio che viene inserita una anagrafica con una partita iva già presente nella lista. Il sistema (anche degli XML) è case sensitive. Questo vuol dire che la definizione e/o i possibili valori devono essere indicati con il maiuscolo/minuscolo definito in questa guida. La gestione seguirà lo standard di sviluppo interfacce con files XML per questo motivo nello sviluppo dell interfaccia il gestionale dovrà seguire le regole standard: i nodi di un file xml non devono avere per forza un ordine preciso. Questo vuol dire che se in questa fase il nodo DEFAULT è stato indicato come penultimo non è detto che nel file viene generato per primo. I nodi sono case sensitive; quindi il maiuscolo/minuscolo deve rispettare l indicazione di questa guida In fase di sviluppo acquisizione files nuovi clienti e modifiche clienti, l interfaccia deve essere costruita leggendo i nodi non per posizione/riga del file proprio per quello spiegato al punto 1. Inoltre la stessa struttura dell anagrafica del cliente nel tempo potrebbe avere delle variazioni che non devono assolutamente implicare la gestione dell acquisizione da parte Pagina n.2

3 del gestionale, anche se queste non vengono comunicate in quanto potrebbero essere delle informazioni di appoggio di sistema. Di seguito l attuale definizione dei campi dell anagrafica del cliente: Descrizione PartitaIVA CodiceFiscale Indirizzo Cap Localita Provincia Zona Pagamento Sconto1 Sconto2 Sconto3 CodiceEsenzione CodiceListino Valuta GruppoListino StatoCF CodiceAgente Telefono Giro Sequenza DocumentoAbituale TipoValorizzazioneDDT GestioneCessionario ModificaPrezziAbilitata ModificaScontiAbilitata; StampaPezzi TipoOmaggio CodiceAlias _MonteOmaggio _ImportoFidoMassimo _NumeroMassimoPartiteAperte _NumeroMassimoGiorniScoperto _NonControllaFidoSeIncasso _GruppoClienteCanvas _MarginalitaMinima _GGRitardoPagamenti _Fax _SitoInternet _CciaaRea _Pec _FatturatoMensilePrevisto _Banca1 _Banca2 _Note _ResponsabileOrdini _... Tutti i campi dell anagrafica del cliente devono essere inviati su ANAGRAFE.txt Tutti i campi personalizzati (quelli nel quale il nome inizia per _ ) devono essere inviati su ANAGRAFE_PERS.txt Il campo CODICE (codice del cliente) è un nome privato e per i nuovi clienti verrà generato in automatico. Pagina n.3

4 Di seguito un esempio del file XML che può essere fornito: <ANAGRAFE_CUSTOM> <NUMERO_DESTINAZIONI>1</NUMERO_DESTINAZIONI> <ANAG> <INTESTAZIONE>SI</INTESTAZIONE> <OBBLIGATORIA>SI</OBBLIGATORIA> <DEFINIZIONE> <CODICE>Descrizione</CODICE> <DESCRIZIONE>Ragione Sociale</DESCRIZIONE> <OBBLIGATORIO>NO</OBBLIGATORIO> <CODICE>PartitaIVA</CODICE> <DESCRIZIONE>Partita Iva</DESCRIZIONE> <TIPO>PARTITAIVA</TIPO> <OBBLIGATORIOSEVUOTO>CodiceFiscale</OBBLIGATORIOSEVUOTO> <UNIVOCO>SI</UNIVOCO> <OBBLIGATORIO>NO</OBBLIGATORIO> <CODICE>CodiceFiscale</CODICE> <DESCRIZIONE>Codice Fiscale</DESCRIZIONE> <TIPO>CODICEFISCALE</TIPO> <OBBLIGATORIOSEVUOTO>PartitaIva</OBBLIGATORIOSEVUOTO> <UNIVOCO>SI</UNIVOCO> <CODICE>Indirizzo</CODICE> <DESCRIZIONE>Indirizzo</DESCRIZIONE> Pagina n.4

5 <CODICE>Cap</CODICE> <DESCRIZIONE>Cap</DESCRIZIONE> <CODICE>Localita</CODICE> <DESCRIZIONE>Localita</DESCRIZIONE> <CODICE>Provincia</CODICE> <DESCRIZIONE>Provincia</DESCRIZIONE> <CODICE>Telefono</CODICE> <DESCRIZIONE>Telefono</DESCRIZIONE> <OBBLIGATORIO>NO</OBBLIGATORIO> <CODICE>Fax</CODICE> <DESCRIZIONE>Fax</DESCRIZIONE> Pagina n.5

6 <CODICE> </CODICE> <DESCRIZIONE> </DESCRIZIONE> <CODICE>_Pec</CODICE> <DESCRIZIONE>Pec</DESCRIZIONE> <CODICE>Pagamento</CODICE> <DESCRIZIONE>Pagamento</DESCRIZIONE> <DEFAULT>01</DEFAULT> <CODICE>Valuta</CODICE> <DESCRIZIONE>Valuta</DESCRIZIONE> <DEFAULT>EUR</DEFAULT> <CODICE>Giro</CODICE> <DESCRIZIONE>Giro</DESCRIZIONE> Pagina n.6

7 <TIPO>NUMERICO</TIPO> <DEFAULT> </DEFAULT> <CODICE>Sequenza</CODICE> <DESCRIZIONE>Sequenza</DESCRIZIONE> <TIPO>NUMERICO</TIPO> <DEFAULT>0</DEFAULT> <CODICE>DocumentoAbituale</CODICE> <DESCRIZIONE>Documento Abituale</DESCRIZIONE> <DEFAULT>01</DEFAULT> <CODICE>StatoCF</CODICE> <DESCRIZIONE>Cliente Bloccato</DESCRIZIONE> <DEFAULT>A</DEFAULT> <CODICE>ModificaPrezziAbilitata</CODICE> <DESCRIZIONE>ModificaPrezziAbilitata</DESCRIZIONE> <DEFAULT>N</DEFAULT> Pagina n.7

8 <CODICE>ModificaScontiAbilitata</CODICE> <DESCRIZIONE>ModificaScontiAbilitata</DESCRIZIONE> <DEFAULT>N</DEFAULT> <CODICE>_MonteOmaggio</CODICE> <DESCRIZIONE>MonteOmaggio</DESCRIZIONE> <TIPO>DECIMALE</TIPO> <DEFAULT>100</DEFAULT> <CODICE>_ImportoFidoMassimo</CODICE> <DESCRIZIONE>ImportoFidoMassimo</DESCRIZIONE> <TIPO>DECIMALE</TIPO> <DEFAULT>99999</DEFAULT> <CODICE>_NumeroMassimoPartiteAperte</CODICE> <DESCRIZIONE>NumeroMassimoPartiteAperte</DESCRIZIONE> <TIPO>NUMERICO</TIPO> <DEFAULT>999</DEFAULT> <CODICE>_NumeroMassimoGiorniScoperto</CODICE> <DESCRIZIONE>NumeroMassimoGiorniScoperto</DESCRIZIONE> <TIPO>NUMERICO</TIPO> <DEFAULT>60</DEFAULT> Pagina n.8

9 <CODICE>_LegaleRappresentante</CODICE> <DESCRIZIONE>Legale Rappresentante</DESCRIZIONE> <CODICE>_CodiceFiscaleLegRappr</CODICE> <DESCRIZIONE>Codice Fiscale Legale Rappr</DESCRIZIONE> <TIPO>CODICEFISCALE</TIPO> <CODICE>_GiorniConsegna</CODICE> <DESCRIZIONE>Giorni di Consegna</DESCRIZIONE> <CODICE>_GiorniChiusura</CODICE> <DESCRIZIONE>Giorni di Chiusura</DESCRIZIONE> <CODICE>_NoteSpedizioniere1</CODICE> Pagina n.9

10 <DESCRIZIONE>NoteSpedizioniere 1</DESCRIZIONE> <CODICE>_NoteSpedizioniere2</CODICE> <DESCRIZIONE>NoteSpedizioniere 2</DESCRIZIONE> </DEFINIZIONE> </ANAG> <ANAG> <INTESTAZIONE>NO</INTESTAZIONE> <OBBLIGATORIA>NO</OBBLIGATORIA> <DEFINIZIONE> <CODICE>Descrizione</CODICE> <DESCRIZIONE>Ragione Sociale Dest</DESCRIZIONE> <CODICE>Indirizzo</CODICE> <DESCRIZIONE>Indirizzo Dest</DESCRIZIONE> <CODICE>Cap</CODICE> <DESCRIZIONE>CAP Dest</DESCRIZIONE> Pagina n.10

11 <CODICE>Localita</CODICE> <DESCRIZIONE>Localita Dest</DESCRIZIONE> <CODICE>Provincia</CODICE> <DESCRIZIONE>Provincia Dest</DESCRIZIONE> <CODICE>Telefono</CODICE> <DESCRIZIONE>Telefono Dest</DESCRIZIONE> <CODICE> </CODICE> <DESCRIZIONE> Dest</DESCRIZIONE> Pagina n.11

12 <CODICE>_GiorniConsegna</CODICE> <DESCRIZIONE>Giorni di Consegna Dest</DESCRIZIONE> <CODICE>_GiorniChiusura</CODICE> <DESCRIZIONE>Giorni di Chiusura Dest</DESCRIZIONE> <CODICE>_NoteSpedizioniere1</CODICE> <DESCRIZIONE>NoteSpedizioniere 1 Dest</DESCRIZIONE> <CODICE>_NoteSpedizioniere2</CODICE> <DESCRIZIONE>NoteSpedizioniere 2 Dest</DESCRIZIONE> </DEFINIZIONE> </ANAG> </ANAGRAFE_CUSTOM> Pagina n.12

13 Il file deve chiamarsi CONF_ANAGRAFE.XML e deve essere messo nella cartella IMPORT di ogni agente. Il file deve essere inviato la prima volta e successivamente solo quando si vogliono apportare delle modifiche nella gestione. Nella lista di clienti in menù si andrà ad aggiungere la voce Nuovo Cliente e Modifica Cliente. Se è presente il file CONF_ANAGRAFE.XML, la gestione sarà la seguente. In caso contrario la gestione sarà l attuale presente in Zippy Evolution. 2. CLIENTE NUOVO: Verrà presentata una maschera con la richiesta di tutti i campi presenti nel file CONF_ANAGRAFE.XML. Verranno ricercati tutti i campi appartenenti alla definizione per INTESTAZIONE. Verranno presentati i campi nell ordine definito nel file di configurazione e l etichetta corrisponderà alla definizione in Descrizione. Al salvataggio verrà generata una nuova anagrafica cliente assegnando come codice NEWnnnnn. La parte nnnnn è un contatore. Inoltre verrà generato un file XML nella cartella EXPORT\ANAGRAFE del tablet con il codice del nuovo cliente e all interno la struttura con i dati del nuovo cliente inserito. 3. MODIFICA CLIENTE: Verrà generata una maschera con la richiesta di tutti i campi presenti nel file CONF_ANAGRAFE.XML. Verranno ricercati tutti i campi appartenenti alla definizione di INTESTAZIONE se l anagrafica selezionata è un intestazione o alla definizione di DESTINAZIONE se l anagrafica selezionata è una destinazione. Per la definizione dei campi relativi ad anagrafe verranno visualizzati anche i valori al momento presenti. Pagina n.13

14 Al salvataggio verranno aggiornati i dati e se già non presente verrà generato un file XML nella cartella EXPORT\ANAGRAFE del tablet con il codice del cliente selezionato. Verrà inserita la struttura e i dati dell anagrafica del cliente con le modifiche apportate e qualora già modificata e quindi già presente verrà accodata il nodo: <LIST_Anagrafe> <STDT_Anagrafe> <CODICE>C </CODICE> TUTTI GLI ALTRI VALORI DEI CAMPI DELLA PRIMA MODIFICA. </STDT_Anagrafe> <STDT_Anagrafe> <CODICE>C </CODICE> TUTTI GLI ALTRI VALORI DEI CAMPI DELLA SECONDA MODIFICA. </STDT_Anagrafe> <STDT_Anagrafe> <CODICE>C </CODICE> TUTTI GLI ALTRI VALORI DEI CAMPI DELLA TERZA MODIFICA. </STDT_Anagrafe>. </LIST_Anagrafe> In questo modo si potrà tener traccia di tutte le modifiche apportate. Ad esempio un agente potrebbe entrare in modifica di un cliente modificando l indirizzo e poi emettere documento. Successivamente prima di mandare i dati al gestionale potrebbe rientrare in modifica e riportare l indirizzo a come era prima. In fase di trasmissione dati, i files presenti nella cartella EXPORT\ANAGRAFE verranno inviati alla cartella EXPORT del server remoto ftp. Pagina n.14

15 Esempio contenuto file: <?xml version="1.0" encoding="utf-8"?> <LIST_Anagrafe xmlns:xsi=" xmlns:xsd=" <STDT_Anagrafe> <ModificaPrezziAbilitata>N</ModificaPrezziAbilitata> <CODICE>NEW00100</CODICE> <Descrizione>ragione sociale srl</descrizione> <PartitaIVA> </PartitaIVA> <CodiceFiscale /> <Indirizzo>indirizzo</Indirizzo> <Cap>00100</Cap> <Localita>loca</Localita> <Provincia>prt</Provincia> <Zona /> <Pagamento>01</Pagamento> <Sconto1 /> <Sconto2 /> <Sconto3 /> <Valuta>EUR</Valuta> <GruppoListino /> <StatoCF>A</StatoCF> <Telefono>t</Telefono> < >t</ > <Giro> </Giro> <Sequenza>0</Sequenza> <DocumentoAbituale>01</DocumentoAbituale> <ModificaPrezziAbilitata>N</ModificaPrezziAbilitata> <ModificaScontiAbilitata>N</ModificaScontiAbilitata> <Pt1CL_LIST /> <Pt2CL_LIST /> <Pt3CL_LIST /> <Pt4CL_LIST /> <Pt5CL_LIST /> <Pt6CL_LIST /> <Pt7CL_LIST /> <TipoOmaggio>0</_TipoOmaggio> <_MonteOmaggio>100.00</_MonteOmaggio> <_ImportoFidoMassimo> </_ImportoFidoMassimo> <_NumeroMassimoPartiteAperte>999</_NumeroMassimoPartiteAperte> <_NumeroMassimoGiorniScoperto>60</_NumeroMassimoGiorniScoperto> <_NonControllaFidoSeIncasso>0</_NonControllaFidoSeIncasso> <_GruppoClienteCanvas /> <_MarginalitaMinima>0</MarginalitaMinima> <_GGRitardoPagamenti>0</GGRitardoPagamenti> <Data> T00:00:00</Data> <Fax>t</Fax> <_Pec>t</_Pec> <_FatturatoMensilePrevisto>0</_FatturatoMensilePrevisto> <_GiorniConsegna>t</_GiorniConsegna> Pagina n.15

16 <_PostiASedere>0</_PostiASedere> <_SedeAmministrativa>false</_SedeAmministrativa> <_Trattativa>false</_Trattativa> <CAMPIPERSONALIZZATI> <CODICE>_LegaleRappresentante</CODICE> <DESCRIZIONE>t</DESCRIZIONE> <CODICE>_CodiceFiscaleLegRappr</CODICE> <DESCRIZIONE> </DESCRIZIONE> <CODICE>_GiorniChiusura</CODICE> <DESCRIZIONE>t</DESCRIZIONE> <CODICE>_NoteSpedizioniere1</CODICE> <DESCRIZIONE>nota</DESCRIZIONE> <CODICE>_NoteSpedizioniere2</CODICE> <DESCRIZIONE>nota</DESCRIZIONE> </CAMPIPERSONALIZZATI> </STDT_Anagrafe> <STDT_Anagrafe> <ModificaPrezziAbilitata>N</ModificaPrezziAbilitata> <CODICE>NEW00100</CODICE> <Descrizione>Linea Computer S.r.l.</Descrizione> <PartitaIVA> </PartitaIVA> <CodiceFiscale /> <Indirizzo>via solferino 55</Indirizzo> <Cap>00100</Cap> <Localita>Pesaro</Localita> <Provincia>PU</Provincia> <Zona /> <Pagamento>01</Pagamento> <Sconto1 /> <Sconto2 /> <Sconto3 /> <Valuta>EUR</Valuta> <GruppoListino /> <StatoCF>A</StatoCF> <Telefono> </Telefono> <Giro> </Giro> <Sequenza>0</Sequenza> <DocumentoAbituale>01</DocumentoAbituale> <ModificaPrezziAbilitata>N</ModificaPrezziAbilitata> <ModificaScontiAbilitata>N</ModificaScontiAbilitata> Pagina n.16

17 <Pt1CL_LIST /> <Pt2CL_LIST /> <Pt3CL_LIST /> <Pt4CL_LIST /> <Pt5CL_LIST /> <Pt6CL_LIST /> <Pt7CL_LIST /> <TipoOmaggio>0</TipoOmaggio> <_MonteOmaggio>100.00</_MonteOmaggio> <_ImportoFidoMassimo> </_ImportoFidoMassimo> <_NumeroMassimoPartiteAperte>999</_NumeroMassimoPartiteAperte> <_NumeroMassimoGiorniScoperto>60</_NumeroMassimoGiorniScoperto> <_NonControllaFidoSeIncasso>0</_NonControllaFidoSeIncasso> <_GruppoClienteCanvas /> <_MarginalitaMinima>0</_MarginalitaMinima> <_GGRitardoPagamenti>0</_GGRitardoPagamenti> <Data> T00:00:00</Data> <Fax /> <_FatturatoMensilePrevisto>0</_FatturatoMensilePrevisto> <_GiorniConsegna>lun, mer, gio</_giorniconsegna> <_PostiASedere>0</_PostiASedere> <_SedeAmministrativa>false</_SedeAmministrativa> <_Trattativa>false</_Trattativa> <CAMPIPERSONALIZZATI> <CODICE>_LegaleRappresentante</CODICE> <DESCRIZIONE>Oscar Ceccolini</DESCRIZIONE> <CODICE>_CodiceFiscaleLegRappr</CODICE> <DESCRIZIONE> </DESCRIZIONE> <CODICE>_GiorniChiusura</CODICE> <DESCRIZIONE>mar</DESCRIZIONE> <CODICE>_NoteSpedizioniere1</CODICE> <DESCRIZIONE>scaricare nota consegna 1</DESCRIZIONE> <CODICE>_NoteSpedizioniere2</CODICE> <DESCRIZIONE>scaricare nota spedizione 1</DESCRIZIONE> </CAMPIPERSONALIZZATI> </STDT_Anagrafe> </LIST_Anagrafe> Pagina n.17

18 4. GESTIONE INVIO DATI PERSONALIZZATI: Nella configurazione dell anagrafica (CONF_ANAGRAFE.XML) è possibile utilizzare campi della struttura standard anagrafe di Zippy come è possibile utilizzare dei campi personalizzati. Nel file di anagrafica che torna al gestionale i dati personalizzati vengono scritti in una lista all interno dell anagrafica con struttura: CODICE DESCRIZIONE (vedere l esempio riportato in precedenza). Per inviare le anagrafiche dal gestionale comprensive dei dati personalizzati si deve utilizzare il nuovo archivio ANAGRAFE_PERS.TXT che ha la seguente struttura: CODICE CLIENTE: codice del cliente al quale agganciare l informazione personalizzata; CODICE CAMPO: codice del campo definito anche in CONF_ANAGRAFE personalizzato; VALORE: valore Questo file verrà integrato in fase di trasmissione all archivio anagrafe e potrà essere consultato e visionato nella scheda del cliente. Esempio: ' ','_LegaleRappresentante','Bianchi Mario' ' ','_CodiceFiscaleLegRappr','RRRRRRRRRRRRRRRR' ' ','_NoteSpedizioniere1','abcd nota nota 1' ' ','_NoteSpedizioniere2','abcd nota nota 2' ' ','_LegaleRappresentante','Rossi Mario' ' ','_CodiceFiscaleLegRappr','DDDDDDDDDDDDDDDD' ' ','_NoteSpedizioniere1','abcd nota nota 1' ' ','_NoteSpedizioniere2','abcd nota nota 2' Per poter visualizzare questi dati personalizzati nella scheda del cliente si deve andare in Configurazione Schede e aggiungere un gruppo con la query base ANAGRAFE_PERSONALIZZATI. Pagina n.18