Catálogo de consumibles y partes
El módulo Consumibles es el catálogo global de partes y repuestos (columnas, sellos, lámparas, filtros, viales…). Un consumible no pertenece a un equipo: se define una sola vez acá y luego se vincula a los módulos de los equipos desde la Ficha de Equipo. Un mismo consumible puede usarse en módulos de distintos equipos.
Los consumibles no se borran: DELETE /consumibles/{id} responde 405. Para dar de
baja se archiva con motivo obligatorio, y el registro queda consultable con "Ver archivados".
Restaurar es una acción exclusiva de administradores.
Campos del consumible
| Campo | Obligatorio | Detalle |
|---|---|---|
| Número de parte | ✅ Sí | Es el "código" del consumible. Único entre los consumibles activos (ignora mayúsculas y espacios). |
| Marca | ✅ Sí | Fabricante de la parte. |
| Descripción | — | Texto libre (p. ej. "Columna C18 150×4.6 mm 5 µm"). |
| Número de parte alternativo | — | Código de una parte equivalente (segunda fuente / cross-reference). También es buscable. |
| Marca alternativa | — | Marca de esa parte equivalente. |
El número y la marca alternativos describen un repuesto equivalente que puede sustituir al principal. No crean un segundo registro ni un vínculo: son dos campos descriptivos dentro del mismo consumible.
Acciones y estados
Todos los endpoints exigen sesión iniciada. La búsqueda, el filtro por marca y el ordenamiento son del lado del cliente (la lista completa se trae una vez y se filtra en memoria).
| Acción | Endpoint | Condiciones |
|---|---|---|
| Listar / ver archivados | GET /consumibles/?incluir_archivados= | Sin el flag, solo activos. |
| Crear | POST /consumibles/ | 409 si el número de parte ya existe en otro activo. |
| Editar | PUT /consumibles/{id} | 409 si está archivado (restaurar primero) o si el nuevo número colisiona. |
| Archivar | PATCH /consumibles/{id}/archivar | Motivo obligatorio (mínimo 5 caracteres en pantalla). |
| Restaurar | PATCH /consumibles/{id}/restaurar | Solo administrador (403 si no). 409 si otro activo tomó ese número mientras estuvo archivado. |
| Vincular a un módulo | POST /equipos/{equipo_id}/consumibles/asociar | Desde la Ficha de Equipo. Idempotente. |
| Desvincular de un módulo | DELETE /equipos/{equipo_id}/consumibles/desasociar | Desde la Ficha de Equipo. |
Dos consumibles activos no pueden compartir número de parte (comparación sin distinguir mayúsculas ni espacios). Sí podés reutilizar un número cuyo original fue archivado. Toda alta, edición, archivado, restauración, vínculo y desvínculo queda registrada en el audit trail con el estado anterior real.
Cómo se usa desde Equipos
El vínculo real vive en la relación módulo ↔ consumible. En la Ficha de Equipo, la sección "Consumibles asociados" muestra los consumibles ya vinculados a los módulos del equipo y sugiere candidatos por coincidencia de marca.
Número de parte y marca. Esto solo lo agrega a la lista global.
Elegís el consumible y el módulo destino. Recién ahí figura en ese equipo.
Archivar un consumible no rompe sus vínculos con los módulos. Si querés que deje de figurar en un equipo, desvinculalo desde la Ficha de Equipo además de archivarlo.
Preguntas frecuentes
405). Usá Archivar con un motivo; el registro se conserva y podés verlo con "Ver archivados".