- Índice
- Funcionalidades
- Compatibilidade e Requisitos
- Instalação
- Desinstalando
- Reinstalando
- Menu Lateral
- Configurações
- Changelog
- Contribuindo
-
Disponibilizar aos clientes da loja, cotações com vários fornecedores de frete, de uma maneira simplificada.
-
Possui ambiente sandbox para testes
-
Seguro para correios
-
Aviso de recebimento
-
Solicitação de coleta
-
Entrega em mãos próprias
-
Valor adicional e prazo extra
-
Valor de desconto
- Magento 2.4.2 & PHP 7.4
- Magento 2.4.1 & PHP 7.4
- Magento 2.4.0 & PHP 7.4
-
Baixe o arquivo .zip do repositório.
-
Crie as pastas
app/code/MelhorEnvio/Quotee extraia o .zip para essa pasta. -
Habilite o módulo com o seguinte comando:
bin/magento module:enable MelhorEnvio_Quote -
Execute os seguintes comandos:
bin/magento setup:upgrade &&
bin/magneto setup:di:compile &&
bin/magento setup:static-content:deploy -f &&
bin/magento c:c && bin/magento c:f
-
Desabilite o módulo com o comando:
bin/magento module:disable MelhorEnvio_Quote -
Remova os arquivos e a pasta "app/code/MelhorEnvio/Quote"
-
Deletar o registro antigo na tabela setup_module:
DELETE FROM setup_module WHERE module = 'MelhorEnvio_Quote' -
Execute os seguintes comandos:
bin/magento setup:upgrade &&
bin/magneto setup:di:compile &&
bin/magento setup:static-content:deploy -f &&
bin/magneto c:c && bin/magento c:f
-
Deletar o registro antigo na tabela setup_module com o comando SQL:
DELETE FROM setup_module WHERE module = 'MelhorEnvio_Quote' -
Remova a pasta do módulo
app/code/MelhorEnvio/Quote -
Baixe o arquivo .zip deste repositório.
-
Crie as pastas
app/code/MelhorEnvio/Quotee extraia o .zip para essa pasta. -
Habilite o módulo com o seguinte comando:
bin/magento module:enable MelhorEnvio_Quote -
Execute os seguintes comandos:
bin/magento setup:upgrade &&
bin/magneto setup:di:compile &&
bin/magento setup:static-content:deploy -f &&
bin/magneto c:c && bin/magento c:f
Após realizar a primeira instalação do módulo da Melhor Envio, você irá notar um novo ícone no menu lateral esquerdo com o Label “Melhor Envio”. Ao clicar nele, será aberto um submenu com as opções disponíveis:
Imagem 1 - Menulateral criado para o módulo
- Envios: uma lista com envios, conforme imagem abaixo:
Imagem 2 - Listagem de Envios
- Configuração: Um link para as configurações do módulo.
É necessário que as informações da loja sejam preenchidas, para isso vá em Stores > Settings > Configuration > General > General, role até o fim e procure pela seção Store Information. Nela preencha os seguintes campos:
- Store name: nome da loja
- Store Phone Number: número de telefone da loja
- Country: país
- Region/State: estado
- ZIP/Postal Code: cep no formato xxxxxx-xxx
- City: cidade
- Street Address: logradouro e número separados por vírgula
- Street Address 2: nome do seu Bairro
Imagem 3 - Campos de configurações gerais da loja
Ainda no menu de configurações, vá em Sales > Shipping Settings e preencha os seguintes campos:
- Country: país
- Region/State: estado
- ZIP/Postal Code: cep no formato xxxxxx-xxx
- City: cidade
- Street Address: logradouro e número separados por vírgula ,
As configurações do módulo podem ser acessadas pelo link disponibilizado pelo menu lateral, visto anteriormente, ou, ainda, podem ser acessadas pelo caminho: Stores > Configurations > Sales (aba do menu) > Delivery Methods > Melhor Envio. Nesta primeira aba que abrirá, você encontrará as configurações gerais do módulo. Abaixo, seguem detalhados os campos disponíveis para preenchimento e seleção e o que cada um faz:
Imagem 4 - Configurações Melhor Envio - parte 1
- Ativo: ativa / desativa a cotação dos fretes para os clientes da loja.
- É Sandox: ativa / desativa o ambiente sandbox (testes) do módulo. Tanto o ambiente de produção quanto o ambiente de sandbox utilizam o mesmo token de autenticação.
- Token: método de autenticação utilizado para realizar as cotações de frete pela api da Melhor Envio que o módulo utiliza. Este token deve ser gerado no próprio painel da Melhor Envio (https://melhorenvio.com.br/cadastre-se).
- Nome do método: nome com que o método de envio aparecerá para os clientes da loja.
- Ordenação: número de 0 a infinito, que define onde o método será mostrado na lista de métodos de envio. Zero é o menor valor possível, logo, tal método seria o primeiro da lista.
- Título: nome do método de entrega.
Imagem 5 - Configurações Melhor Envio - parte 2
- Ship to applicable Countries: define se o envio pode ser realizado para qualquer país em que o cliente definir no seu endereço de entrega, ou ainda, é possível definir destinos específicos, o que habilita o próximo campo.
- Ship to Specific Countries: campo de seleção de países específicos para realizar as cotações de entrega.
- Habilitar Log: habilita o log registrar para as transações realizadas pelo módulo com a API.
- Habilitar Url de Debug: cria uma url com o domínio da loja, onde é possível ver o log criado.
Esta aba possui configurações sobre a entrega.
Imagem 6 - Configurações Melhor Envio
- Segurar sempre: criar um seguro para o pedido.
- Aviso de recebimento (AR): criar um aviso de recebimento para o cliente, caso o mesmo não possa ser entregue no local.
- Solicitação de coleta: define se a entrega deverá ser coletada no local.
- Mão própria: define se a entrega deverá acontecer em mãos próprias.
- Valor do desconto: valor a ser dado de desconto no frete, em cima do valor fornecido pela api.
- Valor adicional: valor adicional a ser cobrado ao valor fornecido pela api.
- Prazo Extra: quantidade de dias para adicionar ao prazo fornecido pela api.
Esta aba possui configurações sobre os atributos de produto.
Imagem 7 - Configurações Melhor Envio
- Unidade de medida: pode ser metros ou centímetros.
- Unidade de peso: gramas ou quilos.
- Atributo de altura: mapeamento dos atributos de produtos já existentes na loja, para definir qual o atributo de altura referente ao produto. Caso não exista um previamente na loja, o mesmo deverá ser criado.
- Atributo de largura: mapeamento dos atributos de produtos já existentes na loja, para definir qual o atributo de largura referente ao produto. Caso não exista um previamente na loja, o mesmo deverá ser criado.
- Atributo de comprimento: mapeamento dos atributos de produtos já existentes na loja, para definir qual o atributo de comprimento referente ao produto. Caso não exista um previamente na loja, o mesmo deverá ser criado.
- Altura padrão: altura padrão definida para todos os produtos, caso não exista um atributo de altura na loja, ou ainda, o mesmo não esteja preenchido no produto.
- Largura padrão: largura padrão definido para todos os produtos, caso o atributo presente no produto não esteja preenchido.
- Comprimento padrão: comprimento padrão definido para todos os produtos, caso o atributo presente no produto não esteja preenchido.
- Peso padrão: peso padrão definido para todos os produtos, caso o atributo presente no produto não esteja preenchido.
Esta aba possui configurações do local de envio e coleta.
Imagem 8 - Configurações Melhor Envio
- Nome: nome do remetente.
- Telefone: telefone para contato do remetente.
- E-mail: e-mail para contato do remetente.
- CPF: campo para identificação do remetente das postagens, caso seja pessoa física.
Imagem 9 - Configurações Melhor Envio
- É empresa: Caso marcado como sim, esconde o campo de CPF e abrem os campos de CNPJ e Inscrição estadual.
- CNPJ: número do cnpj do remetente, sem pontuação ou formatação.
- IE: inscrição estadual do remetente, sem pontuação ou formatação.
Imagem 10 - Configurações Melhor Envio
- Rua: endereço do remetente
- Número: número do endereço do remetente
- Bairro: do remetente
- Complemento: do endereço do remetente
- Cidade: do remetente
- UF: estado do remetente
- País: do remetente
- CEP: do remetente
- Notas: se houver alguma coisa a ser enviado às transportadoras.
Possui configurações para seleção das transportadoras disponíveis para cotação de entrega.
Imagem 11 - Configurações Melhor Envio
Possui configurações específicas para seleção das agências da Jadlog.
Imagem 12 - Configurações Melhor Envio
Consulte CHANGELOG para mais informações de alterações recentes.
Consulte CONTRIBUTING para mais detalhes.