Informe de Consumo API

¿Qué es una API pública?

Es un recurso que tienen las aplicaciones alojadas en la nube que permite que otras aplicaciones o centros de datos (data lake) tomen o dejen datos en nuestra base de datos.

ejemplos:

Ejemplo de “dejar” o escribir datos en la base de datos de Gstock: cuando una aplicación TPV (POS) envía un fichero con datos de ventas de un restaurante, datos necesarios para que Gstock pueda dar de baja materia prima del almacén. Otro ejemplo es cuando un proveedor entrega digitalmente a través de la API correspondiente un albarán.
Ejemplo de “tomar” datos o leer en la base de datos de Gstock: cualquier aplicación de Business Inteligence, o cualquier aplicación de Contabilidad, ambas necesitan datos para poder alimentar sus bases de datos.

¿Es gratuito el uso de una API?

Todas las aplicaciones en la nube (como Gstock) alojadas en los grandes servidores de servicios de internet (Amazon, Azure, Google, etc) tienen que pagar por cada vez que hay una petición de escritura o de lectura a través de la API, por lo que TODAS estas interacciones tienen un coste para la aplicación.

¿Gstock cobra al cliente el uso de estas API?

Hasta enero de 2026 Gstock no ha cobrado al cliente final por el uso de las API. Lo que ha sucedido es que el auge en el uso de este recurso ha provocado un aumento considerable

1. Propósito del Informe

El Informe de Consumo de API ha sido diseñado para ofrecer a los usuarios con rol "Administrador" una visión clara y detallada del uso de la API. El objetivo es que puedas monitorizar el número de llamadas, controlar los costes asociados y tomar decisiones informadas sobre la gestión del consumo de tus diferentes centros de coste (CECOs) y paneles.

2. Ruta de Acceso

Para acceder a este informe, sigue la siguiente ruta dentro de la aplicación:

Panel Admin → Informes → Informes de Sistema → Consumo API

3. Descripción General de la Pantalla

Al acceder al informe, encontrarás una pantalla dividida en tres secciones principales que te permitirán analizar el consumo desde una vista general hasta el máximo detalle.

Filtros

En la parte superior, dispones de varios filtros para acotar la información mostrada:

Año: Selecciona el año del que deseas consultar el consumo.
Mes: Filtra por un mes específico o selecciona "Año completo" para ver los datos anuales.
CECO / Panel: Elige un centro de coste o panel específico, o déjalo en "Todos los CECOs" para una vista global.
Aplicación: Filtra por la aplicación de entrada de datos, que realiza las llamadas o selecciona "Todas".

Resúmenes Superiores

Justo debajo de los filtros, verás dos cuadros con los totales clave según el periodo filtrado:

Resumen General: Presenta la suma total de llamadas y el importe de todos los CECOs y paneles que gestionas.

Tabla de Consumo Detallado

Es la sección principal del informe y muestra un desglose mensual del consumo con las siguientes columnas:

CECO / PANEL: Nombre del centro de coste o panel que realizó el consumo.
APLICACIÓN: Aplicación específica que utilizó la API (ej. Facturación, Logística).
MES: Mes en el que se registraron las llamadas.
LLAMADAS (MES): Número total de llamadas realizadas en ese mes por esa aplicación y CECO.
IMPORTE MES (€): Coste monetario asociado a las llamadas de ese mes.
USO DE ENDPOINTS: Un icono de acción (☰) que te permite ver el detalle exacto de los endpoints consumidos.

4. Cómo Utilizar el Informe

Paso 1: Filtrar la información

Utiliza los filtros superiores para definir el rango de fechas y el ámbito (CECOs, aplicaciones) que quieres analizar. Haz clic en "Aplicar Filtros" para actualizar los datos.

Paso 2: Analizar los resúmenes

Observa el cuadro de Resumen General para obtener una idea rápida del volumen total de llamadas y su coste en el periodo seleccionado.

Paso 3: Profundizar en el detalle por CECO/Panel

Revisa la tabla de Consumo Detallado para identificar qué centros de coste o aplicaciones están generando un mayor volumen de llamadas y en qué meses se concentra la actividad.

Paso 4: Ver el uso específico de Endpoints

Para un análisis técnico, haz clic en el icono ☰ de la columna USO DE ENDPOINTS en la fila que te interese. Se abrirá una ventana emergente que te mostrará:

Un listado de cada endpoint específico utilizado.
El número de llamadas que recibió cada uno.
Un buscador para encontrar un endpoint concreto.
Paginación para navegar si la lista es muy extensa.