Ir para o conteúdo
clabor Manual do ERPia

Gestão, relatórios e IA na retaguarda#

O que os números pedem de decisão: painel do dia, fila de trabalho, direção, faturamento, análises, relatórios, margem, risco e as áreas de IA.

Antes de começar — as permissões variam por tela: retaguarda.painel_ver (painel e ideias), ia.trabalho_ver (Meu trabalho), ia.direcao_ver (Direção), retaguarda.faturamento_ver, retaguarda.analitico_ver, relatorios.executar (Relatórios), retaguarda.relatorio_ver (margem, cesta, concentração, recompra, Ações da IA) e ia.analytics_consultar (alertas, riscos, curva de fornada, previsão).

Como usar o Painel do dia#

  1. Abra Visão geral > Painel do dia. Ele cumprimenta você pelo nome e abre no que exige atenção.
  2. Use os chips Precisa de você e A IA já cuidou para separar o que depende de decisão humana do que já foi resolvido.
  3. Percorra os cartões e resolva o que está em Precisa de você.
  4. Use os atalhos da barra de ação para ir direto às pendências do dia: Entradas pendentes, NFC-e travadas, Atenção do gestor e Perguntar à IA.
  5. Abra Novidades e correções (pelo sino) para ver o que entrou em cada atualização.

Resultado esperado — você começa o dia sabendo o que fazer, sem garimpar menu.

Se algo der errado

SintomaCausa provávelO que fazer
O painel abre vazioNenhuma pendência no seu escopo, ou falta loja vinculadaConfira suas lojas em Usuários
O painel não cumprimenta pelo nomeO shell ainda não carregou a sessãoRecarregue a página
Um atalho leva a uma tela que eu não vejoFalta a permissão da tela de destinoVeja a permissão no Mapa das telas

Como trabalhar a fila do Meu trabalho#

  1. Abra Visão geral > Meu trabalho.
  2. Busque por prioridade, motivo ou próxima ação, ou percorra a fila na ordem.
  3. Abra o item e leia o que é, por que apareceu e qual é a próxima ação.
  4. Execute a ação indicada — o ERPia encontra, explica e prepara; você confirma antes da execução, e a auditoria comprova o resultado.
  5. Volte à fila: o item resolvido sai dela.

Resultado esperado — a fila encolhe e o que sobra tem motivo e próximo passo claros.

Se algo der errado

SintomaCausa provávelO que fazer
Fila vazia e eu sei que há pendênciaA pendência é de outra pessoa/permissãoVeja quem tem a permissão da tela de origem
Não consigo executar a ação sugeridaFalta o direito específico da ação (não o da tela)Peça a permissão da ação ao administrador

Como usar a Direção da Empresa#

  1. Abra Gestão e análises > Direção da Empresa.
  2. Leia a proposta estruturada e as evidências que a sustentam.
  3. Aprove explicitamente a direção.
  4. Depois de aprovada, ela orienta o Meu trabalho.

Resultado esperado — a direção aprovada aparece refletida nas prioridades do dia.

Se algo der errado

SintomaCausa provávelO que fazer
Não consigo aprovarFalta o direito de aprovar a direçãoPropor, aprovar e ver são permissões diferentes (ia.direcao_propor, ia.direcao_aprovar, ia.direcao_ver)
As prioridades não mudaramA direção não foi aprovadaAprove explicitamente

Como ler o Faturamento#

  1. Abra Gestão e análises > Faturamento (ou o atalho Faturamento em Financeiro — é a mesma tela).
  2. Escolha o período (o padrão é o dia).
  3. Leia a receita por loja, forma de pagamento, hora e caixa.
  4. Use as quebras para responder: qual loja vendeu mais, qual forma de pagamento domina, qual o pico do dia.

Resultado esperado — você entende de onde veio a receita do período.

Se algo der errado

SintomaCausa provávelO que fazer
Venda faltando no totalVenda ainda não sincronizada do caixaConfira o caixa em Checkout — caixas
Números diferentes do PDVPeríodo ou loja diferentesIguale o filtro dos dois lados

Como analisar as vendas#

  1. Abra Gestão e análises > Analítico de vendas.
  2. Escolha o período (o padrão é o dia).
  3. Percorra os chips Classe A, Classe B e Classe C para ver a curva ABC do que vende.
  4. Combine com a Margem por produto: faturamento e lucro não são a mesma lista.

Resultado esperado — você sabe o que puxa o faturamento e quais itens são a cauda longa.

Como criar um relatório#

  1. Abra Gestão e análises > Relatórios.
  2. Clique em Novo relatório.
  3. Aba 1. Fonte: escolha a fonte publicada. O rótulo mostra o domínio e o grão da fonte — o grão diz o que cada linha representa.
  4. Aba 2. Campos e métricas: escolha as dimensões e as métricas. Métricas não aditivas no recorte não podem ser somadas — a tela indica a aditividade de cada uma.
  5. Aba 3. Filtros e período: aplique os filtros e o período.
  6. Aba 4. Visualização e salvar: escolha a visualização (inclusive “Sem gráfico (só a tabela)”), veja a prévia amostral e salve.
  7. Use os chips Todos, Meus e Compartilhados comigo para achar relatórios depois.
  8. Para reaproveitar, use Duplicar; para levar o resultado, use Baixar CSV, Baixar XLSX ou Baixar PDF; para volumes maiores, Exportar em 2º plano e acompanhe em Exportações.

Resultado esperado — o relatório fica salvo na biblioteca, com a prévia conferida antes de compartilhar.

Se algo der errado

SintomaCausa provávelO que fazer
Não consigo salvarFalta a permissão de definir relatórios (relatorios.definir)Peça o direito; executar e definir são permissões separadas
Não consigo compartilharFalta relatorios.compartilharCompartilhar decide o acesso de outra pessoa — permissão própria
Não consigo baixarFalta relatorios.exportarPeça o direito de exportar
Troquei a loja e voltei para a bibliotecaO contexto do relatório não sobreviveu à troca de filtroAbra o relatório de novo pelo item da biblioteca
Quem recebeu vê números diferentesRecorte de loja/permissão de quem recebeConfira a loja do destinatário

Como ler a Margem por produto#

  1. Abra Gestão e análises > Margem por produto.
  2. Escolha a Loja, a Visão e o período (o padrão é o mês atual).
  3. Percorra o ranking por margem — e não por faturamento.
  4. Use os chips Classe A, Classe B, Classe C e No prejuízo.

Como funciona por dentro — a classe A de margem é feita de poucos produtos que fazem a maior parte do lucro; produto sem custo cadastrado fica fora da conta.

Resultado esperado — você sabe quais itens sustentam o lucro e quais vendem no prejuízo.

Se algo der errado

SintomaCausa provávelO que fazer
Produto importante fora da listaSem custo cadastradoCadastre o custo e reabra a tela
“No prejuízo” com preço que parece bomCusto, imposto ou taxa de cartão comem a margemRevise na Precificação

Como usar a Cesta de compras#

  1. Abra Gestão e análises > Cesta de compras.
  2. Filtre por produto.
  3. Leia os pares comprados junto (lift e confiança).
  4. Use para decidir sortimento, oferta combinada e encarte.

Resultado esperado — você descobre combinações reais de compra (o que vai junto no carrinho) e usa isso em promoção e encarte.

Como ler a Concentração de vendas#

  1. Abra Gestão e análises > Concentração de vendas.
  2. Confira o período (o padrão é o mês atual).
  3. Leia quanto cada marca, categoria e setor representa do seu faturamento.
  4. Use na negociação com fornecedor: concentração alta é poder de barganha.

Como usar a Recompra B2B#

  1. Abra Gestão e análises > Recompra B2B.
  2. Escolha a Loja.
  3. Filtre por CNPJ ou use os chips Em atraso e Em dia.
  4. Ligue para quem está Em atraso: são os clientes que passaram da própria cadência de compra.

Como funciona por dentro — a tela olha os clientes que compram com CNPJ na nota e calcula a cadência de recompra de cada um; quem passou da cadência aparece em atraso.

Como tratar um alerta de margem#

  1. Abra Gestão e análises > Alertas de margem (ou o atalho Atenção do gestor no painel).
  2. Use os chips Em aberto, Severidade alta e Resolvidos.
  3. Abra o alerta e leia o preço sugerido.
  4. Aplique o preço sugerido ou trate o caso (custo, promoção, descontinuação).

Resultado esperado — o alerta sai de Em aberto e a margem do item volta ao alvo.

Se algo der errado

SintomaCausa provávelO que fazer
“sem permissao para aplicar preco”Falta retaguarda.produto_gerenciarPeça o direito no seu perfil
“acao invalida”Versão de tela diferenteAtualize a página
Apliquei e o caixa não mudouCarga PDV não enviadaEnvie em Carga PDV

Como ler Riscos e perdas#

  1. Abra Gestão e análises > Riscos & perdas.
  2. Percorra os chips Caixa, Validade, Margem e FEFO.
  3. Trate na ordem: dinheiro saindo (caixa), perda iminente (validade), margem fora do alvo e lote que precisa girar primeiro (FEFO).

Resultado esperado — você protege dinheiro antes de o problema crescer.

Como enviar uma ideia ou problema#

  1. Abra Gestão e análises > Ideias e melhorias.
  2. Clique em Enviar ideia ou problema.
  3. Escolha O que você quer enviar (ideia de melhoria ou problema).
  4. Dê um Título curto (opcional) e escreva Conte o que precisa ou o que aconteceu.
  5. Escolha Quem pode ver: comunidade de clientes (sem identificar a sua empresa) ou somente a sua empresa e o time 3A.
  6. Se anexar Captura ou evidência, marque a autorização de análise e confirme que o arquivo não contém senha, token, PIN ou dado pessoal desnecessário.
  7. Envie e acompanhe pelos chips Em alta, Recentes, Minhas, Roadmap, Problemas e Atualizações.
  8. No cabeçalho, a ação de E-mail liga ou desliga os avisos por e-mail.

Resultado esperado — a solicitação entra na fila da 3A e a resposta oficial aparece no próprio item.

Se algo der errado

SintomaCausa provávelO que fazer
“o anexo não pode ser lido; escolha o arquivo novamente”Arquivo corrompido ou formato não aceitoReenvie o arquivo
A solicitação foi criada sem o anexoFalha ao guardar o arquivoA solicitação existe; anexe de novo depois
“escreva um comentário, anexe uma evidência ou avalie a entrega antes de enviar”Você tentou enviar uma resposta vaziaEscreva o comentário ou avalie

Como usar a Governança da IA#

  1. Abra Administração > Governança da IA.
  2. Percorra os chips: Todos, Agentes, Agenda, Camadas da IA, Diagnósticos, Governança da IA, Observabilidade, Treinamento, Correções, Maturidade, Telas, Qualidade, Dicionário e Conhecimento.
  3. No cabeçalho, use a ação de trabalho automático para ligar/desligar a execução automática e a de verificar agora para rodar as vencidas sob demanda.
  4. Para pedir pacotes de processamento, abra a ação de linha, informe a Quantidade de pacotes e envie a solicitação.

Resultado esperado — você sabe o que a IA está fazendo, o que está agendado e o que precisa de intervenção humana — tudo auditável.

Se algo der errado

SintomaCausa provávelO que fazer
“informe uma quantidade valida de pacotes”Quantidade vazia ou inválidaInforme um número válido
“agenda da IA indisponivel”Agenda não respondeuTente novamente
“sessao de usuario invalida”Sessão expiradaEntre novamente
Uma aba não abre para mimA área tem leitura e operação separadasPeça a permissão da operação

Como usar as Ações da IA#

  1. Abra Administração > Ações da IA.
  2. Percorra a lista de ações que a IA sabe executar.
  3. Clique numa ação para ver o que muda antes de aplicar (prévia).
  4. Confirme a execução — cada ação passa pelo mesmo portão: prévia → confirmação → aplicação.
  5. Abra o histórico para ver o que a IA já aplicou.

Resultado esperado — nada é aplicado sem prévia e confirmação, e o histórico mostra o que foi feito.

Se algo der errado

SintomaCausa provávelO que fazer
A ação não apareceFalta a permissão da açãoPeça o direito da ação específica
Apliquei e não vi efeitoA ação depende de outra etapa (ex.: carga do PDV)Veja a próxima ação indicada na própria tela