Verifique se duas tabelas batem

Descrição

Antes de fechar, você precisa saber que um conjunto de números concorda com outro: o razão geral com o balancete, um sistema de origem com a sua carga, os saldos finais deste mês com os saldos iniciais do próximo. Uma reconciliação nomeia os dois lados e como as linhas deles correspondem, e o Weave responde de uma de três formas:

Realizado do razão geral bate com Balancete: todas as 1.204 contas concordam exatamente. Ambos somam 12.345.678,90.

Realizado do razão geral não bate com Balancete: 3 de 1.204 contas diferem, em 4.210,00 no total, ignorando o sinal. Em valores líquidos, Realizado do razão geral é 3.900,00 maior. A maior diferença é a da conta 4000, com 3.900,00 de distância (Realizado do razão geral 1.000.000,00, Balancete 996.100,00).

O Weave não conseguiu verificar se Realizado do razão geral bate com Balancete: nenhum dos lados tem linhas que correspondam aos filtros desta reconciliação. Se esses dados ainda não foram carregados, carregue-os e verifique novamente.

O Weave nunca diz que uma reconciliação bate quando não conseguiu ler os dois lados por completo. A comparação é uma consulta aos seus dados; nenhuma IA é usada.

Crie uma reconciliação

Somente um Arquiteto do projeto pode criar, editar ou excluir uma reconciliação, e o projeto precisa estar desbloqueado.

Abra a guia Weave do projeto e clique em Reconciliações na barra de ferramentas.
Clique em Novo.
Dê a ela um Nome e, em As linhas são chamadas de, diga o que é uma linha comparada, no plural — “contas” ou “pares de conta e centro de custo”. O Weave usa isso em todas as frases; ele diz “itens” quando você deixa em branco.
Em Primeiro lado e Segundo lado, dê a cada lado um Rótulo — o nome que o Weave usa para ele, como “Realizado do razão geral” — e escolha sua Tabela. Em Medida, escolha como as linhas dele são totalizadas — Soma de, Contagem de, Contagem distinta de, Smallest, Largest ou Média de — e a coluna.
Adicione Filtros a qualquer lado para ler apenas parte das linhas dele. Separe vários valores com vírgulas. Para comparar dois períodos de uma mesma tabela, escolha a mesma tabela nos dois lados e filtre cada lado pelo seu período; não adicione a coluna de período em Corresponder por, ou nenhuma linha vai corresponder.
Em Corresponder por, adicione uma linha para cada coluna-chave. Cada linha emparelha uma coluna do primeiro lado com uma coluna do segundo, de modo que account pode corresponder a acct. Dê à linha um título, como “Conta”; ele intitula essa coluna na lista de diferenças. Sem chaves, cada lado é comparado como um único valor — seu total, no caso de uma soma ou de uma contagem.
Opcionalmente, defina uma Tolerância por linha: a distância máxima entre os dois valores de uma linha para que ainda concordem, nas unidades da própria medida, como 0.01. Não é uma porcentagem. Deixe em 0 para que toda linha concorde exatamente.
Opcionalmente, escolha um Fluxo de trabalho para colocar a reconciliação na lista de verificação de prontidão do fechamento desse fluxo de trabalho. Consulte Na lista de verificação de prontidão.
Clique em Salvar rascunho.

O Weave recusa uma reconciliação que não conseguiria comparar de forma justa e diz por quê:

Os dois lados precisam ter o mesmo número de chaves, até 8, e rótulos diferentes, e não podem ser idênticos além dos rótulos.
As colunas-chave emparelhadas precisam conter o mesmo tipo de valor — números, texto, datas, datas e horas, ou verdadeiro/falso. Colunas de números de ponto flutuante (tipos como float ou double) não podem ser chaves, e uma chave não pode ser uma coluna chamada value ou rows.
Uma medida precisa ser uma coluna numérica, a menos que seja uma contagem.
Uma média, ou uma soma, o menor ou o maior valor de uma coluna de números de ponto flutuante, exige uma tolerância acima de 0, porque esses valores raramente concordam exatamente.
Toda tabela e coluna que ela nomeia precisa estar no projeto, e o fluxo de trabalho ao qual ela está vinculada também precisa estar no projeto.
Salvar sem nenhuma alteração é recusado.

Os dois lados podem usar medidas diferentes, como uma soma de um lado e uma contagem do outro. Linhas ausentes contam como 0 apenas quando os dois lados usam Soma de ou Contagem de; consulte Leia o resultado.

Aprovação

Uma reconciliação pode marcar um fluxo de trabalho como pronto para fechar, então ela exige duas pessoas. O que você salva é um rascunho. Outro Arquiteto o seleciona e clica em Aprovar, e a partir daí essa versão é a que os leitores e a lista de verificação de prontidão executam. Você não pode aprovar uma versão que foi o último a editar, então um projeto precisa de um segundo Arquiteto para colocar uma reconciliação em uso. A aprovação verifica as tabelas novamente e é recusada se o rascunho mudou desde que o aprovador o leu.

Editar uma reconciliação aprovada salva um novo rascunho, e a versão aprovada continua em uso até que a nova seja aprovada. Quando há um rascunho mais novo aguardando, o resultado informa isso. Os Arquitetos podem clicar em Verificar o rascunho para executar a versão de trabalho antes de ela ser aprovada.

Leia o resultado

Selecione uma reconciliação para executá-la. Clique em Verificar Novamente para executá-la depois que os dados mudarem.

Quando ela não bate, as linhas que diferem são listadas abaixo da frase, a maior primeiro, com até 50 exibidas. Cada uma mostra suas chaves, os valores dos dois lados e o primeiro lado menos o segundo. Uma linha encontrada em apenas um lado mostra sem linhas para o outro lado, nunca 0, e uma linha cujo valor é vazio mostra sem valor. Quando mais linhas diferem do que as exibidas, uma legenda informa quantas ficaram de fora e quanto elas diferem juntas; adicione filtros para olhar menos linhas por vez.

Tolerância. Uma linha concorda quando seus dois valores não estão mais distantes do que a tolerância. Essas pequenas diferenças ainda se acumulam, então uma reconciliação pode bater linha por linha enquanto seus totais diferem, e a frase então informa isso:

Realizado do razão geral bate com Balancete: cada uma das 1.204 contas está dentro da tolerância de 0,01. Em todas as contas, essas pequenas diferenças somam 0,37 em valores líquidos: Realizado do razão geral totaliza 12.345.679,27 e Balancete 12.345.678,90, de modo que Realizado do razão geral é 0,37 maior.
Linhas ausentes. Quando os dois lados usam Soma de ou Contagem de, uma linha que só um lado tem conta como 0 no outro lado, então uma linha em 0 de um lado e ausente do outro concorda. Um lado sem nenhuma linha, enquanto o outro tem algumas, é sempre uma diferença.
Outras medidas. Para uma contagem distinta, o menor valor, o maior valor ou uma média, uma linha que um dos lados não tem é uma diferença, e nenhum total é informado, já que esses valores não se somam.

O Weave diz que não foi possível verificar quando não consegue comparar os dois lados por completo, e informa o motivo, inclusive quando:

sua função não pode ler dados de tabelas, ou não pode ver uma das tabelas que um lado lê;
o acesso às linhas permite que você veja apenas parte das linhas de um lado — bater em parte dos dados não é bater;
uma tabela ou coluna que a reconciliação usa foi removida ou renomeada, uma coluna-chave agora contém um tipo de valor diferente, ou uma coluna de medida não contém mais números ou agora precisa de uma tolerância que não tem;
uma busca em um lado agora corresponde a mais de uma linha para algumas entradas;
nenhum dos lados tem linhas que correspondam aos seus filtros, ou nenhum tem valor para qualquer linha;
a reconciliação ainda não foi aprovada;
ela não pôde ser executada agora, como quando o data warehouse demora a responder.

Na lista de verificação de prontidão

Uma reconciliação vinculada a um fluxo de trabalho aparece no item desse fluxo de trabalho em todo conjunto de prontidão que inclui o fluxo de trabalho, como a linha Reconciliations tie out, com a frase de cada reconciliação e Abrir reconciliação. Uma reconciliação que não bate deixa o fluxo de trabalho Não pronto. Uma que o Weave não conseguiu verificar, ou que não foi aprovada, o deixa como Não foi possível verificar, a menos que outra linha já o deixe Não pronto.

A lista de verificação executa a versão aprovada de cada uma, como a pessoa que está verificando, então sua resposta reflete as linhas que essa pessoa pode ver. Ela executa até 25 por lista de verificação e dá a elas um minuto no total; as que passarem disso informam isso em vez de executar e contam como Não foi possível verificar. Quando o Weave verifica um conjunto antes do prazo, ele as executa como o responsável pelo conjunto, e só lê tabelas se o responsável podia fazê-lo quando salvou o conjunto pela última vez.

Quem pode ver o quê

Qualquer pessoa que possa abrir a guia Weave do projeto pode listar as reconciliações aprovadas. Executar uma também exige uma função que possa ler dados de tabelas. Um leitor que não é Arquiteto vê o nome e os rótulos dos lados de cada reconciliação, nunca suas tabelas, colunas ou filtros, e os motivos que o Weave dá a ele nomeiam apenas os lados.

Pela API

As reconciliações estão disponíveis pela API da plataforma: GET /analyze/weave/reconciliations lista as reconciliações de um projeto, e GET, POST, PUT e DELETE em /analyze/weave/reconciliation leem, criam, substituem e excluem uma. POST /analyze/weave/reconciliation/approve aprova um rascunho: envie digest, definido como o content_digest que você leu com ele, que identifica exatamente a versão que você revisou. GET /analyze/weave/reconciliation/run executa uma.

Um lado também pode buscar outras tabelas — uma junção da tabela do lado com uma tabela de busca, que deve encontrar no máximo uma linha para cada linha do lado. As buscas e a medida Média ponderada de, que exige uma tolerância acima de 0 como uma média, só podem ser definidas pela API; o formulário as mantém quando você edita.

Agentes de IA conectados por MCP podem encontrar e executar reconciliações com reconciliation_find e reconciliation_run. Um Arquiteto conectado com o próprio login também pode salvar um rascunho com reconciliation_upsert; uma IA agindo em nome de alguém, como uma sessão de agente, o Microsoft 365 Copilot ou o chat do aplicativo, não pode. Nenhuma ferramenta MCP aprova uma.