Sistema - WebService - Acesso Usuário
Primeiro passo para integrar outros sistemas com o Imobiliar via API
"Meu fornecedor de site quer usar as APIs do Imobiliar, o que devo fazer?"
"Quero dar acesso a um fornecedor para desenvolver uma integração com o Imobiliar via webserfice, o que devo configurar?"
Os WebServices do Imobiliar utilizam o mesmo mecanismo de autenticação padrão do sistema.
Dessa forma, para se autenticar no WebService, deve-se utilizar um usuário cadastrado e ativo com as permissões de login pelo WebService e das operações que ele poderá executar.
1 - Criação de um novo usuário
Menu Configurações -> Usuários
Importante combinar com o fornecedor um nome de identificação e uma senha.
2. Conceder a permissão de login de acesso pelos webservices.
Menu -> Usuários -> Acessos do Usuário
A opção de acesso remoto é necessário quando o acesso ao webservice é externo a rede interna da empresa.
3. Adicionalmente, para cada endpoint (chamada de webservice) que for utilizado, será necessário conceder a permissão específica para este usuário.
Exemplo: Para ALTERAR os dados de pessoas através do endpoint CADASTRO_PESSOA_ALTERAR deve-se liberar o acesso Geral -> Cadastros -> Pessoas -> ALTERAÇÃO para o usuário do WebService também.
No Manual dos webservices tem a imagem do caminho na árvore de acesso que deverá ser concedido para cada chamada.
Outro exemplo: Pesquisa de Filiais
4. Configuração de limite de sessões.
Caso seja necessário limitar ou aumentar o número de sessões simultâneas de um determinado usuário pode-se configurar o campo Limite de sessões simultâneas com o valor desejado na tela de Permissões de Acessos do mesmo. Por padrão o sistema já vem configurado com um valor padrão (campo sem conteúdo) que é bem atendido pela maioria dos clientes.
Campo para cadastro do número de sessões simultâneas
OBS: Esta configuração é válida apenas para as sessões abertas via WebService e não para as sessões abertas com o cliente do Imobiliar nas estações de trabalho.
Importante: Todos os passos acima devem ser realizado por um usuário da imobiliária com poderes administrativos!
Revisado em 05/09/2025 CS
Revisado em 16/10/2025 RP