VTEX Condiciones comerciales

Cómo configurar las condiciones comerciales de VTEX con el V2 Widget#

VTEX permite a los comerciantes utilizar condiciones comerciales para agrupar un conjunto de productos (SKU) en la plataforma. A través de estas condiciones comerciales, VTEX permite al comerciante decidir mediante qué condición de pago (método de pago) procesar la transacción del comprador.

Beneficios

VTEX permite configurar diferentes proveedores de pago y asociarlos a condiciones de pago en las que se pueden activar condiciones comerciales (SKU) específicas. Sin embargo, este proceso puede presentar algunos desafíos:

1. Limitaciones del proveedor: Es posible que algunos proveedores de pago que utilice no estén disponibles en los conectores VTEX. Por lo tanto, no se puede asociar una condición comercial a un proveedor no disponible.
2. Habilitación de pago integrada: A diferencia de VTEX, que actualmente no soporta el uso de condiciones de pago en modalidades embebidas (app de pago) debido a limitaciones en su protocolo de pago, nuestro Widget permite integrar estas funcionalidades, ofreciendo una experiencia de pago mejorada.
3. Experiencia de pago: No todos los proveedores de VTEX ofrecen una experiencia de pago integrada. La configuración de diferentes proveedores da como resultado la aparición de múltiples botones en el proceso de pago, lo que puede confundir al comprador y afectar negativamente la experiencia de compra.
4. Configuración sencilla: Con el widget DEUNA sólo necesitas configurar una condición de pago (DeunaNow) para gestionar todas las condiciones comerciales deseadas desde una única condición de pago.

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

Requisitos

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

Pasos

1. Configurar PSP en DEUNA para condiciones comerciales
2. Configurar método de pago en VTEX
3. Configurar reglas en DEUNA para procesar cuotas con condiciones comerciales

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

Antes de realizar la configuración en tu tienda VTEX, es importante que puedas configurar tu PSP en DEUNA. Para ello, debes seguir estos pasos:

• Ingresa a tu administrador DEUNA con tu usuario y contraseña. Luego seleccione el módulo "Conexiones"
• Añade tu PSP y configura las credenciales. Para soportar las condiciones comerciales, sugerimos agregar múltiples conexiones de tu PSP usando la siguiente nomenclatura:

PSP Name - VTEX commercial condition name

Detalles de nomenclatura

• Nombre de PSP: Nombre de la PSP que estás configurando. Ejemplo: mercadopago
• Nombre de condición comercial VTEX: El nombre que identifica la condición comercial que utilizará, el cual se construye con: nombre de la condición + porcentaje de activación de regla en VTEX. Ejemplo: artículos estacionarios > 20%

En el siguiente tutorial te mostramos cómo realizar esta configuración.

DEUNA Admin - Configuración de PSP para condición comercial en VTEX

Una vez que termine esta configuración, puede continuar con el siguiente paso.

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

Para 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 admita cuotas con condiciones comerciales.

• Agregar un método de pago: Agregue el método de pago DeunaNow. Recomendamos utilizar un nombre descriptivo que identifique el nombre de la regla que utilizará. (En la tabla adjunta puedes encontrar un ejemplo de nombre de regla)
• Activar cuotas para condición de pago: Una vez que agregues el método de pago DeunaNow, asigna un conector y agrega el nombre. Debes presionar la opción “Número total de cuotas”.
• Identificador asociado: En el campo “Número total de cuotas”, se debe ingresar una combinación del número máximo de cuotas permitidas junto con el identificador de condición comercial adjunto en la tabla, según la siguiente nomenclatura:

[Maximum number of installments to show in widget],[Commercial condition identifier]

Detalles de nomenclatura

• Número máximo de cuotas para 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 le pueden ofrecer al cliente durante el proceso de compra.
• Identificador de condición comercial: Es un número asignado a cada condición comercial, establecido en la tabla de identificación adjunta. Este identificador permite a DEUNA reconocer la condición comercial específica aplicada a la transacción.

Ejemplo práctico

Si tienes una condición comercial que permite pagos hasta en 6 cuotas y está asociada al identificador 50 (artículos estacionarios > 20%) de la tabla de condiciones, debes ingresar en el campo 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 su tienda.

En el siguiente tutorial te mostramos cómo 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 condición comercial configurado en VTEX no será mostrado al comprador.

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

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

• Ingresa al administrador de DEUNA con tu usuario y contraseña, y selecciona el módulo “Estrategias de Pago”
• Presione el botón "Crear regla específica" y agregue un nombre a la regla. Sugerimos utilizar un nombre que permita identificar la regla de condición comercial. Luego presione el botón "Ir al siguiente paso"
• En la sección “Agregar condiciones” debes presionar el botón “Agregar condición +” y debes buscar la opción “Metadatos”
• En Metadatos es importante que utilices el nombre de la variable "condición_comercial", escriba el formato "Texto", Propiedades: "({}) Contiene" y agregue el número de identificador que utilizó en el paso anterior. Ejemplo: 50 (Correspondiente a artículos estacionarios > 20%)
• Una vez que agregue esta información presione el botón "Guardar metadatos" y luego presione el botón "Guardar" para ir al siguiente paso.
• Una vez que regrese a la sección "Crear una regla específica", presione el botón "Ir al siguiente paso".
• En la sección "Definir orden de procesamiento de transacciones" presione el botón "Editar ruta", seleccione el procesamiento (conexión) que configuró para la condición comercial. Ejemplo: "Mercadopago - Papelería Especial".
• Seleccione la regla de procesamiento y presione el botón "Guardar". Con esto has terminado de configurar la regla específica para tu condición comercial.

En el siguiente tutorial te mostramos cómo realizar esta configuración.

Configurar regla en DEUNA para soportar cuotas con condición comercial VTEX

Tabla de ejemplo de condiciones comerciales con identificador para DEUNA#

En la siguiente tabla le proporcionamos un ejemplo de nombres 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 sugerimos utilizar un número mayor o igual a 49 para poder identificarla en DEUNA.

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

Agregamos la siguiente tabla con ejemplos sugeridos para identificar sus condiciones comerciales, donde:

• Nombre de la regla de condición comercial: Es el nombre de la condición comercial seguido de la regla que configuras en el método de pago que es válido.
• Identificador: Identificador que utiliza el widget DEUNA para poder identificar qué condición comercial se debe utilizar. Este identificador será utilizado cuando realice el paso de configuración de Cuotas con soporte de condiciones comerciales de 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 diferentes productos (SKU) para definir escenarios de pago específicos (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 le permite establecer, con base en un porcentaje del total del carrito, cuándo se activará esa condición comercial. Por ejemplo, consideremos una tienda VTEX donde vendes los siguientes productos:

Como propietario de la tienda, es posible que desees establecer condiciones comerciales que agrupen los productos en categorías como Ropa y Tecnología. Además, es posible que desees que las transacciones de Ropa se procesen a través de MercadoPago (condición de pago) y Tecnología a través de Stripe (condición de pago).

Podrías configurar las reglas de la siguiente manera: si el total de productos de Ropa supera el 20% del total del carrito, entonces serán procesados por MercadoPago. Del mismo modo, si el total de productos tecnológicos supera el 20% del total del carrito, Stripe los procesará. Así es como se configuraría:

Escenarios de ejemplo:

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

La condición comercial de Ropa, que supere el 80% del total del carrito, se tramitará a través de MercadoPago. Por su parte, la condición Tecnología, que representa el 16% del total, no se encuentra activada.

• Escenario 2: Un comprador compra 1 celular, 1 computadora, 1 tableta y 1 camiseta.

La condición comercial Tecnología supera el 90% del total del carrito y será procesada a través de Stripe, mientras que Ropa, que representa sólo el 4,55%, no está activada.

En resumen, las condiciones comerciales en VTEX permiten al comerciante procesar transacciones a través de diferentes condiciones de pago (métodos de pago como MercadoPago o Stripe, etc), dependiendo de la configuración que realice en función del porcentaje total del carrito. Esto facilita la gestión de diferentes PSP según la configuración de pago.