> 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. |
| ----------------------------------------------------------------------------------------------------------------------- |

<br>

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. |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

<br>

Fluxo principal

| <ol><li>O SISTEMA exibe a IU1.32 Pesquisar Fármaco .</li></ol><p>{Adicionar Fármaco}{Pesquisar Fármaco}</p><ol start="2"><li>O fluxo principal termina.</li></ol> |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |

<br>

Subfluxos

*Subfluxo \<nome do subfluxo>*

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

<br>

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       | <ol><li><p>O SISTEMA realiza busca de acordo com os parâmetros informados na interface IU1.32 Pesquisar Fármaco .</p><ol><li>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.</li><li>Caso exista, o SISTEMA exibe os registros na grid de retorno.</li></ol></li></ol><p>{Mostrar Fármaco}{Editar Fármaco}{Adicionar Fármaco}{Excluir Fármaco}</p><ol start="2"><li>O fluxo retorna ao ponto em que foi acionado.</li></ol> |

<br>

*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       | <ol><li>O SISTEMA exibe a interface IU1.33 Manter Fármaco .</li><li>O Usuário preenche os dados.</li></ol><p>{Pesquisar ATCC}</p><ol start="3"><li>O Usuário aciona o comando \[Adicionar].</li><li><p>O SISTEMA valida se os campos obrigatórios foram preenchidos</p><ol><li>Caso não tenham sido preenchidos, o SISTEMA exibe a mensagem MSGA006 Campo obrigatório.   e retorna para o passo 2 deste fluxo.</li></ol></li><li><p>O SISTEMA valida se já existe fármaco cadastrado no sistema com o mesmo “Fármaco” informado.</p><ol><li>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.</li></ol></li><li>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. .</li><li>O fluxo alternativo retorna ao ponto em que foi acionado.</li></ol> |

<br>

*Fluxo alternativo Pesquisar ATCC*

| Precondições | O Usuário acionou o comando \[Pesquisa ATC].                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Passos       | <ol><li>O SISTEMA exibe a interface IU0.17 Pop-up Pesquisar/Selecionar Classe ATCC .</li><li>O Usuário insere ou não os parâmetros de pesquisa.</li></ol><p>{ Pesquisar ATCC}</p><ol start="3"><li>O Usuário aciona o comando \[Buscar].</li><li><p>O SISTEMA verifica se existem registros para serem exibidos.</p><ol><li>Caso negativo o SISTEMA exibe a MSGI011 Nenhum registro foi encontrado. e retorna ao passo 1 deste fluxo alternativo.</li><li>Caso positivo o SISTEMA retorna os registros na GRID de resultados de acordo com a RNG1.05 Pesquisar Classificação ATCC .</li></ol></li><li>O Usuário aciona o comando \[Selecionar Classe ATC] do registro selecionado.</li><li>O fluxo retorna para o ponto onde foi acionado, preenchendo o campo “Código ATCC 3º nível”.</li></ol> |

<br>

*Fluxo alternativo Mostrar Fármaco*

| Precondições | O Usuário acionou o comando \[Mostrar].                                                                                                                                                                                            |
| ------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Passos       | <ol><li>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.</li><li>O caso de uso termina.</li></ol> |

<br>

*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       | <ol><li>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 .</li><li>O Usuário altera os dados.</li></ol><p>{Pesquisar ATCC}</p><ol start="3"><li>O Usuário aciona o comando \[Alterar].</li><li><p>O SISTEMA valida se os campos obrigatórios foram preenchidos;</p><ol><li>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.</li></ol></li><li><p>O SISTEMA valida se já existe fármaco cadastrado no sistema com o mesmo “Fármaco” informado.</p><ol><li>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.</li></ol></li><li>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. .</li><li>O caso de uso termina.</li></ol> |

<br>

*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       | <ol><li><p>O SISTEMA exibe a mensagem MSGA014 Deseja realmente excluir o registro? .</p><ol><li>Caso o Usuário responda \[NÃO], o SISTEMA não exclui o registro e se mantém na IU1.32 Pesquisar Fármaco .</li><li><p>Caso o Usuário responda \[SIM], o SISTEMA verifica se o registro possui vínculos conforme RNG0.01 Exclusão de Registros .</p><ol><li>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) '\<funcionalidade>' de 'Nome' igual a '\<nome da funcionalidade>'. .</li><li>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. .</li></ol></li></ol></li><li>O caso de uso termina.</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?                                                                                                                            |     |     |               |

## Interface Pesquisar Fármaco

Layout

<figure><img src="/files/I0rLsyEJquf4oODcAbNI" alt=""><figcaption></figcaption></figure>

\
\
Campos\
&#x20;&#x20;

| Número                       | Nome                                        | Descrição                 |                                                                                                                                         Valores válidos e formato                                                                                                                                        | Restrições                             |
| ---------------------------- | ------------------------------------------- | ------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | -------------------------------------- |
| <ol><li></li></ol>           | Fármaco                                     | farmaco . nome            |                                                                                                                                            Texto, 255 posições                                                                                                                                           | Não obrigatório. Alterável.            |
| *Grid de Resultados*         |                                             |                           |                                                                                                                                                                                                                                                                                                          |                                        |
| <ol start="2"><li></li></ol> | Fármaco                                     | farmaco . nome            |                                                                                                                                            Texto, 255 posições                                                                                                                                           | Informado pelo sistema. Não alterável. |
| <ol start="3"><li></li></ol> | PORTARIA 344/1998 – RDC 44/2010             | farmaco . portaria\_id    |                                                                                                                                                  Texto.                                                                                                                                                  | Informado pelo sistema. Não alterável. |
| <ol start="4"><li></li></ol> | 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\
&#x20;&#x20;

| Número                       | Nome              | Ação                                                                            | Restrições                                     |
| ---------------------------- | ----------------- | ------------------------------------------------------------------------------- | ---------------------------------------------- |
| <ol><li></li></ol>           | Buscar            | Executa a busca.                                                                | Disponível.                                    |
| <ol start="2"><li></li></ol> | Adicionar Fármaco | Aciona o fluxo alternativo {Adicionar Fármaco}.                                 | Disponível.                                    |
| <ol start="3"><li></li></ol> | Mostrar           | Aciona o fluxo alternativo {Mostrar Fármaco}.                                   | Disponível caso a pesquisa retorne resultados. |
| <ol start="4"><li></li></ol> | Editar            | Aciona o fluxo alternativo {Editar Fármaco}.                                    | Disponível caso a pesquisa retorne resultados. |
| <ol start="5"><li></li></ol> | Excluir           | Aciona o fluxo alternativo {Excluir Fármaco}.                                   | Disponível caso a pesquisa retorne resultados. |
| <ol start="6"><li></li></ol> | PDF               | Gera um relatório em formato PDF de acordo com o retorno da grid de resultados. | Disponível caso a pesquisa retorne resultados. |
| <ol start="7"><li></li></ol> | 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\
&#x20;&#x20;

| Os campos obrigatórios deverão ser identificados por um asterisco a frente dos rótulos. |
| --------------------------------------------------------------------------------------- |

## Interface Cadastrar / Editar Fármaco

Layout

<figure><img src="/files/pkPARgCbFGOdw3xnLwm7" alt=""><figcaption></figcaption></figure>

\
\
Campos\
&#x20;&#x20;

| Número                       | Nome                           | Descrição                                        |                                                                                                                      Valores válidos e formato                                                                                                                      | Restrições                                                                           |
| ---------------------------- | ------------------------------ | ------------------------------------------------ | :-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | ------------------------------------------------------------------------------------ |
| <ol><li></li></ol>           | Nome farmaco                   | tb\_farmaco.nom\_farmaco                         |                                                                                                                         Texto, 255 posições                                                                                                                         | ObrigatórioAlterável                                                                 |
| <ol start="2"><li></li></ol> | Obriga CID                     | tb\_farmaco.flg\_obriga\_cid                     |                                                                                                                 Lista de seleção.Valores:- Sim- Não                                                                                                                 | ObrigatórioAlterável                                                                 |
| <ol start="3"><li></li></ol> | Ativo para credenciamento UPDT |                                                  |                                                                                                        Lista de seleção.Valores:- Sim- NãoValor default: Não.                                                                                                       | ObrigatórioAlterável                                                                 |
| <ol start="4"><li></li></ol> | 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 |
| <ol start="5"><li></li></ol> | 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                 |
| <ol start="6"><li></li></ol> | Classe ATC Geral               | tb\_farmaco.cod\_atc\_geral                      |                                                                                                                               Inteiro                                                                                                                               |                                                                                      |
| <ol start="7"><li></li></ol> | Sinônimos                      | tb\_farmaco.nom\_farmaco\_sinonimo               |                                                                                                                                Texto                                                                                                                                | Obrigatório (caso seja acionado o comando \[Adicionar Sinônimo])Alterável            |
| <ol start="8"><li></li></ol> | Lista                          | tb\_farmaco.flg\_lista\_controle\_especial       |                                                         <p>Tabela Interna, 2 posições<br>Combobox com as opções:- A1- A2- A3- B1- B2- C1- C2- C3- C4- C5- D1- D2- E- F1- F2- F3- Antimicrobianos- Outros</p>                                                        | Obrigatório (caso seja acionado o comando \[Adicionar Controle Especial])Alterável   |
| <ol start="9"><li></li></ol> | Receituário                    | tb\_farmaco.flg\_receituario\_controle\_especial | <p>Tabela Interna, 2 posições<br>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</p> | Obrigatório (caso seja acionado o comando \[Adicionar Controle Especial])Alterável   |

\
Comandos\
&#x20;&#x20;

| 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\
&#x20;&#x20;

| Os campos obrigatórios deverão ser identificados por um asterisco a frente dos rótulos. |
| --------------------------------------------------------------------------------------- |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://manuais.farmaciadigital.saude.mg.gov.br/cadastros/medicamentos-e-produtos/farmaco.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
