Venda com saída de vacinaRascunho

Eu, como usuário do sistema AgroDigital, quero buscar venda com saída de vacina, listar venda com saída de vacina, adicionar venda com saída de vacina, visualizar venda com saída de vacina e editar venda com saída de vacina para gerenciar vendas com saída 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 saída de vacinas, para que eu possa permitir a gestão eficiente dessas informações.

1. Buscar venda com saída de vacina

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

Campo	Tipo	Obrigatório	Validações
Revendedora de Produtos Agropecuários	Seleção simples de entidade: revendedoras de produtos agropecuários	Não	Valores = revendedoras de produtos agropecuários de Minas Gerais cadastradas no sistema
Tipo de Destinatário	Seleção simples	Não	Valores = “Produtor”, “Vacinador”, “Médico Veterinário”, “Revendedora de Produtos Agropecuários”
Destinatário	Texto	Não	Tamanho = 255 caracteres
CPF/CNPJ do Destinatário	Texto	Não	Tamanho = 14 caracteres
Número da Nota Fiscal	Texto	Não	Tamanho = 255 caracteres
Número de Partida	Texto	Não	Tamanho = 20 caracteres
Laboratório	Seleção simples de entidade: laboratório	Não	Valores = laboratórios cadastrados no sistema
Doença	Seleção simples de entidade: doença	Não	Valores = doenças cadastradas no sistema
Tipo de Vacina	Seleção simples de entidade: tipo de vacina	Não	Valores = tipos de vacinas cadastradas no sistema
Situação	Seleção	Não	Valores = “Gravado”, “Cancelado”

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

2. Listar venda com saída 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
Revendedora de Produtos Agropecuários	Exibe o Código/Nome da revendedora
Destinatário	Exibe “CPF/CNPJ - Nome/Razão Social” do destinatário
Número da Nota Fiscal	Exibe o número da nota fiscal
Lotes	Exibe o Número de Partida - Laboratório - Doença - Tipo de Vacina (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 saída 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
Revendedora de Produtos Agropecuários	Seleção de entidade: revendedora de produtos agropecuários	Sim	Não	Valores = revendedoras de produtos agropecuários de Minas Gerais cadastradas no sistema Ao selecionar 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 revendedora de vacinas, mas não deve impedir o cadastro.

Destinatário

Campo	Tipo	Obrigatório	Editável	Validações
Tipo de Destinatário	Seleção simples	Sim	Não	Valores = “Produtor”, “Vacinador”, “Médico Veterinário”, “Revendedora de Produtos Agropecuários”
Destinatário possui cadastro no IMA?	Seleção simples	Sim	Não	Valores = “Sim”, “Não”
Destinatário de fora do estado?	Seleção simples	Sim	Não	Valores = “Sim”, “Não”

(Disponível se “Destinatário tem cadastro no IMA?” = “Sim”)

(Disponível se “Tipo de Destinatário” = “Revendedora de Produtos Agropecuários”)

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

(Disponível se “Tipo de Destinatário” = “Produtor”)

Campo	Tipo	Obrigatório	Editável	Validações
Destinatário	Seleção de entidade: pessoa	Sim	Não	Valores = pessoas físicas ou jurídicas que são produtoras cadastradas no sistema

(Disponível se “Tipo de Destinatário” = “Médico Veterinário”)

Campo	Tipo	Obrigatório	Editável	Validações
Destinatário	Seleção de entidade: profissional da área animal	Sim	Não	Valores = profissionais da área animal que são médicos veterinários cadastrados no sistema

(Disponível se “Tipo de Destinatário” = “Vacinador”)

Campo	Tipo	Obrigatório	Editável	Validações
Destinatário	Seleção de entidade: vacinador contra brucelose	Sim	Não	Valores = vacinadores contra brucelose cadastrados no sistema

(Disponível se “Destinatário tem cadastro no IMA?” = “Não”)

Campo	Tipo	Obrigatório	Editável	Validações
Destinatário ⚠︎ Caso possua atividade agropecuária em Minas Gerais, recomenda-se realizar o cadastro no IMA.	Texto	Sim	Não	Tamanho = 255 caracteres
CPF/CNPJ do Destinatário	Inteiro	Sim		Tamanho = 11 ou 14 caracteres

Contatos simples

Campo	Tipo	Obrigatório	Validações	Exemplo	Valor padrão
Tipo de Contato (E-mail)	Texto	Sim	Somente leitura.	`E-mail`	E-mail
E-mail	Texto curto	Sim	Formato = e-mail válido.	`joaquim@email.com`	Vazio
Observação do e-mail	Texto longo	Não	Tamanho máximo = 1.500 caracteres.	`Meu e-mail`	Vazio
Tipo de Contato (Telefone)	Texto	Sim	Somente leitura.	`Telefone`	Telefone
Número	Texto numérico	Sim	Tamanho = 11 dígitos. Formato = (XX) XXXXX-XXXX.	`(35) 99999-1111`	Vazio
Observação do telefone	Texto longo	Não	Tamanho máximo = 1.500 caracteres.	`Meu telefone`	Vazio
Tipo de Contato (outros)	Seleção simples	Sim	Valores = E-mail, Telefone.	`Telefone`	E-mail
E-mail (outros)	Texto curto	Sim	Disponível se Tipo de Contato = E-mail. Formato = e-mail válido.	`joaquim_junior@email.com`	Vazio
Número (outros)	Texto numérico	Sim	Disponível se Tipo de Contato = Telefone. Tamanho = 11 dígitos. Formato = (XX) XXXXX-XXXX.	`(35) 99999-1111`	Vazio
Observação (outros)	Texto longo	Não	Tamanho máximo = 1.500 caracteres.	`Contato do meu filho`	Vazio

A seção admite zero ou mais contatos, conforme a fonte.

Nota Fiscal

Campo	Tipo	Obrigatório	Editável	Validações
Número da Nota Fiscal	Texto	Sim	Não	Tamanho = 255 caracteres
UF da Nota Fiscal	Seleção	Sim	Não	Somente leitura Valor = Minas Gerais
Data da Nota Fiscal	Data	Sim	Não	Formato = DD/MM/AAAA

Saldo de Vacinas

Campo	Tipo	Obrigatório	Editável	Validações
Saldo	Seleção múltipla de entidade: saldo de vacinas	Sim	Não	Valores = saldo de vacinas que estão no nome da “Revendedora de Produtos Agropecuários” emitente

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

[Apresentação] (Uma ou mais)

Informações das Doses (Disponível para cada “Informação Dose”)

Campo	Tipo	Obrigatório	Editável	Validações
Gráfico	Gráfico	Sim	Não	Somente leitura Deve exibir os dados separando o saldo por doses vencidas, descartadas, vendidas e disponíveis

Disponíveis

Campo	Tipo	Obrigatório	Editável	Validações
Frascos	Inteiro	Sim	Não	Somente Leitura Exibe de acordo com o saldo do lote
Doses	Inteiro	Sim	Não	Somente Leitura Exibe de acordo com o saldo do lote

Adquiridas

Campo	Tipo	Obrigatório	Editável	Validações
Frascos	Inteiro	Sim	Não	Deve ser menor ou igual que os Disponíveis
Doses	Inteiro	Sim	Não	Somente leitura Deve atualizar automaticamente conforme o valor de “Frascos”, considerando o número de doses por frascos da apresentação

Receituário (Disponível se tipo de Destinatário = “Produtor”, “Vacinador” ou “Médico Veterinário”) (Disponível para cada “Tipo de Vacina” do Número de Partida selecionado que exigir receituário para venda de vacina)

Campo	Tipo	Obrigatório	Editável	Validações
Receituário para [Nome do Tipo de Vacina]	Arquivo	Sim	Não	-
Médico Veterinário Emissor	Seleção de entidade: profissional da área animal	Sim	Não	Para Tipo de Destinatário = “Vacinador” ou “Médico Veterinário”: Valor = O proprio médico veterinário ou médico veterinário responsável pelo vacinador Para Produtor: Valor = profissionais da área animal que são médicos veterinários cadastrados no sistema
CRMV	Texto	Sim	Não	Somente leitura. CRMV do profissional da área animal selecionado

Coleta de Informações Adicionais

Campo	Tipo	Obrigatório	Editável	Validações
Possui previsão de uso das vacinas em explorações pecuárias específicas?	Seleção Simples	Sim	Não	Valores = “Sim”, “Não”, “Não sei informar” Valor padrão = “Não”
Exploração Pecuária	Seleção simples de entidade: exploração pecuária	Sim	Não	Disponível se “Possui previsão de uso das vacinas em explorações pecuárias específicas?” = “Sim” (Uma ou mais) Valores = explorações pecuárias cadastradas no sistema

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 saída 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	Tipo	Obrigatório	Editável	Descrição
Situação	Seleção simples	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 saída 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 apenas a Situação
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 emitente (revendedora de produtos agropecuários) e do destinatário (múltiplas entidades) Muda a situação do cadastro para “Cancelado”, 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 lotes
- A chave de identificação única do lote é composta pelo Laboratório + Número de Partida.
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.
RNE004 - Ao cadastrar uma venda de vacina, o sistema deve verificar se o destinatário está apto para a posse, conforme os campos “Autorizados à posse de doses” e “Exige cadastro para a venda da vacina?” dos tipos de vacina selecionados. Caso o destinatário não atenda a qualquer uma das condições aplicáveis, o sistema deve impedir o cadastro e apresentar uma mensagem de alerta para cada tipo de vacina cuja posse não seja permitida. Quando as validações forem atendidas, o sistema deve permitir o cadastro e o lançamento das doses no saldo do destinatário.

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.
As condições citam Destinatário tem cadastro no IMA?, enquanto o campo se chama Destinatário possui cadastro no IMA?. Confirmar o rótulo controlador.
Destinatário de fora do estado? não possui campos ou condições associados. Confirmar o tratamento do destinatário externo.
O filtro CPF/CNPJ exige 14 caracteres, mas o cadastro admite 11 ou 14 e usa tipo Inteiro. Confirmar o tratamento do CPF, zeros iniciais e máscaras; o EDT desse campo está vazio.
A autorização à posse de doses lista categorias de pessoas no tipo de vacina, enquanto a venda também admite revendedoras. Confirmar a representação da autorização para revendedoras.
A RNE003 explicita o crédito no destinatário, mas não detalha o débito no emitente ou o estorno de ambos no cancelamento.
A fonte não define formatos e limites do receituário, nem validação temporal para a Data da Nota Fiscal. A seção Contato foi vinculada ao componente Contatos simples, preservando zero ou mais itens.