Cajas Diario Movimientos

Gestion de movimientos de ingreso y egreso dentro de una caja diario, con registro detallado de metodos de pago, origenes, destinos y baja de movimientos.

Que son los Movimientos de Cajas Diario

El modulo Cajas Diario Movimientos permite gestionar todos los movimientos financieros (ingresos y egresos) que ocurren dentro de una caja diario especifica. Cada movimiento registra el tipo de operacion, el metodo de pago, el monto, el cajero responsable, el origen y destino del dinero, y un motivo descriptivo.

Se accede a esta pantalla desde el modulo Cajas Diario, seleccionando la opcion "Detalles" en el menu contextual de una caja en estado APERTURA.

Ruta de navegacion: Inicio > Cajas > Movimientos

Estados de un movimiento

Cada movimiento tiene un estado que indica si esta activo o fue dado de baja:

Estado	Valor	Color del badge	Descripcion
Valido	0	Verde (`success`)	El movimiento esta activo y vigente.
Baja	4	Rojo (`danger`)	El movimiento fue dado de baja y ya no es operativo.

Cualquier otro valor de estado se muestra como "Desconocido" con badge de color azul (info).

Pantalla principal: lista de movimientos

Descripcion general

La pantalla muestra el titulo "Lista de movimientos" con la descripcion "Muestra el listado y las herramientas para gestionar los movimientos de cajas".

Barra de herramientas

En la parte superior derecha se encuentran tres botones:

Boton	Icono	Estilo	Descripcion
Actualizar	`pi pi-refresh`	Gris outlined	Recarga la tabla con los datos mas recientes del servidor.
Nuevo Ingreso	`pi pi-arrow-up`	Verde (`p-button-success`)	Abre el formulario para registrar un nuevo movimiento de ingreso.
Nuevo Egreso	`pi pi-arrow-down`	Rojo (`p-button-danger`)	Abre el formulario para registrar un nuevo movimiento de egreso.

Columnas de la tabla principal

La tabla tiene las siguientes columnas, todas con soporte de ordenamiento (sort):

#	Columna	Ancho	Ordenable	Descripcion
1	Fecha	150px	Si	Fecha y hora del movimiento. Formato: `DD/MM/YYYY hh:mm:ss AM/PM`.
2	Tipo	150px	Si	Tipo de movimiento: `INGRESO` o `EGRESO`.
3	Tipo activo	130px	Si	Metodo de pago utilizado: EFECTIVO, TARJETA, DEPOSITO EN CUENTA, TRANSFERENCIA o MONEDERO ELECTRONICO.
4	Motivo	Flexible	Si	Texto descriptivo del motivo del movimiento. Puede ser "APERTURA", "CIERRE" o un motivo personalizado.
5	Monto total	150px	Si	Monto total del movimiento.
6	Cajero	200px	Si	Responsable del movimiento. Se muestra como inicial del nombre + apellido paterno en mayusculas (ej: "CTAPIA").
7	Origen	200px	Si	Persona o entidad de donde proviene el dinero. Si es un colaborador registrado, muestra su nombre completo. Si es externo, muestra el texto ingresado manualmente.
8	Destino	200px	Si	Persona o entidad a donde va el dinero. Misma logica que Origen.
9	Estado	130px	Si	Badge de color que muestra "Valido" (verde) o "Baja" (rojo).
10	Acciones	80px	No	Icono de tres puntos horizontales (`pi pi-ellipsis-h`) que despliega el menu contextual. Centrado.

La tabla soporta seleccion multiple de filas. Se puede seleccionar varias filas usando Ctrl+clic o Shift+clic. Tambien se puede hacer clic derecho para abrir el menu contextual directamente.

Paginacion

La tabla incluye un sistema de paginacion con los siguientes controles:

Texto informativo: "Mostrando pagina {X} con {Y} registros de {Z} entradas"
Boton Primera pagina (pi pi-angle-double-left)
Boton Pagina anterior (pi pi-angle-left)
Selector de pagina: dropdown que muestra "1 de N"
Boton Pagina siguiente (pi pi-angle-right)
Boton Ultima pagina (pi pi-angle-double-right)

Tamano de pagina por defecto: 50 registros.

Si no hay registros, se muestra: "No se encontraron datos" con icono de advertencia.

El menu contextual aparece al hacer clic derecho sobre una fila o al hacer clic en el icono de tres puntos de la columna ACCIONES. Tiene una unica opcion disponible para todos los movimientos:

Opcion	Icono	Descripcion
Dar de Baja	`pi pi-trash`	Abre el dialogo de confirmacion para dar de baja el movimiento seleccionado.

Filtros de busqueda

Busqueda por texto libre

Campo de texto con icono de lupa (pi pi-search). Al presionar Enter se ejecuta la busqueda.

Filtros avanzados

Al hacer clic en "Agregar filtro" se abre un panel overlay con los siguientes tipos de filtro:

#	Filtro	Campos que muestra	Descripcion
1	Fecha	Fecha inicio + Fecha fin	Filtra movimientos por rango de fechas. Ambos campos son obligatorios. Formato: selector de fecha (`date`).
2	Tipo	Dropdown con opciones	Filtra por tipo de movimiento: Ingreso o Egreso.
3	Tipo Activo	Dropdown con opciones	Filtra por metodo de pago: Efectivo, Tarjeta, Deposito en cuenta, Transferencia o Monedero electronico.
4	Cajero	Autocomplete con busqueda	Filtra por cajero responsable. Muestra nombre, tipo y numero de documento. Se puede buscar escribiendo.

Botones de filtros

Boton	Icono	Descripcion
Agregar filtro	`pi pi-filter`	Abre el panel overlay para configurar un nuevo filtro.
Quitar filtros	`pi pi-filter-slash`	Elimina todos los filtros activos.
Buscar	`pi pi-search`	Ejecuta la busqueda con los filtros activos.

Los filtros activos se muestran como chips con boton X para eliminarlos individualmente. Al hacer clic sobre un chip se puede editar el filtro existente.

Botones dentro del panel overlay:

Aplicar filtro: guarda el filtro y ejecuta la busqueda
Cancelar: cierra el panel sin aplicar cambios

Formulario de nuevo ingreso

Al hacer clic en "Nuevo Ingreso", se abre un dialogo a pantalla completa con el titulo "Registro de Ingreso Financiero".

El formulario muestra el mensaje: "Complete los datos para registrar un movimiento" y la nota "() Son obligatorios."*

Cajero(a)

Dropdown con busqueda para seleccionar el cajero responsable. El campo esta visualmente deshabilitado (p-disabled) y se pre-selecciona con el usuario actual.

Tooltip: "Seleccione el responsable"
Placeholder: SELECCIONE
Busqueda en tiempo real al escribir
Error: " Seleccione el responsable"*

Fecha

Muestra la fecha de apertura de la caja con un selector de solo hora (timeOnly). Formato visible: DD/MM/YYYY como label + selector de hora con segundos.

Tooltip: "Seleccione la hora"
Icono del calendario: reloj (pi pi-clock)

Responsable de origen

Seccion con fieldset titulado "Responsable de origen". Indica de donde proviene el dinero.

Tiene dos opciones mediante radio buttons:

Opcion	Descripcion
Colaborador (por defecto)	Muestra un dropdown con la lista de todos los colaboradores del sistema. Se puede buscar por nombre.
Otros	Muestra un textarea para ingresar manualmente el nombre o descripcion del origen. Maximo 250 caracteres con contador de caracteres restantes.

Validaciones:

Si se selecciona Colaborador: el dropdown es obligatorio. Error: " Seleccione el origen del ingreso"*
Si se selecciona Otros: el textarea es obligatorio. Error: " Ingrese el responsable de destino"*

Responsable de destino

Seccion con fieldset titulado "Responsable de destino". Indica a donde va el dinero.

Funciona exactamente igual que el Responsable de origen:

Opcion	Descripcion
Colaborador (por defecto)	Dropdown con lista de colaboradores.
Otros	Textarea de hasta 250 caracteres con contador.

Validaciones:

Si se selecciona Colaborador: el dropdown es obligatorio. Error: " Seleccione el destino de monto"*
Si se selecciona Otros: el textarea es obligatorio. Error: " Ingrese el responsable de destino"*

Tipo ingreso

Dropdown para seleccionar el metodo de pago. Obligatorio.

#	Tipo de cobro	Valor interno
1	Efectivo	`EFECTIVO`
2	Tarjeta	`TARJETA`
3	Deposito en cuenta	`DEPOSITO EN CUENTA`
4	Transferencia	`TRANSFERENCIA`
5	Monedero electronico	`MONEDERO ELECTRONICO`

Tooltip: "Seleccione el tipo de cobro"
Error: " Seleccione el tipo de monto"*
Al cambiar de tipo, se resetean los campos: tarjeta_tipo, numero_referencia, verificado, banco_nombre, monedero_nombre

Monto ingreso

Campo numerico decimal obligatorio. Formato con 2 decimales, locale ES-PE.

Tooltip: "Ingrese el Monto"
Error: " Ingrese el monto recibido"*
Al hacer foco, se selecciona automaticamente todo el texto para facilitar la edicion

Campos condicionales (solo si el tipo NO es Efectivo)

Si el tipo de cobro seleccionado es diferente a Efectivo, aparecen tres campos adicionales:

Monto tipo

Dropdown que cambia segun el tipo de cobro seleccionado:

Tipo de cobro	Opciones del dropdown
Tarjeta	Debito, Credito
Deposito en cuenta	Lista de 17 bancos
Transferencia	Lista de 17 bancos
Monedero electronico	Yape, Plin, IzipayYA, Agora PAY, Bim

Tooltip: "Seleccione el tipo de monto"
Error: " Seleccione metodo de pago"*

Numero de referencia

Campo de texto enmascarado que acepta hasta 22 digitos numericos.

Tooltip: "Marque la validacion"
Error: " Ingrese el numero de referencia"*

Monto verificado?

Checkbox con la etiqueta "Confirmar validacion del monto".

Tooltip: "Seleccione si el monto ha sido verificado de acuerdo al tipo de cobro realizado."
Error: " Seleccione la validacion del monto"*

Los 17 bancos y 5 monederos electronicos disponibles son los mismos que en el modulo Cajas Diario. Consulta esa pagina para la lista completa.

Motivo

Campo de texto obligatorio (textarea) con maximo 200 caracteres. Muestra un contador de caracteres restantes que se pone en rojo cuando quedan 20 o menos.

Tooltip: "Ingrese el motivo"
Error: " Ingrese el motivo"*

Guardar ingreso

Al hacer clic en "Guardar":

Se validan todos los campos obligatorios
Si hay errores: se muestra "Revise bien, hay formularios por validar." y los campos invalidos se resaltan en rojo
Si todo es valido: se crea el movimiento con tipo INGRESO
Mensaje de exito: "Se ha registrado con exito"
El dialogo se cierra y el movimiento aparece al inicio de la tabla

Botones del formulario (fijos en la parte inferior):

Boton	Icono	Descripcion
Cancelar	`pi pi-times`	Cierra el dialogo sin guardar.
Guardar	`pi pi-check`	Valida y guarda el movimiento. Se deshabilita mientras se procesa.

Formulario de nuevo egreso

Al hacer clic en "Nuevo Egreso", se abre un dialogo a pantalla completa con el titulo "Registro de Egreso Financiero".

El formulario de egreso es identico al formulario de ingreso en estructura y campos. La unica diferencia es que el movimiento se guarda con tipo EGRESO en lugar de INGRESO. Todos los campos, validaciones, listas de opciones y comportamientos son exactamente los mismos.

Dar de baja un movimiento

Al seleccionar "Dar de Baja" en el menu contextual:

Se abre un dialogo pequeno (30% del ancho y alto de pantalla) con el titulo "Notificacion"
Se muestra el mensaje: "Estas seguro de dar de baja a {TIPO} de {MONTO_TOTAL}"
- Donde \{TIPO\} es INGRESO o EGRESO
- Y \{MONTO_TOTAL\} es el monto del movimiento
Dos botones:
- Cancelar (pi pi-times): cierra el dialogo sin hacer cambios
- Aceptar (pi pi-check): confirma la baja

Al confirmar:

El estado del movimiento cambia a 4 (Baja)
El movimiento se actualiza en la tabla con el badge rojo "Baja"
Si hay error, se muestra un mensaje con el detalle

La baja de un movimiento es una operacion de cambio de estado (patch), no una eliminacion fisica. El movimiento sigue visible en la tabla pero con estado "Baja" en rojo.

Mensajes del sistema

Mensajes de exito

Mensaje	Contexto
"Se ha registrado con exito"	Movimiento de ingreso o egreso creado correctamente.

Mensajes de error

Mensaje	Contexto
"Revise bien, hay formularios por validar."	Campos obligatorios sin completar al intentar guardar.
" Seleccione el responsable"*	Campo Cajero(a) vacio.
" Seleccione el origen del ingreso"*	No se selecciono responsable de origen (modo Colaborador).
" Ingrese el responsable de destino"*	No se ingreso texto de origen/destino (modo Otros).
" Seleccione el destino de monto"*	No se selecciono responsable de destino (modo Colaborador).
" Seleccione el tipo de monto"*	No se selecciono tipo de cobro.
" Ingrese el monto recibido"*	Campo de monto vacio.
" Seleccione metodo de pago"*	No se selecciono subtipo (tarjeta, banco, monedero).
" Ingrese el numero de referencia"*	Numero de referencia vacio (para pagos no efectivo).
" Seleccione la validacion del monto"*	Checkbox de verificacion no marcado.
" Ingrese el motivo"*	Campo motivo vacio.
"Error de estructura de envio de datos. ERROR 400"	Error en los datos enviados al servidor.
"No se encontro el servidor de respuestas, consulte con el Administrador. ERROR 404"	Servidor no responde.
"Error interno del servidor. ERROR 500"	Error interno del servidor.

Problemas comunes y soluciones

Problema	Causa probable	Solucion
No aparecen los campos de referencia y verificacion	El tipo de cobro seleccionado es Efectivo	Estos campos solo se muestran para tipos diferentes a Efectivo (Tarjeta, Deposito, Transferencia, Monedero).
El campo Cajero esta deshabilitado	Es el comportamiento normal	El cajero se pre-selecciona con el usuario actual y no se puede cambiar manualmente.
No puedo ver los movimientos de otra caja	Cada vista es por caja especifica	Los movimientos mostrados corresponden unicamente a la caja diario desde la cual se accedio. Para ver otra caja, regrese a la lista de Cajas Diario y seleccione "Detalles" en la caja deseada.
El movimiento aparece como "Baja" pero necesito reactivarlo	La baja es un cambio de estado	Actualmente no hay opcion de reactivar un movimiento dado de baja desde la interfaz. Contacte al administrador del sistema.
El contador de caracteres del motivo se pone rojo	Quedan 20 caracteres o menos	Es una alerta visual. El maximo es 200 caracteres. Acorte el texto si necesita mas espacio.
No puedo ordenar la tabla	La tabla debe tener datos	El ordenamiento solo funciona si hay registros. Haga clic en el encabezado de cualquier columna para ordenar ascendente/descendente.
Error al guardar con campos de origen/destino	Seleccione correctamente el modo	Si tiene seleccionado "Colaborador", debe elegir un colaborador del dropdown. Si tiene seleccionado "Otros", debe ingresar texto en el textarea. No deje ambos vacios.

Relacion con otros modulos

Modulo relacionado	Relacion
Cajas Diario	Modulo padre. Desde ahi se accede a los movimientos de una caja especifica mediante la opcion "Detalles" del menu contextual.
Mis Cajas Diario	Vista personal del cajero. Tambien permite acceder a los movimientos de sus propias cajas.
Cobros / Cobros Ventas	Los cobros registrados pueden reflejarse como movimientos de ingreso en las cajas diario.