WooCommerce (Woo): conectar a loja, configurar o frete e importar pedidos

A integração com o WooCommerce, também chamado de Woo, traz os pedidos da sua loja para o Veolog e devolve o rastreamento ao pedido. O plugin Veolog Frete para WooCommerce também mostra preços e prazos de entrega no carrinho e na finalização da compra.

Comece pela instalação no WordPress. Depois, escolha quais pedidos importar e faça um teste completo: consultar o frete, criar um pedido e conferir os dados que chegaram ao Veolog.

1. Confira o que você precisa

• Acesso de administrador no Veolog e permissão para instalar plugins e gerenciar o WooCommerce na loja.
• Loja acessível por HTTPS, com WooCommerce ativo. O plugin Veolog exige WordPress 6.5 ou superior, PHP 7.4 ou superior e WooCommerce 9.9 ou superior. A versão do WooCommerce instalada pode exigir versões maiores de WordPress e PHP.
• Moeda em reais (BRL) e entregas habilitadas para o Brasil. Confira essas opções em WooCommerce > Configurações > Geral.
• Remetente e serviços de frete configurados no Veolog. Confira o endereço de origem e as transportadoras que pretende usar.
• Peso e medidas dos produtos físicos. Cada item precisa ter peso, comprimento, largura e altura para que o plugin calcule o frete.

Se outra pessoa cuida do WordPress, peça a ela para conferir os requisitos da versão do WooCommerce antes de instalar ou atualizar plugins.

2. Instale o plugin e conecte a loja

1. No Veolog, abra Configurações > Integrações > WooCommerce e clique em Baixar Plugin Veolog. Guarde o arquivo ZIP sem descompactar.
2. No WordPress, vá a Plugins > Adicionar plugin > Enviar plugin. Selecione o ZIP, instale e ative Veolog Frete para WooCommerce.
3. A tela do plugin abre após a ativação. Se ela não aparecer, acesse WooCommerce > Veolog.
4. Clique em Conectar à Veolog. Entre na conta Veolog que vai receber os pedidos, confira o endereço da loja e clique em Continuar.
5. Na tela de autorização do WooCommerce, aprove o acesso. Essa permissão permite consultar os pedidos e produtos e registrar o rastreamento.
6. Ao retornar, confira a conexão e as áreas com Frete Veolog ativo. Volte também à integração no Veolog e confirme que ela mostra a loja correta.

Faça a autorização no mesmo navegador e conclua em até dez minutos. Se cancelar ou deixar a autorização expirar, volte a WooCommerce > Veolog e inicie novamente. As credenciais são configuradas automaticamente durante esse processo.

3. Confira onde o frete será oferecido

Depois de uma nova autorização, o Veolog configura o método de frete nas áreas definidas exclusivamente para o Brasil ou seus estados. Em uma loja sem áreas cadastradas e sem métodos em Locais não cobertos, ele cria uma área Brasil. Os outros métodos de entrega continuam disponíveis.

Se a tela indicar uma pendência, use Ativar frete ou Configurar áreas de entrega. Áreas que misturam países ou usam apenas CEPs precisam ser revisadas no editor do WooCommerce. Abra a área correspondente ao cliente, adicione o método Veolog se necessário e confira se está habilitado.

A ordem das áreas faz diferença: o WooCommerce usa a primeira que corresponde ao endereço do comprador. Por exemplo, se um CEP entra em uma área específica de São Paulo, o método precisa estar ativo nessa área; tê-lo apenas na área Brasil pode não bastar. Consulte o guia oficial de áreas de entrega para ajustar regiões e ordem.

Se a conexão foi feita com outra moeda, altere para BRL, salve e retorne à tela Veolog no WordPress para conferir a ativação pendente. Instalar ou atualizar o plugin, por si só, não conclui a conexão.

4. Cadastre peso e medidas sem confundir as unidades

1. No WordPress, abra Produtos > Todos os produtos e edite um produto físico.
2. Em Dados do produto > Entrega, preencha peso, comprimento, largura e altura. Dependendo da tradução, a aba pode aparecer como Shipping.
3. Confira as unidades em WooCommerce > Configurações > Produtos > Geral. Por exemplo, 500 gramas correspondem a 0,5 kg: o número informado precisa seguir a unidade selecionada.
4. Se o produto tem variações, confira também os dados de cada variação vendida. Salve a alteração no produto.

As medidas são por unidade; o plugin considera a quantidade comprada. Produtos virtuais não entram no cálculo. Se um produto físico do carrinho estiver sem peso ou alguma dimensão, o Veolog não apresenta frete para aquele pacote. Veja os campos no manual do editor de produtos do WooCommerce.

A Embalagem padrão escolhida na integração Veolog serve para pedidos importados com dados incompletos. Ela não preenche os produtos no WordPress nem resolve a falta de medidas no checkout. Antes de emitir uma etiqueta, confira sempre o peso e as medidas da encomenda já embalada.

5. Escolha os pedidos que vão entrar no Veolog

Na integração WooCommerce do Veolog, a primeira configuração pergunta Deseja importar pedidos antigos? Informe de 1 a 30 dias e clique em Importar pedidos. Se não quiser trazer o histórico, escolha Não importar.

Ative Sincronização automática para continuar recebendo pedidos e enviando rastreios. Em Padrões para pedidos importados, você pode escolher:

• Serviço padrão: usado quando o pedido não informa uma modalidade. Ele precisa estar disponível para aquela encomenda. Se o pedido informar um serviço que não puder ser identificado, revise a escolha no Veolog.
• Embalagem padrão: usada quando o pedido chega com peso ou dimensões incompletos. Escolha uma embalagem que corresponda ao que você realmente envia.

Clique em Salvar depois de alterar a sincronização ou os padrões. Para buscar os pedidos sem aguardar a próxima atualização automática, use Atualizar agora.

A importação considera pedidos em Processando (processing), em reais e com entrega no Brasil. Pedidos aguardando pagamento, concluídos, cancelados, reembolsados, com falha ou de retirada local ficam de fora. Produtos virtuais também não geram envio. Pedidos feitos com outro método de frete podem entrar; nesse caso, confira o serviço selecionado no Veolog.

6. Revise o pedido e emita a etiqueta

1. Localize o pedido no Carrinho ou em Envios. Pedidos com contrato Veolog vão para o Carrinho; com contrato próprio identificado, podem aparecer em Envios, inclusive com pendências.
2. Se aparecer Edição necessária, use Editar e corrigir no registro. No Carrinho, essa ação aparece no ícone de lápis. Confira remetente, destinatário, número, bairro, CEP, produtos, quantidades, peso, medidas e serviço.
3. Preencha o documento exigido para o envio. A importação não gera uma nota fiscal nem dispensa essa revisão.
4. Para fretes do contrato Veolog, selecione o pedido no Carrinho e use Finalizar pagamento. Com contrato próprio, siga a solicitação da etiqueta em Envios > Etiquetas.
5. Quando a etiqueta estiver pronta, use Imprimir, prepare a encomenda e faça a postagem no local compatível com o serviço.

Para ver as etapas com mais detalhes, consulte como revisar e pagar no Carrinho e como gerar e imprimir etiquetas.

7. Entenda quando o rastreio volta à loja

Mantenha a sincronização automática ativa. A integração envia o rastreamento ao WooCommerce quando o envio passa para em trânsito ou entregue. A emissão da etiqueta, sozinha, não dispara essa atualização.

O plugin mostra código, transportadora e link de acompanhamento nos detalhes do pedido e nos e-mails de pedido enviados depois pelo WooCommerce. A atualização do rastreio não envia um novo e-mail por conta própria e não muda o status comercial do pedido para Concluído. Se sua loja usa telas ou e-mails personalizados, confira a exibição em um pedido de teste.

Se algo não funcionar

A autorização não termina

Confira se o plugin está ativo, se você entrou nas contas corretas e se tem permissão de administrador. Recomece em WooCommerce > Veolog > Configuração avançada > Reconectar à Veolog. Se continuar falhando, peça ao responsável pelo site para verificar HTTPS, links permanentes e bloqueios de segurança ou cache na API do WooCommerce.

O frete não aparece no carrinho ou checkout

Teste com um produto físico de dados completos, moeda BRL e CEP brasileiro de oito dígitos. Confira a área de entrega que atende esse CEP e se o método Veolog está ativo nela. Depois, confira os serviços disponíveis e as regras de frete no Veolog. Um único item sem peso ou medidas pode impedir o cálculo do pacote inteiro.

O pedido não foi importado

Confira o período escolhido, o status Processando, o país e a moeda do pedido. Use Atualizar agora e procure também em Envios e no Carrinho. Uma nova sincronização reconhece os pedidos já importados, por isso eles não devem aparecer como uma nova cópia.

O pedido veio sem número ou bairro

Atualize o plugin Veolog e teste um novo pedido: ele inclui Número e Bairro nos checkouts clássico e por blocos. Para um pedido que já está no Veolog, use Editar e corrigir no registro com pendência. Atualizar o plugin ou sincronizar de novo não preenche automaticamente o pedido já importado.

Preciso atualizar o plugin ou interromper a integração

Baixe o plugin Veolog atualizado e envie o ZIP em Plugins > Adicionar plugin > Enviar plugin, confirmando a substituição da versão instalada. Para interromper apenas as tarifas, desative Veolog nas áreas de entrega. Para encerrar a conexão, use Desvincular no Veolog; novos pedidos, cotações e atualizações de rastreio dessa conexão serão interrompidos.

Se precisar de ajuda, informe ao suporte a loja, o número do pedido, o horário do teste e a mensagem apresentada. Esses dados ajudam a localizar a falha sem enviar senhas ou chaves de acesso.