Catálogos Servicios Detalles

Descripción general

La pantalla Catálogos Servicios Detalle permite gestionar los servicios individuales dentro de un catálogo de tipo SERVICIO específico. Se accede navegando desde la pantalla de Catálogos de Productos al seleccionar "Detalle" en un catálogo de tipo SERVICIO.

---

Acceso

Navegue a: Logística → Módulos → Catálogos de Productos → clic derecho sobre un catálogo SERVICIO → Detalle

Breadcrumb: Logistica > Catalogos servicios detalles

Ruta: /logistica/catalogos-servicios-detalles/\{id\} (donde \{id\} es el ID del catálogo)

---

Vista principal — Tabla de servicios

Al ingresar se muestra el título "Catalogos servicios detalle" con el subtítulo "Muestra el listado y las herramientas para gestionar los catalogos servicios detalle", seguido de una barra de búsqueda y una tabla de servicios del catálogo seleccionado.

Barra de herramientas

Botón	Ícono	Estilo	Descripción
Actualizar	pi pi-refresh	Contorno	Recarga la lista de servicios.
Grupos	—	Primario	Abre el diálogo de gestión de grupos/familias.
Nuevo servicio	pi pi-plus	Primario	Abre el formulario para crear un nuevo servicio.

Búsqueda y filtros

• Campo de búsqueda: Texto libre para buscar servicios.
• Agregar filtro (pi pi-filter): Abre panel de filtros avanzados.
• Quitar filtros (pi pi-filter-slash): Elimina filtros activos.
• Buscar (pi pi-search): Ejecuta la búsqueda.

Filtro disponible

Filtro	Tipo	Descripción
Grupo	Selector de árbol (p-treeSelect)	Filtra servicios por grupo/familia jerárquico.

Columnas de la tabla

Columna	Ancho	Descripción
GRUPO	125px	Ruta jerárquica del grupo (ej. "Grupo1 / SubGrupo2").
CODIGO	125px	Código del servicio.
NOMBRE	auto	Nombre del servicio.
DESCRIPCION	auto	Descripción del servicio.
SKU	100px	Código SKU.
CODIGO DE BARRA	100px	Código de barras.
Acciones	60px	Menú contextual (pi pi-ellipsis-h).

Menú contextual

Opción	Ícono	Descripción
Editar	pi pi-pencil	Abre el formulario de edición.
Eliminar	pi pi-times	Abre el diálogo de confirmación.

Paginación

50 registros por página. Controles: Primera, Anterior, Selector de página, Siguiente, Última.

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

---

Formulario de creación / edición

Diálogo a pantalla completa con los siguientes datos.

Encabezado

• Breadcrumb: Logistica > Catalogos servicios detalles > Nuevo
• Título: "Nuevo Servicios"
• Subtítulo: "Aqui puede editar la lista de catalogos de servicios detalle"

Sección 1 — Datos generales de servicio

Nota: "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
Grupo / Familia	Selector de árbol (p-treeSelect) con filtro y botón limpiar	No	12/12 columnas	"Si dese agregar a un grupo/familia seleccione"	"* Obligatorio"	Grupo jerárquico del servicio.
Codigo	Texto (pInputText)	Sí	2/12 columnas	"Ingrese el codigo"	"* Obligatorio"	Código identificador del servicio.
Nombre	Texto (pInputText)	Sí	7/12 columnas	"Ingrese el nombre"	"* Obligatorio"	Nombre del servicio.
Descripcion	Texto (pInputText)	No	12/12 columnas	"Ingrese la descripcion"	"* Obligatorio"	Descripción del servicio.

Sección 2 — Categorías

Subtítulo: "Permite seleccionar las categorias."

Campo	Tipo	Tooltip	Descripción
Categorias	Autocompletado múltiple (p-autoComplete con [multiple]="true") con desplegable	"Seleccione las categorias"	Selecciona categorías del catálogo. Busca con mínimo 1 carácter. Las seleccionadas se muestran como chips.

Botones del formulario

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

---

Flujo de creación

---

Flujo de edición

---

Gestión de grupos

Al hacer clic en "Grupos", se abre un diálogo a pantalla completa con una tabla tipo árbol (TreeTable) de grupos jerárquicos.

Tabla de grupos

Columna	Descripción
Grupos	Nombre del grupo con control de expansión.
Acciones	Botón editar (pi pi-pencil) y eliminar (pi pi-trash).

Formulario de grupo

Campo	Tipo	Obligatorio	Tooltip	Mensaje de error
Grupo (padre)	Selector de árbol (p-treeSelect)	No	"Seleccione el grupo si desea asignarlo"	"* Obligatorio"
Codigo	Texto	Sí	"Ingrese el codigo"	"* Obligatorio"
Nombre	Texto	Sí	"Ingrese el nombre del grupo"	"* Obligatorio"
Descripcion	Texto	No	"Ingrese la descripcion del grupo"	"* Obligatorio"

---

Diálogo de unidades

El diálogo de unidades (70% del ancho de pantalla) permite seleccionar y crear unidades de medida. Funciona igual que en Productos Principal:

• Panel izquierdo: Tabla de unidades disponibles del grupo seleccionado con checkboxes.
• Panel derecho: Formularios para crear nueva unidad o nuevo grupo de unidades.

---

Eliminación

Diálogo de confirmación modal (50% de pantalla):

• Título: "Confirmacion"
• Mensaje: "Estas seguro de proceder con la eliminacion?"
• Ícono: pi pi-exclamation-triangle
• Soporta eliminación tanto de servicios como de grupos.

Tras confirmar: "Eliminado." (éxito, 5 segundos).

---

Validaciones del formulario

Escenario	Mensaje	Tipo	Duración
Campos obligatorios vacíos	"Hay campos por validar revise."	Error	5 segundos
Servicio creado exitosamente	"Registro exitoso."	Éxito	5 segundos
Servicio actualizado exitosamente	"Actualizacion exitoso."	Éxito	5 segundos
Grupo creado exitosamente	"Registro exitoso."	Éxito	5 segundos
Grupo actualizado exitosamente	"Actualizacion exitoso."	Éxito	5 segundos
Eliminación exitosa	"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."

---

Endpoints de la API

Método	Endpoint	Descripción
GET	/v2.0.2/erpx/logistica/catalogos-servicios/?search=\{búsqueda\}&from=\{desde\}&size=\{tamaño\}	Lista servicios con paginación.
GET	/v2.0.2/erpx/logistica/catalogos-servicios/\{id\}	Obtiene un servicio por ID.
POST	/v2.0.2/erpx/logistica/catalogos-servicios/	Crea un servicio.
PUT	/v2.0.2/erpx/logistica/catalogos-servicios/\{id\}	Actualiza un servicio.
DELETE	/v2.0.2/erpx/logistica/catalogos-servicios/\{id\}	Elimina un servicio.
GET	/v2.0.1/erpx/logistica/catalogos-grupos/?search=catalogo_id:\{id\}	Lista grupos del catálogo.
POST	/v2.0.1/erpx/logistica/catalogos-grupos/	Crea un grupo.
PUT	/v2.0.1/erpx/logistica/catalogos-grupos/\{id\}	Actualiza un grupo.
DELETE	/v2.0.1/erpx/logistica/catalogos-grupos/\{id\}	Elimina un grupo.

---

Problemas comunes

Problema	Causa	Solución
No se muestran servicios	El catálogo no tiene servicios o error de conexión	Verifique la conexión. Use Actualizar.
El selector de grupo está vacío	No se han creado grupos en este catálogo	Use el botón "Grupos" para crear grupos primero.
El autocompletado de categorías no muestra resultados	No hay categorías registradas	Cree categorías desde Categorías.
Error "Hay campos por validar revise."	Código o Nombre vacíos	Complete los campos obligatorios.

---

Páginas relacionadas

• Catálogos de Productos — Vista general de catálogos.
• Catálogos Servicios Principal — Gestión global de servicios.
• Servicios Salud — Servicios específicos de salud.
• Categorías — Categorías de productos y servicios.