Requisiciones de Material

Descripcion General

El modulo de Requisiciones de Material permite a los empleados de ACE solicitar formalmente materiales e insumos necesarios para sus operaciones. Este modulo digitaliza el formulario fisico ACE-MT-FO-RM-027 y automatiza todo el flujo de aprobacion multinivel, despacho multi-almacen y seguimiento completo con integracion a procura.

Que es una Requisicion de Material?

Una requisicion de material es una solicitud interna que un empleado realiza para obtener materiales del almacen de la empresa. A diferencia de una requisicion de compra (externa), los materiales solicitados pueden estar disponibles en inventario.

Tipo	Origen	Destino
Requisicion de Material (interna)	Empleado -> Almacen	Despacho desde inventario existente
Requisicion de Compra (externa)	Almacen/Procura -> Proveedor	Compra de materiales no disponibles

Flujo Completo

graph TD
    A[Empleado crea solicitud] --> B[DRAFT]
    B --> C{Enviar para revision}
    C -->|Empleado regular| D[PENDING_MANAGER]
    C -->|Gerente de depto| E[PENDING_DIRECTOR]
    C -->|Director| F[APPROVED - auto]
    D -->|Gerente aprueba| E
    D -->|Devuelve| G[RETURNED]
    E -->|Director aprueba| F
    E -->|Devuelve| G
    G -->|Edita y reenvia| C
    F --> H{Logistica verifica stock}
    H -->|Todo disponible| I[Despacho total]
    H -->|Parcial| J[Despacho + Procura]
    H -->|Sin stock| K[Solo Procura]
    I --> L[FULFILLED]
    J --> M[PARTIALLY_FULFILLED]
    K --> N[AWAITING_PROCUREMENT]
    N -->|OC recibida| O[READY_FOR_DISPATCH]
    O -->|Logistica despacha| L
    M -->|Completa despacho| L

Roles Involucrados

Rol	Permisos	Responsabilidad
Solicitante	requisitions:create, requisitions:submit	Crea, envia y puede reenviar requisiciones devueltas
Gerente de Departamento	requisitions:review	Primer nivel de aprobacion (PENDING_MANAGER -> PENDING_DIRECTOR)
Director Tecnico	requisitions:review	Aprobacion final (PENDING_DIRECTOR -> APPROVED). Auto-aprueba sus propias requisiciones
Logistica/Almacen	requisitions:fulfill	Verifica stock, despacha materiales, registra items en inventario
Procura	requisitions:route-procurement	Enruta items sin stock al modulo de procura
Administrador	requisitions:manage	Acceso completo al modulo

Estados de una Requisicion

Estado	Codigo	Descripcion
Borrador	DRAFT	Editable por el creador. Puede agregar/modificar items
Pendiente Gerente	PENDING_MANAGER	Esperando aprobacion del gerente de departamento
Pendiente Director	PENDING_DIRECTOR	Esperando aprobacion final del director tecnico
Devuelta	RETURNED	Devuelta al solicitante para correcciones. Puede editarla y reenviar
Aprobada	APPROVED	Lista para despacho por logistica
Parcialmente Despachada	PARTIALLY_FULFILLED	Algunos items despachados, otros pendientes o en procura
En Espera de Procura	AWAITING_PROCUREMENT	Todos los items pendientes estan en proceso de compra
Lista para Despacho	READY_FOR_DISPATCH	Material recibido de OC, listo para que logistica despache
Completada	FULFILLED	Todos los items despachados exitosamente
Rechazada	REJECTED	Rechazada en el flujo de aprobacion (legacy)
Cancelada	CANCELLED	Cancelada por el solicitante o administrador

Propositos de Requisicion

Cada requisicion puede tener un proposito que determina como se procesan los materiales:

Proposito	Codigo	Tipo de Movimiento Generado
Reposicion de Stock	STOCK_REPLENISHMENT	STOCK_TRANSFER
Asignacion a Departamento	DEPARTMENT_ASSIGNMENT	DEPARTMENT_USE
Asignacion a Activo	ASSET_ASSIGNMENT	ASSET_ASSIGNMENT
Asignacion a Proyecto	PROJECT_ASSIGNMENT	PROJECT_USE

Informacion Presupuestaria

Cada requisicion puede incluir informacion presupuestaria para facilitar el control contable:

• Categoria Presupuestaria: Vinculacion al plan presupuestario (OPEX/CAPEX)
• Sub Categoria: Clasificacion mas especifica
• Renglon Presupuestario: Linea especifica del presupuesto
• N. Partida por item: Codigo de partida presupuestaria individual
• Activo de Produccion: Equipo o activo al que se destina el material
• Nota de Proposito: Justificacion detallada de la requisicion

Auto-Aprobacion

El sistema auto-aprueba requisiciones en dos casos:

1. Director Tecnico (Position.level=1, isSupervisory=true): Al crear o enviar, se aprueba automaticamente
2. Gerente del departamento: Al crear, se aprueba automaticamente

En ambos casos se notifica directamente al equipo de logistica.

Guias del Modulo

• Crear una Requisicion - Formulario, items del catalogo y texto libre
• Flujo de Aprobacion - Aprobacion multinivel, devolucion y reenvio
• Despacho de Almacen - Despacho multi-almacen, registro de inventario, opciones combinadas
• Integracion con Procura - Enrutamiento a compras, cierre de ciclo

Referencia API

Endpoint	Metodo	Permiso	Descripcion
/api/material-requisitions	GET	requisitions:read	Listar requisiciones
/api/material-requisitions	POST	requisitions:create	Crear requisicion
/api/material-requisitions/:id	GET	requisitions:read	Obtener detalle
/api/material-requisitions/:id	PUT	requisitions:update	Actualizar (DRAFT/RETURNED)
/api/material-requisitions/:id	DELETE	requisitions:delete	Eliminar
/api/material-requisitions/:id/submit	POST	requisitions:submit	Enviar para revision
/api/material-requisitions/:id/approve	POST	requisitions:review	Aprobar
/api/material-requisitions/:id/return	POST	requisitions:review	Devolver con comentario
/api/material-requisitions/:id/resubmit	POST	requisitions:submit	Reenviar despues de correccion
/api/material-requisitions/:id/cancel	POST	requisitions:cancel	Cancelar
/api/material-requisitions/:id/stock-check	GET	requisitions:fulfill	Verificar stock
/api/material-requisitions/:id/fulfill	POST	requisitions:fulfill	Despachar items
/api/material-requisitions/:id/fulfill-and-procure	POST	requisitions:fulfill	Despacho + procura combinado
/api/material-requisitions/:id/route-procurement	POST	requisitions:route-procurement	Enrutar a procura
/api/material-requisitions/:id/pdf	GET	requisitions:read	Exportar PDF
/api/material-requisitions/:id/timeline	GET	requisitions:read	Ver historial de actividad
/api/material-requisitions/:id/comment	POST	requisitions:read	Agregar comentario
/api/material-requisitions/stats	GET	requisitions:read	Estadisticas
/api/material-requisitions/pending-approval	GET	requisitions:review	Pendientes de aprobacion