> For the complete documentation index, see [llms.txt](https://manuais.farmaciadigital.saude.mg.gov.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://manuais.farmaciadigital.saude.mg.gov.br/cadastros/estabelecimentos/vincular-estabelecimento.md).

# Vincular Estabelecimento

## Caso de Uso

Descrição

| Este caso de uso permite que o Usuário inclua, visualize, edite e exclua vínculos entre estabelecimentos de saúde. A finalidade dos vínculos é propiciar que o Estabelecimento Principal visualize informações dos Estabelecimentos Vinculados nos relatórios do sistema. |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

<br>

Precondições

| O Usuário logado deve ter um dos seguintes perfis: Gestor Master, Farmacêutico SAF, Farmacêutico GRS, Farmacêutico Municipal, Farmacêutico Diretor Técnico.O Usuário acessou o menu Cadastros > Estabelecimentos > Vincular Estabelecimentos. |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

<br>

Fluxo principal

| <ol><li>O SIGAF exibe a interface IU1.152 Pesquisar Estabelecimentos Vinculados .</li></ol><p>{Pesquisar Vínculos Entre Estabelecimentos}{Adicionar Vínculo Entre Estabelecimentos}</p><ol start="2"><li>O caso de uso termina.</li></ol> |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

<br>

Fluxos alternativos

*Fluxo alternativo Pesquisar Vínculos Entre Estabelecimentos*

| Precondições | Não se aplica.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| ------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Passos       | <ol><li>O Usuário preencheu ou não os filtros de pesquisa.</li></ol><p>{Pesquisar Estabelecimento}{Pesquisar Estabelecimentos (Vinculados)}</p><ol start="2"><li>O Usuário acionou o comando \[Pesquisar].</li><li><p>O SIGAF realiza busca de acordo com os parâmetros informados na interface IU1.152 Pesquisar Estabelecimentos Vinculados .</p><ol><li>Caso não exista registro que atenda os parâmetros, o SIGAF exibe a mensagem MSGI001 Não existem registros a serem exibidos. e retorna para o passo onde o fluxo alternativo foi acionado.</li><li>Caso exista, o SIGAF exibe os registros na grid de retorno.</li></ol></li></ol><p>{Mostrar Vínculo Entre Estabelecimentos}{Editar Vínculo Entre Estabelecimentos}{Adicionar Vínculo Entre Estabelecimentos}{Excluir Vínculo Entre Estabelecimentos}</p><ol start="4"><li>O fluxo retorna ao ponto em que foi acionado.</li></ol> |

<br>

*Fluxo alternativo Adicionar Vínculo Entre Estabelecimentos*

| Precondições | O Usuário deve estar logado com o perfil de Gestor master.O Usuário acionou o comando \[Adicionar Novo Vínculo Entre Estabelecimentos].                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| ------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Passos       | <ol><li>O SIGAF exibe a interface IU1.153 Manter Estabelecimentos Vinculados .</li><li>O Usuário preenche os dados.</li></ol><p>{Pesquisar Estabelecimento}</p><ol start="3"><li><p>O SIGAF verifica se o Usuário solicitou a inclusão de Estabelecimentos Vinculados sem antes informar o Estabelecimento Principal.</p><ol><li>Caso sim, o SIGAF exibe a mensagem MSGE006 Selecione \<nome do campo>. onde Nome do campo = Estabelecimento Principal, e retorna ao passo 2 deste fluxo.</li></ol></li><li><p>O SIGAF verifica se o Estabelecimento Principal selecionado pelo Usuário já possui registro de vínculos cadastrados.</p><ol><li>Caso tenha, o SIGAF carrega na seção “Adicionar Estabelecimentos Vinculados” os estabelecimentos que já foram vinculados ao Estabelecimento Principal.</li></ol></li><li>O Usuário aciona o comando \[Salvar].</li><li><p>O SIGAF valida se os campos obrigatórios foram preenchidos</p><ol><li>Caso não tenham sido preenchidos, o SIGAF exibe a mensagem MSGA003 Formulário incompleto! Para prosseguir, preencha os itens destacados. É necessário inserir \<nome do campo>. e retorna para o passo 2 deste fluxo.</li></ol></li><li><p>O SIGAF valida se foi informado pelo menos 1 (um) Estabelecimento Vinculado.</p><ol><li>Caso não, o SIGAF exibe a mensagem MSGE007 Em \<nome da seção> é obrigatório informar pelo menos 1 item. onde Nome da seção = Estabelecimentos Vinculados e retorna ao passo 2 deste fluxo.</li></ol></li><li>O SIGAF grava o cadastro do registro, grava o log (nome do usuário, data e hora) de cadastro e exibe a mensagem MSGI004 Os dados foram salvos com sucesso. .</li><li>O fluxo retorna ao ponto em que foi acionado.</li></ol> |

<br>

*Fluxo alternativo Mostrar Vínculo Entre Estabelecimentos*

| Precondições | O Usuário acionou o comando \[Mostrar].                                                                                                                                                                                                                                    |
| ------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Passos       | <ol><li>O SIGAF exibe a IU1.153 Manter Estabelecimentos Vinculados com os campos preenchidos, de acordo com o item selecionado na Grid de resultados da IU1.152 Pesquisar Estabelecimentos Vinculados , e bloqueados para edição.</li><li>O caso de uso termina.</li></ol> |

<br>

*Fluxo alternativo Editar Vínculo Entre Estabelecimentos*

| Precondições | O Usuário deve estar logado com o perfil de Gestor master.O Usuário acionou o comando \[Editar].                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| ------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Passos       | <ol><li>O SIGAF exibe a IU1.153 Manter Estabelecimentos Vinculados .</li><li>O Usuário altera os campos.</li></ol><p>{Pesquisar Estabelecimento}</p><ol start="3"><li>O Usuário aciona o comando \[Salvar].</li><li><p>O SIGAF valida se foi informado pelo menos 1 (um) Estabelecimento Vinculado.</p><ol><li>Caso não, o SIGAF exibe a mensagem MSGE007 Em \<nome da seção> é obrigatório informar pelo menos 1 item. e retorna ao passo 2 deste fluxo.</li></ol></li><li>O SIGAF grava o cadastro do registro, grava o log (nome do usuário, data e hora) de alteração e exibe a mensagem MSGI004 Os dados foram salvos com sucesso .</li><li>O fluxo retorna ao ponto em que foi acionado.</li></ol> |

<br>

*Fluxo alternativo Excluir Vínculo Entre Estabelecimentos*

| Precondições | O Usuário deve estar logado com o perfil de Gestor master.O Usuário acionou o comando \[Excluir].                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| ------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Passos       | <ol><li><p>O SIGAF exibe a mensagem MSGI005 Você tem certeza que deseja excluir PERMANENTEMENTE este(a) \<Nome do registro>? onde Nome do registro = Vínculo.</p><ol><li>Caso o Usuário responda \[NÃO], o SIGAF não exclui o registro e se mantém na IU1.152 Pesquisar Estabelecimentos Vinculados .</li><li>Caso o Usuário responda \[SIM], o SIGAF exclui o registro, se mantém na IU1.152 Pesquisar Estabelecimentos Vinculados e exibe a MSGI003 Registro excluído com sucesso. .</li></ol></li><li>O caso de uso termina.</li></ol> |

<br>

*Fluxo alternativo Pesquisar Estabelecimento*

| Precondições | O Usuário acionou o comando \[Pesquisar Estabelecimento Principal] ou \[Pesquisar Estabelecimento Vinculado] da IU1.153 Manter Estabelecimentos Vinculados .O Usuário acionou o comando \[Pesquisar Estabelecimento Principal] da IU1.152 Pesquisar Estabelecimentos Vinculados .                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| ------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Passos       | <ol><li>O SIGAF exibe a interface IU1.160 Pop up Pesquisar/Selecionar Estabelecimentos (apenas 1) de acordo com a RNG1.52 Vínculo entre Estabelecimentos de Saúde .</li><li>O Usuário insere ou não os parâmetros de pesquisa.</li><li>O Usuário aciona o comando \[Pesquisar].</li><li><p>O SIGAF verifica se existem registros para serem exibidos.</p><ol><li>Caso negativo o SIGAF exibe a MSGI001 Não existem registros a serem exibidos. e retorna ao passo 2 deste fluxo.</li><li>Caso positivo o SIGAF retorna os registros na GRID de resultados.</li></ol></li><li>O Usuário aciona o comando \[Selecionar Estabelecimento] do registro selecionado.</li><li>O fluxo retorna para o ponto onde foi acionado, preenchendo o campo “Estabelecimento de saúde”.</li></ol> |

<br>

*Fluxo alternativo Pesquisar Estabelecimentos (Vinculados)*

| Precondições | O Usuário acionou o comando \[Pesquisar Estabelecimentos Vinculados] da IU1.152 Pesquisar Estabelecimentos Vinculados..                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| ------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Passos       | <ol><li>O SIGAF exibe a interface IU1.161 Pop up Pesquisar/Selecionar Estabelecimentos (mais de 1) .</li><li>O Usuário insere ou não os parâmetros de pesquisa e aciona o comando \[Buscar].</li><li><p>O SIGAF verifica se existem registros para serem exibidos.</p><ol><li>Caso negativo o SIGAF exibe a MSGI001 Não existem registros a serem exibidos. e retorna ao passo 2 deste fluxo.</li><li>Caso positivo o SIGAF retorna os registros na GRID de resultados.</li></ol></li><li>O Usuário aciona o comando \[Selecionar Estabelecimento] do registro selecionado.</li><li>O SIGAF inclui o item selecionado na lista de “Estabelecimentos selecionados”.</li><li>Caso o Usuário queira selecionar mais Estabelecimentos, o SIGAF retorna para o passo 2 deste fluxo.</li><li>O Usuário aciona o comando \[Confirmar Seleção].</li><li>O fluxo retorna para o ponto onde foi acionado, preenchendo o campo da Estabelecimento de Saúde.</li></ol> |

\ <br>

Observações

| Não se aplica. |
| -------------- |

<br>

Critérios de aceitação do requisito

|   | Item a ser cumprido                                                                                                                                                                                       | Sim | Não | Não se aplica |
| - | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :-: | :-: | ------------- |
| 1 | A descrição do caso de uso mostra com clareza qual a funcionalidade que será especificada e seu objetivo?                                                                                                 |     |     |               |
| 2 | Considerando que a cada desvio que há em um fluxo (fluxo alternativo, subfluxo ou caso de uso), após o seguirmos e retornarmos ao ponto onde estávamos, o fluxo principal inicia e termina o caso de uso? |     |     |               |
| 3 | O fluxo principal executa algo relevante para o usuário (uma consulta, por exemplo)?                                                                                                                      |     |     |               |
| 4 | Os atributos das interfaces de usuário do caso de uso estão presentes nas classes apresentadas no diagrama de classes?                                                                                    |     |     |               |
| 5 | Todas as regras de negócio referentes ao caso de uso foram utilizadas adequadamente por ele?                                                                                                              |     |     |               |
| 6 | A comunicação direta com outro sistema (caso exista) está presente no Diagrama de Contexto ou no Diagrama de Caso de Uso?                                                                                 |     |     |               |
| 7 | O dicionário de classes foi utilizado no caso de uso explorando todo o seu potencial?                                                                                                                     |     |     |               |
| 8 | Os requisitos não funcionais relativos a esse caso de uso foram identificados?                                                                                                                            |     |     |               |
|   |                                                                                                                                                                                                           |     |     |               |

o
