~~ODT~~

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

====== Importar Documento Hábil ======

Este caso de uso tem a finalidade de importar do SIAFI os dados Documento Hábil diretamente para o SIPAC, pois durante o processamento do arquivo o sistema tenta realizar automaticamente a consolidação. Os envolvidos são os setores de execução orçamentária. Os arquivos são gerados pelo STA (Sistema de Transferência de Arquivos do SIAFI) e devem ser descompactados antes de realizar a importação.

**Pré-condições:** É preciso que usuário tenha permissão de Integrador SIAFI Global ou Gestora.
  * É preciso que usuário extraia o arquivo ddhd ou ddhu compactado do STA (Sistema de Transferência de Arquivo) do SERPRO (Serviço Federal de Processamento de Dados).


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

Este caso de uso inicia quando o usuário acessa a opção: SIPAC → Orçamento → Intregração SIAFI → Leitura de Arquivos do SIAFI  → Documento Hábil

O sistema solicita ao usuário que informe o arquivo extraído e tipo de arquivo:
  * **Arquivo**: Tipo - TEXTO. ( [[#Principais Regras de Negócio| RN05 ]] )
  * **Tipo de Arquivo:** Tipo - TEXTO. Opções: ddhd, ddhu.


O usuário confirma e sistema realiza processamento do arquivo.  ( [[#Principais Regras de Negócio| RN01 ]] ), ( [[#Principais Regras de Negócio| RN02 ]] ), ( [[#Principais Regras de Negócio| RN03 ]] ), ( [[#Principais Regras de Negócio| RN04 ]] )

o caso de uso é finalizado.


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

  * **RN01** - O sistema deve permitir a importação manual de arquivo ddhd e ddhu.
  * **RN02** - Para que o processo seja iniciado o sistema irá fazer algumas verificações prévias como: O nome do arquivo deve seguir o padrão: NNNNNNXXXXSSSSS-YYYYY, onde NNNNNN é o número da Unidade Gestora, XXXX é o tipo de documento, SSSSS é o sequencial de migração e YYYYY é o número da exportação no novo SIAFI.  A extensão do arquivo de registros deve ser .zip.
  * **RN03** - O sistema deve consolidar o arquivo de ddhd ou ddhu automaticamente.
  * **RN04** - Em caso de erro no processamento o sistema deve gerar pendências.
  * **RN05** - O tipo de arquivo a ser processado pelo sistema depois de ser compactado (.zip) deve ser um xml.

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

Não se aplica.

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


^ Classe                                                      ^ Tabela                                           ^
| br.ufrn.sipac.siafi.dominio.ImportacaoSIAFI                 | administrativo.siafi.importacao                  |
| br.ufrn.sipac.orcamento.dominio.Tributo                     | administrativo.sco.tribulo                       |
| br.ufrn.sipac.orcamento.movimentacoes.dominio.Bloqueio      | administrativo.sco.bloqueiro                     |
| br.ufrn.sipac.orcamento.movimentacoes.dominio.Dotacao       | administrativo.sco.dotacao.dotacao               |
| br.ufrn.sipac.orcamento.movimentacoes.dominio.Empenho       | administrativo.sco.empenho                       |
| br.ufrn.sipac.orcamento.movimentacoes.dominio.EventoEmpenho | administrativo.sco.evento_empenho                |
| br.ufrn.sipac.orcamento.movimentacoes.dominio.Lancamento    | administrativo.sco.lancamento                    |
| br.ufrn.sipac.orcamento.movimentacoes.dominio.OrdemBancaria | administrativo.sco.ordem_bancaria                |
| br.ufrn.sipac.orcamento.movimentacoes.dominio.Transferencia | administrativo.sco.transferencia                 |
| br.ufrn.sipac.siafi.dominio.ConfiguracaoIntegracaoSIAFI     | administrativo.sco.configuracao_integracao_siafi |
| br.ufrn.sipac.siafi.dominio.ConvenioGRU                     | administrativo.siafi.convenio_gru                |
| br.ufrn.sipac.siafi.dominio.GRU                             | administrativo.siafi.gru                         |
===== Plano de Teste =====

Sistema: SIPAC

Módulo: Orçamento

Link(s): SIPAC → Orçamento → Intregração SIAFI → Leitura de Arquivos do SIAFI → Documento Hábil.

Usuário: joice

Papel que o usuário deve ter: PapeisOrcamento.INTEGRADOR_SIAFI_GESTORA; PapeisOrcamento.INTEGRADOR_SIAFI_GLOBAL.

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

Não se aplica.


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

Não se aplica.