# GET en APIs con utilización de filtros

**URL:** <https://bc.finneg.com/t/get-en-apis-con-utilizacion-de-filtros/5655>\
**Category:** App Builder\
**Tags:** api, cómo-se-hace\
**Created:** [11 Agosto, 2025 21:11 UTC](https://bc.finneg.com/t/get-en-apis-con-utilizacion-de-filtros/5655 "2025-08-11T21:11:12Z")\
**Posts on this page:** 1\
**Page:** 1

<div class="post-metadata">

**Author:** ![AcademiaFinnegans](https://bc.finneg.com/user_avatar/bc.finneg.com/academiafinnegans/32/23146_2.png) [@AcademiaFinnegans](https://bc.finneg.com/u/AcademiaFinnegans)\
**Post date:** [11 Agosto, 2025 21:11 UTC](https://bc.finneg.com/t/get-en-apis-con-utilizacion-de-filtros/5655/1 "2025-08-11T21:11:13Z")

</div>

#### Comportamiento al ejecutar GET en APIs de Tipo Entidad cuando se aplica la utilización de filtros

La API **Filters** permite buscar cualquier selector del Diccionario de Datos al ejecutar el método GET.

En este caso se toma como ejemplo el Diccionario de Datos “Proveedor” de la Entidad “Proveedores”.

 ![image](https://bc.finneg.com/uploads/default/original/3X/f/f/ffc602d6d98c7e54c23ba5afcbdca8f541155d4d.png)

Dentro del Diccionario “Proveedor”, en la sección de “Selectores” se encuentran las queries que se ejecutan en el GET cuando se usa la API.

* * *

###### Comportamiento al ejecutar GET

- _Acceder al Diccionario de Datos desde Menú → Configuración → Diseño del espacio de trabajo → Datos._

- _Seleccionar el Diccionario de Datos “Proveedor”_

- _ **Ir a la solapa “Selectores”:** _ aquí se encuentran las queries que se ejecutan a través de la API. El orden de ejecución es el siguiente:

 ![image](https://bc.finneg.com/uploads/default/original/3X/f/0/f052fd53b12da5f97c5c30a02b2c2ed1494471bd.png)

- _ **Ir a la solapa “Selectores Adicionales”:** _ sirven para completar una query personalizada. Si se configuran, la API primero intenta ejecutar los selectores adicionales (antes de los principales que están en la solapa “Selectores”), siguiendo el orden mencionado en el punto 1 y 2.

 ![image](https://bc.finneg.com/uploads/default/original/3X/0/3/03700c550a8075e646c2c5fbca8c97ab857243a0.png)

> ⚠  
> _ **Importante:** _ _en la sección “Campos” es posible configurar múltiples filtros; sin embargo, en el parámetro “filtroString”, al ejecutar la API, solo se podrá utilizar un filtro por cada ejecución._

##### Parámetros

 ![image](https://bc.finneg.com/uploads/default/original/3X/e/7/e78f85c9292834890714df246b455aac48431218.png)

- **filtroString:** admite un solo valor y corresponde a los filtros configurados en el diccionario de datos, en la seccion “Campos” de la solapa “Selectores”.  

- **access\_token:** autenticación que permite poder consumir una API. Más información en [obtener token.](https://bc.finneg.com/t/como-generar-el-token-para-las-apis/2827)

- **camposAdicionales:** admite más de un valor y trae los campos de la Entidad.

- **diccAlias:** corresponde al código del diccionario de datos que se quiere ejecutar.  

##### Pasos a seguir

1. Ingresar a Postman
2. Completar los parámetros.
  - En “filtroString” utilizaremos _CUIT_ previamente configurado en el Diccionario de Datos,
  - Para “camposAdicionales” en Postman seleccionaremos para que devuelva todos los campos de la Entidad Proveedores con asterisco (\*)
  - En diccAlias utilizaremos el codigo “PROVEEDOR”

3. Al ejecutar la API vemos que retorna el Proveedor corresponde al CUIT ingresado en el parámetro “filtroString”.  
 ![image](https://bc.finneg.com/uploads/default/original/3X/2/5/25b7f7154b3202a0408bda847de50ddb427d3bff.png)  
 ![image](https://bc.finneg.com/uploads/default/original/3X/7/0/70b53c5c8108b0c3110d7f314e70f249a68ac568.png)
4. Si se agregan valores específicos para el parámetro “camposAdicionales” vemos que retorna la información correspondiente para ese Proveedor, según lo definido en el parámetro.  
 ![image](https://bc.finneg.com/uploads/default/original/3X/5/c/5cc9a888ba23a2f63f0b5ac5c18be1a28360ed20.png)