Buscar familias

GET /api/common/ventas/familias/buscarfamilia?page={page}&pageSize={pageSize} V4

Descripción

Endpoint para buscar familias de forma avanzada.

Permite realizar búsquedas dinámicas indicando:

• La columna sobre la que buscar (columnaBusqueda)
• El valor a buscar (valorBusqueda)
• El tipo de búsqueda (tipoBusqueda)

Además, se pueden limitar los campos devueltos mediante el parámetro campos.

---

Parámetros de consulta

Parámetro	Tipo	Requerido	Descripción
page	int	✅	Número de página
pageSize	int	✅	Cantidad de elementos por página
campos	string	❌	Lista de campos separados por comas
columnaBusqueda	string	❌	Campo sobre el que realizar la búsqueda (ej: descripcion)
valorBusqueda	string	❌	Valor a buscar
tipoBusqueda	enum	❌	Puedes hacer búsquedas exactas, parciales o que no contengan ese o eso valores.
codigoEmpresa	int	✅ (si es multiempresa)	Código de la empresa

---

El tipoBusqueda puede ser:

Note

* Completa
* Parcial
* DistintosDe

Ejemplo con filtros

# Buscar familias por descripción
curl -X GET "https://api.tandem.com/api/common/ventas/familias/buscarfamilia?page=1&pageSize=10&columnaBusqueda=descripcion&valorBusqueda=Materiales%20acabados&tipoBusqueda=Parcial&codigoEmpresa=9999" \
  -H "Authorization: Bearer tu_access_token"

Respuesta exitosa (200)

{
  "success": true,
  "message": "Familias encontradas",
  "result": {
    "data": [
      {
        "codigoEmpresa": 9999,
        "codigoFamilia": "Acabados",
        "codigoSubfamilia": "**********",
        "descripcion": "Materiales acabados",
        "%Margen": 0,
        "%Margen2": 0,
        "%Margen3": 0,
        "codigoArancelario": "",
        "colores_": 0,
        "grupoTalla_": 0,
        "grupoIva": 0,
        "grupoIvaCompras": 0,
        "%Descuento": 0,
        "%Descuento2": 0,
        "%Descuento3": 0,
        "%DescuentoCompras": 0,
        "%DescuentoCompras2": 0,
        "%DescuentoCompras3": 0,
        "codigoSeccion": "",
        "codigoProyecto": "",
        "codigoDepartamento": "",
        "trataNumerosSerieLc": 0,
        "codigoSerie": "",
        "imagenTactilSR": "",
        "descuentoMaxSR": 0,
        "periodoGarantiaSR": 0,
        "publicarInternet": 0,
        "idFamilia": "56747787-abb3-401c-9055-41146f7591ba",
        "publicarGCRM": -1,
        "cP_MostrarTPlant": -1
      }
    ],
    "totalRecords": 1,
    "totalPages": 1,
    "currentPage": 1,
    "pageSize": 10
  }
}