01. DADOS GERAIS

02. SITUAÇÃO/REQUISITO

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

• Pontos de entrada e parâmetros das autorizações e títulos da rotina antiga da posiçã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 - Posição do Beneficiário (PO UI)
      2. DT PE Adicionar Novos Campos no Cabeçalho da Autorização - Posição do Beneficiário (PO UI)
      3. DT PE Adicionar Novos Campos nos Eventos da Autorização - Posição do Beneficiário (PO UI)
   2. api titles: 
      1. DT PE Ordenar os Títulos da Posição Financeiro - Posição do Beneficiário (PO UI)
      2. DT PE Filtrar os Títulos na Posição Financeiro - Posiçã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
4. Dados do subcontrato do Beneficiário (Pessoa Juridica): 
   1. Ao realizar um GET da api de contracts é o beneficiário informado foi do tipo pessoa juridica, 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.
      
      
5. 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.
      
      
6. 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.
      
      
7. 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