Api Documentation

Si se informa id de agencia en el anuncio tiene que coincidir con las credenciales usadas para la autenticación de la API.

El tipo y subtipo de inmueble deben ser válidos.

Los inmuebles deben tener una única dirección especificada, siendo ésta obligatoria.
Las coordenadas X,Y son obligatorias, y deben tener un valor distinto de 0.
Las coordenadas deben ser válidas, comprendidas dentro de los valores válidos.
En inmuebles de España, el código postal es opcional si se especifican las coordenadas X,Y aunque se recomienda especificarlo, siendo comprobada su validez. En inmuebles fuera de España (Francia, Andorra…) el código postal es obligatorio.

Es obligatorio especificar al menos una transacción.
Cada transacción debe tener el Price y el PriceM2 con valor especificado.
El alquiler con opción a compra implica enviar dos transacciones: Alquiler y Alquiler con opción a compra.
Los tipos de transacción deben estar permitidos para el tipo de inmueble del anuncio:
- Piso y Casa no admiten Traspaso
- Local, Oficina, Edificio, Suelo, Industrial y Hotel no admiten A compartir.
- Suelo no permite la transacción alquiler. Se rechazarán los inmuebles de tipo ”Suelo” si alguna de sus transacciones es “Alquiler”.
- Parking y Trastero no admiten Traspaso y A compartir.

Se debe especificar un usuario o listado de usuarios con un identificador válido.
Debe especificarse el usuario principal.
Los usuarios especificados deben existir.

El extra de superficie es obligatorio (id = 1). Se rechazarán valores con punto ( “.”) delante tipo “.010”.
Los extras especificados deben existir.
Los extras especiales de alquiler solo están disponibles para Piso y Casa y debe existir una transacción de alquiler especificada.
Los extras especiales de compartir solo están disponibles para Piso y Casa y debe existir una transacción de compartir especificada.

Las publicaciones deben tener un identificador válido de la tabla de publicaciones en la página de diccionarios.
La agencia debe tener permisos para las publicaciones especificadas.
Si quiere publicar los inmuebles en alguna publicación es obligatorio indicar el identificador de la publicación en concreto (campo Fk_PublicationId de la sección PropertyPublications en el json).

Los campos ContactTypeId y ValueTypeId tienen que tener el mismo valor.
El campo ValueTypeId de PropertyContactInfo determina el tipo de contacto que muestra el anuncio.
Los datos de contacto de la agencia configurados en la pestaña Herramientas de Inmofactory, prevalecen sobre los datos que se envíen en el JSON.

Este campo no puede contener “/“ por entrar en conflicto con las URL resultantes.

Para enviar vídeos de youtube o vimeo hay que especificar en el nodo de PropertyDocument, el nodo TypeId = 8 y el nodo FileTypeId = 17

¡Importante! De acuerdo al RD 390/2021, de 1 de junio, te recordamos que es obligatorio indicar todos los valores del certificado energético en los anuncios de venta o alquiler de inmuebles. La opción “en trámite” no es válida, si la indicas confirmas que el certificado energético de este inmueble está siendo tramitado por un profesional cualificado, y que actualizarás este campo una vez finalizada la certificación. Más información en: Real Decreto 390/2021 ¿Cuándo es obligatorio el certificado energético?
Te informamos que en los inmuebles ubicados en Cataluña si seleccionas la opción “en trámite” o no informas alguno de los campos, tu anuncio se publicará en Fotocasa con la calificación energética menos eficiente (“G”-999), tanto en emisiones como en consumo.