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.

Como abrir tickets de bug, dúvida, feature ou incidente — e acompanhar status.

Campo de busca typeahead em /admin, /edi-hub, /edi-hub/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 (admin, EDI Hub, detalhe de empresa, reports) 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.

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

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

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

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

O dropdown de formato de origem agora mostra só entities compatíveis com a versão da URL da conexão (V2 ou 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).

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.

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

Como rodar uma integração manualmente no Integration Lab

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.

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.

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

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.

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.

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 no EDI Hub permitem seleção múltipla. Ações em batch: pausar/reativar/excluir integrações; reprocessar mensagens. Botão "Selecionar todos" no header.

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

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

Como o Lefia verifica que a saída EDI (EDIFACT e X12) segue a spec real da mensagem — e por que violação estrutural bloqueia a ativação do mapping.

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

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

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 botão Publicar bloqueia por campos obrigatórios não mapeados, o toast vermelho oferece "Forçar ativação". Saiba quando usar.

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.

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

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.

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.

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

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.

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.

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.

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".

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

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.

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.

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

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

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

Toggle cards/lista persistido no navegador, aplicado em /monitor, /edi-hub, /admin/empresa, /reports.

Os 3 viewers (olhinho, comparar, ver saída) mostram source raw e destino convertido no mesmo padrão, com badge V2/V4.

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

Ver tudo passando em tempo real, filtrar e drilldown.

Diff side-by-side pra debug.

Como ver e validar o EDIFACT/X12/IDoc/JSON exato enviado ao destino.

Duas audiências, duas linguagens, dois lugares. Como o Lefia separa suporte técnico de gestão de negócio.

Métricas observáveis que ajudam a triar problemas — sem promessa de SLA contratual.

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

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.

Tour pelas seções de /relatorios/empresa/[id] — o que cada visualização mostra e como usar.

Card no topo de /relatorios com narrativa LLM em linguagem comum. Em 2-3 linhas você entende o que merece atenção.

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.

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.

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.