Manufactura

El modulo de manufactura permite gestionar el proceso productivo completo: desde la definicion de listas de materiales (BOM) hasta la ejecucion de ordenes de trabajo con control de materiales, centros de trabajo y producto terminado.

Conceptos clave

Concepto	Descripcion
BOM (Bill of Materials)	Lista de materiales necesarios para fabricar un producto
Centro de trabajo	Estacion o area donde se realiza una operacion de produccion
Ruta	Secuencia de operaciones y centros de trabajo para fabricar un producto
Orden de trabajo	Instruccion para fabricar una cantidad especifica de un producto

Lista de materiales (BOM)

La BOM define que materiales se necesitan para fabricar un producto y en que cantidad.

Estructura

BOM: Silla de Madera (PT-001)
+-- Asiento de madera (MP-010)    x 1 unidad
+-- Respaldo (MP-011)             x 1 unidad
+-- Patas (MP-012)                x 4 unidades
+-- Tornillos (MP-013)            x 8 unidades
+-- Barniz (MP-014)               x 0.2 litros

Estados de BOM

Estado	Descripcion
DRAFT	Borrador, no se puede usar en ordenes
ACTIVE	Activa, disponible para produccion
OBSOLETE	Obsoleta, ya no se debe usar

Operaciones

Endpoint	Metodo	Descripcion
/v1/manufactura/bom	GET	Listar BOMs con filtros
/v1/manufactura/bom	POST	Crear nueva BOM
/v1/manufactura/bom/:id	GET	Detalle de BOM con lineas
/v1/manufactura/bom/:id/activar	POST	Activar BOM
/v1/manufactura/bom/:id/obsoleto	POST	Marcar como obsoleta

Crear BOM

Para crear una BOM se necesita:

1. Seleccionar el producto terminado
2. Agregar las lineas con materiales y cantidades
3. Opcionalmente, definir la version

{
  "productId": 100,
  "version": "1.0",
  "lines": [
    { "materialId": 200, "quantity": 1, "unit": "PZA" },
    { "materialId": 201, "quantity": 4, "unit": "PZA" },
    { "materialId": 202, "quantity": 8, "unit": "PZA" }
  ]
}

Centros de trabajo

Los centros de trabajo representan las estaciones de produccion donde se realizan las operaciones.

Datos del centro de trabajo

Campo	Descripcion
Nombre	Nombre descriptivo (ej: “Corte”, “Ensamblaje”, “Pintura”)
Capacidad	Capacidad productiva por hora
Costo por hora	Costo de operacion del centro
Estado	Activo/Inactivo

Operaciones

Endpoint	Metodo	Descripcion
/v1/manufactura/centros-trabajo	GET	Listar centros de trabajo
/v1/manufactura/centros-trabajo	POST	Crear centro de trabajo

Rutas de produccion

Las rutas definen la secuencia de operaciones necesarias para completar la fabricacion.

Estructura

Ruta para BOM "Silla de Madera":
  1. Corte       -- Centro: Sierra    -- 15 min
  2. Ensamblaje  -- Centro: Banco     -- 30 min
  3. Lijado      -- Centro: Lijadora  -- 10 min
  4. Pintura     -- Centro: Cabina    -- 20 min
  5. Secado      -- Centro: Secadero  -- 60 min

Operaciones

Endpoint	Metodo	Descripcion
/v1/manufactura/bom/:id/rutas	GET	Ver rutas de una BOM
/v1/manufactura/bom/:id/rutas	POST	Agregar operacion a la ruta

Cada operacion de ruta incluye:

• Nombre de la operacion
• Centro de trabajo asignado
• Numero de secuencia
• Tiempo estimado

Ordenes de trabajo

La orden de trabajo es la instruccion para fabricar una cantidad especifica de un producto usando una BOM determinada.

Ciclo de vida

PLANNED --> IN_PROGRESS --> COMPLETED
                        --> CANCELLED

Estado	Descripcion
PLANNED	Planificada, no iniciada
IN_PROGRESS	En produccion activa
COMPLETED	Completada exitosamente
CANCELLED	Cancelada

Flujo completo de una orden

1. Crear orden

POST /v1/manufactura/ordenes
{
  "bomId": 1,
  "quantity": 50,
  "plannedStartDate": "2026-03-25",
  "plannedEndDate": "2026-03-27"
}

La orden se crea en estado PLANNED.

2. Iniciar produccion

POST /v1/manufactura/ordenes/:id/iniciar

La orden pasa a estado IN_PROGRESS. Se registra la fecha de inicio real.

3. Reportar consumo de materiales

POST /v1/manufactura/ordenes/:id/consumir
{
  "materials": [
    { "materialId": 200, "quantity": 50 },
    { "materialId": 201, "quantity": 200 },
    { "materialId": 202, "quantity": 400 }
  ]
}

Se descuenta stock del inventario para cada material consumido. Si un material no tiene stock suficiente, se reporta pero no bloquea la operacion.

4. Reportar salida de producto terminado

POST /v1/manufactura/ordenes/:id/reportar-salida
{
  "quantity": 48,
  "warehouseId": 1
}

Se ingresa el producto terminado al inventario. La cantidad puede ser menor a la planificada (merma).

5. Completar orden

POST /v1/manufactura/ordenes/:id/completar

Al completar la orden:

1. El estado cambia a COMPLETED
2. Se genera asiento contable (best-effort):
   • Debito: Inventario de Producto Terminado
   • Credito: Produccion en Proceso
3. Se registra la fecha de finalizacion real

6. Cancelar orden (alternativo)

POST /v1/manufactura/ordenes/:id/cancelar

Cancela la orden. Los materiales ya consumidos no se devuelven automaticamente.

Operaciones

Endpoint	Metodo	Descripcion
/v1/manufactura/ordenes	GET	Listar ordenes con filtros
/v1/manufactura/ordenes	POST	Crear orden de trabajo
/v1/manufactura/ordenes/:id	GET	Detalle de orden
/v1/manufactura/ordenes/:id/iniciar	POST	Iniciar produccion
/v1/manufactura/ordenes/:id/consumir	POST	Reportar consumo
/v1/manufactura/ordenes/:id/reportar-salida	POST	Reportar producto terminado
/v1/manufactura/ordenes/:id/completar	POST	Completar orden
/v1/manufactura/ordenes/:id/cancelar	POST	Cancelar orden

Integraciones

Manufactura a Inventario

• Consumo: descuenta materias primas del almacen
• Produccion: ingresa producto terminado al almacen
• Ambas operaciones generan StockMovement trazables

Manufactura a Contabilidad

Al completar una orden se genera asiento contable con:

• SourceModule: manufactura
• SourceDocumentNo: numero de la orden de trabajo

Stored procedures

SP	Descripcion
usp_Mfg_BOM_List	Listar BOMs
usp_Mfg_BOM_Get	Detalle de BOM
usp_Mfg_BOM_Create	Crear BOM
usp_Mfg_BOM_Activate	Activar BOM
usp_Mfg_BOM_Obsolete	Marcar obsoleta
usp_Mfg_WorkCenter_List	Listar centros
usp_Mfg_WorkCenter_Create	Crear centro
usp_Mfg_Routing_List	Listar rutas
usp_Mfg_Routing_Create	Crear operacion de ruta
usp_Mfg_WorkOrder_List	Listar ordenes
usp_Mfg_WorkOrder_Get	Detalle de orden
usp_Mfg_WorkOrder_Create	Crear orden
usp_Mfg_WorkOrder_Start	Iniciar orden
usp_Mfg_WorkOrder_Consume	Reportar consumo
usp_Mfg_WorkOrder_ReportOutput	Reportar salida
usp_Mfg_WorkOrder_Complete	Completar orden
usp_Mfg_WorkOrder_Cancel	Cancelar orden
usp_Mfg_Integracion_StockMovement	Mover stock
usp_Mfg_Integracion_AccountingEntry	Generar asiento