Sindicacion // API Ayuda - Publicar sus avisos automaticamente en el sitio de enbuenosaires

Pasito por pasito

El mecanismo de importación de avisos de enbuenosaires funcióna por importar avisos almecenados en un archivo xml brindado por la Inmobiliria, El Sistema de Gestación o Agregador o sea "Le Proveedor".

El archivo se carga una vez el dia del servidor del proveedor y la información de los avisos adentro del archivo se utiliza para agregar nuevos avisos, actualizar avisos corrientes y borrar avisos que ya no figuran adentro del archivo.

El archivo xml debe adherir a la especificación definido por enbuenosaires, y debe ser colocado en un servidor controlado por el proveedor y actualizado cada 24hs.

Cada aviso en el feed debe contener cierta información incluso un identificador (que distingue de manera unica en el sistema del proveedor) en el caso que el proveedor sea un Sistema de Gestion o Agregador tambien un identificador para el cliente particular en su sistema.

En el caso que el proveedor es un Sistema de Gestion o Agregador le pedimoos que nos contacte para que podemos pasarle un identificador para agregar a cada aviso.

El format y especificación del archivo xml del feed

The format of the xml file is defined using an XSD file (xml schema definition) and can be found here: El format del archivo xml se define por medio de un archivo XSD (definición del esquema XML) y se ecuentra aca:
enbuenosaires esquema del archivo XML

Luego de hacer un borrador del archivo del feed (recomendamos que al principio lo hacen con pocos avisos), se puede comprobar que esta bien formateado y valido por controlarlo directamente contra el XSD.

Se puede hacer dicha operación en el seguiente sitio:
Validifacdor de XSD
Para entender mejor respecto a este proceso
como validificar y verificar el feed xml que he producido

Ejemplos:

Un ejemplo de un archivo con un solo aviso:
Importante la información se base en ingles dado que el sistema esta basado en ingles.

               <feed version="1.0" feed-type="complete" syndication-partner="proveedor-id">
                   <ad>
                       <ad-id>101018</ad-id>
                       <ad-status>activated</ad-status>
                       <url><![CDATA[http://cliente-inmo.com.ar/ficha.php?id=101018&utm_source=enbsas&utm_medium=portal&utm_campaign=enbsas]]></url>
                       <syndication-partner id="proveedor-id">
                           <publisher-id>proveedor-client-1234</publisher-id>
                           <publisher-name>Client 1234 Propiedades</publisher-name>
                           <publisher-email>info@client-1234-propiedades.com.ar</publisher-email>
                           <publisher-telephone>(011) 1234 1234</publisher-telephone>
                           <publisher-address></publisher-address>
                           <publisher-latitude>-34.6392815</publisher-latitude>
                           <publisher-longitude>-58.514672</publisher-longitude>
                           <contact-info>(011) 1234 1234 // 15 4321 4321</contact-info>
                       </syndication-partner>
                       <title>TORRE \"MIRABILIA\" 2 AMB CON COCHERA - 101018</title>
                       <description>IMPRESIONANTE COMPLEJO "TORRE MIRABILIA" EN PALERMO
                           46 PISOS, TODAS LAS COMODIDADES Y SEVICIOS DE ULTIMA GENERACIÒN.
                ...
                Mas información informativa del inmueble
                ...
                           IDEAL INVERSION INMOBILIARIA.</description>
                       <operation-type>sale</operation-type>
                       <property-type>apartment</property-type>
                       <price period="straight" currency="USD">280000.0</price>
                       <expenses period="month" currency="ARS">850.0</expenses>
                       <published-date>2016-01-05T04:00:23.000</published-date>
                       <updated-date>2016-03-23T04:00:03.000</updated-date>
                       <surface-area unit="square-meter">55</surface-area>
                       <quantity-of-main-rooms>two</quantity-of-main-rooms>
                       <quantity-of-bedrooms>one</quantity-of-bedrooms>
                       <address>
                           <street>Av. JUAN B. JUSTO al 1100</street>
                           <area>Palermo</area>
                           <city>Capital Federal</city>
                           <region>Buenos Aires</region>
                           <country>AR</country>
                       </address>
                       <rooms>
                           <room>kitchen</room>
                       </rooms>
                       <features>
                           <feature>washing-room</feature>
                           <feature>gym</feature>
                           <feature>out-house</feature>
                           <feature>play room</feature>
                           <feature>sauna</feature>
                       </features>
                       <latitude>-34.5823688</latitude>
                       <longitude>-58.4306768</longitude>
                       <year-built>2016</year-built>
                       <images>
                           <url>http://static.proveedor.com/9/101018/files/19.jpg</url>
                           <url>http://static.proveedor.com/9/101018/files/20.jpg</url>
                           <url>http://static.proveedor.com/9/101018/files/21.jpg</url>
                       </images>
                       <video>http://www.youtube.com/watch?v=PDQDM94gL_E</video>
                       <zonification>R1A</zonification>
                   </ad>
                   <!-- more ad elements-->
                   ...
               </feed>
            

Formato y especificación del archivo xml del feed

Mas información del los tags y atributos del xml

nombre del tag //
[nombre del atributo]
tipo de valorobligatorio (sí)
o no
descripción
feed:ad:ad-idalphanumericun valor alfanumerico que distingue el aviso de manera unica en el sistema del proveedor
feed:ad:urlurlnoun url que contiene información del aviso en el sitio del proveedor o del cliente ej: "http://www.cliente-inmo.com.ar/ad.php?id=1234"
feed:ad:syndication-partner[id]alphanumericidentificador creado por enbuenosaires parea identificar al proveedor en el caso que sea un Sistema de Gestion o Agregador e.g. "previsite", "xintel", "inmokey" etc
feed:ad:syndication-partner:publisher-idalphanumericidentificador que distingue el cliente en el sistem del proveedor (creado por el proveedor) e.g. "inmo-1234"
feed:ad:titlealphanumericnoEl titulo del aviso
feed:ad:descriptionalphanumericLa descripción del aviso no deberia incluir datos de contact ni información del proveedor
feed:ad:operation-typealphanumeric / enumIndica la operación del aviso, por ejemplo:
valordescripción
"sale"En Venta
"rental-standard"Alquiler 36 Meses
"rental-commercial"Alquiler Comercial (Locales, Comerciales, Oficinas etc)
"rental-short-term"Alquiler Temporario
"rental-student"Alquiler a Estudiantes
feed:ad:property-typealphanumeric / enumEl tipo de la propiedad
valordescripción
"agricultural"Campo
"apartment"Departamento // Piso // Apartamento
"chalet"Chalet
"commercial"Local
"detached-house"Casa Quinta
"development"Emprendimiento
"duplex"Duplex
"garage"Cochera
"going-concern"Fondo de Comercio
"house"Casa
"gated-community"Country // Barrio Cerrado
"industrial-plant"Planta Industrial
"loft"Loft
"office"Oficina
"other"Otro
"plot"Terreno
"storage"Galpon
"town-house"PH // Propiedad Horizontal
feed:ad:pricenumericel monto numerico de la moneda, sin puntos, commas etc, ej: "125000", "4000"
feed:ad:price[period]alphanumeric / enumIndica si el precio es un solo pago o recorriente (cada mes, trimestre, semana quincena etc)
valordescripción
"straight"Un solo pago (por ejemplo para una propiedad en venta)
"month"Cada Mes
"day"Cada Dia
"week"Cada Semana
"quarter"Cada Trimestre
feed:ad:price[currency]alphanumeric / enumTipo de Moneda del precio ej.: "USD", "ARS", "UYU"
valordescripción
"USD"Dolares Estadounidenses
"ARS"Pesos Argentinos
"UYU"Pesos Uruguayos
feed:ad:expensesnumericnoLas expensas del inmueble e.j. "850"
feed:ad:expenses[period]numericnoLa frequencia del pago de las expensas (igual como feed:ad:price[period])
feed:ad:expenses[currency]numericnoMoneda de las expensas (igual como feed:ad:price[currency])
feed:ad:published-datedateFecha de la primera publicación del inmueble en formato estandard de xml: yyyy-MM-DD'T'HH:MM:SS
e.j.: "2016-01-23T04:00:03"
feed:ad:updated-datedateFecha de la ultima actualización del inmueble: yyyy-MM-DD'T'HH:MM:SS
e.j.: "2016-03-19T04:00:03"
feed:ad:surface-areanumericsuperficie total del inmueble en los unidades especificados
e.j.: "85"
feed:ad:surface-area[unit]alphanumeric / enumlas unidades del superficie:
valordescripción
"square-meter"Metro Cuadrado
"square-foot"Pie Cuadrado
"hectare"Hectare (100 Metros X 100 Metros)
feed:ad:quantity-of-main-roomsalphanumeric / enumcantidad de ambientes:
ValorDescripción
"zero"Cero
"one"Uno
"two"Dos
[etc]Tres hasta Diez en valor en ingles
"more"Mas que diez
feed:ad:quantity-of-bedroomsalphanumeric / enumcantidad de dormitorios:
ValorDescripción
"zero"Cero
"one"Uno
"two"Dos
[etc]Tres hasta Diez en valor en ingles
"more"Mas que diez
feed:ad:addressparentTag del raiz de la dirección del inmueble
feed:ad:address:streetalphanumericLa calle o avenida de la dirección
e.j. "San Martin"
feed:ad:address:buildingalphanumericnoLa altura o nombre del edificio de la dirección
e.j. "900", "La bombonera"
feed:ad:address:intersecting-streetalphanumericnola calle de la esquina o calle que cruzca la calle principal de la dirección
e.j.: "Marcelo T de Alvear"
feed:ad:address:areaalphanumericel barrio, distrito, partido o zona donde se ubica la propiedad
e.j. "Palermo", "Quilmes", "Saavedra", "Coghlan", "La Matanza", "Morón" etc
feed:ad:address:cityalphanumericCualquier de los siguientes valores:
ValorDescripción
"Capital Federal"Capital Federa // CABA
"Zona Norte"Zona Norte de Gran Buenos Aires
"Zona Sur"Zona Sur de Gran Buenos Aires
"Zona Oeste"Zona Oeste de Gran Buenos Aires
"Mar Del Plata"Zona de Mar del Plata
"Costa Atlantica"Costa Atlantica
"Interior Pcia. Bs. As."El Resto de la Provincia de Buenos Aires
feed:ad:address:regionalphanumericLa provincia, actualmente solo "Buenos Aires"
feed:ad:address:countryalphanumericUn codigo del pais de dos letras mayusculas (Lista de codigos de paises), Actualmente el unico pais es Argentina o sea "AR"
feed:ad:roomsparentnoPuede contener tags de "room"
feed:ad:rooms:roomalphanumeric / enumnoun cuarto del inmueble cualquier de los siguientes valores
ValorDescripción
"balcony"Un Balcon
"balcony-extra"Otro Balcon
"bathroom"Baño
"bathroom-extra"Segundo Baño
"dining-room"Comedor
"hall"Hall
"kitchen"Cocina
"kitchen-extra"Otra Cocina
"kitchenette"Cocina Pequeña
"living-room"Living // Sala de Estar
"living-room-extra"Otro Living // Sala de Estar
"none"No Applicable
"office-space"Ofina
"other"Otro
"store-room"Almacen // Baulera
"study"Escritorio
"toilet-extra"Otro Baño
"utility-room"Depósito
feed:ad:featuresparentnopuede contener tags de feature
feed:ad:features:featurealphanumeric / enumnouna caracteristica de un inmueble:
ValorDescripción
"access-by-stairs"Acceso por escaleras
"access-by-truck"Acceso por Camiones
"aircon"Aire Acondiciónado
"back-of-building"Al Contrafrente
"balcony"Al Contrafrente
"balcony"Balcón
"block-units"c/unidades
"bulk-storage"Deposito
"changing-rooms"Vestuarios
"washing-room"Lavedero
"concierge"Encargado
"demolition-rights"con demolición
"drains-sewers"Cloaca
"electricity"Electricidad
"fire-network"Red Incendio
"front-of-building"al Frente
"garden" Jardi
"gas"Gas
"golf-course"Golf
"gym"Gym
"heating" Calefacción
"in-country-residence"En Country
"in-gated-community"En Barrio Cerrado
"internet"Internet // WIFI
"integrated-kitchen"Cocina Integrada
"kitchen-day-room"Cocina Com. Diario
"living-quarters" con Vivienda
"needs-recycling"a refacciónar
"no-building-expenses"Sin Expensas
"office"Escritorio
"on-main-road"Sobre Avenida
"on-street-corner"En Esquina
"on-street"A la Calle
"on-the-coast"Sobre Costa
"out-house"Quincho
"parking"Parking / with cochera
"patio"Patio
"planning-permission"Planos Aprob.
"play-room"Play Room
"professional-use"Apto Profesional
"sauna"Sauna
"security"Sin Expensas
"service-entrance" Ent. De Servicio
"service-quarters" Dep. Serv.
"storage-space"Baulera
"suite"Suite ??
"swimming-pool"Piscina
"telephone-exchange"Central Telef.
"tennis-court"Tenis
"terrace"Terraza
"view-of-water"Vista al Mar
"water-access"Perf. Agua
"weighing-scales"Báscula
"without-columns"Sin columnas
feed:ad:latitudedecimalnovalor decimal del latitud del inmueble
e.j. "-34.5823688"
feed:ad:longitudedecimalnovalor decimal del longitud del inmueble
e.j. "-58.430676800000015"
feed:ad:year-builtintegernoel año de la construcción del inmueble cuatro digitos
e.j. "1998"
feed:ad:imagesparentnocontiene tags de url
feed:ad:images:urlurlnoun url donde se ubica una imagen (foto o plano etc) del inmueble formatos permitidos son: "png", "jpg", "gif"
e.j. "http://static.proveedor.com/9/101018/files/19.jpg"
feed:ad:videourlnoun url que apunte a un video del inmueble
e.j.: (http://www.youtube.com/watch?v=PDQDM94gL_E)
feed:ad:zonificationalphanumeric / enumno la zonificación del inmueble
ValorDescripción
"R1A"Residencial Exclusivo (Media) Vivienda Individual y Colectiva
"R1BI"Residencial Exclusivo (Media Baja) Vivienda Individual y Colectiva
"R1BII"Residencial Exclusivo (Baja) Vivienda Individual y Colectiva
"R2A"Residencial Alto
"R2B"Residencial Media
"R2BIII"Residencial Mayor Diversidad de Usos
"C1"Equipamiento Administración, Comercial, Microcentro Vivienda Solo s/ PB
"C2"Equipamiento Administración, Comercial, Microcentro, Grandes Centros Barriales, Vivienda Solo s/PB
"C3"Equipamiento Administración, Comercial, Centros Barriales, Barriales Vivienda Solo s/PB
"E1"Comercial Mayorista con Local de Venta, Vivienda Solo s/PB o coomo uso Complementario
"E2"Industrias, depositos, vivienda contra frente <= 10 Metros
"E3"Servicio de Areas Residenciales Coexistencia Vivienda
"I"Industrias Depositos Viviendas Complementaria < 91 M2
"P"
"U"
"AE"
"APH"
"RU"
"UF"
"ADP"

Incluir datos de emprendimientos

Si quiere agregar informacion de emprendimientos en el archivo de feed se puede hacer, los emprendimientos figuraran en esta pagina Las instrucciones para hacer la incorporacion se encuentran aca

Ud. tiene una consulta: Cualquier consulta al respecto : consulte aca

Se puede validificar y corroborar el archivo del feed acá

Real Time Web Analytics