Func: getImpresa
Per richiedere i dati relativi ad un impresa inserita in banca dati, sono disponibli varie funzioni, tutte vanno interrogate passando i seguenti parametri:
search: la stringa di ricerca, cambia a seconda della funzione utilizzata
username: username per inviare richieste
password: la password per inviare richieste
Username e password sono personali di ogni scuola. Verranno fornite da e-land alle varie scuole che richiederanno l’utilizzo del WebService. Il sistema è stato protetto da username e password per evitare che agenti esterni possano caricare o richiedere i dati presenti.
Come detto, tutte le funzioni restituiscono i dati su una o più imprese presenti che rispecchino la stringa cercata, in particolare, a seconda della funzione, il parametro search deve contenere:
getImpresaByCf : il codice fiscale della ditta ricercata. Viene restituita l’unica ditta -se presente- con quel codice fiscale.
getImpresaByPiva : la partita iva della ditta ricercata. Viene restituita l’unica ditta -se presente- con quella partita iva.
getImpresaByRagione : la ragione sociale (o parte di essa) dell’impresa ricercata. Pssono venir restituite più di un impresa con la seguente ragione sociale.
getImpresaByCforIva : è l’unione delle prime due funzioni. Cerca se sono presenti ditte che hanno o il codice fiscale o la partita iva uguali alla stringa cercata. Può quindi restituire più imprese. La stringa cercata deve essere di almeno 5 caratteri.
getImpresaByAll : è l’unione delle prime tre funzioni. Cerca se sono presenti ditte che hanno o il codice fiscale o la partita iva o la ragione sociali uguali (anche in parte) alla stringa cercata. Può quindi restituire più imprese. La stringa cercata deve essere di almeno 5 caratteri.