Unidades Detalles

Descripción general

La pantalla Unidades Detalles permite gestionar las unidades de medida individuales dentro de un grupo de unidades. Cada unidad se define con un código, nombre, una unidad base opcional para conversión, factores de conversión (numerador y denominador), y una unidad SUNAT asociada.

---

Acceso

Navegue a: Logística → Configuración → Grupos de Unidades → clic derecho sobre un grupo → Detalles

Breadcrumb: Logistica > Grupos unidades > Unidades detalles

Ruta: /logistica/grupos-unidades-detalles/\{id\} (donde \{id\} es el ID del grupo de unidades)

---

Vista principal — Tabla de unidades

Al ingresar se muestra el título "Unidades detalles" con el subtítulo "Muestra el listado y las herramientas para gestionar las unidades detalles", seguido de una tabla de datos (p-table) que muestra todas las unidades pertenecientes al grupo seleccionado.

Columnas de la tabla

Columna	Campo	Ordenable	Descripción
Codigo	codigo	Sí	Código identificador de la unidad.
Nombre	nombre	Sí	Nombre de la unidad de medida.
Base	unidad_base.nombre	Sí	Nombre de la unidad base de referencia. Se muestra vacío si no tiene unidad base asignada.
Factor	factor_numerador / factor_denominador	Sí	Factor de conversión expresado como fracción: numerador/denominador.
Unidad sunat	unidad_sunat.nombre	Sí	Nombre de la unidad SUNAT asociada. Se muestra vacío si no tiene asignada.
Acciones	—	No	Ícono de puntos suspensivos (pi pi-ellipsis-h) que despliega el menú contextual.

---

Barra de menú

Opción	Submenú	Ícono	Descripción
Nuevo	Unidad	pi pi-plus	Abre el formulario para crear una nueva unidad.
Actualizar	—	pi pi-refresh	Recarga la lista de unidades desde el servidor.
Exportar a	Excel, PDF, CSV	pi pi-cloud-download	Opciones de exportación.
Eliminar	—	pi pi-trash	Eliminación masiva.

---

Menú contextual

Al hacer clic derecho sobre una fila o al hacer clic en el ícono de puntos suspensivos (⋯) de la columna Acciones:

Opción	Ícono	Descripción
Nuevo	pi pi-plus	Abre el formulario para crear una nueva unidad.
Editar	pi pi-pencil	Abre el formulario de edición con los datos de la unidad seleccionada.
Eliminar	pi pi-times	Abre el diálogo de confirmación para eliminar la unidad seleccionada.

---

Formulario de creación / edición

Al seleccionar Nuevo > 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 > Unidades detalles > Nuevo
  • "Logistica" enlaza a /logistica
  • "Grupos unidades" enlaza a /logistica/grupos-unidades
  • "Unidades detalles" enlaza a /logistica/grupos-unidades/\{id del grupo\}
  • "Nuevo" es texto sin enlace
• Título del formulario: "Nueva unidad"
• Subtítulo: "Aqui puede editar la lista de unidades detalles"
• El diálogo ocupa el 100% del ancho y alto de la pantalla.
• No es arrastrable ni redimensionable.

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
Base	Desplegable (p-dropdown) con filtro y botón limpiar	No	12/12 columnas	"Seleccione una base"	"* Seleccione una base"	Selecciona la unidad base de referencia para la conversión. Muestra todas las unidades del mismo grupo. El nombre de la unidad se usa como etiqueta. Se puede limpiar la selección con el botón ✕.
Codigo	Texto (pInputText)	Sí	2/12 columnas	"Ingrese el codigo"	"* Ingrese el codigo"	Código identificador de la unidad.
Nombre	Texto (pInputText)	Sí	10/12 columnas	"Ingrese el nombre"	"* Ingrese el nombre"	Nombre de la unidad de medida.
Factor numerador	Texto (pInputText)	Sí	6/12 columnas	"Ingrese el factor numerador"	"* Ingrese el factor numerador"	Numerador del factor de conversión respecto a la unidad base.
Factor denominador	Texto (pInputText)	Sí	6/12 columnas	"Ingrese el factor numerador"	"* Ingrese el factor denominador"	Denominador del factor de conversión respecto a la unidad base.
Unidad sunat	Desplegable (p-dropdown) con filtro	Sí	12/12 columnas	"Seleccione una unidad sunat"	"* Seleccione una unidad sunat"	Selecciona la unidad de medida según el catálogo SUNAT. Se carga desde el catálogo global de unidades SUNAT.

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 la unidad. Se deshabilita durante el proceso de guardado.

---

Flujo de creación

---

Flujo de edición

---

Eliminación 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.

Tras confirmar, se muestra la notificación "Eliminado." (tipo éxito, duración 5 segundos).

---

Validaciones del formulario

Escenario	Mensaje	Tipo	Duración
Formulario inválido al guardar	"Revise bien, hay formularios por validar."	Error	5 segundos
Unidad creada exitosamente	"Registrado con exito"	Éxito	5 segundos
Unidad actualizada exitosamente	"Se ha actualizado con exito"	Éxito	5 segundos
Unidad eliminada 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 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/unidades/?search=grupo_unidad_id:\{id\}&from=\{desde\}&size=\{tamaño\}	Obtiene las unidades de un grupo específico.
GET	/v2.0.1/erpx/logistica/unidades/\{id\}	Obtiene una unidad por su ID.
POST	/v2.0.1/erpx/logistica/unidades/	Crea una nueva unidad.
PUT	/v2.0.1/erpx/logistica/unidades/\{id\}	Actualiza una unidad existente.
DELETE	/v2.0.1/erpx/logistica/unidades/\{id\}	Elimina una unidad.
GET	/v2.0.1/erpx/global/unidades-sunat/?search=*&from=0&size=10000	Obtiene el catálogo global de unidades SUNAT.

---

Problemas comunes

Problema	Causa	Solución
No se muestran unidades en la tabla	El grupo de unidades no tiene unidades registradas o error de conexión	Verifique la conexión de red. Use Actualizar en la barra de menú. Asegúrese de haber accedido desde un grupo válido.
El desplegable "Base" está vacío	No hay otras unidades registradas en el mismo grupo	Cree al menos una unidad en el grupo antes de intentar asignar una unidad base.
El desplegable "Unidad sunat" está vacío	Error al cargar el catálogo global de unidades SUNAT	Verifique la conexión de red. Cierre y vuelva a abrir el formulario.
Error "Revise bien, hay formularios por validar."	Campos obligatorios vacíos (Código, Nombre, Factor numerador, Factor denominador o Unidad sunat)	Complete todos los campos marcados como obligatorios.
Las opciones de exportación no hacen nada	La exportación no está implementada en la versión actual	Contacte al administrador del sistema.
No puedo regresar al grupo de unidades	—	Use el breadcrumb "Grupos unidades" en la parte superior del formulario o de la vista principal.

---

Páginas relacionadas

• Grupos de Unidades — Gestión de grupos de unidades de medida.
• Categorías — Categorías jerárquicas de productos y servicios.
• Productos — Catálogo de productos que utilizan unidades de medida.