Agendar demo
Valores de atributo
Catálogo API v1

Valores de atributo

Asigna el valor de un atributo a un producto o a un grupo. El destino es siempre uno de los dos — nunca ambos a la vez.

Campos

CampoTipoNotas
attribute_idnumberAtributo al que pertenece el valor
group_idnumberXOR con product_id. Usar para atributos role: spec
product_idnumberXOR con group_id. Usar para atributos role: axis
value_textstringPara data_type: text o enum
value_numbernumberPara data_type: number
value_booleanbooleanPara data_type: boolean

Solo uno de los tres campos de valor (value_text, value_number, value_boolean) debe estar presente, según el data_type del atributo. Los otros deben omitirse o enviarse como null.

Endpoints

PUT /catalog/attribute-values

Upsert por (attribute_id, destino): crea el valor si no existe, lo actualiza si ya existe. La clave lógica es la combinación de attribute_id + group_id o product_id.

Asignar talla a variante (axis)

{
  "attribute_id": 31,
  "product_id": 204,
  "value_text": "m"
}

Asignar material al grupo (spec)

{
  "attribute_id": 32,
  "group_id": 88,
  "value_text": "algodón"
}

Response 200 con el registro completo actualizado. 201 si se creó por primera vez.

GET /catalog/attribute-values

Lista de valores. Filtros: attribute_id, group_id, product_id.

DELETE /catalog/attribute-values

Borra el valor. Body: {"attribute_id": N, "product_id": M} (o group_id). 404 si no existe la combinación.