PHP WooCommerce Correios: Woocommerce plugin for shipping via Correios

Recommend this page to a friend!
  Info   View files Documentation   View files View files (54)   DownloadInstall with Composer Download .zip   Reputation   Support forum   Blog    
Ratings Unique User Downloads Download Rankings
Not enough user ratingsTotal: 73 All time: 9,662 This week: 272Up
Version License PHP version Categories
woocommerce-correios 3.0.6BSD License5.0PHP 5, E-Commerce, Web services
Description Author
This package is specific mainly for applications used in Brazil Brazil .

This package is a plugin for Woocommerce for shipping orders via Correios of Brazil.

It sends requests to the Correios API to determining the shipping costs based on the size and weight of the order package and the type of shipping.

Currently it supports the shipping types: PAC, SEDEX, SEDEX 10, SEDEX Hoje, e-SEDEX, Impresso Normal e Impresso Urgente.

In Portuguese:

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.
Métodos de entrega aceitos:

- PAC (com ou sem contrato).
- SEDEX (com ou sem contrato).
- SEDEX 10.
- SEDEX Hoje.
- e-SEDEX (apenas com contrato).
- Impresso Normal.
- Impresso Urgente.

Picture of Julio Cezar Kronbauer
  Performance   Level  
Name: Julio Cezar Kronbauer <contact>
Classes: 11 packages by
Country: Brazil Brazil
Age: 38
All time rank: 2180145 in Brazil Brazil
Week rank: 641 Up56 in Brazil Brazil Up
Innovation award
Innovation award
Nominee: 1x

Details

WooCommerce Correios

Contributors: claudiosanches, rodrigoprior, matheuscl Donate link: http://claudiosmweb.com/doacoes/ Tags: shipping, delivery, woocommerce, correios Requires at least: 4.0 Tested up to: 4.7 Stable tag: 3.1.5 License: GPLv2 or later License URI: http://www.gnu.org/licenses/gpl-2.0.html

Integration between the Correios and 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.

O plugin WooCommerce Correios 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.

Serviços integrados

Estão integrados os seguintes serviços:

  • Entrega nacional: - PAC - SEDEX - SEDEX 10 Envelope - SEDEX 10 Pacote - SEDEX 12 - SEDEX Hoje - e-SEDEX (necessário conta administrativa nos Correios) - Carta Registrada - Impresso Normal - Impresso Urgente
  • Entrega internacional: - Mercadoria Expressa - Mercadoria Econômica - Leve Internacional
  • Consulta do histórico de rastreamento da encomenda (sendo exibida na página do pedido em "Minha conta" para o cliente)
  • Consulta e autopreenchimento de endereços baseados em CEPs

Instalação:

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

Compatibilidade

Compatível com a versão 2.6.x do WooCommerce.

Dúvidas?

Você pode esclarecer suas dúvidas usando:

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:

  • SimpleXML ativado no PHP (note que já é ativado por padrão no PHP 5).
  • Modulo SOAP (utilizado para a tabela de histórico de rastreamento e autopreenchimento de endereços).

Configurações do plugin:

[youtube https://www.youtube.com/watch?v=IWjLAy9i--I]

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).

Frequently Asked Questions

Qual é a licença do plugin?

Este plugin esta licenciado como GPL.

O que eu preciso para utilizar este plugin?

  • WooCommerce 2.6 ou superior.
  • SimpleXML ativado no PHP (note que já é ativado por padrão no PHP 5).
  • Modulo SOAP (utilizado para a tabela de histórico de rastreamento e autopreenchimento de endereços).
  • Adicionar peso e dimensões nos produtos que pretende entregar.

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

São aceitos os seguintes métodos de entrega nacionais:

  • PAC
  • SEDEX
  • SEDEX 10 Envelope
  • SEDEX 10 Pacote
  • SEDEX 12
  • SEDEX Hoje
  • e-SEDEX (necessário conta administrativa nos Correios)
  • Carta Registrada
  • Impresso Normal
  • Impresso Urgente

E os seguintes métodos de entrega internacionais:

  • Mercadoria Expressa
  • Mercadoria Econômica
  • Leve Internacional

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 quase 4 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 memoria.

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 plguin.

Screenshots

1. Exemplo de áreas de entrega com os Correios.

1. Exemplo de áreas de entrega com os Correios.

2. Exemplo da tela de configurações dos métodos de entrega.

2. Exemplo da tela de configurações dos métodos de entrega.

3. Configurações de integração com os Correios.

3. Configurações de integração com os Correios.

4. Campo para adicionar o código de rastreamento (tela de administração de pedidos).

4. Campo para adicionar o código de rastreamento (tela de administração de pedidos).

5. Configurações do e-mails do código de rastreamento.

5. Configurações do e-mails do código de rastreamento.

6. Exemplo dos métodos de entrega sendo exibidos na página de finalização.

6. Exemplo dos métodos de entrega sendo exibidos na página de finalização.

7. Exemplo do código de rastreamento sendo exibido dentro da página de detalhes de pedido na página "Minha conta".

7. Exemplo do código de rastreamento sendo exibido dentro da página de detalhes de pedido na página "Minha conta".

8. Exemplo da 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 de integração.

8. Exemplo da 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 de integração.

Changelog

3.1.5 - 2016/12/31

  • Adicionado link para a página de rastreio do pedido nas notas do pedido.
  • Corrigido valor declarado utilizando o valor do pacote atual e não do carrinho.
  • Adicionado objeto do pacote no filtro `woocommerce_correios_{$method_id}_rate`.

3.1.4 - 2016/12/23

  • Adicionada prevenção de erros no PHP quando todos os valores de peso e dimensões estão em branco.
  • Introduzido o filtro `woocommerce_correios_get_estimating_delivery` para edição da estimativa de entrega.
  • Adicionada informações do pacote nos filtros para tornar possível calcular frete para múltiplos pacotes.
  • Adicionada prevenção de erro quando Correios retorna apenas um objeto no rastreio de entrega.

3.1.3 - 2016/09/27

  • Corrigido erro quando utilizado código de rastreio incorreto.

3.1.2 - 2016/09/20

  • Removida mensagem de erro quando serviço é indisponível no trecho informado, esta mensagem estava causando muita confusão para usuários quando Sedex 10 ou Sedex Hoje estão indisponíveis.

3.1.1 - 2016/09/15

  • Corrigida a utilização das classes de entrega para os métodos de Carta Registrada, Impresso Normal e Impresso Urgente.

3.1.0 - 2016/09/13

  • Adicionado os métodos Impresso Normal e Impresso Urgente (obrigado a @jckronbauer).
  • Adicionada opção para enviar novamente e-mail do código de rastreio.
  • Adicionada mensagem de erro quando serviço é indisponível no trecho informado.

3.0.6 - 2016/08/20

  • Introduzida a função `wc_correios_get_address_by_postcode()`.
  • Removida opção de seguro para métodos internacionais, pois o valor adicionado era o valor do premio do seguro automático.
  • Corrigido e-Sedex para aceitar apenas a opção corporativa.

3.0.5 - 2016/07/20

  • Corrigido o formato das dimensões e peso para os métodos de entrega internacionais.

3.0.4 - 2016/07/20

  • Corrigido o tratamento do XML das métodos internacionais, nos quais os Correios as vezes envia um XML no formato incorreto.

3.0.3 - 2016/06/28

  • Corrigida as unidades de medidas dos métodos internacionais.

3.0.2 - 2016/06/28

  • Adicionado novo método de Carta Registrada seguindo a tabela dos Correios e com suporte a classes de entrega.

3.0.1 - 2016/06/26

  • Corrigido o calculo da taxa de manuseio.

3.0.0 - 2016/06/26

  • Reformulação geral de todos o código do plugin.
  • Adicionado suporte as áreas de entrega do WooCommerce 2.6.
  • Adicionado os métodos de SEDEX 10 Envelope, SEDEX 12, Carta Registrada, Mercadoria Expressa, Mercadoria Econômica e Leve Internacional.
  • Adicionado novo menu de "integrações".
  • Adicionada integração com o serviço de consulta de CEP e assim adicionando uma opção para autopreencher endereços com base no CEP.
  • Atualizada a integração com o sistema que gera o histórico de rastreamento do pedido.
  • Removida a opção de simulador de frete na página do produto.
  • Integrado o campo de "correios_tracking_code" dos pedidos com a API REST do WooCommerce.
  • E mais outras várias alterações que podem ser verificadas pelo GitHub.

Upgrade Notice

3.1.5

  • Adicionado link para a página de rastreio do pedido nas notas do pedido.
  • Corrigido valor declarado utilizando o valor do pacote atual e não do carrinho.
  • Adicionado objeto do pacote no filtro `woocommerce_correios_{$method_id}_rate`.
  Files folder image Files  
File Role Description
Files folder imageassets (1 directory)
Files folder imageincludes (9 files, 5 directories)
Files folder imagelanguages (1 file)
Files folder imagetemplates (2 directories)
Accessible without login Plain text file .editorconfig Data Auxiliary data
Accessible without login Plain text file .jshintrc Data Auxiliary data
Accessible without login Plain text file Gruntfile.js Data Auxiliary data
Accessible without login Plain text file LICENSE.txt Doc. Documentation
Accessible without login Plain text file package.json Data Auxiliary data
Accessible without login Plain text file README.md Doc. Documentation
Accessible without login Plain text file readme.txt Doc. Documentation
Accessible without login Plain text file uninstall.php Aux. Auxiliary script
Accessible without login Plain text file wc-correios.php Appl. Application script
Accessible without login Plain text file woocommerce-correios.php Appl. Application script

  Files folder image Files  /  assets  
File Role Description
Files folder imagejs (2 directories)

  Files folder image Files  /  assets  /  js  
File Role Description
Files folder imageadmin (4 files)
Files folder imagefrontend (2 files)

  Files folder image Files  /  assets  /  js  /  admin  
File Role Description
  Accessible without login Plain text file integration.js Data Auxiliary data
  Accessible without login Plain text file integration.min.js Data Auxiliary data
  Accessible without login Plain text file shipping-methods.js Data Auxiliary data
  Accessible without login Plain text file shipping-methods.min.js Data Auxiliary data

  Files folder image Files  /  assets  /  js  /  frontend  
File Role Description
  Accessible without login Plain text file autofill-address.js Data Auxiliary data
  Accessible without login Plain text file autofill-address.min.js Data Auxiliary data

  Files folder image Files  /  includes  
File Role Description
Files folder imageabstracts (4 files)
Files folder imageadmin (1 file, 1 directory)
Files folder imageemails (1 file)
Files folder imageintegrations (1 file)
Files folder imageshipping (14 files)
  Plain text file class-wc-correios-autofill-addresses.php Class Class source
  Plain text file class-wc-correios-install.php Class Class source
  Plain text file class-wc-correios-package.php Class Class source
  Plain text file class-wc-correios-rest-api.php Class Class source
  Plain text file class-wc-correios-soap-client.php Class Class source
  Plain text file class-wc-correios-tracking-history.php Class Class source
  Plain text file class-wc-correios-...e-international.php Class Class source
  Plain text file class-wc-correios-webservice.php Class Class source
  Accessible without login Plain text file wc-correios-functions.php Aux. Auxiliary script

  Files folder image Files  /  includes  /  abstracts  
File Role Description
  Plain text file abstract-wc-correios-shipping-carta.php Class Class source
  Plain text file abstract-wc-correi...ipping-impresso.php Class Class source
  Plain text file abstract-wc-correi...g-international.php Class Class source
  Plain text file abstract-wc-correios-shipping.php Class Class source

  Files folder image Files  /  includes  /  admin  
File Role Description
Files folder imageviews (3 files)
  Plain text file class-wc-correios-admin-orders.php Class Class source

  Files folder image Files  /  includes  /  admin  /  views  
File Role Description
  Accessible without login Plain text file html-admin-help-message.php Aux. Auxiliary script
  Accessible without login Plain text file html-admin-missing-dependencies.php Aux. Auxiliary script
  Accessible without login Plain text file html-admin-shipping-method-settings.php Conf. Configuration script

  Files folder image Files  /  includes  /  emails  
File Role Description
  Plain text file class-wc-correios-tracking-email.php Class Class source

  Files folder image Files  /  includes  /  integrations  
File Role Description
  Plain text file class-wc-correios-integration.php Class Class source

  Files folder image Files  /  includes  /  shipping  
File Role Description
  Plain text file class-wc-correios-...arta-registrada.php Class Class source
  Plain text file class-wc-correios-shipping-esedex.php Class Class source
  Plain text file class-wc-correios-...impresso-normal.php Class Class source
  Plain text file class-wc-correios-...mpresso-urgente.php Class Class source
  Plain text file class-wc-correios-shipping-legacy.php Class Class source
  Plain text file class-wc-correios-...e-internacional.php Class Class source
  Plain text file class-wc-correios-...doria-economica.php Class Class source
  Plain text file class-wc-correios-...adoria-expressa.php Class Class source
  Plain text file class-wc-correios-shipping-pac.php Class Class source
  Plain text file class-wc-correios-...ping-sedex-hoje.php Class Class source
  Plain text file class-wc-correios-shipping-sedex.php Class Class source
  Plain text file class-wc-correios-...edex10-envelope.php Class Class source
  Plain text file class-wc-correios-...-sedex10-pacote.php Class Class source
  Plain text file class-wc-correios-shipping-sedex12.php Class Class source

  Files folder image Files  /  languages  
File Role Description
  Accessible without login Plain text file woocommerce-correios.pot Data Sample output

  Files folder image Files  /  templates  
File Role Description
Files folder imageemails (1 file, 1 directory)
Files folder imagemyaccount (2 files)

  Files folder image Files  /  templates  /  emails  
File Role Description
Files folder imageplain (1 file)
  Accessible without login Plain text file correios-tracking-code.php Aux. Sample output

  Files folder image Files  /  templates  /  emails  /  plain  
File Role Description
  Accessible without login Plain text file correios-tracking-code.php Aux. Sample output

  Files folder image Files  /  templates  /  myaccount  
File Role Description
  Accessible without login Plain text file tracking-code.php Aux. Sample output
  Accessible without login Plain text file tracking-history-table.php Aux. Sample output

 Version Control Unique User Downloads Download Rankings  
 100%
Total:73
This week:0
All time:9,662
This week:272Up

For more information send a message to info at phpclasses dot org.