Especificação
Produto	HIS	Módulo	Farmácia / Adm. do Sistema
Segmento Executor	Saúde
Projeto¹	S_SAU_HIS_20151016	IRM¹	PCREQ-10313
Requisito¹	PCREQ-9886	SubTarefa¹	SAU_DEV-4326
Chamado²
Release de Entrega Planejada	12.1.11	Réplica
País	Brasil ( ) Argentina ( ) Mexico ( ) Chile ( ) Paraguai ( ) Equador ( ) USA ( ) Colombia ( ) Outro _____________.
Outros

Objetivo

O objetivo desta melhoria é criar um controle de saldo do residente, alerta por e-mail quando o saldo estiver próximo ao fim e realizar o lançamento na conta do residente para os itens adquiridos no residencial Cora, afim de automatizar este controle que hoje é manual.
.

Definição da Regra de Negócio

RN001 – Deve ser criada uma tela para controle de saldo do residente. Esta tela deve ter opção para selecionar o residente, incluir os itens e listar os produtos já adquiridos pelo residente.
RN002 – A página de Controle de Saldos deverá apresentar todos os residentes com atendimentos abertos e até os que já possuem alta, mas que não tiveram suas contas fechadas até o momento pelo faturamento. Contas em que o Fechamento for parcial, o residente deve continuar sendo listado.
RN003 – Página de Controle de Saldos do Residente devem permitir o cadastro dos 2 tipos de compra listados abaixo:
Secretaria de Saúde / Família – Produtos que a família retirou na secretária de saúde ou que o familiar comprou o medicamento e trouxe pra o consumo do residente
Aquisição ILPI – Produto consumido do estoque do residencial. Quando registrado este tipo de saldo o mesmo de ser registrado na conta do residente.
RN004 – Após adicionada uma compra, deve ser possível editar o valor de aquisição e o saldo.
RN005 – As dispensações para residente devem baixar automaticamente o saldo do residente, seguindo a ordem abaixo caso o mesmo produto tenha os 2 tipos de compra
1) Secretaria de Saúde / família 2) Aquisição ILPI
RN006 – Caso o produto não tenha sido adicionado ao painel de controle de saldos do residente, e seja feita uma dispensação do mesmo, o produto deve ser adicionado ao painel com quantidade zerada, saldo negativo e com o tipo de compra Aquisição ILPI. Somente neste caso o produto deverá ir para a conta do paciente a partir da dispensação. Este produto será regularizado a partir do cadastro de uma nova compra.
RN007 – Ao ser cadastrada a compra de um produto para o residente, se esta for do tipo Aquisição ILPI, deverá ir automaticamente para a conta do paciente.
RN008 – Deve ser criada uma página para cadastro e configuração de e-mail de alerta de necessidade de aquisição de novo produto. Este alerta deve ocorrer sempre que o produto atingir o ponto do alerta deve respeitar configuração especifica de cada residente.
RN009 – Deve ser criado um relatório para o Controle de Movimentações do Residente, listando: Data Hora, Operação (Consumo, Edição de Saldo, Edição de Aquisição), Motivo, Quantidade e Saldo.
RN010 – Deve ser criado um relatório para o Controle de Saldo do Residente, listando: Produto, Saldo, Tipo de Compra, Ponto de Alerta. Necessário poder filtrar por produtos que já atingiram o ponto de alerta.
RN011 – Deve ser criado um cadastrado de motivos de ajuste de estoque/saldo do residente e essa informação deve ser utilizada quando necessário algum ajuste.

Rotinas Envolvidas
Rotina	Tipo de Operação	Opção de Menu	Regras de Negócio
Controle de Saldo por Residente	Criação	Farmácia > Atendimento > Atendimento de Solicitações para o Paciente > Controle de Saldo por Residente	RN001, RN002, RN003, RN004, RN005, RN006, RN007
Cadastro de Motivos de Ajuste de Saldo do Residente	Criação	Estoque > Cadastros > Cadastro de Motivos de Ajuste de Saldo do Residente	RN011
Gerenciador de Dispensações do Residente	Alteração	Farmácia > Atendimento > Gerenciador de Dispensações do Residente	RN005, RN006
Configurações > Configuração de Notificação de Necessidade de Aquisição de Produto	Criação	Adm. do Sistema > Configurações > Configuração de Notificação de Necessidade de Aquisição de Produto	RN008
Relatório de Movimentações de Estoque do Residente	Criação	Farmácia > Relatórios > Relatório de Movimentações de Estoque do Residente	RN009
Relatório de Saldo Atual do Residente	Criação	Farmácia > Relatórios > Relatório de Saldo Atual do Residente	RN010

Protótipo de Tela

As imagens de telas destacadas a seguir são consideradas apenas protótipos, as mesmas poderão sofrer alterações em função da atualização de componentes utilizados no sistema, devem ser utilizadas apenas para exemplificar a forma de iteração que os usuários possuirão ao acessar o HIS, o fluxo de negócio e a forma em que os dados e informações serão manipuladas.

Controle de Saldo por Residente

Funcionalidade	Controle de Saldo por Residente – Farmácia
Objetivo	Criar configuração para permitir ao usuário controlar o saldo de itens por residente controlado por permissão de acesso.
Módulo	Farmácia

Menu	Farmácia > Atendimento > Atendimento de Solicitações para o Paciente > Controle de Saldo por Residente
Regras da Interface
RI-001	Título do painel: Identificação do Residente Clique aqui para selecionar um paciente: Mesmo que o paciente tenha alta, ele deve ser exibido na lista para seleção. O paciente deve sair da lista de busca somente quando sua conta tiver sido fechada. Ao ser selecionado o residente, o sistema deve exibir: Residente (IH + Nome), Idade, Data de Nasc e Sexo. Caso já existam dados para esse paciente, os respectivos produtos devem ser listados com suas quantidades.
RI-002	Ao clicar no botão Detalhes do Atendimento, deve ser exibida a modal conforme protótipo abaixo:
RI-003	Painel: Itens Novos Exibe campos: Código, Descrição, Quantidade, Alertar, Tipo (esses campos são incluídos pelo link logo abaixo desse painel: Cliquei aqui para selecionar o produto...)

RI-004

Ao clicar no link "Clique aqui para selecionar o produto. Clique sobre o item para editá-lo" é exibida a página de Lançamento de Itens (Protótipo abaixo).
Descrição dos campos:

Tipo: Campo de seleção do tipo de compra. Campo Obrigatório. Devem ser apresentadas somente as opções abaixo:
Aquisição ILPI: Produto consumido do estoque do próprio residencial. Ao ser lançado esse saldo para o paciente, automaticamente deve ir todo o valor do produto para a conta do paciente.
Secretaria de Saúde / Família: Produto retirado por familiar/residente na secretaria da saúde ou compra feita pela Família.
Código de Barras: Campo para leitura de código de barras de um produto cadastro. Ao ser lido o código de barras através do botão Buscar, o sistema deve apresentar a Descrição do Produto.
Clique aqui para selecionar o produto: Devem ser listados todos os produtos ativos para seleção por descrição ou código. Ao selecionar o produto desejado, o sistema deve apresentar a Descrição do Produto
.
Quantidade: Campo para ser adicionado o saldo do produto adquirido. Deve aceitar apenas números inteiros. Campo obrigatório.
Alertar com: Campo para informar em que posição de saldo deve ser exibido o alerta para compra do produto. Campo fica habilitado e torna-se obrigatório sempre que o checkbox Alertar estiver selecionado (por default deve vir selecionado). Deve aceitar apenas números inteiros.
Lote: Deve ser habilitado e obrigatório sempre que se tratar de um produto de controle Total ou Parcial.
Validade: Deve ser habilitado e obrigatório sempre que se tratar de um produto de controle Total ou Parcial. Deve aceitar datas maiores ou igual a atual.
Voltar: Botão apenas retorna para a página anterior sem consistir/salvar informações.
Confirmar: Consiste informações e exibe mensagem de alerta em caso de campos obrigatórios não informados. Se todas as informações estiverem corretas, persiste dados no painel "Itens novos" da página anterior.
Excluir: Deve ser habilitado quando se tratar de uma edição. Deve apagar dados mediante a confirmação de que realmente deseja excluir os dados.

RI-005

Ao clicar sobre o registro adicionado no painel (protótipo abaixo), deve ser exibida a página para a edição das informações, conforme protótipo da RI-004. No caso de edição deve ser habilitado o botão Excluir conforme especificado na RI-004.
Ao clicar no botão Confirmar, os dados de todos os produtos presentes no painel Itens Novos passam para o painel Saldo do Residente. Neste momento toda esta quantidade adicionar deve ir para a conta do paciente caso o tipo seja de Aquisição ILPI.

Neste momento acessar: Faturamento > Faturamento > Lançamento de Itens na Conta do Paciente e validar lançamento dos produtos na conta do paciente respeitando quantidade adicionada.

RI-006

Toda vez que o produto chegar/passar do ponto de alerta, deve ser enviado um e-mail (configurações descritas no tópico 3.4. Configuração de Notificação de Necessidade de Aquisição de Produto) seguindo configuração exibida na tela do residente, onde:
Tipos de Aquisição devem ser: Secretaria da Saúde / Família e Aquisição ILPI.

E-mail para o Resp. Financeiro: Ao checar o campo, deve-se verificar na admissão do paciente se esse campo está preenchido, caso não esteja deve ser exibido um alerta impedindo a seleção. Necessário informar ao menos um tipo de aquisição para alerta do Resp. Financeiro.

E-mail para Farmácia: Ao checar o campo, deve-se verificar se nas configurações de notificação de alerta de aquisição de produto existe ao menos um e-mail cadastrado, caso não exista deve ser exibido um alerta impedindo a seleção. Necessário informar ao menos um tipo de aquisição para alerta da Farmácia.

RI-007

Painel: Saldo do Residente

Código: Exibe o código do produto adicionado.
Descrição: Exibe a descrição do produto adicionado.
Quantidade: Recebe a quantidade informada na RI-004. Caso já exista o mesmo produto, com o mesmo tipo de compra, o sistema deve adicionar essa nova quantidade a já existente. Caso ainda não exista, apenas adiciona uma nova linha. Caso seja feita uma dispensação de um item que não esteja no painel, o mesmo deve ser adicionado com o campo QUANTIDADE igual a zero.
Saldo: Resultado do cálculo do campo Quantidade subtraído pelas dispensações já realizadas. Quando saldo for igual ao campo Alertar, deve disparar a rotina de envio de e-mail de alerta. Caso seja feita uma dispensação de um item que não esteja no painel, o mesmo deve ser adicionado com o campo SALDO negativo. Para regularizar será necessário cadastrar uma nova compra, conforme especificado acima na RI-004, neste caso só deve ser adicionado na conta do paciente a diferença entre a quantidade comprada e a quantidade que já foi dispensada. Ex.: Se saldo negativo era de 15, e foi comprado 20, apenas 5 unidades do produto devem ir para conta. Regra para ser decrementado: Caso um produto tenha registro nos três tipos de saldo, o sistema deverá utilizar abaixa o saldo sempre usando a sequência a seguir: 1) Secretária de Saúde / Família 2) Aquisição ILPI.
Alertar: Recebe a quantidade informada na RI-004.
Tipo: Recebe o valor informado na RI-004. Caso o item tenha sido adicionado por meio de dispensação, automaticamente o tipo deve ser preenchido com o valor "Aquisição ILPI".

RI-008

Ao clicar sobre o registro, deve ser exibida uma página para editar o campo Quantidade e/ou Saldo. [Necessário perfil de acesso exclusivo para esta edição. Caso usuário não tenha permissão, deve ser exibido o alerta pelo sistema].

Caso editado o campo Quantidade para uma quantidade maior que a atual, os novos itens devem ir para a conta do paciente. Ao alterar a Quantidade, necessariamente o usuário é obrigado a selecionar um motivo previamente cadastrado [especificado no Protótipo 3.2]. Caso a nova quantidade seja menor que a atual, essa diferença deve ser removida da conta do paciente [Neste momento acessar: Faturamento > Faturamento > Lançamento de Itens na Conta do Paciente e validar lançamento dos produtos na conta do paciente respeitando quantidade adicionada ajustada].
Necessário controlar "Ajustes" no campo Saldo. Ao alterar o Saldo, necessariamente o usuário é obrigado a selecionar um motivo previamente cadastrado [especificado no Protótipo 3.2]. Deve-se a quantidade desse ajuste para considerar no cálculo do campo Saldo. Ou seja, Saldo = (Quantidade – Dispensações + Ajustes de Saldo Positivos – Ajustes de Saldo Negativos).

Painel: Manutenção de Saldo do Residente
Produto: Código e Descrição do Produto selecionados na página anterior.
Motivo de Ajuste: Motivo especificado no protótipo 3.2. Campo Obrigatório. Por default nenhuma opção selecionada.
Quantidade Atual: Quantidade de saldo cadastrada para o paciente. Exibe valor cadastrado na página anterior. É alterado conforme preenchimento do campo QUANTIDADE.
Quantidade: Por default é exibido com o mesmo valor do campo QUANTIDADE ATUAL. Pode ser editado para mais ou para menos. As alterações nesse campo devem atualizar também os campos QUANTIDADE ATUAL, SALDO ATUAL e SALDO.
Saldo Atual: Exibe o saldo pendente deste produto conforme exibido na página anterior. É alterado conforme preenchimento dos campos QUANTIDADE e SALDO.
Saldo: Por default é exibido com o mesmo valor do campo SALDO ATUAL. Pode ser editado para mais ou para menos. As alterações nesse campo devem atualizar também o campo SALDO ATUAL.

Painel: Histórico de Manutenções
Qtd Original: Apresenta a quantidade antes da edição do campo QUANTIDADE.
Qtd Nova: Apresenta a quantidade após a edição do campo QUANTIDADE.
Saldo Original: Apresenta o saldo antes da edição dos campos QUANTIDADE e SALDO.
Saldo Novo: Apresenta o saldo antes da edição dos campos QUANTIDADE e SALDO.
Usuário: Apresenta usuário que realizou a manutenção de saldo.
Motivo de Ajuste: Apresenta o motivo de ajuste selecionado pelo usuário ao realizar a manutenção.

Confirmar: Exibe alerta questionando se o usuário confirma as modificações. Em caso de aprovação, salva alterações, cria registro de histórico de manutenções e, no caso de ser um saldo do tipo Aquisição ILPI, pode disparar e-mail de alerta de alerta caso atinja o ponto de notificação.
Voltar: Retorna para a página anterior sem persistir alterações.

Cadastro de Motivos de Ajuste de Saldo do Residente

Funcionalidade	Cadastro de Motivos de Ajuste de Saldo do Residente – Estoque
Objetivo	Criar cadastro para permitir posterior justificativa de motivo de ajuste de saldo do residente.
Módulo	Estoque
Menu	Estoque > Cadastros > Cadastro de Motivos de Ajuste de Saldo do Residente

Regras da Interface
RI-001	Sistema deve possibilitar Incluir, Visualizar, Alterar e Excluir (logicamente) motivos de ajuste de saldo do residente. Cada opção deve ser habilitada por meio de permissão de acesso.
RI-002

Gerenciador de Dispensações Sem Filtro de Aprazamento

Funcionalidade	Gerenciador de Dispensações do Residente – Farmácia
Objetivo	Realizar dispensações sem filtro de data.
Módulo	Farmácia
Menu	Farmácia > Atendimento > Gerenciador de Dispensações do Residente

Regras da Interface
RI-001	Página deve ser habilitada por meio de permissão de acesso.
RI-002	Ao acessar registro, devem ser visualizadas as solicitações PENDENTES DE ATENDIMENTO / DISPENSAÇÃO, sem filtro de data. O gerenciador atual exibe itens com data de agora para trás, esta tela tem como objetivo visualizar tudo o que o paciente tenha pendente de dispensação, inclusive itens com data posterior ao dia de hoje. As dispensações feitas a partir desta funcionalidade, devem adicionar linhas no painel de Saldo do Residente, conforme especificado no protótipo 3.1. Somente nesse caso, quando adicionar linhas com saldo negativo, é que as dispensações feitas por essa tela deverão gerar lançamentos na conta do residente (exceto se no cadastro do produto estiver marcada a flag “Não Cobrado, valor incluso em taxa”). O relatório a ser impresso nessa página é o mesmo que é impresso pelo gerenciador de dispensações.
RI-003	Conforme protótipo acima, apresentar campo "Data/Hora Solic Mais Nova" indicando o horário da solicitação mais recente.
RI-004	Ao ser confirmada a dispensação de um produto, caso seja um produto com origem de compra de tipo "Secretaria da Saúde / Família", o sistema deve realizar a baixa somente do saldo do residente. Já caso o produto tenha origem de uma compra do tipo "Aquisão ILPI", além do saldo do residente, deve ocorrer a baixa de estoque do residente e também do estoque local da farmácia na qual a dispensação está sendo realizada. Botão Localizar Produto: Exclusivamente quando acessado o botão por este caminho, o sistema deve listar também produtos de controle Parcial. Onde caso o produto tenha dois lotes por exemplos, ambos serão exibidos a caberá ao usuário selecionar o respectivo lote (mais detalhes na RI-005). Após a seleção do respectivo lote, deve ser possível editar a quantidade do produto.
RI-005	Busca de produtos deve listar todos os lotes do respectivo item. A baixa de estoque no HIS será a do lote selecionado.

Configuração de Notificação de Necessidade de Aquisição de Produto

Funcionalidade	Configuração de Notificação de Necessidade de Aquisição de Produto – Adm. do Sistema
Objetivo	Configurar e-mail de alerta a ser enviado.
Módulo	Adm. do Sistema
Menu	Adm. do Sistema > Configurações > Configuração de Notificação de Necessidade de Aquisição de Produto

Regras da Interface
RI-001	Página deve ser habilitada por meio de permissão de acesso.
RI-002	Deve ser possível Incluir, Visualizar, Alterar e Excluir configuração.

RI-003	Painel: E-mail Assunto do E-mail: Campo para ser utilizado no assunto do e-mail. Deve permitir a utilização de macros. Campo Obrigatório. Mensagem do E-mail: Campo para ser adicionado o texto do corpo do e-mail. Deve permitir a utilização de macros. Campo Obrigatório. MACROS: Ao clicar sobre o campo, a macro é adicionada de acordo com a posição do cursor do mouse, ou no campo Assunto ou no campo Mensagem. Ao ser enviado o e-mail de alerta, a macro deve exibir os dados do respectivo residente. Necessárias as macros: @ih (IH do Residente), @nome_residente (Nome do Residente), @nome_médico (Médico da Prescrição), @produto (Produto que atingiu o ponto de alerta) e @saldo (saldo do produto que atingiu o ponto de alerta). Painel: Destinatários É um profissional cadastrado na instituição?: Caso selecionado o checkbox, a tela oculta os campos Nome e E-mail e apresenta um combo com autocomplete para seleção do profissional, conforme protótipo abaixo. Caso o profissional não tenha um e-mail informado em seu cadastro, ao clicar no botão inserir deve ser exibido um alerta e o mesmo não deve ser adicionado a grid. Nome: Nome do profissional/área. Texto livre e obrigatório. E-mail: E-mail do destinatário. Texto libre e obrigatório. Ao clicar em Inserir deve ser validado se o campo possui o caractere @, caso não possua, deve ser exibido um alerta de formato inválido. Inserir: Deve validar se campos estão preenchidos corretamente. Se estiverem, dados são adicionados na grid. Confirmar: Armazena informações. Voltar: Retorna para a página anterior sem salvar informações. Ao clicar sobre um registro, o sistema deve questionar se deseja-se excluí-lo. Em caso de confirmação, o respectivo registro deve ser removido do painel.
RI-004	Configurações de e-mail que o sistema deve utilizar são as mesmas já existentes nas configurações avançadas:
RI-005	Ao ser atingido o ponto de alerta de aquisição do produto, deve ser disparado o e-mail conforme configuração na RI-006 do tópico 3.1. Controle de Saldo por Residente.

Relatório de Movimentações de Estoque do Residente

Funcionalidade	Relatório de Movimentações de Estoque do Residente – Farmácia
Objetivo	Consultar movimentações de estoque do residente
Módulo	Farmácia
Menu	Farmácia > Relatórios > Relatório de Movimentações de Estoque do Residente

Regras da Interface
RI-001	Página deve ser habilitada por meio de permissão de acesso.
RI-002	Descrições dos Filtros: Data Inicial: Data do registro da Movimentação no sistema. Campo obrigatório caso residente não tenha sido informado. Data Final: Data do registro da Movimentação no sistema. Campo obrigatório caso residente não tenha sido informado. Residente: Residente para filtro de movimentações. Campo obrigatório caso Data Inicial e Data Final não tenham sido informados. Clique aqui para selecionar o Residente: Abre página para busca de residente, deve exibir todos os residentes cadastrados, inclusive os que já possuem alta. Clique aqui para limpar o campo: Apaga o residente selecionado. Produto: Produto para filtro de movimentações. Clique aqui para selecionar o Produto: Abre página para busca de produtos. Clique aqui para limpar o campo: Apaga o produto selecionado. Motivo de Ajuste de Saldo: Motivo de Ajuste de Saldo para filtro de movimentações. Clique aqui para selecionar o Motivo de Ajuste de Saldo: Abre página para busca de motivos. Clique aqui para limpar o campo: Apaga o motivo de ajuste de saldo selecionado. Imprimir: Direciona para página do relatório especificada a seguir na RI-003. Voltar: Retorna para a página anterior.

RI-003

Relatório de Movimentações de Estoque do Residente [Orientação padrão: PAISAGEM]

Título: MOVIMENTAÇÕES DE ESTOQUE DO RESIDENTE
Data da Impressão: Data/hora em que o impresso foi gerado.
Residente: Concatena IH e o Nome do Residente.
Código: Código do Produto
Descrição: Descrição do Produto
Operação: Pode ser:
a) AQUISIÇÃO – Secretaria da Saúde / Família
b) AQUISIÇÃO – Aquisição ILPI
c) DISPENSAÇÃO
d) AJUSTE DE SALDO
Data/Hora da Operação: Data/hora da movimentação
Qtd da Operação: Quantidade do produto na operação. Caso seja uma operação de saída/baixa, ao lado do valor deve ser exibido o sinal de negativo "-".
Saldo: Saldo do Produto após operação/movimento de estoque.
Usuário: Usuário responsável pela operação/movimento de estoque.
Motivo: Motivo de Ajuste de Saldo selecionado pelo usuário. Campo deve ser exibido só em caso de ajuste de saldo.
Voltar: Retorna para a página anterior.

Relatório de Saldo Atual do Residente

Funcionalidade	Relatório de Saldo Atual do Residente – Farmácia
Objetivo	Consultar movimentações de estoque do residente
Módulo	Farmácia
Menu	Farmácia > Relatórios > Relatório de Saldo Atual do Residente

Regras da Interface
RI-001	Página deve ser habilitada por meio de permissão de acesso.
RI-002	Descrições dos Filtros: Estabelecimento: Estabelecimento para filtro de saldos. Clique aqui para selecionar um estabelecimento: Abre página para busca de estabelecimentos. Clique aqui para limpar o campo: Apaga o estabelecimento selecionado. Unidade: Unidade para filtro de saldos. Clique aqui para selecionar uma unidade: Abre página para busca de unidades. Clique aqui para limpar o campo: Apaga a unidade selecionada. Residente: Residente para filtro de saldos. Clique aqui para selecionar um residente: Abre página para busca de residentes. Devem ser listados todos os residentes, mesmo que estes já tenham alta. Clique aqui para limpar o campo: Apaga o residente selecionado. Produto: Produto para filtro de saldos. Clique aqui para selecionar um produto: Abre página para busca de produtos. Clique aqui para limpar o campo: Apaga o produto selecionado. Tipo de Compra: Tipo de compra para filtro de saldos. Valores fixos e, por default, devem ser exibidos já selecionados. Exibir apenas produtos com saldo abaixo do ponto de alerta: Por default opção SIM é exibida selecionada. Neste caso deve buscar somente produtos que tenham atingido o ponto de alerta.
RI-003	Relatório de Saldo Atual do Residente [Orientação padrão: RETRATO] Título: SALDO ATUAL DO RESIDENTE Residente: Concatena IH e Nome do Residente Unidade: Exibe descrição da unidade em que o paciente está/foi atendido. Código: Código do Produto Descrição: Descrição do Produto Saldo: Saldo do produto para o residente. Caso o saldo seja negativo, ao lado deste deve ser exibido o sinal de negativo "-". Tipo de Compra: Tipo de compra do produto. Pode apresentar os valores Aquisição ILPI e Secretaria da Saúde / Família. Alertar em: Ponto de alerta para aquisição do produto. Voltar: Retorna para a página anterior.

Páginas filhas

ER_PCREQ-9886_MAT_Saldo_por_Residente