Stock de Productos

Descripción general

La pantalla Stock de Productos permite consultar los niveles de stock de productos en los diferentes almacenes. Es una vista de solo lectura que muestra cantidades disponibles, vendidas, retenidas y en tránsito, con funcionalidad de filtrado avanzado y exportación a Excel.

---

Acceso

Navegue a: Logística → Módulos → Stock de Productos

Breadcrumb: Inicio > Logistica > Stocks de productos

---

Vista principal — Tabla de stock

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

Barra de herramientas

Botón	Ícono	Descripción
Exportar	pi pi-file-excel	Abre el diálogo de exportación a Excel. Requiere filtro de fecha activo.
Actualizar	pi pi-refresh	Recarga la tabla de stock.

Filtros de búsqueda

La barra de búsqueda incluye campo de texto libre y botones de gestión de filtros:

Botón	Ícono	Descripción
Agregar filtro	pi pi-filter	Abre panel de filtros avanzados.
Quitar filtros	pi pi-filter-slash	Elimina todos los filtros.
Aplicar filtros	pi pi-search	Ejecuta la búsqueda.

Filtros disponibles

Filtro	Tipo de campo	Formato de consulta	Descripción
Fecha	Rango de fechas (inicio y fin)	fecha:[inicio TO fin]	Filtra por rango de fecha del último movimiento.
Almacén	Desplegable con búsqueda diferida	almacen_id:\{id\}	Filtra por almacén. Muestra nombre, zona y dirección.
Producto	Desplegable con búsqueda diferida	catalogo_producto_id:\{id\}	Filtra por producto específico.

Los filtros activos se muestran como chips removibles. Solo se puede aplicar un filtro de cada tipo.

Columnas de la tabla

Columna	Descripción
FECHA ULTIMO MOVIMIENTO	Fecha y hora del último movimiento del producto en formato DD/MM/YYYY hh:mm:ss A.
ALMACEN	Nombre del almacén donde se encuentra el stock.
PRODUCTO	Nombre del producto.
VALOR UNITARIO PROMEDIO	Valor unitario promedio del producto en stock.
UNIDAD POR DEFECTO	Unidad de medida predeterminada del producto.
CANTIDAD	Cantidad total en stock.
CANTIDAD VENDIDA	Cantidad retenida por ventas pendientes.
CANTIDAD RETENIDA	Cantidad retenida por movimientos en proceso.
CANTIDAD DISPONIBLE	Cantidad efectivamente disponible (= Cantidad - Cantidad vendida - Cantidad retenida).
CANTIDAD EN TRANSITO	Cantidad en proceso de entrega/traslado.

Paginación

50 registros por página. Controles: Primera, Anterior, Selector de página ("X de Y"), Siguiente, Última.

Etiqueta: "Mostrando pagina \{X\} con \{Y\} registros de \{Z\} entradas".

---

Exportación a Excel

Al hacer clic en "Exportar", se abre un diálogo modal para configurar la exportación.

Validaciones previas

Validación	Mensaje de error
Sin filtro de fecha activo	"Tiene que filtrar minimo por la fecha"
Rango de fecha mayor a 3 meses	"El filtro por la fecha tiene como maximo 3 meses para exportaciones"

Diálogo de exportación

• Título: "EXPORTAR A EXCEL"
• Ancho: 50% de la pantalla
• Modal: Sí

Campo	Tipo	Descripción
Customizar nombre de archivo	Texto con botón de reinicio	Nombre del archivo Excel. Valor por defecto: stock-\{timestamp\}. El botón de reinicio restaura el valor por defecto.
Exportar	Desplegable	Tipo de exportación. Opción disponible: "LISTA DE STOCK". Tooltip: "Seleccione la exportacion a realizar."

Botón	Acción
No	Cierra el diálogo sin exportar.
Si	Genera y descarga el archivo Excel. Muestra spinner durante la generación.

Columnas del archivo Excel

Columna
Fecha de ultimo movimiento
Almacen
Producto
Valor unitario promedio
Unidad por defecto
Cant.
Cant. vendida
Cant. retenida
Cant. disponible
Cant. en transito

---

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."

Todos los errores se muestran como notificación de tipo error con duración de 5 segundos.

---

Endpoints de la API

Método	Endpoint	Descripción
GET	/v2.0.1/erpx/logistica/stocks-productos/?search=\{búsqueda\}&from=\{desde\}&size=\{tamaño\}	Lista stock de productos con paginación y filtros.
GET	/v2.0.1/erpx/logistica/catalogos-productos/?search=\{búsqueda\}	Busca productos para el filtro.
GET	/v2.0.1/erpx/global/elementos-infraestructuras/?search=tipo:3	Obtiene almacenes para el filtro.

---

Problemas comunes

Problema	Causa	Solución
No se muestran datos de stock	No hay productos con stock o los filtros son muy restrictivos	Quite los filtros y actualice. Verifique que existan movimientos de almacén registrados.
Error al exportar: "Tiene que filtrar minimo por la fecha"	No hay filtro de fecha activo	Agregue un filtro de Fecha antes de exportar.
Error al exportar: rango mayor a 3 meses	El rango de fechas excede 90 días	Reduzca el rango de fechas a máximo 3 meses.
El filtro de almacén no muestra opciones	Error de conexión o no hay almacenes configurados	Verifique la conexión. Asegúrese de que existan elementos de infraestructura de tipo almacén.
Las opciones de exportar a PDF y CSV no hacen nada	No están implementadas en la versión actual	Use la exportación a Excel.

---

Páginas relacionadas

• Movimientos de Almacén — Gestión de movimientos entre almacenes.
• Recepciones de Compras — Recepción de mercadería.
• Salidas de Almacén — Salidas de productos del almacén.
• Productos Principal — Catálogo de productos.