DT Gestão do Beneficiário em PO UI - Melhorias no Back-End

01. DADOS GERAIS

02. SITUAÇÃO/REQUISITO

Necessidade de realizar as seguintes melhorias no back-end das APIs da Gestão do Beneficiário em PO UI:

• Pontos de entrada e parâmetros das autorizações e títulos da rotina antiga da gestão do beneficiário.
• Status code das APIs.
• Ajustar a API de cobrança para retornar os dados a faturar e já faturado em uma só requisição, não sendo necessário o query param billingType.
• Adicionar nome social nas APIs de contracts e familyBeneficiaries.
• Adicionar os dados do subcontrato na API de contracts quando for pessoa juridica.
• Adicionar atributo dias em atraso na api de titles.
• Ajustado o conceito dos demais títulos na api de titles.

03. SOLUÇÃO

Realizado as seguintes implementações nas APIs:

1. Ponto de Entrada:
   1. api authorizations: 
      1. DT PE Filtrar as Autorizações do Beneficiário - Gestão do Beneficiário (PO UI)
      2. DT PE Adicionar Novos Campos no Cabeçalho da Autorização - Gestão do Beneficiário (PO UI)
      3. DT PE Adicionar Novos Campos nos Eventos da Autorização - Gestão do Beneficiário (PO UI)
   2. api titles: 
      1. DT PE Ordenar os Títulos da Posição Financeiro - Gestão do Beneficiário (PO UI)
      2. DT PE Filtrar os Títulos na Posição Financeiro - Gestão do Beneficiário (PO UI)
         
         
2. Status Code das APIs: Ajustado os status code das mensagens de erros, sendo: 400 (Bad Request: Erro de regra de négocio) e 404 (Not Found: Erro de registro não encontrado).
   1. api autorizations
   2. api billing
   3. api contract
   4. api cid
   5. api coverage
   6. api elegibleProcedures
   7. api gracePeriod
   8. api search
   9. api titles
      
      
3. Nome Social do Beneficiário: Adicionado novo atributos do nome social nas APIs:
   1. api contract
   2. api familyBeneficiaries
   3. api search

1. Dados do subcontrato do Beneficiário (Pessoa Jurídica): 
   1. Ao realizar um GET da api de contracts é o beneficiário informado foi do tipo pessoa jurídica, o sistema irá retornar os seguintes campos no items do json: ba3_codemp, ba3_desemp, ba3_conemp, ba3_vercon, ba3_subcon, ba3_versub, ba3_dessub.
      
      
2. Parâmetros:
   1. Adicionado o MV_PLCPSE1 na api de titles, para que seja informado quais os campos que deveram ser adicionado além do padrão.
      
      
3. API titles
   
   1. Adicionado o atributo latedays (dias em atraso).
   2. Criado query param allTitles para informar se será retornados os Demais Títulos do beneficiário (Títulos que não são de origem PLS).
   3. Removido o status D (Demais Títulos), essa consulta será feita pelo query param allTitles.
      
      
4. API billing
   1. Removido o query param billingType.
   2. Alterado a estrutura do json de retorno, agora o sistema irá retornar os dados à faturar (billsToBill) e os dados já faturados (billsAlreadyBilled) em um json.

04. DEMAIS INFORMAÇÕES

• API beneficiaryPosition - Endpoint: Dados de Contrato do Beneficiário
• API beneficiaryPosition - Endpoint: Doenças Preexistentes do Beneficiário (CID)
• API beneficiaryPosition - Endpoint: Pesquisa de Beneficiários
• API beneficiaryPosition - Endpoint: Títulos de Cobrança do Beneficiário (Posição Financeira)
• API beneficiaryPosition - Endpoint: Elegibilidade de Procedimentos (Carência/Cobertura)
• API beneficiaryPosition - Endpoint: Valor de Cobrança
• API beneficiaryPosition - Endpoint: Carências do Beneficiário
• API beneficiaryPosition - Endpoint: Coberturas do Beneficiário
• API beneficiaryPosition - Endpoint: Autorizações do Beneficiário

05. ASSUNTOS RELACIONADOS

        Não se aplica.