Como integrar a Centra do Frete em sua loja WooCommerce

Ofereça cotação de frete em tempo real com múltiplas transportadoras na sua loja virtual WordPress.

Requisitos: WordPress 5.6+ | WooCommerce 5.0+ | PHP 7.4+

O que você ganha com a integração

Com o plugin da Central do Frete, seus clientes veem automaticamente as opções de frete disponíveis com preços e prazos reais durante a compra. Tudo isso sem precisar configurar transportadora por transportadora.

• Várias transportadoras — Seu cliente vê opções de várias transportadoras em uma única consulta.
• Cotação em tempo real — Preços e prazos atualizados a cada consulta.
• Calculador no produto — O cliente calcula o frete direto na página do produto, antes de comprar.
• Personalizável — Controle quais transportadoras exibir, adicione prazos extras e taxas de manuseio.

Parte 1 — Instalar o plugin

1. Faça o download do plugin (arquivo .zip) na página de releases do GitHub: github.com/central-do-frete/CentraldoFrete-WooCommerce/releases. Clique no arquivo CentraldoFrete-WooCommerce.zip para baixar.
2. No painel do WordPress, vá em Plugins › Adicionar novo e clique em Enviar plugin (botão no topo da página).
   
3. Clique em Escolher arquivo, selecione o .zip que você baixou e depois clique em Instalar agora.
   
4. Quando a instalação terminar, clique em Ativar plugin. Pronto, o plugin está instalado!
   

Parte 2 — Configurar a área de entrega

Antes de ativar a Central do Frete, você precisa ter uma área de entrega configurada no WooCommerce. Se já tiver uma para o Brasil, pode pular para a Parte 3.

1. No painel do WordPress, acesse WooCommerce › Configurações › Entrega.
2. Se você ainda não tem uma área de entrega para o Brasil, clique em Adicionar área de entrega. Dê um nome (ex: "Brasil") e selecione as regiões que deseja atender.
   
3. Dentro da área de entrega, clique em Adicionar método de entrega.
   
4. Na lista que aparece, selecione Central do Frete e confirme.
   
5. Finalizado a etapa acima, clique em EDITAR
   

Parte 3 — Configurar o plugin

Agora vamos conectar o plugin à sua conta da Central do Frete usando o token de acesso.

1. Na área de entrega onde você adicionou a Central do Frete, clique em Editar no método Central do Frete.
2. No campo Token de acesso, cole o token da sua conta. Para encontrá-lo, acesse app.centraldofrete.com, vá em Integrações › API e copie (ou gere) o token.
3. Clique em Salvar.
   
4. Após salvar, clique no botão Atualizar Tipos de Carga. Isso carrega automaticamente os tipos de carga disponíveis na sua conta.
5. Configure as demais opções conforme a sua necessidade (veja a tabela abaixo).

Opções disponíveis

Parte 4 — Configurar seus produtos

Para que as cotações de frete sejam precisas, cada produto precisa ter peso e dimensões cadastrados.

1. Edite um produto e vá na aba Envio (dentro de "Dados do produto").
2. Preencha Peso e Dimensões (comprimento, largura e altura).
3. Se necessário, selecione um Tipo de Carga específico para este produto. Caso não selecione nenhum, será usado o tipo de carga padrão configurado no plugin.
4. Salve o produto. Repita para os demais produtos da loja.
   
    

⚠️ Atenção: Produtos sem peso e dimensões não terão cotação de frete calculada corretamente. Configure pelo menos as dimensões padrão no plugin para evitar problemas.

Calculador de frete na página do produto

O plugin inclui um calculador de frete que aparece automaticamente na página de cada produto. Seu cliente pode digitar o CEP e ver as opções de transportadora, prazo e valor antes mesmo de adicionar ao carrinho.

O CEP digitado fica salvo na sessão do cliente, então quando ele for ao checkout, o campo de CEP já aparece preenchido.

Algo não está funcionando?

Se você encontrar algum problema com as cotações ou com o plugin, siga estas etapas:

1. Nas configurações do plugin (dentro da área de entrega), ative o Modo debug.
2. Faça uma cotação teste na sua loja.
3. Acesse WooCommerce › Status › Logs e procure por arquivos que começam com central-do-frete.
4. Os logs mostram detalhes das consultas feitas, incluindo erros, cálculos de volume e uso de cache. Use essas informações para identificar o problema ou envie para nosso suporte.

💡 Dica: Lembre de desativar o modo debug depois de resolver o problema, para não acumular logs desnecessários.

Precisa de ajuda?

Se tiver dúvidas ou dificuldades durante a integração, entre em contato:

• 🌐 centraldofrete.com
• 📧 Envie um chamado pela nossa Central de Ajuda

✅ Pronto! Sua loja WooCommerce já está integrada com a Central do Frete. Seus clientes agora podem comparar fretes de diferentes transportadoras e escolher a melhor opção diretamente no checkout.