#API Doc — Integración Odoo Producción

Versión 14 | Base path: /api/v1 | Formato: JSON UTF-8 | Autenticación: Bearer Token

#1. Introducción

Esta API conecta un sistema externo con Odoo para soportar procesos del módulo de Producción. Define de forma unificada los endpoints, contratos de datos, validaciones y reglas de sincronización para operar con demanda comercial, órdenes de fabricación y maestros compartidos.

#2. Casos de integración

#Caso A — Demanda por venta

El sistema externo informa una demanda comercial. La API registra la venta en Odoo y el ERP genera la fabricación mediante su flujo estándar de abastecimiento y MRP.

• Aplica cuando existe pedido, cliente y compromiso comercial.
• Preserva trazabilidad: venta → producción.

#Caso B — Producción directa

El sistema externo actúa como planificador y la API crea directamente la orden de fabricación en Odoo con los datos de planificación necesarios.

• Aplica cuando el sistema externo es planificador o MES.
• Permite fabricar sin depender de una venta previa.

#3. Autenticación

#4. Convenciones

#Envelope de respuesta

{
  "success": true,
  "data": {},
  "meta": {
    "correlation_id": "...",
    "timestamp": "2026-06-26T23:30:00Z"
  },
  "errors": []
}

#5. Sincronización de datos maestros

#Prioridad de maestros

#Estrategia técnica

• Sincronización incremental por endpoint de upsert.
• Conciliación nocturna opcional para detectar diferencias.
• Versionado recomendado para BOMs mediante version o effective_from.
• Bloqueo de integración transaccional si faltan productos o BOMs requeridos.

#6. Endpoints

#Autenticación y headers comunes

Todos los endpoints requieren:

Authorization: Bearer <token>
X-Source-System: <codigo_sistema>
Content-Type: application/json

#6.1 Productos

POST /api/v1/master-data/products/upsert

Crea o actualiza productos necesarios para venta, fabricación y consumo.

#Request

{
  "external_id": "PROD-1001",
  "sku": "PT-1001",
  "name": "Producto terminado A",
  "type": "storable",
  "uom_code": "UN",
  "can_be_sold": true,
  "can_be_manufactured": true,
  "tracking": "lot",
  "active": true
}

#Response

{
  "success": true,
  "data": {
    "external_id": "PROD-1001",
    "odoo_model": "product.product",
    "odoo_id": 2481,
    "status": "upserted"
  },
  "errors": []
}

#6.2 Listas de materiales

POST /api/v1/master-data/boms/upsert

Crea o actualiza listas de materiales y sus componentes.

#Request

#components[]

{
  "external_id": "BOM-PT-1001-V1",
  "product_external_id": "PROD-1001",
  "uom_code": "UN",
  "base_quantity": 1,
  "version": "v1",
  "routing_external_id": "ROUT-010",
  "components": [
    {
      "component_product_external_id": "MAT-2001",
      "quantity": 2,
      "uom_code": "UN"
    },
    {
      "component_product_external_id": "MAT-2002",
      "quantity": 0.5,
      "uom_code": "KG",
      "scrap_factor": 0.03
    }
  ]
}

#6.3 Caso A — Demanda por venta

POST /api/v1/case-a/sales-orders

El sistema externo envía una demanda comercial. La API crea una orden de venta y Odoo genera la fabricación mediante su flujo estándar de reaprovisionamiento/MRP.

#Request

#lines[]

{
  "external_order_id": "SO-EXT-9001",
  "customer_external_id": "CUST-5001",
  "order_date": "2026-06-26T10:00:00Z",
  "warehouse_code": "WH-01",
  "lines": [
    {
      "line_external_id": "SO-EXT-9001-1",
      "product_external_id": "PROD-1001",
      "quantity": 120,
      "uom_code": "UN",
      "price_unit": 0
    }
  ]
}

#Response

{
  "success": true,
  "data": {
    "external_order_id": "SO-EXT-9001",
    "sale_order": {"odoo_id": 981, "name": "S000981"},
    "manufacturing": {"status": "triggered"}
  },
  "errors": []
}

#6.4 Caso B — Producción directa

POST /api/v1/case-b/manufacturing-orders

El sistema externo decide qué producir y la API crea directamente la orden de fabricación en Odoo.

#Request

{
  "external_mo_id": "MO-EXT-7001",
  "product_external_id": "PROD-1001",
  "bom_external_id": "BOM-PT-1001-V1",
  "quantity": 250,
  "planned_start": "2026-06-27T08:00:00Z",
  "warehouse_code": "WH-01",
  "routing_external_id": "ROUT-010",
  "priority": "high"
}

#Response

{
  "success": true,
  "data": {
    "external_mo_id": "MO-EXT-7001",
    "manufacturing_order": {"odoo_id": 4521, "name": "MO/004521"},
    "state": "confirmed"
  },
  "errors": []
}

#6.5 Consulta de estado

GET /api/v1/status/production-orders/{external_id}

Consulta el estado consolidado de una demanda u orden de producción.

#Response

#6.6 Maestros secundarios

#7. Errores

{
  "success": false,
  "data": null,
  "errors": [
    {
      "code": "MASTER_NOT_FOUND",
      "message": "No existe product_external_id=PROD-1001",
      "field": "product_external_id"
    }
  ]
}

#8. Mapeo interno con Odoo

Nota de implementación: el adaptador Odoo debe resolver referencias externas en tablas de equivalencia o campos dedicados (x_external_id) y preservar unicidad por modelo.

📄 Fuente: Informe de Integración Odoo Producción v14