Conciliação por dimensão e dia (loja, filial, centro)

Onde: Monitoramento → Análise → Conciliação → Por dimensão e dia.

Para empresas que precisam provar a entrega por uma dimensão (loja, filial, centro…) e por dia — a venda diária de cada loja, por exemplo. Vale para qualquer integração e qualquer formato de destino.

Configurar (uma vez por integração)

Escolha a integração e clique em Configurar. Os campos vêm preenchidos a partir do último registro que a integração entregou; confira e altere o que precisar.

Nome da dimensão — como a tela chama (Loja, Filial, Centro…).
Campo da dimensão e Campo do dia — no registro entregue (ou na linha, se não estiverem no registro). O dia aceita AAAA-MM-DD, AAAAMMDD e DD/MM/AAAA.
Lista de linhas — quando cada registro leva uma lista (os produtos vendidos na loja no dia, por exemplo). Sem lista, cada registro é uma linha.
Campo da quantidade e Campo do valor — na linha.
Como cada medida conta — Reprova se não bater (com a tolerância aceita) ou Só mostra, com uma nota na tela. Exemplo: quantidade de item vendido a peso que ainda depende da regra de unidade combinada com o destino.
Tabela de referência (opcional) — uma tabela de referência da empresa cujas chaves são as dimensões esperadas: a loja que não teve nada no dia aparece mesmo assim.

O total da origem

Marque Consultar o total da origem para provar que nada ficou na origem. É uma consulta de controle à origem da integração (OData), lida por dia:

a entidade; numa CDS com parâmetros, a navegação dos parâmetros e os parâmetros que recebem o dia (início e fim = o dia); sem parâmetros, o campo filtrado pelo dia;
a resposta: já agregada por dimensão (com os campos de linhas, quantidade e valor) ou detalhada (uma linha por item; o Lefia conta e soma);
o teto de linhas da consulta detalhada: passou dele, a leitura é marcada como cortada;
os campos que identificam uma linha, quando o $metadata não declara a chave: a leitura detalhada é feita em janelas numa ordem única, e sem chave nem esses campos ela é recusada com o motivo.

O Lefia relê o dia anterior de tempos em tempos (no intervalo do perfil) e quando você clica em Consultar a origem agora. Uma leitura cortada ou com erro não entra na comparação: a tela diz Origem indisponível e mostra o motivo, em vez de comparar com um total incompleto.

O que a tela mostra

Por dimensão: origem, enviado e confirmado em cada medida, o que está aguardando o destino e o que falhou. A situação:

Conciliado — o confirmado bate com a origem em toda medida que reprova.
Divergente — alguma medida não bate (a diferença aparece em destaque).
Não enviado — a origem tem, o Lefia não tem nada.
Com falha / Em andamento — há mensagens com erro, ou ainda aguardando o destino.
Valor ilegível — algum registro tem uma medida que não é número.
Sem movimento — nada na origem nem no Lefia.
Observação (não enviado) — a integração está em modo observação: as linhas são lidas e convertidas, mas nunca enviadas; não contam como enviadas nem confirmadas.

Registros cujo dia não se lê (campo errado ou formato de data desconhecido) aparecem num quadro à parte, Registros sem dia legível, por dimensão — não somem.

Confirmado (sem origem) — sem a consulta de origem, tudo o que saiu foi confirmado (não é a prova completa).

Só conta a última mensagem de cada documento (o destino substitui pela chave); partes canceladas e duplicadas ficam fora. Exportar CSV baixa o dia com os mesmos números.

Mensagens que passaram antes da configuração

Em Recalcular das mensagens, escolha o período de recebimento: o Lefia relê os registros entregues dessas mensagens. Use também depois de mudar um campo.

Reprocessar uma dimensão e um dia

Em cada linha, Reprocessar (para quem administra a empresa) devolve à fila as mensagens não confirmadas daquela dimensão e dia — ou todas, se escolher; o destino substitui pela chave, então reenviar não duplica. Marque Reler o dia na origem para trazer o que o Lefia nunca recebeu (o mesmo Reler período da integração): filtrado pela dimensão quando o perfil diz o campo da origem que filtra a dimensão. O motivo é obrigatório e fica na trilha. A causa mais frequente de cada dimensão aparece na tela e no CSV.

Alerta diário

Em Alerta diário do que não conciliou, escolha o horário (no fuso da integração) e quantos dias atrás conferir (1 = ontem). No horário, as dimensões que não conciliaram vão para o sino de quem administra a empresa e para o e-mail/Slack da seção Alertas, com a situação, a causa e o link para reprocessar — uma vez por dia. Conciliado, sem movimento e modo observação não alertam.

Itens sem cadastro no destino (órfãos)

Em Itens sem cadastro no destino, diga o campo da chave do item na linha (o produto), a integração de cadastro e o campo da chave no registro dela. Um item é órfão quando a chave dele não tem nenhuma mensagem confirmada na integração de cadastro; a lista é conferida de novo a cada vez (o item cadastrado depois sai) e tem export em CSV. Itens cadastrados no destino por fora do Lefia aparecem como órfãos até passarem pela integração de cadastro.

Código da origem diferente do destino

Quando a origem usa um código (a planta) e o destino outro (a loja), informe na consulta de controle a tabela de tradução (uma tabela de referência da empresa com a chave = valor da origem) e a coluna com o valor do destino. Valor da origem sem tradução aparece como veio, até a tabela ser completada.

Integrações sem essa configuração não mudam em nada.