Konduto é um antifraude, sistema externo que analisa as compras realizadas a fim de evitar fraudes.

Este antifraude depende de configurações diferentes dos demais antifraudes que podem ser configurados em sua plataforma. Por isto, este artigo tem como objetivo documentar a configuração do Konduto.

Configure seu GTM

GTM é o Google Tag Manager, uma ferramenta do Google que faz gerenciamento de tags no site. Esse GTM é então associado em sua conta e insere todas as tags configuradas nele em seu site. Veja mais detalhes sobre como configurar o GTM em sua loja.

Configure a variável

O primeiro passo é a configuração da variável. O nome da variável deve ser kondutoId, pois é o valor indicado no script abaixo. No valor da variável, insira o public_key informado pela Konduto – cada loja possui um id único.

Configure a tag

Em sua conta GTM, configure o script abaixo.

<script>
var __kdt = __kdt || [];__kdt.push({{kondutoId}});__kdt.push({"post_on_load": false});(
function() { var kdt = document.createElement('script');kdt.id = 'kdtjs';kdt.type = 'text/javascript';kdt.async = true;
kdt.src = 'https://i.k-analytix.com/k.js';var s = document.getElementsByTagName('body')[0]; s.parentNode.insertBefore(kdt, s); })();

$(function() { setTimeout(function(){setKondutoFingerPrint();}, 4500); }); 
var setKondutoFingerPrint = function(){ var kdtFP = Konduto.getVisitorID(); window.vtex.deviceFingerprint = kdtFP; Konduto.sendEvent('page','checkout'); }
</script>

Configure a afiliação de gateway

1. Acesse o módulo PCI Gateway;
2. Acesse Configurações;
3. Acesse a aba Afiliações de Gateways;
4. Clique em +;
5. Clique sobre o antifraude Konduto;
6. Preencha os campos do formulário com os dados indicados pelo antifraude (EntityCode);
7. Clique no botão Salvar.

Configure a(s) forma(s) de pagamento

1. Acesse a aba Condições de Pagamento;
2. Clique sobre a condição desejada ou crie a condição de pagamento;
3. Selecione a opção Usar antifraude;
4. Selecione o Konduto;
5. Clique no botão Salvar.

O produto visitado é a funcionalidade que envia e-mails para os clientes que navegaram por um produto em seu site mas não finalizaram compra. Esse e-mail tem como objetivo a recuperação da venda, enviando, além do produto abandonado, sugestões de novos produtos. Tudo isso é possível através de seu Master Data.

Defina um intervalo mínimo de disparo

Definir um intervalo de disparo significa limitar o tempo mínimo de espera entre um disparo e outro para o mesmo cliente. Isso evita que o cliente receba vários e-mails durante uma mesma navegação na loja.

Para configurar esse intervalo, é preciso criar um campo na entidade CL.

1. Acesse nomedaloja.ds.vtexcrm.com.br;
2. Acesse a aba Entidade de dados;
3. Na entidade Cliente, clique sobre o símbolo de lápis;
4. Clique no botão Novo campo;
5. Preencha os campos conforme indicação abaixo;
   • Nome: lastTrigger
   • Nome de exibição: Data do último trigger enviado
   • Tipo: Date and Time
6. Clique no botão Salvar.

Exiba os campos no formulário

Após criar um campo na entidade, é preciso configurar para que o campo seja exibido no formulário – assim, é possível ver os dados cadastrados nele. Isso também é válido para campos que criados automaticamente pela VTEX mas que não foram marcados para serem exibidos no formulário. Segue abaixo um manual de como exibir os campos que serão importantes para o cenário de Produto Visitado.

1. Acesse o módulo Master Data;
2. Na aplicação Profile System, clique no símbolo de engrenagem;
   
3. Clique no símbolo lápis sobre o formulário Cliente;
4. Clique na aba Schemas de Layout;
5. Clique no botão Incluir Nova seção;
6. Dê um nome para esta seção;
7. Na coluna Campos disponíveis, arraste o campo desejado até a área Campos da coluna 1, abaixo do nome da seção criada;
   
8. Clique no botão Salvar.

Crie o template de e-mail

O template do e-mail que será enviado, assim como no Carrinho Abandonado, é configurado no módulo CMS. Para auxiliar a configuração, use nosso template de exemplo.

1. Acesse o módulo CMS;
2. Clique em Portal;
3. Clique aqui para baixar o template de exemplo;
4. Clique em Templates de página;
5. Clique em novo template;
6. Preencha o nome e cole o código de seu template. Atenção! Se estiver usando o template de exemplo, lembre-se de alterar o código TEMPLATE_DE_PRATELEIRA pelo id de seu template de prateleira e o código NOME_DA_LOJA pela url de sua loja.
7. Clique no botão Salvar.

Entenda os produtos enviados

Perceba que o controle responsável por exibir o produto visitado é o ProductQueryStringReferenceShelf e o controle que exibirá a(s) prateleira(s) de similares é <vtex.cmc:productsCrossSelling … crossSellingType="1" /> com o parâmetro crossSellingType variando de 1 a 6, sendo:

• 1: Quem viu, viu também
• 2: Quem viu, comprou também
• 3: Quem comprou, comprou também
• 4: Produtos similares
• 5: Sugestões
• 6: Acessórios

As três primeiras prateleiras são montadas automaticamente pelo sistema e as três últimas são configuradas manualmente no cadastro de produto.

Crie a estrutura de pastas

Após criar o template, é preciso criar a estrutura de pastas necessária para a configuração da trigger. Siga o passo a passo abaixo.

1. Clique em Websites;
2. Clique sobre sua loja;
3. Clique na pasta /;
4. Clique na pasta CEM;
5. Clique em nova pasta;
6. Preencha os campos conforme abaixo;
   • Nome da Pasta: Produto-visitado
   • Protocolo: HTTP
   • Requer Autenticação: desmarcado
7. Clique no botão Salvar Pasta.

Após a criação da pasta, associe o template de página ao layout da página.

1. Clique na pasta criada;
2. Clique em novo layout;
   
3. Selecione o template criado anteriormente;
4. Clique no botão Salvar.

Configure a trigger de disparo do e-mail

1. Acesse nomedaloja.ds.vtexcrm.com.br;
2. Clique na aba Trigger;
3. Clique no botão Novo;
4. Insira o nome da trigger;
5. Em Status, marque Ativo;
6. Em Condição do trigger, selecione O valor de um atributo for alterado;
7. Em Informe o atributo, selecione Produto Visitado;
8. Em Filtro adicional, configure conforme abaixo:
   Checkout Está nulo and
   Produto Visitado Não está nulo and
9. Clique no botão Incluir grupo;
10. Clique em Incluir filtro e preencha conforme abaixo:
    Data do último trigger enviado Menor ou igual DATAL ATUAL – Subtrair dias – 7 or
    Data do último trigger enviado Está nulo
    
11. Clique na aba Agendamento;
12. Selecione uma das opções de envio. Ex.: Agendar execução para uma data dinâmica, [DATA ATUAL] mais 2 horas;
13. Clique na aba Ações em caso positivo;
14. Em Destinatário, como teste, digite seu e-mail e clique em Incluir e-mail estático. Quando já tiver testado, exclua seu e-mail e selecione Cliente: Email e clique em Incluir e-mail dinâmico;
15. Em Formato do corpo do e-mail, selecione HTML;
16. Em Nome do remetente, insira o nome de sua loja;
17. Em E-mail de resposta, preencha com o endereço de e-mail que o cliente poderá responder com dúvidas;
18. Em Origem do conteúdo, selecione Conteúdo de uma URL;
19. Preencha o campo Assunto;
20. Em Url, insira o endereço de sua loja com as pastas em que o layout do carrinho abandonado foi configurado. Ex.: nomedaloja.com.br/CEM/Produto-Visitadp;
21. Em Adicionar utm_source em todos os links com valor, preencha com “CEM”, para facilitar a identificação de compras pelo produto visitado;
22. Marque a opção Sobrescrever utm_source;
23. Clique no botão Salvar.

Este documento pertence ao artigo Como criar Promoções

Este tipo de promoção é usado para definir um preço máximo para um produto ou conjunto de produtos. Por exemplo, “smart tvs 40 polegadas por até R$ 2 mil no dia dos pais”, ou ainda “todas as camisas por até R$ 39,90 em setembro”.

Campos

Quais são os dados gerais desta promoção?

• Nome
  Nome da promoção
• Status
  Ativa ou inativa a promoção
• Descrição
  Descrição interna da promoção. Este campo é destinado ao uso interno na sua loja. Nele você pode deixar claro se a promoção se deve a alguma campanha, queima de estoque etc.
• Validade
  Data e horário de início e fim da promoção. É aqui que você define o período durante o qual a promoção será aplicada no site. Pode ser usada uma data de início futura. Caso seja configurada dessa forma, a promoção terá o status de agendada até que a data e o horário de início sejam atingidos. Enquanto a promoção estiver válida, ela terá o status de ativa, e ao término da data e horário definidos, o status será automaticamente alterado para inativo.
• Especificar dias da semana para ativação
  Essa opção é do tipo “caixa de seleção”. Quando marcada, disponibiliza sete outras caixas de seleção, para que sejam selecionados os dias da semana em que a promoção será aplicada. Se deseja que a promoção seja aplicada em qualquer dia da semana, não selecione essa opção.

Preço máximo por item

• Item
  Aqui deve ser inserido o nome ou o Id do SKU que você deseja incluir na promoção.
• Preço
  Aqui deve ser definido o preço máximo pelo qual será vendido o produto. Só é possível definir o preço máximo de um item por vez. Para adicionar produtos à promoção, use o botão +.

É possível fazer a importação de uma lista de SKUs, que deve estar salva em um arquivo .xml, com cada Id em uma linha diferente, seguido pelo nome e o preço máximo correspondentes. Para ver um modelo, clique em download de planilha exemplo.

Quais as condições para a promoção ser válida?

• Número máximo de parcelas
  Se desejar, você pode definir um número máximo de parcelas de pagamento como condição para que a promoção seja válida. Caso deseje que ela seja válida para qualquer número de parcelas, basta deixar a caixa de seleção ilimitado marcada.
• Utm_source
  O desconto será concedido caso a navegação seja realizada com a utm_source com o valor cadastrado.
• Utm_campaign
  O desconto será concedido caso a navegação seja realizada com a utm_campaign com o valor cadastrado.

Seller

Selecione o seller que oferecerá o desconto. Se possui multiloja, aparecerão aqui todos os sellers que estiverem cadastrados em sua conta. Esta opção possibilita condicionar um desconto diferente para cada seller.

Política comercial

Selecione as Políticas Comerciais que oferecerão o desconto. Serão listadas aqui todas as políticas que estiverem cadastradas em E-Commerce > Marketplace > Políticas Comercias. Essa opção possibilita oferecer descontos diferentes para cada uma delas.

O certificado SSL é necessário para que seja possível trafegar dados criptografados entre a loja e o cliente, através do protocolo HTTPS. Este certificado é sempre fornecido gratuitamente pela VTEX.

Até então, a compra, instalação e renovação era feita manualmente pela própria VTEX, tendo a Digicert como fornecedor.

Recentemente desenvolvemos uma automação que faz a emissão, instalação e renovação automaticamente através da Let’s Encrypt. É um processo muito mais escalável e seguro para nossas lojas, com o mesmo nível de qualidade.

Próximo da renovação do certificado emitido pela Digicert, é fundamental que as lojas que já estão no ar migrem para este novo processo e façam adesão ao processo automatizado.

O processo pode ser realizado por qualquer loja, assim que desejarem, mas estamos contatando todos individualmente para instruir como fazer a migração, e a data limite em que isso deve ocorrer. Todo o processo é amparado pela VTEX, seja via Professional Services, agência de atendimento, ou mesmo para os usuários que recorrem à Comunidade.

Como eu realizo a migração do meu SSL?

A emissão e instalação do novo certificado exige que o domínio de sua loja seja direcionado para o Hodor – sistema responsável pelo processo de gerar, instalar e renovar os certificados.

A tarefa de direcionar o domínio para o Hodor é realizada nos apontamentos de DNS de sua loja, aonde será removido ou alterado o CNAME atual e aplicadas as instruções do artigo Novo processo de SSL e GoLive.

Detalhando os três passos ilustrados no artigo acima:

1. Alterar o apontamento CNAME de WWW (ou equivalente), que estará direcionado para um domínio terminado em “vtexcommerce.com.br”, para hodor.vtex.com.
2. Após a propagação, acessar a loja em HTTPS. A requisição gerada irá emitir e instalar o novo certificado. Vale conferir se este foi emitido corretamente.
3. Tendo o certificado emitido, a loja poderá apontar seu domínio para o CNAME ssl.vtexcommerce.com.br.

Terei alguma indisponibilidade nos períodos de propagação do DNS?

Toda alteração nos apontamentos de DNS depende de um tempo para atingir toda a internet. Dessa forma, direcionar o domínio atual para o Hodor pode levar um tempo, e quando propagado deixará sua loja temporariamente fora do ar.

Assim que propagado, bastará conferir se o certificado foi emitido corretamente para que se faça o apontamento ao CNAME da VTEX, levando o site de volta ao ar.

É possível agilizar esse tempo de propagação, e por consequência a indisponibilidade, de duas formas:

• Reduzir o TTL (time to live) do domínio antes de realizar a primeira alteração no DNS. Nem todos serviços permitem essa alteração, mas se for possível ela irá fazer com que a internet verifique mudanças no seu domínio em um tempo mais curto, o que normalmente ocorre a cada 24 horas. Dessa forma, após tornar seu domínio de volta ao “vtexcommerce”, o site voltará ao ar mais rapidamente.
• Após a alteração do apontamento, acessar o domínio através de outras operadoras de internet, evitando o cache de DNS dos provedores. Ou seja, assim que apontar seu domínio para o Hodor vale tentar requisitar a páginas em HTTPS com, por exemplo, um 3G/4G de operadoras diferentes, forçando receber o novo certificado, assim já podendo tornar o domínio de volta ao “vtexcommerce”.

Devo remover o selo de segurança da Digicert?

Com esse novo certificado deixa de ser necessário o selo de segurança da Digicert no rodapé das lojas. Caso a loja possua este selo, deve removê-lo.
Note que este é um selo meramente informativo, que não realiza nenhum tipo de ação no site.

Opcionalmente, a loja pode substituí-lo por alguma informação personalizada sobre o uso do protocolo HTTPS em sua loja e os benefícios da criptografia oferecida.

É possível ativar um campo de observação na página de checkout, o texto preenchido neste campo será registrado no pedido e pode ser utilizado posteriormente pelo lojista. Este campo virá, por padrão, com sua exibição desabilitada. Para habilitá-lo é necessário inserir a seguinte regra no CSS:

.note { display: block; }

Este campo será apresentado da seguinte forma, no passo de pagamento:

Ele estará disponível via API, ao obter o pedido, no campo openTextField.

E, além disso, estará no JSON do Message Center, no campo openTextField. Ou seja, esse campo pode ser usado no template dos e-mails da loja.

Não é mais necessário solicitar a compra do certificado SSL (antes fornecido pela Digicert). O certificado agora é emitido via Let’s Encrypt e sua criação passou a ser responsabilidade da loja, a qual é feita momento do GoLive da loja.

São três etapas:

1. Apontar o DNS para o Hodor;
2. Acessar a loja em HTTPS para gerar o certificado;
3. Apontar o DNS para o Balance.

Apontar o DNS para o Hodor

Em sua hospedagem, crie uma entrada do tipo CNAME de www (ou o subdomínio correspondente) para hodor.vtex.com.

Aguarde a propagação.

Acessar a loja em HTTPS para gerar o certificado

Basta acessar o seu site especificando o protocolo HTTPS na URL. Assim que carregada, a página deverá retornar um certificado válido, que foi gerado instantaneamente neste primeiro acesso.

Para conferir se o certificado foi gerado corretamente, veja estes passos:

1. Em meu exemplo, a URL final da loja, com HTPS, é
   https://www.garrucho.com.br.
2. Com a geração do certificado SSL, será exibido o cadeado verde. Clique nele.
3. Na janela que foi aberta, clique em Detalhes.
4. Junto às informações do certificado, clique em View certificate.
5. Neste grupo de informações você pode confirmar o domínio para o qual o certificado foi emitido (o domínio de sua loja), quem emitiu (Let’s Encrypt Authority) e a validade (não se preocupe com o vencimento).

Apontar o DNS para o Balance

Note que, apesar do certificado emitido corretamente, o site apresenta a mensagem “The resource cannot be found“. Isto acontece porque o Hodor ainda está limitado à geração do certificado SSL, e não fornece o conteúdo da loja.

Sendo assim, após a geração do certificado SSL, devemos apontar o domíno para o Balance da VTEX.

1. Remova a entrada de DNS criada para o Hodor;
2. Crie uma entrada do tipo CNAME de www (ou o subdomínio correspondente) para ssl.vtexcommerce.com.br.
   
   
3. Aguarde a propagação e sua loja estará no ar!

Selo de segurança no rodapé

A Let’s Encrypt não fornece um selo de segurança padrão como outras empresas emissoras de certificado, então note que não é adequado ter no rodapé (ou mesmo outras partes do site) certificações deste tipo sem efetivamente tê-las. Exemplos de selos de segurança são os emitidos pela Digicert, RapidSSL, Comodo CA etc. Caso possua algum, recomendamos a remoção.

Este tipo de selo é apenas informativo, não realizando nenhuma ação ativa no site. Opcionalmente, pode ser inserido no layout alguma informação personalizada sobre o uso do protocolo HTTPS em sua loja e os benefícios da criptografia oferecida.

Primeiros Passos

Alguns passos são essenciais para iniciarmos as configurações.

1. Configure a política comercial;
2. Configure a logística para essa política comercial;
3. Entrar em contato com a YOP;

Como configurar

Configure o perfil de acesso

1. Acesse o módulo License Manager;
2. Clique na aba Usuários;
3. Clique no botão Novo usuário;
4. Preencha o e-mail e nome completo;
5. Busque e selecione os perfis de acesso IntegrationProfile-Fulfillment_Oms (para adicionar as novas ordens) e Admin Restrito (para consulta de catálogo e de logística);
6. Clique no botão Adicionar;
7. Clique no botão Salvar.

Configure o afiliado

Siga as instruções de nosso manual e preencha os campos conforme indicação abaixo.

• Nome: YOP
• ID: YPP
• Política Comercial: ID da política comercial que será assumida pelo marketplace.
• E-mail de FollowUp: Endereço de e-mail que receberá qualquer notificação de conflito nas integrações de pedidos.
• Endpoint de Search: https://yop.land/vtex/notifications
• Versão do Endpoint de Search: Hoje existe apenas 1, não alterável – Padrão: 1.x.x;
• Usar meu meio de pagamento: Não utilizar.

Crie uma promoção de frete grátis

Siga nosso manual de como criar promoção para o marketplace.

Para saber mais

Entenda como funciona a integração com os marketplaces.

Este artigo explica o passo-a-passo necessário para configurar a integração da sua loja com o marketplace Magazine Luiza.

Criar acesso

Para iniciar a integração da sua loja VTEX, você deve dar permissão à chave de integração do Magazine Luiza.

A chave de integração possibilita que o marketplace receba e envie todas as atualizações necessárias para o fluxo de vendas funcionar. Permite, por exemplo, receber o catálogo, calcular o frete e enviar pedidos.

Para configurar essa chave, siga os passos abaixo:

1. Acesse o módulo License Manager;
2. Clique na aba Usuários;
3. Clique no botão Novo usuário;
4. Preencha os campos E-mail e Nome da seguinte forma:

   Email: vtexappkey-luizalabs-RLXLFR
   Nome: magazineluiza

5. Faça uma busca pelo perfil de acesso IntegrationProfile-Fulfillment_Oms e selecione-o;

   Atenção: preencha os campos de E-mail, Nome e Perfil de acesso exatamente como descrito acima.

6. Clique no botão Salvar.

Criar coleção

1. No módulo E-commerce, selecione a aba Configurações e clique em Portal;
2. No Gerenciador do Portal, clique no item Coleções;
3. Clique no botão nova coleção;
4. Preencha o campo Nome. Este é o único campo de preenchimento obrigatório. O campo Id de Coleção não precisa ser preenchido, pois será gerado automaticamente pelo sistema assim que você clicar no botão Salvar Coleção.

Depois disso, sua coleção já existe e você deve apenas acrescentar os produtos que fazem parte dela. Isto é feito por meio da inclusão de grupos à coleção. Estão disponíveis os seguintes filtros:

• Departamento, Categoria ou subcategoria;
• Marca.

Para mais informações sobre como criar uma coleção e incluir grupos, consulte este artigo.

Configurar política comercial

A política comercial é criada com o intuito de especificar um catálogo ou uma regra de logística diferente para o marketplace. Porém, a mesma política comercial pode ser utilizada para mais de um marketplace ou entre loja principal e marketplace. Para isso, basta que se use o mesmo id de política comercial nas configurações. Neste caso, será usado o mesmo catálogo e a mesma logística para as lojas que utilizarem a mesma política comercial.

Será necessário associar à nova política comercial uma coleção que contenha as categorias e/ou grupo de SKUs que serão enviados.

Para detalhes de como configurar a política comercial, acesse este artigo.

Configurar afiliado

O cadastro do afiliado serve como uma identificação única do marketplace em sua loja.

Para configurar o afiliado, siga os passos abaixo:

1. Acesse o módulo OMS;
2. Clique no botão de Configurações (ícone à direita);
3. Clique na aba Afiliados;
4. Clique no botão Novo Afiliado.
5. Preencha os campos da seguinte forma:

   Nome: Magazine Luiza
   ID: MGZ
   Política Comercial: (preencha com o número de id da política comercial desejada)
   E-mail de Follow Up: (preencha com o e-mail da pessoa responsável pela integração)
   Endpoint de Search: http://mkp.luizalabs.com/api/v1/notifications/

6. Clique em Salvar.

Passos finais

Após realizados todos os passos anteriores, o lojista precisará enviar as seguintes informações ao Magazine Luiza:

• Store Id;
• Sales Channel;
• Affiliate Id;
• E-mail do responsável pela integração;
• Telefone do responsável pela integração;
• Banco;
• Código do Banco;
• Agência da conta do recebedor;
• Dígito da Agência;
• Número da conta bancária do recebedor;
• Dígito verificador da conta do recebedor;
• CPF ou CNPJ do recebedor.

O marketplace fará, então, os testes de integração necessários, publicando alguns produtos de seu catálogo para a efetuação de pedidos e testando o fluxo de ponta a ponta.

Este artigo explica o passo-a-passo necessário para configurar a integração da sua loja com o marketplace CSU (Opte+).

A CSU trabalha apenas com o modelo de marketplace Checkout na CSU. Por esse modelo, todo o processo de pagamento é feito na CSU, e o seller apenas recebe o pedido e a autorização para despachá-lo.

Primeiros passos

1. Configure a política comercial;
2. Configure a logística para essa política comercial.

Cadastrar afiliado

Depois de configuradas a política comercial e a logística, é preciso cadastrar o afiliado. Para isso, acesso o módulo OMS, clique no ícone de configurações, à direita, e depois na aba Afiliados. Por fim, clique no botão Novo afiliado e preencha os campos conforme indicado abaixo:

1. Nome: nome do afiliado/marketplace;
2. ID: código de identificação do afiliado com três caracteres.
   A CSU exige que seja criado um afiliado para cada canal, ou seja, um para o marketplace da CSU, um para o programa de fidelidade de cada um dos clientes da CSU e um para cada shopping corporativo.Entre em contato com a CSU para obter uma planilha com todos os sites da empresa, de modo que você possa criar os afiliados conforme indicado por ela.

   Para o marketplace da CSU, o código é PTM (Marketplace Optemais). Para o programa de fidelidade do marketplace, o código é PSS (Passaporte);

3. Política comercial: id da política comercial em que está definido o sortimento de produtos que serão trabalhados no marketplace. A sugestão da CSU é que seja usada a mesma política comercial do seu próprio site;
4. E-mail de Follow Up: endereço de e-mail que receberá quaisquer notificações de conflito nas integrações de pedidos (License Manager > Conta > Contato);
5. Endpoint de search: será o mesmo para os diversos marketplaces da CSU: http://stage.optemais.com.br/Notificacao/Vtex/Sku;
6. Versão do endpoint de search: 1.x.x;
7. Usar meu meio de pagamento: Não marcar esta flag.

Criar acesso

Uma vez criado o afiliado no OMS, é preciso atribuir a correta permissão para a chave da CSU.

Para cada marketplace, existem usuários específicos associados à aplicação do parceiro e também perfis diferentes que devem ser associados. Para os diversos marketplaces da CSU, teremos o mesmo usuário e o mesmo perfil, que devem ser configurados conforme os passos abaixo:

1. Acesse o módulo License Manager;
2. Clique na aba Usuários;
3. Busque pelo valor vtexappkey-parceirocsu-ERUXDY;
4. Selecione o usuário encontrado e associe a ele o perfil de acesso IntegrationProfile-Fulfillment_Gateway_GetOrder;
5. Clique no botão Salvar.

Para saber mais

Entenda como funciona a integração com os marketplaces.

Todo computador na internet possui um número IP. Ele é o número responsável por dar um endereço para cada computador na rede de forma que possamos encontrá-lo quando quisermos acessar um site ou qualquer outro serviço disponível na internet. É por meio do endereço IP que conseguimos encontrar um computador na rede. Porém, é o DNS que associará um endereço web a um IP. Ex.: www.vtex.com direciona para o seu verdadeiro endereço IP 186.202.154.232.

Para que uma nova loja entre no ar, é preciso informar ao seu servidor DNS qual o endereço IP do servidor onde a plataforma VTEX estará em execução. Dessa forma, ao digitar o endereço da sua loja no navegador, o servidor DNS saberá redirecionar o tráfego para os servidores da VTEX onde sua loja estará hospedada.

Configuração no servidor de DNS

Não é mais necessário solicitar a compra do certificado SSL (antes fornecido pela Digicert). O certificado agora é emitido via Let’s Encrypt, e sua criação passou a ser responsabilidade da loja. Este processo é realizado no momento do GoLive da loja.

São três etapas:

1. Apontar o DNS para o Hodor;
2. Acessar a loja em HTTPS para gerar o certificado;
3. Apontar o DNS para o Balance.

Apontar o DNS para o Hodor

Em sua hospedagem, crie uma entrada do tipo CNAME de www – ou o subdomínio correspondente – para hodor.vtex.com.

Aguarde a propagação.

Acessar a loja em HTTPS para gerar o certificado

Basta acessar o seu site especificando o protocolo HTTPS na URL. Assim que carregada, a página deverá retornar um certificado válido, que foi gerado instantaneamente neste primeiro acesso.

Para conferir se o certificado foi gerado corretamente, veja os seguintes passos:

1. Em meu exemplo, a URL final da loja, com HTPS, é
   https://www.garrucho.com.br.
2. Com a geração do certificado SSL, será exibido o cadeado verde. Clique nele.
3. Na janela que foi aberta, clique em Detalhes.
4. Junto às informações do certificado, clique em View certificate.
5. Nesse grupo de informações você pode confirmar o domínio para o qual o certificado foi emitido (o domínio de sua loja), quem emitiu (Let’s Encrypt Authority) e a validade (não se preocupe com o vencimento).

Apontar o DNS para o Balance

Note que, apesar do certificado emitido corretamente, o site apresenta a mensagem “The resource cannot be found“. Isto acontece porque o Hodor ainda está limitado à geração do certificado SSL, e não fornece o conteúdo da loja.

Sendo assim, após a geração do certificado SSL, devemos apontar o domíno para o Balance da VTEX.

1. Remova a entrada de DNS criada para o Hodor;
2. Crie uma entrada do tipo CNAME de www (ou o subdomínio correspondente) para ssl.vtexcommerce.com.br.

   
   

3. Aguarde a propagação e sua loja estará no ar!

Selo de segurança no rodapé

A Let’s Encrypt não fornece um selo de segurança padrão como outras empresas emissoras de certificado, então note que não é adequado exibir no rodapé (ou em quaisquer outras partes do site) certificações desse tipo sem efetivamente tê-las. Exemplos de selos de segurança são os emitidos pela Digicert, RapidSSL, Comodo CA etc. Caso atualmente sua loja exiba algum, recomendamos a remoção.

Esse tipo de selo é apenas informativo – não realiza nenhuma ação ativa no site. Opcionalmente, pode ser inserida no layout alguma informação personalizada sobre o uso do protocolo HTTPS em sua loja e os benefícios da criptografia oferecida.

Configurando acesso sem www

Tão importante quanto o apontamento DNS é o redirecionamento para seu site sem o www. Para fazer essa configuração, é necessário realizar as seguintes ações em seu painel de controle no seu serviço de hospedagem:

• Crie um registro do tipo A = nomedaloja.com.br apontando para 52.8.174.221;
• Criar um registro do tipo CNAME = redirect.nomedaloja.com.br apontando para www.nomedaloja.com.br.opts-uri.direcionar.com.br.

Lembre-se! O Direcionar não é um serviço da VTEX. Existem outros serviços similares, e você é livre para escolher a opção que mais lhe convenha.

O controle de histórico de preço da VTEX tem como objetivo exibir o menor valor faturado de um item por mês. Ou seja, com ele é possível exibir o menor valor pelo qual determinado item foi vendido em sua loja.

Como configurar

O novo controle deve ser incluído no template da página de produto, conforme abaixo:

<!--Price History Inicio v1-->
        <vtex.cmc:StockKeepingUnitPriceHistory Months="6" Percentile="100"/>
<!--Price History Fim-->

Veja aqui a lista completa de controles para templates.

Exibição dos preços

O modo de exibição padrão dos valores segue o modelo da imagem abaixo. São exibidos em sequência o ano, o mês e o menor valor faturado neste mês.

Caso a loja deseje exibir os dados de outra forma, será necessário fazer a customização por meio de uma agência de layout.

Os parâmetros Months e Percentile

Para permitir maior flexibilidade na exibição dos valores na página do produto, é possível definir no parâmetro Months a quantidade de meses a serem considerados pelo controle. Se o parâmetro for igual a “6”, por exemplo, o controle irá exibir o menor valor faturado do item para cada um dos últimos 6 meses.

Além disso, pode acontecer de o menor valor faturado do item num dado mês estar abaixo do praticado normalmente pela loja, em decorrência de uma promoção específica, por exemplo. Para não exibir esse valor, é possível utilizar o parâmetro Percentile. Por meio dele, o lojista consegue desconsiderar valores periféricos. Por exemplo: usando o parâmetro com o valor 95 (Percentile=”95″), desconsideram-se 5% dos valores. Usando-o com o valor 90 (Percentile=”90″), desconsideram-se 10% dos valores. Em casos como estes, valores muito abaixo do praticado normalmente não serão exibidos.

Tão importante quanto o apontamento DNS é o redirecionamento para seu site sem o www. Para fazer essa configuração, é necessário realizar as seguintes ações em seu painel de controle no seu serviço de hospedagem:

• Crie um registro do tipo A = nomedaloja.com.br apontando para 52.8.174.221;
• Criar um registro do tipo CNAME = redirect.nomedaloja.com.br apontando para www.nomedaloja.com.br.opts-uri.direcionar.com.br.

Lembre-se! O Direcionar não é um serviço da VTEX. Existem outros serviços similares, e você é livre para escolher a opção que mais lhe convenha.

Para acessar o valor da receita aprovada de um determinado mês, siga os passos abaixo:

1. Acesse a tela do Admim (Gerenciamento de Pedidos);
2. Clique em Filtros;
3. Clique em Data Autorização;
4. Clique em Todas as Datas;
5. Selecione o mês de referência (data inicial – 01/xx/20xx – e data final – 30[ou 31]/xx/20xx);
6. Ao lado, encontra-se a checkbox Usar meu fuso horário, que não deve ser selecionada;
7. Automaticamente aparecerão o resultado e todos os pedidos.

Caso queira exportar esse resultado, é possível fazer um download:

1. Clique no 4º box da mesma tela: Exportar para e-mail;
2. Automaticamente será encaminhado o relatório para o e-mail da pessoa que estiver logada.

O objetivo deste tutorial é ensinar os passos necessários para utilizar a geolocalização no checkout da sua loja. Por meio desta funcionalidade, é possível fazer com que as entregas usem como base um ponto geográfico (latitude e longitude) em vez de um código postal.

Como isto melhora a minha loja?

A funcionalidade de geolocalização permite ao seu cliente a autogestão na busca pelo endereço de entrega desejado.

Ou seja, no momento do checkout, ele tem à disposição uma ferramenta com a habilidade de geolocalizar endereços do Google Maps com um ícone marcador de posição num mapa.

Isto dá ao usuário a segurança visual de que o pedido chegará ao local que ele escolheu. As informações de localização se completarão automaticamente assim que o ponto seja carregado no mapa.

Essa funcionalidade é especialmente útil em regiões com uma estrutura de códigos postais mal-definida.

Configurando o Logistics

Para utilizar essa funcionalidade, siga os passos abaixo.

Antes de mais nada, é necessário obter uma Javascript API Key do Google Maps que permita a integração com o serviço de geolocalização do Google. Você pode ler mais sobre como obtê-la em:

https://developers.google.com/maps/documentation/javascript/get-api-key

Com a API Key em mãos, siga os passos abaixo:

1. Acesse o módulo Logistics;
2. Clique na aba Geolocalização;
3. Insira a API Key no campo disponível e clique em Cadastrar chave.

Configurando o polígono

Para que essa funcionalidade trabalhe corretamente, é necessário cadastrar os polígonos correspondentes às áreas de entrega desejadas no mapa. Em seguida, deve-se associá-los às transportadoras que farão as entregas, por meio da inclusão dos IDs desses polígonos na tabela de frete. Saiba como fazer isso no artigo Cadastrando geolocalização.

Configurando o Checkout

Após criar o polígono e inserir seu ID na planilha de frete, você precisará inserir a API Key do Google nas configurações do Checkout:

Acesse o módulo Portal;

1. Clique no ícone de configurações do site desejado;
2. Clique na aba Checkout;
3. No campo Google Maps API Key, insira a mesma API Key informada no módulo Logistics.

Como funciona a consulta do frete?

Com a geolocalização no checkout, o cálculo do frete busca, em vez de faixas de CEP, os polígonos que englobam as coordenadas do destino identificado. Se, junto com a geolocalização, o usuário também informar o CEP do endereço de entrega, o sistema calcula o frete para ambos critérios – polígono e CEP. Neste caso, vence a melhor opção.

A lista de preços é o principal ambiente de gestão de preços na sua loja. Nela são listados os preços-base dos seus SKUs e os preços que serão aplicados em cada política comercial da loja. Além disso, é possível verificar qual será o preço final, inclusive aplicando algumas das promoções disponíveis na loja.

Para ver a lista de preços, acesse o módulo Pricing e clique na aba Preços.

Os preços são listados por produto.

Mesmo produtos que não possuam SKUs cadastrados ou SKUs ainda sem preço serão listados. Abaixo é possível ver um exemplo de lista para um produto sem SKUs e outro para um SKU sem preços cadastrados.

A lista de preços é a tela padrão do menu de preços. Nela é possível visualizar as seguintes informações:

• Nome do produto: O mesmo nome que é cadastrado no catálogo, para o produto principal. Cada tabela (card) representa o produto com seus SKUs e preços para cada política comercial.
• Id do produto: Conforme cadastro do catálogo.
• Nome da marca: Nome da marca do produto que está sendo exibido, com seu id.
• Nome da categoria: Nome da categoria na qual o produto está cadastrado.
• Nome da política comercial: Conforme cadastrado no admin.
• Id do SKU: Conforme cadastrado no catálogo. É possível visualizar o nome do SKU ao passar o mouse sobre o id.
• Preço de lista: Também conhecido como “preço de”, que aparece na vitrine e páginas de produto tachado (R$ 10,00). Ele aparece riscado logo abaixo do id do SKU. Este é um campo opcional no cadastro de um preço.
• Preço de custo: Seu cadastro é obrigatório, pois serve de base para o cálculo do preço de venda do produto. Considere aqui todo o custo que está injetado no seu produto, de custo de matéria-prima e produção a estocagem e custos operacionais. Toda vez que é alterado, o preço é salvo e enviado para indexação.
• Markup cadastrado: Margem que deseja ganhar em cima da venda do produto. Esse percentual acrescerá o valor do produto sobre o preço de custo. Toda vez que é alterado, o preço é salvo e enviado para indexação.
• Preço-base: É o preço de venda inicial do produto.  É uma relação entre o Preço de Custo e o Markup.

Como filtrar

A busca pode ser feita por nome e id de produto, e por SKU.

Para filtrar a lista de produtos, estão disponíveis filtros de categoria e marca.

Para isso, basta clicar no link de filtro (ao lado esquerdo do campo de busca) ou digitar no campo de busca o valor desejado. O resultado será exibido na listagem, conforme a imagem abaixo.

Preços-base dos produtos

Na lista de preços são cadastrados os preços dos SKUs, que são compostos principalmente de:

• Preço de custo;
• Markup (percentual de lucro);
• Preço de venda.

Esses dados estão na primeira coluna à esquerda, e serão a base de cálculo para todas as políticas comerciais da loja, que aparecem nas colunas à direita.

Cada SKU é representado na lista por duas ou mais colunas. A primeira coluna representa o preço-base do SKU. A segunda coluna é o preço calculado para a política comercial principal. Essa política sempre existirá, e o preço exibido será o preço do SKU para a mesma, incluindo quaisquer regras de modificação que existam para essa política ou mesmo um preço fixo cadastrado para ela.

Um novo markup (calculado) também é exibido nesta coluna, identificando qual é a margem de lucro para aquele SKU na política comercial. Outras colunas podem ser exibidas mostrando as demais políticas comerciais ativas existentes na loja.

Para visualizar em detalhes (ou editar) os preços, basta clicar sobre as células. Uma aba lateral será exibida com os dados do preço-base (para a primeira coluna) ou o fluxo seguido para cálculo do preço (para as demais colunas).

Cadastrando um preço

Abaixo é possível ver o fluxo de cadastro de preço para um SKU.

1. Clique na primeira coluna (a que contém o ID do SKU) na lista de preços.
2. É necessário que dois dos três campos (Preço de custo, Markup inicial e Preço-base) sejam preenchidos. Preenchendo dois dos campos, o terceiro será calculado com base nos primeiros valores inseridos. Ao terminar, clique fora da aba para salvar o preço.
3. Caso queira inserir um preço de lista (“preço de”), basta selecionar a opção Preço de Lista na aba de edição de preço, e um novo campo será apresentado. Nele é possível cadastrar o valor desejado.
4. Também é possível aplicar preços fixos para qualquer política comercial. Preços fixos ignoram quaisquer regras de modificação de preço cadastradas e valem como o preço do SKU em uma política comercial. Para adicionar esse valor, simplesmente clique na coluna da política comercial em que deseja fixar um preço.

Uma regra de preço é um modificador do preço-base cadastrado na tela Lista de preços.

Como funciona

O cadastro do preço-base servirá como referência para todas as políticas comerciais. A partir dele, serão calculados os preços de venda na loja.

As regras de preços são utilizadas quando se deseja alterar um preço de uma determinada política comercial sem alterar o preço-base para as demais políticas comerciais. Elas também podem ser utilizadas para alterações de preço para todos os produtos de uma categoria ou marca.

Regras de modificação de preço são opcionais. O preço calculado de um SKU será o seu preço-base caso ele não se encaixe em nenhuma regra de modificação.

Além disso, é importante ressaltar que as regras de preço são aplicadas ao preço do SKU de forma sequencial, na ordem em que são cadastradas. A ordem pode ser alterada arrastando-se a seta à esquerda de uma regra para cima ou para baixo. Será aplicada apenas a primeira regra de preço que seja válida para as condições do SKU (categoria; marca; e data de início e fim). Mesmo que existam outras regras de preço válidas, apenas a primeira na ordenação será utilizada para o cálculo de preço do SKU.

Como cadastrar

O passo-a-passo para cadastro é bem simples, e está ilustrado a seguir:

1. Na tela de Regras de preços será exibida uma lista com todas as políticas comerciais. Dentro de cada uma dessa políticas, estarão as regras. Clique no botão Nova regra, acima da lista, para criar uma regra;
2. Escolha em qual política comercial essa regra será inserida;
3. Escolha em quais itens essa regra será aplicada. Você pode escolher duas opções: aplicar em toda a loja ou preencher os campos Categoria e/ou Marca com um ou mais valores.
4. Preencha o campo Modificador com o valor percentual que será acrescido ou decrescido do markup do preço-base;
5. Clique no botão Salvar.

Abaixo é possível visualizar exemplos dos fluxos de edição e exclusão de regras de preço.

Fluxo de alteração de uma regra

Fluxo de exclusão de uma regra

O conceito de preço psicológico visa o “arredondamento”, para evitar preços quebrados e fazer com que comercialmente se apresentem como uma vantagem para o cliente. Para cadastrar o preço psicológico, siga os passos abaixo:

1. Acesse o módulo Pricing;
2. Clique na aba Preços;
3. Clique em Preço psicológico.

Nesta tela, você poderá, por exemplo, ajustar um preço de R$19,85 para R$19,90; ou de R$48,70 para R$48,99. Essas modificações serão feitas de acordo com o que o lojista entenda como mais chamativo para seu público-alvo e seu ramo de negócio, e isso impactará na apresentação de todos os preços da loja.

Como funciona

Para ter os preços arredondados, é necessário criar uma regra. Por meio dela, você escolherá a faixa de preço que será arredondada, a casa decimal e o método de arredondamento. É possível criar a regra para centavos, décimo de centavo ou unidade, e você pode escolher entre três métodos de arredondamento: “nove”, “noves” e “zero”.

Exemplos

Centavo:

• Nove: adiciona um 9 com zeros à direita. Ex.: R$ 59,56 → R$ 59,59
• Zero: adiciona um 0 com zeros à direita. Ex.: R$ 20,56 → R$ 20,60

Décimo de centavo:

• Nove: adiciona um 9 com zeros à direita. Ex.: R$ 59,56 → R$ 59,90
• Noves: adiciona um 9 com noves à direita. Ex.: R$ 5,07 → R$ 4,99
• Zero: adiciona um 0 com zeros à direita. Ex.: R$ 263,56 → R$ 264,00

Unidade:

• Nove: adiciona um 9 com zeros à direita. Ex.: R$ 59,56 → R$ 59,00
• Noves: adiciona um 9 com noves à direita. Ex.: R$ 5,07 → R$ 9,99
• Zero: adiciona um 0 com zeros à direita. Ex.: R$ 263,56 → R$ 260,00

Critério de arredondamento

O arredondamento utiliza a diferença absoluta entre o preço original e valores próximos com o final desejado. Aplicar o método Noves ao valor 9,70 fará com que ele seja arredondado para 9,99, pois dentre 8,99 e 9,99 o valor mais próximo é o segundo.

Sendo assim, é importante sempre lembrar que o arredondamento será por aproximação do valor com o final desejado. Dessa forma, o usuário poderá arredondar o preço para um valor mais baixo ou mais alto do que o valor original, e essa variação será de acordo com a escolha da casa decimal.

• Centavo: variação de até 5 centavos;
• Décimo de centavo: variação de até 50 centavos;
• Unidade: variação de até 5 reais.

No final, o usuário poderá visualizar preços com as configurações da regra e poderá testar um preço para ver como ele ficará com o arredondamento da regra.

Abaixo é possível ver exemplos dos fluxos de inclusão, edição e exclusão de regras de preço psicológico. Também é possível conferir como simular preços para uma regra específica.

Fluxo de criação de uma regra

Fluxo de alteração de uma regra

Fluxo de exclusão de uma regra

Simulação de preço para uma regra

O gerenciamento de preço é realizado no módulo Pricing, que cuida também das taxas e promoções da plataforma VTEX. Os artigos listados abaixo têm como objetivo esclarecer e detalhar o processo de precificação de itens em uma loja, usando a nova versão da lista de preços.

A nova lista de preços é composta de: uma lista com os produtos e seus preços-base; regras que alteram os preços dos produtos de acordo com as Políticas Comerciais; regras de arredondamento (preço psicológico); e uma seção de configurações gerais.

• Lista de preços (v2)
• Regras de preços (v2)
• Preço psicológico (v2)

As configurações dos Preços são acessadas pelo botão Configurações, no canto direito do módulo Pricing.

Nessa tela, é possível fazer o cadastro do markup mínimo. Entenda a seguir o que é markup e como configurá-lo.

Markup

Markup é uma margem que, adicionada ao valor de custo de um produto ou serviço, define o preço de venda do item. Ou seja, é a margem de lucro.

Markup médio

O markup médio é utilizado apenas quando ocorre a integração externa de preços e o preço vem sem o preço de custo. Quando isso ocorre, o sistema utiliza o preço-base e o markup médio para estimar um preço de custo.

Markup mínimo

O cadastro do markup mínimo, realizado na tela de Configurações, servirá como referência para dois cenários:

• Definição de markup no preço-base: Ao criar um markup para o preço-base, esse valor é comparado ao markup mínimo ─ se for menor, o cadastro não será possível.
• Destaque na lista de preços: Caso seja criada uma regra com percentual negativo que impacte o lucro de um SKU, fazendo-o ficar menor que o lucro (markup) mínimo, o valor do markup será destacado em vermelho.

O markup mínimo inicial, por política comercial, é sempre zero e pode ser livremente ajustado para valores positivos ou negativos.