Variaciones de Ítems

Un mismo producto puede venir en varias versiones: por color, talla, material o cualquier otra característica. En lugar de crear un ítem por cada combinación, Zauru las agrupa como variaciones usando un Ítem Maestro (el producto base) y varios Ítems Hijos (cada versión), vinculados por el campo "Ítem Maestro".

Cómo funcionan

Cada variación se describe con atributos: pares clave-valor con un color opcional. Por ejemplo, una camisa puede tener las variaciones:

Variación	Color	Talla
Camisa roja M	Rojo	M
Camisa roja L	Rojo	L
Camisa azul M	Azul	M

La clave se comparte entre todas las variaciones (todas tienen "Color" y "Talla"); lo que cambia es el valor. Por eso el editor se ve como una tabla: cada fila es un ítem (maestro o hijo) y cada columna es un atributo.

El color de cada atributo es opcional y sirve para identificar la variación de un vistazo, por ejemplo en el listado o en el punto de venta.

Cuando actualiza el maestro, los hijos heredan automáticamente las claves de sus atributos para mantener la consistencia entre todas las variaciones.

Antes de empezar

Las variaciones son ítems normales de su catálogo. Antes de vincularlas:

1. Cree el ítem que será el maestro.
2. Cree los ítems que serán las variaciones (uno por cada versión).

Después las vincula desde el editor de variaciones o desde el formulario del propio ítem.

Agregar o editar variaciones

1. Abra el detalle del ítem maestro.
2. Seleccione "Editar Variaciones".

Si abre las variaciones desde un ítem hijo, Zauru lo lleva directamente al maestro.

En el editor podrá:

• Agregar un atributo ("Nuevo Atributo"): crea una columna que se aplica a todas las variaciones.
• Agregar una variación: elija un ítem de la lista de "ítems similares" y quedará vinculado como hijo.
• Editar valores: escriba el valor de cada atributo y ajuste su color.
• Quitar una variación: desvincula el ítem hijo del maestro, sin borrarlo.

Para guardar, presione "Actualizar Variaciones".

Ítems similares

La lista para agregar variaciones muestra los ítems con código o nombre similar que aún no tengan maestro. Si necesita vincular cualquier ítem, active la opción "Mostrar todos los ítems al editar variaciones" en Configuraciones de la Entidad.

Vincular un ítem desde su formulario

También puede asignar el maestro desde el formulario de edición del ítem: en la sección "Variaciones" elija el "Ítem Maestro". Esta sección se muestra cuando existen ítems similares, y permite editar los atributos cuando el ítem tiene hijos o ya es hijo de un maestro.

API (llamadas desde sistemas externos)

Actualizar variaciones de ítem

curl -v \
  -H "Accept: application/json" \
  -H "Content-type: application/json" \
  -H "X-User-Email: prueba@zauru.com" \
  -H "X-User-Token: XSDFKK09238487DLFS" \
  -X PATCH \
  -d '{
    "id": "1",
    "items": [
      {
        "id": "2",
        "master_item_id": "1",
        "item_attributes_attributes": [
          {"key": "Color", "value": "Rojo", "color": "#FF0000"}
        ]
      }
    ]
  }' \
  https://app.zauru.com/settings/items/1/update_item_variations.json

Esto devolverá un JSON similar a este:

{
  "status": "ok"
}