Agencify Docsdocs.agencify.es · Documentación oficial
AgencifAI Volver a Agencify
Docs/Sistema/AQL
Agencify Query Language

AQL — el lenguaje de consultas de Agencify

Escribe preguntas de negocio en español y obtén datos exactos —los calcula la base de datos, no una estimación— junto a una gráfica automática. AQL está inspirado en ShopifyQL, pero está en tu idioma y conectado a AgencifAI.

Qué es AQL

AQL (Agencify Query Language) es un lenguaje pensado para el comercio. En vez de escribir SQL contra tablas técnicas, consultas conceptos de negocio como ventas, pedidos, productos, devoluciones o clientes mediante cláusulas legibles.

Internamente, cada consulta se convierte en una ficha estructurada y el motor ejecuta SQL parametrizado usando un diccionario cerrado de campos. No concatena texto libre: los datos son exactos y la consulta se mantiene segura.

Pregunta en español
→ AQL (este lenguaje)→ Ficha estructurada→ SQL parametrizado→ Datos exactos + gráfica

Anatomía de una consulta

Toda consulta empieza por DESDE <dataset> y MOSTRAR <métricas>. El resto de cláusulas es opcional y añade el nivel de detalle, filtros, periodo y orden.

DESDE ventas
MOSTRAR ventas_totales, pedidos
AGRUPAR POR metodo_de_pago
DURANTE ESTE MES
COMPARAR CON PERIODO ANTERIOR
CON PORCENTAJE
ORDENAR POR ventas_totales DESC
LIMITE 10
Uso

Las palabras clave no distinguen mayúsculas y los nombres pueden escribirse con o sin acentos. En el editor, pulsa Ctrl + Enter para ejecutar.

Dónde se usa

Chat de AgencifAI

Pregunta en lenguaje natural. La IA genera AQL, lo muestra y puedes editarlo o volver a ejecutarlo sin pedir otra respuesta.

Consultas AQL

Editor del panel para escribir AQL a mano con ayuda de sintaxis, resultados, totales, gráfica y tabla.

Informes guardados

Guarda una consulta con un nombre y ejecútala más adelante con datos actualizados. Los resultados se pueden exportar en CSV, Excel o JSON.

Exportar

Descarga la tabla de resultados de cualquier consulta en formato CSV, Excel o JSON para compartirla o trabajarla fuera del panel.

Cláusulas

DESDE <dataset>

Elige el conjunto de datos. Obligatoria. Ejemplo: DESDE ventas.

MOSTRAR <métrica>, …

Indica las métricas del vocabulario del dataset. Obligatoria. Ejemplo: MOSTRAR ventas_totales, pedidos.

CALCULAR nombre = fórmula

Crea una métrica derivada con + - * / ( ). Ejemplo: CALCULAR ticket = ventas_totales / pedidos.

AGRUPAR POR dimensión, …

Desglosa por una o dos dimensiones. Ejemplo: AGRUPAR POR canal, estado.

DONDE campo op valor

Filtra filas. Admite Y y listas, por ejemplo DONDE estado = (pagado, enviado).

DURANTE / ULTIMOS / ENTRE

Define el periodo: DURANTE ESTE MES, ULTIMOS 30 DIAS o un rango absoluto.

COMPARAR CON …

Añade la variación porcentual frente al periodo anterior o al año pasado.

TENIENDO métrica op valor

Filtra sobre un total agregado; requiere AGRUPAR POR. Ejemplo: TENIENDO unidades > 100.

CON PORCENTAJE

Añade la cuota de cada fila sobre el total: por ejemplo, una tarjeta supone el 62 % de las ventas.

ORDENAR POR / LIMITE

Ordena en DESC por defecto. Devuelve 50 filas por defecto y admite un máximo de 500.

Operadores admitidos

ContextoOperadores
DONDE= != > < >= <= y listas (a, b, c)
TENIENDO> < >= <= = !=
CALCULAR+ - * / ( )

Fechas y periodos

Periodos predefinidos — DURANTE …

HOYAYERESTA SEMANASEMANA PASADAESTE MESMES PASADOESTE TRIMESTRETRIMESTRE PASADOESTE AÑOAÑO PASADO

Periodos relativos — ULTIMOS N …

Las unidades disponibles son DIAS, SEMANAS, MESES y AÑOS. Por ejemplo: ULTIMOS 6 MESES o ULTIMOS 30 DIAS.

Periodos absolutos — ENTRE … Y …

Usa fechas en formato AAAA-MM-DD, por ejemplo ENTRE 2026-01-01 Y 2026-04-01.

Por defecto: los datasets transaccionales (ventas, devoluciones, cobros…) usan los últimos 12 meses si no pones fecha. Catálogo y clientes cuentan todo el histórico.

Métricas derivadas

Con CALCULAR puedes crear métricas a partir de las que ya ofrece el dataset. Solo se permiten nombres de métricas, números y + - * / ( ); la expresión se valida y se sustituye por SQL seguro.

Sirve, por ejemplo, para responder cuál es el ticket medio y las unidades por pedido, desglosado por canal.

DESDE ventas MOSTRAR ventas_totales, pedidos
CALCULAR ticket = ventas_totales / pedidos
AGRUPAR POR canal DURANTE ESTE MES

Datasets disponibles

Hay 13 conjuntos de datos. Cada uno tiene sus métricas para MOSTRAR, dimensiones para AGRUPAR POR y, cuando corresponde, campos válidos para DONDE. Las métricas marcadas con € se expresan como importe y las de % como porcentaje.

€ importe% porcentaje◷ dimensión temporal para series12 meses rango por defecto

ventas

12 mesespedidos
Métricas

ventas_totales €pedidosticket_medio €descuentos €envio_cobrado €impuestos €recargo_de_pago €pagado_con_tarjeta_regalo €pagado_con_credito €pedidos_pagadospedidos_cancelados

Dimensiones

diasemanameshoradia_de_la_semanaestadometodo_de_pagometodo_de_enviocanalprovinciaciudadpaiscuponetiquetatipo_de_cliente

Filtros (DONDE): estadocanalmetodo_de_pago

productos_vendidos

12 mesespor línea de pedido
Métricas

ventas €unidadespedidosimpuesto_recaudado €precio_medio_vendido €productos_distintos

Dimensiones

productocategoriaproveedordiasemanameshoradia_de_la_semanaestadocanal

Filtros (DONDE): estadocanal

productos

catálogo
Métricas

productosstock_totalprecio_medio €valor_de_inventario €agotadosstock_bajo_5en_rebajastock_medio

Dimensiones

estadotipoproveedormes_de_alta

Filtros (DONDE): estadotipoproveedor

clientes

histórico
Métricas

clientessuscritos_emailsuscritos_sms

Dimensiones

diamesprovinciaciudad

Filtros (DONDE): email_marketingsms_marketing

devoluciones

12 meses
Métricas

total_devuelto €devolucionesenvio_devuelto €

Dimensiones

metodo_de_devoluciondiasemanames

Filtros (DONDE): metodo_de_devolucion

cobros

12 mesesdinero realmente cobrado
Métricas

cobrado €cobros

Dimensiones

metodo_de_pagodiasemanames

Filtros (DONDE): metodo_de_pago

descuentos

12 mesesuso de promociones
Métricas

descuento_aplicado €usos

Dimensiones

diasemanames

newsletter

12 mesessuscriptores
Métricas

suscriptores

Dimensiones

diasemanames

carritos

12 mesesconversión / abandono
Métricas

carritosconvertidosabandonadostasa_de_conversion %

Dimensiones

diasemanames

deseos

12 meseslistas de deseos
Métricas

anadidos_a_deseosproductos_distintos

Dimensiones

productodiasemanames

tarjetas_regalo

12 meses
Métricas

emitido €canjeado €movimientos

Dimensiones

tipodiasemanames

Filtros (DONDE): tipo

stock_tiendas

stock por tienda (POS)
Métricas

stock_totalagotadosstock_bajo

Dimensiones

tiendaproducto

finanzas

12 mesesventas netas (ventas − devoluciones)
Métricas

ingresos_de_ventas €devoluciones €ingreso_neto €descuentos €pedidostasa_de_devolucion %

Dimensiones

diasemanamescanal

Filtros (DONDE): origin

Ejemplos

Ventas por método de pago este mes, con cuota y comparación.

DESDE ventas MOSTRAR ventas_totales, pedidos AGRUPAR POR metodo_de_pago DURANTE ESTE MES COMPARAR CON PERIODO ANTERIOR CON PORCENTAJE ORDENAR POR ventas_totales DESC

Evolución mensual de ventas de los últimos seis meses.

DESDE ventas MOSTRAR ventas_totales AGRUPAR POR mes ULTIMOS 6 MESES

Los diez productos con más unidades del trimestre.

DESDE productos_vendidos MOSTRAR unidades, ventas AGRUPAR POR producto DURANTE ESTE TRIMESTRE ORDENAR POR unidades DESC LIMITE 10

La categoría con más ventas durante el mes.

DESDE productos_vendidos MOSTRAR ventas AGRUPAR POR categoria DURANTE ESTE MES ORDENAR POR ventas DESC

Las horas y días de la semana con más ventas.

DESDE ventas MOSTRAR ventas_totales AGRUPAR POR dia_de_la_semana, hora DURANTE ESTE MES

Productos que han vendido más de cien unidades este año.

DESDE productos_vendidos MOSTRAR unidades AGRUPAR POR producto TENIENDO unidades > 100 DURANTE ESTE AÑO

Ingreso neto y tasa de devolución por mes.

DESDE finanzas MOSTRAR ingreso_neto, tasa_de_devolucion AGRUPAR POR mes ULTIMOS 12 MESES

Valor de inventario y productos agotados o con stock bajo.

DESDE productos MOSTRAR valor_de_inventario, agotados, stock_bajo_5

Provincias de origen de los clientes.

DESDE clientes MOSTRAR clientes AGRUPAR POR provincia ORDENAR POR clientes DESC LIMITE 15

Ventas de este año frente al año pasado, desglosadas por mes.

DESDE ventas MOSTRAR ventas_totales AGRUPAR POR mes DURANTE ESTE AÑO COMPARAR CON AÑO PASADO

Notas y límites

  • finanzas combina pedidos y devoluciones, por lo que solo puede agruparse por día, semana, mes y canal.
  • Al agrupar ventas por etiqueta, un pedido con varias etiquetas aparece en cada una. Los importes pueden duplicarse, pero el conteo de pedidos se mantiene exacto.
  • Se admiten como máximo dos dimensiones en AGRUPAR POR y hasta 500 filas con LIMITE.
  • Los informes de cohortes y retención se generan desde su propia herramienta; no se escriben en AQL.