PHPackages                             melhorenvio/magento2 - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility &amp; Helpers](/categories/utility)
4. /
5. melhorenvio/magento2

ActiveMagento2-module[Utility &amp; Helpers](/categories/utility)

melhorenvio/magento2
====================

Módulo para gestão de frete do Melhor Envio

58859[4 issues](https://github.com/melhorenvio/magento2/issues)PHP

Since Oct 9Pushed 7mo ago9 watchersCompare

[ Source](https://github.com/melhorenvio/magento2)[ Packagist](https://packagist.org/packages/melhorenvio/magento2)[ RSS](/packages/melhorenvio-magento2/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependenciesVersions (2)Used By (0)

[![logo](./images/image2.png)](./images/image2.png)

Índice
------

[](#índice)

- [Índice](#%C3%ADndice)
- [Funcionalidades](#funcionalidades)
- [Compatibilidade e Requisitos](#compatibilidade-e-requisitos)
- [Instalação](#instala%C3%A7%C3%A3o)
- [Desinstalando](#desinstalando)
- [Reinstalando](#reinstalando)
- [Menu Lateral](#menu-lateral)
- [Configurações](#configura%C3%A7%C3%B5es)
    - [Da loja](#da-loja)
    - [Específicas do Módulo](#espec%C3%ADficas-do-m%C3%B3dulo)
        - [Aba Quote Shipping](#aba-quote-shipping)
        - [Aba Products Attributes](#aba-products-attributes)
        - [Aba From Settings](#aba-from-settings)
        - [Aba Transportadores](#aba-transportadores)
        - [Aba Configurações de Agência](#aba-configura%C3%A7%C3%B5es-de-ag%C3%AAncia)
- [Changelog](#changelog)
- [Contribuindo](#contribuindo)

Funcionalidades
---------------

[](#funcionalidades)

- 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

Compatibilidade e Requisitos
----------------------------

[](#compatibilidade-e-requisitos)

- Magento 2.3.6+ &amp; PHP 7.4+

Instalação
----------

[](#instalação)

1. Baixe o arquivo .zip do repositório.
2. Crie as pastas `app/code/MelhorEnvio/Quote`e extraia o .zip para essa pasta.
3. Habilite o módulo com o seguinte comando: `bin/magento module:enable MelhorEnvio_Quote`
4. 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

```

Desinstalando
-------------

[](#desinstalando)

1. Desabilite o módulo com o comando: `bin/magento module:disable MelhorEnvio_Quote`
2. Remova os arquivos e a pasta "app/code/MelhorEnvio/Quote"
3. Deletar o registro antigo na tabela setup\_module: `DELETE FROM setup_module WHERE module = 'MelhorEnvio_Quote'`
4. 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

```

Reinstalando
------------

[](#reinstalando)

1. Deletar o registro antigo na tabela setup\_module com o comando SQL: `DELETE FROM setup_module WHERE module = 'MelhorEnvio_Quote'`
2. Remova a pasta do módulo `app/code/MelhorEnvio/Quote`
3. Baixe o arquivo .zip deste repositório.
4. Crie as pastas `app/code/MelhorEnvio/Quote` e extraia o .zip para essa pasta.
5. Habilite o módulo com o seguinte comando: `bin/magento module:enable MelhorEnvio_Quote`
6. 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

```

Menu Lateral
------------

[](#menu-lateral)

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:

[![melhorenvio-image-1](./images/image11.png)](./images/image11.png)

Imagem 1 - Menulateral criado para o módulo

- **Envios**: uma lista com envios, conforme imagem abaixo:

[![melhorenvio-image-2](./images/image13.png)](./images/image13.png)

Imagem 2 - Listagem de Envios

- **Configuração**: Um link para as configurações do módulo.

Configurações
-------------

[](#configurações)

### Da loja

[](#da-loja)

É necessário que as informações da loja sejam preenchidas, para isso vá em Stores &gt; Settings &gt; Configuration &gt; General &gt; 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

[![melhorenvio-image-3](./images/image8.png)](./images/image8.png)

Imagem 3 - Campos de configurações gerais da loja

Ainda no menu de configurações, vá em Sales &gt; Shipping Settings e preencha os seguintes campos:

[![melhorenvio-image](./images/image14.png)](./images/image14.png)

- 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 ,

### Específicas do Módulo

[](#específicas-do-módulo)

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 &gt; Configurations &gt; Sales (aba do menu) &gt; Delivery Methods &gt; 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:

[![melhorenvio-image-4](./images/image4.png)](./images/image4.png)

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

[![melhorenvio-image-5](./images/image5.png)](./images/image5.png)

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.

#### Aba Quote Shipping

[](#aba-quote-shipping)

Esta aba possui configurações sobre a entrega.

[![melhorenvio-image-6](./images/image10.png)](./images/image10.png)

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.

#### Aba Products Attributes

[](#aba-products-attributes)

Esta aba possui configurações sobre os atributos de produto.

[![melhorenvio-image-7](./images/image9.png)](./images/image9.png)

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.

#### Aba From Settings

[](#aba-from-settings)

Esta aba possui configurações do local de envio e coleta.

[![melhorenvio-image-8](./images/image6.png)](./images/image6.png)

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.

[![melhorenvio-image-9](./images/image7.png)](./images/image7.png)

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.

[![melhorenvio-image-10](./images/image1.png)](./images/image1.png)

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.

#### Aba Transportadores

[](#aba-transportadores)

Possui configurações para seleção das transportadoras disponíveis para cotação de entrega.

[![melhorenvio-image-11](./images/image3.png)](./images/image3.png)

Imagem 11 - Configurações Melhor Envio

#### Aba Configurações de Agência

[](#aba-configurações-de-agência)

Possui configurações específicas para seleção das agências da Jadlog.

[![melhorenvio-image-12](./images/image12.png)](./images/image12.png)

Imagem 12 - Configurações Melhor Envio

Changelog
---------

[](#changelog)

Consulte [CHANGELOG](CHANGELOG.md) para mais informações de alterações recentes.

Contribuindo
------------

[](#contribuindo)

Consulte [CONTRIBUTING](CONTRIBUTING.md) para mais detalhes.

###  Health Score

22

—

LowBetter than 22% of packages

Maintenance29

Infrequent updates — may be unmaintained

Popularity25

Limited adoption so far

Community21

Small or concentrated contributor base

Maturity15

Early-stage or recently created project

 Bus Factor1

Top contributor holds 52.1% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

### Community

Maintainers

![](https://www.gravatar.com/avatar/f2312644ab5c9636934786ee1abdf291a33b656214113d2f7bda1a2129416e13?d=identicon)[Melhor Envio](/maintainers/Melhor%20Envio)

---

Top Contributors

[![contardi](https://avatars.githubusercontent.com/u/9461829?v=4)](https://github.com/contardi "contardi (25 commits)")[![marcalpizzi](https://avatars.githubusercontent.com/u/43763142?v=4)](https://github.com/marcalpizzi "marcalpizzi (9 commits)")[![andrevpde90](https://avatars.githubusercontent.com/u/5326648?v=4)](https://github.com/andrevpde90 "andrevpde90 (3 commits)")[![janainabiz](https://avatars.githubusercontent.com/u/153859807?v=4)](https://github.com/janainabiz "janainabiz (3 commits)")[![viniciustessmann](https://avatars.githubusercontent.com/u/8430333?v=4)](https://github.com/viniciustessmann "viniciustessmann (2 commits)")[![Carlessso](https://avatars.githubusercontent.com/u/41929217?v=4)](https://github.com/Carlessso "Carlessso (2 commits)")[![ScopelEduardo](https://avatars.githubusercontent.com/u/88912413?v=4)](https://github.com/ScopelEduardo "ScopelEduardo (2 commits)")[![valiati100](https://avatars.githubusercontent.com/u/28447522?v=4)](https://github.com/valiati100 "valiati100 (1 commits)")[![LucasPereira762xi](https://avatars.githubusercontent.com/u/26752169?v=4)](https://github.com/LucasPereira762xi "LucasPereira762xi (1 commits)")

---

Tags

integracoesmagentotecnologia

### Embed Badge

![Health badge](/badges/melhorenvio-magento2/health.svg)

```
[![Health](https://phpackages.com/badges/melhorenvio-magento2/health.svg)](https://phpackages.com/packages/melhorenvio-magento2)
```

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
