ArvoAgentHub

Quantidade acima do autorizado

Overview

Rule agent for checking authorization limits and quantities. This agent implements two main rules: - C040: Checks if procedures require authorization but none exists - C039: Checks if quantities exceed authorized amounts The agent can be configured to check authorization at the account level or individual item level.

Este agente é usado com os seguintes IDs:

  • C039: Quantidade acima do autorizado
  • C040: Item não autorizado

Architecture

Field Value
Name Quantidade acima do autorizado
Agent ID C039, C040
Version 1
Nature audit
Layer

Inheritance

AuthorizationLimits → BaseAgent → BaseAgent

Core Functionality

  1. load_artifacts
  2. prepare_data
  3. rule_assessment

Business Rules

Comportamento da cobrança

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

Usage

from agents.authorizationlimits import AuthorizationLimits

rule = AuthorizationLimits()
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 C039, C040
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.