> ## 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.

# Tablas auxiliares: almacena y consulta datos personalizados

> Usa los endpoints de tabla para leer, insertar, modificar y eliminar datos en tablas auxiliares personalizadas del usuario en A3ERP.

Los endpoints de tablas auxiliares te ofrecen acceso CRUD completo a las tablas personalizadas del usuario registradas en A3ERP. Con ellos puedes consultar, insertar, modificar y eliminar registros de cualquier tabla auxiliar configurada, lo que te permite integrar datos propios dentro del ecosistema de A3ERP sin necesidad de intervención directa en la base de datos.

***

## GET — Consultar tabla

Devuelve todos los registros de la tabla auxiliar indicada.

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

**Ejemplo:**

```http theme={null}
GET https://servidor:5555/api/tabla/TESTING
```

### Parámetros

<ParamField path="tabla" type="string" required>
  El nombre de la tabla auxiliar a consultar.
</ParamField>

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

### Respuesta

```json theme={null}
[
  {
    "id": 1,
    "name": "Angel",
    "value": "80AF63C0C"
  }
]
```

***

## POST — Insertar registro

Añade un nuevo registro a la tabla auxiliar indicada. Los campos del cuerpo deben corresponderse con las columnas de la tabla.

```http theme={null}
POST https://servidor:<puerto>/api/tabla/{tabla}
```

**Ejemplo:**

```http theme={null}
POST https://servidor:5555/api/tabla/TESTING
```

### Parámetros

<ParamField path="tabla" type="string" required>
  El nombre de la tabla auxiliar en la que se insertará el registro.
</ParamField>

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

<ParamField body="json" type="object">
  Objeto JSON con los pares campo-valor a insertar. Los campos deben coincidir con las columnas de la tabla.
</ParamField>

### Cuerpo de ejemplo

```json theme={null}
{
  "name": "Pedro",
  "value": "35G3FC324X4G"
}
```

### Respuesta

```
Insertados correctamente los datos en {Tabla}
```

***

## PUT — Modificar registro

Actualiza los campos de un registro existente en la tabla auxiliar. La condición de búsqueda se pasa como parámetro de ruta en formato de cláusula SQL `WHERE`.

```http theme={null}
PUT https://servidor:<puerto>/api/tabla/{tabla}/{condicion}
```

**Ejemplo:**

```http theme={null}
PUT https://servidor:5555/api/tabla/TESTING/id=1
```

### Parámetros

<ParamField path="tabla" type="string" required>
  El nombre de la tabla auxiliar que se va a modificar.
</ParamField>

<ParamField path="condicion" type="string" required>
  Condición SQL que identifica el registro a modificar (equivalente a una cláusula `WHERE`). Por ejemplo: `id=1`.
</ParamField>

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

<ParamField body="json" type="object">
  Objeto JSON con los pares campo-valor a actualizar.
</ParamField>

### Cuerpo de ejemplo

```json theme={null}
{
  "name": "Pedro",
  "value": "35G3FC324X4G"
}
```

### Respuesta

```
Modificados correctamente los datos en {Tabla}
```

***

## DELETE — Eliminar registro

Elimina el registro o los registros de la tabla auxiliar que cumplan la condición indicada.

```http theme={null}
DELETE https://servidor:<puerto>/api/tabla/{tabla}/{condicion}
```

**Ejemplo:**

```http theme={null}
DELETE https://servidor:5555/api/tabla/TESTING/id=1
```

### Parámetros

<ParamField path="tabla" type="string" required>
  El nombre de la tabla auxiliar de la que se eliminará el registro.
</ParamField>

<ParamField path="condicion" type="string" required>
  Condición SQL que identifica el registro a eliminar (equivalente a una cláusula `WHERE`). Por ejemplo: `id=1`.
</ParamField>

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

### Respuesta

```
Eliminados correctamente los datos en {Tabla}
```