Integração com a VTEX: importar produtos e sincronizar estoque nos dois sentidos
A tela Configurações > Integrações do painel do lojista agora também conecta direto com a VTEX — traz seus produtos pro marketplace e mantém o estoque sincronizado nos dois sentidos, automaticamente.
Essa integração é diferente das outras (Tiny, Bling): a VTEX não é só um sistema de back-office, é a sua própria loja virtual. Por isso, o estoque precisa andar nos dois sentidos — se vende na VTEX, o marketplace fica sabendo e atualiza; se vende aqui, a VTEX fica sabendo e atualiza também. Assim você nunca vende o mesmo item duas vezes em canais diferentes.
Conectando
Clique em "Conectar" no card da VTEX e preencha:
| Nome da conta VTEX | É o nome que aparece no endereço da sua loja, ex.: se seu admin é minhaempresa.vtexcommercestable.com.br, o nome da conta é minhaempresa. |
| App Key e App Token | Geradas no painel da VTEX em Conta → Configurações da Conta → Chaves de Aplicação. Só um usuário com perfil Super Admin consegue gerar essa chave. Ao criar, dê preferência a conceder só as permissões de Logística, Catálogo e Pedidos — nunca peça mais do que isso. |
Diferente do Tiny e do Bling, aqui não tem passo manual de webhook — ao conectar, o sistema já valida as chaves, descobre automaticamente o depósito (warehouse) da sua conta e configura a notificação de pedidos na própria VTEX por trás dos panos. Está tudo pronto assim que a conexão é confirmada.
Como funciona a sincronização de estoque
- Vendeu na VTEX (sua loja): o marketplace fica sabendo pelo aviso automático da própria VTEX e desconta a quantidade vendida do estoque daquele produto aqui.
- Vendeu aqui no marketplace: a mesma quantidade é descontada do estoque do produto na sua conta VTEX.
- Pedido cancelado em qualquer um dos dois lados (inclusive pela Confirmação por Vídeo, quando o cliente reprova um produto antes do envio): a quantidade volta a ficar disponível dos dois lados também — nunca fica "perdida" achando que já foi vendida.
Tudo isso acontece sozinho, sem precisar reimportar nada — só precisa ter conectado uma vez.
Importando produtos
Com a conexão feita, clique em "Ver produtos para importar". O preview mostra os produtos da sua conta VTEX, 50 por página, com:
- Filtrar por categoria — pelas categorias que vieram nos próprios produtos carregados.
- Estoque acima de — esconde produtos com estoque baixo/zerado.
- Filtrar por SKU — busca por código do produto ou de uma variação específica.
Selecionando o que importar
Cada linha é um produto. Produtos com mais de uma variação (SKU) na VTEX aparecem com os filhos logo abaixo, cada um com sua própria caixinha — dá pra desmarcar uma variação específica sem tirar o produto inteiro. Marcar o "pai" marca todas de uma vez.
Produtos já importados antes aparecem com a etiqueta "importado" — selecioná-los de novo atualiza o produto existente em vez de duplicar.
Categoria sem mapeamento
Se a categoria de um produto na VTEX ainda não tem correspondente no marketplace, aparece um seletor na própria linha pra escolher a categoria certa. Dá pra fazer produto por produto, ou usar o bloco "Mapear categoria em massa" no topo do preview: escolha a categoria da VTEX de um lado e a do marketplace do outro, e clique em "Aplicar a todos dessa categoria".
Produtos incompletos (vão como rascunho)
Quando um produto já tem peso, altura, comprimento, largura, descrição e foto cadastrados na VTEX, aparece a chave "Importar como ativo/rascunho" — você escolhe se ele já entra publicado. Faltando qualquer um desses dados, o produto sempre entra como rascunho, com etiquetas laranjas mostrando o que falta — é o mesmo cuidado que já existe pro Tiny e pro Bling, porque sem peso e dimensão certos o frete não fecha corretamente depois.
Sobre variações: a VTEX guarda o nome de cada variação (ex.: "Azul - P") de um jeito que ainda não conseguimos separar automaticamente em "Cor" e "Tamanho" com certeza — por enquanto, cada variação entra com o nome completo da VTEX como opção única. Funciona bem, só não tem o seletor bonitinho separado por cor/tamanho ainda; é uma melhoria que pode vir depois.
Confirmando a importação
Marque os produtos desejados e clique em "Confirmar importação". Ao final, o sistema informa quantos foram importados (novos) e quantos foram atualizados.
Desconectando
Clique em "Desconectar" no topo do card pra parar a sincronização. Isso não apaga os produtos já importados, só encerra a conexão.