> ## Documentation Index
> Fetch the complete documentation index at: https://a3erpapi.appcloud.es/llms.txt
> Use this file to discover all available pages before exploring further.

# Vistas: ejecuta consultas SQL personalizadas en A3ERP

> Ejecuta vistas SQL del diccionario JNCApi para obtener datos de A3ERP. Descubre los campos disponibles y aplica filtros y ordenación en tus consultas.

Las vistas son consultas SQL personalizadas que permiten obtener datos de A3ERP de forma flexible y adaptada a tus necesidades. Para poder ejecutarlas a través de la API, deben estar previamente registradas en el diccionario **JNCApi** mediante la herramienta **CfgVistas.exe**. Las vistas se cargan en memoria cuando el servicio arranca, por lo que cualquier cambio en su configuración requiere reiniciar el servicio para que surta efecto.

<Warning>
  Solo se pueden ejecutar vistas que estén registradas en el diccionario JNCApi. Las vistas creadas en otros diccionarios no son accesibles a través de este endpoint.
</Warning>

Para obtener instrucciones detalladas sobre cómo registrar vistas en el diccionario JNCApi, consulta la guía de [configuración de vistas y procedimientos](/conceptos/vistas-y-procedimientos).

***

## GET — Ejecutar una vista

Ejecuta la vista indicada y devuelve su conjunto de resultados en formato JSON.

```http theme={null}
GET https://servidor:<puerto>/api/vista/{vista}
```

**Ejemplo:**

```http theme={null}
GET https://servidor:5555/api/vista/Api_Vinculos
```

### Parámetros

<ParamField path="vista" type="string" required>
  El nombre de la vista tal como está registrada en el diccionario JNCApi.
</ParamField>

<ParamField header="Authorization" type="string" required>
  Token de autenticación en formato `Bearer <JWT_token>`.
</ParamField>

### Respuesta

<ResponseField name="200" type="array">
  Devuelve el resultado de la vista en formato JSON. La estructura depende de los campos definidos en la consulta SQL de la vista.
</ResponseField>

***

## GET — Descubrir los campos de una vista

Antes de ejecutar una vista, puedes consultar qué campos devuelve utilizando el endpoint de campos:

```http theme={null}
GET https://servidor:<puerto>/api/campos/{vista}
```

**Ejemplo:**

```http theme={null}
GET https://servidor:5555/api/campos/Api_Vinculos
```

<ParamField path="vista" type="string" required>
  El nombre de la vista cuya estructura de campos deseas consultar.
</ParamField>

<ParamField header="Authorization" type="string" required>
  Token de autenticación en formato `Bearer <JWT_token>`.
</ParamField>

***

## Filtrado y ordenación

Las vistas admiten los mismos mecanismos de filtrado y ordenación que el resto de endpoints de la API. Puedes encadenar los segmentos `/filtro/{filtro}` y `/order/{campo}` a la URL base:

```http theme={null}
GET https://servidor:5555/api/vista/Api_Vinculos/filtro/codcli='0001'/order/fecha
```

Consulta la página de [paginación y filtrado](/conceptos/paginacion-y-filtrado) para ver todos los operadores disponibles y ejemplos detallados.