Relatórios: Visão executiva, Técnico, Negócio, Conciliação, Evidência e Meus relatórios

O período vale para todas as abas

Escolha 7, 30, 90 dias ou um período personalizado no topo. Ele vale para a aba inteira e acompanha você nas outras abas. O período anterior é o de mesmo tamanho logo antes — é contra ele que as variações são calculadas.

Visão executiva

O que quem decide pergunta, em uma tela:

• Resumo da IA do período, com até 3 achados (veja o artigo do resumo da IA).
• 4 números com a variação real contra o período anterior: mensagens, taxa de sucesso, dentro do SLA e erros.
• Tendência: volume por dia, com os erros de cada dia.
• Principais parceiros: os cinco com mais mensagens, com o link para o Scorecard completo.

Técnico

Para quem opera a integração: entregues, aguardando, falharam e em processamento; os motivos reais das falhas; as integrações e etapas mais lentas; o funil de processamento; erros por tipo e por categoria; o Scorecard de parceiros e o envelhecimento do que está parado.

Scorecard de parceiros

Uma linha por parceiro com: mensagens no período, % no prazo, % de erro, acks pendentes (confirmações que ainda não chegaram) e a tendência de 12 semanas do % no prazo, com a variação das últimas 4 semanas contra as 4 anteriores. O parceiro é sempre o código do outro lado da mensagem — nunca o da própria empresa. Substitui os antigos quadros de saúde por parceiro, risco operacional e erros por parceiro.

Dentro do SLA (prazo de entrega)

Uma mensagem está no prazo quando foi entregue ao destino dentro do prazo da empresa (padrão: 60 minutos). Mensagem que ainda está dentro do prazo não conta nem a favor nem contra. O prazo e o limiar de erro ficam em Configurações → Política de SLA.

Negócio

Faturamento, pedidos, entregas, clientes e produtos (Inteligência de Negócio) e os relatórios de documentos, itens e valores lidos do conteúdo das mensagens.

Os valores aparecem como o documento os declara: Pedido (total geral do pedido), Líquido dos itens (soma líquida das linhas, como o valor líquido de um pedido de venda do SAP) e Faturado (total da fatura). Cada um só aparece quando o documento traz aquele valor — ausência é "—", nunca zero. Um item é uma linha do documento pela identidade da linha aprovada no catálogo (por exemplo, o número do item): condições de preço, divisões de remessa e outras listas do documento não contam como itens.

O papel de cada parceiro (comprador, recebedor, faturado…) sai do qualificador que o próprio documento traz (a função do parceiro no SAP, o NAD no EDIFACT, o PARVW no IDoc, o N1 no X12), lido no dicionário de papéis. A função do parceiro que vem do SAP é lida na língua em que o SAP respondeu aquela mensagem (em alemão, SP é o transportador; em inglês, o emissor). Vale a língua em que o SAP de fato respondeu, não a pedida: o SAP aceita uma língua que não tem instalada e responde em outra sem avisar, e o Lefia confere pela resposta e pela descrição do serviço ($metadata). Quando a resposta veio em outra língua, a tela da integração avisa; quando não dá para saber a língua, o código não é convertido e conta como sem língua. Mensagem sem língua gravada é lida como inglês e contada. Valor que o dicionário não conhece aparece como "Sem papel declarado"; valor com mais de um papel possível, como "Ambíguo". Os dois são contados na rotina de materialização para curadoria.

Nos formatos em que o mesmo campo carrega valores diferentes conforme o qualificador (no EDIFACT, o MOA do cabeçalho é o total das linhas com 79, o total do pedido com 86, o imposto com 124), cada valor entra no conceito que o qualificador da própria ocorrência indica, na linha ou no cabeçalho. Qualificador que o dicionário não conhece não é contado como nenhum total: fica de fora e é contado para curadoria.

Quando o documento não declara o total do pedido ou o imposto total, o relatório os DERIVA do que o documento traz (total do pedido = líquido das linhas + imposto das linhas; imposto total = soma do imposto das linhas ou, quando o documento traz o imposto por grupo (uma alíquota por grupo) e não o total, a soma de todos os grupos) e mostra a marca derivado. O valor declarado sempre vence o derivado, e os dois nunca se misturam. A derivação confere a moeda de cada linha (coluna Moeda do item; linha sem moeda própria está na moeda do documento): se uma linha estiver em outra moeda, o valor derivado não aparece, porque somar moedas diferentes daria um número errado.

Conciliação

A prova documento a documento de que o que saiu da origem chegou ao destino. Origem e destino costumam escrever o mesmo valor em códigos diferentes (o tipo de documento TA do SAP é 220 no EDIFACT): a comparação passa o código da origem pelo mesmo de-para da base de conhecimento que a integração usou, e só diz "chegou diferente" quando o resultado não é o que chegou. Código sem de-para na base aparece em Campos que não deu para comparar, não como diferença.

Evidência

Documento com os números exatos do período, por integração, para anexar a um fechamento ou auditoria.

Meus relatórios

Você descreve o relatório e a IA monta a definição. As perguntas sugeridas são as que os dados da empresa conseguem responder. Se a pergunta não der para montar, a tela diz o que falta e oferece a pergunta mais próxima que dá. Quem administra a empresa pode salvar o relatório. Avalie cada resposta com os botões de útil e não útil.

Do número para a mensagem

Todo número clicável abre a aba Mensagens no mesmo período e ambiente, já filtrada: por desfecho, por parceiro, por categoria ou pelas paradas.

Mensagem dividida em partes

Quando uma leitura vira vários documentos no destino (por exemplo, a venda do dia de uma loja enviada em partes), os relatórios, o monitoramento e os alertas contam o documento uma vez: uma parte com erro deixa o documento com erro, uma parte ainda em processamento deixa o documento em processamento, e o tempo de entrega é o da última parte. No relatório de negócio, cada registro de um envio em lista aparece como um documento. Mensagens que não são divididas não mudam em nada. A franquia e os totais do mês continuam contando por mensagem.

Relatório de negócio em dia

O conteúdo das mensagens que o relatório de Negócio lê é preparado em segundo plano, em rodadas a cada 5 minutos que usam o tempo todo da rodada, também durante uma leitura grande. Cada mensagem é preparada logo depois de o Lefia convertê-la (a que ainda não foi convertida espera até 15 minutos, para não ser preparada duas vezes). Enquanto uma mensagem ainda não foi preparada, o relatório a lê direto do conteúdo original: o número é o mesmo, só a consulta fica um pouco mais lenta.

Relatórios grandes

As abas Técnico, Negócio, Conciliação e Evidência leem somas por hora e por dia que o Lefia mantém enquanto as mensagens chegam — não cada mensagem do período. Por isso abrem em segundos mesmo com centenas de milhares de mensagens por dia. Ao clicar numa aba, a tela troca na hora e mostra que o relatório está sendo montado; se a leitura falhar, o aviso aparece na própria aba, com Tentar de novo. No relatório de Negócio, mensagens que acabaram de chegar e ainda não tiveram o conteúdo preparado entram na próxima rodada (a cada 5 minutos), e o relatório diz quantas são.

Conciliação: o que cada número quer dizer

• Chegaram iguais: entregues, e todo campo que os dois formatos carregam bate.
• Chegaram diferentes: entregues, e algum campo que os dois formatos carregam veio diferente (ou sumiu no destino).
• Não chegaram: o envio não aconteceu ou falhou.
• Puladas de propósito: o fluxo decidiu não enviar (por exemplo, uma lista vazia). Não é falha.
• Não dá para comparar: um dos lados não traz nenhum campo do documento que o outro também traga (por exemplo, um cadastro de material), ou o conteúdo ainda não foi preparado; a tela diz o motivo.

Campo que só um dos formatos tem não é comparado. Identificadores de sistemas diferentes (o código do parceiro no SAP e o CNPJ, por exemplo) aparecem como não verificável — identificadores de sistemas diferentes.