Central de ajuda

Marketplaces e lojas

Conecte Nuvemshop, Tray, VTEX, WooCommerce ou Shopify

Conecte a sua loja virtual ao Ravion, escolha o depósito que atende, vincule os produtos pelo SKU e deixe pedidos e estoque andarem sozinhos.

Atualizado em 16/10/2026

Com a loja virtual conectada, os pedidos pagos entram no Ravion e o estoque dos produtos vinculados vai para a loja. Depois de conectar, você escolhe o depósito que atende a loja e liga os produtos da loja aos do Ravion pelo SKU.

Antes de começar

  • Só a função Administrador conecta lojas e altera a configuração.
  • Use o mesmo SKU (código do produto) na loja e no Ravion: é por ele que produtos e variações se ligam.
  • Tenha pelo menos um depósito ativo em Sistema › Depósitos e endereços.
  • Cada loja nova conta no limite de lojas virtuais do seu plano.

Passo a passo

  1. Abra Sistema › Integrações e escolha a categoria "Lojas virtuais (e-commerce)".
  2. Clique no cartão da sua plataforma.
  3. No cartão "Conectar loja", preencha os dados pedidos (veja abaixo) e clique no botão de conectar. O Ravion testa os dados na loja antes de gravar.
  4. No cartão da loja conectada, escolha o "Depósito que atende a loja": de onde saem os pedidos e o estoque enviado.
  5. Marque as opções que quiser: "Atualizar o estoque na loja sozinho", "Importar os pedidos sozinho" e "Pedido pago já entra aprovado (reserva o estoque)". Clique em "Salvar configuração".
  6. Clique em "Vincular produtos por SKU". O cartão passa a mostrar quantos produtos da loja foram vinculados.
  7. Clique em "Importar pedidos (3 dias)" para trazer os pedidos recentes. Para conferir se a loja responde, use "Testar conexão".

O que cada plataforma pede

Nuvemshop

Se aparecer o botão "Instalar o Ravion na Nuvemshop", clique nele e autorize na Nuvemshop. Se não, use um token de acesso já gerado: preencha "ID da loja" e "Token de acesso" e clique em "Conectar". Nesse caso, os pedidos chegam pela importação de hora em hora.

Tray

Instale o aplicativo na loja Tray. Ele devolve o code e o endereço da API. Se precisar preencher à mão, informe "Endereço da API" (por exemplo, https://www.sualoja.com.br/web_api) e "Code da instalação" e clique em "Conectar". Se a tela pedir, informe também "Consumer key do aplicativo" e "Consumer secret do aplicativo". Depois, coloque no aplicativo da Tray a "URL de notificações" mostrada no cartão da loja.

VTEX

No admin da VTEX, crie uma chave de API em Configurações da conta › Chaves de aplicação, com acesso a OMS, Catálogo, Logística e Preços. No Ravion, preencha "Conta VTEX" (o nome antes de .vtexcommercestable.com.br), "Nome para mostrar", "App Key", "App Token" e "Depósito (warehouse) da VTEX", que pode ser informado depois.

WooCommerce

Informe o "Endereço da loja" e clique em "Conectar com o WooCommerce". O Ravion abre a tela de autorização do próprio WooCommerce: entre no WordPress e aprove. Se a autorização não funcionar, crie uma chave em WooCommerce › Configurações › Avançado › API REST › Adicionar chave, com permissão Leitura/Gravação, e preencha "Chave do consumidor (ck_…)" e "Segredo do consumidor (cs_…)" em "Conectar com a chave". Para CPF, número e bairro nos pedidos, use o plugin Brazilian Market on WooCommerce.

Shopify

No admin da Shopify, vá em Configurações › Apps › Desenvolver apps › Criar app, com os escopos de pedidos, produtos, estoque e locais (leitura e escrita). Instale o app e copie o token de acesso e a chave secreta. No Ravion, preencha "Loja" (minhaloja.myshopify.com), "Token de acesso do Admin API (shpat_…)" e "Chave secreta da API" e clique em "Conectar". O estoque vai para o "Local de estoque da Shopify (id)" informado na configuração; em branco, para o primeiro local ativo.

Como funciona

  • Pedidos: a loja avisa o Ravion a cada pedido (na Tray, pela URL de notificações). Com "Importar os pedidos sozinho" marcado, uma importação de hora em hora traz o que o aviso não trouxe. Se o aviso parar de chegar na Nuvemshop, VTEX, WooCommerce ou Shopify, clique em "Cadastrar aviso de pedidos".
  • Um pedido específico: use "Importar um pedido pelo número".
  • Vínculo: produto sem SKU igual no Ravion fica sem vínculo e não recebe estoque.
  • Desativar: a conta para de importar pedidos e de publicar estoque. "Ativar" volta.
  • Estoque Drop: no fim do cartão, "Estoque Drop desta conta" define se o estoque de fornecedores soma no que vai para a loja. Veja Estoque Drop: venda o estoque do fornecedor.

Tray com Multi CD

Se a sua loja Tray usa vários centros de distribuição, clique em "Verificar na Tray". Com o Multi CD ligado, ligue cada CD da Tray a um depósito do Ravion e clique em "Salvar Multi CD": o estoque de cada depósito vai para o CD dele, e o pedido entra no depósito do CD de origem. Enquanto nenhum CD estiver ligado, o estoque não vai para a loja. "Criar CD para…" cria na Tray o CD de um depósito, e "Conferir" compara o estoque de um SKU em cada CD e corrige o que estiver diferente.

Outras plataformas

Para Loja Integrada, Magento ou um site próprio, use o cartão "Loja própria (API)": quem desenvolve a sua loja faz a integração pela API do Ravion.

Problemas comuns

  • Aparece o cartão "Confirmar a conexão". A instalação começou na plataforma. Clique em "Conectar esta loja" só se foi você quem autorizou agora; senão, clique em "Não conectar". O pedido vale por 10 minutos.
  • Estoque não chega na VTEX. Informe o "Depósito (warehouse) da VTEX" e salve a configuração.

Para anúncios, estoque e preço, veja Anúncios, preço e estoque publicados nos canais.

Este artigo ajudou?