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
#Nombre de regla para condici贸n comercial (ejemplo)Identificador
1tech items > 10%49
2stationary items > 20%50
3stationary items > 10%58
4preventa clothing items > 1%51
5stationary special items > 20%52
6clothing items > 20%53
7grocery items > 20%54
8personal care items > 20%55
9giftcard items > 20%56
10preventa tech items > 1%57

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:

Nombre del productoValor
Camiseta1000
Pantalon1500
Camisa1200
Vestido2500
Celular5000
Computador10000
Tablet6000

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:

#Condici贸n comercial en la condici贸n de pago de VTEXProductos asociadosResultado
1Vestuario > 20% del total del carritoCamiseta, Pantalon, Camisa, VestidoProcesa por MercadoPago
2Tecnolog铆a > 20% del total del carritoCelular, Computador, TabletProcesa por Stripe

Escenarios de ejemplo:

  • Escenario 1: Un comprador adquiere 10 camisetas y 10 pantalones, y tambi茅n compra 1 celular.
ProductoCantidadCondici贸n comercial a la que perteneceTotal
Camisetas10Vestuario10000
Pantalon10Vestuario15000
Celular1Tecnologia5000
TOTAL DEL CARRITO30000

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.
ProductoCantidadCondici贸n comercial a la que perteneceTotal
Celular1Tecnolog铆a5000
Computador1Tecnolog铆a10000
Tablet1Tecnolog铆a6000
Camiseta1Vestuario1000
TOTAL DEL CARRITO

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]