Venda com entrada de vacinaRascunho

Eu, como usuário do sistema AgroDigital, quero buscar venda com entrada de vacina, listar venda com entrada de vacina, adicionar venda com entrada de vacina, visualizar venda com entrada de vacina e editar venda com entrada de vacina para gerenciar vendas com entrada de vacina.

Histórico da fonte

v1.0 - 10/07/2026: Primeira versão da história.

História de usuário

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

1. Buscar venda com entrada de vacina

Dado que estou na tela inicial para usuários autenticados
Quando acesso o menu Venda com Entrada de Vacina (Ver RNC007 - Permissões de Acesso)
Então o sistema exibe a tela de busca, contendo os seguintes filtros:

Campo	Tipo	Obrigatório	Validações	Valor padrão
Fornecedor	Seleção simples de entidade: fornecedor	Não	Valores = revendedoras de produtos agropecuários de outros estados e laboratórios	Vazio
Revendedora de Produtos Agropecuários	Seleção simples de entidade: revendedora de produtos agropecuários	Não	Valores = revendedoras de produtos agropecuários de Minas Gerais cadastradas no sistema	Vazio
Número da Nota Fiscal	Texto	Não	Tamanho = 255 caracteres	Vazio
Número de Partida	Texto	Não	Tamanho = 20 caracteres	Vazio
Doença	Seleção simples de entidade: doença	Não	Valores = doenças cadastradas no sistema	Vazio
Tipo de Vacina	Seleção simples de Entidade: tipo de vacina	Não	Valores = tipos de vacinas cadastradas	Vazio
Situação	Seleção simples	Não	Valores = “Gravado”, “Cancelado”	Vazio

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

2. Listar venda com entrada de vacina

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	Descrição
Fornecedor	Exibe o nome do laboratório/revendedora fornecedor de vacinas
Revendedora de Produtos Agropecuários	Exibe o Código/Nome da revendedora beneficiada
Número da Nota Fiscal	Exibe o número da nota fiscal da venda
Lotes	Exibe o Número de Partida - Laboratório - Doença - Tipo de Vacina (se aplicável) (Um ou mais)
Situação	Exibe a situação do cadastro

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

3. Adicionar venda com entrada de vacina

Dado que estou na tela de cadastro
Então o sistema exibe um formulário, contendo os seguintes campos:

Emitente

Campo	Tipo	Obrigatório	Editável	Validações
Fornecedor 🛈 Não encontrou o Fornecedor de Vacina? Entre em contato com o Escritório Seccional do IMA de sua região.	Seleção de entidade: fornecedor	Sim	Não	Valores = revendedoras de produtos agropecuários de outros estados e laboratórios Ao selecionar um laboratório que não produz vacina ou uma revendedora que não revende vacinas, o sistema deve alertar com uma mensagem fixada abaixo do campo, que a entidade não está cadastrada como produtor/revendedor de vacinas, mas não deve impedir o cadastro.

Destinatário

Campo	Tipo	Obrigatório	Editável	Validações
Revendedora de Produtos Agropecuários	Seleção simples de entidade: revendedora de produtos agropecuários	Sim	Não	Valores = revendedoras de produtos agropecuários de Minas Gerais cadastradas no sistema

Nota Fiscal

Campo	Tipo	Obrigatório	Editável	Validações
Número da Nota Fiscal	Inteiro	Sim	Não	Tamanho = 255 caracteres
UF da Nota Fiscal	Seleção pesquisável	Sim	Não	Valores = estados brasileiros
Data da Nota Fiscal	Data	Sim	Não	Deve ser menor ou igual a data atual

Lote de Vacina (Um ou mais)

Campo	Tipo	Obrigatório	Editável	Validações
Número de Partida	Texto	Sim	Não	Tamanho = 20 caracteres
Laboratório	Seleção simples de entidade: laboratório	Sim	Não	Se o “Fornecedor” selecionado for um laboratório, trazê-lo como somente leitura. Se for uma revendedora é possível selecionar. Valores = laboratórios cadastrados no sistema.
Doença	Seleção simples de entidade: doença	Sim	Não	Valores = doenças cadastradas no sistema Ao selecionar uma doença que o laboratório não produz vacina, o sistema deve alertar com uma mensagem fixada abaixo do campo, que o laboratório não está cadastrado como produtor de vacinas para a doença em questão, mas não deve impedir o cadastro.
Tipo de Vacina	Seleção simples	Sim	Não	Disponível quando a “Doença” for selecionada Valores = tipos de vacinas da doença selecionada
Validade	Data	Sim	Não	Formato = MM/AAAA. Deve ser maior ou igual a data atual.

Apresentação de Vacinas (Uma ou mais)

Campo	Tipo	Obrigatório	Editável	Validações
Número de Doses por Frasco	Inteiro	Sim	Não	-
Número de Frascos Adquiridos	Inteiro	Sim	Não	-
Total de Doses	Texto	Sim	Não	Somente leitura. Corresponde ao “Número de Frascos Adquiridos” multiplicado pelo “Número de Doses por Frasco”

Total do Lote

Campo	Tipo	Obrigatório	Editável	Validações
Total de Doses Adquiridas	Texto	Sim	Não	Somente leitura. Corresponde à soma de todos os valores colocados em “Total de Doses”

Total da Nota (Um ou mais) DIsponível para cada Tipo de Vacina informado nos lotes

Campo	Tipo	Obrigatório	Editável	Validações
Doença	Texto	Sim	Não	Somente leitura. Doenças selecionadas no cadastro
Tipo de Vacina	Texto	Sim	Não	Somente leitura. Tipos de vacina selecionados no cadastro, se houver
Total de Doses Adquiridas	Texto	Sim	Não	Somente leitura. Corresponde a soma de todas as doses adquiridas em lotes da vacina em questão

E exibe as seguintes ações: (Ver AC003 - Ações das telas de cadastro e AC006 - Ações de interação com formulários)

4. Visualizar venda com entrada de vacina

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, além desses, exibe os seguintes campos, também como somente leitura:

Situação

Campo	Obrigatório	Editável	Descrição
Situação	Sim	Sim	Valores = “Gravado”, “Cancelado”

E exibe as seguintes ações: (Ver AC004 - Ações das telas de visualizar e AC006 - Ações de interação com formulários)

5. Editar venda com entrada de vacina

Dado que estou na tela de edição
Então o sistema exibe todos os campos descritos nos critérios de aceitação 3 e 4, com seus valores já preenchidos
E permite editar todos os campos editáveis (EDT = Sim)
E exibe as seguintes ações: (Ver AC005- Ações das telas de editar e AC006 - Ações de interação com formulários)

Outras

Ação	Descrição
Cancelar	Disponível se não houver movimentação posterior ao cadastro no saldo do destinatário (revendedora de produtos agropecuários) Muda a situação do cadastro para “Cancelada”, não permitindo desfazer a ação.

Regras de negócio específicas

RNE001 - Quando o cadastro é efetuado, gera-se uma nota fiscal no sistema, definida da seguinte forma:
- Contém todas as informações descritas na seção da nota fiscal
- A chave de identificação única da Nota Fiscal é composta pelo Número da Nota Fiscal + Emitente
- A Nota Fiscal deve conter os lotes associados
RNE002 - Quando o cadastro é efetuado, geram-se os lotes, definidos da seguinte forma:
- Contém todas as informações descritas na seção de lotesLaboratório + Número de Partida
- A chave de identificação única do lote é composta pelo .
RNE003 - As doses cadastradas nessa venda devem ser lançadas no saldo do destinatário. O saldo é definido da seguinte forma:
- Deve ser discretizado com a seguinte hierarquia, para mapeamento correto das doses disponíveis:
  - Doença + Tipo de Vacina > Lote > Apresentação
  - Doses de um mesmo lote devem ser agrupadas juntas, para um mesmo destinatário, mesmo que sejam adquiridas por notas fiscais distintas.
- O sistema deve manter um mapeamento para associar o saldo em lotes com as notas fiscais (uma ou mais) que deram origem a ele.

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 RNE002 traz Laboratório + Número de Partida concatenado à descrição anterior e deixa vazia a frase da chave única. Confirmar se esses campos compõem a chave; o texto recebido foi preservado.
Número da Nota Fiscal é Inteiro com tamanho de 255 caracteres, mas o filtro é Texto. Confirmar o tipo e a preservação de zeros iniciais.
Validade usa MM/AAAA e comparação com a data atual sem definir qual dia representa o mês. Confirmar o critério.
A edição permite os campos EDT = Sim, mas os dados do cadastro têm EDT = Não; apenas Situação é editável na tabela da visualização. Confirmar se a alteração ocorre exclusivamente pela ação Cancelar.