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.
{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;
{
"code": 200,
"message": "The property was created successfully",
"property": {
"idpro": 123456,
"codpro": 123,
"pictures": [],
"pictures360": []
}
}
Parámetro | Descripción | Ejemplo |
---|---|---|
Authorization | Token de ingreso e identificador de la inmobiliaria (obligatorio) | "Authorization" => "TOKEN_INGRESO" |
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 (requerido si no se envía city_zone) | &zone=3 |
city_zone | Zona de ciudad del inmueble (requerido si no se envía zone) | &city_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 | ®istry_date=2020-03-30 11:10:00 |
comission_percentage | Porcentaje de comisión | &comission_percentage=3 |
registration | Número de matrícula | ®istration=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 |