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. Este método 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 su estado.

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 "json", debido a que no se pueden enviar simplemente en la url porque causaría una reacción adversa por parte del API.

Las imágenes se suben en un método aparte y ese es un método que aplica tanto para creación como para actualización de inmuebles.

Ejemplo de uso

{success} POST: /properties

use GuzzleHttp\Client;

$client = new Client();
$res = $client->request("POST", "{$endpoint}/properties", [
    "headers" => [
        "Content-type" => "application/json",
        "Accept" => "application/json",
        "Authorization" => "TOKEN_INGRESO"
    ],
    "json" => [
        "code" => 12345,
        "description" => "Descripción de prueba para creación",
        "amenities" => [
            [
                "id": 11,
                "nombre": "habitaciones",
                "valor": "2",
                "comentario": "Dos habitaciones dobles",
                "segundaria": [
                    "id": 54,
                    "name": "Doble",
                    "amenity_id": 11
                ]
            ]
        ]
    ]
]);

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

Ejemplo de respuesta

{
    "code": 200,
    "message": "The property was created successfully",
    "property": {
        "unique_code": 123456,
        "code": 123
    }
}

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 Body (Form params)

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
title Título del inmueble &title=Inmueble en...
property_type Tipo de inmueble &property_type=1
ubication1 País del inmueble &ubication1=1
address Dirección del inmueble &address=Calle 22...
latitude Latitud de la dirección &latitude=4.12...
longitude Longitud de la dirección &latitude=-7.12...
code Código en texto o referencia del inmueble &code=ABC123
rent Si el inmueble está en arriendo (requerido si no se envía sale o single_rent) &rent=true
sale Si el inmueble está en venta (requerido si no se envía rent o single_rent) &sale=true
single_rent Si el inmueble está en alquiler por días (requerido si no se envía rent o sale) &single_rent=true
rent_price Precio de arriendo del inmueble &rent_price=100000
sale_price Precio de venta del inmueble &sale_price=100000
rent_per_date_price Precio de alquiler por días del inmueble &rent_per_date_price=100000
administration_price Precio de administración del inmueble &administration_price=100000
branch Sucursal u oficina del inmueble (si no se envía, queda registrada la del usuario por defecto) &branch=1
catcher_broker Asesor captador del inmueble (si no se envía, queda registrad el usuario por defecto) &catcher_broker=1
promoter_broker Asesor captador del inmueble (si no se envía, queda registrad el usuario por defecto) &promoter_broker=1
consignation_date Fecha de consignación &consignation_date=2020-03-03 10:00:00
stratum Estrato del inmueble &stratum=2
featured ¿Es inmueble destacado? &featured=true
exclusive ¿Tiene el inmueble mandato exclusivo? &exclusive=true
description Descripción general del inmueble &description=Descripción...
ubication2 Ubicación 2 del inmueble (generalmente sería departamento/región) &ubication2=1
ubication3 Ubicación 3 del inmueble (generalmente sería ciudad) &ubication3=1
ubication4 Ubicación 4 del inmueble (generalmente sería localidad/barrio) &ubication4=1
neighborhood Barrio en texto del inmueble &neighborhood=1
video_platform Plataforma de video donde está el video del inmueble (youtube por defecto) &video_platform=1
video_code Código del video en la plataforma seleccionada &video_code=ah789adA
virtual_tour Url del tour virtual si tiene &virtual_tour=https://...
amenities JSON con las características del inmueble (un ejemplo de ello está en el ejemplo de uso) &amenities='{...}'
custom_description_# Descripción personalizada del inmueble, el número que se especifica corresponde al campo "code" de los elementos de la respuesta &custom_description_2=Descripción del inmueble para portales
custom_description_generated_# Se especifica si ésta descripción fue generada con inteligencia artificial custom_description_generated_#=1