Catálogos Servicios Principal

Descripción general

La pantalla Catálogos Servicios permite gestionar los servicios individuales dentro de un catálogo de tipo SERVICIO. Desde esta vista puede crear, editar y eliminar servicios organizados por grupos jerárquicos y asociados a categorías.

---

Acceso

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

Breadcrumb: Logistica > Catalogos servicios

---

Vista principal — Tabla de servicios

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

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 del catálogo.
Nuevo servicio	pi pi-plus	Primario	Abre el formulario para crear un nuevo servicio.

Búsqueda y filtros

La barra de búsqueda incluye:

• Campo de búsqueda: Texto libre para buscar servicios por código o nombre.
• Agregar filtro (pi pi-filter): Abre un panel para agregar filtros avanzados.
• Quitar filtros (pi pi-filter-slash): Elimina todos los filtros activos.
• Buscar (pi pi-search): Ejecuta la búsqueda con los filtros configurados.

Filtro disponible

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

Los filtros activos se muestran como chips removibles.

Columnas de la tabla

Columna	Ancho	Descripción
GRUPO	125px	Ruta jerárquica del grupo/familia (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 del servicio.
CODIGO DE BARRA	100px	Código de barras del servicio.
Acciones	60px	Ícono de puntos suspensivos (pi pi-ellipsis-h) para el menú contextual.

Menú contextual

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

Paginación

La tabla carga 50 registros por página. Muestra: "Mostrando pagina \{X\} con \{Y\} registros de \{Z\} entradas".

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

---

Formulario de creación / edición de servicio

Al hacer clic en "Nuevo servicio" o "Editar" desde el menú contextual, se abre un diálogo a pantalla completa con el formulario.

Encabezado del diálogo

• Breadcrumb: Logistica > Catalogos servicios > Nuevo
• Título: "Nuevo Servicios"
• Subtítulo: "Aqui puede editar la lista de catalogos de servicios detalle"
• Diálogo a pantalla completa, no arrastrable ni redimensionable.

---

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 desea agregar a un grupo/familia seleccione"	"* Obligatorio"	Selecciona el grupo jerárquico al que pertenece el 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 detallada del servicio.

---

Sección 2 — Categorías

Subtítulo: "Permite seleccionar las categorias."

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

---

Botones del formulario

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

---

Flujo de creación

---

Flujo de edición

---

Gestión de grupos

Al hacer clic en el botón "Grupos" de la barra de herramientas, se abre un diálogo a pantalla completa para gestionar los grupos/familias del catálogo de servicios.

Tabla tipo árbol (TreeTable)

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

Formulario de grupo

Al hacer clic en "Nuevo Grupo" o editar un grupo existente:

• Breadcrumb: Inicio > Logistica > Catalogos productos detalle
• Título: "Nuevo grupo"
• Subtítulo: "Aqui puede editar la lista de grupos"

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

---

Eliminación

Al seleccionar Eliminar desde el menú contextual (para servicios o grupos), se abre un 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í

Botón	Acción
No	Cierra el diálogo sin eliminar.
Si	Ejecuta la eliminación. Muestra "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.3/erpx/logistica/catalogos-servicios/?search=\{búsqueda\}&from=\{desde\}&size=\{tamaño\}	Lista servicios con paginación.
GET	/v2.0.3/erpx/logistica/catalogos-servicios/\{id\}	Obtiene un servicio por ID.
POST	/v2.0.3/erpx/logistica/catalogos-servicios/	Crea un servicio.
PUT	/v2.0.3/erpx/logistica/catalogos-servicios/\{id\}	Actualiza un servicio.
DELETE	/v2.0.3/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.
GET	/v2.0.1/erpx/logistica/catalogos-categorias/?search=\{búsqueda\}&size=50	Busca categorías para el autocompletado.

---

Problemas comunes

Problema	Causa	Solución
No se muestran servicios	El catálogo no tiene servicios registrados o error de conexión	Verifique la conexión. Use Actualizar. Asegúrese de haber accedido desde un catálogo válido.
El selector de grupo está vacío	No se han creado grupos en el catálogo	Use el botón "Grupos" para crear grupos/familias primero.
El autocompletado de categorías no muestra resultados	No hay categorías registradas o error de conexión	Verifique que existan categorías en Categorías.
Error "Hay campos por validar revise."	Código o Nombre están vacíos	Complete los campos obligatorios marcados con (*).

---

Páginas relacionadas

• Catálogos de Productos — Vista general de catálogos (productos y servicios).
• Servicios Detalles — Detalles adicionales de servicios.
• Categorías — Categorías de productos y servicios.
• Productos Principal — Gestión de productos dentro de un catálogo.