terça-feira, 29 de setembro de 2026
Como Integrar a Tray E-commerce no Olist ERP: Guia Completo de Catálogo, Estoque, Frete e NF-e (Com Telas)

Integrar a Tray E-commerce ao Olist ERP é o caminho definitivo para lojistas que desejam transformar sua loja virtual em uma operação escalável, faturando Notas Fiscais Eletrônicas (NF-e Modelo 55) em lote, controlando o estoque físico e disponível em tempo real e unificando em um único sistema tanto as vendas diretas (D2C) da loja virtual quanto os pedidos vindos dos marketplaces conectados via Tray (ou diretamente no Hub do ERP).

Muitos empreendedores que iniciam na Tray esbarram em um gargalo clássico: tentam operar apenas pelo painel da loja virtual ou utilizam faturadores básicos que não possuem controle de Reserva de Estoque, Estoque de Segurança, DRE Gerencial com abatimento de taxas por canal ou Ordem de Compra e Suprimentos. Quando o volume passa de 15 a 30 pedidos por dia, a falta de um ERP robusto gera furos de estoque, atrasos na expedição e erros na apuração de impostos.

Neste Super Guia Completo e Ilustrado (com 12 telas e GIFs oficiais do Olist ERP), você vai aprender passo a passo como instalar, autenticar via URL segura e parametrizar a integração da Tray no Olist ERP, configurar a aba exclusiva de Canais de Venda (Tray como Hub), sincronizar kits e variações, mapear pagamentos (Vindi/Yapay) e automatizar o envio do XML da NF-e e do código de rastreio.

🎁 Benefício Exclusivo para Lojistas Tray: Cupom GEFF no Olist ERP

Conecte sua loja virtual Tray ao Olist ERP com nossa condição especial de especialista parceiro: ganhe 30 dias de uso gratuito + 3 meses com 50% de desconto na mensalidade + Inteligência Artificial LIS liberada para enriquecer títulos e descrições do seu catálogo!

  • ✅ Olist ERP (30 dias grátis + 50% OFF por 3 meses): Use o cupom oficial GEFF no link abaixo.
  • 🚚 Olist Envios (R$ 100 de Bônus no Frete da sua Loja Tray): Reduza o abandono de carrinho com fretes até 70% mais baratos usando o cupom GEFF em Olist Envios.
  • 💰 Capital de Giro Flip by Olist: Antecipe suas notas fiscais emitidas na Tray com taxas reduzidas aplicando o cupom GEFFALENCAR em Flip Crédito.

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

1. O Que a Integração Oficial Tray + Olist ERP Faz pela Sua Loja?

A integração nativa entre a Tray e o Olist ERP opera de ponta a ponta com suporte completo ao módulo OMS (Order Management System). Confira todos os fluxos automatizados:

  • Receber produtos e Enviar produtos: Importe todos os produtos cadastrados na sua loja Tray para o Olist ERP ou cadastre seus produtos, kits e grades de variação (Cor/Tamanho) no ERP e exporte-os prontos para a Tray.
  • Receber pedidos em tempo real: Assim que um cliente conclui a compra na sua loja Tray (ou em um marketplace plugado na Tray), o pedido é importado automaticamente para o ERP.
  • Enviar estoque (Saldo Disponível + Segurança): Baixa o estoque automaticamente a cada venda e sincroniza o saldo líquido entre a loja Tray, Mercado Livre, Shopee, Amazon e loja física (PDV).
  • Enviar preços (Preço Fixo, Lista ou Regra): Atualize preços de venda e preços promocionais (De/Por) na Tray diretamente a partir das telas de reajuste do ERP.
  • Sincronizar situação, NF-e e Rastreio: Ao emitir a NF-e e despachar o pedido no Olist ERP, a chave de acesso de 44 dígitos, o link do XML/DANFE e o código de rastreamento da transportadora retornam automaticamente para o painel da Tray, disparando o aviso ao consumidor.
Recurso OperacionalOperar Apenas pelo Painel Tray / Faturador BásicoTray Integrada ao Olist ERP Completo
Controle de Reserva e Estoque de SegurançaLimitado; risco de vender o último item simultaneamente em dois canais.Reserva automática no ato do pedido + margem de segurança antirruptura configurável.
Mapeamento de Canais (Tray como Hub)Sem distinção automática de Intermediador Fiscal e comissão líquida na DRE.Aba exclusiva Canais de Venda identifica cada marketplace, preenche o CNPJ do Intermediador na NF-e e desconta a comissão exata.
Gestão de Kits (Composições) e ComprasControle manual de insumos e reposição de fornecedores.Baixa automática dos componentes do kit na venda + importação de XML de compra para dar entrada no estoque.
Expedição por Código de Barras (Bipagem)Conferência visual sujeita a envio de item trocado.Conferência cega via leitor de código de barras EAN-13 + impressão casada de DANFE e Etiqueta Olist Envios.

2. Passo a Passo: Como Instalar e Autenticar a Tray no Olist ERP

Para conectar sua loja virtual Tray ao Olist ERP de forma segura via OAuth, siga exatamente estas etapas:

  1. No menu lateral do seu Olist ERP, acesse Início > Integrações;
  2. Clique em Adicionar integração, digite Tray no campo de pesquisa e clique em Instalar;
  3. Na aba Integração, no campo Nome, defina um identificador claro para a sua loja (ex: Loja Virtual Tray - Matriz);
  4. Na seção Autenticação, preencha o campo Endereço seguro do site (URL HTTPS): acesse o painel administrativo da sua conta Tray, copie a URL segura que aparece na barra de endereços do navegador e cole no respectivo campo dentro do Olist ERP;
  5. Clique no botão “Conectar na Tray” (e em seguida em “Conectar com Tray”). Você será direcionado para a tela de login da Tray: insira seu usuário administrador e senha para autorizar a comunicação automática e retornar ao ERP.

3. Configurando a Aba Exclusiva “Canais de Venda” (Para Quem Usa a Tray como Hub)

Um diferencial poderoso da integração Tray no Olist ERP é a aba Canais de Venda. Se você conecta marketplaces por dentro da Tray, esta aba permite que o Olist ERP reconheça de qual marketplace veio cada pedido, preencha automaticamente o CNPJ do Intermediador na NF-e (NT 2020.006) e calcule a comissão exata daquele canal:

  • Clique em Adicionar canal de venda;
  • Informe o Código do canal de venda no e-commerce (ID do canal na Tray) e selecione o Intermediador da transação correspondente;
  • Marque a opção caso deseje Importar o valor do frete nos pedidos deste canal;
  • Defina os parâmetros financeiros para apuração exata do seu lucro líquido: Taxa (%), Valor mínimo de comissão, Valor unitário mínimo, Valor adicional mínimo e a Base de cálculo para comissão (Total da venda ou Total da venda sem frete);
  • Caso o integrador cobre uma taxa extra sobre o canal, habilite a chave “Integrador cobra taxa para este canal de venda” e clique em Salvar.

4. Aba Produtos: Estoque Disponível, Estoque de Segurança, Preços e Imagens

Na aba Produtos, você parametriza como o catálogo e o saldo do Olist ERP serão sincronizados com a sua loja Tray:

Configuração de envio de saldo disponível na aba Produtos do Olist ERP
Passo 1 da Aba Produtos: Selecione “Enviar saldo disponível” para proteger sua loja Tray contra vendas duplicadas.
Seleção de depósito de estoque próprio ou geral na integração do Olist ERP
Passo 2: Escolha o depósito “Geral” (ou “Todos os próprios” caso opere múltiplos galpões ou loja física integrada).
Lançamento automático de saída de estoque ao autorizar a nota fiscal no Olist ERP
Passo 3: Configure o lançamento de estoque como “Automático ao autorizar a nota fiscal”.
GIF oficial demonstrando a configuração do Estoque de Segurança no Olist ERP
Passo 4 (GIF Oficial): Ativando o Estoque de Segurança para zerar o anúncio na loja virtual antes de acabar a última unidade física.
Regras de utilização de preços para o e-commerce Tray no Olist ERP
Passo 5: Defina se a loja Tray utilizará o Preço Fixo do ERP, uma Lista de Preços VIP ou uma Regra de Preço customizada.
Importar imagens como anexos na recepção de produtos da Tray no Olist ERP
Passo 6: Marque “Importar imagens como anexos” para armazenar as fotos dos produtos diretamente no servidor do Olist ERP.

5. Aba Pedidos e Dados Fiscais: Frete, CEP, Intermediador e Natureza de Operação

Na aba Pedidos, você garante que todos os pedidos vindos da Tray cheguem prontos para a emissão da NF-e sem necessidade de digitação manual:

Fluxo de pedidos e importação do valor do frete da Tray no Olist ERP
Passo 7: Habilite a importação do valor de frete pago pelo consumidor no checkout da Tray.
Validação e preenchimento automático de endereço por CEP nos pedidos importados
Passo 8: Configure a validação de endereço por CEP (“Apenas se o bairro não está informado” ou “Sempre”).
Vinculação da Natureza de Operação fiscal de venda na integração Tray do Olist ERP
Passo 9: Vincule a Natureza de Operação padrão para Venda de Mercadorias (e habilite a natureza específica para CNPJ Contribuinte ICMS).
Mapeamento de Situações de Pedidos e Formas de Recebimento na integração do Olist ERP
Passo 10: Mapeie as Situações de Pedidos, as Formas de Recebimento (Vindi, Yapay, Pix, Cartão) e as Formas de Frete (Olist Envios, Correios, Jadlog).

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

1. Onde encontro o “Endereço seguro do site” para autenticar a Tray no Olist ERP?

Basta fazer login no painel administrativo da sua loja Tray e copiar a URL completa (iniciada por https://) exibida na barra de endereços do navegador, colando-a no campo “Endereço seguro do site” na seção Autenticação do Olist ERP.

2. Se eu usar a Tray como Hub de marketplaces, o Olist ERP identifica de qual canal veio a venda?

Sim! Na aba Canais de Venda da integração Tray no Olist ERP, você pode adicionar cada canal conectado na Tray, informando o código do canal, o Intermediador da transação (para a NF-e) e a comissão cobrada.

3. Qual é o limite de imagens enviadas do Olist ERP para os produtos na Tray?

A API da plataforma Tray possui uma limitação técnica própria quanto ao peso e à quantidade máxima de fotos sincronizadas por SKU. Recomendamos cadastrar no Olist ERP fotos otimizadas em JPG/PNG e manter marcada a opção “Importar imagens como anexos”.

4. Posso usar o Olist Envios para despachar os pedidos da minha loja Tray?

Sim! Ao mapear as Formas de Frete na integração e ativar o Olist Envios com o cupom GEFF (que garante R$ 100 de bônus inicial), você gera etiquetas com fretes ultra competitivos direto na expedição do ERP e envia o rastreio automaticamente para a Tray.

5. A chave de acesso da NF-e é enviada automaticamente para o pedido na Tray?

Sim! Assim que a NF-e é autorizada pela SEFAZ no Olist ERP, os dados fiscais (número da nota, série, chave de acesso e link do XML) são sincronizados automaticamente com o pedido na Tray.

6. Como ganhar 30 dias grátis + 50% OFF no Olist ERP para integrar minha loja Tray?

Cadastre-se pelo link oficial info.olist.com/lp-geff utilizando o cupom GEFF para liberar 30 dias gratuitos, 3 meses com 50% de desconto e acesso à IA Lis.

🎁 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!

Deixe um comentário

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