forked from claudiosanches/woocommerce-correios
-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathreadme.txt
245 lines (159 loc) · 12.5 KB
/
readme.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
=== Claudio Sanches - Correios for WooCommerce ===
Contributors: claudiosanches, rodrigoprior, matheuscl
Donate link: https://claudiosanches.com/doacoes/
Tags: shipping, delivery, woocommerce, correios
Requires at least: 4.0
Tested up to: 5.2
Stable tag: 3.8.0
Requires PHP: 5.6
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](http://www.correios.com.br/) é 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](https://www.correios.com.br/precos-e-prazos/calculador-remoto-de-precos-e-prazos) e com apoio da [Infranology](http://infranology.com.br/) 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:
- Exporta Fácil Econômico
- Exporta Fácil Expresso
- Exporta Fácil Premium
- Exporta Fácil Standard
- Documento Econômico
- Documento Internacional Expresso
- Documento Internacional Premium
- Documento Internacional Standard
- 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](http://wordpress.org/extend/plugins/woocommerce-correios/installation/).
= Compatibilidade =
Requer WooCommerce 3.0 ou posterior para funcionar.
= Dúvidas? =
Você pode esclarecer suas dúvidas usando:
- A nossa sessão de [FAQ](http://wordpress.org/extend/plugins/woocommerce-correios/faq/).
- Utilizando o nosso [fórum no Github](https://github.com/claudiosanches/woocommerce-correios).
- Criando um tópico no [fórum de ajuda do WordPress](http://wordpress.org/support/plugin/woocommerce-correios).
== 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](http://php.net/manual/pt_BR/book.simplexml.php) ativado no PHP (note que já é ativado por padrão no PHP 5).
- Modulo [SOAP](http://php.net/manual/pt_BR/book.soap.php) (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 3.0 ou posterior.
* [SimpleXML](http://php.net/manual/pt_BR/book.simplexml.php) ativado no PHP (note que já é ativado por padrão no PHP 5).
* Modulo [SOAP](http://php.net/manual/pt_BR/book.soap.php) (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](https://www.correios.com.br/para-sua-empresa/servicos-para-o-seu-contrato/precos-e-prazos).
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](http://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](https://wordpress.org/support/plugin/woocommerce-correios/#new-post).
= Dúvidas sobre o funcionamento do plugin? =
Em caso de dúvidas, basta abrir um tópico no [fórum de suporte do plugin](https://wordpress.org/support/plugin/woocommerce-correios/#new-post), 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.
2. Exemplo da tela de configurações dos métodos de entrega.
3. Configurações de integração com os Correios.
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.
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".
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.8.0 - 2019/09/20 =
- Nome do plugin atualizado de "WooCommerce Correios" para "Claudio Sanches - Correios for WooCommerce".
- Atualizado limites de peso para Impresso normal, Registro Módico e Registro Nacional.
- Corrigida rotina de atualização das opções do plugin.
= 3.7.2 - 2019/05/06 =
- Correção dos links que levam para a página de rastreio de encomenda.
- Corrigido problema com código incorreto vindo do Webservice dos Correios impossibilitando mostrar o frete corretamente.
- Atualizado valores do Impresso normal, Registro Módico e Registro Nacional para tabela de 01/08/2018.
- Corrigido os valores de altura e comprimento que estavamos trocados.
= 3.7.1 - 2018/05/11 =
- Melhorado o comportamento quando login e senha para tabela de rastreamento estão incorretos.
- Melhorada a descrição para opção de integração com tabela de rastreamento.
= 3.7.0 - 2018/05/08 =
- Atualizados os valores do Impresso e Carta, mais detalhes em [#97](https://github.com/claudiosanches/woocommerce-correios/pull/97) e [#100](https://github.com/claudiosanches/woocommerce-correios/pull/100).
- Adicionada opção para peso extra nos métodos de Impresso e Carta, mais detalhes em [#95](https://github.com/claudiosanches/woocommerce-correios/pull/95).
- Adicionada opções para usar rastreamento com dados administrativos.
- Melhorado a exibição e salvamento da estimativa de entrega, mais detalhes em [#98](https://github.com/claudiosanches/woocommerce-correios/pull/98)
[See changelog for all versions](https://raw.githubusercontent.com/claudiosanches/woocommerce-correios/master/CHANGELOG.txt).
== Upgrade Notice ==
= 3.8.0 =
- Nome do plugin atualizado de "WooCommerce Correios" para "Claudio Sanches - Correios for WooCommerce".
- Atualizado limites de peso para Impresso normal, Registro Módico e Registro Nacional.
- Corrigida rotina de atualização das opções do plugin.