Integração entre CRM Superlógica Imobi e ERP Superlógica

Visão geral

A integração entre o CRM Superlógica Imobi e o ERP Superlógica permite que os contratos de locação fechados no CRM sejam enviados ao ERP, evitando a necessidade de cadastrar as mesmas informações manualmente nos dois sistemas.

Para estabelecer a conexão, é necessário gerar e trocar dois códigos entre as plataformas: o App token, gerado no CRM, e o Access token, gerado no ERP.

Quando usar este artigo

Utilize este artigo quando precisar configurar a integração entre o CRM Superlógica Imobi e o ERP ou quando a comunicação entre os sistemas apresentar falhas.

Sintoma ou cenário

Os contratos de locação fechados no CRM precisam ser cadastrados manualmente no ERP.
A integração entre os sistemas ainda não foi configurada.
A integração foi configurada, mas os contratos não estão sendo enviados ao ERP.

Benefício para o usuário ou operação

A integração automatiza o envio dos contratos de locação do CRM para o ERP, reduzindo a digitação manual, o retrabalho e a possibilidade de erros no cadastro das informações.

Onde acessar / contexto de uso

ERP: menu do usuário > Todos os usuários > bloco API (Integração com outros sistemas).
CRM Superlógica Imobi: menu Integrações.

Pré-requisitos (Antes de começar)

No ERP, o usuário responsável pela configuração deve possuir a permissão Usuários - Alteração e consulta.
No CRM, é necessário ter acesso à área de Integrações.
Mantenha os dois sistemas abertos durante a configuração para copiar e inserir os códigos.

Causas prováveis

Quando a integração não estabelece conexão ou deixa de enviar contratos, as causas podem estar relacionadas a:

App token copiado incorretamente, com espaços ou caracteres adicionais.
Usuário do ERP sem a permissão Usuários - Alteração e consulta.
Aplicativo removido da lista Aplicativos liberados no ERP.
Access token desatualizado ou informado incorretamente no CRM.

Como fazer ou corrigir

Parte 1: Gerando o App Token no CRM

Acesse sua conta no CRM.
No menu superior, navegue até Preferências> Integrações.
No canto superior direito, clique em Novo Registro.
No campo Integração, selecione a opção Superlógica - Locação.
O sistema exibirá o campo App Token. Copie este código e mantenha a aba aberta.

Parte 2: Liberando o acesso no ERP

Acesse o ERP Superlógica.
No canto superior direito, clique no seu nome de usuário e selecione Todos os usuários.
Role a página até o final e, na seção APP Integração com outros sistemas, clique em Aplicativos liberados.
Clique no botão Liberar aplicativo e escolha a opção Outro Aplicativo.
Cole o App Token (copiado do passo 5 em Gerando o App Token no CRM) e clique em Liberar.
A tela será atualizada exibindo o aplicativo AppArbo. Clique em Ver Access Token e copie este novo código.

Parte 3: Concluindo no CRM

Retorne à aba da tela de integração no CRM.
Localize o campo destinado ao Access Token e cole o código obtido no ERP.
Clique em Salvar.

Resultado esperado

A integração fica configurada e os contratos de locação fechados no CRM passam a ser enviados ao ERP, ficando disponíveis no menu Contratos.

Quando escalar

Solicite análise quando:

O ERP apresentar a mensagem Aplicativo não encontrado mesmo após conferir o App token.
A integração estiver salva nos dois sistemas, mas os contratos não forem enviados ao ERP.
A configuração estiver correta e o envio continuar apresentando falhas.

Informações para escalonamento

Ao solicitar análise, informe:

Licença do ERP.
Usuário que liberou o aplicativo.
Captura de tela da lista Aplicativos liberados.
Data e horário do envio realizado pelo CRM.
Identificação do contrato que não chegou ao ERP.
Mensagens de erro apresentadas, se houver.

Importante: não envie o Access token completo. Esse código deve ser tratado como uma senha.

Regras importantes / Observações

A integração realiza o envio de contratos de locação. Vendas e outros cadastros não são enviados por esse processo.
O CRM acessa o ERP utilizando as permissões do usuário que liberou o aplicativo.
Para ajustar as permissões utilizadas pela integração, acesse Aplicativos liberados e clique em Editar usuário na linha do aplicativo.
O App token e o Access token são credenciais de acesso e devem ser mantidos em segurança.

Problemas comuns e como resolver

Problema: A mensagem "Aplicativo não encontrado" aparece ao tentar liberar o aplicativo no ERP.
Causa provável: O App token foi copiado incorretamente ou está incompleto.
Ação recomendada: Gere ou copie novamente o App token no CRM e cole no ERP, verificando se não há espaços ou caracteres adicionais.

Problema: A mensagem "Acesso negado. (1010)" aparece no ERP.
Causa provável: O usuário não possui a permissão Usuários - Alteração e consulta.
Ação recomendada: Solicite a um administrador que ajuste as permissões do usuário responsável pela configuração.

Problema: A integração parou de enviar contratos.
Causa provável: O aplicativo pode ter sido removido da lista Aplicativos liberados no ERP.
Ação recomendada: Libere novamente o aplicativo no ERP e atualize o Access token correspondente no CRM.

Dúvidas relacionadas (FAQ)

P: A integração envia outros tipos de contrato ou cadastros?
R: Não. A integração realiza o envio de contratos de locação.

P: Como desativar a integração?
R: No ERP, acesse Aplicativos liberados, localize o aplicativo e clique em Deletar. Em seguida, confirme a remoção do acesso na mensagem apresentada.

P: Perdi o Access token. Preciso gerar outro?
R: Na lista Aplicativos liberados do ERP, localize o aplicativo e clique novamente em Ver Access Token.

P: Suspeito que os códigos de acesso foram expostos. O que devo fazer?
R: No ERP, acesse Aplicativos liberados e clique em Deletar na linha do aplicativo para retirar o acesso. Em seguida, acione o suporte para orientação.

Palavras-chave de busca

CRM Superlógica Imobi, integração CRM e ERP, integração de contratos, contrato de locação, App token, Access token, liberar aplicativo, Aplicativos liberados, integração Superlógica.