Formato compute

GET /api/event-criterias/:id?format=compute

Devuelve un filtro de eventos como una lista plana de condiciones, en lugar del árbol completo. Es la otra rama del query param format de GET /event-criterias/:id.

Auth: Requerida — permiso event-criteria:view

Esta representación es más angosta que la definición: transporta condiciones de fila sobre un solo bloque de consulta. Un filtro cuya definición no cabe en ella se rechaza con 422 y un código que dice exactamente qué no cabe — nunca se devuelve una versión degradada del filtro.

Parámetros de ruta

Parámetros de consulta

Ejemplo

curl "https://api.reten.ai/api/event-criterias/9f3a1c22-4b7e-4c31-9a8d-2f5e6b7c8d90?format=compute" \
  -H "Authorization: Bearer <token>" \
  -H "x-tenant-id: <tenant-id>" \
  -H "x-project-id: <project-id>"

import axios from 'axios';

const id = '9f3a1c22-4b7e-4c31-9a8d-2f5e6b7c8d90';
const response = await axios.get(
  `https://api.reten.ai/api/event-criterias/${id}`,
  {
    headers: { Authorization: 'Bearer <token>', 'x-tenant-id': '<tenant-id>', 'x-project-id': '<project-id>' },
    params: { format: 'compute' },
  },
);
const computeCriteria = response.data;

Forma de la respuesta 200 OK

IComputeEventCriteria:

Cada elemento de conditions es una de dos formas, distinguibles por su operator:

Condición escalar

Condición de registro

Los cuatro casos

1 · Condición escalar

Eventos cuyo status es Facturada.

{
  "id": "9f3a1c22-4b7e-4c31-9a8d-2f5e6b7c8d90",
  "name": "Venta oficial — solo facturada",
  "conditions": [
    {
      "field": "status",
      "operator": "=",
      "value": "Facturada",
      "source": "event_transactions"
    }
  ]
}

2 · Registro con dos sub-filtros

Eventos con un atributo cuya key es documento_tipo y cuyo value es factura.

{
  "id": "1c7d2e83-5a90-4f62-8b31-6d4e5f70a1b2",
  "name": "Documentos tipo factura",
  "conditions": [
    {
      "field": "attributes",
      "operator": "CONTAINS_RECORD",
      "source": "event_transactions",
      "match_all": true,
      "sub_filters": [
        { "field": "key", "operator": "=", "value": "documento_tipo" },
        { "field": "value", "operator": "=", "value": "factura" }
      ]
    }
  ]
}

3 · Escalar + registro

Ventas facturadas con al menos una línea que no es una devolución.

{
  "id": "4b8e0f15-2c76-4a03-9d58-7e1f2a3b4c5d",
  "name": "Ventas con ítems no-devolución",
  "conditions": [
    {
      "field": "status",
      "operator": "=",
      "value": "Facturada",
      "source": "event_transactions"
    },
    {
      "field": "items",
      "operator": "CONTAINS_RECORD",
      "source": "event_transactions",
      "match_all": true,
      "sub_filters": [
        { "field": "category", "operator": "NOT IN", "value": ["devolucion"] }
      ]
    }
  ]
}

4 · Escalar + tabla relacionada

Ventas facturadas con al menos una línea cuyo producto es de categoría Food Service u HORECA. La condición sobre la tabla relacionada llega al mismo nivel que las demás, distinguida por su source: el camino hasta product_properties no viaja.

{
  "id": "6d2a9c41-7e35-48b0-b1c9-0f8e7d6c5b4a",
  "name": "Proyecto Food Service",
  "conditions": [
    {
      "field": "status",
      "operator": "=",
      "value": "Facturada",
      "source": "event_transactions"
    },
    {
      "field": "categorization.category_name",
      "operator": "IN",
      "value": ["Food Service", "HORECA"],
      "source": "product_properties"
    }
  ]
}

Qué significa match_all

Es donde más fácil se equivoca una integración, así que va explícito:

1. match_all combina los sub_filters dentro del elemento, no sobre los elementos. match_all: true significa que existe un elemento del array que cumple todos los sub_filters. Un elemento que coincide solo en key o solo en value no lo satisface.
2. match_all: false es el mismo existencial con OR adentro: existe un elemento que cumple al menos uno de los sub_filters. Nunca significa "todos los elementos".
3. Con un solo sub_filter siempre viaja match_all: true. Con menos de dos sub-filtros el conectivo no cambia el resultado, y true es la forma canónica.
4. CONTAINS_RECORD es existencial también con operadores negativos. items con category NOT IN ["devolucion"] y match_all: true significa "existe un ítem que no es devolución", no "ningún ítem es devolución". Esta representación no sabe expresar cuantificación universal.
5. Un array vacío o NULL nunca satisface un CONTAINS_RECORD, y un sub-campo en NULL no matchea, tampoco con un operador negativo.

Qué significa field

El field es el path completo relativo a su scope, y el scope nunca se repite:

Subset de operadores

Los operadores viajan como literales SQL, no como los miembros del enum de la definición:

CONTAINS_RECORD no traduce ningún operador de comparación: lo emite la hoja de registro.

Tipo JSON del value

Con qué tipo JSON viaja el valor lo fija el tipo de la columna en el catálogo, no la forma en que la definición quedó guardada:

Respuesta 422 Unprocessable Entity

El filtro es válido y compila a SQL; lo que no existe es su proyección a esta representación. El cuerpo trae el diagnóstico:

{
  "code": "TIME_WINDOW_UNSUPPORTED",
  "path": "queryBlocks[0].timeWindow",
  "message": "No se puede proyectar queryBlocks[0].timeWindow (TIME_WINDOW_UNSUPPORTED): el wire no transporta la ventana IN_THE_LAST"
}

Los doce códigos

Relación con conditionCount

Respuestas de error