Central de Ajuda

Productivity hacks pra navegar rápido.

Como entrar via SSO (Okta/Azure AD/Google Workspace) e como o admin habilita o SSO da empresa.

Você recebeu um email de convite ou de recuperação? Veja como definir sua senha e acessar o Lefia.

Quando você testa conexão OData e o SAP tem fields diferentes do catálogo local, abre um dialog mostrando added/removed antes de gravar.

Visão geral em 1 minuto sobre o que a plataforma faz.

No primeiro acesso, um guia no topo da tela mostra o caminho e se marca sozinho conforme você avança.

A barra da esquerda tem dois níveis: a trilha mostra as zonas, o painel mostra as telas da zona aberta.

Como abrir um incidente — bug, dúvida, feature ou sistema fora do ar — e acompanhar o status.

Quando uma ação sua falha, o assistente no canto da tela pergunta se pode ajudar. Ele só consulta a IA se você pedir.

O assistente responde com base nos artigos de ajuda e na tela em que você está. Você pode responder, perguntar mais e, se não resolver, abrir o incidente com a conversa inteira.

Campo de busca typeahead em /admin, /mapeamentos, /mapeamentos/empresa/<id> e /reports. Filtra cards e lista em tempo real, case-insensitive, busca por nome (e por parceiro/tipo em integrações).

Toda view com toggle cards/lista (Empresas, Mapeamentos, detalhe de empresa, Relatórios) tem campo de busca typeahead que filtra em tempo real.

Como receber, ler e arquivar notificacoes.

O que funciona/nao funciona no iPhone + como usar ResponsiveTable.

Confirme cada interchange EDI recebido com um CONTRL (EDIFACT) ou 997 (X12) e acompanhe os acks que o parceiro devolve pros seus envios.

Wizard admin não cria mais message_type stub. Salva default_source_format + default_destination_format na integration; "Derivar mapping" usa pra pré-preencher.

Autentique conexões SFTP por chave privada (OpenSSH ou PEM), por senha ou pelas duas.

Responda ao remetente assim que a mensagem é mapeada e deixe a fila entregar ao destino com retry — sem acoplar o remetente à disponibilidade do destino.

O que o admin e os usuários da empresa podem fazer em Mapeamentos e em Execuções.

A origem OData não é escolhida por nome: sai do serviço e da versão que a URL da conexão aponta, em V2 e em V4.

Toggle por integração que define se o Lefia só observa o tráfego (modo seguro pra rollout) ou orquestra de fato o envio ao destino. Default novo tenant: observability.

Como o Lefia detecta e bloqueia mensagens duplicadas at-insert via fingerprint SHA-256 + header Idempotency-Key (padrão Stripe). UNIQUE parciais por message_type, race fallback via 23505.

Como conectar um endpoint de iFlow do SAP Integration Suite (CPI) como origem REST — Basic Auth para PoC, service key OAuth para produção, e os erros comuns do BTP.

Conectar 2 sistemas — origem (de onde vêm dados) e destino (pra onde vão).

Como configurar SAP (ou outro sistema externo) para postar documentos no Lefia via webhook autenticado.

Quando o SAP retorna mais documentos do que cabe em uma página, o Lefia segue automaticamente o link da próxima até esgotar (com limites de segurança).

Trocar um campo mantém os outros guardados; apagar é só pelo botão Remover.

Lista completa dos 14 protocolos com quando usar cada.

File polling busca arquivos de um diretório SFTP/FTP em intervalos regulares, baixa, processa pelo pipeline e marca como duplicado se já viu o arquivo.

Na lista de integrações da tela Mapeamentos, o estado de cada integração nas últimas 24 horas — e por que "Parada" aqui não é o mesmo que na Visão geral.

Arquivar tira de operação e guarda o histórico; excluir com mensagens pede o nome digitado.

Mesmo sistema em várias integrações: escolha a conexão já cadastrada em vez de colar a senha de novo.

Teste um destino webhook sem parceiro: o Lefia recebe, guarda e mostra o que e como chegou. Ou encadeie numa entrada do próprio Lefia.

Declare o que o sistema de destino exige e a mensagem do parceiro não traz (empresa, data de lançamento) e converta códigos (tipo de documento, imposto, unidade).

Campos com cardinalidade, diferença para o catálogo e amostra real, iguais para todo formato, no assistente e na tela da integração.

A origem OData sai do serviço e da versão da conexão. Se o catálogo não tem essa versão, o administrador da empresa registra a mensagem do serviço (Exclusiva) ou pede ao Lefia.

Receber notificações em sistemas externos quando mensagens chegam/falham.

Como rodar uma integração manualmente no Integration Lab

Todo arquivo EDIFACT, X12 ou IDoc leva no envelope a identificação do remetente e do destinatário e se é teste ou produção. Isso se cadastra na conexão de destino; sem o perfil, o Lefia não envia.

Automático ou Limitado: como o Lefia lê as páginas de uma origem OData.

Por documento ou Ordem de chegada: como os lotes de uma interface saem para o destino.

Lefia detecta automaticamente OData V2 ou V4 por URL. 4 services com V4 disponível (Billing, Sales Order, Purchase Order, Product). Catálogos separados, mapping editor mostra fields da versão correta. V4 expõe header pricing populado, descriptions humanas e rollups Net/Gross/Profit.

Destino que recebe POST: leia os campos do corpo de cada operação direto do swagger.json.

Junte N mensagens num POST de array e confirme cada lote consultando a fila do destino pelo id do processo.

Faça uma integração esperar a confirmação do destino para o documento correspondente de outra — por exemplo, produto só depois do fornecedor.

Traga da origem o que ficou para trás num período passado, sem mexer no ponto da leitura normal e sem duplicar.

Por quanto tempo o Lefia guarda o conteúdo, o rastro, a mensagem e o registro de identidade e conciliação de cada integração, e de onde vem o prazo.

Diga quantos envios o destino aceita por segundo ou por minuto: o Lefia respeita o limite em todo envio e, quando o destino pede uma pausa, para a conexão inteira até o prazo.

Como anexar/trocar certificado digital A1 (.pfx/.p12) ao criar OU editar integração SOAP/REST. Inclui alerta automático 30/14/7/1d antes do vencimento e badge na UI.

Doc canônico do pipeline de mensagens com 7 cenários (sucesso, retry-success, retry-DLQ, retry-manual, 4xx não-retentável, cert-expirando, cancelar). Estados, classifier de erros, onde ver tudo.

Autenticação server-to-server via client_id + client_secret. Padrão pra Azure AD M2M, Auth0 M2M, Oracle OIC, SAP BTP Service Key.

Autenticação via JWT assinado pela chave privada do cliente. Padrão SAP S/4HANA enterprise, Auth0 private_key_jwt e Azure AD on-behalf-of.

Auth não-OAuth pra APIs próprias: o Lefia faz login (POST usuário+senha), recebe um token no corpo e passa a mandá-lo como Bearer. Configurável no form REST.

Autenticação user-on-behalf via redirect ao provider. PKCE obrigatório (RFC 7636). Único grant que devolve refresh_token — Lefia renova automaticamente.

Como o Lefia humaniza erros HTTP 5xx, timeouts, DNS, TLS, SSH/FTP/Kafka. Cada mensagem diz quem é o problema (cliente/provider/rede) e se vai haver retry automático.

Os 6 cards do mapping editor refletem dimensões granulares (não mutuamente exclusivas): total de campos com origem, com destino, mapeados por IA, mapeados manualmente, sem destino, sem origem. Click no card filtra.

O catálogo declara type/length/precision/scale/pattern/enumeration por campo, extraídos de XSD/EDMX. Mapping editor mostra badge "string · ..35" ou "decimal · 18,3" no destino.

Cada campo no catálogo declara fonte (spec/IA/curado/cliente), com link público pra spec quando disponível. Sub-tipos manual distinguem curadoria Lefia (global) de validação do cliente (tenant).

Segundo passo de inteligência do mapping editor — depois de mapear de-para, propõe a transformação certa baseada em tipo/length/precision/scale.

Banner amarelo no mapping editor avisa quando o mapping referencia fields que sumiram do $metadata atual do SAP. Botão "Atualizar catálogo" remove os órfãos.

Tire fotos imutáveis do estado do catálogo num momento. Mappings podem referenciar o snapshot que originou eles. Diff visual entre snapshot e estado atual.

Promova fields sugeridos por IA a "curado por Lefia" com 1 clique (após revisão humana). Pruning automático remove sugestões IA não-promovidas mais velhas que 90 dias.

sap-client header só vai em SAP on-premise / private cloud. Sandbox (sandbox.api.sap.com / *.api.sap.com) rejeita com 401 — tenant é fixo pelo API key. Tanto execução de query quanto $metadata fetch respeitam essa regra agora.

Mensagem nova do catálogo aparece com o selo "em validação": configure e teste em DEV/QAS; em PRD ela vale depois que o destino real da empresa aceitar os primeiros documentos.

Criar e editar uma integração usam o mesmo conjunto de campos. Tudo que aparece no edit aparece no create — triggerType, executionWindow, retry policy, file polling, post-processing. Sem surpresa entre os 2 fluxos.

Antes integrações novas nasciam com mode="observability" (só observa, não envia ao destino). Mudou para "orchestration" (envia de fato). Default antigo deixava cliente novo sem entender por que nada chegava no destino.

Tabelas de integrações e mensagens em Mapeamentos permitem seleção múltipla. Ações em batch: pausar/reativar/excluir integrações; reprocessar mensagens. Botão "Selecionar todos" no header.

O agente de IA da sua empresa (Joule, Claude, MuleSoft Agent Fabric ou outro cliente MCP) consulta integrações, mensagens, erros, números do Monitor, o relatório de negócio, o catálogo de formatos e os seus incidentes de suporte — com uma chave da empresa.

Cole ou edite o documento de origem e envie pelo mesmo caminho do recebimento. O número vem do documento: mesmo número com conteúdo novo é nova revisão.

Como usar um banco Oracle atrás de VPN como origem, via agente lefia-bridge (read-only).

Escolha, por interface, se cada documento lido vira uma mensagem ou se as páginas lidas viram pacotes com vários documentos — e quando usar cada um.

O Sugerir IA agora usa por padrão o modo determinístico: a IA reconhece o conceito de cada campo e o compilador monta o destino exato pela especificação — sem chutar slot/qualifier. Cai no modo clássico só onde o formato ainda não está coberto.

Envelope EDI/X12/IDoc/NFe (UNH, UNT, ISA, IEA, EDI_DC40, protNFe, etc.) é preenchido automaticamente pelo Lefia — operador não deve mapear.

Quando o sistema mostra warning sobre campo obrigatório do destino, está apontando um gap REAL no mapping — não ruído.

Filter Lookup permite extrair valor de um array source onde determinada condição é verdadeira. Caso típico: SAP pricing — pegar ConditionAmount onde ConditionType="PR00".

Passo a passo pra criar filter_lookup rule no drawer — útil pra SAP pricing, X12 qualifier-driven amounts, EDIFACT MOA com qualifier.

Como o Lefia verifica que a saída EDI (EDIFACT e X12) segue a spec real da mensagem — no mapping (quality gate) e em cada envio, antes do arquivo sair.

Quando o botão Publicar bloqueia por campos obrigatórios não mapeados, o toast vermelho oferece "Forçar ativação". Saiba quando usar.

A interlíngua de conceito: toda fonte vira conceito, o conceito vira qualquer destino. Sem tradutores N×N.

Quando um mapping falha, a mensagem agora aponta exatamente qual campo, qual transform, qual valor causou o problema, e (quando possível) sugere a origem certa.

Suporte a estruturas item-level: SAP to_Item.results[], linhas de pedido, e PARCEIROS como array (to_Partner[*] por PartnerFunction → NAD+BY/IV/PE automáticos). Ver também "Instâncias qualificadas".

Antes de ativar um mapping, o Lefia valida que todos os campos obrigatórios do formato de destino estão mapeados. Bloqueia ativação se faltar.

A sugestão de mapping roda em 3 camadas: heurística instantânea, embeddings semânticos com cache, e LLM só pros campos ambíguos. Reduz latência -70% e custo -75% em mappings grandes (SAP OData 300+ fields).

O que cada stat card no detalhe do mapping significa

Quando o destino pede um campo que no SAP mora noutro serviço, o mapeamento declara uma segunda leitura pela chave do documento e usa o resultado como campo da origem.

Segmentos como NAD, TAX, CUX (EDIFACT), N1 (X12) e E1EDKA1 (IDoc) só têm sentido com o qualificador. Quando o mapping gera um sem ele, o Lefia não envia e diz onde está a regra solta.

O botão "Sincronizar com catálogo" remove TODOS os fields obsoletos (inclusive já mapeados) e dispara a pirâmide IA pra repropor o mapping. Resolve banner stale persistente.

Todas as linhas e cards do editor de mapeamento usam o mesmo hover (verde signal a 10% claro / 15% escuro) — visual consistente, foco no dado.

Tirar máscara e conferir CNPJ/NCM, "se bloqueado OU eliminado", e o lote da execução no destino.

Pra IA propor mappings precisos, o catálogo do SAP precisa estar atualizado no banco. Rode "Testar conexão" sempre que a estrutura do SAP mudar.

Como ler os 6 cards do topo, o banner de cobertura e os chips de filtro: o que cada um indica e por que destino vem primeiro.

Aplica os campos do mapping num payload de exemplo e mostra o resultado convertido + erros/warnings, sem persistir nada.

Por que o catálogo destino agora mostra LIN.C212.C21201 em vez de C21201 plano, e como o mapping fica não-ambíguo.

Templates pré-prontos de mappings comuns (X12, EDIFACT, OData) que você pode aplicar em qualquer mapping pra acelerar setup.

Banner azul Ambiguidade de catálogo V3 no mapping editor — o que significa e como resolver.

Cada save com mudança em field_mappings snapshota a versão antiga. Inspecione versões anteriores no botão v{N} do mapping detail.

No mapping editor, o input do campo destino tem dropdown autocomplete que filtra os fields do catálogo do formato destino conforme você digita. Reduz erro de digitação e acelera mapping manual.

Autosave a cada 5s salva mudanças como rascunho (draft); pipeline só aplica quando você clica Ativar. Protege contra publicar mudanças não-revisadas.

Click numa row da view estruturada abre painel lateral à direita com editor full. Substitui a antiga view "Tabela".

Loops colapsáveis com chevron. Nested via parser auto. Counter agregado colorido. Botão Expandir/Colapsar tudo. Estado só na sessão.

Input de busca filtra source/dest field+desc. Cards de cobertura são clicáveis. Filtros se compõem por interseção. Chip + contador aparecem quando ativo.

Botão Sugerir IA roda 4 estágios em sequência. 4 chips visíveis desde o clique mostram progresso. Botão "Sugerir Regras" separado foi removido.

Source mostra OData V2 (toggle XML/JSON) e destino mostra EDIFACT/X12/IDoc serializado real, idêntico ao monitor.

Cards filtram a tabela ao clicar (não só decorativos). Badge IA% inline mostra confidence score por rule sugerida.

Reconhecer envelopes e por que não devem ser mapeados.

Por que o EDIFACT tem vários NAD/MOA iguais distinguidos por um código, e como o Lefia gera isso sozinho a partir do SAP — incluindo o chip ⌖ verde e o que fazer quando falta parceiro.

Botão que envia 2 payloads pra Claude e retorna diferenças estruturais, de campos e resumo narrativo.

Clique em qualquer cabeçalho de coluna para ordenar as mensagens; o padrão é a mais recente primeiro.

O detalhe da mensagem, o painel lateral e o Comparar mostram o original como chegou e o que foi entregue ao destino; o editor de mapping mostra uma pré-visualização.

Toggle cards/lista persistido no navegador, aplicado em /monitor, /mapeamentos, /admin/empresa, /reports.

Como ver qual mapping (e qual versão) produziu o mapped_data

A aba Mensagens: filtros, a lista no celular, abrir o detalhe e reprocessar.

Diff side-by-side pra debug.

Prove a entrega por loja e por dia: o total da origem, o que o Lefia enviou e o que o destino confirmou, em linhas, quantidade e valor.

Em "Dados originais", a seção "Recebido da origem" mostra os bytes que o parceiro ou o sistema de origem enviaram — sem formatar, sem reordenar — com content-type, tamanho, cabeçalhos e a conferência do sha256.

No detalhe da mensagem, a seção "Entregue ao destino" mostra os bytes exatos que foram ao parceiro, com content-type, cabeçalhos, resposta do destino e todas as tentativas.

Recebido, dados convertidos e entregue mostram a mesma coisa na mesma ordem: a barra de cópia no topo, a leitura estruturada para navegar e o texto exato, conferido pelo sha256.

Antes de cada envio, o Lefia valida o arquivo EDI contra a spec da mensagem. Se reprovar, ele não sai: a mensagem fica em erro com a lista do que corrigir.

Antes de enviar, o Lefia confere se os totais do arquivo fecham com as linhas e com o que a origem declarou. Divergência avisa ou barra o envio, conforme a integração.

Onde fica cada coisa no Monitoramento, as abas da empresa e como o período e o ambiente acompanham você entre as telas.

No monitor, selecione 2 mensagens para abrir o comparativo side-by-side com segments + mapped_data + status.

O que significa cada cor da Visão geral, o que entra em "O que precisa de você agora" e as faixas de envelhecimento de 2 h, 6 h e 3 dias.

O que cada aba da Análise responde, o Scorecard de parceiros, o prazo de entrega (SLA) e como abrir as mensagens por trás de cada número.

O resumo do período escolhido, com até 3 achados — cada um com o número, a comparação com o período anterior e o link para as mensagens.

O que significa "Consolidado por hora · atualizado há…" e por que o prazo de entrega aceita só alguns valores.

Como a lista de Mensagens conta o total do período e o que significa "mais de 50.000".

A IA explica por que a mensagem falhou, mostra a evidência e termina num botão: reprocessar, abrir o mapeamento ou copiar o texto pronto para quem precisa agir.

Por que o relatório de negócio agora mostra um card separado para parceiro dentro do item e parceiro em sub-linha.

Cada parte de uma lista que não é linha de item (sistólica e diastólica, cada dose, cada diagnóstico) vira uma linha de componente.

Acompanhamento das integrações em 3 sections: programados (próximas runs), executados (histórico real), manual (sob demanda). Badge Inicial mostra progresso da carga inicial.

Gerar link público pro parceiro fornecer credenciais sem precisar criar conta.

Checklist de critérios quantitativos para abrir e fechar uma PoC: volume, taxa de erro, latência, retry, duplicidade e observabilidade — e como provar cada um na plataforma.

Lista priorizada de features feitas, em andamento e bloqueadas.

Showcase animado na landing mostrando a cascata C1 → C2 → C3 do suggest-mapping. Não é um LLM jogado no problema — é inteligência em camadas.

O admin da empresa decide sobre o uso de IA (com registro) e qualquer usuário baixa os próprios dados; o admin exporta a empresa inteira.

O IP por onde o Lefia chama o seu sistema, a opção "Exige IP fixo de saída" e o que acontece quando a saída não está disponível.

O que o administrador decide sobre o uso de IA e sobre o suporte ver o conteúdo das mensagens.

Adicionar segunda camada via app autenticador (Google Authenticator, Authy, 1Password).

Super admins podem baixar um ZIP com todos os dados de uma empresa (tenant) — 1 JSON por tabela, formato estruturado, com manifest legal. Audit log registra cada export.

Receber notificação quando taxa de erro do tenant ultrapassar threshold.

O Lefia usa Row-Level Security (RLS) do Postgres pra garantir que um cliente nunca vê dado de outro. Isso é provado por suíte E2E que roda no CI a cada push.

O topo de clientes da Inteligência de Negócio mostra um código no lugar do nome por padrão. Uma política de privacidade por empresa decide se o nome sai em claro.

Documentação dos endpoints públicos /api/health e /api/ready para monitoramento externo.

Pipeline de redaction de PII (CPF, CNPJ, IBAN, email, cartão, DNI...) aplicado antes de enviar payload pra LLM.

Como ligar/desligar IA seletivamente por empresa, integração ou message type. Hierarquia, onde aplica e auditoria.