Conciliando Odoo Po

QUANDO NAO USAR ESTA SKILL

• Validar match NF x PO (este e Fase 2, anterior a consolidacao)
• Processar recebimento fisico com lotes/quality check (este e Fase 4, posterior)
• Operacoes financeiras como pagamentos ou reconciliacao de extratos
• Apenas consultar/rastrear documentos sem modificar POs

Conciliando Odoo PO

Skill para EXECUTAR operacoes de Split e Consolidacao de Pedidos de Compra no Odoo.

Contexto

Quando uma NF-e (DFe) chega com quantidades diferentes dos POs existentes, o sistema precisa:

1. Criar um PO Conciliador que casa 100% com a NF
2. Ajustar os POs originais para ficarem com o saldo restante
3. Vincular o DFe ao PO Conciliador

Operacoes Suportadas

Arquivo Principal

app/recebimento/services/odoo_po_service.py (1281 linhas)

Classe Principal

from app.recebimento.services.odoo_po_service import OdooPoService

service = OdooPoService()

Fluxo Completo de Consolidacao

ENTRADA:
  - validacao_id (ValidacaoNfPoDfe com status='aprovado')
  - pos_para_consolidar: [{'po_id': 123, 'po_name': 'PO00123'}, ...]

PASSO 1: Buscar fornecedor_id pelo CNPJ
  → odoo.search('res.partner', [('l10n_br_cnpj', '=', cnpj_formatado)])

PASSO 2: Criar PO Conciliador VAZIO
  → copy(PO de referencia) com overrides: partner_id, date_order, origin, state=draft, order_line=False
  → Fallback: se copy() copiar linhas, remove-las via unlink

PASSO 3: Para CADA item da NF com match:
  → Para cada MatchAlocacao (suporte multi-PO):
    a) copy(linha de referencia) → nova linha no PO Conciliador com qtd_nf e preco_nf
    b) write(linha original) → reduzir product_qty no PO original

PASSO 4: Confirmar PO Conciliador
  → execute_kw('purchase.order', 'button_confirm', [po_id])

PASSO 5: Vincular DFe ao PO Conciliador
  → write('purchase.order', po_id, {'dfe_id': dfe_id})

Modelos Locais Envolvidos

Modelos Odoo Envolvidos

Metodo de Conexao Odoo

from app.odoo.utils.connection import get_odoo_connection

odoo = get_odoo_connection()
odoo.authenticate()

# UNICO metodo generico disponivel:
resultado = odoo.execute_kw(modelo, metodo, args, kwargs)

# Helpers especificos (wrapper de execute_kw):
odoo.search(modelo, domain, limit=None)
odoo.read(modelo, ids, fields)
odoo.write(modelo, id_ou_ids, values)
odoo.create(modelo, values)

IMPORTANTE: NAO existe odoo.execute()

A classe OdooConnection (app/odoo/utils/connection.py) possui APENAS:

• execute_kw(model, method, args, kwargs) - generico
• search(), read(), write(), create() - helpers

NUNCA usar odoo.execute() — nao existe e causara AttributeError.

Cenarios de Uso

SPLIT (1 NF parcial de 1 PO)

PO Original: 500 un produto X
NF chegou: 400 un produto X

Resultado:
  PO Original: 100 un (saldo)
  PO Conciliador (NOVO): 400 un → vinculado a NF

CONSOLIDACAO (1 NF com itens de N POs)

PO-A: 500 un produto X
PO-B: 500 un produto Y
NF chegou: 400 X + 400 Y

Resultado:
  PO-A: 100 un X (saldo)
  PO-B: 100 un Y (saldo)
  PO Conciliador (NOVO): 400 X + 400 Y → vinculado a NF

MULTI-PO SPLIT (1 item NF → N POs)

PO-A: 200 un produto X
PO-B: 300 un produto X
NF chegou: 450 un produto X

Resultado (via MatchAlocacao):
  PO-A: 0 un (consumido total, pode ser cancelado)
  PO-B: 50 un (saldo)
  PO Conciliador: 200 X (do PO-A) + 250 X (do PO-B) = 450 X

Pre-requisitos para Consolidacao

1. Validacao com status='aprovado'
2. MatchNfPoItem com status_match='match' para cada item
3. MatchAlocacao com odoo_po_line_id preenchido para multi-PO
4. Conexao Odoo funcional

Referencia Cruzada com Outras Skills