Inicio
26
API de Auditorías con Datos Resumidos por Período

API de Auditorías con Datos Resumidos por Período

Fecha de publicación: 22 de octubre de 2026
Versión necesaria: plugin de Auditorías 11.261.2171

Objetivo

Poner a disposición una API para consultar los resultados de auditorías de presencia y de etiqueta ya consolidados por período. Así, el integrador obtiene los mismos indicadores mostrados en la pantalla de Auditorías, sin necesidad de sumar ítem por ítem.

Endpoints

Método	Ruta	Vista
`GET`	`/{tenant}/api/rest/audit/v1/period/presence/products`	Situación producto por producto de la auditoría de presencia en el período
`GET`	`/{tenant}/api/rest/audit/v1/period/presence/summary`	Resumen por tienda de la auditoría de presencia en el período
`GET`	`/{tenant}/api/rest/audit/v1/period/tag/products`	Situación producto por producto de la auditoría de etiqueta en el período
`GET`	`/{tenant}/api/rest/audit/v1/period/tag/summary`	Resumen por tienda de la auditoría de etiqueta en el período

Parámetros

begin (obligatorio): inicio del período, en formato yyyy-MM-dd HH:mm:ss o yyyy-MM-dd.
end (obligatorio): fin del período, en el mismo formato.
storeFilter: filtra una o más tiendas.
categoryFilter: filtra por clase de producto.
Page / PageSize: paginación de los resultados.

El intervalo entre begin y end no puede superar 1 mes calendario.

Ejemplo de solicitud:

CODE

GET /{tenant}/api/rest/audit/v1/period/presence/summary?begin=2026-09-01&end=2026-09-30

Respuestas:

200: éxito, con la lista de resultados.
400: parámetros inválidos o ausentes, o período superior a 1 mes. Ejemplo: "Período inválido".
500: error interno al armar la respuesta.

Beneficios

Datos listos para análisis: indicadores consolidados por período, listos para informes y BI;
Consistencia con la pantalla: los valores siguen los mismos indicadores mostrados en Auditorías de Presencia y de Etiqueta;
Integración simplificada: la consulta por período y por tienda reduce el volumen de llamadas y el procesamiento en el sistema integrado.

Para detalles de los campos y ejemplos de respuesta, consulte la documentación de las APIs.