Histórico Padrão
Documentação Técnica Histórico Padrão Rotina de Contabilidade / Cadastros que permite cadastrar textos padronizados usados para descrever a natureza de lançamentos contábeis ou financeiros, evitando digitação repetida a cada lançamento. 01 — VISÃO GERAL Visão Geral da Rotina A rotina de Histórico padrão, dentro do módulo Contabilidade (Contabilidade / Cadastros / Histórico padrão), permite cadastrar textos padronizados que descrevem a natureza de um lançamento contábil ou financeiro (por exemplo, “Pagamento de fornecedor” ou “Recebimento de duplicata”). Em vez de digitar a mesma descrição a cada lançamento, o usuário seleciona um histórico padrão já cadastrado. Cada histórico padrão tem um código numérico e um nome, e pode ser marcado como participante do LCDPR (Livro Caixa Digital do Produtor Rural), obrigação acessória usada por produtores rurais. Além do cadastro em si, a rotina permite consultar quais “fatos contábeis” (regras de geração automática de lançamento contábil a partir de operações financeiras ou de movimentações de estoque/produção) estão associados a um histórico, e atualizar em lote a descrição já gravada nesses lançamentos quando o texto do histórico padrão muda. 02 — VÍDEO TUTORIAL Vídeo Tutorial do Histórico Padrão ▶ Tutorial em vídeo: ainda não disponível para esta rotina. 03 — PRÉ-REQUISITOS Pré-requisitos e Contexto de Acesso do Histórico Padrão Para acessar a tela de Histórico padrão, o usuário precisa ter a permissão “ListViewDeHistoricoPadrao” atribuída ao seu perfil — sem ela, o item de menu “Contabilidade / Cadastros / Histórico padrão” não é exibido. Para executar ações específicas dentro da tela, o usuário precisa também das permissões correspondentes: Incluir Permissão “HistoricoPadrao/Novo”. Editar Permissão “HistoricoPadrao/Editar”. Excluir Permissão “HistoricoPadrao/Excluir”. Exportar Permissão “HistoricoPadrao/Exportar”. Atualizar Fatos Contábeis Permissão “HistoricoPadrao/AtualizarFatosContabeis”, necessária para atualizar os fatos contábeis vinculados a um histórico. Dependência Não há dependência de cadastro prévio de outra rotina para criar um histórico padrão em si; porém, para que um histórico seja efetivamente utilizado em lançamentos automáticos, ele precisa estar associado a um ou mais “fatos contábeis” (regras configuradas em outra rotina do sistema). 04 — PASSO A PASSO Processo de Criação — Passo a Passo 1 Acessar a rotina O usuário acessa “Contabilidade / Cadastros / Histórico padrão” e aciona a opção de novo cadastro. 2 Informar o código do histórico O usuário digita o código numérico (campo “ID”) que identificará o histórico padrão. O sistema exige que esse campo seja preenchido. 3 Informar o nome do histórico O usuário digita o texto descritivo do histórico (campo “Nome”). O sistema exige o preenchimento e limita o texto a 150 caracteres. 4 Indicar participação no LCDPR O usuário marca ou desmarca o indicador “Participa do LCDPR”, conforme o histórico deva ou não ser considerado nessa obrigação acessória. Esse campo é opcional. 5 Salvar O usuário confirma o cadastro. O sistema grava o novo histórico padrão e exibe a mensagem “Historico Padrão inserido com sucesso.”. 05 — CAMPOS DA TELA Descrição de Cada Campo da Tela do Histórico Padrão Código (campo “ID” do histórico padrão) Tipo: número Obrigatoriedade: obrigatório Descrição: código numérico que identifica o histórico padrão de forma única. Comportamento: não pode ficar em branco; é usado como chave de busca (aceita busca exata por código na listagem). Impacto: aparece em todas as telas onde o histórico padrão é selecionado (lançamentos contábeis/financeiros) como parte do texto “Código – Nome”; é a chave usada para localizar os fatos contábeis vinculados. Nome (campo “Nome” do histórico padrão) Tipo: texto Obrigatoriedade: obrigatório Descrição: descrição textual do histórico, exibida junto ao código nos lançamentos. Comportamento: limitado a 150 caracteres; aceita busca por conteúdo (texto parcial) na listagem. Impacto: é o texto exibido nos lançamentos contábeis/financeiros que utilizam este histórico; pode ser propagado retroativamente aos lançamentos de fato contábil já existentes através da funcionalidade de atualização de fatos contábeis (ver seção 8). Participa do LCDPR (campo “Participa do LCDPR”) Tipo: checkbox (indicador de 0 ou 1) Obrigatoriedade: opcional — quando não informado, o sistema assume o valor 0 (não participa) Descrição: indica se este histórico deve ser considerado na apuração do LCDPR (Livro Caixa Digital do Produtor Rural). Comportamento: alterna entre marcado/desmarcado; não possui validação adicional. Impacto: [informação não disponível na análise de código — validar com analista/vídeo do sistema] quanto ao relatório/processo específico do LCDPR que consome esse indicador. 06 — CONSULTAS Utilização e Consulta de Registros do Histórico Padrão O usuário localiza históricos padrão existentes através da grid de listagem da rotina, que exibe Código e Nome. É possível filtrar a lista digitando um texto de busca: se o texto digitado for um número, o sistema busca tanto por código exato quanto por nome que contenha o texto; se for texto, busca apenas por nome que contenha o valor digitado. A listagem também está disponível para exportação (Excel/outro formato configurado) e para consulta por outras telas do sistema (via consulta dinâmica de grid). 07 — EDIÇÃO Processo de Edição do Histórico Padrão Após o cadastro, o usuário pode editar o Nome e o indicador “Participa do LCDPR” de um histórico padrão existente, informando o Código do registro a ser alterado. O Código (ID) é a chave do registro e é usado para localizar o histórico a editar — a análise de código não identificou uma trava explícita contra a alteração do próprio código no fluxo de edição; ao confirmar a edição, o sistema grava a alteração e exibe a mensagem “Historico Padrão editado com sucesso.”. Importante A edição do Nome do histórico não altera automaticamente a descrição que já foi gravada em lançamentos anteriores (fatos contábeis Financeiro e TMV) que usam esse histórico. Para propagar o novo texto a esses lançamentos já existentes, é necessário usar a funcionalidade de atualização de fatos contábeis, descrita na seção 8. 08 — ESTRUTURA TÉCNICA Estrutura Técnica e Comportamento do Sistema do Histórico Padrão Integração com fatos contábeis A rotina se integra com o módulo de lançamentos contábeis/financeiros através dos chamados “fatos contábeis” — regras que associam um histórico padrão a uma operação financeira (ex: liquidação de título) ou a um tipo de movimento (TMV, usado em operações de estoque/produção). A tela permite consultar, para
Frigorífico
Frente de Loja
Perfil Contábil Item
Documentação Técnica 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. 01 — VISÃO GERAL 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. Observação importante 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. 02 — VÍDEO TUTORIAL Vídeo Tutorial do Perfil Contábil Item ▶ Tutorial em vídeo: ainda não disponível para esta rotina. 03 — PRÉ-REQUISITOS 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”. Pré-requisito recomendado 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. 04 — PASSO A PASSO Processo de Criação — Passo a Passo do Perfil Contábil Item 1 Acessar a rotina O usuário acessa “Contabilidade / Cadastros / Perfil contábil item” e clica no botão de novo cadastro. 2 Informar o código e o nome do perfil O usuário preenche o “Código” (até 3 caracteres) e o “Nome” (até 50 caracteres) do perfil contábil. 3 Selecionar o tipo do grupo O usuário define se o perfil se aplica a “Produto” ou a “Bem” (Tipo do grupo). Essa escolha determina em quais telas de lookup esse perfil vai aparecer disponível para seleção. 4 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. 5 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”. 05 — CAMPOS DA TELA Descrição de Cada Campo da Tela do Perfil Contábil Item Código (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 (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 (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 (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 (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. 06 — CONSULTA
Financeiro
Centro de Custo
Documentação Técnica Centro de Custo Rotina do módulo Contabilidade que mantém o cadastro das dimensões de rateio e análise de custos usadas para classificar gastos e receitas de forma independente do Plano de Contas — permitindo apurar o resultado por unidade, obra, entidade de gastos, entre outros recortes. 01 — VISÃO GERAL Visão Geral do Centro de Custo A rotina de Centro de Custo, do módulo Contabilidade, mantém o cadastro das dimensões de rateio e análise de custos usadas para classificar gastos e receitas de forma independente do Plano de Contas — permitindo apurar o resultado por unidade, obra, entidade de gastos, entre outros recortes. Um Centro de Custo pode ser do tipo Sintético (agrupador, que não recebe lançamento direto) ou Analítico (que recebe lançamento direto), seguindo a mesma lógica hierárquica do Plano de Contas. Observação importante O cadastro também guarda dados de identificação do estabelecimento (CNPJ ou CNO) e um indicativo de obra de construção civil, usados para a geração de arquivos e obrigações que exigem essa informação, como o eSocial de obras. 02 — VÍDEO TUTORIAL Vídeo Tutorial do Centro de Custo ▶ Tutorial em vídeo: ainda não disponível para esta rotina. 03 — PRÉ-REQUISITOS Pré-requisitos e Contexto de Acesso do Centro de Custo Para acessar a listagem de Centros de Custo, o usuário precisa da permissão de acesso à rotina “ListViewDeCentroDeCusto” (ID 115). Para as demais operações, são necessárias permissões específicas: CentroDeCusto/Novo ID 114 Cadastrar um novo Centro de Custo. CentroDeCusto/Editar ID 111 Editar um Centro de Custo existente. CentroDeCusto/Excluir ID 112 Excluir um Centro de Custo. CentroDeCusto/Exportar ID 113 Exportar a listagem. Pré-requisito de negócio A Entidade de Gastos que será vinculada ao Centro de Custo precisa já estar cadastrada previamente no sistema — o cadastro de um novo Centro de Custo exige essa vinculação (ver Regra 2). 04 — PASSO A PASSO Processo de Criação — Passo a Passo do Centro de Custo 1 Informar o código e a máscara O usuário informa o código do Centro de Custo e a Máscara (código hierárquico, ex.: “1.1.01”). O sistema verifica se a máscara já está em uso por outro Centro de Custo; se estiver, bloqueia o cadastro (ver Regra 1). 2 Informar o nome e o tipo O usuário preenche o nome do Centro de Custo e escolhe o tipo: Sintético (apenas agrupador) ou Analítico (recebe lançamento). 3 Vincular a Entidade de Gastos O usuário seleciona a Entidade de Gastos à qual o Centro de Custo pertence. Esse vínculo é obrigatório e o sistema valida se a entidade informada realmente existe (ver Regras 2 e 3). 4 Selecionar o Grupo do Centro de Custo e o Status O usuário escolhe o grupo (ex.: Despesa, Custo produtivo, Receita, entre outros) e define o status Ativo ou Inativo. 5 Preencher dados do estabelecimento (quando aplicável) Se o Centro de Custo representar um estabelecimento com CNPJ ou CNO (por exemplo, uma obra), o usuário informa o tipo de inscrição, o número de inscrição e o indicativo de obra de construção civil. Se o tipo for CNPJ, o sistema valida o dígito verificador antes de salvar (ver Regra 4). 6 Gravação Ao confirmar, o sistema grava o registro definitivamente no banco de dados. 05 — CAMPOS DA TELA Descrição de Cada Campo da Tela do Centro de Custo Código Tipo: texto/número Obrigatoriedade: obrigatório Descrição: identificador único do Centro de Custo no sistema. Comportamento: usado como chave de busca em “ObterPorId” e como referência em relatórios e outras rotinas que citam o Centro de Custo. Impacto: aparece em lançamentos, relatórios e vínculos com o Plano de Contas. Nome Tipo: texto Obrigatoriedade: obrigatório, máximo de 50 caracteres Descrição: nome descritivo do Centro de Custo. Comportamento: usado nas buscas livres da listagem e em campos de seleção/autocomplete de outras telas. Impacto: exibido em listagens, relatórios e nos campos de seleção de lançamento. Máscara Tipo: texto Obrigatoriedade: obrigatório, máximo de 30 caracteres Descrição: código hierárquico do Centro de Custo (ex.: “1.1.01”), que reproduz a estrutura em árvore usada também no Plano de Contas. Comportamento: não pode repetir a máscara de outro Centro de Custo; se repetir, a operação é bloqueada (ver Regra 1). Impacto: usada nos filtros de busca e na organização hierárquica da listagem. Tipo do Centro de Custo Tipo: seleção (Analítico / Sintético) Obrigatoriedade: obrigatório Descrição: define se o Centro de Custo é um agrupador (Sintético, não recebe lançamento direto) ou se recebe lançamento diretamente (Analítico). Comportamento: somente os Centros de Custo do tipo Analítico e Ativo aparecem nas listas de seleção usadas para lançamento (“ListarAnalitico”). Impacto: determina se o Centro de Custo pode ser selecionado diretamente em lançamentos contábeis. Entidade de Gastos Tipo: seleção (autocomplete) Obrigatoriedade: obrigatório no cadastro Descrição: entidade de gastos à qual o Centro de Custo está vinculado. Comportamento: obrigatória ao cadastrar; se não informada, o sistema bloqueia o cadastro (Regra 2). Se o código informado não corresponder a uma entidade existente, o cadastro também é bloqueado (Regra 3). Impacto: usada nos filtros de listagem e em relatórios que segmentam custos por entidade. Grupo do Centro de Custo Tipo: seleção Obrigatoriedade: obrigatório (parte do cadastro básico) Descrição: classificação do Centro de Custo em um grupo de negócio, entre os valores: Despesa, Custo produtivo, Custo auxiliar à produção, Receita, Avicultura (avós e matrizes, incubatório, frango de corte), Suinocultura (UPL, creche, recria, terminação) e Investimentos. Comportamento: convertido para descrição textual (ex.: “Despesa”) na listagem. Impacto: usado no filtro de listagem e em relatórios segmentados por grupo. Status Tipo: seleção (Ativo / Inativo) Obrigatoriedade: obrigatório Descrição: indica se o Centro de Custo está ativo ou inativo no sistema. Comportamento: um Centro de Custo Inativo não pode ser selecionado em outras rotinas que fazem a busca padrão com validação de status (ver Regra 6); ainda assim, pode ser editado ou excluído nesta própria tela mesmo estando inativo. Impacto: filtra a exibição nas listas de seleção ativas (“ListarAtivos”) e bloqueia o uso em lançamentos quando inativo. Tipo de Inscrição do Estabelecimento Tipo: seleção (CNPJ / CNO) Obrigatoriedade: condicional — necessário apenas quando
