--- title: "Cadastra imobiliária." method: POST path: "/v1/cadastros/imobiliarias" tags: ["Imobiliária"] --- # Cadastra imobiliária. `POST /v1/cadastros/imobiliarias` ## Request - Base URL: `https://integracao.cvcrm.com.br/api` - URL: `https://integracao.cvcrm.com.br/api/v1/cadastros/imobiliarias` - Auth: none declared. Required headers: `email`, `token` > 🔒 **Autenticação necessária** > > Esta API utiliza autenticação via **e-mail e token** nos headers da requisição. > Consulte o tutorial completo antes de fazer sua primeira chamada: > [Como autenticar nas APIs do CV CRM (v1 — E-mail e Token)](https://desenvolvedor.cvcrm.com.br/docs/como-autenticar-apis-cvcrm-email-token) Interface responsável por inserir novas imobiliárias dentro do Construtor de Vendas, quando o serviço for requisitado irá verificar se o dado inserido no campo idimobiliaria_int ou CNPJ existe ou não no Construtor de Vendas, se já existir uma imobiliária cadastrada com o mesmo idimobiliaria_int (código interno da imobiliária) ou com mesmo CNPJ a API irá atualizar os dados solicitados na requisição, senão irá cadastrá-los. **Obs: Para que essas informações sejam inseridas no Construtor de Vendas, o campo estado deve ser a sigla em letras maiúsculas e os campos de CNPJ devem ser válidos. O campo remover só deve ser informado caso a imobiliária precise ser excluída do CV, para esse processo acontecer o campo deve conter a informação do código interno da imobiliária.** ## Headers - `email` string, required - `token` string, required ## Request body - CadastrarImobiliaria: Imobiliária - `referencia` string: Código identificador da imobiliaria - `referencia_data` string: Data de referência - `ativo` string: Informa se está ativo ou não - `ativo_painel` string, required: Informa se está ativo no painel ou não - `idimobiliaria` integer: Código identificador da imobiliaria - `data_cad` string: Data de Cadastro da imobiliária - `idestado` integer: Identificação do estado da imobiliária - `idcidade` integer: Identificação da cidade da imobiliária - `nome` string, required: Nome da imobiliária - `razao_social` string, required: Razao Social da Imobiliára - `cnpj` string: CNPJ da imobiliária - `cnpj_faturamento` string: CNPJ da faturmanto da imobiliária - `idlogradouro` integer: Logradouro da imobiliária - `endereco` string: Endereço da imobiliária. - `complemento` string: Complemento do endereço da imobiliária - `numero` string: Número de endereço da imobiliária - `bairro` string: Bairro da imobiliária - `cep` string: CEP da imobiliária - `telefone` string: Telefone da imobiliária - `celular` string: Celular da imobiliária - `email` string: E-mail da imobiliária. - `creci` string, required: CRECI da imobiliária - `avatar_nome` string: Nome do arquivo avatar da imobiliária - `avatar_servidor` string: Nome do arquivo avatar da imobiliária no servidor - `avatar_tipo` string: Tipo de arquivo do avatar da imobiliária - `avatar_tamanho` integer: Tamanho do arquivo do avatar da imobiliária - `validade_creci` string, required: Data de validade do CRECI da imobiliária - `gerente_nome` string: Nome do gerente da imobiliária - `gerente_cpf` string: CPF do gerente da imobiliária - `gerente_telefone` string: Telefone do gerente da imobiliária - `gerente_celular` string: Celular do gerente da imobiliária - `gerente_email` string: E-mail do gerente da imobiliária - `sigla` string, required: Sigla da imobiliária - `codigointerno` string: Código interno da imobiliária - `observacoes` string: Observações da imobiliária - `micro_empresa` string, required: Informa se imobiliária é uma microempresa Sim (S) ou Não (N) - `inscricao_estadual` string: Inscrição estadual da imobiliária - `inscricao_municipal` string: Inscrição municipal da imobiliária - `tipo_conta` string: Tipo de conta da imobiliária: Conta Corrente (C) ou Poupança (P) - `idbanco` integer: Identificador do banco da imobiliária no CV - `nome_agencia` string: Nome da agência do banco da imobiliária - `numero_agencia` string: Número da agência da imobiliária - `digito_agencia` string: Dígito verificador da agência da imobiliária - `numero_conta` string: Número da conta de banco da imobiliária - `digito_conta` string: Dígito verificador da conta de banco da imobiliária - `nome_favorecido` string: Nome do favorecido da conta de banco da imobiliária - `cnpj_favorecido` string: CNPJ do favorecido da conta de banco da imobiliária - `alterar_login_corretor` string, required: Informa se a imobiliária pode interferir no login do corretor: Sim (S) ou Não (N) - `escala_plantao` string, required: Informa se a imobiliária pode administrar a escala de plantão: Sim (S) ou Não (N) - `idimobiliaria_nov` string: Campo idimobiliaria_nov da imobiliária - `bloqueado_recebimento_pagamento_comissao` string: Informa se a imobiliária está bloqueada (S) ou não (N) para receber pagamento de comissão - `autocadastro_corretor` string: Informa se exibe (S) ou não (N) a imobiliária no Cadastre-se do Painel Corretor. - `diretor_nome` string: Nome do diretor da imobiliária - `diretor_cpf` string: CPF do diretor da imobiliária - `diretor_telefone` string: Telefone do diretor da imobiliária - `diretor_celular` string: Celular do diretor da imobiliária - `diretor_email` string: E-mail do diretor da imobiliária - `data_modificacao` string: Data de modificação da imobiliária - `banco` string: Nome do banco. - `idimobiliaria_int` string: Identificador da imobiliária no sistema legado. - `logradouro` string: Logradouro do endereço da imobiliária. - `cidade` string: Cidade em que a imobiliária se localiza. - `estado` string: Estado em que a imobiliária se localiza. - `remover` string: Informar apenas se quiser remover a imobiliária informada do CV. ## Response `200` Operação realizada com sucesso. - CadastrarImobiliariaSucesso: Retorno da mensagem de sucesso ao cadastrar imobiliária - `codigo` string - `mensagem` string ## Other responses - `400`: Requisição Incorreta! --- [API](https://skmtc.dev/cvcrm/apis/clientes.md) - [All operations](https://skmtc.dev/cvcrm/apis/clientes/llms.txt) - [OpenAPI document](https://skmtc.dev/cvcrm/apis/clientes/revisions/42bf5add8bf3?raw)