🔗 Nexus

← Volver a notas
7 KB 10/08/2026 23:06
🔗

Odoo-Hoseg — Reportes, consultas a BD y automatizaciones

Registrado: 2026-08-10 · Cliente: Hoseg (14 Diez SAC) · Estado: EN DEFINICIÓN
Objetivo: Conectar Nexus con Odoo del cliente vía API para reportes, consultas a su BD y automatizaciones.


📋 Alcance (definido por Daniel)

  1. Reportes — generar reportes a partir de datos de Odoo
  2. Consultas a su BD — consultar la base de datos de Odoo
  3. Automatizaciones — evaluar qué se puede implementar (fase 3)

Contexto histórico: Odoo v19 Enterprise en Odoo Cloud era parte del proyecto Hoseg Rewards original, pero ese proyecto pivotó sin Odoo (2026-08-05). Este es un proyecto NUEVO centrado en Odoo como fuente de datos.


🏗️ Arquitectura Odoo 19 (resumen de investigación)

Capas (3-tier)

Modelos y tablas

⚠️ Cambios críticos Odoo 19 (migración grande)


🔌 API de Odoo 19 (3 opciones)

1. External JSON-2 API ⭐ (RECOMENDADA para Odoo 19)

2. XML-RPC (legacy pero soportada)

3. JSON-RPC (legacy)

⚠️ Plan de precios (Odoo Online/SaaS)


🗄️ Consultas directas a BD (solo self-hosted)

Reglas


📊 Modelos core para reportes

Ventas

Modelo Tabla Campos clave
sale.order sale_order name, partner_id, date_order, state (draft/sent/sale/done/cancel), amount_total, amount_untaxed, invoice_status, user_id, company_id
sale.order.line sale_order_line order_id, product_id, product_uom_qty, qty_delivered, qty_invoiced, price_unit, price_subtotal, price_total, discount, tax_ids (v19)
res.partner res_partner name, email, phone, company_id, create_date, display_name

Productos

Modelo Tabla Campos clave
product.product product_product name, default_code (SKU), categ_id, list_price, standard_price (costo), uom_id, type
product.template product_template name, list_price, standard_price (herencia)

Contabilidad

Modelo Tabla Campos clave
account.move account_move name, partner_id, invoice_date, state (draft/posted/cancel), amount_total, amount_untaxed, move_type (out_invoice/in_invoice), invoice_origin, payment_state
account.move.line account_move_line move_id, product_id, name, quantity, price_unit, price_subtotal, price_total, account_id, sale_line_id (link a sale.order.line)

Reportes nativos (SQL views, _auto=False)

Ejemplos SQL (reportes)

-- Ventas totales por producto
SELECT pp.name AS producto, SUM(sol.price_total) AS total
FROM product_product pp
JOIN sale_order_line sol ON sol.product_id = pp.id
JOIN sale_order so ON so.id = sol.order_id
WHERE so.state IN ('sale','done')
GROUP BY pp.name ORDER BY total DESC;

-- Órdenes con cliente y producto
SELECT so.name AS orden, rp.name AS cliente, so.date_order AS fecha,
       pp.default_code AS sku, sol.product_uom_qty AS qty, sol.price_unit AS precio
FROM sale_order so
JOIN res_partner rp ON so.partner_id = rp.id
JOIN sale_order_line sol ON so.id = sol.order_id
JOIN product_product pp ON sol.product_id = pp.id
WHERE so.state IN ('sale','done')
ORDER BY so.date_order DESC;

🔑 Credenciales necesarias (PENDIENTE — pedir a Daniel/cliente)

⏳ Próximos pasos

  1. Confirmar tipo de instancia (Online vs self-hosted) → define todo el approach
  2. Obtener API key y probar conectividad (/json/2/res.partner/search_read con limit 5)
  3. Mapear qué reportes quiere Hoseg (ventas, facturación, inventario, clientes)
  4. Definir automatizaciones candidatas (alertas, extractos, sync)