Com a loja conectada, você pode trazer os pedidos para o Veolog, preparar os envios e devolver o rastreamento para a plataforma. O frete exibido na loja depende também da configuração do Gateway de Frete, que consulta os preços e prazos do Veolog durante a compra.
Este guia atende às duas plataformas. No Veolog, abra o cartão Tray para uma loja Tray ou o cartão Bagy para uma loja Bagy. Os cartões compartilham a mesma conexão: salvar preferências ou desvincular a loja em um deles também afeta o outro.
Antes de começar
- Entre no Veolog com uma conta que possa gerenciar integrações e tenha acesso administrativo à loja que será conectada.
- Separe o endereço da loja, por exemplo, minha-loja.com.br.
- Confira o endereço de origem dos envios, os serviços das transportadoras e as regras de frete no Veolog.
- Revise peso, comprimento, largura e altura dos produtos na plataforma. Esses dados influenciam o cálculo do frete.
1. Conecte e autorize a loja
- No Veolog, acesse Configurações > Integrações.
- Abra Tray ou Bagy, conforme sua loja.
- Em Domínio da loja, informe o endereço da loja. Você pode colar o link completo; o Veolog usa apenas o domínio.
- Clique em Conectar loja. Na página aberta pela plataforma, entre na conta da loja e conclua a autorização do Veolog.
- Aguarde o retorno ao Veolog e confira a mensagem de conexão. Se você gerencia mais de uma loja, confirme que autorizou a loja desejada.
O Veolog tenta configurar o Gateway de Frete durante essa conexão. Se a mensagem confirmar que a loja e o gateway estão configurados, avance para o teste de frete. Se ela pedir configuração manual ou informar que o gateway requer atenção, conclua a etapa abaixo.
2. Confira o frete da loja
Conseguir importar pedidos e conseguir mostrar frete na loja são verificações separadas. Por isso, mesmo depois de conectar, faça uma simulação de compra: coloque um produto no carrinho da loja, informe um CEP atendido e confira as opções, os valores e os prazos.
Quando aparecer “O Gateway de Frete precisa ser configurado manualmente”
- No aviso do Veolog, clique em Revelar dados do gateway.
- Informe sua senha atual do Veolog e clique em Confirmar e revelar.
- Copie a URL e o Token exibidos para os campos correspondentes da configuração de frete da sua loja.
Na Tray: se o recurso ainda não estiver habilitado, acesse Aplicativos > Instalar Novos Aplicativos, procure Gateway de Fretes e instale. Esse é o caminho indicado no guia oficial da Tray para habilitar o gateway.
- No painel Tray, abra Configurações e, no grupo Frete e Envio, clique em Geral > Integração Externa.
- Identifique a integração como Veolog e revise os acréscimos de frete. Uma taxa adicional nesse painel pode alterar o valor apresentado ao cliente.
- Salve e abra a aba Configuração. Preencha URL do Webservice e Token com os dados revelados no Veolog.
- Salve a configuração e volte à opção Habilitada para marcar Sim.
Os campos e a ordem de habilitação estão descritos no passo a passo oficial de integração com transportadoras da Tray.
Na Bagy: use a URL e o token mostrados para sua loja no Veolog. Se o painel apresentar as mesmas opções de integração externa descritas acima, siga esses campos. Se não encontrar essa configuração, peça ao suporte da Bagy o caminho de configuração do Gateway de Frete para sua loja.
Depois do cadastro manual, o Veolog precisa identificar o método de frete criado na plataforma. A tela atual ainda não oferece o campo para informar esse número. Peça ao suporte do Veolog para concluir o vínculo, informando o domínio da loja e o ID do método, se estiver disponível. Não envie sua senha nem o token.
3. Escolha se quer trazer pedidos antigos
Depois da conexão, a tela pode perguntar Deseja importar pedidos antigos? Você tem duas opções:
- Importar pedidos: preencha Importar pedidos dos últimos com um número de 1 a 30 dias e confirme. Por exemplo, informe 7 para buscar os pedidos da última semana que atendam às condições de importação.
- Não importar: siga sem buscar o histórico anterior à conexão. Acompanhe os novos pedidos pela sincronização automática.
Aguarde a conclusão da busca antes de repetir a ação. Importar um pedido prepara o envio no Veolog; essa ação não emite a etiqueta automaticamente.
Quais pedidos entram no Veolog?
A importação considera pedidos com produtos físicos para entrega, dentro do período permitido, ainda não enviados e em uma destas situações da loja:
- A ENVIAR ou AGUARDANDO ENVIO;
- A ENVIAR VINDI, A ENVIAR YAPAY, A ENVIAR MASTER, A ENVIAR VISA ou A ENVIAR ELO.
Para Tray e Bagy, a situação pronta para envio orienta a importação. Um pedido nessas situações pode entrar mesmo que a plataforma ainda não informe pagamento confirmado. Confira o pagamento na sua rotina de separação antes de despachar a mercadoria.
Pedidos cancelados, encerrados, já enviados ou fora dessas situações não entram como novos envios. Um pedido com dados incompletos pode aparecer para revisão: isso permite corrigir o cadastro antes de emitir a etiqueta.
4. Ajuste os padrões e mantenha a sincronização ativa
Em Padrões para pedidos importados, configure apenas o que fizer sentido para sua operação:
- Serviço padrão: é usado quando a plataforma não informa a modalidade de entrega. Escolha um serviço que você realmente utiliza.
- Embalagem padrão: substitui peso e dimensões quando o pedido chega com esses dados incompletos. Escolha uma embalagem compatível com seus envios ou use Criar nova embalagem.
Se você trabalha com pacotes muito diferentes, revise a embalagem de cada pedido. Por exemplo, o padrão de uma camiseta não representa uma caixa com vários pares de sapatos. Esses padrões de importação também não substituem a revisão do cadastro dos produtos usado no frete da loja.
Deixe Sincronização automática como Ativa para manter a busca de pedidos e o retorno das atualizações. Clique em Salvar após alterar as preferências. Para solicitar uma nova busca manualmente, use Atualizar agora e aguarde o resultado.
5. Revise os pedidos e emita as etiquetas
Pesquise pelo número do pedido no Carrinho e em Envios. O destino depende do contrato de frete identificado: pedidos com contrato Veolog vão para o Carrinho; pedidos com contrato próprio podem ir diretamente para Envios.
Se aparecer Edição necessária, abra o item e confira as pendências indicadas. Revise destinatário, documento, endereço, peso, medidas, modalidade e dados fiscais. Quando o serviço ou contrato não puder ser identificado, escolha uma opção válida antes de continuar.
Com os dados corretos, siga o processo de emissão da etiqueta no Veolog. A presença do pedido na lista não significa que a etiqueta já está pronta para imprimir.
6. Acompanhe o rastreamento
Com a sincronização ativa, o Veolog envia o código e o link de rastreamento quando o envio entra em transporte e volta a atualizar a loja quando registra a entrega. A simples emissão da etiqueta não garante uma atualização imediata da situação do pedido na plataforma.
O Veolog procura as situações correspondentes disponíveis na loja, como Enviado ou Em transporte e, na entrega, Entregue ou Finalizado. Se o envio avançar no Veolog e a situação continuar parada na loja, informe o número do pedido ao suporte para conferir essa correspondência.
Problemas comuns e como resolver
A autorização falhou
Confira o domínio informado e entre na conta administrativa da loja correta. Volte ao cartão e inicie a conexão novamente. Se o Veolog mostrar que a integração está desabilitada ou indisponível, envie essa mensagem ao suporte.
A loja está conectada, mas não aparece frete
Confira se o Gateway de Frete está habilitado na loja e se há algum aviso na integração. Revise também os serviços ativos no Veolog, as regras de frete, a origem, o CEP de destino e o peso e as medidas do produto. Se você fez a configuração manual, confira se a URL e o token foram copiados por completo.
O valor do frete é diferente no checkout
Compare o mesmo CEP, produto, quantidade, peso e medidas. Depois confira as regras de frete no Veolog e os acréscimos configurados no painel da plataforma. Testar uma unidade e duas unidades do mesmo produto ajuda a identificar um cadastro de peso ou medidas incorreto.
Um pedido não foi importado
Confira a data, a situação na loja e se o pedido já foi enviado ou cancelado. Verifique se você escolheu importar o período correspondente e se a sincronização está ativa. Use Atualizar agora uma vez, aguarde e pesquise em Carrinho e Envios antes de cadastrar o pedido manualmente.
O rastreamento não voltou para a loja
Confirme que o envio veio dessa integração, já possui código de rastreamento e chegou à etapa de transporte ou entrega. Confira a conexão e a opção Sincronização automática. Se continuar pendente, envie ao suporte o domínio, o número do pedido e a mensagem exibida no Veolog.