Beta
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 , 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):
| Tabela | BPW |
| Modo | Compartilhado |
| Modo Unidade | Exclusivo |
| Modo Empresa | Exclusivo |
| Chave Única | BPW_FILIAL+BPW_CODIGO |
| Nome | CadBenef Online - Lote |
Inclusão na tabela SX3 (Campos):
| Campo | Ordem | Tipo | Tamanho | Decimal | Titulo | Descrição | Picture | Validação | Usado | Obrigatório | Inic. Padrão | Exibe Browser | Visual | Contexto | Cbox | Consulta Padrão | Help |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| BPW_FILIAL | 01 | Caracter | 8 | 0 | Filial | Filial do Sistema | Não | Não | Não | Alterar | Real | Filial do sistema. | |||||
| BPW_CODIGO | 02 | Caracter | 8 | 0 | Cod. Lote | Código do Lote | @! | Sim | Sim | getSXENum("BPW", "BPW_CODIGO") | Sim | Visualizar | Real | Código identificador do lote. | |||
| BPW_DTEMIS | 03 | Data | 8 | 0 | Dt. Emissão | Data de Emissão do Lote | Sim | Sim | dDataBase | Sim | Visualizar | Real | Data em que o lote foi lançado no sistema. | ||||
| BPW_STATUS | 04 | Caracter | 1 | 0 | Status | Status do Lote | @! | pertence("12345") | Sim | Sim | 1 | Sim | Visualizar | Real | 1=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_UNIORI | 05 | Caracter | 4 | 0 | Unimed Orig. | Cod. Unimed Orig. Envio | @! | Sim | Sim | plsIntPad() | Sim | Visualizar | Real | Código da Unimed origem do envio do lote para o CadBenef. | |||
| BPW_TIPMOV | 06 | Caracter | 1 | 0 | Tipo de Mov. | Tipo de Mov. do Envio | @! | pertence("1234") | Sim | Sim | Sim | Alterar | Real | 1=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_DATINI | 07 | Data | 8 | 0 | Data Inicial | Data de Início da Mov. | Sim | Sim | Não | Alterar | Real | Informe a data de Início que será utilizada para a busca dos beneficiários que irão compor este lote. | |||||
| BPW_DATFIN | 08 | Data | 8 | 0 | Data Final | Data Final da Mov. | Sim | Sim | Não | Alterar | Real | Informe a data fim que será utilizada para a busca dos beneficiários que irão compor este lote. | |||||
| BPW_EMPINI | 09 | Caracter | 4 | 0 | Empresa Ini. | Empresa Inicial do Filtro | @! | Sim | Não | Não | Alterar | Real | B7APLS | Informe 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_EMPFIN | 10 | Caracter | 4 | 0 | Empresa Fin. | Empresa Final do Filtro | @! | Sim | Não | Não | Alterar | Real | 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_CONINI | 11 | Caracter | 12 | 0 | Contra. Ini. | Contr. Inicial do Fitro | @! | Sim | Não | Não | Alterar | Real | B7BPLS | Informe o código do contrato de início que será utilizado neste range na busca dos beneficiários. | |||
| BPW_CONFIN | 12 | Caracter | 12 | 0 | Contra. Fin. | Contr. Final do Filtro | @! | Sim | Não | Não | Alterar | Real | B7BPLS | Informe o código final do contrato que será utilizado neste range na busca dos beneficiários. | |||
| BPW_SUBINI | 13 | Caracter | 9 | 0 | Subcon. Ini. | Subcont. Inicial Filtro | @! | Sim | Não | Não | Alterar | Real | B7CPLS | Informe o código do subcontrato de início que será utilizado neste range na busca dos beneficiários. | |||
| BPW_SUBFIN | 14 | Caracter | 9 | 0 | Subcon. Fin. | Subcont. Final Filtro | @! | Sim | Não | Não | Alterar | Real | B7CPLS | Informe o código final do subcontrato que será utilizado neste range na busca dos beneficiários. | |||
| BPW_ANS | 15 | Caracter | 1 | 0 | Consid. ANS | Considera ANS no Filtro | @! | pertence("01") | Sim | Não | Não | Alterar | Real | 0=Não;1=Sim | Informe se será considerado ANS na busca dos beneficiários. | ||
| BPW_SIB | 16 | Caracter | 1 | 0 | Consid. SIB | Considera SIB no Filtro | @! | pertence("01") | Sim | Não | Não | Alterar | Real | 0=Não;1=Sim | Informe se será considerado SIB na busca dos beneficiários. |
Inclusão na tabela SIX (Índices):
| Ordem | Chave | Descrição |
|---|---|---|
| 1 | BPW_FILIAL + BPW_CODIGO | Filial + Código do Lote |
Inclusão na tabela SX9 (Relacionamento):
| Tabela Domínio | Exp. Domínio | Tabela Contra-Domínio | Exp. Contra-Domínio | Tp. Lig. Dom. | Tip. Lig. CDom. |
|---|---|---|---|---|---|
| BG9 | BG9_CODIGO | BPW | BPW_EMPFIN | 1 | N |
| BG9 | BG9_CODIGO | BPW | BPW_EMPINI | 1 | N |
| BQC | BQC_SUBCON | BPW | BPW_SUBINI | 1 | N |
| BQC | BQC_SUBCON | BPW | BPW_SUBFIN | 1 | N |
| BT5 | BT5_NUMCON | BPW | BPW_CONINI | 1 | N |
| BT5 | BT5_NUMCON | BPW | BPW_CONFIN | 1 | N |
Beneficiários do Lote
Inclusão na tabela SX2 (Tabelas):
| Tabela | BPY |
| Modo | Compartilhado |
| Modo Unidade | Exclusivo |
| Modo Empresa | Exclusivo |
| Chave Única | BPY_FILIAL+BPY_CODLOT+BPY_CODINT+BPY_CODEMP+BPY_MATRIC+BPY_TIPREG+BPY_DIGITO |
| Nome | CadBenef Online - Beneficiário |
Inclusão na tabela SX3 (Campos):
| Campo | Ordem | Tipo | Tamanho | Decimal | Titulo | Descrição | Picture | Validação | Usado | Inic. Padrão | Exibe Browser | Visual | Contexto | Cbox | Inic. Browser | Help |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| BPY_FILIAL | 01 | Caracter | 8 | 0 | Filial | Filial do Sistema | Não | Não | Alterar | Real | Filial do sistema. | |||||
| BPY_CODLOT | 02 | Caracter | 8 | 0 | Cod. Lote | Codigo do Lote | @! | Sim | Não | Visualizar | Real | Código identificador do Lote do beneficiário. | ||||
| BPY_CODINT | 03 | Caracter | 4 | 0 | Operadora | Código da Operadora | @! | Sim | Sim | Visualizar | Real | Código da operadora que compõe a matrícula do beneficiário pertencente neste lote. | ||||
| BPY_CODEMP | 04 | Caracter | 4 | 0 | Cod. Empresa | Código da Empresa | @! | Sim | Sim | Visualizar | Real | Código da empresa que compõe a matrícula do beneficiário pertencente neste lote. | ||||
| BPY_MATRIC | 05 | Caracter | 6 | 0 | Matrícula | Matrícula da Família | @! | Sim | Sim | Visualizar | Real | Matrícula da família que compõe a matrícula do beneficiário pertencente neste lote. | ||||
| BPY_TIPREG | 06 | Caracter | 2 | 0 | Tp. Registro | Tipo Reg. Beneficiário | @! | Sim | Sim | Visualizar | Real | Tipo do registro do beneficiário que compõe a matrícula do beneficiário pertencente neste lote. | ||||
| BPY_DIGITO | 07 | Caracter | 1 | 0 | Dígito | Dígito Verificador | 9 | Sim | Sim | Visualizar | Real | Digito que compõe a matrícula do beneficiário pertencente neste lote. | ||||
| BPY_NOMBEN | 08 | Caracter | 70 | 0 | Nome Benef. | Nome do Beneficiário | @! | Sim | iif(inclui,"",posicione("BA1", 2, xFilial("BA1")+BPY->(BPY_CODINT+BPY_CODEMP+BPY_MATRIC+BPY_TIPREG+BPY_DIGITO),"BA1_NOMUSR")) | Sim | Visualizar | Virtual | totvs.protheus.health.plan.unimed.cadBenefGetBenefNameBrowser() | Nome do beneficiário pertencente neste lote. | ||
| BPY_STATUS | 09 | Caracter | 1 | 0 | Status | Status do Envio | @! | pertence("123") | Sim | 1 | Sim | Visualizar | Real | 1=Pendente de Envio;2=Envio Finalizado;3=Erro de Envio | Status em que se encontra o envio do beneficiário para o CadBenef. | |
| BPY_TIPMOV | 10 | Caracter | 1 | 0 | Tipo de Mov. | Tipo de Envio | @! | pertence("123") | Sim | Sim | Visualizar | Real | 1=Inclusão;2=Atualização;3=Exclusão | Indica o tipo da movimentação do beneficiário para envio ao CadBenef. | ||
| BPY_CODTRA | 11 | Caracter | 20 | 0 | Cd. Transac. | Cod. Transação do PTU | Sim | Sim | Visualizar | Real | Código de Transação do PTU. | |||||
| BPY_DATENV | 12 | Data | 8 | 0 | Data Envio | Data de Envio | Sim | Sim | Visualizar | Real | Data em que foi realizado a ultima comunicação do envio do beneficiário para o CadBenef. | |||||
| BPY_HORENV | 13 | Caracter | 8 | 0 | Hora Envio | Hora de Envio | Sim | Sim | Visualizar | Real | Hora em que foi realizado a ultima comunicação do envio do beneficiário para o CadBenef. | |||||
| BPY_MSGENV | 14 | Memo | 10 | 0 | Msg. Envio | Mensagem de Envio | Sim | Não | Visualizar | Real | Request body (json) com os dados do beneficiário enviado para o CadBenef. | |||||
| BPY_MSGRES | 15 | Memo | 10 | 0 | Msg. Resp. | Mensagem de Resposta | Sim | Não | Visualizar | Real | Response (json) de retorno da comunicação com o CadBenef. | |||||
| BPY_RESULT | 16 | Caracter | 150 | 0 | Resultado | Resultado do Envio | Sim | Não | Visualizar | Real | Mensagem com o resultado da comunicação com o CadBenef. | |||||
| BPY_TIMERP | 17 | Caracter | 8 | 0 | Tempo Resp. | Tempo de Resposta | Sim | Não | Visualizar | Real | Tempo total de resposta da comunicação com o CadBenef. |
Inclusão na tabela SIX (Índices):
| Ordem | Chave | Descrição |
|---|---|---|
| 1 | BPY_FILIAL + BPY_CODLOT + BPY_CODINT + BPY_CODEMP + BPY_MATRIC + BPY_TIPREG + BPY_DIGITO | Filial + Código do Lote + Operadora + Empresa + Matrícula+ Tipo Registro + Digito |
| 2 | BPY_FILIAL + BPY_CODINT + BPY_CODEMP + BPY_MATRIC + BPY_TIPREG + BPY_DIGITO | Filial + Operadora + Empresa + Matrícula+ Tipo Registro + Digito |
Inclusão na tabela SX9 (Relacionamento):
| Tabela Domínio | Exp. Domínio | Tabela Contra-Domínio | Exp. Contra-Domínio | Tp. Lig. Dom. | Tip. Lig. CDom. |
|---|---|---|---|---|---|
| BA1 | BA1_CODINT+BA1_CODEMP+BA1_MATRIC+BA1_TIPREG+BA1_DIGITO | BPY | BPY_CODINT + BPY_CODEMP + BPY_MATRIC + BPY_TIPREG + BPY_DIGITO | 1 | N |
Cadastro da Operadora de Saúde
Inclusão na tabela SX3 (Campos):
| Campo | Tipo | Tamanho | Decimal | Titulo | Descrição | Picture | Usado | Exibe Browser | Visual | Contexto | Folder | Help |
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| BA0_UBURL | Caracter | 200 | 0 | URL Token | Endpoint Autenticação | Sim | Não | Alterar | Real | 6 | Endpoint de homologação/produção disponibilizado pela Unimed Brasil para autenticação. | |
| BA0_UBCLID | Caracter | 100 | 0 | ID Token | Client ID do Token | Sim | Não | Alterar | Real | 6 | Client ID solicitado previamente para Unimed Brasil. | |
| BA0_UBCLSC | Caracter | 100 | 0 | Secret Token | Secret ID do Token | @* | Sim | Não | Alterar | Real | 6 | Secret ID solicitado previamente para Unimed Brasil. |
| BA0_UBACTK | Memo | 10 | 0 | Access Token | Bearer do Access Token | Sim | Não | Visualizar | Real | 6 | Bearer obtido pela api de Token para ser utilizado nas Integrações do PTU. | |
| BA0_UBEXIN | Caracter | 20 | 0 | Expira Token | Tempo de Expiração Token | Sim | Não | Visualizar | Real | 6 | Tempo em que o access token irá expirar. Campo para controle interno do sistema. | |
| BA0_CDBURL | Caracter | 200 | 0 | URL CadBenef | Endpoint do CadBenef | Sim | Não | Alterar | Real | 6 | Endpoint de homologação/produção do CadBenef-Online | |
| BA0_CDBPFX | Caracter | 100 | 0 | PFX CadBenef | Certificado do CadBenef | Sim | Não | Alterar | Real | 6 | O nome do certificado com extensão. | |
| BA0_CDBPAS | Caracter | 100 | 0 | Pass CadBen. | Senha do Certificado | @* | Sim | Não | Alterar | Real | 6 | Senha 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_URLVTK | Caracter | 200 | 0 | URL Vd. Tok. | URL Validação do Token | Sim | Não | Alterar | Real | 6 | Endpoint 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):
| Campo | Tipo | Tamanho | Decimal | Titulo | Descrição | Picture | Usado | Exibe Browser | Folder | Visual | Contexto | Help |
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| BA1_CODUBR | Caracter | 17 | 0 | Código UB | Cod. Controle Uni. Brasil | Sim | Não | Visualizar | Real | Código de Controle gerado pela Unimed do Brasil. | ||
| BA1_AEMAIL | Caracter | 70 | 0 | Email Alter. | Email Alternativo | Sim | Não | 1 | Alterar | Real | Informe um email alternativo para o beneficiário. | |
| BA1_FINREP | Date | 8 | 0 | Fin. Repasse | Data final do Repasse | Sim | Não | 3 | Alterar | Real | Data final do compartilhamento de risco (repasse) do beneficiário. |
Beneficiários Pós Pagamento/Habitual
Inclusão na tabela SX3 (Campos):
| Campo | Ordem | Tipo | Tamanho | Decimal | Titulo | Descrição | Picture | Validação | Usado | Exibe Browser | Visual | Contexto | Help |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| B5F_CODTRA | 24 | Caracter | 20 | 0 | Cd. Transac. | Cod. Transação do PTU | Sim | Não | Visualizar | Real | Código de Transação do PTU. |
Alteração na tabela SX3 (Campos):
| Campo | Usado |
|---|---|
| B5F_TPCONT | Sim |
Produto Saúde
Inclusão na tabela SX3 (Campos):
| Campo | Ordem | Tipo | Tamanho | Decimal | Titulo | Descrição | Picture | Validação | Obrigatório | Usado | Exibe Browser | Visual | Contexto | cBox | Help |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| BI3_INDPLA | A7 | Caracter | 1 | 0 | Indic. Plano | Indicação de Plano | pertence("1234 ") | Não | Sim | Não | Alterar | Real | 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):
| Var | Tipo | Descrição | Conteúdo (default) |
|---|---|---|---|
| MV_PLCBREP | L - Lógico | Habilita o recebimento (via api) do compartilhamento de risco em pré-pagamento ou repasse dos beneficiários de outra Unimed. | .F. |
MV_PLCBEMP | C - Caracter | Dados da empresa do tipo pessoa juridica, aonde os beneficiários serão cadastrados no compartilhamento de risco em pré-pagamento. |
Parâ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
As 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".
Importante
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
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas