Manufacturing

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:

Seleccionar el producto terminado
Agregar las lineas con materiales y cantidades
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:

El estado cambia a COMPLETED
Se genera asiento contable (best-effort):
- Debito: Inventario de Producto Terminado
- Credito: Produccion en Proceso
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