Painel Executivo

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

Visão Geral

Vendas

Geomarketing

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.

Região atendida — vendas de 12 meses e potencial da base de prospecção, consolidados por cidade

Mapa de calor · faturamento por cidade

Cidade	Clientes	Fat. 12m	Potencial	Capt.

Contas a receber

Aging · por faixa de dias vencidos

Inadimplência em atraso por vendedor

Por cliente atraso ≥ 4 dias 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

Mix, eficiência e casada — fonte: entradas (139) + pedidos + recebimentos + movimentos

Mix mensal · estoque × casadasó entradas que contam como compra

Compras por canal (12m)

Sell-through por coorte de compra% da qtd comprada p/ estoque vendida em 30/60/90 dias após a entrada

Coorte (mês da compra)	Qtd comprada	Valor (R$)	30d	60d	90d

Consumo por entrada capado na quantidade comprada (aproximação). Vermelho: 60d abaixo do limiar (). "Janela aberta" = ainda não passaram os N dias.

Painel da casadarecebida e não faturada = capital preso + cliente esperando

Fornecedores · lead time, OTIF e acuracidade

Variação de custo por item (180d)

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

Etiquetas

Inventário QR

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 em 3 viasfísico × NF × pedido · divergência vira pendência na Auditoria

Gerar etiquetasrolo térmico · 100 × 40 mm · gap de 4 mm é calibração da impressora

Por código

Por locação (vaga ou range)

1 etiqueta por item das vagas

Por NF de entrada

qtd sugerida = qtd da NF

Ajuste da impressora (deslocamento)

→ p/ direita (mm)
↓ p/ baixo (mm)

Cortou a esquerda → aumente o "→". Cortou embaixo → use "↓" negativo (ex.: -2). Fica salvo para todos.

Fila de impressão

Código	Descrição	Locação	Unid.	Etiquetas

QR abre o item no sistema (inventário/consulta) · barras Code128 do código do item

Leitor de etiquetas

InventárioConsulta

câmera desligada

Sessão de inventário

Código	Unid.	Contado

O leitor lê QR das etiquetas E código de barras. Inventário: escaneie → informe a quantidade (o mesmo item em vagas diferentes soma) → Finalizar grava as contagens na Auditoria — o que bateu sai conferido, divergência fica aberta para recontagem. Consulta: escaneie e a ficha abre na hora. A câmera exige HTTPS (ok no endereço do sistema).

Sugestão de Compras

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

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

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

Comissões · Apuração

Lucro bruto do mês (emissão da NF, todas as unidades) × percentuais por pessoa + adicional de liquidez + campanhas de marca.

Pessoa	Papel	Base lucro (R$)	Comissão (R$)	+ Liquidez	+ Campanhas	Ajuste (R$)	DSR (R$)	Fixo (R$)	Sal. bruto (R$)	Status

Clique na pessoa para ver a memória de cálculo · Ajuste (±) entra no total e fica gravado no fechamento

Comissões · Fechamentos

Histórico de fechamentos por mês e pessoa, com controle do que já foi pago.

Status

Colaborador

Mês	Pessoa	Papel	Base (R$)	Comissões (R$)	Ajuste (R$)	DSR (R$)	Fixo (R$)	Sal. bruto (R$)	Status

Fechamento é um retrato: recalcular a apuração depois não altera o que já foi fechado

Minhas despesas

Aprovação

Financeiro

Resumo por vendedor

Parâmetros

Despesas com clientes · Minhas despesas

Programa de autonomia: um limite mensal para agrados ao cliente (lanche na oficina, bebida, pequeno brinde comprado). Lance a despesa com o cupom fiscal no CNPJ da NAKI e o cliente atendido.

Lançamentos

Data	Cliente	Categoria	Descrição	Cupom	Valor	Status

Viabilidade Marketplace

Fat. × Margem · Vendedor

Fat. × Margem · Marca

Indicadores por mês

Relatórios · Viabilidade Marketplace

Itens com movimento no ano — base para anunciar no Mercado Livre, Amazon e afins.

Prévia

Código	Descrição	Marca	Tipo	ABC valor	ABC mov.	Qtd	Faturamento	Margem %	Preço médio	Saldo	Aptidão

O CSV exporta TODAS as colunas e todos os itens (não só a prévia), incluindo peso, unidade e última saída. Aptidão = heurística de margem, preço, regularidade e disponibilidade.

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)

Inventário rotativo: conferir a cada (dias)

Inventário rotativo: itens por dia

Por curva ABC

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

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

Fornecedores × canal (indústria ou distribuidora — classifique uma vez; alimenta o mix de compras)

Abra após a carga inicial de entradas (Sincronização).

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.

Entradas de compra · carga inicial (COMPRAS.md C1)

Importa as entradas por item (relatório 139) do início do ano até hoje, mês a mês. Rode uma vez após o deploy; depois o sync de 6/6h mantém sozinho (janela móvel de 7 dias). Ids estáveis: rodar de novo ou sincronizar no meio do dia nunca duplica.

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.

Parâmetros de comissão

Pessoas comissionadas (percentuais individuais sobre o lucro bruto + adicional de liquidez) e campanhas de bônus por marca. Ver COMISSOES.md.

Pessoas comissionadas

Campanhas de marca (bônus sobre faturamento)

Calendário de DSR · feriados e dias úteis

Painel Executivo

Gestão de Estoque

Como funciona

Normalizar endereço

Por código

Por locação (vaga ou range)

Por NF de entrada

Ajuste da impressora (deslocamento)

Sugestão de Compras

Pedidos de Compra

Atendimento · Carteira de Clientes

Agenda do dia

Funil de prospecção

Comissões · Apuração

Comissões · Fechamentos

Despesas com clientes · Minhas despesas

Lançamentos

Despesas · Aprovação

Despesas · Financeiro

Aprovadas · aguardando lote

Lotes autorizados

Despesas · Resumo por vendedor

Por cliente no mês

Despesas · Parâmetros

Relatórios · Viabilidade Marketplace

Faturamento × Margem por mês

Indicadores por mês

Parâmetros de compra

Por curva ABC

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

Fornecedores × canal (indústria ou distribuidora — classifique uma vez; alimenta o mix de compras)

Parâmetros do CRM

Carteira e status

Agenda / motor

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

Cadastros do CRM

Sincronização

APIs & integrações

Usuários & acessos

Parâmetros de comissão

Entrar no sistema

Painel Executivo

Gestão de Estoque

Como funciona

Normalizar endereço

Por código

Por locação (vaga ou range)

Por NF de entrada

Ajuste da impressora (deslocamento)

Sugestão de Compras

Pedidos de Compra

Atendimento · Carteira de Clientes

Agenda do dia

Funil de prospecção

Comissões · Apuração

Comissões · Fechamentos

Despesas com clientes · Minhas despesas

Lançamentos

Despesas · Aprovação

Despesas · Financeiro

Aprovadas · aguardando lote

Lotes autorizados

Despesas · Resumo por vendedor

Por cliente no mês

Despesas · Parâmetros

Relatórios · Viabilidade Marketplace

Faturamento × Margem por mês

Indicadores por mês

Parâmetros de compra

Por curva ABC

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

Fornecedores × canal (indústria ou distribuidora — classifique uma vez; alimenta o mix de compras)↻

Parâmetros do CRM

Carteira e status

Agenda / motor

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

Cadastros do CRM

Sincronização

APIs & integrações

Usuários & acessos

Parâmetros de comissão

Fornecedores × canal (indústria ou distribuidora — classifique uma vez; alimenta o mix de compras)