▶ Tutorial em vídeo: ainda não disponível para esta rotina.

Dependências

Não há dependência de cadastro prévio obrigatório para criar um livro modelo básico; porém, a sincronização de filiais depende do cadastro de filiais (tela de Filiais) já estar preenchido no sistema.

Passo 1: Acessar a rotina

O usuário acessa “Contabilidade / Cadastros / Livros Contábeis/Fiscais” e clica no botão de novo cadastro.

Passo 2: Preencher o código do livro

O usuário informa o “Código do livro”, com até 3 caracteres. Esse código é a chave que identifica o livro modelo e não pode ser repetido.

Passo 3: Preencher a descrição e a página máxima

O usuário informa a “Descrição” do livro (até 50 caracteres) e o “Número máximo de página” — o limite de páginas que o livro pode atingir antes de trocar de numeração.

Passo 4: Informar a versão do layout (quando aplicável)

O usuário pode informar a “Versão do layout” vinculada ao formulário de impressão do livro.

Passo 5: Salvar

O usuário confirma o cadastro. O sistema grava o novo livro modelo e exibe a mensagem “Livro Modelo inserido com sucesso”.

Passo 6: Sincronizar as filiais

Após criar o livro, o usuário utiliza a ação “Atualizar Filiais” para que o sistema inclua automaticamente, na numeração do livro, todas as filiais cadastradas que ainda não têm numeração própria para ele (cada uma começa zerada, com número de livro e de página iguais a zero).

Código do livro (campo IDDoLivro, tela Livros Contábeis/Fiscais)

Tipo: texto

Obrigatoriedade: obrigatório

Descrição: código que identifica de forma única o livro modelo cadastrado (ex: livro Diário, livro Razão).

Comportamento: aceita até 3 caracteres; é a chave usada para localizar o livro em consultas, edição e nas telas de numeração por filial.

Impacto: usado como chave de vínculo em todas as linhas de numeração por filial (tela de edição) e nos relatórios/exportações da rotina.

Descrição (campo DescricaoLivro, tela Livros Contábeis/Fiscais)

Tipo: texto

Obrigatoriedade: opcional

Descrição: nome/descritivo do livro modelo, exibido nas listagens e telas de seleção.

Comportamento: aceita até 50 caracteres; compõe o texto “[Código] – [Descrição] – Versão: [Versão]” usado em campos de busca/lookup em outras telas do sistema.

Impacto: aparece na listagem principal da rotina e em qualquer tela do sistema que use o livro modelo como referência de seleção.

Página máxima (campo PaginaMaxima, tela Livros Contábeis/Fiscais)

Tipo: número

Obrigatoriedade: obrigatório

Descrição: quantidade máxima de páginas permitida para o livro antes de ser necessário abrir um novo volume/numeração.

Comportamento: aceita valores numéricos inteiros (tipo curto/short); usado como parâmetro de controle da numeração de página do livro.

Impacto: usado como referência no controle de numeração sequencial de páginas do livro contábil/fiscal.

Versão do layout (campo VersaoLayout, tela Livros Contábeis/Fiscais)

Tipo: texto

Obrigatoriedade: opcional

Descrição: identifica a versão do layout de formulário vinculado ao livro, usado para geração/impressão do livro no leiaute correto.

Comportamento: campo de texto livre.

Impacto: [informação não disponível na análise de código — validar com analista se há tela de seleção estruturada para esse campo, já que a entidade de domínio referencia um cadastro de LayoutFormulario].

Filial (campo IDDaFilial / NomeDaFilial, grade de numeração por filial dentro da tela de edição do livro)

Tipo: seleção (lista de filiais cadastradas)

Obrigatoriedade: obrigatório para cada linha da grade de numeração

Descrição: identifica a filial à qual aquela linha de numeração pertence.

Comportamento: preenchido automaticamente ao usar “Atualizar Filiais” (traz todas as filiais que ainda não tinham numeração para o livro) ou informado manualmente ao adicionar uma linha na edição.

Impacto: define para qual filial o número de livro/página informado se aplica.

Número do livro atual (campo NumeroLivroAtual, grade de numeração por filial)

Tipo: número

Obrigatoriedade: obrigatório para cada linha da grade

Descrição: número do livro que está correntemente em uso por aquela filial.

Comportamento: iniciado em zero quando a filial é incluída via “Atualizar Filiais”; pode ser ajustado manualmente na edição.

Impacto: usado no controle sequencial legal da escrituração contábil/fiscal daquela filial.

Número da página atual (campo NumeroPaginaAtual, grade de numeração por filial)

Tipo: número

Obrigatoriedade: obrigatório para cada linha da grade

Descrição: número da página que está correntemente em uso por aquela filial dentro do livro atual.

Comportamento: iniciado em zero quando a filial é incluída via “Atualizar Filiais”; comparado ao limite definido em “Página máxima” para controle de virada de página/livro.

Impacto: usado no controle sequencial legal da escrituração contábil/fiscal daquela filial.

Na tela de listagem, o usuário pode pesquisar livros modelo digitando um valor no campo de busca. O sistema interpreta esse valor de forma automática: se o texto digitado for um número, a busca localiza livros cujo formulário vinculado tenha aquele ID, ou cuja página máxima seja igual ao número digitado, ou cujo código do livro seja exatamente igual ao texto; se o texto não for numérico, a busca localiza livros cujo código seja exatamente igual ao texto digitado ou cuja descrição contenha o texto buscado. A listagem também suporta paginação e ordenação pelas colunas Código, Versão do layout, Descrição e Página máxima.

Na edição de um livro modelo, o usuário pode alterar a Descrição, a Página máxima e a Versão do layout, além de ajustar a numeração corrente (número de livro e de página) de cada filial já vinculada, ou adicionar novas linhas de filial diretamente na grade. O Código do livro (IDDoLivro) é a chave do registro; embora o campo apareça na tela, ele identifica o registro sendo editado — [informação não disponível na análise de código — validar com analista se o campo de código fica bloqueado (somente leitura) na tela de edição, já que essa trava é normalmente feita na camada de tela/JavaScript, não no controller]. Toda edição salva grava simultaneamente a lista completa de filiais informada — não existe uma ação separada para editar a numeração de uma única filial isoladamente pela tela de edição.

Esta rotina não realiza integrações automáticas com lançamentos contábeis, estoque ou documentos fiscais — ela apenas mantém o cadastro de referência de numeração dos livros. A ação “Atualizar Filiais” é a única integração automática da rotina: ela consulta o cadastro de Filiais do sistema e inclui, na numeração do livro, qualquer filial ainda não vinculada, com numeração zerada.

Regra 1 — Busca inteligente na listagem

Quando o usuário digita um valor de busca na tela de listagem, o sistema decide automaticamente o critério de filtro conforme o tipo do valor digitado (numérico ou texto), como detalhado na seção 6. Isso significa que buscar por um número pode retornar resultados por três critérios diferentes ao mesmo tempo (formulário vinculado, página máxima ou código exato).

Regra 2 — “Atualizar Filiais” só inclui, nunca remove

Ao clicar em “Atualizar Filiais”, o sistema inclui automaticamente uma linha de numeração zerada para cada filial do cadastro de Filiais que ainda não tenha numeração para aquele livro. Filiais que já possuem numeração não são alteradas, e filiais que tenham sido excluídas do cadastro de Filiais não são removidas da numeração do livro por esta ação.

Regra 3 — Exclusão remove toda a numeração do livro

Ao excluir um livro modelo, o sistema remove automaticamente, sem aviso prévio, todas as linhas de numeração por filial associadas àquele livro. Não há mensagem de confirmação de negócio adicional nem bloqueio de exclusão por dependência — a rotina não implementa nenhuma mensagem de erro própria para impedir a exclusão de um livro em uso.

Regra 4 — Edição da numeração é sempre em lote

Ao salvar a edição de um livro modelo, o sistema recebe a lista completa de filiais/numeração da tela e concilia registro a registro: se a filial já constava na numeração do livro, os números são sobrescritos pelos valores informados na tela; se a filial ainda não constava, ela é adicionada. Não é possível editar a numeração de apenas uma filial sem reenviar a lista inteira da tela.