Guia de erros comuns de replicação entre matriz e filial
Identifique sintoma, causa e solução para os problemas mais comuns que travam a replicação entre bases.
Este guia reúne os problemas mais frequentes que interrompem a replicação de dados entre matriz e filial (ou entre bases), organizados por sintoma e causa. Cada tópico abaixo traz o cenário, a causa confirmada e o passo a passo ou encaminhamento necessário para normalizar a replicação.
Replicação parada por registro já existente na base de destino
Este manual se aplica quando a replicação de dados entre matriz e filial (ou entre bases) para de processar porque um comando tenta inserir ou atualizar um registro (usuário, produto, título financeiro, conta contábil, item de PCP, entre outros) que já existe de forma idêntica na base de destino. O resultado esperado é a normalização da fila de replicação após a confirmação de que os dados já estão consistentes entre as bases.
Sintoma
A replicação para de processar novos comandos. Em alguns casos o cliente percebe um cadastro (usuário, cliente, produto) que não aparece replicado em uma unidade específica; em outros, um erro de duplicidade ou de chave é relatado ao suporte.
Causa confirmada
Um comando de inclusão (ou atualização) tenta gravar um registro que já existe, de forma idêntica, na base de destino. Isso ocorre normalmente quando o mesmo dado é cadastrado diretamente nas duas bases, quando há oscilação de comunicação que faz reenvio de comandos já processados, ou quando uma trigger de duplicidade barra o comando. Essa divergência bloqueia o processamento da fila, impedindo que os comandos seguintes sejam processados.
Passo a passo
Verificar se o cadastro realmente não está replicado
Confirme, na tela do cadastro afetado (usuário, cliente, produto, etc.), se o registro está de fato ausente ou divergente na unidade de destino, ou se apenas parece ausente por outro motivo (filtro, permissão de acesso).
Abrir chamado com os detalhes do cadastro afetado
Caso o registro esteja realmente ausente ou divergente, abra um chamado em: atak.movidesk.com informando qual cadastro (usuário, cliente, produto, título, conta contábil) não está sincronizado e em quais unidades/bases o problema ocorre.
Comparar os dados entre as bases envolvidas
O suporte compara o registro na base de origem e na base de destino para confirmar se as informações já estão consistentes e idênticas.
Liberar o comando bloqueado na fila de replicação
Com a consistência confirmada, o suporte trata (ignora) o comando específico que estava causando o bloqueio, permitindo que a fila de replicação volte a processar normalmente.
Acompanhar a normalização da fila
O suporte acompanha o processamento até que todos os comandos pendentes sejam concluídos e a replicação seja restabelecida.
⚠ Importante
O comando só deve ser ignorado após confirmação de que os dados já estão consistentes entre as bases. Ignorar um comando sem essa validação pode causar perda de sincronismo entre matriz e filial.
📌 Observações
- Em alguns casos, a divergência foi relacionada a itens de PCP (planejamento e controle da produção) que não foram gerados automaticamente em uma das filiais no momento do cadastro do item.
- Em um dos atendimentos, o mesmo tipo de problema (cadastro não replicado) foi resolvido bloqueando e desbloqueando novamente o cadastro do cliente na origem, ao invés de tratar o comando na fila — alternativa mais simples quando a replicação em si não apresenta erro (solução não validada pelo cliente).
- Em alguns atendimentos, a divergência estava em um único caractere de formatação entre os dados (por exemplo “0” em uma base e vazio na outra) — o princípio de verificação é o mesmo: comparar e confirmar consistência antes de liberar o comando.
- Parte dos atendimentos referentes a este padrão foi encerrada automaticamente pelo sistema sem confirmação explícita do cliente (solução não validada pelo cliente).
Replicação bloqueada por documento vinculado a lote da escrita fiscal
Este manual se aplica quando a replicação entre bases é interrompida porque um comando tenta alterar ou excluir informações de um documento que ainda está vinculado a um lote da escrita fiscal na base de destino. O sistema possui uma validação interna que impede essa alteração enquanto o vínculo existir, bloqueando o processamento da fila de replicação.
Sintoma
A replicação para de processar comandos. O sistema pode apresentar uma mensagem informando que a alteração do lançamento não é permitida porque o documento está na escrita fiscal.
Causa confirmada
A replicação executa os comandos em uma ordem específica: primeiro tenta remover informações do documento e, somente depois, excluir esse documento do lote da escrita fiscal. Quando o primeiro comando é executado no banco de destino, o documento ainda está vinculado ao lote, e uma validação interna do sistema bloqueia o processo.
Passo a passo
Relatar o erro ao suporte
Abra um chamado em: atak.movidesk.com informando que a replicação está parada e, se disponível, a mensagem de erro exibida pelo sistema.
Identificar o documento e o lote envolvidos
O suporte analisa a fila de replicação para localizar o documento vinculado ao lote da escrita fiscal que está causando o bloqueio.
Remover o vínculo do documento com o lote na base de destino
O suporte solicita ou realiza a remoção manual do documento do lote da escrita fiscal diretamente na base de destino.
Conferir a quantidade de documentos do lote em ambas as bases
Confira, com apoio do suporte, se a quantidade de documentos do lote está igual nas duas bases. Caso haja divergência, pode ser necessário excluir os documentos inconsistentes na base de origem e realizar o lançamento novamente.
Acompanhar a normalização da fila de replicação
Após a remoção do vínculo, a replicação volta a processar os comandos pendentes normalmente.
⚠ Importante
Quando a fila acumula um grande volume de comandos pendentes por causa desse bloqueio, o tempo de normalização completa pode ser significativamente maior.
📌 Observações
- O mesmo tipo de bloqueio pode ocorrer mais de uma vez durante o mesmo atendimento, se houver mais de um documento vinculado a lotes pendentes.
- Parte dos atendimentos referentes a este padrão foi encerrada automaticamente pelo sistema sem confirmação explícita do cliente (solução não validada pelo cliente).
Replicação bloqueada por divergência de estrutura de campo entre bases
Este manual se aplica quando a replicação entre matriz e filial falha porque um campo de uma tabela está configurado com um tipo de dado diferente entre as duas bases (por exemplo, texto em uma base e número em outra), impedindo que os dados sejam atualizados corretamente durante o processo.
Sintoma
A replicação para de processar comandos relacionados a uma tabela específica, sem que exista divergência de conteúdo — a causa está na estrutura da tabela, não no dado em si.
Causa confirmada
Um mesmo campo está configurado com tipos de dado diferentes entre a base de origem e a base de destino. Essa diferença impede que os dados sejam atualizados corretamente durante a replicação, travando a fila de comandos.
Passo a passo
Relatar o erro ao suporte
Abra um chamado em: atak.movidesk.com informando que a replicação está parada e, se possível, qual tabela ou processo estava sendo executado quando o erro apareceu.
Identificar a divergência estrutural entre as bases
O suporte compara a estrutura da tabela envolvida entre as bases para identificar o campo com tipo de dado divergente.
Liberar a fila de replicação temporariamente
Caso o ajuste do tipo do campo não possa ser feito de imediato (por exemplo, por haver vínculo de chave estrangeira com outra tabela), o suporte realiza uma ação controlada para liberar a fila, ignorando temporariamente os comandos com erro, e ajusta manualmente os registros que ficaram pendentes.
Corrigir e padronizar o campo divergente
O suporte corrige o campo, padronizando seu tipo e sua referência (vínculo com outras tabelas) para seguir o mesmo padrão utilizado nas demais bases/filiais.
Validar o ajuste com comparativo antes/depois
O suporte revisa e valida as alterações realizadas, comparando o estado da tabela antes e depois do ajuste.
⚠ Importante
Esse tipo de correção envolve alteração de estrutura de banco de dados e deve ser feito exclusivamente pelo suporte técnico, nunca pelo cliente.
Observações
Nenhuma observação adicional documentada nos tickets analisados.
Replicação bloqueada por trigger de cadastro tributário
Este manual se aplica quando a replicação entre bases para de funcionar devido a uma regra de validação (trigger) relacionada ao cadastro tributário de um cliente, impedindo o processamento normal da fila de comandos.
Sintoma
A replicação para de funcionar de forma recorrente, sem uma causa aparente relacionada a divergência de dados comuns (cadastro, produto, título).
Causa confirmada
Havia um problema em uma regra de validação (trigger) vinculada ao cadastro tributário, que bloqueava o processamento normal da fila de replicação.
O que fazer
Este problema requer ajuste técnico pelo suporte. Abra um chamado em: atak.movidesk.com informando que a replicação está parada e, se possível, que o problema já ocorreu anteriormente nos mesmos moldes, para ajudar na identificação mais rápida da causa:
- Nome do cadastro/cliente relacionado ao chamado
- Horário aproximado em que a replicação parou de funcionar
Observações
Este mesmo padrão de bloqueio (trigger de cadastro tributário) já se repetiu mais de uma vez para o mesmo cliente em curto espaço de tempo, sugerindo que a causa raiz pode não ter sido eliminada de forma definitiva na primeira correção. Recomenda-se, ao relatar o chamado, informar se o problema já ocorreu antes.
Replicação parada por assinatura de publicação inativa
Este manual se aplica quando o serviço de replicação para completamente de enviar dados entre matriz e filial porque a assinatura da publicação responsável por essa comunicação foi marcada como inativa.
Sintoma
A replicação de dados entre as bases para completamente, sem novos registros sendo sincronizados.
Causa confirmada
A assinatura da publicação responsável pela replicação estava marcada como inativa, interrompendo o envio de novos dados entre as bases.
O que fazer
Este problema requer ajuste técnico pelo suporte. Abra um chamado em: atak.movidesk.com informando que a replicação está parada, incluindo:
- Desde quando os dados pararam de ser sincronizados
- Quais tabelas ou processos aparentam estar desatualizados na unidade afetada
O suporte precisará excluir a assinatura inativa e recriar uma nova assinatura da publicação, além de sincronizar manualmente as tabelas que ficaram pendentes durante o período de inatividade.
📌 Observações
- Além de recriar a assinatura, é necessário sincronizar manualmente as tabelas que deixaram de ser replicadas durante o período de inatividade (exemplos observados: plano de contas, cadastro geral, cliente, endereço, produto e referência de produto).
- Após o ajuste, recomenda-se validar com o cliente se os dados aparecem corretamente em ambas as bases antes de encerrar o atendimento.
Replicação parada por falha temporária de comunicação entre servidores
Este manual se aplica quando a replicação apresenta erro ou fica temporariamente parada devido a uma interrupção momentânea na comunicação (rede) entre os servidores envolvidos, sem que haja um problema de dado ou de estrutura de banco por trás.
Sintoma
A replicação apresenta falha de comunicação (por exemplo, do tipo TCP) entre as duas pontas, ou os comandos passam a ser reenviados repetidamente, gerando acúmulo de comandos pendentes na fila.
Causa confirmada
Houve uma interrupção momentânea na comunicação entre os servidores das duas pontas da replicação. Esse tipo de instabilidade pode fazer com que uma publicação não receba a confirmação de entrega de um comando e tente reenviá-lo, gerando comandos duplicados na fila e um acúmulo significativo de pendências.
Passo a passo
Relatar a interrupção da replicação
Abra um chamado em: atak.movidesk.com informando que a replicação está parada ou apresentando erro.
Verificar o estado atual da replicação
O suporte verifica se a replicação já normalizou sozinha após a instabilidade de rede ou se ainda está bloqueada.
Analisar e tratar os comandos duplicados na fila, se houver
Caso existam comandos duplicados na fila em razão do reenvio, o suporte analisa e valida esses comandos manualmente antes de liberar o processamento.
Acompanhar o processamento até a normalização completa
O suporte acompanha a fila até que todos os comandos pendentes sejam processados, o que pode levar mais tempo quando o volume de comandos acumulados é grande.
⚠ Importante
Pequenas quedas de conexão pontuais são consideradas normais e geralmente não indicam um problema estrutural — o acompanhamento serve para confirmar que a replicação retomou sozinha ou identificar se há necessidade de intervenção adicional.
📌 Observações
- Em atendimentos com maior volume de comandos acumulados (dezenas de milhares de comandos pendentes), o tempo de estabilização total foi consideravelmente maior.
- Alguns chamados relacionados a esse padrão foram encerrados automaticamente pelo sistema sem confirmação explícita do cliente (solução não validada pelo cliente).
Replicação parada por serviços de replicação interrompidos
Este manual se aplica quando a replicação entre matriz e filial para completamente porque os serviços responsáveis por essa comunicação estavam parados no servidor da matriz.
Sintoma
A replicação está completamente interrompida, sem qualquer novo dado sendo sincronizado entre matriz e filial.
Causa confirmada
Os serviços responsáveis por manter os dados sincronizados entre matriz e filial estavam parados na matriz, interrompendo toda a comunicação de replicação.
O que fazer
Este problema requer ajuste técnico pelo suporte. Abra um chamado em: atak.movidesk.com informando que a replicação está completamente parada, incluindo:
- Desde quando a sincronização parou de ocorrer
- Se há alguma mensagem de erro visível relacionada ao processo de replicação
O suporte precisará reiniciar os serviços responsáveis pela comunicação de replicação na matriz.
Observações
Após a reinicialização dos serviços, é importante acompanhar o processo por um período para confirmar que a replicação foi retomada com sucesso e opera normalmente.
Cadastro de classificação tributária ausente destravando a replicação
Este manual se aplica quando a replicação da filial para a matriz para de funcionar porque um documento utiliza uma classificação tributária (por exemplo, relacionada a IBS/CBS) que existia no lançamento na filial, mas não estava cadastrada na tabela correspondente da matriz.
Sintoma
A replicação de movimentações da filial para a matriz para de processar, geralmente após o lançamento de um documento de entrada com uma classificação tributária específica.
Causa confirmada
A classificação tributária utilizada no lançamento existia no documento de origem, mas não estava cadastrada na tabela específica responsável por armazenar essas informações na base da matriz. Também foi identificado que, na base da filial, a tabela de itens de entrada não possuía o vínculo necessário com essa tabela de classificação, permitindo que a informação fosse gravada sem a validação correspondente.
O que fazer
Este problema requer ajuste técnico pelo suporte. Abra um chamado em: atak.movidesk.com informando que a replicação está parada após o lançamento de um documento fiscal, incluindo:
- Qual documento/lançamento foi feito antes da parada
- Qual classificação tributária foi utilizada no lançamento
O suporte precisará cadastrar a classificação tributária ausente diretamente na base da matriz para destravar a fila de replicação.
Observações
O cadastro da classificação tributária realizado pelo suporte tem como objetivo principal restabelecer o funcionamento da replicação. Esse cadastro deve ser revisado posteriormente pelo setor fiscal/contábil do cliente, para garantir que os dados tributários estejam corretos do ponto de vista fiscal, não apenas do ponto de vista técnico.
Replicação parada por fechamento de período contábil pendente
Este manual se aplica quando a replicação entre matriz e filial para de funcionar porque um fechamento de período contábil permaneceu registrado na base de destino, impedindo que a replicação concluísse corretamente o processamento dos comandos relacionados.
Sintoma
A replicação apresenta uma inconsistência vinculada a uma regra (trigger) de fechamento contábil, interrompendo o processamento normal da fila.
Causa confirmada
Um fechamento de período contábil permaneceu registrado na base, impedindo que a replicação concluísse corretamente o processamento dos comandos relacionados a esse período.
O que fazer
Este problema requer ajuste técnico pelo suporte. Abra um chamado em: atak.movidesk.com informando que a replicação está parada e, se souber, a qual período contábil o problema pode estar relacionado.
O suporte precisará remover o fechamento de período contábil pendente através da própria rotina de fechamento contábil do sistema, já que o ajuste direto pelo banco de dados pode ser bloqueado por regras internas vinculadas a esse fechamento.
Observações
Após a exclusão do período contábil pendente pela rotina de fechamento do sistema, os demais fechamentos foram sincronizados automaticamente pela própria replicação, sem necessidade de tratamento adicional.
Conteúdos relacionados
- → Dúvida: Replicação parada por registro já existente na base de destino
- → Dúvida: Replicação parada por falha temporária de comunicação entre servidores
- → Dúvida: Replicação bloqueada por documento vinculado a lote da escrita fiscal
- →Dúvida: Replicação parada por serviços de replicação interrompidos
⚠ Atenção — Aviso de Escopo
As causas e soluções acima são baseadas exclusivamente nos atendimentos analisados. Situações não listadas devem ser abertas como novo chamado em: atak.movidesk.com