Workflow de Autorização Médica - Amil

Este documento descreve o processo completo de autorização médica automatizada para a Amil Saúde. O workflow foi desenvolvido para integrar com os sistemas legados e modernos da operadora, garantindo conformidade com as regulamentações da ANS e otimizando o tempo de resposta.

Visão Geral do Processo

O sistema processa automaticamente solicitações de autorização médica através de múltiplos canais:

• Portal médico online (Web e Mobile)
• API REST para sistemas de terceiros
• Integração EDI para operadoras parceiras
• Upload de documentos via interface administrativa

Fluxo de Validação

1. 1
   Recepção da Solicitação: Sistema valida formato e integridade dos dados
2. 2
   Verificação de Elegibilidade: Consulta status do beneficiário e cobertura
3. 3
   Análise Automatizada: Engine de regras avalia critérios médicos
4. 4
   Decisão e Notificação: Resposta automática ou encaminhamento para auditoria

Configuração da API

A integração com a API da Amil requer configuração específica de autenticação OAuth 2.0:

{
  "amil": {
    "baseUrl": "https://api.amil.com.br/v2",
    "authentication": {
      "type": "oauth2",
      "clientId": "${AMIL_CLIENT_ID}",
      "clientSecret": "${AMIL_CLIENT_SECRET}",
      "scope": "authorization.read authorization.write"
    },
    "endpoints": {
      "authorize": "/auth/authorize",
      "token": "/auth/token",
      "eligibility": "/beneficiary/eligibility",
      "authorization": "/medical/authorization"
    },
    "timeout": 30000,
    "retryAttempts": 3
  }
}

public async Task<AuthorizationResult> ProcessAuthorizationAsync(
                                AuthorizationRequest request)
{
                                // Validação inicial
                                if (!ValidateRequest(request))
    {
                                return new AuthorizationResult
        {
            Status = AuthStatus.InvalidRequest,
            Message = "Dados da solicitação inválidos"
        };
    }

                                // Verificação de elegibilidade
                                var eligibility = await _amilService
        .CheckEligibilityAsync(request.BeneficiaryId);

                                if (!eligibility.IsEligible)
    {
                                return new AuthorizationResult
        {
            Status = AuthStatus.NotEligible,
            Message = eligibility.Reason
        };
    }

                                // Processamento da autorização
                                return await _authorizationEngine
        .ProcessAsync(request, eligibility);
}

Códigos de Status da API

Parâmetros de Configuração

Para configurar o timeout da API, utilize o parâmetro connectionTimeout no arquivo de configuração. O valor padrão é 30000ms. Para ambientes de produção, recomenda-se usar maxRetryAttempts: 3.

Monitoramento e Logs

O sistema gera logs detalhados para auditoria e troubleshooting. Todos os eventos são armazenados com timestamp UTC e incluem informações de rastreabilidade.