Código TUSS inválido

Overview

Flags items whose TUSS code is either absent from the taxonomy or inactive.

Architecture

Field	Value
Name	Código TUSS inválido
Agent ID	T002
Version	0.0.0
Nature	tech
Layer	—

Inheritance

InvalidTussCodeRule → BaseAgent → BaseAgent

Core Functionality

1. load_artifacts
2. prepare_data
3. rule_assessment

Business Rules

Conformidade da cobrança

Constantes:

• MOTIVO_ANS = "1801 - PROCEDIMENTO INVÁLIDO"
• MOTIVO_ARVO_NOT_FOUND = "O código TUSS informado não consta na base de procedimentos válidos."

Usage

from agents.invalidtusscoderule import InvalidTussCodeRule

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

Configuration

rule = InvalidTussCodeRule(
    evaluated=True,
    evaluated=evaluated,
    artifact_loader=ArtifactLoader(self.logger),
    taxonomy=self.artifact_loader.load_taxonomy(code_type_list=["codigo_tuss"]),
    taxonomy=taxonomy[[EVENT_COLUMNS.id_evento,
    subset=[EVENT_COLUMNS.id_evento,
    taxonomy=self.taxonomy.rename(columns={EVENT_COLUMNS.id_evento: ARVO_COLUMNS.id_evento_predicted}),
    taxonomy=self.taxonomy.drop(columns=[ARVO_COLUMNS.code_type]),
)

Input Requirements

Consultar expected_input_columns no código-fonte.

Output Format

Glosa DataFrame Columns

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