Métricas

Desde Métricas puedes crear indicadores de rendimiento personalizados para medir el desempeño comercial y logístico de tu organización. Cada métrica define un periodo de análisis, una periodicidad y uno o más indicadores con filtros específicos por vendedor, zona, punto de venta o almacén.

---

Vista principal — Listado de métricas

Al ingresar al módulo, el sistema muestra una tabla con todas las métricas registradas. La tabla utiliza paginación del lado del servidor con un tamaño de página de 50 registros por defecto.

Barra de herramientas

En la parte superior de la vista se encuentran tres botones de acción:

Botón	Icono	Descripción
Exportar	pi pi-file-excel	Exporta los datos filtrados a Excel. Requiere que haya un filtro de fecha aplicado y que el rango no supere 3 meses (90 días)
Actualizar	pi pi-refresh	Recarga la tabla con los datos más recientes del servidor
Nuevo	pi pi-plus	Abre el formulario para crear una nueva métrica

Columnas de la tabla

Columna	Descripción
NOMBRE	Nombre asignado a la métrica
DESCRIPCION	Texto descriptivo de la métrica
MODO TIEMPO	Modo temporal de la métrica. Valores posibles: ABSOLUTO o RELATIVO
PERIODICIDAD - DURACIÓN	Combinación del tipo de tiempo y el intervalo. Ejemplo: MES - 1, DIA - 7, AÑO - 1
ACCIONES	Botón de tres puntos (pi pi-ellipsis-h) que despliega el menú de acciones

Valores de modo de tiempo

Valor interno	Etiqueta mostrada
0	ABSOLUTO
1	RELATIVO

Valores de periodicidad (tipo de tiempo)

Valor interno	Etiqueta mostrada
1	MINUTO
2	HORA
3	DIA
4	MES
5	AÑO

Menú contextual

Al hacer clic derecho sobre una fila o al presionar el botón de tres puntos en la columna ACCIONES, se despliega un menú con las siguientes opciones:

Opción	Icono	Descripción
Ver detalles	pi pi-eye	Navega a la vista de detalles de la métrica (ruta: /analiticas/metricas-detalles/\{id\})
Editar	pi pi-pencil	Abre el formulario de edición con los datos de la métrica seleccionada precargados
Eliminar	pi pi-trash	Abre el diálogo de confirmación para eliminar la métrica
Registro de actividades	pi pi-lock	Opción reservada para futuras implementaciones (actualmente sin funcionalidad)

Paginación

La paginación se muestra en la parte inferior de la tabla con los siguientes controles:

Control	Icono	Descripción
Ir al inicio	pi pi-angle-double-left	Navega a la primera página
Página anterior	pi pi-angle-left	Retrocede una página
Selector de página	Dropdown	Permite seleccionar una página específica. Muestra el formato X de Y
Página siguiente	pi pi-angle-right	Avanza una página
Ir al final	pi pi-angle-double-right	Navega a la última página

En la parte superior de la tabla se muestra el texto: "Mostrando página {N} con {registros_actuales} registros de {total} entradas".

---

Filtros de búsqueda

La barra de búsqueda se ubica debajo de la barra de herramientas. Incluye un campo de texto libre para búsqueda general y un sistema de filtros avanzados mediante chips.

Campo de búsqueda de texto

Un campo de texto con ícono de lupa (pi pi-search) que permite buscar por cualquier término. La búsqueda se combina con los filtros activos usando el operador AND.

Tipos de filtros disponibles

Para agregar un filtro, haz clic en el botón "Agregar filtro" (pi pi-filter). Se abre un panel flotante donde primero debes seleccionar el tipo de filtro:

Filtro	Valor	Campos que muestra	Descripción
FECHA	1	Fecha inicio + Fecha fin	Filtra por rango de fechas usando calendarios. Ambos campos son obligatorios
SERIE	2	Serie	Campo de texto para filtrar por serie
NÚMERO	3	Número	Campo de texto para filtrar por número
RESPONSABLE	4	Responsable (dropdown)	Selección de un colaborador de la lista. Muestra: Apellido_paterno Apellido_materno Nombres
MOTIVOS	5	Motivos (multiselect)	Selección múltiple de motivos (pendiente de implementación en listado)
ORIGEN	6	Origen (dropdown)	Selección de un elemento de infraestructura tipo almacén (tipo:3)
DESTINO	7	Destino (dropdown)	Selección de un elemento de infraestructura tipo almacén (tipo:3)
ESTADOS	8	Estados (multiselect)	Selección múltiple de estados (pendiente de implementación en listado)

Validaciones de filtros

Campo	Validación	Mensaje de error
Filtro (tipo)	Obligatorio	" Obligatorio"*
Fecha inicio	Obligatorio (cuando filtro = FECHA)	" Obligatorio"*
Fecha fin	Obligatorio (cuando filtro = FECHA)	" Obligatorio"*
Serie	Obligatorio (cuando filtro = SERIE)	" Obligatorio"*
Número	Obligatorio (cuando filtro = NÚMERO)	" Obligatorio"*
Responsable	Obligatorio (cuando filtro = RESPONSABLE)	" Obligatorio"*
Motivos	Obligatorio (cuando filtro = MOTIVOS)	" Obligatorio"*
Origen	Obligatorio (cuando filtro = ORIGEN)	" Obligatorio"*
Destino	Obligatorio (cuando filtro = DESTINO)	" Obligatorio"*
Estados	Obligatorio (cuando filtro = ESTADOS)	" Obligatorio"*

---

Crear o editar una métrica

Al presionar el botón Nuevo o la opción Editar del menú contextual, se abre un diálogo a pantalla completa con el formulario de la métrica.

Encabezado del diálogo

• Título: "Métrica"
• Subtítulo: "Aqui puede editar la lista de métrica"

Campos del formulario principal

Botones del formulario principal

Botón	Icono	Descripción
Cancelar	pi pi-times	Cierra el diálogo sin guardar cambios
Guardar	pi pi-check	Valida el formulario y guarda la métrica. Muestra un spinner durante el proceso

Mensajes al guardar

Escenario	Tipo	Mensaje
Formulario inválido	Error	"Revise bien, hay formularios por validar."
Creación exitosa	Éxito	"Registro exitoso."
Actualización exitosa	Éxito	"Actualización exitoso."
Error del servidor	Error	Mensaje de error del servidor o código de error correspondiente

---

Configuración de indicadores

Al presionar "Agregar Indicador" o el botón de editar en un indicador existente, se abre un sub-diálogo con ancho del 50% de la ventana.

Encabezado del sub-diálogo

• Título: "Configuración"
• Subtítulo: "Aqui puede editar la configuración"

Campos del indicador

Campo	Tipo	Obligatorio	Descripción
Nombre	Texto (pInputText)	Sí	Nombre identificativo del indicador
Color	Selector de color (p-colorPicker)	Sí	Color para representar el indicador en gráficos. Valor por defecto: #000000 (negro)
Indicador	Dropdown (p-dropdown)	Sí	Código del tipo de indicador. Las opciones se cargan dinámicamente desde los parámetros del sistema con dominio ERPX_ANALITICAS_METRICAS_CRITERIOS_CODIGOS

Validaciones del indicador

Campo	Validación	Mensaje de error
Nombre	Obligatorio	" Obligatorio"*
Color	Obligatorio	" Obligatorio"*
Indicador	Obligatorio	" Obligatorio"*

Filtros del indicador

Dentro del sub-diálogo de configuración del indicador, existe una sección de filtros que permite refinar los datos que alimentarán el indicador. Los filtros funcionan con un sistema de chips similar al de la búsqueda principal.

Tipos de filtros de indicador

Filtro	Valor	Componente	Descripción
VENDEDORES	1	p-multiSelect	Selección múltiple de colaboradores. Se muestran como Apellido_paterno Apellido_materno Nombres. Permite búsqueda por nombre
ZONAS	2	p-multiSelect	Selección múltiple de zonas geográficas. Se muestran por nombre. Permite búsqueda por nombre
PUNTOS VENTAS	3	p-multiSelect	Selección múltiple de puntos de venta. Se muestran por nombre. Permite búsqueda por nombre
ALMACENES	4	p-multiSelect	Selección múltiple de almacenes (elementos de infraestructura tipo 3). Se muestran por nombre. Permite búsqueda por nombre

Controles de filtros de indicador

Botón	Icono	Descripción
Agregar filtro	pi pi-filter	Abre el panel flotante para seleccionar el tipo de filtro y sus valores
Quitar filtros	pi pi-filter-slash	Elimina todos los filtros del indicador

Botones del sub-diálogo

Botón	Icono	Descripción
Cancelar	pi pi-times	Cierra el sub-diálogo sin guardar el indicador
Guardar	pi pi-check	Valida y guarda el indicador en la lista de indicadores de la métrica

---

Eliminar una métrica

Al seleccionar la opción Eliminar del menú contextual, se abre un diálogo de confirmación.

Diálogo de confirmación

• Título: "Confirmación"
• Icono: pi pi-exclamation-triangle (triángulo de advertencia, tamaño 2rem)
• Mensaje: "Estas seguro de proceder con la eliminación?"

Botón	Icono	Descripción
No	pi pi-times	Cierra el diálogo sin eliminar
Si	pi pi-check	Confirma la eliminación. Muestra spinner durante el proceso. Se deshabilita mientras procesa

Mensajes al eliminar

Escenario	Tipo	Mensaje
Eliminación exitosa	Éxito	"Eliminado."
Error 400	Error	"Error de estructura de envio de datos. ERROR 400"
Error 401/402/403	Error	Muestra los mensajes de error devueltos por el servidor concatenados con coma
Error 404	Error	"No se encontró el servidor de respuestas, consulte con el Administrador. ERROR 404"
Error 500	Error	"Error interno del servidor. ERROR 500"

---

Ver detalles

Al seleccionar Ver detalles del menú contextual, el sistema navega a la ruta /analiticas/metricas-detalles/\{id\}, donde se muestra la información detallada de la métrica seleccionada.

---

Estructura de datos de una métrica

Al guardar, el sistema envía la siguiente estructura al servidor:

Campo	Tipo	Descripción
id	String/null	Identificador único. null para nuevas métricas
nombre	String	Nombre de la métrica
descripcion	String	Descripción de la métrica
tiempo_tipo	Number	Tipo de periodicidad (1-5)
tiempo_intervalo	Number	Duración del intervalo
tiempo_modo	Number	Modo de tiempo: 0 (ABSOLUTO) o 1 (RELATIVO)
fecha_inicio	String	Fecha de inicio en formato YYYY-MM-DD HH:mm:ss
fecha_fin	String	Fecha de fin en formato YYYY-MM-DD HH:mm:ss
user_id	String/null	ID del usuario
creator_id	String	ID del creador (colaborador autenticado)
detalles	Array	Lista de indicadores configurados

Estructura de cada indicador (detalle)

Campo	Tipo	Descripción
nombre	String	Nombre del indicador
color	String	Color en formato hexadecimal (ej: #FF5733)
indicador_codigo	String	Código del tipo de indicador
vendedores	Array	Lista de vendedores seleccionados como filtro
zonas	Array	Lista de zonas seleccionadas como filtro
puntos_ventas	Array	Lista de puntos de venta seleccionados como filtro
almacenes	Array	Lista de almacenes seleccionados como filtro

---

Endpoints de la API

Todos los endpoints requieren los headers Authorization: Bearer \{token\} y enterprise-id: \{id_empresa\}.

Métricas

Método	Endpoint	Descripción
GET	/v2.0.3/erpx/analiticas/metricas/?search=\{filtros\}&from=\{desde\}&size=\{tamaño\}&sort=\{orden\}	Listar métricas con paginación y filtros
GET	/v2.0.3/erpx/analiticas/metricas/\{id\}	Obtener una métrica por ID
POST	/v2.0.3/erpx/analiticas/metricas/	Crear una nueva métrica
PUT	/v2.0.3/erpx/analiticas/metricas/\{id\}	Actualizar una métrica existente
PATCH	/v2.0.3/erpx/analiticas/metricas/\{id\}	Actualizar parcialmente una métrica
DELETE	/v2.0.3/erpx/analiticas/metricas/\{id\}	Eliminar una métrica

Recursos auxiliares

Método	Endpoint	Descripción
GET	/v2.0.1/erpx/comercial/gateway-ventas/?search=\{filtros\}	Consultar gateway de ventas
GET	/v2.0.3/erpx/rrhh/colaboradores/?search=\{filtros\}	Listar colaboradores (vendedores)
GET	/v2.0.1/erpx/global/zonas/?search=\{filtros\}	Listar zonas geográficas
GET	/v2.0.1/erpx/comercial/puntos-ventas/?search=\{filtros\}	Listar puntos de venta
GET	/v2.0.1/erpx/global/elementos-infraestructuras/?search=\{filtros\}	Listar elementos de infraestructura (almacenes: tipo 3)
GET	/v2.0.1/erpx/global/params/?search=\{filtros\}	Obtener parámetros del sistema (indicadores disponibles)
GET	/v2.0.1/erpx/contabilidad/impuestos/?search=\{filtros\}	Listar impuestos
POST	/v2.0.1/erpx/contabilidad/impuestos/calcular/	Calcular impuestos
GET	/v2.0.1/erpx/logistica/catalogos-productos/?search=\{filtros\}	Listar catálogos de productos
GET	/v2.0.1/erpx/logistica/ordenes-compras/?search=\{filtros\}	Listar órdenes de compra
GET	/v2.0.1/erpx/logistica/proveedores/?search=\{filtros\}	Listar proveedores
POST	/v2.0.1/erpx/logistica/stocks-productos/entradas/	Registrar entrada de stock
POST	/v2.0.1/erpx/logistica/kardex/	Registrar movimiento en kardex

---

Problemas comunes

Problema	Causa	Solución
No aparece el botón "Nuevo"	El usuario no tiene permisos para el módulo de analíticas	Solicita al administrador que asigne el perfil adecuado desde Perfiles y Roles
Error al exportar: "Tiene que filtrar minimo por la fecha"	No se ha aplicado un filtro de fecha en la búsqueda	Agrega un filtro de tipo FECHA con un rango de inicio y fin antes de intentar exportar
Error al exportar: "El filtro por la fecha tiene como máximo 3 meses"	El rango de fechas supera los 90 días	Reduce el rango de fechas a un máximo de 3 meses (90 días)
"Revise bien, hay formularios por validar" al guardar	Uno o más campos obligatorios no están completos	Revisa que todos los campos marcados con asterisco estén llenos y que haya al menos un indicador
No se cargan las opciones de indicador	El dominio de parámetros ERPX_ANALITICAS_METRICAS_CRITERIOS_CODIGOS no tiene registros	Contacta al administrador para configurar los códigos de criterios de métricas
Los campos de fecha no se muestran	El modo de tiempo está configurado como RELATIVO	En modo relativo, las fechas se calculan automáticamente. Si necesitas definir fechas específicas, cambia a modo ABSOLUTO
Los filtros de vendedores muestran solo 50 resultados	La búsqueda carga los primeros 50 registros por defecto	Usa el campo de búsqueda del multiselect para filtrar y encontrar el vendedor específico que buscas

---

Páginas relacionadas

• Métricas - Detalles — vista detallada de cada métrica con gráficos
• Mapas de Calor — visualización geográfica de datos de ventas
• Reportes de Ventas — reportes de avance de ventas
• Reportes de Documentos — reportes de documentos de venta emitidos