QUANDO NAO USAR ESTA SKILL

• Operacoes financeiras como pagamentos ou reconciliacao de extratos (esta skill apenas exporta relatorios)
• Rastrear fluxo documental de NF/PO/SO (esta skill gera relatorio contabil, nao rastreia documentos)
• Explorar modelo Odoo desconhecido (esta skill trabalha exclusivamente com account.move.line)

Razão Geral do Odoo (General Ledger)

Skill para exportação do relatório Razão Geral a partir do Odoo via XML-RPC.

QUANDO USAR:

• Exportar Razão Geral de um período
• Consultar movimentos contábeis (account.move.line) em massa
• Calcular saldos acumulados de contas
• Relatórios contábeis que envolvem account.move.line

Tela Web

URL: /relatorios-fiscais/razao-geral Menu: Financeiro → Central Financeira → Relatórios Contábeis → Razão Geral Blueprint: relatorios_fiscais

Script Standalone

source .venv/bin/activate && python scripts/exportar_razao_geral.py

Configuração (editar no script):

• DATA_INICIO: Data inicial (YYYY-MM-DD)
• DATA_FIM: Data final (YYYY-MM-DD)
• COMPANY_IDS: Lista de company_ids

Service (Importável)

Arquivo: app/relatorios_fiscais/services/razao_geral_service.py

Funções Disponíveis

Exemplo de Uso

from app.odoo.utils.connection import get_odoo_connection
from app.relatorios_fiscais.services.razao_geral_service import (
    buscar_movimentos_razao, gerar_excel_razao
)

connection = get_odoo_connection()
connection.authenticate()

dados_agrupados, contas_info, saldos, total = buscar_movimentos_razao(
    connection,
    data_ini='2024-08-01',
    data_fim='2024-08-31',
    company_ids=[4, 1, 3],
    conta_filter='1010'  # Opcional: filtrar por código de conta
)

excel = gerar_excel_razao(
    dados_agrupados, contas_info, saldos,
    data_ini='2024-08-01', data_fim='2024-08-31', company_ids=[4, 1, 3]
)

# excel é BytesIO pronto para send_file() ou salvar em disco

Modelos Odoo Envolvidos

account.move.line (Modelo Base)

Cada linha representa um débito ou crédito individual.

account.account (Plano de Contas)

account.journal (Diários)

Mapeamento de Empresas

Contas Patrimoniais vs Resultado

Patrimoniais (RECEBEM saldo inicial)

Resultado (SEM saldo inicial)

Padrões Técnicos Utilizados

Paginação com ID-cursor

Usa cursor baseado em ID para performance constante O(1) por batch (sem degradação por offset):

last_id = 0
while True:
    domain_cursor = domain + [['id', '>', last_id]]
    lote = connection.execute_kw(
        'account.move.line', 'search_read', [domain_cursor],
        {'fields': campos, 'limit': 3000, 'order': 'id asc'},
        timeout_override=120
    )
    if not lote:
        break
    last_id = lote[-1]['id']
    # transformar inline...

Nota: Os dados são ordenados por (date, move_name) dentro de cada conta no momento da geração do Excel.

Saldo Inicial via read_group

Uma ÚNICA query para calcular saldos de todas as contas patrimoniais:

result = connection.execute_kw(
    'account.move.line', 'read_group',
    [domain],
    {
        'fields': ['account_id', 'debit:sum', 'credit:sum', 'balance:sum'],
        'groupby': ['account_id'],
        'lazy': False
    },
    timeout_override=180
)

Tratamento de campos Many2one

Campos many2one retornam [id, display_name] ou False:

# Extrair display_name
partner_name = reg['partner_id'][1] if isinstance(reg.get('partner_id'), (list, tuple)) else ''

Tratamento de False do Odoo

Campos vazios retornam False (não None):

valor = reg.get('ref') or '' if reg.get('ref') is not False else ''

Formato do Excel Gerado

Colunas

Conta Contábil | Data | Lançamento | Diário | Parceiro | Referência | Label | Débito | Crédito | Saldo Acumulado | Conciliação

Estrutura

• Linha de título + subtítulo
• Cabeçalho das colunas (fundo azul)
• Para cada conta (ordenada por código):
  • Se patrimonial: linha "Saldo Inicial" (itálico cinza)
  • Linhas de movimentos com saldo acumulado progressivo
• Formato numérico: #,##0.00
• Datas: DD/MM/YYYY

Volume de Dados Observado

Tempo de execução estimado: ~100s (ID-cursor ~90s + Excel xlsxwriter ~8s) Pico de memória: ~40MB (transformação inline sem duplicação)

Troubleshooting