Histórico da Página

ÍNDICE

01. VISÃO GERAL

...

Implementação da extração das informações para geração da DMED
Para atender as necessidades de nossas Operadoras de Saúde a rotina irá gerar as despesas médicas para o módulo Central de Obrigações.
Essa extração se dará através

...

02. CONFIGURAÇÕES DE PARAMENTOS.

a) Configurar o Endpoint PtWebAEvent.

Com o WebService Protheus configurado, disponibilizar o endereço e porta para Unimed do Brasil para que a mesma acesse o EndPoint e envia os arquivos XML.

Exemplo: http://meuwebservice.com.br:1234/PTWebAEvent.APW

Caso a Unimed destino não disponibilize o Endpoint, há a opção importação manual, onde a Unimed destino baixa o arquivo XML, disponibilizado pela Unimed do Brasil, essa opção se encontra dentro da rotina Importação do PTU A100 (PLSP100IMP), na chamada "Importar Manual".

b) Verificar se existe a estrutura de pasta no servidor ("\plsptu\A100\").

c) Configurar o paramento MV_PLWBSCH, nele definimos o modelo de schema que será usado pela rotina, o seu valor default ptu_A100_Pos_UB.xsd, esse deverá estar dentro da estrutura "\plsptu\a100\schemas".

d) Configurar o paramento MV_PLTPARQ , nele definimos o layout a ser utilizado default (A100).

e) Configurar o paramento MV_PLDRARQ, nele definimos o caminho aonde será salvo os arquivos vindo do webservice default ("\plsptu\A100\entradas\")

f) Configurar o paramento MV_PLWBPRC, nele definimos aonde será salvo os arquivos processado ao finalizar a rotina de Importação do PTU A100 (PLSP100IMP) default ("\plsptu\A100\processados\").

03. EXEMPLO DE UTILIZAÇÃO

Recebendo arquivo XML via webservice.

Ao receber o arquivo via webservice da Unimed do Brasil, é retornado para a mesma o arquivo xml de confirmação, conforme o layout A105.

Image Removed

Atenção

Possíveis casos aonde os arquivos não são processados :

Arquivo XML em desacordo com o schema.

Enpoint não disponibilizado.

Arquivo já importado ou com o mesmo hash.

A Tag ptuA100_Pos_UB foi disponibilizada no schema os links xmlns="http://www.w3.org/2001/XMLSchema" xmlns:ptu="http://ptu.unimed.coop.br/schemas/V1_0" targetNamespace="http://ptu.unimed.coop.br/schemas/V1_0" elementFormDefault="qualified">, caso esteja incompleto apresentará a mensagem de: Erro: namespace error

.

...

de API´S disponibilizada pelo módulo de Central de Obrigações, conforme o link abaixo.
https://api.totvs.com.br/apidetails/AnalyticDmedExpenses_v1_100.json

02. EXEMPLO DE UTILIZAÇÃO

Totvs custom tabs box

tabs	Passo 01, Passo 02, Passo 03, Passo 04
ids	passo1,passo2,passo3

Totvs custom tabs box items

default	yes
referencia	passo1

Configuração do Schedule Protheus.

Para que rotina seja executada de uma forma automática, precisamos configurar o schedule no módulo Configurador, nesse contém a rotina que analisará as movimentações que serão enviadas para a DMED no módulo Central de Obrigações.

O schedule permite que rotinas do sistema sejam agendadas para que possam ser executadas posteriormente, em um período determinado pelo usuário.

Esse mecanismo tem por objetivo encontrar movimentações de cobrança e reembolso que serão processadas.

Exemplo da rotina de Extração de informação da DMED para a Central de Obrigações.

Image Added

Mais informação sobre Schedule Protheus.

Schedule Protheus

Totvs custom tabs box items

default	yes
referencia	passo2

A estrutura do JSON.

Para melhor entendimento da estrutura do arquivo JSON, o mesmo estará divido por identificador de registro que são:

TOP = Titular

RTOP = Reembolso do Titular

DTOP = Dependente do Titular

RDTOP = Reembolso do Dependente do Titular

Identificador de Registro TOP e DTOP.

A partir das baixas dos títulos gerado pelo Lote de Cobrança (SE1), em conjunto com a composição de Cobrança (BM1), a integração se dará com as movimentações de meses anteriores, essa tratativa se dará devido que os beneficiários já efetuaram o pagamento de suas despesas, e para isso classificaremos a estrutura do JSON como TOP = Titular e DTOP = Dependente do Titular.

Image Added

Estrutura do TOP = Titular

{
    "healthInsurerCode":"0000001",
    "ssnHolder":"13926361751",
    "titleHolderEnrollment":"00010001000011005",
    "holderName":"OLIVER BENICIO PIRES",
    "expenseKey":"0000000000000000000000000000000000000001",
    "expenseAmount":1000,
    "period":"202011",
    "exclusionId":"0"
}

Estrutura do DTOP = Dependente do Titular

{

    "healthInsurerCode":"000001",
    "ssnHolder":"76116313221",
    "titleHolderEnrollment":"00010001000011005",
    "holderName":"OLIVER BENICIO PIRES",
    "dependentSsn":"14754460553",
    "dependentEnrollment":"00010001000011038",
    "dependentName":"MARIANA ISABELLA PEIXOTO PIRES",
    "dependentBirthDate":"20091013",
    "dependenceRelationships":"03",
    "expenseKey":"0000000000000000000000000000000000000003",
    "expenseAmount":1000,
    "period":"202010",
    "exclusionId":"0"
}

Identificador de Registro RTOP e RDTOP.

A partir dos reembolsos aprovados (B44 e B45), a integração se dará com as movimentações de meses anteriores, devidos aos beneficiários efetuar o pagamento de suas despesas, nessa tratativa chamamos de RTOP = Reembolso do Titular e RDTOP= Reembolso do Dependente do Titular.

Para uma melhora de performance não precisaremos verificar o título gerado no módulo financeiro (SE2), devido que já foi aprovado o reembolso, campo B44_PREFIX e B44_NUM e B45 para posicionamento de beneficiário.

Image Added

Identificador de Registro - RTOP

{

"healthInsurerCode":"417505",
"ssnHolder":"76116313221",
"titleHolderEnrollment":"00010001000011005",
"holderName":"OLIVER BENICIO PIRES",
"expenseKey":"0000000000000000000000000000000000000002",
"refundAmount":2000,
"previousYearRefundAmt":2000,
"period":"202010",
"providerSsnEin":"39613205861",
"providerName":"NOME PRESTADOR",
"exclusionId":"0"

}

Totvs custom tabs box items

default	yes
referencia	passo3

Image Removed

Importação dos beneficiário a partir dos arquivos XML.

Para que seja importado as informações para o sistema PROTEUS e preciso utilizar a rotina de importação de arquivo PTU A100 (PLSP100IMP).

No browse constará os registros das movimentações dos arquivos processados e prontos para serem importados para o sistema.

Para efetuar a importação dos arquivos o usuário deverá selecionar o arquivo que deseja, com a legenda verde e clicar em importar.

Image Removed

Tela de seleção dos beneficiários para importação.Nesse momento são selecionados os beneficiários que serão importados para empresa de escolha do usuário.

Image Removed

Após a confirmação é efetuado a importação e a popular as tabelas pertinente a rotina de Grupo Familiar.

E nesse momento também e feito a copia do arquivo XML da pasta entradas para a pasta de processados definido pelo parâmetro MV_PLWBPRC e a mudança de legenda no browse de verde para vermelho que significa que o item já foi importado.

Image Removed

04. PARÂMETROS

Criação de Parâmetro no arquivo SX6 – Parâmetros:

...

Nome da Variável

...

MV_PLWBSCH

...

Tipo

...

Caractere

...

Descrição

...

Determina o modelo de schema que será usado pela rotina PTU A100

...

Valor Padrão

...

ptu_A100_Pos_UB.xsd

...

Nome da Variável

...

MV_PLTPARQ

...

Tipo

...

Caractere

...

Descrição

...

Determina o layout a ser utilizado pela rotina de importação PTU A100

...

Valor Padrão

...

A100

...

Nome da Variável

...

MV_PLDRARQ

...

Tipo

...

Caractere

...

Descrição

...

Determina o caminho aonde será salvo os arquivos vindo do webservice.

...

Valor Padrão

...

\plsptu\A100\entradas\

...

Nome da Variável

...

MV_PLWBPRC

...

Tipo

...

Caractere

...

Descrição

Determina aonde será salvo os arquivos processado pela rotina de importação.

...

Valor Padrão

...

\plsptu\A100\processados\

05. TABELAS UTILIZADAS

Campos novos

...

BX0 - Reg. de Entradas Ptu A100 XML

...

Reg. de Entradas Ptu A100 XML

...

Árvore de páginas

Versões comparadas

Versão antiga 2

Nova versão Atual

Chave

ÍNDICE

01. VISÃO GERAL

02. CONFIGURAÇÕES DE PARAMENTOS.

03. EXEMPLO DE UTILIZAÇÃO

02. EXEMPLO DE UTILIZAÇÃO

Configuração do Schedule Protheus.

Mais informação sobre Schedule Protheus.

A estrutura do JSON.

04. PARÂMETROS

05. TABELAS UTILIZADAS

Campos novos

BX0 - Reg. de Entradas Ptu A100 XML