#Estimación — Integración Odoo Producción v14

Informe Ejecutivo de Estimación · Metodología JEO (Jinzo Estimación Odoo) · 2026-08-06

#KPIs

#1. Resumen Ejecutivo

Se estima el desarrollo de una capa de integración entre un sistema externo y Odoo 19 Enterprise para el módulo de Producción, siguiendo la especificación API v14 documentada en Hitofusion Docs. La solución consiste en un middleware que expone los endpoints definidos en la API doc (inbound) y consume las APIs del sistema externo (outbound), junto con un módulo Odoo custom que extiende los modelos de fabricación, productos, BOMs y routings.

Se implementa uno de los dos casos de integración (A: demanda por venta, o B: producción directa). La estimación toma como base el Caso B por ser el de mayor complejidad técnica, e incluye migración de datos históricos.

#2. Desglose por Fase

#3. Desglose por Rol

#4. Arquitectura y Componentes

#Middleware (API Gateway)

• Framework base (FastAPI), health checks, configuración multi-ambiente
• Autenticación Bearer Token, logging estructurado JSON, correlation-id
• Manejo de errores estandarizado con envelope success/data/errors/meta
• Idempotencia por Idempotency-Key y unicidad de external_id
• Rate limiting básico

#Endpoints Maestros (Inbound)

• POST /master-data/products/upsert → product.product
• POST /master-data/boms/upsert → mrp.bom + componentes
• POST /master-data/customers/upsert → res.partner
• POST /master-data/vendors/upsert → res.partner
• POST /master-data/warehouses/upsert → stock.warehouse
• POST /master-data/routings/upsert → mrp.routing.workcenter

#Endpoints de Negocio (Inbound)

• POST /case-b/manufacturing-orders → mrp.production (creación directa, confirmación, planificación)
• GET /status/production-orders/{id} → estado consolidado (MO + stock.move + work orders)

#Conexión Outbound

• Cliente HTTP para APIs del sistema externo (autenticación, reintentos, timeouts)
• Mapeo y transformación bidireccional de contratos de datos

#Módulo Odoo Custom

• Campos x_external_id con índices únicos en product, BOM, MO, partner, warehouse, routing
• Resolución de referencias externas con validación de existencia
• Extensión de mrp.production para API de creación y planificación
• Extensión de mrp.bom y mrp.routing.workcenter para sincronización

#5. Tamaño Funcional (COSMIC Adaptado)

E = Entrada · X = Salida · R = Lectura · W = Escritura · CFP = Puntos de Función Cósmica

#6. Alcance y Exclusiones

#✅ Incluido

• Desarrollo completo del middleware (todos los endpoints maestros + Caso B + status)
• Módulo Odoo con extensiones de modelos de producción
• Migración de datos históricos
• Conexión outbound a APIs del sistema externo
• Idempotencia, trazabilidad y manejo de errores
• Tests unitarios, integración, funcionales y regresión
• Documentación técnica y funcional
• Deploy, staging, rollback y UAT interno
• Coordinación de contratos de integración bilaterales

#❌ Fuera de alcance

• Desarrollo del lado del sistema externo
• Certificación formal externa o auditoría de seguridad
• Capacitación de usuarios
• Soporte post-go-live (más allá de estabilización)
• Dashboard o monitoreo avanzado
• Conciliación nocturna automática
• Caso A adicional si se elige Caso B (y viceversa)

#7. Supuestos y Dependencias

• Odoo 19 Enterprise con módulos MRP, Stock y Ventas instalados y funcionales
• Las APIs del sistema externo están documentadas y disponibles para análisis
• Volumen transaccional bajo — sin necesidad de workers asíncronos, colas ni Redis
• Middleware desplegado on-premise o cloud gestionado con conectividad a Odoo
• El equipo del sistema externo está disponible para coordinación en tiempo razonable
• Staging disponible; credenciales gestionadas internamente (~1 día de configuración)
• Datos históricos en formato estructurado accesible; sin ingeniería inversa de formatos legacy

#8. Riesgos Identificados

#🔴 Alto

Coordinación bilateral bloqueante

Probabilidad media · Impacto alto

Si el equipo externo demora en responder, ANL-01 y DEV-12/13 se dilatan significativamente.

→ Mitigación: iniciar coordinación temprano, establecer SLAs de respuesta, definir contrato API como prerequisito de desarrollo.

APIs del sistema externo no analizadas

Probabilidad media · Impacto alto

Complejidad y madurez desconocidas de los contratos outbound.

→ Mitigación: spike de ~20 h antes de cerrar el rango pesimista.

#🟡 Medio

Calidad de datos históricos

Probabilidad media · Impacto medio

Inconsistencias o datos faltantes pueden disparar MIG-02 al extremo pesimista.

→ Mitigación: análisis de muestra de datos antes de scripts de migración.

Cambios en APIs de Odoo 19 MRP

Probabilidad baja · Impacto medio

APIs de MRP pueden diferir de versiones conocidas.

→ Mitigación: verificación temprana en staging con módulos reales.

#🟢 Bajo

Caso no definido (A vs B)

Probabilidad baja · Impacto bajo

La estimación ya contempla el Caso B como cota superior. Si se elige Caso A, el esfuerzo sería ~20-25 h menor.

#9. Estado de Gates (JEO)

#10. Condiciones de Validez y Próximos Pasos

#Esta estimación debe reversionarse si cambia:

• La versión o edición de Odoo
• El caso de integración de A a B (o viceversa) después de iniciado el desarrollo
• El contrato de API con el sistema externo
• El volumen transaccional (si pasa a requerir procesamiento asíncrono)
• La estrategia de arquitectura (middleware → módulo directo)
• La disponibilidad o alcance de la migración histórica
• Los criterios de aceptación (si se agrega certificación externa)

#Próximos pasos recomendados:

1. Validar funcionalmente el entendimiento del flujo y confirmar Caso A o B
2. Ejecutar spike técnico (~20 h) para analizar APIs del sistema externo y cerrar la incertidumbre outbound
3. Revisión funcional y técnica de esta estimación por parte del equipo
4. Con spike completado y revisión aprobada, convertir a E2 comprometible
5. Iniciar coordinación con el equipo del sistema externo en paralelo

#11. Fuentes

• API Doc v14: hitofusion-doc.netlify.app/integraciones/produccion/api-doc — especificación completa de endpoints, contratos, errores y mapeo Odoo
• Metodología JEO v1.0.0: Jinzo Estimación Odoo — COSMIC adaptado, WBS técnica Odoo, PERT de tres puntos
• Matriz técnica Odoo: estrategias de solución, componentes WBS, complejidad C1–C5, factores de incertidumbre
• Q&A con stakeholder: respuestas sobre versión Odoo, middleware, casos, volumen, migración, staging (2026-08-06)

#Anexo A — WBS Técnica Detallada

#Fase: Análisis

#Fase: Desarrollo

Nota: La WBS original del informe fuente está parcialmente truncada a partir de DEV-06. Las tareas restantes de desarrollo, migración, QA, deploy y gestión de proyecto completan el total de 383 h esperadas.