Cockpit - Tela de Atualização de Regras de Medicamentos

Introdução

A Tela de Atualização de Regras de Medicamentos foi desenvolvida para permitir o gerenciamento controlado das regras fiscais aplicáveis a produtos do segmento farmacêutico, garantindo consistência entre as parametrizações específicas definidas pelo usuário e as regras disponibilizadas pela carga interna de regras.

Nesta funcionalidade, o cadastro do produto, sua origem e o cenário associado são considerados critérios prioritários de identificação. Quando esses dados estiverem configurados, as regras de medicamentos correspondentes não serão atualizadas automaticamente pela carga interna de regras, assegurando que as regras existentes aprovadas sejam preservadas.

Dessa forma, a tela oferece maior controle sobre a manutenção das regras de medicamentos, permitindo que ajustes específicos sejam realizados de forma consciente e evitando novos registros indevidos durante processos automáticos de atualização.

Atualização de Regras de Medicamentos

Tela de Atualização de Regras de Medicamentos

A Tela de Atualização de Regras de Medicamentos foi desenvolvida para permitir o controle e a gestão das regras fiscais aplicáveis a medicamentos, garantindo que parametrizações específicas não sejam sobrescritas indevidamente por cargas automáticas de regras.

A tela está dividida em três partes principais, cada uma com uma finalidade específica, conforme descrito a seguir.


1. Filtro

A seção de Filtro permite ao usuário localizar e restringir o conjunto de regras que serão analisadas ou atualizadas.
Por meio dos filtros disponíveis, é possível selecionar informações como produto, origem e cenário, facilitando a identificação das regras aplicáveis ao contexto desejado.

O uso correto dos filtros contribui para maior precisão nas operações, reduzindo o risco de alterações indevidas e otimizando o processo de atualização.

image.png


2. Upload

A seção de Upload é destinada ao envio de arquivos contendo regras de medicamentos para atualização controlada.
Nesta etapa, o usuário poderá realizar o upload manual das regras, garantindo que apenas os registros desejados sejam processados.

As regras enviadas por meio do upload respeitam as configurações previamente cadastradas, impedindo que sejam sobrescritas por cargas internas automáticas, quando aplicável.

image.png


3. Log de Requisições

O Log de Requisições apresenta o histórico das operações realizadas na tela, permitindo o acompanhamento e a rastreabilidade das atualizações efetuadas.
Nesta área, o usuário pode consultar informações como data e hora da requisição, status do processamento e resultado da operação, possibilitando a identificação de eventuais falhas ou inconsistências.

O log é um elemento fundamental para auditoria e controle, garantindo maior transparência e segurança no processo de atualização das regras de medicamentos.

image.png

4. Demonstrativo dos Registros bloqueados

Demonstrativo dos Registros bloqueados apresenta em tela todos os registros (cenário + produto + origem) que estão bloqueados para não receber atualizações automáticas decorrentes de cargas internas no cockpit.

image.png

Incluir Registro unitário

A funcionalidade de Inclusão do Registro Unitário permite o cadastro individual de regras de medicamentos de forma manual e controlada, sendo indicada para situações que exigem ajustes pontuais ou criação específica de registros, sem a necessidade de realizar carga em lote.

Essa opção garante maior flexibilidade ao usuário, ao mesmo tempo em que mantém a integridade das configurações já existentes no sistema.

Para incluir um registro unitário, o usuário deverá clicar no botão "incluir":

image.png

Abrirá a tela de pop-up para que as informações relativas ao produto e cenário sejam informadas:

image.png

As informações que deverão ser preenchidas são:

id_cenario

ID cenário

código do cenário registrado
cod_prod Código de Produto código do produto registrado
descriçao Descrição descrição do produto
mat_origem Material Origem origem do produto
ean EAN ean do produto
ncm NCM ncm do produto
ex-tipi ex-TIPI ex-tipi da ncm do produto se houver
vigência_de Vigência inicial vigência inicial para bloquear a integração das regras
vigência_ate Vigência final vigência final de bloqueio da integração das regras

Após o preenchimento completo da tela, clicar no botão "salvar":

image.png

Na tela de pop-up aparecera o status do registro, ou seja, salvo com sucesso:

image.png

A requisição será inserida no log de requisições, registrando a data, horário, usuário e a quantidade de registros. 

image.png

A partir desse momento, as regras (cenário + código de produto + origem do produto) estarão bloqueadas, ou seja, se o cockpit recepcionar uma carga interna desses registros, não será integrado ao cockpit.

Incluir registros em lote

A funcionalidade de Registro em Lote permite a inclusão e atualização de múltiplas regras de medicamentos de forma simultânea, por meio do envio de um arquivo estruturado. Essa opção é indicada para situações que envolvem grande volume de registros, proporcionando maior agilidade e padronização no processo de manutenção das regras.

O registro em lote possibilita o processamento controlado das informações, respeitando as configurações existentes no sistema e garantindo consistência nos dados cadastrados.

A tela possui o template para ser seguido na confecção do arquivo para upload:

image.png

O modelo do arquivo é o seguinte:

image.png

id_cenario

ID cenário

código do cenário registrado
cod_prod Código de Produto código do produto registrado
descriçao Descrição descrição do produto
mat_origem Material Origem origem do produto
ean EAN ean do produto
ncm NCM ncm do produto
ex-tipi ex-TIPI ex-tipi da ncm do produto se houver
vigência_de Vigência inicial vigência inicial para bloquear a integração das regras
vigência_ate Vigência final vigência final de bloqueio da integração das regras

Para inclusão em lote, basta fazer o upload do arquivo:

image.png

O arquivo será processado e o usuário será informado o status do upload. Em seguida será registrado a requisição no log de requisições:

image.png

E os registros ficarão disponíveis para consulta na parte de registros:

image.png

A partir desse momento, as regras (cenário + código de produto + origem do produto) estarão bloqueadas, ou seja, se o cockpit recepcionar uma carga interna desses registros, não será integrado ao cockpit.

Filtros

A seção de Filtros tem como objetivo permitir a localização rápida e precisa dos registros de regras de medicamentos, facilitando a consulta, análise e manutenção das informações cadastradas no sistema.

Por meio dos filtros, o usuário pode restringir o conjunto de resultados exibidos na tela, tornando o processo de gestão das regras mais eficiente e seguro.

Os filtros podem ser feitos considerando os seguintes campos, usando informações combinadas ou não:

image.png

Os campos são:

ID cenário

código do cenário registrado
Código de Produto código do produto registrado
Descrição descrição do produto
Material Origem origem do produto
EAN ean do produto
NCM ncm do produto
ex-TIPI ex-tipi da ncm do produto se houver
Vigência de vigência inicial informado no registro
Vigência até vigência final informado no registro, se houver

image.png

image.png

 

Exportar Registros

A funcionalidade de Exportar Registros permite ao usuário extrair os dados dos registros exibidos na tela para um arquivo externo, possibilitando análise, conferência e compartilhamento das informações de forma prática e segura.

Essa opção é especialmente útil para validações e controle interno das regras cadastradas no sistema.

Para fazer a exportação dos registros da tela, basta clicar no ícone do excel na tela:

image.png

Será gerado um arquivo contendo os registros demonstrados em tela, ou seja, na totalidade ou somente os registros filtrados:

image.png

Arquivo completo:

image.png

Arquivo parcial:

image.png

 

Desativação dos Registros

A funcionalidade de Desativação de Registros permite ao usuário inativar regras de medicamentos cadastradas manualmente na tela de atualização, restabelecendo o comportamento padrão do sistema para aquele produto, origem e cenário.

Ao desativar um registro, o Cockpit deixa de considerar a configuração manual e volta a recepcionar automaticamente as regras oriundas da carga interna.

Para desativar um registro, basta selecionar através dos filtros, ativar a flag e clicar no botão "desativar":

image.png

image.png

Informar a justificativa:

image.png

E os registros passarão a ficar desativados:

image.png

A partir desse momento, as cargas internas relativas a esses produtos e cenário voltarão a integrar normalmente no cockpit.

 

 

Reativação de Registros

A funcionalidade de Reativação de Registros permite ao usuário reativar regras de medicamentos previamente desativadas na tela de atualização, restabelecendo a aplicação da configuração manual para o produto, origem e cenário correspondentes.

Ao reativar um registro, o Cockpit volta a considerar a regra cadastrada manualmente, impedindo novamente a atualização automática das regras oriundas da carga interna.

Para reativar um registro, basta selecionar através dos filtros, ativar a flag e clicar no botão "ativar":

image.png

Abrirá o pop-up solicitando a confirmação da reativação dos registros:

image.png

Após a confirmação, os registros serão reativados novamente:

image.png

image.png