Creación de Inmuebles


Introducción

Este es el método para crear inmuebles, se hacen varias validaciones y desde aquí es posible agregar nuevos inmuebles en la inmobiliaria. Es método que debe manejarse con mucho cuidado porque los inmuebles que se insertan no se pueden borrar de la base de datos, sin embargo, se puede cambiar el estado de los inmuebles.

No se puede agregar inmuebles a otras inmobiliarias diferentes a la propia, pero se pueden agregar inmuebles a otras sucursales de la misma inmobiliaria desde este método.

En el ejemplo se puede observar que los elementos se envían como "form_params", debido a que no se pueden enviar simplemente en la url porque causaría una reacción adversa por parte del API.

Ejemplo de uso

{success} POST: /properties

use GuzzleHttp\Client;

$client = new Client();
$res = $client->request("POST", "{$endpoint}/properties", [
    "headers" => [
        "Authorization" => "TOKEN_INGRESO"
    ],
    "form_params" => [
        "codpro" => 12345,
        "description" => "Descripción de prueba para creación",
        "neighborhood_code" => 123
    ]
]);

$properties = json_decode($res->getBody(), true);
return $properties;

Ejemplo de respuesta

{
    "code": 200,
    "message": "The property was created successfully",
    "property": {
        "idpro": 123456,
        "codpro": 123,
        "pictures": [],
        "pictures360": []
    }
}

Parámetros que recibe

Por Header

Parámetro Descripción Ejemplo
Authorization Token de ingreso e identificador de la inmobiliaria (obligatorio) "Authorization" => "TOKEN_INGRESO"

Por URL

Los parámetros en negrilla son obligatorios. Los parámetros en cursiva pueden ser obligatorios de acuerdo a la configuración inicial de la inmobiliaria

Parámetro Descripción Ejemplo
codpro Código del inmueble (no obligatorio si el código se genera automáticamente) ?codpro=262
city Ciudad del inmueble &city=11001
address Dirección del inmueble (requerido si no se envía el campo "complete_address")  &address=25
latitude Latitud &latitude=123456789
longitude Longitud &longitude=123456789
zone Zona del inmueble &zone=3
biz Tipo de negocio del inmueble &biz=2
stratum Estrato del inmueble &stratum=4
type Tipo de inmueble &type=5
neighborhood Barrio del inmueble (obligatorio si no se envía neighborhood_code) &neighborhood=colina
neighborhood_code Id del barrio (obligatorio si no se envía neighborhood) &neighborhood_code=4751
area_cons Área construida del inmueble en m² (obligatorio en ciertos tipos de inmueble) &area_cons=60
area_lot Área de lote en m² (obligatorio en ciertos tipos de inmueble) &area_lot=80
private_area Área privada en m² &private_area=80.2
floor_type Tipo de piso &floor_type=ceramica
level Piso o nivel del inmueble en un edificio &level=2
building_unit Unidad del edificio &building_unit=2
window_sign ¿Hay aviso en ventana? &window_sign=1
front Frente &front=1
rear Fondo &rear=1
bedrooms Habitaciones (obligatorio en ciertos tipos de inmueble) &bedrooms=4
bathrooms Baños (obligatorio en ciertos tipos de inmueble) &bathrooms=4
parking Cantidad de parqueaderos &parking=4
parking_covered Cantidad de parqueaderos cubiertos &parking_covered=4
rent Precio de arriendo (obligatorio si "biz" es 1 o 3) &rent=1200000
saleprice Precio de venta (obligatorio si "biz" es 2 o 3) &saleprice=1200000
administration Valor de administracion &administration=250000
description Descripción del inmueble &description=remodelado
english_description Descripción del inmueble en inglés &english_description=this is a description
french_description Descripción del inmueble en francés &french_description=la description
descripcionmetrocuadrado Descripción del inmueble para metro cuadrado &descripcionmetrocuadrado=descripción...
description_mls Descripción del inmueble para grupos inmobiliarios &description_mls=descripción...
restrictions Restricciones del inmueble &restrictions=no se admiten perros
comment Comentario del inmueble &comment=Comentario
comment2 Comentario 2 del inmueble &comment2=Comentario
video Video del inmueble &video=https://...
tour3d Tour 3D/360 del inmueble &tour3d=https://...
status Estado del inmueble (si no se envía se genera automáticamente deacuerdo a la configuración de la inmobiliaria) &status=3
built_year Año de construcción &built_year=1998
remodeling_year Año de remodelación &remodeling_year=1998
great ¿Es inmueble destacado? &great=1
exclusive ¿Es inmueble exclusivo? &exclusive=1
destination Destino del inmueble &destination=2
broker Asesor que tiene el inmueble asignado &broker=1256
promoter_broker Asesor promotor del inmueble (si no se envía queda el campo "broker" por defecto) &promoter_broker=1256
catcher_broker Asesor que captó el inmueble (si no se envía queda el campo "broker" por defecto) &catcher_broker=1256
branch Sucursal &branch=601
amenities Caracteristicas del inmueble &amenities=24,87,63
publication_date Fecha de publicación &publication_date=2020-03-30 11:10:00
update_date Fecha de actualización &update_date=2020-03-30 11:10:00
consignation_date Fecha de consignación &consignation_date=2020-03-30 11:10:00
registry_date Fecha de registro &registry_date=2020-03-30 11:10:00
comission_percentage Porcentaje de comisión &comission_percentage=3
registration Número de matrícula &registration=39ol
reference Referencia &reference=39ol
rental_premise_value Valor de renta de locales &rental_premise_value=300000
iva Porcentaje de iva del inmueble &iva=19
image_# Link de imagen y orden de la imagen del inmueble (hasta 30) &image_20=https://...
image360_# Link de imagen 360 y orden de la imagen del inmueble (hasta 30) &image360_20=https://...
complete_address Requerido si no se envía el campo "address" &complete_address=1
dir_1 - 10 Campos de la dirección completa del 1 al 10 se requiere mayor información &dir_1=1