Davix ERPXGrupos de Unidades
Gestión de grupos de unidades de medida en el módulo de Sistema de Logística Hospitalaria de Davix ERPX.
Descripción general
La pantalla Grupos de Unidades permite gestionar los grupos de unidades de medida utilizados para clasificar productos en el módulo de Sistema de Logística Hospitalaria. Cada grupo se identifica por un código y un nombre, y puede contener múltiples unidades de detalle asociadas.
Acceso
Navegue a: Logística → Configuración → Grupos de Unidades
Breadcrumb: Logistica > Grupos unidades
Vista principal — Tabla de grupos de unidades
Al ingresar se muestra el título "Grupos de Unidades" con el subtítulo "Muestra el listado y las herramientas para gestionar los grupos de unidade", seguido de una tabla de datos (p-table) con carga diferida (lazy loading) y paginación del lado del servidor.
Columnas de la tabla
| Columna | Campo | Ancho | Ordenable | Campo de ordenamiento |
|---|---|---|---|---|
| ☐ (Checkbox) | — | 40px | No | — |
| Codigo | codigo | 150px | Sí | codigo |
| Nombre | nombre | auto | Sí | razon_social |
| Acciones | — | 80px | No | — |
- La columna ☐ permite seleccionar múltiples registros mediante checkboxes.
- La columna Acciones muestra un ícono de puntos suspensivos (
pi pi-ellipsis-h) que al hacer clic despliega el menú contextual. - Las columnas son redimensionables arrastrando los bordes.
Si la tabla no contiene datos, se muestra un ícono de advertencia (pi pi-exclamation-triangle) con el mensaje: "No se encontraron datos".
Paginación
La tabla carga 50 registros por página desde el servidor. En la parte inferior se muestra:
- Etiqueta informativa:
"Mostrando pagina \{página\} con \{registros visibles\} registros de \{total\} entradas" - Controles de navegación:
| Botón | Ícono | Acción |
|---|---|---|
| Primera página | pi pi-angle-double-left | Ir a la primera página. |
| Página anterior | pi pi-angle-left | Retroceder una página. |
| Selector de página | Desplegable (p-dropdown) | Seleccionar una página específica. Muestra opciones como "1 de N", "2 de N", etc. Permite filtrar por número. |
| Página siguiente | pi pi-angle-right | Avanzar una página. |
| Última página | pi pi-angle-double-right | Ir a la última página. |
Barra de menú
La tabla cuenta con una barra de menú superior (p-menubar) con las siguientes opciones:
| Opción | Submenú | Ícono | Descripción |
|---|---|---|---|
| Nuevo | Grupo de unidad | pi pi-plus | Abre el formulario para crear un nuevo grupo de unidad. |
| Actualizar | — | pi pi-refresh | Recarga la lista de grupos desde el servidor. |
| Exportar a | Excel, PDF, CSV | pi pi-cloud-download | Opciones de exportación. |
| Eliminar | — | pi pi-trash | Eliminación masiva. |
Las opciones de Exportar a (Excel, PDF, CSV) y Eliminar desde la barra de menú no están implementadas en la versión actual del sistema.
Menú contextual
Al hacer clic derecho sobre una fila de la tabla, o al hacer clic en el ícono de puntos suspensivos (⋯) de la columna Acciones, se despliega un menú contextual con las siguientes opciones:
| Opción | Ícono | Descripción |
|---|---|---|
| Detalles | pi pi-folder | Navega a la pantalla de Unidades Detalles del grupo seleccionado (/logistica/grupos-unidades-detalles/\{id\}). |
| Nuevo | pi pi-plus | Abre el formulario para crear un nuevo grupo de unidad. |
| Editar | pi pi-pencil | Abre el formulario de edición con los datos del grupo seleccionado. |
| Eliminar | pi pi-times | Abre el diálogo de confirmación para eliminar el grupo seleccionado. |
La opción Detalles permite acceder directamente a las unidades de detalle asociadas al grupo seleccionado, donde se configuran las conversiones y equivalencias entre unidades de medida.
Formulario de creación / edición
Al seleccionar Nuevo > Grupo de unidad desde la barra de menú, Nuevo o Editar desde el menú contextual, se abre un diálogo a pantalla completa (p-dialog) con el formulario.
Encabezado del diálogo
- Título del diálogo:
"Grupo unidad" - Breadcrumb:
Logistica > Grupos unidades > Nuevo- "Logistica" enlaza a
/logistica - "Grupos unidades" enlaza a
/logistica/grupos-unidades - "Nuevo" es texto sin enlace
- "Logistica" enlaza a
- Título del formulario:
"Nuevo grupo unidad" - Subtítulo:
"Aqui puede editar la lista de grupos de unidad" - El diálogo ocupa el 100% del ancho y alto de la pantalla.
- No es arrastrable ni redimensionable.
Mientras se cargan los datos del formulario, se muestra el mensaje "Cargando sus datos" con un ícono de carga giratoria (pi pi-spin pi-spinner).
Sección — Detalles de grupo unidad
Nota del formulario: "Se tiene que rellenar los campos que contengan (*) obligatoriamente que se requiere para el registro."
| Campo | Tipo | Obligatorio | Ancho | Tooltip | Mensaje de error | Descripción |
|---|---|---|---|---|---|---|
| Codigo | Texto (pInputText) | Sí | 4/12 columnas | "Ingrese el codigo de registro" | "* Ingrese codigo valido" | Código identificador del grupo de unidad. |
| Nombre | Texto (pInputText) | Sí | 8/12 columnas | "Ingrese el nombre" | "* Ingrese codigo valido" | Nombre del grupo de unidad. |
Cada campo muestra un ícono de información (pi pi-exclamation-circle) con tooltip al pasar el cursor.
Botones del formulario
| Botón | Ícono | Acción |
|---|---|---|
| Cancelar | pi pi-times | Cierra el diálogo sin guardar cambios. |
| Guardar | pi pi-check (o pi pi-spin pi-spinner mientras guarda) | Valida el formulario y guarda el grupo. Se deshabilita durante el proceso de guardado. |
Flujo de creación
Seleccione "Nuevo > Grupo de unidad" desde la barra de menú
Se abre el diálogo a pantalla completa con todos los campos vacíos.
Complete los campos requeridos
Ingrese el Código y Nombre del grupo de unidad. Ambos campos son obligatorios.
Haga clic en "Guardar"
El sistema valida el formulario. Si es válido, envía una solicitud POST al endpoint /v2.0.1/erpx/logistica/grupos-unidades/.
Confirmación
Se muestra la notificación "Registrado con exito" (tipo éxito, duración 5 segundos). El diálogo se cierra y el nuevo registro aparece al inicio de la tabla.
Flujo de edición
Haga clic derecho sobre un grupo y seleccione "Editar"
Se abre el diálogo con los datos del grupo cargados: código y nombre.
Modifique los campos deseados
Puede cambiar el código o el nombre.
Haga clic en "Guardar"
El sistema valida el formulario y envía una solicitud PUT al endpoint /v2.0.1/erpx/logistica/grupos-unidades/\{id\}.
Confirmación
Se muestra la notificación "Se ha actualizado con exito" (tipo éxito, duración 5 segundos). El diálogo se cierra y el registro se actualiza en la tabla.
Eliminación de grupos de unidades
Al seleccionar Eliminar desde el menú contextual, se abre un diálogo de confirmación.
Diálogo de confirmación
- Título:
"Confirmacion" - Ancho: 50% de la pantalla
- Ícono:
pi pi-exclamation-triangle(tamaño 2rem) - Mensaje:
"Estas seguro de proceder con la eliminacion?" - Modal: Sí (fondo oscurecido)
| Botón | Ícono | Acción |
|---|---|---|
| No | pi pi-times | Cierra el diálogo sin eliminar. |
| Si | pi pi-check (o pi pi-spin pi-spinner mientras elimina) | Ejecuta la eliminación enviando una solicitud DELETE al endpoint. |
Haga clic derecho sobre un grupo y seleccione "Eliminar"
Se abre el diálogo de confirmación.
Confirme la eliminación haciendo clic en "Si"
El sistema envía una solicitud DELETE al endpoint /v2.0.1/erpx/logistica/grupos-unidades/\{id\}.
Confirmación
Se muestra la notificación "Eliminado." (tipo éxito, duración 5 segundos). El diálogo se cierra y el registro se elimina de la tabla.
Validaciones del formulario
| Escenario | Mensaje | Tipo | Duración |
|---|---|---|---|
| Formulario inválido al guardar (campos requeridos vacíos) | "Revise bien, hay formularios por validar." | Error | 5 segundos |
| Grupo creado exitosamente | "Registrado con exito" | Éxito | 5 segundos |
| Grupo actualizado exitosamente | "Se ha actualizado con exito" | Éxito | 5 segundos |
| Grupo eliminado exitosamente | "Eliminado." | Éxito | 5 segundos |
Errores de servidor
| Código HTTP | Mensaje mostrado |
|---|---|
| 400 | "Error de estructura de envio de datos. ERROR 400" |
| 401 / 402 / 403 | 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 de servidor 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/grupos-unidades/?search=\{búsqueda\}&from=\{desde\}&size=\{tamaño\} | Obtiene la lista de grupos de unidades con paginación. |
| GET | /v2.0.1/erpx/logistica/grupos-unidades/\{id\} | Obtiene un grupo por su ID. |
| POST | /v2.0.1/erpx/logistica/grupos-unidades/ | Crea un nuevo grupo de unidad. |
| PUT | /v2.0.1/erpx/logistica/grupos-unidades/\{id\} | Actualiza un grupo existente. |
| DELETE | /v2.0.1/erpx/logistica/grupos-unidades/\{id\} | Elimina un grupo de unidad. |
Problemas comunes
| Problema | Causa | Solución |
|---|---|---|
| No se muestran grupos en la tabla | No hay grupos registrados o error de conexión | Verifique la conexión de red. Use Actualizar en la barra de menú para recargar los datos. |
| Error "Revise bien, hay formularios por validar." | Uno o más campos obligatorios (Código, Nombre) están vacíos | Complete todos los campos marcados con (*) antes de guardar. |
| Las opciones de exportación no hacen nada | La exportación a Excel, PDF y CSV no está implementada en la versión actual | Contacte al administrador del sistema. Esta funcionalidad estará disponible en futuras versiones. |
| No puedo acceder a los detalles del grupo | Error de navegación o permisos insuficientes | Verifique que tiene el perfil adecuado. Intente hacer clic derecho sobre el grupo y seleccione "Detalles". |
Páginas relacionadas
- Unidades Detalles — Detalles y conversiones de unidades de medida dentro de cada grupo.
- Categorías — Categorías jerárquicas de productos y servicios.
- Marcas — Gestión de marcas de productos.
- Productos — Catálogo de productos que utilizan unidades de medida.