Venda com saída de insumoRascunho

Eu, como usuário do sistema AgroDigital, quero buscar venda com saída de insumo, listar venda com saída de insumos, adicionar venda com saída de insumo, visualizar venda com saída de insumos e editar venda com saída de insumos para gerenciar vendas com saída de insumo.

Histórico da fonte

v1.1 - 05/08/2026: Conversão para o formato completo.
v1.0 - 31/07/2026: Primeira versão da história.

História de usuário

Eu, como usuário do sistema, quero gerenciar venda com saída de insumos para exames, para que eu possa permitir a gestão eficiente dessas informações.

1. Buscar venda com saída de insumo

Dado que estou na tela inicial para usuários autenticados
Quando acesso o menu Venda com Saída de Insumos
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: revendedora 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 = “Médico Veterinário Habilitado PNCEBT”, “Instituição de ensino e pesquisa”, “Laboratório”, “Responsável Técnico GRSC”, “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 Insumo	Seleção simples de entidade: tipo de insumo	Não	Valores = tipos de insumo cadastrados no sistema
Situação	Seleção simples	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 insumos

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 ordenados pelo nome, contendo os seguintes campos:

Campo	Descrição
Fornecedor	Exibe “Código/Nome” do fornecedor de insumos
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 Insumo (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 insumo

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 simples 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 insumos para exames de brucelose/tuberculose, o sistema deve alertar com uma mensagem fixada abaixo do campo, que a entidade não está cadastrada como revendedora de exames para a doença em questão, 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 = “Médico Veterinário Habilitado PNCEBT”, “Instituição de Ensino e Pesquisa”, “Laboratório”, “Responsável Técnico GRSC”, “Revendedora de Produtos Agropecuários”
Destinatário de fora do estado?	Seleção simples	Sim	Não	Valores = “Sim”, “Não”

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

Campo	Tipo	Obrigatório	Editável	Validações
Destinatário	Seleção simples de entidade: profissional da área animal	Sim	Não	Valores = profissionais da área animal cadastrados no sistema que são habilitados para realização de exame de brucelose/tuberculose

(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 cadastrados no sistema

(Disponível se “Tipo de Destinatário” = “Instituição de Ensino e Pesquisa”)

Campo	Tipo	Obrigatório	Editável	Validações
Destinatário	Seleção simples de entidade: instituição de ensino e pesquisa	Sim	Não	Valores = instituições de ensino e pesquisa cadastradas no sistema

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

Campo	Tipo	Obrigatório	Editável	Validações
Destinatário	Seleção simples de entidade: laboratório	Sim	Não	Valores = laboratórios cadastrados no sistema

(Disponível se “Tipo de Destinatário” = “Responsável Técnico GRSC”)

Campo	Tipo	Obrigatório	Editável	Validações
Destinatário	Seleção simples de entidade: profissional da área animal	Sim	Não	Valores = profissionais da área animal cadastradas no sistema que são responsáveis técnicos de uma GRSC

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	Deve ser menor ou igual a “Data Atual”

Saldo de Insumos

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

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)

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

Requerimento

Campo	Tipo	Obrigatório	Editável	Validações
Requerimento	Arquivo	Sim	Nã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 saída de insumos

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 visualização e AC006 - Ações de interação com formulários)

5. Editar venda com saída de insumos

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 passíveis de edição (EDT = Sim)
E exibe as seguintes ações: (Ver AC005 - Ações das telas de edição 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 Insumo > 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.
RNE005 - Ao cadastrar uma venda de insumo, o sistema deve verificar se o destinatário está apto para a compra, conforme o campo “Autorizados à posse de doses” do tipo de insumo selecionado e, quando o destinatário for Médico Veterinário, se possui habilitação regular para exames. Caso o destinatário não atenda a qualquer uma das condições aplicáveis, o sistema deve impedir o cadastro da venda e apresentar uma mensagem de alerta para cada tipo de insumo cuja compra não seja permitida. Quando as validações forem atendidas, o sistema deve permitir o cadastro da venda e o lançamento do insumo no saldo do destinatário.

Documentos vinculados

Convenções e ações comuns

As colunas Obrigatório e Editável correspondem a OBG e EDT da fonte. Editável = Não restringe a alteração posterior ao cadastro; não impede a informação inicial dos campos. As indicações explícitas de somente leitura e as condições de exibição foram preservadas.

As ações comuns AC001 a AC006 e a regra de permissões RNC007 são aplicadas nos pontos citados pela fonte. Não foram criados exemplos ou valores padrão ausentes do arquivo recebido.

Pendências da fonte

A fonte não informa código US. Nenhum identificador foi criado para esta conversão.
Destinatário de fora do estado? não possui condições ou campos associados. Confirmar como consultar ou informar destinatários externos.
O filtro CPF/CNPJ exige 14 caracteres, sem esclarecer o tratamento do CPF com 11 dígitos e das máscaras.
A RNE003 determina crédito no destinatário, mas não explicita o débito e a classificação das doses no emitente, nem o estorno dos dois saldos no cancelamento.
A RNE005 aplica a autorização de posse do tipo de insumo às entidades destinatárias, mas Tipo de Insumo lista apenas categorias de veterinários. Confirmar a autorização para as demais entidades.
A numeração salta de RNE003 para RNE005; nenhuma RNE004 foi criada.
A listagem exige ordenação pelo nome sem identificar qual nome. A expressão Informação Dose não é definida.
Os campos do cadastro têm Editável = Não; a Situação é marcada Editável = Sim em uma visualização descrita como somente leitura. Confirmar se apenas a ação Cancelar controla a situação.
A fonte não define formatos ou tamanho máximo do Requerimento nem mínimos de frascos adquiridos.