Acompanhamento do conector

A sincronização rodou? Bateu com a origem? O que não entrou, e por quê? Cada execução aparece com os números reais — lidos, criados, atualizados e pendências — inclusive quando falha. A conciliação mostra a contagem NA ORIGEM ao lado da contagem NO TENKA: se divergiu, fica vermelho, sem interpretação.

Quando um registro chega sem destino claro (tipo de operação sem classificação, empresa não confirmada, local de estoque sem depósito), ele NÃO entra torto: vira pendência com o motivo escrito. Resolva a causa na tela de configuração e clique em Reprocessar — o conector relê e o que estava pendente entra. Nada se perde, nada entra escondido.

Primeiro "Recarregar cadastros": os cadastros passam a ser lidos por inteiro na próxima sincronização (a carga histórica mês a mês NÃO é afetada — nenhum progresso se perde). Depois "Rodar agora", para os cadastros entrarem. Por último "Amarrar vínculos", que liga os documentos aos cadastros que chegaram. A ordem importa: amarrar antes de recarregar não encontra nada, porque o cadastro ainda não existe.

O clique em "Rodar agora" dispara a sincronização em segundo plano e acende o indicador "Sincronizando agora…" ao lado do título de Execuções. A lista se atualiza sozinha a cada poucos segundos enquanto a rodada corre, e o indicador some quando ela termina — o status final (OK, PARCIAL ou FALHA) fica na primeira linha da lista, com o detalhe por recurso.

Quando um título, nota ou pedido chega do ERP citando um cliente, fornecedor, natureza ou centro que ainda não foi importado, o documento ENTRA — com valor, data e vencimento preservados — e o vínculo que faltou fica registrado com o código do ERP. Nada é descartado e nada precisa ser digitado de novo. Enquanto houver vínculo pendente, o painel diz em vermelho que a carga NÃO está completa: os totais por cliente, fornecedor, natureza e centro estão parciais até a amarração acontecer.

Como o código do ERP fica guardado em cada vínculo pendente, amarrar é uma operação local — segundos, sem tocar a origem. É a diferença entre resolver 1.800 pendências num clique e reler 270 mil títulos no ERP por horas. Só o caso do título que NÃO entrou (natureza ausente antes desta versão) exige reimportar o mês.

Se a natureza do ERP ainda não existe, o título entra numa natureza técnica chamada "A CLASSIFICAR" — porque a alternativa seria recusar o título e perder o dado. Ela NÃO é uma categoria de negócio: é um marcador temporário. A natureza real fica guardada no vínculo pendente e substitui a técnica quando o cadastro chegar. Nenhum relatório deve ser lido como definitivo enquanto houver títulos nela.

O botão "Reprocessar" de uma pendência de documento (financeiro, notas, pedidos) tenta AMARRAR o vínculo — ele não apaga o progresso da carga mês a mês. Já o "Recarregar cadastros" zera apenas o cursor dos cadastros. As 92 janelas do histórico só são relidas se você pedir a reimportação de um mês explicitamente.

Quando um documento do ERP é barrado na importação, o sistema registra de qual mês ele era. O painel "Completude e conserto" lista esses meses, e o botão de reimportação relê apenas eles — em vez de reler daquele mês até hoje. Reler é seguro: registros existentes são atualizados pela chave do ERP e nunca duplicados. Atenção ao limite: documentos barrados em versões anteriores do sistema não deixaram esse registro de mês; para recuperá-los, use "Reimportar desde o mês", informando o mês mais antigo afetado.

O painel de completude tem dois tipos de mensagem, e eles pedem ações diferentes. As mensagens normais descrevem o ESTADO ("N vínculos esperando cadastros", "N deveriam ter amarrado") e a ação é sobre dados: recarregar cadastros, decidir sobre um de-para. A mensagem VERMELHA começando com "FALHA na amarração de…" é outra coisa: a passada daquele domínio explodiu e foi revertida — nada dele foi amarrado, e o texto traz o erro técnico exato. Nesse caso não adianta recarregar cadastro nem clicar de novo: copie o erro e envie ao suporte. É o motivo real de um "0 amarrados".

No painel "Ver quais faltam" da conciliação, o lado "sobram no Tenka" lista o que existe aqui e já não existe na origem. O que fazer com essas sobras é a política do conector: MANTER não toca em nada (padrão); INATIVAR tira da operação e preserva a história — é o recomendado; EXCLUIR apaga fisicamente, mas só o que nenhum documento referencia — registro citado por título ou nota é inativado em vez de excluído, e o relatório diz quantos ficaram presos. Use sempre o Ensaiar primeiro: ele mostra os números sem gravar nada. Documentos financeiros não entram nesta rotina; título conciliado é imutável por regra.

Em bases grandes a amarração estourava o tempo limite do banco e a passada inteira era revertida — a tela mostrava "0 amarrados" com um diagnóstico que falava dos cadastros, e a causa real ficava num log. Agora a falha aparece em vermelho com o erro exato, e a própria amarração foi reescrita para resolver cada vínculo uma vez só e trabalhar em lotes. Se ainda aparecer mensagem vermelha, copie o texto: ele nomeia o domínio e o erro.

Quando um documento entra citando um cadastro que ainda não existe no espelho, ele ENTRA assim mesmo — com o campo vazio e o código do ERP guardado ao lado. "Amarrar vínculos" faz três coisas, nesta ordem: grava o vínculo no documento, marca a amarra como resolvida e, por último, encerra a pendência que aparece na lista. Os dois primeiros passos são a carga; o terceiro é só o carimbo.

Se a mensagem disser que os vínculos foram amarrados e SALVOS mas o encerramento das pendências não coube na passada, o trabalho está feito. O que ficou para trás é o carimbo: as linhas seguem aparecendo como abertas até a próxima rodada, e nenhum número mudou por causa disso. É diferente da mensagem vermelha, que diz que a passada foi revertida — essa sim significa que nada daquele domínio foi amarrado.

Recarregar cadastros traz o de-para atual do ERP. Rodar agora processa o pendente contra esse de-para. Reimportar o mês só quando a regra de um mês fechado mudou. Reimportar ANTES de recarregar reprocessa o mês contra o de-para VELHO — e o resultado parece certo, porque não dá erro nenhum.

A cada rodada, a carga confere as pendências abertas contra o espelho: aviso de "título não entrou" cujo título JÁ ESTÁ na plataforma (entrou por rodada posterior ou por releitura) é fechado automaticamente, com o carimbo dizendo quem fechou e por quê. O que sobra na fila é só o que pede decisão humana — vencimento digitado errado, e-mail inválido, cadastro para conferir no ERP.

No Tenka o e-mail do contato é a identidade de acesso ao portal, e por isso não pode se repetir. Quando a origem manda o mesmo e-mail para duas pessoas diferentes — o sócio de duas empresas, o contador de várias, o endereço genérico da recepção — o segundo contato entra com nome, telefone e cargo, mas sem o e-mail, e uma pendência avisa. Nada é perdido: o telefone, que é o dado pelo qual alguém liga, continua lá. Para esse contato poder acessar o portal, dê a ele um e-mail próprio no ERP de origem e sincronize; a pendência fecha na rodada seguinte.

O extrato lista o dia a dia POR CONTA BANCÁRIA, então título sem conta não aparece nele — mesmo estando importado e correto na DRE. Se a carga entrou antes de a conta existir no espelho, o código da conta ficou guardado no documento: clique em "Recarregar cadastros", depois "Rodar agora" e por último "Amarrar vínculos". Não é preciso reimportar mês nenhum. Se o selo de vínculos pendentes não zerar, os cadastros que sobraram realmente não existem na origem.

Não necessariamente — e este é o caso mais escorregadio da tela. Número igual não significa CONJUNTO igual: já aconteceu de haver 38 contas bancárias na origem e 38 aqui, com 24 códigos diferentes entre os dois lados. Use "Ver quais faltam" na linha para ver os códigos que a origem tem e o espelho não, e os que só existem aqui. A lista vale para cadastro (parceiros, produtos, contas, naturezas, centros, TOPs); para título, nota e pedido a pergunta certa é o diagnóstico de vínculos pendentes, porque são centenas de milhares de chaves.

Nem sempre — e essa frase já apontou o culpado errado. Ela descreve o ESTADO do banco no instante da leitura: documento presente, campo vazio, cadastro compatível. Se a passada anterior amarrou e foi revertida por algum motivo, esses mesmos vínculos aparecem aqui como se nunca tivessem sido tentados. Antes de registrar como defeito, rode "Amarrar vínculos" de novo e veja se o número cai: caindo, era passada interrompida; ficando igual, é defeito de verdade.

A própria carga: todo cadastro citado por um vínculo pendente (por exemplo, a natureza de um título antigo que entrou pelo incremental) entra NOMINALMENTE no próximo pedido à origem, mesmo fora da janela de datas. É a regra "quem a carga citou, a carga pede" — sem depender de reimportar meses inteiros.

Porque deixaram de ser decisão de alguém (regra de 30/09/2026). E-mail inválido, repetido ou ausente na origem: o cadastro entra sem e-mail e pronto — não há o que decidir aqui, e corrigir no ERP é opcional. Parceiro que não é cliente nem fornecedor no ERP: quem tem título de despesa entra como fornecedor e quem tem título de receita entra como cliente, automaticamente; quem não tem papel nem movimento não é espelhado, e o contato dele também não. Saldo de conta bancária que não existe no espelho: é conta inativa na origem, e o saldo dela é ignorado. Nada disso some do seu radar: o resumo de cada execução, na coluna Detalhe, conta quantos entraram sem e-mail, quantos ficaram sem papel e quantos saldos foram ignorados. As pendências antigas desses três tipos foram fechadas como IGNORADAS na atualização.