Como configurar condiciones comerciales de VTEX con Widget V2

VTEX permite a los comercios utilizar condiciones comerciales para agrupar un conjunto de productos (SKUs) en la plataforma. A través de estas condiciones comerciales, VTEX permite al comercio decidir por cual condición de pago (método de pago) realizar la transacción del comprador.

📘

Para obtener más información sobre las condiciones comerciales en VTEX, te invitamos a consultar el siguiente enlace: Qué es una condición comercial en VTEX ?

Beneficios

VTEX permite configurar diferentes proveedores de pago y asociarlos a condiciones de pagos en el cual puedes activar condiciones comerciales específicas (SKUs). Sin embargo, este proceso puede presentar algunos desafíos:

1. Limitación de proveedores: Algunos proveedores de pago que utilizas podrían no estar disponibles en los conectores de VTEX. Por lo cual no podrías asociar una condición comercial a un proveedor no disponible.
2. Habilitación de pagos embebidos: A diferencia de VTEX, que actualmente no soporta el uso de condiciones de pago en modalidades embebidas (payment app) debido a limitaciones en su protocolo de pagos, nuestro Widget permite integrar estas funcionalidades, ofreciendo una experiencia de pago mejorada.
3. Experiencia de pago: No todos los proveedores en VTEX ofrecen una experiencia de checkout embebida. Configurar distintos proveedores resulta en la aparición de múltiples botones en el checkout, lo que puede confundir al comprador y afectar negativamente la experiencia de compra.
4. Configuración sencilla: Con el widget de DEUNA, solo necesitas configurar una condición de pago (DeunaNow) para administrar todas las condiciones comerciales deseadas desde un única condición de pago.

Con estas ventajas, el Widget de DEUNA no solo mejora la funcionalidad y eficiencia al usar VTEX, sino que también eleva la experiencia de compra de tus clientes.

Requisitos

1. Cuotas configuradas en DEUNA
2. Credenciales de VTEX proporcionadas a equipo de DEUNA
3. Credenciales de PSP para realizar la configuración en DEUNA

Pasos

1. Configura los PSPs en DEUNA para condiciones comerciales
2. Configura el método de pago en VTEX
3. Configura reglas en DEUNA para procesar las cuotas con condiciones comerciales

Paso 1: Configuración de PSPs en DEUNA para condiciones comerciales

Antes de realizar la configuración en tu tienda de VTEX es importante que puedas configurar tu PSP en DEUNA, para esto debes seguir los siguientes pasos:

• Entrar a tu administrador de DEUNA con tu usuario y contraseña. Luego selecciona el módulo de "Conexiones"
• Agrega tu PSP y configura las credenciales. Para poder soportar condiciones comerciales te sugerimos agregar múltiples conexiones de tu PSP utilizando la siguiente nomenclatura:

Nombre de PSP - Nombre condicion comercial de VTEX

Detalles de la nomenclatura

• Nombre de PSP: Nombre del PSP que estás configurado. Ejemplo: Mercadopago
• Nombre condición comercial de VTEX: El nombre que identifique la condición comercial que utilizaras en donde esta esta construida por: nombre de la condicón + porcentaje de activación de la regla en VTEX. Ejemplo: stationary items > 20%

📘

Para encontrar más ejemplos de nombre de condición comercial te sugerimos revisar la sección: Tabla de ejemplo para condiciones comerciales con identificador para DEUNA

En el siguiente tutorial te mostramos como realizar esta configuración

Una vez finalices esta configuración, puedes pasar al siguiente paso.

Paso 2: Configuración de método de pago en VTEX

Para garantizar que DEUNA identifique correctamente las condiciones comerciales en VTEX, es fundamental realizar una configuración adecuada en el método de pago DeunaNow. Aquí te explicamos el proceso paso a paso, incluyendo cómo utilizar la nomenclatura correcta para que tu widget soporte cuotas con condiciones comerciales

• Agregar un método de pago: Agregar método de pago DeunaNow. Te recomendamos usar un nombre descriptivo que identifique el nombre de la regla que utilizarás. (En la tabla adjunta puedes encontrar un ejemplo de nombre de la regla)
• Activar cuotas para la condición de pago: Una vez agregas el método de pago de DeunaNow, asignas un conector y agregar el nombre. Debes presionar la opción "Total de número de cuotas".
• Asociar identificador: En el campo "Total de número de cuotas", debes ingresar una combinación del número máximo de cuotas permitidas junto con el identificador de la condición comercial adjunta en la tabla, según la siguiente nomenclatura:

[Número máximo de cuotas a mostrar en el widget],[Identificador de la condición comercial]

Detalles de la nomenclatura

• Número máximo de cuotas a mostrar en el widget: Corresponde al límite de cuotas que se configuró en el administrador de DEUNA. Este número define hasta cuántas cuotas se pueden ofrecer al cliente durante el proceso de compra.
• Identificador de la condición comercial: Es un número asignado a cada condición comercial, establecido en la tabla de identificación adjunta. Este identificador permite que DEUNA reconozca la condición comercial específica aplicada a la transacción.

Ejemplo práctico

Si tienes una condición comercial que permite pagos hasta 6 cuotas y está asociada con el identificador 50 (stationary items > 20%) de la tabla de condiciones, deberás ingresar en el campo de cuotas:

6, 50

Este formato asegura que DEUNA reconozca tanto el número máximo de cuotas permitidas como la condición comercial aplicable, facilitando el proceso de pago y asegurando la correcta aplicación de las políticas comerciales de tu tienda.

📘

La configuración de la cuota / installment "50" en VTEX no se va a mostrar como una opción de cuota / installment al cliente pues este valor no estará configurado como una opción de installment disponible desde el ADMIN de DEUNA.

En el siguiente tutorial te mostramos como realizar esta configuración

Importante:La configuración de cuotas realizada anteriormente, es referencial para que nuestro widget detecte la configuración. El identificador de la condición comercial configurado en VTEX no se mostrará al comprador.

Paso 3: Configuración de reglas en DEUNA para procesar las cuotas con condiciones comerciales

Luego de que hayas configurado el método de pago DeunaNow con el identificador de condición comercial en el paso anterior, es sumamente importante configurar las reglas en el admin de DEUNA. Con esto nuestro widget podrá identificar por cual condición comercial realizar el proceso de pago. Para realizar la configuración de reglas en DEUNA para procesar las cuotas con condiciones comerciales debes hacer lo siguiente:

• Entrar al administrador de DEUNA con tu usuario y contraseña, y seleccionar el módulo "Estrategias de pago"
• Presionar el botón "Crear regla específica" y agregar un nombre a la regla. Te sugerimos utilizar un nombre que te permita identificar la regla de la condición comercial. Luego presiona el botón "Ir al siguiente paso"
• En la sección "Agrega condiciones" debes presionar el botón "Agregar condición +" y debes buscar la opción "Metadata"
• En Metadata es importante que utilices el nombre de variable "commercial_condition", tipo de formato "Texto", Propiedades: "({}) Contiene" y agregar el número identificador que utilizaste en el paso anterior. Ejemplo: 50 (Correspondiente a stationary items > 20%)
• Una vez agregues esta información presiona el botón "Guardar metadato" y luego presionar el botón "Guardar" para ir al siguiente paso.
• Una vez vuelvas a la sección de "Crea una regla especifica" presiona el botón "Ir al paso siguiente"
• En la sección "Define el orden de procesamiento de la transacción" presiona el botón "Editar ruteo" selecciona el procesamiento (conexión) que configuraste para la condición comercial. Ejemplo: "Mercadopago - Special Stationary".
• Selecciona la regla de procesamiento y presiona el botón "Guardar". Con esto haz terminado de configurar la regla específica para tu condición comercial.

En el siguiente tutorial te mostramos como realizar esta configuración

📘

Para encontrar más ejemplos de nombre de condición comercial te sugerimos revisar la sección: Tabla de ejemplo para condiciones comerciales con identificador para DEUNA

Tabla de ejemplo para condiciones comerciales con identificador para DEUNA

En la siguiente tabla te proporcionamos un ejemplo de nombre de condiciones comerciales, con un identificador sugerido. El nombre de la regla de condición comercial hace referencia al nombre de la condición comercial que tienes en VTEX, por otro lado nosotros sugerimos utilizar un número mayor o igual a 49 para poder identificarlo en DEUNA.

Este número será el que configures dentro del administrador de DEUNA al momento de configurar reglas de procesamiento para el PSP.

Agregamos la siguiente tabla con ejemplos sugeridos para la identificación de tus condiciones comerciales, donde:

• Nombre de regla para condición comercial: Es el nombre de la condición comercial seguido de la regla que configuras en el método de pago que sea válido
• Identificador: Identificador que utiliza el widget de DEUNA para poder identificar que condición comercial debe utilizar. Este identificador se utilizará al momento que realices el paso Configuración de cuotas con soporte de condiciones comerciales para VTEX. El identificador debe ser mayor o igual al número 49

Qué es una condición comercial en VTEX ?

Una condición comercial en VTEX es un recurso que permite a los comerciantes agrupar distintos productos (SKUs) para definir escenarios específicos de pago (condiciones de pago) en la plataforma. Al configurar tu condición de pago con condiciones de pago especiales podrás activar la condición comercial. VTEX te permite establecer, basado en un porcentaje del total del carrito, cuándo se activará dicha condición comercial. Por ejemplo, consideremos una tienda en VTEX donde vendes los siguientes productos:

Como dueño de la tienda, podrías querer establecer condiciones comerciales que agrupen los productos en categorías como Vestuario y Tecnología. Además, podrías desear que las transacciones de Vestuario se procesen a través de MercadoPago (condición de pago) y las de Tecnología a través de Stripe (condición de pago).

Podrías configurar las reglas de la siguiente manera: si el total de los productos de Vestuario supera el 20% del total del carrito, entonces se procesarán por MercadoPago. De forma similar, si el total de los productos de Tecnología excede el 20% del total del carrito, entonces se procesarán por Stripe. Aquí tienes cómo se configuraría:

Escenarios de ejemplo:

• Escenario 1: Un comprador adquiere 10 camisetas y 10 pantalones, y también compra 1 celular.

La condición comercial de Vestuario, que supera el 80% del total del carrito, se procesará mediante MercadoPago. Por otro lado, la condición de Tecnología, que representa el 16% del total, no se activa.

• Escenario 2: Un comprador adquiere 1 celular, 1 computador, 1 tablet y 1 camiseta.

La condición comercial de Tecnología supera el 90% del total del carrito y se procesará mediante Stripe, mientras que la de Vestuario, que representa solo el 4.55%, no se activa.

En resumen, las condiciones comerciales en VTEX permiten al comerciante procesar transacciones mediante diferentes condiciones de pago (métodos de pago como MercadoPago o Stripe, etc), dependiendo de la configuración realizada en base al porcentaje total del carrito. Esto facilita el manejo de distintos PSPs según la configuración del pago.

Para más información sobre cómo funcionan las condiciones comerciales en VTEX, te invitamos a consultar su documentación:

• Registrar condición comercial [Link]
• Configurar condiciones de pago [Link]
• Configurar condiciones especiales de pago [Link]