Todo anúncio publicado fica salvo em nosso banco de dados sob seu Id. Eventualmente você pode despublicá-lo (Zonaprop API > DELETE aviso ), publicá-lo novamente (Zonaprop API > PUT aviso ) ou modificá-lo sem perder os dados.

Aqui um exemplo de como cada campo pode ser preenchido

  • property : faz referência a um objeto de imóvel
  • customerData: faz referência a um objeto do cliente da aplicação
  • propertyPriceNavent: Se o imóvel tiver um preço de 1, será mapeado com o preço 0 no Zonaprop (casos especiais de imóveis)
  • characteristicsNavent : faz referência às características previamente mapeadas no formato exigido pelo Zonaprop
  • A documentação oficial está no seguinte link https://open-docs.navent.com/arg/modelo-de-aviso/

Modelo de trabalho.

{
    "realStateId": property.custId,
    "propertyId": property.propertyId,
    "apiKey":apikeyNavent,
    "custId":property.custId,
    "brand":"mapaprop",
    "propertyJson": {
      "codigoAviso": property.propertyId,
      "claveReferencia": null,
      "titulo":property.title,
      "descripcion":property.description,
      "tipoDePropiedad": {
          "idTipo":propertyTypeId,
          "tipo":propertyTypeName,
          "idSubTipo": null,
          "subTipo": null
      },
      "caracteristicas": characteristicsNavent,
      "precios": [
          {
              "monto": propertyPriceNavent,
              "moneda": property.currency,
              "operacion": propertyOperationId
          }
      ],
      "multimedia": {
          "imagenes": imagesNavent,
          "videos": null,
          "recorridos360": null,
          "planos": houseMapsNavent
      },
      "localizacion": {
        "codigoPostal": property.zipcode,
        "direccion": property.address,
        "idUbicacion": zoneNavent,
        "latitud": property.mapLatitude,
        "longitud": property.mapLongitude,
        "muestraMapa": "EXACTO",
        "ubicacion": zoneDescription
      },
      "publicacion": {
          "tipoDePublicacion": plan,
      },
      "publicador": {
          "codigoInmobiliaria": property.custId,
          "emailAsesor": customerData.email,
          "emailDeContacto": customerData.email,
          "nombreDeContacto": customerData.name,
          "telefonoDeContacto": customerData.phone1
      },
  }
}

Modelo final Zonaprop July 17, 2025

{
  "claveReferencia": "ADPM12",
  "codigoAviso": "ONCA213",
  "titulo": "Departamento espacioso con vista al mar - Excelente oportunidad",
  "descripcion": "Departamento 3 ambientes con pileta y cochera",
  "localizacion": {
    "codigoPostal": "5312-MI",
    "direccion": "Casa en Lomas de la Rioja, Riviera Veracruzana",
    "idUbicacion": "V1-C-2491",
    "latitud": "19.02689486",
    "longitud": "-96.096215",
    "muestraMapa": "EXACTO",
    "ubicacion": "Riviera Veracruzana"
  },
  "caracteristicas": [
    {
      "idValor": "0",
      "nombre": "SERVICIOS|CISTERNA",
      "valor": "False"
    },
    {
      "idValor": "0",
      "nombre": "GENERALES|MASCOTAS",
      "valor": "False"
    },
    {
      "valor": "2",
      "nombre": "GENERALES|ELEVADOR(S)",
      "idValor": null
    },
    {
      "id": "1000129",
      "nombre": "SERVICIOS|TELEFONO",
      "valor": "True",
      "idValor": "1"
    },
    {
      "id": "CFT5",
      "nombre": "PRINCIPALES|ANTIGUEDAD",
      "valor": "20",
      "idValor": null
    },
    {
      "id": "1000032",
      "nombre": "GENERALES|SUPERFICIE_DEL_TERRENO_(M2)",
      "valor": "256",
      "idValor": null
    },
    {
      "id": "1000036",
      "nombre": "GENERALES|TIPO_TECHO",
      "valor": "Pizarra",
      "idValor": "1000238"
    },
    {
      "id": "1000078",
      "nombre": "GENERALES|PARRILLA",
      "valor": "True",
      "idValor": "1"
    }
  ],
  "multimedia": {
    "imagenes": [
      {
        "titulo": "Cuarto principal",
        "urlImagenOriginal": "https://images.com/2020/12/18/departamento_a_estrenar.jpg"
      }
    ],
    "planos": [
      {
        "titulo": "Primer Plano",
        "urlImagenOriginal": "https://planos.com/2020/12/18/plano_del_departamento.jpg"
      }
    ],
    "recorridos360": [
      {
        "codigoRecorrido360": "view/depto_360.com",
        "titulo": "Video 360"
      }
    ],
    "videos": [
      {
        "codigoVideo": "e4agbGljftk8",
        "titulo": "Sala principal"
      }
    ]
  },
  "precios": [
    {
      "moneda": "MXN",
      "monto": "1550000",
      "operacion": "VENTA"
    }
  ],
  "publicacion": {
    "tipoDePublicacion": "DESTACADO"
  },
  "publicador": {
    "codigoInmobiliaria": "ON1254",
    "emailAsesor": "asesor@mail.com",
    "emailDeContacto": "contacto@mail.com",
    "nombreDeContacto": "Esteban Raul",
    "telefonoDeContacto": "555-48695-42"
  },
  "tipoDePropiedad": {
    "tipo": "1"
  }
}

Mapeamento de Zonas

Para obter a zona correta do Navent, você deve mapear suas zonas com as do Navent. Para isso contamos com um sistema composto por vários métodos. Você pode ver os detalhes em Zonaprop API > Mapping zone

Mapeamento de Características

As características devem cumprir um formato predefinido para que possam ser validadas corretamente durante um Zonaprop API > PUT aviso

Para obter o formato necessário, você pode fazer um GET ao endpoint de características do Navent, passando o access_token do integrador OpenNavent como parâmetro na URL

https://api-zp.open.navent.com/v1/tipopropiedades/1/caracteristicas?access_token=xxxx

Cada característica tem um id a partir do qual podemos mapear cada uma delas com as do seu APP


//Autorização necessária

//Endpoint
https://api-navent.mapaprop.com/property-api/navent/put-property

//JSON body
{
    "realStateId": "3454",
    "propertyId": 188017,
    "apiKey": "40a6660d-dfb3-48ca-8cbd-f381a525b2a4",
    "custId": 1,
    "brand": "mapaprop",
    "propertyJson": {
        "codigoAviso": "188017___mapaprop",
        "claveReferencia": null,
        "titulo": "esta es la propiedad A58f",
        "descripcion": "una gran casa una gran",
        "tipoDePropiedad": {
            "idTipo": "1",
            "tipo": "Casa",
            "idSubTipo": null,
            "subTipo": null
        },
        "caracteristicas": [
            {
                "id": "CFT4",
                "nombre": "PRINCIPALES|MEDIO_BANO",
                "valor": "1",
                "idValor": null
            },
            {
                "id": "CFT2",
                "nombre": "PRINCIPALES|DORMITORIO",
                "valor": "2",
                "idValor": null
            },
            {
                "id": "CFT7",
                "nombre": "PRINCIPALES|COCHERA",
                "valor": "1",
                "idValor": null
            }
        ],
        "precios": [
            {
                "monto": 50008,
                "moneda": "ARS",
                "operacion": "ALQUILER"
            }
        ],
        "multimedia": {
            "imagenes": [
                {
                    "urlImagenOriginal": "https://s3.amazonaws.com/mapaprop-image/photos/1/188017/1883534.jpg",
                    "titulo": "imagen1"
                },
                {
                    "urlImagenOriginal": "https://s3.amazonaws.com/mapaprop-image/photos/1/188017/2718472.jpg",
                    "titulo": "imagen2"
                },
                {
                    "urlImagenOriginal": "https://s3.amazonaws.com/mapaprop-image/photos/1/188017/2718473.jpg",
                    "titulo": "imagen3"
                },
                {
                    "urlImagenOriginal": "https://s3.amazonaws.com/mapaprop-image/photos/1/188017/2719065.jpg",
                    "titulo": "imagen4"
                },
                {
                    "urlImagenOriginal": "https://s3.amazonaws.com/mapaprop-image/photos/1/188017/2719069.jpg",
                    "titulo": "imagen5"
                }
            ],
            "videos": null,
            "recorridos360": null,
            "planos": []
        },
        "localizacion": {
            "codigoPostal": "1885",
            "direccion": "Calle ficticia d",
            "idUbicacion": "V1-C-1003674",
            "latitud": "-34.61134195324214",
            "longitud": "-58.45366379921022",
            "muestraMapa": "EXACTO",
            "ubicacion": "Argentina, Capital Federal, Once"
        },
        "publicacion": {
            "tipoDePublicacion": "SIMPLE"
        },
        "publicador": {
            "codigoInmobiliaria": "3454",
            "emailAsesor": "info@mapaprop.com",
            "emailDeContacto": "info@mapaprop.com",
            "nombreDeContacto": "Mapaprop Demo INCsss",
            "telefonoDeContacto": "4581-8985"
        }
    }
}