Metafields de producto

Campos personalizados con tipado estricto para almacenar datos arbitrarios en productos.

Listar metafields

GET /api/v1/catalog/products/:id/metafields

Respuesta 200:

{
  "data": [
    {
      "id": "uuid",
      "product_id": "uuid",
      "variant_id": null,
      "namespace": "specs",
      "key": "material",
      "value": "100% algodón",
      "value_type": "string",
      "created_at": "2026-04-08T12:00:00Z",
      "updated_at": "2026-04-08T12:00:00Z"
    }
  ]
}

---

Crear metafield

POST /api/v1/catalog/products/:id/metafields

{
  "namespace": "specs",
  "key": "material",
  "value": "100% algodón",
  "value_type": "string"
}

Campo	Requerido	Descripción
namespace	Sí	Agrupador lógico (ej: specs, seo, custom)
key	Sí	Nombre del campo
value	Sí	Valor (debe coincidir con el value_type)
value_type	Sí	Tipo de dato del valor
variant_id	No	UUID de variante específica

Tipos de valor válidos:

value_type	Formato del valor
string	Texto libre
integer	Número entero
decimal	Número decimal
boolean	true o false
json	Objeto o array JSON válido
date	YYYY-MM-DD
datetime	YYYY-MM-DDTHH:MM:SSZ
url	URL completa con scheme
color	Hex con # (ej: #ff5733)
reference	UUID

Respuesta 201: objeto Metafield completo.

---

Actualizar metafield

PATCH /api/v1/catalog/products/:id/metafields/:metafield_id

Solo actualiza el valor.

{
  "value": "95% algodón, 5% elastano"
}

---

Eliminar metafield

DELETE /api/v1/catalog/products/:id/metafields/:metafield_id

Respuesta 204 No Content