PHPackages                             olist/envios-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. olist/envios-magento2

ActiveMagento2-module

olist/envios-magento2
=====================

Módulo oficial de fretes Envios da Olist para Magento 2

v1.0.1(1mo ago)06↓75%proprietaryPHPPHP >=8.1

Since Jul 13Pushed 1mo agoCompare

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

READMEChangelogDependencies (3)Versions (4)Used By (0)

Envios da Olist — Módulo Magento 2
==================================

[](#envios-da-olist--módulo-magento-2)

Módulo oficial de fretes para Magento 2. Exibe as opções de frete do Envios da Olist diretamente no checkout da loja, consumindo a API de cotação em tempo real.

---

Requisitos
----------

[](#requisitos)

- PHP 8.1 ou superior
- Magento 2.4.x
- Extensão PHP `ext-curl`
- Conta ativa no [Envios da Olist](https://envios.olist.com) com token de integração gerado

---

Instalação via Composer
-----------------------

[](#instalação-via-composer)

```
composer require olist/envios-magento2
php bin/magento module:enable Olist_Envios
php bin/magento setup:upgrade
php bin/magento setup:di:compile
php bin/magento cache:clean
```

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

[](#instalação-manual)

1. Faça o download ou clone este repositório
2. Copie a pasta para `app/code/Olist/Envios/` na raiz da sua instalação Magento
3. Execute os comandos abaixo:

```
php bin/magento module:enable Olist_Envios
php bin/magento setup:upgrade
php bin/magento setup:di:compile
php bin/magento cache:clean
```

---

Configuração
------------

[](#configuração)

Acesse **Lojas → Configuração → Vendas → Métodos de Entrega → Envios da Olist** e preencha os campos:

CampoDescrição**Habilitado**Ativa ou desativa o método de entrega no checkout**Título**Nome exibido ao comprador (padrão: "Envios da Olist")**Token de integração**UUID do token obtido no painel do Envios da Olist**URL da API**URL base da API — altere apenas para apontar a um ambiente de testes**Mensagem de erro**Texto exibido ao comprador quando o cálculo de frete falhar**Modo debug**Registra requisições e respostas em `var/log/system.log`Salve e limpe o cache:

```
php bin/magento cache:flush
```

---

Dimensões de produtos
---------------------

[](#dimensões-de-produtos)

Altura, largura e comprimento não são atributos nativos do Magento, então o módulo envia o valor padrão de **10 cm** para cada dimensão de item. Não é necessário configurar medidas nos produtos da loja.

---

Unidade de peso
---------------

[](#unidade-de-peso)

O módulo lê a unidade de peso configurada na loja em **Lojas → Configuração → Geral → Opções de Localidade → Unidade de Peso** e converte automaticamente para quilogramas antes de enviar à API.

Unidades suportadas: `kg` (sem conversão) e `lbs` (multiplicado por 0,453592).

---

Cache
-----

[](#cache)

As cotações são armazenadas em cache por **5 minutos** com base no conteúdo do carrinho e no CEP de destino. Para limpar o cache de cotações manualmente:

```
php bin/magento cache:clean olist_envios_quote
```

---

Debug
-----

[](#debug)

Ative o **Modo debug** nas configurações. As requisições e respostas da API serão registradas em `var/log/system.log` com o prefixo `[Olist Envios]`.

---

Ambiente de desenvolvimento local
---------------------------------

[](#ambiente-de-desenvolvimento-local)

O repositório inclui um ambiente Docker em `development/` com Magento, banco de dados e OpenSearch prontos para uso. O código-fonte do Magento fica armazenado em um volume interno do Docker — não é necessário baixá-lo manualmente.

### Pré-requisitos

[](#pré-requisitos)

- Docker e Docker Compose instalados
- Chaves de acesso do [Magento Marketplace](https://marketplace.magento.com) configuradas em `~/.composer/auth.json`:

```
{
    "http-basic": {
        "repo.magento.com": {
            "username": "SUA_CHAVE_PUBLICA",
            "password": "SUA_CHAVE_PRIVADA"
        }
    }
}
```

### Uso

[](#uso)

```
make dev-up    # inicia os containers (na primeira vez, baixa e instala o Magento automaticamente)
make dev-stop  # pausa os containers preservando o estado (reinício rápido com dev-up)
make dev-down  # remove os containers e redes (dados nos volumes são preservados)
make dev-shell # abre um terminal dentro do container
make dev-logs  # acompanha o progresso da instalação automática
```

Use `dev-stop` / `dev-up` no dia a dia — é mais rápido pois os containers não precisam ser recriados. Use `dev-down` quando quiser liberar recursos ou após uma sessão mais longa. Se o arquivo `docker-compose.yml` for alterado, é necessário recriar os containers:

```
docker compose -f development/docker-compose.yml up -d --force-recreate magento
```

### Apontando para uma API local

[](#apontando-para-uma-api-local)

O container do Magento não consegue acessar `localhost` da máquina host diretamente. O `docker-compose.yml` já está configurado com `extra_hosts: host.docker.internal:host-gateway`, que mapeia automaticamente o hostname `host.docker.internal` para o IP da máquina host.

Para apontar o módulo para uma API rodando localmente (ex.: `http://localhost:5000`), acesse o painel admin em **** e configure a **URL da API** como:

```
http://host.docker.internal:5000

```

Ou via CLI dentro do container:

```
bin/magento config:set carriers/olist_envios/api_url http://host.docker.internal:5000
bin/magento cache:flush
```

Na **primeira execução**, `make dev-up` dispara um container de inicialização que baixa o Magento 2.4.8, executa a instalação e habilita o módulo `Olist_Envios`. Isso pode levar alguns minutos. Nas execuções seguintes o ambiente sobe instantaneamente.

Acesse em **** e o painel admin em **** (usuário `admin` / senha `Admin1234!`).

---

Desinstalação
-------------

[](#desinstalação)

```
php bin/magento module:disable Olist_Envios
php bin/magento setup:upgrade
php bin/magento setup:di:compile
php bin/magento cache:clean
```

Se instalado via Composer:

```
composer remove olist/envios-magento2
```

###  Health Score

38

—

LowBetter than 83% of packages

Maintenance90

Actively maintained with recent releases

Popularity4

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity44

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% 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.

###  Release Activity

Cadence

Every ~0 days

Total

2

Last Release

47d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/15eec128f298a98b96f40f4e4ae6956d82ef497c523d6dad6497f0b995ccf034?d=identicon)[fernando.matos.olist](/maintainers/fernando.matos.olist)

---

Top Contributors

[![fernando-matos-olist](https://avatars.githubusercontent.com/u/103277124?v=4)](https://github.com/fernando-matos-olist "fernando-matos-olist (21 commits)")

###  Code Quality

TestsPHPUnit

### Embed Badge

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

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

###  Alternatives

[fastly/magento2

Fastly CDN Module for Magento 2.4.x

1564.5M2](/packages/fastly-magento2)[mollie/magento2

Mollie Payment Module for Magento 2

1162.0M19](/packages/mollie-magento2)[adyen/module-payment

Official Magento2 Plugin to connect to Payment Service Provider Adyen.

1673.2M11](/packages/adyen-module-payment)[algolia/algoliasearch-magento-2

Algolia Search & Discovery extension for Magento 2

1912.0M23](/packages/algolia-algoliasearch-magento-2)[nosto/module-nostotagging

Increase your conversion rate and average order value by delivering your customers personalized product recommendations throughout their shopping journey.

28726.5k7](/packages/nosto-module-nostotagging)[myparcelnl/magento

A Magento 2 module that creates MyParcel labels

1862.4k](/packages/myparcelnl-magento)

PHPackages © 2026

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