Inicio

API

1. Primeiros passos

3. Modelos de anúncios da API

4. Entrar em produção

5. Callbacks

6. Mostrar localização no mapa

8. Integração ReadOnly

9.Associar Imobiliárias

XML

1. Primeiros passos

2. Exemplos de XML por país

3. Estrutura para Anúncios

3.1 Campos obrigatórios

4. Estrutura para Lançamentos

4.1 Campos obrigatórios

5. Erros comuns XML

6. Como ler o XML do resultado?

7. Passar para produção

8. Callbacks

9. Mostrar localização no mapa

Médio

Antes de administrar os anúncios, é fundamental poder consultar a informação e os recursos das imobiliárias que você gerencia.


Listar imobiliárias habilitadas

Este endpoint permite que você obtenha uma lista de todas as imobiliárias (sucursais) que sua integração tem permissão para administrar. Daqui você obterá o codigoInmobiliaria necessário para as demais operações.

Endpoint:

GET /v1/inmobiliarias

Exemplo de Peticão (cURL)

curl --location --request GET '<https://api-br-sandbox-open.navent.com/v1/imobiliarias>' \\
--header 'Authorization: Bearer <TU_ACCESS_TOKEN>' \\
--header 'User-Agent: MiCRMInmobiliario/2.1 ([email protected])'

Resposta exitosa (200 OK)

A resposta incluirá sucursais

{
  "number": 0,
  "size": 2,
  "total": 8287,
  "content": [
    {
      "codigoInmobiliaria": "15512058",
      "idNavplat": 15512058,
      "nombre": "ANÉLIO IMÓVEIS",
      "habilitadoDesde": 1484753134000,
      "bloqueada": false,
      "emailsPorRol": {
        "Administrador": [
          "[email protected]"
        ]
      }
    },
    {
      "codigoInmobiliaria": "15513119",
      "idNavplat": 15513119,
      "nombre": "TUTOIA IMÓVEIS",
      "habilitadoDesde": 1484753134000,
      "bloqueada": false,
      "emailsPorRol": {
        "Administrador": [
          "[email protected]"
        ],
        "Superusuario": [
          "[email protected]"
        ]
      }
    }
  ]
}


Verificar os créditos disponíveis

Para evitar erros na publicação (ERR-0502), é altamente recomendado verificar com antecedência se a imobiliária possui créditos disponíveis para o plano de publicação desejado.

**GET /v1/inmobiliarias/{codigoInmobiliaria}/disponibilidad**

Exemplo de Peticão (cURL)

curl --location --request GET '<https://api-br-sandbox-open.navent.com/v1/inmobiliarias/><TU_CODIGO_INMOBILIARIA>/disponibilidad' \\
--header 'Authorization: Bearer <TU_ACCESS_TOKEN>' \\
--header 'User-Agent: MiCRMInmobiliario/2.1 ([email protected])'

Resposta exitosa (200 OK)

{
  "disponibles": [
    {
      "planDePublicacion": "DESTACADO",
      "cantidadDisponible": 0
    },
    {
      "planDePublicacion": "GRATIS",
      "cantidadDisponible": 20
    },
    {
      "planDePublicacion": "HOME",
      "cantidadDisponible": 0
    },
    {
      "planDePublicacion": "SIMPLE",
      "cantidadDisponible": 1
    }
  ],
  "vencimientos": [
    {
      "fecha": 26223800400000,
      "planDePublicacion": "DESTACADO",
      "cantidad": 4
    },
    {
      "fecha": 26223800400000,
      "planDePublicacion": "GRATIS",
      "cantidad": 20
    },
    {
      "fecha": 26223800400000,
      "planDePublicacion": "HOME",
      "cantidad": 1
    },
    {
      "fecha": 26223800400000,
      "planDePublicacion": "SIMPLE",
      "cantidad": 15
    }
  ]
}

image.png

Países

Argentina

Brasil

Resto de Latinoamérica

Documentación

API

XML