Como Integrar Envia.com com Magento / Adobe Commerce: Tutorial 2026

Magento 2 (Adobe Commerce) é a plataforma open-source/enterprise para lojas de grande porte. No Brasil tem base de uso menor que Shopify ou VTEX, mas ainda popular em lojas verticalizadas (moda, eletrônicos premium). Integrar com a Envia.com acrescenta cotação multi-transportadora no checkout, com suporte para regras complexas (multi-store, multi-warehouse).

Este tutorial é para equipes técnicas (desenvolvedores Magento, DevOps).

⚠️ Disclosure: o frete.center é afiliado da Envia.com.

Índice

1. Pré-requisitos
2. Passo 1 — Conta Envia + API Key
3. Passo 2 — Instalação via Composer ou Marketplace
4. Passo 3 — Configurar Shipping Method
5. Passo 4 — Multi-store / Multi-warehouse
6. Passo 5 — Testar checkout
7. Erros comuns
8. FAQ

Pré-requisitos

• Magento 2.4+ (ou Adobe Commerce equivalente)
• Acesso SSH ao servidor (para Composer) OU acesso ao Admin
• CLI Magento (bin/magento)
• Conta Envia.com + API Key
• Catálogo com peso/dimensões cadastrados

Passo 1 — Conta Envia + API Key

1. Cadastre-se via link do frete.center.
2. Configure endereço de coleta.
3. Configurações → API → Generate API Key. Anote.

Passo 2 — Instalação via Composer ou Magento Marketplace

Via Composer (recomendado):

composer require envia/magento2-shipping
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento setup:static-content:deploy
bin/magento cache:flush

Via Magento Marketplace:

1. Acesse marketplace.magento.com.
2. Busque por "Envia.com" ou "Envia Shipping".
3. Adquira (gratuito) e instale via Web Setup Wizard ou Composer.

Passo 3 — Configurar Shipping Method

1. Admin → Stores → Configuration → Sales → Shipping Methods → Envia.com.
2. Enabled: Yes.
3. API Key: cole sua chave Envia.
4. Origin Address: confirme endereço de coleta.
5. Carriers enabled: marque as transportadoras desejadas:

1. Title in checkout: texto exibido (ex. "Envio padrão").
2. Salve.

Passo 4 — Multi-store / Multi-warehouse

Magento 2 suporta múltiplas lojas e armazéns:

• Multi-store: cada Store View pode ter configuração Envia diferente (origem, transportadoras). Configure em Stores → Configuration → [escolher Store View no topo].
• Multi-source inventory (MSI): se vc tem múltiplos armazéns, configure Envia para cotar do source correto. Magento 2.3+ tem MSI nativo.

Para lojas com 10k+ pedidos/mês, considere regras de routing customizadas via plugin/preference para priorizar transportadoras por SKU/região.

Passo 5 — Testar checkout

1. Frontend em modo anônimo.
2. Carrinho → checkout → CEP de teste.
3. Confira cotação aparecendo nas transportadoras configuradas.

Se nada aparece: verifique log em var/log/system.log e var/log/exception.log para erros API.

Erros comuns

1. "No shipping methods available." Causa: produto sem peso, MSI mal configurado ou origem fora de cobertura. Verifique catalog + MSI + log.

2. Cotação lenta no checkout. Magento + várias transportadoras pode ser pesado. Solução: cache de cotação (Redis), limitar a 3-4 carriers visíveis.

3. API key inválida após deploy. Cache. Solução: bin/magento cache:flush.

4. Etiqueta gerada mas pedido não muda de status. Webhook Envia desconfigurado. Solução: confira endpoint webhook no painel Envia.

FAQ

Funciona em Adobe Commerce Cloud? Sim, mas instale via Composer, não via SSH direto (cloud não permite).

Magento 1 ainda suportado? Magento 1 é descontinuado oficialmente. Para Magento 1 legado, há extensões da comunidade, mas recomendamos migrar pra Magento 2.

Cobra licença? Plugin é gratuito. Você paga só as etiquetas Envia.

Como customizar regras de carrier por região? Use observer/plugin do Magento para alterar \Magento\Shipping\Model\Shipping::collectRates e filtrar/ordenar conforme sua regra.

E para B2B (Adobe Commerce B2B)? Funciona — Envia cota encomendas. Para carga fechada B2B (caminhão), use marketplace dedicado fora do Magento.

Veja também:

• Magento + Envia.com — detalhe


• VTEX + Envia.com — outra plataforma enterprise


• Envia.com no Brasil

Cadastrar grátis na Envia.com →