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.

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.

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:

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!

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.

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