GEFF • Estratégias de E-commerce, IA & Infraestrutura Digital
Ferramentas

Como Integrar a VTEX no Olist ERP: Passo a Passo Completo de AppKey, AppToken, OMS, Estoque e NF-e (Com Telas)

•
Publicado em 29/09/2026
•
9 min de leitura
Publicidade

Integrar uma operação Enterprise VTEX ao Olist ERP permite unir a plataforma de Digital Commerce mais robusta da América Latina à agilidade de faturamento fiscal (NF-e Modelo 55 em lote), gestão de múltiplos depósitos, conciliação financeira e expedição por código de barras do ERP da Olist — com uma fração do custo de implantação e manutenção dos ERPs legados tradicionais.

Na arquitetura da VTEX, o módulo OMS (Order Management System) exige que o ERP integrado opere como um Fulfillment Endpoint de altíssima precisão: ele precisa autenticar via cabeçalhos criptografados (X-VTEX-API-AppKey e X-VTEX-API-AppToken), respeitar o ID do Estoque (Inventory / Doca), aplicar a Política Comercial (Trade Policy / Sales Channel) correta e devolver o pacote fiscal (Chave de Acesso de 44 dígitos + XML da NF-e + Tracking Number) para que a máquina de estados da VTEX avance o pedido de Ready for Handling (Pronto para Manuseio) para Invoiced (Faturado) e Shipped (Enviado).

Neste Super Guia Técnico e Ilustrado (com todas as telas oficiais da integração VTEX no Olist ERP), você aprenderá passo a passo como gerar suas chaves no License Manager da VTEX, configurar o conector no Olist ERP, mapear múltiplos canais de venda (VTEX como Hub nativo de Marketplaces), sincronizar estoques por doca e automatizar 100% do faturamento e rastreio.

Publicidade

🎁 Condição Especial Enterprise: Cupom GEFF no Olist ERP

Vai integrar sua operação VTEX ao Olist ERP? Ative agora nossa condição exclusiva de parceiro oficial: 30 dias de teste grátis + 3 meses com 50% de desconto na mensalidade + IA LIS inclusa!

  • ✅ Cupom Olist ERP (30 dias grátis + 50% OFF por 3 meses): Código GEFF no link oficial abaixo.
  • 🚚 Olist Envios (R$ 100 de Bônus Logístico): Despache pedidos D2C com fretes reduzidos usando o cupom GEFF em Olist Envios.
  • 💰 Flip by Olist (Antecipação de Recebíveis NF-e): Liquidez imediata para suas vendas faturadas com o cupom GEFFALENCAR em Flip Crédito.

👉 Quero Ativar 30 Dias Grátis + 50% OFF no Olist ERP (Cupom GEFF)

1. Arquitetura de Integração VTEX <-> Olist ERP: Recursos Homologados

O conector oficial da VTEX no Olist ERP suporta 100% das operações de catálogo, estoque, precificação e OMS:

  • Receber pedidos (OMS VTEX): Importa automaticamente pedidos aprovados na loja VTEX e nos marketplaces integrados ao hub nativo da VTEX, trazendo dados completos do cliente, itens, descontos e frete.
  • Receber produtos e Enviar produtos: Sincronização bidirecional de SKUs, especificações, marcas, categorias e variações entre o ERP e o Catálogo VTEX.
  • Enviar estoque por ID de Inventário: Atualiza em tempo real o saldo disponível diretamente no ID do estoque (Warehouse ID) configurado na logística da VTEX.
  • Enviar preços por Política Comercial: Permite atualizar o preço fixo ou regras de preço diretamente nas Políticas Comerciais (Trade Policies) da VTEX.
  • Sincronizar situação, Chave de Acesso NF-e e Rastreio: Notifica a API de Fulfillment da VTEX com a nota fiscal (XML/Chave) para mudar o status para Faturado e envia o código de rastreio até a confirmação de Entregue.
Parâmetro na Arquitetura VTEXOnde Localizar no Admin VTEXConfiguração Equivalente no Olist ERP
Account Name (Nome da Conta)Configurações da Conta > Gerenciamento da ContaCampo Nome da conta na aba Autenticação da integração VTEX.
APPKEY & APPTOKENConfigurações da Conta > Chaves de Aplicação (License Manager)Campos APPKEY e APPTOKEN (com perfil IntegrationProfile – Fulfillment/OMS).
Trade Policy / Sales Channel (Ex: 1)Configurações da Loja > Canais > Políticas ComerciaisAba Canais de Venda > Código do canal de venda no e-commerce.
Notification Invoice & TrackingPedidos > Todos os Pedidos (Fluxo OMS)Envio automático de dados da Chave de Acesso NF-e + Código de Rastreio na expedição.

2. Passo a Passo: Como Instalar e Autenticar a VTEX com AppKey e AppToken no Olist ERP

Para realizar a conexão segura entre o seu ambiente VTEX e o Olist ERP, siga o roteiro oficial:

  1. No menu lateral do Olist ERP, acesse Menu > Início > Integrações;
  2. Clique em Adicionar integração, pesquise por Vtex e clique em Instalar;
  3. No campo Nome da integração no ERP, informe a identificação da loja (ex: VTEX Enterprise - Loja Oficial);
  4. Na seção Autenticação, preencha os 4 parâmetros técnicos obrigatórios:
    • URL da loja: Informe o domínio público da sua loja virtual (ex: https://www.sualoja.com.br);
    • Nome da conta (Account Name): Informe o identificador exato da sua conta na VTEX (subdomínio nomedaconta.myvtex.com);
    • APPKEY e APPTOKEN: Insira a chave de aplicação (vtexappkey-...) e o token secreto de 128 caracteres gerados no License Manager da VTEX com permissões de leitura/escrita no OMS, Catálogo e Logística;
  5. Clique no botão “Conectar com VTEX” e, em seguida, clique em “Testar configurações” para validar a resposta HTTP 200 OK da API da VTEX!
Tela oficial da integração VTEX no Olist ERP - Passo 1
Tela Oficial 1: Configurando os parâmetros de integração e canais de venda na extensão VTEX do Olist ERP.

3. Aba Canais de Venda: Como Mapear Políticas Comerciais e Marketplaces Conectados na VTEX

Muitas operações utilizam a VTEX como Hub nativo (VTEX Marketplace / Trade Policies) para vender no Mercado Livre, Amazon, Magalu, Carrefour e Dafiti. Caso algum desses marketplaces não esteja conectado diretamente ao Olist ERP, mas sim dentro da VTEX, você deve mapeá-lo na aba Canais de Venda da integração VTEX:

  1. Na configuração da integração VTEX no Olist ERP, abra a aba Canais de Venda e clique em Adicionar canal de venda;
  2. Informe o Código do canal de venda no e-commerce (o ID da Política Comercial / Afiliado na VTEX) e selecione o Intermediador da transação para o preenchimento automático da NF-e;
  3. Defina se deseja Importar o valor do frete nos pedidos deste canal e configure as taxas de comissão (%) e valores mínimos para que o Contas a Receber do Olist ERP já reflita o repasse líquido real.
Tela oficial da integração VTEX no Olist ERP - Passo 2
Tela Oficial 2: Parametrizando detalhes específicos da operação VTEX dentro do Olist ERP.
Tela oficial da integração VTEX no Olist ERP - Passo 3
Tela Oficial 3: Ajuste das diretrizes de catálogo, variações e sincronização de estoque com o inventário da VTEX.

4. Regras de Estoque, Preços, Envio da Chave da NF-e e Rastreio para o OMS da VTEX

Para que a máquina de estados do OMS da VTEX funcione de forma 100% autônoma com o Olist ERP, revise os parâmetros operacionais abaixo:

Tela oficial da integração VTEX no Olist ERP - Passo 4
Tela Oficial 4: Sincronização de dados fiscais (Chave de Acesso NF-e) e código de rastreamento do Olist ERP para a VTEX.
Tela oficial da integração VTEX no Olist ERP - Passo 5
Tela Oficial 5: Obtendo o código do canal de venda e gerenciando o status de entrega no OMS da VTEX.
Configuração de envio de saldo disponível para a VTEX no Olist ERP
Passo Complementar 6: Mantenha “Enviar saldo disponível” ativado para descontar reservas de pedidos em aberto.
GIF oficial mostrando a ativação do Estoque de Segurança no Olist ERP
Passo Complementar 7 (GIF Oficial): Configure o Estoque de Segurança para proteger campanhas de alto tráfego na VTEX.
  • Enviar dados da Chave de Acesso ao e-commerce: Assim que a NF-e é autorizada pela SEFAZ no Olist ERP, o sistema envia o número da nota, série, valor e os 44 dígitos da Chave de Acesso para a API de Invoice Notification da VTEX, avançando o status do pedido para Faturado (Invoiced).
  • Enviar código de rastreio e marcar pedidos como entregues na VTEX: Quando o pedido é despachado no módulo de Expedição do Olist ERP, o número de rastreamento e a URL da transportadora são injetados no pacote do OMS da VTEX, disparando os e-mails transacionais ao cliente até a confirmação de entrega.

Perguntas Frequentes (FAQ) sobre a Integração VTEX no Olist ERP

1. Quais credenciais são necessárias para conectar a VTEX ao Olist ERP?

Você precisará da URL da loja, do Nome da conta (Account Name) da VTEX e do par de chaves APPKEY e APPTOKEN gerados no módulo License Manager (Chaves de Aplicação) do painel VTEX com permissão de integração OMS/Catálogo/Logística.

2. Devo mapear na aba Canais de Venda da VTEX um marketplace que já está integrado direto no Olist ERP?

Não! A documentação oficial do Olist ERP orienta que, se você já conectou um marketplace diretamente ao ERP (como Mercado Livre ou Shopee), não deve conectá-lo novamente por dentro da VTEX para evitar duplicidade de pedidos e de reservas de estoque.

3. Como o Olist ERP muda o status do pedido para “Faturado” no OMS da VTEX?

Basta emitir e autorizar a NF-e no Olist ERP com o envio automático de dados da nota habilitado. O ERP envia a Chave de Acesso e os valores da NF-e para a API da VTEX, que automaticamente transiciona o pedido para Faturado.

4. É possível reajustar preços em massa no Olist ERP e refletir na loja VTEX?

Sim! Pelo módulo de Preços e Anúncios do Olist ERP, você pode atualizar os preços dos produtos ou listas de preços e comandar o envio em lote para a sua loja VTEX.

5. O Olist ERP atualiza o código de rastreio e o status de pedido entregue na VTEX?

Sim, ao concluir a expedição no Olist ERP, o código de rastreio é enviado para a VTEX e, quando a entrega é confirmada pela transportadora, o pedido pode ser marcado automaticamente como entregue no OMS.

6. Como resgatar 30 dias grátis + 50% de desconto por 3 meses no Olist ERP?

Acesse o link oficial info.olist.com/lp-geff e utilize o cupom GEFF para garantir 30 dias grátis, 3 mensalidades com 50% OFF e acesso à IA Lis.

📚 Central de Tutoriais Olist ERP (Tiny ERP) — Conheça as Outras Trilhas

Acelere sua operação de e-commerce e loja física navegando por todos os guias oficiais passo a passo com telas do sistema:

🎁 PARCERIA OFICIAL OLIST + GEFF

🚀 Solicitar Implantação Assistida VIP + Cupom GEFF no Ecossistema Olist

Preencha seus dados abaixo para registrar seu atendimento prioritário em nosso painel e liberar na mesma hora o seu link de cadastro gratuito com o Cupom GEFF (30 dias grátis + 3 meses com 50% OFF + IA LIS no Olist ERP), R$ 100 de bônus no Olist Envios e Flip Crédito (GEFFALENCAR):

🔒 Seus dados ficam salvos em nossa Central VIP ([email protected]) e o link direto de cadastro gratuito com cupom aparece na tela imediatamente!

Publicidade
DICA DE PARCEIRO

Acelere sua operação com as melhores ferramentas

Utilize cupons exclusivos negociados diretamente com grandes players de E-commerce, ERP e Inteligência Artificial.

Geferson Alencar
CO-FUNDADOR GFV & CRIADOR

Geferson Alencar (Geff)

Sou o Geff. Gravo vídeos sobre e-commerce, marketplaces, inteligência artificial e programação. Sou co-fundador do GFV, já vendi bastante no digital e hoje dedico minha vida a ajudar outros sellers com tutoriais práticos na internet, além de praticar esporte híbrido (CrossFit, Hyrox, corrida) e me dedicar à minha família.

Deixe um comentário

O seu endereço de e-mail não será publicado. Campos obrigatórios são marcados com *

COMUNIDADE VIP

Receba insights exclusivos de E-commerce, Ferramentas & IA

Junte-se a milhares de empreendedores que acompanham meus conteúdos e análises práticas.

Cupom copiado com sucesso!
Falar no WhatsApp