Árvore de páginas


01. DADOS GERAIS

Produto:

TOTVS Saúde Planos

Linha de Produto:

Linha Protheus 

Segmento:

Saude 

Módulo:GESTÃO DE CONTRATOS / FAMÍLIAS
Função:ANÁLISE DE BENEFICIÁRIOS - API PLINCBENMODEL
Ticket:22120289
Story:DSAUBE-26320


02. 
SITUAÇÃO/REQUISITO

Foi identificada a necessidade de incluir o campo Data de Inclusão (B2N_DATINC) na API de inclusão de beneficiários (PLINCBENMODEL ou PLINCAUTOBENMODEL). O sistema deve permitir o cadastro de beneficiários com datas de inclusão anteriores ou futuras, desde que respeite as seguintes regras:

  • Não permitir a inclusão de dependentes com data de inclusão anterior à data de inclusão do titular ou da família já existente.
  • Permitir que seja enviada uma data de inclusão diferente da data atual, podendo ser uma data no passado ou no futuro.

03. SOLUÇÃO

Foi ajustada a API para incluir o campo Data de Inclusão (B2N_DATINC) no cadastro de beneficiários. A implementação segue as regras de validação:

  • Bloqueio de inclusão de dependentes com data anterior à data de inclusão do titular ou da família existente.
  • Aceitação de datas de inclusão anteriores ou futuras, conforme o envio na requisição.

Com essas alterações, o processo de inclusão de beneficiários agora possui maior flexibilidade.

Atualização do Dicionário de Dados

Incluído o novo campo na tabela B2N com as seguintes especificações:

CampoTipoTamanhoDecimalTituloDescriçãoUsadoVisualContextoHelp
B2N_DATINCData80Dt. InclusãoDt. Inclusão BeneficiárioSimAlterarRealIndica a data de inclusão do beneficiário no contrato do grupo familiar.


Importante

As alterações no dicionário de dados, referentes a essa implementação, estarão disponíveis por meio do pacote de expedição contínua do plano de saúde.

04. DEMAIS INFORMAÇÕES

Para utilizar o novo processo de inclusão com o campo Data de Inclusão, é necessário enviar no JSON:

{
	"id":"B2N_DATINC",
    "value":"20250110" // data de inclusão no formato aaaammdd
}

Para mais informações, acesse a documentação:

API PLIncAutoBenModel - Protocolo de Inclusão de Beneficiários Aprovado Automaticamente

API PLIncBenModel - Protocolo de Inclusão de Beneficiários

05. ASSUNTOS RELACIONADOS

Não se aplica