Informações Gerais

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.

1. Será criada uma nova opção no menu EDI do PLS (Miscelanea /  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.), identificada como XML TISS. 
        a. Essa opção deverá ter dois sub-itens, chamados de Layout e Itens do Layout.
   
   
2. Esse menu será igual ao menu E.D.I. existente existente no módulo SIGAHSP (Gestão Hospitalar), que fica no caminho: Atualizações / EDI - Hospital / Cadastro. 
   
   
3. 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: gg0GG0, gg1GG1, gg2GG2, gg3 GG3 e gg8GG8.
   
   

4. Criar um Pergunte específico para o PLS, com o nome MV_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. 
   
   

5. 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 (MV_PLSEXPTISSS)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).
   
   
6. 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. 
   
   
7. 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. 
   
   
8. 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.

    

9. 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 - Definições sobre layout formato TISS Tipos de Guias e características no layout TISS 3.02.00

Exemplo de Aplicação:

• Criar o campo “% Mínimo Espécie” (AAA_PERESP) onde o usuário informará o % que o aluno pagará em dinheiro. Esse % poderá ser alterado durante a negociação.
• Criar o campo “Referência Mínima para Cálculo” (AAA_REFCAL) onde o usuário informará um dos 4 valores disponíveis para pagamento das mensalidades  como a referência mínima para calcular o débito total do aluno.
• Criar o parâmetro MV_ACPARNE que definirá se as informações de “% Mínimo Espécie” e “Referência Mínima para Cálculo” serão obrigatórias.
• O parâmetro MV_ACPARNE deve ter as seguintes opções: 1=Obrigatório e 2=Opcional. Deve ser inicializado como opcional>.

Tabelas Utilizadas

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

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

3.       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 estão no range: gg0, gg1, gg2, gg3 e gg8.

4.       Criar um Pergunte especifico para o PLS, com o nome MV_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.

5.       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 desejado na tela e clicar na função Exportar, deverá obrigatoriamente exibir o pergunte criado acima (MV_PLSEXPTISSS), 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).

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

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

8.       Em ambos os casos acima -  a função ser chamada pelo lote de cobrança ou lote de cobrança eventual, 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.

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

Opcional

Protótipo de Tela

<Caso necessário inclua protótipos de telas com o objetivo de facilitar o entendimento do requisito, apresentar conceitos e funcionalidades do software>.

Protótipo 01

 Image Removed

Opcional

Fluxo do Processo

<Nesta etapa incluir representações gráficas que descrevam o problema a ser resolvido e o sistema a ser desenvolvido. Exemplo: Diagrama - Caso de Uso, Diagrama de Atividades, Diagrama de Classes, Diagrama de Entidade e Relacionamento e Diagrama de Sequência>. 

Opcional

Dicionário de Dados

Arquivo ou Código do Script: AAA – Negociação Financeira / *Versao=CP.2014.12_03*/

(Opcional)

Grupo de Perguntas

<Informações utilizadas na linha Protheus>.

Nome: FINSRF2

(Opcional)

Consulta Padrão

<Informações utilizadas na linha Protheus>

Consulta: AMB

1. 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.
   
   
2. Ao abrir a tela, teremos as seguintes guias no formato TISS 3.02.00:
   1. Guia no formato TISS 3.02.00 SP/SADT
   2. Guia no formato TISS 3.02.00 Internação
   3. Guia no formato TISS 3.02.00 Consulta
   4. Guia no formato TISS 3.02.00 Honorário Individual
      
      
3. 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.
   
   
4. 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).
   
   
5. 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.
   
   
6. 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. 

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

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

   3. Como exemplo, pode ser consultado no fonte PLSTISS a rotina PLSGINT, que gera esses totalizadores na hora da impressão da guia TISS.
       

7. Logo, percebemos que para cada Layout de guias, temos os Itens de Layout, relacionados via Cod. Grupo. 

   
   

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

1. 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.
   
   
2. No SIGAHSP, o fonte responsável pela parte de Itens de layout é chamado de HSPAHABS e o fonte responsável pelo Layout é o HSPAHM52.
   
   
3. 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.
   
   
4. 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.
   
   1. 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.
      
      
5. 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.
   
   
6. 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.
   
   
7. 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

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

   1. Guia no formato TISS 3.02.00 SP/SADT

   2. Guia no formato TISS 3.02.00 Internação

   3. Guia no formato TISS 3.02.00 Consulta

   4. Guia no formato TISS 3.02.00 Honorário Individual

2. 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)
3. 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

4. Depois, acessar o módulo SIGAHSP e acessar o menu Layout, via Atualizações / EDI - Hospital / Cadastro / Layout.

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

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

    

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

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

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

Image Added
Imagem 3 - Exemplo de query que terá que ser adaptada para os campos do PLS.

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

Image Added
Imagem 5 - Itens de layout, onde vemos as tags e query que necessitam de modificação para rodar no PLS.

Protótipos de Tela

Image Added
Protótipo 1 - Botão Gerar XML TISS na tela de Lote de Cobrança de Intercâmbio

Image Added
Protótipo 2 - Botão Gerar XML TISS na tela de Lote de Cobrança.

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

Fluxo do Processo

 Image Added

Caso de Uso 1 - Geração Arquivo XML TISS

Image Added

Caso de Uso 2 - Importação dos layouts TISS

Grupo de Perguntas

Nome: PLSEXPTISS

(Opcional)

Estrutura de Menu

<Informações utilizadas na linha Datasul>.

Procedimentos

Programas

Cadastro de Papéis

<O cadastro de papéis é obrigatório para os projetos de desenvolvimento FLEX a partir do Datasul 10>.

<Lembrete: o nome dos papeis em inglês descrito neste ponto do documento, devem ser homologados pela equipe de tradução>.