Agendar demo
Grupos de variantes
Catálogo API v1

Grupos de variantes

Un grupo es el contenedor del que cuelgan los productos que son variantes de un mismo artículo base. Por ejemplo: "Camiseta Azul" agrupa las variantes "Camiseta Azul Talla S", "Camiseta Azul Talla M" y "Camiseta Azul Talla L".

Campos

CampoTipoNotas
namestringreq
slugstringreqÚnico por tenant
category_idnumber
brand_idnumber
image_urlstringImagen representativa del grupo
descriptionstring

Los productos vinculan al grupo con product_id. Un grupo no tiene stock propio — el stock vive en cada producto/variante.

Endpoints

GET /catalog/groups

Lista de grupos. Filtros: category_id, brand_id, search, limit, offset.

GET /catalog/groups/{id}

Devuelve el grupo y la lista de sus variantes en el campo products.

POST /catalog/groups

Request

{
  "name": "Camiseta Azul",
  "slug": "camiseta-azul",
  "category_id": 11,
  "brand_id": 3
}

Response 201

{
  "id": 88,
  "name": "Camiseta Azul",
  "slug": "camiseta-azul",
  "category_id": 11,
  "brand_id": 3,
  "image_url": null
}
PATCH /catalog/groups/{id}

Actualiza cualquier campo editable del grupo. No mueve los productos ya vinculados.

DELETE /catalog/groups/{id}

409 si el grupo aún tiene productos vinculados (product_id activo). Desvincula los productos antes de borrar.