Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

 

 

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

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.

  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 utilizadas são: GG0, GG1, GG2, GG3 e GG8.

  4. Criar um Pergunte específico 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 desejada 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 -  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 layouts formato TISS Tipos de Guias e características no layout 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.
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.
  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 xxx)

  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.

  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.
Para melhor guiar o trabalho do desenvolvedor, segue um correspondente dos campos envolvidos no layout do XML entre o SIGAHSP e o SIGAPLS.

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:
  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
    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 xxx)
    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.
  5. 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.

       

  6.  

  7.  

  8.  

  9.  

 

 

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

  • BD5 – Processamento de Contas.
  • BD6  Eventos Processamentos Contas.
  • BTF  Cabeçalho Eventual.
  • BTC  Cabeçalho de Cobrança.
  • BDH  Usuarios Participação.
  • BDT – Calendário de Pagamentos.
  • BDC – Cabeçalho de Cobrança.

1.       

  • de Cobrança.

1.       

Opcional

Protótipo de Tela

 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.

 

 


Imagem 2 - Exemplo do layout da guia TISS 3.02.00 SP/SADT

 

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*/

  

Índice

Chave

01

<FI9_FILIAL+FI9_IDDARF+FI9_STATUS>

02

<FI9_FILIAL+FI9_FORNEC+ FI9_LOJA+FI9_EMISS+FI9_IDDARF>

03

<FI9_FILIAL+FI9_FORNEC+ FI9_LOJA+FI9_PREFIX+FI9_NUM+FI9_PARCEL+FI9_TIPO>

Campo

<AAA_PERESP>

Tipo

<N>

Tamanho

<6>

Valor Inicial

<Varia de acordo com o tipo informado. Por exemplo, quando o campo “tipo” for date, neste campo pode ser informado uma data>. 

Mandatório

Sim (  ) Não (  )

Descrição

<Referência Mínima para Cálculo>

Título

<Ref.Calc.>

Picture

<@E999.99>

Help de Campo

<Informar o % que o aluno pagará em dinheiro. Esse % poderá ser alterado durante a negociação>

 

(Opcional)

Grupo de Perguntas

 

<Informações utilizadas na linha Protheus>.

 

Nome: FINSRF2

X1_ORDEM

01

X1_PERGUNT

Emissão De

X1_TIPO

D

X1_TAMANHO

8

X1_GSC

G

X1_VAR01

MV_PAR01

X1_DEF01

Comum

X1_CNT01

'01/01/08'

X1_HELP

Data inicial do intervalo de emissões das guias de DARF a serem consideradas na seleção dos dados para o relatório 

 

(Opcional)

Consulta Padrão

<Informações utilizadas na linha Protheus>

 

Consulta: AMB

Descrição

Configurações de Planejamento

Tipo

Consulta Padrão

Tabela

“AMB”

Índice

“Código”

Campo

“Código”; ”Descrição”

Retorno

AMB->AMB_CODIGO

 

(Opcional)

Estrutura de Menu

 

<Informações utilizadas na linha Datasul>.

 

Procedimentos

 

Procedimento

 

 

 

Descrição

(Max 40 posições)

(Max 40 posições)

(Max 40 posições)

Módulo

 

 

 

Programa base

 

 

 

Nome Menu

(Max 32 posições)

(Max 32 posições)

(Max 32 posições)

Interface

GUI/WEB/ChUI/Flex

GUI/WEB/ChUI/Flex

GUI/WEB/ChUI/Flex

Registro padrão

Sim

Sim

Sim

Visualiza Menu

Sim/Não

Sim/Não

Sim/Não

Release de Liberação

 

 

 

 

 

 

Programas

 

Programa

 

 

 

Descrição

(Max 40 posições)

(Max 40 posições)

(Max 40 posições)

Nome Externo

 

 

 

Nome Menu/Programa

(Max 32 posições)

(Max 32 posições)

(Max 32 posições)

Nome Verbalizado[1]

(Max 254 posições)

(Max 254 posições)

(Max 254 posições)

Procedimento

 

 

 

Template

(Verificar lista de opções no man01211)

(Verificar lista de opções no man01211)

(Verificar lista de opções no man01211)

Tipo[2]

Consulta/Manutenção/ Relatório/Tarefas

Consulta/Manutenção/ Relatório/Tarefas

Consulta/Manutenção/ Relatório/Tarefas

Interface

GUI/WEB/ChUI/Flex

GUI/WEB/ChUI/Flex

GUI/WEB/ChUI/Flex

Categoria[3]

 

 

 

Executa via RPC

Sim/Não

Sim/Não

Sim/Não

Registro padrão

Sim

Sim

Sim

Outro Produto

Não

Não

Não

Visualiza Menu

Sim/Não

Sim/Não

Sim/Não

Query on-line

Sim/Não

Sim/Não

Sim/Não

Log Exec.

Sim/Não

Sim/Não

Sim/Não

Rotina (EMS)

 

 

 

Sub-Rotina (EMS)

 

 

 

Localização dentro da Sub Rotina (EMS)

 

 

 

Compact[4]

Sim/Não

Sim/Não

Sim/Não

Home[5]

Sim/Não

Sim/Não

Sim/Não

Posição do Portlet[6]

0 – Top Left

1 – Top Right

2 – Bottom Left

3 – Bottom Right

0 – Top Left

1 – Top Right

2 – Bottom Left

3 – Bottom Right

0 – Top Left

1 – Top Right

2 – Bottom Left

3 – Bottom Right

Informar os papeis com os quais o programa deve ser vinculado

 

 

 

 

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

 

Código Papel

(máx 3 posições)

Descrição em Português*

 

Descrição em Inglês*

 


[1] Nome Verbalizado é obrigatório para desenvolvimentos no Datasul 10 em diante.

[2] Tipo é obrigatório para desenvolvimento no Datasul 10 em diante

[3] Categorias são obrigatórias para os programas FLEX.

[4] Obrigatório quando o projeto for FLEX

[5] Obrigatório quando o projeto for FLEX

[6] Obrigatório quando o projeto for FLEX

Este documento é material de especificação dos requisitos de inovação, trata-se de conteúdo extremamente técnico.                                                             

...