# FILTROS API NUWWE

Serán usados para definir un conjunto de acciones , basadas en la información que está siendo pasada.

En esta guía se usará insomnia para visualizar los ejemplos:

## 1. Filtros parciales básicos (NOMBRE\_CAMPO  LIKE%VALOR%)

Los filtros parciales son útiles cuando se desea buscar dentro de una cadena de texto alguna palabra clave, estos se podrán realizar usando el nombre de la columna por la que se desea filtrar y el valor deseado<br>

**Ejemplo 1:** filtro para obtener todos los inmuebles tipo venta

```bash
https://api.nuwwe.com/api/inmueble?filter%5Bcod_tipo_consignacion%5D=VEN
```

{% hint style="info" %}
Este filtro aunque es parcial, será más exacto que el del segundo ejemplo ya que usa el código cod\_tipo\_consignacion el cual es único
{% endhint %}

![](https://lh3.googleusercontent.com/jQCY7kIcZ8Uouz0sD8osP6Hwjk44mLL5g8QkDmCEhnHsZm9vbWvZHSww7A_jEHsX3MGk5dnUSYV_DXeigfCCaf0sw6Jf5VMudjp7hdSpT593bdQa1H_ahSbnTO3QeC0e8ohWffSQ)

Otra alternativa es usar el nombre como se muestra a continuación

**Ejemplo 2:** filtro para obtener todos los inmuebles tipo venta por medio del nombre

```bash
https://api.nuwwe.com/api/inmueble?filter%5Bnom_tipo_consignacion%5D=VENTA
```

{% hint style="info" %}
La diferencia es que este filtro es que buscara todos los inmuebles  por nom\_tipo\_consignacion que contenga la palabra VENTA
{% endhint %}

![](https://lh6.googleusercontent.com/cK2c6_psMnsTv5NzUO1WX5pLuDgne0RERat3H4CsNQlv2MecN_1p4ZcJMPGAq8AaAxE5ipa8YqHRPYFJP9RyWudOngFrs0IvTtSXz5_rFSf0T5sEClUZhiOSlP-OKbIrUL58HMEr)

Se podrá combinar filtros lo que equivale a realizar filtros con la condición AND

**Ejemplo 3:** Filtro para obtener todos los inmuebles tipo venta de la ciudad de Bogotá.

```bash
https://api.nuwwe.com/api/inmueble?filter%5Bnom_tipo_consignacion%5D=VENTA&filter%5Bcod_ciudad%5D=11001
```

{% hint style="info" %}
**NOTA:** recuerde que la búsqueda parcial por código será mas exacta que la búsqueda por nombre, tener presente que la búsqueda parcial busca coincidencias dentro del texto.
{% endhint %}

## 2. Filtros exactos básicos ( NOMBRE\_CAMPO  = VALOR)

Para obtener mayor exactitud en la búsqueda, se recomienda el uso de los filtros exactos los cuales harán una búsqueda más refinada. Su uso es similar a los filtros parciales solo será necesario anteponer el símbolo “=” al nombre del campo como se muestra a continuación

**Ejemplo 4:** Filtro exacto para obtener todos los inmuebles tipo venta de la ciudad de Bogotá

![](https://lh3.googleusercontent.com/GC-jQXQ5zacKTP3mOuuVdWkoRTRzTtdAGYxrrriuYvgCMnozEs9rJLULlRqUUETb4ND6k8TpLhRsPn-mtdVqLJqzmSKafODngTAzkEnOxIWvD-Zp3aeNL86IUPsOEgwIWk-OZBnp)

## 3. Ordenamiento

Si desea ordenar use la palabra **sort** seguido del tipo de  ordenamiento y el nombre de columna

**Ejemplo 5:** Como se ve en la figura si desea ordenar de forma descendente agregue el signo negativo a la columna, si no lo agrega el ordenamiento por defecto será ascendente.

```bash
https://api.nuwwe.com/api/inmueble?sort=-vlr_canon 
```

![](https://lh4.googleusercontent.com/2mum7RHirrUEK829pRQzwLH1W0hwr5WPAY7as_Bgbgn9_57UYy6TjZgfWzl9nC_82K-ZJPjQz9K8rNKXYQGxvBPrzai7JITsZfVBpkslYmZE0Qwp00KzVtdi1aaHUVuPmHW9MFl4)

## 4. Filtros de rangos

Para algunos campos es útil realizar filtros por rangos, esto será útil para campos que sean tipo fecha o numérico, los siguientes filtros estarán disponibles:

* Menor a: anteponer before  al nombre del campo before\_nombre\_campo
* Mayor a: anteponer after  al nombre del campo after\_nombre\_campo
* Entre: anteponer between al nombre del campo between\_nombre\_campo

**Ejemplo 5:** El siguiente filtro obtendrá todos  los inmuebles  con valores de canon menor o igual  a 1000000 ordenamos de forma descendente

```bash
https://api.nuwwe.com/api/inmueble?sort=-vlr_canon&filter%5Bbefore_vlr_canon%5D=1000000
```

![](https://lh6.googleusercontent.com/usiGio6ULaQjuJXtlREtiIEF_j4_lLV6h_D_psf7E7Avyw4OKJbrIQh1ltGr6puwhxP7ug2uuSwJofI0E-BufiLah8jGEv924sXy8-YsE74OTdF_cQKkT2pmvSRdZJsgE2cMDg4S)

**Ejemplo 6:** El siguiente filtro obtendrá todos  los inmuebles  con valores de canon mayor l a 1000000 ordenamos de forma descendente.

```bash
https://api.nuwwe.com/api/inmueble?sort=-vlr_canon&filter%5Bafter_vlr_canon%5D=1000000
```

![](https://lh6.googleusercontent.com/hB7eu8-XXeWyD1r55uw-r7t2Cczfuc6jY0yY2MY28ZZlqnyYC7-wPK_ZMDtOPiMZ52BGY_8YncPxLBJmuI8Q4VK0V15A5G-ZiFMNYeM0IZvJDofFON8_jOK1FY0kA7j40W0dIVJZ)

**Ejemplo 7:** El siguiente filtro obtendrá todos  los inmuebles  con valores de canon mayor entre 600000 y 1000000 ordenamos de forma ascendente

```bash
https://api.nuwwe.com/api/inmueble?sort=vlr_canon&filter%5Bbetween_vlr_canon%5D=600000,1000000
```

![](https://lh3.googleusercontent.com/2ki3lX8LITmRybEaz1Xz47bsZUfkk3SDZ3EO-hS3RYbMohUGyP0flkZOsL2Qs7Tx6SSgue8kq2Vt_fxydXOxBEsZEVCr_5rUByJPRTHNL3Y6J-4oqnRzP1Uz79LuHf8vwi9GtCd6)

{% hint style="info" %}
**Nota:** estos filtros aplica para los endpoints de inmueble, cliente, solicitudes, solo debemos cambiar la variable dentro del filter.\
**Ejemplo:** filter\[xxxxxxxxxxxx]
{% endhint %}

```bash
https://api.nuwwe.com/api/solicitud?filter%5Bnro_solicitud%5D=519846
```

![](/files/-MbqWJOxiMLVb9EMGyRJ)

```bash
https://api.nuwwe.com/api/cliente?filter%5Bcod_cliente%5D=741842748
```

![](/files/-Mbq_5ak9ne-wfYS0WMo)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://api-nuwwe.gitbook.io/api-nuwwe-1/filtros/filtros-api-nuwwe.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
