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

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.
📑 Índice do Conteúdo (Clique para navegar)
[Ocultar/Expandir]- 1. Arquitetura de Integração VTEX <-> Olist ERP: Recursos Homologados
- 2. Passo a Passo: Como Instalar e Autenticar a VTEX com AppKey e AppToken no Olist ERP
- 3. Aba Canais de Venda: Como Mapear Políticas Comerciais e Marketplaces Conectados na VTEX
- 4. Regras de Estoque, Preços, Envio da Chave da NF-e e Rastreio para o OMS da VTEX
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.
🎁 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
GEFFno link oficial abaixo. - 🚚 Olist Envios (R$ 100 de Bônus Logístico): Despache pedidos D2C com fretes reduzidos usando o cupom
GEFFem Olist Envios. - 💰 Flip by Olist (Antecipação de Recebíveis NF-e): Liquidez imediata para suas vendas faturadas com o cupom
GEFFALENCARem 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.
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:
- No menu lateral do Olist ERP, acesse Menu > Início > Integrações;
- Clique em Adicionar integração, pesquise por Vtex e clique em Instalar;
- No campo Nome da integração no ERP, informe a identificação da loja (ex:
VTEX Enterprise - Loja Oficial); - 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;
- URL da loja: Informe o domínio público da sua loja virtual (ex:
- Clique no botão “Conectar com VTEX” e, em seguida, clique em “Testar configurações” para validar a resposta
HTTP 200 OKda API da VTEX!

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:
- Na configuração da integração VTEX no Olist ERP, abra a aba Canais de Venda e clique em Adicionar canal de venda;
- 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;
- 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.


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:



- 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:
- 👉 Checklist para Emitir NF-e Modelo 55 no Olist ERP (Tiny): Passo a Passo Completo
- 👉 Como Preparar Sua Conta no Olist ERP (Tiny) Antes de Instalar uma Integração
- 👉 Como Configurar uma Integração no Olist ERP: Estoque, Preços e Pedidos
- 👉 Como Importar e Cadastrar Produtos dos Canais de Venda no Olist ERP
- 👉 Conheça o Menu Global da Olist no ERP: Navegação no Ecossistema Unificado
- 👉 Guia Geral de Configurações do Olist ERP: Passo a Passo de Parametrização
- 👉 Minha Conta no Olist ERP: Detalhes do Plano, Limites de Armazenamento e Faturas
- 👉 Usuários no Olist ERP: Como Cadastrar Equipe e Permissões de Acesso por Setor
- 👉 Como Integrar o Mercado Livre no Olist ERP via Hub da Olist (Com Telas)
- 👉 Como Publicar Anúncios no Mercado Livre e Temu via Hub da Olist no ERP
- 👉 Como Integrar a Amazon Brasil no Olist ERP: Guia Completo DBA, FBA e NF-e
- 👉 Como Integrar a Shopee no Olist ERP: Sincronizar Estoque, Pedidos e NF-e
- 👉 Como Integrar o TikTok Shop no Olist ERP: Vendas em Lives, Vídeos e NF-e
- 👉 Como Integrar o Magalu Marketplace no Olist ERP: Magalu Entregas, Full e NF-e
- 👉 Como Integrar a Shein Brasil no Olist ERP: Variações de Moda, Estoque e NF-e
- 👉 Como Integrar o AliExpress Brasil (Local Seller) no Olist ERP: Cainiao e NF-e
- 👉 Como Integrar Casas Bahia Marketplace (Via) e Americanas no Olist ERP
- 👉 Como Integrar a Nuvemshop no Olist ERP: Estoque, Frete, Preços e NF-e
- 👉 Como Integrar o WooCommerce (WordPress) no Olist ERP: API REST e Webhooks
- 👉 Como Integrar a Loja Integrada no Olist ERP: Chave de API, Estoque e NF-e
- 👉 Como Integrar a Tray E-commerce no Olist ERP: Catálogo, Canais de Venda e NF-e
- 👉 Como Integrar a Shopify no Olist ERP: Lojas D2C, Estoque, Frete e NF-e
- 👉 Como Integrar a VTEX no Olist ERP: AppKey, AppToken, OMS, Estoque e NF-e
- 👉 Como Integrar o E-commerce da Olist (Vnda) no Olist ERP: 36 Telas Oficiais
- 👉 Guia de Implementação do Olist ERP para Loja Física (PDV e NFC-e)
- 👉 Configurações do PDV no Olist ERP: Frente de Caixa, Gaveta e Impressão
- 👉 Como Cadastrar Produtos no Olist ERP: Conheça os 5 Métodos Disponíveis
- 👉 Formas de Recebimento no Olist ERP: Configurar Taxas de Cartão, Pix e Prazos
- 👉 Guia de Implementação do Olist ERP para Setor de Serviços e Emissão de NFS-e
- 👉 Cadastro de Serviços e Ordens de Serviço (OS) no Olist ERP Passo a Passo
- 👉 Como Usar uma Integração no Dia a Dia no Olist ERP: Pedidos, NF-e e Expedição
- 👉 Pagamento Integrado no Olist ERP: Taxas de Marketplace, Frete e Intermediador
- 👉 Como Emitir Nota Fiscal de Devolução de Venda no Olist ERP (NF-e Entrada)
- 👉 Como Emitir Nota de Devolução de Compra ao Fornecedor no Olist ERP (NF-e Saída)
- 👉 Como Dar Entrada de XML de Compra e Sincronizar Estoque no Olist ERP (MD-e)
- 👉 Módulo de Separação e Bipagem de Produtos por Código de Barras no Olist ERP
- 👉 Módulo de Expedição, Agrupamento e Impressão de Etiquetas ZPL/PDF no Olist ERP
- 👉 Como Gerar e Analisar o Relatório DRE no Olist ERP: Lucro Líquido Real
- 👉 É Possível Emitir MDF-e no Olist ERP? Resposta Oficial e Alternativas para Carga Própria
- 👉 Como Configurar Transportadoras Próprias e Tabela de Frete Customizada no Olist ERP
- 👉 Gestão de Múltiplos Depósitos de Estoque no Olist ERP: Filiais, Pulmão e Fulfillment
- 👉 Como Criar Múltiplas Listas de Preços no Olist ERP: Preço Atacado vs Varejo e Canais
- 👉 Gestão de Propostas Comerciais e Orçamentos no Olist ERP: Do Envio à Conversão em Venda
- 👉 Como Configurar e Controlar Comissões de Vendedores no Olist ERP: Regras e Metas
- 👉 Emissão Automática de NF-e no Olist ERP: Como Faturar Pedidos sem Clique Manual
- 👉 Conciliação Bancária via Arquivo OFX no Olist ERP: Como Conciliar Extrato sem Furos de Caixa
- 👉 Gestão de Contas a Pagar e Contas a Receber no Olist ERP: Fluxo de Caixa e Alertas da IA Lis
- 👉 Inventário e Balanço de Estoque no Olist ERP: Ajustes por Tela, Planilha ou Coletor
- 👉 Necessidade de Compra no Olist ERP: Como Calcular Reposição de Estoque e Ponto de Pedido
- 👉 Conta Digital Olist no ERP: Como Emitir Cobranças via Pix e Boleto e Conciliar Pagamentos
- 👉 Ordem de Produção e PCP no Olist ERP: Como Gerenciar Matéria-Prima, Fichas Técnicas e Kits Industriais
🚀 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):
Acelere sua operação com as melhores ferramentas
Utilize cupons exclusivos negociados diretamente com grandes players de E-commerce, ERP e Inteligência Artificial.



Deixe um comentário