Atributos

Consultar los atributos

GET /api/v1/ecommerce/shop/attributes

No pide token. No recibe parámetros.

curl https://<dominio-de-la-empresa>/api/v1/ecommerce/shop/attributes \
  -H "Accept: application/json"

Respuesta

{
  "data": [
    {
      "id": 3,
      "description": "Talla",
      "type": "text",
      "values": [
        { "id": 12, "ecommerce_attribute_id": 3, "value": "L", "color": null },
        { "id": 11, "ecommerce_attribute_id": 3, "value": "M", "color": null },
        { "id": 10, "ecommerce_attribute_id": 3, "value": "S", "color": null }
      ]
    },
    {
      "id": 4,
      "description": "Color",
      "type": "color",
      "values": [
        { "id": 18, "ecommerce_attribute_id": 4, "value": "Azul", "color": "#1d4ed8" },
        { "id": 16, "ecommerce_attribute_id": 4, "value": "Negro", "color": "#111111" }
      ]
    }
  ],
  "success": true,
  "message": "Atributos de la tienda obtenidos de forma correcta."
}

Campo	Qué es
id	Identificador del atributo. Es el attribute_id del filtro de productos
description	Nombre del atributo para mostrar
type	color si cada valor tiene un color para pintar una muestra, o text si el valor se muestra como texto
values	Los valores del atributo
values[].id	Identificador del valor. Es el value_id del filtro de productos
values[].ecommerce_attribute_id	El atributo al que pertenece el valor
values[].value	Texto del valor, por ejemplo M o Azul
values[].color	Color del valor en #RRGGBB si el atributo es de color; si no, null

Solo aparecen los atributos activos, en el orden que definió la empresa. Los valores van ordenados alfabéticamente por value, como texto: 40 va antes que L, y L antes que M. Si la tienda no tiene atributos, la lista llega vacía.

Filtrar productos por atributo

Los ids de esta respuesta son los que usa el filtro attributes de productos: id del atributo como attribute_id y values[].id como value_id.

{ "attributes": [ { "attribute_id": 3, "value_id": 11 }, { "attribute_id": 4, "value_id": 18 } ] }

Esto devuelve los productos que tienen talla M y color azul entre sus atributos asignados en el ERP. El filtro no mira las variantes; ver productos.

No confundas estos ids con variants[].values[].id de un producto: ese es el identificador del valor dentro de la variante y no sirve para filtrar. Para relacionar una variante con un atributo, compara por nombre.

Si algo sale mal

HTTP	code	Cuándo	Qué hacer
404	STORE_NOT_FOUND	La tienda no está publicada	La empresa debe publicarla desde el ERP
503	STORE_PAUSED	La tienda está pausada	Reintenta más tarde (Retry-After)
429	RATE_LIMITED	Se superó el límite	Espera lo que indica Retry-After
500	INTERNAL_ERROR	Fallo del servidor	Reporta la reference