Note riguardanti l'utilizzo del tracciato XML per esportare verso ImmoGalaxy ============================================================================ 1. Gli invii del file XML sono giornalieri (1 al giorno). 2. Dal 5 settembre 2018 e' possibile effettuare delle trasmissioni "complete" come pure "incrementali". Lo standard richiesto durante la settimana rimane il tipo "incrementale"; il tipo "completo" puo' essere eseguito solo al sabato, la domenica o il lunedi' mattina in caso si voglia assicurare la correttezza degli oggetti inviati in modo "incr" (incrementale) durante la settimana. 2.1 il nodo segue immediatamente dopo il nodo : 2.2 Invii incrementali; solo le modifiche del giorno agli oggetti indicati per l'esportazione (se non specificato altrimenti, questo e' il default): 2.3 Invii completi; tutti gli oggetti attivi sul vostro sito indicati per l'esportazione: 2.4 Come specificato, gli invii devono essere incrementali: primo invio completo di tutti gli oggetti, invii successivi con solo le modifiche giornaliere. Sia il tipo di trasmissione "incr" sia il tipo "full" supportano: e anche se con il tipo "full" non e' piu' necessario inviare i "DELETE"; eventuali vostri oggetti non piu' attivi ma, ancora attivi su immogalaxy, verranno bloccati automaticamente. Come utilizzare il tag e significato del "tipo" di azione: . UPDATE -> per nuovi oggetti o per modifiche ai loro dati / foto . DELETE -> per cancellazioni o sospensioni sul vostro sito 3. Fasi di preparazione / attivazione: FASE 1: test ------------ . ci invierete i tracciati XML di prova tramite email a nikita@immogalaxy.ch . i file XML dovranno contenere dei dati veritieri con dei puntamenti URL effettivi (sia immagini, sia ev. pdf) - per poter essere validati completamente . una volta passata la fase di validazione si procede con due giorni di test con dati REALI: . primo invio completo di tutti i dati . secondo invio con solo le modifiche ("UPDATE" e/o "DELETE") . validata la FASE 1 si passa alla FASE 2 FASE 2: produzione ------------------ . i primi 2 file XML con dati REALI verranno processati manualmente sul server immogalaxy.ch e caricheranno gli oggetti su www.immogalaxy.ch . vi invieremo i dati FTP per il trasferimento automatico giornaliero del file XML sul server immogalaxy.ch . attiveremo la procedura di importazione automatica dei vostri tracciati XML. 4. NOTE di dettaglio sui TAG presenti nel file XML . i tag e per ogni parent li stabilite voi e NON dovranno pił cambiare in futuro; servono per poter identificare le agenzie, le persone di contatto e gli immobili negli invii futuri. Di solito vengono generati tramite un identificatore della vostra banca dati. . il tag rappresenta l'agenzia che pubblica (visto che il tracciato prevede la possibilita' di esportare i dati di diverse agenzie con un unico invio) . minimo 1 fotografia, massimo 12, da inviare come URL che punti ad una vostra foto di buona qualita', la nostra procedura automatica provvede a convertirla sul nostro server nei formati classici ImmoGalaxy (le foto del cliente vengono lette solamente dalla procedura automatica durante il loro caricamento e per controllare se sono state modificate dall'ultima lettura, quindi notte-tempo) . documenti PDF, al massimo 1 con un peso massimo di 10MB . gestiamo automaticamente tutte le citta'/paesi Svizzeri e Italiani tramite il loro codice di avviamento postale . il nome "tipo" del file da inviare e': YYYYMMDD.annunci.xml . codice "" nei campi non viene accettato (accettiamo solo
e
  • ), nel qual caso dovrete "racchiudere" il testo nel codice xml "" 5. Valori possibili per i TAG con codice (questi tag sono obbligatori): ----------------------------------------------------------------------- 1 = rustici 2 = case 3 = appartamenti 4 = locali commerciali 5 = progetti 6 = terreni 7 = ville 8 = stabili di reddito 9 = garages parcheggi 10 = bar ristoranti hotel 11 = attici 1 = affitto 2 = vendita 1 = unitario 2 = m2/grezzo 3 = m2/finito 4 = m3/grezzo 5 = m3/finito 6 = m2 7 = trattabile 8 = a partire da 9 = mensile 10 = trimestrale 11 = semestrale 12 = annuale (1 obbligatoria); oppure (facoltativo, max 1x10MB) (facoltativo, max 1 link) YYYY-MM-GG oppure da subito oppure da concordare 6. Riepilogo TAG con valore obbligatorio ---------------------------------------- . per il nodo 2 caratteri 0 o valore reale CHF - ATTENZIONE: se vuoto si assume sia "CHF" 7. I valori degli altri TAG sono facoltativi ma vivamente consigliati --------------------------------------------------------------------- 8. Nome dei files da inviare tramite FTP, orario e frequenza ------------------------------------------------------------- I file che ci inviate dovranno avere il formato: YYYYMMDD.nome-gestionale(+opzionale-identificativo-agenzia).xml il "nome-gestionale" vi verra' comunicato prima della fase 2: produzione. Accettiamo l'invio di un solo file al giorno x gestionale.agenzia e ci deve pervenire tra le 00:01AM e le 01:29AM con data del giorno dell'invio nel nome del file.