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