ArvoAgentHub

Reembolso disfarçado - Consulta psiquiatrica

Overview

This class aims at identifying instances where there are over N psychiatric appointments per month for a given beneficiary with a particular healthcare provider.

Architecture

Field Value
Name Reembolso disfarçado - Consulta psiquiatrica
Agent ID R019
Version 1.0
Nature audit
Layer

Inheritance

HiddenPsyquiatristRule → BaseRule → BaseAgent

Core Functionality

  1. load_artifacts
  2. prepare_data
  3. rule_assessment

Business Rules

Comportamento indevido

Consultar código-fonte para regras de negócio detalhadas.

Usage

from agents.hiddenpsyquiatristrule import HiddenPsyquiatristRule

rule = HiddenPsyquiatristRule()
violations_df = rule.rule_assessment(claims_df)

Configuration

rule = HiddenPsyquiatristRule(
    psychiatrist_indicator={"cbo": "medico psiquiatra"},
    threshold_appointments=3,
    timeframe=30,
    logger=logger,
)

Input Requirements

Consultar expected_input_columns no código-fonte.

Output Format

Glosa DataFrame Columns

Column Description
agent_id R019
version 1.0
id_arvo Original record ID
vl_glosa_arvo Glosa value
qt_glosa_arvo Glosa quantity
score_arvo Confidence score
motivo_glosa_arvo Detailed reason in Portuguese
motivo_glosa_ANS ANS standard code
data_dict JSON metadata with calculation details

Error Handling

  • DataFrames vazios retornam estrutura vazia com colunas obrigatórias.
  • Colunas ausentes geram warning mas não causam crash.
  • Conversões numéricas usam errors="coerce" para evitar falhas.