Appearance
Tipo de Comprobante de Stock
Modulo: Stock Tipo: Resource Estado: Implementado Fecha: 2026-03-20 Ultima actualizacion: 2026-03-21
Descripcion
Problema de negocio
Los tipos de comprobante de stock definen las categorias con las que se clasifican los movimientos de inventario. Cada tipo indica si corresponde a un ingreso o egreso de mercaderia, y permite configurar opciones adicionales como impresion, control y valoracion.
Actualmente la gestion de estos tipos se realiza a traves de un mecanismo que no sigue los estandares del sistema, lo que limita la auditoria de cambios y la consistencia del mantenimiento.
Necesidad del negocio
El sistema requiere una gestion estandarizada de los tipos de comprobante de stock que permita:
- Consultar todos los tipos de comprobante disponibles
- Crear nuevos tipos de comprobante con su configuracion
- Editar tipos de comprobante existentes
- Auditar todas las operaciones de alta y modificacion
Valor para el negocio
- Estandarizacion del mantenimiento de tipos de comprobante
- Trazabilidad completa de cambios con registro de auditoria
- Validacion de datos al crear y editar, previniendo inconsistencias
Frontend (Perspectiva de Usuario)
Vistas
- Pantalla de listado con todos los tipos de comprobante de stock
- Formulario para crear un nuevo tipo de comprobante
- Formulario para editar un tipo de comprobante existente
Interacciones del Usuario
- Consultar el listado completo de tipos de comprobante
- Crear un nuevo tipo de comprobante indicando nombre, tipo de movimiento y opciones
- Editar un tipo de comprobante existente
Estados de UI
- Indicador de carga mientras se obtiene el listado
- Mensaje de exito al crear o editar un tipo de comprobante
- Mensaje de error si el nombre ya existe o faltan datos obligatorios
- Vista vacia cuando no hay tipos de comprobante registrados
Backend (Perspectiva de Datos de Negocio)
Entidades de Negocio
- Tipo de Comprobante de Stock: Define una categoria de comprobante utilizada en movimientos de stock
Datos Necesarios
| Campo | Descripcion | Obligatorio |
|---|---|---|
| Codigo | Identificador unico, asignado automaticamente | Si (automatico) |
| Descripcion | Nombre del tipo de comprobante (maximo 50 caracteres) | Si |
| Tipo de movimiento | Indica si es Ingreso (I) o Egreso (E) | Si |
| Imprimir | Indica si el comprobante se imprime (Si/No) | Si |
| Valor | Indica si el comprobante tiene valoracion (Si/No) | Si |
| Control | Indica si el comprobante tiene control (Si/No) | Si |
Relaciones de Negocio
- Los tipos de comprobante de stock se utilizan al registrar movimientos de stock para clasificar la operacion
Validaciones de Negocio
- La descripcion es obligatoria y no puede superar los 50 caracteres
- El tipo de movimiento solo admite los valores Ingreso o Egreso
- La descripcion debe ser unica; no pueden existir dos tipos con el mismo nombre
- Al editar, la unicidad del nombre se valida excluyendo el registro propio
Reglas de Negocio
RN-001: Asignacion automatica de codigo
- Condicion: Al crear un nuevo tipo de comprobante
- Accion: El sistema asigna automaticamente el proximo codigo disponible (siguiente al maximo existente)
RN-002: Unicidad de descripcion
- Condicion: Al crear o editar un tipo de comprobante
- Accion: El sistema verifica que no exista otro tipo con la misma descripcion (sin distinguir mayusculas/minusculas). Si ya existe, rechaza la operacion
RN-003: Registro de auditoria
- Condicion: Al crear o editar un tipo de comprobante
- Accion: El sistema registra automaticamente la operacion en el log de auditoria (quien, cuando, que cambio)
Casos de Uso
Caso de Uso 1: Crear tipo de comprobante de stock
Actor: Usuario administrador de stock
Precondiciones:
- El usuario tiene acceso al modulo de Stock
Flujo principal:
- Usuario accede a la gestion de tipos de comprobante de stock
- Usuario selecciona "Nuevo tipo de comprobante"
- Sistema muestra formulario con los campos: descripcion, tipo de movimiento, imprimir, valor, control
- Usuario completa los datos y confirma
- Sistema valida que la descripcion no este duplicada
- Sistema asigna codigo automaticamente
- Sistema guarda el tipo de comprobante y registra auditoria
- Sistema muestra confirmacion
Flujos alternativos:
- 5a. Descripcion ya existe: Sistema muestra error indicando duplicado, no guarda
Postcondiciones:
- Tipo de comprobante creado y disponible para uso en movimientos de stock
- Auditoria registrada
Caso de Uso 2: Editar tipo de comprobante de stock
Actor: Usuario administrador de stock
Precondiciones:
- El tipo de comprobante existe en el sistema
Flujo principal:
- Usuario accede al listado de tipos de comprobante
- Usuario selecciona un tipo de comprobante para editar
- Sistema muestra formulario con los datos actuales
- Usuario modifica los datos y confirma
- Sistema valida que la nueva descripcion no colisione con otro registro
- Sistema guarda los cambios y registra auditoria
- Sistema muestra confirmacion
Flujos alternativos:
- 5a. Descripcion colisiona con otro registro: Sistema muestra error, no guarda
Postcondiciones:
- Tipo de comprobante actualizado
- Auditoria registrada
Consideraciones
Seguridad
- Solo usuarios autenticados con acceso al modulo de Stock pueden gestionar tipos de comprobante
- Todas las operaciones de creacion y edicion quedan registradas en auditoria
Auditoria
- Creacion de tipo de comprobante: quien creo, cuando, datos ingresados
- Edicion de tipo de comprobante: quien modifico, cuando, que datos cambiaron
Dependencias
Modulos internos
- Movimientos de Stock: Los tipos de comprobante se usan al registrar movimientos de inventario
Criterios de Aceptacion
- [x] El usuario puede consultar el listado completo de tipos de comprobante de stock
- [x] El sistema muestra un listado vacio cuando no hay registros
- [x] El usuario puede crear un nuevo tipo de comprobante con descripcion, tipo de movimiento y opciones
- [x] El sistema asigna automaticamente el codigo al crear
- [x] El sistema rechaza la creacion si la descripcion ya existe
- [x] El sistema rechaza la creacion si faltan campos obligatorios
- [x] El usuario puede editar un tipo de comprobante existente
- [x] El sistema rechaza la edicion si la descripcion colisiona con otro registro
- [x] El sistema registra auditoria en cada creacion y edicion
Notas Adicionales
- Este recurso reemplaza la gestion legacy de tipos de comprobante de stock. El endpoint legacy
backend/mod-stock/tipo-comprobante.phpfue eliminado y reemplazado por las nuevas capas Slim Framework (Route + Controller + Service + Model + DTO) bajo el prefijo/mod-stock/tipo-comprobante - No se contempla la eliminacion de tipos de comprobante en esta version