ArvoAgentHub

Qtd excessiva de terapia sequencial

Overview

Regra técnica: "Qtd excessiva de terapia sequencial". Esta regra identifica, em contas ambulatoriais, sessões de terapias cuja quantidade mensal ultrapassa um limite parametrizado por artefatos. Além de sinalizar as sessões excedentes (glosa), pode realizar "arrasto" de itens relacionados (taxas/pacotes e materiais/medicamentos) quando indicado. Atributos principais

Architecture

Field Value
Name Qtd excessiva de terapia sequencial
Agent ID C030
Version 7
Nature tech
Layer

Inheritance

ExcessiveTherapiesRule → BaseRule → BaseAgent

Core Functionality

  1. artifacts_tolerance
  2. load_artifacts
  3. prepare_data
  4. rule_assessment

Business Rules

Comportamento indevido

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

Usage

from agents.excessivetherapiesrule import ExcessiveTherapiesRule

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

Configuration

Sem parâmetros configuráveis identificados.

Input Requirements

Consultar expected_input_columns no código-fonte.

Output Format

Glosa DataFrame Columns

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