Claudio Sanches – Correios for WooCommerce

Description

Utilize os métodos de entrega e servi?os dos Correios com a sua loja WooCommerce.

Correios é um método de entrega brasileiro.

Este plugin foi desenvolvido sem nenhum incentivo dos Correios. Nenhum dos desenvolvedores deste plugin possuem vínculos com esta empresa. E note que este plugin foi feito baseado na documenta??o do Webservices Correios e com apoio da Infranology na constru??o das classes de cubagem.

Integra??o

Este plugin suporta a nova API dos Correios, fazendo integra??o completa com o seu contrato, sendo possível integrar com qualquer método de entrega disponível para o seu contrato, como PAC, SEDEX e mais.
Também tem integra??o para consulta do histórico de rastreamento da encomenda (sendo exibida na página do pedido em “Minha conta” para o cliente), além de incluir integra??o para preenchimento automático de endere?os a partir de um CEP.

Instala??o:

Confira o nosso guia de instala??o e configura??o do Correios na aba Installation.

Compatibilidade

• WooCommerce 3.0 ou posterior para funcionar.
• Integrado com a API nova dos Correios.
• Compatível com o Link Correios.

Dúvidas?

Você pode esclarecer suas dúvidas usando:

• A nossa sess?o de FAQ.
• Utilizando o nosso fórum no Github.
• Criando um tópico no fórum de ajuda do WordPress.

Screenshots

Installation

Instala??o do plugin:

• Envie os arquivos do plugin para a pasta wp-content/plugins, ou instale usando o instalador de plugins do WordPress.
• Ative o plugin.

Requerimentos:

• Ter contrato utilizando um CNPJ com os Correios.
• O contrato com os Correios precisa ser pelo menos no nível Bronze 1 para funcionar com a API.

Configura??o do plugin

1. Depois de instalado e ativado, vá até “WooCommerce” > “Configura??es” > “Integra??es” > “Correios”.
2. Preencha os campos “Nome de usuário”, “Código de acesso” e “Cart?o de postagem” na sess?o “Correios Web Services”.
3. Salve as configura??es.
4. Ainda nesta página você pode clicar em “Atualizar lista de servi?os” para baixar a lista de servi?os dos Correios disponíveis no seu contrato.
5. Finalmente vá até “WooCommerce” > “Configura??es” > “Entrega” e crie/edite uma area de entrega para entregas no Brasil.
6. Adicione o método de entrega “Correios (Nova API)”.
7. Clique para editar o método e selecione o “Servi?o” que será usado. Por exemplo “PAC CONTRATO AG” ou “SEDEX CONTRATO AG” (os servi?os s?o baixados na etapa 4 deste guia).
8. Finalmente termine de configurar as outras op??es conforme a sua necessidade e salve o método de entrega.
9. Pronto, tudo configurado.

Para garantir que tudo esta funcionando tenha certeza de configurar o peso e medidas dos produtos em cada um deles, veja mais detalhes na sess?o seguinte.

Configura??es dos produtos

é necessário configurar o peso e dimens?es de todos os seus produtos, caso você queria que a cota??o de frete seja exata.
Note que é possível configurar com produtos do tipo simples ou variável e n?o virtuais (produtos virtuais s?o ignorados na hora de cotar o frete).

Alternativamente, você pode configurar apenas o peso e deixar as dimens?es em branco, pois ser?o utilizadas as configura??es do Pacote Padr?o para as dimens?es (neste caso pode ocorrer uma varia??o pequena no valor do frete, pois os Correios consideram mais o peso do que as dimens?es para a cota??o).

FAQ

Qual é a licen?a do plugin?

Este plugin esta licenciado como GPL.

O que eu preciso para utilizar este plugin?

• WooCommerce 3.0 ou posterior.
• Contrato com os Correios.
• Adicionar peso e dimens?es nos produtos que pretende entregar.

Quais s?o os métodos de entrega que o plugin aceita?

Todos os métodos disponíveis no seu contrato com os Correios.

Onde configuro os métodos de entrega?

Os métodos de entrega devem ser configurados em “WooCommerce” > “Configura??es” > “Entrega” > “áreas de entrega”.

Para entrega nacional, é necessário criar uma área de entrega para o Brasil ou para determinados estados brasileiros e atribuir os métodos de entrega.

Onde configuro o autopreenchimento de endere?o ou a tabela de histórico de rastreamento

é possível configurar os dois em “WooCommerce” > “Configura??es” > “Integra??es” > “Correios”.

Como alterar a mensagem que é enviada no e-mail do código de rastreamento?

é possível encontrar configura??es para o e-mail do código de rastreamento em “WooCommerce” > “Configura??es” > “E-mails” > “Código de rastreio dos Correios”.

Como é feita a cota??o do frete?

A cota??o do frete é feita utilizando o Calculador Remoto de Pre?os e Prazos dos Correios.

Na cota??o do frete é usado o seu CEP de origem, CEP de destino do cliente, junto com as dimens?es dos produtos e peso. Desta forma o valor cotado sera o mais próximo possível do real.

Note que já fazem mais de 10 anos que este plugin existe utilizando o mesmo método para obter a cubagem do pedido e tem funcionando muito bem, caso você tenha algum problema, provavelmente é por causa de configurar valores errados nos produtos.

Tem calculadora de frete na página do produto?

N?o tem, simplesmente porque n?o faz parte do escopo deste plugin.

Escopo deste plugin é prover integra??o entre o WooCommerce e os Correios.

Este plugin faz altera??es na calculadora de frete na página do carrinho ou na de finaliza??o?

N?o, nenhuma altera??o é feita, este plugin funcionando esperando o WooCommerce verificar pelos valores de entrega, ent?o é feita uma conex?o com os Correios e os valores retornados s?o passados de volta para o WooCommerce apresentar.

Note que n?o damos suporte para qualquer tipo de personaliza??o na calculadora, simplesmente porque n?o faz parte do escopo do plugin, caso você queria mudar algo como aparece, deve procurar ajuda com o WooCommerce e n?o com este plugin.

Como resolver o erro “N?o existe nenhum método de entrega disponível. Por favor, certifique-se de que o seu endere?o esta correto ou entre em contato conosco caso você precise de ajuda.”?

Primeiro de tudo, isso n?o é um erro, isso é uma mensagem padr?o do WooCommerce que é exibida quando n?o é encontrado nenhuma método de entrega.

Mesmo você configurando os métodos de entrega, eles n?o s?o exibidos quando os Correios retornam mensagens de erro, por exemplo quando a regi?o onde o cliente esta n?o é coberta pelos Correios ou quando o peso do pacote passa do limite suportado.

Entretanto boa parte das vezes esse tipo de coisa acontece porque os métodos e/ou produtos n?o foram configurados corretamente.

Aqui uma lista de erros mais comuns:

• Faltando CEP de origem nos métodos configurados.
• CEP de origem inválido.
• Produtos cadastrados sem peso e dimens?es
• Peso e dimens?es cadastrados de forma incorreta (por exemplo configurando como 1000kg, pensando que seria 1000g, ent?o verifique as configura??es de medidas em WooCommerce > Configura??es > Produtos).

E n?o se esque?a de verificar o erro ativando a op??o de Log de depura??o nas configura??es de cada método de entrega. Imediatamente após ativar o log, basta tentar cotar o frete novamente, fazendo assim o log ser gerado. Você pode acessar todos os logs indo em “WooCommerce” > “Status do sistema” > “Logs”.

Dica: Caso apare?a no log a mensagem WP_Error: connect() timed out! pode acontecer do site dos Correios ter caído ou o seu servidor estar com pouca memória.

Os métodos de entrega dos Correios n?o aparecem no carrinho ou durante a finaliza??o?

As mesmas dicas da sess?o acima valem como solu??o para isto também.

O valor do frete calculado n?o bateu com a da loja dos Correios?

Este plugin utiliza o Webservices dos Correios para calcular o frete e quando este tipo de problema acontece geralmente é porque:

1. Foram configuradas de forma errada as op??es de peso e dimens?es dos produtos na loja.
2. Configurado errado o CEP de origem nos métodos de entrega.
3. O Webservices dos Correios enviou um valor errado! Sim isso acontece e na página da documenta??o do Webservice tem o seguinte alerta:

Os valores obtidos pelos simuladores aqui disponíveis s?o uma estimativa e dever?o ser confirmados no ato da postagem.

Ainda esta tendo problemas?

Se estiver tendo problemas, antes de tudo ative a op??o de Log de depura??o do método que você esta tendo problema e tente novamente cotar o frete, fazendo isso, um arquivo de log é criado e s?o registradas as respostas do Webservice dos Correios, leia o arquivo de log, nele é descrito exatamente o que esta acontecendo, tanto o que foi concluindo com sucesso ou n?o.

Se ainda n?o foi capaz de solucionar o problema, copie o conteúdo do arquivo de log, cole no pastebin.com, salve e pegue o link gerado, depois disso abra um tópico informando o seu problema no fórum de suporte do plugin.

Dúvidas sobre o funcionamento do plugin?

Em caso de dúvidas, basta abrir um tópico no fórum de suporte do plugin, vou responder conforme eu tenho tempo livre e caso sua dúvida for relacionada com o funcionamento deste plugin.

Reviews

N?o funciona

pauloviniciusgyn November 21, 2024

n?o funciona o plugin, n?o calcula o frete

muito bom

kluyw3rt10 September 20, 2024

ótimo

Excelente

Anaprpires September 9, 2024

Excelente

Top

pacbandeira August 5, 2024

Produto muito bom e facil de usar

N?o informa prazo de entrega

taticlima July 16, 2024

A API n?o informa o prazo de entrega se também estiver a op??o Frete Grátis configurada e habilitada. Ao desabilitar Frete Grátis, a estimativa de entrega volta a aparecer no carrinho. é importante corrigir esse erro, pois o consumidor necessita saber o prazo da entrega independente da cobran?a ou n?o do frete.

Parou de calcular o frete

ismaelxavier July 2, 2024

Parou de calcular o frete. Precisa de atualiza??o

Contributors & Developers

Changelog

4.2.5 – 2024/02/17

• Declarado suporte para WooCommerce 8.6 e WordPress 6.4.

4.2.4 – 2024/02/17

• Corrigida compatibilidade com WooCommerce 8.6+.

4.2.3 – 2023/11/08

• Corrigido um erro relacionado a lista de servi?os desatualizada que impedia editar o método de entrega.
• Atualizada a mensagem do e-mail para deixar claro que estimativa de entrega come?a apenas depois do envio do produto.

4.2.2 – 2023/10/30

• Corrigida convers?o de peso para gramas.

4.2.1 – 2023/10/29

• Adicionado suporte para WooCommerce 8.2+.

4.2.0 – 2023/10/29

• Implementa??o de método de entrega internacional.
• Melhorada compatibilidade com PHP 8.2.

4.1.8 – 2023/09/29

• Corrigido o comportamento da integra??o de preenchimento de endere?o quando os campos da nova API est?o preenchidos pela metade.

4.1.7 – 2023/09/28

• Corrigido o assunto do e-mail do código de rastreamento que n?o era exibido as vezes.
• Melhorado os logs para incluir apenas a resposta e o cabe?alho da resposta de requisi??es.
• Melhorada a descri??o dos campos da integra??o, adicionado link para ajudar os usuários encontrar o número do Cart?o de Postagem.

4.1.6 – 2023/09/26

• Corrigido a exibi??o da estimativa de entrega para métodos offline.

4.1.5 – 2023/09/25

• Adicionado suporte para servi?os do tipo “LOG +”.
• Corrigido link de log da integra??o e dos métodos de entrega.
• Corrigido erros quando token n?o pode ser gerado com sucesso.
• Adicionado suporte para WooCommerce 8.1

4.1.4 – 2023/09/13

• Atualizado o link para o rastreamento de objeto.

4.1.3 – 2023/09/13

• Corrida taxa de manuseio que n?o estava sendo aplicada no método “Correios (Nova API)”.

4.1.2 – 2023/09/12

• Atualizado valor mínimo declarado para R$ 24,5.

4.1.1 – 2023/09/11

• Adicionado suporte para WooCommerce High-Performance Order Storage.
• Corrigida a validade do token dos Correios.
• Adicionada mensagem para avisar quando a API dos Correios n?o esta configurada corretamente.
• Removido suporte para vers?es anteriores ao WooCommerce 3.0.
• Corrigida a tabela de rastreamento de objeto para ser responsiva.

4.1.0 – 2023/09/11

• Atualizado valor mínimo declarado para 24 reais.
• Melhorada exibi??o das datas da tabela de rastreamento de objeto.
• Corrigido auto preenchimento de endere?o quando a cidade tem apenas um CEP, prevenindo de remover o nome da rua e o bairro.
• Atualizado peso máximo e valores do Impresso Normal.
• Atualizado os pre?os de Carta Registrada.
• Corre??es gerais de estabilidade e prevenindo erros no WP.

4.0.0 – 2023/09/10

• Implementa??o da nova API dos Correios para calculo do valor de entrega, estimativa de entrega, rastreamento de objeto e de busca de endere?o por CEP.
• Um novo método de entrega chamado “Correios (Nova API)” foi adicionado.

See changelog for all versions.