Marcas

Descripción general

La pantalla Marcas permite gestionar las marcas asociadas a los productos del módulo de Sistema de Logística Hospitalaria. Desde esta vista puede listar, crear, editar y eliminar marcas, cada una identificada por un código, nombre y descripción.

---

Acceso

Navegue a: Logística → Configuración → Marcas

Breadcrumb: Logistica > Marcas

---

Vista principal — Tabla de marcas

Al ingresar se muestra el título "Marcas" con el subtítulo "Muestra el listado y las herramientas para gestionar las marcas", 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.

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	Marca	pi pi-plus	Abre el formulario para crear una nueva marca.
Actualizar	—	pi pi-refresh	Recarga la lista de marcas desde el servidor.
Exportar a	Excel, PDF, CSV	pi pi-cloud-download	Opciones de exportación.
Eliminar	—	pi pi-trash	Eliminación masiva (sin implementar).

---

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
Nuevo	pi pi-plus	Abre el formulario para crear una nueva marca.
Editar	pi pi-pencil	Abre el formulario de edición con los datos de la marca seleccionada.
Eliminar	pi pi-times	Abre el diálogo de confirmación para eliminar la marca seleccionada.

---

Formulario de creación / edición

Al seleccionar Nuevo > Marca 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

• Breadcrumb: Logistica > Marcas > Nuevo
  • "Logistica" enlaza a /logistica
  • "Marcas" enlaza a /logistica/marcas
  • "Nuevo" es texto sin enlace
• Título: "Nueva marca"
• Subtítulo: "Aqui puede editar la lista de marcas"
• El diálogo ocupa el 100% del ancho y alto de la pantalla.
• No es arrastrable ni redimensionable.

Sección — Detalles de marca

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 de la marca.
Nombre	Texto (pInputText)	Sí	8/12 columnas	"Ingrese el nombre"	"* Ingrese el nombre"	Nombre de la marca.
Descripción	Área de texto (pInputTextarea, autoResize, 5 filas)	Sí	12/12 columnas	"Ingrese la descripcion"	"* Ingrese la descripcion"	Descripción detallada de la marca. Campo de texto multilínea con redimensionado automático.

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

---

Flujo de creación

---

Flujo de edición

---

Eliminación de marcas

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.

---

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
Marca creada exitosamente	"Registrado con exito"	Éxito	5 segundos
Marca actualizada exitosamente	"Se ha actualizado con exito"	Éxito	5 segundos
Marca 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 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/marcas/?search=\{búsqueda\}&from=\{desde\}&size=\{tamaño\}	Obtiene la lista de marcas con paginación.
GET	/v2.0.1/erpx/logistica/marcas/\{id\}	Obtiene una marca por su ID.
POST	/v2.0.1/erpx/logistica/marcas/	Crea una nueva marca.
PUT	/v2.0.1/erpx/logistica/marcas/\{id\}	Actualiza una marca existente.
DELETE	/v2.0.1/erpx/logistica/marcas/\{id\}	Elimina una marca.

---

Problemas comunes

Problema	Causa	Solución
No se muestran marcas en la tabla	No hay marcas registradas 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, Descripción) 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.
Error 400 al guardar	Los datos enviados tienen un formato incorrecto	Verifique que todos los campos contengan datos válidos y vuelva a intentar.
Error 500 al guardar	Error interno del servidor	Reintente la operación. Si el error persiste, contacte al administrador del sistema.

---

Páginas relacionadas

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