ArvoAgentHub

Materiais não custo/efetivos

Overview

Agent to deny payment of two material types: disposable and ineffective. It is associated two agent IDs: - C050 for disposable materials - C053 for ineffective materials Both cases are considered as Material Pertinence. List of materials to be considered is stored in the artifact ARTIFACTS.ineffective_materials.

Este agente é usado com os seguintes IDs:

  • C050: Pertinência de materiais
  • C053: Pertinência de materiais

Architecture

Field Value
Name Materiais não custo/efetivos
Agent ID C050, C053
Version 1
Nature adm
Layer

Inheritance

CostIneffectiveMatRule → BaseRule → BaseAgent

Core Functionality

  1. load_artifacts
  2. prepare_data
  3. rule_assessment

Business Rules

Custo-efetividade

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

Usage

from agents.costineffectivematrule import CostIneffectiveMatRule

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

Configuration

Sem parâmetros configuráveis identificados.

Input Requirements

Column Type Description
ARVO_COLUMNS.code_type - -
EVENT_COLUMNS.id_evento - -
EVENT_COLUMNS.evento - -
EVENT_COLUMNS.vl_pago - -
EVENT_COLUMNS.id_fatura - -
EVENT_COLUMNS.id - -
EVENT_COLUMNS.qt_paga - -
EVENT_COLUMNS.categoria - -
ARVO_COLUMNS.code_type_predicted - -
ARVO_COLUMNS.id_evento_predicted - -

Output Format

Glosa DataFrame Columns

Column Description
agent_id C050, C053
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.