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)
- Reportes — generar reportes a partir de datos de Odoo
- Consultas a su BD — consultar la base de datos de Odoo
- 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)
- Presentación: HTML5/JS/CSS (web client)
- Lógica: Python (módulos/addons)
- Datos: PostgreSQL exclusivamente (única BD soportada)
Modelos y tablas
- Modelo = clase Python; tabla = modelo con
. → _
res.partner → res_partner
sale.order → sale_order
account.move → account_move
product.product → product_product
- 3 clases base:
RegularModel → tabla física (clientes, productos, órdenes)
TransientModel → temporales (wizards), se limpian solas
AbstractModel → comportamiento compartido, sin tabla
- Many2many → tabla rel
res_partner_res_partner_category_rel (info en ir_model_relation)
- Verificar nombre de tabla: Settings → Technical → Database Structure → Models (modo debug)
⚠️ Cambios críticos Odoo 19 (migración grande)
- 130 modelos renombrados, 25 módulos fusionados (ej:
hr_contract → dentro de hr; web_editor → html_builder)
- 51 campos renombrados, 416 cambios de constraints, 338 constraints eliminadas
- Cambios en ORM:
fields_get() firma cambiada, name_search() → _name_search()
- Campos que cambiaron (¡importante para consultas!):
sale.order.line: tax_id → tax_ids (multi-impuesto), product_uom → product_uom_id
account.move.line: se eliminó product_uom_category_id
- Implicación: si el cliente migró de versión anterior, los campos viejos pueden no existir. Verificar siempre contra la BD real.
🔌 API de Odoo 19 (3 opciones)
1. External JSON-2 API ⭐ (RECOMENDADA para Odoo 19)
- Endpoint:
POST /json/2/<model>/<method>
- Auth: API Key como bearer token:
Authorization: bearer <API_KEY>
- Header:
X-Odoo-Database: <db> (si múltiples BD)
- Body: JSON con args nombrados (
domain, fields, ids, values, context)
- API key: Preferences → Account Security → New API Key (descripción + duración)
- Todos los requests son POST; sin args posicionales
- Ejemplo:
python
import requests
headers = {
"Content-Type": "application/json",
"Authorization": f"bearer {API_KEY}",
"X-Odoo-Database": DB_NAME,
}
url = f"{ODOO_URL}/json/2/res.partner/search_read"
r = requests.post(url, headers=headers, json={
"domain": [], "fields": ["name", "email"], "limit": 5
})
2. XML-RPC (legacy pero soportada)
/xmlrpc/2/common → authenticate(db, login, password) → uid
/xmlrpc/2/object → execute_kw(db, uid, password, model, method, args, kwargs)
- Métodos:
search, read, search_read, create, write, unlink
- API keys funcionan como password
- ⚠️ Deprecada: se elimina en Odoo 22 (2028) y Online 21.1 (2027)
3. JSON-RPC (legacy)
/web/session/authenticate → session_id cookie
- Luego
/jsonrpc con método call
- ⚠️ Misma fecha de deprecación que XML-RPC
⚠️ Plan de precios (Odoo Online/SaaS)
- API externa SOLO con plan Custom (no One App Free ni Standard)
- Odoo Online NO permite conexión directa a PostgreSQL — solo API
- Si el cliente usa Odoo Online con plan Standard → hay que verificar acceso API o considerar self-hosted
🗄️ Consultas directas a BD (solo self-hosted)
Reglas
- Odoo Online/SaaS: NO hay acceso directo a PostgreSQL. Solo API.
- Self-hosted: sí se puede conectar con psql, PERO:
- ⚠️ Bypassa toda la seguridad del ORM (record rules, multi-company)
- ⚠️ Escritura directa = riesgo de corrupción (mejor ORM para escribir)
- Para solo lectura/reportes es aceptable y MUCHO más rápido en datasets grandes (100k+)
- Leer via psql: usuario postgres, BD Odoo; credenciales en
odoo.conf (db_user, db_password)
- Prácticas: queries parametrizadas (anti-injection), usar
read_group() para agregados, EXPLAIN ANALYZE para perf, vistas materializadas para reportes recurrentes
📊 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)
sale.report — análisis de ventas (pivot/graph)
account.report — balance, P&L, libro mayor, aged receivables
account.invoice.report — estadísticas de facturas (_table_query complejo)
stock.report — inventario, valorización, movimientos
- Accesibles vía Reporting menu; extensibles con
_select_additional_fields()
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)
- [ ] URL de la instancia Odoo (¿Odoo Online Cloud? ¿self-hosted en VPS?)
- [ ] Nombre de la BD
- [ ] Usuario con permisos de lectura + API Key (Preferences → Account Security → New API Key)
- [ ] Confirmar plan: ¿Custom (API habilitada)?
- [ ] Si es self-hosted: ¿acceso psql directo? (reportes pesados)
⏳ Próximos pasos
- Confirmar tipo de instancia (Online vs self-hosted) → define todo el approach
- Obtener API key y probar conectividad (
/json/2/res.partner/search_read con limit 5)
- Mapear qué reportes quiere Hoseg (ventas, facturación, inventario, clientes)
- Definir automatizaciones candidatas (alertas, extractos, sync)