Primeiros Passos: Integração com o Sienge

A integração entre o Mobuss Construção e o ERP Sienge permite que os locais, clientes e seus vínculos sejam importados no Mobuss.

O benefício principal da integração é a redução no trabalho de cadastros e manutenções dos locais, uma vez que o Mobuss realizará a carga diretamente do ERP e atualizará os contratos/distratos(vínculos entre cliente e local) diariamente.

Confira abaixo uma visão geral do fluxo de funcionamento da integração:

1. A obra será criada no em ambos os sistemas;
2. O usuário realizará o vínculo da obra no Mobuss, selecionando o empreendimento do Sienge na tela de manutenção da obra;
3. Caso já existam locais cadastrados no Mobuss, o usuário deverá entrar em contato com o time de CS para avaliar a possibilidade de realizar uma equalização dos dados. 
4. Se não existirem locais no Mobuss, o usuário aceitará a carga inicial, que importará locais, clientes e seus devidos vínculos para o Mobuss;
5. Diariamente, duas rotinas noturnas atualizarão os cadastros de clientes e seus vínculos com os locais, considerando novos contratos e distratos(cancelamento de contratos).

Pré-requisitos

• Possuir um usuário com perfil de Administrador no Sienge.
• Ter acesso ao módulo de Integrações do Sienge.
  

No MOBUSS

Para que a integração funcione, é essencial que os seguintes itens estejam em ordem:

• Contrato: Ter a integração Mobuss x Sienge devidamente contratada junto aos times de Contratos e Relacionamento (CS) do Mobuss Construção;
• Obra: Ter ao menos uma obra cadastrada no sistema;

Como Obter as Informações no Sienge

Para configurar a integração no Mobuss, você precisará de quatro informações fundamentais do seu ambiente Sienge. Veja abaixo como localizá-las:

1. Identificando a URL de Acesso

• O formato padrão é: https://api.sienge.com.br/nome-da-sua-empresa/public/api/v1 
• Dica: Substitua "nome-da-sua-empresa" pelo subdomínio que você já utiliza para acessar o Sienge no seu navegador. 

Caso necessário, veja a documentação completa do Sienge no material de apoio.

2. Criando o Usuário de Integração (API)

Não utilize seu usuário de acesso pessoal (e-mail). É necessário criar um usuário específico para que os sistemas se comuniquem: 

• No Sienge com um usuário com perfil de Administrador, acesse o menu Integrações. 
• Vá em APIs > Usuários de APIs. 
• Clique para criar um novo usuário (sugerimos o nome MOBUSS). 
• IMPORTANTE: Ao finalizar a criação, o Sienge exibirá uma Senha única. Copie e guarde esta senha em local seguro, pois ela não será exibida novamente. 

Caso necessário, veja a documentação completa do Sienge no artigo de apoio.

3. Liberando Permissões de Acesso

Após criar o usuário, você precisa autorizar quais informações o Mobuss pode ler: 

• Na tela de Usuários de API, localize o usuário criado e clique no ícone de lápis (Editar).
• No campo de busca de recursos, localize e marque as opções de consulta (GET) para os seguintes serviços: 
• Empreendimentos (Obras) - Tipo de Recurso: Transacional
• GET /enterprises 
• Unidades de Imóveis >> Unidades - Tipo de Recurso: Transacional
•  GET /units
• Clientes >> Clientes - Tipo de Recurso: Transacional
• GET /customers
• Contratos de Vendas >> Bulkdata de contratos de vendas - Tipo de Recurso: Massivo
• GET /sales
• Certifique-se de marcar as caixas de seleção correspondentes para liberar o acesso. 

Caso necessário, veja a documentação completa do Sienge no artigo de apoio.

4. Identificando o Código da Empresa (Company ID)

Este código é necessário para que o Mobuss saiba de qual empresa dentro do seu Sienge ele deve buscar os dados: 

• No Sienge, acesse o menu de cadastro de Empresas. 
• Realize uma consulta para listar as empresas cadastradas. 
• Localize a coluna Código. O número que aparece nesta coluna é o que deve ser inserido nas configurações do Mobuss. 

Configurando a Integração no Mobuss

Acesse o menu Administração >> Central de Integrações >> Aba: Catálogo >> Sienge >> Configurações.

Ao preencher os dados no Mobuss Construção, utilize as informações coletadas acima:

• URL: O endereço completo identificado no passo 1 da seção Como Obter as Informações no Sienge.
  
• Usuário: O nome do usuário de API criado (ex: integra-mobuss), considerando o passo 2 da seção Como Obter as Informações no Sienge.
  
• Senha: Aquela senha gerada automaticamente pelo Sienge que você salvou para o usuário criado.
  
• Código da Empresa: O número da coluna "Código" visto no passo 4 da seção Como Obter as Informações no Sienge.

• Rotinas Noturnas: Uma vez contratada a integração, nosso time de suporte fará a configuração de agendamentos noturnos para a atualização de clientes e seus vínculos com locais.

• Proporção de Vínculo: O vínculo ocorre na proporção de 1 para 1, ou seja, cada obra no Mobuss só pode ser conectada a um único empreendimento no Sienge.
  
• Configuração Manual: Após configurar a integração, cada obra deve ser vinculada manualmente através da tela de Informações Gerais da Obra.
  
• Atenção à Duplicidade: Se a obra no Mobuss já possuir locais cadastrados antes da primeira carga de dados, os itens poderão ficar duplicados. Nesses casos, é essencial realizar a equalização dos locais. Entre em contato com o time de CS para avaliar possibilidades.
  
• Hierarquia de Locais: A estrutura de unidades importada do Sienge não possui hierarquia nativa (todos os locais ficam no mesmo nível).
  
• Organização Pós-Carga: Pode ser necessário um ajuste manual para criar "Locais Pai" (como Blocos ou Pavimentos) e realocar as unidades importadas como "Filhos". Para locais já equalizados pelo suporte, essa organização manual é dispensada.
  
  

• Novos Locais: Os locais não são atualizados automaticamente na rotina noturna. Caso uma nova unidade seja criada no Sienge após a carga inicial, será necessário realizar uma nova carga no Mobuss.
  
• Procedimento para Nova Carga: Para atualizar a lista de locais, desvincule a obra e realize o vínculo novamente. Os locais já integrados não serão duplicados, e o novo local aparecerá na lista (sem hierarquia).
  
• Equalização Pontual: Se o novo local também foi criado manualmente no Mobuss, caso necessite de uma equalização, entre em contato com nosso time de CS para avaliação.

Sincronização de Status e Contratos

• Dados Inativados: O Mobuss não recebe informações de inativação vindas do Sienge. Se uma unidade, cliente ou contrato for inativado no ERP, a mesma ação deve ser repetida manualmente no Mobuss.
  
• Rotinas Noturnas: O sistema executa rotinas automáticas durante a noite para cadastrar e atualizar clientes e seus vínculos com locais.
  
  • Novos Contratos: O cliente é vinculado ao local automaticamente.
    
  • Distratos/Cancelamentos: O cliente é removido do vínculo com o local no Mobuss.
    
• Encerramento da Integração: Ao desvincular uma obra, as rotinas noturnas param de ser executadas para aquele projeto. Recomendamos que o desvínculo ocorra apenas na conclusão da obra.
  

Problemas Conhecidos

• Erro de Permissão (Permission Denied): Ocorre quando o usuário de API foi criado, mas os serviços específicos (como /units ou /sales) não foram marcados na tela de autorizações.