Árvore de páginas

Versões comparadas

Chave

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

Funcionalidade em fase de testes.

01. DADOS GERAIS

Produto:

TOTVS Saúde Planos

Solucoes_totvs
Solucao

Solucoes_totvs_cross
SolucaoCross

Solucoes_totvs_parceiros
SolucaoParceiros

Solucoes_totvs_parceirosexptotvs
SolucaoParcsExpsTOTVS

Linha de Produto:

Linha Protheus 

Linhas_totvs

Segmento:

Saude 

Segmentos_totvs
Segmento

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

  • POST – Inclusão de Beneficiários.
  • PATCH – Atualização dos dados beneficiários.
  • DELETE – Exclusão do beneficiário.

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

Criado nova api para receber os compartilhamentos de risco em pós-pagamento ou custo operacional: /totvsHealthPlans/unimed/cadbenef-online/v1/beneficiarios/compartilhamento-riscos

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@!
SimNão
NãoAlterarReal
B7APLSInforme o código da empresa de início do range que será utilizado para a busca dos beneficiários que irão compor este lote.
BPW_EMPFIN10Caracter40Empresa Fin.Empresa Final do Filtro@!
SimNão
NãoAlterarReal
B7APLS

Informe o código da empresa final do range que será utilizado para a busca dos beneficiários que irão compor este lote.

BPW_CONINI11Caracter120Contra. Ini.Contr. Inicial do Fitro@!
SimNão
NãoAlterarReal
B7BPLS

Informe o código do contrato de início que será utilizado neste range na busca dos beneficiários.

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

Informe o código final do contrato que será utilizado neste range na busca dos beneficiários.

BPW_SUBINI13Caracter90Subcon. Ini.Subcont. Inicial Filtro@!
SimNão
NãoAlterarReal
B7CPLS

Informe o código do subcontrato de início que será utilizado neste range na busca dos beneficiários.

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

Informe o código final do subcontrato que será utilizado neste range na busca dos beneficiários.

BPW_ANS   15Caracter10Consid. ANS Considera ANS no Filtro@!pertence("01")SimNão
NãoAlterarReal0=Não;1=Sim

Informe se será considerado ANS na busca dos beneficiários.

BPW_SIB   16Caracter10Consid. SIBConsidera SIB no Filtro@!pertence("01")SimNão
NãoAlterarReal0=Não;1=Sim

Informe se será considerado SIB na busca dos beneficiários.


Inclusão na tabela SIX (Índices): 

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


Inclusão na tabela SX9 (Relacionamento):

Tabela DomínioExp. DomínioTabela Contra-DomínioExp. Contra-DomínioTp. Lig. Dom.Tip. Lig. CDom.
BG9BG9_CODIGOBPWBPW_EMPFIN1N
BG9BG9_CODIGOBPWBPW_EMPINI1N
BQCBQC_SUBCONBPWBPW_SUBINI1N
BQCBQC_SUBCONBPWBPW_SUBFIN1N
BT5BT5_NUMCONBPWBPW_CONINI1N
BT5BT5_NUMCONBPWBPW_CONFIN1N


Beneficiários do Lote

Inclusão na tabela SX2 (Tabelas):

TabelaBPY
ModoCompartilhado
Modo UnidadeExclusivo
Modo EmpresaExclusivo
Chave ÚnicaBPY_FILIAL+BPY_CODLOT+BPY_CODINT+BPY_CODEMP+BPY_MATRIC+BPY_TIPREG+BPY_DIGITO
Nome 

CadBenef Online - Beneficiário


Inclusão na tabela SX3 (Campos):

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

Não
NãoAlterarReal



Filial do sistema.

BPY_CODLOT02Caracter80Cod. LoteCodigo do Lote@!
Sim
NãoVisualizarReal

Código identificador do Lote do beneficiário.

BPY_CODINT03Caracter40OperadoraCódigo da Operadora@!                                       
Sim
SimVisualizarReal

Código da operadora que compõe a matrícula do beneficiário pertencente neste lote.
BPY_CODEMP04Caracter40Cod. EmpresaCódigo da Empresa@!
Sim
SimVisualizarReal

Código da empresa que compõe a matrícula do beneficiário pertencente neste lote.
BPY_MATRIC05Caracter60MatrículaMatrícula da Família@!
Sim
SimVisualizarReal

Matrícula da família que compõe a matrícula do beneficiário pertencente neste lote.
BPY_TIPREG06Caracter20Tp. RegistroTipo Reg. Beneficiário @!
Sim
SimVisualizarReal

Tipo do registro do beneficiário que compõe a matrícula do beneficiário pertencente neste lote.
BPY_DIGITO07Caracter10DígitoDígito Verificador9
Sim
SimVisualizarReal

Digito que compõe a matrícula do beneficiário pertencente neste lote.
BPY_NOMBEN08Caracter700Nome Benef.Nome do Beneficiário@!
Simiif(inclui,"",posicione("BA1", 2, xFilial("BA1")+BPY->(BPY_CODINT+BPY_CODEMP+BPY_MATRIC+BPY_TIPREG+BPY_DIGITO),"BA1_NOMUSR"))SimVisualizarVirtual
totvs.protheus.health.plan.unimed.cadBenefGetBenefNameBrowser()                         

Nome do beneficiário pertencente neste lote.

BPY_STATUS09Caracter10StatusStatus do Envio@!pertence("123")Sim1SimVisualizarReal1=Pendente de Envio;2=Envio Finalizado;3=Erro de Envio
Status em que se encontra o envio do beneficiário para o CadBenef.
BPY_TIPMOV10Caracter10Tipo de Mov.Tipo de Envio@!pertence("123")Sim
SimVisualizarReal1=Inclusão;2=Atualização;3=Exclusão    

Indica o tipo da movimentação do beneficiário para envio ao CadBenef.

BPY_CODTRA11Caracter200Cd. Transac.Cod. Transação do PTU

Sim
SimVisualizarReal

Código de Transação do PTU.

BPY_DATENV12Data80Data EnvioData de Envio

Sim
SimVisualizarReal

Data em que foi realizado a ultima comunicação do envio do beneficiário para o CadBenef.

BPY_HORENV13Caracter80Hora EnvioHora de Envio

Sim
SimVisualizarReal

Hora em que foi realizado a ultima comunicação do envio do beneficiário para o CadBenef.

BPY_MSGENV14Memo100Msg. EnvioMensagem de Envio

Sim
NãoVisualizarReal

Request body (json) com os dados do beneficiário enviado para o CadBenef.

BPY_MSGRES15Memo100Msg. Resp.Mensagem de Resposta

Sim
NãoVisualizarReal

Response (json) de retorno da comunicação com o CadBenef.

BPY_RESULT16Caracter1500Resultado Resultado do Envio

Sim
NãoVisualizarReal

Mensagem com o resultado da comunicação com o CadBenef.

BPY_TIMERP17Caracter80Tempo Resp.Tempo de Resposta

Sim
NãoVisualizarReal

Tempo total de resposta da comunicação com o CadBenef.


Inclusão na tabela SIX (Índices): 

OrdemChaveDescrição
1BPY_FILIAL + BPY_CODLOT + BPY_CODINT + BPY_CODEMP + BPY_MATRIC + BPY_TIPREG + BPY_DIGITOFilial + Código do Lote + Operadora + Empresa + Matrícula+ Tipo Registro + Digito
2BPY_FILIAL + BPY_CODINT + BPY_CODEMP + BPY_MATRIC + BPY_TIPREG + BPY_DIGITOFilial +  Operadora + Empresa + Matrícula+ Tipo Registro + Digito


Inclusão na tabela SX9 (Relacionamento):

Tabela DomínioExp. DomínioTabela Contra-DomínioExp. Contra-DomínioTp. Lig. Dom.Tip. Lig. CDom.
BA1BA1_CODINT+BA1_CODEMP+BA1_MATRIC+BA1_TIPREG+BA1_DIGITOBPYBPY_CODINT + BPY_CODEMP + BPY_MATRIC + BPY_TIPREG + BPY_DIGITO1N

Cadastro da Operadora de Saúde

Inclusão na tabela SX3 (Campos):

CampoTipoTamanhoDecimalTituloDescriçãoPictureUsadoExibe BrowserVisualContextoFolderHelp
BA0_UBURL Caracter2000URL TokenEndpoint Autenticação 
SimNãoAlterarReal6

Endpoint de homologação/produção disponibilizado pela Unimed Brasil para autenticação.

BA0_UBCLIDCaracter1000ID TokenClient ID do Token
SimNãoAlterarReal6

Client ID solicitado previamente para Unimed Brasil.

BA0_UBCLSCCaracter1000Secret TokenSecret ID do Token

@*                                           

SimNãoAlterarReal6Secret ID solicitado previamente para Unimed Brasil.
BA0_UBACTKMemo100Access TokenBearer do Access Token
SimNãoVisualizarReal6

Bearer obtido pela api de Token para ser utilizado nas Integrações do PTU.

BA0_UBEXINCaracter200Expira TokenTempo de Expiração Token
SimNãoVisualizarReal6

Tempo em que o access token irá expirar. Campo para controle interno do sistema.

BA0_CDBURLCaracter2000URL CadBenefEndpoint do CadBenef  
SimNãoAlterarReal6Endpoint de homologação/produção do CadBenef-Online
BA0_CDBPFXCaracter1000PFX CadBenefCertificado do CadBenef 
SimNãoAlterarReal6O nome do certificado com extensão.
BA0_CDBPASCaracter1000Pass CadBen.Senha do Certificado     @*                                           SimNãoAlterarReal6Senha que será utilizada para a abertura da chave privada. Para uma chave privada que não possua senha, deve ser informada uma string vazia.
BA0_URLVTKCaracter2000URL Vd. Tok.URL Validação do Token
SimNãoAlterarReal6Endpoint de homologação/produção para validar o token no GIU para autorização das apis de integração com a Unimed Brasil.


Cadastro do Beneficiário

Inclusão na tabela SX3 (Campos):

CampoTipoTamanhoDecimalTituloDescriçãoPictureUsadoExibe BrowserFolderVisualContextoHelp
BA1_CODUBRCaracter170Código UBCod. Controle Uni. Brasil
SimNão
VisualizarReal

Código de Controle gerado pela Unimed do Brasil.

BA1_AEMAILCaracter700Email Alter.Email Alternativo
SimNão1AlterarReal

Informe um email alternativo para o beneficiário.


Beneficiários Pós Pagamento/Habitual

Inclusão na tabela SX3 (Campos):

CampoOrdemTipoTamanhoDecimalTituloDescriçãoPictureValidaçãoUsadoExibe BrowserVisualContextoHelp
B5F_CODTRA24Caracter200Cd. Transac.Cod. Transação do PTU

SimNãoVisualizarReal

Código de Transação do PTU.

Alteração na tabela SX3 (Campos):

CampoUsado
B5F_TPCONTSim

Produto Saúde

Inclusão na tabela SX3 (Campos):

CampoOrdemTipoTamanhoDecimalTituloDescriçãoPictureValidaçãoObrigatórioUsadoExibe BrowserVisualContextocBoxHelp
BI3_INDPLAA7Caracter10Indic. PlanoIndicação de Plano
pertence("1234 ")NãoSimNãoAlterarReal

1=Plano LowCost;2=Plano de Acidente de Trabalho;3=Plano de Saúde Ocupacional;4=Plano APS

Informe qual é a indicação do plano, sendo: Plano LowCost, Plano de Acidente de Trabalho, Plano de Saúde Ocupacional e Plano APS.

Parâmetros

Inclusão no arquivo SX6 (Parâmetros): 

VarTipoDescriçãoConteúdo (default)
MV_PLCBREPL - LógicoHabilita o recebimento (via api) do compartilhamento de risco em pré-pagamento ou repasse dos beneficiários de outra Unimed..F.

MV_PLCBEMP

C - CaracterDados da empresa do tipo pessoa juridica, aonde os beneficiários serão cadastrados no compartilhamento de risco em pré-pagamento.
Nota
titleParâmetro MV_PLCBEMP

O conteúdo do parâmetro deve ser a seguinte estrutura: codigoEmpresa-numeroContrato-versaoContrato-subcontrato-versaoSubcontrato-produto-versaoProduto

Exemplo: 1008-000000000001-001-000000003-001-0001-001

  • Código da empresa: 1008
  • Contrato: 000000000001
  • Versão do Contrato: 001
  • Subcontrato: 000000003
  • Versão do Subcontrato: 001
  • Produto: 0001
  • Versão do Produto: 001


Card documentos
InformacaoAs alterações de dicionário referente a essa implementação estarão disponíveis através de pacote de expedição contínua do plano de saúde com data igual ou superior "sem data".
TituloImportante

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



Templatedocumentos