Esta funcionalidad solo está disponible para las tiendas desarrolladas con VTEX IO. Antes de seguir, debes instalar y configurar el Product Customizer en tu tienda.

Una assembly option es un anexo para escenarios complejos, como la personalización de productos en las que es necesario controlar diferentes combinaciones de productos, la cantidad, ítems adicionales, costes y la gestión de stock.

En el siguiente ejemplo, una tienda ofrece múltiples assembly options para el producto custom bell (campana personalizada). Estas opciones se muestran en la página de producto, donde el cliente puede seleccionar las opciones deseadas. Dependiendo de las opciones, puede haber un coste adicional para el SKU.

Puedes combinar distintos SKU para ofrecer assembly options, como los Bells add-ons Roman o los Bells add-ons 1-3 lines en el ejemplo anterior. Si un ítem está agotado, se mostrará como no disponible.

En este artículo, explicamos cómo empezar a utilizar las opciones de ensamblaje (Assembly Options) en tu tienda.

Hay dos formas de implementar las opciones de ensamblaje: utilizando la aplicación Assembly Options o la interfaz nativa de Campos personalizados del Catálogo.

Al implementar las opciones de ensamblaje en una cuenta de seller, las opciones de personalización del producto se mostrarán a los clientes de tu tienda en el checkout. Para que las opciones se muestren en la página del producto, debes implementar la funcionalidad en una cuenta de marketplace.

La aplicación Assembly Options, disponible para las tiendas desarrolladas con VTEX IO, proporciona una interfaz para configurar y gestionar las opciones de personalización. En este caso, la sintaxis de las opciones de ensamblaje y el anexo se generan automáticamente. Para más información sobre esta aplicación, lee la documentación sobre la Aplicación Assembly Options.

Para crear opciones de ensamblaje utilizando Campos personalizados en el Admin VTEX, primero debes crear manualmente una sintaxis para definir las reglas de personalización del producto. Después, debes insertar esa sintaxis en la configuración del anexo. Consulta las secciones a continuación para obtener más información.

Sintaxis de las assembly options

Para implementar una assembly option, primero debes crear una sintaxis, como la que se muestra a continuación, cambiando cada valor según tu escenario.

[0-3]#10000[1-2][1]pricetable1;#20000[0-2][0]pricetable2;#30000[0-2][0]pricetable3

El primer [x-y] corresponde a las reglas que se aplican al grupo, y entre cada # y ; se encuentran las reglas para los SKU. Aprende más sobre cada segmento de esta sintaxis en la siguiente tabla.

Segmento	Descripción
[0-3]#10000[1-2][1]pricetable1;#20000[0-2][0]pricetable2;#30000[0-2][0]pricetable3	Cantidad mínima y máxima de ítems que se pueden seleccionar del grupo. El primer segmento define cuántas opciones acepta esta assembly option en total. [0-3] significa que puedes seleccionar un mínimo de cero elementos y un máximo de tres. Si el valor es [1-1], significa que solo puedes seleccionar un elemento de entre todas las opciones.
[0-3]#10000[1-2][1]pricetable1;#20000[0-2][0]pricetable2;#30000[0-2][0]pricetable3	Después de cada #, debes incluir el ID del SKU del componente. Debes utilizar al menos un SKU en las assembly options.
[0-3]#10000**[1-2][1]pricetable1;#20000[0-2][0]pricetable2;#30000[0-2]**[0]pricetable3	Este segmento define la cantidad mínima y máxima de cada SKU que el cliente final puede seleccionar. Si el valor es [0-1], significa que puede haber hasta uno de este SKU.
[0-3]#10000[1-2]**[1]pricetable1;#20000[0-2][0]pricetable2;#30000[0-2][0]**pricetable3	Este segmento define la cantidad seleccionada por defecto para cada SKU.
[0-3]#10000[1-2][1]pricetable1;#20000[0-2][0]pricetable2;#30000[0-2][0]pricetable3	El último segmento indica la tabla de precios de cada ítem.

Configuración del anexo

Para agregar una assembly option, es necesario tener un adjunto ya creado. Consulta el artículo Registrar un anexo para aprender a crear uno.

Después de añadir un anexo y asociarlo a un SKU, sigue los pasos que se indican a continuación para configurar la assembly option.

1. En el Admin VTEX, accede a Catálogo, o escribe Catálogo en la barra de búsqueda en la parte superior de la página.
2. Haz clic en Campos personalizados.
3. En la pestaña Servicios y SKU, elige el anexo al que quieres añadir la assembly option y haz clic en Editar.
4. En el campo Valores permitidos, inserta la sintaxis que has creado, como se describe en la sección Sintaxis de las assembly options.
5. Haz clic en Guardar.