Reembolso disfarçado - Atividade Suspeita

Overview

Documentação base para a regra "Reembolso disfarçado - Atividade Suspeita".

Architecture

Field	Value
Name	Reembolso disfarçado - Atividade Suspeita
Agent ID	R006
Version	1
Nature	audit
Layer	—

Inheritance

ProviderSuspiciousActivityRule → BaseRule → BaseAgent

Core Functionality

1. load_artifacts
2. prepare_data
3. rule_razao_social
4. rule_blocklist
5. rule_assessment

Business Rules

Comportamento indevido

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

Usage

from agents.providersuspiciousactivityrule import ProviderSuspiciousActivityRule

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

Configuration

rule = ProviderSuspiciousActivityRule(
    blocklist_cnae=None,
    show_cnae_motivo=True,
    logger=logger,
)

Input Requirements

Consultar expected_input_columns no código-fonte.

Output Format

Glosa DataFrame Columns

Column	Description
agent_id	R006
version	1
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.