Histórico da Página
Este documento é material de especificação dos requisitos de inovação, trata-se de conteúdo extremamente técnico. |
---|
Informações Gerais
Especificação | |||
Produto | Microsiga Protheus | Módulo | SIGAPLS |
Segmento Executor | Saúde | ||
Projeto | M_SAU_PLS001 | IRM | PCREQ-5315 |
Requisito | PCREQ-5319 | Subtarefa | PCSFA-394 |
Release de Entrega Planejada | 12.1.78 | Réplica | Não |
País | ( X ) Brasil ( ) Argentina ( ) Mexico ( ) Chile ( ) Paraguai ( ) Equador ( ) USA ( ) Colombia ( ) Outro _____________. | ||
Outros | Não Aplicável. |
Objetivo
A especificação presente visa detalhar para o desenvolvedor as tarefas e rotinas necessárias para a geração do arquivo xml – para a cobrança das empresas de reciprocidade, bem como para os casos de Intercâmbio – tornando este processo de cobrança mais rápido e simples para as empresas, visando ganho de tempo e redução de custos em todo o processo envolvido.
Nos casos de reciprocidade, o usuário poderá selecionar a opção de gerar o arquivo xml de cobrança no formato TISS e após o término do processamento, poderá enviar o arquivo para a operadora desejada - a fim de receber pelos atendimentos efetuados. Nos casos de intercâmbio (especifico de processos Unimed), o arquivo xml poderá ser gerado também – ao invés da utilização do PTU online – de acordo com a necessidade da organização.
Deste modo, o processo de cobrança de empresas de reciprocidade e intercâmbios se tornam mais práticas e produtivas para a operadora, pois além da praticidade existente no processo, haverá a normalização do arquivo xml no formato TISS, garantindo pleno atendimento a legislação vigente e a facilidade da comunicação neste formato.
Definição da Regra de Negócio
A geração de arquivos xml permite a rápida e eficaz comunicação entre operadoras e prestadores, permitindo que os processos sejam mais ágeis na cobrança e outros, além de permitir maior automatização dos processos, diminuindo o número de erros e glosas que podem ocorrer por lançamentos errôneos. Também, temos a questão da padronização, visto que o xml é um formato de uso universal e o padrão adotado pela ANS – Agência Nacional de Saúde Suplementar – deve ser seguido por todas as operadoras em território nacional.
Com a geração das cobranças de reciprocidade em formato xml, temos maior agilidade no processo produtivo da organização, além de oferecer maior integração com outros sistemas e o fim de uma série de controles paralelos que possam existir para controlar estas cobranças. Logo, o processo será simplificado e integrado, propiciando ganhos e melhorias para todos os envolvidos.
Regras de Negócio - Definições Gerais
Aqui, detalhamos as etapas básicas sobre o funcionamento da nova funcionalidade, elencando apenas as caracteriticas de uso que deverá existir no sistema para o usuário final. Por se tratar de algo complexo, as demais partes serão divididas, para facilitar o entendimento do desenvolvedor.
- Será criada uma nova opção no menu EDI do PLS (Miscelanea / E.D.I.), identificada como XML TISS.
a. Essa opção deverá ter dois sub-itens, chamados de Layout e Itens do Layout. - Esse menu será igual ao menu E.D.I. existente no módulo SIGAHSP (Gestão Hospitalar), que fica no caminho: Atualizações / EDI - Hospital / Cadastro.
- A rotina HSPAHM52 – no fonte HSPAHM52 – será reaproveitada, sendo necessário apenas algumas adaptações para o pleno funcionamento no PLS.
a. As tabelas que hoje são utilizadas no SIGAHSP para importação / exportação do layout serão mantidas e utilizadas, para centralizar tudo numa tela só, sem necessidade de criar mais tabelas no PLS para o mesmo feito.
b. As tabelas utilizadas são: GG0, GG1, GG2, GG3 e GG8.
- Criar um Pergunte específico para o PLS, com o nome PLSEXPTISS, constando os seguintes campos:
a. Pesquisa do tipo F3, para procurar a operadora padrão (BA0);
b. Campo combobox, com as opções Cobrança ou Intercâmbio;
c. Pesquisa do tipo F3, para localizar os lotes de cobrança da tabela BDC (se não houver pesquisa padrão para esta tabela, criar uma);
d. Pesquisa do tipo F3, para localizar os lotes de cobrança de intercambio da tabela BTF (se não houver pesquisa padrão para esta tabela, criar uma).
e. Será necessário criar validação no campo combobox, para que quando seja selecionado o tipo Cobrança, fique apenas disponível a pesquisa baseada na tabela BDC e quando for escolhido Intercâmbio, fique disponível apenas a pesquisa da tabela BTF.
f. OBS: Caso o programador queira utilizar outro meio neste Pergunte, para torna-lo mais dinâmico em tempo de execução, poderá realizá-lo, desde que respeite as normas impostas acima.
- A função HSPAHM52 deverá sofrer alterações para detectar quando for chamada do PLS, pois quando o usuário selecionar o registro de tipo de guia desejada na tela e clicar na função Exportar, deverá obrigatoriamente exibir o Pergunte criado acima (PLSEXPTISS), para que o cliente possa escolher o lote de pagamento, a operadora e qual o tipo de exportação deseja utilizar (Cobrança ou Intercâmbio, quando aplicável para a organização).
- No fonte PLSA627 – Lote de Cobrança – será necessário criar opção Gerar XML TISS no menu Outras Ações, pois ao clicar neste botão, por já estar posicionada no lote desejado, o sistema deverá gerar os arquivos xml de cobrança referente aos itens encontrados no lote em questão.
- No fonte PLSA628 – Lote de Cobrança Intercâmbio – será necessário criar opção Gerar XML TISS no menu Outras Ações, pois ao clicar neste botão, por já estar posicionado no lote de intercâmbio desejado, o sistema deverá gerar os arquivos xml de cobrança referente aos itens encontrados no lote em questão.
- Em ambos os casos acima - caso a função seja chamada pelo Lote de Cobrança (PLSA627) ou Lote de Cobrança Eventual - Intercâmbio (PLSA628), antes de iniciar o processo de geração do xml, será necessário o usuário indicar em qual pasta do computador deseja salvar o arquivo, para que o sistema possa gerar o xml neste local.
a. Aqui, será necessário o uso da função cGetFile, que exibe a estrutura de pasta do computador do usuário.
b. Após a escolha do local pelo usuário, será necessário gerar o arquivo xml nesta pasta. Após a geração do arquivo xml no local determinado pelo usuário, será necessário emitir um alerta (Alert/MSGALERT), indicando o sucesso da operação e o local onde está salvo o arquivo xml.
Regras de Negócio - Tipos de Guias e características no layout TISS 3.02.00
- Iremos trabalhar com as seguintes guias para a geração das cobranças, baseadas no formato hoje existente no SIGAHSP. No HSP, o caminho para verificar estas guias é via Atualizações / EDI - Hospital / Cadastro / Layout.
- Ao abrir a tela, teremos as seguintes guias no formato TISS 3.02.00:
- Guia no formato TISS 3.02.00 SP/SADT
- Guia no formato TISS 3.02.00 Internação
- Guia no formato TISS 3.02.00 Consulta
- Guia no formato TISS 3.02.00 Honorário Individual
- Atrelados a estes layouts, temos os Itens de layouts, onde para cada guia, temos as subdivisões de acordo com a ANS, para formar o arquivo de xml corretamente. Para verificar os subitens de cada guia, no HSP, devemos acessar Atualizações / EDI - Hospital / Cadastro / Itens de layout.
- Os itens de layout são relacionados com o Layout principal pelo campo chamado Cód. Grupo (Verifique a imagem 2, na seção Imagens de Apoio).
- Em ambos os itens - Layout e Itens de Layout - é necessário verificar as querys e tags, promovendo a compatibilização com o PLS. Sempre que um campo não existir no PLS, será necessário verificar no schema da ANS se este campo é opcional: se sim, podemos remover a tag. Caso não, será necessário verificar com os superiores sobre a possibilidade de cadastrar este campo no PLS ou outra saída.
Os schemas podem ser encontrados nos eguinte endereço: http://www.ans.gov.br/prestadores/tiss-troca-de-informacao-de-saude-suplementar/padrao-tiss-versao-3-02-01. - Porém, temos um caso onde será necessário escrever uma nova query, não sendo possível aproveitar a existente. A query está Porém, temos um caso onde será necessário escrever uma nova query, não sendo possível aproveitar a existente. A query está localizada em Itens de Layout/ Total da Guia - Internação.
Essa query terá que ser reescrita, pois se trata dos totais da guia de internação, dividida por itens do tipo: Por Procedimentos, Por OPME, Por Gases Medicinais, Por Valor dos Medicamentos, Por Materiais, Por Diárias e Por Taxas e Aluguéis.
No PLS, essa divisão de tipos de materiais é feita na tabela BR8, no campo BR8_TPPROC, onde identificamos que o procedimento cadastrado se trata de um Procedimento, OPME ou qualquer um dos acima listados. Por isso, será necessário reescrever a query, pensando nesta característica do PLS.
Como exemplo, pode ser consultado no fonte PLSTISS a rotina PLSGINT, que gera esses totalizadores na hora da impressão da guia TISS.
Logo, percebemos que para cada Layout de guias, temos os Itens de Layout, relacionados via Cod. Grupo.
Esse relacionamento também existirá no PLS. Logo, fundamental é o entendimento sobre o funcionamento e as características, para que seja possível reproduzir no PLS.
Regras de Negócio - Definições sobre layouts formato TISS 3.02.00
- Como estamos baseando nossos arquivos nos layouts já existentes no SIGAHSP, será necessário adaptar todas as querys existentes neste módulo para os campos do PLS, para garantir o funcionamento e os dados corretos na geração das cobranças.
- No SIGAHSP, o fonte responsável pela parte de Itens de layout é chamado de HSPAHABS e o fonte responsável pelo Layout é o HSPAHM52.
- No SIGAHSP, o sistema trabalha na estrutura de query pai e query filhas, fazendo os relacionamentos necessários para buscar e consolidar os dados para o funcionamento.
- Será necessário o estudo destas querys, para que seja feita a compatibilização com as tabelas e campos do PLS, para que retorne os mesmos resultados.
- Para maior entendimento, consulte na parte de protótipos a tela existente hoje no SIGAHSP, para verificar o esquema de trabalho existente nestes fontes citados acima.
- Para maior entendimento, consulte na parte de protótipos a tela existente hoje no SIGAHSP, para verificar o esquema de trabalho existente nestes fontes citados acima.
- Podemos resumir que todas as querys deverão ser adaptadas para as tabelas do PLS. Deste modo, para essa compatibilização, serão usadas as tabelas BD5 e BD6, que contêm os cabeçalhos de cobrança e itens de cobrança, além da BD7, parte de honorários, quando houver a necessidade.
- Quando a query for para relacionar apenas Cobrança (ou seja, sem intercâmbio), será necessário chegar nas tabelas BD5 e BD6, utilizando como forma de relacionamento os dados da tabela BDC para a BBT. Para relacionar Cobrança de Intercâmbio, será necessário utilizar os dados da tabela BTF para a BBT, para então, chegarmos na BD5, que relaciona com a tabela BD6.
- Para melhor guiar o trabalho do desenvolvedor, segue um correspondente dos campos envolvidos no layout do XML entre o SIGAHSP e o SIGAPLS. De-Para Campos.xlsx
8. Para conversões entre a terminologia do Sistema e a terminologia TISS, utilizar a função PLSGETVINC - pois ela é responsável pelo prepara entre o código do procedimento no PLS para a Terminologia TISS - disponível no fonte PLSTISS.
9. Após a criação dos layouts, será necessário exportá-los e adiciona-los ao TFS. Será necessário criar a estrutura de pastas dentro de Pano de Saúde: Layouts EDI -> TISS -> V30200.
Observações Importantes - Como obter os layouts desta especificação
O desenvolvedor terá que acessar o SIGAHSP e verificar se na sua base local já existem os layouts informados nesta especificação, que são:
Guia no formato TISS 3.02.00 SP/SADT
Guia no formato TISS 3.02.00 Internação
Guia no formato TISS 3.02.00 Consulta
Guia no formato TISS 3.02.00 Honorário Individual
- Caso não tenha, será necessário baixar os layouts do TFS, que estão na pasta: $/Protheus_Padrao/Fontes_Doc/Sustentação/V12/V12/Fontes/Gestao Hospitalar/Layouts EDI/TISS/V30200/DBF e salvar estes arquivos em alguma pasta dentro do servidor do Protheus (dentro da pasta Protheus_Data)
- Após isto, terá que configurar o parâmetro MV_DEXPLAY, via Configurador ou APSDU, indicando o caminho desta pasta com a contrabarra - Exemplo: \dadosdbf
Depois, acessar o módulo SIGAHSP e acessar o menu Layout, via Atualizações / EDI - Hospital / Cadastro / Layout.
Na tela que se abre, clicar no botão Outras Ações e selecionar a opção Imp_layout, pois baseado no caminho do parâmetro MV_DEXPLAY, o sistema irá verificar os layouts disponíveis e exibir uma janela, com todos os layouts encontrados nos dbfs.
Marque todos os layouts no grid e após, clique no botão Salvar. O sistema irá importar para as tabelas os layouts e a partir daí, será possível realizar os demais trabalhos necessários desta especificação.
Rotina Rotina - Módulo | Tipo de Operação | Opção de Menu | Regras de Negócio |
HSPAHM52 - SIGAHSP | Alteração | - | 1, 2, 3, 4, 5 |
PLSA627 - SIGAPLS | Alteração | - | 6, 8, 9 |
PLSA628 - SIGAPLS | Alteração | - | 7, 8, 9 |
HSPAHABS - SIGAHSP | Alteração | - |
Funções / Recursos | Descrição |
PLSGETVINC | Retorna a descrição ou código do vínculo entre procedimento e a terminologia TISS |
MSGALERT | Exibir um alerta para o usuário |
Alert | Exibir um alerta para o usuário |
MSGYESNO | Tela de confirmação, onde o usuário pode selecionar sim ou não. |
HSPAHM52 | Cadastro de Layout no SIGAHSP e que será reaproveitado no PLS |
HSPAHABS | Cadastro de Itens de Layout |
Tabelas Utilizadas
- BD5 – Processamento de Contas.
- BD6 – Eventos Processamentos Contas.
- BTF – Cabeçalho Eventual.
- BDH – Usuarios Participação.
- BDT – Calendário de Pagamentos.
- BDC – Cabeçalho de Cobrança.
Observação
Em consonância com as melhores práticas de programação e necessidades no desenvolvimento do requisito, poderão ser incluídos/criados outros fontes ou funções de apoio e consulta, para executar da melhor maneira possível o proposto neste documento.
1.
Imagens de Apoio
Imagem 1 - Tela existente hoje no SIGAHSP, de Layouts de Guias. No destaque, percebemos as quatro guia pertencentes ao padrão TISS 3.02.00, que deverão ser cadastradas também para o PLS.
Imagem 2 - Exemplo do layout da guia TISS 3.02.00 SP/SADT. Note no destaque (quadrado 1), que temos os códigos de grupo (Cod. Grupo), onde são relacionados os itens de layout com esse layout.
Imagem 3 - Exemplo de query que terá que ser adaptada para os campos do PLS.
Imagem 4 - Tela Itens de Layout. Note que aqui, os itens de layout são relacionados ao layou pelo Código de Grupo (Cod. Grupo). Veja figura 2 onde demonstramos esse mesmo código de relacionamento..
Imagem 5 - Itens de layout, onde vemos as tags e query que necessitam de modificação para rodar no PLS.
Protótipos de Tela
Protótipo 1 - Botão Gerar XML TISS na tela de Lote de Cobrança de Intercâmbio
Protótipo 2 - Botão Gerar XML TISS na tela de Lote de Cobrança.
Protótipo 3 - Exemplo do comando cGetFile, que deve ser exibido antes de salvar o xml, para o usuário indicar o local onde deseja salvar o arquivo.
salvar o arquivo.
Fluxo do Processo
Caso de Uso 1 - Geração Arquivo XML TISS
Caso de Uso 2 - Importação dos layouts TISS
Grupo de Perguntas
Nome: PLSEXPTISS
X1_ORDEM | 01 |
X1_PERGUNT | Tipo de Lote |
X1_TIPO | C |
X1_TAMANHO | 1 |
X1_GSC | C |
X1_VAR01 | MV_PAR01 |
X1_DEF01 | INTERCÂMBIO |
X1_DEF02 | RECIPROCIDADE |
X1_HELP | Indica o tipo de lote que será buscado para a geração do XML |
X1_ORDEM | 02 | ||
X1_PERGUNT | Operadora | ||
X1_TIPO | C | ||
X1_TAMANHO | 4 | ||
X1_GSC | G | ||
X1_VAR01 | MV_PAR02 | ||
X1_F3 |
| X1_HELP | Operadora |
X1_ORDEM | 03 | ||
X1_PERGUNT | Lote Intercâmbio | ||
X1_TIPO | C | ||
X1_TAMANHO | 8 | ||
X1_GSC | G | ||
X1_VAR01 | MV_PAR03 | X1_F3 | |
X1_HELP | Número do lote de intercâmbio para a geração do XML |
X1_ORDEM | 04 | ||
X1_PERGUNT | Lote Cobrança | ||
X1_TIPO | C | ||
X1_TAMANHO | 8 | ||
X1_GSC | G | ||
X1_VAR01 | MV_PAR04 | ||
X1_ | F3X1_HELP | Número do lote de cobrança para a geração do XML |
Este documento é material de especificação dos requisitos de inovação, trata-se de conteúdo extremamente técnico. |
---|
|
---|