DSAUBE-13628 DT JOB DE INTEGRAÇÃO DO PLS COM CENTRAL DE OBRIGAÇÃOES (DMED)

01. DADOS GERAIS

02. VISÃO GERAL

Para atender as necessidades de nossas Operadoras de Saúde. foi disponibilizado no módulo Plano de Saúde (PLS),  a extração das informações das despesas medicas (DMED),  para módulo Central de Obrigações.

03. PROCEDIMENTOS DE IMPLEMENTAÇÃO

a) Configurar um ambiente que tenha REST, conforme link e exemplo abaixo.

https://tdn.totvs.com/display/framework/02.+REST+com+ERP+Microsiga+Protheus

b) Configurar a rotina de Schedule conforme link e exemplo abaixo abaixo.

Schedule - Como agendar a execução de rotinas

c) Configurar o parâmetro MV_PLURDEM que determina o endereço da API.

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

https://api.totvs.com.br/apidetails/AnalyticDmedExpenses_v1_100.json

Estrutura Json do TOP (Titular)

{  

    "healthInsurerCode":"417505",

    "ssnHolder":"76116313221",

    "titleHolderEnrollment":"00010001000011005",

    "holderName":"PAULO SILVA TITULAR",

    "expenseKey":"0000000000000000000000000000000000000001",

    "expenseAmount":1000,

    "period":"202010",

    "exclusionId":"0"

}

Estrutura Json do DTOP (Dependente do Titular)

{  

    "healthInsurerCode":"417505",

    "ssnHolder":"76116313221",

    "titleHolderEnrollment":"00010001000011005",

    "holderName":"PAULO SILVA TITULAR",

    "dependentSsn":"14754460553",

    "dependentEnrollment":"00010001000011108",

    "dependentName":"DEPENDENTE TITULAR",

    "dependentBirthDate":"20091013",

    "dependenceRelationships":"03",

    "expenseKey":"0000000000000000000000000000000000000003",

    "expenseAmount":1000,

    "period":"202010",

    "exclusionId":"0"

}

Estrutura Json do RTOP (Reembolso do Titular)

{   

    "healthInsurerCode":"417505",

    "ssnHolder":"76116313221",

    "titleHolderEnrollment":"00010001000011005",

    "holderName":"PAULO SILVA TITULAR",

    "expenseKey":"0000000000000000000000000000000000000002",

    "refundAmount":2000,

    "previousYearRefundAmt":2000,

    "period":"202010",

    "providerSsnEin":"39613205861",

    "providerName":"NOME PRESTADOR",

    "exclusionId":"0"

}

Estrutura Json RDTOP (Reembolso do Dependente do Titular)

{  

    "healthInsurerCode":"417505",

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

}

04. PROCEDIMENTOS EXECUÇÃODA ROTINA

a)  No módulo Plano de Saúde, 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 com base no database do sistema , isso é necessário devidos aos beneficiários já terem efetuado pagamentos de suas despesas, nessa tratativa chamamos de TOP = Titular e DTOP = Dependente do Titular.

Com acionamento do Job (PlJobExtDmed)  a rotina analisará as movimentações a partir das baixas dos títulos efetuada pela rotina FINA070 - Baixas a Receber (SE1), em conjunto com a composição de cobrança (BM1) que contem o campo BM1_FLDMED, esse campo determina se a informação foi enviada para o módulo Central de Obrigações, caso seja enviado esse campo será preenchido com o caractere "S" que significa que o registro foi enviado. 

b)  No módulo Plano de Saúde, a partir dos reembolsos (B44 e B45), a integração se dará com as movimentações de reembolso já aprovados, nessa tratativa chamamos de RTOP = Reembolso do Titular e  RDTOP= Reembolso do Dependente do Titular.

Com acionamento do Job (PlJobExtDmed)  a rotina analisará os movimentos a partir a  dos reembolsos aprovados (B44 e B45) que contem o campo B44_FLDMED, esse campo determina se a informação foi enviada para o módulo Central de Obrigações, caso seja enviado esse campo será preenchido com o caractere "S" que significa que o registro foi enviado. 

c)  A rotina disponibiliza logs para que seja analisado se o sistema esta efetuando corretamente o envio das informações para o módulo central de Obrigações, essas informações são encontrado na pasta LOGPLS dentro do Protheus_data com o nome de job_extdmed.

Dentro log terá a informação dos itens que foram enviado e os que tiveram problemas, ocorrendo problemas no envio, e não for preenchido o campo BM1_FLDMED ou B44_FLDMED com "S", a rotina efetuará o reenvio novamente, caso esses campos estiver preenchido e não foi enviado, é preciso que os campo BM1_FLDMED ou B44_FLDMED estejam com seu valor em branco.

05. PARÂMETROS

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