~~ODT~~

<PHP>
echo "<div style='display:block;float:right;'>"; 
echo "Última atualização: ";
ver('', false);
echo "</div>";
</PHP>

====== Gerar Arquivo de Credores ======

Esse caso de uso tem como finalidade a geração de um arquivo de lista de credores que será enviado ao SIAFI.

O caso de uso é utilizado por usuários responsáveis pela geração de arquivos do SIAFI no módulo de Bolsas.


===== Descrição do Caso de Uso =====

Este caso de uso inicia quando o usuário acessa a opção: //SIPAC -> Bolsas -> Operações -> Operações -> Pagamentos -> Gerar Arquivo de Credores//.

São solicitados os seguintes dados ao usuário:

   * **Tipos de Bolsa***: Formato - NOME - (UNIDADE PAGADORA) - (VALOR), Tipo - TEXTO ([[#principais_regras_de_negócio|RN01]]).
   * **Mês**: Tipo - TEXTO.
   * **Ano**: Formato - 9999, Tipo - NUMÉRICO.

Para gerar o arquivo deve-se selecionar a opção **Gerar Arquivo**.

  * O sistema exibe o relatório no formato TXT para contabilização no SIAFI com as seguintes informações:
    * Tipo de Registro;
    * Código do Arquivo;
    * Data da Geração da Fita;
    * Hora da Geração do Arquivo;
    * Ano de referência;
    * Código da UG;
    * CPF do responsável;
    * Tipo de Registro;
    * Tipo de Credor;
    * Favorecido;
    * Código do Banco de Origem;
    * Código da Agência de Origem;
    * Código da conta corrente de origem;
    * Valor de Crédito;
    * Código da UG emitente da Lista;
    * Código da Gestão Emitente da Lista;
    * Número da Lista;
    * Tipo da Lista;
    * Suprimentos de Fundos;
    * Tipo de pagamento;
    * Tipo de Registro;
    * Quantidade de Registros do Detalhe.

O caso de uso é finalizado.


===== Principais Regras de Negócio =====

   * **RN01** - São exibidos apenas os tipos de bolsa ativos que necessitam de envio de frequência e não são bolsas de convênio.


==== Resoluções/Legislações Associadas ====

Não se aplica.


===== Classes Persistentes e Tabelas Envolvidas =====

^ Classe ^ Tabela |
| br.ufrn.sipac.bolsas.dominio.TipoBolsa | administrativo.bolsas.tipo_bolsa |
| br.ufrn.sipac.bolsas.dominio.Frequencia | administrativo.bolsas.frequencia |


====== Plano de Teste ======

Sistema: SIPAC

Módulo: Bolsas

Link(s): Operações -> Operações -> Pagamentos -> Gerar Arquivo de Credores

Usuário: matceu

Papel que o usuário deve ter: SipacPapeis.GESTOR_BOLSAS_SIAFI

===== Cenários de Teste =====

Não há.

===== Dados para o Teste =====

Consulta que retorna todos os tipos de bolsa ativos que necessitam de envio de frequência e não são bolsas de convênio ([[#principais_regras_de_negócio|RN01]]).
<code SQL>
SELECT t.denominacao, u.sigla, t.valor
FROM bolsas.tipo_bolsa t
JOIN comum.unidade u ON t.id_unidade_pagadora = u.id_unidade
WHERE t.ativo = true
AND t.necessita_enviar_frequencia = true
AND t.convenio = false;
</code>