Declaração de vacinaçãoRascunho

Eu, como usuário do sistema AgroDigital, quero buscar declaração de vacinação, listar declaração de vacinação, adicionar declaração de vacinação, visualizar declaração de vacinação, editar declaração de vacinação e validar dados do rebanho para gerenciar declarações de vacinação.

Histórico da fonte

v1.1 - 29/07/2026: Atualizações para contemplar o papel Produtor
v1.0 - 10/07/2026: Primeira versão da história.

História de usuário

Eu, como usuário do sistema, quero gerenciar declarações de vacinação, para que eu possa permitir a gestão eficiente dessas informações.

1. Buscar declaração de vacinação

Dado que estou na tela inicial para usuários autenticados
Quando acesso o menu Declaração de Vacinação
Então o sistema exibe a tela de busca, contendo os seguintes filtros:

Campo	Tipo	Obrigatório	Validações	Exemplo	Valor padrão
Etapa de Vacinação	Seleção simples de entidade: etapa de vacinação	Não	Valores = etapas de vacinação cadastradas no sistema”	“2026
Doença	Seleção simples de entidade: doença	Não	Somente leitura se “Etapa de Vacinação” for selecionado Valores = doenças cadastradas no sistema	“Brucelose”	Vazio
Tipo de Vacinação	Seleção simples	Não	Disponível se “Etapa de Vacinação” for selecionado” Valores = Tipos de vacinação cadastrados para a etapa em questão	“Vacina Oficial”	Vazio
Produtor	Seleção simples de entidade: produtor	Não	Dispónível se papel do usuário != Produtor: Valores = pessoas físicas ou jurídicas que são produtoras cadastradas no sistema	“José Aarão Neto - 555.009.956-40”	Vazio
Estabelecimento Agropecuário	Seleção simples de entidade: estabelecimento agropecuário	Não	Se o papel do usuário = Produtor: Valores = estabelecimentos agropecuários do produtor Senão: Valores = estabelecimentos agropecuários cadastrados no sistema	“Fazenda Rio Preto”	Vazio
Exploração Pecuária	Seleção simples de entidade: exploração pecuária	Não	Se o papel do usuário = Produtor: Valores = explorações pecuárias do produtor Senão: Valores = explorações pecuárias cadastrados no sistema	“3100203003910001”	Vazio
Núcleo de Produção	Seleção simples de entidade: núcleo de produção	Não	Se o papel do usuário = Produtor: Valores = núcleos de produção do produtor Senão: Valores = núcleos de produção cadastrados no sistema	“Núcleo A”	Vazio
Espécie	Seleção simples de entidade: espécie	Não	Valores = espécies cadastradas no sistema	“Bovino”	Vazio
Município do Estabelecimento Agropecuário	Seleção pesquisável	Não	Valores = municípios de Minas Gerais	“Lavras”	Vazio
Período - De:	Data	Não	Deve ser menor ou igual a data atual	“01/01/2026”	Vazio
Período - Até:	Data	Não	Deve ser maior ou igual à data informada no campo “Período - De:”	“31/02/2026”	Vazio
Situação	Seleção simples	Não	Valores = “Gravado”, “Cancelado”	“Ativo”	Vazio

E exibe as seguintes ações: (Ver AC001 - Ações das telas de busca)

2. Listar declaração de vacinação

Dado que estou na tela de busca
E o campo de busca e/ou pelo menos um dos filtros disponíveis foi corretamente preenchido
Quando realizo a ação “Pesquisar”
E o sistema encontrou registros compatíveis com os valores informados
Então o sistema exibe os resultados retornados, contendo os seguintes campos:

Campo	Tipo	Descrição	Exemplo
Etapa de Vacinação	Texto	Exibe a etapa de vacinação	“2026/01”
Doença	Texto	Exibe a doença da etapa de vacinação	“Brucelose”
Tipo de Vacinação	Texto	Exibe o tipo de vacinação	“Vacina Oficial”
Produtor	Texto	Exibe o CPF/CNPJ - Nome/Razão Social do produtor	“José Aarão Neto - 555.009.956-40”
Estabelecimento Agropecuário	Texto	Exibe o Código - Nome do estabelecimento agropecuário	“31234567891 - Fazenda do Rio”
Exploração Pecuária / Núcleo de Produção	Texto	Exibe o código da exploração / núcleo de produção	“312345678910109”
Espécie	Texto	Exibe a espécie explorada	“Bovino”
Município - UF	Texto	Exibe o Nome - UF do município do estabelecimento agropecuário	“Lavras - MG”
Data de Vacinação	Texto	Exibe a data de vacinação	“01/02/2026”
Situação	Texto	Exibe a situação da vacinação	“Ativo”

E exibe as seguintes ações: (Ver AC002 - Ações das telas de listagem)

3. Adicionar declaração de vacinação

Dado que estou na tela de atualização do rebanho de uma exploração ou núcleo
Então o sistema exibe um formulário, contendo os seguintes campos:

Informações Básicas

Campo	Tipo	Obrigatório	Validações	Exemplo	Valor padrão
Etapa de Vacinação	Seleção simples de entidade: etapa de vacinação	Sim	Se papel do usuário = Produtor ou Médico Veterinário ou Vacinador Valor = somente etapas atuais Se papel do usuário = Funcionário do IMA Valores = etapas de vacinação cadastradas no sistema, exceto as com status “Criada”(incluindo as passadas)	“2026/01”	Vazio
Justificativa de Autorização	Texto	Sim	Disponível se a o papel = Funcionário do IMA e a etapa selecionada já estiver fechada Tamanho = 1500 caracteres	“Foi permitido a declaração pois…”	Vazio
Tipo de Vacinação	Seleção simples	Sim	Valores = tipos de vacinação cadastrados para a etapa de vacinação	“Primeira Dose”	Vazio
Tipo de Vacina	Seleção simples	Não	Valores = tipos de vacinas possíveis cadastrados para o tipo de vacinação	“B19”	Vazio
Data da Vacinação	Data	Sim	Deve ser menor ou igual a data atual	01/01/2026	Vazio
Data do Atestado de Vacinação	Data	-	A obrigatoriedade deve ocorrer conforme o campo “Possui atestado obrigatório na declaração?” do Tipo de Vacinação da Etapa Valores = tipos de vacinas possíveis cadastrados para o tipo de vacinação Deve ser menor ou igual a data atual E maior ou igual a “Data de Vacinação”	01/01/2026	Vazio
Atestado de Vacinação	Arquivo	-	A obrigatoriedade deve ocorrer conforme o campo “Possui atestado obrigatório na declaração?” do Tipo de Vacinação da Etapa	atestado.pdf	Vazio

Informações do Rebanho Vacinado

Campo	Tipo	Obrigatório	Validações	Exemplo	Valor padrão
Produtor	Seleção simples de entidade: produtor	Sim	Se papel do usuário = Produtor Somente leitura Valor = o próprio produtor Se papel do usuário = Funcionário do IMA Valores = pessoas físicas ou jurídicas que são produtoras de explorações pecuárias cadastradas no sistema Se papel do usuário = Médico Veterinário ou Vacinador Valores = pessoas físicas ou jurídicas que são produtoras de explorações pecuárias cadastradas que o Médico Veterinário / Vacinador possui permissão para realizar a declaração	“José Aarão Neto - 555.009.956-40”	Vazio
Estabelecimento Agropecuário	Seleção simples de entidade: estabelecimento agropecuário	Sim	Disponível quando o “Produtor” for selecionado Valores = estabelecimentos agropecuários em que o “Produtor” está relacionado como produtor titular de pelo menos alguma de suas explorações pecuárias	“Fazenda Rio Preto”	Vazio
Município do Estabelecimento Agropecuário	Texto	Sim	Somente leitura Disponível quando o campo “Estabelecimento Agropecuário” for preenchido Deve corresponder ao cadastro informado no campo “Estabelecimento Agropecuário”	“Lavras”	Vazio
Exploração Pecuária	Seleção simples de entidade: exploração pecuária	Sim	Disponível quando o “Estabelecimento Agropecuário” for selecionado Valores = explorações pecuárias em que o “Produtor” está relacionado como produtor titular	“3100203003910001”	Vazio
Núcleo de Produção	Seleção simples de entidade: núcleo de produção	Sim	Disponível se a “Espécie Explorada” da “Exploração Pecuária” selecionada possuir controle de rebanho por núcleo Valores = núcleos de produção da exploração pecuária informada	“Núcleo A”	Vazio”

Informações do Responsável pela Vacinação

Campo	Tipo	Obrigatório	Validações	Exemplo	Valor padrão
Responsável pela Vacinação	Seleção simples	Sim	Disponível conforme cadastrado em “Autorizados à posse de doses” para o tipo de vacina selecionado Valores possíveis = “Produtor”, “Médico Veterinário”, “Médico Veterinário Cadastrado para Vacinação contra Brucelose”, “Vacinador contra Brucelose”	“Médico Veterinário”	Vazio
Produtor	Texto	Sim	Disponível se “Responsável pela Vacinação” = “Produtor” Somente Leitura Valor = mesmo produtor informado no campo “Produtor” acima	“João Dias Neto”	Vazio
Médico Veterinário	Seleção simples de entidade: profissional da área animal	Sim	Disponível se “Responsável pela Vacinação” = “Médico Veterinário” Valores = médicos veterinários cadastrados no sistema	“João Dias Neto”	Vazio
Médico Veterinário Cadastrado para Vacinação contra Brucelose	Seleção simples de entidade: profissional da área animal	Sim	Disponível se “Responsável pela Vacinação” = “Médico Veterinário Cadastrado para Vacinação contra Brucelose” ou “Vacinador contra Brucelose” Valores = médicos veterinários cadastrados para vacinação contra brucelose	“João Dias Neto”	Vazio
Vacinador Contra Brucelose	Seleção simples de entidade: vacinador contra brucelose	Sim	Disponível se “Responsável pela Vacinação” = “Vacinador contra Brucelose” Valores = vacinadores contra brucelose associados ao “Médico Veterinário Responsável” selecionado	“João Dias Neto”	Vazio

Saldo de Vacinas (Disponível após o “Responsável pela Vacinação” for informado)

Campo	Tipo	Obrigatório	Validações	Exemplo	Valor padrão
Saldo	Seleção múltipla de entidade: saldo de vacinas	Sim	Valores = saldos de vacina que estão no nome do “Responsável pela Vacinação” que ainda possuem alguma dose disponível e são do “Tipo de vacina” informado	-	Vazio

Lote [X] - [Nº de Partida], [Doença], [Tipo de Insumo], [Laboratório], [Validade], [Frascos], [Doses por Frasco], [Total de Doses] (Um ou mais) (Disponível para cada lote selecionado)

[Apresentação] (Uma ou mais)

Campo	Tipo	Obrigatório	Validações	Exemplo	Valor padrão
Gráfico	Gráfico	Sim	Somente leitura Deve exibir os dados separando o saldo por doses vencidas, perdidas, descartadas, utilizadas, disponíveis e doadas/partilhadas	-	-

Disponíveis

Campo	Tipo	Obrigatório	Validações	Exemplo	Valor padrão
Frascos	Inteiro	Sim	Somente Leitura Exibe de acordo com o saldo do lote	-	-
Doses	Inteiro	Sim	Somente Leitura Exibe de acordo com o saldo do lote	-	-

Utilizadas

Campo	Tipo	Obrigatório	Validações	Exemplo	Valor padrão
Frascos	Inteiro	Sim	Somente leitura Deve atualizar automaticamente considerando o valor selecionado dentro da seção “Distribuição por frasco”	-	-
Doses	Inteiro	Sim	Somente leitura Deve atualizar automaticamente considerando o valor selecionado dentro da seção “Distribuição por frasco”	-	-

Distribuição por frasco

Campo	Tipo	Obrigatório	Validações	Exemplo	Valor padrão
Tipo de Vacina	Texto	-	Somente leitura	-	-
Doses de Estoque	Texto	-	Somente leitura	-	-
Frascos Fechados	Texto	-	Somente leitura	-	-
Frascos Abertos	Texto	-	Somente leitura	-	-

Frascos abertos (Zero ou mais)

Campo	Tipo	Obrigatório	Validações	Exemplo	Valor padrão
Doses utilizadas	Inteiro	Sim	Deve respeitar o limite de doses nos fracos disponíveis	-	0

Uso completo

Campo	Tipo	Obrigatório	Validações	Exemplo	Valor padrão
Frascos utilizadas	Inteiro	Sim	Deve respeitar o limite de fracos disponíveis	-	0

Uso parcial (Zero ou mais)

Campo	Tipo	Obrigatório	Validações	Exemplo	Valor padrão
Doses utilizadas	Inteiro	Sim	Deve respeitar o limite de doses nos fracos disponíveis	-	0

Vacinação

Campo	Tipo	Obrigatório	Validações	Exemplo	Valor padrão
Doses Disponíveis	Inteiro	-	Exibe o total de doses disponíveis no saldo da origem para o tipo de vacina selecionado	-	-
Doses Utilizadas	Inteiro	-	Exibe a soma da quantidade de doses selecionadas como utilizadas no saldo	-	-
Doses Lançadas	Inteiro	-	Exibe, em tempo real, a quantidade de doses lançadas pelo usuário. Para concluir o cadastro, o total de doses lançadas deve ser igual ao total de doses informadas como utilizadas	-	-
Doses Restantes	Inteiro	-	Exibe a quantidade de doses restante, subtraindo-se o total de doses utilizadas	, -	-

Instruções de Vacinação (Disponível se “Tipo de Vacinação da Etapa” possuir “Instruções de Vacinação”

Campo	Tipo	Obrigatório	Validações	Exemplo	Valor padrão
Exibe a mensagem de instruções de vacinação conforme cadastrado na “Tipo de Vacinação da Etapa”, se houver

Faixa Etária (Uma ou mais)

Campo	Tipo	Obrigatório	Validações	Exemplo	Valor padrão
Faixa Etária	Texto	-	Somente leitura Valores = faixas etárias de vacinação informadas no “Tipo de vacinação” da “Etapa de vacinação” cadastradas para a espécie informada	“De 0 a 12 Meses”	Vazio

Animais (Disponível se “Possui Sexo Definido?” = “Não” para a espécie informada)

Campo	Tipo	Obrigatório	Validações	Exemplo	Valor padrão
Existentes	Texto	-	Somente leitura Exibe o quantitativo de animais no rebanho	10	Vazio
Já Vacinados	Texto	-	Disponível conforme cadastrado em “Exibir na Tabela de Vacinação” para o “Tipo de vacinação” da “Etapa de vacinação” Somente leitura Exibe o quantitativo de animais já vacinados na etapa	10	Vazio
Não Vacinados	Texto	-	Disponível conforme cadastrado em “Exibir na Tabela de Vacinação” para o “Tipo de vacinação” da “Etapa de vacinação” Somente leitura Exibe o quantitativo de animais não vacinados na etapa	10	Vazio
Vacinados	Inteiro	Não	Ver regra de negócio RNE001	4	Vazio

Machos (Disponível se “Possui Sexo Definido?” = “Sim” para a espécie informada E o “Tipo de Vacinação” envolver machos, conforme cadastrado na “Etapa de Vacinação”)

Campo	Tipo	Obrigatório	Validações	Exemplo	Valor padrão
Mesmos campos da seção “Animais”

Fêmeas (Disponível se “Possui Sexo Definido?” = “Sim” para a espécie informada E o “Tipo de Vacinação” envolver machos, conforme cadastrado na “Etapa de Vacinação”)

Campo	Tipo	Obrigatório	Validações	Exemplo	Valor padrão
Mesmos campos da seção “Animais”

Situação do cadastro (Disponível após o cadastro)

Campo	Tipo	Obrigatório	Validações	Exemplo	Valor padrão
Situação	Texto	-	Valores = Gravado, Cancelado	-	Vazio

E exibe as seguintes ações: (Ver AC003 - Ações das telas de cadastro)

4. Visualizar declaração de vacinação

Dado que estou na tela de visualização
Então o sistema exibe os campos do formulário descrito no critério de aceitação 3 como somente leitura, com seus valores já preenchidos
E exibe as seguintes ações: (Ver AC004 - Ações das telas de visualizar)

Ações de Navegação

Ação	Descrição
Baixar Comprovante	Baixa o comprovante de declaração de vacinação

5. Editar declaração de vacinação

Ações de Navegação

Ação	Descrição
Cancelar	Muda a situação do cadastro para “Cancelado” e reverte a declaração da vacina. Só é permitido cancelar uma declaração caso não haja outra declaração posterior para o rebanho em questão nem movimentação do rebanho. Quando o cadastro tem sua situação mudada para “Cancelado”, ela não pode voltar para a situação “Ativo” novamente.

6. Validar dados do rebanho

Dado que estou na tela de validação de dados do rebanho
Então o sistema exibe o formulário com os dados de rebanho da exploração pecuária selecionada para validação
E exibe as seguintes ações:

Ações de Navegação

Ação	Descrição
Acessar Cadastro para Editar	Vai para a tela de rebanho da exploração pecuária
Confirmar dados	Habilita o botão de avançar
Cancelar / Fechar	Volta para a tela de listagem
Salvar	Confirma a validade dos dados, salva a confirmação para não solicitar novamente e vai para a tela de declaração de vacina

Regras de negócio específicas

RNE001 – Validação e Confirmação da Declaração de Vacinação

O sistema deve tratar a declaração de vacinação conforme o perfil do declarante:

Produtor: antes de iniciar o lançamento da declaração, o sistema deve solicitar a confirmação de que o rebanho está atualizado. Caso o produtor informe que não, o sistema deve disponibilizar o direcionamento para a atualização do rebanho antes da realização da declaração. Caso confirme que sim, o sistema deve permitir o preenchimento da declaração, considerando os quantitativos registrados no rebanho como limite para os lançamentos.
Médico Veterinário ou Vacinador: o sistema deve permitir o lançamento da declaração sem exigir a atualização prévia do rebanho. Caso o quantitativo declarado seja superior ao quantitativo registrado no rebanho, o sistema deve gerar uma pendência de atualização do rebanho para o produtor, sem impedir o registro da declaração. A declaração somente deve ser efetivada após o atendimento das pendências aplicáveis.
Funcionário do IMA: o sistema deve permitir o lançamento da declaração sem exigir a atualização prévia do rebanho e sem considerar os quantitativos registrados no rebanho como limite para os lançamentos. Caso o quantitativo declarado seja realizado em uma etapa atual, e seja superior ao quantitativo registrado no rebanho, o sistema deve gerar uma pendência de atualização do rebanho para o produtor, sem impedir o registro da declaração.

RNE002 – Controle de Estoque de Vacinas por Frasco

O sistema deve realizar o controle do estoque de vacinas individualmente por lote, apresentação e frasco, permitindo identificar o quantitativo de doses disponível e a situação das doses de cada frasco.

Para cada frasco, o sistema deve controlar:

o lote ao qual pertence;
a apresentação da vacina e o quantitativo original de doses;
a quantidade de doses disponíveis;
a data de abertura, quando o frasco tiver sido aberto;
a situação das doses remanescentes.

As doses de cada frasco podem assumir as seguintes situações:

Disponíveis: doses que podem ser utilizadas, desde que atendidas as demais condições aplicáveis;
Vencidas: doses que não podem mais ser utilizadas em razão do vencimento da validade do respectivo lote;
Perdidas: doses remanescentes de um frasco aberto que não podem mais ser utilizadas em razão do término do prazo de utilização após a abertura;
Descartadas: doses que foram descartadas mediante registro no sistema.

Ao registrar uma declaração de vacinação, o sistema deve permitir a utilização somente de doses com situação Disponível.

O usuário deve informar separadamente as doses utilizadas de frascos abertos e de frascos fechados. Ao utilizar doses de um frasco aberto, o sistema deve reduzir o quantitativo disponível daquele frasco.

Ao utilizar doses de um frasco fechado, o sistema deve registrar sua abertura, a data de abertura e o quantitativo de doses utilizado. Caso permaneçam doses no frasco, o sistema deve mantê-lo como aberto e registrar o saldo remanescente para utilização posterior.

Quando todas as doses disponíveis de um frasco forem utilizadas, o sistema deve considerar o frasco como esgotado.

O sistema deve manter o controle individual dos frascos mesmo quando pertencentes ao mesmo lote e à mesma apresentação, permitindo identificar a origem e a movimentação das doses utilizadas, vencidas, perdidas ou descartadas.

O sistema deve controlar a validade das doses conforme a validade do lote e, para vacinas que possuam prazo de utilização após a abertura, conforme o prazo definido no cadastro do tipo de vacina.

RNE003 – Controle do Prazo de Utilização da Vacina

O sistema deve controlar a validade das doses considerando:

Vencimento do lote: determinado pela data de validade cadastrada no lote. Ao atingir essa data, as doses remanescentes devem assumir a situação “Vencidas”.
Vencimento após abertura: aplicável aos tipos de vacina configurados com “Possui vencimento após abertura do frasco?” = “Sim”. Nesse caso, as doses remanescentes devem ser utilizadas dentro do prazo definido em “Tempo de vencimento após abertura (em dias)”, contado a partir da data de abertura do frasco. Após esse prazo, devem assumir a situação “Perdidas”.

A abertura do frasco pode ser registrada por meio de uma declaração de vacinação ou de um ajuste de doses.

Na declaração de vacinação, o sistema deve considerar a data da vacinação informada para verificar se a dose estava válida no momento da aplicação. Assim, uma declaração realizada após o vencimento não deve impedir a utilização da dose quando a data da vacinação respeitar a data de validade aplicável, observadas as demais regras de estoque.

Quando o tipo de vacina não possuir vencimento após a abertura, a abertura do frasco não deve alterar a situação das doses, permanecendo aplicável apenas a validade do lote.

RNE004 - Geração do PDF da Declaração de Vacinação

Após a declaração de vacinação, o sistema deve gerar um documento de comprovação de vacinação conforme os templates apresentados abaixo para cada doença:

BRUCELOSE (ver imagem)

Modelo de comprovante da fonte

RAIVA DOS HERBÍVOROS (ver imagem)

Modelo de comprovante da fonte

Documentos vinculados

Convenções da conversão

As colunas Obrigatório e Editável correspondem a OBG e EDT da fonte. A edição posterior observa também as condições de somente leitura e de situação do cadastro. Campos, exemplos, padrões e referências recebidos foram preservados, sem criar valores ausentes.

Pendências da fonte

A fonte não informa código US; nenhum identificador foi criado.
A linha do filtro Etapa de Vacinação contém exemplo truncado; os exemplos 31/02/2026 e Ativo divergem da data válida e das situações Gravado/Cancelado. Os valores recebidos foram preservados.
Tipo de Vacina é opcional, mas controla responsável autorizado e saldo. Confirmar quando o preenchimento é necessário.
A configuração de atestado obrigatório é atribuída ao Tipo de Vacinação da Etapa nesta fonte, mas aparece na seção geral da etapa. Confirmar o nível da configuração.
A condição de Fêmeas exige que o tipo de vacinação envolva machos. Confirmar se deveria envolver fêmeas; a condição recebida foi preservada.
A seleção de saldo exige doses ainda disponíveis, mas a RNE003 permite declaração posterior ao vencimento quando a aplicação ocorreu em data válida. Confirmar como selecionar e validar o saldo histórico.
A RNE001 condiciona efetivação de declaração por médico/vacinador ao atendimento de pendências, mas não define situação intermediária nem o momento do débito de estoque.
A validação inicial do rebanho diz para salvar a confirmação e não solicitar novamente, mas não define prazo ou eventos que invalidam essa confirmação.
O lote é rotulado Tipo de Insumo em uma declaração de vacina. A fonte também usa Ativo no texto do cancelamento, enquanto as situações declaradas são Gravado e Cancelado.
A Data do Atestado traz validação de valores de tipos de vacina, incompatível com campo Data. Confirmar a regra temporal e os formatos/tamanho do arquivo de atestado.
Confirmar como o cancelamento reverte doses e abertura dos frascos e como combinar perda após abertura com o vencimento do lote. Os modelos de PDF foram preservados em arquivos locais.