rastreando-odoo

Rastreando Odoo

Rastreia fluxo completo de documentos e executa auditorias financeiras.

Fluxos Suportados

Workflow

1. Normalizar entrada → Transforma texto humano em ID Odoo
2. Detectar tipo → Identifica se e compra, venda ou devolucao
3. Rastrear fluxo → Navega pelos relacionamentos
4. Retornar JSON → Estrutura completa com todos os documentos

Scripts

normalizar.py

Transforma mencoes humanas em identificadores Odoo.

source .venv/bin/activate

# Por nome de parceiro
python .claude/skills/rastreando-odoo/scripts/normalizar.py "Atacadao" --json

# Por CNPJ
python .claude/skills/rastreando-odoo/scripts/normalizar.py "18467441" --json

# Por numero de NF
python .claude/skills/rastreando-odoo/scripts/normalizar.py "NF 12345" --json

# Por PO (formatos: PO00123, C2513147)
python .claude/skills/rastreando-odoo/scripts/normalizar.py "PO00789" --json

# Por SO (prefixos: VCD, VFB, VSC)
python .claude/skills/rastreando-odoo/scripts/normalizar.py "VCD123" --json

# Apenas detectar tipo (sem buscar)
python .claude/skills/rastreando-odoo/scripts/normalizar.py "VCD123" --detectar

rastrear.py

Rastreia fluxo completo a partir de qualquer entrada.

source .venv/bin/activate

# Por chave NF-e
python .claude/skills/rastreando-odoo/scripts/rastrear.py "35251218467441..." --json

# Por numero de NF
python .claude/skills/rastreando-odoo/scripts/rastrear.py "NF 12345" --json

# Por PO ou SO
python .claude/skills/rastreando-odoo/scripts/rastrear.py "PO00789" --json
python .claude/skills/rastreando-odoo/scripts/rastrear.py "VCD123" --json

# Por parceiro
python .claude/skills/rastreando-odoo/scripts/rastrear.py "Atacadao" --json

# Forcar tipo de fluxo
python .claude/skills/rastreando-odoo/scripts/rastrear.py "12345" --fluxo compra --json

auditoria_faturas_compra.py

Extrai auditoria completa de faturas de compra com titulos, pagamentos e conciliacoes.

source .venv/bin/activate

# Auditoria de mes especifico
python .claude/skills/rastreando-odoo/scripts/auditoria_faturas_compra.py --mes 11 --ano 2025

# Todo o periodo disponivel
python .claude/skills/rastreando-odoo/scripts/auditoria_faturas_compra.py --all

# Exportar para JSON
python .claude/skills/rastreando-odoo/scripts/auditoria_faturas_compra.py --mes 11 --ano 2025 --json

# Exportar formato tabular (para Excel via skill exportando-arquivos)
python .claude/skills/rastreando-odoo/scripts/auditoria_faturas_compra.py --mes 11 --ano 2025 --excel

Dados extraidos: fatura, fornecedor, CNPJ, parcelas, vencimentos, pagamentos, conciliacao bancaria, notas de credito/estornos.

auditoria_extrato_bancario.py

Extrai auditoria de extrato bancario com status de conciliacao.

source .venv/bin/activate

# Extrato de periodo
python .claude/skills/rastreando-odoo/scripts/auditoria_extrato_bancario.py --inicio 2024-07-01 --fim 2025-12-31

# Exportar para JSON
python .claude/skills/rastreando-odoo/scripts/auditoria_extrato_bancario.py --inicio 2024-07-01 --fim 2025-12-31 --json

# Exportar formato tabular (para Excel)
python .claude/skills/rastreando-odoo/scripts/auditoria_extrato_bancario.py --inicio 2024-07-01 --fim 2025-12-31 --excel

Dados extraidos: data, referencia, valor, parceiro, conta bancaria, status conciliacao.

mapeamento_vinculos_completo.py

Extrai 5 visoes cruzadas para identificar registros "soltos" (sem vinculo):

source .venv/bin/activate

# Mapeamento de pagamentos (extratos < 0)
python .claude/skills/rastreando-odoo/scripts/mapeamento_vinculos_completo.py --inicio 2024-07-01 --fim 2025-12-31 --pagamentos

# Exportar JSON completo
python .claude/skills/rastreando-odoo/scripts/mapeamento_vinculos_completo.py --inicio 2024-07-01 --fim 2025-12-31 --json

# Exportar formato tabular (para Excel)
python .claude/skills/rastreando-odoo/scripts/mapeamento_vinculos_completo.py --inicio 2024-07-01 --fim 2025-12-31 --excel

Visoes extraidas:

• EXTRATOS: titulo_ids, fatura_ids, nc_ids, payment_ids, CNPJ, conta_bancaria
• TITULOS: extrato_ids, fatura_id, nc_ids, payment_ids, parcela, CNPJ
• FATURAS: titulo_ids, extrato_ids, nc_ids, chave_nfe, CNPJ
• NOTAS_CREDITO: fatura_origem_id, titulo_ids, extrato_ids, CNPJ
• PAGAMENTOS: extrato_ids, titulo_ids, CNPJ

vincular_extrato_fatura_excel.py

Processa planilha Excel para vincular extratos com faturas automaticamente.

source .venv/bin/activate

# Simular (dry-run)
python .claude/skills/rastreando-odoo/scripts/vincular_extrato_fatura_excel.py -a planilha.xlsx --dry-run

# Executar modo otimizado (3-4x mais rapido)
python .claude/skills/rastreando-odoo/scripts/vincular_extrato_fatura_excel.py -a planilha.xlsx --otimizado

# Executar em lotes de 500
python .claude/skills/rastreando-odoo/scripts/vincular_extrato_fatura_excel.py -a planilha.xlsx --otimizado -o 0 -b 500

Colunas esperadas na planilha:

• A (0): ID do extrato
• H (7): FATURA (name)
• I (8): CNPJ
• K (10): FATURA.1 (ID)
• L (11): PARCELA
• M (12): VALOR
• T (19): Movimento

Processo: Cria account.payment, posta, reconcilia com titulo e extrato.

Estrutura JSON de Saida

Fluxo de Compra

{
  "entrada": "NF 12345",
  "sucesso": true,
  "fluxo": {
    "tipo": "compra",
    "dfe": { "id": 1234, "nfe_infnfe_ide_nnf": "12345" },
    "pedido_compra": { "id": 789, "name": "PO00789", "amount_total": 10000.00 },
    "fatura": { "id": 456, "name": "BILL/2025/0001", "payment_state": "paid" },
    "titulos": [{ "date_maturity": "2025-01-15", "debit": 10000.00, "reconciled": true }]
  }
}

Fluxo de Venda

{
  "fluxo": {
    "tipo": "venda",
    "pedido_venda": { "id": 500, "name": "VCD123", "state": "sale" },
    "pickings": [{ "name": "WH/OUT/00600", "state": "done" }],
    "faturas": [...],
    "titulos": [...]
  }
}

References

Prefixos de Pedido de Venda

Skills Relacionadas