> 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/medicamentos-e-produtos/farmaco.md). # Fármaco ## Caso de Uso Descrição | Este caso de uso permite ao usuário realizar a pesquisa, cadastro, edição, visualização exclusão de fármaco no sistema. | | ----------------------------------------------------------------------------------------------------------------------- |
Precondições | O Usuário logado deve ter um dos seguintes perfis: Gestor Master, Técnico Judicialização, Técnico Prescrição.O Usuário acessa o menu Cadastros > Medicamentos > Fármaco. | | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
Fluxo principal |
  1. O SISTEMA exibe a IU1.32 Pesquisar Fármaco .

{Adicionar Fármaco}{Pesquisar Fármaco}

  1. O fluxo principal termina.
| | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
Subfluxos *Subfluxo \* | Não se aplica. | | -------------- |
Fluxos alternativos *Fluxo alternativo Pesquisar Fármaco* | Precondições | O Usuário preencheu ou não os filtros de pesquisa.O Usuário acionou o comando \[Buscar]. | | ------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Passos |

  1. O SISTEMA realiza busca de acordo com os parâmetros informados na interface IU1.32 Pesquisar Fármaco .

    1. Caso não exista registro que atenda os parâmetros, o SISTEMA exibe a mensagem MSGI011 Nenhum registro foi encontrado. e retorna para o passo onde o fluxo alternativo foi acionado.
    2. Caso exista, o SISTEMA exibe os registros na grid de retorno.

{Mostrar Fármaco}{Editar Fármaco}{Adicionar Fármaco}{Excluir Fármaco}

  1. O fluxo retorna ao ponto em que foi acionado.
|
*Fluxo alternativo Adicionar Fármaco* | Precondições | O Usuário deve estar logado com um dos seguintes perfis: Gestor Master, Técnico Prescrição.O Usuário acionou o comando \[Adicionar Fármaco] . | | ------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Passos |
  1. O SISTEMA exibe a interface IU1.33 Manter Fármaco .
  2. O Usuário preenche os dados.

{Pesquisar ATCC}

  1. O Usuário aciona o comando \[Adicionar].

  2. O SISTEMA valida se os campos obrigatórios foram preenchidos

    1. Caso não tenham sido preenchidos, o SISTEMA exibe a mensagem MSGA006 Campo obrigatório. e retorna para o passo 2 deste fluxo.

  3. O SISTEMA valida se já existe fármaco cadastrado no sistema com o mesmo “Fármaco” informado.

    1. Caso o fármaco inserido conste na base de dados, o SISTEMA exibe a mensagem MSGE015 Não é permitido o cadastro de registros duplicados. e retorna para o passo 2 deste fluxo.
  4. O SISTEMA grava o cadastro do Fármaco, grava o log simples (nome do usuário e data), retorna para a IU1.32 Pesquisar Fármaco e exibe a mensagem MSGI012 Registro gravado com sucesso. .
  5. O fluxo alternativo retorna ao ponto em que foi acionado.
|
*Fluxo alternativo Pesquisar ATCC* | Precondições | O Usuário acionou o comando \[Pesquisa ATC]. | | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | Passos |
  1. O SISTEMA exibe a interface IU0.17 Pop-up Pesquisar/Selecionar Classe ATCC .
  2. O Usuário insere ou não os parâmetros de pesquisa.

{ Pesquisar ATCC}

  1. O Usuário aciona o comando \[Buscar].

  2. O SISTEMA verifica se existem registros para serem exibidos.

    1. Caso negativo o SISTEMA exibe a MSGI011 Nenhum registro foi encontrado. e retorna ao passo 1 deste fluxo alternativo.
    2. Caso positivo o SISTEMA retorna os registros na GRID de resultados de acordo com a RNG1.05 Pesquisar Classificação ATCC .
  3. O Usuário aciona o comando \[Selecionar Classe ATC] do registro selecionado.
  4. O fluxo retorna para o ponto onde foi acionado, preenchendo o campo “Código ATCC 3º nível”.
|
*Fluxo alternativo Mostrar Fármaco* | Precondições | O Usuário acionou o comando \[Mostrar]. | | ------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Passos |
  1. O SISTEMA exibe a IU1.33 Manter Fármaco com os campos preenchidos, de acordo com o item selecionado na Grid de resultados da IU1.32 Pesquisar Fármaco , e bloqueados para edição.
  2. O caso de uso termina.
|
*Fluxo alternativo Editar Fármaco* | Precondições | O Usuário deve estar logado com um dos seguintes perfis: Gestor Master, Técnico Prescrição.O Usuário acionou o comando \[Editar]. | | ------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Passos |
  1. O SISTEMA exibe a IU1.33 Manter Fármaco com os campos preenchidos, de acordo com o item selecionado na IU1.32 Pesquisar Fármaco .
  2. O Usuário altera os dados.

{Pesquisar ATCC}

  1. O Usuário aciona o comando \[Alterar].

  2. O SISTEMA valida se os campos obrigatórios foram preenchidos;

    1. Caso os campos obrigatórios não tenham sido preenchidos o SISTEMA exibe a MSGA006 Campo obrigatório. e retorna para o passo 2 deste fluxo.

  3. O SISTEMA valida se já existe fármaco cadastrado no sistema com o mesmo “Fármaco” informado.

    1. Caso o fármaco inserido conste na base de dados, o SISTEMA exibe a mensagem MSGE015 Não é permitido o cadastro de registros duplicados. . e retorna para o passo 2 deste fluxo.
  4. O SISTEMA grava a alteração do fármaco, grava o log simples (nome do usuário e data), retorna para a IU1.32 Pesquisar Fármaco , e exibe a MSGI012 Registro gravado com sucesso. .
  5. O caso de uso termina.
|
*Fluxo alternativo Excluir Fármaco* | Precondições | O Usuário deve estar logado com um dos seguintes perfis: Gestor Master.O Usuário acionou o comando \[Excluir]. | | ------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Passos |

  1. O SISTEMA exibe a mensagem MSGA014 Deseja realmente excluir o registro? .

    1. Caso o Usuário responda \[NÃO], o SISTEMA não exclui o registro e se mantém na IU1.32 Pesquisar Fármaco .

    2. Caso o Usuário responda \[SIM], o SISTEMA verifica se o registro possui vínculos conforme RNG0.01 Exclusão de Registros .

      1. Caso o registro possua vínculos, o SISTEMA não exclui o registro e exibe a mensagem MSGE008 Não é possível remover o(a) '\' de 'Nome' igual a '\'. .
      2. Caso o registro não possua vínculos, o SISTEMA exclui o registro, se mantém na IU1.32 Pesquisar Fármaco e exibe a MSGI013 Registro excluído com sucesso. .
  2. O caso de uso termina.
|
Observações | Não se aplica. | | -------------- |
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? | | | | ## Interface Pesquisar Fármaco Layout
\ \ Campos\ | Número | Nome | Descrição | Valores válidos e formato | Restrições | | ---------------------------- | ------------------------------------------- | ------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | -------------------------------------- | |
| Fármaco | farmaco . nome | Texto, 255 posições | Não obrigatório. Alterável. | | *Grid de Resultados* | | | | | |
| Fármaco | farmaco . nome | Texto, 255 posições | Informado pelo sistema. Não alterável. | |
| PORTARIA 344/1998 – RDC 44/2010 | farmaco . portaria\_id | Texto. | Informado pelo sistema. Não alterável. | |
| RECEITUÁRIO PORTARIA 344/1998 - RDC 44/2010 | farmaco . receituario\_id | Texto. Valores válidos:- Notificação de receita A- Notificação de receita B- Notificação de receita B 2- Receita de controle especial (C1 e C5)- Notificação de receita C 2 (Resinoides Sistêmicos)- Notificação de receita especial C 3 (Talidomida)- Notificação de receita especial (Antimicrobianos) | Informado pelo sistema. Não alterável. | \ Comandos\ | Número | Nome | Ação | Restrições | | ---------------------------- | ----------------- | ------------------------------------------------------------------------------- | ---------------------------------------------- | |
| Buscar | Executa a busca. | Disponível. | |
| Adicionar Fármaco | Aciona o fluxo alternativo {Adicionar Fármaco}. | Disponível. | |
| Mostrar | Aciona o fluxo alternativo {Mostrar Fármaco}. | Disponível caso a pesquisa retorne resultados. | |
| Editar | Aciona o fluxo alternativo {Editar Fármaco}. | Disponível caso a pesquisa retorne resultados. | |
| Excluir | Aciona o fluxo alternativo {Excluir Fármaco}. | Disponível caso a pesquisa retorne resultados. | |
| PDF | Gera um relatório em formato PDF de acordo com o retorno da grid de resultados. | Disponível caso a pesquisa retorne resultados. | |
| CSV | Gera um relatório em formato CSV de acordo com o retorno da grid de resultados. | Disponível caso a pesquisa retorne resultados. | \ Observações\ | Os campos obrigatórios deverão ser identificados por um asterisco a frente dos rótulos. | | --------------------------------------------------------------------------------------- | ## Interface Cadastrar / Editar Fármaco Layout
\ \ Campos\ | Número | Nome | Descrição | Valores válidos e formato | Restrições | | ---------------------------- | ------------------------------ | ------------------------------------------------ | :-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | ------------------------------------------------------------------------------------ | |
| Nome farmaco | tb\_farmaco.nom\_farmaco | Texto, 255 posições | ObrigatórioAlterável | |
| Obriga CID | tb\_farmaco.flg\_obriga\_cid | Lista de seleção.Valores:- Sim- Não | ObrigatórioAlterável | |
| Ativo para credenciamento UPDT | | Lista de seleção.Valores:- Sim- NãoValor default: Não. | ObrigatórioAlterável | |
| Complemento Fármaco | tb\_farmaco.cod\_complemento\_farmaco | lista de complemento fármaco originada de "tb\_complemento\_farmaco.cod\_complemento\_farmaco" | Obrigatório (caso seja acionado o comando \[Adicionar Complemento Fármaco])Alterável | |
| ATC | tb\_farmaco.cod\_atc\_classificacao\_triagem | lista de classificação atc originada de "tb\_atc\_classificacao\_triagem.cod\_atc\_classificacao\_triagem" | Obrigatório (caso seja acionado o comando \[Adicionar ATC])Alterável | |
| Classe ATC Geral | tb\_farmaco.cod\_atc\_geral | Inteiro | | |
| Sinônimos | tb\_farmaco.nom\_farmaco\_sinonimo | Texto | Obrigatório (caso seja acionado o comando \[Adicionar Sinônimo])Alterável | |
| Lista | tb\_farmaco.flg\_lista\_controle\_especial |

Tabela Interna, 2 posições
Combobox com as opções:- A1- A2- A3- B1- B2- C1- C2- C3- C4- C5- D1- D2- E- F1- F2- F3- Antimicrobianos- Outros

| Obrigatório (caso seja acionado o comando \[Adicionar Controle Especial])Alterável | |
| Receituário | tb\_farmaco.flg\_receituario\_controle\_especial |

Tabela Interna, 2 posições
Combobox com as opções:- Notidicação de receita 'A'- Notificação de receita 'B'- Receita de controle especial em duas vias- Notificação de receita especial- receita médica sem retenção- Notificação de receita de talidomida

| Obrigatório (caso seja acionado o comando \[Adicionar Controle Especial])Alterável | \ Comandos\ | Número | Nome | Ação | Restrições | | ------ | ----------------------------------------------------------------------------------- | ------------------------------------------------ | ----------------------------------------------------------------- | | 1 | Voltar | Retorna para a IU1.34 - Pesquisar Fármaco | Disponível | | 2 | Adicionar (caso a interface seja acionada a partir do comando \[Adicionar Fármaco]) | Persiste as informações no banco de dados | Disponível | | 3 | Alterar (caso a interface seja acionada a partir do comando \[Editar]) | Persiste as informações no banco de dados | Disponível | | 4 | Adicionar Compelmento Fármaco | Adiciona um campo para Complemento Fármaco | Disponível | | 5 | Pesquisar Complemento Fármaco | Retorna a IU1.36 - Pesquisar Complemento Fármaco | Disponíve após acionar o comando \[Adicionar Complemento Fármaco] | | 6 | Adicionar ATC | Adiciona um campo para ATC | Disponível | | 7 | Pesquisar ATC | | Disponível após acionar o comando \[Adicionar ATC] | | 8 | Adicionar Sinônimo | Adiciona um campo para Sinônimo | Disponível | \ Observações\ | Os campos obrigatórios deverão ser identificados por um asterisco a frente dos rótulos. | | --------------------------------------------------------------------------------------- |