# Manual de Utilização — para humanos

Guia para quem usa o sistema **Versus — Custos e Precificação** no dia a dia. As seções seguem o **menu da esquerda, na ordem em que as telas são usadas**: do cadastro até a DRE.

> **Primeira vez?** Leia a seção 1 (como o sistema pensa) e a seção 2 (roteiro do começo ao fim). Depois consulte a tela de que precisar. Para saber **o que já está pronto e o que falta** em qualquer momento, abra **Planejamentos** — a lista de etapas leva você direto à tela de cada pendência.

## 1. Como o sistema pensa

**O objetivo:** dizer, para cada produto, **quanto custa produzir**, **quanto cobrar** (para cobrir custos, despesas, impostos e a meta de lucro) e **qual resultado** a empresa terá, no total e em cada canal de venda.

**Conceitos que aparecem em todas as telas:**

- **Planejamento** — o "caderno" de trabalho (ex.: *2026 Vrs. 01*). Cada Planejamento guarda os seus próprios cadastros, formulações, despesas, impostos, Centros e quantidades. Para testar uma ideia, **crie uma nova versão a partir de outra** e mude nela; compare depois. O Planejamento em uso aparece no alto da tela.
- **Produto cabeça (Tabela de Preços)** — produto acabado ou de revenda que a empresa vende e que tem preço. O custo é calculado **a partir das cabeças** e da estrutura que elas usam (intermediários, insumos, embalagens). Semiacabados só entram se algum produto os usa.
- **Formulação (estrutura do produto)** — a "receita": quanto de cada insumo/intermediário e **quantas horas** de mão de obra, máquina, instalação e outros cada lote consome.
- **Elementos de custo** — Mão de obra, Instalações, Máquinas e Outros. Cada um tem **custo por hora** (custo mensal ÷ horas úteis) e capacidade. Horas úteis **não usadas** viram **ociosidade**, que o sistema distribui entre os produtos que usam aquele tipo de elemento.
- **Centro de Custo × Centro de Resultados** — *Centro de Custo* é onde o gasto nasce (um departamento). *Centro de Resultados* é onde a venda acontece (um canal ou recorte comercial), com despesas, desconto e destino das vendas próprios.
- **Primária × Centros** — a **Precificação Primária** é o resultado que a empresa almeja, único. Cada **Centro de Resultados** parte dela e soma os seus acréscimos; a **DRE Consolidada** soma tudo.
- **Vigência por mês** — mudanças de custo valem **a partir de um mês** (campo *Atualizado em*, formato AAAA-MM). O custo de cada mês usa o preço da época, e o histórico guarda o anterior.

## 2. Roteiro do começo ao fim

Marque conforme avança (a tela **Planejamentos** faz esse acompanhamento por você):

1. **Escolha ou crie o Planejamento** (alto da tela).
2. **Cadastros:** Plano de Contas e Centros de Custo; **Direcionadores de Custos** (critérios de rateio).
3. **Insumos e Embalagens** com custo de compra; **Unidades e Conversões**, se usar unidades fora de kg/g/l/ml.
4. **Elementos de Custos e Capacidades:** colaboradores, instalações, máquinas e outros, com os gastos mensais e as horas úteis.
5. **Formulações:** produtos e suas estruturas; marque na **Tabela de Preços** os que são cabeça.
6. **Planejamento de Produção:** quantidade a produzir de cada cabeça por mês.
7. **Custo dos Produtos:** clique em *Calcular custos*.
8. **Despesas** (fixas e variáveis) e **Impostos** (créditos, alíquotas, destino da venda).
9. **Precificação e Resultado Primário:** defina a Meta de Lucro, confira o **rateio das despesas fixas** e os preços e, ao concluir, **trave a primária** (*Concluir e liberar Centros*).
10. **Centro de Resultados:** só abre com a primária travada; cadastre os canais, as despesas adicionais e as quantidades de cada um.
11. **DRE Consolidada** e **Premissas:** leia o resultado e registre as premissas.
12. **Histórico de Planejamento:** congele uma "foto" para comparar depois.

> **Atalho para quem já tem as planilhas:** a tela **Importação** carrega cadastros, formulações, despesas e impostos de uma vez (seção 4.7). Depois é só calcular.

## 3. Navegação e recursos comuns

- **Menu lateral:** os grupos são *Cadastros 01*, *Cadastros 02*, *Planejamento e custos*, *Despesas e impostos*, *Precificação e resultado*, *Ajuda* e *Administração* (só administradores). O botão do topo recolhe o menu. **Planejador de Estoques** e **Planejador de Compras** aparecem como *em breve*: ainda não estão disponíveis.
- **Seletor de Planejamento:** no cabeçalho. A estrela marca o **oficial**. Trocar de Planejamento recarrega todas as telas.
- **Filtros:** o botão **Filtros** (cabeçalho) abre o painel de busca e filtros da tela atual.
- **Avisos no cabeçalho:** uma pílula **"Alocado acima da produção (N)"** aparece quando os Centros de Resultados somam mais do que a produção de algum produto; clique para corrigir.
- **Linhas de subtotais:** as tabelas mostram subtotais do que está filtrado.
- **Autoria:** cada custo guarda **quem** digitou e **quando**; o administrador vê o **Log de Ações**.
- **Sua conta:** no canto inferior do menu, troque a senha ou saia.

## 4. As telas, na ordem do menu

### 4.1 Planejamentos
**Para que serve:** escolher o Planejamento, criar versões, comparar e **acompanhar o que está pronto e o que falta**.

**O que você vê**
- A lista de Planejamentos (nome, versão, criação) com as marcas **oficial** e **em uso**.
- O cartão **"Situação de … : o que está pronto e o que falta"**: barra de progresso e as etapas, agrupadas na ordem de uso.
- **Comparar dois Planejamentos** (quando há mais de um).

**Como ler a situação**
| Estado | Significado |
| --- | --- |
| **Pronto** (verde) | Há o que a etapa precisa |
| **Falta algo** (âmbar) | Há dados, mas faltam itens — clique na etapa para ver a lista |
| **Por fazer** (vermelho) | Nada feito ainda |
| **Aguarda etapas anteriores** (cinza) | Depende de outra etapa (ex.: preço depende de custo e Meta de Lucro) |
| **Opcional** | Não é obrigatória (ex.: Histórico) |

O botão **Ir para a tela** leva à tela onde se resolve. **Verificar de novo** atualiza depois de você corrigir.

**Passo a passo**
1. **Nova versão a partir de…** — escolha o Planejamento de origem, o ano e o nome; ele copia tudo e passa a ser o Planejamento em uso.
2. **Trabalhar neste** — troca o Planejamento em uso.
3. Estrela — marca como **oficial** (só um por vez). Lápis — renomeia. Lixeira (administrador) — **exclui o Planejamento e todos os dados dele**; não dá para desfazer.
4. **Comparar** — escolha A (base) e B e veja as diferenças B − A.

### 4.2 Cadastros (Plano de Contas, Centros de Custo e Instalações)
**Para que serve:** a base contábil. O **Plano de Contas** (receitas, custos, despesas, impostos) é uma árvore; **contas sintéticas** só agrupam, **analíticas** recebem lançamentos. **Centros de Custo** são os departamentos onde os gastos nascem (marque *Produtivo (custo)* para os que produzem).

**Passo a passo**
1. Abas **Plano de Contas** e **Centros de Custo**.
2. **Nova conta raiz**, ou **Novo filho** na linha de um nó — o código hierárquico é montado pela árvore.
3. **Editar**, **Inativar** (some das escolhas, sem perder histórico) ou **Excluir** (só se não estiver em uso; a coluna *Em uso* mostra quantos usos há).
4. **Expandir tudo / Recolher tudo** ajudam a navegar.

> Dica: se o seu plano já existe em planilha, use a **Importação** em vez de digitar.

### 4.3 Direcionadores de Custos
**Para que serve:** definir **como as despesas fixas são divididas entre os produtos**. A estrutura é **Área → Macroprocesso → Processo → Atividade → Direcionador**. O Direcionador tem uma **base** de medida:
- **Tempo** — horas do roteiro × volume;
- **Quantidade produzida**;
- **Custo primário** — custo do produto × volume.

**Passo a passo:** **Nova área**; em cada nível use *Macroprocesso*/*Processo*/*Atividade*/*Direcionador* para criar o filho; **Editar** e **Excluir** pelos ícones. As **Atividades** também são as "etapas" das formulações (ex.: *Pesagem de Insumos*, *Mistura*, *Envase*).

### 4.4 Insumos e Embalagens
**Para que serve:** matérias-primas e embalagens com **preço de compra, frete, IPI e ICMS**. Cada reajuste guarda o preço anterior no histórico; o custo de cada mês usa o preço da época.

**Passo a passo**
1. **Novo insumo** — código, nome, tipo (ingrediente ou embalagem), unidade, preço, frete, impostos e o mês de vigência.
2. Na linha: **Histórico**, **Editar dados** (nome/tipo), **Alterar preço** (cria uma nova versão a partir do mês informado) e **Excluir**.
3. A coluna *Custo final* mostra o preço mais frete; *receita(s)* diz em quantas formulações o insumo é usado.
4. Itens que vieram do TOTVS são atualizados pelas cargas da **Importação** (seção 4.7).

**Créditos de imposto do item** (ICMS, CBS, IR/CSLL e alíquota própria) se marcam no próprio cadastro ou na tela **Impostos**.

### 4.5 Unidades e Conversões
**Para que serve:** cada insumo e produto tem uma **unidade base**. Gramas ↔ quilos e mililitros ↔ litros convertem sozinhos; para as demais (caixa, pacote, dúzia, densidade…) cadastre **quanto vale 1 da unidade na unidade base** do item.

**Passo a passo:** escolha o tipo (*Insumo* ou *Produto*), o item, e use **Cadastrar conversão** informando a unidade e o fator. A formulação, o custo e o cálculo dos volumes usam esses fatores; sem a conversão, a linha dá erro de unidade.

### 4.6 Elementos de Custos e Capacidades
**Para que serve:** cadastrar o que "custa por hora": **Mão de Obra, Instalações, Máquinas e Outros**, com os **gastos mensais**, o **custo/hora** e a **ocupação** (horas do roteiro × horas úteis).

**Abas:** *Mão de Obra*, *Instalações*, *Máquinas*, *Outros*.

**Passo a passo (exemplo: mão de obra)**
1. **Nova mão de obra** — código da folha, nome, cargo, Centro de Custo, **classificação (fixo ou variável)**, horas contratadas e absenteísmo.
2. **Alterar gastos** — lance os gastos do mês por conta do Plano de Contas (salários, encargos, benefícios…): *Desembolso* e *Retenção*. Eles formam o custo total e o **custo/hora**.
3. A visão **Colaboradores** lista as pessoas; **Grupos Depto-Cargo (alocação e capacidade)** mostra os grupos que o sistema forma sozinho (Centro de Custo × cargo × classificação). **É o grupo — não a pessoa — que se aloca aos produtos**, e é nele que se vê horas úteis, utilização e ociosidade.
4. **Instalações** formam uma árvore (sala, galpão…); **Máquinas** e **Outros** (qualquer recurso com custo/hora, como utilidades) funcionam como as demais, com *horas úteis/mês*.
5. Os filtros de **utilização** (Sobrecarga acima de 100%, Em uso, Sem uso) ajudam a achar ociosidade ou gargalo.

**Classificação:** *Fixo* — o custo existe mesmo sem produzir; *Variável* — acompanha o uso. Isso define o que entra no custo variável do produto.

### 4.7 Importação
**Para que serve:** carregar dados em lote. **Só administradores gravam**; todos veem a conferência. Cada carga mostra uma **prévia** e **só grava ao aplicar**.

**As quatro cargas**
1. **Cadastro de Produtos (TOTVS)** — aba *Totvs_Cad_Prod* da NDC: atualiza o nome dos itens que vieram do TOTVS e lista os itens ainda sem estrutura.
2. **Estrutura de Produtos (TOTVS)** — cria/atualiza produtos, insumos e estruturas; mostra a **conferência** com as formulações do sistema.
3. **Planilha NDC (custos)** — atualiza os custos dos itens.
4. **Planilha de Custeio Geral** — o modelo completo do sistema (veja abaixo).

**Planilha de Custeio Geral — passo a passo**
1. Baixe o **modelo**. A versão **preenchida** já traz os dados atuais do Planejamento — ideal para editar e subir de volta.
2. Preencha **só as abas que quer atualizar**. **Aba vazia ou apagada não muda nada**; célula vazia também não altera o registro. A importação **nunca apaga** — com uma exceção: o **Mix de Destinos** de um Centro substitui o anterior (e precisa somar 100%).
3. Abas: Plano de Contas, Centros de Custo, Mão de obra, Instalações, Máquinas, Outros, Gastos, Áreas, Macroprocessos, Processos, Atividades, Direcionadores, Insumos, Produtos, Roteiros (estruturas), Centros de Resultados, Planejamentos, Volumes, Despesas, Alíquotas, ICMS Destinos, ICMS Compras, Mix de Destinos, Desenvolve-BA e Premissas. Os créditos de imposto são colunas dentro de cada aba (Insumos, Gastos, Despesas, Produtos de revenda).
4. Percentuais: digite **18%** (ou formate a célula como %). Mês de vigência: **AAAA-MM**.
5. **Validar** mostra o que seria criado/atualizado e **os erros por linha**. Corrija a planilha e valide de novo. A gravação é **tudo-ou-nada**: com qualquer erro, nada é gravado.
6. **Aplicar** grava. Depois, recalcule em **Custo dos Produtos**.

**Cargas anteriores** lista o histórico das aplicações.

### 4.8 Formulações (Estrutura dos Produtos)
**Para que serve:** montar e ajustar a "receita" de cada produto: **insumos e intermediários** e as **alocações de elementos de custo**, em uma árvore.

**Como a tela é organizada**
- A **lista de produtos** fica no painel **Filtros**: busque por código/nome, filtre por tipo e use **"Todos os produtos (não só os da Tabela de Preços)"** para ver o catálogo inteiro. Os botões **Marcar os N da lista / Desmarcar** colocam produtos na Tabela de Preços em lote.
- Ao escolher um produto: cabeçalho com **tipo, rendimento, produção estimada, custo do lote e custo unitário** (e o variável) e as abas **Árvore da formulação** e **Histórico**. Use **Custo em (mês)** para ver o custo de outro mês.
- **Novo produto**, **Editar**, **Duplicar**, **Excluir**; **Na Tabela de Preços / Retirar da Tabela de Preços** liga ou desliga o produto como cabeça.

**A árvore tem dois ramos**
1. **Insumos** — por etapa (Atividade): item, quantidade, custo unitário, custo e vigência. **Insumo / intermediário em nova etapa** adiciona linhas. Um intermediário mostra o **custo total** e o atalho **Abrir** para a formulação dele.
2. **Alocações de Elementos de Custo (Direcionadores)** — por Atividade → tipo (Mão de obra, Instalações, Máquinas, Outros) → recurso, com **horas por bacia** (um lote) e o direcionador. **Elemento** adiciona; **Copiar de outro produto…** e **Aplicar a vários produtos…** replicam alocações.

**Alterar ou encerrar uma linha** — ícones *Alterar linha* e *Encerrar linha*. Alterar cria uma nova versão **a partir do mês informado**; encerrar a retira daquele mês em diante (o passado fica). Linhas vindas do **TOTVS** são somente leitura.

**Conceitos:** *bacia* é o que a formulação processa; *perda* é evaporação/desperdício; *rendimento real* = bacia × (1 − perda).

### 4.9 Planejamento de Produção
**Para que serve:** informar **quanto se pretende produzir por mês** de cada produto da Tabela de Preços. Esse volume é a base da **capacidade, ociosidade, rateio de despesas e créditos de imposto**.

**Abas**
- **Produção** — para cada produto: *Produção/mês* (você digita), *Previsto nos Centros*, *Diferença*, *Calculado pela estrutura* e *Total a produzir*. Os **intermediários (PI)** não se digitam: são calculados pela estrutura a partir dos acabados.
- **Volumes por Centro de Resultado** — quanto cada Centro vai vender de cada produto.

**Regra de ouro:** a soma das quantidades dos Centros deve **fechar com a produção**. O Centro **"Produção a alocar"** recebe a diferença; se os Centros somarem **mais** que a produção, aparece o aviso no cabeçalho e você pode usar o ajuste para igualar a produção aos Centros.

### 4.10 Custo dos Produtos
**Para que serve:** calcular e ler o **custo unitário** das cabeças. Um único cálculo por Planejamento alimenta preço, DRE e Planejamento.

**Passo a passo**
1. Em **Parâmetros e resumo do custeio**, escolha a **competência** (mês) e clique **Calcular custos**. Refaça sempre que mudar custos, formulações, produção, despesas ou impostos.
2. O histórico de cálculos (competência mais recente primeiro) e **Entradas usadas** mostram com quais valores cada cálculo foi feito.
3. A tabela traz uma linha por produto, com colunas **Insumos**, **Elementos de Custo** e **Total** — use **[±]**/**Expandir** para abrir o detalhe (matéria-prima, embalagem, intermediários; mão de obra, instalações, máquinas, outros). A seta da linha abre a **estrutura** que compõe o produto.

**Como ler**
- **Tudo é unitário** (por unidade de rendimento).
- **Elementos de custo** = custo absorvido (horas × custo/hora ÷ rendimento) **+ ociosidade** (horas úteis não usadas, rateadas entre os produtos que usam aquele tipo).
- **Total = Insumos + Elementos de Custo** — é o custo que o preço sugerido, a precificação e a DRE usam.
- O cartão **Ociosidade não alocada** mostra o custo de capacidade que nenhum produto usa (fica fora do preço).

### 4.11 Despesas
**Para que serve:** despesas do Planejamento — **fixas** (valor mensal, rateado por Direcionador) e **variáveis** (% sobre a receita bruta). Marketing é uma despesa como as outras. **Todas entram no preço sugerido.**

**Passo a passo**
1. **Nova despesa:** título, **Plano de Contas**, **Fixa ou Variável**, Centro de Custo e, conforme o tipo:
   - *Fixa* → **valor mensal** e **Direcionador** (o critério de rateio entre os produtos);
   - *Variável* → **% da receita**.
2. Marque os **créditos** que a despesa gera (ICMS, CBS, IR/CSLL), com alíquota própria se precisar.
3. Os cartões do alto mostram o total das fixas, o % das variáveis e a divisão das fixas por Plano de Contas.

> Despesas que valem **só para um Centro de Resultados** (adicionais) se cadastram dentro do Centro, não aqui.

### 4.12 Impostos
**Para que serve:** definir **quais créditos cada item gera** e **como cada imposto é apurado**.

**Aba Créditos** — em sessões (Insumos e embalagens, Mão de obra, Instalações, Máquinas e outros, Despesas, Revenda), marque para cada item os créditos de **ICMS**, **CBS** e/ou **IR/CSLL** (neste último, a dedutibilidade). No ICMS informe a **origem da compra** (Bahia, Sul/Sudeste ou as demais); na CBS e no IR/CSLL só preencha **alíquota própria** se o item tiver alíquota diferente da padrão. Use **marcar visíveis** para classificar vários de uma vez.

**Aba Débitos e Mecanismos de Apuração** — uma sessão por imposto:
- **ICMS** — alíquotas por UF de destino e por faixa, **compra: alíquota por origem**, **mix de destinos** de cada Centro (quanto da receita vai para cada UF) e o **Desenvolve-BA** (benefício que dilata o saldo devedor; aparece como **informativo** — não reduz o preço);
- **CBS** e **IR/CSLL** — alíquotas **por vigência** (mês de início).

**Importante:** Centro sem mix de destinos é tratado como **100% dentro da Bahia**. O regime considerado é **Lucro Real**.

### 4.13 Precificação e Resultado Primário
**Para que serve:** o **resultado que a empresa almeja**: a Meta de Lucro, o preço que cobre custo, impostos, despesas e meta, e o que sobra por produto. É **único** — os Centros partem dele.

**Seis abas**
1. **Meta de Lucro** — quatro destinos em % do preço: **Distribuição Sócios, Reserva, Expansão, Outros**. A soma é o **Lucro Pretendido** (líquido do IR/CSLL).
2. **Rateio das Despesas Fixas** — como as despesas fixas se dividem entre os produtos (veja abaixo).
3. **Precificação** — escolha o modo dos impostos (**Contábil** ou **Financeira**) e veja, por produto: Impostos, Custo do Produto, Despesas Variáveis, Despesa Fixa (rateada), % Lucro, **Preço Sugerido**, **Preço Definido** e **Spread**. A seta abre a **composição do preço**. O **Preço Definido** nasce igual ao sugerido; digite outro para testar (o botão *voltar ao sugerido* desfaz).
4. **Análise de Preço x Lucro (Primário)** — para cada produto, **Unitário** e **Total** (× quantidade prevista), e o **Total geral**: Preço/Faturamento, Impostos, Custo, Despesas Variáveis, **Margem de Contribuição**, Despesas Fixas, **Resultado Operacional**, Destinação da Meta e **Resultado Final**.
5. **Tabela de Preços** — o preço por faixa de **ICMS** (Bahia, Sul/Sudeste, N/NE/CO/ES), mantendo o mesmo resultado; use **Imprimir** ou **Exportar Excel**.
6. **DRE** — a DRE primária por Plano de Contas, em três colunas (**Desembolso, Retenções e Total**; veja a seção 4.15).

**Rateio das Despesas Fixas.** As despesas fixas (cadastradas em *Despesas*, cada uma com um Direcionador) formam um **pool por Direcionador**. O pool se divide entre os produtos da Tabela de Preços que usam a Atividade do Direcionador e têm produção prevista.
- **Sugestão:** vem do **critério** escolhido no bloco do Direcionador — por padrão o da base do cadastro dele. Opções: **Custo × Volume** (custo unitário × quantidade), **Quantidade**, **Mistura** (média ponderada da quantidade e do custo × volume; você define a parte da quantidade, começa em 50%), **Tempo** (horas do roteiro × volume) e **Igual para todos**. Trocar o critério descarta a distribuição gravada.
- **Redistribuir:** digite o **% do pool** de cada produto para dar mais despesa a um e menos a outro. O bloco mostra *Faltam / Sobram X%* e só deixa **Gravar distribuição** com a soma em **100%** — assim toda a despesa fixa fica prevista no preço. *Normalizar para 100%* ajusta proporcionalmente; *Voltar à sugestão* apaga a distribuição gravada.
- **Efeito:** no fim da aba, por produto, o % do total, a despesa fixa por unidade, o preço sugerido e o spread. Redistribuir só move despesa entre os produtos: o total das despesas fixas não muda.

**Trava da primária.** No topo da tela fica a faixa de estado. Com tudo conferido, clique **Concluir e liberar Centros**: a primária fica **travada** — rateio, Meta de Lucro, Preços Definidos e o modo dos impostos ficam congelados e os **Centros de Resultados e a DRE Consolidada** são liberados. Se depois o **custo, a quantidade produzida ou uma despesa** mudarem, a trava fica **desatualizada** e os Centros voltam a ficar bloqueados: use **Reabrir**, confira o rateio e trave de novo. Enquanto a primária não é travada, a tela de Centros e a DRE Consolidada mostram o aviso (o cadastro dos Centros, as despesas adicionais e as quantidades continuam liberados).

**Como ler o Spread:** margem líquida efetiva menos a Meta, em pontos percentuais. **Zero** = no preço sugerido; **positivo** = você cobra acima da necessidade; **negativo** = abaixo da meta.

**Contábil × Financeira:** na *contábil*, os créditos abatem o custo e os débitos entram cheios; na *financeira*, o sistema estima o % da receita que os impostos representam (iterando). O **Desenvolve não reduz o preço**.

### 4.14 Centro de Resultados
**Para que serve:** cada canal de venda **parte da precificação primária** e soma o que é só dele: **despesas adicionais**, **destino das vendas (ICMS)**, **desconto comercial** e **quantidades**. Sem acréscimos, o Centro dá os mesmos preços e resultado da primária.

**Passo a passo**
1. **Novo Centro de Resultados** — código, nome e descrição. Abra-o por **Abrir**.
2. Aba **Cadastro e Parâmetros:** dados cadastrais, **desconto** (o preço de tabela = preço líquido ÷ (1 − desconto)), **mix de destinos** (soma 100%) e **despesas adicionais** (fixas, rateadas só entre as quantidades do Centro, ou variáveis).
3. Aba **Precificação:** os mesmos campos da primária para o Centro, mais a coluna **Quantidade** editável (o saldo "a alocar" se atualiza na hora) e o Preço Definido do Centro.
4. Abas **Análise de Preço x Lucro** e **Tabela de Preços** do Centro.

**"Produção a alocar"** é um Centro do sistema (não se edita nem exclui): a quantidade dele é **produção − o que foi alocado aos outros Centros**, para a soma sempre fechar.

### 4.15 DRE Consolidada
**Para que serve:** o **resultado da empresa**: a soma dos Centros de Resultados, por Plano de Contas.

- **Visão:** *Consolidada (todos os Centros)* ou um Centro específico.
- **Cartões:** Resultado Operacional da **Primária**, **efeito dos Centros** e Resultado Operacional **Consolidado** (reconciliação).
- A árvore mostra Receita Bruta, Impostos (ICMS, CBS, IR/CSLL), Custos, Despesas, Resultado Operacional, Destinação e Resultado Final, em **três colunas**:
  - **Desembolso** — o que sai do caixa;
  - **Retenções** — as provisões e encargos lançados nos gastos de mão de obra, instalações, máquinas e outros (a coluna *Retenção* do cadastro de gastos);
  - **Total** — Desembolso + Retenções (é o valor que sempre existiu na DRE, sem mudança).
- Receita, impostos, insumos e despesas ficam inteiros em **Desembolso**: só os custos dos elementos se dividem. Nas linhas de **Resultado**, *Desembolso* é o resultado antes das provisões e *Retenções* é o efeito delas (negativo).
- As **fotos** do Histórico guardam as três colunas; fotos congeladas antes desta mudança mostram só o Total ("—" nas outras duas).
- Clique para recolher/expandir grupos.
- O benefício do **Desenvolve-BA** aparece como **informativo** (reserva de lucro), fora do resultado e do preço.

### 4.16 Premissas
**Para que serve:** resumo do Planejamento em quatro áreas (Comercial, Operacional/Produção, Despesas e Orçamento Financeiro), com as **premissas** (textos) que explicam os números — ex.: *"Crescer 8%"*, *"Novo turno"*.

**Passo a passo:** **Premissa** cria uma; **Editar**/**Excluir** nas linhas. Os valores vêm da DRE e do custeio; as premissas ficam gravadas no Planejamento e entram nas fotos do Histórico.

### 4.17 Histórico de Planejamento
**Para que serve:** guardar **fotos congeladas** dos resultados (Meta de Lucro, DRE Consolidada, Centros, Premissas e linhas por produto). Uma foto **não muda depois**.

**Passo a passo**
1. **Congelar foto** — dê um rótulo e uma observação. Exige a **Meta de Lucro** definida e o **custo calculado**.
2. Abra uma foto para ver o conteúdo, ou **compare**: foto × Planejamento de hoje, ou foto × foto. A comparação mostra *B − A* por seção (Consolidada, Centros, Produtos, Premissas).
3. Só o **rótulo**, a **observação** e a marca de **oficial** podem ser editados.

### 4.18 Manual de Utilização (IA e Humano)
Esta tela. A aba **Para humanos** é este texto, com **índice** à esquerda. A aba **Para IA** é o guia técnico para um agente de inteligência artificial operar o sistema pela API, pela CLI e pela planilha; use **Copiar** ou **Baixar .md** para entregá-lo a uma IA.

### 4.19 Administração (somente administradores)
- **Usuários:** quem pode entrar. **Novo usuário** (e-mail, nome, senha, perfil), **Editar** (nome, perfil, ativo/inativo, nova senha). O sistema exige **ao menos um administrador ativo**.
- **Log de Ações:** quem fez qual alteração, quando, em qual recurso — mostra **o que** foi feito, não os valores (o antes/depois dos custos está no histórico de cada item). Filtre por usuário e recurso.

## 5. Receitas rápidas

**Cadastrar um produto novo**
1. *Formulações* → **Novo produto** (código, nome, tipo, rendimento).
2. Monte a árvore: insumos por etapa e **Elemento** para as horas de mão de obra/máquina/instalação.
3. Marque **Na Tabela de Preços**.
4. *Planejamento de Produção* → informe a produção/mês.
5. *Custo dos Produtos* → **Calcular custos**. Confira o preço em *Precificação*.

**Reajustar o preço de um insumo**
*Insumos e Embalagens* → **Alterar preço** do item, com o mês de vigência → *Custo dos Produtos* → **Calcular custos**.

**Atualizar muita coisa de uma vez**
*Importação* → baixe o modelo **preenchido** → edite só as abas necessárias → **Validar** → corrija os erros → **Aplicar** → **Calcular custos**.

**Simular uma ideia sem mexer no oficial**
*Planejamentos* → **Nova versão a partir de…** → mude na cópia → compare com o original (**Comparar** ou **Histórico de Planejamento**).

**Fechar o mês**
1. *Planejamentos*: todas as etapas obrigatórias **Pronto**.
2. *DRE Consolidada*: confira o resultado e a reconciliação.
3. *Histórico de Planejamento*: **Congelar foto**.

## 6. Problemas comuns

| O que aparece | O que significa | O que fazer |
| --- | --- | --- |
| Custo do produto em branco ou "—" | O produto é novo ou entrou depois do último cálculo | **Calcular custos** de novo; confira que ele está na Tabela de Preços |
| Preço sugerido não aparece | Faltam a Meta de Lucro ou o custo | Defina a meta (*Precificação*) e calcule o custo |
| Centros de Resultados e DRE Consolidada com aviso | A primária não está travada, ou a trava está desatualizada | Em *Precificação e Resultado Primário*, confira o rateio e clique em *Concluir e liberar Centros* (ou *Reabrir* e travar de novo) |
| *Concluir e liberar Centros* desabilitado | Há pendências (sem custo, sem Meta, Direcionador sem produto para ratear ou produto novo sem % no rateio gravado) | Leia a lista sob a faixa e resolva cada item |
| Não consigo gravar o rateio | A soma dos % do Direcionador não é 100%, ou a primária está travada | Use *Normalizar para 100%*; se travada, *Reabrir* |
| "Alocado acima da produção" | Os Centros somam mais que a produção de algum produto | Reduza as quantidades dos Centros ou ajuste a produção |
| Erro de unidade na formulação | Falta conversão entre a unidade da linha e a do item | Cadastre em *Unidades e Conversões* |
| Despesa fixa sem rateio | Nenhum produto consome a Atividade do Direcionador, ou falta volume | Revise o Direcionador e a produção |
| Importação recusada | Há erro em alguma linha (tudo-ou-nada) | Leia os erros, corrija a planilha e valide de novo |
| Mix de destinos recusado | Não soma 100% | Ajuste os percentuais do Centro |
| Divisor ≥ 100% no preço | Impostos + despesas variáveis + lucro passam de 100% | Revise a Meta, as despesas variáveis e as alíquotas |
| Não consigo excluir | O item está em uso (formulação, lançamento…) | Inative em vez de excluir, ou remova o uso antes |
| Menu "Administração" ausente | Seu perfil não é administrador | Peça a um administrador |

## 7. Glossário

- **Bacia** — quantidade que a formulação processa de uma vez (um lote).
- **Cabeça** — produto marcado na Tabela de Preços; ponto de partida do custeio.
- **Competência** — mês a que o custo se refere.
- **Custo absorvido** — custo dos elementos realmente usados pelo produto (horas × custo/hora).
- **Custo primário** — o custo total unitário do produto (insumos + elementos + ociosidade).
- **Direcionador** — critério de rateio (tempo, quantidade produzida ou custo primário).
- **Desenvolve-BA** — benefício fiscal da Bahia que dilata o ICMS a pagar; entra só como informativo.
- **Ociosidade** — custo das horas úteis que ninguém usou, distribuído entre os produtos que usam aquele tipo de elemento.
- **Spread** — margem líquida efetiva menos a Meta de Lucro, em pontos percentuais.
- **Vigência** — mês a partir do qual um valor passa a valer.