Painel Executivo

Visão consolidada do negócio — saúde operacional e comparativo entre unidades.

Visão Geral

Vendas

Contas a Receber

Fluxo de Caixa

DRE

Estoque

Compras

CRM

Indicadores

Comparativo entre unidadesBase da replicação: só se replica o que se mede

Unidade	SKUs	Valor em estoque	Em ruptura	% endereçado	A comprar (R$)	Divergências

Período

Evolução mensal · faturamento e lucro bruto

Venda por marca

Margem por marcaR$ bruto

Venda por tipo / segmento

Margem por tipo / segmentoR$ bruto

Top clientes — acumulado do anoclique no valor para ver por marca

Cliente	Mês (R$)	Acum. Ano (R$)

Concentração de clientes · curva ABC (Pareto)

Ranking de vendedores

Vendedor	Faturamento (R$)	Lucro bruto (R$)	Margem

Margem por cliente · top 10decisão comercial: margem, não só faturamento

Cliente	Faturamento (R$)	Margem (R$)	Margem %

Pedidos em aberto · por cliente

Cliente	Valor Aberto (R$)	Dias Aberto

Faturamento = documentos com situação concluída (não cancelados), pelo mês da emissão da nota fiscal. "VENDA ATACADO - NAKI/AOKI" é medido à parte (bloco no topo) e não entra no faturamento. O gráfico de evolução mensal sempre mostra o ano inteiro; os demais blocos seguem o período selecionado.

Contas a receber

Aging · por faixa de dias vencidos

Inadimplência em atraso por vendedor

Por cliente só com vencidos

Cliente	Em aberto (R$)	Vencido (R$)	Dias em atraso

clique no cliente = todos os títulos · clique no Vencido = só os vencidos

A receber imediato · dinheiro / cartão / depósito

Por cliente

Cliente	Em aberto (R$)	Títulos

Projeção de caixa · 13 semanas

Semana	Entradas	Saídas	Saldo	Acumulado

Aging — contas a receber

Aging — contas a pagar

DRE em cascata · acumulado do ano

Resultado mês a mês

Mês	Rec. líquida	Lucro bruto	Result. oper.	Líquido	Marg.

Composição de despesas

Demonstração do Resultado (DRE)valor · % da receita líquida

Valor em estoque por curva ABC

Matriz ABC × XYZvalor em estoque

Estoque parado · por tempo sem venda

Situação do endereçamento

Itens que mais saem (giro) só cobertura < 20 dias

Código	Descrição	Qtd vendida	Vendido (R$)	Saldo	Cobertura

Top itens parados · capital preso

Código	Descrição	Marca	Saldo	Valor parado (R$)	Sem venda

Prioridades de compra · ruptura com demanda

Código	Descrição	Curva	Valor (R$)

Sugerido a comprar · por curva

Carteira, cobertura e potencial — fonte: base de prospecção + movimentos + interações

Gap de potencial por segmento (R$/ano)

Funil de prospecção

Contexto de mercado · Vale da Celulose

Saúde do estoque

Financeiro & comercial · realizado × meta

Saúde financeira (DRE)

Saúde comercial

KPIs de apoio

OKRs da empresa

Gestão de Estoque

Posição de estoque, endereçamento e conferência — sincronizado do Microwork Cloud.

Estoque

Locações

Auditoria

Recebimento

Código	Descrição	Marca	Localização	Status	Saldo	Custo médio

Fonte: Microwork Cloud (consulta) · endereços normalizados pela plataforma

Disponível Indisponível Ocupada

Como funciona

Cada coluna tem 3 vagas em profundidade: X (frente), Y (meio) e Z (fundo). A X já entra disponível; Y e Z entram bloqueadas — clique numa vaga livre para alternar disponível/indisponível conforme couber fisicamente. Vagas ocupadas mostram o SKU ao passar o mouse.

Normalizar endereço

Digite como o estoquista cadastrou (texto livre) e veja o endereço canônico.

Aguardando…

Contagem às cegas: digite a quantidade contada e confirme. O item sai da lista quando bater; divergências permanecem para revisão.

Recebimento pendente · endereçamento sugeridoItens "SEM LOCAL" recebem sugestão automática

Sugestão de Compras

Lista priorizada gerada pelo motor (BigQuery) — o que comprar e quanto.

Curva

Marca

Decisão

	Código	Descrição	Marca	Curva	Local	Saldo	Dem./sem	ROP	Sugestão	Valor (R$)

Fonte: motor de sugestão (BigQuery) · atualizado semanalmente

Pedidos de Compra

Pedidos gerados e acompanhamento de atendimento (baixa automática pela expectativa de saldo).

Status

Nº pedido	Data	Marca / representante	Unid.	Itens	Atendimento	Valor (R$)	Status

Atendimento calculado pelo saldo atual vs. saldo no momento do pedido

Atendimento · Carteira de Clientes

Base de prospecção + histórico do ERP, unificados por CNPJ (radical). Clique no cliente para abrir a ficha 360º.

Segmento

Status

Curva

Carteira

Cliente	Vendedor	Segmento	Município	Frota	Últ. compra	Compras 12m (R$)	Ciclo	Status	Curva

Compras casadas por CNPJ (radical) · respeitam a unidade selecionada

Agenda do dia

Contatos sugeridos pelo motor de CRM — quem contatar, por quê e o que oferecer.

Funil de prospecção

Estágio derivado dos dados (compras + interações): prospect → contatado → orçamento → cliente. Recorte por campanha.

Segmento

Município Frota mínima

Parâmetros de compra

Regras que o motor de Sugestão de Compras usa para calcular o que comprar.

Período de revisão (semanas)

Lote mínimo de compra (un)

Dias sem venda p/ "parado" (estoque)

Por curva ABC

Curva	Nível de serviço	Lead time (semanas)

Lead time por marca (opcional — sobrepõe a curva)

Parâmetros do CRM

Regras do motor de CRM e da carteira (doc config/crm). O motor usa na próxima rodada; a carteira reflete na hora.

Carteira e status

Cliente "ativo" até (dias s/ compra)

"Inativo" a partir de (dias)

Volta ao bolsão após (dias s/ compra e s/ contato)

Meta de contatos por dia

Agenda / motor

Antecedência do contato (dias antes do dia provável)

Urgência mínima p/ entrar na agenda

Máx. de sugestões por unidade

Prospects por semana

Ciclo mínimo (dias)

Ciclo máximo (dias)

Afinidade: mín. de compradores do par

Supressão após parecer (dias fora da agenda)

Contatado

Adiado

Descartado

Cadastros do CRM

Sincronização

O guia de "qual botão clicar": três níveis de atualização, do mais profundo ao mais leve.

1 · Sincronizar com o ERP (Microwork)

O botão-mestre. Consulta o ERP e regrava: estoque (saldos/locais), movimentos (vendas do ano, com CNPJ), pendências de auditoria e o score de crédito do CRM. Roda sozinho a cada 6h — use manualmente após lançamentos importantes no ERP ou depois de um deploy de functions.

2 · Botões "↻ Atualizar" das telas

Não consultam o ERP — apenas recarregam o cache da sessão daquela tela a partir do Firestore (as abas ao vivo — Vendas/Receber/DRE — reconsultam o ERP na 1ª abertura). Use quando uma tela parecer desatualizada. O botão ao lado limpa todos os caches de uma vez.

3 · Motores de inteligência (Python — rodar na máquina, semanal)

Recalculam as sugestões de Compras e do CRM (agenda). Sequência, na raiz do projeto:

python sugestao\carregar_bigquery.py     # 1. leva o histórico ao BigQuery
set PUSH_FIRESTORE=1
python sugestao\motor_compras.py         # 2. sugestões de compra
python crm\motor_crm.py                  # 3. agenda do CRM

Sempre rode o passo 1 antes dos motores (senão eles leem dados velhos). Detalhes: CRM.md §10 e SUGESTAO.md.

APIs & integrações

De onde vem cada dado do sistema. Endpoint único do Microwork: POST https://microworkcloud.com.br/api/integracao/terceiro (token Bearer no Secret Manager · Functions em southamerica-east1).

Relatório (Microwork)	O que traz	Alimenta	Modo
151 · Estoque	Saldo disponível, localização, custos, marca	Estoque, Locações, Auditoria, Sugestão de Compras	Sync 6/6h
131 · Movimentação	Vendas por item: cliente (CNPJ), vendedor, valores, NF, cancelamentos	Vendas, CRM (ciclos, carteiras, afinidade), ABC, Auditoria	Sync 6/6h + ao vivo (KPIs/Vendas)
223 · Contas a Receber	Títulos do ano: em aberto, vencidos, dias de atraso	Dashboard Receber, score de crédito (gravado no sync), ficha do CRM	Ao vivo + crédito no sync
229 · Contas a Pagar	Títulos a pagar por vencimento	Fluxo de Caixa	Ao vivo
401 · Diário contábil	Lançamentos (receita, CMV, despesas)	DRE	Ao vivo

Outras integrações: Firestore (operação em tempo real: itens, movimentos, CRM, crédito, config) · BigQuery dataset naki (camada analítica dos motores Python) · Base de prospecção (planilha de veículos → crm/importar_prospeccao.py → coleções clientes/veiculos). Mapa técnico completo: HANDOFF.md §8.

Usuários & acessos

Cadastro de logins, papéis (Master · Supervisor · Vendedor), vínculo com os vendedores do ERP e liberação de recursos e empresas por usuário.

Entrar no sistema