Perfil Contábil Item
Criado por Igor Ribeiro em 24 de setembro de 2025
Atualizado por Igor Ribeiro em 02 de setembro de 2026
Perfil Contábil Item
A rotina “Perfil contábil item” (Contabilidade / Cadastros / Perfil contábil item) cadastra modelos reutilizáveis que dizem ao sistema em quais contas contábeis e centros de custo lançar valores relacionados a um produto ou a um bem do patrimônio.
Visão Geral do Perfil Contábil Item
A rotina “Perfil contábil item” (Contabilidade / Cadastros / Perfil contábil item) cadastra modelos reutilizáveis que dizem ao sistema em quais contas contábeis e centros de custo lançar valores relacionados a um produto ou a um bem do patrimônio. Cada perfil contábil item guarda até 40 combinações de “conta contábil + centro de custo”, uma para cada esquema de lançamento contábil configurado na empresa.
Depois de cadastrado, um perfil contábil item é vinculado a produtos (no cadastro de Produtos) ou a bens (no cadastro de Bens do Patrimônio), conforme o “Tipo do grupo” definido no perfil. Isso evita que o usuário precise informar manualmente a conta e o centro de custo toda vez que um produto ou bem participa de uma movimentação — o sistema já sabe, pelo perfil vinculado, para onde direcionar o lançamento contábil.
Esta rotina não deve ser confundida com “Perfil contábil do Patrimônio” (rotina de outro módulo, Controle Patrimonial), que é uma tela e um cadastro diferentes.
Vídeo Tutorial
▶ Tutorial em vídeo: ainda não disponível para esta rotina.
Pré-requisitos e Contexto de Acesso do Perfil Contábil Item
Para acessar a tela de Perfil contábil item, o usuário precisa ter a permissão “ListViewDePerfilContabilProduto” atribuída ao seu perfil de acesso. Sem essa permissão, o menu “Contabilidade / Cadastros / Perfil contábil item” não aparece.
Cada ação específica exige uma permissão própria:
Novo
Permissão “PerfilContabilProduto/Novo”.
Editar
Permissão “PerfilContabilProduto/Editar”.
Excluir
Permissão “PerfilContabilProduto/Excluir”.
Exportar
Permissão “PerfilContabilProduto/Exportar”.
Antes de preencher os campos de conta contábil e centro de custo, é recomendável que os cadastros de Plano de Contas (contas analíticas) e Centro de Custo já estejam prontos, já que o perfil apenas referencia códigos já existentes nesses cadastros.
Processo de Criação — Passo a Passo do Perfil Contábil Item
Acessar a rotina
O usuário acessa “Contabilidade / Cadastros / Perfil contábil item” e clica no botão de novo cadastro.
Informar o código e o nome do perfil
O usuário preenche o “Código” (campo ID, até 3 caracteres) e o “Nome” (campo Nome, até 50 caracteres) do perfil contábil.
Selecionar o tipo do grupo
O usuário define se o perfil se aplica a “Produto” ou a “Bem” (campo Tipo do grupo). Essa escolha determina em quais telas de lookup esse perfil vai aparecer disponível para seleção.
Preencher os pares de conta contábil e centro de custo
Para cada um dos 40 esquemas contábeis disponíveis (cujos nomes/rótulos são definidos previamente nas configurações do sistema), o usuário informa o “Código contábil N” (conta do Plano de Contas Analítica) e, opcionalmente, o centro de custo correspondente. O usuário pode preencher apenas os esquemas relevantes para a empresa, deixando os demais em branco.
Salvar
O usuário confirma o cadastro. O sistema grava o perfil contábil com os 40 pares informados (mesmo os que ficaram vazios) e exibe a mensagem “Perfil contábil produto inserido com sucesso”.
Descrição de Cada Campo da Tela do Perfil Contábil Item
Código (campo ID, tela Perfil contábil item)
Tipo: texto
Obrigatoriedade: obrigatório
Descrição: código que identifica de forma única o perfil contábil item.
Comportamento: aceita até 3 caracteres; se deixado em branco, o sistema exibe “Campo obrigatório”; se ultrapassar 3 caracteres, exibe “O código deve conter no máximo 3 caracteres.”.
Impacto: usado como chave de vínculo quando o perfil é selecionado no cadastro de Produtos ou de Bens do Patrimônio.
Nome (campo Nome, tela Perfil contábil item)
Tipo: texto
Obrigatoriedade: obrigatório
Descrição: nome descritivo do perfil contábil, exibido nas listagens e telas de seleção.
Comportamento: aceita até 50 caracteres; se deixado em branco, o sistema exibe “Campo obrigatório”; se ultrapassar 50 caracteres, exibe “O Nome deve conter no máximo 50 caracteres.”.
Impacto: compõe o texto “[Código] – [Nome]” usado em campos de busca/lookup em outras telas do sistema.
Tipo do grupo (campo Tipo do grupo, tela Perfil contábil item)
Tipo: seleção (“Produto” ou “Bem”)
Obrigatoriedade: opcional
Descrição: classifica o perfil contábil como voltado a Produtos ou a Bens do Patrimônio.
Comportamento: aceita no máximo 1 caractere internamente (“P” para Produto, “B” para Bem); se um valor inválido com mais de 1 caractere for enviado, o sistema exibe “O TipoCentroCusto deve ter no máximo 1 caracter.” — observação: o texto dessa mensagem cita “TipoCentroCusto” em vez de “Tipo do grupo”, uma inconsistência do próprio sistema.
Impacto: determina se o perfil aparece na lista de seleção usada pelo cadastro de Bens do Patrimônio (somente perfis marcados como “Bem” aparecem nesse lookup específico).
Código contábil 1 até Código contábil 40 (campos PlanoDeContas1 a PlanoDeContas40, tela Perfil contábil item)
Tipo: texto (referência a conta do Plano de Contas Analítica)
Obrigatoriedade: opcional
Descrição: código da conta contábil analítica vinculada ao esquema contábil correspondente (o rótulo exibido para cada um dos 40 campos — por exemplo “Depreciação” ou “Custo de Aquisição” — vem de uma configuração do sistema, não é fixo).
Comportamento: aceita até 10 caracteres; se ultrapassar esse limite, o sistema exibe “O código deve conter no máximo 10 caracteres.”. Campos deixados em branco são gravados como referência vazia, sem bloquear o cadastro.
Impacto: define em qual conta contábil o sistema lança valores relacionados ao item, para aquele esquema contábil específico.
Centro de custo 1 até Centro de custo 40 (campos CentroDeCusto1 a CentroDeCusto40, tela Perfil contábil item)
Tipo: texto/número (referência a Centro de Custo)
Obrigatoriedade: opcional
Descrição: centro de custo vinculado ao esquema contábil correspondente, para rateio/análise de custos.
Comportamento: só é buscado e vinculado ao perfil se o campo estiver preenchido; se vazio, o item correspondente é gravado sem centro de custo.
Impacto: usado no rateio de custos quando o item participa de uma movimentação contábil, junto com a conta informada no campo “Código contábil” do mesmo esquema.
Utilização e Consulta de Registros do Perfil Contábil Item
Na tela de listagem, o usuário pode pesquisar perfis contábeis digitando um valor no campo de busca — o sistema localiza registros cujo Código ou Nome contenham o texto digitado (correspondência parcial, não precisa ser exata). A listagem também está disponível na forma completa (sem paginação) para telas que precisem carregar todos os perfis de uma vez, e em uma variação de busca exclusiva para bens, que retorna apenas os perfis cujo “Tipo do grupo” seja “Bem” — essa variação é a usada pelo campo de seleção de perfil contábil dentro do cadastro de Bens do Patrimônio.
Processo de Edição do Perfil Contábil Item
Na edição de um perfil contábil item, o usuário pode alterar o Nome, o Tipo do grupo e qualquer um dos 40 pares de Código contábil/Centro de custo. O campo Código (ID) identifica o registro que está sendo editado.
[informação não disponível na análise de código — validar com analista se o campo Código fica bloqueado (somente leitura) na tela de edição, já que essa trava normalmente é aplicada na camada de tela/JavaScript e não é visível na análise do controller].
Não há registro de histórico de alterações visível ao usuário final nesta rotina — internamente, o sistema grava um log de auditoria a cada edição, mas esse log não é uma tela consultável pelo usuário nesta rotina.
Estrutura Técnica e Comportamento do Sistema do Perfil Contábil Item
O perfil contábil item não gera lançamentos contábeis por si só — ele é uma referência consultada por outras rotinas do sistema (como o cadastro de Produtos e o cadastro de Bens do Patrimônio) no momento em que essas rotinas precisam saber em qual conta contábil e centro de custo lançar um valor relacionado ao item. Os rótulos exibidos para cada um dos 40 “esquemas contábeis” vêm da tela de Configurações do sistema (parâmetros do tipo “pNomeEsquemaCtbN”), o que significa que o significado de cada esquema pode variar de uma implantação para outra da empresa.
Regras de Negócio e Restrições do Perfil Contábil Item
O perfil sempre tem 40 posições fixas
Todo perfil contábil item é composto por exatamente 40 pares de conta contábil e centro de custo, numerados de 1 a 40. Mesmo que o usuário preencha só alguns deles, os demais são gravados como posições vazias — nenhum dos 40 esquemas é removido ou renumerado.
O rótulo de cada esquema é configurável, não fixo
O nome exibido para cada um dos 40 campos de “Código contábil” (ex: o que hoje aparece como “Esquema 3” pode ser renomeado para “Depreciação”) vem de uma configuração de sistema por esquema, e não do código do perfil contábil em si. Isso significa que o significado de cada posição pode ser diferente entre empresas ou ambientes.
“Tipo do grupo” restringe onde o perfil aparece para seleção
Perfis marcados como “Bem” são os únicos que aparecem na lista de seleção usada pelo cadastro de Bens do Patrimônio. Perfis marcados como “Produto” não aparecem nessa lista específica — a tela de seleção usada pelo cadastro de Produtos usa a listagem geral (Listar/ListarTodos), sem esse filtro por tipo.
Validações de tamanho de campo bloqueiam o cadastro, mas não há mensagens de negócio adicionais
As únicas mensagens de erro desta rotina são as de validação de formato dos campos (tamanho máximo de caracteres e obrigatoriedade), listadas na seção 5. Não existe, por exemplo, uma mensagem específica de “código já cadastrado” ou “conta contábil inexistente” — esses casos, se ocorrerem, são tratados de forma genérica pelo sistema, sem uma mensagem de negócio dedicada a esta rotina.
Exclusão remove todos os 40 itens do perfil
Ao excluir um perfil contábil item, todas as 40 posições de conta contábil/centro de custo vinculadas a ele são removidas junto — não há bloqueio de exclusão por dependência nem mensagem de aviso adicional além da confirmação padrão de exclusão.
