Apuração Custeio
Criado por Igor Ribeiro em 14 de novembro de 2025
Atualizado por Igor Ribeiro em 02 de setembro de 2026
Apuração Custeio
Módulo Contabilidade > Custeio — apuração do custo dos itens de estoque movimentados em um período, com base nas fases de um Modelo de Custeio, com contabilização automática do valor apurado por fase.
Visão Geral da Rotina
A rotina de Custeio, dentro do módulo Contabilidade, é onde o usuário apura o custo dos itens de estoque movimentados em um determinado período, com base nas fases configuradas em um Modelo de Custeio previamente cadastrado. O usuário informa a filial e o período (data inicial e data final), seleciona o Modelo de Custeio a aplicar e o sistema gera a lista de itens movimentados, permite ajustar o valor econômico de referência de cada item, calcula o rateio de custo fase a fase e, por fim, contabiliza os valores apurados em um lote contábil.
Vídeo Tutorial da Apuração Custeio
Pré-requisitos e Contexto de Acesso da Apuração Custeio
O usuário precisa ter a permissão “Apuração Custeio” para acessar a tela. Para criar, editar ou excluir um Custeio, são necessárias as permissões específicas de cada ação (Novo, Editar, Excluir). Para executar as etapas de apuração, são necessárias as permissões de “Obter Lista Para Gerar Itens”, “Aplicar Conteúdo Econômico”, “Calcular Custo dos Itens”, “Atualizar Entradas e Saídas”, “Contabilizar Valores da Fase” e/ou “Iniciar Custeio”, conforme as etapas executadas.
Processo de Criação — Passo a Passo
Criar o Custeio
O usuário acessa “Contabilidade / Custeio / Apuração Custeio” e inicia um novo registro, informando Nome, Filial, Data Inicial, Data Final e o Modelo de Custeio a ser utilizado. O sistema grava o cabeçalho do Custeio.
Gerar a lista de itens
O usuário aciona a geração da lista de itens do período (“Obter Lista Para Gerar Itens”). O sistema percorre cada fase do Modelo de Custeio e busca, para a filial e o período informados, as entradas e saídas de estoque associadas aos tipos de movimento configurados em cada fase, aplicando a visão de Ficha Técnica quando a fase estiver configurada dessa forma.
Aplicar o conteúdo econômico
O usuário seleciona uma Lista de Preço e uma data de vigência e aciona “Aplicar Conteúdo Econômico”. O sistema busca o valor unitário de referência de cada item na lista de preço informada (exceto para itens de fase “Ficha Técnica”, cujo valor unitário é sempre 1), calcula o Valor Total Econômico de cada item e recalcula o percentual de participação de cada item dentro da sua fase.
Atualizar entradas e saídas (apurar o custo)
O usuário aciona “Atualizar Entradas e Saídas”. O sistema valida se todos os itens têm valor econômico preenchido, verifica se existe fechamento de estoque compatível com o período (quando aplicável ao tipo de modelo), processa cada fase do Modelo de Custeio calculando o custo apurado e grava o resultado. Esta etapa pode demorar; o andamento pode ser acompanhado pelo log do processo.
Contabilizar os valores da fase
O usuário aciona “Contabilizar Valores da Fase” informando a Filial e a Data Final do período. O sistema gera (ou reutiliza) um lote contábil do mês e cria um lançamento de débito/crédito para cada fase que tenha planos de contas configurados no Modelo de Custeio, com o valor apurado na fase.
(Alternativa aos passos 4 e 5) Iniciar Custeio
Em vez de rodar a apuração pela tela, o usuário pode acionar “Iniciar Custeio”, que dispara o mesmo processamento de forma assíncrona em um serviço externo, liberando a tela imediatamente. O acompanhamento é feito pelo log do processo.
Descrição de Cada Campo da Tela da Apuração Custeio
Nome
Tipo: texto
Obrigatoriedade: obrigatório
Descrição: nome/descrição que identifica o registro de Custeio.
Comportamento: texto livre.
Impacto: exibido nas listagens e nos filtros de busca do Custeio.
Filial
Tipo: seleção
Obrigatoriedade: obrigatório
Descrição: filial para a qual o custeio será apurado.
Comportamento: seleção de uma filial cadastrada no sistema.
Impacto: usada para localizar as entradas/saídas de estoque e o fechamento de inventário do período; também usada na geração do lote contábil.
Data Inicial / Data Final
Tipo: data
Obrigatoriedade: obrigatório
Descrição: início e fim do período apurado.
Comportamento: a Data Final também é usada para compor o número do lote contábil gerado na contabilização (ano/mês/dia).
Impacto: usadas como filtro nas buscas de movimentação de estoque, na verificação de fechamento de inventário e na numeração do lote contábil.
Modelo de Custeio
Tipo: seleção
Obrigatoriedade: obrigatório
Descrição: modelo que define as fases de apuração e a contabilização do custeio. [informação não disponível na análise de código — validar com analista/vídeo do sistema: se a seleção do modelo é bloqueada após a geração de itens]
Comportamento: ao ser selecionado, define quais fases serão percorridas na geração de itens e no cálculo de custo.
Impacto: determina o tipo do modelo (Fiscal, Gerencial – RCPE, Fiscal Simplificado, Gerencial – RCPE Simplificado), que define qual fluxo de processamento e validações de fechamento de estoque serão aplicados.
Lista de Preço / Data em Vigor
Tipo: seleção + data
Obrigatoriedade: obrigatório para executar a ação “Aplicar Conteúdo Econômico”
Descrição: lista de preço e data usadas para buscar o valor econômico (preço de referência) de cada item do custeio.
Comportamento: ao confirmar, o sistema busca o valor unitário econômico de cada item nessa lista de preço, na data informada.
Impacto: define o Valor Total Econômico e o Percentual de cada item dentro da fase; itens de fase “Ficha Técnica” não usam esse valor (valor unitário sempre igual a 1).
Item do Custeio (grid de itens)
Tipo: grid (somente leitura na maior parte dos campos, gerado pelo sistema)
Obrigatoriedade: gerado automaticamente pela ação “Obter Lista Para Gerar Itens”
Descrição: cada linha representa um item de estoque movimentado no período, associado a uma fase do Modelo de Custeio, com suas quantidades, valor unitário econômico, valor total econômico, percentual na fase e valor de custo fiscal apurado.
Comportamento: os valores de quantidade e item vêm da movimentação de estoque; o valor unitário econômico é preenchido/alterado por “Aplicar Conteúdo Econômico”; o percentual é recalculado automaticamente sempre que o valor econômico do item ou de outros itens da mesma fase muda.
Impacto: é a base de cálculo para a apuração de custo por fase e para a contabilização.
Utilização e Consulta de Registros da Apuração Custeio
O usuário localiza registros de Custeio já cadastrados na grid de listagem da rotina “Apuração Custeio”, usando o campo de busca livre. Esse campo aceita: o ID do próprio Custeio, o ID do Modelo de Custeio vinculado, o código numérico do tipo de modelo, o ID ou nome da filial, a data final do período (se reconhecida como data) ou parte do nome do Custeio/Modelo de Custeio. Existe ainda uma segunda tela de consulta (“Consultar”), usada para demonstrativos contábeis relacionados, com os mesmos recursos de paginação e ordenação de grid.
Processo de Edição da Apuração Custeio
Estrutura Técnica e Comportamento do Sistema da Apuração Custeio
Integração com Estoque: a geração de itens do custeio busca diretamente as movimentações de entrada e saída de estoque do período/filial informados, respeitando os tipos de movimento e o centro de custo configurados em cada fase do Modelo de Custeio.
Integração com Contabilidade: a ação “Contabilizar Valores da Fase” gera lançamentos em um Lote Contábil (série “CST”), usando os planos de contas de débito e crédito e o centro de custo configurados em cada fase do Modelo de Custeio (ou o centro de custo padrão do sistema, quando a fase não tiver um definido).
Integração com Fechamento de Inventário de Estoque: para modelos Fiscal e Fiscal (Simplificado), a apuração exige fechamento de estoque compatível com o período; para modelos Gerencial e Gerencial (Simplificado), o próprio processo de custeio inicializa/valida o fechamento de inventário.
Processamento em lote e log de acompanhamento: as etapas de cálculo mais pesadas (“Atualizar Entradas e Saídas” e “Iniciar Custeio”) gravam um arquivo de log de progresso por Custeio, consultável em tempo real na própria tela e disponível para download completo.
Processamento assíncrono externo: “Iniciar Custeio” delega o processamento a um serviço externo (fora da aplicação web principal); falhas de comunicação com esse serviço não impedem a resposta de sucesso imediata ao usuário — o resultado real deve ser conferido pelo log.
Integração com Sped Contribuições: a tela de “Lista de Erros” do Custeio exibe os erros/avisos do último evento de integração de Sped Contribuições registrado para a filial.
Regras de Negócio e Restrições da Apuração Custeio
Lista de itens obrigatória para aplicar conteúdo econômico ou calcular custo
Se o usuário tentar aplicar o conteúdo econômico ou calcular o custo dos itens sem nenhum item selecionado/gerado, o sistema bloqueia a ação.
Lista de itens obrigatória para atualizar entradas e saídas
Se o usuário tentar atualizar entradas e saídas sem nenhum item na lista, o sistema bloqueia a operação.
Valor econômico não pode ficar zerado
Antes de atualizar entradas e saídas ou de iniciar o custeio, o sistema verifica se algum item está com o Total Econômico igual a zero. Se houver, a operação é interrompida.
Fechamento de estoque obrigatório para modelos fiscais
Para Modelo de Custeio do tipo Fiscal ou Fiscal (Simplificado), o sistema exige que exista fechamento de estoque com status “Fechado” cobrindo o período apurado.
Fechamento de inventário já existente bloqueia custeio Gerencial (Simplificado)
Se já existir um fechamento de estoque registrado para a filial e a data final informadas, o custeio do tipo Gerencial – RCPE (Simplificado) não pode ser processado.
Validação prévia do inventário nos modelos simplificados
Nos modelos Fiscal (Simplificado) e Gerencial (Simplificado), o sistema executa uma validação prévia do inventário de estoque antes de concluir o processamento. Se houver inconsistências, elas são gravadas no arquivo de log detalhado e a operação é bloqueada.
Itens de fase “Ficha Técnica” têm valor unitário fixo em 1
Quando um item pertence a uma fase do Modelo de Custeio marcada para apropriar custos no estoque com base na Ficha Técnica, o sistema sempre atribui o valor 1 como valor unitário econômico desse item, independentemente da lista de preço informada em “Aplicar Conteúdo Econômico”.
Percentual recalculado automaticamente
Sempre que os valores econômicos dos itens são alterados (edição, aplicação de conteúdo econômico ou atualização de entradas/saídas), o sistema recalcula automaticamente o percentual de participação de cada item dentro do total econômico da sua fase — o usuário não informa esse percentual manualmente.
Contabilização depende do plano de contas configurado na fase
Na contabilização dos valores da fase, apenas as fases do Modelo de Custeio que tiverem plano de contas de débito e de crédito configurados geram lançamento contábil; fases sem essa configuração são ignoradas nesta etapa, sem mensagem de erro.
Parâmetro de sistema obrigatório para iniciar o custeio em lote
Para usar “Iniciar Custeio”, é necessário que o parâmetro de configuração de pasta de documentos eletrônicos (código 12009) esteja preenchido no sistema.
Log de processamento sempre disponível durante e após a apuração
Toda apuração processada pela tela ou pelo serviço externo grava um arquivo de log específico do Custeio, que pode ser acompanhado em tempo real ou baixado por completo.
Disparo do processamento assíncrono não garante sucesso imediato
Ao acionar “Iniciar Custeio”, o sistema responde com sucesso assim que o pedido é enviado ao serviço externo de processamento, mesmo que esse serviço esteja indisponível ou falhe — o usuário deve confirmar o resultado real da apuração consultando o log do processo, não apenas a resposta imediata da tela.
