Filtros

En las consultas que devuelven colecciones de datos puedes utilizar ciertos campos para filtrar el resultado deseado.

Los endpoints /search soportan un conjunto común de parámetros de filtro y ordenamiento, además de los filtros específicos de cada recurso.

Valores aceptados para Logic

ParámetroDescripción
andCuando todos los filtros deben cumplirse
orCuando al menos uno de los filtros debe cumplirse
xorCuando exactamente uno de los filtros debe cumplirse

Valores aceptados para Operator

ParámetroDescripción
eqIgual a
neqNo igual a
ltMenor que
lteMenor o igual que
gtMayor que
gteMayor o igual que
startswithComienza con
endswithTermina con
containsContiene

Ejemplo combinando filtros y ordenamiento

POST /rrhh/fichas/search
{
    "advancedFilter": {
        "logic": "and",
        "filters": [
            {
                "field": "vigente",
                "operator": "eq",
                "value": true
            },
            {
                "field": "idCentroCosto",
                "operator": "eq",
                "value": 2
            }
        ]
    }
}
💡

Recomendación

Usa la mayor cantidad de filtros posibles, para reducir el tamaño de la respuesta y mejorar el rendimiento de tu integración, especialmente en listados grandes.