Pular para conteúdo

Schema: Dívida

ID: divida Área Johnny.Decimal: 10-19 Jurídico → 14 Cobranças


Frontmatter Template

---
jd_id: "14.XX.DYY"
jd_area: "Jurídico"
jd_categoria: "Cobranças"
tipo: "divida"
titulo: ""
data_criacao: "YYYY-MM-DD"
data_modificacao: "YYYY-MM-DD"
tags: [juridico, cobranca, divida]
status: "em_cobranca"

# Referências
devedor_id: "14.XX"
devedor_nome: ""
devedor_cpf_cnpj: ""
credor_nome: ""
credor_cnpj: ""

# Identificação da Dívida (CHAVE DE DEDUPLICAÇÃO)
referencia_unica: ""  # número contrato/boleto/processo
tipo_divida: ""  # boleto | contrato | emprestimo | cartao | servico | judicial

# Valores
valor_original: 0
valor_atualizado: 0
valor_multa: 0
valor_juros: 0
valor_honorarios: 0
valor_custas: 0
valor_total: 0
moeda: "BRL"

# Datas
data_vencimento_original: ""
data_vencimento_mais_antigo: ""
data_vencimento_mais_recente: ""
data_atualizacao_calculo: ""

# Boletos/Parcelas (lista)
debitos: []
# Formato: { numero: "", valor: 0, vencimento: "", status: "" }

# Status
status_cobranca: "pendente"  # pendente | em_negociacao | acordo | judicial | quitado | prescrito
cobranca_autorizada: true
whatsapp_enviado: false
whatsapp_respondido: false
prometeu_pagamento: false
data_promessa: ""

# Processo Judicial (se houver)
tem_processo: false
numero_processo: ""
vara: ""
fase_processual: ""
data_distribuicao: ""
advogado: ""

# PostgreSQL
pg_id: ""  # UUID da tabela dividas
pg_sync: "YYYY-MM-DD HH:MM:SS"

# Documento Fonte
documento_original: ""  # path no MinIO
documento_hash: ""  # SHA256 para deduplicação
metodo_extracao: "dual"  # texto | imagem | dual
confianca_extracao: 0  # 0-100%
---

Regras de Deduplicação

Chave Única Composta

HASH(devedor_cpf_cnpj + credor_cnpj + referencia_unica)

Fluxo de Decisão

  1. Calcular hash da chave única
  2. Buscar no PostgreSQL por devedor_id + credor_id + referencia
  3. Se encontrar:
  4. Comparar valores
  5. Se diferente → UPDATE + log
  6. Se igual → skip (documento já processado)
  7. Se não encontrar → INSERT

Campos que NÃO podem mudar (identificação)

  • devedor_cpf_cnpj
  • credor_cnpj
  • referencia_unica

Campos que PODEM atualizar

  • valores (atualização monetária)
  • status
  • datas
  • dados do processo

Estrutura do Documento

# Dívida: [Devedor] vs [Credor]

**Referência:** [número]
**Status:** [status]

## Resumo

| Campo | Valor |
|-------|-------|
| Devedor | [[14.XX Nome]] |
| CPF/CNPJ | |
| Credor | |
| Valor Original | R$ |
| Valor Atualizado | R$ |
| Vencimento | |

## Composição do Débito

| # | Referência | Valor | Vencimento | Status |
|---|------------|-------|------------|--------|
| 1 | | | | |

## Cálculo Atualizado

- **Principal:** R$ X
- **Multa (2%):** R$ X
- **Juros (1% a.m.):** R$ X
- **Honorários (10%):** R$ X
- **Total:** R$ X

*Cálculo atualizado em: YYYY-MM-DD*

## Processo Judicial

*(se aplicável)*

| Campo | Valor |
|-------|-------|
| Número | |
| Vara | |
| Fase | |
| Advogado | |

## Histórico de Cobrança

| Data | Ação | Resultado |
|------|------|-----------|
| | | |

## Documentos

- [[link MinIO - documento original]]
- [[link MinIO - análise visual]]

## Extração de Dados

**Método:** Dual (Texto + Imagem)
**Confiança:** XX%

### Dados extraídos do texto
[resumo do que foi extraído]
### Dados extraídos das imagens
[resumo do que foi extraído das tabelas]
### Divergências resolvidas
*(se houver diferenças entre métodos)*

## Log de Alterações

| Data | Campo | Anterior | Novo | Fonte |
|------|-------|----------|------|-------|
| | | | | |


Validações

  • Valor > 0
  • Data vencimento válida
  • Referência não vazia
  • Credor identificado

Schema criado em 2026-02-01