Page 1

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

webservice impi@ntitermici  

Descrizione webservice impiantitermici