Funcionalidade em fase de testes.

01. DADOS GERAIS

Produto:

TOTVS Saúde Planos

Linha de Produto:

Linha Protheus 

Segmento:

Saude 

Módulo:PTU
Função:CADBENEF ONLINE
Ticket:
Story:DSAUBE-22560


02. 
SITUAÇÃO/REQUISITO

Possibilitar que seja enviado a movimentação cadastral do beneficiário (Inclusão, Alteração e Exclusão) para o CadBenef.

Cadastro de Beneficiários On-line terá início em 15/04/2024, com obrigatoriedade em 12/08/2024, data em que o envio dos dados dos beneficiários à Unimed do Brasil através do PTU A1300 deixará de existir.

Nesse novo processo, o compartilhamento de risco através do PTU A100 também deixará de existir, tendo em vista já incorporado ao novo PTU de Integrações 8.0 por meio da mensagem de "Cadastro de Beneficiário", assim como o PTU A200, na mensagem "Retorno do Compartilhamento de Risco".

Vale lembrar que tais mudanças otimizarão o processo de cadastramento de beneficiários no intercâmbio, uma vez que os processos manuais serão extintos.

03. SOLUÇÃO

Implementada rotina do CadBenef Online (PLPTU001) no menu do Plano de Saúde (SIGAPLS), onde será possível enviar as movimentações cadastrais do beneficiário (Inclusão, alteração e exclusão) para o Cadastro Nacional de Beneficiários (CadBenef).

No processo serão utilizados os seguintes métodos (Rest Full): 

A API da Unimed Brasil só permite o envio de 1 beneficiário por requisição.

Compartilhamento de risco não implementado nessa primeira fase.

Atualização de Dicionário de Dados

Lote de Envio do CadBenef

Inclusão na tabela SX2 (Tabela):

TabelaBPW
ModoCompartilhado
Modo UnidadeExclusivo
Modo EmpresaExclusivo
Chave ÚnicaBPW_FILIAL+BPW_CODIGO
Nome 

CadBenef Online - Lote


Inclusão na tabela SX3 (Campos):

CampoOrdemTipoTamanhoDecimalTituloDescriçãoPictureValidaçãoUsadoObrigatórioInic. PadrãoExibe BrowserVisualContextoCboxConsulta PadrãoHelp
BPW_FILIAL01Caracter80FilialFilial do Sistema

NãoNão
NãoAlterarReal



Filial do sistema.

BPW_CODIGO02Caracter80Cod. LoteCódigo do Lote@!
SimSimgetSXENum("BPW", "BPW_CODIGO")SimVisualizarReal

Código identificador do lote.

BPW_DTEMIS03Data80Dt. EmissãoData de Emissão do Lote

SimSimdDataBaseSimVisualizarReal

Data em que o lote foi lançado no sistema.

BPW_STATUS04Caracter10StatusStatus do Lote@!

pertence("12345")

SimSim1SimVisualizarReal1=Recebido;2=Processando Envio;3=Falha de Envio;4=Finalizado com Sucesso;5=Finalizado Parcialmente
Indica o status em que o lote se encontra conforme a comunicação com o CadBenef.
BPW_UNIORI05Caracter40Unimed Orig.Cod. Unimed Orig. Envio@!
SimSimplsIntPad()SimVisualizarReal

Código da Unimed origem do envio do lote para o CadBenef.

BPW_TIPMOV06Caracter10Tipo de Mov.Tipo de Mov. do Envio@!pertence("1234")SimSim
SimAlterarReal1=Cadastro Ativo;2=Cadastro Completo;3=Mov. Periódica;4=Somente Exclusão

Indica de qual forma o sistema irá buscar os beneficiários no cadastro, sendo:


Cadastro Ativo: Beneficiários que tiveram inclusão no intervalo da data inicial e final informada no lote que estão sem data de bloqueio.

Cadastro Completo: Todos os beneficiários.

Mov. Periódica: Beneficiários que tiveram alterações/inclusões (BX1), via de cartão (BED), repasse, bloqueio e desbloqueio (BCA) no intervalo da data inicial e final informada no lote.

Somente Exclusão: Beneficiários que tiveram bloqueio no intervalo da data inicial e final informada no lote e que já foram enviados para o CadBenef.

BPW_DATINI07Data80Data InicialData de Início da Mov.

SimSim
NãoAlterarReal

Informe a data de Início que será utilizada para a busca dos beneficiários que irão compor este lote.

BPW_DATFIN08Data80Data FinalData Final da Mov.

SimSim
NãoAlterarReal

Informe a data fim que será utilizada para a busca dos beneficiários que irão compor este lote.

BPW_EMPINI09Caracter40Empresa Ini.Empresa Inicial do Filtro@!
Sim

NãoAlterarReal
B7APLS
BPW_EMPFIN10Caracter40Empresa Fin.Empresa Final do Filtro@!
Sim

NãoAlterarReal
B7APLS
BPW_CONINI11Caracter120Contra. Ini.Contr. Inicial do Fitro@!
Sim

NãoAlterarReal
B7BPLS
BPW_CONFIN12Caracter120Contra. Fin.Contr. Final do Filtro@!
Sim

NãoAlterarReal
B7BPLS
BPW_SUBINI13Caracter90Subcon. Ini.Subcont. Inicial Filtro@!
Sim

NãoAlterarReal
B7CPLS
BPW_SUBFIN14Caracter90Subcon. Fin.Subcont. Final Filtro@!
Sim

NãoAlterarReal
B7CPLS
BPW_ANS   15Caracter10Consid. ANS Considera ANS no Filtro@!pertence("01")Sim

NãoAlterarReal0=Não;1=Sim

BPW_SIB   16Caracter10Consid. SIBConsidera SIB no Filtro@!pertence("01")Sim

NãoAlterarReal0=Não;1=Sim


Inclusão na tabela SIX (Índices): 

OrdemChaveDescrição
1BPW_FILIAL + BPW_CODIGOFilial + Código do Lote


Beneficiários do Lote

Inclusão na tabela SX2 (Tabelas):

TabelaBPY
ModoCompartilhado
Modo UnidadeExclusivo
Modo EmpresaExclusivo
Chave ÚnicaBPY_FILIAL+BPY_CODLOT+BPY_MATBEN
Nome 

CadBenef Online - Beneficiário


Inclusão na tabela SX3 (Campos):

CampoOrdemTipoTamanhoDecimalTituloDescriçãoPictureValidaçãoUsadoInic. PadrãoExibe BrowserVisualContextoCboxInic. Browser
BPY_FILIAL01Caracter80FilialFilial do Sistema

Não
NãoAlterarReal



BPY_CODLOT02Caracter80Cod. LoteCodigo do Lote@!
Sim
NãoVisualizarReal

BPY_MATBEN03Caracter170Matric. Ben.Matricula do Beneficiário@!
Sim
SimVisualizarReal

BPY_NOMBEN04Caracter700Nome Benef.Nome do Beneficiário@!
Simiif(inclui, "", posicione("BA1", 2, xFilial("BA1") + BPY->BPY_MATBEN, "BA1_NOMUSR"))SimVisualizarVirtual
posicione("BA1", 2, xFilial("BA1") + BPY->BPY_MATBEN, "BA1_NOMUSR") 
BPY_STATUS05Caracter10StatusStatus do Envio@!pertence("123")Sim
SimVisualizarReal1=Pendente de Envio;2=Envio Finalizado;3=Erro de Envio
BPY_TIPMOV06Caracter10Tipo de Mov.Tipo de Envio@!pertence("123")Sim
SimVisualizarReal1=Inclusão;2=Atualização;3=Exclusão    
BPY_CODTRA07Caracter200Cd. Transac.Cod. Transação do PTU

Sim
SimVisualizarReal

BPY_DATENV08Data80Data EnvioData de Envio

Sim
SimVisualizarReal

BPY_HORENV09Caracter80Hora EnvioHora de Envio

Sim
SimVisualizarReal

BPY_MSGENV10Memo100Msg. EnvioMensagem de Envio

Sim
NãoVisualizarReal

BPY_MSGRES11Memo100Msg. Resp.Mensagem de Resposta

Sim
NãoVisualizarReal

BPY_RESULT12Caracter1500Resultado Resultado do Envio

Sim
NãoVisualizarReal

BPY_TIMERP13Caracter80Tempo Resp.Tempo de Resposta

Sim
NãoVisualizarReal


Inclusão na tabela SIX (Índices): 

OrdemChaveDescrição
1BPY_FILIAL + BPY_CODLOT + BPY_MATBENFilial + Código do Lote + Matricula do Beneficiário
2BPY_FILIAL + BPY_MATBENFilial + Matricula do Beneficiário


Cadastro da Operadora de Saúde

Inclusão na tabela SX3 (Campos):

CampoTipoTamanhoDecimalTituloDescriçãoPictureUsadoExibe BrowserVisualContextoFolder
BA0_UBURL Caracter2000URL Token

SimNãoAlterarReal6
BA0_UBCLIDCaracter1000ID Token

SimNãoAlterarReal6
BA0_UBCLSCCaracter1000Secret Token
@*                                           SimNãoAlterarReal6
BA0_UBACTKMemo100Access Token

SimNãoVisualizarReal6
BA0_UBEXINCaracter200Expira Token

SimNãoVisualizarReal6
BA0_CDBURLCaracter2000URL CadBenef

SimNãoAlterarReal6
BA0_CDBPFXCaracter1000PFX CadBenef

SimNãoAlterarReal6
BA0_CDBPASCaracter1000Pass CadBen.
@*                                           SimNãoAlterarReal6


Cadastro do Beneficiário

Inclusão na tabela SX3 (Campos):

CampoTipoTamanhoDecimalTituloDescriçãoPictureUsadoExibe BrowserVisualContexto
BA1_CODUBRCaracter170Código UBCod. Controle Uni. Brasil
SimNãoVisualizarReal


04. DEMAIS INFORMAÇÕES

Para mais informações de como utilizar essa funcionalidade, acesse a documentação de referência: CadBenef Online - Movimentação Cadastral de Beneficiarios - PLPTU001

05. ASSUNTOS RELACIONADOS

        Manual do PTU de Integrações 8.0