Saltar al contenido principal

Sincroniza tu Sitio Web con un Feed XML | Hoggary Chile

 

Sincroniza tu sitio web con un Feed XML — Hoggary Chile (hoggary.cl)

 

¿Tu inmobiliaria, agencia o desarrolladora ya tiene un sitio web con sus propiedades publicadas? Entonces no necesitas volver a capturarlas una por una: con un feed XML puedes publicar todo tu catálogo en Hoggary y mantenerlo al día de forma automática y gratuita.

 

Qué obtienes

  • Publicación automática y gratuita. El sistema da de alta tus inmuebles nuevos y, en cada sincronización, actualiza los ya publicados (título, descripción, precio, operación, ubicación y características) y pausa automáticamente los que ya no vienen en tu feed: tu inventario publicado siempre refleja tu sitio.

  • Hasta 15 fotografías por inmueble, importadas automáticamente al darlo de alta.

  • Los contactos llegan directo a ti. Los anuncios se publican bajo tu cuenta de Hoggary, con tus datos de contacto y el chat del sitio.

  • Mínimo esfuerzo. Configuras tu feed una sola vez; de ahí en adelante todo es automático.

 

Cómo funciona: 4 pasos

  1. Crea tu cuenta gratuita en Hoggary (si aún no la tienes). Los anuncios sincronizados se publican bajo tu cuenta, para que los interesados te contacten a ti.

  2. Prepara tu feed XML siguiendo la especificación técnica de abajo y publícalo en una URL accesible de tu servidor (por ejemplo: https://tu-inmobiliaria.com/feed.xml).

  3. Envíanos la URL de tu feed y el correo de tu cuenta a través de nuestra página de Contacto.

  4. Nosotros hacemos el resto. Revisamos que el feed sea correcto y lo activamos. A partir de ahí se procesa periódicamente: los inmuebles nuevos se agregan y los existentes se actualizan solos.

 

Especificación técnica del feed

Requisitos generales

  • El archivo debe estar en codificación UTF-8.

  • La etiqueta raíz es <ads> y cada inmueble va dentro de una etiqueta <ad>.

  • Recomendamos envolver los textos (title, content) en <![CDATA[...]]> para evitar errores con caracteres especiales.

  • Si tu feed incluye etiquetas adicionales a las de esta guía, simplemente se ignoran (no causan error).

 

Campos obligatorios

Campo

Descripción y formato

Ejemplo

id

Identificador único del inmueble en tu sistema. No debe repetirse y no debe cambiar entre sincronizaciones (es la llave para actualizarlo en lugar de duplicarlo).

12345

title

Título del anuncio. Claro y descriptivo; los títulos de hasta 60 caracteres se leen mejor.

<![CDATA[Casa con quincho en Viña del Mar]]>

content

Descripción detallada del inmueble.

<![CDATA[Hermosa casa de 3 dormitorios, cocina equipada y jardín...]]>

type

Operación del inmueble: venta o arriendo. Si falta, el inmueble se publica como venta.

arriendo

price

Precio del inmueble. Solo números enteros, sin comas ni puntos. Puedes indicar la moneda con el atributo currency (formato ISO, ej. CLP); si falta, se usa la moneda local del sitio.

95000000

property_type

Tipo de inmueble, en texto. Valores reconocidos:

  • Casa
  • Departamento
  • Terreno
  • Oficina
  • Bodega
  • Habitaciones en renta

Usa estos valores tal cual (son los del sistema), aunque en tu sitio uses otra palabra. Cualquier otro valor se clasifica como "Otros inmuebles".

Casa

region

Región donde se ubica el inmueble. Usa el nombre tal como aparece en el buscador de Hoggary, para que la ubicación se asigne correctamente.

Valparaíso

city

Ciudad donde se ubica el inmueble, tal como aparece en el buscador de Hoggary.

Viña del Mar

 

Campos opcionales (muy recomendados: mejoran la posición de tu anuncio en los filtros de búsqueda)

Campo

Descripción y formato

Ejemplo

rooms

Número de dormitorios. Solo el número.

3

bathrooms

Número de baños. Solo el número (admite medios baños: 2.5).

2

parking

Número de estacionamientos. Solo el número.

2

floor_area

Superficie construida en m². Solo el número.

250

plot_area

Superficie del terreno en m². Solo el número.

300

latitude

Coordenada de latitud, para la ubicación en el mapa.

-33.0245

longitude

Coordenada de longitud, para la ubicación en el mapa.

-71.5518

pictures

Bloque de fotografías del inmueble: dentro de <pictures> agrega una etiqueta <picture> por foto, cada una con su <picture_url> (URL completa y directa a la imagen). Se importan hasta 15 fotos por inmueble.

(ver ejemplo completo)

 

Sobre las fotografías

  • Las fotos se descargan al dar de alta cada inmueble. En las sincronizaciones siguientes se actualizan los datos, pero no las fotos; si necesitas renovar las fotografías de un inmueble ya publicado, escríbenos por la página de Contacto.

  • Las URLs deben ser públicas y apuntar directamente al archivo de imagen (JPG, PNG o WebP).

  • El orden de las fotos en el feed se respeta: pon primero la mejor (será la portada del anuncio).

 

Ejemplo completo del archivo XML

<?xml version="1.0" encoding="UTF-8"?>
<ads>
  <ad>
    <id>12345</id>
    <title><![CDATA[Casa con quincho en Viña del Mar]]></title>
    <content><![CDATA[Hermosa casa de 3 dormitorios, 2 baños, cocina equipada y jardín. Excelente ubicación, cerca de escuelas y comercios.]]></content>
    <type>venta</type>
    <price currency="CLP">95000000</price>
    <property_type>Casa</property_type>
    <region>Valparaíso</region>
    <city>Viña del Mar</city>
    <rooms>3</rooms>
    <bathrooms>2</bathrooms>
    <parking>2</parking>
    <floor_area>250</floor_area>
    <plot_area>300</plot_area>
    <latitude>-33.0245</latitude>
    <longitude>-71.5518</longitude>
    <pictures>
      <picture>
        <picture_url>https://tu-inmobiliaria.com/img/fachada.jpg</picture_url>
      </picture>
      <picture>
        <picture_url>https://tu-inmobiliaria.com/img/sala.jpg</picture_url>
      </picture>
    </pictures>
  </ad>
  <ad>
    ... (siguiente inmueble) ...
  </ad>
</ads>

 

Recomendaciones finales

  • Mantén el id estable. Si cambias el id de un inmueble, el sistema lo tratará como uno nuevo y quedará duplicado.

  • Tu feed es la fuente de la verdad. Cuando un inmueble ya no esté disponible, simplemente quítalo de tu feed: en la siguiente sincronización su anuncio se pausará automáticamente (y si vuelve a aparecer en el feed, se reactiva solo). Por lo mismo, si quieres pausar un inmueble sincronizado, hazlo quitándolo de tu feed, no desde el panel.

  • Cuida la calidad. Títulos claros, descripciones completas y buenas fotos reciben más contactos. Te recomendamos nuestra guía Cómo publicar un anuncio exitoso.

 

¿Dudas o necesitas ayuda con tu feed? Escríbenos por la página de Contacto y con gusto te orientamos. El servicio es gratuito para inmobiliarias, agencias y desarrolladoras con sitio web propio.

¿Tienes más preguntas?

Nuestro equipo de soporte está listo para ayudarte.

Contáctanos Centro de ayuda