Consultar tabla personalizada

GET /api/common/auxiliares/tablaspersonalizadas V4

Descripción

Devuelve una lista paginada de los registros de cualquier tabla del sistema, indicada por el parámetro nombreTabla. La tabla debe existir en la base de datos; en caso contrario se devuelve 404. Si se especifica el parámetro opcional campos (lista separada por comas), solo se devuelven esos campos; si no se especifica, se devuelven todos. Permite búsqueda por una o varias columnas (separadas por comas en columnaBusqueda) con uno o varios valores (separados por comas en valorBusqueda) y tres modos: Completa (igualdad exacta), Parcial (LIKE %valor%) y DistintosDe. Si la tabla contiene la columna CodigoEmpresa, el filtro se aplica automáticamente. Los parámetros page y pageSize son obligatorios.

Parámetros de consulta

Parámetro	Tipo	Requerido	Descripción
nombreTabla	string	✅	Nombre exacto de la tabla en la base de datos
page	int	✅	Número de página
pageSize	int	✅	Cantidad de registros por página
campos	string	❌	Campos a devolver, separados por comas. Si se omite, se devuelven todos
columnaBusqueda	string	❌	Columna(s) por las que filtrar, separadas por comas
valorBusqueda	string	❌	Valor(es) de búsqueda correspondientes a columnaBusqueda, separados por comas
tipoBusqueda	enum	❌	Modo de búsqueda (por defecto Parcial)
columnaOrden	string	❌	Columna por la que ordenar los resultados
ordenDescendente	bool	❌	true para orden descendente (por defecto false)
codigoEmpresa	int	✅ (si es multiempresa)	Código de la empresa

Valores de tipoBusqueda

Valor	Comportamiento
Parcial	Búsqueda LIKE %valor% (valor por defecto)
Completa	Igualdad exacta
DistintosDe	Registros cuyo valor sea distinto

Ejemplo con filtros

# Obtener la primera página de la tabla EmpVendedores filtrando por nombre
curl -X GET "https://api.tandem.com/api/common/auxiliares/tablaspersonalizadas?nombreTabla=EmpVendedores&page=1&pageSize=10&columnaBusqueda=NombreVendedor&valorBusqueda=Juan&tipoBusqueda=Parcial" \
  -H "Authorization: Bearer tu_access_token"

Respuesta exitosa (200)

{
  "success": true,
  "message": "Registros encontrados",
  "result": {
    "data": [
      {
        "CodigoEmpresa": 9999,
        "CodigoVendedor": 1,
        "NombreVendedor": "Juan García"
      }
    ],
    "totalRecords": 1,
    "totalPages": 1,
    "currentPage": 1,
    "pageSize": 10
  }
}

Respuesta sin resultados (404)

{
  "success": false,
  "message": "No se encontraron registros en la tabla 'NombreTabla'.",
  "result": null
}