Categoria de Imóveis

Para importação da categoria de Imóveis, é necessário informar a category e subcategory que será utilizada para que o anúncio esteja disponível na categoria correta. As subcategorias existentes são as seguintes:

Category	Subcategory
Imóveis	Apartamentos
Imóveis	Casas
Imóveis	Terrenos, sítios e fazendas

No momento a API do Eu Preciso apenas aceita as subcategorias “Casas”, “Apartamentos” e “Terrenos, sítios e fazendas”.

Parâmetros específicos por subcategoria

Cada subcategoria de Imóveis tem seu conjunto de parâmetros e valores específicos. Para isso, você deverá considerar os parâmetros específicos para cada subcategoria, bem como os parâmetros gerais para quaisquer anúncios no Eu Preciso.

Aqui está um exemplo de JSON para inserção ou edição de anúncios na subcategoria Apartamentos:

{
  "ad_list": [
    {
      "id": "111111111111",
      "action": "insert",
      "category": "Imóveis",
      "subcategory": "Apartamentos",
      "title": "Apartamento Novo",
      "body": "Descrição do anúncio\nNova linha da descrição\nAinda outra linha da descrição",
      "phoneNumber": 4799999999,
      "operation": "venda",
      "price": 950000,
      "zipcode": "89999999",
      "params": {
        "rooms": "3",
        "bathrooms": "2",
        "garage_spaces": "2",
        "size": 150,
        "iptu": 1000,
        "condominio": 500,
        "apartment_type": "3",
        "apartment_features": ["1", "2"],
        "apartment_complex_features": ["1", "2"],
        "launch": true,
        "launch_modality": "1"
      },
      "images": ["http://www.a.com/image1.png", "http://www.a.com/image2.png"]
    },
    {
      "id": "222222222222",
      "action": "insert",
      "category": "Imóveis",
      "subcategory": "Apartamentos",
      "title": "Apartamento Novo",
      "body": "Descrição do anúncio\nNova linha da descrição\nAinda outra linha da descrição",
      "phoneNumber": 4799999999,
      "operation": "venda",
      "price": 950000,
      "zipcode": "89999999",
      "params": {
        "rooms": "2",
        "bathrooms": "1",
        "garage_spaces": "0",
        "size": 90,
        "iptu": 200,
        "condominio": 300,
        "apartment_type": "2",
        "apartment_features": ["1", "2"],
        "apartment_complex_features": ["1", "2"],
        "launch": false,
        "complex_name": "Nome do Condomínio aprovavado pela API Eu Preciso",
        "complex_images": [
          "https://www.complex_images.com/image1.png",
          "https://www.complex_images.com/image2.png"
        ]
      },
      "images": ["http://www.a.com/image1.png", "http://www.a.com/image2.png"]
    }
  ]
}

Apartamentos

Parâmetro	Valor	Tipo	Obrigatório	Descrição
`rooms`	0 para 0 quartos 1 para 1 quarto 2 para 2 quartos 3 para 3 quartos 4 para 4 quartos 5 para 5 ou mais quartos	string	Sim	Quantidade de quartos
`bathrooms`	0 para 0 banheiro 1 para 1 banheiro 2 para 2 banheiros 3 para 3 banheiros 4 para 4 banheiros 5 para 5 ou mais banheiros	string	Não¹	Quantidade de banheiros
`garage_spaces`	0 para 0 vagas 1 para 1 vaga 2 para 2 vagas 3 para 3 vagas 4 para 4 vagas 5 para 5 ou mais vagas	string	Não¹	Quantidade de vagas de garagem
`size`		integer	Não¹	Área do apartamento (m²). Não aceita frações
`apartment_type`	1 para Padrão 2 para Cobertura 3 para Duplex/triplex 4 para Kitnet 5 para Loft 6 para Multipropriedade	string	Sim	Tipo de apartamento
`apartment_features`	1 para Ar condicionado 2 para Área de Serviço 3 para Armários na Cozinha 4 para Armários no Quarto 5 para Banheira/spa/jacuzzi 6 para Mobiliado 7 para Piscina privativa 8 para Quarto de serviço 9 para Varanda	array de strings	Não¹	Detalhes do imóvel
`apartment_complex_features`	1 para Academia 2 para Banheira/Spa/Jacuzzi 3 para Campo de golf 4 para Condomínio fechado 5 para Coworking 6 para Elevador 7 para Energia fotovoltaica 8 para Permitido animais 9 para Piscina 10 para Portão eletrônico 11 para Portaria 12 para Quadra de tênis 13 para Quadra poliesportiva 14 para Reaproveitamento de água da chuva 15 para Salão de beleza 16 para Salão de festas 17 para Sala de Massagem 18 para Sauna 19 para Segurança 24h	array de strings	Não¹	Detalhes do condomínio
`iptu`		integer	Não¹	Valor mensal do IPTU
`condominio`		integer	Não¹	Valor mensal do condomínio
`complex_name`		String	Não	Nome do condomínio. Para verificar os nomes disponíveis use o serviço do Eu Preciso, conforme descrito nesta documentação.
`complex_images`		Array de strings	Não	Fotos do condomínio².
`launch`		Boolean	Não	Para imóveis em fase de lançamento.
`launch_modality`	1 para Pronto para morar ou construir 2 para na Planta	String	Depende	A modalidade de lançamento será obrigatória quando o parâmetro launch for true.
`exchange`	1 para Sim 2 para Não	string	Depende	Aceita trocas pelo produto. Obrigatório quando a operação for “venda”.

Notas

1. Se você não quer enviar um parâmetro não-obrigatório, deixe de enviar o parâmetro no payload. Se você enviar o parâmetro com valor vazio ou 0, a operação vai falhar (a menos, é claro, que o valor 0 seja esperado para esse parâmetro).
2. Na categoria de imóveis, as fotos do condomínio devem ser enviadas este campo próprio, caso exista o condomínio na listagem da API Eu Preciso, sob pena de envio do anúncio para correção.

Casas

Parâmetro	Valor	Tipo	Obrigatório	Descrição
`rooms`	0 para 0 quartos 1 para 1 quarto 2 para 2 quartos 3 para 3 quartos 4 para 4 quartos 5 para 5 ou mais quartos	string	Sim	Quantidade de quartos
`bathrooms`	1 para 1 banheiro 2 para 2 banheiros 3 para 3 banheiros 4 para 4 banheiros 5 para 5 ou mais banheiros	string	Não¹	Quantidade de banheiros
`garage_spaces`	0 para 0 vagas 1 para 1 vaga 2 para 2 vagas 3 para 3 vagas 4 para 4 vagas 5 para 5 ou mais vagas	string	Não¹	Quantidade de vagas de garagem
`size`		integer	Não¹	Área da casa (m²). Não aceita frações
`home_type`	1 para Padrão 2 para Casa de vila 3 para Casa de condomínio	string	Sim	Tipo de casa
`home_features`	1 para Ar condicionado 2 para Área de Serviço 3 para Armários na Cozinha 4 para Armários no Quarto 5 para Banheira/spa/jacuzzi 6 para Mobiliado 7 para Piscina privativa 8 para Quarto de serviço 9 para Varanda	array de strings	Não¹	Detalhes do imóvel
`home_complex_features`	1 para Academia 2 para Banheira/Spa/Jacuzzi 3 para Campo de golf 4 para Condomínio fechado 5 para Coworking 6 para Elevador 7 para Energia fotovoltaica 8 para Permitido animais 9 para Piscina 10 para Portão eletrônico 11 para Portaria 12 para Quadra de tênis 13 para Quadra poliesportiva 14 para Reaproveitamento de água da chuva 15 para Salão de beleza 16 para Salão de festas 17 para Sala de Massagem 18 para Sauna 19 para Segurança 24h	array de strings	Não¹	Detalhes do condomínio
`iptu`		integer	Não¹	Valor mensal do IPTU
`condominio`		integer	Não¹	Valor mensal do condomínio
`complex_name`		String	Não	Nome do condomínio. Para verificar os nomes disponíveis use o serviço do Eu Preciso, conforme descrito nesta documentação.
`complex_images`		Array de strings	Não	Fotos do condomínio².
`launch`		Boolean	Não	Para imóveis em fase de lançamento.
`launch_modality`	1 para Pronto para morar ou construir 2 para na Planta	String	Depende	A modalidade de lançamento será obrigatória quando o parâmetro launch for true.
`exchange`	1 para Sim 2 para Não	string	Depende	Aceita trocas pelo produto. Obrigatório quando a operação for “venda”.

Notas

1. Se você não quer enviar um parâmetro não-obrigatório, deixe de enviar o parâmetro no payload. Se você enviar o parâmetro com valor vazio ou 0, a operação vai falhar (a menos, é claro, que o valor 0 seja esperado para esse parâmetro).
2. Na categoria de imóveis, as fotos do condomínio devem ser enviadas este campo próprio, caso exista o condomínio na listagem da API Eu Preciso, sob pena de envio do anúncio para correção.

Terrenos, sítios e fazendas

Parâmetro	Valor	Tipo	Obrigatório	Descrição
`size`		integer	Não¹	Área do terreno (m²). Não aceita frações
`land_type`	1 para Terrenos e lotes 2 para Sítios e chácaras 3 para Fazendas 4 para outros	string	Sim	Tipo de terreno
`land_features`	1 para Acesso asfaltado 2 para Água encanada 3 para Área verde 4 para Campo de futebol 5 para Casa sede 6 para Churrasqueira 7 para Energia elétrica 8 para Piscina 9 para Poço artesiano 10 para Pomar	array de strings	Não¹	Detalhes do imóvel
`land_complex_features`	1 para Academia 2 para Banheira/Spa/Jacuzzi 3 para Campo de golf 4 para Condomínio fechado 5 para Coworking 6 para Elevador 7 para Energia fotovoltaica 8 para Permitido animais 9 para Piscina 10 para Portão eletrônico 11 para Portaria 12 para Quadra de tênis 13 para Quadra poliesportiva 14 para Reaproveitamento de água da chuva 15 para Salão de beleza 16 para Salão de festas 17 para Sala de Massagem 18 para Sauna 19 para Segurança 24h	array de strings	Não¹	Detalhes do condomínio
`iptu`		integer	Não¹	Valor mensal do IPTU
`condominio`		integer	Não¹	Valor mensal do condomínio
`complex_name`		String	Não	Nome do condomínio. Para verificar os nomes disponíveis use o serviço do Eu Preciso, conforme descrito nesta documentação.
`complex_images`		Array de strings	Não	Fotos do condomínio².
`launch`		Boolean	Não	Para imóveis em fase de lançamento.
`launch_modality`	1 para Pronto para morar ou construir 2 para na Planta	String	Depende	A modalidade de lançamento será obrigatória quando o parâmetro launch for true.
`exchange`	1 para Sim 2 para Não	string	Depende	Aceita trocas pelo produto. Obrigatório quando a operação for “venda”.

Notas

1. Se você não quer enviar um parâmetro não-obrigatório, deixe de enviar o parâmetro no payload. Se você enviar o parâmetro com valor vazio ou 0, a operação vai falhar (a menos, é claro, que o valor 0 seja esperado para esse parâmetro).
2. Na categoria de imóveis, as fotos do condomínio devem ser enviadas este campo próprio, caso exista o condomínio na listagem da API Eu Preciso, sob pena de envio do anúncio para correção.

Exemplo de resposta:

{
  "status": "ok",
  "data": [
    {
      "nome": "VISION RESIDENCE",
      "cnpj": "46757764000127",
      "cep": "89221008",
      "logradouro": "Rua Dona Francisca",
      "numero": "2818",
      "bairro": "Saguaçu",
      "municipio": "Joinville",
      "state": "Santa Catarina"
    },
    {
      "nome": "MATISSE RESIDENCE HOME CLUB",
      "cnpj": "21439848000191",
      "cep": "89221008",
      "logradouro": "Rua Dona Francisca",
      "numero": "2666",
      "bairro": "Saguaçu",
      "municipio": "Joinville",
      "state": "Santa Catarina"
    }
  ]
}

Listagem de Condomínios no Eu Preciso

Os endpoints disponíveis para consultar nomes de Condomínios no Eu Preciso são os seguintes:

Descrição	Endpoint	Parâmetros
Nomes de condomínio disponíveis por cep	https://apps.eupreciso.com.br/v1.0/integradores/autoupload/info/complex_info/cep/${CEP}	-
Nomes de condomínio disponíveis por CNPJ	https://apps.eupreciso.com.br/v1.0/integradores/autoupload/info/complex_info/cnpj/${CNPJ}	-
Nomes de condomínio disponíveis por Nome	https://apps.eupreciso.com.br/v1.0/integradores/autoupload/info/complex_info/nome/${PARTE DO NOME}	cidade, bairro

Nosso servidor deve receber a requisição com método do tipo POST, sendo que o formato do arquivo a ser enviado para nosso servidor deverá ser do tipo JSON.

Exemplo de consulta por CEP:

https://apps.eupreciso.com.br/v1.0/integradores/autoupload/info/complex_info/cep/89221008

https://apps.eupreciso.com.br/v1.0/integradores/autoupload/info/complex_info/cep/89221-008

Exemplo de consulta por nome:

https://apps.eupreciso.com.br/v1.0/integradores/autoupload/info/complex_info/nome/Ouro?cidade=São+Paulo&bairro=Jardim+Paulista

O access_token deve ser fornecido no headers da requisição.
O nome a ser preenchido no campo params.complex_name é o nome, primeiro campo da resposta.

Exemplo de resposta:

{
  "status": "ok",
  "data": {
    "nome": "NOME_COMPLETO"
  }
}

Inserção de Condomínios no Eu Preciso

O endpoint disponível para inserir um condomínio não localizado na base de dados do Eu Preciso é:

Descrição	Endpoint	Parâmetros
Nomes de condomínio disponíveis por cep	https://apps.eupreciso.com.br/v1.0/integradores/autoupload/info/complex_info/insert	-

Nosso servidor deve receber a requisição com método do tipo POST, sendo que o formato do arquivo a ser enviado para nosso servidor deverá ser do tipo JSON. A requisição deve receber como parâmetro somente o cnpj do condomínio.

Exemplo de inserção de condomínio:

https://apps.eupreciso.com.br/v1.0/integradores/autoupload/info/complex_info/insert?cnpj=46757764000127

A inserção de condomínios pode resultar em erros de servidor (status 400, reason: “SERVER_ERROR_CEP”), em razão do CEP inválido cadastrado para o condomínio nas bases oficiais. Em caso de repetidos erros de servidor para a inserção de um mesmo condomínio, contate nosso suporte para inserção interna.

Também é possível que o erro retornado seja referente à impossibilidade de definição de zona e região para o condomínio. Nesse caso o servidor retornará uma mensagem: “Verifique com o suporte a inserção da zona e região para os seguintes dados. Bairro: nome do Bairro, Cidade: cidade/uf.

Outros erros possíveis podem estar relacionados ao CNAE não referente a condomínio, CNPJ inativo ou empresa estrangeira.

Categoria de Autos e Peças Requisição de Status