Validação de Indicação Clínica (CID)

Overview

Flags claims whose CID-10 code is either absent or not found in the reference table.

Architecture

Field	Value
Name	Validação de Indicação Clínica (CID)
Agent ID	T008
Version	0.0.0
Nature	adm
Layer	—

Inheritance

InvalidCidCodeRule → BaseAgent → BaseAgent

Core Functionality

1. load_artifacts
2. prepare_data
3. rule_assessment

Business Rules

Validação de informações

Constantes:

• MOTIVO_ANS = "1509 - CÓDIGO CID INVÁLIDO"
• MOTIVO_AUSENTE = "CID não informado"
• MOTIVO_INVALIDO = "CID inválido ou não encontrado na tabela de referência"

Usage

from agents.invalidcidcoderule import InvalidCidCodeRule

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

Configuration

rule = InvalidCidCodeRule(
    evaluated=True,
    _cid_raw_table=kwargs.get("cid_raw_table"),
    _cid_column=kwargs.get("cid_column"),
    _valid_cids=set(),
    evaluated=evaluated,
    artifact_loader=ArtifactLoader(self.logger),
)

Input Requirements

Consultar expected_input_columns no código-fonte.

Output Format

Glosa DataFrame Columns

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