Feed XML Locales

Si tienes un grupo inmobiliario, franquicia inmobiliaria, asociación inmobiliaria, banco o un portal inmobiliario y quieres que tus anuncios salgan en CasaToc, tan sólo tienes que seguir las indicaciones que vienen detalladas a continuación:

  1. Crea un archivo XML siguiendo el formato especificado más abajo.
  2. Asegúrese de que no haya errores de sintaxis o fallos que impidan el procesamiento de la información. Para ello, utilice un validador de XML disponible en internet, como por ejemplo:
  3. Contacta con nosotros a info@casatoc.es, o a través de nuestro formulario de contacto e indícanos la URL de tu XML.

XML y formato del Feed

Aspectos importantes en el procesamiento del XML:

  • La codificación del archivo debe ser en UTF-8.
  • Es importante incluir el <![CDATA[...]]> en cada campo XML para evitar errores de interpretación.
  • Cada inmueble debe tener al menos una imagen.
  • La imagen que se verá en el anuncio será la insertada en el XML. No aceptamos imágenes corporativas con informaciones del tipo Imagen no disponible
  • No pueden existir dos anuncios con una misma URL. La URL debe ser única.
  • Si se nos facilita información sobre la agencia (provincia, localidad, teléfono, e-mail, etc.) a la que pertenece el inmueble, obtendrá las siguientes ventajas:
    • Las agencias insertadas aparecerán en un listado de agencias, ofreciendo un grupo de inmuebles del mismo: Listado de agencias
    • Las fichas de los inmuebles aparecerán con el diseño de las fichas de CasaToc, en vez de usar un iframe. Esta ventaja es muy importante, ya que nuestra página se adapta a los distintos dispositivos (móviles, tablets o ordenadores), por lo que el usuario que entré a una ficha, podrá ver y contactar fácilmente desde un dispositivo móvil.
    • En el pie de la ficha del inmueble, junto a la agencia a la que pertenece el inmueble y el formulario de contacto, aparecerá una imagen corporativa del partner.
    • Nuestro sistema será el encargado del envío de mensajes a las agencias cuando un usuario contacte con las mismas.

Estructura del feed

El archivo XML contendrá un etiqueta principal <casatoc> que recogerá un conjunto de anuncios representado por bloques de etiquetas <ad></ad>. Cada bloque <ad></ad> contiene campos obligatorios (marcados en negrita) y opcionales:

<?xml version="1.0" encoding="utf-8"?>
<casatoc>

	<ad>
		<id><![CDATA[...]]></id>
		<url><![CDATA[...]]></url>
		<mobile_url><![CDATA[...]]></mobile_url>
		<title><![CDATA[...]]></title>
		<type><![CDATA[...]]></type>
		<content><![CDATA[...]]></content>

		<price><![CDATA[...]]></price>
	
		<property_type><![CDATA[...]]></property_type>

		<address><![CDATA[...]]></address>
		<city><![CDATA[...]]></city>
		<region><![CDATA[...]]></region>
		<neighborhood><![CDATA[...]]></neighborhood>
		<postcode><![CDATA[...]]></postcode>
		<latitude><![CDATA[...]]></latitude>
		<longitude><![CDATA[...]]></longitude>

		<agency><![CDATA[...]]></agency>
		<agency_id><![CDATA[...]]></agency_id>
		<agency_picture><![CDATA[...]]></agency_picture>
		<agency_facebook><![CDATA[...]]></agency_facebook>
		<agency_city><![CDATA[...]]></agency_city>
		<agency_region><![CDATA[...]]></agency_region>
		<agency_phone><![CDATA[...]]></agency_phone>
		<agency_email><![CDATA[...]]></agency_email>
		<agency_web><![CDATA[...]]></agency_web>
		<agency_address><![CDATA[...]]></agency_address>
		<agency_postcode><![CDATA[...]]></agency_postcode>
		<agency_longitud><![CDATA[...]]></agency_longitud>
		<agency_latitud><![CDATA[...]]></agency_latitud>

		<floor_area><![CDATA[...]]></floor_area>
		<plot_area><![CDATA[...]]></floor_area>
		<bathrooms><![CDATA[...]]></bathrooms>
	
		<picture><![CDATA[...]]><</picture>
		<more_pictures>
			<picture><![CDATA[...]]><</picture>
			<picture><![CDATA[...]]><</picture>
			<picture><![CDATA[...]]><</picture>
			...
		</more_pictures>

		<date><![CDATA[...]]></date>
		<date_update><![CDATA[...]]></date_update>
		<parking><![CDATA[...]]></parking>
		
	</ad>

	...
</casatoc>

CAMPOS OBLIGATORIOS

Los campos obligatorios son el conjunto de etiquetas XML que proporcionan la cantidad mínima de información necesaria para que nuestros sistemas incluyan tus anuncios en CasaToc. En el bloque anterior han sido marcados en negrita.

  • id: Identificador del anuncio en tu página web (puede ser numérico o alfanumérico, pero debe ser único, ya que lo utilizamos para evitar anuncios duplicados).
  • url: URL del anuncio en tu página web. No pueden existir dos anuncios con una misma URL. La URL debe ser única.
  • title: Título del anuncio (debe ser completamente relacionado con el anuncio, no puede contener el nombre ni la URL de tu web).
  • type: Tipo de anuncio. El contenido de este campo debe ser uno de los siguientes:
    • Venta
    • Alquiler
    • Alquiler con opción a compra
    • Alquiler por temporada
  • content: Descripción del anuncio. Recuerda que cuanto más rica sea la descripción, mejor será el posicionamiento del anuncio.
  • price: Precio del inmueble.
  • property_type: Tipo de inmueble. Deben ser obligatoriamente uno de estos tipos:
    • Centro Comercial
    • Local
    • Nave
    • Oficina
    • Parking
    • Trastero
  • city: Ciudad donde se encuentra el inmueble.
  • region: Nombre de la provincia donde se encuentra el inmueble.
  • picture: Contiene la URL de la imagen. Es la imagen principal del inmueble, y la que aparecerá en los resultados de búsqueda.

CAMPOS OPCIONALES

Los campos opcionales, si se disponen de ellos, son aconsejables de añadir. Cuanta más información tengamos de tu anuncio, mejor será su posicionamiento y más interesados tendrá.

  • mobile_url: URL del anuncio en tu página web cuando el usuario accede desde un dispositivo móvil. Útil cuando tu página web está preparada para dichos dispositivos.
  • address: Dirección donde se encuentra el inmueble.
  • neighborhood : Barrio donde se encuentra el inmueble.
  • postcode: Código postal.
  • latitude: Latitud donde se encuentra el inmueble. Aunque este campo es opcional, es muy recomendable de añadir para que la búsqueda a través del mapa sea efectiva.
  • longitude: Longitud donde se encuentra el inmueble. Aunque este campo es opcional, es muy recomendable de añadir para que la búsqueda a través del mapa sea efectiva.
  • agency: Nombre de la agencia.
  • agency_id: Identificador único de la agencia. Si se proporciona información sobre la agencia, este campo pasa a ser obligatorio.
  • agency_picture: Imagen de la agencia.
  • agency_facebook: Facebook de la agencia.
  • agency_city: Ciudad de la agencia.
  • agency_region: Provincia de la agencia.
  • agency_phone: Teléfono de la agencia.
  • agency_email: E-mail de la agencia.
  • agency_web: Web de la agencia.
  • agency_address: Dirección de la agencia.
  • agency_postcode: Código postal de la agencia.
  • agency_longitud: Longitud de la agencia.
  • agency_latitud: Latitud de la agencia.
  • floor_area: Superficie del inmueble.
  • plot_area: Superficie de la parcela dónde se ubica el inmueble.
  • bathrooms: Número de baños del inmueble.
  • more_pictures: Contiene el resto de imágenes del inmueble, y serán utilizadas en la ficha del inmueble. Cada imagen debe aparecer entre las etiquetas <picture></picture>. Ejemplo

    <more_pictures>
    	<picture>http://www.tupaginaweb.es/image_salon.jpg</picture>
    	<picture>http://www.tupaginaweb.es/image_habitacion1.jpg</picture>
    	<picture>http://www.tupaginaweb.es/image_jardin.jpg</picture>
    </more_pictures>
    								
  • date: Fecha de publicación del anuncio. Los formatos aceptados son DD/MM/AAAA o DD/MM/AAAA HH:MM:SS y AAAA/MM/DD o AAAA/MM/DD HH:MM:SS.
  • date_update: Fecha de modificación del anuncio. Los formatos aceptados son DD/MM/AAAA o DD/MM/AAAA HH:MM:SS y AAAA/MM/DD o AAAA/MM/DD HH:MM:SS.

Los siguientes campos deben rellenarse según si son ciertos o falsos.

  • parking: Si el inmueble tiene parking o no.

Ejemplo de feed XML:

<?xml version="1.0" encoding="utf-8"?>
<casatoc>
	<ad>
		<id><![CDATA[123875]]></id>
		<url><![CDATA[http://www.tupaginaweb.es/property/123875]]></url>
		<mobile_url><![CDATA[http://m.tupaginaweb.es/property/123875]]></mobile_url>
		<title><![CDATA[Ático en Venta en Torrevieja]]></title>
		<type><![CDATA[Venta]]></type>
		<content><![CDATA[Ático en primera línea de playa. Contiene 2 habitaciones y está listo para entrar a vivir. ]]></content>

		<property_type><![CDATA[Ático]]></property_type>

		<address><![CDATA[Av. Ronda César Cánovas, 12]]></address>
		<city><![CDATA[Torrevieja]]></city>
		<region><![CDATA[Alicante]]></region>
		<neighborhood><![CDATA[La siesta]]></neighborhood>
		<postcode><![CDATA[03120]]></postcode>
		<latitude><![CDATA[37,97747]]></latitude>
		<longitude><![CDATA[-0,6832271]]></longitude>
		<agency><![CDATA[Adaix Torrevieja]]></agency>

		<floor_area><![CDATA[100]]></floor_area>
		<plot_area><![CDATA[10]]></plot_area>
		<bathrooms><![CDATA[1]]></bathrooms>
	
		<picture><![CDATA[http://www.tupaginaweb.es/image_salon.jpg]]></picture>

		<date><![CDATA[21/02/2014 12:20:48]]></date>
		<date_update><![CDATA[25/02/2014 10:12:35]]></date_update>

		<parking><![CDATA[1]]></parking>
		
	</ad>

</casatoc>