Via Bornaccino 231 47822 Santarcangelo di Romagna fax: 05411792014 tel: 05411796642
www.vanzotech.com info@vanzotech.com
Webservice impi@ntitermici Versione 1.1
vanzotech Š impi@ntitermici
Introduzione L'applicativo web impi@ntitermici permette l'interfacciamento con altri sistemi attraverso il consumo di web service. La tipica richiesta è la seguente: <request_impiantitermici> <login> <user>webclient_username</user> <password>webclient_password</password> </login> <service>service_name</service> <parameters> <param_1></param_1> <param_2></param_2> …. <param_n></param_n> </parameters> </request_impiantitermici>
mentre la tipica risposta è la seguente <response_impiantitermici> <results> ….. </results> </response_impiantitermici>
Per utilizzare i servizi occorre autenticarsi al sistema fornendo all'interno della richiesta utente e password nella la sezione <login>....</login>. UtentE e password verranno fornite dall'amministratore di sistema insieme all'URI del servizio. L'utente potrà usufruire solo dei webservice effettivamente richiesti. Per testare i webservice nell'applicativo demo per l'ente locale utilizzare i seguenti parametri: URI
http://62.149.232.53/demo_it_entelocale/index.php?fuseaction=webservice.request
Username
wsu_demo
Password
password
In comune per tutti i webservice ci sono le seguenti casistiche di risposta: <response_impiantitermici> <service>ws_ditte</service> <results>failedlogin</results> </response_impiantitermici>
Non sono state fornite le credenziali corrette. <response_impiantitermici> <service>ws_ditte</service> <results>expiredaccount</results> </response_impiantitermici>
L'account è scaduto. <response_impiantitermici> <service>ws_ditte</service> <results>insufficientpriviledges</results> </response_impiantitermici>
L'utente non ha il privilegio per accedere a questo webservice.
vanzotech © impi@ntitermici
vanzotech Š impi@ntitermici
Esempio di chiamata al servizio Di seguito un esempio molto semplice di chiamata al servizio. <form method=”post” action=”http://62.149.232.53/demo_it_entelocale/index.php? fuseaction=webservice.request”> <input name=”request” type=”text”> </form>
vanzotech © impi@ntitermici
Servizio: ws_ditte Questo servizio permette l'inserimento e la modifica di dati relativi a ditte di manutenzione. La struttura della richiesta è la seguente: <request_impiantitermici> <login> <user>webclient_username</user> <password>webclient_password</password> </login> <service>ws_ditte</service> <parameters> <dit_cod_fisc>1322132132131</dit_cod_fisc> <dit_denominazione>VANZOTECH</dit_denominazione> <dit_indirizzo_decodificato>Via Bornaccino 231 – 47822 Santarcangelo di Romagna (RN)</dit_indirizzo_decodificato> <dit_tel_fisso>05411796642</dit_tel_fisso> <dit_fax>05411792014</dit_fax> <dit_cellulare>3336777093</dit_cellulare> <dit_email>info@vanzotech.com</dit_email> <dit_www>www.vanzotech.com</dit_www> <dit_cciaa>RIMINI</dit_cciaa> <dit_numiscrizione>12345</dit_numiscrizione> <dit_numiscrizioneartigiani>12345</dit_numiscrizioneartigiani> <dit_rea_prefisso>RN</dit_rea_prefisso> <dit_rea_numero>12345</dit_rea_numero> </parameters> </request_impiantitermici>
di seguito la descrizione dei parametri: Parametro
Descrizione
Obbligatorio
dit_cod_fisc (key)
Codice Fiscale o partita IVA
SI
dit_denominazione
Ragione sociale manutentore
SI
dit_indirizzo_decodificato
Decodifica estesa della sede legale
SI
dit_tel_fisso
Telefono sede legale
dit_cellulare
Cellulare responsabile
dit_fax
Fax azienda
dit_email
Posta elettronica manutentore
dit_www
Sito web manutentore
dit_cciaa
Camera di Commercio
dit_numiscrizione
Numero iscrizione camera di commercio
dit_numiscrizioneartigiani
Numero iscrizione albo artigiani
dir_rea_prefisso
Prefisso codice REA
dit_rea_numero
Numero codice REA
La struttura della risposta è la seguente: <response_impiantitermici> <service>ws_ditte</service> <results>added</results> </response_impiantitermici>
La ditta è stata correttamente inserita. <response_impiantitermici> <service>ws_ditte</service> <results>modified</results> </response_impiantitermici>
La ditta è stata correttamente modificata. vanzotech © impi@ntitermici
<response_impiantitermici> <service>ws_ditte</service> <results>keymissing</results> </response_impiantitermici>
Manca la partita iva o il codice fiscale. <response_impiantitermici> <service>ws_ditte</service> <results>mandatorymissing</results> </response_impiantitermici>
Mancano uno o piĂš campi obbligatori.
vanzotech Š impi@ntitermici
Servizio: ws_codiciimpianto Questo servizio permette l'inserimento dei dati relativi alla consegna di un range di codici impianto. La struttura della richiesta è la seguente: <request_impiantitermici> <login> <user>webclient_username</user> <password>webclient_password</password> </login> <service>ws_codiciimpianto</service> <parameters> <coi_cod_fisc>1322132132131</coi_cod_fisc> <coi_da_numero>1</coi_da_numero> <coi_a_numero>1000</coi_a_numero> <coi_ritiratoda>mario rossi</coi_ritiratoda> <coi_dataritiro>AAAA-MM-DD</coi_dataritiro> <coi_estremidocumento>C.I. N. 12345</coi_estremidocumento> </parameters> </request_impiantitermici>
di seguito la descrizione dei parametri: Parametro
Descrizione
Obbligatorio
coi_cod_fisc (key)
Codice Fiscale o partita IVA
SI
coi_da_numero
Codice iniziale assegnato
SI
coi_a_numero
Codice finale assegnato
SI
coi_ritiratoda
Cognome Nome di chi ritira i codici
SI
coi_dataritiro
Data Ritiro (formato AAAA-MM-DD)
SI
coi_estremidocumento
Estremi documento
La struttura della risposta è la seguente: <response_impiantitermici> <service>ws_codiciimpianto</service> <results>added</results> </response_impiantitermici>
Il range di codici è stata correttamente inserito. <response_impiantitermici> <service>ws_codiciimpianto</service> <results>badrange</results> </response_impiantitermici>
Il range non è definito correttamente. <response_impiantitermici> <service>ws_codiciimpianto</service> <results>rangeoverlapping</results> </response_impiantitermici>
Il range si sovrappone ad altri già inseriti. <response_impiantitermici> <service>ws_codiciimpianto</service> <results>rangemissing</results> </response_impiantitermici>
Almeno un codice impianto nel range non esiste. <response_impiantitermici> <service>ws_codiciimpianto</service> <results>keymissing</results> </response_impiantitermici> vanzotech © impi@ntitermici
Manca il codice fiscale della ditta di manutenzione <response_impiantitermici> <service>ws_codiciimpianto</service> <results>baddate</results> </response_impiantitermici>
La data non è nel formato corretto AAAA-MM-DD <response_impiantitermici> <service>ws_codiciimpianto</service> <results>keynotfound</results> </response_impiantitermici>
La ditta di manutenzione non è codificata (utilizzare in questo caso ws_ditte). <response_impiantitermici> <service>ws_coicodiciimpianto</service> <results>mandatorymissing</results> </response_impiantitermici>
Mancano uno o piĂš campi obbligatori.
vanzotech Š impi@ntitermici
Servizio: ws_bollini Questo servizio permette l'inserimento dei dati relativi alla consegna di un range di bollini. La struttura della richiesta è la seguente: <request_impiantitermici> <login> <user>webclient_username</user> <password>webclient_password</password> </login> <service>ws_bollini</service> <parameters> <bol_cod_fisc>1322132132131</bol_cod_fisc> <bol_da_numero>1</bol_da_numero> <bol_a_numero>1000</bol_a_numero> <bol_prefisso></bol_prefisso> <bol_ritiratoda>mario rossi</bol_ritiratoda> <bol_dataritiro>AAAA-MM-DD</bol_dataritiro> <bol_estremidocumento>C.I. N. 12345</bol_estremidocumento> </parameters> </request_impiantitermici>
di seguito la descrizione dei parametri: Parametro
Descrizione
Obbligatorio
bol_cod_fisc (key)
Codice Fiscale o partita IVA
SI
bol_da_numero
Bollino iniziale assegnato
SI
bol_a_numero
Bollino finale assegnato
SI
bol_prefisso
Prefisso range Bollini
bol_ritiratoda
Cognome Nome di chi ritira i bollini
SI
bol_dataritiro
Data Ritiro (formato AAAA-MM-DD)
SI
bol_estremidocumento
Estremi documento
La struttura della risposta è la seguente: <response_impiantitermici> <service>ws_bollini</service> <results>added</results> </response_impiantitermici>
Il range di bollini è stata correttamente inserito. <response_impiantitermici> <service>ws_bollini</service> <results>badrange</results> </response_impiantitermici>
Il range non è definito correttamente. <response_impiantitermici> <service>ws_bollini</service> <results>rangeoverlapping</results> </response_impiantitermici>
Il range si sovrappone ad altri già inseriti. <response_impiantitermici> <service>ws_bollini</service> <results>rangemissing</results> </response_impiantitermici>
Almeno un bollino nel range non esiste. <response_impiantitermici> <service>ws_bollini</service> <results>baddate</results>
vanzotech © impi@ntitermici
</response_impiantitermici>
La data non è nel formato corretto AAAA-MM-DD <response_impiantitermici> <service>ws_bollini</service> <results>keymissing</results> </response_impiantitermici>
Manca il codice fiscale della ditta di manutenzione <response_impiantitermici> <service>ws_bollini</service> <results>keynotfound</results> </response_impiantitermici>
La ditta di manutenzione non è codificata (utilizzare in questo caso ws_ditte). <response_impiantitermici> <service>ws_bollini</service> <results>mandatorymissing</results> </response_impiantitermici>
Mancano uno o piĂš campi obbligatori.
vanzotech Š impi@ntitermici