Verificar se duas tabelas batem certo

Descrição

Antes de fechar, é necessário saber que um conjunto de valores concorda com outro: o razão geral com o balancete, um sistema de origem com a sua carga, os saldos de fecho deste mês com os saldos de abertura do mês seguinte. Uma reconciliação indica os dois lados e a forma como as respetivas linhas correspondem, e o Weave responde de uma de três formas:

Os Valores reais do razão geral batem certo com o Balancete: todas as 1204 contas concordam exatamente. Ambos totalizam 12 345 678,90.

Os Valores reais do razão geral não batem certo com o Balancete: 3 de 1204 contas diferem, em 4 210,00 no total, ignorando o sinal. Em termos líquidos, os Valores reais do razão geral são 3 900,00 superiores. A maior diferença é a da conta 4000, com 3 900,00 de distância (Valores reais do razão geral 1 000 000,00, Balancete 996 100,00).

O Weave não conseguiu verificar se os Valores reais do razão geral batem certo com o 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 de novo.

O Weave nunca diz que uma reconciliação bate certo quando não conseguiu ler ambos os lados na totalidade. A comparação é uma consulta aos seus dados; não há qualquer IA envolvida.

Criar uma reconciliação

Só um Arquiteto do projeto pode criar, editar ou eliminar uma reconciliação, e o projeto tem de estar desbloqueado.

Abra o separador Weave do projeto e clique em Reconciliações na sua barra de ferramentas.
Clique em Novo.
Atribua-lhe um Nome e, em As linhas chamam-se, indique o que é uma linha comparada, no plural — «contas», ou «pares de conta e centro de custo». O Weave utiliza-o em todas as frases; diz «itens» quando o deixa em branco.
Em Primeiro lado e Segundo lado, atribua a cada lado uma Etiqueta — o nome que o Weave utiliza para o designar, como «Valores reais do razão geral» — e escolha a respetiva Tabela. Em Medida, escolha como as suas linhas são somadas — Soma de, Contagem de, Contagem distinta de, Menor, Maior ou Média de — e a coluna.
Adicione Filtros a qualquer um dos lados para ler apenas algumas das suas linhas. Separe vários valores com vírgulas. Para comparar dois períodos de uma mesma tabela, escolha a mesma tabela em ambos os lados e filtre cada lado pelo respetivo período; não adicione a coluna do período em Corresponder por, ou nenhuma linha corresponderá.
Em Corresponder por, adicione uma linha por cada coluna-chave. Cada linha emparelha uma coluna do primeiro lado com uma coluna do segundo, pelo que account pode corresponder a acct. Atribua à linha um cabeçalho, como «Conta»; é o cabeçalho dessa coluna na lista de diferenças. Sem chaves, cada lado é comparado como um único valor — o 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 percentagem. Deixe em 0 para que cada linha concorde exatamente.
Opcionalmente, escolha um Fluxo de trabalho para colocar a reconciliação na lista de verificação de prontidão para o fecho desse fluxo de trabalho. Consulte Na lista de verificação de prontidão.
Clique em Guardar rascunho.

O Weave recusa uma reconciliação que não consiga comparar de forma justa e indica o motivo:

Os dois lados precisam do mesmo número de chaves, até 8, e de etiquetas diferentes, e não podem ser idênticos à parte as etiquetas.
As colunas-chave emparelhadas têm de conter o mesmo tipo de valor — números, texto, datas, datas e horas, ou verdadeiro/falso. As colunas de números de vírgula flutuante (tipos como float ou double) não podem ser chaves, e uma chave não pode ser uma coluna com o nome value ou rows.
Uma medida tem de ser uma coluna numérica, a não ser que conte.
Uma média, ou uma soma, um menor ou um maior de uma coluna de números de vírgula flutuante, precisa de uma tolerância superior a 0, porque esses valores raramente concordam exatamente.
Todas as tabelas e colunas que indica têm de estar no projeto, e o fluxo de trabalho a que está associada também tem de estar no projeto.
Guardar sem nada alterado é recusado.

Os dois lados podem utilizar medidas diferentes, como uma soma de um lado e uma contagem do outro. As linhas em falta contam como 0 apenas quando ambos os lados utilizam Soma de ou Contagem de; consulte Ler o resultado.

Aprovação

Uma reconciliação pode marcar um fluxo de trabalho como pronto para fechar, pelo que são precisas duas pessoas. O que guarda é um rascunho. Outro Arquiteto seleciona-o 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. Não pode aprovar uma versão que tenha sido o último a editar, pelo que um projeto precisa de um segundo Arquiteto para pôr uma reconciliação em utilização. A aprovação volta a verificar as tabelas e é recusada se o rascunho tiver sido alterado desde que o aprovador o leu.

Editar uma reconciliação aprovada guarda um novo rascunho, e a versão aprovada continua em utilização até o novo ser aprovado. Quando há um rascunho mais recente à espera, o resultado indica-o. Os Arquitetos podem clicar em Verificar o rascunho para executar a versão de trabalho antes de ser aprovada.

Ler o resultado

Selecione uma reconciliação para a executar. Clique em Verificar de Novo para a executar depois de os dados mudarem.

Quando não bate certo, as linhas que diferem são listadas por baixo da frase, a maior primeiro, com um máximo de 50 apresentadas. Cada uma mostra as suas chaves, os valores de ambos os lados e o primeiro lado menos o segundo. Uma linha encontrada apenas num dos lados mostra sem linhas no outro lado, nunca 0, e uma linha cujo valor está vazio mostra sem valor. Quando diferem mais linhas do que as apresentadas, uma legenda indica quantas ficaram de fora e qual a diferença conjunta; adicione filtros para ver menos linhas de cada vez.

Tolerância. Uma linha concorda quando os seus dois valores não distam mais do que a tolerância. Essas pequenas diferenças somam-se na mesma, pelo que uma reconciliação pode bater certo linha a linha enquanto os totais diferem, e a frase di-lo então:

Os Valores reais do razão geral batem certo com o Balancete: cada uma das 1204 contas está dentro da sua tolerância de 0,01. Em todas as contas, essas pequenas diferenças resultam num valor líquido de 0,37: os Valores reais do razão geral totalizam 12 345 679,27 e o Balancete 12 345 678,90, pelo que os Valores reais do razão geral são 0,37 superiores.
Linhas em falta. Quando ambos os lados utilizam Soma de ou Contagem de, uma linha que só um dos lados tem conta como 0 no outro lado, pelo que uma linha a 0 de um lado e ausente do outro concorda. Um lado sem quaisquer linhas, enquanto o outro tem algumas, é sempre uma diferença.
Outras medidas. Para uma contagem distinta, o menor, o maior ou uma média, uma linha que falta a um dos lados é uma diferença, e não é indicado nenhum total, 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 na totalidade, e indica o motivo, nomeadamente quando:

a 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-lhe ver apenas algumas das linhas de um lado — uma correspondência numa parte dos dados não é uma correspondência;
uma tabela ou coluna que a reconciliação utiliza foi removida ou renomeada, uma coluna-chave passou a conter outro tipo de valor, ou uma coluna de medida já não contém números ou passou a precisar de uma tolerância que não tem;
uma pesquisa num dos lados corresponde agora a mais do que uma linha para algumas entradas;
nenhum dos lados tem linhas que correspondam aos seus filtros, ou nenhum tem um valor para qualquer linha;
a reconciliação ainda não foi aprovada;
não foi possível executá-la neste momento, por exemplo quando o armazém demora a responder.

Na lista de verificação de prontidão

Uma reconciliação associada a um fluxo de trabalho aparece no item desse fluxo de trabalho em todos os conjuntos de prontidão que o incluem, como a linha As reconciliações batem certo, com a frase própria de cada reconciliação e Abrir reconciliação. Uma reconciliação que não bate certo torna o fluxo de trabalho Não pronto. Uma que o Weave não conseguiu verificar, ou que não foi aprovada, torna-o Não foi possível verificar, a menos que outra linha já o torne Não pronto.

A lista de verificação executa a versão aprovada de cada uma, como a pessoa que a está a verificar, pelo que a sua resposta reflete as linhas que essa pessoa pode ver. Executa até 25 por lista de verificação e dá-lhes um minuto no conjunto; as que excedam esse limite indicam-no em vez de serem executadas e contam como Não foi possível verificar. Quando o Weave verifica um conjunto antes da respetiva hora limite, executa-as como o responsável pelo conjunto e só lê tabelas se o responsável podia fazê-lo quando guardou o conjunto pela última vez.

Quem pode ver o quê

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

Através da API

As reconciliações estão disponíveis através da 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 eliminam uma. POST /analyze/weave/reconciliation/approve aprova um rascunho: envie digest, definido como o content_digest que leu com ele, que identifica exatamente a versão que reviu. GET /analyze/weave/reconciliation/run executa uma.

Um lado também pode pesquisar noutras tabelas — uma junção da tabela do lado a uma tabela de pesquisa, que tem de encontrar no máximo uma linha por cada linha do lado. As pesquisas e a medida Média ponderada de, que precisa de uma tolerância superior a 0 como uma média, só podem ser definidas através da API; o formulário mantém-nas quando edita.

Os agentes de IA ligados através de MCP podem encontrar e executar reconciliações com reconciliation_find e reconciliation_run. Um Arquiteto ligado com o seu próprio início de sessão também pode guardar um rascunho com reconciliation_upsert; uma IA que atue em nome de alguém, como uma sessão de agente, o Microsoft 365 Copilot ou o chat da aplicação, não pode. Nenhuma ferramenta MCP aprova uma.