Condições Comerciais VTEX

Como configurar as condições comerciais da VTEX com o V2 Widget#

A VTEX permite que lojistas utilizem condições comerciais para agrupar um conjunto de produtos (SKUs) na plataforma. Através dessas condições comerciais, a VTEX permite que o lojista decida por qual condição de pagamento (forma de pagamento) processar a transação do comprador.

Benefícios

A VTEX permite configurar diferentes provedores de pagamento e associá-los a condições de pagamento nas quais você pode ativar condições comerciais (SKUs) específicas. No entanto, este processo pode apresentar alguns desafios:

1. Limitações do provedor: Alguns provedores de pagamento que você utiliza podem não estar disponíveis nos conectores VTEX. Portanto, não seria possível associar uma condição comercial a um fornecedor indisponível.
2. Ativação de pagamento incorporado: Diferentemente da VTEX, que atualmente não suporta a utilização de condições de pagamento em modalidades embarcadas (app de pagamento) devido a limitações em seu protocolo de pagamento, nosso Widget permite integrar essas funcionalidades, oferecendo uma experiência de pagamento aprimorada.
3. Experiência de pagamento: Nem todos os provedores da VTEX oferecem uma experiência de checkout integrada. A configuração de diferentes fornecedores resulta no aparecimento de vários botões no checkout, o que pode confundir o comprador e afetar negativamente a experiência de compra.
4. Configuração simples: Com o widget DEUNA você só precisa configurar uma condição de pagamento (DeunaNow) para gerenciar todas as condições comerciais desejadas a partir de uma única condição de pagamento.

Com essas vantagens, o DEUNA Widget não só melhora a funcionalidade e a eficiência na utilização da VTEX, como também eleva a experiência de compra dos seus clientes.

Requisitos

1. Parcelas configuradas no DEUNA
2. Credenciais VTEX fornecidas à equipe DEUNA
3. Credenciais PSP para realizar configuração em DEUNA

Passos

1. Configurar PSPs na DEUNA para condições comerciais
2. Configurar forma de pagamento na VTEX
3. Configure regras no DEUNA para processar parcelamentos com condições comerciais

Passo 1: Configuração do PSP no DEUNA para condições comerciais

Antes de realizar a configuração na sua loja VTEX, é importante que você configure seu PSP no DEUNA. Para fazer isso, você deve seguir estas etapas:

• Digite seu administrador DEUNA com seu nome de usuário e senha. Em seguida, selecione o módulo "Conexões"
• Adicione seu PSP e configure as credenciais. Para suportar as condições comerciais, sugerimos adicionar múltiplas conexões do seu PSP usando a seguinte nomenclatura:

PSP Name - VTEX commercial condition name

Detalhes da nomenclatura

• Nome PSP: Nome do PSP que você está configurando. Exemplo: Mercadopago
• Nome da condição comercial VTEX: O nome que identifica a condição comercial que você utilizará, que é construído por: nome da condição + percentual de ativação da regra na VTEX. Exemplo: itens estacionários > 20%

No tutorial a seguir mostramos como realizar esta configuração

DEUNA Admin - Configuração do PSP para condição comercial na VTEX

Depois de concluir esta configuração, você poderá prosseguir para a próxima etapa.

Passo 2: Configuração da forma de pagamento na VTEX

Para garantir que a DEUNA identifique corretamente as condições comerciais na VTEX, é fundamental realizar a configuração adequada no meio de pagamento DeunaNow. Aqui explicamos o passo a passo, inclusive como usar a nomenclatura correta para que seu widget suporte parcelamento com condições comerciais

• Adicione uma forma de pagamento: Adicione o método de pagamento DeunaNow. Recomendamos usar um nome descritivo que identifique o nome da regra que você usará. (Na tabela anexa você pode encontrar um exemplo de nome de regra)
• Ative o parcelamento para condição de pagamento: Depois de adicionar o método de pagamento DeunaNow, atribua um conector e adicione o nome. Você deve clicar na opção “Número total de parcelas”.
• Identificador associado: No campo “Número total de parcelas”, deve-se informar uma combinação do número máximo de parcelas permitidas junto com o identificador da condição comercial anexado na tabela, conforme a seguinte nomenclatura:

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

Detalhes da nomenclatura

• Número máximo de parcelas para mostrar no widget: Corresponde ao limite de parcelamento que foi configurado no administrador DEUNA. Esse número define até quantas parcelas podem ser oferecidas ao cliente durante o processo de compra.
• Identificador de condição comercial: É um número atribuído a cada condição comercial, estabelecido na tabela de identificação anexa. Este identificador permite à DEUNA reconhecer a condição comercial específica aplicada à transação.

Exemplo prático

Se você possui uma condição comercial que permite parcelamento em até 6x e está associada ao identificador 50 (itens fixos > 20%) da tabela de condições, deverá inserir no campo parcelamento:

6, 50

Este formato garante que a DEUNA reconhece tanto o número máximo de parcelas permitidas como a condição comercial aplicável, facilitando o processo de pagamento e garantindo a correta aplicação das políticas comerciais da sua loja.

No tutorial a seguir mostramos como realizar esta configuração

Importante: A configuração da parcela realizada acima é referencial para que nosso widget detecte a configuração. O identificador da condição comercial configurado na VTEX não será mostrado ao comprador.

Passo 3: Configuração de regras no DEUNA para processar parcelamentos com condições comerciais

Depois de ter configurado o meio de pagamento DeunaNow com o identificador de condição comercial no passo anterior, é extremamente importante configurar as regras no admin do DEUNA. Com isso, nosso widget poderá identificar por qual condição comercial realizar o processo de pagamento. Para realizar a configuração de regras no DEUNA para processar parcelamentos com condições comerciais, você deve fazer o seguinte:

• Entre no administrador DEUNA com seu nome de usuário e senha e selecione o módulo "Estratégias de Pagamento"
• Pressione o botão “Criar regra específica” e adicione um nome à regra. Sugerimos utilizar um nome que permita identificar a regra de condição comercial. Em seguida, pressione o botão "Ir para a próxima etapa"
• Na seção "Adicionar condições" você deve pressionar o botão "Adicionar condição +" e procurar a opção "Metadados"
• Em Metadados é importante que você utilize o nome da variável "condição_comercial", tipo de formato "Texto", Propriedades: "({}) Contém" e adicione o número identificador que você utilizou no passo anterior. Exemplo: 50 (correspondente a itens estacionários > 20%)
• Depois de adicionar essas informações pressione o botão "Salvar metadados" e depois pressione o botão "Salvar" para ir para a próxima etapa.
• Depois de retornar à seção "Criar uma regra específica", pressione o botão "Ir para a próxima etapa"
• Na seção “Definir ordem de processamento da transação” pressione o botão “Editar roteamento”, selecione o processamento (conexão) que você configurou para a condição comercial. Exemplo: “Mercadopago – Estacionário Especial”.
• Selecione a regra de processamento e pressione o botão “Salvar”. Com isso você finalizou a configuração da regra específica para sua condição comercial.

No tutorial a seguir mostramos como realizar esta configuração

Configurar regra no DEUNA para suportar parcelamento com condição comercial VTEX

Exemplo de tabela de condições comerciais com identificador para DEUNA#

Na tabela a seguir fornecemos um exemplo de nomes de condições comerciais, com uma sugestão de identificador. O nome da regra da condição comercial refere-se ao nome da condição comercial que você possui na VTEX, por outro lado sugerimos utilizar um número maior ou igual a 49 para poder identificá-la na DEUNA.

Este número será aquele que você configurará no administrador DEUNA ao configurar as regras de processamento para o PSP.

Acrescentamos a seguinte tabela com sugestões de exemplos para identificação das suas condições comerciais, onde:

• Nome da regra de condição comercial: É o nome da condição comercial seguido da regra que você configura na forma de pagamento que é válida
• Identificador: Identificador utilizado pelo widget DEUNA para poder identificar qual condição comercial deve ser utilizada. Este identificador será utilizado quando você realizar a etapa de configuração do Parcelamento com suporte às condições comerciais VTEX. O identificador deve ser maior ou igual ao número 49

O que é condição comercial na VTEX?#

Uma condição comercial na VTEX é um recurso que permite ao lojista agrupar diferentes produtos (SKUs) para definir cenários de pagamento (condições de pagamento) específicos na plataforma. Ao configurar sua condição de pagamento com condições especiais de pagamento, você poderá ativar a condição comercial. A VTEX permite estabelecer, com base em um percentual do total do carrinho, quando aquela condição comercial será acionada. Por exemplo, vamos considerar uma loja VTEX onde você vende os seguintes produtos:

Como dono da loja, você pode querer estabelecer condições comerciais que agrupem os produtos em categorias como Roupas e Tecnologia. Além disso, você pode querer que as transações de Vestuário sejam processadas através do MercadoPago (condição de pagamento) e de Tecnologia através do Stripe (condição de pagamento).

Você pode configurar as regras da seguinte forma: se o total de produtos de Roupas ultrapassar 20% do total do carrinho, eles serão processados pelo MercadoPago. Da mesma forma, se o total de produtos de Tecnologia ultrapassar 20% do total do carrinho, eles serão processados ​​pela Stripe. Veja como seria configurado:

Cenários de exemplo:

• Cenário 1: Um comprador compra 10 camisetas e 10 calças, e também compra 1 celular.

A condição comercial de Roupas que ultrapassar 80% do total do carrinho será processada através do MercadoPago. Por outro lado, a condição Tecnologia, que representa 16% do total, não está ativada.

• Cenário 2: Um comprador compra 1 celular, 1 computador, 1 tablet e 1 camiseta.

A condição comercial de Tecnologia ultrapassa 90% do total do carrinho e será processada através do Stripe, enquanto a de Vestuário, que representa apenas 4,55%, não é ativada.

Resumindo, as condições comerciais na VTEX permitem ao lojista processar transações através de diferentes condições de pagamento (meios de pagamento como MercadoPago ou Stripe, etc), dependendo da configuração feita com base no percentual total do carrinho. Isto facilita a gestão de diferentes PSPs de acordo com a configuração de pagamento.