Documentación: Feed compatible con Chilepropiedades.cl

Estos detalles solo son para clientes que desean conectar su cartera de propiedades a Chilepropiedades.cl, pero su proveedor o sistema no se encuentra mencionado en este articulo: Ver sistemas soportados actualmente

La carga de carteras de propiedades actualmente se realiza leyendo un "feed" al que usted como cliente nos tiene que dar acceso. El "feed" es un archivo que contiene los datos de las publicaciones, los datos de contacto del agente y datos de contacto de la corredora según aplique.

Tipos de conexión

Soportamos conexiones por FTP y por HTTP(s). Nosotros preferimos HTTP(s) por sobre FTP por la facilidad de configuración.

Las imagenes de las publicaciones pueden estar accesibles por el mismo tipo de conexion, o por uno distinto. Por ejemplo: el feed esta disponible en un servidor accesible por FTP, y las imagenes estan disponibles por HTTP(s).

Formatos soportados

Soportamos integraciones en formatos: JSON, XML, XLS, XLSX. Si ya tienen un feed hecho para otro portal, es posible que podamos usar ese mismo feed.

Si prefiere hacer un feed especifico para Chilepropiedades.cl, recomendamos usar un XML con la siguiente estructura:

<listings>
  <listing>
    <referenceId>
      <![CDATA[ 35345342 ]]>
    </referenceId>
    <contact>
      <name>
        <![CDATA[ Juan Agustin ]]>
      </name>
      <email>
        <![CDATA[ juan@corredora-ejemplo.com ]]>
      </email>
      <phones>
        <phone whatsapp="true">
          <![CDATA[ +56 9 6209 8454 ]]>
        </phone>
        <phone whatsapp="false">
          <![CDATA[ +56 2 4234 5454 ]]>
        </phone>
      </phones>
      <agencyName>
          <![CDATA[ Corredora Ejemplo ]]>
      </agencyName>
      <agencyLogo>
          <![CDATA[ https://corredora-ejemplo.com/imagenes/133ed304-883b-11ee-bda8-a3ead605fb2a.jpg ]]>
      </agencyLogo>
      <agencyId>
          <![CDATA[ ririower2nrt4 ]]>
      </agencyId>
      <agencyAddress>
          <![CDATA[ Simon Bolivar 1231, La Reina ]]>
      </agencyAddress>
    </contact>
    <address>
      <![CDATA[ Av. Tobalaba 1234 ]]>
    </address>
    <commune>
      <![CDATA[ Las Condes ]]>
    </commune>
    <description>
      <![CDATA[ Lorem ipsum dolor sit amet, consectetur adipiscing elit. Vivamus
      sit amet placerat mauris. Nunc volutpat orci lacus, eu mattis metus ultricies in.

      Nullam congue augue purus, non dignissim ipsum sagittis at. Quisque
      fermentum arcu eget neque mollis pretium. Pellentesque tincidunt ligula arcu,
      a volutpat ex dapibus nec.
      ]]>
    </description>
    <prices>
      <price currency="CLF" operation="Arriendo">
        <![CDATA[ 40 ]]>
      </price>
    </prices>
    <title>
      <![CDATA[ Departamento amoblado cerca del Metro ]]>
    </title>
    <propertyType>
      <![CDATA[ Casa ]]>
    </propertyType>
    <coordinates>
      <latitude>
        <![CDATA[ -33.459745 ]]>
      </latitude>
      <longitude>
        <![CDATA[ -70.569754 ]]>
      </longitude>
    </coordinates>
    <bedrooms>
      <![CDATA[ 4 ]]>
    </bedrooms>
    <bathrooms>
      <![CDATA[ 2 ]]>
    </bathrooms>
    <floorArea unit="sqm">
      <![CDATA[ 140 ]]>
    </floorArea>
    <usableFloorArea unit="sqm">
      <![CDATA[ 126 ]]>
    </usableFloorArea>
    <plotArea unit="sqm">
      <![CDATA[ 244.2 ]]>
    </plotArea>
    <constructionYear>
      <![CDATA[ 2021 ]]>
    </constructionYear>
    <levels>
      <![CDATA[ 2 ]]>
    </levels>
    <floorNumber>
      <![CDATA[ 4 ]]>
    </floorNumber>
    <pictures>
      <picture>
        <url>
          <![CDATA[ https://corredora-ejemplo.com/imagenes/133ed304-883b-11ee-bda8-b3ead605fb2a.jpg ]]>
        </url>
        <description>
          <![CDATA[ Sala de estar ]]>
        </description>
      </picture>
      <picture>
        <url>
          <![CDATA[ https://corredora-ejemplo.com/imagenes/1ecfb300-883b-11ee-b92f-079715694ad6.jpg ]]>
        </url>
        <description>
          <![CDATA[ Cocina ]]>
        </description>
      </picture>
      <picture>
        <url>
          <![CDATA[ https://corredora-ejemplo.com/imagenes/2a7e5198-883b-11ee-a5d8-b3cd261d5a4b.jpg ]]>
        </url>
        <description>
          <![CDATA[ ]]>
        </description>
      </picture>
    </pictures>
    <virtualTour>
      <![CDATA[ https://youtube.com/v?watch=sdkjwlkrj23 ]]>
    </virtualTour>
    <parkingLots>
      <![CDATA[ 1 ]]>
    </parkingLots>
    <furnished>
      <![CDATA[ true ]]>
    </furnished>
    <featured>
      <![CDATA[ false ]]>
    </featured>
  </listing>
  <listing>
    ...
  </listing>
  ...
</listings>

Campos y validación

Cada listing requiere referenceId, propertyType, commune y un prices/price con valor numérico, atributo currency y atributo operation. Debe enviarse un solo precio efectivo por aviso: el importador usa solo el primer price recibido.

Los demás elementos del ejemplo son opcionales. Si falta address, se usa la comuna como dirección; description puede quedar vacía. title se sanitiza y se guarda como título de la publicación. Se conservan los primeros 65 caracteres limpios y se agrega ... si es más largo. Si un aviso existente se actualiza sin title, su título guardado se elimina.

Los datos de contact identifican el contacto del aviso. Los elementos agencyName, agencyLogo, agencyId y agencyAddress se usan durante el descubrimiento separado de corredora/agentes; no cambian la propiedad individual de cada aviso.

Los siguientes campos tienen valores restringidos:

propertyType: Bodega, Casa, Departamento, Estacionamiento, Estudio, Galpón, Hotel, Local Comercial, Loft, Lote de Cementerio, Negocios turísticos, Oficina, Parcela, Sitio, Terreno, Terreno Agricola, Terreno Forestal, Terreno Industrial
price.operation: Arriendo, Arriendo Diario, Venta
price.currency: CLF, CLP, USD
floorArea.unit, usableFloorArea.unit y plotArea.unit: m2, sqm, ha
furnished, featured y phone.whatsapp: true, false

virtualTour es soportado y se guarda como tour virtual cuando su URL pasa la sanitización de proveedores compatibles. usableFloorArea, constructionYear, levels y floorNumber se importan también. Las áreas aceptan decimales; año, niveles y número de piso aceptan enteros.

Campos aplicables por tipo de propiedad

Esta tabla es una guía de visualización basada en el catálogo activo. Enviar un campo no aplicable no rechaza el aviso; puede quedar oculto en la ficha. Marca Sí indica que el tipo usa ese campo.

Tipo	Dorm.	Baños	Sup. construida	Sup. terreno	Sup. útil	Año	Niveles	Piso	Estac.	Amoblado	G. comunes	Valor / área
Casa	Sí	Sí	Sí	Sí	No	Sí	No	No	Sí	Sí	No	No
Departamento	Sí	Sí	No	Sí	Sí	Sí	No	Sí	Sí	Sí	Sí	No
Estudio	Sí	Sí	No	Sí	Sí	Sí	No	Sí	Sí	Sí	Sí	No
Loft	Sí	Sí	No	Sí	Sí	Sí	No	Sí	Sí	Sí	Sí	No
Oficina	Sí	Sí	No	Sí	Sí	Sí	No	Sí	Sí	Sí	Sí	No
Local Comercial	Sí	Sí	Sí	Sí	No	Sí	No	No	Sí	Sí	No	No
Sitio	No	No	No	Sí	No	No	No	No	No	No	No	No
Parcela	Sí	Sí	Sí	Sí	No	No	No	No	No	Sí	No	No
Bodega	No	No	No	Sí	Sí	Sí	No	No	No	No	No	Sí
Estacionamiento	No	No	No	Sí	No	No	No	No	Sí	No	No	No
Terreno Industrial	No	No	No	Sí	No	No	No	No	No	No	No	No
Terreno Agricola	No	No	No	Sí	No	No	No	No	No	No	No	No
Terreno Forestal	No	No	No	Sí	No	No	No	No	No	No	No	No
Terreno	No	No	No	Sí	No	No	No	No	No	No	No	No
Lote de Cementerio	No	No	No	Sí	No	No	No	No	No	No	No	No
Negocios turísticos	Sí	Sí	Sí	Sí	No	Sí	No	No	Sí	Sí	No	No
Hotel	Sí	Sí	Sí	Sí	Sí	Sí	No	No	Sí	Sí	No	Sí
Galpón	No	No	No	Sí	Sí	Sí	No	No	No	No	No	Sí

XLS/XLSX es el formato que MENOS recomendamos.

Imagenes

No es necesario proveer imagenes de distintos tamaño. Deberán proveer la imagen más grande posible y Chilepropiedades.cl se encargara de ajustarla a los distintos tamaños que Chilepropiedades.cl usa.

Si cambian las imagenes de un aviso, NO REUTILIZAR el nombre del archivo de las imagenes reemplazadas ya que esto hará que no se actualizen en Chilepropiedades.cl

Enviar consultas a integraciones@chilepropiedades.cl