~~ODT~~ echo "
"; echo "Última atualização: "; ver('', false); echo "
"; ====== Cadastro Ordem de Fornecimento ====== Este caso de uso permite aos fiscais e gestores do contrato cadastrar os prazos de entrega/instalação, informando os endereços e os itens para cada Ordem de Fornecimento. Ao final do cadastro, o fornecedor é notificado por email sobre a lista de endereço e o prazo. ===== Descrição do Caso de Uso ===== Este caso de uso inicia quando o usuário acessa a opção: //SIPAC → Portal Administrativo → Contratos → Pagamento Online-> Ordem de Fornecimento → Cadastrar Ordem Fornecimento. // ====Passo 1==== O Usuário informa um ou mais filtros especificados na consulta do caso de uso [[desenvolvimento:especificacoes:sipac:contratos:casos_de_uso:consultas_relatorios:gerais:listar_contratos| Listar Contratos ]]. O Usuário seleciona o contrato e consequentemente é direcionado para o passo 2. ====Passo 2 ===== Após o usuário seleciona o contrato para a inserção das Ordem de fornecimento, e o Sistema exibe as informações gerais especificadas no caso de uso [[desenvolvimento:especificacoes:sipac:contratos:casos_de_uso:consultas_relatorios:gerais:contrato_detalhado|Contrato Detalhado]]. O Sistema solicita : * **__Dados da Ordem de Fornecimento__** * **__Tipo de Ordem__***: Tipo TEXTO. Opções ENTREGA, INSTALAÇÃO E UNIFICADA. * **__Prazo de Entrega__***: Tipo DATA. Formato: DD/MM/AAAA. Aparece caso opção seja //Entrega// * **__Prazo de Instalação__***: Tipo DATA. Formato: DD/MM/AAAA.Aparece caso opção seja //Instalação.// Em seguida existe a funcionalidade de inserir endereço. ==== Passo 3 ==== O usuário pode inserir os endereços que farão parte da Ordem de Fornecimento. Tendo o campos para realizar a pesquisa do endereços: * **Razão Social**: Tipo - TEXTO. * **CEP**: Tipo NUMÉRICO, formato: 99999-999. * Caso o endereço seja um Código de Endereçamento Postal, os campos: Logradouro, Bairro, UF e Cidade serão automaticamente preenchidos. * **Logradouro**: Tipo TEXTO. * **Bairro**: Tipo TEXTO. * **UF***: Tipo TEXTO, formato: SIGLA ESTADO, representa o UF onde a garagem está localizada. * **Cidade***: Tipo TEXTO. E opção de buscar todos os endereços. Em seguida é exibida a lista com os endereço de execução encontrados, no quais são apresentadas as seguintes informações: * **__Razão Social__**: Tipo - TEXTO e NÚMERICO. * **__Cidade__**: Tipo - TEXTO. * **__Estado__**: Tipo - TEXTO. * **__Endereço__**: Tipo - TEXTO, Formato - "LOGRADOURO, NÚMERO, BAIRRO, COMPLEMENTO". Sendo possível escolher um endereço. É exibido uma lista com todos os endereço já adicionados: * **__Razão Social__**: Tipo - TEXTO e NÚMERICO. * **__Cidade__**: Tipo - TEXTO. * **__Estado__**: Tipo - TEXTO. Sendo possível para cada endereço //adicionar, editar, apagar// itens . ==== Passo 4 ==== Ao inserir itens ao endereço teremos duas opções: * Inserir Itens do Contrato * Informar Valores Totais Quando o usuário escolhe //Inserir Itens do Contrato// será exibido um lista de itens disponíveis: * **__Título__**: Título do item. Tipo TEXTO. * **__Natureza da Despesa__**: Natureza da Despesa do item. Tipo TEXTO. * **__Descrição__**: Descrição de item. Tipo TEXTO. * **__Unid. Medida__**: Unidade de medida do item. Tipo TEXTO. * **__Quant. Disponíveis__**: Unidade itens disponível. Tipo NÚMERICO * ** Quantidade Solicitada **: Tipo NÚMERICO * **__Valor__**: Valor unitário do item. Tipo MONETÁRIO. Com a inserção do itens do contrato será mostrado uma lista com todos os itens inseridos. com os sequintes dados: * **__Título__**: Título do item. Tipo TEXTO. * **__Natureza da Despesa__**: Natureza da Despesa do item. Tipo TEXTO. * **__Descrição__**: Descrição de item. Tipo TEXTO. * **__Valor__**: Valor unitário do item. Tipo MONETÁRIO. * **__Quantidade Solicitada__ **: Tipo NÚMERICO * **__Total__ **: Tipo NÚMERICO Quando termina a inserção do itens do contrato o usuário é direcionado para a tela dos endereço. No início do passo 4 caso escolha //Inserir Valores Totais// será direcionado para o cadastro de Itens de Valores totais no qual tem os seguintes campos: * **Tipo***: Título do item. Tipo TEXTO. Material ou Serviço * **Descrição***: Tipo TEXTO. * **Quantidade**: Tipo NÚMERICO * **Valor**: Valor unitário do item. Tipo MONETÁRIO. Ao inserir os itens teremos a listagem dos já cadastros: * **__Tipo__**: Título do item. Tipo TEXTO. Material ou Serviço * **__Descrição__***: Tipo TEXTO. * **__Quantidade__**: Tipo NÚMERICO * **__Valor__**: Valor unitário do item. Tipo MONETÁRIO. * **__Total__**: Valor unitário do item. Tipo MONETÁRIO. Ao inserir os itens será retornado para a listagem de endereço. ==== Passo 5 ==== Ao continuar será mostrados os dados do contratos e os dados da ordem de fornecimento para em seguida tenha a confirmação. contrato: * **__Número do Contrato__**: Tipo NUMÉRICO, formato: 9.../AAAA. * **__Licitação__**: Tipo TEXTO, formato: SIGLA LICITAÇÃO - 9.../AAAA. * **__Tipo do Contrato__**: Tipo TEXTO. * **__Subtipo do Contrato__**: Tipo TEXTO. * **__Status__**: Tipo TEXTO. * **__Objeto do Contrato__**: Tipo TEXTO. * **__Contratado__**: Tipo TEXTO, formato: CPF ou CNPJ - DENOMINAÇÃO CONTRATADO. * **__Data de Início__**: Tipo DATA, formato: DD/MM/AAAA. * **__Data de Término__**: Tipo DATA, formato: DD/MM/AAAA. * **__Data da Publicação__**: Tipo DATA, formato: DD/MM/AAAA. * **__Continuado__**: Tipo TEXTO. * **__Valor Original do Contrato__**: Tipo NUMÉRICO. * **__Valor Atual do Contrato__**: Tipo NUMÉRICO. * **__Saldo Atual__**: Tipo NUMÉRICO. * **__Informações Gerais da Ordem de Fornecimento__** * **__Número/ANO__**: Tipo NUMÉRICO, formato: 9.../AAAA. * **__Prazo de Entrega__**: Tipo DATA, formato: DD/MM/AAAA. * **__Prazo de Instalação__**: Tipo DATA, formato: DD/MM/AAAA. * **__Endereço de Execução__** * **__Razão Social__**: Tipo - TEXTO e NÚMERICO. * **__Endereço__**: Tipo - TEXTO, Formato - "LOGRADOURO, NÚMERO, BAIRRO, COMPLEMENTO". * **__Cidade__**: Tipo - TEXTO. * **__ESTADO__**: Tipo - TEXTO. Para cada endereço exista Itens de Contratos/Itens Valor total: Item Valor Total ^ Tipo ^ Descrição ^ Quantidade ^ Valor ^ Total ^ | Material/Serviço | | 999 | R$ 9,99 | R$ 9,99 | | --- | -- | -- | -- | --- | | -- | -- | -- | -- | -- | Item Contrato ^ Título ^ Descrição ^ Quantidade ^ Valor ^ Total ^ | TEXTO | TEXTO | 999 | R$ 9,99 | R$ 9,99 | | --- | -- | -- | -- | | -- | -- | -- | -- | O usuário tem as opções de "Apenas Gravar" e "Gravar e Enviar", que se diferem no seguinte: * Apenas Gravar: Salva o que o usuário digitou até o momento, mas não submete. Sendo assim, o usuário pode terminar o cadastro em um outro momento, podendo parar e continuar quantas vezes for necessário. * Gravar e Enviar: Envia a ordem de fornecimento para o fornecedor. Depois desta etapa o usuário não poderá mais editar a Ordem de Fornecimento. Esta opção somente deve ser utilizada quando a ordem de fornecimento estiver pronta. Quando a ordem de Fornecimento é enviada será enviado um e-mail para o fornecedor informando que ele recebeu uma ordem fornecimento. O caso de uso é finalizado. ===== Principais Regras de Negócio ===== * **RN01**: Só é permitido informar o prazo para contratos vigentes. * **RN02**: O prazo informado pode ultrapassar a data final de vigência do contrato. * **RN03**: A quantidade informada não pode ultrapassar o quantitativo do contrato. ==== Resoluções/Legislações Associadas ==== Não se Aplica. ===== Classes Persistentes e Tabelas Envolvidas ===== ^ Classe ^ Tabela ^ | br.ufrn.sipac.contratos.dominio.OrdemFornecimento | administrativo.contratos.ordem_fornecimento | | br.ufrn.sipac.contratos.dominio.ItemOrdemFornecimento | administrativo.contratos.item_ordem_fornecimento | | br.ufrn.sipac.contratos.dominio.EnderecoExecucao | administrativo.contratos.endereco_execucao | | br.ufrn.sipac.contratos.dominio.ItemOrdemFornecimentoContrato | administrativo.contratos.item_ordem_fornecimento_contrato | | br.ufrn.sipac.contratos.dominio.ItemValorTotal | administrativo.contratos.item_valor_total | | br.ufrn.sipac.contratos.dominio.TipoSolicitacaoItem | administrativo.contratos.tipo_solicitacao_item | | br.ufrn.sipac.contratos.dominio.ItemContrato | administrativo.contratos.item_contrato | ====== Plano de Teste ====== Sistema: SIPAC Módulo: Portal Administrativo Link(s): SIPAC → Portal Administrativo → Contratos → Pagamento Online → Ordem de Fornecimento → Cadastrar Ordem Fornecimento. Usuário: rcsl Papel que usuário deve ter: * SipacPapeis.GESTOR_CONTRATO * SipacPapeis.FISCAL_CONTRATO ===== Cenários de Teste ===== * Realizar um cadastro de um contrato no UC: SIPAC → Módulo Contratos → Aba Geral → Contrato → Cadastrar/Editar Contrato → Receita * Em seguida deve cadastrar itens para o contrato no UC: SIPAC → Módulo Contratos → Aba Geral → Outros → Cadastrar Itens do Contrato. * Após realizar o cadastro do contrato e inserir itens já se pode cadastrar um ordem de fornecimento. ===== Dados para o Teste ===== Após cadastrar um ordem fornecimento com itens de contrato podemos verificar a persistência dos dados atráves da seguinte consulta: SELECT item.descricao, item.quantidade AS QUANTIDADE_ITEM , item.quantidade_liberada AS QUANTIDADE_LIBERADA FROM contratos.ordem_fornecimento ordem JOIN contratos.contrato contrato ON(ordem.id_contrato = contrato.id) JOIN contratos.item_contrato item ON( item.id_contrato = contrato.id) WHERE contrato.numero=NUMERO_CONTRATO AND contrato.ano=ANO_CONTRATO Outra opção para verificar os dados da ordem de fornecimento que foram apenas gravados é no UC: [[desenvolvimento:especificacoes:sipac:portal_administrativo:casos_de_uso:contratos:modificar_ordem_fornecimento|Modificar Ordem de Fornecimento]]