Bank Statement Import Skill

Esta skill descreve o processo de ingestão e normalização de transações financeiras a partir de arquivos bancários.

Objetivo

Automatizar a entrada de dados financeiros e reconciliar com os lançamentos manuais/planejados.

Inputs

• •Arquivos de Extrato: .ofx, .csv, .pdf
• •Lista de Transações Planejadas (Budget Items)

Outputs

• •Lista Normalizada de Transações (FinancialTransaction[])
• •Relatório de Divergências (Conciliação)

Regras de Processamento

1. Normalização

• •Data: Converter para ISO 8601 (YYYY-MM-DD).
• •Valor: Converter para Decimal/Centavos (positivo = crédito, negativo = débito).
• •Descrição: Remover prefixos bancários comuns ("PIX ENVIADO", "INT TED").
• •ID Único: Gerar hash da transação (data + valor + descrição) para evitar duplicidade.

2. Matching (Conciliação)

• •Exato: Data idêntica E Valor idêntico.
• •Aproximado: Data +/- 2 dias E Valor idêntico.
• •Tarifas: Identificar automaticamente tarifas bancárias não previstas (devem ser estornadas ou categorizadas como despesa administrativa).

Definition of Done (DoD)

• • 100% das transações do extrato importadas.
• • Duplicatas identificadas e descartadas.
• • Conciliação automática realizada com >90% de sucesso.
• • Tarifas identificadas.

Anti-patterns

• •❌ Importar transações pendentes/agendadas.
• •❌ Ignorar diferenças de centavos (reconciliação deve ser exata).
• •❌ Criar lançamentos duplicados ao reimportar o mesmo arquivo.