> ## Documentation Index
> Fetch the complete documentation index at: https://docs.morada.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Conectar o Mega
> O que o Morada OS consulta no Mega ERP, o que o administrador do Mega precisa liberar antes, como conectar e os cuidados de uso.
O Mega ERP, da Senior, é onde muitas incorporadoras controlam o financeiro e a carteira de recebíveis. Ao conectar o Mega, você pergunta em linguagem natural ("o que vence esta semana?", "como está a inadimplência deste contrato?") e o Morada OS consulta o Mega com o **seu** login e responde no chat.
O Morada OS **só lê** o Mega. Nenhuma consulta altera, baixa ou cria nada no sistema.
***
## O que dá para perguntar
O que vence num período, quanto ainda falta pagar a um fornecedor, separado por filial, fornecedor, tipo de documento ou dia de vencimento. Títulos em aberto ou já baixados. O total e o saldo em aberto vêm primeiro.
O saldo por conta, mês a mês, em uma ou mais filiais (até 10 por consulta).
Os empreendimentos, os contratos de cada um, as parcelas e o atraso de um contrato, as renegociações, os refinanciamentos, os distratos e as ocorrências registradas (baixas e reajustes).
Os contratos do cliente, o total devido e o próximo vencimento.
Exemplos para começar:
```text wrap theme={null}
O que vence no contas a pagar desta semana? Separe por fornecedor.
```
```text wrap theme={null}
Quanto ainda devemos ao fornecedor [nome do fornecedor]? Traga só os títulos em aberto.
```
```text wrap theme={null}
Como está a inadimplência dos contratos do empreendimento [nome]? Separe por faixa de atraso.
```
```text wrap theme={null}
Quais contratos o cliente de CPF [número] tem conosco, e quando é o próximo vencimento?
```
Quer resultados melhores? Leia [Como pedir bem](/morada-os/casos-de-uso/como-pedir-bem): três minutos de leitura que melhoram todos os seus pedidos.
***
## Antes de conectar: o que o administrador do Mega libera
No Mega, ter acesso à tela **não basta** para conectar. O administrador do Mega da sua empresa libera cada pessoa, uma a uma, e informa o código da empresa. São dois passos, feitos uma vez.
No Mega, o administrador abre **Configurações Globais → Segurança → Grupos e usuários**, escolhe o usuário da pessoa e marca a opção **Usuário de APIs**. Sem essa marcação, o Mega recusa a conexão, mesmo para quem usa o sistema todo dia.
O **Mega Registro** é o código da sua empresa no Mega, com 36 caracteres, no formato `3f2504e0-4f89-41d3-9a0c-0305e82c3301`. O administrador encontra o código em **Configurações Globais → Registrar Sistema** e passa para quem vai conectar. O código é o mesmo para todas as pessoas da empresa.
O login certo é o do **Mega ERP**, o sistema que a equipe usa no dia a dia. O login do **Portal de Clientes** do Mega (o site onde os compradores veem boletos e contratos) é outro e não serve para conectar.
Os dois passos, com as imagens da própria Senior, estão no [guia de APIs do Mega Cloud](https://suporte.senior.com.br/hc/pt-br/articles/35890009439252).
**Um login por pessoa, nunca um login compartilhado.** O Mega mantém uma só conexão ativa por login. Se duas pessoas conectam o mesmo login, a conexão de uma derruba a da outra, e o erro "a sessão do Mega expirou ou foi encerrada em outro acesso" aparece e some sem motivo aparente. O mesmo vale para um robô ou outra integração que já usa aquele login.
### O que cada pessoa enxerga
O Morada OS enxerga o que o **login da pessoa** enxerga no Mega, nunca mais. Se o login não tem acesso a um módulo (por exemplo, à contabilidade), a consulta daquele módulo é recusada e o Morada OS diz isso no chat. Quem amplia o acesso é o administrador do Mega, no cadastro do usuário.
O que a sua empresa contratou também conta: um módulo que a empresa não tem no Mega não aparece nas respostas.
***
## Como conectar
No menu lateral do Morada OS, clique em **Conectores**, procure **Mega** e clique em **Conectar**.
* **Mega Registro**: o código de 36 caracteres que o administrador passou.
* **Usuário**: o usuário com que você entra no Mega.
* **Senha**: a senha desse usuário.
Clique em **Conectar**. O Morada OS confere os dados com o Mega na hora.
O Mega passa para **Conectados por você**. Abra um chat e pergunte.
Na mesma página do conector, a lista **O que Morada OS pode ler** mostra as 10 consultas do Mega. Todas começam em **Sempre permitir**, porque nenhuma altera o Mega. Se preferir confirmar cada consulta no chat, troque a etiqueta para **Perguntar antes**.
***
## Cuidados de uso
O Mega não divide as respostas em páginas: ele devolve tudo de uma vez. Quando a consulta fica grande demais, o Morada OS pede um recorte menor, como um período mais curto, uma filial ou um empreendimento. Em listas muito longas, a resposta traz os totais e pede um filtro antes de listar item por item. Comece pelo recorte e a resposta vem mais rápido.
Um documento com dígitos que não batem é recusado antes de chegar ao Mega, porque o Mega responde a um documento inválido com contratos de outras pessoas. Confira o número e pergunte de novo.
O TREINAMENTO é a base de teste do Mega, então ele fica fora das listas e dos totais. Se você precisa dele, peça para incluir.
Os lançamentos contábeis costumam chegar depois dos financeiros. O Morada OS informa até quando cada filial tem lançamento, para você saber se o saldo está fechado.
Use o CPF e o CNPJ de clientes no chat só para localizar o contrato no Mega. Não copie esses dados para fora do Morada OS nem para conversas com quem não precisa deles.
***
## Limitações
* **Sem link para o Mega.** O Mega não oferece link para abrir um registro, então o Morada OS informa o número do contrato ou do título para você procurar no Mega.
* **Só leitura.** O Morada OS não baixa títulos, não renegocia e não altera cadastros no Mega.
* **Só o que está na lista.** O Morada OS consulta contas a pagar, saldos contábeis e a carteira de recebíveis. Outros módulos do Mega (como contas a receber fora da carteira, estoque ou folha) não estão no conector.
* **Lentidão do Mega.** Quando o Mega demora a responder, a consulta é interrompida e o Morada OS pede para tentar de novo em instantes. Quando o Mega limita o número de consultas, acontece o mesmo.
***
## Problemas comuns
1. Confira o usuário e a senha entrando no Mega pela tela de login.
2. Confira se o Mega Registro tem os 36 caracteres, com os hífens.
3. Confirme com o administrador do Mega se o seu usuário tem **Usuário de APIs** marcado.
Depois, em **Conectores → Mega**, conecte de novo com os dados atuais.
O seu login do Mega não tem acesso àquele módulo. Peça ao administrador do Mega para liberar o módulo no seu usuário.
Outra pessoa, robô ou integração conectou com o mesmo login. Cada pessoa precisa do próprio login do Mega. Veja o aviso em [Antes de conectar](#antes-de-conectar-o-que-o-administrador-do-mega-libera).
* **Central de atendimento**: [support.morada.ai](https://support.morada.ai)
* **E-mail**: `suporte@morada.ai`
* **Status da plataforma**: [status.morada.ai](https://status.morada.ai)
***
## Como desconectar
Em **Conectores**, abra o **Mega** e clique em **Desvincular**. O Morada OS apaga o usuário e a senha guardados e deixa de consultar o Mega na hora.
Para cortar o acesso também do lado do Mega, o administrador desmarca **Usuário de APIs** no cadastro da pessoa.
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.