Como integrar a Central do Frete em sua loja WooCommerce

Com o plugin da Central do Frete, sua loja mostra o preço e o prazo de várias transportadoras na hora em que o cliente informa o CEP. Você não precisa cadastrar transportadora por transportadora.

Este guia vai da instalação até o primeiro frete calculado. Você não precisa saber programar. Separe uns 20 minutos.

Antes de começar você precisa de: uma conta na Central do Frete, WordPress 5.6 ou mais novo, WooCommerce 5.0 ou mais novo e PHP 7.4 ou mais novo. Se não souber qual PHP a sua loja usa, pergunte para quem hospeda o site.

O que muda na sua loja

• Várias transportadoras de uma vez — o cliente vê as opções lado a lado e escolhe.
• Preço e prazo de verdade — os valores vêm da sua conta da Central do Frete, não de uma tabela fixa que você tem que atualizar.
• Cálculo já na página do produto — o cliente descobre o frete antes de colocar o item no carrinho.
• Você decide o que aparece — pode mostrar todas as transportadoras ou só as mais baratas, somar dias de preparo, somar uma taxa e escolher quais produtos entram no cálculo.

---

Por onde começar

São cinco partes obrigatórias e duas opcionais. Fazendo só as cinco primeiras, a sua loja já calcula frete corretamente.

• Obrigatório — Partes 1 a 5: instalar o plugin, criar a área de entrega, colar o token de acesso, conferir o CEP da loja e preencher peso e medidas dos produtos.
• Opcional — Partes 6 e 7: como o frete aparece para o cliente e quais produtos entram no cálculo. As duas já vêm prontas de fábrica; mexa quando quiser.
• Só para conferir — no fim do guia: o que o cliente vê na loja e o que fazer se algo não funcionar.

A Parte 5 é a que custa dinheiro quando fica para depois: leia o aviso dela antes de pular.

---

Parte 1 — Instalar o plugin

O plugin está no diretório oficial do WordPress. Dá para instalar sem sair do painel da sua loja: você não precisa baixar arquivo, nem descompactar, nem enviar nada.

1. No painel do WordPress, vá em Plugins › Adicionar plugin. A página que abre se chama Instalar plugins. Em WordPress anterior à versão 6.4 esse item de menu tem outro nome, Adicionar novo, e leva para a mesma página.

2. No campo Pesquisar plugins, no alto da página à direita, digite Central do Frete.

   

3. Nos resultados, o primeiro cartão é o Central do Frete, com Por centraldofrete logo abaixo do nome. A busca traz outros plugins de frete junto, então confira nome e autor antes de instalar.

4. Clique em Instalar agora, no cartão, e espere alguns segundos.

5. O mesmo botão vira Ativar quando a instalação termina. Clique nele.

   

Como saber que deu certo: em Plugins › Plugins instalados, o item Central do Frete aparece na lista e não tem mais o link "Ativar" ao lado dele.

💡 Por que instalar por aqui: plugin instalado pelo diretório recebe atualização. Quando sai uma versão nova, o WordPress avisa em Plugins › Plugins instalados e você atualiza com um clique — ou clica em Ativar atualizações automáticas, na linha do plugin, para ele se atualizar sozinho. Quem instalava enviando um arquivo baixado não recebia aviso nenhum e ficava parado na versão daquele dia.

---

Parte 2 — Dizer para onde a sua loja entrega

O WooCommerce só mostra frete para um cliente se existir uma área de entrega que cubra o endereço dele. Área de entrega é simplesmente a lista de lugares para onde você envia. É aí dentro que a Central do Frete passa a funcionar.

1. Vá em WooCommerce › Configurações › Entrega.

   

   Se já existe uma área que cobre o Brasil, pule para o passo 5.

2. Clique em Adicionar área.

3. Em Nome da área, escreva um nome que faça sentido para você. Por exemplo: Brasil.

4. Em Regiões da área, comece a digitar Brasil e clique no resultado Brasil. Se aparecer Em toda parte ali dentro, clique no x ao lado para tirar.

   

5. Clique em Adicionar método de entrega.

6. Na janela que abre, clique em Central do Frete e depois em Continuar.

   

7. Central do Frete passa a aparecer na lista Métodos de entrega, com a chavinha da coluna Ativo ligada.

   

8. Clique em Salvar alterações.

💡 Dica: vale a pena deixar um segundo método de entrega nessa mesma área, como Taxa fixa, para servir de reserva. Assim, se um dia a consulta de preços falhar, o cliente ainda tem uma opção de frete e consegue fechar o pedido. No exemplo acima, esse segundo método se chama "Correios PAC (fallback)".

---

Parte 3 — Conectar a sua conta da Central do Frete

Agora você vai ligar a loja à sua conta. Isso é feito com um código que a Central do Frete gera para você.

1. Em WooCommerce › Configurações › Entrega, entre na sua área de entrega e clique em Editar na linha da Central do Frete.

2. Em outra aba do navegador, entre em app.centraldofrete.com, vá em Integrações › API e copie o código que aparece ali. Se não houver nenhum, gere um.

3. Volte para a loja e cole esse código no campo Token de acesso. Ele funciona como uma senha: é o que prova para a Central do Frete que a loja é sua. Trate-o como uma senha, não mande por e-mail nem cole em grupos de mensagem.

   

   Depois de salvar, o campo passa a mostrar bolinhas em vez do código. Isso é o esperado, o código continua lá.

4. Deixe Habilitar cotações da Central do Frete marcado.

5. Desça até o fim da página e clique em Salvar alterações.

6. Suba até a seção Tipo de carga e clique em Atualizar Tipos de Carga. A página recarrega sozinha e aparece a mensagem X tipos de carga carregados.

   

7. Em Tipo padrão, escolha a categoria que descreve a maior parte do que você vende. Tipo de carga é a categoria da mercadoria, como móveis ou carga geral, e algumas transportadoras cobram valores diferentes por categoria.

8. Clique em Salvar alterações outra vez.

Como saber que deu certo: a mensagem verde de tipos de carga carregados aparece e a lista Tipo padrão deixa de estar vazia.

Se o botão não trouxer nada, o motivo mais comum é o código estar incompleto ou com um caractere trocado. Copie e cole de novo, sem espaços no começo ou no fim.

---

Parte 4 — Conferir o CEP da sua loja

O cálculo do frete precisa saber de onde a mercadoria sai. Com o Endereço da loja preenchido, as cotações saem do CEP que está ali.

Sem CEP na loja, elas saem do endereço de coleta cadastrado na sua conta da Central do Frete. O cliente continua vendo preços, e é justamente aí que mora o risco: origem diferente muda o valor e muda a lista de transportadoras, sem nada parecer errado na tela da loja. A tela da Central do Frete avisa disso no alto, dizendo de qual CEP as cotações estão saindo.

1. Vá em WooCommerce › Configurações › Geral.
2. Confira se o Endereço da loja está preenchido, com o CEP correto.
3. Se mudou algo, clique em Salvar alterações.

---

Parte 5 — Peso e medidas dos seus produtos

O preço do frete depende de quanto o pedido pesa e de quanto espaço ele ocupa. Sem esses dados em cada produto, o cálculo não tem em que se basear.

⚠️ Atenção, esta parte mexe no seu bolso: produto sem peso e sem medidas não fica sem frete, e é aí que mora o problema. O plugin completa o que faltou com medidas de reserva, que de fábrica são 0,3 kg e 2 × 11 × 16 cm — o tamanho de um envelope. Uma mesa de 40 kg com os campos vazios é cotada como esse envelope: o cliente paga um frete de envelope, você despacha uma mesa, e a transportadora cobra depois o peso real. A diferença sai do seu bolso e você só descobre na fatura da transportadora. Nada avisa na tela.

1. Vá em Produtos e clique no produto que você quer ajustar.

2. Na caixa Dados do produto, clique na aba Entrega, na coluna da esquerda.

3. Preencha Peso (kg) com o peso do produto já embalado.

4. Preencha Dimensões (cm) nos três campos, na ordem comprimento, largura e altura, também com a embalagem.

5. Em Tipo de Carga (Central do Frete), deixe Usar padrão do plugin se este produto é igual ao resto da loja. Só escolha uma categoria aqui se este produto for diferente dos outros.

   

6. Clique em Atualizar, no alto da página, para salvar.

7. Repita nos outros produtos.

Até aqui é o obrigatório. Com as Partes 1 a 5 feitas, a sua loja já calcula frete corretamente. O que vem a seguir é ajuste fino: faça na ordem que quiser, ou deixe para depois.

---

Parte 6 — Escolher como o frete aparece para o cliente (opcional)

Essas opções ficam na mesma tela da Central do Frete, na seção Como exibir o frete para o cliente. Todas já vêm com um valor razoável.

Mais abaixo, na seção Ajustes de prazo e preço, você pode somar valor e tempo ao que a transportadora cobra:

E na seção Dimensões padrão dos produtos ficam os campos Peso padrão (kg), Altura padrão (cm), Largura padrão (cm) e Comprimento padrão (cm). São as medidas de reserva do aviso da Parte 5: valem só para o produto que ficou sem peso ou sem medidas, e existem para que ele não fique sem preço nenhum. Elas não substituem o cadastro do produto. Se você ainda tem produtos assim, deixe aqui algo próximo do que você mais vende, para o erro ser o menor possível enquanto você não preenche.

---

Parte 7 — Escolher quais produtos a Central do Frete cota (opcional)

Se tudo o que você vende viaja mais ou menos do mesmo jeito, pule esta parte. Por padrão a Central do Frete cota todos os produtos, e está tudo bem.

Esta parte é para lojas que vendem coisas muito diferentes entre si. Imagine uma loja que vende armários e também parafusos: faz sentido cotar os armários com a Central do Frete e mandar os parafusos por outro método, mais barato para item pequeno. É isso que se configura aqui.

Para isso o WooCommerce usa classes de entrega. Classe de entrega é um jeito de juntar num mesmo grupo os produtos que viajam parecido, para poder tratá-los de forma diferente do resto.

1. Crie os grupos

1. Vá em WooCommerce › Configurações › Entrega e clique em Classes, no menu de cima.

2. Clique em Adicionar classe de entrega, escreva um nome e salve. Crie um grupo para cada tipo de produto que você quer separar.

   

2. Coloque cada produto no seu grupo

1. Abra o produto e vá na aba Entrega, como na Parte 5.
2. Em Classe de entrega, escolha o grupo dele.
3. Clique em Atualizar.

Produto que você deixar sem grupo também pode entrar na regra, como você vai ver no próximo passo.

3. Monte a regra

1. Volte em WooCommerce › Configurações › Entrega, entre na sua área de entrega e clique em Editar na linha da Central do Frete.

2. Desça até a seção Restrição por classe de entrega.

   

3. Em Quais classes a Central do Frete atende?, escolha uma das três:

   • Todas as classes — cota qualquer produto. É como vem de fábrica.
   • Apenas as classes selecionadas — cota só os produtos dos grupos que você marcar abaixo.
   • Todas, exceto as selecionadas — cota tudo, menos os produtos dos grupos que você marcar abaixo.

4. No campo Classes de entrega, clique e marque os grupos que a regra vai considerar. A lista traz também Produtos sem classe de entrega, para o caso de você querer incluir na regra os produtos que ficaram sem grupo.

5. Clique em Salvar alterações.

Se você escolher uma das duas últimas opções e não marcar nenhum grupo, nada muda: a Central do Frete continua cotando todos os produtos.

Quando o cliente junta os dois tipos no mesmo carrinho

Falta decidir o que acontece quando o carrinho tem, ao mesmo tempo, produto que a Central do Frete atende e produto que ela não atende. Isso é a opção Carrinho misto:

• Desmarcada (como vem de fábrica) — basta um produto atendido para a Central do Frete aparecer no carrinho.
• Marcada — a Central do Frete só aparece se todos os produtos do carrinho estiverem dentro da regra.

⚠️ Atenção, leia antes de marcar: se você marcar Exigir que todos os produtos do carrinho se enquadrem, mantenha outro método de entrega na mesma área, como Taxa fixa, para atender os produtos que ficaram de fora. Sem esse outro método, um cliente que junta os dois tipos de produto no mesmo carrinho não recebe nenhuma opção de frete e não consegue fechar o pedido.

A regra vale nos três lugares: no carrinho, na finalização do pedido e no campo de cálculo da página do produto. Assim que você salvar, ela já está valendo.

---

O que o cliente vê na loja

As duas seções abaixo não são configuração. Elas mostram o resultado do que você acabou de fazer.

O cliente calcula o frete na página do produto

Com o plugin ativo, um campo Calcule o frete aparece na página de cada produto. O cliente digita o CEP, clica em Calcular e vê transportadora, prazo e valor sem precisar colocar nada no carrinho.

O CEP que ele digitou fica guardado durante a visita. Quando ele for fechar o pedido, o campo de CEP já vem preenchido.

Se você preferir não ter esse campo, desmarque Mostrar campo "Calcule o frete" nas configurações da Central do Frete.

Como o frete aparece no carrinho

No carrinho e na finalização do pedido, as transportadoras aparecem como opções para o cliente escolher, cada uma com prazo e valor. Ele marca uma e o total do pedido se atualiza.

---

Algo não está funcionando?

Comece pelas causas mais comuns, na ordem. Uma delas resolve quase todos os casos:

1. O Endereço da loja, em WooCommerce › Configurações › Geral, está com o CEP preenchido? Sem ele o frete não some, mas sai do endereço de coleta da sua conta — confira o aviso no alto da tela da Central do Frete, que diz de qual CEP as cotações saem.
2. Na tela da Central do Frete, o campo Token de acesso está preenchido e Habilitar cotações da Central do Frete está marcado?
3. O botão Atualizar Tipos de Carga traz a mensagem de tipos carregados? Se não traz, é o código do campo Token de acesso que está errado.
4. O endereço do cliente está dentro da área de entrega que você criou?
5. O produto do teste tem Peso (kg) e Dimensões (cm) preenchidos?
6. Se você usou a Parte 7, a regra não está deixando esse produto de fora sem você perceber?

Se nada disso resolver, guarde um registro do que aconteceu para mandar ao suporte:

1. Na tela da Central do Frete, desça até Configurações técnicas e marque Salvar logs detalhados, na linha Modo debug. Clique em Salvar alterações.

   

2. Faça na loja o mesmo teste que deu errado.

3. Vá em WooCommerce › Status › Logs e abra o arquivo mais recente cujo nome começa com central-do-frete.

4. Copie o conteúdo e mande junto com o seu chamado.

💡 Dica: desmarque Salvar logs detalhados depois de resolver, para o seu site não ficar guardando arquivos que não vão ser usados.

Ainda nessa seção fica Cache de cotações. Ela define por quanto tempo a loja reaproveita um preço que já consultou, em vez de consultar de novo. Um tempo maior deixa as páginas mais rápidas; um tempo menor mostra preços mais recentes. 1 hora atende bem a maioria das lojas. O campo Tempo limite da API, ao lado, é melhor deixar como está, a não ser que o nosso suporte peça para mudar.

---

Precisa de ajuda?

Se travar em algum passo, fale com a gente:

• 🌐 centraldofrete.com
• 📧 Abra um chamado na nossa Central de Ajuda

✅ Pronto! A sua loja já mostra frete de várias transportadoras. Faça um pedido de teste com o seu próprio CEP para ver como o cliente vê.