Clone wiki

Correios / Home

Módulo de Correios Offline & Online para Magento 2 Imagination Media (www.imaginationmedia.com.br)

Este é um módulo gratuito que fornece o cálculo do frete dos Correios em sua loja Magento 2.x.

Funcionalidades do Módulo:

  • 1 Cálculo instantâneo obtendo os valores online do preço e prazo de entrega com os
  • Correios.
  • 2 Permite criação de uma base offline para cálculo, se o cálculo não for possível de ser realizado com a base online dos Correios, será consultada a base offline.
  • 3 Atualização da base offline pelo cron em intervalo de dias.
  • 4 Permite configurar e disponibilizar diferentes forma de entrega dos Correios.
  • 5 Adicionar custos na entrega e dias no prazo final.
  • 6 Personalizar mensagem da forma de entrega.
  • 7 Editar e modificar as faixas de CEP offline.
  • 8 Adicionar novas faixas de CEP offline.
  • 9 Você pode configurar se o cálculo será realizado com os valores online/offline ou somente com a base offline.
  • 10 Adiciona três atributos no cadastro do produto onde você irá informar a largura, tamanho e profundidade do produto que serão utilizados no cálculo.

Instalação

Faça o download do repositório e extraia o conteúdo na pasta app/code/ImaginationMedia/Correios.
Após isso execute o comando de upgrade do Magento para que o novo módulo seja reconhecido e instalado (php bin/magento setup:upgrade).

Limpe o cache do Magento (php bin/magento cache:clean).

Configuração

Produtos

No cadastro dos produtos você verá que há três novos atributos, estes atributos serão utilizados para realizar o cálculo do custo e prazo de envio dos Correios.
Preencha estes dados em todos os produtos, caso sejam deixados em branco assumirão os valores padrão que serão configurados posteriormente em outra sessão do módulo.

O Ariel do canal Mestre Magento publicou um vídeo que ensina passo a passo a configurar o módulo, veja em https://www.youtube.com/watch?v=dtaXYJBpMcQ

Também no canal do Magento Meetup ensinamos como configurar o módulo passo a passo: https://www.youtube.com/watch?v=bmfbcllnfBk

Métodos de Entrega

Para que o módulo funcione exibe as opções de entrega dos Correios durante o cálculo do custo de envio da compra acesse Stores > Configurations. Vá em Sales > Shipping Methods. Ou pela segunda opção dentro da opção do módulo no menu lateral esquerdo.
Picture1.png

Certifique-se que os dados de remetente de sua loja estão preenchidos como país de origem, cep de origem, cidade, etc. Para isso vá em Sales > Shipping Configuration.
Nas configurações do método de entrega você irá configurar o título do método, irá configurá-lo como Habilitado, em "Serviços Disponíveis" você irá selecionar as formas de entrega dos Correios que irá disponibilizar em sua loja, lembrando que algumas só estarão disponíveis se você tiver um contrato com os Correios.

Em "Método para entrega grátis" você irá configurar quais dos métodos dos Correios irá receber o frete grátis quando uma regra de promoção da loja fornecer o frete grátis para a compra.

Em número e senha de contrato você irá preencher o número e a senha de acesso aos serviços dos Correios referente ao seu contrato.
2.png

Em "Tipo de Peso no cálculo" você irá configurar se o peso preenchido nos produtos está em Kg ou Gr, é recomendável sempre utilizar Kg.

Em "Mãos Próprias", "Aviso de Recebimento" e "Usar valor declarado" você irá configurar se as entregas usarão estes serviços durante a cotação do valor da entrega.
3.png

Em validar dimensões você irá validar se as dimensões cadastras nos produtos estão corretas e dentro dos padrões exigidos pelos Correios, é recomendável sempre deixar esta opção habilitada.
Em altura, largura e profundidade padrão você irá configurar os valores padrão em caso de o produto não possuir estes valores preenchidos.

Em "Taxa de manuseio" você irá configurar caso queira um valor a ser adicionado na entrega como custo adicional por embalagem ou algum outro motivo.

Em "Exibir Prazo de Entrega" você irá configurar se ao exibir a cotação do valor da entrega para o cliente também será exibido o prazo para entrega da compra.
Em "Incrementar dias ao prazo" você pode configurar dias a serem adicionados ao prazo fornecido pelos Correios.

Em "Mensagem do prazo de entrega" você pode configurar a mensagem que será exibida ao informar o valor e prazo da entrega. Esta mensagem possui parâmetros, o primeiro é a forma de envio (Pac,Sedex,Esedex,etc) e o segundo o número de dias do prazo caso o prazo for ser exibido na mensagem. Você pode então nesse campo configurar por exemplo: %s - em até %s dias úteis.

Em "Mensagem da entrega grátis" você pode personalizar a mensagem que será exibida na forma de entrega que receber o frete grátis.
4.png

Em "Url do webservice dos Correios" você deve configurar a URL de consulta ao webservice dos Correios para obtenção dos valores e prazos de entrega. Por padrão você pode
configurar http://ws.correios.com.br/calculador/CalcPrecoPrazo.aspx?StrRetorno=xml que á url atual. Se um dia esta URL for modificado você pode configurá-la neste campo.

Em "Peso Máximo" você pode configurar um peso máximo para as entregas, este valor será utilizado para validar as dimensões e o peso da entrega.

Em "Número máximo de faixas offline em cada requisição de atualização" você irá configurar o número de faixas offline que serão atualizadas a cada solicitação de atualização. O que ocorre é que as faixas offline são muitas e dependendo da configuração de sua hospedagem se este número for muito grande poderá ocorrer o erro de timeout, portanto configure um valor que não cause problemas em seu servidor. Um bom número é 400 por exemplo.

Em "Habilitar logs?" você irá habilitar se o módulo irá criar um arquivo de log ou não na pasta /var/log informando possíveis erros que ocorrerem no módulo.
Em "Intervalo de dias para atualização(Faixas de CEP offline)" você irá configurar o intervalo em dias que a base de faixas de CEP offline será atualizada. Este número será utilizado pelo cron para verificar se há necessidade de atualizar ou não a base offline.

Em "Modo de Funcionamento" você irá configurar se os valores que serão apresentados ao cliente serão obtidos somente da base offline ou se será realizada primeiramente uma tentativa para obter no webservices dos Correios e se caso não for possível será consultada a base offline.
5.png

Como utilizar a base offline

Primeiro no item do módulo no Menu Lateral acesse a opção "Faixas de CEP".
Neste tela serão apresentadas as faixas de CEP que estão armazenadas em sua loja e é possível filtrá-las, editá-las e também adicionar novas faixas.
6.png

No primeiro momento sua base offline estará vazia. Você terá então que primeiro clicar no botão "Popular Banco de Dados", assim faixas de CEP pré-definidas serão inseridas em seu banco local.
Após populado o banco você terá que atualizar os valores e prazos para as faixas populadas. Para isso clique no botão "Atualizar Faixas". Serão atualizados X registros da base offline por solicitação, este valor é o número configurado na opção "Número máximo de faixas offline em cada requisição de atualização" dentro das configurações do método de envio.

Ao final da solicitação é exibido o número de registros atualizados com sucesso e os que ocorreram erro. Como as faixas de CEP dos Correios mudam frequentemente error surgirão, não se preocupe. Chegará em um momento que todas as faixas apresentarão erro. Estas faixas então são inválidas e não deverão ser utilizadas em nosso cálculo. Para isso clique no botão "Deletar Faixas Inválidas" e estas faixas serão removidas. Mas atenção só clique neste botão após atualizar todas as faixas de sua base local, pois ao clicar neste botão todas as faixas com valor e prazo 0 serão removidas.

Você pode remover uma faixa manualmente selecionando-a e acionando a ação Excluir dentro do combo de ações.

Para editar uma faixa você deve apenas dar um duplo clique sobre ela, e será possível editar os valores.
Para adicionar uma nova faixa clique no botão "Adicionar Nova Faixa", preencha todos os campos e salve. Lembrando que é possível cadastrar apenas uma faixa de CEP para uma mesma faixa de CEP e um mesmo serviço.
Se você quiser limpar a sua base de dados offline é só clicar no botão "Limpar Banco de Dados".
Este módulo é uma continuação do módulo disponibilizado no repositório do Igor Ludgero (https://bitbucket.org/igor_lm/igorludgero_correiosofflinem2).

Nós da Imagination iremos dar o suporte e fornecer a atualização do módulo de agora em diante.

Para quais dúvidas e suporte você pode entrar em contato pelo contato@imaginationmedia.com.br.

IMAGINATION MEDIA

Updated