PROD

Este servicio devuelve el detalle de una propiedad.

Información del recurso
AutenticaciónRequired
Scopeinternal-portal
Método HTTPGET
RespuestaJSON
Versión2

Alcance de red

Si tu cliente tiene el scope network-suscription, la propiedad debe pertenecer a un cliente de tu red. Las propiedades fuera de tu red devuelven un error de no encontrado, incluso si el hash es válido.

URL del recurso

https://mapaprop.app/api/action/portal-v2/properties/{propertyHash}

Ejemplo de llamada

GET /api/action/portal-v2/properties/YoJEWd1x4qvlpGw HTTP/1.1
Host: mapaprop.app
Content-Type: application/x-www-form-urlencoded
Content-Length: 0
Authorization: Bearer {access_token}

Parámetros

ClaveTipoRequeridoDescripción
propertyHashstringyesEl Hash ID de la propiedad

Respuesta

Un documento JSON con el detalle de la propiedad.

ObjetoCampoTipoRequeridoDescripción
ResponsepropertyProperty objectyesEl objeto propiedad
PropertypropertyHashstringyesID único de la propiedad
timestampstringyesTimestamp ISO8601 de cuándo se creó la propiedad
lastUpdatestringyesTimestamp ISO8601 de la última actualización
codestringyesCódigo único de la propiedad ingresado por el cliente
branchIdintyesID de la sucursal asociada a la propiedad. GET /api/action/express-v1/branches.
typeintyesTipo de propiedad. GET /api/action/portal-v2/settings/types/{country}
propertyTypestringyesDescripción traducida del tipo de propiedad. GET /api/action/portal-v2/settings/types/{country}
operationintyesOperación de la propiedad. GET /api/action/portal-v2/settings/operations/{country}
propertyOperationstringyesDescripción traducida de la operación. GET /api/action/portal-v2/settings/operations/{country}
statusintyesID del estado edilicio. Constantes
mainImagestringnoURL del thumbnail principal de la propiedad
currencystringyesSímbolo de moneda del precio. Constantes
priceintyesPrecio de la propiedad
expensesCurrenciesstringnoSímbolo de moneda de las expensas. Constantes
expensesPriceintnoMonto de las expensas mensuales / anuales
taxCurrencystringnoSímbolo de moneda de los impuestos. Constantes
taxPriceintnoMonto de los impuestos mensuales / anuales
titlestringyesTítulo ingresado por el cliente
addressstringyesCalle y número de la propiedad
zipCodestringyesCódigo postal de la ubicación
zonestringyesDescripción amigable que combina ciudad (si está disponible) y provincia
countryIdintyesID del país de la propiedad
stateIdintyesID de la provincia. GET /api/action/express-v1/zones
countyIdintyesID del partido / condado. GET /api/action/express-v1/zones
cityIdintnoID de la ciudad. GET /api/action/express-v1/zones
countryIdintyesID del país de la propiedad. GET /api/action/express-v1/zones
countrystringyesNombre del país
statestringyesNombre de la provincia
countystringyesNombre del partido o segunda división
citystringnoNombre de la ciudad / barrio o tercera división
suspendedbooleanyesLa publicación fue suspendida
reservedbooleanyesLa propiedad fue reservada
rentedbooleanyesLa propiedad fue alquilada
soldbooleanyesLa propiedad fue vendida
descriptionstringyesDescripción larga de la propiedad
conditionsstringnoCondiciones de la propiedad. Generalmente relacionadas con el pago
bedroomsintnoCantidad de dormitorios
ambiencesintnoCantidad de ambientes
bathroomsintnoCantidad de baños
dependenciesintnoCantidad de dependencias (cuartos extra)
occupancyintnoCantidad de ocupantes (generalmente para alquiler temporal)
toilettesintnoCantidad de toilettes (medios baños)
buildingAreaintnoMetros cuadrados de superficie cubierta
landAreaintnoMetros cuadrados de terreno
yearsOldintnoAntigüedad de la propiedad
ubicationstringnoOrientación cardinal de la propiedad en el edificio
totalFloorsintnoTotal de pisos del edificio
apartmentsPerFloorintnoCantidad de departamentos por piso
airConditionerTypestringnoTipo de aire acondicionado
waterHeaterTypestringnoTipo de calefón
heatingTypestringnoTipo de calefacción
balconyTypestringnoTipo de balcón
garageintnoCantidad de garajes de la propiedad
garageTypestringnoTipo de garage
imagesArray of ImagenoArray de objetos Image
locationLocationyesObjeto de ubicación geográfica
LocationlonstringyesLongitud de la propiedad
latstringyesLatitud de la propiedad
ImageimagestringyesURL de la imagen
thumbnailstringyesURL del thumbnail
orientationintyesOrientación de la imagen. 1 = PORTRAIT, 2 = LANDSCAPE
typeintyesTipo de imagen.
1 = PHOTO,
2 = BLUEPRINT
contentTypestringyesTipo de contenido de la imagen
timestampstringyesTimestamp ISO8601 de cuando se subió la imagen
branchBranch DataArray of infoyesLista de datos de la sucursal del agente
zipstringyes
zone0Descriptionstringyes
zone1Descriptionstringyes
zone2Descriptionstringyes
zone3Descriptionstringno
zone0intyes
zone1intyes
zone2intyes
zone3intno
addressstringyes
phone1stringyes
phone2stringno
phone3stringno
mobilestringno
mainbooleanyes
namestringyes
emailstringyes
customerstringyes
LabelslabelsArray of labelsnoEtiquetas / amenidades de la propiedad - Constantes
customercustomerAddressstringyes
customerCountryintyes
customerEmailstringyes
customerIdintyes
customerlogostringyes
customerNamestringyes
customerPhonestringyes
attributesattributesArray of json attributesnoTodos los atributos de la propiedad
descriptionFormatteddescriptionstringnoDescripción con nuevo formato que acepta saltos de línea
videosvideosArray of jsonnoVideos de la propiedad (URL o embed)

El grupo de desarrollo

Toda propiedad trae estos cuatro campos, sea o no un desarrollo. Siempre vienen: un valor en 0, en false o en [] significa "no aplica", no "falta el dato".

CampoTipoEn un desarrolloEn una unidadEn una propiedad común
developmentbooleantruefalsefalse
developmentIdint0 (no tiene padre)el propertyId del desarrollo0
developmentPropertiesArraylos propertyId de sus unidades[][]
developmentStatsObjectlos números derivados — ver abajoausenteausente

developmentStats es el único que no siempre está: se escribe sólo en un desarrollo que tenga unidades vinculadas. Un proyecto sin unidades cargadas no lo trae, y eso es correcto — no hay nada de qué derivarlo.

Los 10 campos declarados del proyecto

Los declara la inmobiliaria y sólo tienen sentido en un desarrollo. Un contador en 0 significa que no se declaró, no que valga cero.

CampoTipoDescripción
commercialTaglinestringLa leyenda comercial del proyecto
deliveryDatestringFecha de entrega, en formato ISO con zona horaria
logoUrlstringEl logo del proyecto — distinto del logo de la inmobiliaria
totalApartmentsintDepartamentos
totalHousesintViviendas
totalLotsintLotes
totalTowersintTorres
totalElevatorsintAscensores
totalOfficesintOficinas
totalCommercialUnitsintLocales comerciales

developmentStats — los números derivados de las unidades

Se calculan en el backend a partir de las unidades vinculadas, una sola vez y para todas las superficies. No se derivan de los 10 campos de arriba: aquéllos son lo que el proyecto anuncia, éstos son lo que sus unidades cargadas dicen.

BloqueCampos
unitstotal · available · sold · rented · reserved · suspended · withOperation · availabilityRate
buildingAreatotal · available · sold · rented · reserved · unavailable · unit
pricesbyCurrency (por moneda: units · from · to · average · total) · mixedCurrencies
sale · rent · otherOperationunits · commercialized · rate
typologybyAmbiences · byRooms · byBuildingArea · byLandArea — conteo de unidades por valor

Si mixedCurrencies es true, el desarrollo tiene unidades en más de una moneda y no existe un rango único: hay que leer byCurrency moneda por moneda. Mostrar un solo rango mezclando monedas da un número que no significa nada.

Ejemplo del grupo

{
    "development": true,
    "developmentId": 0,
    "developmentProperties": [257092, 257093, 257094, 257095],
    "commercialTagline": "Torres del Parque, el emprendimiento que cambia el barrio",
    "deliveryDate": "2028-03-15T00:00:00.000-03:00",
    "totalApartments": 120,
    "totalTowers": 3,
    "developmentStats": {
        "units": { "total": 4, "available": 4, "sold": 0, "availabilityRate": 100 },
        "buildingArea": { "total": 936, "available": 936, "unit": "m2" },
        "prices": {
            "byCurrency": { "ARS": { "units": 4, "from": 2333333, "to": 2333333, "average": 2333333 } },
            "mixedCurrencies": false
        }
    }
}

Ejemplo de respuesta

{
  "property": {
      "country": "Argentina",
      "heatingType": "Estufas",
      "occupancy": 2,
      "waterHeaterType": "Termotanque",
      "landArea": 200,
      "county": "Chilecito",
      "buildingArea": 120,
      "ubication": "Lateral",
      "cityId": 4011,
      "type": "1",
      "propertyType": "Departamento",
      "apartmentsPerFloor": 3,
      "zone": "Colonia Malligasta, Chilecito, La Rioja, Argentina",
      "price": 2500,
      "airConditionerType": "Split/Ventana",
      "state": "La Rioja",
      "branchId": 23443,
       "videos": [
        {
            "custId": 1,
            "description": "asdasdsadadasd",
            "videoId": 7252,
            "source": "https://www.youtube.com/shorts/DV5mG3XGPZU",
            "propertyId": 256854
        },
        {
            "custId": 1,
            "description": "asdasdsadadasd",
            "videoId": 7253,
            "source": "https://www.youtube.com/watch?v=gLcP6qqulhA&ab_channel=NovalProperties",
            "propertyId": 256854
        },
        {
            "custId": 1,
            "description": "asdasdsadadasd",
            "videoId": 7254,
            "source": "<iframe width=\"560\" height=\"315\" src=\"https://www.youtube.com/embed/gLcP6qqulhA?si=CpKaYWLYZXXh4zyP\" title=\"YouTube video player\" frameborder=\"0\" allow=\"accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share\" referrerpolicy=\"strict-origin-when-cross-origin\" allowfullscreen></iframe>",
            "propertyId": 256854
        },
        {
            "custId": 1,
            "description": "dasdsadsss",
            "videoId": 7258,
            "source": "https://my.matterport.com/show?play=1&lang=en-US&m=CmhKN1eSdqR",
            "propertyId": 256854
        }
    ],
      "branch": {
        "zip": "1878",
        "zone2Description": "Quilmes",
        "branchId": 7914,
        "address": "Lavalle 654 ",
        "phone2": "11-0000-0000",
        "main": true,
        "zone0Description": "Argentina",
        "zone3": 1098,
        "zone2": 237,
        "zone1": 2,
        "zone0": 1,
        "phone1": "7078-0000",
                "mobile": "541144440000"
        "zone1Description": "Buenos Aires",
        "custId": 7466,
        "name": "Gabriel Bagnato Bienes Ra?ces",
        "zone3Description": "Quilmes",
        "email": "xxxxx@gmail.com",
        "customer": "Ruben Inmobiliaria"
    },
      "images": [
        {
          "image": "https://s3.amazonaws.com/mapaprop-dev/photos/2342/92478/755270.jpg",
          "thumbnail": "https://s3.amazonaws.com/mapaprop-dev/photos/234/92478/755270t.jpg",
          "orientation": 1,
          "imageId": 234432,
          "main": true,
          "type": 1,
          "contentType": "image/jpeg",
          "timestamp": "2015-11-18T22:47:53Z"
        },
        {
          "image": "https://s3.amazonaws.com/mapaprop-dev/photos/234/9242348/755271.jpg",
          "thumbnail": "https://s3.amazonaws.com/mapaprop-dev/photos/1687/2/34755271t.jpg",
          "orientation": 2,
          "imageId": 234,
          "main": false,
          "type": 1,
          "contentType": "image/jpeg",
          "timestamp": "2015-11-18T22:48:23Z"
        }
      ],
      "bathrooms": 1,
      "suspended": false,
      "dependencies": 3,
      "labels": [
        "mortgageReady",
        "professionalAvailable",
        "furnished",
        "janitor",
        "grill",
        "security",
        "securityBox",
        "swimmingPool",
        "partySaloon",
        "cableIncluded",
        "heating",
        "airConditioning",
        "telephoneLine",
        "dialyDinning",
        "alarm",
        "frontGarden",
        "garage",
        "laundry",
        "patio",
        "playroom",
        "privateElevator",
        "suite"
      ],
      "bedrooms": 2,
      "ambiences": 2,
      "balconyType": "Terraza",
      "yearsOld": 2,
      "reserved": false,
      "lastUpdate": "2017-11-01T06:40:40.000-04:00",
      "paymentPeriod": "Por mes",
      "conditions": "•\tAlquiler pago mes a mes. •\tDepósito de 1 mes de alquiler. •\tComisión inmobiliaria. ",
      "status": "A Refaccionar",
      "code": "1687-paunero.lasheras-102apt",
      "expensesCurrency": "USD",
      "city": "Colonia Malligasta",
      "description": "Muy luminoso departamento muy bien ubicado en Palermo - Gran balcón - Totalmente amoblado - Gran Sofa - Cocina completamente equipada - Cama grande - baño completo - Tv con Cable - Wifi - Todo INCLUIDO",
      "alternativePrices": [],
      "title": "Hermoso y muy Luminoso depto ubicado en Palermo",
      "totalFloors": 2,
      "countryId": 1,
      "toilettes": 2,
      "seoUrl": "alquiler-temporario-de-departamento-en-colonia-malligasta234-la-rioja-16e87-344",
      "rented": false,
      "expensesPrice": 322,
      "countyId": 561,
      "hightlight": {},
      "currency": "ARS",
      "timestamp": "2015-11-18T00:00:00.000-05:00",
      "sold": true,
      "orientation": "NORTE",
      "address": "Paunero ",
      "zipCode": "1661",
      "stateId": 12,
      "propertyHash": "9cd969ac3a4623sdffd2cfeea1abab7",
      "mainImage": "https://s3.amazonaws.com/mapaprop-dev/photos/32443/2434/755270t.jpg",
      "taxCurrency": "USD",
      "garage": 2,
      "garageType": "Garage Cubierto",
      "taxPrice": 329032,
      "location": {
        "lon": "-58.409215670639014",
        "lat": "-34.58256378363613"
      },
      "operation": "3",
      "propertyOperation": "Alquiler Temporario",
      "customerLogo": "https://s3.amazonaws.com/mapaprop-dev/photos/32443/2434/755270t.jpg",
      "customerAddress": "Malabia 3526",
      "customerCountry": 1,
      "customerEmail": "email@dominio.com",
      "customerId": 0000,
      "customerName": "Inmobiliaria X",
      "customerPhone": "111-111",
            "attributes": [
                {
                    "group_sub": "label",
                    "country": "ar",
                    "key_legacy": "electricity",
                    "group_subtype": "services",
                    "id": "electricity",
                    "label": "Electricidad",
                    "locale": "es_AR",
                    "type": "bool",
                    "group": "propertyAttribute",
                    "status": true
                },
                {
                    "group_sub": "label",
                    "country": "ar",
                    "key_legacy": "grill",
                    "group_subtype": "ammenities",
                    "id": "grill",
                    "label": "Parrilla",
                    "locale": "es_AR",
                    "type": "bool",
                    "group": "propertyAttribute",
                    "status": true
                },
                {
                    "group_sub": "label",
                    "country": "ar",
                    "key_legacy": "laundryMachine",
                    "group_subtype": "ammenities",
                    "id": "laundry-machine",
                    "label": "Lavarropas",
                    "locale": "es_AR",
                    "type": "bool",
                    "group": "propertyAttribute",
                    "status": true
                },
                {
                    "group_sub": "label",
                    "country": "ar",
                    "key_legacy": "professionalAvailable",
                    "group_subtype": "extras",
                    "id": "professional-available",
                    "label": "Apto profesional",
                    "locale": "es_AR",
                    "type": "bool",
                    "group": "propertyAttribute",
                    "status": true
                },
                {
                    "group_sub": "label",
                    "country": "ar",
                    "key_legacy": "hasSecurity",
                    "group_subtype": "services",
                    "id": "security",
                    "label": "Seguridad",
                    "locale": "es_AR",
                    "type": "bool",
                    "group": "propertyAttribute",
                    "status": true
                },
                {
                    "group_sub": "label",
                    "country": "ar",
                    "key_legacy": "sewers",
                    "group_subtype": "services",
                    "id": "sewers",
                    "label": "Cloacas",
                    "locale": "es_AR",
                    "type": "bool",
                    "group": "propertyAttribute",
                    "status": true
                }
          ],
        "descriptionFormatted": "Test Images, Propiedad TestTest Images, \n\nPropiedad Test",
    }
}