Sincronização
Sincronizar é copiar os registros da origem para as entidades. O portal lê sempre essa cópia — por isso ele abre rápido e continua funcionando mesmo quando a sua API ou o seu banco estão fora do ar. O lado ruim: o portal mostra os dados da última sincronização. A agenda define o quanto eles podem ficar defasados.
Agendar
Na página do conector, clique em Agendar e escolha a Frequência:
| Frequência | Exemplo |
|---|---|
| Sob demanda | Só quando alguém pede |
| A cada N minutos | A cada 15 minutos (mínimo de 5) |
| A cada N horas | A cada 2 horas, no minuto 0 |
| A cada N dias | Todo dia às 06:00 |
| Dias úteis | De segunda a sexta às 07:00 |
| Semanal | Toda segunda às 06:00 |
| Mensal | Todo dia 1 às 06:00 |
| Cron personalizado | Uma expressão cron (minuto hora dia mês dia-da-semana) |
Escolha também o Timezone em que os horários valem (o padrão é America/Sao_Paulo). O agendamento aparece na lista de conectores e no resumo do conector — no ERP Aurora Energia, A cada 2 horas (minuto 0).
A agenda é do conector: cada execução sincroniza as entidades dele que estão no modo Agendada. Entidades Manuais e as que sincronizam quando o usuário acessa ficam de fora (veja Sincronização das entidades).
Um conector desativado não sincroniza, mesmo com agenda.
Sincronizar agora
Na página do conector (ou no menu … da lista), há duas ações:
| Ação | O que faz |
|---|---|
| Sincronizar | Busca o que mudou desde a última sincronização e atualiza as entidades que leem do conector |
| Sincronização completa | Lê tudo de novo e remove das entidades os registros que a origem não tem mais. Pode demorar e consumir a cota da API de origem |
As duas pedem confirmação e entram numa fila: os registros aparecem quando a sincronização termina. Elas incluem as entidades Manuais do conector.
Incremental ou completa
Sempre que dá, a sincronização é incremental: lê só o que mudou desde a última vez. Isso acontece quando a origem permite filtrar por "alterado desde" — um endpoint com filtro incremental (a coluna Incremental da aba Endpoints) ou uma tabela com coluna de data de alteração.
A sincronização é completa — lê tudo — quando:
- é a primeira vez;
- a origem não tem filtro incremental (as tools MCP e as consultas SQL, por exemplo);
- a última completa tem mais de um dia — assim os registros apagados na origem também saem do portal;
- você pede Sincronização completa.
Só a completa remove registros. Registros que não mudaram não são regravados.
Cada execução lê no máximo 50.000 registros por entidade. Se a origem tiver mais, a leitura para no limite e a remoção dos registros que sumiram da origem não roda naquela vez — a entidade avisa.
Acompanhar as execuções
- Na entidade: a Visão geral mostra a situação da sincronização, a última sync, a última completa e o resultado da última execução — quantos registros foram lidos, novos, alterados, sem mudança e removidos. Se ela falhou, o erro aparece ali. Veja Sincronização das entidades.
- No conector: a aba Logs lista cada chamada feita à origem, com método, endpoint, status HTTP e duração. Filtre por Método e Resultado (sucesso ou erro) ou busque pelo endpoint. Clique numa chamada para ver os parâmetros, os cabeçalhos e o corpo da requisição e da resposta — e copie tudo para mandar ao time do sistema de origem.
Quando dá erro
Uma sincronização com erro não apaga nada: o portal continua mostrando os registros da última sincronização que deu certo. Para descobrir a causa:
- Abra a entidade com erro e leia a mensagem na Visão geral.
- Abra os Logs do conector e procure as chamadas com erro: o status e a resposta da origem costumam dizer o que houve (credencial vencida, tempo esgotado, parâmetro inválido).
- Corrija a causa — por exemplo, em Editar — e clique em Sincronizar.
Se desconfiar da conexão (credenciais, rede), clique em Testar conexão no conector: se o teste falhar, o conector fica Com erro, com o Último erro na Visão geral.