Árvore de páginas

Versões comparadas

Chave

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

...

03. Exemplo De Utilização da API

                                                       

API

Através da API analyticDmedExpenses recebemos um POST com as despesas e as gravamos na tabela B2Y (Despesas analíticas).

Quem já utiliza o SIB na Central de Obrigações basta enviar a Operadora + Matrícula + CPF do Titular que o sistema já busca e grava o nome pelo que encontrou no cadastro de beneficiário (B3K). Já o dependente (quando for o caso), deve pode vir  Operadora + Matrícula +Nome que o sistema atualiza a data de nascimento e a relação de dependência da tabela de beneficiários. Entretanto, quem não utiliza o SIB, deve enviar todas as informações necessárias para determinado Identificador de Registro.

...

  • Envie um Json conforme exemplo abaixo, com o campo exclusionId = "0" e o campo expenseKey = a uma chave já enviada. Para alterar uma despesa já enviada, basta mandá-la novamente. Caso ela já tenha sido processada pelo JOB de Processamento, o sistema irá retirar o valor da tabela de movimentação e excluir o registro gravado pela API anteriormente. 

...

  • Envie um Json conforme exemplo abaixo, com o campo exclusionId = "1" e o campo expenseKey = a uma chave que já existe e você queira excluir. Neste processo, o sistema irá gerar um registro de exclusão na tabela B2Y e posteriormente ao rodar o JOB de Processamento (SVCPRCDMED) estes valores serão consolidados.


          Exemplo:

          Em Outubro foi enviado uma despesa para o titular com a expenseKey ="00000000000000000000001"   valor 1.000,00 e  exclusionId = "0"

...

{   
    "healthInsurerCode":"000000",
    "ssnHolder":"76116313221",
    "titleHolderEnrollment":"00010001000011005",
    "holderName":"PAULO SILVA TITULAR",
    "dependentSsn":"14754460553",
    "dependentEnrollment":"00010001000011108",
    "dependentName":"DEPENDENTE TITULAR",
    "dependentBirthDate":"20091013",
    "dependenceRelationships":"03",
    "expenseKey":"0000000000000000000000000000000000000004",
    "refundAmount":2000,
    "previousYearRefundAmt":2000,
    "period":"202010",
    "providerSsnEin":"39613205861",
    "providerName":"NOME PRESTADOR",
    "exclusionId":"0"
}


CampoDescriçãoObrigatório na API
healthInsurerCodeOperadoraSim
ssnHolderCPF TitularSim
titleHolderEnrollmentMatrícula TitularNão
holderNameNome TitularNão
dependentSsnCPF DependenteSim (quando despesa for do dependente)
dependentEnrollmentMatrícula DependenteNão
dependentNameNome DependenteSim (quando despesa for do dependente)
dependentBirthDateData de NascimentoNão
dependenceRelationshipsRelação de DependênciaNão
expenseKeyChaveSim
expenseAmountValor DespesaNão
refundAmountValor ReembolsoNão
previousYearRefundAmtValor Reembolso Ano AnteriorNão
periodPeríodoSim
providerSsnEinCPF/CNPJ PrestadorSim (Quando tratar-se de Reembolso)
providerNameNome Prestador Não
exclusionIdExclusãoSim

04. Configuração JOBS

Para configurarmos os JOBS utilize o Wizard Configurador, acesse Atualizações > Wizard Configurador > Selecione o processo da DMED > Em outras ações selecione a operadora Padrão e a Periodicidade que será executado o JOB > Avançar para finalizar o processo de configuração dos JOBS.

...

SVCALDMEDG - Valida os itens que foram gerados na B2W.

05. Processamento

Tendo as despesas gravadas na tabela B2Y, rodamos o JOB SVCPRCDMED que gera a tabela de Movimentos (B2W) classificando os registros em TOP, RTOP, DTOP ou RDTOP através dos dados que foram enviados. Sabemos que para geração do arquivo ainda faltam os Identificadores RESPO, DECPJ e OPPAS, porém eles serão lançados diretamente no arquivo da DMED. Logo, eles não precisam ser processados.

06. Validação

As Movimentações estão disponíveis na tabela B2W com o Status Pendente validação. Neste caso rodamos o JOB SVCALDMEDG e estes registros são validados. Caso haja alguma inconsistência de acordo com o Layout da DMED esta movimentação ficará com status "Criticado."

Críticas de validações:

...


Os Jobs criados pelo wizard acima, ficam dispostos na tela Schedule do configurador. Eles são executados de acordo com a parametrização feita acima.

Image Added


Quando estamos posicionado em um compromisso da DMED, conseguimos visualizar a execução desses JOBS acessando a tela de Monitor de Jobs.

Image Added



05. Responsáveis - RESPO

        Na tela de Responsáveis, tenho cadastrado o responsável de diversas Operadoras (quando houver mais de uma) indicando se o cadastro está ou não ativo. 

        Na rotina de validação das críticas, é verificado se tenho um responsável para Operadora que estou validando, caso não tenha é apresentado a crítica DM14 - Deve existir um responsável ativo.

        Na geração do arquivo, o sistema identifica qual Operadora esta associada ao compromisso e insere as informações no arquivo DMED baseado nesse cadastro.


Image Added

06. Tela Despesas Analíticas


Esta tela permite a visualização, inclusão e alteração de despesas.

OBS: Só é possível a alteração e exclusão de registros inseridos de forma manual.

Visualização:

Lista registros da tabela B2Y, permitindo filtrar, carregar mais resultados e alterar ou excluir.


Image Added


Inclusão:

Insere um novo registro na tabela B2Y, que posteriormente será processado pelo JOB SVCPRCDMED.

Image Added


Alteração:

Altera um registro que foi incluído manualmente.

Image Added

Exclusão:

Exclui um registro que foi incluído manualmente.

Image Added

07. Tela Movimentos


Tendo as despesas gravadas (tabela B2Y), rodamos o JOB SVCPRCDMED que processa as Despesas e gera os Movimentos (tabela B2W) classificando os registros em TOP, RTOP, DTOP ou RDTOP. Sabemos que para geração do arquivo ainda faltam os Identificadores RESPO, DECPJ e OPPAS, porém eles serão lançados diretamente no arquivo da DMED. Logo, eles não precisam ser processados pelo Job. Essa tela tem como objetivo mostrar os itens que foram processados das Despesas Analíticas (B2Y) e geraram os Movimentos (B2W) .expenseAmount

Para acessar: Central de Obrigações/ DMED/ Movimentos. Na tela teremos os botões:

  • Visualizar: Abre a tela de visualização, no item em que está posicionado.
  • Pesquisar: Exibe um filtro de pesquisa que permite a especificação de um filtro.
  • Validar Itens: Valida os itens que foram processados verificando se estão de acordo com as regras.
  • Críticas: Abre a tela de Críticas para os itens de Movimentos.


Status da tela:

Amarelo=Pendente Validação

Azul=Pronto para o Envio

Vermelho=Criticado

Verde=Enviado Receita Federal


Image Added




08. Validação

As Movimentações estão disponíveis na tabela B2W com o Status Pendente validação. Ao executar o JOB SVCALDMEDG estes registros são validados. Caso haja alguma inconsistência de acordo com o Layout da DMED esta movimentação ficará com status "Criticado (vermelho)", caso não

encontre inconsistência status ficará como "Pronto para o Envio (Azul)". Antes de rodar a validação o status é amarelo "Pendente Validação"

Também é possível rodar o JOB de validação direto da tela de movimentações clicando no botão "Validar Itens".


Image Added



Críticas de validações:


CódigoCríticaSolução
DM01Nome do Beneficiário inválido.O campo é de preenchimento obrigatório
DM02Nome do Prestador inválido.O campo é de preenchimento obrigatório, e no máximo de 60 posições para o nome da pessoa física. Para PJ o tamanho é de no máximo 150 posições.
DM03Relação de Dependência é inválida.O campo é numérico de tamanho 2 e deve seguir conforme tabela de Relação de Dependência (03,04,05,06,08 e 10).
DM05O campo CPF do titular está inválido.O campo é de preenchimento obrigatório, deve ser preenchido com um CPF válido.
DM06O campo CPF/CNPJ do prestador inválido.O campo é de preenchimento obrigatório, deve ser preenchido com um CPF ou CNPJ válido.
DM07O campo CPF do dependente é inválido.O campo é de preenchimento obrigatório para declaração de dependentes do titular, deve ser preenchido com um CPF válido.
DM08O campo valor da despesa inválido.Quando o titular não possui beneficiários, o campo valor da despesa deve possuir valor maior que zero ( B2W_VLRDES > 0) .
DM09Esse registro RTOP deve estar associado a um registro do tipo TOP.Enviar para a Central de Obrigações o registro do tipo TOP.
DM10O Campo Data de Nascimento do Dependente inválido.O Campo Data de Nascimento é obrigatório para maiores de 18 anos que não tenham informado CPF. Campo de tamanho 8 e padrão AAAAMMDD'
DM12Esse registro DTOP deve estar associado a um registro do tipo TOP.Enviar para a Central de Obrigações o registro do tipo TOP.
DM13Esse registro RDTOP deve estar associado a um registro do tipo DTOP.Enviar para a Central de Obrigações o registro do tipo DTOP.
DM14Deve existir um responsável ativo.Realize o cadastro de um responsável para operadora.


09. Arquivo

A DMED gerada através da Central de obrigações, não trata "Prestadora de serviços médicos e de saúde". 

Sendo assim geramos o arquivo da seguinte maneira. Repare que não haverá PSS, RPPSS e BRPPSS pois são itens específicos do Prestador de Saúde.


DMED - Declaração de serviços médicos e de saúde

RESPO - Responsável pelo preenchimento

DECPJ - Declarante Pessoa Jurídica

OPPAS - Operadora de plano privado de assistência à saúde.

          TOP - Titular do plano

               RTOP - Reembolso titular do plano

               DTOP - Dependente do titular

               RDTOP - Reembolso do Dependente

FIMDMED     


Para gerarmos o arquivo acessamos o Painel de Obrigações > posicionamos no Compromisso desejado > Clicamos no botão Obrigações e Gerar arquivo de envio, onde teremos os parâmetros a serem preenchidos.


Parâmetros Geração DMED:

Ano referência: Ano de referência do arquivo.

Declaração Retificadora: 

N - Original → Arquivo primário a ser gerado.

S - Retificadora  → Significa que o arquivo anterior foi enviado com ano errado e será atualizado nessa geração.

Número do recibo: Número a ser preenchido somente quando for Retificadora para identificação do anterior.

CNES: Cadastro Nacional de Estabelecimento de Saúde.

CPF Responsável Perante o CNPJ: CPF Responsável.

Situação da Declaração: 

N - Não Especial → deve conter as informações relativas aos valores recebidos durante o ano-calendário (anterior).

S - Especial → Quando o declarante incorrer nas situações especiais de extinção pelo encerramento da liquidação, pela fusão, pela incorporação, ou cisão total, ocorridas no ano-calendário, deve apresentar DMED com informações relativas aos valores recebidos até a data do evento.

Data do evento: Só será preenchido quando a Situação da Declaração for Especial.

Identificador da estrutura do layout: Depende do ano de envio para a opção a ser selecionada.

Responsável: Ao clicar na lupa, o sistema apresenta o cadastro de Responsáveis filtrando por Operadora do compromisso e cadastro ativo.

Diretório do arquivo: Local onde o arquivo será salvo.


Image Added

07. Arquivo

A DMED gerada através da Central de obrigações, não trata "Prestadora de serviços médicos e de saúde". 

Sendo assim geramos o arquivo da seguinte maneira. Repare que não haverá PSS, RPPSS e BRPPSS pois são itens específicos do Prestador de Saúde.

DMED - Declaração de serviços médicos e de saúde

RESPO - Responsável pelo preenchimento

DECPJ - Declarante Pessoa Jurídica

OPPAS - Operadora de plano privado de assistência à saúde.

          TOP - Titular do plano

               RTOP - Reembolso titular do plano

               DTOP - Dependente do titular

               RDTOP - Reembolso do Dependente

FIMDMED     

Para gerarmos o arquivo acessamos o Painel de Obrigações > posicionamos no Compromisso desejado > Clicamos no botão Obrigações e Gerar arquivo de envio, onde teremos os parâmetros a serem preenchidos.

Parâmetros Geração DMED:

Ano referência: Ano de referência do arquivo.

Declaração Retificadora: 

N - Original → Arquivo primário a ser gerado.

S - Retificadora  → Significa que o arquivo anterior foi enviado com ano errado e será atualizado nessa geração.

Número do recibo: Número a ser preenchido somente quando for Retificadora para identificação do anterior.

CNES: Cadastro Nacional de Estabelecimento de Saúde.

CPF Responsável Perante o CNPJ: CPF Responsável.

Situação da Declaração: 

N - Não Especial → deve conter as informações relativas aos valores recebidos durante o ano-calendário (anterior).

S - Especial → Quando o declarante incorrer nas situações especiais de extinção pelo encerramento da liquidação, pela fusão, pela incorporação, ou cisão total, ocorridas no ano-calendário, deve apresentar DMED com informações relativas aos valores recebidos até a data do evento.

Data do evento: Só será preenchido quando a Situação da Declaração for Especial.

Identificador da estrutura do layout: Depende do ano de envio para a opção a ser selecionada.

Diretório do arquivo: Local onde o arquivo será salvo.

Image Removed

08. Tela Despesas Analíticas

Outras Ações / Ações relacionadas

...

09. Tela Movimentos

Essa tela tem como objetivo mostrar os itens que foram processados das Despesas Analíticas (B2Y) e geraram os Movimentos (B2W) .

Para acessar: Central de Obrigações/ DMED/ Movimentos. Na tela teremos os botões:

  • Visualizar: Abre a tela de visualização, no item em que está posicionado.
  • Pesquisar: Exibe um filtro de pesquisa que permite a especificação de um filtro.
  • Validar Itens: Valida os itens que foram processados verificando se estão de acordo com as regras.
  • Críticas: Abre a tela de Críticas para os itens de Movimentos.

Image Removed


10. Tela Histórico de Arquivos

...

        Este número do recibo pode ser alterado caso tenha necessidade. A partir do momento que o número do recibo for inserido, ao voltar à tela principal da Central, irá reparar que o compromisso foi finalizado.


        Botões:

        Incluir Recibo: Inclui e altera um número de recibo

...

        Excluir: Exclui o histórico, porém só permite a exclusão de registros que não foram para Receita Federal (Não tem recibo informado).


        

                

...



HTML
<!-- esconder o menu --> 


<style>
div.theme-default .ia-splitter #main {
    margin-left: 0px;
}
.ia-fixed-sidebar, .ia-splitter-left {
    display: none;
}
#main {
    padding-left: 10px;
    padding-right: 10px;
    overflow-x: hidden;
}

.aui-header-primary .aui-nav,  .aui-page-panel {
    margin-left: 0px !important;
}
.aui-header-primary .aui-nav {
    margin-left: 0px !important;
}
</style>

...