O objetivo deste artigo é explicar os passos para adicionar e configurar o conector Mercado Pago Transparente.
Depois, faltarão apenas quatro passos:
O pedido recorrente é uma excelente oportunidade para aumentar a receita da loja por meio da fidelização do cliente, permitindo a criação de pedidos automáticos programados de acordo com a necessidade de consumo.
O objetivo desse artigo é explicar passo a passo como realizar a configuração do sistema de recorrência.
Além da forma de pagamento “Cartão de Crédito”, a sua loja precisa apenas ter um “anexo especial” para suportar os pedidos recorrentes.
Passo 1: Cadastre o anexo “Recorrência”;
Passo 2: Salve o anexo;
Passo 3: Edite o anexo e defina a frequência.
Ao adicionar um produto habilitado para recorrência no checkout, o cliente seleciona a frequência dos itens que deseja receber recorrentemente e fecha o pedido normalmente, selecionando o meio de pagamento Cartão de Crédito.
Depois do período de tempo escolhido, o sistema automaticamente gera o pedido.
Após a aprovação do pagamento, a recorrência será ativada.
O pedido com recorrência deve ser pago com cartão de crédito.
Atualmente, os gateways de pagamento que permitem pedidos recorrentes na plataforma Vtex são:
Entenda melhor como configurar um gateway de pagamento na sua loja.
No módulo Message Center é possível configurar os e-mails relacionados com a recorrência.
| Recorrência – New | Quando uma recorrência é criada. |
| Recorrência – Next Order | Lembrete do próximo pedido. |
| Recorrência – Cancel | Quando uma recorrência é cancelada (removida). |
| Recorrência – Error | Quando acontece algum erro no fechamento do pedido. |
| Recorrência – Stop | Quando um recorrência é “congelada”. |
| Recorrência – Approved | Avisa que é preciso revisar a captura de um pagamento. |
| Recorrência – Edit | Quando uma recorrência é alterada (item adicionado/removido). |
| Recorrência – Item Unavailable | Quando um item não está disponível no momento em que o pedido recorrente for gerado. |
Entenda melhor como configurar os templates de e-mails transacionais na plataforma VTEX.
O objetivo deste artigo é mostrar como usar o VTEX Img para tornar o carregamento das imagens mais eficiente e melhorar a performance do site.
O VTEX Img, serviço que entrega essas imagens ao front da loja, tem uma pequena API que, se bem utilizada, pode trazer grandes benefícios aos seus clientes.
A URL da imagem de um SKU tem o seguinte formato:
http://[ACCOUNT_NAME].vteximg.com.br/arquivos/ids/[ID](-[LARGURA]–[ALTURA])/([NOME_DA_IMAGEM])
O que está em negrito são valores que mudam de acordo com a loja, sku e imagem (ou seja, o account name da loja, o id, a largura, a altura e o nome da imagem).
O que está entre parênteses são parâmetros opcionais (ou seja, largura, altura e nome da imagem).
O nosso catálogo envia as imagens dos SKUs no seguinte formato:
http://instoreqa.vteximg.com.br/arquivos/ids/155602/robo.jpg
Nessa URL, temos:
O nome da imagem é um parâmetro opcional. Por isso, a mesma imagem é entregue se abrirmos a seguinte URL:
http://instoreqa.vteximg.com.br/arquivos/ids/155602/
A maneira mais eficaz de melhorar a performance das imagens é fazer com que elas tenham o tamanho que será realmente usado no site. Por exemplo:
Uma loja quer exibir em uma página a imagem de um produto com tamanho de 50×50. Imagine que a loja escreva em seu código html a seguinte URL:
http://instoreqa.vteximg.com.br/arquivos/ids/155602/robo.jpg
Neste caso, o navegador irá baixar a imagem com tamanho completo, ou seja, a mesma imagem em alta definição que foi enviada no upload para o Catálogo.
Isso significa que os dados que estão sendo trafegados estão além do necessário, o que é ruim para a performance da loja.
Podemos pedir ao VTEX Img que envie a imagem em um tamanho específico.
No nosso exemplo anterior, basta escrever da seguinte maneira a URL da imagem no código html:
http://instoreqa.vteximg.com.br/arquivos/ids/155602-50-50/
Desta forma, o VTEX Img entregará a imagem com um tamanho de 50×50. Isto tornará seu carregamento muito mais rápido.
Ao redimensionar imagens retangulares, o VTEX Img mantém sua proporção, ou seja, elas são redimensionadas sem distorção.
Em lojas de roupas, por exemplo, é muito comum as imagens terem um formato de retrato, em que a altura é maior do que a largura, como 300×400. Se a loja precisar dessa imagem quadrada (num formato de 50×50, por exemplo) ela acabará distorcida.
O VTEX Img impede distorções completando o espaço vazio com um fundo branco.
The post Melhorando a performance de imagens de produto appeared first on Help Center - VTEX.
Primeiro, vamos explicar o fluxo das consultas. Existem dois tipos:
Esse tipo de consulta é a forma mais rápida de recuperação de dados. O id é a referência mais forte que nos indica o endereço exato de armazenamento.
Neste tipo de consulta os campos marcados como Buscável ou Filtro possuem relevância. Mas não somente eles devem ser considerados. Os índices também fazem parte desse processo. A melhor forma de entendermos o fluxo desse tipo de consulta é por meio de um exemplo.
No nosso exemplo, temos a entidade de dados Cliente, sigla CL. Ela tem as seguintes configurações:
| Nome do campo | Tipo | é filtro | é buscável | | --------------| ------------| ------- | ---------- | | Email | Email | sim | sim | | Nome | Varchar 100 | não | sim | | Idade | Integer | sim | não | | TamanhoRoupa | Varchar 10 | não | não |
O atributo é filtro indica que poderemos realizar um filtro por meio de determinado(s) campo(s). Em nosso exemplo, poderemos realizar filtro por meio dos campos Email e Idade.
Na API, temos como fazer a seguinte consulta na rota search:
Se for realizado um filtro pelo campo Nome, que não foi marcado como filtro, a resposta será um Bad Request informando que o campo Nome não foi configurado para filtro.
O atributo é buscável indica que poderemos fazer uma busca por meio do atributo _keyword da rota search. O _keyword é utilizado para o seguinte cenário: “Quero todos os documentos que tenham o valor maria.”
A chamada da API, neste caso, será a seguinte:
/dataentities/CL/search?_keyword=maria
Os asteriscos são indicadores para uma consulta parcial. Ou seja, não serão buscados os documentos que tenham o valor exato maria, mas os que tenham em alguma parte esse grupo de caracteres.
No resultado dessa consulta teríamos os documentos que tenham nos atributos Nome e Email valores como: Nome=Maria Joaquina | Email=maria@provider.com.
O índice é um recurso do VTEX Master Data que funciona como um “atalho” para encontrar documentos. Ele não passa pela Engine de Busca (tecnologia utilizada para consultas com filtros, busca fulltext e agregação).
Utilizando esse recurso, a consulta é mais rápida que um filtro normal. Contudo, quanto maior a quantidade de índices, mais lento fica a gravação de documentos. Sempre tenha cuidado na sua modelagem para que o processo de gravação e leitura seja o mais eficiente possível na resolução do seu cenário.
A consulta por índices é realizada por meio da rota search. Dentro do fluxo da busca, quando o VTEX Master Data está interpretando a query, ele faz a seguinte pergunta:
Esse filtro compõe um índice?
Se a resposta for positiva, a consulta é realizada através do índice.
A reindexação é um processo em background que faz o seguinte:
Quando os campos de um documento são gravados na Engine de Busca, dizemos que esse documento está indexado. Por isso o nome “reindexação”.
é filtro ou é buscável são alterados.The post Entendendo o funcionamento das consultas no Master Data appeared first on Help Center - VTEX.
search, mais antiga, e scroll, desenvolvida posteriormente. O objetivo deste artigo é explicar as principais diferenças entre as duas e detalhar o funcionamento da rota scroll.A rota search é bastante utilizada para consultas paginadas. E deve continuar assim. Contudo, quanto maior for o intervalo de documentos, mais lenta será a consulta.
Para obter uma melhor performance em cenários como esse, é preciso realizar um filtro. Diminuir a quantidade de documentos do resultado final é o melhor caminho para que a consulta possa ser executada com mais eficiência.
search é a melhor solução para os cenários em que necessitamos buscar uma coleção de documentos diretamente na loja.scroll foi desenvolvida para atender aos cenários de integrações externas. Se a sua necessidade for consultar toda a base do VTEX Master Data ou se a sua coleção de documentos for maior que 10 mil, utilize este recurso.Primeiro, você fará uma consulta na rota scroll utilizando os mesmos recursos de filtragem da rota search. Na resposta ao seu primeiro request, será obtido um token no header X-VTEX-MD-TOKEN.
Utilize esse token para os próximos requests até que retorne uma lista vazia.
scroll;Para mais detalhes, veja nossa documentação de APIs do MasterData.
The post Consultas ao Master Data via rota Scroll appeared first on Help Center - VTEX.
As APIs utilizadas para a integração dos SKUs dos sellers estão disponíveis na seguinte documentação: https://documenter.getpostman.com/view/255119/vtex-suggestion-model/KCg7
No momento da inserção dos SKUs via API, esta pode retornar alguns erros em suas chamadas, além dos retornos de sucesso conhecidos. Estes erros são listados na tabela abaixo. Cada um deles é identificado por um número de 0 a 23 (além dos erros 99 e 999, que são desconhecidos). Na coluna da esquerda, estão os nomes que descrevem cada um dos erros.
Utilizando essa tabela, é possível entender a que se referem os erros retornados na integração, de modo que as sugestões de SKUs possam ser tratadas e aprovadas com sucesso.
| NotSpecifiedError | 0 |
| MatchCategoryIdIsEmpty | 1 |
| MatchBrandIdIsEmpty | 2 |
| ProductNameIsEmpty | 3 |
| SkuNameIsRequired | 4 |
| SkuHeightIsRequired | 5 |
| SkuWeightIsRequired | 6 |
| SkuLengthIsRequired | 7 |
| SkuWidthIsRequired | 8 |
| SkuImagesAreRequired | 9 |
| EanOrRefIdAreRequired | 10 |
| SkuImageUrlIsInvalid | 11 |
| ProductOrSkuHasInvalidSpecificationLength | 12 |
| MatcherIdRequired | 13 |
| MatchSkuRefIsNotValid | 14 |
| MatchScoreIsNotInRange | 15 |
| SuggestionNotFound | 16 |
| MatchOldVersion | 17 |
| SuggestionIsNotPending | 18 |
| MatchBrandIdIsInvalid | 19 |
| MatchCategoryIdIsInvalid | 20 |
| MatchProductRefIsInvalid | 21 |
| SellerIdAndMarketplaceSkuIdAlreadyExists | 22 |
| SellerIdAndSellerSkuIdAlreadyExists | 23 |
| Unknown error (erro de comunicação com o catálogo; estamos trabalhando para que seja melhor descrito) | 99 |
| Unknown error (erro de comunicação com o catálogo; estamos trabalhando para que seja melhor descrito) | 999 |
The post Retornos da API de inserção de SKUs no módulo Suggestion appeared first on Help Center - VTEX.
O Web Developer é uma extensão que adiciona ao navegador diversas ferramentas de desenvolvedor web. Está disponível para Google Chrome, Mozilla Firefox e Opera, e funciona em qualquer plataforma que esses navegadores suportam, incluindo Windows, OS X e Linux.
Essa ferramenta permite ao usuário ativar ou desativar rapidamente várias características da página, como Javascript, CSS, validações de formulários e image crawling. Com isso, você pode analisar como cada um desses elementos influencia no desempenho do site.
É um aplicativo útil para ajudá-lo a identificar se um problema no seu site está relacionado ao front-end ou ao back-end.
Saiba mais em: https://chrispederick.com/work/web-developer/
O Google oferece um add-on que impede que os dados de determinados visitantes (funcionários da sua equipe, por exemplo) sejam usados pelo Google Analytics.
Isso previne um dos erros mais simples em relatórios de tráfego, e que é frequentemente negligenciado por companhias, agências e funcionários.
Você já parou para pensar sobre quantas vezes visita sites de seus clientes em uma hora, em um dia, em um mês? Se você ainda não exclui de relatórios o seu próprio tráfego, está prestes a ver o impacto que você, sua agência ou mesmo funcionários têm quando se trata de inflar seus números.
Digamos que uma empresa tem 100 funcionários e todos os 100 têm o site da empresa definido como homepage em seus computadores. Essas centenas de visitas não apenas mascaram seus números – elas passam métricas erradas, inclusive de conversão.
Se quiser desativar o uso dos dados, faça o download do add-on do Google e instale-o no seu navegador. Essa ferramenta foi desenvolvida para ser compatível com Google Chrome, Internet Explorer 11, Safari, Firefox e Opera.
No caso do Internet Explorer, é necessário ativar os cookies de terceiros.
Saiba mais em: https://tools.google.com/dlpage/gaoptout
O Google Analytics Chrome Extension permite ver como os clientes interagem com as páginas do seu site, incluindo informações sobre os clientes que clicam e os que não clicam em determinado elemento.
Você pode usar esses insights para otimizar o layout do site, melhorar a experiência do usuário e aumentar a conversão. Ao visualizar uma página da web para a qual você tem acesso ao Google Analytics, você verá, em tempo real:
Além disso, é possível usar as ferramentas de comparação de data e segmentação do Google Analytics diretamente na extensão.
Para saber mais sobre ferramentas que auxiliam a medir e melhorar a performance da loja, leia o artigo O que devo fazer para minha loja ser mais rápida.
The post Ferramentas para melhorar a performance da loja appeared first on Help Center - VTEX.
Depois de registrar seu catálogo de produtos, é o momento de registrar suas transportadoras, a quantidade de artigos em seu estoque e os valores de transporte.
The post Estoque e transportadoras appeared first on Help Center - VTEX.
O Network possibilita que lojistas e marketplaces se aproximem de uma rede que conta com mais de 2 mil lojistas VTEX, presentes em mais de 16 países, de maneira simples e fácil.
A ferramenta permite uma rápida comunicação entre os usuários, facilitando negociações entre si e a exposição de catálogos de produtos, assim como condições de comissionamento e pagamento.
Para aprender a usar essa ferramenta, veja o tutorial abaixo:
O acesso ao VTEX Network deve ser feito por um único usuário master da loja. Ele se encontra no admin da sua loja.
Caso você não consiga ver o formulário abaixo, será necessário limpar o cache do seu navegador e atualizar a página.
As informações preenchidas nesse formulário darão visibilidade à sua loja quando outro seller VTEX ou marketplace navegar pelo VTEX NETWORK. Cada item apresenta um “?”, por meio do qual é possível tirar dúvidas rápidas.
Ao selecionar esse campo, aparecem novos campos para complementar seu cadastro como um marketplace.
Nesse passo você pode selecionar múltiplas categorias para sua loja/marketplace, desde que façam parte do seu leque de SKUs. É possível tanto adicionar quanto excluir categorias. Depois que uma for adicionada, aparecerá uma “lixeira”. Ao clicar nela, você verá novamente a tela anterior. Para se desfazer da categoria, basta clicar em Excluir.
Seu cadastro será validado e aprovado em até 24 horas. Com isso, você terá acesso à página de Sellers, que se encontra no header. Basta clicar no botão Sellers. É importante ficar atento à mensagem de confirmação.
Utilize essa área para afunilar ainda mais sua procura. É possível selecionar parceiros por categoria ou fazer uma busca.
Aqui é onde localizamos a prateleira de lojas aptas para integração. Nesta área você encontra informações referentes à loja que deseja conectar. Se gostou da comissão, do tempo de mercado e das demais informações dessa loja, você pode dar um like. Caso não tenha gostado, pode dar um dislike.
Utilize os filtros para achar as lojas que procura. Por meio deles, você consegue localizar:
Para alterar seu cadastro ou acrescentar novas categorias, é preciso clicar no seu e-mail no menu superior. Isso abrirá uma tooltip, Minha conta, que levará para a home. Também é possível fazer esse acesso clicando no logo Network. Seu cadastro estará gravado no mesmo lugar em que o realizou pela primeira vez.
The post Conectando-se a lojistas e marketplaces pelo VTEX Network appeared first on Help Center - VTEX.
Quando a loja possui integração com ERP, possivelmente o integrador irá solicitar nossas AppKey e AppToken.
Os passos abaixo mostram como consegui-los:
The post Onde encontrar a AppKey e o AppToken de sua loja appeared first on Help Center - VTEX.
Nas integrações pela interface de REST, é necessário o fornecimento de alguns headers para a autenticação das consultas. Os obrigatórios são chamados de appKey e appToken, sendo possível utilizá-los com e-mail e senha, respectivamente.
Para a criação deste usuário, é preciso seguir os passos abaixo:
Neste caso, supondo que o mesmo terá acesso a todos os módulos, utilizaremos o Admin Super.
Observações:
The post Autenticando com Usuário e Senha na Interface REST appeared first on Help Center - VTEX.
O Farmácias App é um marketplace mobile certificado pela VTEX. Está disponível para iOS e Android.
Para iniciar a integração, é preciso primeiro dar permissão à chave de integração do Farmácias App. Ela permite que o marketplace receba e envie as atualizações necessárias para o fluxo de vendas – relativas, por exemplo, a recebimento de catálogo, cálculo de frete e envio de pedidos.
Para configurar a chave, siga os passos abaixo:
Email: vtexappkey-farmaciasapp-ISBSVR
Nome: farmaciasapp
Depois, será necessário:
Por fim, deve ser realizado o cadastro do afiliado, que serve como identificação única do marketplace em sua loja. Para fazer isso, siga os passos abaixo:
Nome: Farmácias APP;
ID: FPP;
Política comercial: preencha com o ID da política comercial.
E-mail de follow up: e-mail da pessoa responsável pela integração;
Endpoint de Search: https://integrador.farmaciasapp.com.br/Vtex/api/notification
Após realizar estes passos, você deve enviar os seguintes dados ao Farmácias App:
Para pagamentos processados em ambientes externos ao Farmácias App, também é necessário enviar os seguintes dados:
Após isso o Farmácias App fará as configurações e os testes necessários, publicando alguns produtos em seu catálogo para efetuar pedidos e testar o fluxo de ponta a ponta.
The post Integrando com Farmácias App appeared first on Help Center - VTEX.
As contas alternativas são uma funcionalidade desenvolvida para permitir que o pagamento dos produtos entregues por uma doca específica seja enviado para subcontas diferentes.
Primeiramente temos que entender o que é uma subconta. No módulo License Manager, pode-se criar uma ou mais lojas. Cada loja criada é considerada pelas Contas Alternativas como uma subconta da sua conta principal. Assim, cada nova loja criada vai aparecer na configuração de contas alternativas como uma opção para ser selecionada.
Neste passo você criará a doca dentro da VTEX que representará o novo lugar físico de onde sairá o produto e a conta onde será realizada a venda. Saiba como no artigo Criando uma doca.
No módulo PCI Gateway, na área de configurações -> Contas alternativas, você pode criar ou editar as regras entre docas e subcontas. Cada doca pode ser associada a somente uma subconta, enquanto podemos ter a mesma subconta associada a várias docas.
Com as docas e subcontas vinculadas, você consegue criar condições de pagamentos com o novo filtro de subconta. Assim, aquela subconta pode ser transacionada por uma condição que pague para uma afiliação específica.
Saiba mais em Configurando uma condição de pagamento.
Para criar uma condição de pagamento que só aparecerá no carrinho caso um produto saia da doca selecionada, basta fazer o seguinte dentro de uma condição de pagamento:
The post Configurando contas alternativas appeared first on Help Center - VTEX.
O favicon é o ícone exibido na aba do browser, ao lado do título da página. O browser carrega essa imagem a partir do elemento “<link rel=’ shortcut icon’ >” que referencia uma imagem com extensão “.ico”.
Exemplo:
Usei o Google como exemplo apenas para reforçar que esse recurso não é exclusivo da VTEX e pode ser utilizado em qualquer conteúdo reproduzido em um browser. Leia mais sobre esse assunto no Google. 
Favicon na VTEX
Na VTEX, para garantir que o favicon estará carregado durante toda a navegação do cliente (portal, checkout e orderPlaced), as boas prática indicam que os templates sejam configurados com o elemento <link> dentro do <head>, da seguinte forma:
<link rel=”shortcut icon” href=”/arquivos/{storeName}-favicon.ico”>
Obs.: No portal (/admin/a/) é possível configurar o favicon em outro padrão de URLs (por exemplo, outro nome de arquivo), no entanto, como o Checkout e OrderPlaced carregam a URL nesse padrão, o indicado é carregar também no portal da mesma forma.
Obs. 2: A variável {storeName} deve ser substituida pelo nome da loja, cadastrado no License Manager.
The post Como configurar o favicon em meu site? appeared first on Help Center - VTEX.
A exportação de pedidos no OMS pode ser feita pelo módulo ou através das APIs. Essa exportação enviará ao seu e-mail um arquivo contendo os pedidos que foram filtrados e exportados. Para isso, siga as instruções abaixo.
Sua solicitação irá para uma fila que você poderá acompanhar pelo OMS.
The post Exportando pedidos no OMS appeared first on Help Center - VTEX.
Toda loja VTEX está apta para ser tanto marketplace quanto seller de outras lojas VTEX ou de nossos marketplaces integrados. Isto é feito com configurações simples e sem a necessidade de desenvolvimento de uma integração.
A integração entre lojas VTEX é a mais simples de todas e dispensa alguns passos necessários nas demais integrações. Seguem as instruções para cada configuração abaixo.
Se sua loja for ser marketplace para outra loja VTEX, significa que sua loja receberá os produtos desta outra loja para vender. Para que isso seja possível, basta seguir as instruções para criação de seller.
Se sua loja for inserir produtos para que outra loja VTEX os venda, você precisa cadastrar esta loja como marketplace em seu admin. Para isto, siga os passos abaixo.
Após as configurações, é necessário realizar a indexação de todos os produtos da base, para que a integração ocorra.
Perceba que, na URL, é preciso alterar o termo nomedaloja para o nome de sua loja.
Pronto! Após essas configurações, os produtos começaram a ser enviados para o marketplace. Então, o marketplace deve realizar o mepeamento de categorias, marcas e especificações, além de aceitar os produtos enviados.
Saiba como funciona a integração de marketplaces.
Entenda como configurar seller.
Saiba como realizar o mapeamento de marcas, categorias e especificações.
The post Configurando marketplace entre lojas VTEX appeared first on Help Center - VTEX.
Para incluir um registro, basta acessar o módulo Master Data e escolher a aplicação que deseja visualizar.
Vamos usar um exemplo em que queremos editar as informações de um cliente da sua loja.
As informações apresentadas neste exemplo vem da da entidade de dados CL, e seus campos podem ser configurados como editáveis ou não diretamente na entidade de dados.
Para acessar essa área, é necessário acessar o Dynamic Storage, que fica no seguinte endereço: nomedaloja.ds.vtexcrm.com.br
The post Como incluir um registro em um formulário do Master Data? appeared first on Help Center - VTEX.
