Aggiornamento del 9 ottobre 2026. Endpoint SOAP: software.realgest.it/ws/index.php — WSDL.
numero_balconi è un conteggio facoltativo da 0 a 255. È indipendente dal flag balcone, dal testo dell'annuncio e dalle superfici. NULL significa numero sconosciuto; 0 significa nessun balcone. Nessun dato storico viene compilato automaticamente.
Il parametro SOAP numero_balconi (xsd:int) è aggiunto in fondo a RG_AddAnnuncio e RG_UpdateAnnuncio. L'ordine di tutti i parametri precedenti resta invariato.
| Invio | Inserimento | Aggiornamento |
|---|---|---|
Parametro omesso o xsi:nil="true" | NULL, numero sconosciuto | Conserva il valore presente |
0 | 0, nessun balcone | Imposta 0 |
1–255 | Salva il numero | Sostituisce il numero |
-1 | NULL | Ripristina esplicitamente NULL |
-1 è un comando di trasporto: nel database viene salvato NULL, mai -1. Questa scelta evita cancellazioni involontarie con client NuSOAP che inviano automaticamente nil per parametri non valorizzati. Stringa vuota, testo, valori decimali, valori inferiori a -1 o superiori a255 vengono rifiutati con Success=false e ErrorCode=201, senza salvare l'annuncio.
Il parametro non modifica automaticamente balcone o altri campi. Il flag può essere aggiornato solo inviandolo secondo il contratto già esistente.
RG_GetAnnuncio e RG_GetAnnunci restituiscono numero_balconi come intero nullable. È presente anche nelle letture vetrina e ricerca testuale. Aggiornare il WSDL del client per leggere e scrivere il nuovo campo; le chiamate precedenti restano valide.
Frammenti da inserire nel corpo del metodo insieme alle credenziali e ai suoi parametri obbligatori. Usare chiave API e ID dell'agenzia/annuncio autorizzati.
<numero_balconi>2</numero_balconi><numero_balconi>0</numero_balconi><numero_balconi>-1</numero_balconi>Omettere completamente numero_balconi. Anche il seguente nil conserva il valore; non lo cancella:
<numero_balconi xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:nil="true" /><numero_balconi xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:nil="true" />Nella scheda Caratteristiche, “Numero balconi” è distinto dal flag “Balcone”. Lasciare il campo vuoto per salvare NULL; usare 0 per nessun balcone. Il valore non viene dedotto da descrizione o metri quadrati.
piani_fuori_fabbricato: piani fuori terra dell'edificio.piani_entro_fabbricato: piani entro terra dell'edificio.piano: piano dell'unità immobiliare; non è il numero di piani dell'edificio.Questi significati restano invariati. Il chiarimento non introduce un nuovo parametro SOAP piani_entro_fabbricato se non è previsto dalla firma attuale.