Movimientos de Almacén

Gestión de movimientos y traslados de productos entre almacenes en el módulo de Sistema de Logística Hospitalaria de Davix ERPX.

Descripción general

La pantalla Movimientos de Almacenes permite gestionar los traslados de productos entre almacenes. Cada movimiento registra un origen, un destino, los productos trasladados con sus cantidades y valores, y pasa por un flujo de estados desde su creación hasta su cierre.

Acceso

Navegue a: Logística → Módulos → Movimientos de Almacén

Breadcrumb: Inicio > Logistica > Movimientos de almacenes

Vista principal — Tabla de movimientos

Al ingresar se muestra el título "Movimientos de almacenes" con el subtítulo "Muestra el listado y las herramientas para gestionar los movimientos de almacenes", seguido de un panel de filtros y la tabla de movimientos.

Barra de herramientas

Botón	Ícono	Descripción
Actualizar	`pi pi-refresh`	Recarga la lista.
Nuevo	`pi pi-plus`	Crea un nuevo movimiento de almacén.

Filtros de búsqueda

Campo de texto libre + botones de filtros avanzados.

Filtros disponibles

Filtro	Tipo de campo	Descripción
Fecha	Rango de fechas	Filtra por rango de fecha del movimiento.
Serie	Texto	Filtra por serie del documento.
Número	Texto	Filtra por número del documento.
Responsable	Desplegable de colaboradores	Filtra por responsable del movimiento.
Motivos	Selección múltiple	Filtra por uno o más motivos de movimiento.
Origen	Desplegable de almacenes	Filtra por almacén de origen.
Destino	Desplegable de almacenes	Filtra por almacén de destino.
Estados	Selección múltiple	Filtra por uno o más estados.

Columnas de la tabla

Columna	Descripción
FECHA	Fecha y hora del movimiento en formato `DD/MM/YYYY hh:mm A`.
NUMERO	Serie y número del documento (ej. `MA - 0001`).
RESPONSABLE	Nombre completo del responsable (apellidos y nombres).
MOTIVO	Motivo del movimiento. Si el motivo es "OTRO", muestra el texto personalizado.
ORIGEN	Nombre del almacén de origen.
DESTINO	Nombre del almacén de destino.
PRODUCTOS	Cantidad total de productos contabilizados.
ESTADO	Badge de estado con color según el flujo de estados.
ACCIONES	Menú contextual (`pi pi-ellipsis-h`).

Estados del movimiento

Estado	Nombre	Color
0	NUEVO	Azul (`#2196F3`)
1	CON ERRORES	Amarillo (`#fffc58`, texto negro)
2	PROCESADO	Verde (`#26bf00`)
3	CERRADO	Naranja (`#f57f12`)
4	BAJA	Rojo (`#f32121`)

Menú contextual (varía según estado)

Estado	Opciones disponibles
NUEVO (0)	Ver detalles, Verificar, Baja, Registro de actividades
CON ERRORES (1)	Ver detalles, Verificar, Baja, Registro de actividades
PROCESADO (2)	Ver detalles, Cerrar, Baja, Registro de actividades
CERRADO (3)	Ver detalles, Registro de actividades
BAJA (4)	Ver detalles, Quitar baja, Registro de actividades

Paginación

50 registros por página con controles estándar.

Formulario de creación / edición

Al hacer clic en "Nuevo" o "Editar", se abre un diálogo a pantalla completa.

Encabezado

Título: "Nueva movimiento de almacen"
Subtítulo: "Aqui puede editar la lista de movimiento de almacen"

Sección 1 — Datos generales

Campo	Tipo	Obligatorio	Descripción
Serie	Texto (solo lectura)	Sí	Serie del documento. Se carga automáticamente desde la configuración del sistema.
Numero	Texto (solo lectura)	No	Número correlativo. Placeholder: `"Automatico"`. Se genera al guardar.
Fecha	Calendario con hora (`p-calendar`, formato 12h)	Sí	Fecha y hora del movimiento. Formato: `dd/mm/yy`. Valor por defecto: fecha y hora actual.
Tipo	Desplegable (deshabilitado)	Sí	Tipo de movimiento. Fijo en `"TRASLADO"`.
Motivo	Desplegable	Sí	Motivo del movimiento.
Motivo otro	Texto	Condicional	Solo editable cuando el motivo es `"OTRO"`. De lo contrario, solo lectura.
Responsable	Desplegable de colaboradores con filtro	Sí	Responsable del movimiento. Se pre-selecciona con el usuario actual. Muestra número de documento, apellidos y nombres.
Origen	Desplegable de almacenes con filtro	Sí	Almacén de origen. Muestra nombre, zona y dirección.
Destino	Desplegable de almacenes con filtro	Sí	Almacén de destino. Muestra nombre, zona y dirección.

Motivos disponibles

Motivo
BIENES EN PRESTAMO
BIENES EN CUSTODIA
SUSTITUCION DE BIEN SINIESTRADO
TRANSFERENCIA ENTRE ALMACENES
IDENTIFICACION ERRONEA
OTRO

El Origen y el Destino deben ser diferentes. Si selecciona el mismo almacén en ambos campos, se muestra el error: "Debe ser diferente al destino" / "Debe ser diferente al origen".

Sección 2 — Detalle de productos

Tabla editable para agregar los productos a trasladar.

Columna	Tipo	Descripción
Concepto	Desplegable con búsqueda (`p-dropdown`)	Producto a trasladar. Muestra `código - nombre` y en el desplegable muestra STOCK disponible y Valor Unitario Promedio. Se filtra por almacén de origen.
Unidad	Desplegable	Unidad de medida del producto. Se carga automáticamente al seleccionar el producto.
Cantidad	Número (`p-inputNumber`, hasta 10 decimales, locale `es-PE`)	Cantidad a trasladar. Mínimo: 1. Máximo: cantidad en stock disponible.
V.U.	Solo lectura	Valor unitario calculado automáticamente según el factor de conversión de la unidad.
V.T.	Solo lectura	Valor total = Valor unitario × Cantidad.
Observaciones	Chips	Observaciones del producto. Se agregan mediante un panel emergente con área de texto. Se muestran como chips removibles.
Acciones	Botón eliminar	`pi pi-trash` para quitar el producto de la lista. Deshabilitado para registros existentes en modo edición.

Botón "Agregar producto" (pi pi-plus): Agrega una fila vacía. Se deshabilita si no se ha seleccionado un almacén de origen.

La cantidad máxima de cada producto está limitada por el stock disponible en el almacén de origen. Si ingresa una cantidad mayor, se muestra: "MAX: {cantidad máxima}".

Sección 3 — Documentos relacionados

Tabla editable para registrar documentos asociados al movimiento.

Campo	Tipo	Obligatorio	Descripción
Fecha	Calendario (`p-calendar`)	Sí	Fecha del documento.
Tipo documento	Desplegable	Sí	Tipo de documento (cargado desde parámetros del sistema).
Serie	Texto	Sí	Serie del documento.
Número	Texto	Sí	Número del documento.

Botón "Agregar un documento relacionado": Agrega una fila vacía.

Sección 4 — Opciones de cierre

Campo	Tipo	Descripción
Desea generar la entrada y salida?	Interruptor (`p-inputSwitch`)	Cuando está activado, al guardar se generan automáticamente un registro de entrada en el almacén destino y un registro de salida del almacén origen, y el movimiento pasa a estado PROCESADO.

Botones del formulario

Botón	Ícono	Acción
Cancelar	`pi pi-times`	Cierra sin guardar.
Guardar	`pi pi-check` (o spinner)	Valida y guarda el movimiento.

Flujo de creación

Haga clic en "Nuevo"

Se abre el diálogo con la serie pre-cargada, fecha actual y tipo "TRASLADO".

Complete los datos generales

Seleccione Motivo, Responsable, Origen y Destino (deben ser almacenes diferentes).

Agregue productos

Haga clic en "Agregar producto" y seleccione el producto, unidad y cantidad. Los valores unitarios y totales se calculan automáticamente.

Agregue documentos relacionados (opcional)

Registre cualquier documento asociado al movimiento.

Configure opciones de cierre (opcional)

Active el interruptor "Desea generar la entrada y salida?" para procesar automáticamente el movimiento.

Haga clic en "Guardar"

Se muestra "Registro exitoso." (éxito, 5 segundos).

Vista de detalle

Al seleccionar "Ver detalles" desde el menú contextual, se abre un diálogo a pantalla completa de solo lectura con:

Datos del encabezado

Serie, Número, Fecha, Responsable, Motivo, Origen y Destino.

Tabla de productos

Columna	Descripción
VERIFICADO	SI o NO.
PRODUCTO	Nombre del producto.
UNIDAD	Unidad de medida.
CANTIDAD	Cantidad trasladada.
VALOR UNITARIO	Valor unitario del producto.
VALOR TOTAL	Valor total.
CANT. CONTABILIZADA	Cantidad contabilizada.
CANT. CORRECTA	Cantidad verificada como correcta.
CANT. OBSERVADA	Cantidad con observaciones.
OBSERVACIONES	Chips de observaciones (no removibles).

Tabla de documentos relacionados

Fecha, Tipo documento, Serie, Número.

Cambio de estado

Al seleccionar opciones de cambio de estado desde el menú contextual, se abre un diálogo de confirmación:

Acción	Mensaje de confirmación
Verificar	`"Estas seguro de proceder a cambiar el estado a VERIFICADO CORRECTAMENTE?"`
Cerrar	`"Estas seguro de proceder a cambiar el estado a CERRADO?"`
Baja	`"Estas seguro de proceder a cambiar el estado BAJA?"`
Quitar baja	`"Estas seguro de proceder a quitar el estado de BAJA?"`

Tras confirmar: "Estado actualizado." (éxito, 5 segundos). Se actualiza el estado mediante solicitud PATCH.

Eliminación

Diálogo de confirmación modal:

Mensaje: "Estas seguro de proceder con la eliminacion?"
Tras confirmar: "Eliminado." (éxito, 5 segundos).

Validaciones del formulario

Escenario	Mensaje	Tipo	Duración
Campos obligatorios vacíos	`"Revise bien, hay formularios por validar."`	Error	5 segundos
Origen igual al destino	`"Debe ser diferente al destino"` / `"Debe ser diferente al origen"`	Error (campo)	—
Cantidad excede stock	`"MAX: \{valor\}"`	Error (campo)	—
Movimiento creado	`"Registro exitoso."`	Éxito	5 segundos
Movimiento actualizado	`"Actualizacion exitosa."`	Éxito	5 segundos
Estado actualizado	`"Estado actualizado."`	Éxito	5 segundos
Movimiento eliminado	`"Eliminado."`	Éxito	5 segundos

Errores de servidor

Código HTTP	Mensaje mostrado
400 / 402	Muestra el mensaje de error devuelto por el servidor.
404	`"No se encontro el servidor de respuestas, consulte con el Administrador. ERROR 404"`
500	`"Error interno del servidor. ERROR 500"`
Otro	`"Error 404 consulte con su admin."`

Endpoints de la API

Método	Endpoint	Descripción
GET	`/v2.0.2/erpx/logistica/movimientos-productos/?search=\{búsqueda\}&from=\{desde\}&size=\{tamaño\}`	Lista movimientos con filtros.
GET	`/v2.0.2/erpx/logistica/movimientos-productos/\{id\}`	Obtiene un movimiento por ID.
POST	`/v2.0.2/erpx/logistica/movimientos-productos/`	Crea un movimiento.
PUT	`/v2.0.2/erpx/logistica/movimientos-productos/\{id\}`	Actualiza un movimiento.
PATCH	`/v2.0.2/erpx/logistica/movimientos-productos/\{id\}`	Actualiza parcialmente (cambio de estado).
DELETE	`/v2.0.2/erpx/logistica/movimientos-productos/\{id\}`	Elimina un movimiento.
POST	`/v2.0.1/erpx/logistica/stocks-productos/entradas/`	Registra entrada de stock.
POST	`/v2.0.1/erpx/logistica/stocks-productos/salidas/`	Registra salida de stock.

Problemas comunes

Problema	Causa	Solución
No se muestran movimientos	No hay movimientos registrados o filtros restrictivos	Quite los filtros y actualice.
El botón "Agregar producto" está deshabilitado	No se ha seleccionado un almacén de origen	Seleccione primero el almacén de Origen.
Error "Debe ser diferente al destino"	Origen y destino son el mismo almacén	Seleccione almacenes diferentes para origen y destino.
Cantidad máxima limitada	El stock disponible en el origen es insuficiente	Verifique el stock disponible en Stock de Productos.
No puedo editar productos existentes	Los productos de registros guardados se muestran como solo lectura	Esto es el comportamiento esperado. Solo puede agregar nuevos productos.

Páginas relacionadas

Stock de Productos — Consulta de niveles de stock.
Recepciones de Compras — Recepción de mercadería.
Salidas de Almacén — Salidas de productos.