Contributors: claudiosanches, rodrigoprior
Donate link: http://claudiosmweb.com/doacoes/
Tags: shipping, delivery, woocommerce, correios
Requires at least: 3.8
Tested up to: 4.2
Stable tag: 2.2.2
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html
Adds Correios shipping to the WooCommerce plugin
This plugin adds Correios shipping to WooCommerce.
Please notice that WooCommerce must be installed and active.
Adicione os Correios como método de entrega em sua loja WooCommerce.
Correios é um método de entrega brasileiro.
O plugin WooCommerce Correios foi desenvolvido sem nenhum incentivo dos Correios. Nenhum dos desenvolvedores deste plugin possuem vínculos com esta empresa.
Este plugin foi feito baseado na documentação do Webservices Correios e com apoio da Infranology na construção das classes de cubagem.
- PAC (com ou sem contrato).
- SEDEX (com ou sem contrato).
- SEDEX 10.
- SEDEX Hoje.
- e-SEDEX (apenas com contrato).
Confira o nosso guia de instalação e configuração do Correios na aba Installation.
Compatível com as versões 2.1.x, 2.2.x, 2.3.x e 2.4.x do WooCommerce.
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.
- Upload plugin files to your plugins folder, or install using WordPress built-in Add New Plugin installer;
- Activate the plugin;
- Navigate to WooCommerce -> Settings -> Shipping, choose Correios and fill settings.
- Envie os arquivos do plugin para a pasta wp-content/plugins, ou instale usando o instalador de plugins do WordPress.
- Ative o plugin.
Possuir instalado a extensão SimpleXML (que já é instalado por padrão com o PHP 5).
Com o plugin instalado navegue até "WooCommerce" > "Configurações" > "Entrega" > "Correios".
Nesta tela configure o seu CEP de origem, e ative os serviços que você deseja utilizar para a entrega.
É possível escolher o tipo de Serviço Corporativo que irá ativar o e-SEDEX. Você precisa apenas ser cadastrado nos Correios e informar o seu Código Administrativo e Senha Administrativa.
Também é possível configurar um Pacote Padrão que será utilizando para definir as medidas mínimas do pacote de entraga.
Para que seja possível cotar o frete, os seus produtos precisam ser do tipo simples ou variável e não estarem marcados com virtual ou baixável (qualquer outro tipo de produto será ignorado na cotação).
É necessário configurar o peso e dimensões de todos os seus produtos, caso você queria que a cotação de frete seja exata.
Alternativamente, você pode configurar apenas o peso e deixar as dimensões em branco, pois neste caso 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).
- This plugin is released under a GPL license.
Este plugin esta licenciado como GPL.
- Ter instalado o plugin WooCommerce.
- Possuir instalado em sua hospedagem a extensão de SimpleXML.
- Configurar o seu CEP de origem nas configurações do plugin.
- Adicionar peso e dimensões nos produtos que pretende entregar.
Atenção: É obrigatório ter o peso configurado em cada produto para que seja possível cotar o frete de forma eficiente. As dimensões podem ficar em branco e neste caso, serão utilizadas as medidas da opção Pacote Padrão da configuração do plugin, mas é recomendado que cada produto tenha suas configurações próprias de peso e dimensões.
São aceitos os métodos:
- PAC (com contrato, código 41068 ou sem contrato, código 41106).
- SEDEX (com contrato, código 40096 ou sem contrato, código 40010).
- SEDEX 10 (código 40215).
- SEDEX Hoje (código 40290).
- e-SEDEX (apenas com contrato, código 81019).
Para mais informações sobre os métodos de entrega dos Correios visite: Encomendas - Correios.
A cotação do frete é feita utilizando o Webservices dos Correios utilizando SimpleXML (que é nativo do PHP 5).
Na cotação do frete é usado o seu CEP de origem, CEP de destino do cliente e a cubagem total dos produtos mais o peso. Desta forma o valor cotado sera o mais próximo possível do real.
Desta forma é necessário adicionar pelo menos o peso em cada produto, pois na falta de dimensões serão utilizadas as configurações do pacote padrão.
No momento o Webservices faz cotação apenas para dentro do Brasil.
Como resolver o erro "Nenhum método de envio encontrado. Por favor, recalcule seu frete informando seu estado/país e o CEP para verificar se há algum método de envio disponível para sua região." ou o erro "Desculpe, aparentemente não existem métodos de entrega disponíveis para sua localidade (Brasil). Se você precisa de ajuda ou deseja fazer uma negociação para realizar a entrega, entre em contato conosco."?
Esta é uma mensagem de erro padrão do WooCommerce, ela pode ser gerada por vários problemas.
Segue uma lista dos prováveis erros:
- Os produtos foram cadastros sem peso e dimensões.
- O peso e as dimensões foram cadastrados de forma errada, verifique as configurações de medidas em
WooCommerce > Configurações > Catalogo.
É possível identificar o erro ligando a opção Log de depuração nas configurações dos Correios. Desta forma é gerado um log dentro da pasta wp-content/plugins/woocommerce/logs/. Ao ativar esta opção, tente realizar uma cotação de frete e depois verique o arquivo gerado.
Caso apareça no log a mensagem WP_Error: connect() timed out! pode acontecer do site dos Correios ter caido ou o seu servidor estar com pouca memoria.
Veja quais são os limites em: Correios - limites de dimensões e peso.
Verifique se você realmente ativou as opções de entrega do plugin e faça o mesmo procedimento da questão a cima.
Além de conferir se o carrinho possue produtos do tipo simples e variável e não estarem marcados com virtual ou baixável.
Este plugin utiliza o Webservices dos Correios para calcular o frete e quando este tipo de problema acontece geralmente é porque:
- Foram configuradas de forma errada as opções de peso e dimensões dos produtos na loja.
- O Webservices dos Correios enviou um valor errado! Sim isso acontece e na página da documentação do Webservices 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.
Ative a opção de Log de depuração do plugin e entre em contato clicando aqui. Atenção! Não adianta pedir ajuda se não tiver o log em mãos.
6. Alerta exibindo o código de rastreamento dentro da página de detalhes do pedido na página "Minha conta".
7. Tabela do histórico de rastreamento que é exibida no lugar do alerta acima quando ativada a opção "Tabela do histórico de rastreamento" nas configurações do plugin.
- Corrigido código de conversão do formato de moeda dos Correios para o WooCommerce.
- Removido os decimais do valor declarado, o valor agora é arredondado (Os Correios passou a ter problemas com valores declarados com decimais e a calcular o valor do frete de forma incorreta).
- Adicionado filtro
woocommerce_correios_tracking_user_data.
- Adicionada API para consulta do objeto no site dos Correios (Agradecimentos para Edison Costa).
- Adicionada opção para mostrar histórico do rastreamento do pedido no site dos Correios.
- Adicionado templates para a exibição do histórico de rastreamento.
- Removida as opções de "Disponibilidade" e "Países Permitidos", pois funciona apenas no Brasil.
- Melhorado o relatório de erro quando os Correios retorna status 404.
- Melhorado o salvamento dos códigos de rastremento utilizando o action
woocommerce_process_shop_order_meta. - Corrigido o suporte com o WooCommerce 2.0 nos templates de e-mail.
- Corrigida a opção que manipula o conteúdo do e-mail sobre o código de rastreamento.
- Adicionado suporte para a API de e-mails do WooCommerce para enviar as notificações sobre o código de rastreamento.
- Adicionado suporte para a API de templates do WooCommerce para personalizar os templates de e-mails e do simulador de frete.
- Adicionado o filtro
woocommerce_correios_webservice_urlpara tornar possível personalizar o link do WebService. - Adicionada versões comprimidas dos arquivos de CSS e JavaScript do plugin.
- Melhorado o script que exibe e oculta os campos das opções do plugin.
- Corrigida a exibição do link do código de rastreamento dentro de cada pedido em "Minha Conta".
- Corrigido o simulador de produtos que tinha problemas com páginas com cache.
- Adicionado suporte para templates antigos no simulador.
- Pequena correção nos dados antes de passar para fazer o calculo de cubagem.
- Correção do método que pega os produtos variáveis no simulador de frete.
- Correção da exibição do simulador para produtos virtuais.
- Melhorada a compatibilidade com o WooCommerce 2.0.x.
- Melhorada a perfomance na hora de calcular o frete enviando todos os códigos para serem calculados com apenas uma consulta.
- Melhorado o simulador, agora impede o cliente de clicar várias vezes ao mesmo tempo enquanto esta simulando o frete.
- Melhoradas as classes do simulador.
- Melhorada a exibição do simulador, agora não é exibido quando o produto esta fora de estoque.
- Correção da soma da opção "Dias adicionais".
- Adicionado simulador de frete na página do produto.
- Adicionado tratamento de erro que exibe alguns erros úteis para o cliente na página do carrinho.
- Melhorias no código do plugin.
- Correção no valor declarado que era passado com valor errado para os Correios.
- Atualizado o método que extrai as médidas dos pedidos (agora ele é menos restrito).
- Adicionado suporte para as versões 2.1.x do WooCommerce.
- Removida a classe de conexão com SOAP.
- Melhoria do código.
- Adicionado método para conexão utilizando
wp_remote_gete leitura comSimpleXmlElement. - Adicionado opção de taxa de manuseio.
- Melhoria das descrições na página de configuração.
- Melhoria no tratamento de erros.
- Adicionada opção para enviar o código de rastreamento dos Correios.
- Adicionado o filtro
woocommerce_correios_shipping_methodspara manipular os métodos de entrega do plugin.
- Correção do formato de moeda que é recebido dos Correios.
- Correção do formato de número enviado pelo metodo de SimpleXML.
- Adicionado o filtro wccorreios_default_package para definir um padrão de medidas para a cubagem.
- Adicionada opção para inserir dias extras na Estimativa de Entrega.
- Melhoria no método connection_method().
- Adicionado método (fix_format()) para corrigir o formato das medidas.
- Correção do método order_shipping().
- Corrigido o método connection_method().
- Adicionada opção para logs de erro.
- Adiciona opção para selecionar o tipo de conexão (SOAP ou SimpleXML) caso esteja disponível mais de uma opção no servidor.
- Adicionada prevenção de erros quando o carrinho possui apenas produtos que não requerem entrega.
- Adicionada classe alternativa para fazer a consulta com os correios utilizando SimpleXML.
- Adicionada mensagem de notificação sobre a falta das extensões de SOAP e SimpleXML no servidor.
- Adicionada conversão de pesos para kg (padrão dos Correios).
- Adicionada conversão de medidas para cm (padrão dos Correios).
- Cubagem: removido os produtos que não possuem pesos ou medidas.
- Correção do index do array de medidas (causava erro no carrinho quando tinha um segundo produto com quantidade maior do que 1).
- Adicionado sistema de verificação e notificação sobre a falta de SOAP no servidor.
- Melhorada a inclusão das classes dos Correios no plugin.
- Versão inicial do plugin.
- Corrigido código de conversão do formato de moeda dos Correios para o WooCommerce.
WooCommerce Correios is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
WooCommerce Correios is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with WooCommerce Correios. If not, see http://www.gnu.org/licenses/.